Google Ads API'nin REST arayüzünü kullanırken, Google Ads API'nin .proto açıklayıcı dosyalarında tanımlanan aynı kaynakların ve türlerin JSON gösterimleriyle çalışıyorsunuz. JSON kodlama şeması, Dil Kılavuzu'ndaki protokol arabelleklerinde açıklanan standart kodlama şemasını uygular.
Genel olarak, hizmetlere giden ve bunlardan gelen tüm üst düzey iletiler tek bir JSON nesnesidir.
Birçok mutate isteği birçok create, update veya delete işlemi içeren bir operations dizisi içerir. Benzer şekilde search yanıtları, sorgunuzun sonuç kümesiyle birlikte bir results dizisi içeren JSON nesneleridir.
Tanımlayıcılar, JSON'de snake_case (protokol arabellekleri) içinde lowerCamelCase biçimine dönüştürülür. Bu kuraldaki önemli uyarılardan biri, Google Ads Sorgu Dili sorgularını göndermek için search veya searchStream kullanıldığındadır. Sorgu arayüzünün kendisi, hangi arayüzü kullandığınıza bakılmaksızın yılan düzeni kullanır. Bununla birlikte, REST'teki bir sorgunun sonuçları normal JSON nesneleri olarak döndürülür ve tanımlayıcıları LowCamelCase'de bulunur.
Örneğin, bir hesaptaki etkin anahtar kelimelerin listesini getirmek için yapılan sorgu, sorgunun içinde yılan büyük/küçük harf kullanımını kullanır (adGroupCriterion yerine ad_group_criterion):
POST /v16/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 temsilidir (bu istek searchStream kullanıldığından, bir JSON dizisiyle sarmalanmıştır) ve deveCase tanımlayıcıyı adGroupCriterion kullanır:
[
{
"results": [
{
"adGroupCriterion": {
"resourceName": "customers/1842689525/adGroupCriteria/55771861891~10003060",
"keyword": {
"text": "pay per click"
}
}
},
...
]
}
]