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