Search Ads 360 Reporting API, Search Ads 360 Query Language'i kullanarak sorgular oluşturmanıza olanak tanıyan birleşik bir özellik alma ve metrik raporlama mekanizmasına sahiptir. Bu, bireysel Search Ads 360 hesapları hakkında büyük miktarda veri döndürebilen karmaşık sorguları etkinleştirir.
Search veya SearchStream yöntemlerinden birini kullanarak sorgu oluşturabilirsiniz.
Her iki yöntem de aynı sorguları destekler ve eşdeğer sonuçlar döndürür. Search yöntemi, verileri özelleştirilebilir sayfa boyutlarında döndürür. Bu sayede, sayfalara ayırma özelliğini kullanarak bir sonuç kümesi üzerinde yineleme yapabilirsiniz. Bu, düşük bant genişliği veya güvenilir olmayan ağ koşullarında avantajlı olabilir. Örneğin, büyük bir sonuç kümesini, bağlantı kaybolursa yeniden getirilebilecek daha küçük yanıtlara ayırmak için kullanılabilir. Diğer yandan, SearchStream yöntemi tüm sonuç kümesini tek bir yanıtta geri aktarır. Bu yöntem, toplu veri alma işlemleri için daha verimli olabilir.
Hem Search hem de SearchStream aynı temel URL'yi kullanıyor:
https://searchAds360.googleapis.com/v0/customers/CUSTOMER_ID/searchAds360
Sayfaya dayalı arama yönteminde, tek bir API yanıtında döndürülen sonuç sayısını sınırlayan isteğe bağlı bir pageSize parametresi kullanılır.
POST /v0/customers/CUSTOMER_ID/searchAds360:search HTTP/1.1 Host: searchAds360.googleapis.com Content-Type: application/json Authorization: Bearer ACCESS_TOKEN { "pageSize": 10000, "query": "SELECT ad_group_criterion.keyword.text, ad_group_criterion.status FROM ad_group_criterion WHERE ad_group_criterion.type = 'KEYWORD' AND ad_group_criterion.status = 'ENABLED'" }
Sonuçlarda pageSize değerinden daha fazla satır varsa yanıtta nextPageToken döndürülür:
{ "results": [ // ... // ... // ... ], "nextPageToken": "CPii5aS87vfFTBAKGJvk36qpLiIWUW5SZk8xa1JPaXJVdXdIR05JUUpxZyoCVjMwADjUBkD___________8B", "fieldMask": "adGroupCriterion.keyword.text,adGroupCriterion.status" }
Aynı sorguyu yukarıdaki değerle birlikte pageToken ekleyerek tekrarladığınızda sonuçların sonraki sayfası getirilir:
POST /v0/customers/CUSTOMER_ID/searchAds360:search HTTP/1.1 Host: searchads360.googleapis.com Content-Type: application/json Authorization: Bearer ACCESS_TOKEN { "pageSize": 10000, "query": "SELECT ad_group_criterion.keyword.text, ad_group_criterion.status FROM ad_group_criterion WHERE ad_group_criterion.type = 'KEYWORD' AND ad_group_criterion.status = 'ENABLED'", "pageToken": "CPii5aS87vfFTBAKGJvk36qpLiIWUW5SZk8xa1JPaXJVdXdIR05JUUpxZyoCVjMwADjUBkD___________8B" }
Tüm sonuçları tek bir yayınlanmış yanıtta döndüren SearchStream yöntemini kullanmak için URL'deki hizmet yöntemini searchStream olarak değiştirmeniz yeterlidir
(pageSize ve pageToken, SearchStream için gerekli değildir):
POST /v0/customers/CUSTOMER_ID/searchAds360:searchStream HTTP/1.1 Host: searchads360.googleapis.com Content-Type: application/json Authorization: Bearer ACCESS_TOKEN { "query": "SELECT ad_group_criterion.keyword.text, ad_group_criterion.status FROM ad_group_criterion WHERE ad_group_criterion.type = 'KEYWORD' AND ad_group_criterion.status = 'ENABLED'" }