Sonuçlar arasında gezinme

Tüm sonuç kümesini tek seferde indirmek yerine GoogleAdsService.Search ile alınan sonuçlar arasında gezinebilirsiniz. Google Ads API ile raporlamaya genel bakış için Raporlamaya genel bakış başlıklı makaleyi inceleyin.

Search,10.000 satıra kadar sabit sayfalar döndürür. SearchGoogleAdsRequest içinde page_size ayarlanması artık kullanılmıyor ve RequestError.PAGE_SIZE_NOT_SUPPORTED hatası döndürülüyor.

Örnek sorgu ve sayfalara ayırma

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:

{
  "query": "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",
  "pageToken": "CN3q9...example_token..."
}

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ını 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.

Önbelleğe alma ve sayfa jetonu geçerlilik süresi

Google Ads API, veri kümesini dahili olarak önbelleğe alır. Böylece, sonraki sayfa istekleri ilk isteğe göre daha hızlı olur. next_page_token değerlerinin sınırlı bir geçerlilik süresi (TTL) olduğunu ve kısa bir süre (yaklaşık iki saat) içinde kullanılmazsa süresinin dolacağını unutmayın. Sayfa jetonunun süresi dolarsa API hata döndürür ve yeni bir sorgu başlatmanız gerekir.

Önbelleğe alınmış verilerden yararlanmak için sorgunuz sonraki isteklerde aynı kalmalıdır. Sonraki sayfalandırılmış istekler, Explorer erişimi ve Basic erişimi için günlük işlem kotanıza ek işlem olarak dahil edilmez. Sorgu farklıysa ve aynı sayfa jetonuyla birlikte gönderiliyorsa hata döndürülür.