Changelog

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

18/06/2026 Ajout de la méthode UpdateReportingIdentitySettings

18/06/2026 Ajout du champ can_edit à PropertySummary

  • Ajout du champ can_edit à la PropertySummary ressource dans l'API Admin v1alpha et v1beta. Ce champ indique si l'utilisateur dispose d'un rôle Google Analytics qui lui permet de modifier les paramètres de la propriété.

14/04/2026 Ajout de la méthode GetUserProvidedDataSettings

20/08/2025 Ajout de la méthode GetReportingIdentitySettings

Ajout de la GetReportingIdentitySettings méthode à l'API Admin v1alpha, qui vous permet de récupérer les ReportingIdentitySettings d'une propriété.

20/08/2025 Suppression des anciennes méthodes Universal Analytics

Les anciennes méthodes Universal Analytics (UA) suivantes ont été supprimées de l'API Admin v1alpha : SetAutomatedGa4ConfigurationOptOut, FetchAutomatedGa4ConfigurationOptOut, CreateConnectedSiteTag, DeleteConnectedSiteTag, ListConnectedSiteTags et FetchConnectedGa4Property.

12/06/2025 Ajout de méthodes de gestion de la configuration de la synchronisation des sous-propriétés

Ajout des méthodes GetSubpropertySyncConfig, ListSubpropertySyncConfig, et UpdateSubpropertySyncConfig pour gérer les ressources SubpropertySyncConfig avec l'API Admin v1alpha.

16/04/2025 Ajout de méthodes de gestion des annotations des données de rapport

Ajout des CreateReportingDataAnnotation, GetReportingDataAnnotation, ListReportingDataAnnotations, UpdateReportingDataAnnotation et DeleteReportingDataAnnotation méthodes pour gérer les ReportingDataAnnotation ressources avec l'API Admin v1alpha.

Grâce aux annotations, les utilisateurs peuvent ajouter des notes directement aux rapports Google Analytics. Vous pouvez ainsi enregistrer plus facilement des événements, expliquer les changements concernant les données, ou mettre en avant des observations clés pour vous et votre équipe.

07/03/2025 Abandon du paramètre sharingWithGoogleAnySalesEnabled

Le paramètre sharingWithGoogleAnySalesEnabled de la getDataSharingSettings méthode est désormais obsolète et renverra toujours false. Le champ sera supprimé de l'API Google Analytics Admin v1beta en juin 2025.

20/01/2025 Ajout de la conservation des données utilisateur à DataRetentionSettings

Ajout du userDataRetention champ à DataRetentionSettings dans l' API Admin v1alpha et v1beta. Utilisez ce champ pour récupérer ou modifier les paramètres de conservation des données utilisateur.

09/09/2024 Formulaire d'enquête sur les rapports d'accès

La documentation de la méthode runAccessReport a été mise à jour pour inclure un lien vers le formulaire de commentaires sur les rapports d'accès Google Analytics . Vos commentaires sont importants. N'hésitez pas à nous les envoyer pour nous aider à améliorer cette API.

Ajout des méthodes CreateBigQueryLink, UpdateBigQueryLink et DeleteBigQueryLink pour gérer les ressources BigQueryLink avec l'API Admin v1alpha.

Ajout du champ dataset_location à la ressource BigQueryLink.

Ajout des modifications apportées aux associations BigQuery à l'historique des modifications sous la nouvelle BIGQUERY_LINK valeur dans ChangeHistoryResourceType.

01/08/2024 Modification importante de la méthode createSubproperty

Renommage de la méthode personnalisée createSubproperty en provisionSubproperty dans l'API Admin v1alpha pour l'aligner sur les consignes relatives aux méthodes personnalisées.

01/08/2024 Ajout de la gestion des règles de modification des événements

GetEventEditRule, CreateEventEditRule, DeleteEventEditRule, ListEventEditRules, UpdateEventEditRules, ReorderEventEditRules, méthodes ajoutées à l'API Admin v1alpha.

Une EventEditRule définit les conditions qui déclencheront la création d'un événement entièrement nouveau en fonction des critères correspondants d'un événement source. De plus, une EventEditRule peut définir des modifications des paramètres de l'événement source.

01/08/2024 Modifications diverses

Ajout de create_time à la Audience ressource.

Ajout de primary à la ressource ChannelGroup pour indiquer si le groupe de canaux est le groupe de canaux par défaut pour les rapports. Un seul groupe de canaux peut avoir la valeur primary définie sur true à un moment donné. Si vous définissez primary sur true pour un groupe de canaux, la valeur primary est automatiquement définie sur false pour le groupe de canaux principal précédent.

Ajout de gmp_organization à la ressource Account, qui contient l'URI d'une ressource d'organisation Google Marketing Platform si le compte est associé à une organisation GMP.

06/05/2024 Ajout de méthodes de gestion des événements clés

Les ressources et les méthodes pour les événements clés sont désormais disponibles.

Modifiez votre intégration d'API pour utiliser KeyEvent au lieu de ConversionEvent. ConversionEvent est obsolète.

15/12/2023 Les rapports d'accès aux données sont désormais disponibles pour toutes les propriétés Google Analytics.

Certains champs de la fonctionnalité Rapports d'accès aux données sont désormais disponibles pour toutes les propriétés Google Analytics, à la fois pour les clients Standard et Google Analytics 360.

Pour en savoir plus, consultez la documentation sur le schéma.

15/12/2023 Ajout de la dimension accessDateHour au schéma du rapport d'accès aux données.

Ajout de la dimension accessDateHour au schéma du rapport d'accès aux données. Elle contient la date et l'heure de l'utilisateur GA qui a accédé aux données de rapport GA.

05/10/2023 Les propriétés avec des modèles d'attribution au premier clic, linéaire, avec dépréciation dans le temps et basée sur la position utilisent par défaut l'attribution cross-canal basée sur les données.

À partir de la mi-octobre 2023, les modèles d'attribution au premier clic, linéaire, avec dépréciation dans le temps et basée sur la position ne pourront plus être utilisés avec la méthode UpdateAttributionSettings pour toutes les propriétés.

Si votre propriété est actuellement configurée pour utiliser l'un de ces modèles, elle sera remplacée par l'attribution multicanal basée sur les données. Vous pourrez toujours utiliser le dernier clic cross-canal ou le dernier clic Ads de préférence.

01/09/2023 Ajout de méthodes de configuration du schéma de valeurs de conversion SKAdNetwork.

GetSKAdNetworkConversionValueSchema, CreateSKAdNetworkConversionValueSchema, DeleteSKAdNetworkConversionValueSchema, UpdateSKAdNetworkConversionValueSchema, ListSKAdNetworkConversionValueSchemas méthodes ajoutées à l'API Admin v1alpha.

Cette fonctionnalité permet de gérer la configuration du schéma de valeurs de conversion SKAdNetwork pour un flux iOS.

01/09/2023 Ajout de la méthode UpdateConversionEvent.

UpdateConversionEvent méthode ajoutée à l'API Admin v1beta.

01/09/2023 Renommage du champ BigQueryLink.enterprise_export_enabled en fresh_daily_export_enabled.

Le champ enterprise_export_enabled de la ressource BigQueryLink a été renommé en fresh_daily_export_enabled.

14/07/2023 Modifications importantes des méthodes properties.updateAttributionSettings et properties.getAttributionSettings.

À partir du 24 juillet 2023, des modifications importantes seront apportées à l'API Admin v1 alpha, ce qui affectera la fonctionnalité des properties.getAttributionSettings, properties.updateAttributionSettings.

Les membres de l'ReportingAttributionModel énumération seront renommés comme suit :

Ancien nom Nouveau nom
CROSS_CHANNEL_DATA_DRIVEN PAID_AND_ORGANIC_CHANNELS_DATA_DRIVEN
CROSS_CHANNEL_LAST_CLICK PAID_AND_ORGANIC_CHANNELS_LAST_CLICK
CROSS_CHANNEL_FIRST_CLICK PAID_AND_ORGANIC_CHANNELS_FIRST_CLICK
CROSS_CHANNEL_LINEAR PAID_AND_ORGANIC_CHANNELS_LINEAR
CROSS_CHANNEL_POSITION_BASED PAID_AND_ORGANIC_CHANNELS_POSITION_BASED
CROSS_CHANNEL_TIME_DECAY PAID_AND_ORGANIC_CHANNELS_TIME_DECAY
ADS_PREFERRED_LAST_CLICK GOOGLE_PAID_CHANNELS_LAST_CLICK

Les membres de l'énumération AdsWebConversionDataExportScope seront renommés comme suit :

Ancien nom Nouveau nom
CROSS_CHANNEL PAID_AND_ORGANIC_CHANNELS
ADS_PREFERRED GOOGLE_PAID_CHANNELS

10/07/2023 Ajout du champ ads_web_conversion_data_export_scope au type AttributionSettings

Ajout du champ ads_web_conversion_data_export_scope au AttributionSettings type qui peut être modifié à l'aide de la UpdateAttributionSettings méthode.

05/06/2023 Abandon des modèles d'attribution au premier clic, linéaire, avec dépréciation dans le temps et basée sur la position.

À partir de juin 2023, la méthode UpdateAttributionSettings ne pourra plus être utilisée pour configurer des propriétés GA4 avec des modèles d'attribution au premier clic, linéaire, avec dépréciation dans le temps et basée sur la position. À partir de septembre 2023, ces modèles ne seront plus disponibles pour toutes les propriétés.

Pour en savoir plus, consultez l'annonce du produit Google Analytics.

GetAdSenseLink, CreateAdSenseLink, DeleteAdSenseLink, ListAdSenseLinks méthodes ajoutées à l'API Admin v1alpha.

Cette fonctionnalité permet de gérer les associations entre AdSense et Analytics pour une propriété GA4.

31/05/2023 Ajout d'une méthode pour rechercher une propriété GA4 associée.

La FetchConnectedGa4Property méthode ajoutée à l'API Admin v1alpha.

Cette fonctionnalité permet d'obtenir des informations sur une propriété GA4 associée à votre propriété Universal Analytics lors du processus de migration vers GA4.

31/05/2023 Ajout d'une méthode pour gérer les règles de création d'événements.

Ajout des méthodes CreateEventCreateRule, UpdateEventCreateRule, DeleteEventCreateRule, ListEventCreateRules, GetEventCreateRule à l'API Admin v1alpha.

Cette fonctionnalité permet de gérer les règles de création d'événements qui peuvent déclencher la création d'un événement entièrement nouveau en fonction des critères correspondants d'un événement source.

31/05/2023 Ajout de méthodes pour gérer les groupes de canaux personnalisés.

Ajout des méthodes GetChannelGroup, ListChannelGroups, CreateChannelGroup, UpdateChannelGroup, DeleteChannelGroup à l'API Admin v1alpha.

Cette fonctionnalité permet de gérer les groupes de canaux personnalisés pour les sources de trafic de votre site Web.

Une fois créés, les groupes de canaux personnalisés peuvent être interrogés à l'aide de l' API Google Analytics Data v1.

31/03/2023 Ajout de méthodes de gestion des paramètres des mesures améliorées.

Ajout des méthodes properties.dataStreams.updateEnhancedMeasurementSettings et properties.dataStreams.getEnhancedMeasurementSettings à l'API Admin v1alpha.

Cette fonctionnalité permet de gérer les paramètres des mesures améliorées pour un flux de données Web d'une propriété GA4.

31/03/2023 Ajout de méthodes de gestion des site tags associés.

Ajout des méthodes properties.createConnectedSiteTag, properties.deleteConnectedSiteTag et properties.listConnectedSiteTags à l'API Admin v1alpha.

Cette fonctionnalité permet de gérer les site tags associés et est utile pour transférer le trafic d'une propriété Universal Analytics vers une propriété Google Analytics 4.

31/03/2023 Ajout des méthodes runAccessReport au niveau du compte et de la propriété à l'API Admin v1beta.

Ajout des méthodes properties.runAccessReport et accounts.runAccessReport à la version v1beta de l'API Admin. Les méthodes renvoient un rapport personnalisé des enregistrements d'accès aux données.

24/02/2023 Ajout de méthodes de gestion des ensembles de données développés.

La ressource ExpandedDataSet a été ajoutée à la version v1alpha de l'API, ainsi que les opérations properties.expandedDataSets.create, properties.expandedDataSets.delete, properties.expandedDataSets.patch, properties.expandedDataSets.list et properties.expandedDataSets.get correspondantes. Cette fonctionnalité peut être utilisée pour gérer les ensembles de données développés dans Google Analytics 360.

La ressource AccessBinding a été ajoutée à la version v1alpha de l'API, ainsi que les opérations suivantes :

Cette fonctionnalité permet de gérer les autorisations utilisateur pour un compte ou une propriété GA4, et doit être utilisée à la place des liens utilisateur.

La fonctionnalité "Liens utilisateur" sera supprimée de l'API Admin v1 alpha le 01/06/2023

24/02/2023 Abandon des méthodes d'audit des autorisations utilisateur.

Les méthodes suivantes sont obsolètes et seront supprimées de l'API Admin v1 alpha le 01/06/2023 :

24/02/2023 Ajout de méthodes de gestion des audiences.

La ressource Audience a été ajoutée à la version v1alpha de l'API, ainsi que les opérations properties.audience.create, properties.audience.archive, properties.audience.patch, properties.audience.list et properties.audience.get correspondantes.

Cette fonctionnalité permet de gérer les audiences pour une propriété GA4.

15/02/2023 Ajout de méthodes de désactivation du processus de configuration GA4 automatique.

properties.setAutomatedGa4ConfigurationOptOut et properties.fetchAutomatedGa4ConfigurationOptOut opérations ont été ajoutées à la version v1alpha de l'API.

Cette fonctionnalité permet de gérer l'état de désactivation du processus de configuration GA4 automatique pour une propriété UA.

La ressource BigQueryLink a été ajoutée à la version v1alpha de l'API, ainsi que les opérations properties.bigQueryLinks.get et properties.bigQueryLinks.list correspondantes.

Cette fonctionnalité permet de récupérer des informations sur les associations entre une propriété GA4 et un projet BigQuery.

La SearchAds360Link ressource a été ajoutée à la version v1alpha de l'API, ainsi que les opérations properties.searchAds360Links.create, properties.searchAds360Links.delete, properties.searchAds360Links.patch, properties.searchAds360Links.list et properties.searchAds360Links.get correspondantes.

Cette fonctionnalité permet de gérer les associations entre une propriété GA4 et une entité Search Ads 360.

15/02/2023 Modifications importantes.

15/02/2023 Modifications diverses.

11/08/2022 Ajout de la méthode runAccessReport à l'API Admin v1alpha.

Ajout de la properties.runAccessReport méthode à la version v1alpha de l'API Admin. Elle renvoie un rapport personnalisé des enregistrements d'accès aux données. Le rapport fournit des enregistrements de chaque fois qu'un utilisateur lit des données de rapport Google Analytics. Les rapports d'accès aux données sont disponibles pour les administrateurs des propriétés Google Analytics 360.

11/07/2022 Publication de la version v1beta de l'API Admin.

La version v1beta de l'API Google Analytics Admin a été publiée.

Les canaux alpha et bêta de l'API continuent d'être compatibles avec l'API Admin. La version bêta contient un sous-ensemble des fonctionnalités disponibles dans la version alpha, qui sont considérées comme stables et ne devraient pas subir de modifications importantes à l'avenir. De nouvelles fonctionnalités seront ajoutées à la version bêta une fois qu'elles seront plus abouties.

12/10/2021 Suppression des méthodes EnhancedMeasurementSettings de l'API.

  • properties.webDataStreams.getEnhancedMeasurementSettings, properties.webDataStreams.updateEnhancedMeasurementSettings méthodes sont supprimées de l'API, mais les paramètres des mesures améliorées seront à nouveau modifiables via l'API prochainement.
  • Le champ directRoles de la ressource UserLink n'est plus compatible avec le rôle predefinedRoles/manage-users. Le nouveau rôle predefinedRoles/admin doit être utilisé à la place. Il est équivalent à la combinaison des anciens rôles predefinedRoles/edit et predefinedRoles/manage-users. Cette modification affecte le comportement des méthodes accounts.userLinks et properties.userLinks , et est conforme aux modifications apportées à la gestion des accès et des restrictions de données dans Google Analytics.

05/06/2021 Ajout de fonctionnalités.

Les fonctionnalités suivantes sont ajoutées à l'API :

  • accounts.searchChangeHistoryEvents méthode a été ajoutée à l'API. Cette méthode recherche toutes les modifications apportées à un compte ou à ses enfants en fonction de l'ensemble de filtres spécifié. Les causes courantes sont les mises à jour effectuées dans l'interface utilisateur de Google Analytics, les modifications apportées par l'assistance client ou les modifications automatiques du système Google Analytics.
  • Ajout de méthodes de gestion des secrets du protocole de mesure sous properties.dataStreams.measurementProtocolSecrets:
    • create : crée un secret de protocole de mesure.
    • delete : supprime le secret de protocole de mesure cible.
    • get : recherche un seul secret de protocole de mesure.
    • list : renvoie les secrets de protocole de mesure enfants sous la propriété parent spécifiée.
    • patch : met à jour un secret de protocole de mesure.
  • Ajout de méthodes de gestion des événements de conversion sous properties.conversionEvents:
    • create : crée un événement de conversion avec les attributs spécifiés.
    • delete : supprime un événement de conversion dans une propriété.
    • get : récupère un seul événement de conversion.
    • list : renvoie une liste d'événements de conversion dans la propriété parent spécifiée.
  • Ajout de méthodes de gestion des dimensions personnalisées sous properties.customDimensions:
    • archive : archive une dimension personnalisée dans une propriété.
    • create : crée une dimension personnalisée.
    • get : recherche une seule dimension personnalisée.
    • list : liste les dimensions personnalisées dans une propriété.
    • patch : met à jour une dimension personnalisée dans une propriété.
  • Ajout de méthodes de gestion des métriques personnalisées sous properties.customMetrics:
    • archive : archive une métrique personnalisée dans une propriété.
    • create : crée une métrique personnalisée.
    • get : recherche une seule métrique personnalisée.
    • list : liste les métriques personnalisées dans une propriété.
    • patch : met à jour une métrique personnalisée dans une propriété.
  • Ajout des méthodes properties.getGoogleSignalsSettings, properties.updateGoogleSignalsSettings qui permettent de contrôler le paramètre des signaux Google pour une propriété Google Analytics 4.
  • delete_time, expire_time champs de résultat uniquement ajoutés au Property type.

05/06/2021 Modifications importantes.

Les modifications importantes suivantes ont été apportées :

  • Suppression des méthodes properties.iosAppDataStreams.create et properties.androidAppDataStreams.create de l'API. Veuillez utiliser Firebase pour créer des flux d'application dans une propriété Google Analytics 4.
  • properties.delete méthode renvoie désormais les données de la propriété supprimée en tant que type Property au lieu de renvoyer une réponse vide.
  • time_zone champ du type Property est désormais obligatoire.
  • Suppression du champ deleted du Property type.
  • email_address champ du UserLink type est désormais immuable.
  • name champ du UserLink type est désormais en sortie uniquement.

28/01/2021 Modifications importantes.

Modifications importantes : - update_mask champ est obligatoire pour toutes les opérations de mise à jour.

  • Renommage du champ country_code en region_code dans Account.

  • Renommage du champ url_query_parameter en uri_query_parameter dans EnhancedMeasurementSettings.

  • Suppression du champ parent de GoogleAdsLink.

20/10/2020 Ajout de la compatibilité avec les récapitulatifs de compte.

Ajout de la compatibilité avec la méthode des récapitulatifs de compte.

13/10/2020 Renommage des propriétés Application + Web en Google Analytics 4 (GA4).

15/08/2020 Renommage de l'API de gestion Application + Web en API Admin.

L'API de gestion Application + Web Google Analytics a été renommée API Google Analytics Admin. Par conséquent, le point de terminaison de l'API est désormais analyticsadmin.googleapis.com. Le code existant écrit par rapport à la version précédente de l'URL du point de terminaison de l'API et des bibliothèques clientes doit être mis à jour en conséquence.