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