Дизайн 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 позволит обновлять только одну кампанию за раз. Например, традиционное REST- update кампании потребует отправки одного запроса HTTP PATCH для каждого ресурса кампании.
Чтобы объединить множество операций в одном теле запроса, Google Ads API вместо этого определяет собственный метод mutate для большинства ресурсов. Аналогичным образом, чтобы включить пакетное чтение (одновременное получение множества объектов) из API, API использует специальный метод search с SQL-подобным языком запросов Google Рекламы .
На странице «Общие методы» подробно описаны наиболее часто используемые методы Google Ads API.