GoogleAdsService.Search, 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, पूरे डेटासेट को इंटरनल कैश मेमोरी में सेव करता है, ताकि अगले अनुरोध पहले अनुरोध के मुकाबले तेज़ी से पूरे हों.
कैश मेमोरी में सेव किए गए डेटा का फ़ायदा पाने के लिए, अगले अनुरोधों में आपकी क्वेरी बिलकुल वैसी ही होनी चाहिए. ये अनुरोध आपके कोटे में शामिल नहीं होंगे. खास तौर पर, सामान्य ऐक्सेस के लिए. अगर क्वेरी अलग है और उसे एक ही पेज टोकन के साथ भेजा जाता है, तो गड़बड़ी का मैसेज दिखता है.