مثال ها

این راهنما شامل نمونه هایی از فراخوانی مستقیم نقاط انتهایی 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 مشخص شده است.

حلقه

#!/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 پشتیبانی نمی‌شود.

حلقه

#!/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'