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.