Cette page a été traduite par l'API Cloud Translation.

Journal des modifications

Pour consulter les annonces officielles relatives à l'API Google Analytics, inscrivez-vous à Groupe de notifications de l'API Google Analytics.

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

La documentation runAccessReport a été mise à jour pour inclure un lien vers Commentaires sur les rapports sur l'accès à Google Analytics . Vos commentaires nous sont très utiles, c'est pourquoi nous vous invitons à nous donner votre avis à ce sujet. pour nous aider à l'améliorer.

01/08/2024 Ajout de la gestion des associations BigQuery

Ajout de CreateBigQueryLink, UpdateBigQueryLink et DeleteBigQueryLink des méthodes de gestion BigQueryLink ressources avec la version 1alpha de l'API Admin.

Ajout du champ dataset_location à la ressource BigQueryLink.

Ajout des modifications de l'association à BigQuery dans l'historique des modifications dans le nouveau BIGQUERY_LINK valeur de ChangeHistoryResourceType

01/08/2024 Modification destructive de la méthode `createSubproperty`

Remplacement du nom de la méthode personnalisée createSubproperty par provisionSubproperty de la version v1alpha de l'API Admin pour s'aligner sur la méthode personnalisée consignes.

01/08/2024 Ajout de la gestion des règles de modification d'événement

GetEventEditRule CreateEventEditRule, DeleteEventEditRule, ListEventEditRules, UpdateEventEditRules, ReorderEventEditRules, ajoutées à la version v1alpha de l'API Admin.

Un élément EventEditRule définit les conditions qui déclencheront la création d'un un événement entièrement nouveau basé sur les critères correspondants d'un événement source. De plus, un EventEditRule peut définir des modifications des paramètres à partir de la source. .

01/08/2024 Modifications diverses

Ajout de create_time à Ressource Audience.

Ajout de primary à Ressource ChannelGroup pour indiquer si le groupe de canaux est le groupe de canaux par défaut pour les rapports. Un seul Le primary peut être défini sur true à tout moment dans le groupe de canaux. Paramètre "primary" sur "true" pour un groupe de canaux définit automatiquement "primary" sur "false" pour le groupe de canaux principal précédent.

gmp_organization a été ajouté au Account ressource qui contient l'URI d'une organisation Google Marketing Platform. si le compte est associé à une entreprise GMP.

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

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

Modifier l'intégration de l'API pour l'utiliser KeyEvent au lieu de ConversionEvent Abandon de ConversionEvent.

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, et Google Analytics 360.

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

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

La dimension accessDateHour a été ajoutée à la Schéma du rapport sur l'accès aux données : Il contient la date et l’heure de l'utilisateur GA qui a accédé aux données des rapports GA.

05/10/2023 Les propriétés avec les 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 le modèle DDA cross-canal.

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

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

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

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

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

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

UpdateConversionEvent ajoutée à l'API Admin v1beta.

2023-09-01 Champ `BigQueryLink.enterprise_export_enabled` renommé `fresh_daily_export_enabled`.

Le nom du champ enterprise_export_enabled de la ressource BigQueryLink devient fresh_daily_export_enabled

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

À partir du 24 juillet 2023, des modifications destructives seront apportées à la version 1 de l'API Admin alpha, ce qui aura une incidence sur le fonctionnement properties.getAttributionSettings, properties.updateAttributionSettings méthodes.

Membres de la ReportingAttributionModel sera renommée 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`

Membres de la AdsWebConversionDataExportScope sera renommée 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 le type AttributionSettings, qui peut être modifié à l'aide du UpdateAttributionSettings .

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.

Depuis juin 2023, UpdateAttributionSettings ne peut pas être utilisée pour configurer des propriétés GA4 premier clic, linéaire, avec dépréciation dans le temps et basé sur la position modèles d'attribution. À partir de septembre 2023, ces modèles seront indisponible pour tous les établissements.

Consultez l'annonce concernant le produit Google Analytics. pour en savoir plus.

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

GetAdSenseLink CreateAdSenseLink, DeleteAdSenseLink, ListAdSenseLinks ajoutées à la version v1alpha de l'API Admin.

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.

FetchConnectedGa4Property ajoutée à la version v1alpha de l'API Admin

Cette fonctionnalité permet d'obtenir des informations La propriété GA4 a associé votre propriété Universal Analytics. pendant le 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.

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

Cette fonctionnalité permet de gérer Règles de création d'événement ce qui peut déclencher la création d'un tout nouvel événement d'un événement source.

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

Ajout de GetChannelGroup, ListChannelGroups, CreateChannelGroup, UpdateChannelGroup, DeleteChannelGroup à l'API Admin v1alpha.

Cette fonctionnalité permet de gérer 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 la méthode API Data Google Analytics v1 :

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

Les méthodes properties.dataStreams.updateEnhancedMeasurementSettings et properties.dataStreams.getEnhancedMeasurementSettings ont été 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 de site tag associé.

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.

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

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

ExpandedDataSet ressource a été ajoutée à la version v1alpha de l'API, avec le properties.expandedDataSets.create correspondant, properties.expandedDataSets.delete, properties.expandedDataSets.patch, properties.expandedDataSets.list, properties.expandedDataSets.get opérations. 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 vont remplacer les liens utilisateur pour la gestion des autorisations utilisateur.

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

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

Suppression des liens utilisateur depuis la version alpha de l'API Admin 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 la version 1 de l'API Admin alpha le 01/06/2023:

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

Audience ressource a été ajoutée à la version v1alpha de l'API, avec le properties.audience.create correspondant, properties.audience.archive, properties.audience.patch, properties.audience.list, properties.audience.get opérations.

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

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

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

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

BigQueryLink a été ajoutée à la version v1alpha de l'API, avec la les properties.bigQueryLinks.get correspondants, properties.bigQueryLinks.list opérations.

Cette fonctionnalité permet de récupérer Associations entre une propriété GA4 et un projet BigQuery.

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

SearchAds360Link ressource a été ajoutée à la version v1alpha de l'API, avec le properties.searchAds360Links.create correspondant, properties.searchAds360Links.delete, properties.searchAds360Links.patch, properties.searchAds360Links.list, properties.searchAds360Links.get opérations.

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

15/02/2023 Modifications importantes.

Valeurs LESS_THAN_OR_EQUAL et GREATER_THAN_OR_EQUAL supprimées de NumericFilter.Operation enum.
Valeur PARTIAL_REGEXP supprimée de StringFilter.MatchType enum.

15/02/2023 Modifications diverses.

Champ tokensPerProjectPerHour ajouté à AccessQuota de mots clés.
Valeurs EXPANDED_DATA_SET et CHANNEL_GROUP ajoutées à ChangeHistoryResourceType enum.
Les valeurs searchAds360Link, expandedDataSet et bigqueryLink ont été ajoutées à ChangeHistoryResource.

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

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

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

La version v1beta de l'API Google Analytics Admin.

Les versions alpha et bêta de l'API sont toujours disponibles pour les administrateurs. API. La version bêta contient un sous-ensemble des fonctionnalités disponibles en version alpha : sont considérés comme stables et ne devraient pas subir de changement significatif au niveau à venir. De nouvelles fonctionnalités seront ajoutées à la version bêta une fois qu'elles seront finalisées.

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

properties.webDataStreams.getEnhancedMeasurementSettings, Les méthodes properties.webDataStreams.updateEnhancedMeasurementSettings sont supprimée de l'API, mais les mesures améliorées les paramètres pourront bientôt de nouveau être modifiés via l'API.
Le champ directRoles de UserLink la ressource n'accepte plus le rôle predefinedRoles/manage-users. Utilisez plutôt le nouveau rôle predefinedRoles/admin, qui est équivaut à la combinaison des anciens predefinedRoles/edit et predefinedRoles/manage-users rôles. Ce changement a une incidence sur le comportement accounts.userLinks properties.userLinks et s'aligne sur la procédure de gestion des accès et des restrictions de données les modifications apportées dans Google Analytics.

05/06/2021 Ajout de fonctionnalités.

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

accounts.searchChangeHistoryEvents a été ajoutée à l'API. Cette méthode recherche toutes les modifications apportées à une ou ses enfants en fonction de l'ensemble de filtres spécifié. Causes courantes il s'agit des mises à jour effectuées dans l'UI Google Analytics, 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 secret de protocole de mesure.
- delete Supprime le secret du protocole de mesure cible.
- get Recherchez un seul secret de protocole de mesure.
- list Renvoie les secrets du protocole de mesure enfant sous la propriété parent spécifiée.
- patch Met à jour un secret de 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 Affiche 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 dans une propriété.
- create Crée une dimension personnalisée.
- get Recherchez une seule dimension personnalisée.
- list Liste les dimensions personnalisées d'une propriété.
- patch Met à jour une dimension personnalisée dans une propriété.
Des méthodes de gestion des métriques personnalisées properties.customMetrics:
- archive Archive une métrique personnalisée dans une propriété
- create génère une métrique personnalisée.
- get Recherchez 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 de properties.getGoogleSignalsSettings, properties.updateGoogleSignalsSettings permettant de contrôler les signaux Google pour une propriété Google Analytics 4.
delete_time expire_time champs de sortie uniquement ajoutés à Property de mots clés.

05/06/2021 Modifications majeures.

Les modifications destructives suivantes ont été introduites:

properties.iosAppDataStreams.create, properties.androidAppDataStreams.create ont été supprimées de l'API. Veuillez utiliser Firebase pour créer l'application dans une propriété Google Analytics 4.
properties.delete renvoie désormais les données de propriété supprimées sous la forme Property. au lieu de renvoyer une réponse vide.
time_zone du Property est maintenant obligatoire.
Champ deleted supprimé de Property de mots clés.
email_address du UserLink est désormais immuable.
name du UserLink est maintenant uniquement de sortie.

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

28/01/2021 Modifications importantes.

Modifications majeures: - 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.
Champ parent supprimé de GoogleAdsLink.

20/10/2020 : ajout de la prise en charge des récapitulatifs de compte.

Ajout de la compatibilité avec la méthode récapitulatif de compte.

13/10/2020 Les propriétés Application + Web ont été renommées Google Analytics 4 (GA4).

15/08/2020 L'API Management Application + Web a été renommée API Admin.

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