GoogleAdsService.Search
आपके अनुरोध में page_size
की जानकारी देकर, पेजिंग की सुविधा देता है.
यह क्वेरी के नतीजे के सेट को कई रिस्पॉन्स में बांटता है और हर रिस्पॉन्स में page_size
तक ऑब्जेक्ट की संख्या होती है. अगर page_size
के बारे में नहीं बताया गया है, तो यह अपने-आप 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 कीवर्ड हैं और page_size
को 1,000
पर सेट किया गया है, तो नतीजे के सेट में पहले रिस्पॉन्स में 1,000 GoogleAdsRow
ऑब्जेक्ट और next_page_token
के नतीजे शामिल होंगे.
अगली एक हज़ार पंक्तियां फिर से पाने के लिए, उसी पेज साइज़ के साथ अनुरोध फिर से भेजें. हालांकि, अनुरोध के page_token
को रिस्पॉन्स के next_page_token
में अपडेट करें. बाद के अनुरोधों में
page_size
की वैल्यू हर बार अलग हो सकती है. ध्यान दें कि next_page_token
को उस रिस्पॉन्स में नहीं दिखाया जाता जिसमें पंक्तियों का आखिरी बैच शामिल होता है.
हमारी क्लाइंट लाइब्रेरी, पेजिंग को अपने-आप मैनेज करती है. आपको सिर्फ़ जवाब की लाइनों को दोहराना होगा. मौजूदा पेज की सभी लाइनें मिलने के बाद, क्लाइंट लाइब्रेरी आपकी ओर से पंक्तियों का नया पेज अपने-आप फ़ेच कर लेती है. ऐसा तब तक होता है, जब तक पूरा डेटा सेट वापस नहीं मिल जाता. अगर gRPC के बजाय REST का इस्तेमाल किया जा रहा है, तो आपको हर नए पेज के लिए अलग से अनुरोध करना होगा.
Google Ads API, पूरे डेटा सेट को अंदरूनी तौर पर कैश मेमोरी में सेव करता है. इसलिए, बाद के अनुरोध
पहले वाले अनुरोध से ज़्यादा तेज़ होते हैं. इस्तेमाल के उदाहरण के आधार पर, page_size
को 1 से 10,000 के बीच की किसी भी वैल्यू पर सेट किया जा सकता है. आम तौर पर, बेहतर परफ़ॉर्मेंस के लिए, कम दोतरफ़ा यात्राओं के लिए बड़े page_size
का इस्तेमाल करें.
कैश मेमोरी में सेव किए गए डेटा का फ़ायदा पाने के लिए, आपकी क्वेरी बाद के अनुरोधों में बिलकुल वैसी ही होनी चाहिए; खास तौर पर बुनियादी ऐक्सेस के लिए इन अनुरोधों का आपके कोटे में कोई योगदान नहीं होगा. अगर क्वेरी अलग-अलग है और उसी पेज टोकन के साथ भेजी जाती है, तो गड़बड़ी का मैसेज दिखता है.