JSON Eşlemeleri

Search Ads 360 Reporting API'nin REST arayüzünü kullanırken, Search Ads 360 Reporting API'nin .proto descriptor dosyalarında tanımlanan kaynakların ve türlerin JSON gösterimleriyle çalışırsınız. JSON kodlama şeması, protokol arabellekleri Dil Kılavuzu'nun JSON Eşleme bölümünde açıklanan standart kodlama şemasını izler.

Genel olarak, hizmetlere gelen ve alınan tüm üst düzey mesajlar tek bir JSON nesnesidir. search yanıtları, sorgunuzun sonuç kümesini içeren bir results dizisi içeren JSON nesneleridir.

Tanımlayıcılar, JSON'da snake_case'den (protokol arabelleklerinde) lowerCamelCase'e dönüştürülür. Bu kuralla ilgili dikkat edilmesi gereken bir nokta, Search Ads 360 Sorgu Dili sorguları göndermek için search veya searchStream kullanmaktır. Hangi arayüzü kullandığınızdan bağımsız olarak sorgu dilinin kendisi yılan şeklinde büyük/küçük harf kullanır. Bununla birlikte, REST'teki bir sorgunun sonuçları normal JSON nesneleri olarak döndürülür ve tanımlayıcıları küçükCamelCase ile belirtilir.

Örneğin, bir hesaptaki etkin anahtar kelimelerin listesini getirmek için yapılan sorguda, sorgunun kendi içinde yılan durumu kullanılır (adGroupCriterion değil ad_group_criterion):

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
            FROM ad_group_criterion
            WHERE ad_group_criterion.type = 'KEYWORD'
            AND ad_group_criterion.status = 'ENABLED'"
}

Ancak yanıt, nesnelerin JSON gösterimidir (bu istekte searchStream kullanıldığı için bir JSON dizisinde sarmalanır) ve bunun yerine deve Case tanımlayıcısını adGroupCriterion kullanır:

[
  {
    "results": [
      {
        "adGroupCriterion": {
          "resourceName": "customers/1842689525/adGroupCriteria/55771861891~10003060",
          "keyword": {
            "text": "pay per click"
          }
        }
      },
      ...
    ]
  }
]