ऑब्जेक्ट वापस लाए जा रहे हैं

GoogleAdsService, Google Ads API की यूनिफ़ाइड ऑब्जेक्ट रीट्रिवल और रिपोर्टिंग सेवा है. इस सेवा में ऐसे तरीके शामिल हैं जिनसे:

  • ऑब्जेक्ट के खास एट्रिब्यूट हासिल करना.
  • तारीख की सीमा के आधार पर, ऑब्जेक्ट की परफ़ॉर्मेंस मेट्रिक हासिल करें.
  • ऑब्जेक्ट को उनकी विशेषताओं के आधार पर क्रम से लगाना.
  • शर्तों का इस्तेमाल करके बताएं कि आपको जवाब में कौनसे ऑब्जेक्ट चाहिए.
  • दिखाए जाने वाले ऑब्जेक्ट की संख्या सीमित करें.

GoogleAdsService दो तरीकों से नतीजे दिखा सकता है:

  • GoogleAdsService.SearchStream एक ही स्ट्रीमिंग रिस्पॉन्स में सभी लाइनें दिखाता है. यह बड़े (10,000 से ज़्यादा लाइनों वाले) रिज़ल्ट सेट के लिए ज़्यादा असरदार है. इसका सुझाव तब दिया जाता है, जब आपका ऐप्लिकेशन नतीजों के पूरे सेट डाउनलोड करता हो या पंक्तियों को स्ट्रीम के तौर पर प्रोसेस करता हो.
  • GoogleAdsService.Search, बड़े रिस्पॉन्स को नतीजों के ऐसे पेजों में बांटता है जिन्हें मैनेज करना आसान हो. यह तब काम आता है, जब आपका इंटरैक्टिव ऐप्लिकेशन एक बार में नतीजों का एक पेज दिखाता है.

पेजिंग और स्ट्रीमिंग के बीच के अंतर के बारे में ज़्यादा जानें.

अनुरोध करें

GoogleAdsService.SearchStream के लिए SearchGoogleAdsStreamRequest और GoogleAdsService.Search के लिए SearchGoogleAdsRequest की ज़रूरत होती है. दोनों तरह के अनुरोधों में ये शामिल हैं:

  • customer_id
  • Google Ads क्वेरी लैंग्वेज query, जिससे यह पता चलता है कि किस रिसॉर्स के लिए क्वेरी करनी है, कौनसे एट्रिब्यूट, सेगमेंट, और मेट्रिक वापस पाने हैं. साथ ही, किन शर्तों का इस्तेमाल करके यह तय करना है कि कौनसे ऑब्जेक्ट वापस नहीं पाने हैं

तरीके के आधार पर, अनुरोध में तरीके के हिसाब से फ़ील्ड भी इस्तेमाल किए जा सकते हैं:

  • SearchGoogleAdsStreamRequest (सिर्फ़ SearchStream):
    • एग्रीगेट की गई मेट्रिक वाली समरी लाइन का अनुरोध करने के लिए, वैकल्पिक summary_row_setting
  • SearchGoogleAdsRequest (सिर्फ़ Search):
    • पेजिंग का इस्तेमाल करते समय, नतीजों का अगला बैच पाने के लिए, वैकल्पिक page_token (page_size को 10,000 पंक्तियों पर तय किया गया है; अनुरोध में page_size सेट करने पर, RequestError.PAGE_SIZE_NOT_SUPPORTED गड़बड़ी होती है)
    • return_summary_row, return_total_results_count, और omit_results को कॉन्फ़िगर करने के लिए, search_settings मैसेज. हालांकि, यह ज़रूरी नहीं है
    • क्वेरी को लागू किए बिना उसकी पुष्टि करने के लिए, वैकल्पिक validate_only बूलियन

Google Ads क्वेरी लैंग्वेज के बारे में ज़्यादा जानने के लिए, Google Ads क्वेरी लैंग्वेज गाइड देखें.

जवाब प्रोसेस करना

GoogleAdsService, GoogleAdsRow ऑब्जेक्ट की सूची दिखाता है. ये ऑब्जेक्ट, स्ट्रीम किए गए SearchGoogleAdsStreamResponse बैच या पेज किए गए SearchGoogleAdsResponse में मौजूद होते हैं.

हर GoogleAdsRow, क्वेरी से मिले ऑब्जेक्ट को दिखाता है. इसमें एट्रिब्यूट का एक सेट होता है. यह सेट, SELECT क्लॉज़ में अनुरोध किए गए फ़ील्ड के आधार पर भरा जाता है. SELECT क्लॉज़ में शामिल नहीं किए गए एट्रिब्यूट, जवाब में GoogleAdsRow ऑब्जेक्ट में नहीं दिखते.

उदाहरण के लिए, भले ही ad_group_criterion में status एट्रिब्यूट हो, लेकिन पंक्ति के ad_group_criterion एट्रिब्यूट का status फ़ील्ड, उस क्वेरी के जवाब में नहीं भरा जाता है जिसमें SELECT क्लॉज़ में ad_group_criterion.status शामिल नहीं होता है. इसी तरह, अगर SELECT क्लॉज़ में campaign रिसॉर्स का कोई फ़ील्ड शामिल नहीं है, तो पंक्ति का campaign एट्रिब्यूट पॉप्युलेट नहीं होता.

नतीजों के एक ही सेट में, हर GoogleAdsRow के एट्रिब्यूट और मेट्रिक, दूसरी पंक्ति से अलग हो सकते हैं. इसलिए, पंक्तियों को टेबल की तय पंक्तियों के बजाय ऑब्जेक्ट के तौर पर देखा जाना चाहिए.

UNKNOWN और UNSPECIFIED enum टाइप

UNKNOWN की enum वैल्यू के साथ दिखाए जाने वाले रिसॉर्स, एपीआई के उस वर्शन में पूरी तरह से काम नहीं करते. वहीं, UNSPECIFIED से पता चलता है कि SELECT क्लॉज़ में कोई enum फ़ील्ड सेट नहीं किया गया है या उसके लिए अनुरोध नहीं किया गया है. UNKNOWN enum वैल्यू वाले संसाधनों को Google Ads यूज़र इंटरफ़ेस (यूआई) जैसे अन्य इंटरफ़ेस से बनाया जा सकता है. जब किसी संसाधन का टाइप UNKNOWN हो, तब मेट्रिक चुनी जा सकती हैं. हालांकि, एपीआई का इस्तेमाल करके संसाधन में बदलाव नहीं किया जा सकता. इसका एक उदाहरण, यूज़र इंटरफ़ेस (यूआई) में उपलब्ध ऐसा कैंपेन या विज्ञापन का टाइप है जो एपीआई के उस वर्शन में काम नहीं करता है जिसके लिए क्वेरी की जा रही है.

इन बातों का ध्यान रखें:

  • UNKNOWN टाइप वाले संसाधन को एपीआई के बाद के वर्शन में इस्तेमाल किया जा सकता है या उसे हमेशा के लिए UNKNOWN के तौर पर रखा जा सकता है.
  • UNKNOWN टाइप के नए ऑब्जेक्ट कभी भी दिख सकते हैं. ये ऑब्जेक्ट, पुराने सिस्टम के साथ काम करते हैं, क्योंकि UNKNOWN enum वैल्यू, एपीआई के हर enum में मौजूद होती है. संसाधन UNKNOWN के साथ दिखाए जाते हैं, ताकि आपको अपने खाते की परफ़ॉर्मेंस मेट्रिक की सटीक जानकारी मिल सके.
  • UNKNOWN संसाधनों में, ज़्यादा जानकारी वाली मेट्रिक अटैच की जा सकती हैं. इन मेट्रिक के बारे में क्वेरी की जा सकती है.
  • UNKNOWN संसाधन, आम तौर पर Google Ads के यूज़र इंटरफ़ेस (यूआई) में पूरी तरह से दिखते हैं.
  • आम तौर पर, एपीआई की मदद से UNKNOWN संसाधनों में बदलाव नहीं किया जा सकता.

सेगमेंटेशन

जवाब में, इनमें से हर कॉम्बिनेशन के लिए एक GoogleAdsRow शामिल होता है:

  • FROM क्लॉज़ में बताए गए मुख्य संसाधन का इंस्टेंस
  • चुने गए हर segments फ़ील्ड की वैल्यू

उदाहरण के लिए, FROM campaign को चुनने वाली क्वेरी के जवाब में, SELECT क्लॉज़ में segments.ad_network_type और segments.date शामिल होते हैं. इसमें, इनमें से हर कॉम्बिनेशन के लिए एक लाइन होती है:

  • campaign
  • segments.ad_network_type
  • segments.date

नतीजों को मुख्य संसाधन के हर इंस्टेंस के हिसाब से सेगमेंट किया जाता है, न कि चुने गए अलग-अलग फ़ील्ड की वैल्यू के हिसाब से. उदाहरण के लिए,

SELECT campaign.status, metrics.impressions
FROM campaign
WHERE segments.date DURING LAST_14_DAYS

हर कैंपेन के लिए एक लाइन में नतीजे दिखते हैं. campaign.status फ़ील्ड की हर अलग वैल्यू के लिए एक लाइन में नतीजे नहीं दिखते.

पीछे जाएं
ऑब्जेक्ट बदलना
आगे बढ़ें
संसाधन मेटाडेटा