Journal des modifications

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

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

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

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

15/12/2023 Dimension accessDateHour ajoutée au schéma du rapport sur l'accès aux données.

La dimension accessDateHour ajoutée au schéma du rapport sur l'accès aux données. Il indique la date et l'heure auxquelles l'utilisateur GA a accédé aux données de rapports GA.

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

À 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 passera à l'attribution cross-canal basée sur les données. Vous aurez toujours la possibilité d'utiliser le dernier clic cross-canal ou le dernier clic Ads de préférence à la place.

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

GetSKAdNetworkConversionValueSchema, CreateSKAdNetworkConversionValueSchema, DeleteSKAdNetworkConversionValueSchema, UpdateSKAdNetworkConversionValueSchema et ListSKAdNetworkConversionValueSchemas ajoutées à la version 1alpha de l'API Admin.

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

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

Ajout de la méthode UpdateConversionEvent à la version 1beta de l'API Admin.

2023-09-01 Le champ BigQueryLink.enterprise_export_enabled a été renommé fresh_daily_export_enabled.

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

14/07/2023 Modifications destructives apportées aux méthodes properties.updateAttributionSettings et properties.getAttributionSettings.

À partir du 24 juillet 2023, des modifications destructives seront apportées à la version alpha de l'API Admin v1. Elles affecteront les fonctionnalités des méthodes properties.getAttributionSettings et properties.updateAttributionSettings.

Les membres de l'énumération ReportingAttributionModel 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

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

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

5/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, vous ne pourrez plus utiliser la méthode UpdateAttributionSettings 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 sur le produit Google Analytics.

31/05/2023 Ajout de méthodes de gestion des associations AdSense.

Ajout de méthodes GetAdSenseLink, CreateAdSenseLink, DeleteAdSenseLink et ListAdSenseLinks à la version 1alpha de l'API Admin.

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

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

La méthode FetchConnectedGa4Property ajoutée à la version 1alpha de l'API Admin

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.

Les méthodes CreateEventCreateRule, UpdateEventCreateRule, DeleteEventCreateRule, ListEventCreateRules et GetEventCreateRule ajoutées à la version 1alpha de l'API Admin.

Cette fonctionnalité permet de gérer les règles de création d'événement qui peuvent déclencher la création d'un tout nouvel événement en fonction des critères de correspondance 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 et DeleteChannelGroup à la version 1alpha de l'API Admin.

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.

Méthodes properties.dataStreams.updateEnhancedMeasurementSettings et properties.dataStreams.getEnhancedMeasurementSettings ajoutées à la version 1alpha de l'API Admin.

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.

Les méthodes properties.createConnectedSiteTag, properties.deleteConnectedSiteTag et properties.listConnectedSiteTags ont été ajoutées à la version 1alpha de l'API Admin.

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 de méthodes runAccessReport au niveau du compte et de la propriété à la version 1beta de l'API Admin.

Les méthodes properties.runAccessReport et accounts.runAccessReport ajoutées à 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é permet de gérer les ensembles de données développés dans Google Analytics 360.

24/02/2023 Les liaisons d'accès remplacent les liens utilisateur pour la gestion des autorisations utilisateur.

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

• 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

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

La fonctionnalité Liens utilisateur sera supprimée de la version alpha de l'API Admin le 01/06/2023.

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

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

• accounts.userLinks.audit
• properties.userLinks.audit

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 automatique de GA4.

Les opérations properties.setAutomatedGa4ConfigurationOptOut et properties.fetchAutomatedGa4ConfigurationOptOut 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 automatisé pour une propriété UA.

15/02/2023 Ajout de méthodes de gestion des associations BigQuery.

La ressource BigQueryLink a été ajoutée à la version v1alpha de l'API, avec 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.

15/02/2023 Ajout de méthodes de gestion des associations Search Ads 360.

La ressource SearchAds360Link 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 majeures.

• Les valeurs LESS_THAN_OR_EQUAL et GREATER_THAN_OR_EQUAL ont été supprimées de l'énumération NumericFilter.Operation.

• La valeur PARTIAL_REGEXP a été supprimée de l'énumération StringFilter.MatchType.

15/02/2023 : modifications diverses.

• Champ tokensPerProjectPerHour ajouté au type AccessQuota.
• Valeurs EXPANDED_DATA_SET et CHANNEL_GROUP ajoutées à l'énumération ChangeHistoryResourceType.
• Valeurs searchAds360Link, expandedDataSet et bigqueryLink ajoutées à ChangeHistoryResource.

2022-08-11 Ajout de la méthode runAccessReport à la version 1alpha de l'API Admin.

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

Publication de la version 1beta de l'API Admin du 11/07/2022.

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

Les versions alpha et bêta de l'API sont toujours compatibles avec l'API Admin. La version bêta contient un sous-ensemble des fonctionnalités disponibles en 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 à la version bêta lorsqu'elles seront matures.

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

• Les méthodes properties.webDataStreams.getEnhancedMeasurementSettings et properties.webDataStreams.updateEnhancedMeasurementSettings sont supprimées de l'API, mais les paramètres des mesures améliorées pourront bientôt être modifiés via l'API.
• Le champ directRoles de la ressource UserLink n'accepte plus le rôle predefinedRoles/manage-users. Il est préférable d'utiliser le nouveau rôle predefinedRoles/admin, qui équivaut à la combinaison des anciens rôles predefinedRoles/edit et predefinedRoles/manage-users. Ce changement 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 introduites dans Google Analytics.

05/06/2021 Fonctionnalités ajoutées.

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

• Ajout de la méthode accounts.searchChangeHistoryEvents à 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é. Cela peut être dû à des mises à jour dans l'interface utilisateur de Google Analytics, à des changements effectués par le service client ou à des modifications automatiques du système Google Analytics.
• Méthodes de gestion des secrets du protocole de mesure ajoutées sous properties.webDataStreams.measurementProtocolSecrets :
  • create Crée un code secret du protocole de mesure.
  • delete Supprime le code secret du protocole de mesure cible.
  • get Recherche d'un seul secret de protocole de mesure.
  • list Renvoie les secrets du protocole de mesure enfant sous la propriété parente spécifiée.
  • patch Met à jour un code secret du protocole de mesure.
• Méthodes de gestion des événements de conversion ajoutées 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érez un seul événement de conversion.
  • list Renvoie la liste des événements de conversion dans la propriété parente spécifiée.
• Méthodes de gestion des dimensions personnalisées ajoutées sous properties.customDimensions :
  • archive Archive une dimension personnalisée sur une propriété.
  • create Crée une dimension personnalisée.
  • get Recherchez une seule dimension personnalisée.
  • list Répertorie les dimensions personnalisées pour une propriété.
  • patch Met à jour une dimension personnalisée dans une propriété.
• Méthodes de gestion des métriques personnalisées ajoutées sous properties.customMetrics :
  • archive Archive une métrique personnalisée sur une propriété.
  • create génère une métrique personnalisée.
  • get Recherche pour une seule métrique personnalisée.
  • list Répertorie les métriques personnalisées d'une propriété.
  • patch Met à jour une métrique personnalisée sur une propriété.
• Ajout des méthodes properties.getGoogleSignalsSettings, properties.updateGoogleSignalsSettings, qui permettent de contrôler le paramètre Signaux Google pour une propriété Google Analytics 4.
• delete_time, expire_time champs de sortie uniquement ajoutés au type Property.

05/06/2021 Modifications majeures.

Les modifications destructives suivantes ont été introduites:

• 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.
• La méthode properties.delete 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.
• Le champ time_zone du type Property est désormais obligatoire.
• Champ deleted supprimé du type Property.
• Le champ email_address du type UserLink est désormais immuable.
• Le champ name du type UserLink est désormais uniquement en sortie.

Ajout de la prise en charge de la pagination pour l'opération ListFirebaseLinks (28/01/2021).

28/01/2021 Modifications majeures.

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

• Le champ country_code a été renommé region_code dans Account.

• Le champ url_query_parameter a été renommé uri_query_parameter dans EnhancedMeasurementSettings.

• parent champ supprimé 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 : Les propriétés Application + Web ont été renommées Google Analytics 4 (GA4).

2020-08-15 L'API Management Application + Web s'appelle désormais "API Admin".

L'API Application + Web de gestion de Google Analytics a été renommée API Google Analytics Admin. Par conséquent, le point de terminaison de l'API a été remplacé par analyticsadmin.googleapis.com. Le code existant écrit avec 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.