Google Ads API is returning to beta status. Please read our blog post for more details.

API 调用示例

此示例演示了如何使用 cURL 与 API 进行互动。虽然使用 cURL 和 HTTP + JSON 来构建实际应用可能不太现实,但此示例演示了 Google Ads API 在最低级别的层面上是如何发挥作用的。

我们将逐步讲解如何创建新的广告系列预算:从获取身份验证令牌到使用 cURL 发出调用。这些步骤会在我们的客户端库中自动处理。

  1. 获取您的 OAuth2 客户端 ID 和客户端密钥(如果您尚未完成这些操作的话)。按照 OAuth2 指南中的说明操作。

  2. 在您的 Google Cloud 项目中启用 Google Ads API。按照 OAuth2 指南中的说明操作。

  3. 获取 OAuth2 访问令牌。要从 OAuth2 请求访问令牌,请在以下网址中输入您的 OAuth2 客户端 ID,并将其粘贴到您的浏览器中:

    https://accounts.google.com/o/oauth2/auth?client_id=your-client-id&response_type=code&scope=https%3A%2F%2Fwww.googleapis.com%2Fauth%2Fadwords&redirect_uri=urn:ietf:wg:oauth:2.0:oob&access_type=offline&prompt=consent
    

    此时会出现一个屏幕,您可以在其中授予应用访问您的 Google Ads 数据的权限:

    接受请求后,您会收到一个可用来交换访问令牌的授权代码。

    最后,请发出使用授权代码交换访问令牌的请求:

    curl \
      -d code=AUTHORIZATION CODE \
      -d client_id=CLIENT ID \
      -d client_secret=CLIENT SECRET \
      -d redirect_uri=urn:ietf:wg:oauth:2.0:oob \
      -d grant_type=authorization_code https://accounts.google.com/o/oauth2/token
    

    如果您发出的请求准确适当,那么 Google 会返回您的 OAuth2 访问令牌。在向 Google Ads API 服务发送请求时,您需要使用该访问令牌(即下面代码中 "access_token" : 后以粗体显示的部分)。

    {
      "access_token" : "ya29.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
      "token_type" : "Bearer",
      "expires_in" : 3600,
      "refresh_token" : "1/Ixxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
    }
    
  4. 创建 REST 请求。下面的 JSON 会定义一个添加预算的请求。将此 JSON 另存为 create_budget.json

    {
      operations:
      [
        {
          create:
          {
            name: "new budget 234",
            amount_micros: "60000000"
          }
        }
      ]
    }
    
  5. 使用 cURL 将此请求发送给 CampaignBudgetService。将 1234567890 替换为您的 Google Ads 广告客户帐号的客户 ID,不带连字符。

    curl --request POST \
         --header "Content-Type: application/json" \
         --header "Authorization: Bearer ACCESS TOKEN" \
         --header "developer-token: DEVELOPER TOKEN" \
         --data @create_budget.json \
         https://googleads.googleapis.com/v1/customers/1234567890/campaignBudgets:mutate
    

响应

Google Ads API 服务器处理了您的请求后,会返回一个响应,其中包含用于代表新增预算的 JSON 数据。

{
  "results": [
    {
      "resourceName": "customers/1234567890/campaignBudgets/1xxxxxxxx1"
    }
  ]
}