Method: exchanges.generateReport

Genera y muestra el ID del informe. El informe no se conserva. Las invocaciones con la misma solicitud volverán a generar el informe.

Solicitud HTTP

POST https://dv360exchangereporting.googleapis.com/v1alpha1/{exchange=exchanges/*}:generateReport

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
exchange

string

Obligatorio. Es el nombre del intercambio al que pertenece. Ejemplo: "exchanges/123" Obligatorio.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON
{
  "startDate": string,
  "endDate": string,
  "reportType": enum (ReportType),
  "dimensionIds": [
    enum (DimensionId)
  ]
}
Campos
startDate

string

Obligatorio. Es la fecha de inicio de los informes en formato ISO_8601 (AAAA-MM-DD), inclusive. Obligatorio como entrada.

endDate

string

Obligatorio. Es la fecha de finalización de los informes en formato ISO_8601 (AAAA-MM-DD), inclusive. Obligatorio como entrada.

reportType

enum (ReportType)

Obligatorio. Si no se especifica el tipo de informe, se mostrarán errores.

dimensionIds[]

enum (DimensionId)

Opcional. Lista de dimensiones en función de las cuales se generará el informe. Si es nulo, solo incluye el ID de publicador. Si las dimensiones no se admiten en un tipo específico de informe, se ignorarán.

Cuerpo de la respuesta

Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de Report.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

  • https://www.googleapis.com/auth/doubleclickbidmanager

Para obtener más información, consulta la descripción general de OAuth 2.0.

ReportType

Tipo de informe.

Enumeraciones
REPORT_TYPE_UNSPECIFIED Tipo de informe sin especificar, valor de entrada no válido
HOURLY Tipo de informe por hora.
DAILY Tipo de informe diario.
WEEKLY Tipo de informe semanal.
MONTHLY Tipo de informe mensual.

DimensionId

Se informa el valor enum de DimensionId.

Enumeraciones
DIMENSION_ID_UNSPECIFIED Dimensión del informe sin especificar, valor de entrada no válido.
PARTNER_ID ID de socio, solo se admite en el informe diario.
DEVICE_TYPE Tipo de dispositivo, solo se admite en el informe diario.
CREATIVE_ID ID de la creatividad, solo se admite en el Informe diario. Ten en cuenta que esta dimensión podría contribuir significativamente al tamaño de archivo de los informes. Además, si los informes incluyen esta dimensión, podrían demorar horas en ejecutarse. En el futuro, limitaremos la calificación de estos campos de carga pesada.
CREATIVE_TYPE Tipo de creatividad, solo se admite en el Informe diario. Ten en cuenta que esta dimensión podría contribuir significativamente al tamaño de archivo de los informes. Además, si los informes incluyen esta dimensión, podrían demorar horas en ejecutarse. En el futuro, limitaremos la calificación de estos campos de carga pesada.
REGION_CODE Es el código de país o región, solo se admite en el informe diario.
DEAL_ID ID del acuerdo, asignación a la fuente de inventario; solo se admite en el informe diario.
PUBLISHER_ID ID de publicador, si la lista de ID de la dimensión de entrada es nula, esta es la dimensión predeterminada.