नतीजों को पेज पर दिखाना

GoogleAdsService.Search की मदद से वापस लाए गए नतीजों को एक साथ डाउनलोड करने के बजाय, पेज के हिसाब से देखा जा सकता है. Google Ads API की मदद से रिपोर्टिंग करने की खास जानकारी के लिए, रिपोर्टिंग गाइड देखें.

नतीजे, ज़्यादा से ज़्यादा 10,000 लाइनों वाले पेजों में दिखाए जाते हैं. अगर अनुरोध में page_size सेट नहीं किया गया है, तो डिफ़ॉल्ट रूप से इसकी वैल्यू 10,000 होती है. अगर page_size को 10,000 से ज़्यादा वैल्यू पर सेट किया जाता है, तो भी यह 10,000 का इस्तेमाल करता है.

उदाहरण के लिए, इस क्वेरी पर विचार करें:

SELECT
  ad_group.id,
  ad_group_criterion.type,
  ad_group_criterion.criterion_id,
  ad_group_criterion.keyword.text,
  ad_group_criterion.keyword.match_type
FROM ad_group_criterion
WHERE ad_group_criterion.type = KEYWORD

अगर आपके खाते में 50,000 कीवर्ड हैं, तो नतीजे के सेट में पहले जवाब में 10,000 GoogleAdsRow ऑब्जेक्ट और एक next_page_token शामिल होगा.

अगली 10,000 पंक्तियां पाने के लिए, अनुरोध को फिर से भेजें. हालांकि, अनुरोध के page_token को जवाब के next_page_token पर अपडेट करें. ध्यान दें कि next_page_token, लाइनों के आखिरी बैच वाले जवाब में नहीं दिखता.

हमारी क्लाइंट लाइब्रेरी, पेजिंग को अपने-आप मैनेज करती हैं. आपको सिर्फ़ जवाब की लाइनों को दोहराना होगा. जब मौजूदा पेज की सभी पंक्तियां वापस आ जाती हैं, तो क्लाइंट लाइब्रेरी आपकी ओर से पंक्तियों का नया पेज अपने-आप फ़ेच करती है. ऐसा तब तक होता है, जब तक पूरा डेटासेट वापस नहीं आ जाता. gRPC के बजाय REST का इस्तेमाल करने पर, आपको हर नए पेज के लिए साफ़ तौर पर अनुरोध करना होगा.

Google Ads API, पूरे डेटासेट को इंटरनल तौर पर कैश मेमोरी में सेव करता है. इसलिए, बाद के अनुरोध, शुरुआती अनुरोध की तुलना में ज़्यादा तेज़ी से पूरे होते हैं.

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

अहम जानकारी: अगर आपको मैन्युअल पेजिंग की ज़रूरत है, जैसे कि कस्टम वेब पेजिंग के लिए, तो हमारा सुझाव है कि आप नतीजों को स्थानीय तौर पर सेव करें. जैसे, किसी डेटाबेस में और पेजिंग का अपना लॉजिक बनाएं.