- Solicitud HTTP
- Parámetros de ruta de acceso
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Alcances de autorización
- Pruébalo
Recupera un informe definido por una búsqueda. La respuesta puede contener menos filas que las especificadas por pageSize
. Usa nextPageToken
para determinar si hay más filas que se deben solicitar.
Solicitud HTTP
POST https://merchantapi.googleapis.com/reports/v1beta/{parent=accounts/*}/reports:search
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
Parámetros | |
---|---|
parent |
Obligatorio. Es el ID de la cuenta que realiza la llamada. Debe ser una cuenta independiente o una cuenta secundaria de la MCA. Formato: accounts/{account} |
Cuerpo de la solicitud
El cuerpo de la solicitud contiene datos con la siguiente estructura:
Representación JSON |
---|
{ "query": string, "pageSize": integer, "pageToken": string } |
Campos | |
---|---|
query |
Obligatorio. Es una consulta que define un informe que se recuperará. Para obtener detalles sobre cómo crear tu consulta, consulta la guía del lenguaje de consulta. Para obtener la lista completa de las tablas y los campos disponibles, consulta los campos disponibles. |
page |
Opcional. Cantidad de |
page |
Opcional. Es el token de la página que se recuperará. Si no se especifica, se muestra la primera página de resultados. Para solicitar la siguiente página de resultados, se debe usar el valor obtenido de |
Cuerpo de la respuesta
Mensaje de respuesta para el método ReportService.Search
.
Si se ejecuta correctamente, el cuerpo de la respuesta contiene datos con la siguiente estructura:
Representación JSON |
---|
{
"results": [
{
object ( |
Campos | |
---|---|
results[] |
Filas que coincidieron con la búsqueda. |
next |
Es un token que se puede enviar como |
Permisos de autorización
Requiere el siguiente alcance de OAuth:
https://www.googleapis.com/auth/content
Para obtener más información, consulta la descripción general de OAuth 2.0.