Présentation de l'API Admin de Google Analytics

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

Avertissement :Cette version préliminaire de l'API est susceptible d'être modifiée. Nous allons essayer de vous informer de changements à venir, mais attendez-vous à rencontrer des modifications destructives avant la publication des API.

Les versions alpha et bêta de l'API sont toujours prises en charge. La version bêta contient un sous-ensemble de fonctionnalités disponibles en version alpha qui sont considérées comme stables et qui ne devraient pas changer de manière significative à l'avenir. De nouvelles fonctionnalités seront ajoutées à la version bêta une fois qu'elles seront matures.

Pour obtenir les annonces officielles de l'API Google Analytics, veuillez vous abonner au groupe de notifications de l'API Google Analytics. Pour signaler un problème lié à l'API, utilisez le formulaire de commentaires sur les testeurs de l'API Google Analytics.

Introduction

L'API Admin de Google Analytics permet un accès programmatique aux données de configuration Google Analytics 4 (GA4) et 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
• Listez les récapitulatifs de comptes.
• Rechercher des événements d'historique des modifications :
• Gérer les propriétés :
• Confirmez 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é (version alpha)
• Gérer les flux
• Gérer les secrets du protocole de mesure
• Générer un extrait de 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érer 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 pour l'association entre une propriété GA4 et un annonceur Display & Video 360 (version alpha)
• Gérer les associations entre une propriété GA4 et un annonceur Display & Video 360 (version alpha)
• Gérer les associations entre une propriété GA4 et Search Ads 360 (version alpha)
• Gérer les associations entre une propriété GA4 et un projet BigQuery (version alpha)
• Gérez les autorisations des utilisateurs pour une hiérarchie de compte et les propriétés GA4 (version alpha).
• Générer des rapports sur l'accès aux données (version alpha)
• Gérer les audiences (version alpha)
• Gérer les ensembles de données étendus (version alpha)
• Gérer les paramètres de désactivation de la configuration GA4 automatisée (version 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. Lorsqu'un utilisateur visite l'URL des conditions d'utilisation et accepte les conditions d'utilisation, 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

Lister les récapitulatifs de comptes

• accountSummaries.list

Rechercher des événements d'historique des modifications

• accounts.searchChangeHistoryEvents

Gestion immobilière

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

Acceptation de la collecte de 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 (version 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 via le 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 événements de conversion

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

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 balises Google (version alpha)

• properties.webDataStreams.getGlobalSiteTag

Propositions d'association entre une propriété GA4 et un annonceur Display & Video 360 (version 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 (version alpha)

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

Association de comptes Search Ads 360 (version 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 d'Analytics Search Ads 360 pour une propriété GA4

Association de comptes BigQuery (version alpha)

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

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

Gestion des autorisations des utilisateurs (version 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 (version alpha)

• properties.runAccessReport

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

Gestion des audiences (version 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 (version 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 étendus dans Google Analytics 360

Désactivation automatique du processus de configuration GA4 (version 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.