Новый API отчетов Search Ads 360 теперь доступен. Присоединяйтесь к группе Google searchads-api-announcements , чтобы быть в курсе предстоящих улучшений и выпусков.
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
На этой странице предполагается знакомство с руководствами для разработчиков по ресурсно-ориентированному дизайну и именам ресурсов , а также дополняются конкретными подробностями реализации Search Ads 360 Reporting API.
Ресурсно-ориентированный дизайн
Как правило, API отчетов Search Ads 360 имеет ресурсо-ориентированную структуру и моделируется как набор индивидуально адресуемых ресурсов ( существительные API). На ресурсы ссылаются по их именам, и манипулирование ими осуществляется с помощью небольшого набора методов (также известных как глаголы или операции ).
Эти имена и методыресурсов в сочетании с определенным префиксом версии API составляют URL-адреса интерфейса REST. Например, приведенный ниже URL-адрес можно разбить на отдельные компоненты в соответствии со следующей таблицей:
Все URL-адреса REST для определенной версии API (например, v0 ) имеют общий префикс версии API. Имя ресурса и метод вместе определяют, какая служба API вызывается.
API отчетов Search Ads 360 активно использует пользовательские методы , в отличие от большинства традиционных API REST, которые используют стандартные методы REST, такие как list и get . API отчетов Search Ads 360 включает в себя два специальных метода: search и searchStream .
На следующих страницах более подробно описаны имена ресурсов Search Ads 360 Reporting API, методы обслуживания и соглашения об именах JSON , чтобы проиллюстрировать, как они используются вместе для определения конечных точек интерфейса REST.
[[["Прост для понимания","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-08-29 UTC."],[],["The Search Ads 360 Reporting API uses a resource-oriented design with collections of resources accessed via resource names. API calls use HTTP protocol and are structured with a version prefix, resource name, and method. This API primarily employs custom methods, specifically `search` and `searchStream`, instead of standard REST methods. URLs are constructed using the version prefix (e.g., `v0`), a resource name, and a method, defining the specific API service. Further details are available on resource names, service methods, and JSON conventions.\n"]]
