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.