Google Ads Sorgu Dili, isteğinizde page_size belirterek sayfalandırmayı destekler. Bu işlem, sorgunun sonuç kümesini her biri en fazla page_size nesne içeren birden çok yanıta böler. page_size belirtilmezse otomatik olarak 10.000 satırlık maksimum sayfa boyutuna ayarlanır.
Örneğin, aşağıdaki sorguyla:
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 ve page_size 1,000 değerine ayarlanırsa sonuç kümesi, ilk yanıtta next_page_token ile birlikte 1.000 GoogleAdsRow nesnesi içerir. Sonraki bin satırı almak için isteği aynı sayfa boyutuyla tekrar göndermeniz ancak isteğin page_token değerini yanıtın next_page_token değeriyle güncellemeniz yeterlidir. Sonraki isteklerdeki page_size değeri her seferinde farklı olabilir.
İstemci kitaplıklarımız sayfalama işlemini otomatik olarak gerçekleştirir. Yalnızca yanıt satırları arasında tekrarlama yapmanız gerekir. Geçerli sayfadaki tüm satırlar döndürüldüğünde, istemci kitaplığı veri kümesinin tamamı alınıncaya kadar sizin adınıza yeni bir satır sayfasını otomatik olarak getirir. gRPC yerine REST kullanıyorsanız her yeni sayfa için açıkça istekte bulunmanız gerekir.
Google Ads API, veri kümesinin tamamını dahili olarak önbelleğe alır. Bu nedenle, sonraki istekler ilk istekten daha hızlıdır. Kullanım alanınıza bağlı olarak page_size değerini 1 ile 10.000 arasında herhangi bir değere ayarlayabilirsiniz. Yanıtlarınızda gidiş dönüş sayısının daha az olması nedeniyle genel olarak daha hızlı genel performans için daha büyük bir page_size kullanmanız gerekir.
Önbelleğe alınan verilerden yararlanabilmek için sorgunuzun sonraki isteklerde tamamen aynı kalması gerekir. İstekler, özellikle temel erişim için kotanıza katkıda bulunmaz. Sorgu farklıdır ve sayfa jetonuyla birlikte gönderilirse hata meydana gelir.