- Recurso: ReportTask
- ReportDefinition
- Dimensão
- DimensionExpression
- CaseExpression
- ConcatenateExpression
- Métrica
- DateRange
- FilterExpression
- FilterExpressionList
- Filtrar
- StringFilter
- MatchType
- InListFilter
- NumericFilter
- Operação
- NumericValue
- BetweenFilter
- MetricAggregation
- OrderBy
- MetricOrderBy
- DimensionOrderBy
- OrderType
- CohortSpec
- Coorte
- CohortsRange
- Granularidade
- CohortReportSettings
- ReportMetadata
- Estado
- Métodos
Recurso: ReportTask
Uma configuração específica de tarefa de relatório.
Representação JSON |
---|
{ "name": string, "reportDefinition": { object ( |
Campos | |
---|---|
name |
Apenas saída. Identificador. O nome do recurso da tarefa de relatório atribuído durante a criação. Formato: "properties/{property}/reportTasks/{reportTask}" |
reportDefinition |
Opcional. Uma definição de relatório para buscar dados de relatório, que descreve a estrutura de um relatório. Ele normalmente inclui os campos que serão incluídos no relatório e os critérios que serão usados para filtrar os dados. |
reportMetadata |
Apenas saída. Os metadados de relatório para uma tarefa de relatório específica, que fornece informações sobre um relatório. Ele geralmente inclui as seguintes informações: o nome do recurso, o estado e o carimbo de data/hora em que o relatório foi criado etc. |
ReportDefinition
A definição de como um relatório deve ser executado.
Representação JSON |
---|
{ "dimensions": [ { object ( |
Campos | |
---|---|
dimensions[] |
Opcional. As dimensões solicitadas e exibidas. |
metrics[] |
Opcional. As métricas solicitadas e exibidas. |
dateRanges[] |
Opcional. Períodos dos dados a serem lidos. Se vários períodos forem solicitados, cada linha da resposta conterá um índice de período baseado em zero. Se dois períodos se sobrepuserem, os dados de eventos dos dias sobrepostos serão incluídos nas linhas de resposta dos dois períodos. Em uma solicitação de coorte, esse |
dimensionFilter |
Opcional. Com os filtros de dimensão, você pode solicitar somente valores de dimensão específicos no relatório. Para saber mais, consulte Princípios básicos dos filtros de dimensão para ver exemplos. Não é possível usar métricas neste filtro. |
metricFilter |
Opcional. A cláusula de filtro das métricas. Aplicado após agregar as linhas do relatório, semelhante à cláusula do SQL. Não é possível usar dimensões neste filtro. |
offset |
Opcional. A contagem de linhas da linha inicial do armazenamento do Google Analytics. A primeira linha é contada como 0. Ao criar uma tarefa de relatório, os parâmetros |
limit |
Opcional. O número de linhas a serem retornadas no relatório. Se não for especificado, 10.000 linhas serão retornadas. A API retorna no máximo 250.000 linhas por solicitação, independentemente de quantas linhas você pedir. A API também poderá retornar menos linhas do que o |
metricAggregations[] |
Opcional. Agregação de métricas. Os valores de métricas agregados serão mostrados nas linhas em que dimensionValues estiverem definidos como "RESERVED_(MetricAggregate)". |
orderBys[] |
Opcional. Especifica como as linhas são ordenadas na resposta. |
currencyCode |
Opcional. Um código de moeda no formato ISO4217, como "AED", "USD", "JPY". Se o campo estiver vazio, o relatório vai usar a moeda padrão da propriedade. |
cohortSpec |
Opcional. Grupo de coorte associado a esta solicitação. Se houver um grupo de coorte na solicitação, o campo "coort" a dimensão deve estar presente. |
keepEmptyRows |
Opcional. Se for falso ou não especificado, cada linha com todas as métricas iguais a 0 não será retornada. Se verdadeiro, essas linhas serão retornadas se não forem removidas separadamente por um filtro. Independentemente dessa configuração de Por exemplo, se uma propriedade nunca registrar um evento |
Dimensão
As dimensões são atributos dos seus dados. Por exemplo, a cidade da dimensão indica a cidade de origem de um evento. Os valores de dimensão nas respostas de relatório são strings. por exemplo, a cidade poderia ser "Paris" ou "Nova York".
Representação JSON |
---|
{
"name": string,
"dimensionExpression": {
object ( |
Campos | |
---|---|
name |
O nome da dimensão. Consulte as Dimensões da API para ver a lista de nomes de dimensões compatíveis com os principais métodos de relatório, como Se As dimensões são referenciadas por |
dimensionExpression |
Uma dimensão pode ser o resultado de uma expressão de várias dimensões. Por exemplo, dimensão "país, cidade": concatenate(país, ", ", cidade). |
DimensionExpression
Usado para expressar uma dimensão que é o resultado de uma fórmula com várias dimensões. Exemplos de uso: 1) bottomCase(dimension) 2) concatenar(dimension1, símbolo, dimension2).
Representação JSON |
---|
{ // Union field |
Campos | |
---|---|
Campo de união one_expression . Especifique um tipo de expressão de dimensão para DimensionExpression . one_expression pode ser apenas de um dos tipos a seguir: |
|
lowerCase |
Usado para converter um valor de dimensão para letras minúsculas. |
upperCase |
Usado para converter um valor de dimensão em letras maiúsculas. |
concatenate |
Usado para combinar valores de dimensão em uma única dimensão. Por exemplo, dimensão "país, cidade": concatenate(país, ", ", cidade). |
CaseExpression
Usado para converter um valor de dimensão em um único caso.
Representação JSON |
---|
{ "dimensionName": string } |
Campos | |
---|---|
dimensionName |
Nome de uma dimensão. O nome precisa se referir a um nome no campo de dimensões da solicitação. |
ConcatenateExpression
Usado para combinar valores de dimensão em uma única dimensão.
Representação JSON |
---|
{ "dimensionNames": [ string ], "delimiter": string } |
Campos | |
---|---|
dimensionNames[] |
São os nomes das dimensões. Os nomes precisam se referir aos nomes no campo de dimensões da solicitação. |
delimiter |
O delimitador colocado entre os nomes das dimensões. Os delimitadores geralmente são caracteres únicos, como "|" ou "," mas podem ser strings mais longas. Se um valor de dimensão tiver o delimitador, ambos estarão presentes na resposta sem distinção. Por exemplo, se o valor da dimensão 1 = "US,FR", o valor da dimensão 2 = "JP" e o delimitador = ", a resposta vai conter "US,FR,JP". |
Métrica
As medidas quantitativas de um relatório. Por exemplo, a métrica eventCount
é o número total de eventos. As solicitações podem ter até 10 métricas.
Representação JSON |
---|
{ "name": string, "expression": string, "invisible": boolean } |
Campos | |
---|---|
name |
O nome da métrica. Consulte as Métricas da API para ver a lista de nomes de métricas compatíveis com os principais métodos de geração de relatórios, como Se As métricas são referenciadas por |
expression |
Uma expressão matemática para métricas derivadas. Por exemplo, a contagem de eventos da métrica por usuário é |
invisible |
Indica se uma métrica está invisível na resposta do relatório. Se uma métrica for invisível, ela não produzirá uma coluna na resposta, mas poderá ser usada em |
DateRange
Um conjunto contíguo de dias: startDate
, startDate + 1
, ..., endDate
. As solicitações são permitidas em até quatro períodos.
Representação JSON |
---|
{ "startDate": string, "endDate": string, "name": string } |
Campos | |
---|---|
startDate |
É a data de início inclusiva para a consulta no formato |
endDate |
A data de término inclusiva para a consulta no formato |
name |
Atribui um nome para o período. A dimensão |
FilterExpression
Para expressar filtros de dimensão ou métrica. Os campos na mesma FilterExpression precisam ter todas as dimensões ou todas as métricas.
Representação JSON |
---|
{ // Union field |
Campos | |
---|---|
Campo de união expr . Especifique um tipo de expressão de filtro para FilterExpression . expr pode ser apenas de um dos tipos a seguir: |
|
andGroup |
As FilterExpressions em andGroup têm uma relação AND. |
orGroup |
As FilterExpressions em orGroup têm uma relação OR. |
notExpression |
A FilterExpression NÃO é notExpression. |
filter |
Um filtro primitivo. Na mesma FilterExpression, todos os nomes de campos do filtro precisam ser todas as dimensões ou todas as métricas. |
FilterExpressionList
Uma lista de expressões de filtro.
Representação JSON |
---|
{
"expressions": [
{
object ( |
Campos | |
---|---|
expressions[] |
Uma lista de expressões de filtro. |
Filtro
Uma expressão para filtrar valores de dimensão ou métrica.
Representação JSON |
---|
{ "fieldName": string, // Union field |
Campos | |
---|---|
fieldName |
O nome da dimensão ou da métrica. Precisa ser um nome definido nas dimensões ou métricas. |
Campo de união one_filter . Especifique um tipo de filtro para Filter . one_filter pode ser apenas de um dos tipos a seguir: |
|
stringFilter |
Filtro relacionado a strings. |
inListFilter |
Um filtro para valores na lista. |
numericFilter |
Um filtro para valores numéricos ou de data. |
betweenFilter |
Um filtro entre dois valores. |
StringFilter
O filtro para string
Representação JSON |
---|
{
"matchType": enum ( |
Campos | |
---|---|
matchType |
O tipo de correspondência deste filtro. |
value |
O valor da string usado para a correspondência. |
caseSensitive |
Se verdadeiro, o valor da string diferencia maiúsculas de minúsculas. |
MatchType
O tipo de correspondência de um filtro de string
Enums | |
---|---|
MATCH_TYPE_UNSPECIFIED |
Não especificado |
EXACT |
Correspondência exata do valor da string. |
BEGINS_WITH |
Começa com o valor da string. |
ENDS_WITH |
Termina com o valor da string. |
CONTAINS |
Contém o valor da string. |
FULL_REGEXP |
Correspondência total da expressão regular com o valor da string. |
PARTIAL_REGEXP |
Correspondência parcial para a expressão regular com o valor da string. |
InListFilter
O resultado precisa estar em uma lista de valores de string.
Representação JSON |
---|
{ "values": [ string ], "caseSensitive": boolean } |
Campos | |
---|---|
values[] |
A lista de valores de string. Não pode ficar em branco. |
caseSensitive |
Se verdadeiro, o valor da string diferencia maiúsculas de minúsculas. |
NumericFilter
Filtros para valores numéricos ou de data.
Representação JSON |
---|
{ "operation": enum ( |
Campos | |
---|---|
operation |
O tipo de operação deste filtro. |
value |
Um valor numérico ou de data. |
Operação
Operação aplicada a um filtro numérico
Enums | |
---|---|
OPERATION_UNSPECIFIED |
Não especificado. |
EQUAL |
Igual |
LESS_THAN |
Menor que |
LESS_THAN_OR_EQUAL |
menor ou igual a |
GREATER_THAN |
maior que |
GREATER_THAN_OR_EQUAL |
maior ou igual a |
NumericValue
Para representar um número.
Representação JSON |
---|
{ // Union field |
Campos | |
---|---|
Campo de união one_value . Um de um valor numérico one_value pode ser apenas um destes: |
|
int64Value |
Número inteiro |
doubleValue |
Valor duplo |
BetweenFilter
Para expressar que o resultado precisa estar entre dois números (inclusivo).
Representação JSON |
---|
{ "fromValue": { object ( |
Campos | |
---|---|
fromValue |
Começa com este número. |
toValue |
Termina com este número. |
MetricAggregation
Representa a agregação de métricas.
Enums | |
---|---|
METRIC_AGGREGATION_UNSPECIFIED |
Operador não especificado. |
TOTAL |
Operador SUM. |
MINIMUM |
Operador mínimo. |
MAXIMUM |
Operador máximo. |
COUNT |
Operador de contagem. |
OrderBy
A ordenação define como as linhas serão classificadas na resposta. Por exemplo, ordenar linhas pela contagem de eventos decrescente é uma ordenação, e ordenar linhas pela string do nome do evento é uma ordem diferente.
Representação JSON |
---|
{ "desc": boolean, // Union field |
Campos | |
---|---|
desc |
Se verdadeiro, classifica por ordem decrescente. |
Campo de união one_order_by . Especifique um tipo de ordem por para OrderBy . one_order_by pode ser apenas de um dos tipos a seguir: |
|
metric |
Classifica os resultados pelos valores de uma métrica. |
dimension |
Classifica os resultados pelos valores de uma dimensão. |
MetricOrderBy
Classifica por valores de métrica.
Representação JSON |
---|
{ "metricName": string } |
Campos | |
---|---|
metricName |
Um nome de métrica na solicitação para ordenar. |
DimensionOrderBy
Classifica por valores de dimensão.
Representação JSON |
---|
{
"dimensionName": string,
"orderType": enum ( |
Campos | |
---|---|
dimensionName |
Um nome de dimensão na solicitação para ordenar. |
orderType |
Controla a regra de ordenação dos valores de dimensões. |
OrderType
Regra para ordenar os valores de dimensão da string.
Enums | |
---|---|
ORDER_TYPE_UNSPECIFIED |
Não especificado. |
ALPHANUMERIC |
Classificação alfanumérica por ponto de código Unicode. Por exemplo, "2" < "A" < "X" < “b” < "z". |
CASE_INSENSITIVE_ALPHANUMERIC |
Classificação alfanumérica sem distinção entre maiúsculas e minúsculas por ponto de código Unicode minúsculo. Por exemplo, "2" < "A" < “b” < "X" < "z". |
NUMERIC |
Os valores das dimensões são convertidos em números antes da classificação. Por exemplo, em classificação NUMERIC, "25" < "100" e na classificação ALPHANUMERIC , "100" < "25". Todos os valores de dimensão não numéricos têm o mesmo valor de ordenação abaixo de todos os valores numéricos. |
CohortSpec
A especificação de coortes para um relatório de coorte.
Os relatórios de coorte criam uma série temporal de retenção de usuários para a coorte. Por exemplo, é possível selecionar a coorte de usuários adquiridos na primeira semana de setembro e seguir essa coorte pelas próximas seis semanas. A seleção dos usuários adquiridos na primeira semana da coorte de setembro é especificada no objeto cohort
. A coorte das próximas seis semanas é especificada no objeto cohortsRange
.
Para exemplos, consulte Exemplos de relatórios de coorte.
A resposta do relatório pode mostrar uma série temporal semanal em que o app reteve 60% da coorte após três semanas e 25% após seis semanas. Essas duas porcentagens podem ser calculadas pela métrica cohortActiveUsers/cohortTotalUsers
e vão aparecer em linhas separadas no relatório.
Representação JSON |
---|
{ "cohorts": [ { object ( |
Campos | |
---|---|
cohorts[] |
Define os critérios de seleção para agrupar usuários em coortes. A maioria dos relatórios de coorte define apenas uma única coorte. Se várias coortes forem especificadas, cada uma delas poderá ser reconhecida no relatório pelo nome. |
cohortsRange |
Os relatórios de coorte seguem as coortes durante um período de relatório estendido. Esse intervalo especifica uma duração de deslocamento para acompanhar as coortes. |
cohortReportSettings |
Configurações opcionais para um relatório de coorte. |
Coorte
Define um critério de seleção de coorte. Um coorte é um grupo de usuários que compartilham uma característica comum. Por exemplo, usuários com o mesmo firstSessionDate
pertencem à mesma coorte.
Representação JSON |
---|
{
"name": string,
"dimension": string,
"dateRange": {
object ( |
Campos | |
---|---|
name |
Atribui um nome à coorte. A dimensão |
dimension |
Dimensão usada pela coorte. Obrigatório e compatível apenas com |
dateRange |
A coorte seleciona usuários que tiveram a data do primeiro contato entre as datas de início e término definidas no Em uma solicitação de coorte, a Esse |
CohortsRange
Configura o período estendido de um relatório de coorte. Especifica uma duração de deslocamento para seguir as coortes.
Representação JSON |
---|
{
"granularity": enum ( |
Campos | |
---|---|
granularity |
Obrigatório. É a granularidade usada para interpretar |
startOffset |
Se Se Se |
endOffset |
Obrigatório. Se Se Se |
Granularidade
É a granularidade usada para interpretar startOffset
e endOffset
no período estendido de um relatório de coorte.
Enums | |
---|---|
GRANULARITY_UNSPECIFIED |
Nunca deve ser especificado. |
DAILY |
Granularidade diária. Usado normalmente se o dateRange da coorte for de um único dia e a solicitação contiver cohortNthDay . |
WEEKLY |
Granularidade semanal. Usado com frequência se o dateRange da coorte tiver uma semana de duração (começando no domingo e terminando no sábado) e se a solicitação contiver cohortNthWeek . |
MONTHLY |
Granularidade mensal. Usado normalmente se o dateRange da coorte tiver a duração de um mês e a solicitação contiver cohortNthMonth . |
CohortReportSettings
Configurações opcionais de um relatório de coorte.
Representação JSON |
---|
{ "accumulate": boolean } |
Campos | |
---|---|
accumulate |
Se verdadeiro, acumula o resultado do primeiro dia de contato até o dia de término. Indisponível em |
ReportMetadata
Os metadados de relatório para uma tarefa de relatório específica.
Representação JSON |
---|
{
"creationQuotaTokensCharged": integer,
"state": enum ( |
Campos | |
---|---|
creationQuotaTokensCharged |
Apenas saída. O total de tokens de cota cobrados durante a criação do relatório. Como essa contagem de tokens é baseada na atividade do estado |
state |
Apenas saída. O estado atual dessa tarefa de relatório. |
beginCreatingTime |
Apenas saída. É a hora em que Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: |
taskRowCount |
Apenas saída. O número total de linhas no resultado do relatório. Esse campo será preenchido quando o estado estiver ativo. É possível utilizar |
errorMessage |
Apenas saída. A mensagem de erro será preenchida se uma tarefa de relatório falhar durante a criação. |
totalRowCount |
Apenas saída. O número total de linhas no armazenamento do Google Analytics. Se você quiser consultar outras linhas de dados além do relatório atual, ele poderá iniciar uma nova tarefa de relatório com base no O Por exemplo, suponha que a |
Estado
O estado de processamento.
Enums | |
---|---|
STATE_UNSPECIFIED |
Um estado não especificado nunca será usado. |
CREATING |
O relatório está sendo criado e vai estar disponível no futuro. A criação ocorre imediatamente após a chamada CreateReport. |
ACTIVE |
O relatório foi criado e está pronto para consultas. |
FAILED |
Não foi possível criar o relatório. |
Métodos |
|
---|---|
|
Inicia a criação de uma tarefa de relatório. |
|
Recebe metadados de relatório sobre uma tarefa de relatório específica. |
|
Lista todas as tarefas de relatório de uma propriedade. |
|
Recupera o conteúdo de uma tarefa de relatório. |