Внимание! Вы просматриваете документацию по интерфейсу REST API. Большинство наших официальных клиентских библиотек используют gRPC. Подробнее см. в разделе Введение в REST .
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Архитектура API Google Ads отличается от традиционной архитектуры REST, поскольку в ней в первую очередь используются пользовательские методы, такие как search и mutate, вместо более традиционных методов list , get , create , update и delete . Эти действия выражаются в URL-адресах REST с помощью соглашения HTTP-сопоставления , состоящего из : которое отделяет пользовательскую команду от остальной части URL-адреса.
Например, вызов API мутации кампании использует следующий URL:
Одна из причин использования API собственных методов — возможность объединения нескольких операций в один запрос API. Строгая семантика REST допускает обновление только одной кампании за раз. Например, традиционное update кампании через REST потребовало бы отправки одного HTTP-запроса PATCH на каждый ресурс кампании.
Чтобы объединить множество операций в одном теле запроса, API Google Ads вместо этого определяет специальный метод mutate для большинства ресурсов. Аналогично, для пакетного чтения (одновременной выборки множества объектов) API использует специальный метод search с SQL-подобным языком запросов Google Ads .
На странице «Общие методы» подробно описаны наиболее часто используемые методы в API Google Ads.
[[["Прост для понимания","easyToUnderstand","thumb-up"],["Помог мне решить мою проблему","solvedMyProblem","thumb-up"],["Другое","otherUp","thumb-up"]],[["Отсутствует нужная мне информация","missingTheInformationINeed","thumb-down"],["Слишком сложен/слишком много шагов","tooComplicatedTooManySteps","thumb-down"],["Устарел","outOfDate","thumb-down"],["Проблема с переводом текста","translationIssue","thumb-down"],["Проблемы образцов/кода","samplesCodeIssue","thumb-down"],["Другое","otherDown","thumb-down"]],["Последнее обновление: 2025-09-03 UTC."],[],["The Google Ads API uses custom methods like `search` and `mutate` instead of standard REST methods (e.g., `list`, `get`). This is indicated in URLs by a `:` separator. `Mutate` enables batching multiple operations into one request, unlike standard `update`, which handles one campaign at a time. Similarly, `search` allows fetching multiple objects in a single request, utilizing a SQL-like query language. This deviates from REST conventions to facilitate efficient batch processing and querying.\n"],null,[]]
