Search Ads 360 Reporting API, özellik alımı ve metrik raporlamasıyla ilgili birleştirilmiş bir mekanizma kullanarak sorgu oluşturabilmenizi sağlayan Search Ads 360 Sorgusu Dil. Bu, her bir arama terimiyle ilgili yüksek miktarda veri döndürebilen ayrı Search Ads 360 hesapları için geçerlidir.
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. İlgili içeriği oluşturmak için kullanılan
Search yöntemi, verileri özelleştirilebilir sayfa boyutlarında döndürerek iterasyon yapmanızı sağlar
sayfalandırmayı kullanan sonuç kümesi üzerinde çalışır. Bu, düşük bant genişliğinde avantajlı olabilir
veya güvenilir olmayan ağ koşulları (örneğin, büyük bir sonuç kümesini segmentlere ayırmak)
bağlantı kesilirse yeniden getirilebilecek daha küçük yanıtlara dönüştürür. İlgili içeriği oluşturmak için kullanılan
Öte yandan SearchStream yöntemi, belirlenen tüm sonucun akışı için
Bu da 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, isteğe bağlı bir pageSize parametresi alır. Bu parametre,
tek bir API yanıtında kaç sonuç döndürüldüğünü belirler.
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 nextPageToken
yanıtta şu sayfaya dönüldü:
{ "results": [ // ... // ... // ... ], "nextPageToken": "CPii5aS87vfFTBAKGJvk36qpLiIWUW5SZk8xa1JPaXJVdXdIR05JUUpxZyoCVjMwADjUBkD___________8B", "fieldMask": "adGroupCriterion.keyword.text,adGroupCriterion.status" }
Aynı sorgunun yukarıdaki değerle birlikte pageToken ile tekrarlanması şunları getirir:
sonraki sonuç sayfası:
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ışta döndüren SearchStream yöntemini kullanmak için
yanıtı olarak, URL'deki hizmet yöntemini searchStream olarak değiştirmeniz yeterlidir.
(SearchStream, pageSize ve pageToken öğelerini gerekli kılmaz):
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'" }