En esta página, se da por sentado que conoces las guías para desarrolladores de Diseño orientado a los recursos y Nombres de recursos, y se las complementa con detalles de implementación específicos de la API de Search Ads 360 Reporting.
Diseño orientado a recursos
Por lo general, la API de Search Ads 360 Reporting sigue un diseño orientado a los recursos, que se modela como colecciones de recursos abordables de manera individual (los sustantivos de la API). Se hace referencia a los recursos con sus nombres y se manipulan mediante un conjunto pequeño de métodos (también conocidos como operaciones o verbos).
Estos nombres de recursos y métodos, combinados con un prefijo de versión de la API específico, conforman las URLs de la interfaz REST. Por ejemplo, la siguiente URL se puede desglosar en estos componentes individuales según la siguiente tabla:
https://searchads360.googleapis.com/v0/customers/1234567890/searchAds360:search
| Prefijo de la versión de la API | Nombre del recurso (relativo) | Método |
|---|---|---|
https://searchads360.googleapis.com/v0
|
customers/1234567890
|
search
|
Todas las URLs de REST para una versión en particular de la API (p.ej., v0) comparten un prefijo de versión de API común. El nombre y el método del recurso juntos identifican a qué servicio de API se le llama.
La API de Search Ads 360 Reporting usa mucho los métodos personalizados, a diferencia de la mayoría de las APIs de REST tradicionales que usan métodos REST estándar, como list y get. La API de informes de Search Ads 360
incluye dos métodos personalizados: search y searchStream.
En las siguientes páginas, se proporcionan más detalles sobre los nombres de recursos, los métodos de servicio y las convenciones de nombres de JSON de la API de informes de Search Ads 360 para ilustrar cómo se usan en conjunto para definir los extremos de la interfaz REST.