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