Änderungsprotokoll

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

18.06.2026: Methode UpdateReportingIdentitySettings hinzugefügt

18.06.2026: Feld can_edit zu PropertySummary hinzugefügt

  • Das Feld can_edit wurde der Ressource PropertySummary in der Admin API v1alpha und v1beta hinzugefügt. In diesem Feld wird angegeben, ob der Nutzer eine Google Analytics-Rolle hat, die es ihm erlaubt, Einstellungen für die Property zu ändern.

14.04.2026: Methode GetUserProvidedDataSettings hinzugefügt

20.08.2025: Methode GetReportingIdentitySettings hinzugefügt

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

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 Synchronisierungskonfiguration für untergeordnete Properties hinzugefügt

Die Methoden GetSubpropertySyncConfig, ListSubpropertySyncConfig und UpdateSubpropertySyncConfig wurden hinzugefügt, um SubpropertySyncConfig-Ressourcen mit der Admin API v1alpha zu verwalten.

16.04.2025: Methoden zur Verwaltung von Berichtsdatenannotationen hinzugefügt

Die Methoden CreateReportingDataAnnotation, GetReportingDataAnnotation, ListReportingDataAnnotations, UpdateReportingDataAnnotation und DeleteReportingDataAnnotation wurden hinzugefügt, um ReportingDataAnnotation-Ressourcen mit der Admin API v1alpha zu verwalten.

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: Einstellung des Parameters sharingWithGoogleAnySalesEnabled

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

20.01.2025: DataRetentionSettings wurde um die Aufbewahrung von Nutzerdaten erweitert.

Das Feld userDataRetention wurde zu DataRetentionSettings in der Admin API v1alpha und v1beta hinzugefügt. Verwenden Sie dieses Feld, um Aufbewahrungseinstellungen für Nutzerdaten abzurufen oder zu ändern.

09.09.2024: Umfrageformular für Zugriffsberichte

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

Die Methoden CreateBigQueryLink, UpdateBigQueryLink und DeleteBigQueryLink wurden hinzugefügt, um BigQueryLink-Ressourcen mit der Admin API v1alpha zu verwalten.

Der Ressource BigQueryLink wurde das Feld dataset_location hinzugefügt.

Änderungen an BigQuery-Verknüpfungen wurden dem Änderungsverlauf unter dem neuen Wert BIGQUERY_LINK in ChangeHistoryResourceType 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 einem EventEditRule werden Bedingungen definiert, die die Erstellung eines völlig neuen Ereignisses basierend auf den übereinstimmenden Kriterien eines Quellereignisses auslösen. Darüber hinaus kann ein EventEditRule Änderungen der Parameter aus dem Quellereignis definieren.

01.08.2024: Sonstige Änderungen

create_time wurde zur Ressource Audience hinzugefügt.

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

gmp_organization wurde der Ressource Account 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 wurde verworfen.

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 Bericht zum Datenzugriff hinzugefügt. Sie enthält das Datum und die Uhrzeit des GA-Nutzers, der auf GA-Berichtsdaten zugegriffen hat.

05.10.2023: Properties mit den Attributionsmodellen „Erster Klick“, „Linear“, „Zeitverlauf“ und „Positionsbasiert“ werden standardmäßig auf die channelübergreifende datengetriebene Attribution umgestellt.

Ab Mitte Oktober 2023 können die Attributionsmodelle Erster Klick, Linear, Zeitverlauf und Positionsbasiert nicht mehr mit der Methode UpdateAttributionSettings für alle Properties verwendet werden.

Wenn Ihre Property derzeit für die Verwendung eines dieser Modelle konfiguriert ist, wird sie auf die kanalübergreifende datengetriebene Attribution umgestellt. Sie können stattdessen weiterhin die Optionen „Letzter Klick (channelübergreifend)“ oder „Letzter Google Ads-Klick bevorzugt“ verwenden.

01.09.2023: Methoden zur Konfiguration des SKAdNetwork-Conversion-Wert-Schemas hinzugefügt.

Die 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: Methode UpdateConversionEvent 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 funktionsgefährdende Änderungen an der Admin API v1 Alpha vorgenommen, die sich auf die Funktionalität der Methoden properties.getAttributionSettings und properties.updateAttributionSettings auswirken.

Die 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

Die 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: Einstellung der Attributionsmodelle „Erster Klick“, „Linear“, „Zeitverlauf“ und „Positionsbasiert“

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 Produktankündigung zu Google Analytics.

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

Mit dieser Funktion können Verknüpfungen zwischen AdSense und Analytics 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 wurde der Admin API v1alpha hinzugefügt.

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 für die Ereigniserstellung hinzugefügt.

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

Mit dieser Funktion können Sie Regeln für die Ereigniserstellung verwalten, die die Erstellung eines völlig neuen Ereignisses basierend auf übereinstimmenden Kriterien eines Quellereignisses auslösen können.

31.05.2023: 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: Methoden zur Verwaltung der 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 können verbundene Website-Tags verwaltet werden. 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 Version v1beta der Admin API hinzugefügt. Die Methoden geben einen benutzerdefinierten Bericht zu Datenzugriffsaufzeichnungen zurück.

24.02.2023: Methoden zur Verwaltung erweiterter Datensätze hinzugefügt.

Die Ressource ExpandedDataSet wurde der v1alpha-Version der API hinzugefügt, zusammen mit den entsprechenden Vorgängen properties.expandedDataSets.create, properties.expandedDataSets.delete, properties.expandedDataSets.patch, properties.expandedDataSets.list und properties.expandedDataSets.get. Mit dieser Funktion können erweiterte Datensätze in Google Analytics 360 verwaltet werden.

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

Mit dieser Funktion können Nutzerberechtigungen für ein GA4-Konto oder eine GA4-Property verwaltet werden. Sie sollte anstelle von Nutzerverknüpfungen verwendet werden.

Die Funktion Nutzerlinks wird am 1.6.23 aus der Admin API v1 Alpha entfernt

24.02.2023: Einstellung der Methoden zur Prüfung von Nutzerberechtigungen.

Die folgenden Methoden wurden verworfen und werden am 1. Juni 2023 aus der Admin API v1 Alpha entfernt:

24.02.2023: Methoden zur Zielgruppenverwaltung hinzugefügt.

Die Ressource Audience wurde der v1alpha-Version der API hinzugefügt, zusammen mit den entsprechenden Vorgängen properties.audience.create, properties.audience.archive, properties.audience.patch, properties.audience.list, properties.audience.get.

Mit dieser Funktion können Zielgruppen für eine GA4-Property verwaltet werden.

15.02.2023: Methoden zum Deaktivieren der automatischen GA4-Einrichtung 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 automatische GA4-Einrichtung für eine UA-Property verwalten.

Die Ressource BigQueryLink wurde der v1alpha-Version der API hinzugefügt, zusammen mit den entsprechenden Vorgängen properties.bigQueryLinks.get und properties.bigQueryLinks.list.

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 hinzugefügt, zusammen mit den entsprechenden Vorgängen properties.searchAds360Links.create, properties.searchAds360Links.delete, properties.searchAds360Links.patch, properties.searchAds360Links.list und properties.searchAds360Links.get.

Mit dieser Funktion können Verknüpfungen zwischen einer GA4-Property und einer Search Ads 360-Entität verwaltet werden.

15.02.2023 Funktionsgefährdende Ä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 Datenzugriffsdatensätzen zurückgegeben. Der Bericht enthält Einträge für jedes Mal, wenn ein Nutzer Google Analytics-Berichtsdaten liest. Datenzugriffsberichte sind für Administratoren von Google Analytics 360-Properties verfügbar.

11.07.2022: Admin API v1beta veröffentlicht.

Die v1beta-Version der Google Analytics Admin API wurde veröffentlicht.

Sowohl die Alpha- als auch die Betaversion der Admin API werden weiterhin unterstützt. Die Betaversion enthält eine Teilmenge der in der Alphaversion verfügbaren Funktionen, die als stabil gelten und sich in Zukunft voraussichtlich nicht wesentlich ändern werden. Neue Funktionen werden der Betaversion hinzugefügt, sobald sie ausgereift sind.

12.10.2021: EnhancedMeasurementSettings-Methoden wurden aus der API entfernt.

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

05.06.2021: Funktionen hinzugefügt.

Die folgenden Funktionen werden der API hinzugefügt:

  • Die Methode accounts.searchChangeHistoryEvents wurde der API 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 Änderungen am Google Analytics-System.
  • Methoden zur Verwaltung von Measurement Protocol-Secrets unter properties.dataStreams.measurementProtocolSecrets hinzugefügt:
    • create Erstellt ein Measurement Protocol-Secret.
    • delete Löscht das Ziel-Secret für das Measurement Protocol.
    • get Suche nach einem einzelnen Measurement Protocol-Secret.
    • list Gibt untergeordnete Measurement Protocol-Secrets unter der angegebenen übergeordneten 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 Ruft ein einzelnes Conversion-Ereignis ab.
    • list Gibt eine Liste der Conversion-Ereignisse in der angegebenen übergeordneten Property zurück.
  • Unter properties.customDimensions wurden Methoden zur Verwaltung benutzerdefinierter Dimensionen hinzugefügt:
    • archive Archiviert eine benutzerdefinierte Dimension in einer Property.
    • create Erstellt eine benutzerdefinierte Dimension.
    • get Suche nach einer einzelnen benutzerdefinierten Dimension.
    • list Listet benutzerdefinierte Dimensionen in einer Property auf.
    • patch Aktualisiert eine benutzerdefinierte Dimension in einer Property.
  • Unter properties.customMetrics wurden Methoden zur Verwaltung benutzerdefinierter Messwerte hinzugefügt:
    • archive Archiviert einen benutzerdefinierten Messwert in einer Property.
    • create Erstellt einen benutzerdefinierten Messwert.
    • get Suche nach einem einzelnen benutzerdefinierten Messwert.
    • list Listet benutzerdefinierte Messwerte für eine Property auf.
    • patch Aktualisiert einen benutzerdefinierten Messwert in einer 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 Nur-Ausgabe-Felder, die dem Typ Property hinzugefügt wurden.

05.06.2021 Funktionsgefährdende Änderungen.

Die folgenden funktionsgefährdenden Ä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 des Typs 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.

Funktionsgefährdende Ä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.

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

20.10.2020: Unterstützung für Kontozusammenfassungen 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 Verwaltungs-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 der Clientbibliotheken geschrieben wurde, muss entsprechend aktualisiert werden.