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

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

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

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

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

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

अनुरोध करें

खोज के तरीके के लिए ज़रूरी है SearchGoogleAdsRequest, जिसमें यह शामिल है यहां दी गई जानकारी में से:

• customer_id
• Google Ads की क्वेरी लैंग्वेज query, जो बताती है कि किस रिसॉर्स के लिए क्वेरी करनी है, एट्रिब्यूट, फिर से हासिल किए जाने वाले सेगमेंट, मेट्रिक, और सीमित करने के लिए इस्तेमाल की जाने वाली शर्तें कौनसे ऑब्जेक्ट दिखाए जाते हैं
• (सिर्फ़ GoogleAdsService.Search) A page_size यह बताने के लिए कि एक प्रतिक्रिया में कितने ऑब्जेक्ट वापस करने हैं पेजिंग का इस्तेमाल करके.
• (सिर्फ़ GoogleAdsService.Search) इसका उपयोग करते समय परिणामों का अगला बैच पुनर्प्राप्त करने के लिए वैकल्पिक page_token पेजिंग.

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

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

GoogleAdsService, GoogleAdsRow ऑब्जेक्ट.

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

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

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

UNKNOWN enum टाइप

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

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

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

सेगमेंट करने की सुविधा

रिस्पॉन्स में, कन्वर्ज़न वैल्यू के हर कॉम्बिनेशन के लिए एक GoogleAdsRow होगा फ़ॉलो किया जा रहा है:

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

उदाहरण के लिए, ऐसी क्वेरी का जवाब जो 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 फ़ील्ड.