Sonuçlara göz atma

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 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ümesinde, ilk yanıtta 10.000 GoogleAdsRow nesnesi ve bir next_page_token bulunur.

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ın 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 sorgunuz sonraki isteklerde 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.