API Reference

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, vedi la Panoramica.

Ogni sezione di questa guida definisce il metodo e la risposta della richiesta per un tipo di entità nei dati di configurazione per un utente autenticato. Le richieste sono tutte mostrate in formato REST. Alla fine della pagina di ciascun metodo, puoi provare la richiesta in modo interattivo in Explorer API utilizzando il link "Prova".

Tipi di risorse

  1. Riepiloghi account
  2. Link utente dell'account
  3. Account
  4. Collegamenti AdWords
  5. Origini dati personalizzate
  6. Dimensioni personalizzate
  7. Metriche personalizzate
  8. Esperimenti
  9. Filtri
  10. Obiettivi
  11. ID client
  12. Link filtro profilo
  13. Link utente del profilo
  14. Segmenti di pubblico per il remarketing
  15. Segmenti
  16. Report non campionati
  17. Caricamenti
  18. Viste (profili)
  19. Proprietà web
  20. Link 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.

Per i dettagli della risorsa link utente dell'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
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 della risorsa 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.

Per i dettagli delle risorse link AdWords, 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/entityAdWordsLinks/webPropertyAdWordsLinkId Elimina un collegamento tra proprietà web e AdWords.
ricevi GET  /management/accounts/accountId/webproperties/webPropertyId/entityAdWordsLinks/webPropertyAdWordsLinkId Restituisce un link proprietà web-AdWords a cui l'utente ha accesso.
inserire POST  /management/accounts/accountId/webproperties/webPropertyId/entityAdWordsLinks Crea un collegamento webProperty-AdWords.
list GET  /management/accounts/accountId/webproperties/webPropertyId/entityAdWordsLinks Elenca i collegamenti webProperty-AdWords per una determinata proprietà web.
cerotto PATCH  /management/accounts/accountId/webproperties/webPropertyId/entityAdWordsLinks/webPropertyAdWordsLinkId Consente di aggiornare un collegamento webProperty-AdWords esistente. Questo metodo supporta la semantica delle patch.
aggiornamento PUT  /management/accounts/accountId/webproperties/webPropertyId/entityAdWordsLinks/webPropertyAdWordsLinkId Consente di aggiornare un collegamento webProperty-AdWords esistente.

Sorgenti di dati personalizzati

Per i dettagli delle risorse origini dati 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
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 relativa alla rappresentazione delle risorse.

Metodo Richiesta HTTP Descrizione
URI relativi a https://www.googleapis.com/analytics/v3, se non diversamente specificato
ricevi GET  /management/accounts/accountId/webproperties/webPropertyId/customDimensions/customDimensionId Ottieni una dimensione personalizzata a cui ha accesso l'utente.
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 Consente di aggiornare una dimensione personalizzata esistente. Questo metodo supporta la semantica delle patch.
aggiornamento PUT  /management/accounts/accountId/webproperties/webPropertyId/customDimensions/customDimensionId Consente di aggiornare una dimensione personalizzata esistente.

Metriche personalizzate

Per i dettagli della risorsa con 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
ricevi GET  /management/accounts/accountId/webproperties/webPropertyId/customMetrics/customMetricId Ottieni una metrica personalizzata a cui ha accesso l'utente.
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 delle patch.
aggiornamento PUT  /management/accounts/accountId/webproperties/webPropertyId/customMetrics/customMetricId Aggiorna una metrica personalizzata esistente.

Esperimenti

Per i dettagli della risorsa 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.
ricevi 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 Aggiorna un esperimento esistente. Questo metodo supporta la semantica delle patch.
aggiornamento PUT  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/experiments/experimentId Aggiorna un esperimento esistente.

Filtri

Per i dettagli delle risorse 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.
ricevi GET  /management/accounts/accountId/filters/filterId Restituisce un filtro 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 delle patch.
aggiornamento PUT  /management/accounts/accountId/filters/filterId Aggiorna un filtro esistente.

Gol

Per i dettagli della risorsa 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
ricevi GET  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/goals/goalId Consente di ottenere 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 delle 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.

Per i dettagli delle risorse link filtro profilo, 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/profileFilterLinks/linkId Link per eliminare un filtro del profilo.
ricevi 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 Crea un nuovo link al filtro del profilo.
list GET  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/profileFilterLinks Elenca tutti i link ai filtri per un profilo.
cerotto PATCH  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/profileFilterLinks/linkId Aggiorna il link a un filtro profilo esistente. Questo metodo supporta la semantica delle patch.
aggiornamento PUT  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/profileFilterLinks/linkId Aggiorna il link a un filtro profilo esistente.

Per i dettagli della risorsa link utente del profilo, 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/entityUserLinks/linkId Rimuove un utente dalla vista (profilo) specificata.
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 relativa ai 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.
ricevi GET  /management/accounts/accountId/webproperties/webPropertyId/remarketingAudiences/remarketingAudienceId Genera 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 delle 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 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/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.
ricevi 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.
ricevi 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
https://www.googleapis.com/upload/analytics/v3/management/accounts/accountId/webproperties/webPropertyId/customDataSources/customDataSourceId/uploads
Caricare i dati per un'origine dati personalizzata.

Viste (profili)

Per i dettagli delle risorse delle viste (profili), 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 Elimina una vista (profilo).
ricevi GET  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId Restituisce 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 delle patch.
aggiornamento PUT  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId Aggiorna una vista (profilo) esistente.

Proprietà web

Per i dettagli della risorsa delle proprietà web, 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
ricevi GET  /management/accounts/accountId/webproperties/webPropertyId Restituisce 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 delle patch.
aggiornamento PUT  /management/accounts/accountId/webproperties/webPropertyId Aggiorna una proprietà esistente.

Per i dettagli della risorsa link utente di proprietà web, 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/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 per un utente esistente sulla proprietà web specificata.