GoogleAdsService.Search, isteğinizde page_size belirterek sayfalandırmayı destekler.
Bu işlem, sorgunun sonuç grubunu her biri en fazla page_size sayıda nesne içeren birden fazla yanıta böler. page_size belirtilmezse otomatik olarak maksimum 10.000 satıra ayarlanır.
Örneğin, 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 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 değeriyle güncelleyin. Sonraki isteklerde yer alan page_size değeri her seferinde farklı olabilir. Son satır grubunu içeren yanıtta next_page_token ifadesinin doldurulmadığını unutmayın.
İstemci kitaplıklarımız sayfalama işlemini otomatik olarak gerçekleştirir. 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ınana kadar sizin adınıza otomatik olarak yeni bir satır sayfası getirir. gRPC yerine REST kullanıyorsanız her yeni sayfa için açıkça istek göndermeniz gerekir.
Google Ads API, veri kümesinin tamamını dahili olarak önbelleğe alır. Bu nedenle, sonraki istekler ilk gönderilenden daha hızlıdır. Kullanım alanınıza bağlı olarak page_size öğesini 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 kotanızdan düşülmez. Sorgu farklıysa ve aynı sayfa jetonuyla gönderilirse hata döndürülür.