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
- Ajout de la méthode
UpdateReportingIdentitySettingsà l'API Admin v1alpha, qui vous permet de mettre à jourReportingIdentitySettingspour une propriété.
18/06/2026 : ajout du champ can_edit à PropertySummary
- Ajout du champ
can_edità la ressourcePropertySummarydans les versions v1alpha et v1beta de l'API Admin. Ce champ indique si l'utilisateur dispose d'un rôle Google Analytics qui l'autorise à modifier les paramètres de la propriété.
14/04/2026 : ajout de la méthode GetUserProvidedDataSettings
Ajout de la méthode
GetUserProvidedDataSettingsà l'API Admin v1alpha, qui vous permet de récupérer leUserProvidedDataSettingsd'une propriété.Ajout de la ressource
UserProvidedDataSettingsà la version v1alpha de l'API Admin, qui inclut les champsuserProvidedDataCollectionEnabledetautomaticallyDetectedDataCollectionEnabledde collecte des données fournies par l'utilisateur.
20-08-2025 : ajout de la méthode GetReportingIdentitySettings
Ajout de la méthode GetReportingIdentitySettings à l'API Admin v1alpha, qui vous permet de récupérer le 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 de données de rapport
Ajout des méthodes CreateReportingDataAnnotation, GetReportingDataAnnotation, ListReportingDataAnnotations, UpdateReportingDataAnnotation et DeleteReportingDataAnnotation pour gérer les ressources ReportingDataAnnotation 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 méthode getDataSharingSettings est désormais obsolète et renverra toujours false. Le champ sera supprimé de la version v1beta de l'API Google Analytics Admin en juin 2025.
20/01/2025 : ajout de la conservation des données utilisateur à DataRetentionSettings
Ajout du champ userDataRetention à DataRetentionSettings dans les versions v1alpha et v1beta de l'API Admin. 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.
01/08/2024 : ajout de la gestion des associations BigQuery
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 liens BigQuery à l'historique des modifications sous la nouvelle valeur BIGQUERY_LINK dans ChangeHistoryResourceType.
01/08/2024 : Modification destructive de la méthode createSubproperty
La méthode personnalisée createSubproperty a été renommée provisionSubproperty dans l'API Admin v1alpha pour s'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 tout nouvel événement en fonction des critères de correspondance d'un événement source. En outre, un EventEditRule peut définir des modifications des paramètres de l'événement source.
01/08/2024 : modifications diverses
Ajout de create_time à la ressource Audience.
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 primary défini sur true à un moment donné. Si vous définissez primary sur true pour un groupe de canaux, primary est automatiquement défini 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 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, 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 sur l'accès aux données.
La dimension accessDateHour a été ajoutée au schéma du rapport sur l'accès aux données. Il contient la date et l'heure auxquelles l'utilisateur GA a accédé aux données de rapport GA.
05/10/2023 : Les propriétés utilisant les modèles d'attribution au premier clic, linéaire, avec dépréciation dans le temps et basée sur la position passent par défaut à l'attribution basée sur les données 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 seront plus disponibles 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 basée sur les données cross-canal. Vous pourrez toujours utiliser les modèles "Dernier clic cross-canal" ou "Dernier clic Ads de préférence".
01/09/2023 : ajout des méthodes de configuration du schéma de valeurs de conversion SKAdNetwork.
Méthodes GetSKAdNetworkConversionValueSchema, CreateSKAdNetworkConversionValueSchema, DeleteSKAdNetworkConversionValueSchema, UpdateSKAdNetworkConversionValueSchema et ListSKAdNetworkConversionValueSchemas 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.
Méthode UpdateConversionEvent ajoutée à la version v1beta de l'API Admin.
01/09/2023 : 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 |
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 type AttributionSettings, qui peut être modifié à l'aide de la méthode 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.
À partir de juin 2023, la méthode UpdateAttributionSettings ne pourra plus être utilisée pour configurer les propriétés GA4 avec les 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 aucune propriété.
Pour en savoir plus, consultez l'annonce produit Google Analytics.
31/05/2023 : ajout de méthodes de gestion des associations AdSense.
GetAdSenseLink,
CreateAdSenseLink,
DeleteAdSenseLink,
ListAdSenseLinks
méthodes ajoutées à l'API Admin v1alpha.
Cette fonctionnalité permet de gérer les associations d'AdSense à Analytics pour une propriété GA4.
31/05/2023 : ajout d'une méthode permettant de rechercher une propriété GA4 associée.
La méthode FetchConnectedGa4Property 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 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.
Les méthodes CreateEventCreateRule, UpdateEventCreateRule, DeleteEventCreateRule, ListEventCreateRules et GetEventCreateRule ont été ajoutées à 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 tout nouvel événement en fonction des critères 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 à l'API Admin v1alpha.
Cette fonctionnalité permet de gérer des 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 version 1 de l'API Google Analytics Data.
31/03/2023 : ajout de méthodes de gestion des paramètres des mesures améliorées.
Les méthodes properties.dataStreams.updateEnhancedMeasurementSettings et properties.dataStreams.getEnhancedMeasurementSettings ont été ajoutées à l'API Admin v1alpha.
Cette fonctionnalité permet de gérer les paramètres de mesures améliorées pour un flux de données Web d'une propriété GA4.
31/03/2023 : ajout des méthodes de gestion des site tags associés.
Les méthodes properties.createConnectedSiteTag, properties.deleteConnectedSiteTag et properties.listConnectedSiteTags ont été ajoutées à l'API Admin v1alpha.
Cette fonctionnalité permet de gérer les balises de site associées et de 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.
Les méthodes properties.runAccessReport et accounts.runAccessReport ont été 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 des 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, ainsi que les opérations suivantes :
accounts.accessBindings.createaccounts.accessBindings.deleteaccounts.accessBindings.patchaccounts.accessBindings.listaccounts.accessBindings.getaccounts.accessBindings.batchCreateaccounts.accessBindings.batchDeleteaccounts.accessBindings.batchUpdateaccounts.accessBindings.batchGetproperties.accessBindings.createproperties.accessBindings.deleteproperties.accessBindings.patchproperties.accessBindings.listproperties.accessBindings.getproperties.accessBindings.batchCreateproperties.accessBindings.batchDeleteproperties.accessBindings.batchUpdateproperties.accessBindings.batchGet
Cette fonctionnalité permet de gérer les autorisations utilisateur pour un compte ou une propriété GA4. Elle doit être utilisée à la place de User Links.
La fonctionnalité User Links sera supprimée de l'API Admin v1 alpha le 1er juin 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 1er juin 2023 :
24/02/2023 : ajout des 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 d'une propriété GA4.
15/02/2023 : ajout de méthodes de désactivation du processus de configuration automatique de GA4.
properties.setAutomatedGa4ConfigurationOptOut,
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.
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 liaisons 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 destructives.
Valeurs
LESS_THAN_OR_EQUAL,GREATER_THAN_OR_EQUALsupprimées de l'énumérationNumericFilter.Operation.Valeur
PARTIAL_REGEXPsupprimée de l'énumérationStringFilter.MatchType.
15/02/2023 : modifications diverses.
- Ajout du champ
tokensPerProjectPerHourau typeAccessQuota. - Ajout des valeurs
EXPANDED_DATA_SETetCHANNEL_GROUPà l'énumérationChangeHistoryResourceType. searchAds360Link,expandedDataSet,bigqueryLink: valeurs ajoutées àChangeHistoryResource.
11/08/2022 : ajout de la méthode runAccessReport à l'API Admin v1alpha.
La méthode properties.runAccessReport a été ajoutée à la version v1alpha de l'API Admin. Il 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 sur l'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 est désormais disponible.
Les versions alpha et bêta de l'API Admin continuent d'être 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 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 prêtes.
12/10/2021 : suppression des méthodes EnhancedMeasurementSettings de l'API.
- Les méthodes
properties.webDataStreams.getEnhancedMeasurementSettingsetproperties.webDataStreams.updateEnhancedMeasurementSettingsont été supprimées de l'API, mais les paramètres de mesure améliorée pourront bientôt être modifiés à nouveau via l'API. - Le champ
directRolesde la ressourceUserLinkn'accepte plus le rôlepredefinedRoles/manage-users. Le nouveau rôlepredefinedRoles/admindoit être utilisé à la place. Il équivaut à la combinaison des anciens rôlespredefinedRoles/editetpredefinedRoles/manage-users. Cette modification affecte le comportement des méthodesaccounts.userLinksetproperties.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 :
- La méthode
accounts.searchChangeHistoryEventsa é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 les plus courantes sont les mises à jour effectuées dans l'interface utilisateur de Google Analytics, les modifications apportées par le service client ou les modifications automatiques du système Google Analytics. - Méthodes de gestion des secrets du protocole de mesure ajoutées sous
properties.dataStreams.measurementProtocolSecrets:createCrée un secret de protocole de mesure.deleteSupprime le secret du protocole de mesure cible.getRecherche d'un seul code secret du protocole de mesure.listRenvoie les secrets Measurement Protocol enfants sous la propriété parente spécifiée.patchMet à jour un secret du protocole de mesure.
- Méthodes de gestion des événements de conversion ajoutées sous
properties.conversionEvents: - Méthodes de gestion des dimensions personnalisées ajoutées sous
properties.customDimensions: - Méthodes de gestion des métriques personnalisées ajoutées sous
properties.customMetrics: - Ajout des méthodes
properties.getGoogleSignalsSettingsetproperties.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 typeProperty.
05/06/2021 : modifications destructives.
Les modifications destructives suivantes ont été introduites :
- Les méthodes
properties.iosAppDataStreams.createetproperties.androidAppDataStreams.createont été supprimées de l'API. Veuillez utiliser Firebase pour créer des flux d'application dans une propriété Google Analytics 4. - La méthode
properties.deleterenvoie désormais les données de la propriété supprimée en tant que typePropertyau lieu de renvoyer une réponse vide. - Le champ
time_zonedu typePropertyest désormais obligatoire. - Le champ
deleteda été supprimé du typeProperty. - Le champ
email_addressdu typeUserLinkest désormais immuable. - Le champ
namedu typeUserLinkest désormais en sortie uniquement.
28/01/2021 : ajout de la compatibilité avec la pagination pour l'opération ListFirebaseLinks.
28/01/2021 : modifications destructives.
Modifications destructives :
- Le champ update_mask est obligatoire pour toutes les opérations Update.
Le champ
country_codea été renomméregion_codedansAccount.Le champ
url_query_parametera été renomméuri_query_parameterdansEnhancedMeasurementSettings.Le champ
parenta été supprimé deGoogleAdsLink.
20-10-2020 : ajout de la compatibilité avec les récapitulatifs de compte.
Ajout de la compatibilité avec la méthode account summaries.
13/10/2020 : les propriétés Application + Web sont renommées "Google Analytics 4 (GA4)".
15/08/2020 : l'API Management App + Web a été renommée "API Admin".
L'API Google Analytics Management App + Web a été renommée API Google Analytics Admin. Par conséquent, le point de terminaison de l'API est devenu analyticsadmin.googleapis.com. Le code existant écrit pour 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.