Relatórios: atualizar

Atualiza um relatório. Faça um teste.

Solicitação

Solicitação HTTP

PUT https://www.googleapis.com/dfareporting/v3.4/userprofiles/profileId/reports/reportId

Parâmetros

Nome do parâmetro Valor Descrição
Parâmetros de caminho
profileId long ID do perfil do usuário do Campaign Manager 360.
reportId long É o ID do relatório.

Autorização

Esta solicitação requer autorização com o seguinte escopo:

Escopo
https://www.googleapis.com/auth/dfareporting

Para mais informações, consulte a página de autenticação e autorização.

Corpo da solicitação

No corpo da solicitação, forneça um recurso de relatório com as seguintes propriedades:

Nome da propriedade Valor Descrição Observações
Propriedades obrigatórias
accountId long O ID da conta a que esse relatório pertence.
delivery.recipients[].deliveryType string O tipo de entrega ao destinatário.

Os valores aceitáveis são os seguintes:
  • "ATTACHMENT"
  • "LINK"
gravável
delivery.recipients[].email string O endereço de e-mail do destinatário. gravável
id long O ID único que identifica esse recurso de relatório.
lastModifiedTime unsigned long O registro de data e hora (em milissegundos desde época) da última modificação desse relatório.
name string O nome do relatório. gravável
ownerProfileId long O ID do perfil de usuário do proprietário desse relatório.
schedule.active boolean Se a programação está ativa ou não. Deve ser definida como true ou false. gravável
schedule.expirationDate date A data de expiração na qual o relatório programado deixa de ser gerado. gravável
schedule.repeats string É o intervalo em que o relatório é repetido. Observação:
  • "DAILY" também requer que o campo "every" seja definido.
  • "WEEKLY" também requer que os campos "every" e "repeatsOnWeekDays" sejam definidos.
  • "MONTHLY" também requer que os campos "every" e "runsOnDayOfMonth" sejam definidos.
gravável
schedule.startDate date Data de início do período no qual os relatórios programados devem ser gerados. gravável
type string O tipo do relatório.

Os valores aceitáveis são os seguintes:
  • "CROSS_DIMENSION_REACH"
  • "FLOODLIGHT"
  • "PATH"
  • "PATH_ATTRIBUTION"
  • "PATH_TO_CONVERSION"
  • "REACH"
  • "STANDARD"
Propriedades opcionais
criteria.activities.filters[] list É a lista dos filtros de atividades. Os valores de dimensão precisam ser todos do tipo "dfa:activity" ou "dfa:activityGroup". gravável
criteria.customRichMediaEvents.filteredEventIds[] list Lista dos IDs de evento personalizado de rich media. Os valores de dimensão precisam ser todos do tipo dfa:richMediaEventTypeIdAndName. gravável
criteria.dateRange.endDate date A data de término do período, inclusive. Uma string no formato: "aaaa-MM-dd". gravável
criteria.dateRange.relativeDateRange string É o período relativo a quando o relatório é gerado.

Os valores aceitáveis são os seguintes:
  • "LAST_14_DAYS"
  • "LAST_24_MONTHS"
  • "LAST_30_DAYS"
  • "LAST_365_DAYS"
  • "LAST_60_DAYS"
  • "LAST_7_DAYS"
  • "LAST_90_DAYS"
  • "MONTH_TO_DATE"
  • "PREVIOUS_MONTH"
  • "PREVIOUS_QUARTER"
  • "PREVIOUS_WEEK"
  • "PREVIOUS_YEAR"
  • "QUARTER_TO_DATE"
  • "TODAY"
  • "WEEK_TO_DATE"
  • "YEAR_TO_DATE"
  • "YESTERDAY"
gravável
criteria.dateRange.startDate date A data de início do período, inclusive. Uma string no formato: "aaaa-MM-dd". gravável
criteria.dimensionFilters[] list É a lista dos filtros que serão usados nas dimensões.

Filtros para diferentes dimensões usam AND, filtros para a mesma dimensão são agrupados e usam OR.

gravável
criteria.dimensions[] list É a lista de dimensões padrão que o relatório deve incluir. gravável
criteria.metricNames[] list É a lista dos nomes de métricas que o relatório deve incluir. gravável
crossDimensionReachCriteria object Os critérios para um relatório do tipo "CROSS_DIMENSION_REACH". gravável
crossDimensionReachCriteria.breakdown[] list É a lista de dimensões que o relatório deve incluir. gravável
crossDimensionReachCriteria.dateRange nested object O período para o qual este relatório deve ser gerado. gravável
crossDimensionReachCriteria.dateRange.endDate date A data de término do período, inclusive. Uma string no formato: "aaaa-MM-dd". gravável
crossDimensionReachCriteria.dateRange.relativeDateRange string É o período relativo a quando o relatório é gerado.

Os valores aceitáveis são os seguintes:
  • "LAST_14_DAYS"
  • "LAST_24_MONTHS"
  • "LAST_30_DAYS"
  • "LAST_365_DAYS"
  • "LAST_60_DAYS"
  • "LAST_7_DAYS"
  • "LAST_90_DAYS"
  • "MONTH_TO_DATE"
  • "PREVIOUS_MONTH"
  • "PREVIOUS_QUARTER"
  • "PREVIOUS_WEEK"
  • "PREVIOUS_YEAR"
  • "QUARTER_TO_DATE"
  • "TODAY"
  • "WEEK_TO_DATE"
  • "YEAR_TO_DATE"
  • "YESTERDAY"
gravável
crossDimensionReachCriteria.dateRange.startDate date A data de início do período, inclusive. Uma string no formato: "aaaa-MM-dd". gravável
crossDimensionReachCriteria.dimension string É a opção da dimensão.

Os valores aceitáveis são os seguintes:
  • "ADVERTISER"
  • "CAMPAIGN"
  • "SITE_BY_ADVERTISER"
  • "SITE_BY_CAMPAIGN"
gravável
crossDimensionReachCriteria.dimensionFilters[] list É a lista dos filtros que serão usados nas dimensões. gravável
crossDimensionReachCriteria.metricNames[] list É a lista dos nomes de métricas que o relatório deve incluir. gravável
crossDimensionReachCriteria.overlapMetricNames[] list É a lista de nomes das métricas de sobreposição que o relatório deve incluir. gravável
crossDimensionReachCriteria.pivoted boolean Se o relatório é dinâmico ou não. O padrão é true. gravável
delivery object As configurações de entrega de relatórios por e-mail. gravável
delivery.emailOwner boolean Se o relatório deve ser enviado por e-mail ao proprietário do relatório. gravável
delivery.emailOwnerDeliveryType string É o tipo de entrega para o proprietário que receberá o relatório, se ativado.

Os valores aceitáveis são os seguintes:
  • "ATTACHMENT"
  • "LINK"
gravável
delivery.message string A mensagem que será enviada em cada e-mail. gravável
delivery.recipients[] list A lista dos destinatários para os quais enviar o relatório por e-mail. gravável
fileName string O nome de arquivo usado ao gerar os arquivos de relatório. gravável
floodlightCriteria.dateRange.endDate date A data de término do período, inclusive. Uma string no formato: "aaaa-MM-dd". gravável
floodlightCriteria.dateRange.relativeDateRange string É o período relativo a quando o relatório é gerado.

Os valores aceitáveis são os seguintes:
  • "LAST_14_DAYS"
  • "LAST_24_MONTHS"
  • "LAST_30_DAYS"
  • "LAST_365_DAYS"
  • "LAST_60_DAYS"
  • "LAST_7_DAYS"
  • "LAST_90_DAYS"
  • "MONTH_TO_DATE"
  • "PREVIOUS_MONTH"
  • "PREVIOUS_QUARTER"
  • "PREVIOUS_WEEK"
  • "PREVIOUS_YEAR"
  • "QUARTER_TO_DATE"
  • "TODAY"
  • "WEEK_TO_DATE"
  • "YEAR_TO_DATE"
  • "YESTERDAY"
gravável
floodlightCriteria.dateRange.startDate date A data de início do período, inclusive. Uma string no formato: "aaaa-MM-dd". gravável
floodlightCriteria.dimensionFilters[] list É a lista dos filtros que serão usados nas dimensões.

Filtros para diferentes dimensões usam AND, filtros para a mesma dimensão são agrupados e usam OR.

gravável
floodlightCriteria.dimensions[] list É a lista de dimensões que o relatório deve incluir. gravável
floodlightCriteria.floodlightConfigId nested object É o ID do Floodlight para os dados que você quer exibir no relatório. Todos os anunciantes associados a esse ID serão automaticamente adicionados. A dimensão do valor precisa ser "dfa:floodlightConfigId". gravável
floodlightCriteria.metricNames[] list É a lista dos nomes de métricas que o relatório deve incluir. gravável
format string O formato de saída do relatório. Se não for especificado, o formato padrão será "CSV". O formato real no arquivo de relatório concluído poderá ser diferente se, por exemplo, o tamanho do relatório exceder as capacidades do formato. Nesse caso, "CSV" será o formato substituto.

Os valores aceitáveis são os seguintes:
  • "CSV"
  • "EXCEL"
gravável
pathAttributionCriteria.activityFilters[] list A lista de valores "dfa:activity" para filtrar. gravável
pathAttributionCriteria.dateRange.endDate date A data de término do período, inclusive. Uma string no formato: "aaaa-MM-dd". gravável
pathAttributionCriteria.dateRange.relativeDateRange string É o período relativo a quando o relatório é gerado.

Os valores aceitáveis são os seguintes:
  • "LAST_14_DAYS"
  • "LAST_24_MONTHS"
  • "LAST_30_DAYS"
  • "LAST_365_DAYS"
  • "LAST_60_DAYS"
  • "LAST_7_DAYS"
  • "LAST_90_DAYS"
  • "MONTH_TO_DATE"
  • "PREVIOUS_MONTH"
  • "PREVIOUS_QUARTER"
  • "PREVIOUS_WEEK"
  • "PREVIOUS_YEAR"
  • "QUARTER_TO_DATE"
  • "TODAY"
  • "WEEK_TO_DATE"
  • "YEAR_TO_DATE"
  • "YESTERDAY"
gravável
pathAttributionCriteria.dateRange.startDate date A data de início do período, inclusive. Uma string no formato: "aaaa-MM-dd". gravável
pathAttributionCriteria.dimensions[] list É a lista de dimensões que o relatório deve incluir. gravável
pathAttributionCriteria.floodlightConfigId nested object É o ID do Floodlight para os dados que você quer exibir no relatório. Todos os anunciantes associados a esse ID serão automaticamente adicionados. A dimensão do valor precisa ser "dfa:floodlightConfigId". gravável
pathAttributionCriteria.metricNames[] list É a lista dos nomes de métricas que o relatório deve incluir. gravável
pathCriteria.activityFilters[] list A lista de valores "dfa:activity" para filtrar. gravável
pathCriteria.dateRange.endDate date A data de término do período, inclusive. Uma string no formato: "aaaa-MM-dd". gravável
pathCriteria.dateRange.relativeDateRange string É o período relativo a quando o relatório é gerado.

Os valores aceitáveis são os seguintes:
  • "LAST_14_DAYS"
  • "LAST_24_MONTHS"
  • "LAST_30_DAYS"
  • "LAST_365_DAYS"
  • "LAST_60_DAYS"
  • "LAST_7_DAYS"
  • "LAST_90_DAYS"
  • "MONTH_TO_DATE"
  • "PREVIOUS_MONTH"
  • "PREVIOUS_QUARTER"
  • "PREVIOUS_WEEK"
  • "PREVIOUS_YEAR"
  • "QUARTER_TO_DATE"
  • "TODAY"
  • "WEEK_TO_DATE"
  • "YEAR_TO_DATE"
  • "YESTERDAY"
gravável
pathCriteria.dateRange.startDate date A data de início do período, inclusive. Uma string no formato: "aaaa-MM-dd". gravável
pathCriteria.dimensions[] list É a lista de dimensões que o relatório deve incluir. gravável
pathCriteria.floodlightConfigId nested object É o ID do Floodlight para os dados que você quer exibir no relatório. Todos os anunciantes associados a esse ID serão automaticamente adicionados. A dimensão do valor precisa ser "dfa:floodlightConfigId". gravável
pathCriteria.metricNames[] list É a lista dos nomes de métricas que o relatório deve incluir. gravável
pathToConversionCriteria.activityFilters[] list A lista de valores "dfa:activity" para filtrar. gravável
pathToConversionCriteria.conversionDimensions[] list É a lista de dimensões de conversão que o relatório deve incluir. gravável
pathToConversionCriteria.customFloodlightVariables[] list É a lista de variáveis personalizadas do Floodlight que o relatório deve incluir. gravável
pathToConversionCriteria.dateRange.endDate date A data de término do período, inclusive. Uma string no formato: "aaaa-MM-dd". gravável
pathToConversionCriteria.dateRange.relativeDateRange string É o período relativo a quando o relatório é gerado.

Os valores aceitáveis são os seguintes:
  • "LAST_14_DAYS"
  • "LAST_24_MONTHS"
  • "LAST_30_DAYS"
  • "LAST_365_DAYS"
  • "LAST_60_DAYS"
  • "LAST_7_DAYS"
  • "LAST_90_DAYS"
  • "MONTH_TO_DATE"
  • "PREVIOUS_MONTH"
  • "PREVIOUS_QUARTER"
  • "PREVIOUS_WEEK"
  • "PREVIOUS_YEAR"
  • "QUARTER_TO_DATE"
  • "TODAY"
  • "WEEK_TO_DATE"
  • "YEAR_TO_DATE"
  • "YESTERDAY"
gravável
pathToConversionCriteria.dateRange.startDate date A data de início do período, inclusive. Uma string no formato: "aaaa-MM-dd". gravável
pathToConversionCriteria.floodlightConfigId nested object É o ID do Floodlight para os dados que você quer exibir no relatório. Todos os anunciantes associados a esse ID serão automaticamente adicionados. A dimensão do valor precisa ser "dfa:floodlightConfigId". gravável
pathToConversionCriteria.metricNames[] list É a lista dos nomes de métricas que o relatório deve incluir. gravável
pathToConversionCriteria.perInteractionDimensions[] list É a lista de dimensões por interação que o relatório deve incluir. gravável
reachCriteria.activities.filters[] list É a lista dos filtros de atividades. Os valores de dimensão precisam ser todos do tipo "dfa:activity" ou "dfa:activityGroup". gravável
reachCriteria.customRichMediaEvents.filteredEventIds[] list Lista dos IDs de evento personalizado de rich media. Os valores de dimensão precisam ser todos do tipo dfa:richMediaEventTypeIdAndName. gravável
reachCriteria.dateRange.endDate date A data de término do período, inclusive. Uma string no formato: "aaaa-MM-dd". gravável
reachCriteria.dateRange.relativeDateRange string É o período relativo a quando o relatório é gerado.

Os valores aceitáveis são os seguintes:
  • "LAST_14_DAYS"
  • "LAST_24_MONTHS"
  • "LAST_30_DAYS"
  • "LAST_365_DAYS"
  • "LAST_60_DAYS"
  • "LAST_7_DAYS"
  • "LAST_90_DAYS"
  • "MONTH_TO_DATE"
  • "PREVIOUS_MONTH"
  • "PREVIOUS_QUARTER"
  • "PREVIOUS_WEEK"
  • "PREVIOUS_YEAR"
  • "QUARTER_TO_DATE"
  • "TODAY"
  • "WEEK_TO_DATE"
  • "YEAR_TO_DATE"
  • "YESTERDAY"
gravável
reachCriteria.dateRange.startDate date A data de início do período, inclusive. Uma string no formato: "aaaa-MM-dd". gravável
reachCriteria.dimensionFilters[] list É a lista dos filtros que serão usados nas dimensões.

Filtros para diferentes dimensões usam AND, filtros para a mesma dimensão são agrupados e usam OR.

gravável
reachCriteria.dimensions[] list É a lista de dimensões que o relatório deve incluir. gravável
reachCriteria.enableAllDimensionCombinations boolean Indica se todas as combinações de dimensões de alcance serão ativadas no relatório. Padroniza como falso. Se ativado, o período do relatório precisa ser nos últimos 42 dias. gravável
reachCriteria.metricNames[] list É a lista dos nomes de métricas que o relatório deve incluir. gravável
reachCriteria.reachByFrequencyMetricNames[] list É a lista de nomes das métricas de alcance por frequência que o relatório deve incluir. gravável
schedule object A programação do relatório. Só poderá ser definida se o "dateRange" do relatório for um período relativo e se o período relativo não for "TODAY". gravável
schedule.every integer Define a cada quantos dias, semanas ou meses o relatório deve ser gerado. Precisa ser definida quando "repeats" for "DAILY", "WEEKLY" ou "MONTHLY". gravável
schedule.repeatsOnWeekDays[] list Lista dos dias da semana em que os relatórios programados "WEEKLY" devem ser gerados. gravável
schedule.runsOnDayOfMonth string Nos relatórios programados "MONTHLY", é a enumeração para definir se os relatórios devem ser repetidos no mesmo dia do mês como "startDate" ou no mesmo dia da semana no mês.

Exemplo: se "startDate" fosse segunda-feira, 2 de abril de 2012 (2012-04-02), "DAY_OF_MONTH" geraria os relatórios subsequentes no dia 2 de cada mês, e "WEEK_OF_MONTH" geraria relatórios subsequentes na primeira segunda-feira do mês.



Os valores aceitáveis são os seguintes:
  • "DAY_OF_MONTH"
  • "WEEK_OF_MONTH"
gravável

Resposta

Se for bem-sucedido, este método retorna um recurso de relatório no corpo da resposta.

Faça um teste.

Use o APIs Explorer abaixo para chamar esse método em dados ativos e ver a resposta.