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 /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 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" } } }, ... ] } ]