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,en fazla 10.000 satırdan oluşan sabit sayfalar döndürür. SearchGoogleAdsRequest içinde page_size ayarı kullanımdan kaldırıldı ve RequestError.PAGE_SIZE_NOT_SUPPORTED hatası döndürüyor.
Örnek sorgu ve sayfalama
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 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:
{
"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ı arasında gezinmeniz 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 jetonunun süresinin dolması
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 bir 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 sayfalı istekler, Gezgin erişimi ve Temel erişim için günlük işlem kotanıza ek işlem olarak sayılmaz. Sorgu farklıysa ve aynı sayfa jetonuyla birlikte gönderiliyorsa hata döndürülür.