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