Présentation de l'API Admin de Google Analytics

Résumé: ce document offre une vue d'ensemble de la version 1.0 de l'API Admin de Google Analytics.

Avertissement :Il s'agit d'une version preview anticipée de l'API qui est susceptible d'être modifiée. Nous nous efforcerons de vous informer des changements à venir, mais attendez-vous à rencontrer des modifications destructives avant le lancement public des API.

Les versions alpha et bêta de l'API sont toujours prises en charge. La version bêta contient un sous-ensemble des fonctionnalités disponibles dans la version alpha qui sont considérées comme stables et qui ne devraient pas subir de changement important à l'avenir. De nouvelles fonctionnalités seront ajoutées en version bêta lorsqu'elles seront matures.

Pour recevoir les annonces officielles de l'API Google Analytics, veuillez vous abonner au groupe de notification de l'API Google Analytics. Pour signaler un problème avec l'API, utilisez le formulaire de commentaires du testeur d'API Google Analytics.

Introduction

L'API Admin de Google Analytics permet un accès programmatique aux données de configuration Google Analytics 4 (GA4). Elle n'est compatible qu'avec les propriétés GA4. En savoir plus sur les propriétés GA4

Vous pouvez utiliser l'API Admin de Google Analytics pour:

• Provisionnez de nouveaux comptes.
• Gérer les comptes
• Gérer les paramètres de partage des données
• Répertoriez les récapitulatifs de compte.
• Événements de l'historique des modifications des recherches :
• Gérer les propriétés.
• Acceptez la collecte des données utilisateur.
• Gérer les paramètres de conservation des données pour une propriété
• Gérer le paramètre des signaux Google pour une propriété (version alpha).
• Gérez vos diffusions.
• Gérer les codes secrets du protocole de mesure
• Gérer le schéma de valeur de conversion SKAdNetwork (alpha)
• Générez un extrait de code de la balise Google pour les flux de données Web (version alpha).
• Gérer les événements de conversion
• Gérer les dimensions personnalisées
• Gérer les métriques personnalisées
• Gérez les associations entre les propriétés GA4 et les projets Firebase.
• Gérer les associations entre les propriétés GA4 et les comptes Google Ads
• Gérer les propositions d'association entre une propriété GA4 et un annonceur Display & Video 360 (alpha).
• Gérer les associations entre une propriété GA4 et un annonceur Display & Video 360 (alpha).
• Gérer les associations entre une propriété GA4 et Search Ads 360 (alpha)
• Gérer les associations entre une propriété GA4 et un projet BigQuery (alpha).
• Gérer les autorisations des utilisateurs pour une hiérarchie de comptes et des propriétés GA4 (alpha).
• Générer des rapports sur l'accès aux données (alpha)
• Gérer les audiences (alpha)
• Gérer les ensembles de données développés (alpha)
• Gérer les paramètres de désactivation du processus de configuration automatique de GA4 (alpha).

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 (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

Obtenir la liste des 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

Acceptation de la collecte des données utilisateur

• properties.acknowledgeUserDataCollection

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 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 des schémas de valeur 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 de conversion

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

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 compte Google Ads

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

Génération de balise Google (alpha)

• properties.webDataStreams.getGlobalSiteTag

Propositions d'association entre une propriété GA4 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 d'un compte 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 d'Analytics Search Ads 360 pour une propriété GA4.

Association de compte BigQuery (alpha)

• properties.bigQueryLinks.get
• properties.bigQueryLinks.list

Découvrez comment configurer BigQuery Export pour une propriété GA4.

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 sur l'accès aux données (alpha)

• 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 étendus (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

Désactivation du processus de configuration automatique de GA4 (alpha)

• properties.setAutomatedGa4ConfigurationOptOut
• properties.fetchAutomatedGa4ConfigurationOptOut

Découvrez comment gérer l'état de désactivation du processus de configuration GA4 automatique pour une propriété UA.