- Richiesta HTTP
- Parametri del percorso
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- DimensionMetadata
- MetricMetadata
- Prova!
Restituisce i metadati per le dimensioni e le metriche disponibili nei metodi di generazione di report. Utilizzato per esplorare le dimensioni e le metriche. In questo metodo, nella richiesta viene specificato un identificatore di proprietà GA4 di Google Analytics e la risposta dei metadati include dimensioni e metriche personalizzate, nonché metadati universali.
Ad esempio, se una metrica personalizzata con nome parametro levels_unlocked
è registrata in una proprietà, la risposta Metadati conterrà customEvent:levels_unlocked
. I metadati universali sono dimensioni e metriche applicabili a qualsiasi proprietà, come country
e totalUsers
.
Richiesta HTTP
GET https://analyticsdata.googleapis.com/v1alpha/{name=properties/*/metadata}
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
Parametri | |
---|---|
name |
Obbligatoria. Il nome della risorsa dei metadati da recuperare. Questo campo del nome è specificato nel percorso dell'URL e non nei parametri dell'URL. La proprietà è un identificatore numerico di proprietà GA4 di Google Analytics. Per scoprire di più, scopri dove trovare il tuo ID proprietà. Esempio: Properties/1234/metadata Imposta l'ID proprietà su 0 per le dimensioni e le metriche comuni a tutte le proprietà. In questa modalità speciale, questo metodo non restituisce dimensioni e metriche personalizzate. |
Corpo della richiesta
Il corpo della richiesta deve essere vuoto.
Corpo della risposta
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
Le dimensioni e le metriche attualmente accettate nei metodi di generazione di report.
Rappresentazione JSON | |
---|---|
{ "name": string, "dimensions": [ { object ( |
Campi | |
---|---|
name |
Il nome della risorsa di questi metadati. |
dimensions[] |
Le descrizioni delle dimensioni. |
metrics[] |
Le descrizioni delle metriche. |
Ambiti di autorizzazione
Richiede uno dei seguenti ambiti OAuth:
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics
DimensionMetadata
Spiega una dimensione.
Rappresentazione JSON | |
---|---|
{ "apiName": string, "uiName": string, "description": string, "deprecatedApiNames": [ string ], "customDefinition": boolean } |
Campi | |
---|---|
apiName |
Il nome di questa dimensione. Utilizzabile in |
uiName |
Il nome di questa dimensione nell'interfaccia utente di Google Analytics. Ad esempio, |
description |
Descrizione di come viene utilizzata e calcolata questa dimensione. |
deprecatedApiNames[] |
Nomi ancora utilizzabili, ma deprecati per questa dimensione. Se compilata, questa dimensione è disponibile da |
customDefinition |
True se la dimensione è una dimensione personalizzata per questa proprietà. |
MetricMetadata
Spiega una metrica.
Rappresentazione JSON | |
---|---|
{
"apiName": string,
"uiName": string,
"description": string,
"deprecatedApiNames": [
string
],
"type": enum ( |
Campi | |
---|---|
apiName |
Il nome di una metrica. Utilizzabile in |
uiName |
Il nome di questa metrica nell'interfaccia utente di Google Analytics. Ad esempio, |
description |
Descrizione di come viene utilizzata e calcolata questa metrica. |
deprecatedApiNames[] |
Nomi ancora utilizzabili, ma deprecati per questa metrica. Se compilata, questa metrica è disponibile da |
type |
Il tipo di questa metrica. |
expression |
L'espressione matematica per questa metrica derivata. Può essere utilizzato nel campo |
customDefinition |
True se la metrica è una metrica personalizzata per questa proprietà. |