Para obtener una lista de métodos para este recurso, consulta al final de esta página.
Representaciones de recursos
Representa una consulta.
{
"kind": "doubleclickbidmanager#query",
"queryId": long,
"metadata": {
"title": string,
"dataRange": string,
"format": string,
"running": boolean,
"reportCount": integer,
"googleCloudStoragePathForLatestReport": string,
"latestReportRunTimeMs": long,
"googleDrivePathForLatestReport": string,
"sendNotification": boolean,
"shareEmailAddress": [
string
],
"locale": string
},
"params": {
"type": string,
"groupBys": [
string
],
"filters": [
{
"type": string,
"value": string
}
],
"metrics": [
string
],
"includeInviteData": boolean
},
"schedule": {
"frequency": string,
"endTimeMs": long,
"nextRunMinuteOfDay": integer,
"nextRunTimezoneCode": string
},
"reportDataStartTimeMs": long,
"reportDataEndTimeMs": long,
"timezoneCode": string
}| Nombre de la propiedad | Valor | Descripción | Notas |
|---|---|---|---|
kind |
string |
Identifica qué tipo de recurso es. Valor: la cadena fija "doubleclickbidmanager#query" |
|
metadata |
nested object |
Metadatos de la consulta. | |
metadata.dataRange |
string |
Rango de datos de informes.
Los valores aceptables son los siguientes:
|
|
metadata.format |
string |
Es el formato del informe generado.
Los valores aceptables son los siguientes:
|
|
metadata.googleCloudStoragePathForLatestReport |
string |
La ruta de acceso a la ubicación en Google Cloud Storage en la que se almacena el informe más reciente. | |
metadata.googleDrivePathForLatestReport |
string |
La ruta en Google Drive del informe más reciente. | |
metadata.latestReportRunTimeMs |
long |
Indica el momento en que comenzó a ejecutarse el informe más reciente. | |
metadata.locale |
string |
Es la configuración regional de los informes generados. Los valores aceptables son:
Si una cadena de configuración regional que no está en la lista anterior generará informes en inglés. |
|
metadata.reportCount |
integer |
La cantidad de informes que se generaron para la consulta. | |
metadata.running |
boolean |
Indica si el informe más reciente se está ejecutando actualmente. | |
metadata.sendNotification |
boolean |
Si se debe enviar una notificación por correo electrónico cuando un informe esté listo. El valor predeterminado es falso. | |
metadata.shareEmailAddress[] |
list |
Lista de direcciones de correo electrónico a las que se envían notificaciones cuando se completa el informe. Independiente de sendNotification. |
|
metadata.title |
string |
Título de la consulta. Se usa para asignar un nombre a los informes generados a partir de esta consulta. | |
params |
nested object |
Parámetros de consulta. | |
params.filters[] |
list |
Son los filtros que se usan para hacer coincidir los datos de tráfico en tu informe. | |
params.filters[].type |
string |
Tipo de filtro.
Los valores aceptables son los siguientes:
|
|
params.filters[].value |
string |
Valor del filtro. | |
params.groupBys[] |
list |
Los datos se agrupan según los filtros enumerados en este campo. | |
params.includeInviteData |
boolean |
Obsoleta. Este campo ya no está en uso. | |
params.metrics[] |
list |
Métricas que se incluirán como columnas en su informe. | |
params.type |
string |
Tipo de informe. Limitaciones específicas del tipo:
Los valores aceptables son los siguientes:
|
|
queryId |
long |
ID de consulta. | |
reportDataEndTimeMs |
long |
Es la hora de finalización de los datos que se muestran en el informe. Ten en cuenta que reportDataEndTimeMs es obligatorio si metadata.dataRange es CUSTOM_DATES y, de lo contrario, se ignora. |
|
reportDataStartTimeMs |
long |
Es la hora de inicio de los datos que se muestran en el informe. Ten en cuenta que reportDataStartTimeMs es obligatorio si metadata.dataRange es CUSTOM_DATES y, de lo contrario, se ignora. |
|
schedule |
nested object |
Información sobre la frecuencia y el momento en que se ejecuta una consulta. | |
schedule.endTimeMs |
long |
Fecha y hora hasta la que se ejecutará la consulta de forma periódica. | |
schedule.frequency |
string |
Es la frecuencia con la que se ejecuta la consulta.
Los valores aceptables son los siguientes:
|
|
schedule.nextRunMinuteOfDay |
integer |
Obsoleta. Este campo no tiene efecto. | |
schedule.nextRunTimezoneCode |
string |
Es el código de zona horaria canónico para la hora de generación del informe. La configuración predeterminada es America/New_York. |
|
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. |
Métodos
- createquery
- Crea una consulta.
- deletequery
- Borra una consulta almacenada, así como los informes almacenados asociados.
- getquery
- Recupera una consulta almacenada.
- listqueries
- Recupera las consultas almacenadas.
- runquery
- Ejecuta una consulta almacenada para generar un informe.