GoogleAdsService का इस्तेमाल करके स्ट्रीमिंग की शिकायत करें

Google Ads API की इकाइयों और रिपोर्टिंग डेटा को फिर से पाने के लिए, इनमें से किसी एक तरीके का इस्तेमाल किया जा सकता है:

यहां दोनों तरीकों के लिए कुछ अहम अंतर दिए गए हैं:

GoogleAdsService.SearchStream GoogleAdsService.Search
प्रोडक्शन कोड के लिए सही है हां हां
सेवा GoogleAdsService GoogleAdsService
स्थिति ऑब्जेक्ट और रिपोर्ट फ़ेच की जा रही हैं ऑब्जेक्ट और रिपोर्ट फ़ेच की जा रही हैं
जवाब GoogleAdsRow ऑब्जेक्ट की स्ट्रीम GoogleAdsRow ऑब्जेक्ट के पेज
जवाबों के फ़ील्ड सिर्फ़ वे क्वेरी जिनके बारे में क्वेरी में बताया गया है सिर्फ़ वे क्वेरी जिनके बारे में क्वेरी में बताया गया है
रोज़ाना इस्तेमाल की सीमाएं तय करना ऐक्सेस लेवल के हिसाब से, रोज़ाना इस्तेमाल की सीमाएं ऐक्सेस लेवल के हिसाब से, रोज़ाना इस्तेमाल की सीमाएं

Search पूरी रिपोर्ट को डाउनलोड करने के लिए, कई पेजों में बांटा गया अनुरोध भेज सकता है, जबकि SearchStream सिर्फ़ एक अनुरोध भेजता है और Google Ads API के साथ लगातार कनेक्शन शुरू करता है, भले ही रिपोर्ट का साइज़ कुछ भी हो.

SearchStream के लिए, डेटा पैकेट तुरंत डाउनलोड होना शुरू हो जाते हैं, जिसमें पूरे नतीजे को डेटा बफ़र में कैश किया जाता है. आपका कोड पूरी स्ट्रीम के खत्म होने का इंतज़ार किए बिना, बफ़र किए गए डेटा को पढ़ना शुरू कर सकता है.

Search रिस्पॉन्स के हर पेज का अनुरोध करने के लिए, दोतरफ़ा यात्रा का समय हटाकर, आपके ऐप्लिकेशन के हिसाब से SearchStream, पेजिंग के मुकाबले बेहतर परफ़ॉर्मेंस दे सकता है. ऐसा खास तौर पर बड़ी रिपोर्ट के लिए किया जा सकता है.

उदाहरण

उदाहरण के लिए, 100,000 पंक्तियों वाली रिपोर्ट लें. यहां दी गई टेबल में, इन दोनों तरीकों के बीच के अकाउंटिंग के अंतर को दिखाया गया है.

SearchStream रिपोर्ट में खोजना
पेज का साइज़ इस पर रेटिंग लागू नहीं होती हर पेज के लिए 10,000 लाइनें
एपीआई अनुरोधों की संख्या 1 अनुरोध 10 अनुरोध
एपीआई से मिले रिस्पॉन्स की संख्या 1 लगातार स्ट्रीम किया जा रहा है 10 जवाब

परफ़ॉर्मेंस के फ़ैक्टर

हम इस्तेमाल के ज़्यादातर उदाहरणों में, Search से ज़्यादा SearchStream का इस्तेमाल करने का सुझाव देते हैं. ऐसा इन वजहों से है:

  • एक पेज की रिपोर्ट (10,000 पंक्तियों में) के लिए: इन दोनों तरीकों की परफ़ॉर्मेंस में कोई खास अंतर नहीं है.

  • एक से ज़्यादा पेज की रिपोर्ट के लिए: SearchStream आम तौर पर तेज़ी से काम करता है, क्योंकि कई राउंडट्रिप से बचा जाता है. साथ ही, डिस्क की कैश मेमोरी से डेटा को पढ़ने या उसमें बदलाव करने की कम संभावना होती है.

रेट लिमिट

दोनों तरीकों के लिए रोज़ाना इस्तेमाल की जाने वाली सीमाएं, आपके डेवलपर टोकन की स्टैंडर्ड सीमाओं और ऐक्सेस लेवल के हिसाब से होती हैं. एक क्वेरी या रिपोर्ट को एक कार्रवाई के तौर पर गिना जाता है, भले ही नतीजा पेज किया गया हो या स्ट्रीम किया गया हो.