API DI GESTIONE
Questa è la guida di riferimento per la versione 3.0 dell'API di gestione. Fornisce dettagli completi sulle query e sulle risposte per i dati di configurazione di Google Analytics. Per una guida ai concetti e alla struttura dei dati di configurazione, consulta la Panoramica.
Ogni sezione di questa guida definisce il metodo e la risposta della richiesta per un tipo di entità nei dati di configurazione di un utente autenticato. Le richieste sono tutte mostrate in formato REST. Alla fine della pagina relativa a ciascun metodo, puoi provare la richiesta in modo interattivo in Explorer API utilizzando il link "Prova".
Tipi di risorse
- Riepiloghi account
- Link utente account
- Account
- Collegamenti AdWords
- Origini dati personalizzate
- Dimensioni personalizzate
- Metriche personalizzate
- Esperimenti
- Filtri
- Obiettivi
- ID client
- Link filtro profilo
- Link utente del profilo
- Segmenti di pubblico per il remarketing
- Segmenti
- Report non campionati
- Caricamenti
- Viste (profili)
- Proprietà web
- Collegamenti utente delle proprietà web
Riepiloghi account
Per i dettagli della risorsa relativa ai riepiloghi degli account, consulta la pagina relativa alla rappresentazione delle risorse.
| Metodo | Richiesta HTTP | Descrizione |
|---|---|---|
| URI relativi a https://www.googleapis.com/analytics/v3, se non diversamente specificato | ||
| list |
GET /management/accountSummaries
|
Elenca i riepiloghi degli account (albero leggero composto da account/proprietà/profili) a cui l'utente ha accesso. |
Link utente account
Per i dettagli della risorsa Collegamenti utente account, consulta la pagina sulla rappresentazione delle risorse.
| Metodo | Richiesta HTTP | Descrizione |
|---|---|---|
| URI relativi a https://www.googleapis.com/analytics/v3, se non diversamente specificato | ||
| elimina |
DELETE /management/accounts/accountId/entityUserLinks/linkId
|
Rimuove un utente dall'account specificato. |
| inserire |
POST /management/accounts/accountId/entityUserLinks
|
Consente di aggiungere un nuovo utente all'account specificato se l'utente ha meno di 100 account. |
| list |
GET /management/accounts/accountId/entityUserLinks
|
Elenca i link utente-account per un determinato account. |
| aggiornamento |
PUT /management/accounts/accountId/entityUserLinks/linkId
|
Aggiorna le autorizzazioni di un utente esistente per l'account in questione. |
Account
Per i dettagli delle risorse degli account, consulta la pagina relativa alla rappresentazione delle risorse.
| Metodo | Richiesta HTTP | Descrizione |
|---|---|---|
| URI relativi a https://www.googleapis.com/analytics/v3, se non diversamente specificato | ||
| list |
GET /management/accounts
|
Elenca tutti gli account a cui l'utente ha accesso. |
Collegamenti AdWords
Per i dettagli della risorsa Collegamenti AdWords, consulta la pagina sulla rappresentazione delle risorse.
| Metodo | Richiesta HTTP | Descrizione |
|---|---|---|
| URI relativi a https://www.googleapis.com/analytics/v3, se non diversamente specificato | ||
| elimina |
DELETE /management/accounts/accountId/webproperties/webPropertyId/entityAdWordsLinks/webPropertyAdWordsLinkId
|
Elimina un collegamento tra proprietà web e AdWords. |
| recupero |
GET /management/accounts/accountId/webproperties/webPropertyId/entityAdWordsLinks/webPropertyAdWordsLinkId
|
Restituisce un link proprietà web-Google Ads a cui l'utente ha accesso. |
| inserire |
POST /management/accounts/accountId/webproperties/webPropertyId/entityAdWordsLinks
|
Crea un collegamento webProperty-Google Ads. |
| list |
GET /management/accounts/accountId/webproperties/webPropertyId/entityAdWordsLinks
|
Elenca i link webProperty-AdWords per una determinata proprietà web. |
| cerotto |
PATCH /management/accounts/accountId/webproperties/webPropertyId/entityAdWordsLinks/webPropertyAdWordsLinkId
|
Aggiorna un collegamento webProperty-AdWords esistente. Questo metodo supporta la semantica della patch. |
| aggiornamento |
PUT /management/accounts/accountId/webproperties/webPropertyId/entityAdWordsLinks/webPropertyAdWordsLinkId
|
Aggiorna un collegamento webProperty-AdWords esistente. |
Sorgenti di dati personalizzati
Per i dettagli della risorsa origini dati personalizzate, consulta la pagina sulla rappresentazione delle risorse.
| Metodo | Richiesta HTTP | Descrizione |
|---|---|---|
| URI relativi a https://www.googleapis.com/analytics/v3, se non diversamente specificato | ||
| list |
GET /management/accounts/accountId/webproperties/webPropertyId/customDataSources
|
Elenca le origini dati personalizzate a cui l'utente ha accesso. |
Dimensioni personalizzate
Per i dettagli della risorsa con dimensioni personalizzate, consulta la pagina sulla rappresentazione delle risorse.
| Metodo | Richiesta HTTP | Descrizione |
|---|---|---|
| URI relativi a https://www.googleapis.com/analytics/v3, se non diversamente specificato | ||
| recupero |
GET /management/accounts/accountId/webproperties/webPropertyId/customDimensions/customDimensionId
|
Ottenere una dimensione personalizzata a cui l'utente ha accesso. |
| inserire |
POST /management/accounts/accountId/webproperties/webPropertyId/customDimensions
|
Crea una nuova dimensione personalizzata. |
| list |
GET /management/accounts/accountId/webproperties/webPropertyId/customDimensions
|
Elenca le dimensioni personalizzate a cui l'utente ha accesso. |
| cerotto |
PATCH /management/accounts/accountId/webproperties/webPropertyId/customDimensions/customDimensionId
|
Aggiorna una dimensione personalizzata esistente. Questo metodo supporta la semantica della patch. |
| aggiornamento |
PUT /management/accounts/accountId/webproperties/webPropertyId/customDimensions/customDimensionId
|
Aggiorna una dimensione personalizzata esistente. |
Metriche personalizzate
Per i dettagli della risorsa relativa alle metriche personalizzate, consulta la pagina relativa alla rappresentazione delle risorse.
| Metodo | Richiesta HTTP | Descrizione |
|---|---|---|
| URI relativi a https://www.googleapis.com/analytics/v3, se non diversamente specificato | ||
| recupero |
GET /management/accounts/accountId/webproperties/webPropertyId/customMetrics/customMetricId
|
Ottenere una metrica personalizzata a cui l'utente ha accesso. |
| inserire |
POST /management/accounts/accountId/webproperties/webPropertyId/customMetrics
|
Crea una nuova metrica personalizzata. |
| list |
GET /management/accounts/accountId/webproperties/webPropertyId/customMetrics
|
Elenca le metriche personalizzate a cui l'utente ha accesso. |
| cerotto |
PATCH /management/accounts/accountId/webproperties/webPropertyId/customMetrics/customMetricId
|
Aggiorna una metrica personalizzata esistente. Questo metodo supporta la semantica della patch. |
| aggiornamento |
PUT /management/accounts/accountId/webproperties/webPropertyId/customMetrics/customMetricId
|
Aggiorna una metrica personalizzata esistente. |
Esperimenti
Per i dettagli delle risorse degli esperimenti, consulta la pagina relativa alla rappresentazione delle risorse.
| Metodo | Richiesta HTTP | Descrizione |
|---|---|---|
| URI relativi a https://www.googleapis.com/analytics/v3, se non diversamente specificato | ||
| elimina |
DELETE /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/experiments/experimentId
|
Eliminare un esperimento. |
| recupero |
GET /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/experiments/experimentId
|
Restituisce un esperimento a cui l'utente ha accesso. |
| inserire |
POST /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/experiments
|
Crea un nuovo esperimento. |
| list |
GET /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/experiments
|
Elenca gli esperimenti a cui l'utente ha accesso. |
| cerotto |
PATCH /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/experiments/experimentId
|
Aggiornare un esperimento esistente. Questo metodo supporta la semantica della patch. |
| aggiornamento |
PUT /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/experiments/experimentId
|
Aggiornare un esperimento esistente. |
Filtri
Per i dettagli della risorsa filtri, consulta la pagina relativa alla rappresentazione delle risorse.
| Metodo | Richiesta HTTP | Descrizione |
|---|---|---|
| URI relativi a https://www.googleapis.com/analytics/v3, se non diversamente specificato | ||
| elimina |
DELETE /management/accounts/accountId/filters/filterId
|
Eliminare un filtro. |
| recupero |
GET /management/accounts/accountId/filters/filterId
|
Restituisce i filtri a cui l'utente ha accesso. |
| inserire |
POST /management/accounts/accountId/filters
|
Crea un nuovo filtro. |
| list |
GET /management/accounts/accountId/filters
|
Elenca tutti i filtri per un account |
| cerotto |
PATCH /management/accounts/accountId/filters/filterId
|
Aggiorna un filtro esistente. Questo metodo supporta la semantica della patch. |
| aggiornamento |
PUT /management/accounts/accountId/filters/filterId
|
Aggiorna un filtro esistente. |
Obiettivi
Per i dettagli delle risorse obiettivi, consulta la pagina relativa alla rappresentazione delle risorse.
| Metodo | Richiesta HTTP | Descrizione |
|---|---|---|
| URI relativi a https://www.googleapis.com/analytics/v3, se non diversamente specificato | ||
| recupero |
GET /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/goals/goalId
|
Recupera un obiettivo a cui l'utente ha accesso. |
| inserire |
POST /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/goals
|
Crea un nuovo obiettivo. |
| list |
GET /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/goals
|
Elenca gli obiettivi a cui l'utente ha accesso. |
| cerotto |
PATCH /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/goals/goalId
|
Consente di aggiornare un obiettivo esistente. Questo metodo supporta la semantica della patch. |
| aggiornamento |
PUT /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/goals/goalId
|
Consente di aggiornare un obiettivo esistente. |
ID client
Per i dettagli della risorsa Management.clientId, consulta la pagina relativa alla rappresentazione delle risorse.
| Metodo | Richiesta HTTP | Descrizione |
|---|---|---|
| URI relativi a https://www.googleapis.com/analytics/v3, se non diversamente specificato | ||
| hashClientId |
POST /management/clientId:hashClientId
|
Esegue l'hashing dell'ID client specificato. |
Link filtro profilo
Per i dettagli della risorsa link filtro profilo, consulta la pagina sulla rappresentazione delle risorse.
| Metodo | Richiesta HTTP | Descrizione |
|---|---|---|
| URI relativi a https://www.googleapis.com/analytics/v3, se non diversamente specificato | ||
| elimina |
DELETE /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/profileFilterLinks/linkId
|
Elimina un link a un filtro di profilo. |
| recupero |
GET /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/profileFilterLinks/linkId
|
Restituisce un singolo link al filtro del profilo. |
| inserire |
POST /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/profileFilterLinks
|
Link Crea un nuovo filtro profilo. |
| list |
GET /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/profileFilterLinks
|
Elenca tutti i link ai filtri di un profilo. |
| cerotto |
PATCH /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/profileFilterLinks/linkId
|
Link per aggiornare un filtro profilo esistente. Questo metodo supporta la semantica della patch. |
| aggiornamento |
PUT /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/profileFilterLinks/linkId
|
Link per aggiornare un filtro profilo esistente. |
Link utente del profilo
Per i dettagli della risorsa link utente del profilo, consulta la pagina sulla rappresentazione delle risorse.
| Metodo | Richiesta HTTP | Descrizione |
|---|---|---|
| URI relativi a https://www.googleapis.com/analytics/v3, se non diversamente specificato | ||
| elimina |
DELETE /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/entityUserLinks/linkId
|
Rimuove un utente dalla vista (profilo) fornita. |
| inserire |
POST /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/entityUserLinks
|
Aggiunge un nuovo utente alla vista (profilo) specificata. |
| list |
GET /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/entityUserLinks
|
Elenca i link utente-profilo per una determinata vista (profilo). |
| aggiornamento |
PUT /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/entityUserLinks/linkId
|
Aggiorna le autorizzazioni per un utente esistente nella vista (profilo) specificata. |
Segmenti di pubblico per il remarketing
Per i dettagli della risorsa Segmenti di pubblico per il remarketing, consulta la pagina relativa alla rappresentazione delle risorse.
| Metodo | Richiesta HTTP | Descrizione |
|---|---|---|
| URI relativi a https://www.googleapis.com/analytics/v3, se non diversamente specificato | ||
| elimina |
DELETE /management/accounts/accountId/webproperties/webPropertyId/remarketingAudiences/remarketingAudienceId
|
Eliminare un segmento di pubblico per il remarketing. |
| recupero |
GET /management/accounts/accountId/webproperties/webPropertyId/remarketingAudiences/remarketingAudienceId
|
Recupera un segmento di pubblico per il remarketing a cui l'utente ha accesso. |
| inserire |
POST /management/accounts/accountId/webproperties/webPropertyId/remarketingAudiences
|
Crea un nuovo segmento di pubblico per il remarketing. |
| list |
GET /management/accounts/accountId/webproperties/webPropertyId/remarketingAudiences
|
Elenca i segmenti di pubblico per il remarketing a cui l'utente ha accesso. |
| cerotto |
PATCH /management/accounts/accountId/webproperties/webPropertyId/remarketingAudiences/remarketingAudienceId
|
Consente di aggiornare un segmento di pubblico per il remarketing esistente. Questo metodo supporta la semantica della patch. |
| aggiornamento |
PUT /management/accounts/accountId/webproperties/webPropertyId/remarketingAudiences/remarketingAudienceId
|
Consente di aggiornare un segmento di pubblico per il remarketing esistente. |
Segmenti
Per i dettagli della risorsa Segmenti, consulta la pagina sulla rappresentazione delle risorse.
| Metodo | Richiesta HTTP | Descrizione |
|---|---|---|
| URI relativi a https://www.googleapis.com/analytics/v3, se non diversamente specificato | ||
| list |
GET /management/segments
|
Elenca i segmenti a cui l'utente ha accesso. |
Report non campionati
Per i dettagli delle risorse di report non campionati, consulta la pagina relativa alla rappresentazione delle risorse.
| Metodo | Richiesta HTTP | Descrizione |
|---|---|---|
| URI relativi a https://www.googleapis.com/analytics/v3, se non diversamente specificato | ||
| elimina |
DELETE /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/unsampledReports/unsampledReportId
|
Elimina un report non campionato. |
| recupero |
GET /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/unsampledReports/unsampledReportId
|
Restituisce un singolo report non campionato. |
| inserire |
POST /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/unsampledReports
|
Crea un nuovo report non campionato. |
| list |
GET /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/unsampledReports
|
Elenca i report non campionati a cui l'utente ha accesso. |
Caricamenti
Per i dettagli delle risorse per i caricamenti, consulta la pagina relativa alla rappresentazione delle risorse.
| Metodo | Richiesta HTTP | Descrizione |
|---|---|---|
| URI relativi a https://www.googleapis.com/analytics/v3, se non diversamente specificato | ||
| deleteUploadData |
POST /management/accounts/accountId/webproperties/webPropertyId/customDataSources/customDataSourceId/deleteUploadData
|
Elimina i dati associati a un caricamento precedente. |
| recupero |
GET /management/accounts/accountId/webproperties/webPropertyId/customDataSources/customDataSourceId/uploads/uploadId
|
Elenca i caricamenti a cui l'utente ha accesso. |
| list |
GET /management/accounts/accountId/webproperties/webPropertyId/customDataSources/customDataSourceId/uploads
|
Elenca i caricamenti a cui l'utente ha accesso. |
| uploadData |
POST
|
Caricare i dati per un'origine dati personalizzata. |
Viste (profili)
Per i dettagli delle risorse delle viste (profili), consulta la pagina sulla rappresentazione delle risorse.
| Metodo | Richiesta HTTP | Descrizione |
|---|---|---|
| URI relativi a https://www.googleapis.com/analytics/v3, se non diversamente specificato | ||
| elimina |
DELETE /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId
|
Elimina una vista (profilo). |
| recupero |
GET /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId
|
Ottieni una vista (profilo) a cui l'utente ha accesso. |
| inserire |
POST /management/accounts/accountId/webproperties/webPropertyId/profiles
|
Crea una nuova vista (profilo). |
| list |
GET /management/accounts/accountId/webproperties/webPropertyId/profiles
|
Elenca le viste (profili) a cui l'utente ha accesso. |
| cerotto |
PATCH /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId
|
Aggiorna una vista (profilo) esistente. Questo metodo supporta la semantica della patch. |
| aggiornamento |
PUT /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId
|
Aggiorna una vista (profilo) esistente. |
Proprietà web
Per i dettagli della risorsa proprietà web, consulta la pagina sulla rappresentazione delle risorse.
| Metodo | Richiesta HTTP | Descrizione |
|---|---|---|
| URI relativi a https://www.googleapis.com/analytics/v3, se non diversamente specificato | ||
| recupero |
GET /management/accounts/accountId/webproperties/webPropertyId
|
Recupera una proprietà a cui l'utente ha accesso. |
| inserire |
POST /management/accounts/accountId/webproperties
|
Crea una nuova proprietà. |
| list |
GET /management/accounts/accountId/webproperties
|
Elenca le proprietà a cui l'utente ha accesso. |
| cerotto |
PATCH /management/accounts/accountId/webproperties/webPropertyId
|
Aggiorna una proprietà esistente. Questo metodo supporta la semantica della patch. |
| aggiornamento |
PUT /management/accounts/accountId/webproperties/webPropertyId
|
Aggiorna una proprietà esistente. |
Link utente delle proprietà web
Per i dettagli della risorsa collegamenti utente della proprietà web, consulta la pagina sulla rappresentazione delle risorse.
| Metodo | Richiesta HTTP | Descrizione |
|---|---|---|
| URI relativi a https://www.googleapis.com/analytics/v3, se non diversamente specificato | ||
| elimina |
DELETE /management/accounts/accountId/webproperties/webPropertyId/entityUserLinks/linkId
|
Rimuove un utente dalla proprietà web specificata. |
| inserire |
POST /management/accounts/accountId/webproperties/webPropertyId/entityUserLinks
|
Aggiunge un nuovo utente alla proprietà web specificata. |
| list |
GET /management/accounts/accountId/webproperties/webPropertyId/entityUserLinks
|
Elenca i link utente-webProperty per una determinata proprietà web. |
| aggiornamento |
PUT /management/accounts/accountId/webproperties/webPropertyId/entityUserLinks/linkId
|
Aggiorna le autorizzazioni di un utente esistente sulla proprietà web specificata. |