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