Sonuç kümesinin tamamını tek seferde indirmek yerine GoogleAdsService.Search ile alınan sonuçlar arasında gezinebilirsiniz. Google Ads API ile raporlamaya genel bakış için Raporlama kılavuzuna göz atın.
Sonuçlar en fazla 10.000 satırlık sayfalar halinde döndürülür. İstekte page_size ayarlanmazsa varsayılan olarak 10.000 değeri kullanılır. page_size değeri 10.000'den büyük bir değere ayarlanırsa yine 10.000 kullanılı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 değerinin doldurulmadığını unutmayın.
İstemci kitaplıklarımız, sayfalama işlemini otomatik olarak gerçekleştirir. Yalnızca yanıtın satırları arasında yineleme yapmanız 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, dahili olarak veri kümesinin tamamını ö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 sorgunuz sonraki isteklerde de tam olarak aynı kalmalıdır. Bu istekler, özellikle Explorer erişim düzeyi ve Basic erişim düzeyi için kotanıza dahil edilmez. Sorgu farklıysa ve aynı sayfa jetonuyla birlikte gönderilirse hata döndürülür.