Дизайн Google Ads API отличается от традиционной архитектуры REST, поскольку в нем в основном используются настраиваемые методы, такие как search и mutate, а не более традиционные list , get , create , update и delete . Эти действия выражаются в URL-адресах REST с использованием соглашения HTTP-сопоставления : чтобы отделить пользовательскую команду от остальной части URL-адреса.
Например, вызов API изменения кампании использует следующий URL-адрес:
https://googleads.googleapis.com/v16/customers/1234567890/campaigns:mutate
Одна из причин, по которой API использует настраиваемые методы, заключается в том, чтобы включить пакетирование нескольких операций в один запрос API. Строгая семантика REST позволяет обновлять только одну кампанию за раз. Например, традиционное REST- update кампании потребует отправки одного HTTP-запроса PATCH для каждого ресурса кампании.
Чтобы объединить множество операций в одном теле запроса, Google Ads API вместо этого определяет собственный метод mutate для большинства ресурсов. Точно так же, чтобы включить пакетное чтение (извлечение множества объектов одновременно) из API, API использует настраиваемый метод search с языком запросов Google Реклама, подобным SQL .
На странице «Общие методы» подробно описаны наиболее часто используемые методы в Google Ads API.