API Reference

API MANAGEMENT

Ceci est le guide de référence de la version 3.0 de l'API Management. 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 présentation 3.0.

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

Types de ressources

  1. Résumés du compte
  2. Associations des utilisateurs au 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 vers les utilisateurs du profil
  14. Audiences de remarketing
  15. Segments
  16. Rapports non échantillonnés
  17. Importations
  18. Vues (profils)
  19. Propriétés Web
  20. Liens des utilisateurs de la propriété Web

Récapitulatifs du compte

Pour en savoir plus sur la ressource "Résumés 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
list GET  /management/accountSummaries Répertorie les récapitulatifs de compte (arborescence légers composés de comptes/propriétés/profils) auxquels l'utilisateur a accès.

Pour en savoir plus sur la ressource "Link User Links", 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/entityUserLinks/linkId Supprime un utilisateur du compte donné.
Insérer POST  /management/accounts/accountId/entityUserLinks Ajoute un utilisateur au compte donné si celui-ci a moins de 100 comptes.
list GET  /management/accounts/accountId/entityUserLinks Répertorie les associations des utilisateurs de comptes pour un compte donné.
mettre à 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
list GET  /management/accounts Répertorie 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 de propriété Web à AdWords.
obtenir GET  /management/accounts/accountId/webproperties/webPropertyId/entityAdWordsLinks/webPropertyAdWordsLinkId Affiche une association de propriété Web AdWords à l'utilisateur.
Insérer POST  /management/accounts/accountId/webproperties/webPropertyId/entityAdWordsLinks Crée une association à "webProperty-AdWords".
list GET  /management/accounts/accountId/webproperties/webPropertyId/entityAdWordsLinks Répertorie les associations webProperty-AdWords pour une propriété Web donnée.
correctif PATCH  /management/accounts/accountId/webproperties/webPropertyId/entityAdWordsLinks/webPropertyAdWordsLinkId Met à jour une association web-AdWords existante. Cette méthode est compatible avec la sémantique "patch".
mettre à jour PUT  /management/accounts/accountId/webproperties/webPropertyId/entityAdWordsLinks/webPropertyAdWordsLinkId Met à jour une association web-AdWords existante.

Sources de données personnalisées

Pour en savoir plus sur les ressources de sources de données personnalisées, consultez la page Représentation des ressources.

Méthode Requête HTTP Description
URI relatifs à https://www.googleapis.com/analytics/v3, sauf indication contraire
list GET  /management/accounts/accountId/webproperties/webPropertyId/customDataSources Répertorie 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
obtenir 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.
list GET  /management/accounts/accountId/webproperties/webPropertyId/customDimensions Répertorie les dimensions personnalisées auxquelles l'utilisateur a accès.
correctif 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".
mettre à 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 les ressources de métriques personnalisées, consultez la page Représentation des ressources.

Méthode Requête HTTP Description
URI relatifs à https://www.googleapis.com/analytics/v3, sauf indication contraire
obtenir 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.
list GET  /management/accounts/accountId/webproperties/webPropertyId/customMetrics Répertorie les métriques personnalisées auxquelles l'utilisateur a accès.
correctif 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".
mettre à 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 "Tests", 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 Supprimer un test
obtenir GET  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/experiments/experimentId Renvoie un test auquel l'utilisateur a accès.
Insérer POST  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/experiments Créez un test.
list GET  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/experiments Répertorie les tests auxquels l'utilisateur a accès.
correctif 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".
mettre à 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", 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
obtenir GET  /management/accounts/accountId/filters/filterId Renvoie un filtre auquel l'utilisateur a accès.
Insérer POST  /management/accounts/accountId/filters Créez un filtre.
list GET  /management/accounts/accountId/filters Répertorie tous les filtres d'un compte
correctif PATCH  /management/accounts/accountId/filters/filterId Met à jour un filtre existant. Cette méthode est compatible avec la sémantique "patch".
mettre à 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
obtenir 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.
list GET  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/goals Répertorie les objectifs auxquels l'utilisateur a accès.
correctif 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".
mettre à 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 Hache l'ID client indiqué.

Pour en savoir plus sur les ressources de liens de filtrage de 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/profileFilterLinks/linkId Supprimer un lien de filtre de profil.
obtenir GET  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/profileFilterLinks/linkId Renvoie un lien de filtre de profil unique.
Insérer POST  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/profileFilterLinks Créer un lien de filtre de profil.
list GET  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/profileFilterLinks Liste tous les liens de filtre d'un profil.
correctif PATCH  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/profileFilterLinks/linkId Mettez à jour un lien de filtre de profil existant. Cette méthode est compatible avec la sémantique "patch".
mettre à jour PUT  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/profileFilterLinks/linkId Mettez à jour un lien de filtre de profil existant.

Pour en savoir plus sur la ressource "Link 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) indiquée.
Insérer POST  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/entityUserLinks Ajoute un utilisateur à la vue (profil) donnée.
list GET  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/entityUserLinks Répertorie les liens utilisateur de profil pour une vue (profil) donnée.
mettre à 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 Supprimez une audience de remarketing.
obtenir 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 ;
list GET  /management/accounts/accountId/webproperties/webPropertyId/remarketingAudiences Répertorie les audiences de remarketing auxquelles l'utilisateur a accès.
correctif 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".
mettre à 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
list GET  /management/segments Répertorie 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é.
obtenir 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é.
list GET  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/unsampledReports Répertorie les rapports non échantillonnés auxquels l'utilisateur a accès.

Mises en ligne

Pour en savoir plus sur la ressource "Uploads", 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
obtenir GET  /management/accounts/accountId/webproperties/webPropertyId/customDataSources/customDataSourceId/uploads/uploadId Répertorie les importations auxquelles l'utilisateur a accès.
list GET  /management/accounts/accountId/webproperties/webPropertyId/customDataSources/customDataSourceId/uploads Répertorie 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
Importer 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 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).
obtenir 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).
list GET  /management/accounts/accountId/webproperties/webPropertyId/profiles Répertorie les vues (profils) auxquelles l'utilisateur a accès.
correctif PATCH  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId Met à jour une vue (profil) existante. Cette méthode est compatible avec la sémantique "patch".
mettre à 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
obtenir 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é.
list GET  /management/accounts/accountId/webproperties Répertorie les propriétés auxquelles l'utilisateur a accès.
correctif PATCH  /management/accounts/accountId/webproperties/webPropertyId Met à jour une propriété existante. Cette méthode est compatible avec la sémantique "patch".
mettre à jour PUT  /management/accounts/accountId/webproperties/webPropertyId Met à jour une propriété existante.

Pour en savoir plus sur la ressource "Liens vers l'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 de la propriété Web donnée.
Insérer POST  /management/accounts/accountId/webproperties/webPropertyId/entityUserLinks Ajoute un nouvel utilisateur à la propriété Web donnée.
list GET  /management/accounts/accountId/webproperties/webPropertyId/entityUserLinks Répertorie les liens utilisateur webProperty d'une propriété Web donnée.
mettre à jour PUT  /management/accounts/accountId/webproperties/webPropertyId/entityUserLinks/linkId Met à jour les autorisations d'un utilisateur existant sur la propriété Web donnée.