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