Google Ads API की इकाइयों और रिपोर्टिंग डेटा को वापस पाने के लिए, इनमें से किसी एक तरीके का इस्तेमाल करें:
यहां दोनों तरीकों के लिए ज़्यादा अंतर बताए गए हैं:
| GoogleAdsService.SearchStream | GoogleAdsService.Search | |
|---|---|---|
| प्रोडक्शन कोड के लिए सही है | हां | हां |
| सेवा | GoogleAdsService |
GoogleAdsService |
| स्थिति | ऑब्जेक्ट और रिपोर्ट को फ़ेच किया जा रहा है | ऑब्जेक्ट और रिपोर्ट को फ़ेच किया जा रहा है |
| जवाब | GoogleAdsRow ऑब्जेक्ट की स्ट्रीम |
GoogleAdsRow ऑब्जेक्ट के पेज |
| जवाब के फ़ील्ड | सिर्फ़ क्वेरी में बताए गए | सिर्फ़ क्वेरी में बताए गए |
| रोज़ाना इस्तेमाल की सीमा तय करना | ऐक्सेस लेवल के हिसाब से रोज़ाना इस्तेमाल की सीमा तय करना | ऐक्सेस लेवल के हिसाब से रोज़ाना इस्तेमाल की सीमा तय करना |
SearchStream बनाम Search
Search पूरी रिपोर्ट डाउनलोड करने के लिए, पेजों को क्रम में लगाने वाले कई अनुरोध भेज सकता है. वहीं, SearchStream एक ही अनुरोध भेजता है और रिपोर्ट के साइज़ की परवाह किए बिना, Google Ads API के साथ स्थायी कनेक्शन शुरू करता है.
SearchStream के लिए, डेटा पैकेट तुरंत डाउनलोड होना शुरू हो जाते हैं. साथ ही, डेटा बफ़र में पूरे नतीजे को कैश मेमोरी में सेव किया जाता है. आपका कोड, पूरी स्ट्रीम के खत्म होने का इंतज़ार किए बिना, बफ़र किए गए डेटा को पढ़ना शुरू कर सकता है.
आपके ऐप्लिकेशन के आधार पर, Search रिस्पॉन्स के हर पेज का अनुरोध करने के लिए, राउंड-ट्रिप में लगने वाला नेटवर्क समय कम करके, SearchStream खास तौर पर बड़ी रिपोर्ट के लिए, पेजिंग की तुलना में बेहतर परफ़ॉर्मेंस दे सकता है.
उदाहरण
उदाहरण के लिए, 100,000 पंक्तियों वाली एक रिपोर्ट लें. नीचे दी गई टेबल, दोनों तरीकों के बीच के अकाउंटिंग के अंतरों को बांटती है.
| SearchStream | रिपोर्ट में खोजना | |
|---|---|---|
| पेज का साइज़ | इस पर रेटिंग लागू नहीं होती | हर पेज में 10,000 लाइनें |
| एपीआई अनुरोधों की संख्या | 1 अनुरोध | 10 अनुरोध |
| एपीआई से मिले रिस्पॉन्स की संख्या | 1 लगातार स्ट्रीम | 10 जवाब |
परफ़ॉर्मेंस के फ़ैक्टर
इस्तेमाल के ज़्यादातर मामलों में, हम Search से ज़्यादा SearchStream का सुझाव देते हैं. इसकी ये वजहें होती हैं:
एक पेज की रिपोर्ट (10,000 से कम लाइन) के लिए: दोनों तरीकों की परफ़ॉर्मेंस में काफ़ी फ़र्क़ नहीं है.
एक से ज़्यादा पेज की रिपोर्ट के लिए: आम तौर पर,
SearchStreamतेज़ी से काम करता है, क्योंकि एक से ज़्यादा राउंडट्रिप से बचा जाता है. साथ ही, डिस्क की कैश मेमोरी से डेटा को पढ़ना या लिखना कम जोखिम भरा होता है.
दर की सीमाएं
दोनों तरीकों के लिए रोज़ाना इस्तेमाल की सीमाएं, आपके डेवलपर टोकन की स्टैंडर्ड सीमाओं और ऐक्सेस लेवल के हिसाब से होती हैं. किसी एक क्वेरी या रिपोर्ट को एक कार्रवाई के तौर पर गिना जाता है. इससे कोई फ़र्क़ नहीं पड़ता कि नतीजे पेज पर हैं या स्ट्रीम किए गए हैं.