Google Ads API'de birleşik bir özellik alma ve metrik raporlama özelliğine sahiptir. mekanizma kullanarak sorgu oluşturmanızı sağlayan Google Ads Sorgusu Dil. Bu, her bir arama terimiyle ilgili yüksek miktarda veri döndürebilen hesaplayabilirsiniz.
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, 10.000 satırlık sabit boyutlu sayfalarda veri döndürerek
sayfalandırmayı kullanarak bir sonuç kümesinde yineleme gerçekleştirme. Bu, düşük dönüşüm hacminde
bant genişliği veya güvenilir olmayan ağ koşulları (örneğin, büyük bir envanteri segmentlere ayırmak için)
bağlantı daha küçükse tekrar getirilebilecek şekilde ayarlanmış olarak
emin olun. Öte yandan SearchStream yöntemi tüm sonucu akış şeklinde gösterir
tek bir yanıtta geri yüklenir. Bu, toplu veriler için daha verimli olabilir.
içerir.
Hem Search hem de SearchStream aynı temel URL'yi kullanır:
https://googleads.googleapis.com/v17/customers/CUSTOMER_ID/googleAds
POST /v17/customers/CUSTOMER_ID/googleAds:search HTTP/1.1
Host: googleads.googleapis.com
Content-Type: application/json
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_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'"
}
Sonuçlarda 10.000'den fazla satır varsa nextPageToken
yanıtta şu sayfaya dönüldü:
{
"results": [
// ...
// ...
// ...
],
"nextPageToken": "CPii5aS87vfFTBAKGJvk36qpLiIWUW5SZk8xa1JPaXJVdXdIR05JUUpxZyoCVjMwADjUBkD___________8B",
"fieldMask": "adGroupCriterion.keyword.text,adGroupCriterion.status"
}
Aynı sorgunun bir pageToken ile tekrarlanması
önceki istek sonraki sonuç sayfasını getirir:
POST /v17/customers/CUSTOMER_ID/googleAds:search HTTP/1.1
Host: googleads.googleapis.com
Content-Type: application/json
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_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'",
"pageToken": "CPii5aS87vfFTBAKGJvk36qpLiIWUW5SZk8xa1JPaXJVdXdIR05JUUpxZyoCVjMwADjUBkD___________8B"
}
Tüm sonuçları tek bir akışta döndüren SearchStream yöntemini kullanmak için
yanıtında, URL'deki hizmet yöntemini searchStream olarak değiştirin
(SearchStream, pageSize ve pageToken öğelerini gerekli kılmaz):
POST /v17/customers/CUSTOMER_ID/googleAds:searchStream HTTP/1.1
Host: googleads.googleapis.com
Content-Type: application/json
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_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'"
}
.