使用创建Google Ads基本连接 Flow Service API

注意

Google广告源为测试版。 请参阅 源概述 有关使用测试版标记源的更多信息。

基本连接表示源和Adobe Experience Platform之间经过身份验证的连接。

本教程将指导您完成使用为Google Ads创建基本连接的步骤。 Flow Service API.

快速入门

本指南要求您对Adobe Experience Platform的以下组件有一定的了解:

  • :Experience Platform允许从各种源摄取数据,同时让您能够使用Experience Platform服务来构建、标记和增强传入数据。
  • 沙盒:Experience Platform提供可将单个Experience Platform实例划分为多个单独的虚拟环境的虚拟沙箱,以帮助开发和改进数字体验应用程序。

Google以下部分提供了您需要了解的其他信息,以便您能够使用 Flow Service API。

收集所需的凭据

为了 Flow Service 要与Google Ads连接,您必须提供以下连接属性的值:

凭据 描述
clientCustomerId 客户端客户ID是与您要使用Google Ads API管理的Google Ads客户端帐户对应的帐号。 此ID遵循的模板 123-456-7890.
loginCustomerId 登录客户ID是与您的Google Ads管理器帐户对应的帐号,用于从特定的运营客户获取报表数据。 有关登录客户ID的更多信息,请阅读 Google Ads API文档.
developerToken 通过开发人员令牌,您可以访问Google Ads API。 您可以使用相同的开发人员令牌针对您的所有Google Ads帐户发出请求。 通过以下方式检索您的开发人员令牌 登录到您的经理帐户 然后导航到 API Center 页面。
refreshToken 刷新令牌是的一部分 OAuth2 身份验证。 此令牌允许您在访问令牌过期后重新生成访问令牌。
clientId 客户端ID与客户端密钥一起使用,作为的一部分 OAuth2 身份验证。 客户端ID和客户端密钥共同支持您的应用程序通过向Google标识来代表您的帐户运行。
clientSecret 客户端密钥与客户端ID一起使用,作为的一部分 OAuth2 身份验证。 客户端ID和客户端密钥共同支持您的应用程序通过向Google标识来代表您的帐户运行。
connectionSpec.id 连接规范返回源的连接器属性,包括与创建基础连接和源连接相关的身份验证规范。 Google Ads的连接规范ID为: d771e9c1-4f26-40dc-8617-ce58c4b53702.

阅读API概述文档,了解 有关Google Ads入门的更多信息.

使用平台API

有关如何成功调用Platform API的信息,请参阅 Platform API快速入门.

创建基本连接

基本连接会保留源和平台之间的信息,包括源的身份验证凭据、连接的当前状态以及唯一的基本连接ID。 基本连接ID允许您浏览和浏览源中的文件,并标识要摄取的特定项目,包括有关其数据类型和格式的信息。

POST要创建基本连接ID,请向 /connections 端点,同时将您的Google Ads身份验证凭据作为请求参数的一部分提供。

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}",
              "authenticationType": "{AUTHENTICATION_TYPE}"
              "clientId": "{CLIENT_ID}",
              "clientSecret": "{CLIENT_SECRET}",
              "refreshToken": "{REFRESH_TOKEN}"
          }
      },
      "connectionSpec": {
          "id": "d771e9c1-4f26-40dc-8617-ce58c4b53702",
          "version": "1.0"
      }
  }'
属性 描述
auth.params.clientCustomerID 您的Google Ads帐户的客户端客户ID。
auth.params.loginCustomerID 与您的Google广告管理器帐户对应的登录客户ID。
auth.params.developerToken Google Ads帐户的开发人员令牌。
auth.params.refreshToken Google Ads帐户的刷新令牌。
auth.params.clientID Google Ads帐户的客户端ID。
auth.params.clientSecret Google Ads帐户的客户端密钥。
connectionSpec.id Google Ads连接规范ID: d771e9c1-4f26-40dc-8617-ce58c4b53702.

响应

成功响应将返回新创建的基本连接的详细信息,包括其唯一标识符(id)。 在下一步中创建源连接时需要此ID。

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

后续步骤

在本教程之后,您已使用创建了Google Ads基本连接。 Flow Service API。 您可以在以下教程中使用此基本连接ID:

在此页面上