LinkedIn

LinkedIn コネクタを使用すると、LinkedIn データに対して読み取りオペレーションを実行できます。

始める前に

Google Cloud プロジェクトで次のタスクを行います。

  • ネットワーク接続が設定されていることを確認します。ネットワーク パターンの詳細については、Network Connectivity をご覧ください。
  • コネクタを構成するユーザーに roles/connectors.admin IAM ロールを付与します。
  • コネクタに使用するサービス アカウントに、roles/secretmanager.viewer と roles/secretmanager.secretAccessor の IAM ロールを付与します。
  • 次のサービスを有効にします。
    • secretmanager.googleapis.com（Secret Manager API）
    • connectors.googleapis.com（Connectors API）

    サービスを有効にする方法については、サービスを有効にするをご覧ください。以前にプロジェクトでこうしたサービスを有効にしていない場合は、コネクタを構成するときに有効にするよう求められます。

コネクタを構成する

接続はデータソースに特有です。つまり、多数のデータソースがある場合は、データソースごとに別々の接続を作成する必要があります。接続を作成する手順は次のとおりです。

  1. Cloud コンソールで、[Integration Connectors] > [接続] ページに移動し、Google Cloud プロジェクトを選択または作成します。

    [接続] ページに移動

  2. [+ 新規作成] をクリックして [接続の作成] ページを開きます。
  3. [ロケーション] セクションで、接続のロケーションを選択します。
    1. リージョン: プルダウン リストからロケーションを選択します

      サポートされているすべてのリージョンのリストについては、ロケーションをご覧ください。

    2. [NEXT] をクリックします。
  4. [接続の詳細] セクションで、次の操作を行います。
    1. コネクタ: 使用可能なコネクタのプルダウン リストから [LinkedIn] を選択します。
    2. コネクタのバージョン: 使用可能なバージョンのプルダウン リストからコネクタのバージョンを選択します。
    3. [接続名] フィールドに、接続インスタンスの名前を入力します。

      接続名は次の条件を満たす必要があります。

      • 接続名には英字、数字、ハイフンを使用できます。
      • 文字は小文字のみを使用できます。
      • 接続名の先頭には英字を設定し、末尾には英字または数字を設定する必要があります。
      • 接続名は 49 文字以内で指定してください。
    4. 必要に応じて、接続インスタンスの [説明] を入力します。
    5. 必要に応じて、Cloud Logging を有効にして、ログレベルを選択します。デフォルトのログレベルは Error に設定されています。
    6. サービス アカウント: 必要なロールを持つサービス アカウントを選択します。
    7. 必要に応じて、接続ノードの設定を構成します。

      • ノードの最小数: 接続ノードの最小数を入力します。
      • ノードの最大数: 接続ノードの最大数を入力します。

      ノードは、トランザクションを処理する接続の単位（またはレプリカ）です。1 つの接続でより多くのトランザクションを処理するには、より多くのノードが必要になります。逆に、より少ないトランザクションを処理するには、より少ないノードが必要になります。ノードがコネクタの料金に与える影響については、接続ノードの料金をご覧ください。値を入力しない場合は、デフォルトで最小ノード数は 2 に設定され（可用性を高めるため）、最大ノード数は 50 に設定されます。

    8. Company Id: 組織に固有の LinkedIn の会社 ID。クエリで会社 ID を指定する場合は、urn:li:organization:COMPANY_ID の形式を使用します。
    9. [NEXT] をクリックします。
    10. [承認] セクションで、クライアント ID とクライアント シークレットの詳細を入力します。
      • クライアント ID: アクセス トークンのリクエストに使用されるクライアント ID。
      • スコープ: LinkedIn デベロッパー アカウントで必要なスコープのカンマ区切りのリスト。
      • クライアント シークレット: 作成した接続されているアプリのクライアント シークレットを含む Secret Manager のシークレットです。
      • シークレットのバージョン: 選択したシークレットのシークレット バージョン。
    11. [次へ] をクリックします。
    12. Review: 接続と認証の詳細を確認します。
    13. [作成] をクリックします。

    システムの上限

    LinkedIn コネクタは、ノードごとに 1 秒あたり最大 5 件のトランザクションを処理でき、この上限を超えるトランザクションはすべてスロットルされます。LinkedIn では、ユーザーあたり 24 時間あたり 1 万件のリクエストの上限が適用されます。

    デフォルトでは、Integration Connectors は、接続に 2 つのノードを割り当てます（可用性を高めるため）。

    Integration Connectors に適用される上限の詳細については、上限をご覧ください。

    統合で LinkedIn 接続を使用する

    接続を作成すると、Apigee Integration と Application Integration の両方で使用できるようになります。この接続は、コネクタタスクを介して統合で使用できます。

    • Apigee Integration で Connectors タスクを作成して使用する方法については、Connectors タスクをご覧ください。
    • Application Integration で Connectors タスクを作成して使用する方法については、Connectors タスクをご覧ください。

    エンティティ

    LinkedIn コネクタは、コメントやプロフィールなどのエンティティをサポートしています。エンティティの構成方法については、エンティティの例をご覧ください。

    エンティティ オペレーションの例

    例 - LinkedIn のプロフィール ページのコメントをすべて一覧表示します。

    この例では、管理している組織ページの投稿のコメントをすべて一覧表示します。

    1. [Configure connector task] ダイアログで、[Entities] をクリックします。
    2. Entity リストから Comments を選択します。
    3. [LIST] オペレーションを選択してから、[完了] をクリックします。

    例 - 特定の ID からプロファイルを取得する

    この例では、Profiles エンティティの ID に基づいてプロファイルを取得します。

    1. [Configure connector task] ダイアログで、[Entities] をクリックします。
    2. Entity から Profiles を選択します。
    3. [GET] オペレーションを選択してから、[完了] をクリックします。
    4. [コネクタ] タスクの [タスク入力] セクションで [entityId] をクリックし、[デフォルト値] フィールドに 2t7k5s4fgC を入力します。

      ここで、Id [KEY] は Profiles エンティティの主キー値です。

    5. [完了] をクリックします。

    Google Cloud コミュニティの助けを借りる

    Google Cloud コミュニティの Cloud フォーラムで質問を投稿したり、このコネクタについてディスカッションしたりできます。

    次のステップ