با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
GoogleAdsService.Search از صفحه بندی در اندازه صفحه ثابت 10000 ردیف پشتیبانی می کند. مجموعه نتایج پرس و جو به چندین پاسخ تقسیم می شود که هر کدام 10000 شیء دارند.
اگر حساب شما حاوی 50000 کلمه کلیدی باشد، مجموعه نتایج شامل 10000 شیء GoogleAdsRow در اولین پاسخ همراه با next_page_token خواهد بود.
برای بازیابی 10000 ردیف بعدی، درخواست را دوباره ارسال کنید، اما page_token درخواست را به next_page_token پاسخ به‌روزرسانی کنید. توجه داشته باشید که next_page_token در پاسخی که حاوی آخرین دسته سطرها است پر نشده است.
کتابخانه های مشتری ما به طور خودکار صفحه بندی را مدیریت می کنند. شما فقط باید از طریق ردیف های پاسخ تکرار کنید. وقتی همه ردیف‌های صفحه فعلی برگردانده شدند، کتابخانه مشتری یک صفحه جدید از ردیف‌ها را به‌طور خودکار از طرف شما واکشی می‌کند تا زمانی که کل مجموعه داده بازیابی شود. در صورت استفاده از REST به جای gRPC، باید صریحاً برای هر صفحه جدید درخواست دهید.
API Google Ads به صورت داخلی کل مجموعه داده را ذخیره می کند، بنابراین درخواست های بعدی سریعتر از درخواست اولیه هستند.
پرس و جو شما باید در درخواست های بعدی برای استفاده از داده های ذخیره شده دقیقاً یکسان باقی بماند. درخواست ها به سهمیه شما کمک نمی کنند، به ویژه برای سطح دسترسی پایه . اگر کوئری متفاوت باشد و همراه با همان توکن صفحه ارسال شود، یک خطا برگردانده می شود.
تاریخ آخرین به‌روزرسانی 2025-08-26 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین به‌روزرسانی 2025-08-26 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003e\u003ccode\u003eGoogleAdsService.Search\u003c/code\u003e returns data in fixed pages of 10,000 rows, requiring multiple requests to retrieve larger datasets.\u003c/p\u003e\n"],["\u003cp\u003eTo retrieve subsequent pages, use the \u003ccode\u003enext_page_token\u003c/code\u003e from the previous response in your next request's \u003ccode\u003epage_token\u003c/code\u003e field.\u003c/p\u003e\n"],["\u003cp\u003eClient libraries automate paging, but when using REST, you must manually request each page.\u003c/p\u003e\n"],["\u003cp\u003eThe Google Ads API caches the entire dataset, making subsequent requests with the same query faster and not counted towards quota.\u003c/p\u003e\n"],["\u003cp\u003eFor custom pagination scenarios, it's recommended to retrieve and store results locally, implementing your own pagination logic.\u003c/p\u003e\n"]]],[],null,["# Paging through results\n\n| **Note:** The `page_size` field was removed in v19 of the Google Ads API. See the [announcement](https://ads-developers.googleblog.com/2024/07/upcoming-changes-to-page-size-in-google.html). The `page_size` field has a default value of 10,000. Don't attempt to set the `page_size` value, as that will throw an error.\n\n[`GoogleAdsService.Search`](/google-ads/api/reference/rpc/v21/GoogleAdsService/Search) supports\npaging in fixed page sizes of 10,000 rows. The result set of the query is split\ninto multiple responses, each of which 10,000 objects.\n\nAs an example, consider the following query: \n\n SELECT\n ad_group.id,\n ad_group_criterion.type,\n ad_group_criterion.criterion_id,\n ad_group_criterion.keyword.text,\n ad_group_criterion.keyword.match_type\n FROM ad_group_criterion\n WHERE ad_group_criterion.type = KEYWORD\n\nIf your account contains 50,000 keywords, the result set will contain 10,000\n[`GoogleAdsRow`](/google-ads/api/reference/rpc/v21/GoogleAdsRow) objects in the first response,\nalong with a\n[`next_page_token`](/google-ads/api/reference/rpc/v21/SearchGoogleAdsResponse#next_page_token).\n\nTo retrieve the next 10,000 rows, send the request again, but update the\nrequest's `page_token` to the response's\n[`next_page_token`](/google-ads/api/reference/rpc/v21/SearchGoogleAdsResponse#next_page_token).\nNote that\n[`next_page_token`](/google-ads/api/reference/rpc/v21/SearchGoogleAdsResponse#next_page_token)\nis not populated in the response that contains the last batch of rows.\n\nOur client libraries handle paging automatically. You only have to iterate\nthrough the rows of the response. When all rows in the current page have\nbeen returned, the client library fetches a new page of rows automatically on\nyour behalf until the entire dataset is retrieved. If using REST instead\nof gRPC, you must explicitly make a request for each new page.\n\nThe Google Ads API internally caches the entire dataset, so subsequent requests are\nfaster than the initial one.\n\nYour query must remain exactly the same in subsequent requests to take advantage\nof the cached data. The requests won't contribute towards your quota,\nparticularly for [Basic Access level](/google-ads/api/docs/access-levels#basic_access). If\nthe query differs and is sent along with the same page token, an error is\nreturned.\n| **Key Point:** If you need manual paging, such as for custom web pagination, we recommend that you retrieve and store the results locally, such as in a database, and build your own pagination logic."]]
