API Reference

API MANAGEMENT

Ce document est le guide de référence de l'API Management version 3.0. Il fournit des informations complètes sur les requêtes et les réponses pour les données de configuration Google Analytics. Pour en savoir plus sur les concepts et la structure des données de configuration, consultez la page Présentation.

Chaque section de ce guide définit la méthode de requête et la réponse pour un type d'entité dans les données de configuration d'un utilisateur authentifié. Les requêtes sont toutes affichées au format REST. Au bas de la page de chaque méthode, vous pouvez tester la requête de manière interactive dans APIs Explorer à l'aide du lien "Essayer".

Types de ressources

  1. Résumés du compte
  2. Liens utilisateur du compte
  3. Comptes
  4. Associations AdWords
  5. Sources de données personnalisées
  6. Dimensions personnalisées
  7. Métriques personnalisées
  8. Tests
  9. Filtres
  10. Objectifs
  11. ID client
  12. Liens de filtre de profil
  13. Liens utilisateur du profil
  14. Audiences de remarketing
  15. Segments
  16. Rapports non échantillonnés
  17. Mises en ligne
  18. Vues (profils)
  19. Sites Web
  20. Liens utilisateur de la propriété Web

Résumés du compte

Pour en savoir plus sur la ressource "Account Summaries", consultez la page relative à la représentation des ressources.

Méthode Requête HTTP Description
URI relatifs à https://www.googleapis.com/analytics/v3, sauf indication contraire
liste GET  /management/accountSummaries Liste les récapitulatifs des comptes (arborescence légère comprenant des comptes/propriétés/profils) auxquels l'utilisateur a accès.

Pour en savoir plus sur la ressource "Liens utilisateur de compte", consultez la page Représentation des ressources.

Méthode Requête HTTP Description
URI relatifs à https://www.googleapis.com/analytics/v3, sauf indication contraire
supprimer DELETE  /management/accounts/accountId/entityUserLinks/linkId Supprime un utilisateur du compte donné.
insérer POST  /management/accounts/accountId/entityUserLinks Ajoute un utilisateur au compte donné si celui-ci possède moins de 100 comptes.
liste GET  /management/accounts/accountId/entityUserLinks Liste les liens des utilisateurs de compte pour un compte donné.
mise à jour PUT  /management/accounts/accountId/entityUserLinks/linkId Met à jour les autorisations d'un utilisateur existant sur le compte donné.

Comptes

Pour en savoir plus sur la ressource "Accounts", consultez la page relative à la représentation des ressources.

Méthode Requête HTTP Description
URI relatifs à https://www.googleapis.com/analytics/v3, sauf indication contraire
liste GET  /management/accounts Liste tous les comptes auxquels l'utilisateur a accès.

Pour en savoir plus sur la ressource "Liens AdWords", consultez la page relative aux représentations de la ressource.

Méthode Requête HTTP Description
URI relatifs à https://www.googleapis.com/analytics/v3, sauf indication contraire
supprimer DELETE  /management/accounts/accountId/webproperties/webPropertyId/entityAdWordsLinks/webPropertyAdWordsLinkId Supprime une association propriété Web-AdWords.
get GET  /management/accounts/accountId/webproperties/webPropertyId/entityAdWordsLinks/webPropertyAdWordsLinkId Affiche un lien propriété Web-AdWords auquel l'utilisateur a accès.
insérer POST  /management/accounts/accountId/webproperties/webPropertyId/entityAdWordsLinks Crée une association webProperty-AdWords.
liste GET  /management/accounts/accountId/webproperties/webPropertyId/entityAdWordsLinks Liste les liens webProperty-AdWords pour une propriété Web donnée.
patch PATCH  /management/accounts/accountId/webproperties/webPropertyId/entityAdWordsLinks/webPropertyAdWordsLinkId Met à jour une association webProperty-AdWords existante. Cette méthode est compatible avec la sémantique "patch".
mise à jour PUT  /management/accounts/accountId/webproperties/webPropertyId/entityAdWordsLinks/webPropertyAdWordsLinkId Met à jour une association webProperty-AdWords existante.

Sources de données personnalisées

Pour en savoir plus sur la ressource de sources de données personnalisées, consultez la page relative à la représentation des ressources.

Méthode Requête HTTP Description
URI relatifs à https://www.googleapis.com/analytics/v3, sauf indication contraire
liste GET  /management/accounts/accountId/webproperties/webPropertyId/customDataSources Répertorier les sources de données personnalisées auxquelles l'utilisateur a accès

Dimensions personnalisées

Pour en savoir plus sur la ressource "Dimensions personnalisées", consultez la page relative à la représentation des ressources.

Méthode Requête HTTP Description
URI relatifs à https://www.googleapis.com/analytics/v3, sauf indication contraire
get GET  /management/accounts/accountId/webproperties/webPropertyId/customDimensions/customDimensionId Obtenez une dimension personnalisée à laquelle l'utilisateur a accès.
insérer POST  /management/accounts/accountId/webproperties/webPropertyId/customDimensions Créez une dimension personnalisée.
liste GET  /management/accounts/accountId/webproperties/webPropertyId/customDimensions Répertorie les dimensions personnalisées auxquelles l'utilisateur a accès.
patch PATCH  /management/accounts/accountId/webproperties/webPropertyId/customDimensions/customDimensionId Met à jour une dimension personnalisée existante. Cette méthode est compatible avec la sémantique "patch".
mise à jour PUT  /management/accounts/accountId/webproperties/webPropertyId/customDimensions/customDimensionId Met à jour une dimension personnalisée existante.

Custom Metrics (Métriques personnalisées)

Pour en savoir plus sur la ressource de métriques personnalisées, consultez la page relative à la représentation des ressources.

Méthode Requête HTTP Description
URI relatifs à https://www.googleapis.com/analytics/v3, sauf indication contraire
get GET  /management/accounts/accountId/webproperties/webPropertyId/customMetrics/customMetricId Obtenez une métrique personnalisée à laquelle l'utilisateur a accès.
insérer POST  /management/accounts/accountId/webproperties/webPropertyId/customMetrics Créez une métrique personnalisée.
liste GET  /management/accounts/accountId/webproperties/webPropertyId/customMetrics Répertorie les métriques personnalisées auxquelles l'utilisateur a accès.
patch PATCH  /management/accounts/accountId/webproperties/webPropertyId/customMetrics/customMetricId Met à jour une métrique personnalisée existante. Cette méthode est compatible avec la sémantique "patch".
mise à jour PUT  /management/accounts/accountId/webproperties/webPropertyId/customMetrics/customMetricId Met à jour une métrique personnalisée existante.

Tests

Pour en savoir plus sur la ressource de test, consultez la page relative à la représentation des ressources.

Méthode Requête HTTP Description
URI relatifs à https://www.googleapis.com/analytics/v3, sauf indication contraire
supprimer DELETE  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/experiments/experimentId Supprimez un test.
get GET  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/experiments/experimentId Affiche un test auquel l'utilisateur a accès.
insérer POST  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/experiments Créez un test.
liste GET  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/experiments Liste les tests auxquels l'utilisateur a accès.
patch PATCH  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/experiments/experimentId Mettez à jour un test existant. Cette méthode est compatible avec la sémantique "patch".
mise à jour PUT  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/experiments/experimentId Mettez à jour un test existant.

Filtres

Pour en savoir plus sur la ressource "Filters" (Filtres), consultez la page relative à la représentation des ressources.

Méthode Requête HTTP Description
URI relatifs à https://www.googleapis.com/analytics/v3, sauf indication contraire
supprimer DELETE  /management/accounts/accountId/filters/filterId supprimer un filtre ;
get GET  /management/accounts/accountId/filters/filterId Affiche un filtre auquel l'utilisateur a accès.
insérer POST  /management/accounts/accountId/filters Créez un filtre.
liste GET  /management/accounts/accountId/filters Répertorie tous les filtres d'un compte
patch PATCH  /management/accounts/accountId/filters/filterId Met à jour un filtre existant. Cette méthode est compatible avec la sémantique "patch".
mise à jour PUT  /management/accounts/accountId/filters/filterId Met à jour un filtre existant.

Buts

Pour en savoir plus sur la ressource "Objectifs", consultez la page relative aux représentations de la ressource.

Méthode Requête HTTP Description
URI relatifs à https://www.googleapis.com/analytics/v3, sauf indication contraire
get GET  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/goals/goalId Récupère un objectif auquel l'utilisateur a accès.
insérer POST  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/goals Créez un objectif.
liste GET  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/goals Liste les objectifs auxquels l'utilisateur a accès.
patch PATCH  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/goals/goalId Met à jour un objectif existant. Cette méthode est compatible avec la sémantique "patch".
mise à jour PUT  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/goals/goalId Met à jour un objectif existant.

ID client

Pour en savoir plus sur la ressource Management.clientId, consultez la page relative à la représentation des ressources.

Méthode Requête HTTP Description
URI relatifs à https://www.googleapis.com/analytics/v3, sauf indication contraire
hashClientId POST  /management/clientId:hashClientId Hachage de l'ID client donné.

Pour en savoir plus sur la ressource "Liens de filtre de profil", consultez la page Représentation des ressources.

Méthode Requête HTTP Description
URI relatifs à https://www.googleapis.com/analytics/v3, sauf indication contraire
supprimer DELETE  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/profileFilterLinks/linkId Supprimer un lien de filtre de profil.
get GET  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/profileFilterLinks/linkId Renvoie un seul lien de filtre de profil.
insérer POST  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/profileFilterLinks Créer un lien de filtre de profil.
liste GET  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/profileFilterLinks Répertorie tous les liens de filtre de profil pour un profil.
patch PATCH  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/profileFilterLinks/linkId Lien de mise à jour d'un filtre de profil existant. Cette méthode est compatible avec la sémantique "patch".
mise à jour PUT  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/profileFilterLinks/linkId Lien de mise à jour d'un filtre de profil existant.

Pour en savoir plus sur la ressource "Profile User Links", consultez la page relative à la représentation des ressources.

Méthode Requête HTTP Description
URI relatifs à https://www.googleapis.com/analytics/v3, sauf indication contraire
supprimer DELETE  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/entityUserLinks/linkId Supprime un utilisateur de la vue (profil).
insérer POST  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/entityUserLinks Ajoute un utilisateur à la vue (profil) donnée.
liste GET  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/entityUserLinks Liste les liens des utilisateurs de profils pour une vue (profil) donnée.
mise à jour PUT  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/entityUserLinks/linkId Met à jour les autorisations d'un utilisateur existant sur la vue (profil) donnée.

Audiences de remarketing

Pour en savoir plus sur la ressource Audiences de remarketing, consultez la page relative à la représentation des ressources.

Méthode Requête HTTP Description
URI relatifs à https://www.googleapis.com/analytics/v3, sauf indication contraire
supprimer DELETE  /management/accounts/accountId/webproperties/webPropertyId/remarketingAudiences/remarketingAudienceId Supprimer une audience de remarketing
get GET  /management/accounts/accountId/webproperties/webPropertyId/remarketingAudiences/remarketingAudienceId Récupère une audience de remarketing à laquelle l'utilisateur a accès.
insérer POST  /management/accounts/accountId/webproperties/webPropertyId/remarketingAudiences Crée une audience de remarketing.
liste GET  /management/accounts/accountId/webproperties/webPropertyId/remarketingAudiences Répertorie les audiences de remarketing auxquelles l'utilisateur a accès.
patch PATCH  /management/accounts/accountId/webproperties/webPropertyId/remarketingAudiences/remarketingAudienceId Met à jour une audience de remarketing existante. Cette méthode est compatible avec la sémantique "patch".
mise à jour PUT  /management/accounts/accountId/webproperties/webPropertyId/remarketingAudiences/remarketingAudienceId Met à jour une audience de remarketing existante.

Segments

Pour en savoir plus sur la ressource "Segments", consultez la page relative à la représentation des ressources.

Méthode Requête HTTP Description
URI relatifs à https://www.googleapis.com/analytics/v3, sauf indication contraire
liste GET  /management/segments Liste les segments auxquels l'utilisateur a accès.

Rapports non échantillonnés

Pour en savoir plus sur la ressource "Rapports non échantillonnés", consultez la page relative aux représentations de la ressource.

Méthode Requête HTTP Description
URI relatifs à https://www.googleapis.com/analytics/v3, sauf indication contraire
supprimer DELETE  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/unsampledReports/unsampledReportId Supprime un rapport non échantillonné.
get GET  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/unsampledReports/unsampledReportId Renvoie un seul rapport non échantillonné.
insérer POST  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/unsampledReports Créez un rapport non échantillonné.
liste GET  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/unsampledReports Liste les rapports non échantillonnés auxquels l'utilisateur a accès.

Mises en ligne

Pour en savoir plus sur la ressource "Import" (Importer), consultez la page relative à la représentation des ressources.

Méthode Requête HTTP Description
URI relatifs à https://www.googleapis.com/analytics/v3, sauf indication contraire
deleteUploadData POST  /management/accounts/accountId/webproperties/webPropertyId/customDataSources/customDataSourceId/deleteUploadData Supprimer les données associées à une importation précédente
get GET  /management/accounts/accountId/webproperties/webPropertyId/customDataSources/customDataSourceId/uploads/uploadId Répertorier les importations auxquelles l'utilisateur a accès.
liste GET  /management/accounts/accountId/webproperties/webPropertyId/customDataSources/customDataSourceId/uploads Répertorier les importations auxquelles l'utilisateur a accès.
uploadData POST
https://www.googleapis.com/upload/analytics/v3/management/accounts/accountId/webproperties/webPropertyId/customDataSources/customDataSourceId/uploads
Importez des données pour une source de données personnalisée.

Vues (profils)

Pour en savoir plus sur la ressource "Vues (profils)", consultez la page relative à la représentation des ressources.

Méthode Requête HTTP Description
URI relatifs à https://www.googleapis.com/analytics/v3, sauf indication contraire
supprimer DELETE  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId Supprime une vue (profil).
get GET  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId Récupère une vue (profil) à laquelle l'utilisateur a accès.
insérer POST  /management/accounts/accountId/webproperties/webPropertyId/profiles Créez une vue (profil).
liste GET  /management/accounts/accountId/webproperties/webPropertyId/profiles Liste les vues (profils) auxquelles l'utilisateur a accès.
patch PATCH  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId Met à jour une vue (profil) existante. Cette méthode est compatible avec la sémantique "patch".
mise à jour PUT  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId Met à jour une vue (profil) existante.

Sites Web

Pour en savoir plus sur la ressource de propriétés Web, consultez la page relative à la représentation des ressources.

Méthode Requête HTTP Description
URI relatifs à https://www.googleapis.com/analytics/v3, sauf indication contraire
get GET  /management/accounts/accountId/webproperties/webPropertyId Récupère une propriété à laquelle l'utilisateur a accès.
insérer POST  /management/accounts/accountId/webproperties crée une propriété ;
liste GET  /management/accounts/accountId/webproperties Liste les propriétés auxquelles l'utilisateur a accès.
patch PATCH  /management/accounts/accountId/webproperties/webPropertyId Met à jour une propriété existante. Cette méthode est compatible avec la sémantique "patch".
mise à jour PUT  /management/accounts/accountId/webproperties/webPropertyId Met à jour une propriété existante.

Pour en savoir plus sur la ressource de liens utilisateur de la propriété Web, consultez la page relative à la représentation des ressources.

Méthode Requête HTTP Description
URI relatifs à https://www.googleapis.com/analytics/v3, sauf indication contraire
supprimer DELETE  /management/accounts/accountId/webproperties/webPropertyId/entityUserLinks/linkId Supprime un utilisateur du site Web donné.
insérer POST  /management/accounts/accountId/webproperties/webPropertyId/entityUserLinks Ajoute un utilisateur au site Web donné.
liste GET  /management/accounts/accountId/webproperties/webPropertyId/entityUserLinks Liste les liens utilisateur de la propriété webProperty pour une propriété Web donnée.
mise à jour PUT  /management/accounts/accountId/webproperties/webPropertyId/entityUserLinks/linkId Met à jour les autorisations d'un utilisateur existant sur le site Web donné.