Ví dụ

Hướng dẫn này chứa các ví dụ về việc gọi trực tiếp các điểm cuối REST mà không cần dùng thư viện ứng dụng.

Điều kiện tiên quyết

Bạn có thể dễ dàng sao chép và dán tất cả mẫu bên dưới vào một shell bash bằng lệnh curl. Bạn sẽ cần một tài khoản người quản lý Search Ads 360 có chứa ít nhất một tài khoản khách hàng.

Biến môi trường

Nhập thông tin đăng nhập tài khoản và mã tài khoản bên dưới, sau đó sao chép và dán vào thiết bị đầu cuối để định cấu hình các biến môi trường được dùng trong các ví dụ tiếp theo.

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

Mã đối tượng không bắt buộc bổ sung

Các ví dụ sau đây hoạt động trên các chiến dịch đã có từ trước. Nếu bạn có mã của một chiến dịch hiện có để dùng với các ví dụ này, hãy nhập mã đó bên dưới.

CAMPAIGN_ID=CAMPAIGN_ID

Phương thức search sử dụng tính năng phân trang, với tham số pageSize có thể điều chỉnh được chỉ định cùng với query.

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]

Ngôn ngữ truy vấn Search Ads 360

  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'

Phát trực tiếp

Phương thức searchStream phát trực tiếp tất cả kết quả trong một phản hồi duy nhất, do đó, trường pageSize không được hỗ trợ.

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]

Ngôn ngữ truy vấn Search Ads 360

  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'