Änderungslog

Offizielle Ankündigungen zur Google Analytics API erhalten Sie, wenn Sie der Google Analytics API-Benachrichtigungsgruppe beitreten.

2025-01-20 DataRetentionSettings: Aufbewahrung von Nutzerdaten hinzugefügt

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

2024-09-09 Umfrage zu Zugriffsberichten

Die Dokumentation für die Methode runAccessReport wurde um einen Link zum Feedbackformular für Google Analytics-Zugriffsberichte ergänzt. Wir freuen uns über Ihr Feedback und möchten Sie bitten, uns Ihre Meinung zu dieser API mitzuteilen, damit wir sie weiter verbessern können.

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

Der Ressource BigQueryLink wurde das Feld dataset_location hinzugefügt.

BigQuery-Verknüpfungsänderungen wurden dem Änderungsverlauf unter dem neuen BIGQUERY_LINK-Wert in ChangeHistoryResourceType hinzugefügt.

01.08.2024 Funktionsgefährdende Änderung an der createSubproperty-Methode

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 für die Bearbeitung 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 auslösen, das auf den übereinstimmenden Kriterien eines Quellereignisses basiert. Außerdem können mit einem EventEditRule Änderungen an den Parametern 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. Für jeweils nur eine Channelgruppe kann primary auf true gesetzt sein. Wenn Sie für eine Channelgruppe primary auf true festlegen, wird für die vorherige primäre Channelgruppe automatisch primary auf false gesetzt.

Der Ressource Account wurde gmp_organization hinzugefügt. Diese 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 wichtige Ereignisse sind jetzt verfügbar.

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

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 Google Analytics-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 Berichte zum Datenzugriff hinzugefügt.

Die Dimension accessDateHour, die dem Schema für Berichte zum Datenzugriff hinzugefügt wurde. Sie enthält das Datum und die Uhrzeit des GA-Nutzers, der auf GA-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 mit der Methode UpdateAttributionSettings nicht mehr für alle Properties verwendet werden.

Wenn für Ihre Property derzeit eines dieser Modelle verwendet wird, wird es in datengetriebene kanalübergreifende Attribution geändert. Sie können stattdessen weiterhin „Letzter Klick (channelübergreifend)“ oder „Letzter Google Ads-Klick bevorzugt“ verwenden.

01.09.2023: Konfigurationsmethoden für das SKAdNetwork-Conversion-Wert-Schema hinzugefügt.

GetSKAdNetworkConversionValueSchema, CreateSKAdNetworkConversionValueSchema, DeleteSKAdNetworkConversionValueSchema, UpdateSKAdNetworkConversionValueSchema, ListSKAdNetworkConversionValueSchemas methods were added to the Admin API v1alpha.

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.

2023-09-01 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 an der Admin API v1alpha grundlegende Änderungen vorgenommen, die sich auf die Funktionalität der Methoden properties.getAttributionSettings und properties.updateAttributionSettings auswirken.

Mitglieder des ReportingAttributionModel-Genums werden folgendermaßen 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 AdsWebConversionDataExportScope-Genums werden folgendermaßen umbenannt:

Alter Name Neuer Name
CROSS_CHANNEL PAID_AND_ORGANIC_CHANNELS
ADS_PREFERRED GOOGLE_PAID_CHANNELS

2023-07-10 Dem Typ AttributionSettings wurde das Feld ads_web_conversion_data_export_scope 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 GA4-Properties nicht mehr mit den Attributionsmodellen Erster Klick, Linear, Zeitverlauf und Positionsbasiert über die Methode UpdateAttributionSettings konfiguriert werden. 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 methods added to the Admin API v1alpha.

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

31.05.2023: Es wurde eine Methode zum Abrufen 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. Mai 2023: Es wurde eine 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 zum Erstellen von Ereignissen verwalten, die das Erstellen eines ganz neuen Ereignisses auslösen können, das auf übereinstimmenden Kriterien eines Quellereignisses basiert.

31. Mai 2023: Es wurden Methoden zum Verwalten benutzerdefinierter Channelgruppen hinzugefügt.

Die Admin API v1alpha wurde um die Methoden GetChannelGroup, ListChannelGroups, CreateChannelGroup, UpdateChannelGroup und DeleteChannelGroup erweitert.

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

Nach dem Erstellen können benutzerdefinierte Channelgruppen mit der Google Analytics Data API Version 1 abgefragt werden.

31.03.2023: Es wurden Verwaltungsmethoden für die 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: Es wurden 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 Sie verknüpfte Website-Tags verwalten. Sie eignet sich zum Weiterleiten von Traffic von einer Universal Analytics-Property zu einer Google Analytics 4-Property.

31. März 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 Datenzugriffssätzen zurück.

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

Die Ressource ExpandedDataSet wurde der Version v1alpha 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 Ressource AccessBinding wurde der v1alpha-Version der API zusammen mit den folgenden Vorgängen hinzugefügt:

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

Die Funktion Nutzerverknüpfungen wird am 01.06.2023 aus der Admin API v1 Alpha entfernt.

24. Februar 2023: Die Methoden zur Prüfung von Nutzerberechtigungen werden eingestellt.

Die folgenden Methoden werden nicht mehr unterstützt und am 01.06.2023 aus der Admin API v1alpha entfernt:

24.02.2023: Methoden zur Zielgruppenverwaltung hinzugefügt.

Die Ressource Audience wurde der Version v1alpha 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 Deaktivierungsmethoden für die automatische GA4-Einrichtung hinzugefügt.

Der v1alpha-Version der API wurden die Vorgänge properties.setAutomatedGa4ConfigurationOptOut und properties.fetchAutomatedGa4ConfigurationOptOut 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 Sie Informationen zu Verknüpfungen zwischen einer GA4-Property und einem BigQuery-Projekt abrufen.

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

2023-02-15 Nicht abwärtskompatible Änderungen.

15.02.2023: Sonstige Änderungen.

  • Dem Typ AccessQuota wurde das Feld tokensPerProjectPerHour hinzugefügt.
  • EXPANDED_DATA_SET- und CHANNEL_GROUP-Werte, die der Aufzählung ChangeHistoryResourceType hinzugefügt wurden.
  • searchAds360Link-, expandedDataSet- und bigqueryLink-Werte, die ChangeHistoryResource hinzugefügt wurden

11.08.2022 runAccessReport-Methode zur Admin API v1alpha hinzugefügt.

Die Methode properties.runAccessReport wurde der v1alpha-Version der Admin API hinzugefügt. Sie gibt einen benutzerdefinierten Bericht zu Datenzugriffssätzen zurück. Der Bericht enthält Einträge für jede Lesevorgang von Google Analytics-Berichtsdaten. Berichte zum Datenzugriff sind für Administratoren von Google Analytics 360-Properties verfügbar.

11. Juli 2022: Veröffentlichung der Admin API-Version 1beta.

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

Sowohl Alpha- als auch Betakanäle der API werden für die Admin API weiterhin unterstützt. Der Beta-Kanal enthält einen Teil der Funktionen, die in Alpha verfügbar sind und als stabil gelten. Es wird nicht erwartet, dass sie sich in Zukunft wesentlich ändern 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 die erweiterten 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. 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.

2021-06-05 Neue Funktionen hinzugefügt.

Die API wird um die folgenden Funktionen erweitert:

  • Der API wurde die Methode accounts.searchChangeHistoryEvents hinzugefügt. Mit dieser Methode werden alle Änderungen an einem Konto oder seinen untergeordneten Konten anhand der angegebenen Filter durchsucht. Häufige Ursachen sind Aktualisierungen auf der Google Analytics-Benutzeroberfläche, Änderungen durch den Kundensupport oder automatische Google Analytics-Systemänderungen.
  • Unter properties.webDataStreams.measurementProtocolSecrets hinzugefügte Methoden zur Verwaltung von Measurement Protocol-Secrets:
    • create Erstellt ein Measurement Protocol-Secret.
    • delete Löscht das Secret für das Measurement Protocol des Ziels.
    • get Nach einem einzelnen Measurement Protocol-Secret suchen.
    • list Gibt die untergeordneten 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 Einzelnes Conversion-Ereignis abrufen.
    • list Liefert eine Liste der Conversion-Ereignisse in der angegebenen übergeordneten Property zurück.
  • Unter properties.customDimensions wurden Methoden zum Verwalten benutzerdefinierter Dimensionen hinzugefügt:
    • archive Archiviert eine benutzerdefinierte Dimension in einer Property.
    • create Erstellt eine benutzerdefinierte Dimension.
    • get Nach einer einzelnen benutzerdefinierten Dimension suchen.
    • list Listet benutzerdefinierte Dimensionen für eine Property auf.
    • patch Aktualisiert eine benutzerdefinierte Dimension in einer Property.
  • Unter properties.customMetrics hinzugefügte Methoden zur Verwaltung benutzerdefinierter Messwerte:
    • 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.
  • Es wurden Methoden für properties.getGoogleSignalsSettings und properties.updateGoogleSignalsSettings hinzugefügt, mit denen die Einstellung für 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.

2021-06-05 Funktionsgefährdende Änderungen.

Die folgenden Ä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 die gelöschten Property-Daten jetzt 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 vom Typ UserLink dient jetzt nur noch der Ausgabe.

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

2020-10-20 Unterstützung für Kontozusammenfassungen hinzugefügt.

Die Methode Kontozusammenfassungen wird jetzt unterstützt.

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

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

Die Google Analytics App + Web Management 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 geschrieben wurde, und Clientbibliotheken müssen entsprechend aktualisiert werden.