Method: exchanges.generateReport

Gera e retorna o ID do relatório. O relatório não é mantido. Invocações com a mesma solicitação vão regenerar o relatório.

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
exchange

string

Obrigatório. Nome da bolsa de valores a que o relatório pertence. Exemplo: "exchanges/123". Obrigatório.

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON 
{
  "startDate": string,
  "endDate": string,
  "reportType": enum (ReportType),
  "dimensionIds": [
    enum (DimensionId)
  ]
}
Campos
startDate

string

Obrigatório. Data de início dos relatórios no formato ISO_8601 AAAA-MM-DD, inclusive. Obrigatório como entrada.
endDate

string

Obrigatório. Data de término dos relatórios no formato ISO_8601 AAAA-MM-DD, inclusive. Obrigatório como entrada.
reportType

enum (ReportType)

Obrigatório. Se não for especificado, o tipo de relatório vai retornar erros.
dimensionIds[]

enum (DimensionId)

Opcional. Lista de dimensões com base nas quais o relatório será gerado. Se for nulo, inclua apenas o ID do publisher. Se as dimensões não forem compatíveis com um tipo específico de relatório, elas serão ignoradas.

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de Report.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte OAuth 2.0 Overview.

ReportType

Tipo de relatório.

Tipos enumerados
REPORT_TYPE_UNSPECIFIED Tipo de relatório não especificado, valor de entrada inválido.
HOURLY Um tipo de relatório por hora.
DAILY Um tipo de relatório diário.
WEEKLY Um tipo de relatório semanal.
MONTHLY Um tipo de relatório mensal.
AWBID_DAILY Um tipo de relatório diário do AwBid.
AWBID_WEEKLY Um tipo de relatório semanal do AwBid.
AWBID_MONTHLY Um tipo de relatório mensal do AwBid.
AWBID_OUT_OF_MONTH_IVT Um tipo de relatório de IVT fora do mês da AwBid.

DimensionId

Enumeração Report DimensionId.

Tipos enumerados
DIMENSION_ID_UNSPECIFIED Dimensão do relatório não especificada, valor de entrada inválido.
PARTNER_ID ID do parceiro, compatível apenas com o relatório diário.
DEVICE_TYPE Tipo de dispositivo, disponível apenas no relatório diário.
CREATIVE_ID ID do criativo, disponível apenas no relatório diário. Essa dimensão pode contribuir significativamente para o tamanho do arquivo dos relatórios. Além disso, os relatórios que incluem essa dimensão podem levar horas para serem executados. No futuro, vamos limitar a classificação nesses campos de carregamento pesado.
CREATIVE_TYPE Tipo de criativo, compatível apenas com o relatório diário. Essa dimensão pode contribuir significativamente para o tamanho do arquivo dos relatórios. Além disso, os relatórios que incluem essa dimensão podem levar horas para serem executados. No futuro, vamos limitar a classificação nesses campos de carregamento pesado.
REGION_CODE Código do país/região, compatível apenas com o relatório diário.
DEAL_ID ID da transação, mapeamento para a origem de inventário, com suporte apenas no relatório diário.
PUBLISHER_ID ID do publisher. Se a lista de IDs de dimensão de entrada for nula, essa será a dimensão padrão.