GoogleAdsService.Search
,10.000 satırlık sabit sayfa boyutlarında sayfalamayı destekler. Sorgunun sonuç kümesi, her biri 10.000 nesne içeren birden fazla yanıta bölünü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ızda 50.000 anahtar kelime varsa sonuç kümesi, ilk yanıtta 10.000 GoogleAdsRow
nesnesi ve bir next_page_token
içerir.
Sonraki 10.000 satırı almak için isteği tekrar gönderin ancak isteğin page_token
değerini yanıtın next_page_token
değeriyle güncelleyin.
Son satır grubunu içeren yanıtta next_page_token
değerinin doldurulmadığını unutmayın.
İstemci kitaplıklarımız sayfalamayı otomatik olarak yönetir. Tek yapmanız gereken yanıt satırlarını iterasyonla incelemek. Mevcut sayfadaki tüm satırlar döndürüldüğünde istemci kitaplığı, veri kümesinin tamamı 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 istemekten daha hızlıdır.
Önbelleğe alınmış verilerden yararlanmak için sonraki isteklerde sorgunuz tam olarak aynı kalmalıdır. Bu istekler, özellikle temel erişim için kotanıza dahil edilmez. Sorgu farklıysa ve aynı sayfa jetonuyla birlikte gönderilirse hata döndürülür.