ตัวอย่าง

คู่มือนี้มีตัวอย่างการเรียกใช้ปลายทาง REST โดยตรงโดยไม่ต้องใช้ไลบรารีไคลเอ็นต์

ข้อกำหนดเบื้องต้น

ตัวอย่างทั้งหมดด้านล่างมีไว้เพื่อให้คุณคัดลอกและวางลงใน bash shell โดยใช้คำสั่ง curl ได้อย่างง่ายดาย คุณจะต้องมีบัญชีดูแลจัดการ Search Ads 360 ที่มีบัญชีลูกค้าอย่างน้อย 1 บัญชี

สำคัญ: ในตัวอย่างนี้ เราถือว่าคุณเข้าถึงบัญชีลูกค้า (CUSTOMER_ID) โดยผู้ใช้ที่มีสิทธิ์เข้าถึงระดับผู้ดูแลระบบในบัญชีดูแลจัดการ (MANAGER_CUSTOMER_ID) ที่จัดการบัญชีลูกค้าโดยตรง หากคุณเข้าถึงบัญชีลูกค้าแต่ละบัญชีโดยตรง ให้ละเว้นส่วนหัว login-customer-id หรือตั้งค่าเป็นค่าเดียวกับ CUSTOMER_ID

ตัวแปรสภาพแวดล้อม

ป้อนข้อมูลเข้าสู่ระบบและรหัสบัญชีด้านล่าง จากนั้นคัดลอกและวางลงในเทอร์มินัลเพื่อกําหนดค่าตัวแปรสภาพแวดล้อมที่ใช้ในตัวอย่างต่อๆ ไป

หมายเหตุ: คู่มือการให้สิทธิ์มีวิธีการสร้างโทเค็นการเข้าถึง OAuth 2.0

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

รหัสออบเจ็กต์เพิ่มเติม (ไม่บังคับ)

ตัวอย่างต่อไปนี้ใช้ได้กับแคมเปญที่มีอยู่ หากคุณมีรหัสของแคมเปญที่มีอยู่เพื่อใช้กับตัวอย่างเหล่านี้ ให้ป้อนรหัสด้านล่าง

CAMPAIGN_ID=CAMPAIGN_ID

การค้นหาแบบแบ่งหน้า

เมธอด search ใช้การแบ่งหน้าเว็บ โดยมีพารามิเตอร์ pageSize ที่ปรับได้ซึ่งระบุไว้ข้าง 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]

ภาษาคําค้นหาของ 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'