Présentation de l'API Admin de Google Analytics

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

Cette API propose des fonctionnalités dans les canaux alpha et bêta. Les produits alpha et bêta peuvent bénéficier d'une assistance 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 prévisualisation. Bien que nous nous efforcions de vous informer des modifications à venir, attendez-vous à rencontrer des modifications importantes avant la publication publique de l'API.

Bêta: aucune modification importante n'est attendue dans ce canal.

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 offre un accès 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 Admin de Google Analytics pour :

• provisionner de nouveaux comptes ;
• gérer des comptes ;
• gérer les paramètres de partage des données ;
• répertorier les résumés de compte ;
• rechercher des événements dans l'historique des modifications ;
• gérer des propriétés ;
• gérer des sous-propriétés ;
• confirmer la collecte des données utilisateur ;
• gérer le paramètre de conservation des données pour une propriété ;
• gérer le paramètre des signaux Google pour une propriété (alpha) ;
• gérer des flux ;
• gérer les codes secrets du protocole de mesure ;
• Gérer le schéma de valeurs de conversion SKAdNetwork (alpha).
• Générer un extrait de code de 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érer les propositions d'association entre une propriété Google Analytics et un annonceur Display &Video 360 (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érer les autorisations des utilisateurs 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ées (alpha) ;
• gérer les paramètres de désactivation du processus de configuration automatisée de Google Analytics (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 gestion des comptes.

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ésumés de compte

• accountSummaries.list

Rechercher des événements dans 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

Gestion du paramètre de conservation des données

• properties.getDataRetentionSettings
• properties.updateDataRetentionSettings

Gestion du paramètre 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 codes 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 de projets Firebase

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

Association de comptes 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 de comptes 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

Découvrez comment configurer l'intégration entre Analytics et Search Ads 360 pour une propriété Google Analytics.

Association de comptes BigQuery (alpha)

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

Découvrez comment configurer l'exportation BigQuery pour une propriété Google Analytics.

Gestion des autorisations des utilisateurs (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ées (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ées dans Google Analytics 360.

Désactivation du processus de configuration automatisée de Google Analytics (alpha)

• properties.setAutomatedGa4ConfigurationOptOut
• properties.fetchAutomatedGa4ConfigurationOptOut

Découvrez comment gérer l'état de désactivation du processus de configuration automatisée de Google Analytics pour une propriété UA.