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