مثال‌ها

این راهنما شامل نمونه هایی از فراخوانی مستقیم نقاط انتهایی REST بدون استفاده از کتابخانه مشتری است.

پیش نیازها

تمام نمونه‌های زیر با استفاده از دستور curl به راحتی قابل کپی و چسباندن در یک پوسته bash هستند. به یک حساب مدیر 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'