Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Ejecuta una consulta almacenada para generar un informe.
Pruébalo ahora.
Solicitud
Solicitud HTTP
POST https://www.googleapis.com/doubleclickbidmanager/v1.1/query/queryId
Parámetros
Nombre del parámetro
Valor
Descripción
Parámetros de ruta de acceso
queryId
long
ID de consulta que se ejecutará.
Parámetros de consulta opcionales
asynchronous
boolean
Si la consulta debe ejecutarse de forma asíncrona. Cuando es verdadero, este método
volverá de inmediato. Si es falso o no se especifica, este método no
hasta que termine de ejecutarse la consulta.
(Predeterminado: false)
Autorización
Esta solicitud requiere una autorización con el siguiente alcance:
Indica el rango de datos que se usó para generar el informe.
Los valores aceptables son los siguientes:
"ALL_TIME"
"CURRENT_DAY"
"CUSTOM_DATES"
"LAST_14_DAYS"
"LAST_30_DAYS"
"LAST_365_DAYS"
"LAST_60_DAYS"
"LAST_7_DAYS"
"LAST_90_DAYS"
"MONTH_TO_DATE"
"PREVIOUS_DAY"
"PREVIOUS_HALF_MONTH"
"PREVIOUS_MONTH"
"PREVIOUS_QUARTER"
"PREVIOUS_WEEK"
"PREVIOUS_YEAR"
"QUARTER_TO_DATE"
"TYPE_NOT_SUPPORTED"
"WEEK_TO_DATE"
"YEAR_TO_DATE"
reportDataStartTimeMs
long
Es la hora de inicio de los datos que se muestran en el informe. Ten en cuenta que reportDataStartTimeMs es obligatorio si dataRange es CUSTOM_DATES y, de lo contrario, se ignora.
reportDataEndTimeMs
long
La hora de finalización de los datos que se muestran en el informe. Ten en cuenta que reportDataEndTimeMs es obligatorio si dataRange es CUSTOM_DATES y, de lo contrario, se ignora.
timezoneCode
string
Es el código de zona horaria canónico para la hora de los datos del informe. La configuración predeterminada es America/New_York.
Respuesta
Si se aplica correctamente, este método muestra un cuerpo de respuesta vacío.
Pruébalo
Usa el Explorador de APIs que se muestra a continuación para llamar a este método en datos en vivo y ver la respuesta.
También puedes probar la
independiente
del navegador.
[null,null,["Última actualización: 2025-07-25 (UTC)"],[[["\u003cp\u003eThis version of the Bid Manager API is sunset, and users should migrate to Bid Manager API v2.\u003c/p\u003e\n"],["\u003cp\u003eRequests to this version may return errors, and specific fields in retrieved \u003ccode\u003eQuery\u003c/code\u003e resources will be empty.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003erunquery\u003c/code\u003e request runs a stored query to generate a report, accepting parameters like \u003ccode\u003equeryId\u003c/code\u003e, \u003ccode\u003easynchronous\u003c/code\u003e, \u003ccode\u003edataRange\u003c/code\u003e, and time parameters.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/doubleclickbidmanager\u003c/code\u003e scope is required for this request.\u003c/p\u003e\n"]]],["The Bid Manager API v1.1 is sunset; users must migrate to v2. Requests to v1.1 may error, and successful requests will return empty `metadata.googleCloudStoragePathForLatestReport`, `metadata.latestReportRunTimeMs`, and `metadata.googleDrivePathForLatestReport` fields. To run a query, send a POST request with the `queryId`, optional asynchronous parameter, and report data range, start/end times, and timezone in the request body. This requires authorization with the `doubleclickbidmanager` scope.\n"],null,["# Queries: runquery\n\n| This version of the Bid Manager API has been sunset. Users must [migrate to Bid Manager API v2](/bid-manager/how-tos/v2-migration).\n|\n|\n| Requests to this version may return an error. If the request is successful, the following fields in retrieved [`Query`](/bid-manager/v1.1/queries#resource) resources will be empty:\n|\n| - [`metadata.googleCloudStoragePathForLatestReport`](/bid-manager/v1.1/queries#metadata.googleCloudStoragePathForLatestReport)\n| - [`metadata.latestReportRunTimeMs`](/bid-manager/v1.1/queries#metadata.latestReportRunTimeMs)\n| - [`metadata.googleDrivePathForLatestReport`](/bid-manager/v1.1/queries#metadata.googleDrivePathForLatestReport)\n|\n| \u003cbr /\u003e\n|\n| **Note:** Requires [authorization](#auth).\n\nRuns a stored query to generate a report.\n[Try it now](#try-it).\n\nRequest\n-------\n\n### HTTP request\n\n```\nPOST https://www.googleapis.com/doubleclickbidmanager/v1.1/query/queryId\n```\n\n### Parameters\n\n| Parameter name | Value | Description |\n|----------------|-----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **Path parameters** |||\n| `queryId` | `long` | Query ID to run. |\n| **Optional query parameters** |||\n| `asynchronous` | `boolean` | Whether the query should be run asynchronously. When true, this method will return immediately. When false or not specified, this method will not return until the query has finished running. (Default: `false`) |\n\n### Authorization\n\nThis request requires authorization with the following scope:\n\n| Scope |\n|---------------------------------------------------------|\n| `https://www.googleapis.com/auth/doubleclickbidmanager` |\n\nFor more information, see the [authentication and authorization](/bid-manager/how-tos/authorizing) page.\n\n### Request body\n\nIn the request body, supply data with the following structure:\n\n```text\n{\n \"dataRange\": string,\n \"reportDataStartTimeMs\": long,\n \"reportDataEndTimeMs\": long,\n \"timezoneCode\": string\n}\n```\n\n| Property name | Value | Description | Notes |\n|-------------------------|----------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------|\n| `dataRange` | `string` | Report data range used to generate the report. \u003cbr /\u003e Acceptable values are: - \"`ALL_TIME`\" - \"`CURRENT_DAY`\" - \"`CUSTOM_DATES`\" - \"`LAST_14_DAYS`\" - \"`LAST_30_DAYS`\" - \"`LAST_365_DAYS`\" - \"`LAST_60_DAYS`\" - \"`LAST_7_DAYS`\" - \"`LAST_90_DAYS`\" - \"`MONTH_TO_DATE`\" - \"`PREVIOUS_DAY`\" - \"`PREVIOUS_HALF_MONTH`\" - \"`PREVIOUS_MONTH`\" - \"`PREVIOUS_QUARTER`\" - \"`PREVIOUS_WEEK`\" - \"`PREVIOUS_YEAR`\" - \"`QUARTER_TO_DATE`\" - \"`TYPE_NOT_SUPPORTED`\" - \"`WEEK_TO_DATE`\" - \"`YEAR_TO_DATE`\" | |\n| `reportDataStartTimeMs` | `long` | The starting time for the data that is shown in the report. Note, `reportDataStartTimeMs` is required if `dataRange` is `CUSTOM_DATES` and ignored otherwise. | |\n| `reportDataEndTimeMs` | `long` | The ending time for the data that is shown in the report. Note, `reportDataEndTimeMs` is required if `dataRange` is `CUSTOM_DATES` and ignored otherwise. | |\n| `timezoneCode` | `string` | Canonical timezone code for report data time. Defaults to `America/New_York`. | |\n\nResponse\n--------\n\nIf successful, this method returns an empty response body.\n\nTry it!\n-------\n\n\nUse the APIs Explorer below to call this method on live data and see the response.\nAlternatively, try the\n[standalone\nExplorer](https://developers.google.com/apis-explorer/#p/doubleclickbidmanager/v1.1/doubleclickbidmanager.queries.runquery)."]]