[beta]{class="badge informative"}

使用Flow Service API連線Google Ads至Experience Platform

最後更新： 2026年7月29日

主題：
Sources

建立對象：

{"id":"ff6a42d2-313e-452e-93a6-792e4fad9ff8"}

NOTE

Google Ads來源目前是測試版，僅支援一次性內嵌。如需使用Beta版標籤來源的相關資訊，請參閱來源概觀。

基礎連線代表您的來源與Adobe Experience Platform之間的已驗證連線。使用本教學課程，使用Flow Service API將您的Google Ads帳戶連結至Experience Platform。

Google Ads基本連線會儲存存取Google Ads API所需的驗證詳細資訊，並建立您將在後續步驟中使用的連線ID，以探索您的來源設定並建立資料流。

開始使用

本指南需要您深入瞭解下列Experience Platform元件：

來源： Experience Platform允許從各種來源擷取資料，同時讓您能夠使用Experience Platform服務來建構、加標籤以及增強傳入的資料。
沙箱： Experience Platform提供的虛擬沙箱可將單一Experience Platform執行個體分割成個別的虛擬環境，以利開發及改進數位體驗應用程式。

下列章節提供您需瞭解的其他資訊，才能使用Flow Service API成功連線到Google Ads。

使用Experience Platform API

如需如何成功呼叫Experience Platform API的詳細資訊，請參閱Experience Platform API快速入門指南。

收集所需標頭的值

若要呼叫Experience Platform API，您必須先完成驗證教學課程。完成驗證教學課程將提供所有Experience Platform API呼叫中每個必要標題的值，如下所示：

Authorization: Bearer {ACCESS_TOKEN}
x-api-key: {API_KEY}
x-gw-ims-org-id: {ORG_ID}
x-sandbox-name: {SANDBOX_NAME}
Content-Type: application/json

Experience Platform中的所有資源都會隔離至特定的虛擬沙箱。對Experience Platform API的所有請求都要求標頭，用於指定將在其中進行操作的沙箱名稱。

收集必要的認證

如需驗證的詳細資訊，請閱讀Google Ads 來源概觀。

建立基礎連線

基本連線會保留來源與Experience Platform之間的資訊，包括來源的驗證認證、連線的目前狀態，以及唯一的基本連線ID。

若要建立基礎連線ID，請在提供您的Google Ads驗證認證作為要求引數的一部分時，對/connections端點提出POST要求。

API格式

POST /connections

要求

以下請求會建立Google Ads的基本連線：

curl -X POST \
  'https://platform.adobe.io/data/foundation/flowservice/connections' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Content-Type: application/json'
  -d '{
      "name": "Google Ads base connection",
      "description": "Google Ads base connection",
      "auth": {
          "specName": "Basic Authentication",
          "params": {
              "clientCustomerID": "{CLIENT_CUSTOMER_ID}",
              "loginCustomerID": "{LOGIN_CUSTOMER_ID}",
              "developerToken": "{DEVELOPER_TOKEN}",
              "refreshToken": "{REFRESH_TOKEN}",
              "clientId": "{CLIENT_ID}",
              "clientSecret": "{CLIENT_SECRET}",
              "googleAdsApiVersion": "v19"

          }
      },
      "connectionSpec": {
          "id": "d771e9c1-4f26-40dc-8617-ce58c4b53702",
          "version": "1.0"
      }
  }'

如果您的目標廣告商帳戶可直接存取，且不需要管理員帳戶路由，則可以從auth.params物件中省略loginCustomerID。

屬性

說明

name

基礎連線的名稱。使用描述性名稱，以便日後輕鬆識別Google Ads連線。

description

選用的說明，可用來儲存有關連線的其他內容。

auth.specName

聯結器使用的驗證型別。

auth.params.clientCustomerID

您Google Ads帳戶的使用者端客戶識別碼。

auth.params.loginCustomerID

與您的Google Ads管理員帳戶對應的登入客戶識別碼。

auth.params.developerToken

您Google Ads帳戶的開發人員權杖。

auth.params.refreshToken

您Google Ads帳戶的重新整理權杖。

auth.params.clientID

您Google Ads帳戶的使用者端識別碼。

auth.params.clientSecret

您Google Ads帳戶的使用者端密碼。

auth.params.googleAdsApiVersion

您正在使用的Google Ads API版本。 Experience Platform目前支援版本v19和更新版本。請確定您使用其中一個支援的版本，以確保相容性。

connectionSpec.id

Google Ads連線規格識別碼： d771e9c1-4f26-40dc-8617-ce58c4b53702。

回應

成功的回應會傳回新建立的基礎連線的詳細資料，包括其唯一識別碼(id)。建立來源連線的下一個步驟需要此ID。

{
    "id": "2484f2df-c057-4ab5-84f2-dfc0577ab592",
    "etag": "\"10033e77-0000-0200-0000-5e96785b0000\""
}

驗證您的連線詳細資料

建立基礎連線後，請先驗證下列專案再繼續：

基礎連線是在預期的沙箱中建立的，
clientCustomerId指向預期的廣告商帳戶，
如果廣告商帳戶是透過MCC存取，loginCustomerId是正確的，
Google Ads API版本支援Experience Platform。

如果驗證成功但下游資料存取失敗，最常見的原因是不正確或不必要的loginCustomerId。

後續步驟

依照本教學課程，您已使用流量服務API建立Google Ads基本連線。

您現在可以繼續下列教學課程：

探索您的來源組態以識別您要擷取的來源物件和欄位。
為廣告來源建立資料流，將Google Ads資料匯入Experience Platform。

疑難排解

子廣告商帳戶的授權錯誤

如果您嘗試存取子廣告商帳戶時要求失敗，請確認loginCustomerId已設定為正確的管理員帳戶。透過MCC階層介導存取時，需要此專案。

無效的或撤銷的重新整理權杖

如果聯結器無法重新整理存取權杖，請重新授權Google Ads帳戶以產生新的重新整理權杖。

不支援的API版本

如果要求因版本不符而失敗，請確定googleAdsApiVersion設定為Experience Platform支援的版本。

recommendation-more-help

experience-platform-help-sources