Method: properties.getMetadata

Retorna metadados para dimensões e métricas disponíveis nos métodos de geração de relatórios. Usada para analisar as dimensões e métricas. Nesse método, um identificador de propriedade do Google Analytics é especificado na solicitação, e a resposta de metadados inclui dimensões e métricas personalizadas, além de metadados universais.

Por exemplo, se uma métrica personalizada com o nome do parâmetro levels_unlocked for registrada em uma propriedade, a resposta de metadados vai conter customEvent:levels_unlocked. Os metadados universais são dimensões e métricas aplicáveis a qualquer propriedade, como country e totalUsers.

Solicitação HTTP

GET https://analyticsdata.googleapis.com/v1beta/{name=properties/*/metadata}

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

Parâmetros de caminho

Parâmetros
name

string

Obrigatório. O nome do recurso dos metadados a serem recuperados. Esse campo de nome é especificado no caminho do URL, não nos parâmetros do URL. A propriedade é um identificador numérico da propriedade do Google Analytics. Para saber mais, consulte onde encontrar o ID da propriedade.

Exemplo: properties/1234/metadata

Defina o ID da propriedade como 0 para dimensões e métricas comuns a todas as propriedades. Nesse modo especial, esse método não retorna dimensões e métricas personalizadas.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

As dimensões, métricas e comparações atualmente aceitas nos métodos de relatórios.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON 
{
  "name": string,
  "dimensions": [
    {
      object (DimensionMetadata)
    }
  ],
  "metrics": [
    {
      object (MetricMetadata)
    }
  ],
  "comparisons": [
    {
      object (ComparisonMetadata)
    }
  ]
}
Campos
name

string

Nome do recurso desses metadados.
dimensions[]

object (DimensionMetadata)

As descrições das dimensões.
metrics[]

object (MetricMetadata)

As descrições das métricas.
comparisons[]

object (ComparisonMetadata)

As descrições de comparação.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

  • https://www.googleapis.com/auth/analytics.readonly
  • https://www.googleapis.com/auth/analytics

ComparisonMetadata

Os metadados de uma única comparação.

Representação JSON 
{
  "apiName": string,
  "uiName": string,
  "description": string
}
Campos
apiName

string

O nome do recurso dessa comparação. Pode ser usado no campo comparison de Comparação. Por exemplo, "comparisons/1234".
uiName

string

Nome dessa comparação na interface do usuário do Google Analytics.
description

string

A descrição dessa comparação.