उदाहरण

इस गाइड में, क्लाइंट लाइब्रेरी का इस्तेमाल किए बिना, REST एंडपॉइंट को सीधे कॉल करने के उदाहरण दिए गए हैं.

ज़रूरी शर्तें

नीचे दिए गए सभी सैंपल इस तरह बनाए गए हैं कि curl कमांड का इस्तेमाल करके, बैश शेल में आसानी से कॉपी करके चिपकाया जा सकता है. आपके पास ऐसा Search Ads 360 मैनेजर खाता होना चाहिए जिसमें कम से कम एक क्लाइंट खाता हो.

अहम जानकारी: इन उदाहरणों में, हम मानते हैं कि आपने किसी ऐसे उपयोगकर्ता से क्लाइंट खाते (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 वाला तरीका, पेज पर नंबर डालने की प्रक्रिया का इस्तेमाल करता है. इसमें query के साथ बताए गए pageSize पैरामीटर को अडजस्ट किया जा सकता है.

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'