Änderungsprotokoll

Wenn Sie offizielle Google Analytics API-Ankündigungen erhalten möchten, abonnieren Sie bitte die Google Analytics API Notify Group.

20.08.2025: Die Methode GetReportingIdentitySettings wurde hinzugefügt.

Der Admin API v1alpha wurde die Methode GetReportingIdentitySettings hinzugefügt, mit der Sie die ReportingIdentitySettings für eine Property abrufen können.

20.08.2025: Alte Universal Analytics-Methoden entfernt

Die folgenden alten Universal Analytics-Methoden (UA) wurden aus der Admin API v1alpha entfernt: SetAutomatedGa4ConfigurationOptOut, FetchAutomatedGa4ConfigurationOptOut, CreateConnectedSiteTag, DeleteConnectedSiteTag, ListConnectedSiteTags und FetchConnectedGa4Property.

12.06.2025: Methoden zur Verwaltung der Synchronisierung von untergeordneten Properties hinzugefügt

Die Methoden GetSubpropertySyncConfig, ListSubpropertySyncConfig und UpdateSubpropertySyncConfig zum Verwalten von SubpropertySyncConfig-Ressourcen mit der Admin API v1alpha wurden hinzugefügt.

16.04.2025: Methoden zur Verwaltung von Anmerkungen für Berichtsdaten hinzugefügt

Die Methoden CreateReportingDataAnnotation, GetReportingDataAnnotation, ListReportingDataAnnotations, UpdateReportingDataAnnotation und DeleteReportingDataAnnotation zum Verwalten von ReportingDataAnnotation-Ressourcen mit der Admin API v1alpha wurden hinzugefügt.

Mit Vermerken können Nutzer Notizen direkt in Google Analytics-Berichte einfügen. So lassen sich leichter Ereignisse erfassen, Datenänderungen erklären oder wichtige Beobachtungen für Sie und Ihr Team hervorheben.

07.03.2025: Der Parameter sharingWithGoogleAnySalesEnabled wird eingestellt

Der Parameter sharingWithGoogleAnySalesEnabled der Methode getDataSharingSettings ist jetzt veraltet und gibt immer false zurück. Das Feld wird im Juni 2025 aus der Google Analytics Admin API v1beta entfernt.

20.01.2025: Aufbewahrung von Nutzerdaten in DataRetentionSettings hinzugefügt

Das Feld userDataRetention wurde in der Admin API v1alpha und v1beta zu DataRetentionSettings hinzugefügt. Mit diesem Feld können Sie die Aufbewahrungseinstellungen für Nutzerdaten abrufen oder ändern.

09.09.2024 Umfrageformular für Zugriffsberichte

Die Dokumentation für die Methode runAccessReport wurde aktualisiert und enthält jetzt einen Link zum Feedbackformular für Google Analytics-Zugriffsberichte. Wir freuen uns über Ihr Feedback zu dieser API, damit wir sie weiter verbessern können.

Die Methoden CreateBigQueryLink, UpdateBigQueryLink und DeleteBigQueryLink zum Verwalten von BigQueryLink-Ressourcen mit der Admin API v1alpha wurden hinzugefügt.

Der Ressource BigQueryLink wurde das Feld dataset_location hinzugefügt.

Dem Änderungsverlauf unter dem neuen Wert BIGQUERY_LINK in ChangeHistoryResourceType wurden Änderungen an BigQuery-Verknüpfungen hinzugefügt.

01.08.2024 Funktionsgefährdende Änderung an der Methode createSubproperty

Die benutzerdefinierte Methode createSubproperty wurde in der Admin API v1alpha in provisionSubproperty umbenannt, um den Richtlinien für benutzerdefinierte Methoden zu entsprechen.

01.08.2024: Verwaltung von Regeln zum Bearbeiten von Ereignissen hinzugefügt

GetEventEditRule, CreateEventEditRule, DeleteEventEditRule, ListEventEditRules, UpdateEventEditRules, ReorderEventEditRules, Methoden, die der Admin API v1alpha hinzugefügt wurden.

Mit einer EventEditRule werden Bedingungen definiert, die das Erstellen eines völlig neuen Ereignisses basierend auf übereinstimmenden Kriterien eines Quellereignisses auslösen. Außerdem kann mit einem EventEditRule die Änderung der Parameter aus dem Quellereignis definiert werden.

01.08.2024 Verschiedene Änderungen

create_time wurde der Ressource Audience hinzugefügt.

Der Ressource ChannelGroup wurde primary hinzugefügt, um anzugeben, ob die Channelgruppe die Standard-Channelgruppe für Berichte ist. Es kann jeweils nur eine Channelgruppe geben, bei der primary auf true gesetzt ist. Wenn Sie primary für eine Channelgruppe auf true festlegen, wird primary für die bisherige primäre Channelgruppe automatisch auf false gesetzt.

gmp_organization wurde der Account-Ressource hinzugefügt. Sie enthält den URI für eine Google Marketing Platform-Organisationsressource, wenn das Konto mit einer GMP-Organisation verknüpft ist.

06.05.2024: Methoden zur Verwaltung von Schlüsselereignissen hinzugefügt

Ressourcen und Methoden für Schlüsselereignisse sind jetzt verfügbar.

Ändern Sie Ihre API-Integration so, dass KeyEvent anstelle von ConversionEvent verwendet wird. ConversionEvent ist veraltet.

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 des Berichts zum Datenzugriff hinzugefügt.

Die Dimension accessDateHour wurde dem Schema für den Datenzugriffsbericht hinzugefügt. Sie enthält das Datum und die Uhrzeit des GA-Nutzers, der auf GA-Berichtsdaten zugegriffen hat.

05.10.2023: Bei Properties mit den Attributionsmodellen „Erster Klick“, „Linear“, „Zeitverlauf“ und „Positionsbasiert“ wird standardmäßig die channelübergreifende DDA verwendet.

Ab Mitte Oktober 2023 sind die Attributionsmodelle Erster Klick, Linear, Zeitverlauf und Positionsbasiert für alle Properties nicht mehr für die Methode UpdateAttributionSettings verfügbar.

Wenn in Ihrer Property derzeit eines dieser Modelle verwendet wird, wird es in channelübergreifende datengetriebene Attribution geändert. Sie haben weiterhin die Möglichkeit, stattdessen „Letzter Klick (channelübergreifend)“ oder „Letzter Google Ads-Klick bevorzugt“ zu verwenden.

01.09.2023: Es wurden Methoden zum Konfigurieren des SKAdNetwork-Conversion-Wert-Schemas hinzugefügt.

GetSKAdNetworkConversionValueSchema, CreateSKAdNetworkConversionValueSchema, DeleteSKAdNetworkConversionValueSchema, UpdateSKAdNetworkConversionValueSchema, ListSKAdNetworkConversionValueSchemas Methoden, die der Admin API v1alpha hinzugefügt wurden.

Mit dieser Funktion können Sie die Konfiguration des SKAdNetwork-Conversion-Wert-Schemas für einen iOS-Stream verwalten.

01.09.2023: Die Methode UpdateConversionEvent 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: Funktionsgefährdende Änderungen an den Methoden properties.updateAttributionSettings und properties.getAttributionSettings.

Ab dem 24. Juli 2023 werden grundlegende Änderungen an der Admin API v1alpha vorgenommen, die sich auf die Funktionalität der Methoden properties.getAttributionSettings und properties.updateAttributionSettings auswirken.

Mitglieder des Enums 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 des Enums 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.

Das Feld ads_web_conversion_data_export_scope wurde dem Typ AttributionSettings hinzugefügt. Es kann mit der Methode UpdateAttributionSettings geändert werden.

05.06.2023: Die Attributionsmodelle „Erster Klick“, „Linear“, „Zeitverlauf“ und „Positionsbasiert“ werden eingestellt.

Ab Juni 2023 kann die Methode UpdateAttributionSettings nicht mehr verwendet werden, um GA4-Properties mit den Attributionsmodellen Erster Klick, Linear, Zeitverlauf und Positionsbasiert zu konfigurieren. Ab September 2023 sind diese Modelle für alle Properties nicht mehr verfügbar.

Weitere Informationen finden Sie in der Google Analytics-Produktmitteilung.

GetAdSenseLink, CreateAdSenseLink, DeleteAdSenseLink, ListAdSenseLinks Methoden, die der Admin API v1alpha hinzugefügt wurden.

Mit dieser Funktion können AdSense-zu-Analytics-Verknüpfungen für eine GA4-Property verwaltet werden.

31.05.2023: Es wurde eine Methode zum Suchen einer verknüpften GA4-Property hinzugefügt.

Die Methode FetchConnectedGa4Property, die der Admin API v1alpha hinzugefügt wurde

Mit dieser Funktion können Sie während der GA4-Migration Informationen zu einer GA4-Property abrufen, die mit Ihrer Universal Analytics-Property verknüpft ist.

31.05.2023: Methode zum Verwalten von Regeln zum Erstellen von Ereignissen hinzugefügt.

Die Methoden CreateEventCreateRule, UpdateEventCreateRule, DeleteEventCreateRule, ListEventCreateRules und GetEventCreateRule wurden der Admin API v1alpha hinzugefügt.

Mit dieser Funktion können Sie Regeln zum Erstellen von Ereignissen verwalten, mit denen die Erstellung eines völlig neuen Ereignisses auf Grundlage der übereinstimmenden Kriterien eines Quellereignisses ausgelöst werden kann.

31.05.2023: Es wurden Methoden zum Verwalten benutzerdefinierter Channelgruppen hinzugefügt.

Die Methoden GetChannelGroup, ListChannelGroups, CreateChannelGroup, UpdateChannelGroup} und DeleteChannelGroup wurden der Admin API v1alpha hinzugefügt.

Mit dieser Funktion können Sie benutzerdefinierte Channelgruppen für die Traffic-Quellen Ihrer Website verwalten.

Nachdem Sie benutzerdefinierte Channelgruppen erstellt haben, können Sie sie mit der Google Analytics Data API v1 abfragen.

31.03.2023: Es wurden Verwaltungsmethoden für Einstellungen für optimierte Analysen hinzugefügt.

Die Methoden properties.dataStreams.updateEnhancedMeasurementSettings und properties.dataStreams.getEnhancedMeasurementSettings wurden der Admin API v1alpha hinzugefügt.

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 verbundener Website-Tags hinzugefügt.

Die Methoden properties.createConnectedSiteTag, properties.deleteConnectedSiteTag und properties.listConnectedSiteTags wurden der Admin API v1alpha hinzugefügt.

Mit dieser Funktion lassen sich verbundene Website-Tags verwalten. Sie ist nützlich, um Traffic von einer Universal Analytics-Property an eine Google Analytics 4-Property weiterzuleiten.

31.03.2023: Der Admin API v1beta wurden runAccessReport-Methoden auf Konto- und Property-Ebene hinzugefügt.

Die Methoden properties.runAccessReport und accounts.runAccessReport wurden der v1beta-Version der Admin API hinzugefügt. Methoden geben einen benutzerdefinierten Bericht zu Datensatzzugriffen zurück.

24.02.2023: Es wurden 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.list und properties.expandedDataSets.get hinzugefügt. Mit dieser Funktion können Sie erweiterte Datensätze in Google Analytics 360 verwalten.

Die AccessBinding-Ressource wurde der v1alpha-Version der API zusammen mit den folgenden Vorgängen hinzugefügt:

Mit dieser Funktion lassen sich Nutzerberechtigungen für ein GA4-Konto oder eine GA4-Property verwalten. Sie sollte anstelle von Nutzerverknüpfungen verwendet werden.

Funktion „Nutzerlinks“ wird am 01.06.2023 aus der Admin API v1 (Alpha) entfernt

24.02.2023: Die Methoden zur Überprüfung von Nutzerberechtigungen werden eingestellt.

Die folgenden Methoden sind veraltet und werden am 01.06.2023 aus der Admin API v1alpha entfernt:

24.02.2023: Methoden zur Zielgruppenverwaltung 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.list und properties.audience.get hinzugefügt.

Mit dieser Funktion können Sie Zielgruppen für eine GA4-Property verwalten.

15.02.2023: Es wurden Methoden zum Deaktivieren der automatischen GA4-Einrichtung hinzugefügt.

Die Vorgänge properties.setAutomatedGa4ConfigurationOptOut und properties.fetchAutomatedGa4ConfigurationOptOut wurden der v1alpha-Version der API hinzugefügt.

Mit dieser Funktion können Sie den Aktivierungsstatus für die automatische GA4-Einrichtung für eine UA-Property verwalten.

Die Ressource BigQueryLink wurde der v1alpha-Version 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.

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.list und properties.searchAds360Links.get hinzugefügt.

Mit dieser Funktion lassen sich Verknüpfungen zwischen einer GA4-Property und einer Search Ads 360-Einheit verwalten.

15.02.2023 Nicht abwärtskompatible Änderungen.

15.02.2023 Verschiedene Änderungen.

11.08.2022: Die Methode runAccessReport wurde der Admin API v1alpha hinzugefügt.

Die Methode properties.runAccessReport wurde der v1alpha-Version der Admin API hinzugefügt. Es wird ein benutzerdefinierter Bericht mit Datensatzdatensätzen zurückgegeben. Der Bericht enthält Aufzeichnungen für jedes Mal, wenn ein Nutzer Google Analytics-Berichtsdaten liest. Berichte zum Datenzugriff sind für Administratoren von Google Analytics 360-Properties verfügbar.

11.07.2022: Die Admin API v1beta wurde veröffentlicht.

Die v1beta-Version 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. Der Beta-Kanal enthält eine Teilmenge der im Alpha-Kanal verfügbaren Funktionen, die als stabil gelten und bei denen in Zukunft keine wesentlichen Änderungen erwartet werden. Neue Funktionen werden der Betaversion hinzugefügt, sobald sie ausgereift sind.

12.10.2021: Die Methoden „EnhancedMeasurementSettings“ wurden aus der API entfernt.

  • Die Methoden properties.webDataStreams.getEnhancedMeasurementSettings und properties.webDataStreams.updateEnhancedMeasurementSettings wurden aus der API entfernt. Die Einstellungen für erweiterte Analysen können aber bald wieder über die API geändert werden.
  • Das Feld directRoles der Ressource UserLink unterstützt die Rolle predefinedRoles/manage-users nicht mehr. Verwenden Sie stattdessen die neue Rolle predefinedRoles/admin, die der Kombination der alten Rollen predefinedRoles/edit und predefinedRoles/manage-users entspricht. Diese Änderung betrifft das Verhalten der Methoden accounts.userLinks und properties.userLinks und entspricht den Änderungen bei der Verwaltung von Zugriffs- und Dateneinschränkungen in Google Analytics.

05.06.2021: Funktionen hinzugefügt.

Der API werden die folgenden Funktionen hinzugefügt:

  • Der API wurde die Methode accounts.searchChangeHistoryEvents hinzugefügt. Mit dieser Methode werden alle Änderungen an einem Konto oder seinen untergeordneten Elementen anhand der angegebenen Filter durchsucht. Häufige Ursachen sind Aktualisierungen in der Google Analytics-Benutzeroberfläche, Änderungen durch den Kundensupport oder automatische Systemänderungen in Google Analytics.
  • Unter properties.webDataStreams.measurementProtocolSecrets wurden Methoden zur Verwaltung von Measurement Protocol-Secrets hinzugefügt:
    • create Erstellt ein Measurement Protocol-Secret.
    • delete Löscht das Measurement Protocol-Secret für das Ziel.
    • get Sucht nach einem einzelnen Measurement Protocol-Secret.
    • list Gibt untergeordnete Measurement Protocol-Secrets für die angegebene übergeordnete Property zurück.
    • patch Aktualisiert ein Measurement Protocol-Secret.
  • Unter properties.conversionEvents wurden Methoden zur Verwaltung von Conversion-Ereignissen hinzugefügt:
    • create Erstellt ein Conversion-Ereignis mit den angegebenen Attributen.
    • delete Löscht ein Conversion-Ereignis in einer Property.
    • get Einzelnes Conversion-Ereignis abrufen.
    • list Gibt eine Liste von Conversion-Ereignissen in der angegebenen übergeordneten Property zurück.
  • Methoden zur Verwaltung benutzerdefinierter Dimensionen, die unter properties.customDimensions hinzugefügt wurden:
    • archive Archiviert eine benutzerdefinierte Dimension in einer Property.
    • create Erstellt eine benutzerdefinierte Dimension.
    • get Suche nach einer einzelnen benutzerdefinierten Dimension.
    • list Listet benutzerdefinierte Dimensionen für eine Property auf.
    • patch Aktualisiert eine benutzerdefinierte Dimension für eine Property.
  • Methoden zur Verwaltung benutzerdefinierter Messwerte, die unter properties.customMetrics hinzugefügt wurden:
    • archive Archiviert einen benutzerdefinierten Messwert in einer Property.
    • create Erstellt einen benutzerdefinierten Messwert.
    • get Nach einem einzelnen benutzerdefinierten Messwert suchen.
    • list Listet benutzerdefinierte Messwerte für eine Property auf.
    • patch Aktualisiert einen benutzerdefinierten Messwert für eine Property.
  • Die Methoden properties.getGoogleSignalsSettings und properties.updateGoogleSignalsSettings wurden hinzugefügt, mit denen die Einstellung Google-Signale für eine Google Analytics 4-Property gesteuert werden kann.
  • delete_time, expire_time gibt nur Felder aus, die dem Typ Property hinzugefügt wurden.

05.06.2021 Funktionsgefährdende Änderungen.

Die folgenden nicht abwärtskompatiblen Änderungen wurden eingeführt:

  • Die Methoden properties.iosAppDataStreams.create und properties.androidAppDataStreams.create wurden aus der API entfernt. Verwenden Sie Firebase, um App-Streams in einer Google Analytics 4-Property zu erstellen.
  • Die Methode properties.delete gibt jetzt die gelöschten Property-Daten als Typ Property zurück, anstatt eine leere Antwort zurückzugeben.
  • Das Feld time_zone vom Typ Property ist jetzt erforderlich.
  • Das Feld deleted wurde aus dem Typ Property entfernt.
  • Das Feld email_address des Typs UserLink ist jetzt unveränderlich.
  • Das Feld name des Typs UserLink ist jetzt nur noch ein Ausgabefeld.

28.01.2021 Funktionsgefährdende Änderungen.

Wichtige Änderungen: – Das Feld update_mask ist für alle Aktualisierungsvorgänge erforderlich.

  • Das Feld country_code wurde in Account in region_code umbenannt.

  • Das Feld url_query_parameter wurde in EnhancedMeasurementSettings in uri_query_parameter umbenannt.

  • Das Feld „parent“ wurde aus „GoogleAdsLink“ entfernt.

20.10.2020: Unterstützung für Kontoübersichten hinzugefügt.

Unterstützung für die Methode account summaries hinzugefügt.

13.10.2020: App + Web-Properties wurden in Google Analytics 4 (GA4) umbenannt.

15.08.2020: Die Management App und die Web-API wurden in Admin API umbenannt.

Die Google Analytics Management App + Web API wurde in Google Analytics Admin API umbenannt. Daher hat sich der API-Endpunkt zu analyticsadmin.googleapis.com geändert. Vorhandener Code, der für die vorherige Version der API-Endpunkt-URL und der Clientbibliotheken geschrieben wurde, muss entsprechend aktualisiert werden.