Новый 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.
[null,null,["Последнее обновление: 2025-08-29 UTC."],[[["\u003cp\u003eThe Search Ads 360 Reporting API uses a resource-oriented design, where data is organized into collections of resources that can be accessed and manipulated.\u003c/p\u003e\n"],["\u003cp\u003eThe API primarily uses custom methods like \u003ccode\u003esearch\u003c/code\u003e and \u003ccode\u003esearchStream\u003c/code\u003e instead of traditional REST methods.\u003c/p\u003e\n"],["\u003cp\u003eAPI endpoints are constructed using an API version prefix, resource name, and method, which are detailed further in linked documentation.\u003c/p\u003e\n"],["\u003cp\u003eThe guide's examples demonstrate API calls using HTTP, with further instructions available for using the \u003ccode\u003ecurl\u003c/code\u003e command-line utility.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers should be familiar with Resource Oriented Design and Resource Names before using this API.\u003c/p\u003e\n"]]],["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"],null,["# REST Interface Design\n\nThis page assumes a familiarity with the [Resource Oriented\nDesign](https://cloud.google.com/apis/design/resources) and [Resource\nNames](https://cloud.google.com/apis/design/resource_names) developer guides and\ncomplements them with specific implementation details of the Search Ads 360 Reporting API.\n| **Key Point:** The examples throughout this guide use HTTP protocol to demonstrate how to call the API. See the [Examples](/search-ads/reporting/api/reference/rest/examples) page for how you can make these same API calls using the [`curl`](https://curl.haxx.se/) command line utility.\n\nResource-oriented design\n------------------------\n\nGenerally, the Search Ads 360 Reporting API follows a resource-oriented design, modeled as\n*collections* of individually-addressable *resources* (the *nouns* of the API).\nResources are referenced with their resource names and manipulated using a small\nset of *methods* (also known as *verbs* or *operations*).\n\nThese [resource names](/search-ads/reporting/api/reference/rest/resource-names) and [methods](/search-ads/reporting/api/reference/rest/service-methods), combined\nwith a specific *API version prefix*, comprise the URLs of the REST interface.\nFor example, the URL below can be broken down into these individual components\naccording to the following table: \n\n https://searchads360.googleapis.com/v0/customers/1234567890/searchAds360:search\n\n| API Version Prefix | Resource Name (relative) | Method |\n|------------------------------------------|--------------------------|----------|\n| `https://searchads360.googleapis.com/v0` | `customers/1234567890` | `search` |\n\nAll REST URLs for a particular version of the API (e.g., `v0`)\nshare a common API version prefix. The resource name and method together\nidentifies which API service is being called.\n\nThe Search Ads 360 Reporting API makes heavy use of *custom methods* , as opposed to most\ntraditional REST APIs that use standard REST methods such as `list` and `get`. The Search Ads 360 Reporting API\nincludes two custom methods: `search` and `searchStream`.\n\nThe following pages go into more details about the Search Ads 360 Reporting API's [resource\nnames](/search-ads/reporting/api/reference/rest/resource-names), [service methods](/search-ads/reporting/api/reference/rest/service-methods), and\n[JSON naming conventions](/search-ads/reporting/api/reference/rest/json-mappings) to illustrate how they're used\ntogether to define REST interface endpoints."]]
