範例

本指南包含直接呼叫 REST 端點的範例，而未使用用戶端程式庫。

必要條件

以下所有範例皆可供您使用 curl 指令，輕鬆複製與貼上至 bash 殼層。您必須擁有至少一個客戶帳戶的 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'