接続の操作方法

お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。

概要

外部連携を利用すると、Zoho WorkDriveをサードパーティやZohoサービスとOAuth 2.0認証を用いて連携できます。WorkDriveは認可、アクセストークン、更新トークン、セキュアな保存など、OAuthフロー全体を管理します。これにより、Deluge関数をシンプルかつ安全に保つことができます。

一度コネクションを作成しアカウントにリンクすると、コネクションのリンク名を参照してカスタム関数内で外部APIを呼び出せます。トークンの管理や認証情報の手動保存は不要です。

コネクションの作成

新規コネクションは、スクラッチ（カスタムサービス）から作成することも、WorkDriveが提供する初期設定サービスのいずれかを利用することもできます。

初期設定サービスを利用してコネクションを作成する方法

WorkDriveアカウントにサインインします。
管理コンソール > 外部連携に移動します。
コネクション作成をクリックします。初期設定サービスタブが初期表示されます。
リストからサービスを選択します（例：Slack）。
コネクション名を入力します。
サービスで指定された必須スコープを選択します。
作成して接続をクリックします。サービスにサインインして認証プロセスを完了してください。

コネクション作成後、WorkDriveでは以下が表示されます:

リンク名
サービス名
コネクションステータス
コネクションを呼び出すためのサンプルDelugeコードスニペット
コネクションはマイ外部連携リストに表示され、カスタム関数間で再利用できます。

カスタムサービスを利用してコネクションを作成する方法

必要なサービスが初期設定サービスに含まれていない場合は、手動で設定できます。設定後は、組織内の誰でも必要な認証情報を入力することで、そのサービスの外部連携を複数作成できます。

メモ: Zoho WorkDrive APIはOAuth 2.0認証を利用しています。クライアントアプリをZohoに登録する必要があります。ヘルプドキュメントを参照し、クライアントアプリの登録方法やカスタムサービスの作成方法をご確認ください。

WorkDriveアカウントにサインインします。
Admin Console > 外部連携に移動します。
作成 Connectionをクリックします。
サービスが一覧にない場合はカスタムサービスを選択します。サービス詳細ダイアログボックスが表示されます。
接続するサービスの名前を入力します（例：MailChimp）。
サードパーティアプリケーションまたはサービスでサポートされている認証の種類を選択します。
サービスの詳細を入力します：

クライアントID
クライアントシークレット
リクエストトークン（認証）URL
アクセストークンURL
トークン更新URL（該当する場合）

Connection名を入力します。
サードパーティサービスで指定されたスコープを入力します。各接続のスコープはサードパーティサービスによって提供されます。該当するサードパーティサービスのヘルプを参照し、提供されているスコープをご確認ください。
作成 and 接続をクリックします。外部サービスにサインインして認証プロセスを完了します。

Connectionが作成されると、「My 外部連携」リストに表示され、カスタム関数で再利用できます。

カスタム関数でConnectionを利用する

My 外部連携タブには、利用可能な外部連携の一覧が表示され、すぐに使用できます。既存のConnectionを選択するか、カスタムサービスタブから作成したものを選択できます。外部連携は関数内で呼び出して利用します。カスタム関数内で直接利用し、外部APIを呼び出すことが可能です。

Connectionを利用する手順：

Admin Console > 外部連携に移動します。
My 外部連携セクションからConnectionを選択します。
まだ認証していない場合は接続をクリックします。
Connection詳細ページ下部に表示されているサンプルDelugeコードをコピーします。
このコードをカスタム関数内で使用し、取得、POST、PUT、削除の各種呼び出しを実行します。
Delugeでは、Connectionはリンク名を使って呼び出します。パラメーターを渡して、API URLやリクエスト本文内の動的な値を置き換えることができます。