उदाहरण

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

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

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