Änderungsprotokoll

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.

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.

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

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.

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.

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.

15.02.2023 Verschiedene Änderungen

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 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 wirkt sich auf das Verhalten der Methoden accounts.userLinks und properties.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:
    • create Erstellt ein Conversion-Ereignis mit den angegebenen Attributen.
    • delete Löscht ein Conversion-Ereignis in einer Property
    • get Rufen Sie ein einzelnes Conversion-Ereignis ab.
    • list Gibt eine Liste der Conversion-Ereignisse in der angegebenen übergeordneten Property zurück.
  • 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 auf
    • patch 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 auf
    • patch 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 Typ Property hinzugefügt wurden.

05.06.2021 Wichtige Ä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 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 wird jetzt nur noch ausgegeben.

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