範例

本指南提供直接呼叫 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'