Method: exchanges.generateReport

Gera e retorna o ID do relatório. O relatório não é mantido. As invocações com a mesma solicitação gerarão o relatório novamente.

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 troca a que o relatório pertence. Exemplo: "trocas/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. O tipo de relatório, se não for especificado, 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 editor. 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 a Visão geral do OAuth 2.0.

ReportType

Tipo de relatório.

Enums
REPORT_TYPE_UNSPECIFIED Tipo de relatório não especificado, valor de entrada inválido
HOURLY Tipo de relatório por hora.
DAILY Tipo de relatório diário.
WEEKLY Tipo de relatório semanal.
MONTHLY Tipo de relatório mensal.

DimensionId

Enumeração de DimensionId do relatório.

Enums
DIMENSION_ID_UNSPECIFIED Dimensão do relatório não especificada, valor de entrada inválido.
PARTNER_ID ID do parceiro, suportado apenas no relatório diário.
DEVICE_TYPE Tipo de dispositivo, suportado apenas no relatório diário.
CREATIVE_ID ID do criativo, suportado 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 gerados. No futuro, limitaremos a classificação desses campos de carregamento intenso.
CREATIVE_TYPE Tipo de criativo, suportado 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 gerados. No futuro, limitaremos a classificação desses campos de carregamento intenso.
REGION_CODE Código do país/região, suportado apenas no relatório diário.
DEAL_ID ID da transação, mapeamento para a origem de inventário, aceito apenas no relatório diário.
PUBLISHER_ID ID do editor, se a lista de IDs da dimensão de entrada for nula, essa será a dimensão padrão.