Sonuçlara göz atma

GoogleAdsService.Search,10.000 satırlık sabit sayfa boyutlarında sayfalandırmayı 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 sorguyu ele alalım:

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 nesne 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 doldurulmaz.

İstemci kitaplıklarımız, sayfalama işlemini otomatik olarak gerçekleştirir. Yalnızca yanıttaki satırları yinelemeniz gerekir. Geçerli 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 istekte bulunmanız gerekir.

Google Ads API, veri kümesinin tamamını dahili olarak önbelleğe alır. Bu nedenle, sonraki istekler ilk isteğe göre daha hızlıdır.

Önbelleğe alınmış verilerden yararlanmak için sonraki isteklerde sorgunuzun tam olarak aynı kalması gerekir. İstekler, özellikle Temel Erişim düzeyi için kotanıza katkıda bulunmaz. Sorgu farklıysa ve aynı sayfa jetonuyla birlikte gönderiliyorsa hata döndürülür.