Offizielle Ankündigungen zur Google Analytics API finden Sie in der Google Analytics API Notify Group (in englischer Sprache).
15.12.2023 Berichte zum Datenzugriff sind jetzt für alle Google Analytics-Properties verfügbar.
Bestimmte Felder der Funktion Berichte zum Datenzugriff sind jetzt für alle Google Analytics-Properties verfügbar – sowohl für Standard- als auch für Google Analytics 360-Kunden.
Weitere Informationen finden Sie in der Schemadokumentation.
15.12.2023 Die Dimension accessDateHour
wurde dem Schema für den Datenzugriffsbericht hinzugefügt.
Die Dimension accessDateHour
wurde dem Schema für den Datenzugriff hinzugefügt. Sie enthält die Datums- und Uhrzeitangabe des Nutzers, der auf Analytics-Berichtsdaten zugegriffen hat.
05.10.2023: Für Properties mit den Attributionsmodellen „Erster Klick“, „Linear“, „Zeitverlauf“ und „Positionsbasiert“ wird standardmäßig die kanalübergreifende datengetriebene Attribution verwendet.
Ab Mitte Oktober 2023 können die Attributionsmodelle Erster Klick, Linear, Zeitverlauf und Positionsbasiert nicht mehr mit der Methode UpdateAttributionSettings verwendet werden.
Wenn Ihre Property derzeit für die Verwendung eines dieser Modelle konfiguriert ist, wird sie in channelübergreifende datengetriebene Attribution geändert. Sie haben aber weiterhin die Möglichkeit, stattdessen „Letzter Klick (channelübergreifend)“ oder „Letzter Google Ads-Klick bevorzugt“ zu verwenden.
01.09.2023 Neue Konfigurationsmethoden für das SKAdNetwork-Conversion-Wert-Schema hinzugefügt.
Methoden GetSKAdNetworkConversionValueSchema
, CreateSKAdNetworkConversionValueSchema
, DeleteSKAdNetworkConversionValueSchema
, UpdateSKAdNetworkConversionValueSchema
und ListSKAdNetworkConversionValueSchemas
wurden der Admin API v1alpha hinzugefügt.
Mit dieser Funktion können Sie die Konfiguration des SKAdNetwork-Conversion-Wert-Schemas für einen iOS-Stream verwalten.
01.09.2023 Die UpdateConversionEvent
-Methode wurde hinzugefügt.
Die Methode UpdateConversionEvent
wurde der Admin API v1beta hinzugefügt.
01.09.2023 Das Feld BigQueryLink.enterprise_export_enabled
wurde in fresh_daily_export_enabled
umbenannt.
Das Feld enterprise_export_enabled
der Ressource BigQueryLink
wurde in fresh_daily_export_enabled
umbenannt.
14.07.2023 Wichtige Änderungen an properties.updateAttributionSettings
, properties.getAttributionSettings
-Methoden.
Ab dem 24. Juli 2023 werden funktionsgefährdende Änderungen an der Alphaversion der Admin API Version 1 vorgenommen, die sich auf die Funktionalität der Methoden properties.getAttributionSettings und properties.updateAttributionSettings auswirken.
Mitglieder der Aufzählung ReportingAttributionModel
werden so umbenannt:
Alter Name | Neuer Name |
---|---|
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 |
Mitglieder der Aufzählung AdsWebConversionDataExportScope
werden so umbenannt:
Alter Name | Neuer Name |
---|---|
CROSS_CHANNEL |
PAID_AND_ORGANIC_CHANNELS |
ADS_PREFERRED |
GOOGLE_PAID_CHANNELS |
10.07.2023 Das Feld ads_web_conversion_data_export_scope
wurde dem Typ AttributionSettings
hinzugefügt.
Dem Typ AttributionSettings
wurde das Feld ads_web_conversion_data_export_scope
hinzugefügt, das mit der Methode UpdateAttributionSettings
geändert werden kann.
05.06.2023: Die Attributionsmodelle „Erster Klick“, „Linear“, „Zeitverlauf“ und „Positionsbasiert“ werden eingestellt.
Ab Juni 2023 können mit der Methode UpdateAttributionSettings GA4-Properties nicht mehr mit den Attributionsmodellen Erster Klick, Linear, Zeitverlauf und Positionsbasiert konfiguriert werden. Ab September 2023 sind diese Modelle nicht mehr für alle Properties verfügbar.
Weitere Informationen finden Sie in der Google Analytics-Produktankündigung.
31.05.2023: Methoden zum Verwalten von AdSense-Verknüpfungen wurden hinzugefügt.
Methoden GetAdSenseLink
, CreateAdSenseLink
, DeleteAdSenseLink
und ListAdSenseLinks
wurden der Admin API v1alpha hinzugefügt.
Mit dieser Funktion können AdSense- und Analytics-Verknüpfungen für eine GA4-Property verwaltet werden.
31.05.2023 Eine Methode zum Suchen einer verbundenen GA4-Property wurde hinzugefügt.
Die Methode FetchConnectedGa4Property
wurde der Admin API v1alpha hinzugefügt
Mit dieser Funktion können Sie Informationen zu einer GA4-Property abrufen, die während der GA4-Migration mit Ihrer Universal Analytics-Property verknüpft wurde.
31.05.2023 Eine Methode zum Verwalten von Regeln zur Ereigniserstellung wurde hinzugefügt.
Die Methoden CreateEventCreateRule
, UpdateEventCreateRule
, DeleteEventCreateRule
, ListEventCreateRules
und GetEventCreateRule
, die der Admin API v1alpha hinzugefügt wurden.
Mit dieser Funktion lassen sich Regeln zur Ereigniserstellung verwalten, die die Erstellung eines komplett neuen Ereignisses auf der Grundlage von Kriterien eines Quellereignisses auslösen können.
31.05.2023 Methoden zur Verwaltung benutzerdefinierter Channelgruppen hinzugefügt.
Der Admin API v1alpha wurden die Methoden GetChannelGroup
, ListChannelGroups
, CreateChannelGroup
, UpdateChannelGroup
und DeleteChannelGroup
hinzugefügt.
Mit dieser Funktion können benutzerdefinierte Channelgruppen für die Besucherquellen Ihrer Website verwaltet werden.
Nach der Erstellung können benutzerdefinierte Channelgruppen mit der Google Analytics Data API Version 1 abgefragt werden.
31.03.2023 Neue Verwaltungsmethoden für Einstellungen für optimierte Analysen hinzugefügt.
Die Methoden properties.dataStreams.updateEnhancedMeasurementSettings
und properties.dataStreams.getEnhancedMeasurementSettings
, die der Admin API v1alpha hinzugefügt wurden.
Mit dieser Funktion können Sie die Einstellungen für optimierte Analysen für einen Web-Datenstream einer GA4-Property verwalten.
31.03.2023 Methoden zur Verwaltung von verbundenen Website-Tags wurden hinzugefügt.
Die Methoden properties.createConnectedSiteTag
, properties.deleteConnectedSiteTag
und properties.listConnectedSiteTags
wurden der Admin API v1alpha hinzugefügt.
Mit dieser Funktion können Sie verbundene Website-Tags verwalten und Traffic von einer Universal Analytics-Property an eine Google Analytics 4-Property weiterleiten.
31.03.2023 runAccessReport
-Methoden auf Konto- und Property-Ebene wurden der Admin API v1beta hinzugefügt.
Die Methoden properties.runAccessReport
und accounts.runAccessReport
, die der v1beta-Version der Admin API hinzugefügt wurden. Über die Methoden wird ein benutzerdefinierter Bericht zu Datenzugriffen zurückgegeben.
24.02.2023: Verwaltungsmethoden für erweiterte Datensätze hinzugefügt.
Die Ressource ExpandedDataSet
wurde der v1alpha-Version der API zusammen mit den entsprechenden Vorgängen properties.expandedDataSets.create
, properties.expandedDataSets.delete
, properties.expandedDataSets.patch
, properties.expandedDataSets.get
hinzugefügt.properties.expandedDataSets.list
Damit lassen sich erweiterte Datensätze in Google Analytics 360 verwalten.
24.02.2023 Zugriffsbindungen ersetzen Nutzerlinks bei der Verwaltung von Nutzerberechtigungen.
Die Ressource AccessBinding
wurde zusammen mit den folgenden Vorgängen der Version v1alpha der API hinzugefügt:
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
Mit dieser Funktion können Sie Nutzerberechtigungen für ein GA4-Konto oder eine GA4-Property verwalten. Sie sollte anstelle von Nutzerlinks verwendet werden.
Die Funktion Nutzerlinks wird am 01.06.2023 aus der Alphaversion der Admin API Version 1 entfernt
24.02.2023 Einstellung der Prüfmethoden für Nutzerberechtigungen.
Die folgenden Methoden wurden eingestellt und am 01.06.2023 aus der Admin API v1 (Alpha) entfernt:
24.02.2023 Methoden zur Zielgruppenverwaltung wurden hinzugefügt.
Die Ressource Audience
wurde der v1alpha-Version der API zusammen mit den entsprechenden Vorgängen properties.audience.create
, properties.audience.archive
, properties.audience.patch
, properties.audience.get
hinzugefügt.properties.audience.list
Mit dieser Funktion können Sie Zielgruppen für eine GA4-Property verwalten.
15.02.2023: Neue Methoden zum automatischen Deaktivieren von GA4-Einrichtungen hinzugefügt.
properties.setAutomatedGa4ConfigurationOptOut
, properties.fetchAutomatedGa4ConfigurationOptOut
-Vorgänge wurden der v1alpha-Version der API hinzugefügt.
Mit dieser Funktion können Sie den Deaktivierungsstatus für die automatisierte GA4-Einrichtung für eine UA-Property verwalten.
15.02.2023 Hinzufügen von Verwaltungsmethoden für BigQuery-Verknüpfungen.
Die Ressource BigQueryLink
wurde der Version v1alpha der API zusammen mit den entsprechenden Vorgängen properties.bigQueryLinks.get
und properties.bigQueryLinks.list
hinzugefügt.
Mit dieser Funktion können Informationen zu Verknüpfungen zwischen einer GA4-Property und einem BigQuery-Projekt abgerufen werden.
15.02.2023 Neue Methoden zum Verwalten von Search Ads 360-Verknüpfungen hinzugefügt.
Die Ressource SearchAds360Link
wurde der v1alpha-Version der API zusammen mit den entsprechenden Vorgängen properties.searchAds360Links.create
, properties.searchAds360Links.delete
, properties.searchAds360Links.patch
, properties.searchAds360Links.get
hinzugefügt.properties.searchAds360Links.list
Mit dieser Funktion können Verknüpfungen zwischen einer GA4-Property und einer Search Ads 360-Entität verwaltet werden.
15.02.2023 Wichtige Änderungen.
Die Werte
LESS_THAN_OR_EQUAL
undGREATER_THAN_OR_EQUAL
wurden aus der AufzählungNumericFilter.Operation
entfernt.Der Wert
PARTIAL_REGEXP
wurde aus der AufzählungStringFilter.MatchType
entfernt.
15.02.2023 Verschiedene Änderungen
- Das Feld
tokensPerProjectPerHour
wurde dem TypAccessQuota
hinzugefügt. EXPANDED_DATA_SET
,CHANNEL_GROUP
-Werte wurden zurChangeHistoryResourceType
-Enum hinzugefügt.searchAds360Link
-,expandedDataSet
- undbigqueryLink
-Werte zuChangeHistoryResource
hinzugefügt.
11.08.2022 Die Methode runAccessReport
wurde der Admin API v1alpha hinzugefügt.
Die Methode properties.runAccessReport
wurde der Version v1alpha der Admin API hinzugefügt. Sie erhalten einen angepassten Bericht zu Datenzugriffen. Der Bericht enthält Daten zu jedem Abrufen
von Google Analytics-Berichtsdaten durch einen Nutzer. Berichte zum Datenzugriff stehen Administratoren von Google Analytics 360-Properties zur Verfügung.
11.07.2022: Betaversion der Admin API v1 veröffentlicht.
Version 1 der Betaversion der Google Analytics Admin API wurde veröffentlicht.
Sowohl Alpha- als auch Betakanäle der API werden weiterhin für die Admin API unterstützt. Die Betaversion enthält einen Teil der in der Alphaversion verfügbaren Funktionen, die als stabil gelten und in Zukunft voraussichtlich keine wesentlichen Änderungen unterliegen. Neue Funktionen werden der Betaversion hinzugefügt, sobald sie ausgereift sind.
12.10.2021: EnhancedMeasurementSettings-Methoden wurden aus der API entfernt.
properties.webDataStreams.getEnhancedMeasurementSettings
,properties.webDataStreams.updateEnhancedMeasurementSettings
-Methoden werden aus der API entfernt. Die Einstellungen für optimierte Analysen lassen sich aber bald wieder über die API ändern.- Das Feld
directRoles
der RessourceUserLink
unterstützt die RollepredefinedRoles/manage-users
nicht mehr. Verwenden Sie stattdessen die neue RollepredefinedRoles/admin
, die der Kombination der alten RollenpredefinedRoles/edit
undpredefinedRoles/manage-users
entspricht. Diese Änderung wirkt sich auf das Verhalten der Methodenaccounts.userLinks
undproperties.userLinks
aus und entspricht den Änderungen zur Verwaltung von Zugriffs- und Dateneinschränkungen, die in Google Analytics eingeführt wurden.
05.06.2021 Funktionen hinzugefügt.
Die folgenden Funktionen werden der API hinzugefügt:
- Der API wurde die Methode
accounts.searchChangeHistoryEvents
hinzugefügt. Bei dieser Methode werden alle Änderungen an einem Konto oder dessen untergeordneten Konten mit den angegebenen Filtern durchsucht. Häufige Ursachen sind Aktualisierungen in der Google Analytics-Benutzeroberfläche, Änderungen durch den Kundensupport oder automatische Google Analytics-Systemänderungen. - Unter
properties.webDataStreams.measurementProtocolSecrets
hinzugefügte Verwaltungsmethoden für Measurement Protocol-Secrets:create
Erstellt ein Measurement Protocol-Secret.delete
Löscht das Ziel-Measurement Protocol-Secret.get
Suchen Sie nach einem einzelnen Measurement Protocol-Secret.list
Gibt die Secrets für das Measurement Protocol unter der angegebenen übergeordneten Property zurück.patch
Aktualisiert ein Measurement Protocol-Secret.
- Unter
properties.conversionEvents
wurden Verwaltungsmethoden für Conversion-Ereignisse hinzugefügt: - Unter
properties.customDimensions
wurden Verwaltungsmethoden für benutzerdefinierte Dimensionen hinzugefügt:archive
Damit wird eine benutzerdefinierte Dimension für eine Property archiviert.create
Erstellt eine benutzerdefinierte Dimension.get
Suche nach einer einzelnen benutzerdefinierten Dimension.list
Listet benutzerdefinierte Dimensionen für eine Property aufpatch
Benutzerdefinierte Dimension für eine Property wird aktualisiert.
- Unter
properties.customMetrics
wurden benutzerdefinierte Verwaltungsmethoden für Messwerte hinzugefügt:archive
Archiviert einen benutzerdefinierten Messwert für eine Property.create
stellt einen benutzerdefinierten Messwert dar.get
Suche nach einem einzelnen benutzerdefinierten Messwert.list
Listet benutzerdefinierte Messwerte für eine Property aufpatch
Aktualisiert einen benutzerdefinierten Messwert für eine Property.
- Es wurden Methoden vom Typ
properties.getGoogleSignalsSettings
,properties.updateGoogleSignalsSettings
, hinzugefügt, mit denen die Einstellung Google-Signale für eine Google Analytics 4-Property gesteuert werden kann. delete_time
,expire_time
reine Ausgabefelder, die dem TypProperty
hinzugefügt wurden.
05.06.2021 Wichtige Änderungen.
Die folgenden funktionsgefährdenden Änderungen wurden eingeführt:
- Die Methoden
properties.iosAppDataStreams.create
undproperties.androidAppDataStreams.create
wurden aus der API entfernt. Verwenden Sie Firebase, um Anwendungsstreams in einer Google Analytics 4-Property zu erstellen. - Die Methode
properties.delete
gibt jetzt die gelöschten Property-Daten als TypProperty
zurück, anstatt eine leere Antwort zurückzugeben. - Das Feld
time_zone
des TypsProperty
ist jetzt erforderlich. - Das Feld
deleted
wurde aus dem TypProperty
entfernt. - Das Feld
email_address
des TypsUserLink
ist jetzt unveränderlich. - Das Feld
name
des TypsUserLink
wird jetzt nur noch ausgegeben.
28.01.2021: Paginierungsunterstützung für ListFirebaseLinks
-Vorgang hinzugefügt.
28.01.2021 Wichtige Änderungen.
Nicht abwärtskompatible Änderungen:
– Das Feld update_mask
ist für alle Aktualisierungsvorgänge erforderlich.
Das Feld
country_code
wurde inAccount
inregion_code
umbenannt.Das Feld
url_query_parameter
wurde inEnhancedMeasurementSettings
inuri_query_parameter
umbenannt.Das Feld „
parent
“ wurde aus „GoogleAdsLink
“ entfernt.
20.10.2020 Unterstützung für Kontozusammenfassungen hinzugefügt.
Die Methode Kontozusammenfassung wird jetzt unterstützt.
13.10.2020: App + Web-Properties wurden in Google Analytics 4 (GA4) umbenannt.
15.08.2020: Management App + Web API wurde in Admin API umbenannt.
Die Google Analytics Management App + Web API wurde in Google Analytics Admin API umbenannt. Daher wurde der API-Endpunkt in analyticsadmin.googleapis.com geändert. Vorhandener Code, der für die vorherige Version der API-Endpunkt-URL und die Clientbibliotheken geschrieben ist, muss entsprechend aktualisiert werden.