Änderungsprotokoll

Offizielle Ankündigungen zur Google Analytics API finden Sie in der Google Analytics API Notify Group.

18.06.2026 Methode UpdateReportingIdentitySettings hinzugefügt

18.06.2026 Feld can_edit zu PropertySummary hinzugefügt

  • Der PropertySummary Ressource in der Admin API v1alpha und v1beta wurde das can_edit Feld hinzugefügt. Dieses Feld gibt an, ob der Nutzer eine Google Analytics-Rolle hat, mit der er Einstellungen für die Property ändern kann.

14.04.2026 Methode GetUserProvidedDataSettings hinzugefügt

20.08.2025 Methode GetReportingIdentitySettings hinzugefügt

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

20.08.2025 Ältere Universal Analytics-Methoden entfernt

Die folgenden älteren 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 Konfiguration der Synchronisierung von untergeordneten Properties hinzugefügt

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

16.04.2025 Methoden zur Verwaltung von Vermerken für Berichtsdaten 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 Parameter sharingWithGoogleAnySalesEnabled wird eingestellt

Der Parameter sharingWithGoogleAnySalesEnabled der getDataSharingSettings Methode 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 zu DataRetentionSettings hinzugefügt

In der Admin API v1alpha und v1beta wurde das userDataRetention Feld 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 runAccessReport Methode wurde um einen Link zum Feedbackformular für Google Analytics-Zugriffsberichte ergänzt. Wir freuen uns über Ihr Feedback und möchten Sie ermutigen, uns Ihre Meinung zu dieser API mitzuteilen, damit wir sie weiter verbessern können.

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

Der Ressource BigQueryLink wurde das Feld dataset_location hinzugefügt.

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

01.08.2024 Funktionsgefährdende Änderung an der Methode createSubproperty

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

01.08.2024 Verwaltung von Regeln zur Ereignisbearbeitung hinzugefügt

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

Eine EventEditRule definiert Bedingungen, die die Erstellung eines völlig neuen Ereignisses auslösen, das auf übereinstimmenden Kriterien eines Quellereignisses basiert. Außerdem können mit einer EventEditRule Änderungen an den Parametern des Quellereignisses definiert werden.

01.08.2024 Verschiedene Änderungen

Der Ressource Audience wurde create_time hinzugefügt.

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

Der Ressource Account wurde gmp_organization hinzugefügt. Sie enthält die 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üssel ereignisse sind jetzt verfügbar.

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

15.12.2023 Datenzugriffsberichte sind jetzt für alle Google Analytics-Properties verfügbar.

Bestimmte Felder der Funktion „Datenzugriffsberichte“ 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 Dimension accessDateHour zum Schema für Datenzugriffsberichte hinzugefügt

Die accessDateHour Dimension wurde zum Schema für Datenzugriffsberichte hinzugefügt. Sie enthält das Datum und die Uhrzeit des Google Analytics-Nutzers, der auf Google Analytics-Berichtsdaten zugegriffen hat.

05.10.2023 Für Properties mit den Attributionsmodellen „Erster Klick“, „Linear“, „Zeitverlauf“ und „Positionsbasiert“ wird standardmäßig die channelübergreifende datengetriebene Attribution verwendet.

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

Wenn für Ihre Property derzeit eines dieser Modelle konfiguriert ist, wird es in die 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 Methoden zur Konfiguration des SKAdNetwork-Conversion-Wert-Schemas hinzugefügt

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

Mit dieser Funktion kann die SKAdNetwork-Conversion-Wert-Schema Konfiguration für einen iOS-Stream verwaltet werden.

01.09.2023 Methode UpdateConversionEvent hinzugefügt

UpdateConversionEvent Der Admin API v1beta wurde die Methode hinzugefügt.

01.09.2023 Feld BigQueryLink.enterprise_export_enabled 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 properties.getAttributionSettings, properties.updateAttributionSettings auswirken.

Die Mitglieder der ReportingAttributionModel Enumeration werden wie folgt 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 der AdsWebConversionDataExportScope Enumeration werden wie folgt umbenannt:

Alter Name Neuer Name
CROSS_CHANNEL PAID_AND_ORGANIC_CHANNELS
ADS_PREFERRED GOOGLE_PAID_CHANNELS

10.07.2023 Feld ads_web_conversion_data_export_scope zum Typ AttributionSettings hinzugefügt

Dem AttributionSettings Typ wurde das ads_web_conversion_data_export_scope Feld hinzugefügt, das mit der UpdateAttributionSettings Methode 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 von Google Analytics.

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

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

31.05.2023 Methode zum Suchen einer verknüpften GA4-Property hinzugefügt

Der Admin API v1alpha wurde die FetchConnectedGa4Property Methode 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 Methode zum Verwalten von Regeln zur Ereigniserstellung hinzugefügt

Der Admin API v1alpha wurden die Methoden CreateEventCreateRule, UpdateEventCreateRule, DeleteEventCreateRule, ListEventCreateRules, GetEventCreateRule hinzugefügt.

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

31.05.2023 Methoden zum Verwalten benutzerdefinierter Channelgruppen hinzugefügt

Der Admin API v1alpha wurden die Methoden GetChannelGroup, ListChannelGroups, CreateChannelGroup, UpdateChannelGroup, DeleteChannelGroup hinzugefügt.

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

Nach der Erstellung können benutzerdefinierte Channelgruppen mit der Google Analytics Data API v1 abgefragt werden.

31.03.2023 Methoden zur Verwaltung der Einstellungen für optimierte Analysen hinzugefügt

Der Admin API v1alpha wurden die Methoden properties.dataStreams.updateEnhancedMeasurementSettings und properties.dataStreams.getEnhancedMeasurementSettings 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 von verbundenen Website-Tags hinzugefügt

Der Admin API v1alpha wurden die Methoden properties.createConnectedSiteTag, properties.deleteConnectedSiteTag und properties.listConnectedSiteTags hinzugefügt.

Mit dieser Funktion können Sie 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 Methoden runAccessReport auf Konto- und Property-Ebene zur Admin API v1beta hinzugefügt

Der v1beta-Version der Admin API wurden die properties.runAccessReport und accounts.runAccessReport -Methoden hinzugefügt. Die Methoden geben einen benutzerdefinierten Bericht mit Datensätzen zum Datenzugriff zurück.

24.02.2023 Methoden zur Verwaltung erweiterter Datensätze hinzugefügt

Der v1alpha-Version der API wurde die ExpandedDataSet Ressource 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 erweiterte Datensätze in Google Analytics 360 verwaltet werden.

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

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 „Nutzerverknüpfungen“ wird am 1. Juni 2023 aus der Admin API v1alpha entfernt.

24.02.2023 Die Audit-Methoden für Nutzerberechtigungen werden eingestellt.

Die folgenden Methoden sind veraltet und werden am 1. Juni 2023 aus der Admin API v1alpha entfernt:

24.02.2023 Methoden zur Zielgruppenverwaltung hinzugefügt

Der v1alpha-Version der API wurde die AudienceRessource zusammen mit den entsprechenden properties.audience.create, properties.audience.archive, properties.audience.patch, properties.audience.list und properties.audience.get Vorgängen hinzugefügt.

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

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

Mit dieser Funktion kann der Deaktivierungsstatus für die automatische GA4 Einrichtung für eine UA-Property verwaltet werden.

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

Mit dieser Funktion können Sie Informationen zu Verknüpfungen zwischen einer GA4-Property und einem BigQuery-Projekt abrufen.

Der v1alpha-Version der API wurde die SearchAds360Link Ressource 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 können Sie Verknüpfungen zwischen einer GA4-Property und einer Search Ads 360-Entität verwalten.

15.02.2023 Funktionsgefährdende Änderungen

15.02.2023 Verschiedene Änderungen

  • Der Typ AccessQuota enthält jetzt das Feld tokensPerProjectPerHour.
  • Der Enumeration ChangeHistoryResourceType wurden die Werte EXPANDED_DATA_SET und CHANNEL_GROUP hinzugefügt.
  • Der Enumeration ChangeHistoryResource wurden die Werte searchAds360Link, expandedDataSet und bigqueryLink hinzugefügt.

11.08.2022 Methode runAccessReport zur Admin API v1alpha hinzugefügt

Der v1alpha-Version der Admin API wurde die properties.runAccessReport Methode hinzugefügt. Sie gibt einen benutzerdefinierten Bericht mit Datensätzen zum Datenzugriff zurück. Der Bericht enthält Datensätze für jeden Zugriff eines Nutzers auf Google Analytics-Berichtsdaten. Zugriffsberichte sind für Administratoren von Google Analytics 360-Properties verfügbar.

11.07.2022 Version v1beta der Admin API veröffentlicht

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

Sowohl der Alpha- als auch der Beta-Kanal der API werden weiterhin für die Admin API unterstützt. Die Betaversion 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 Beta-Version hinzugefügt, sobald sie ausgereift sind.

12.10.2021 Methoden für Einstellungen für optimierte Analysen aus der API entfernt

  • properties.webDataStreams.getEnhancedMeasurementSettings und properties.webDataStreams.updateEnhancedMeasurementSettings Methoden wurden 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. Sie entspricht der Kombination der alten Rollen predefinedRoles/edit und predefinedRoles/manage-users. Diese Änderung wirkt sich auf das Verhalten der accounts.userLinks, properties.userLinks Methoden aus und entspricht den Änderungen an der Verwaltung von Zugriff und Datenbeschränkungen , die in Google Analytics eingeführt wurden.

05.06.2021 Funktionen hinzugefügt

Der API wurden die folgenden Funktionen hinzugefügt:

  • accounts.searchChangeHistoryEvents Methode 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 auf der Google Analytics-Oberfläche, Änderungen durch den Kundensupport oder automatische Änderungen am Google Analytics-System.
  • Methoden zur Verwaltung von Measurement Protocol-Secrets unter properties.dataStreams.measurementProtocolSecrets:
    • create : Erstellt ein Measurement Protocol-Secret.
    • delete : Löscht das Ziel-Measurement Protocol-Secret.
    • 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.
  • Methoden zur Verwaltung von Conversion-Ereignissen unter properties.conversionEvents:
    • 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 von Conversion-Ereignissen in der angegebenen übergeordneten Property zurück.
  • Methoden zur Verwaltung benutzerdefinierter Dimensionen unter properties.customDimensions:
    • archive : Archiviert eine benutzerdefinierte Dimension in einer Property.
    • create : Erstellt eine benutzerdefinierte Dimension.
    • get : Sucht nach einer einzelnen benutzerdefinierten Dimension.
    • list : Listet benutzerdefinierte Dimensionen in einer Property auf.
    • patch : Aktualisiert eine benutzerdefinierte Dimension in einer Property.
  • Methoden zur Verwaltung benutzerdefinierter Messwerte unter properties.customMetrics:
    • archive : Archiviert einen benutzerdefinierten Messwert in einer Property.
    • create : Erstellt einen benutzerdefinierten Messwert.
    • get : Sucht nach einem einzelnen benutzerdefinierten Messwert.
    • list : Listet benutzerdefinierte Messwerte in einer Property auf.
    • patch : Aktualisiert einen benutzerdefinierten Messwert in einer Property.
  • Die Methoden properties.getGoogleSignalsSettings, properties.updateGoogleSignalsSettings wurden hinzugefügt, mit denen die Google-Signale -Einstellung für eine Google Analytics 4-Property gesteuert werden kann.
  • delete_time, expire_time output only fields added to the Property type.

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.
  • properties.delete Methode gibt jetzt die Daten der gelöschten Property als Property Typ zurück, anstatt eine leere Antwort zu liefern.
  • time_zone Feld des Typs Property ist jetzt erforderlich.
  • Das Feld deleted wurde aus dem Property Typ entfernt.
  • email_address Feld des UserLink Typs ist jetzt unveränderlich.
  • name Feld des Typs UserLink dient jetzt nur der Ausgabe.

28.01.2021 Funktionsgefährdende Änderungen

Funktionsgefährdende Änderungen: - update_mask Feld 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 für Kontoübersichten hinzugefügt

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

15.08.2020 Management App + Web API in Admin API umbenannt

Die Google Analytics Management App + Web API wurde in Google Analytics Admin API umbenannt. Dadurch hat sich 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.