Search Ads 360 Reporting API, Search Ads 360 Sorgu Dili'ni kullanarak sorgu oluşturmanıza olanak tanıyan birleşik bir özellik alma ve metrik raporlama mekanizmasına sahiptir. Bu sayede, tekil Search Ads 360 hesaplarıyla ilgili çok miktarda veri döndürebilecek karmaşık sorgular oluşturabilirsiniz.
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ürerek sayfalandırmayı kullanarak bir sonuç kümesi üzerinde iterasyon yapmanıza olanak tanır. 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ı kaybedilirse yeniden getirilebilecek daha küçük yanıtlara segmentlere ayırmak için kullanılabilir. Öte yandan SearchStream yöntemi, sonuç kümesinin tamamını tek bir yanıtta geri gönderir. Bu, toplu veri alma 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'ten fazla satır varsa yanıtta bir nextPageToken döndürülür:
{
"results": [
// ...
// ...
// ...
],
"nextPageToken": "CPii5aS87vfFTBAKGJvk36qpLiIWUW5SZk8xa1JPaXJVdXdIR05JUUpxZyoCVjMwADjUBkD___________8B",
"fieldMask": "adGroupCriterion.keyword.text,adGroupCriterion.status"
}
Yukarıdaki değere pageToken eklenmiş şekilde aynı sorguyu tekrarlamak, sonuçların bir sonraki 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ış yanıtında döndüren SearchStream yöntemini kullanmak için URL'deki hizmet yöntemini searchStream olarak değiştirmeniz yeterlidir (SearchStream için pageSize ve pageToken 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'"
}