नतीजों को पेज के हिसाब से देखना

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

ध्यान दें: पेज टोकन मैनेज किए बिना, एक ही स्थायी कनेक्शन पर बड़े डेटासेट को बेहतर तरीके से वापस पाने के लिए, Search के बजाय GoogleAdsService.SearchStream का इस्तेमाल करें.

Search, ज़्यादा से ज़्यादा 10,000 पंक्तियों वाले फ़िक्स पेज दिखाता है. SearchGoogleAdsRequest में page_size को सेट करने की सुविधा अब काम नहीं करती. ऐसा करने पर, RequestError.PAGE_SIZE_NOT_SUPPORTED गड़बड़ी का मैसेज दिखता है.

क्वेरी और पेज नंबरिंग का उदाहरण

इस क्वेरी पर ध्यान दें:

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 पर अपडेट करें:

{
  "query": "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",
  "pageToken": "CN3q9...example_token..."
}

ध्यान दें कि next_page_token उस रिस्पॉन्स में नहीं भरा जाता है जिसमें पंक्तियों का आखिरी बैच होता है.

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

कैश मेमोरी में सेव होना और पेज टोकन की समयसीमा खत्म होना

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

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

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