Änderungsprotokoll

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

18.06.2026: UpdateReportingIdentitySettings-Methode hinzugefügt

18.06.2026: Das Feld „can_edit“ wurde zu „PropertySummary“ hinzugefügt.

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

14.04.2026: GetUserProvidedDataSettings-Methode hinzugefügt

2025-08-20: 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 Konfigurationsverwaltung 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: 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: Datenaufbewahrung von Nutzerdaten in DataRetentionSettings hinzugefügt

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

09.09.2024 Umfrageformular für den Zugriff auf Berichte

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 einem 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.

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

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 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 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 datengetriebene kanalübergreifende 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 in der Admin API v1alpha funktionsgefährdende Änderungen vorgenommen, die sich auf die Funktionalität der Methoden properties.getAttributionSettings und properties.updateAttributionSettings auswirken.

Die Elemente der ReportingAttributionModel-Enumeration 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 Elemente der AdsWebConversionDataExportScope-Enumeration 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 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.

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

Mit dieser Funktion können Sie AdSense-Analytics-Verknüpfungen für eine GA4-Property verwalten.

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 zum Erstellen von Ereignissen hinzugefügt.

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

Mit dieser Funktion können Sie Regeln zum Erstellen von Ereignissen verwalten, die das Erstellen eines völlig neuen Ereignisses basierend auf übereinstimmenden Kriterien eines Quellereignisses auslösen können.

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

Die Methoden GetChannelGroup, ListChannelGroups, CreateChannelGroup, UpdateChannelGroup>, 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 Methoden zur Verwaltung von 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 Zugriffe 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 mit Datensatzzugriffen zurück.

24.02.2023: Verwaltungsmethoden für erweiterte Datensätze hinzugefügt.

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

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

Mit dieser Funktion können Sie 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.

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

Mit dieser Funktion lässt sich der Aktivierungsstatus 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 SearchAds360Link-Ressource wurde der v1alpha-Version der API zusammen mit den entsprechenden properties.searchAds360Links.create-, properties.searchAds360Links.delete-, properties.searchAds360Links.patch-, properties.searchAds360Links.list- und properties.searchAds360Links.get-Vorgängen hinzugefügt.

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

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 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 Version 1beta der Admin API wurde veröffentlicht.

Die v1beta-Version der Google Analytics Admin API ist jetzt verfügbar.

Sowohl Alpha- als auch Betaversionen der API werden weiterhin für die Admin API unterstützt. Die Betaversion enthält eine Teilmenge der Funktionen, die im Alphakanal verfügbar sind. Diese Funktionen gelten als stabil und es wird nicht erwartet, dass sie sich in Zukunft wesentlich ändern. Neue Funktionen werden der Betaversion hinzugefügt, sobald sie ausgereift sind.

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

  • properties.webDataStreams.getEnhancedMeasurementSettings, properties.webDataStreams.updateEnhancedMeasurementSettings-Methoden werden aus der API entfernt. Die Einstellungen für optimierte 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 aus den 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 wurden die folgenden Funktionen 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 Systemänderungen in Google Analytics.
  • Unter properties.dataStreams.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 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 Ein einzelnes Conversion-Ereignis abrufen.
    • list Gibt eine Liste von Conversion-Ereignissen 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 für eine Property auf.
    • patch Aktualisiert eine benutzerdefinierte Dimension für eine 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 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 reine Ausgabefelder, 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 Anwendungsstreams in einer Google Analytics 4-Property zu erstellen.
  • Die Methode properties.delete gibt jetzt die gelöschten Property-Daten als Property-Typ zurück, anstatt eine leere Antwort zu senden.
  • Das Feld time_zone vom Typ Property ist jetzt erforderlich.
  • Das Feld „deleted“ wurde aus dem Typ Property entfernt.
  • Das Feld email_address vom Typ 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.

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

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

Unterstützung für die Methode accountSummaries 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.