Présentation de l'API Google Analytics Admin

Résumé : Ce document fournit une présentation générale de la version 1.0 de l'API Google Analytics Admin.

Cette API fournit des fonctionnalités dans les canaux alpha et bêta. Les produits Alpha et Bêta sont susceptibles de présenter une compatibilité limitée, et les modifications apportées à ces produits peuvent ne pas être compatibles avec d'autres versions Alpha et Bêta.

Alpha : les fonctionnalités sont en phase de preview anticipée. Bien que nous nous efforcions de vous informer des modifications à venir, attendez-vous à rencontrer des modifications destructives avant la publication de l'API.

Bêta : aucune modification destructive n'est attendue dans cette version.

Pour recevoir les annonces officielles concernant l'API Google Analytics, abonnez-vous au groupe de notification de l'API Google Analytics.

Introduction

L'API Google Analytics Admin permet d'accéder de manière programmatique aux données de configuration de Google Analytics et n'est compatible qu'avec les propriétés Google Analytics. En savoir plus sur les propriétés Google Analytics

Vous pouvez utiliser l'API Google Analytics Admin pour :

• Provisionner de nouveaux comptes
• Gérer les comptes
• Gérer les paramètres de partage des données
• Lister les récapitulatifs de compte
• Rechercher des événements dans l'historique des modifications
• Gérer les propriétés
• Gérer les sous-propriétés
• Confirmez la collecte des données utilisateur.
• Envoyer des demandes de suppression d'utilisateurs pour une propriété (alpha)
• Gérer le paramètre de conservation des données d'une propriété
• Gérer les paramètres des signaux Google pour une propriété (alpha).
• Gérer les flux
• Gérer les secrets du protocole de mesure
• Gérer le schéma de valeurs de conversion SKAdNetwork (alpha)
• Générez un extrait de code d'une balise Google pour les flux de données Web (alpha).
• Gérer les événements clés
• Gérer les événements de conversion (obsolète).
• Gérer les règles de création d'événements (alpha)
• Gérer les règles de modification d'événements (alpha)
• Gérer les dimensions personnalisées
• Gérer les métriques personnalisées
• Gérer les associations entre les propriétés Google Analytics et les projets Firebase
• Gérer les associations entre les propriétés Google Analytics et les comptes Google Ads
• Gérez les propositions d'association entre une propriété Google Analytics et un annonceur Display & Video 360 (version alpha).
• Gérer les associations entre une propriété Google Analytics et un annonceur Display & Video 360 (alpha)
• Gérer les associations entre une propriété Google Analytics et Search Ads 360 (alpha).
• Gérer les associations entre une propriété Google Analytics et un projet BigQuery (alpha).
• Gérez les autorisations utilisateur pour une hiérarchie de comptes et des propriétés Google Analytics (alpha).
• Générer des rapports d'accès aux données
• Gérer les audiences (alpha)
• Gérer les ensembles de données développés (alpha)
• Gérer les annotations des données de rapport (alpha).

Méthodes disponibles

Voici les méthodes disponibles.

Gestion des comptes

• accounts.provisionAccountTicket

Cette méthode renvoie le champ accountTicketId qui doit être inclus dans l'URL des conditions d'utilisation :

https://analytics.google.com/analytics/web/?provisioningSignup=false#/termsofservice/ACCOUNT_TICKET_ID

Une fois qu'un utilisateur accède à l'URL des conditions d'utilisation et les accepte, la création d'un compte Google Analytics est terminée. Consultez l'exemple de provisionnement de compte.

Gestion des comptes

• accounts.delete
• accounts.get
• accounts.list
• accounts.patch

Gestion des paramètres de partage des données

• accounts.getDataSharingSettings

Répertorier les récapitulatifs de compte

• accountSummaries.list

Rechercher des événements de l'historique des modifications

• accounts.searchChangeHistoryEvents

Gestion des propriétés

• properties.get
• properties.patch
• properties.delete
• properties.list
• properties.create

Gestion des sous-propriétés (alpha)

• properties.provisionSubproperty

Confirmation de la collecte des données utilisateur

• properties.acknowledgeUserDataCollection

Suppression de compte utilisateur (alpha)

• properties.submitUserDeletion

Gestion des paramètres de conservation des données

• properties.getDataRetentionSettings
• properties.updateDataRetentionSettings

Gestion des paramètres des signaux Google (alpha)

• properties.getGoogleSignalsSettings
• properties.updateGoogleSignalsSettings

Gestion des flux de données

• properties.dataStreams.create
• properties.dataStreams.get
• properties.dataStreams.list
• properties.dataStreams.patch
• properties.dataStreams.delete

Gestion des secrets du protocole de mesure

• properties.dataStreams.measurementProtocolSecrets.create
• properties.dataStreams.measurementProtocolSecrets.get
• properties.dataStreams.measurementProtocolSecrets.patch
• properties.dataStreams.measurementProtocolSecrets.list
• properties.dataStreams.measurementProtocolSecrets.delete

Gestion du schéma de valeurs de conversion SKAdNetwork (alpha)

• properties.dataStreams.sKAdNetworkConversionValueSchema.get
• properties.dataStreams.sKAdNetworkConversionValueSchema.create
• properties.dataStreams.sKAdNetworkConversionValueSchema.delete
• properties.dataStreams.sKAdNetworkConversionValueSchema.update
• properties.dataStreams.sKAdNetworkConversionValueSchema.list

Gestion des événements clés

• properties.keyEvents.create
• properties.keyEvents.get
• properties.keyEvents.list
• properties.keyEvents.delete
• properties.keyEvents.patch

Gestion des événements de conversion

Obsolète : utilisez plutôt la ressource et les méthodes KeyEvent.

• properties.conversionEvents.create
• properties.conversionEvents.get
• properties.conversionEvents.list
• properties.conversionEvents.delete
• properties.conversionEvents.patch

Gestion des règles de création d'événements (alpha)

• properties.dataStreams.eventCreateRules.create
• properties.dataStreams.eventCreateRules.get
• properties.dataStreams.eventCreateRules.list
• properties.dataStreams.eventCreateRules.delete
• properties.dataStreams.eventCreateRules.patch

Gestion des règles de modification d'événements (alpha)

• properties.dataStreams.eventEditRules.create
• properties.dataStreams.eventEditRules.get
• properties.dataStreams.eventEditRules.list
• properties.dataStreams.eventEditRules.delete
• properties.dataStreams.eventEditRules.patch
• properties.dataStreams.eventEditRules.reorder

Gestion des dimensions personnalisées

• properties.customDimensions.create
• properties.customDimensions.get
• properties.customDimensions.list
• properties.customDimensions.patch
• properties.customDimensions.archive

Gestion des métriques personnalisées

• properties.customMetrics.create
• properties.customMetrics.get
• properties.customMetrics.list
• properties.customMetrics.patch
• properties.customMetrics.archive

Association d'un projet Firebase

• properties.firebaseLinks.create
• properties.firebaseLinks.list
• properties.firebaseLinks.delete

Association de compte Google Ads

• properties.googleAdsLinks.create
• properties.googleAdsLinks.list
• properties.googleAdsLinks.patch
• properties.googleAdsLinks.delete

Génération de balises Google (alpha)

• properties.webDataStreams.getGlobalSiteTag

Propositions d'association entre une propriété Google Analytics et un annonceur Display & Video 360 (alpha)

• properties.displayVideo360AdvertiserLinkProposals.create
• properties.displayVideo360AdvertiserLinkProposals.approve
• properties.displayVideo360AdvertiserLinkProposals.cancel
• properties.displayVideo360AdvertiserLinkProposals.list
• properties.displayVideo360AdvertiserLinkProposals.get
• properties.displayVideo360AdvertiserLinkProposals.delete

Association d'un compte d'annonceur Display & Video 360 (alpha)

• properties.displayVideo360AdvertiserLinks.create
• properties.displayVideo360AdvertiserLinks.get
• properties.displayVideo360AdvertiserLinks.list
• properties.displayVideo360AdvertiserLinks.delete
• properties.displayVideo360AdvertiserLinks.patch

Association de comptes Search Ads 360 (alpha)

• properties.searchAds360Links.create
• properties.searchAds360Links.delete
• properties.searchAds360Links.patch
• properties.searchAds360Links.list
• properties.searchAds360Links.get

En savoir plus sur la configuration de l'intégration entre Analytics et Search Ads 360 pour une propriété Google Analytics

Association de compte BigQuery (alpha)

• properties.bigQueryLinks.create
• properties.bigQueryLinks.delete
• properties.bigQueryLinks.get
• properties.bigQueryLinks.list
• properties.bigQueryLinks.patch

En savoir plus sur la configuration de BigQuery Export pour une propriété Google Analytics

Gestion des autorisations utilisateur (alpha)

• accounts.accessBindings.create
• accounts.accessBindings.delete
• accounts.accessBindings.patch
• accounts.accessBindings.list
• accounts.accessBindings.get
• accounts.accessBindings.batchCreate
• accounts.accessBindings.batchDelete
• accounts.accessBindings.batchUpdate
• accounts.accessBindings.batchGet
• properties.accessBindings.create
• properties.accessBindings.delete
• properties.accessBindings.patch
• properties.accessBindings.list
• properties.accessBindings.get
• properties.accessBindings.batchCreate
• properties.accessBindings.batchDelete
• properties.accessBindings.batchUpdate
• properties.accessBindings.batchGet

Rapports d'accès aux données

• properties.runAccessReport

Pour en savoir plus sur cette fonctionnalité, consultez le guide sur les rapports d'accès aux données.

Gestion des audiences (alpha)

• properties.audiences.create
• properties.audiences.archive
• properties.audiences.patch
• properties.audiences.list
• properties.audiences.get

En savoir plus sur les audiences dans Google Analytics

Gestion des ensembles de données développés (alpha)

• properties.expandedDataSets.create
• properties.expandedDataSets.delete
• properties.expandedDataSets.patch
• properties.expandedDataSets.list
• properties.expandedDataSets.get

En savoir plus sur les ensembles de données développés dans Google Analytics 360

Gestion des annotations des données de rapport (alpha)

• properties.reportingDataAnnotations.create
• properties.reportingDataAnnotations.delete
• properties.reportingDataAnnotations.get
• properties.reportingDataAnnotations.list
• properties.reportingDataAnnotations.patch

En savoir plus sur les annotations pour les ressources ReportingDataAnnotation dans Google Analytics