[beta]{class="badge informative"}

使用Flow Service API将Google Ads连接到Experience Platform

最近更新： 2026年7月29日

主题：
Sources

创建对象：

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

NOTE

Google Ads源当前为测试版，仅支持一次性摄取。有关使用测试版标记源的更多信息，请参阅源概述。

基本连接表示源与Adobe Experience Platform之间的已验证连接。使用本教程通过Flow Service API将您的Google Ads帐户连接到Experience Platform。

Google Ads基本连接存储访问Google Ads API所需的身份验证详细信息，并创建连接ID，您将在后续步骤中使用该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帐户的客户端客户ID。

auth.params.loginCustomerID

与您的Google Ads经理帐户对应的登录客户ID。

auth.params.developerToken

Google Ads帐户的开发人员令牌。

auth.params.refreshToken

Google Ads帐户的刷新令牌。

auth.params.clientID

Google Ads帐户的客户端ID。

auth.params.clientSecret

Google Ads帐户的客户端密钥。

auth.params.googleAdsApiVersion

您正在使用的Google Ads API版本。 Experience Platform当前支持版本v19及更高版本。确保使用这些受支持的版本之一以确保兼容性。

connectionSpec.id

Google Ads连接规范ID： 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广告数据引入Experience Platform。

故障排除

子广告商帐户的授权错误

如果在您尝试访问子广告商帐户时请求失败，请验证loginCustomerId是否设置为正确的经理帐户。当通过MCC层次结构来调解访问时，这是必需的。

刷新令牌无效或吊销

如果连接器无法刷新访问令牌，请重新授权Google Ads帐户以生成新的刷新令牌。

不支持的API版本

如果由于版本不匹配导致请求失败，请确保googleAdsApiVersion设置为Experience Platform支持的版本。

recommendation-more-help

experience-platform-help-sources