Pour recevoir les annonces officielles sur les API Google Analytics, abonnez-vous au groupe de notification sur les API Google Analytics.
2025-01-20 Ajout de la conservation des données utilisateur à DataRetentionSettings
Ajout du champ userDataRetention
à DataRetentionSettings
dans les versions alpha et bêta de l'API Admin v1. Utilisez ce champ pour récupérer ou modifier les paramètres de conservation des données utilisateur.
2024-09-09 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 Commentaires sur les rapports sur l'accès Google Analytics. Vos commentaires sont importants. N'hésitez pas à nous faire part de vos réflexions sur cette API pour nous aider à l'améliorer.
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 associations 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 afin de se conformer aux consignes concernant les méthodes personnalisées.
01/08/2024 Gestion des règles de modification des événements ajoutée
GetEventEditRule
,
CreateEventEditRule
,
DeleteEventEditRule
,
ListEventEditRules
,
UpdateEventEditRules
,
ReorderEventEditRules
,
méthodes ajoutées à l'API Admin v1alpha.
Un 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, un EventEditRule
peut définir des modifications des paramètres à partir de l'événement source.
01/08/2024 Divers changements
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
à la fois. Définir primary
sur true
pour un groupe de canaux définit automatiquement primary
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, que vous soyez client Google Analytics 360 ou Standard.
Pour en savoir plus, consultez la documentation du schéma.
15/12/2023 : la dimension accessDateHour
a été ajoutée au schéma du rapport sur l'accès aux données.
Dimension accessDateHour
ajoutée au 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 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 seront définies par défaut sur l'attribution multicanal par défaut.
À 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 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 à la place.
01/09/2023 Ajout de méthodes de configuration du schéma de valeur de conversion SKAdNetwork.
Ajout des méthodes GetSKAdNetworkConversionValueSchema
, CreateSKAdNetworkConversionValueSchema
, DeleteSKAdNetworkConversionValueSchema
, UpdateSKAdNetworkConversionValueSchema
et ListSKAdNetworkConversionValueSchemas
à 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
.
Ajout de la méthode UpdateConversionEvent
à l'API Admin v1beta.
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 non rétrocompatibles seront apportées à l'API Admin v1alpha, ce qui aura un impact sur le fonctionnement 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
.
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, 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 du produit Google Analytics.
31/05/2023 : ajout de méthodes de gestion des liens AdSense.
Ajout des méthodes GetAdSenseLink
, CreateAdSenseLink
, DeleteAdSenseLink
et ListAdSenseLinks
à l'API Admin v1alpha.
Cette fonctionnalité permet de gérer les associations 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 d'administration 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.
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 é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
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
ajoutées à l'API Admin v1alpha.
Cette fonctionnalité permet de gérer les paramètres de mesure améliorée 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 à l'API Admin v1alpha.
Cette fonctionnalité permet de gérer les balises de site associées 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é à 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é 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.
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 associations d'utilisateurs pour la gestion des autorisations des utilisateurs.
La ressource AccessBinding
a été ajoutée à la version v1alpha de l'API, ainsi que 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 associations utilisateur.
La fonctionnalité User Links (Associations d'utilisateurs) 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 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 d'une propriété GA4.
15/02/2023 Ajout de méthodes de désactivation du processus de configuration GA4 automatique.
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 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 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 destructives.
Valeurs
LESS_THAN_OR_EQUAL
,GREATER_THAN_OR_EQUAL
supprimées de l'énumérationNumericFilter.Operation
.Valeur
PARTIAL_REGEXP
supprimée de l'énumérationStringFilter.MatchType
.
15/02/2023 Modifications diverses.
- Champ
tokensPerProjectPerHour
ajouté au typeAccessQuota
. - Valeurs
EXPANDED_DATA_SET
etCHANNEL_GROUP
ajoutées à l'énumérationChangeHistoryResourceType
. - Valeurs
searchAds360Link
,expandedDataSet
etbigqueryLink
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é sur les enregistrements d'accès aux données. Le rapport enregistre 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 : version bêta de l'API Admin v1 publiée.
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 pris en charge pour l'API Admin. Le canal bêta contient un sous-ensemble des fonctionnalités disponibles en 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 finalisées.
12/10/2021 : suppression des méthodes EnhancedMeasurementSettings de l'API.
- Les méthodes
properties.webDataStreams.getEnhancedMeasurementSettings
etproperties.webDataStreams.updateEnhancedMeasurementSettings
sont supprimées de l'API, mais les paramètres de mesure améliorée seront bientôt à nouveau modifiables via l'API. - Le champ
directRoles
de la ressourceUserLink
n'est plus compatible avec le rôlepredefinedRoles/manage-users
. Le nouveau rôlepredefinedRoles/admin
, qui équivaut à la combinaison des anciens rôlespredefinedRoles/edit
etpredefinedRoles/manage-users
, doit être utilisé à la place. Ce changement affecte le comportement des méthodesaccounts.userLinks
etproperties.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 : fonctionnalités ajoutées.
Les fonctionnalités suivantes sont ajoutées à l'API:
- La méthode
accounts.searchChangeHistoryEvents
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 apportées à 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.webDataStreams.measurementProtocolSecrets
: - 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.getGoogleSignalsSettings
etproperties.updateGoogleSignalsSettings
qui permettent de contrôler le paramètre Signaux Google pour une propriété Google Analytics 4. delete_time
,expire_time
n'affichent que les champs ajoutés au typeProperty
.
05/06/2021 : modifications destructives.
Les modifications non rétrocompatibles suivantes ont été introduites:
- Les méthodes
properties.iosAppDataStreams.create
etproperties.androidAppDataStreams.create
ont é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.delete
renvoie désormais les données de propriété supprimées au formatProperty
au lieu de renvoyer une réponse vide. - Le champ
time_zone
du typeProperty
est désormais obligatoire. - Champ
deleted
supprimé du typeProperty
. - Le champ
email_address
du typeUserLink
est désormais immuable. - Le champ
name
du typeUserLink
est désormais en sortie uniquement.
28/01/2021 Prise en charge de la pagination pour l'opération ListFirebaseLinks
.
28/01/2021 Modifications destructives.
Modifications non compatibles :
- Le champ update_mask
est obligatoire pour toutes les opérations de mise à jour.
Le champ
country_code
a été renomméregion_code
dansAccount
.Le champ
url_query_parameter
a été renomméuri_query_parameter
dansEnhancedMeasurementSettings
.Champ
parent
supprimé deGoogleAdsLink
.
20/10/2020 : prise en charge des récapitulatifs de compte.
Ajout de la compatibilité avec la méthode Récapitulatifs du compte.
13/10/2020 : les propriétés Application + Web sont rebaptisées Google Analytics 4 (GA4).
15/08/2020 L'application de gestion et l'API Web ont été rebaptisées API Admin.
L'API Google Analytics Management App + Web a été rebaptisé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 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.