Mappages JSON

Lorsque vous utilisez l'interface REST de l'API Google Ads, vous travaillez avec des représentations JSON des mêmes ressources et types que ceux définis dans les fichiers de descripteurs.proto de l'API Google Ads. Le schéma d'encodage JSON suit le schéma d'encodage canonique décrit dans la section Mappage JSON du guide du langage des tampons de protocole.

En général, tous les messages de premier niveau à destination et en provenance des services sont des objets JSON uniques. La plupart des requêtes de mutation contiennent un tableau operations contenant de nombreuses opérations create, update ou delete. De même, les réponses search sont des objets JSON contenant un tableau results avec l'ensemble de résultats de votre requête.

Les identifiants sont transformés de snake_case (dans des tampons de protocole) à lowerCamelCase en JSON. Il convient de noter cette règle lorsque vous utilisez search ou searchStream pour envoyer des requêtes Langage de requête Google Ads. Le langage de requête lui-même utilise snake case, quelle que soit l'interface utilisée. Cependant, les résultats d'une requête dans REST sont renvoyés en tant qu'objets JSON normaux et leurs identifiants sont en minuscules.

Par exemple, une requête pour extraire une liste de mots clés actifs dans un compte utilise la casse snake dans la requête elle-même (ad_group_criterion, et non adGroupCriterion):

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

Cependant, la réponse est une représentation JSON des objets (encapsulés dans un tableau JSON, car cette requête utilise searchStream) et utilise à la place l'identifiant camelCase adGroupCriterion:

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