Ví dụ

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

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

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

Lưu ý quan trọng: Trong những ví dụ này, chúng tôi giả định rằng bạn đang truy cập vào tài khoản khách hàng (CUSTOMER_ID) bởi một người dùng có quyền quản trị đối với tài khoản người quản lý (MANAGER_CUSTOMER_ID) trực tiếp quản lý tài khoản khách hàng đó. Thay vào đó, nếu bạn truy cập trực tiếp vào một tài khoản khách hàng cá nhân, hãy bỏ qua tiêu đề login-customer-id hoặc đặt tiêu đề này thành cùng một giá trị với CUSTOMER_ID.

Biến môi trường

Nhập thông tin đăng nhập và mã nhận dạng 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 dùng trong các ví dụ tiếp theo.

Lưu ý: Hướng dẫn Uỷ quyền cung cấp thông tin hướng dẫn cách tạo mã truy cập OAuth 2.0.

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

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

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

CAMPAIGN_ID=CAMPAIGN_ID

Tìm kiếm được phân trang

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 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'

Phát trực tiếp

Phương thức searchStream truyền trực tuyến 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 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'