GoogleAdsService.Search, isteğinizde page_size belirterek sayfalandırmayı destekler.
Bu işlem, sorgunun sonuç kümesini birden fazla yanıta böler. Yanıtların her biri en fazla page_size sayıda nesne içerir. page_size belirtilmezse otomatik olarak maksimum 10.000 satıra ayarlanır.
Örnek olarak, aşağıdaki sorgu için:
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
Hesabınız 50.000 anahtar kelime içeriyorsa ve page_size 1,000 olarak ayarlanırsa sonuç kümesi, ilk yanıtta bir next_page_token ile birlikte 1.000 GoogleAdsRow nesnesi içerir.
Sonraki bin satırı almak için isteği aynı sayfa boyutuyla tekrar gönderin ancak isteğin page_token değerini yanıtın next_page_token olarak güncelleyin. Sonraki isteklerdeki page_size değeri her defasında farklı olabilir. Son satır grubunu içeren yanıtta next_page_token seçeneğinin doldurulmadığını unutmayın.
İstemci kitaplıklarımız sayfalandırmayı otomatik olarak yapar. Yalnızca yanıt satırlarını tekrarlamanız gerekir. Geçerli sayfadaki tüm satırlar döndürüldüğünde, istemci kitaplığı tüm veri kümesi alınıncaya kadar sizin adınıza yeni bir satır sayfası getirir. gRPC yerine REST kullanıyorsanız her yeni sayfa için açıkça istekte bulunmanız gerekir.
Google Ads API, veri kümesinin tamamını dahili olarak önbelleğe aldığı için sonraki istekler, ilkinden daha hızlıdır. Kullanım alanınıza bağlı olarak page_size değerini 1 ile 10.000 arasında herhangi bir değere ayarlayabilirsiniz. Genel olarak, daha hızlı genel performans için daha az gidiş dönüş için daha büyük bir page_size kullanın.
Önbelleğe alınan verilerden yararlanmak için sorgunuzun sonraki isteklerde tam olarak aynı kalması gerekir. İstekler, özellikle temel erişim için olmak üzere, kotanıza katkıda bulunmaz. Sorgu farklıysa ve aynı sayfa jetonuyla birlikte gönderilirse bir hata döndürülür.