GoogleAdsService
एक यूनिफ़ाइड ऑब्जेक्ट है
Google Ads API की रिकवरी और रिपोर्टिंग सेवा. इस सेवा का इस्तेमाल इन तरीकों से किया जा सकता है:
- ऑब्जेक्ट के खास एट्रिब्यूट वापस पाना.
- तारीख की सीमा के आधार पर ऑब्जेक्ट के लिए परफ़ॉर्मेंस मेट्रिक फिर से पाएं.
- ऑब्जेक्ट को उनकी विशेषताओं के आधार पर क्रम से लगाएं.
- शर्तों का इस्तेमाल करके बताएं कि आपको रिस्पॉन्स में कौनसे ऑब्जेक्ट वापस चाहिए.
- लौटाए गए ऑब्जेक्ट की संख्या सीमित करें.
GoogleAdsService
इन नतीजों में नतीजे दिखा सकता है
दो तरीके:
GoogleAdsService.SearchStream
एक स्ट्रीमिंग रिस्पॉन्स में सभी पंक्तियां दिखाता है, जो बड़े (10,000 से ज़्यादा पंक्तियों वाले) नतीजे के सेट का इस्तेमाल करें. यह ज़्यादा सही हो सकता है अगर आपका बैच ऐप्लिकेशन ज़्यादा से ज़्यादा डेटा को उतनी तेज़ी से डाउनलोड करना चाहता है किया जा सकता है.GoogleAdsService.Search
ब्रेक अप आसानी से मैनेज किए जा सकने वाले पेजों में बड़े जवाबों को शामिल करें. इसे और यह तब ठीक होगा, जब आपका इंटरैक्टिव ऐप्लिकेशन किसी पेज पर नतीजों का पेज समय.
पेजिंग बनाम स्ट्रीमिंग के बारे में ज़्यादा जानें.
अनुरोध करें
खोज के तरीके के लिए ज़रूरी है
SearchGoogleAdsRequest
, जिसमें यह शामिल है
यहां दी गई जानकारी में से:
customer_id
- Google Ads की क्वेरी लैंग्वेज
query
, जो बताती है कि किस रिसॉर्स के लिए क्वेरी करनी है, एट्रिब्यूट, फिर से हासिल किए जाने वाले सेगमेंट, मेट्रिक, और सीमित करने के लिए इस्तेमाल की जाने वाली शर्तें कौनसे ऑब्जेक्ट दिखाए जाते हैं - (सिर्फ़
GoogleAdsService.Search
) Apage_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
फ़ील्ड.