Tüm sonuç grubunu tek seferde indirmek yerine GoogleAdsService.Search ile alınan sonuçlar arasında sayfa sayfa 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..."
}
next_page_token, son satır grubunu içeren yanıtta doldurulmaz.
İ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ığı, tüm veri kümesi 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, sonraki sayfa isteklerinin ilk istekten daha hızlı olması için veri kümesini dahili olarak önbelleğe alır. next_page_token değerlerinin sınırlı bir geçerlilik süresi (TTL) olduğunu ve kısa bir süre içinde (yaklaşık iki saat) kullanılmazsa geçerliliğini yitireceğini 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ınan verilerden yararlanmak için sorgunuzun sonraki isteklerde aynı kalması gerekir. Sonraki sayfalı istekler, Explorer 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önderilirse hata döndürülür.