Method: properties.getMetadata

Zwraca metadane wymiarów i danych dostępnych w metodach raportowania. Służy do analizowania wymiarów i danych. W tej metodzie w żądaniu jest podany identyfikator usługi w Google Analytics 4, a odpowiedź metadanych obejmuje niestandardowe wymiary i dane oraz metadane Universal.

Jeśli np. w usłudze zarejestrowane są dane niestandardowe o nazwie parametru levels_unlocked, odpowiedź metadanych będzie zawierać wartość customEvent:levels_unlocked. Metadane uniwersalne to wymiary i dane obowiązujące w przypadku dowolnej usługi, np. country czy totalUsers.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
name

string

Wymagane. Nazwa zasobu metadanych do pobrania. To pole nazwy jest określone w ścieżce adresu URL, a nie w parametrach adresu URL. Usługa to numeryczny identyfikator usługi w GA4. Więcej informacji znajdziesz w artykule, gdzie znaleźć identyfikator usługi.

Przykład: properties/1234/metadata

W przypadku wymiarów i danych wspólnych dla wszystkich usług ustaw Identyfikator usługi na 0. W tym specjalnym trybie ta metoda nie zwraca niestandardowych wymiarów ani danych.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Wymiary, dane i porównania obecnie akceptowane w metodach raportowania.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "name": string,
  "dimensions": [
    {
      object (DimensionMetadata)
    }
  ],
  "metrics": [
    {
      object (MetricMetadata)
    }
  ],
  "comparisons": [
    {
      object (ComparisonMetadata)
    }
  ]
}
Pola
name

string

Nazwa zasobu tych metadanych.
dimensions[]

object (DimensionMetadata)

opisy wymiarów.
metrics[]

object (MetricMetadata)

Opisy danych.
comparisons[]

object (ComparisonMetadata)

opisy porównań,

Zakresy autoryzacji

Wymaga jednego z tych zakresów protokołu OAuth:

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

ComparisonMetadata

Metadane pojedynczego porównania.

Zapis JSON 
{
  "apiName": string,
  "uiName": string,
  "description": string
}
Pola
apiName

string

Nazwa zasobu tego porównania. Używany w polu comparison w porównaniu. Przykład: „porównania/1234”.
uiName

string

Nazwa tego porównania w interfejsie Google Analytics.
description

string

Opis tego porównania.