उदाहरण

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

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

यहां दिए गए सभी सैंपल को curl कमांड का इस्तेमाल करके, bash shell में आसानी से कॉपी करके चिपकाया जा सकता है. इसके लिए, आपके पास 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'