接続 - Zoho People

接続 - Zoho People

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

Zoho People コネクションは、Zoho PeopleとZohoまたはサードパーティのサービスとの間に安全なリンクを認証し、確立するツールであり、シームレスな統合を実現します。これは仮想の'ログインする'として機能し、さまざまなプラットフォームでデータへのアクセスを許可します。一度サービスに接続すると、Zohoやその他のサードパーティアプリケーションからデータを取得し、交互作用することができ、それぞれの時間にログインする必要がないため、データのスムーズな交換が可能になります。
Info
外部連携は、任意のサードパーティアプリケーションのREST APIを起動し、認証済みデータにアクセスするために利用できます。
Info
外部連携はすべてのZoho People有料プランで利用可能です。

技術的詳細

  1. 認証の3つのモードがあります: 基本、OAuth 1。+10、-10、およびOAuth 2。+10、-10。
  2. 管理者権限は外部連携を使用するために必須です。
  3. Rest APIとDelugeスクリプトの知識が必須です。
初期設定サービス:これらは、Zoho Peopleで即座に利用可能な事前設定されたサービスです。これらの初期設定されたサービスを使用して接続を素早く作成し、認証情報を提供することで認証を行い、シームレスかつ効率的な統合を確保します。

カスタムサービス: 必要なサービスが初期設定の利用可能なサービスのリストに含まれていない場合、自分で設定するオプションがあります。これにより、特定の要件に適したカスタムサービスを連携させることができます。サービスが成功裏に設定されると、管理者はそのサービスを使用して外部連携を作成することができます。

初期設定サービスを使用した接続の作成

Zoho Peopleで利用可能な初期設定サービスの接続を作成するには：
  1. 設定 > 開発者向け情報 > 外部連携 > My 外部連携 へ進み、接続を作成をクリックします。



  2. Pick your サービスで、選択を初期設定サービスタブにし、作成したい外部連携のサービスを選択します。


  3. 接続名とリンク名を入力し、スコープを選択して、作成および接続をクリックします。

  4. 接続をクリックします。

  5. 次に、続行してサインインするように求められます（この場合、SlackのワークスペースURLが必要です）。続行をクリックします。



  6. 次のページでは、接続のリンク名、サービス名、ステータスが表示されます。



  7. さらに、接続を呼び出すための関数内で使用されるコードもボックスで提供されます。
Idea
  1. URLはサードパーティのサービスから取得できます。
  2. POST、PUT、取得、削除のタイプは、リクエストが実行する操作の種類を決定するHTTPメソッドです。
  3. パラメータは、APIに存在する動的な値をユーザ固有の値に置き換えるために関数によって使用されます。例えば、APIがリードの詳細（名前、メールアドレス、連絡先番号など）を取得する必要がある場合、これらの値はAPI内の動的な値によって表現されます。この動的な値は、パラメータ関数を使用して見込み客の詳細ページの実際の値から置き換えることができます。この文書で後述の例でこの関数についての詳細な情報を提供します。
  4. コード中のConnectionはリンク名です。
以上のコードブロックを使用してURLを呼び出し、サードパーティアプリとZoho Peopleを連携できます。

カスタムサービスを作成して外部連携を作成する

カスタムサービスを作成するプロセスを理解するためのいくつかの重要な条件は以下の通りです:
  1. リソース - クライアントがアクセスしようとしているアプリケーションやサービスを指します。この場合、リソースとは、クライアントが連携しようとしている第三者のサービス（例：MailChimp）を指します。
  2. リクエストトークンURL - このURLは、認証リクエストをリソースサーバーに送信するために使用されます。リソースサーバーはリソースの担当者（ユーザー）にこのリクエストを認証するよう求めます。
  3. アクセストークンURL - リクエストがリソースの担当者によって認証されると、サーバーはクライアントにアクセストークンを送信します。これは、クライアントがリソースデータにアクセスするたびに交換する必要があります。
  4. トークン更新URL - 一部のアクセストークンは限られた時間だけ有効です。アクセストークンが期限切れになると、クライアントはトークンを更新するためのURLを使用してリソースから別のアクセストークンを取得する必要があります。
  5. クライアントID - 各クライアントアプリケーションに提供される一意の識別子です。このIDはリソース担当者（例：MailChimp）から提供されます。
  6. クライアントシークレット - 各クライアントアプリケーションは、不正アクセスを防ぐための対応するシークレットコードを持っています。
  7. リダイレクトURL - このURLは、データアクセスの認証を受けた後、エンドユーザーがリダイレクトされる場所です。クライアントアプリケーションはこのリダイレクトURLを自動的に生成します。

Zohoクライアントの登録

Info
メモ: 下記の手順は、カスタムサービスを外部連携に追加したい場合のみ、Appsに対して実施してください。
Zoho PeopleのAPIはOAuth2の標準に基づいて認証されているため、クライアントアプリをZohoに登録する必要があります。以下の手順を参照してください:
  1. このURLにアクセスします: https://取引先。Zoho。com/developerconsole
  2. クライアントIDを追加をクリックします。
  3. クライアントの名前とドメインを入力します。
  4. Redirect URIを'https://deluge。Zoho。com/delugeauth/callback'に設定します。
  5. クライアントタイプをWebベースとして選択します。
  6. 作成をクリックします。
  7. クライアントアプリが作成され、表示されるはずです。
  8. 新規登録したアプリのクライアントIDとクライアントシークレットは設定→ 編集 (設定は右上角の三つの点のアイコン) をクリックすることで見つけることができます。

カスタムサービスを作成する手順

カスタムサービスは、最初にサービスを一から作成し、その後に接続を作成することで作成することができます。
  1. 設定 > 開発者情報 > 外部連携 > My外部連携へ移動し、外部連携の作成をクリックします。


  2. カスタムサービスタブをクリックします。
  3. サービスに接続したい名前を提供します（例：Zoom）。
  4. サードパーティのアプリケーションまたはサービスによってサポートされる認証の種類を選択します。
  5. サードパーティのサーバーに関する以下の詳細を提供します：
    1. クライアントIDとクライアントシークレット。
    2. Request Token URL：これにより、コネクターはリソースサーバー上のデータへのアクセス許可を要求することができます。
    3. Access Token URL：認証されると、Request TokenとTokenキーがAccess Tokenと交換され、コネクターがサードパーティのサーバーから特定の情報にアクセスできるようになります。
    4. Tokenの更新URL：一部のアプリケーションでは、トークンの有效期間を限定することでセキュリティを強化しています。これらの場合は、コネクターがアクセスを再認証するためにTokenの更新URLを提供します。



  6. ConnectionのScope名とScope表示名を提供します。各接続の範囲は、サードパーティのサービスによって提供されます。各サービスの提供範囲を理解するために、それぞれのサードパーティサービスのヘルプを参照してください。
  7. Scopeの区切り文字としてコンマを入力します。
  8. 接続のScopesを提供します。各接続の範囲は、サードパーティのサービスによって提供されます。各サービスの提供範囲を理解するために、それぞれのサードパーティサービスのヘルプを参照してください。
  9. サービスの作成をクリックします。
  10. サービス概要の右上隅で接続の作成をクリックします。
  11. 接続が作成されると、サービスの選択タブで利用できるようになります。
  12. 作成して接続をクリックします。

接続の例

Zoomのビデオ会議アプリとの接続を設定する手順の例を以下に示します。これらの手順に従ってください:
  1. 設定 > 開発者向け情報 > 外部連携 > My 外部連携に移動し、作成 Connectionをクリックしてください。
  2. カスタム サービスタブをクリックしてください。
  3. Zoom 予定という名前をサービスにつけてください。
  4. サービスリンクの名前を入力してください。
  5. 認証の種類をOAuth 2に設定してください。
  6. Parameterの種類をヘッダーに、Grant 種類をクライアント資格情報に設定してください。
  7. 以下の情報を提供してください:
    1. クライアントID : {your_client_id}
    2. Client シークレット : {your_client_secret}
    3. 認証 URL : https://zoom.us/oauth/認証
    4. Access Token URL : https://zoom.us/oauth/token
    5. 更新する Token URL : https://zoom.us/oauth/token
  8. Connectionに名前をつけてください。
  9. Zoomに指定された範囲で接続のスコープを提供してください。
  10. 作成サービスをクリックしてください。
  11. サービス概要で作成 Connectionをクリックしてください。
  12. 接続詳細ページで作成し、接続するをクリックしてください。
  13. 外部連携が確立されると、完了メッセージが表示されます。接続概要画面に表示されるコードはカスタム関数で使用が可能です。
  14. この接続を呼び出すカスタム関数を作成できます。上に表示されたコードを使用することができます。取得/POST/PUT/削除の操作を実行できます。
以下のリンクで詳細情報が確認できます: