Änderungslog

Offizielle Ankündigungen zur Google Analytics API erhalten Sie, wenn Sie Google Analytics API Notify Group (Google Analytics API-Benachrichtigungsgruppe)

09.09.2024 Umfrageformular für den Zugriff auf Berichte

Die Dokumentation für die runAccessReport -Methode aktualisiert, um einen Link zum Feedback zu Google Analytics-Zugriffsberichten aus. Ihr Feedback ist uns wichtig und wir würden uns freuen, wenn Sie uns Ihre Meinung dazu mitteilen. API verwenden, um sie weiter zu verbessern.

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

Der Ressource BigQueryLink wurde das Feld dataset_location hinzugefügt.

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

01.08.2024 Funktionsgefährdende Änderung an der Methode createSubproperty

Die benutzerdefinierte Methode createSubproperty wurde umbenannt in provisionSubproperty in der Admin API v1alpha, um sie an der benutzerdefinierten Methode anzupassen .

01.08.2024: Verwaltung von Regeln für die Bearbeitung von Ereignissen hinzugefügt

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

Ein EventEditRule definiert Bedingungen, die das Erstellen eines vollständig neues Ereignis basierend auf übereinstimmenden Kriterien eines Quellereignisses. Außerdem kann ein EventEditRule Änderungen der Parameter aus der Quelle definieren .

01.08.2024 Verschiedene Änderungen

create_time hinzugefügt zu Ressource Audience.

primary hinzugefügt zu Ressource ChannelGroup für geben an, ob die Channelgruppe die Standard-Channelgruppe für Berichte ist. Nur eine Für die Channelgruppe kann „primary“ jederzeit auf „true“ festgelegt sein. Einstellung „primary“ für eine Channelgruppe auf „true“ legt „primary“ automatisch auf „false“ fest für die vorherige primäre Channelgruppe.

gmp_organization wurde zu Account hinzugefügt Ressource, die den URI für eine Google Marketing Platform-Organisation enthält Ressource, wenn das Konto mit einer GMP-Organisation verbunden ist.

06.05.2024: Methoden zur Verwaltung von Schlüsselereignissen hinzugefügt

Ressourcen und Methoden für wichtige Ereignisse sind jetzt verfügbar.

API-Integration für die Verwendung anpassen KeyEvent statt ConversionEvent ConversionEvent wurde verworfen.

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, und Google Analytics 360-Kunden.

Weitere Informationen finden Sie in der Dokumentation zum Schema.

15.12.2023 Die Dimension accessDateHour wurde dem Schema des Datenzugriffsberichts hinzugefügt.

Die Dimension accessDateHour wurde dem Schema des Datenzugriffs. Es enthält das Datum und die Stunde. des Analytics-Nutzers, der auf Google Analytics-Berichtsdaten zugegriffen hat.

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

Ab Mitte Oktober 2023 wird der erste Klick, linear Zeitverlauf und positionsbasiert Attributionsmodelle können nicht mehr mit UpdateAttributionSettings verwendet werden für alle Eigenschaften festlegen.

Wenn Ihre Property derzeit für die Verwendung eines dieser Modelle konfiguriert ist, wird er geändert zu kanalübergreifender datengetriebener Attribution. 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 wurden hinzugefügt.

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

Mit dieser Funktion lässt sich das SKAdNetwork-Conversion-Wert-Schema Konfiguration für einen iOS-Stream.

01.09.2023: Methode UpdateConversionEvent wurde hinzugefügt.

UpdateConversionEvent 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 umbenannt in fresh_daily_export_enabled

14.07.2023 Wichtige Änderungen an properties.updateAttributionSettings, properties.getAttributionSettings-Methoden.

Ab dem 24. Juli 2023 werden wichtige Änderungen an der Admin API Version 1 vorgenommen. Alpha, was sich auf die Funktionalität des properties.getAttributionSettings, properties.updateAttributionSettings .

Mitglieder von ReportingAttributionModel enum wird 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

Mitglieder von AdsWebConversionDataExportScope enum wird wie folgt 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 hinzugefügt: AttributionSettings-Typ, der mit dem UpdateAttributionSettings .

05.06.2023: Die Attributionsmodelle „Erster Klick“, „Linear“, „Zeitverlauf“ und „Positionsbasiert“ werden eingestellt.

Ab Juni 2023 sind die UpdateAttributionSettings kann nicht verwendet werden, um GA4-Properties mit Erster Klick linear Zeitverlauf und positionsbasiert Attributionsmodelle. Ab September 2023 werden diese Modelle nicht für alle Properties verfügbar.

Weitere Informationen finden Sie in der Google Analytics-Produktankündigung. .

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

Mit dieser Funktion lassen sich Verknüpfungen von AdSense mit Analytics verwalten. für eine GA4-Property.

31.05.2023: Es wurde eine Methode zum Nachschlagen einer verbundenen GA4-Property hinzugefügt.

Die FetchConnectedGa4Property Methode zur Admin API v1alpha hinzugefügt

Mit dieser Funktion können Sie Informationen Mit Ihrer Universal Analytics-Property verknüpfte GA4-Property während der GA4-Migration.

31.05.2023: Methode zum Verwalten von Regeln zur Ereigniserstellung wurde hinzugefügt.

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

Mit dieser Funktion können Sie Regeln für die Ereigniserstellung die die Erstellung eines völlig neuen Ereignisses eines Quellereignisses.

31.05.2023: Methoden zum Verwalten von benutzerdefinierten Channelgruppen hinzugefügt.

GetChannelGroup hinzugefügt, ListChannelGroups, CreateChannelGroup, UpdateChannelGroup, DeleteChannelGroup. für die Admin API v1alpha.

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

Nachdem benutzerdefinierte Channelgruppen erstellt wurden, können sie über die Funktion Google Analytics Data API Version 1:

31.03.2023: Verwaltungsmethoden für Einstellungen für optimierte Analysen wurden 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: Verwaltungsmethoden für verbundene Website-Tags wurden hinzugefügt.

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

Mit dieser Funktion lassen sich 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: Der Admin API v1beta wurden runAccessReport-Methoden auf Konto- und Property-Ebene hinzugefügt.

Die properties.runAccessReport und accounts.runAccessReport Methoden wurden zur v1beta-Version der Admin API hinzugefügt. Methoden geben eine zurück. benutzerdefinierter Bericht zu Datenzugriffsdatensätzen.

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

Die ExpandedDataSet Die Ressource wurde der v1alpha-Version der API zusammen mit dem entsprechenden properties.expandedDataSets.create hinzugefügt. properties.expandedDataSets.delete, properties.expandedDataSets.patch, properties.expandedDataSets.list, properties.expandedDataSets.get Geschäftsabläufe. Diese Funktion kann zur Verwaltung erweiterter Datensätze in Google Analytics 360 verwendet werden.

Die AccessBinding Ressource wurde der v1alpha-Version der API hinzugefügt, zusammen mit dem folgende Vorgänge:

Mit dieser Funktion können Sie Nutzerberechtigungen für ein GA4-Konto oder und sollten anstelle von Nutzerlinks verwendet werden.

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

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

Die folgenden Methoden wurden eingestellt und werden aus der Admin API Version 1 entfernt Alpha am 01.06.23:

24.02.2023: Methoden zur Zielgruppenverwaltung hinzugefügt.

Die Audience Die Ressource wurde der v1alpha-Version der API zusammen mit dem entsprechenden properties.audience.create hinzugefügt. properties.audience.archive, properties.audience.patch, properties.audience.list, properties.audience.get Geschäftsabläufe.

Mit dieser Funktion lassen sich Zielgruppen für eine GA4-Property verwalten.

15.02.2023: Methoden zum automatischen Deaktivieren von GA4 wurden hinzugefügt.

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

Mit dieser Funktion lässt sich der Deaktivierungsstatus für die automatische GA4-Property verwalten. Einrichtung für eine UA-Property.

Die BigQueryLink Ressource wurde der v1alpha-Version der API hinzugefügt, zusammen mit dem für properties.bigQueryLinks.get, properties.bigQueryLinks.list Geschäftsabläufe.

Diese Funktion ermöglicht das Abrufen von Informationen Verknüpfungen zwischen einer GA4-Property und einem BigQuery-Projekt.

Die SearchAds360Link Die Ressource wurde der v1alpha-Version der API zusammen mit dem entsprechenden properties.searchAds360Links.create hinzugefügt. properties.searchAds360Links.delete, properties.searchAds360Links.patch, properties.searchAds360Links.list, properties.searchAds360Links.get Geschäftsabläufe.

Mit dieser Funktion lassen sich Verknüpfungen zwischen einer GA4-Property und eine Search Ads 360-Entität.

15.02.2023 Wichtige Änderungen.

15.02.2023 Sonstige Änderungen.

11.08.2022 Die Methode runAccessReport wurde der Admin API v1alpha hinzugefügt.

Die properties.runAccessReport der v1alpha-Version der Admin API hinzugefügt. Es wird ein einen benutzerdefinierten Bericht über Datenzugriffsdatensätze. Der Bericht enthält Aufzeichnungen zu jedem Ein Nutzer liest Google Analytics-Berichtsdaten. Datenzugriffsberichte sind Administratoren von Google Analytics 360-Properties verfügbar.

11.07.2022: Betaversion der Admin API v1 wurde veröffentlicht.

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

Administratoren können sowohl die Alpha- als auch die Betaversion der API weiterhin verwenden. der API erstellen. Die Betaversion umfasst einen Teil der in der Alphaversion verfügbaren Funktionen, die als stabil gelten und keine wesentliche Änderung der in der Zukunft. Neue Funktionen werden der Betaversion hinzugefügt, sobald sie verfügbar sind.

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

  • properties.webDataStreams.getEnhancedMeasurementSettings, properties.webDataStreams.updateEnhancedMeasurementSettings-Methoden sind aus der API entfernt, aber für optimierte Analysen -Einstellungen können bald wieder über die API geändert werden.
  • Das Feld directRoles von UserLink Ressource unterstützt nicht mehr die Rolle predefinedRoles/manage-users. Stattdessen sollte die neue Rolle predefinedRoles/admin verwendet werden, die entspricht der Kombination aus alten Werten für predefinedRoles/edit und predefinedRoles/manage-users-Rollen. Diese Änderung wirkt sich auf das Verhalten accounts.userLinks, properties.userLinks und entspricht der 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:

  • accounts.searchChangeHistoryEvents wurde der API hinzugefügt. Bei dieser Methode werden alle Änderungen an einem Konto oder dessen untergeordnete Elemente mit dem festgelegten Satz von Filtern. Häufige Ursachen wären Aktualisierungen in der Google Analytics-Benutzeroberfläche, Änderungen oder automatische Google Analytics-Systemänderungen.
  • Verwaltungsmethoden für Measurement Protocol-Secrets hinzugefügt unter properties.webDataStreams.measurementProtocolSecrets:
    • create Erstellt ein Measurement Protocol-Secret.
    • delete Löscht das Ziel-Measurement Protocol-Secret.
    • 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 hinzugefügte Verwaltungsmethoden für Conversion-Ereignisse:
    • create Erstellt ein Conversion-Ereignis mit den angegebenen Attributen.
    • delete Löscht ein Conversion-Ereignis in einer Property.
    • get Einzelnes Conversion-Ereignis abrufen
    • list Gibt eine Liste der Conversion-Ereignisse in der angegebenen übergeordneten Property zurück.
  • Verwaltungsmethoden für benutzerdefinierte Dimensionen, die unter properties.customDimensions hinzugefügt wurden:
    • archive Archiviert eine benutzerdefinierte Dimension für eine Property.
    • create Erstellt eine benutzerdefinierte Dimension.
    • get Suche nach einer einzelnen benutzerdefinierten Dimension.
    • list Listet die benutzerdefinierten Dimensionen für eine Property auf.
    • patch Aktualisiert eine benutzerdefinierte Dimension für eine Property.
  • Benutzerdefinierte Methoden zur Messwertverwaltung hinzugefügt unter properties.customMetrics:
    • archive Archiviert einen benutzerdefinierten Messwert in einer Property.
    • create einen benutzerdefinierten Messwert.
    • 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.
  • properties.getGoogleSignalsSettings hinzugefügt, properties.updateGoogleSignalsSettings Methoden, mit denen die Google-Signale gesteuert werden können für eine Google Analytics 4-Property.
  • delete_time, expire_time Der Property wurden reine Ausgabefelder hinzugefügt. Typ.

05.06.2021 Funktionsgefährdende Änderungen.

Die folgenden funktionsgefährdenden Änderungen wurden eingeführt:

  • properties.iosAppDataStreams.create, properties.androidAppDataStreams.create aus der API entfernt wurden. Verwenden Sie Firebase, um die Anwendung zu erstellen in einer Google Analytics 4-Property.
  • properties.delete gibt die gelöschten Property-Daten jetzt als Property zurück. anstatt eine leere Antwort zurückzugeben.
  • time_zone von Property ist nun erforderlich.
  • Feld „deleted“ aus Property entfernt Typ.
  • email_address von UserLink -Typ ist jetzt unveränderlich.
  • name von UserLink -Typ ist jetzt nur noch für die Ausgabe verfügbar.

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

  • parent Feld aus „GoogleAdsLink“ entfernt.

20.10.2020: Unterstützung für Kontozusammenfassungen hinzugefügt.

Die Methode für die Kontozusammenfassung wird jetzt unterstützt.

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

15.08.2020: Die Management App + Web API wurde in Admin API umbenannt.

Die Google Analytics Management App + Web API wurde in Google Analytics Admin API. Daher wurde der API-Endpunkt in analyticsadmin.googleapis.com. Vorhandener Code, der für die vorherige Version geschrieben wurde der API-Endpunkt-URL und der Clientbibliotheken müssen entsprechend aktualisiert werden.