Search Ads 360 Reporting API, Search Ads 360 Sorgu Dili'ni kullanarak sorgu oluşturmanıza olanak tanıyan birleştirilmiş bir özellik alma ve metrik raporlama mekanizmasına sahiptir. Bu, tek tek Search Ads 360 hesapları hakkında büyük miktarlarda veri döndürebilen karmaşık sorgulara olanak tanır.
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, özelleştirilebilir sayfa boyutlarında veri döndürür. Böylece, sayfalandırmayı kullanarak bir sonuç kümesi üzerinde yineleme yapabilirsiniz. Bu, düşük bant genişliği veya güvenilir olmayan ağ koşullarında, örneğin büyük bir sonuç kümesini, bağlantı koptuğunda yeniden alınabilecek daha küçük yanıtlara segmentlere ayırmak için avantajlı olabilir. Diğer yandan SearchStream yöntemi, sonucun tamamını tek bir yanıtta geri aktarır ve bu, toplu veri alımı için daha verimli olabilir.
Hem Search hem de SearchStream aynı temel URL'yi kullanır:
https://searchAds360.googleapis.com/v0/customers/CUSTOMER_ID/searchAds360
Sayfa tabanlı arama yöntemi, tek bir API yanıtında döndürülen sonuç sayısını sınırlayan isteğe bağlı bir pageSize parametresi alı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 satırdan daha fazla satır varsa yanıtta nextPageToken döndürülür:
{
"results": [
// ...
// ...
// ...
],
"nextPageToken": "CPii5aS87vfFTBAKGJvk36qpLiIWUW5SZk8xa1JPaXJVdXdIR05JUUpxZyoCVjMwADjUBkD___________8B",
"fieldMask": "adGroupCriterion.keyword.text,adGroupCriterion.status"
}
Aynı sorgunun yukarıdaki değerle birlikte bir pageToken ile tekrarlanması, sonraki sonuç sayfasını getirir:
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 akışlı yanıtla döndüren SearchStream yöntemini kullanmak için URL'deki hizmet yöntemini searchStream olarak değiştirmeniz yeterlidir (SearchStream, pageSize ve pageToken özelliklerini gerektirmez):
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'"
}