LinkedIn

LinkedIn 連接器可讓您對 LinkedIn 資料執行讀取作業。

事前準備

在 Google Cloud 專案中，執行下列工作：

  • 確認已設定網路連線。如要瞭解網路模式，請參閱「網路連線」。
  • 將 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」>「Connections」頁面，然後選取或建立 Google Cloud 專案。

    前往「連線」頁面

  2. 按一下「+ 建立新連線」，開啟「建立連線」頁面。
  3. 在「位置」部分中，選擇連線的位置。
    1. 區域：從下拉式清單中選取位置。

      如需所有支援區域的清單，請參閱「地點」一文。

    2. 點按「下一步」。
  4. 在「連線詳細資料」部分，完成下列步驟：
    1. 連接器：從可用連接器的下拉式清單中選取「LinkedIn」。
    2. 連接器版本：從可用版本的下拉式清單中選取連接器版本。
    3. 在「連線名稱」欄位中，輸入連線執行個體的名稱。

      連線名稱必須符合下列條件：

      • 連線名稱可使用英文字母、數字或連字號。
      • 字母必須為小寫。
      • 連線名稱開頭須為英文字母，結尾則須為英文字母或數字。
      • 連結名稱不得超過 49 個半形字元。
    4. 視需要輸入連線執行個體的「Description」(說明)。
    5. 或者，可啟用 Cloud Logging，然後選取記錄層級。記錄層級預設為 Error。
    6. 服務帳戶：選取具備必要角色的服務帳戶。
    7. 視需要設定「連線節點設定」：

      • 節點數下限：輸入連線節點的數量下限。
      • 節點數上限：輸入連線節點數上限。

      節點是用來處理交易的連線單位 (或備用資源)。如要處理更多連線交易，就需要更多節點；反之，如要處理較少的交易，則需要較少的節點。如要瞭解節點對連線器價格的影響，請參閱「 連線節點的定價」。如未輸入任何值，系統預設會將節點下限設為 2 (提高可用性)，節點上限則設為 50。

    8. 公司 ID：貴機構專屬的 LinkedIn 公司 ID。如果在查詢中指定公司 ID，請使用下列格式：urn:li:organization:COMPANY_ID。
    9. 點按「下一步」。
    10. 在「授權」部分，輸入用戶端 ID 和用戶端密鑰的詳細資料。
      • 用戶端 ID：用於要求存取權杖的用戶端 ID。
      • 範圍：以半形逗號分隔的清單，列出 LinkedIn 開發人員帳戶中所需的範圍。
      • 用戶端密鑰：Secret Manager 密鑰，內含您建立的已連結應用程式用戶端密鑰。
      • 密鑰版本：所選密鑰的密鑰版本。
    11. 按一下「下一步」。
    12. 檢查：檢查連結和驗證詳細資料。
    13. 點選「建立」。

    系統限制

    每個節點的 LinkedIn 連接器每秒最多可處理 5 筆交易，並限制任何超出此限制的交易。LinkedIn 會對每位使用者設下限制，每 24 小時最多可發出 1 萬次要求。

    根據預設，Integration Connectors 會為連線分配 2 個節點 (以提高可用性)。

    如要瞭解 Integration Connectors 適用的限制，請參閱「限制」一文。

    在整合服務中使用 LinkedIn 連結

    建立連線後，Apigee Integration 和 Application Integration 都會提供該連線。您可以在整合中透過「連接器」工作使用連線。

    • 如要瞭解如何在 Apigee Integration 中建立及使用連接器工作，請參閱「連接器工作」。
    • 如要瞭解如何在 Application Integration 中建立及使用連接器工作，請參閱「連接器工作」。

    實體

    LinkedIn 連接器支援留言和個人資料等實體。如要瞭解如何設定實體，請參閱實體範例。

    實體作業範例

    範例 - 列出 LinkedIn 個人資料頁面的所有留言。

    這個範例會列出您管理的機構頁面中，所有貼文的留言

    1. 在 Configure connector task 對話方塊中，按一下 Entities。
    2. 從 Entity 清單中選取「留言」。
    3. 選取 LIST 作業，然後按一下「完成」。

    範例 - 依據特定 ID 取得設定檔

    這個範例會根據 Profiles 實體的 ID 取得設定檔。

    1. 在 Configure connector task 對話方塊中，按一下 Entities。
    2. 從 Entity 清單中選取 Profiles。
    3. 選取 GET 作業，然後按一下「完成」。
    4. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下「entityId」， 然後在「Default Value」(預設值) 欄位中輸入 2t7k5s4fgC。

      其中 Id [KEY] 是 Profiles 實體的主鍵值。

    5. 按一下「完成」。

    向 Google Cloud 社群尋求協助

    如要發布問題及討論這個連接器，請前往 Cloud 論壇的 Google Cloud 社群。

    後續步驟