При использовании интерфейса REST Google Ads API вы работаете с JSON-представлениями тех же ресурсов и типов, которые определены в файлах дескриптора .proto Google Ads API. Схема кодирования JSON соответствует канонической схеме кодирования, описанной в разделе JSON Mapping Руководства по языку буферов протокола.
Как правило, все сообщения верхнего уровня в службы и из них представляют собой отдельные объекты JSON. Большинство запросов на изменение содержат массив operations
, который сам содержит множество операций create
, update
или delete
. Точно так же ответы search
— это объекты JSON, содержащие массив results
с набором результатов вашего запроса.
Идентификаторы преобразуются из змеиного регистра (в буферах протокола) в нижний верблюжий регистр в формате JSON. Одно заметное предостережение в отношении этого правила касается использования search
или searchStream
для отправки запросов Google Ads Query Language . Сам язык запросов использует змеиный регистр, независимо от того, какой интерфейс вы используете. Однако результаты запроса в REST возвращаются как обычные объекты JSON и имеют свои идентификаторы в нижнем регистре CamelCase.
Например, запрос на получение списка активных ключевых слов в учетной записи использует регистр змеи внутри самого запроса ( ad_group_criterion
, а не 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'" }
Однако ответ представляет собой JSON-представление объектов (обернутое в массив JSON, поскольку этот запрос использует searchStream
) и вместо этого использует идентификатор adGroupCriterion
в стиле camelCase:
[ { "results": [ { "adGroupCriterion": { "resourceName": "customers/1842689525/adGroupCriteria/55771861891~10003060", "keyword": { "text": "pay per click" } } }, ... ] } ]