カスタムサービスの編集
カスタムサービスを編集するには、次の操作を行います。
- カスタムサービス タブに移動します。
- 対象のカスタムサービスに対応する編集ボタンをクリックします。
- 必要な変更を行い、更新する ボタンをクリックします。
接続設定
お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。
外部連携とは
外部連携は、外部サービスとの認証および連携を行うためのブリッジとして機能します。外部連携は、Zoho Forms アカウント内のフォームをサードパーティサービスにリンクするための手段と考えることができます。
Zoho Forms には、Zoho CRM、Salesforce、Google スプレッドシート、Outlook カレンダーなどの一般的なサービスとの事前構築済み連携が多数用意されています。利用したいサービスがこれらの中にない場合は、独自にカスタム外部連携を作成し、Webhook 連携を使用して目的のサービスに接続できます。
メモ:
- 同じサービスに対して複数の外部連携を作成できます。
- 外部連携は有料プランでのみご利用いただけます。
Zoho Forms 組織で外部連携を有効にする
Zoho Forms 組織のスーパー管理者が外部連携を初期化する必要があります。手順は次のとおりです。
- スーパー管理者として Zoho Forms アカウントにログインします。
- フォーム一覧ページの左ペインで、設定 の下にある コントロールパネル をクリックします。
- 開発者向け情報 の下にある 外部連携 をクリックします。
- 接続 をクリックします。
サービス
サービスは、外部連携を作成するために使用するコネクタです。サービスには次の種類があります。
-
初期設定サービス:これらはあらかじめ設定されたサービスです。初期設定サービスを使用すると、簡単に外部連携を作成し、認証情報を使って認証できます。
- カスタムサービス:必要なサービスが初期設定サービス一覧にない場合は、自分で設定できます。
カスタムサービスの設定
カスタムサービスを作成するには、
-
カスタムサービス セクションで サービスを作成 をクリックし、次の情報を入力します。
- サービス名: 作成するサービスの表示名です。表示名は最大 50 文字まで指定できます。
-
サービスリンク名: カスタムサービスを一意に識別するためのサービスのリンク名です。
-
認証タイプ: 利用するサービスの API ドキュメントに基づき、次の認証タイプから選択します。
種類 説明 項目 APIキー この認証タイプでは、目的のサービスとの接続を確立するためのパラメーターを指定する必要があります。次の手順で、連携を実行するためにこれらのパラメーターに値を設定します。たとえば、パラメーターとして authtoken を指定した場合、次の手順ではアカウントの認証トークンを入力して、正常に接続を確立します。 認証タイプとして APIキー を選択した場合、次の項目に値を設定する必要があります。
- 実パラメーター: パラメーターを送信する対象となるキーの名前です（利用するサービスの API ドキュメントで指定されているキー名）。
- パラメーター表示名: パラメーターの表示名です。この名前は、外部連携を認証する際に入力を求められます。
- パラメーターの種類: 認証パラメーターを、invoke URL スクリプトで指定した URL にどのように付与して送信するかを決定します。サポートされるパラメータータイプ: クエリ文字列、フォームデータ、ヘッダー
基本 この認証タイプでは、次の手順でユーザー名とパスワードを指定する必要があります。指定したユーザー名とパスワードは、自動的にbase64アルゴリズムで暗号化され、次の形式でヘッダーとして送信されます: Basic <encrypted_username>:<encrypted_password>. N/A OAuth 1 この認証タイプでは、OAuth 1認証を実行するために必要な必須パラメーターを指定する必要があります。 認証タイプとしてOAuth 1を選択した場合、次の項目に値を入力する必要があります:
- Consumerキー: サービスプロバイダーから発行されたConsumerキー
- Consumerシークレット: アプリケーションを認証するためのConsumerシークレット
- Request Token URL: 対象サービスのAPIドキュメントで指定されている、リクエストトークンを取得するためのURL
- 認証URL: 対象サービスのAPIドキュメントで指定されている認証URL
- Access Token URL: 対象サービスのAPIドキュメントで指定されている、アクセストークンを取得するためのURL
- パラメーターの種類: invoke URLスクリプトで指定したURLに対して、認証パラメーターをどのように送信するかを指定します。サポートされる種類: Query string、Form Data、Header
OAuth 2 この認証タイプでは、OAuth 2認証を実行するために必要な必須パラメーターを指定する必要があります。 認証タイプとしてOAuth 2を選択した場合、次の項目に値を入力する必要があります:
- Grantタイプ: 対象サービスが認可に使用するGrantタイプです。サポートされているGrantタイプ（Authorizationコード、Client credentials）から選択できます。
- クライアントID: サービスプロバイダーから発行されたクライアントID
- Clientシークレット: アプリケーションを認証するためのClientシークレット
- 認証URL: 対象サービスのAPIドキュメントで指定されている認証URL
- Access Token URL: 対象サービスのAPIドキュメントで指定されている、アクセストークンを取得するためのURL
- 更新用Token URL: 対象サービスのAPIドキュメントで指定されている、リフレッシュトークンを取得するためのURL
- パラメーターの種類: invoke URLスクリプトで指定したURLに対して、認証パラメーターをどのように送信するかを指定します。サポートされる種類: Query string、Header
-
Scope (OAuth 2認証タイプにのみ適用): 対象サービスのAPIドキュメントで指定されている、連携を実行するために必要なスコープ。
-
スコープ区切り文字 (OAuth 2 認証タイプにのみ適用): 利用するサービス API が、スコープを区切るために想定している区切り文字です。
メモ:
- 使用できる区切り文字は、カンマ、スペース、プラス記号です。指定しない場合は、カンマが既定の区切り文字として使用されます。
- 複数のスコープを指定する場合にのみ、区切り文字を選択できます。
2. 必要な詳細を入力したら、サービスを作成 をクリックします。
接続の作成
- マイ連携 タブに移動し、接続を作成 をクリックします。
- 利用するサービスを選択します。
- 次に、接続情報とその他の必須項目を入力します。
- 接続名: 接続の表示名です。
-
連携リンク名: リンク名は一意である必要があり、Deluge の連携タスクや Invoke URL スクリプトで認証を確立するために使用できます。
入力するリンク名は、次の条件を満たす必要があります。
- 先頭は小文字で始める必要があります。
- 使用できるのは、小文字、数字、アンダースコア（_）です。
- 最大 50 文字まで指定できます。
-
作成して接続 をクリックします。
-
ユーザー権限ダイアログがポップアップ表示されるので、認証情報を入力して続行します。
-
接続の概要が表示されます。
-
認可が正常に完了すると、接続が作成され、「連携」ページに一覧表示されます。
-
接続にカーソルを合わせると、編集、取り消し 、削除 の操作を行えます。