مثال‌ها

این راهنما حاوی نمونه‌هایی از فراخوانی مستقیم نقاط پایانی REST بدون استفاده از کتابخانه کارخواه است.

پیش‌نیازها

همه نمونه‌های زیر به‌گونه‌ای طراحی شده‌اند که به‌راحتی بتوان آن‌ها را بااستفاده از فرمان curl در bash shell کپی و جای‌گذاری کرد. به حساب مدیر Search Ads 360 که حداقل یک حساب مشتری داشته باشد نیاز دارید.

متغیرهای محیطی

اعتبارنامه‌ها و شناسه‌های حساب را در زیر وارد کنید، سپس آن‌ها را در پایانه خود کپی و جای‌گذاری کنید تا متغیرهای محیطی استفاده‌شده در مثال‌های بعدی پیکربندی شود.

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'