示例

本指南包含一些示例，这些示例介绍了如何在不使用客户端库的情况下直接调用 REST 端点。

前提条件

要使用 curl 命令，可以轻松地将以下所有示例复制并粘贴到 bash shell 中。您需要一个 Search Ads 360 经理帐号，且该帐号至少包含一个客户帐号。

重要提示 ：在这些示例中，我们假定您正在访问客户帐号 (CUSTOMER_ID)，该用户对直接管理客户帐号的经理帐号 (MANAGER_CUSTOMER_ID) 拥有管理员权限。如果您要直接访问单个客户帐号，请省略 login-customer-id 标头或将其设置为与 CUSTOMER_ID 相同的值。

环境变量

在下方输入帐号凭据和 ID，然后复制并粘贴到您的终端中，以配置后续示例中使用的环境变量。

注意 ：授权指南提供了有关如何生成 OAuth 2.0 访问令牌的说明。

API_VERSION="0"
OAUTH2_ACCESS_TOKEN="OAUTH_ACCESS_TOKEN"
MANAGER_CUSTOMER_ID="MANAGER_CUSTOMER_ID"
CUSTOMER_ID="CUSTOMER_ID"

其他可选对象 ID

以下示例适用于已经存在的广告系列。如果您有要用于这些示例的现有广告系列的 ID，请在下面输入。

CAMPAIGN_ID=CAMPAIGN_ID

分页搜索

search 方法使用分页，在 query 旁边指定可调整的 pageSize 参数。

cURL

#!/bin/bash
# [START curl_command]
curl -f --request POST "https://searchads360.googleapis.com/v${API_VERSION}/customers/${CUSTOMER_ID}/searchAds360:search" \
--header "Content-Type: application/json" \
--header "login-customer-id: ${MANAGER_CUSTOMER_ID}" \
--header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \
--data '{
"pageSize": 10,
"query": "
  SELECT campaign.name,
    campaign_budget.amount_micros,
    campaign.status,
    campaign.advertising_channel_type,
    metrics.clicks,
    metrics.impressions,
    metrics.ctr,
    metrics.average_cpc,
    metrics.cost_micros,
    campaign.bidding_strategy_type
  FROM campaign
  WHERE segments.date DURING LAST_7_DAYS
    AND campaign.status != 'REMOVED'
"
}'
# [END curl_command]

SA360 查询语言

  SELECT campaign.name,
    campaign_budget.amount_micros,
    campaign.status,
    campaign.advertising_channel_type,
    metrics.clicks,
    metrics.impressions,
    metrics.ctr,
    metrics.average_cpc,
    metrics.cost_micros,
    campaign.bidding_strategy_type
  FROM campaign
  WHERE segments.date DURING LAST_7_DAYS
    AND campaign.status != 'REMOVED'

流式处理

searchStream 方法会在单个响应中流式传输所有结果，因此不支持 pageSize 字段。

cURL

#!/bin/bash
# [START curl_command]
curl -f --request POST "https://searchads360.googleapis.com/v${API_VERSION}/customers/${CUSTOMER_ID}/searchAds360:searchStream" \
--header "Content-Type: application/json" \
--header "login-customer-id: ${MANAGER_CUSTOMER_ID}" \
--header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \
--data '{
"query": "
  SELECT campaign.name,
    campaign_budget.amount_micros,
    campaign.status,
    campaign.advertising_channel_type,
    metrics.clicks,
    metrics.impressions,
    metrics.ctr,
    metrics.average_cpc,
    metrics.cost_micros,
    campaign.bidding_strategy_type
  FROM campaign
  WHERE segments.date DURING LAST_7_DAYS
    AND campaign.status != 'REMOVED'
"
}'
# [END curl_command]

SA360 查询语言

  SELECT campaign.name,
    campaign_budget.amount_micros,
    campaign.status,
    campaign.advertising_channel_type,
    metrics.clicks,
    metrics.impressions,
    metrics.ctr,
    metrics.average_cpc,
    metrics.cost_micros,
    campaign.bidding_strategy_type
  FROM campaign
  WHERE segments.date DURING LAST_7_DAYS
    AND campaign.status != 'REMOVED'