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 connaître les concepts et la structure des données de configuration, consultez la 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 pour un utilisateur authentifié. Les requêtes sont toutes affichées au format REST. À la fin 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 vers les filtres 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écapitulatifs 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 Recense les récapitulatifs des comptes (arborescence légère composé de comptes/propriétés/profils) auxquels l'utilisateur a accès.

Pour en savoir plus sur la ressource "Liens utilisateur du compte", 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/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 Répertorie 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 à 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/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 "Experiments", 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 Répertorie 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 Supprimez 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 Liste 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.

Objectifs

Pour en savoir plus sur la ressource "Objectifs", 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/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éer un objectif.
liste GET  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/goals Répertorie 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 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/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 Liste tous les liens de filtre d'un profil.
patch PATCH  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/profileFilterLinks/linkId Mettre à jour un lien de 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 Mettre à jour un lien de 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 nouvel utilisateur à la vue (profil) donnée.
liste GET  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/entityUserLinks Répertorie les liens de l'utilisateur du profil 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 dans la vue donnée (profil).

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 Liste 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 à 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/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 "Importations", 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 Répertorie 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 "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 Répertorie 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 "Liens utilisateur" de Webproperty, 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 nouvel utilisateur au site Web donné.
liste GET  /management/accounts/accountId/webproperties/webPropertyId/entityUserLinks Répertorie les liens webProperty-user 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 la propriété Web donnée.