Method: exchanges.generateReport

Genera y devuelve el ID del informe. El informe no se conserva. Las invocaciones con la misma solicitud regenerarán 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

Parámetros
exchange

string

Obligatorio. Nombre del intercambio al que pertenece el informe. Ejemplo: "exchanges/123". Se requiere.

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. Fecha de inicio de los informes en formato ISO_8601, AAAA-MM-DD, inclusive. Se requiere como entrada.
endDate

string

Obligatorio. Fecha de finalización de los informes en formato ISO_8601, AAAA-MM-DD, inclusive. Se requiere como entrada.
reportType

enum (ReportType)

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

enum (DimensionId)

Opcional. Es la lista de dimensiones según las cuales se generará el informe. Si es nulo, solo se incluye el ID del publicador. Si las dimensiones no son compatibles con un tipo de informe específico, 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 permiso de OAuth:

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

Para obtener más información, consulta OAuth 2.0 Overview.

ReportType

Es el tipo de informe.

Enums
REPORT_TYPE_UNSPECIFIED No se especificó el tipo de informe, valor de entrada no válido.
HOURLY Es un tipo de informe por hora.
DAILY Es un tipo de informe diario.
WEEKLY Es un tipo de informe semanal.
MONTHLY Es un tipo de informe mensual.
AWBID_DAILY Es un tipo de informe de AwBid diario.
AWBID_WEEKLY Es un tipo de informe semanal de AwBid.
AWBID_MONTHLY Es un tipo de informe mensual de AwBid.
AWBID_OUT_OF_MONTH_IVT Es un tipo de informe de IVT fuera del mes de AwBid.

DimensionId

Es la enumeración Report DimensionId.

Enums
DIMENSION_ID_UNSPECIFIED No se especificó la dimensión del informe, valor de entrada no válido.
PARTNER_ID Es el ID de socio, que solo se admite en el informe diario.
DEVICE_TYPE Tipo de dispositivo, solo compatible con el informe diario.
CREATIVE_ID Es el ID de la creatividad, que solo se admite en el informe diario. Ten en cuenta que esta dimensión podría contribuir significativamente al tamaño de los archivos de los informes, y los informes que incluyen esta dimensión podrían tardar horas en ejecutarse. En el futuro, limitaremos la clasificación en estos campos de carga pesada.
CREATIVE_TYPE Tipo de creatividad, solo compatible con el informe Diario. Ten en cuenta que esta dimensión podría contribuir significativamente al tamaño del archivo de los informes, y los informes que incluyen esta dimensión podrían tardar horas en ejecutarse. En el futuro, limitaremos la clasificación en estos campos de carga pesada.
REGION_CODE Es el código de país o región, que solo se admite en el informe Diario.
DEAL_ID Es el ID del acuerdo, que se asigna a la fuente de inventario y solo se admite en el informe diario.
PUBLISHER_ID Es el ID de publicador. Si la lista de IDs de dimensiones de entrada es nula, esta es la dimensión predeterminada.