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