Mappature JSON

Quando utilizzi l'interfaccia REST dell'API Google Ads, utilizzi JSON delle stesse risorse e degli stessi tipi definiti nell'API Google Ads .proto descriptor. Lo schema di codifica JSON segue schema di codifica canonico descritto Sezione Mappatura JSON del protocollo Memorizza nel buffer la Guida in lingua.

In generale, tutti i messaggi di primo livello servizi sono singoli oggetti JSON. La maggior parte delle richieste mutate contiene un array operations che a sua volta contiene molti Operazioni create, update o delete. In modo simile, search risposte vengono Oggetti JSON contenenti un array results con il set di risultati della query.

Gli identificatori vengono trasformati da snake_case (nei buffer di protocollo) a lowerCamelCase in JSON. Un'avvertenza notevole a questa regola riguarda l'uso search o searchStream per inviare il linguaggio di query di Google Ads query. Anche il linguaggio di query utilizza snake case, indipendentemente dal dell'interfaccia utente che stai utilizzando. Tuttavia, i risultati di una query in REST vengono restituiti come oggetti JSON normali e hanno i relativi identificatori in belowCamelCase.

Ad esempio, una query per recuperare un elenco di parole chiave attive in un account utilizza snake all'interno della query stessa (ad_group_criterion, non adGroupCriterion):

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'"
}

Tuttavia, la risposta è una rappresentazione JSON degli oggetti (aggregati in un file JSON) poiché questa richiesta utilizza searchStream) e utilizza l'identificatore camelCase adGroupCriterion invece:

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