Google Ads API'nin REST arayüzünü kullanırken JSON biçiminde, ve reklam türlerini gösteren, Google Ads API'nin .proto açıklayıcı dosyalarına sahip olması gerekir. JSON kodlama şeması konusunda açıklanan standart kodlama şeması Protokolün JSON Eşleme bölümü Dil Rehberi'nde arabelleğe alınır.
Genel olarak,
services, tek JSON nesneleridir.
Çoğu değişiklik isteği, kendisi çok sayıda öğe içeren bir operations dizisi içeriyor.
create, update veya delete işlemleri. Benzer şekilde, search yanıtlar
Sorgunuzun sonuç kümesine sahip bir results dizisi içeren JSON nesneleri.
Tanımlayıcılar, snake_case değerinden (protokol arabelleklerinde)
JSON biçiminde lowerCamelCase'ı seçin. Bu kuralda dikkat edilmesi gereken bir uyarı,
Google Ads Sorgu Dili göndermek için search veya searchStream
daha fazla bilgi edineceksiniz. Sorgu dilinin kendisi yılan büyük/küçük harf kullanır,
olduğunu unutmayın. Ancak REST'teki sorgunun sonuçları şu şekilde döndürülür:
normal JSON nesneleri'ne sahiptir ve tanımlayıcıları küçükCamelCase biçimindedir.
Örneğin, bir hesaptaki etkin anahtar kelimelerin listesini getiren bir sorgu,
yılan şeklinde büyük harf kullanımı (ad_group_criterion, adGroupCriterion değil):
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
FROM ad_group_criterion
WHERE ad_group_criterion.type = 'KEYWORD'
AND ad_group_criterion.status = 'ENABLED'"
}
Ancak yanıt, nesnelerin JSON gösterimidir (bir JSON dosyasına sarmalanmış)
dizisinden (searchStream) ve büyük/küçük harf tanımlayıcısını kullandığından
Bunun yerine adGroupCriterion:
[
{
"results": [
{
"adGroupCriterion": {
"resourceName": "customers/1842689525/adGroupCriteria/55771861891~10003060",
"keyword": {
"text": "pay per click"
}
}
},
...
]
}
]