Überarbeitungsverlauf

Auf dieser Seite werden API-Änderungen und Dokumentationsaktualisierungen für die YouTube Reporting API und die YouTube Analytics API aufgeführt. Beide APIs ermöglichen Entwicklern den Zugriff auf YouTube Analytics-Daten, allerdings auf unterschiedliche Weise. Diesen Changelog abonnieren Abonnieren

22. September 2025

Die zuvor angekündigte Einstellung von Berichten wurde vom 30. September 2025 auf den 31. Oktober 2025 verschoben. Bisherige Versionen von Berichten, die aufgrund von Änderungen bei den Aufrufen von Shorts aktualisiert wurden, sind bis dahin weiterhin verfügbar. Ausgenommen sind der Anspruchsbericht 1.0 (content_owner_active_claims_a1) und der Anspruchsbericht 1.1 (content_owner_active_claims_a2), die weiterhin am 30. September eingestellt werden.

24. Juni 2025

Wie am 26. März 2025 angekündigt, wird die Bulk Reports API im Rahmen der neuen Änderung der Aufrufzahlen für Shorts aktualisiert. Die folgenden Änderungen wurden vorgenommen:

  • Für jeden Bericht, der Aufrufe enthält, wurde eine neue Version erstellt. Das betrifft die meisten Berichte. Die Version jedes betroffenen Berichts wurde um eins erhöht, z. B. von Version a2 zu Version a3.
  • Bei Shorts entspricht die Anzahl der Aufrufe jetzt der Anzahl der Wiedergaben oder wiederholten Wiedergaben. Bei Videos ändert sich nichts.
  • Aktualisierte Berichte enthalten eine neue Spalte, engaged_views, in der die bisherige Zählweise für Aufrufe berücksichtigt wird.

Diese Änderungen treten am 30. Juni 2025 für die Bulk Reports API in Kraft. Passen Sie die Verarbeitung Ihrer Berichte entsprechend an.

Vorherige Versionen des Berichts sind bis zum 30. September 2025 verfügbar. Nach dem 30. September 2025 werden die vorherigen Versionen verworfen. Migrieren Sie unbedingt zu den neuesten Versionen.

Achten Sie schließlich darauf, die Best Practices bei der Verarbeitung der Berichte zu befolgen, damit zukünftige Änderungen an Berichten Ihre Verarbeitungspipelines nicht beeinträchtigen.

In den folgenden Tabellen sind die neuen Berichtsversionen für jeden Berichtstyp aufgeführt:

YouTube Analytics-Berichte mit Massendaten

Kanalberichte – Videoberichte
Berichtsname Vorherige Version Aktuelle Version
Nutzeraktivität channel_basic_a2 channel_basic_a3
Nutzeraktivität nach Bundesland channel_province_a2 channel_province_a3
Wiedergabeorte channel_playback_location_a2 channel_playback_location_a3
Zugriffsquellen channel_traffic_source_a2 channel_traffic_source_a3
Gerätetyp und Betriebssystem channel_device_os_a2 channel_device_os_a3
Untertitel channel_subtitles_a2 channel_subtitles_a3
Kombiniert channel_combined_a2 channel_combined_a3
Kanalberichte – Playlist-Berichte
Berichtsname Vorherige Version Aktuelle Version
Nutzeraktivität playlist_basic_a1 playlist_basic_a2
Nutzeraktivität nach Bundesland playlist_province_a1 playlist_province_a2
Wiedergabeorte playlist_playback_location_a1 playlist_playback_location_a2
Zugriffsquellen playlist_traffic_source_a1 playlist_traffic_source_a2
Gerätetyp und Betriebssystem playlist_device_os_a1 playlist_device_os_a2
Kombiniert playlist_combined_a1 playlist_combined_a2
Rechteinhaberberichte – Videoberichte
Berichtsname Vorherige Version Aktuelle Version
Nutzeraktivität content_owner_basic_a3 content_owner_basic_a4
Nutzeraktivität nach Bundesland content_owner_province_a2 content_owner_province_a3
Wiedergabeorte content_owner_playback_location_a2 content_owner_playback_location_a3
Zugriffsquellen content_owner_traffic_source_a2 content_owner_traffic_source_a3
Gerätetyp und Betriebssystem content_owner_device_os_a2 content_owner_device_os_a3
Untertitel content_owner_subtitles_a2 content_owner_subtitles_a3
Kombiniert content_owner_combined_a2 content_owner_combined_a3
Rechteinhaberberichte – Playlist-Berichte
Berichtsname Vorherige Version Aktuelle Version
Nutzeraktivität content_owner_playlist_basic_a1 content_owner_playlist_basic_a2
Nutzeraktivität nach Bundesland content_owner_playlist_province_a1 content_owner_playlist_province_a2
Wiedergabeorte content_owner_playlist_playback_location_a1 content_owner_playlist_playback_location_a2
Zugriffsquellen content_owner_playlist_traffic_source_a1 content_owner_playlist_traffic_source_a2
Gerätetyp und Betriebssystem content_owner_playlist_device_os_a1 content_owner_playlist_device_os_a2
Kombiniert content_owner_playlist_combined_a1 content_owner_playlist_combined_a2
Rechteinhaberberichte – Asset-Berichte
Berichtsname Vorherige Version Aktuelle Version
Nutzeraktivität content_owner_asset_basic_a2 content_owner_asset_basic_a3
Nutzeraktivität nach Bundesland content_owner_asset_province_a2 content_owner_asset_province_a3
Videowiedergabeorte content_owner_asset_playback_location_a2 content_owner_asset_playback_location_a3
Zugriffsquellen content_owner_asset_traffic_source_a2 content_owner_asset_traffic_source_a3
Gerätetyp und Betriebssystem content_owner_asset_device_os_a2 content_owner_asset_device_os_a3
Kombiniert content_owner_asset_combined_a2 content_owner_asset_combined_a3

Vom System verwaltete Berichte – Finanzen (nicht Musik)

Rechteinhaberberichte – Shorts Reports (Non-Music)
Berichtsname Vorherige Version Aktuelle Version
Zusammenfassung der weltweiten Werbeeinnahmen content_owner_shorts_global_ad_revenue_summary_a1 content_owner_shorts_global_ad_revenue_summary_a2
Tägliche Zusammenfassung der Werbeeinnahmen content_owner_shorts_day_ad_revenue_summary_a1 content_owner_shorts_day_ad_revenue_summary_a2
Zusammenfassung der Werbeeinnahmen nach Land content_owner_shorts_country_ad_revenue_summary_a1 content_owner_shorts_country_ad_revenue_summary_a2
Zusammenfassung der Werbeeinnahmen content_owner_shorts_ad_revenue_summary_a1 content_owner_shorts_ad_revenue_summary_a2

Vom System verwaltete Berichte – Nicht finanziell

Rechteinhaberberichte – Anspruchsberichte
Berichtsname Vorherige Version Aktuelle Version
Aktive Ansprüche content_owner_active_claims_a2 content_owner_active_claims_a3
Rechteinhaberberichte – Berichte zu Videometadaten
Berichtsname Vorherige Version Aktuelle Version
Videometadaten content_owner_video_metadata_a3 content_owner_video_metadata_a4
Rechteinhaberberichte – Asset-Berichte
Berichtsname Vorherige Version Aktuelle Version
Assets content_owner_asset_a2 content_owner_asset_a3
Asset-Konflikte content_owner_asset_conflict_a2 content_owner_asset_conflict_a3

24. April 2025

Wie am 26. März 2025 angekündigt, wird die Targeted Queries API im Rahmen der neuen Änderung bei der Zählweise von Shorts-Aufrufen aktualisiert:

  • Bei Shorts entspricht views jetzt der Anzahl der Wiedergaben oder wiederholten Wiedergaben eines Shorts.
  • Der neue Messwert engagedViews entspricht der bisherigen Zählweise für Aufrufe. engagedViews wird zusammen mit views in allen Berichten verfügbar sein.

Diese Änderungen treten am 30. April 2025 für die Targeted Queries API in Kraft. Passen Sie Ihre Anfragen entsprechend an.

In diesem Überarbeitungsverlauf erfahren Sie, welche Änderungen an der Bulk Reports API vorgenommen werden und wann.

22. April 2025

Wie am 7. April 2024 angekündigt, wurde die Dimension isCurated für Kanalberichte und Berichte zu Playlists von Rechteinhabern eingestellt. Ab dem 31. Dezember 2024 wird die Dimension nicht mehr unterstützt. Die Dimension wurde aus Berichten und aus der Dokumentation entfernt.

26. März 2025

Dieses Update enthält die folgende Änderung in Bezug auf die YouTube Analytics und Reporting APIs:

Ab dem 31. März 2025 ändert sich die Art und Weise, wie YouTube Shorts-Aufrufe zählt. Bisher wurde auf YouTube ein Aufruf erst erfasst, wenn ein Short eine bestimmte Zeit lang abgespielt wurde. Die Anzahl der Aufrufe entspricht jetzt der Anzahl der Wiedergaben oder wiederholten Wiedergaben eines Shorts. Die Wiedergabezeit ist dabei unerheblich. Weitere Informationen

Die YouTube Analytics API (gezielte Abfragen) und die YouTube Reporting API (Bulk-Berichte) werden mit den folgenden Änderungen aktualisiert:

  • Bei Shorts wird mit views die Anzahl der Wiedergaben oder wiederholten Wiedergaben eines Shorts gezählt.
  • Ein neuer Messwert, engagedViews, wird verfügbar gemacht und spiegelt die bisherige Methode zur Zählung von Aufrufen wider.
  • Wenn du Inhaber eines Kanals bist oder berechtigt bist, auf Daten für einen Kanal zuzugreifen, kannst du sowohl die aktualisierten Aufrufe als auch die Aufrufe mit Interaktionen abfragen.

Gezielte Anfragen werden bis zum 30. April und Bulk-Berichte bis zum 30. Juni aktualisiert. Bis dahin werden Aufrufe nach der alten Methode gezählt. Die Aufrufe von Shorts und Kanalaufrufe stimmen nicht mit den Analytics-Daten in Studio überein.

Außerdem wurde die bereits angekündigte Einstellung des Berichts „Tägliche Ansprüche“ (Version 1.0) verschoben.

In diesem Überarbeitungsverlauf erfahren Sie, wann Änderungen an den APIs vorgenommen werden.

3. März 2025

Dieses Update enthält die folgende Änderung in Bezug auf die YouTube Reporting API:

Hinweis:Dies ist eine Einstellungsbenachrichtigung.

Der Bericht Tägliche Ansprüche (Version 1.0) wurde für Partner eingestellt. Ab dem 30. April 2025 wird sie nicht mehr unterstützt. Die Definition dieses Berichts wurde entsprechend aktualisiert. Verwende stattdessen den aktuellen Tagesbericht zu Ansprüchen.

15. November 2024

Hinweis:Die folgende Änderung gilt ab dem 18. November 2024.

Die Dokumentation zur YouTube Analytics API (Targeted Queries) wurde aktualisiert. Für Berichte zur Traffic-Quelle gibt die reports.query-Methode der API jetzt einen Fehler zurück, wenn das Produkt aus Anzahl der abgefragten Videos × Anzahl der Tage im Zeitraum 50.000 überschreitet. Bei einer Abfrage, mit der Daten für 500 Video-IDs abgerufen werden, können beispielsweise Daten für maximal 100 Tage angefordert werden.

Diese Änderung betrifft Berichte für Kanäle und Rechteinhaber.

Wenn Sie die Anzahl der Zeilen, die von einer Anfrage zurückgegeben werden, reduzieren möchten, teilen Sie Ihre Abfrage in mehrere Abfragen auf, in denen weniger Videos angegeben sind oder kürzere Zeiträume festgelegt werden. In der Regel werden Bulk-Berichte für große Datasets empfohlen.

6. Mai 2024

Die YouTube Analytics API (Targeted Queries) unterstützt drei neue Berichte für Kanäle:

Außerdem wurde der Bericht Zuschauerbindung um drei neue Messwerte erweitert:

7. April 2024

Die YouTube Analytics API (Targeted Queries) wurde in Bezug auf Berichte zu Playlists von Rechteinhabern aktualisiert. Die Änderungen sind dieselben wie bei den Berichten zu Kanal-Playlists, die am 19. Januar 2024 angekündigt wurden.

Der folgende Revisionsverlaufseintrag enthält fast dieselben Informationen wie der Eintrag vom 19. Januar 2024. Hinweis: In den Playlist-Berichten für Rechteinhaber wird die Dimension isCurated bis zum 31. Dezember 2024 unterstützt. In den Playlist-Berichten für Kanäle wird sie bis zum 30. Juni 2024 unterstützt.

  • Hinweis:Dies ist eine Einstellungsbenachrichtigung.

    Die Dimension isCurated wurde für Berichte zu Playlists von Rechteinhabern eingestellt. Ab dem 31. Dezember 2024 wird sie nicht mehr unterstützt. Die Definition dieser Dimension wurde entsprechend aktualisiert.

    Um die Abwärtskompatibilität beizubehalten, wenn Sie die Dimension isCurated entfernen, müssen Sie auch Ihren Code aktualisieren, damit nur für Playlist-Berichte der Messwert playlistViews anstelle des Messwerts views abgerufen wird. Da der Messwert views weiterhin für Playlist-Berichte unterstützt wird, wenn auch mit einer anderen Bedeutung, werden von der API weiterhin Daten zurückgegeben, wenn Sie den Messwertnamen nicht aktualisieren. Sie können Ihre Anwendung natürlich so ändern, dass sowohl views als auch playlistViews abgerufen und angezeigt werden.

    Zusätzlich zur Dimension isCurated wird die folgende API-Funktionalität in den neuen Berichten nicht mehr unterstützt:

    • Standortfilter wie continent und subcontinent werden für die neuen Berichte zu Kanal-Playlists nicht unterstützt.
    • Die Messwerte redViews und estimatedRedMinutesWatched werden für die neuen Berichte zu Kanal-Playlists nicht mehr unterstützt. Diese Messwerte waren in YouTube Studio nicht verfügbar. Durch diese Änderung wird die API-Funktionalität an die Funktionalität der Studio-Anwendung angeglichen.
    • Die Dimensionen subscribedStatus und youtubeProduct werden nicht mehr als Filter für Berichte zu Kanal-Playlists unterstützt. Diese Filter waren in YouTube Studio nicht verfügbar. Durch diese Änderung wird die API-Funktionalität an die in der Studio-Anwendung verfügbare Funktionalität angepasst.

  • Der Abschnitt Wiedergabelistenberichte in der Dokumentation zu Berichten für Rechteinhaber wurde aktualisiert. Dort werden die Arten von Messwerten, die für Wiedergabelistenberichte unterstützt werden, genauer erläutert:

    • Zusammengefasste Videomesswerte enthalten Messwerte zu Nutzeraktivitäten und Impressionen, die für alle Videos in den Playlists des Rechteinhabers zusammengefasst werden, die ebenfalls dem Rechteinhaber gehören. Aggregierte Videomesswerte werden nur für API-Anfragen unterstützt, in denen die Dimension isCurated nicht verwendet wird.
    • Messwerte für Playlists geben die Nutzeraktivität und das Engagement im Kontext der Playlist-Seite wieder. Diese Messwerte enthalten auch Daten zu Aufrufen von Videos, die nicht dir gehören, aber nur, wenn diese Aufrufe im Kontext der Playlist erfolgten.
    • Im Abschnitt Unterstützte Playlist-Messwerte finden Sie die aggregierten Videomesswerte und Messwerte für Playlists, die für Playlist-Berichte unterstützt werden.

  • Die folgenden neuen In-Playlist-Messwerte werden für Playlistberichte für Rechteinhaber unterstützt. Diese Messwerte werden nur unterstützt, wenn in der API-Anfrage zum Abrufen der Berichte die Dimension isCurated nicht verwendet wird. Definitionen der einzelnen Messwerte finden Sie in der Dokumentation zu Messwerten:

  • Das Verhalten des Messwerts views hängt jetzt davon ab, ob für die API-Anfrage, mit der der Playlist-Bericht abgerufen wurde, die Dimension isCurated verwendet wurde:

    • Wenn eine Anfrage die Dimension isCurated enthält, ist der Messwert views ein Messwert für die Wiedergabe in Playlists. Er gibt an, wie oft Videos im Kontext der Playlists des Rechteinhabers angesehen wurden.
    • Wenn eine Anfrage die Dimension isCurated nicht enthält, ist der Messwert views ein aggregierter Videomesswert, der die Gesamtzahl der Aufrufe von Videos in den Playlists des Rechteinhabers angibt. Dabei spielt es keine Rolle, ob die Aufrufe im Kontext der Playlist erfolgten. Die aggregierte Gesamtzahl umfasst nur Aufrufe von Videos, die dem Rechteinhaber gehören, der mit dem Kanal verknüpft ist, dem die Playlist gehört.

      In diesen Berichten, in denen die Dimension isCurated nicht verwendet wird, gibt der Messwert playlistViews an, wie oft Videos im Kontext der Playlist aufgerufen wurden. Dieser Messwert umfasst Aufrufe aller Videos in der Playlist, unabhängig davon, welchem Kanal sie gehören.

  • Die Dokumentation zu Berichten für Rechteinhaber enthält jetzt für jeden Playlist-Bericht Tabellen mit den unterstützten Messwerten für diesen Bericht. Die Messwerte sind davon abhängig, ob die API-Anfrage die Dimension isCurated enthält. Ein Beispiel finden Sie im Abschnitt zur Definition von zeitbasierten Playlist-Berichten.

19. Januar 2024

Die YouTube Analytics API (Targeted Queries) wurde in Bezug auf Berichte zu Kanal-Playlists aktualisiert. Die Änderungen umfassen eine nicht mehr unterstützte Dimension sowie mehrere neue und aktualisierte Messwerte:

  • Hinweis:Dies ist eine Einstellungsbenachrichtigung.

    Die Dimension isCurated wurde für Channelberichte eingestellt. Ab dem 30. Juni 2024 wird sie nicht mehr unterstützt. Die Definition dieser Dimension wurde entsprechend aktualisiert.

    Um die Abwärtskompatibilität beizubehalten, wenn Sie die Dimension isCurated entfernen, müssen Sie auch Ihren Code aktualisieren, damit nur für Playlist-Berichte der Messwert playlistViews anstelle des Messwerts views abgerufen wird. Da der Messwert views weiterhin für Playlist-Berichte unterstützt wird, wenn auch mit einer anderen Bedeutung, werden von der API weiterhin Daten zurückgegeben, wenn Sie den Messwertnamen nicht aktualisieren. Sie können Ihre Anwendung natürlich so ändern, dass sowohl views als auch playlistViews abgerufen und angezeigt werden.

    Zusätzlich zur Dimension isCurated wird die folgende API-Funktionalität in den neuen Berichten nicht mehr unterstützt:

    • Standortfilter wie continent und subcontinent werden für die neuen Berichte zu Kanal-Playlists nicht unterstützt.
    • Die Messwerte redViews und estimatedRedMinutesWatched werden für die neuen Berichte zu Kanal-Playlists nicht mehr unterstützt. Diese Messwerte waren in YouTube Studio nicht verfügbar. Durch diese Änderung wird die API-Funktionalität an die Funktionalität der Studio-Anwendung angeglichen.
    • Die Dimensionen subscribedStatus und youtubeProduct werden nicht mehr als Filter für Berichte zu Kanal-Playlists unterstützt. Diese Filter waren in YouTube Studio nicht verfügbar. Durch diese Änderung wird die API-Funktionalität an die in der Studio-Anwendung verfügbare Funktionalität angepasst.

  • Der Abschnitt Wiedergabelistenberichte in der Dokumentation zu Kanalberichten wurde aktualisiert. Dort werden die Arten von Messwerten, die für Wiedergabelistenberichte unterstützt werden, genauer erläutert:

    • Zusammengefasste Videomesswerte enthalten Messwerte zur Nutzeraktivität und zu Impressionen, die für alle Videos in den Playlists des Kanals zusammengefasst werden, die auch dem Kanal gehören. Aggregierte Videomesswerte werden nur für API-Anfragen unterstützt, in denen die Dimension isCurated nicht verwendet wird.
    • Messwerte für Playlists geben die Nutzeraktivität und das Engagement im Kontext der Playlist-Seite wieder. Diese Messwerte enthalten auch Daten zu Aufrufen von Videos, die nicht dir gehören, aber nur, wenn diese Aufrufe im Kontext der Playlist erfolgten.
    • Im Abschnitt Unterstützte Playlist-Messwerte finden Sie die aggregierten Videomesswerte und Messwerte für Playlists, die für Playlist-Berichte unterstützt werden.

  • Die folgenden neuen In-Playlist-Messwerte werden für Playlist-Berichte für Kanäle unterstützt. Diese Messwerte werden für Berichte für Rechteinhaber noch nicht unterstützt. Diese Messwerte werden nur unterstützt, wenn in der API-Anfrage zum Abrufen der Berichte nicht die Dimension isCurated verwendet wird. Definitionen der einzelnen Messwerte finden Sie in der Dokumentation zu Messwerten:

  • Das Verhalten des Messwerts views hängt jetzt davon ab, ob für die API-Anfrage, mit der der Playlist-Bericht abgerufen wurde, die Dimension isCurated verwendet wurde:

    • Wenn eine Anfrage die Dimension isCurated enthält, ist der Messwert views ein In-Playlist-Messwert, der angibt, wie oft Videos im Kontext der Playlists des Kanals angesehen wurden.
    • Wenn eine Anfrage die Dimension isCurated nicht enthält, ist der Messwert views ein aggregierter Videomesswert, der die Gesamtzahl der Aufrufe dieses Videos in den Playlists des Kanals angibt, unabhängig davon, ob diese Aufrufe im Playlist-Kontext erfolgt sind. Die aggregierte Gesamtzahl umfasst nur Aufrufe von Videos, die dem Kanal gehören, dem auch die Playlist gehört.

      In diesen Berichten, in denen die Dimension isCurated nicht verwendet wird, gibt der Messwert playlistViews an, wie oft Videos im Kontext der Playlist aufgerufen wurden. Dieser Messwert umfasst Aufrufe aller Videos in der Playlist, unabhängig davon, welchem Kanal sie gehören.

  • Die Dokumentation zu Channelberichten enthält jetzt für jeden Playlistbericht Tabellen mit den unterstützten Messwerten für diesen Bericht. Dabei wird berücksichtigt, ob die Dimension isCurated in der API-Anfrage enthalten ist. Ein Beispiel finden Sie im Abschnitt zur Definition von zeitbasierten Playlist-Berichten.

4. Dezember 2023

Die YouTube Analytics API (Targeted Queries) wurde aktualisiert, um zwei insightTrafficSourceType-Dimensionswerte zusammenzuführen. Bisher wurde bei der Dimension zwischen Videos, die als Teil einer Playlist wiedergegeben wurden (PLAYLIST), und Aufrufen unterschieden, die von einer Seite stammten, auf der alle Videos in einer Playlist aufgeführt sind (YT_PLAYLIST_PAGE). Künftig werden beide Arten von Aufrufen dem Dimensionswert PLAYLIST zugeordnet.

15. Dezember 2022

Die YouTube Analytics API (Targeted Queries) unterstützt zwei neue Dimensionen und einen neuen Bericht:

  • Ein neuer Bericht enthält Nutzeraktivitäten nach Stadt. Dieser Bericht ist für Kanäle und Rechteinhaber verfügbar. Dieser Bericht enthält die neue Dimension city, mit der die Stadt angegeben wird, in der die Nutzeraktivität stattgefunden hat (Schätzung von YouTube).

  • Mit der neuen Dimension creatorContentType wird der Typ von YouTube-Inhalten angegeben, der mit den Messwerten für Nutzeraktivitäten in der Datenzeile verknüpft ist. Unterstützte Werte sind LIVE_STREAM, SHORTS, STORY und VIDEO_ON_DEMAND.

    Die Dimension creatorContentType wird als optionale Dimension für alle Videoberichte für Kanäle und Rechteinhaber unterstützt.

  • Die Beispielanfragen für die YouTube Analytics API enthalten jetzt Beispiele für beide neuen Dimensionen.

  • Verweise auf die Dimensionen 7DayTotals und 30DayTotals wurden aus der Dokumentation entfernt. Die Einstellung dieser Dimensionen wurde im Oktober 2019 angekündigt.

26. August 2022

Die YouTube Analytics API (gezielte Abfragen) und die YouTube Reporting API (Bulk-Berichte) unterstützen beide einen neuen Detailwert für die Zugriffsquelle:

  • Wenn in der YouTube Analytics API (Targeted Queries) API der Wert der Dimension insightTrafficSourceType SUBSCRIBER ist, kann der Wert insightTrafficSourceDetail auf podcasts gesetzt werden. Das bedeutet, dass der Traffic von der Zielseite für Podcasts stammt.
  • Wenn der Wert der Dimension traffic_source_type in der YouTube Reporting (Bulk Reports) API 3 ist, kann der Wert traffic_source_detail auf podcasts gesetzt werden. Das bedeutet, dass der Traffic von der Zielseite für Podcasts stammt.

11. Februar 2022

Die Menge der gültigen Werte für die Dimension gender ändert sich am oder nach dem 11. August 2022. Dies kann eine nicht abwärtskompatible Änderung in Ihrer API-Implementierung sein. Gemäß dem Abschnitt Abwärtsinkompatible Änderungen der Nutzungsbedingungen für YouTube-API-Dienste wird diese Änderung sechs Monate vor ihrem Inkrafttreten angekündigt. Bitte aktualisieren Sie Ihre API-Implementierung vor dem 11. August 2022, um einen reibungslosen Übergang zu den neuen Werten zu gewährleisten.

Die spezifischen Änderungen sind:

  • In der YouTube Analytics API (Targeted Queries) unterstützt die Dimension gender derzeit zwei Werte: female und male. Ab dem 11. August 2022 unterstützt diese Dimension drei Werte: female, male und user_specified.
  • In der YouTube Reporting API (Bulk Reports) unterstützt die Dimension gender derzeit drei Werte: FEMALE, MALE und GENDER_OTHER. Am oder nach dem 11. August 2022 ändert sich die Menge der unterstützten Werte zu FEMALE, MALE und USER_SPECIFIED.

9. Februar 2022

Zwei Messwerte wurden aktualisiert, um Traffic von Clips mit Schleifen ab dem 13. Dezember 2021 auszuschließen. Diese Änderung betrifft sowohl die YouTube Analytics API (gezielte Abfragen) als auch die YouTube Reporting API (Bulk-Berichte).

2. Februar 2022

Die YouTube Reporting API (Bulk Reports) unterstützt einen neuen Wert für die Dimension „Trafficquelle“, der angibt, dass die Aufrufe von Live-Weiterleitungen stammen:

  • In der YouTube Reporting API (Bulk Reports) unterstützt die Dimension traffic_source_type den Wert 28.

Bei diesem Traffic-Quellentyp gibt die Dimension traffic_source_detail die Kanal-ID an, von der der Zuschauer weitergeleitet wurde.

23. September 2020

Die YouTube Analytics API (Targeted Queries) und die YouTube Reporting API (Bulk Reports) unterstützen beide einen neuen Wert für die Dimension „Zugriffsquelle“, der angibt, dass der Zuschauer durch vertikales Wischen in der YouTube Shorts-Wiedergabe auf das Video aufmerksam wurde:

  • In der YouTube Analytics API (Targeted Queries) wird für die Dimension insightTrafficSourceType der Wert SHORTS unterstützt.
  • In der YouTube Reporting API (Bulk Reports) unterstützt die Dimension traffic_source_type den Wert 24.

Die Detaildimension für die Zugriffsquelle – insightTrafficSourceDetail in der YouTube Analytics API oder traffic_source_detail in der YouTube Reporting API – wird für diesen neuen Zugriffsquellentyp nicht ausgefüllt.

20. Juli 2020

Dieses Update umfasst zwei Änderungen, die sich auf die YouTube Analytics API (Targeted Queries) auswirken:

  • Die maximale Größe einer YouTube Analytics-Berichtsgruppe wurde von 200 auf 500 Einheiten erhöht.
  • Der Parameter filters der Methode reports.query gibt eine Liste von Filtern an, die beim Abrufen von YouTube Analytics-Daten angewendet werden sollen. Der Parameter unterstützt die Angabe mehrerer Werte für die Filter video, playlist und channel. Die maximale Anzahl von IDs, die für diese Filter angegeben werden können, wurde von 200 auf 500 IDs erhöht.

13. Februar 2020

Dieses Update enthält die folgenden Änderungen in Bezug auf die YouTube Analytics API (Targeted Queries) und die YouTube Reporting API (Bulk Reports). Weitere Informationen zu diesen Änderungen findest du in der YouTube-Hilfe.

In beiden APIs ändert sich die Menge der möglichen Detailwerte für Traffic-Quellen für Benachrichtigungen. In gezielten Anfragen werden Benachrichtigungen als insightTrafficSourceType=NOTIFICATION gemeldet. In Bulk-Berichten werden Benachrichtigungen als traffic_source_type=17 gemeldet.

Die neuen Werte unterteilen Benachrichtigungen zu hochgeladenen Videos und Livestreams, die zuvor als uploaded gemeldet wurden, in zwei Kategorien:

  • uploaded_push – Aufrufe, die durch Push-Benachrichtigungen generiert wurden, die an Abonnenten gesendet wurden, als ein Video hochgeladen wurde
  • uploaded_other: Aufrufe, die nicht über Push-Benachrichtigungen generiert wurden, z. B. über E‑Mail- oder Posteingangsbenachrichtigungen, die an Abonnenten gesendet wurden, als ein Video hochgeladen wurde.

Diese Werte werden für den Zeitraum ab dem 13.01.2020 zurückgegeben.

Außerdem möchten wir dich noch einmal daran erinnern, dass diese Werte nicht die Benachrichtigungen selbst darstellen, sondern die Zugriffsquellen, die zu bestimmten YouTube-Aufrufen geführt haben. Wenn in einer Berichtszeile beispielsweise views=3, traffic_source_type=17 (NOTIFICATION) und traffic_source_detail=uploaded_push angegeben sind, bedeutet das, dass drei Aufrufe durch Zuschauer erzielt wurden, die auf Push-Benachrichtigungen geklickt haben, die beim Hochladen des Videos gesendet wurden.

15. Oktober 2019

Dieses Update enthält die folgenden Änderungen in Bezug auf die YouTube Analytics API (Targeted Queries):

  • Hinweis:Dies ist eine Einstellungsbenachrichtigung.

    YouTube entfernt die Unterstützung für die Dimensionen 7DayTotals und 30DayTotals. Bis zum 15. April 2020 können Sie weiterhin Daten mit diesen Dimensionen abrufen. Ab diesem Datum wird bei Versuchen, Berichte mit der Dimension 7DayTotals oder 30DayTotals abzurufen, ein Fehler zurückgegeben.

    Nutzer können einige der Daten für diese Dimensionen reproduzieren, indem sie mit der Dimension day Abfragen ausführen und Daten über Zeiträume von 7 oder 30 Tagen aggregieren oder ableiten. Beispiel:

    • Die Anzahl der Aufrufe für einen Zeitraum von sieben Tagen kann berechnet werden, indem die Anzahl der Aufrufe für jeden Tag dieses Zeitraums addiert wird.
    • Der Prozentsatz der Zuschauer für einen Zeitraum von sieben Tagen kann berechnet werden, indem die Anzahl der Aufrufe, die an jedem Tag erfolgt sind, mit dem Prozentsatz der Zuschauer für diesen Tag multipliziert wird. So erhältst du die Anzahl der Zuschauer, die an diesem Tag beim Ansehen des Videos angemeldet waren. Anschließend kann die Anzahl der angemeldeten Zuschauer für den gesamten Zeitraum addiert und durch die Gesamtzahl der Aufrufe für diesen Zeitraum geteilt werden, um den Prozentsatz der Zuschauer für den gesamten Zeitraum zu erhalten.
    • Die Anzahl der einzelnen Zuschauer für einen Zeitraum von sieben Tagen kann nicht berechnet werden, da derselbe Zuschauer an verschiedenen Tagen als einzelner Zuschauer gezählt werden könnte. Möglicherweise können Sie jedoch die Dimension month anstelle der Dimension 30DayTotals verwenden, um Daten zur Anzahl der einzelnen Zuschauer über einen Zeitraum von 30 Tagen zu extrapolieren. Die Dimension month bezieht sich auf Kalendermonate, während bei der Dimension 30DayTotals 30‑Tage-Zeiträume auf Grundlage des angegebenen Start- und Enddatums berechnet werden.

27. Juni 2019

Dieses Update enthält die folgenden Änderungen in Bezug auf die YouTube Analytics API (Targeted Queries):

  • Da Version 1 der API jetzt vollständig eingestellt wurde, wurde die Dokumentation aktualisiert, um Verweise auf diese Version zu entfernen, einschließlich des Hinweises zur Einstellung und der Migrationsanleitung, in der erläutert wird, wie Sie auf Version 2 aktualisieren.

1. November 2018

Dieses Update enthält die folgenden Änderungen in Bezug auf die YouTube Analytics API (Targeted Queries):

17. September 2018

Dieses Update enthält die folgenden Änderungen in Bezug auf die YouTube Analytics API (Targeted Queries):

  • Im neuen Abschnitt Datenanonymisierung im Übersichtsartikel Datenmodell wird erläutert, dass einige YouTube Analytics-Daten eingeschränkt sind, wenn Messwerte einen bestimmten Grenzwert nicht erreichen. Das kann in verschiedenen Fällen passieren. In der Praxis bedeutet das, dass ein Bericht möglicherweise nicht alle oder keine Ihrer Daten enthält, wenn:

    1. ein Video oder Kanal in einem bestimmten Zeitraum nur eingeschränkte Zugriffe hat,

      oder

    2. Sie haben einen Filter oder eine Dimension wie Traffic-Quelle oder Land ausgewählt, für die die Werte einen bestimmten Grenzwert nicht erreichen.

    Im neuen Abschnitt wird auch erläutert, welche Arten von Daten in YouTube Analytics-Berichten eingeschränkt sein können.

  • Die Dokumente Kanalberichte und Berichte für Rechteinhaber wurden aktualisiert. Die Messwerte redViews und estimatedRedMinutesWatched werden nicht mehr für Berichte zu Wiedergabeort, Traffic-Quelle und Gerätetyp/Betriebssystem unterstützt.

18. Juni 2018

Dieses Update enthält die folgenden Änderungen an der YouTube Analytics API (Targeted Queries):

  • Die Bereichsanforderungen für die folgenden Methoden haben sich geändert:
    • Anfragen an die Methode reports.query müssen Zugriff auf den Bereich https://www.googleapis.com/auth/youtube.readonly haben.
    • Anfragen an die Methode groupItems.list müssen Zugriff auf Folgendes haben:
      • https://www.googleapis.com/auth/youtube-Bereich
        oder
      • der Bereich https://www.googleapis.com/auth/youtube.readonly
        und
        der Bereich https://www.googleapis.com/auth/yt-analytics.readonly

      Bei der ersten Option wird ein Bereich verwendet, der zufällig ein Lese-/Schreibbereich ist, während bei der zweiten Option zwei schreibgeschützte Bereiche verwendet werden.

23. Mai 2018

Dieses Update enthält die folgenden Änderungen an der YouTube Analytics API (Targeted Queries):

  • Die API-Übersicht enthält einen neuen Abschnitt Aggregierte Messwerte und gelöschte Elemente. Darin wird erläutert, wie in API-Antworten Daten behandelt werden, die mit gelöschten Ressourcen wie Videos, Playlists oder Kanälen verknüpft sind.
  • Der Abschnitt Best Practices in der API-Übersicht wurde aktualisiert. Dort wird darauf hingewiesen, dass du mit der YouTube Data API zusätzliche Metadaten für Ressourcen abrufen kannst, die in YouTube Analytics API-Antworten angegeben sind. Wie in den Richtlinien für Entwickler der YouTube API-Dienste (Abschnitte III.E.4.b bis III.E.4.d) beschrieben, müssen API-Clients gespeicherte Ressourcenmetadaten aus dieser API nach 30 Tagen entweder löschen oder aktualisieren.

22. Mai 2018

Dieses Update enthält die folgenden Änderungen im Zusammenhang mit der YouTube Reporting API (Bulk-Berichte):

  • Die folgenden Änderungen sollen im Juli 2018 in Kraft treten. Die neuen Richtlinien gelten weltweit für alle Berichte und Berichtsjobs.

    • Nach der Änderung sind die meisten API-Berichte, einschließlich Backfill-Berichten, 60 Tage lang verfügbar, nachdem sie generiert wurden. Berichte mit Verlaufsdaten sind jedoch ab dem Zeitpunkt ihrer Erstellung 30 Tage lang verfügbar.

      Vor dieser Ankündigung waren alle API-Berichte ab dem Zeitpunkt ihrer Erstellung 180 Tage lang verfügbar. Wenn diese Richtlinienänderung in Kraft tritt, sind auch Berichte mit Verlaufsdaten, die älter als 30 Tage sind, nicht mehr über die API zugänglich. Alle anderen Berichte, die älter als 60 Tage sind, sind dann ebenfalls nicht mehr verfügbar. In der Dokumentation wird jetzt angegeben, dass Berichte, die vor der Richtlinienänderung erstellt wurden, bis zu 180 Tage lang verfügbar sind.

    • Nach der Änderung werden bei der Planung eines Berichterstellungsjobs Berichte ab diesem Tag und für den Zeitraum von 30 Tagen vor dem Zeitpunkt der Planung des Jobs generiert. Vor der Änderung wurden bei der Planung eines Berichterstellungsjobs Berichte für den Zeitraum von 180 Tagen vor dem Zeitpunkt der Planung des Jobs erstellt.

  • Der Abschnitt Best Practices wurde aktualisiert. Sie können jetzt die YouTube Data API verwenden, um zusätzliche Metadaten für Ressourcen abzurufen, die in Berichten angegeben sind. Wie in den Richtlinien für Entwickler der YouTube API-Dienste (Abschnitte III.E.4.b bis III.E.4.d) beschrieben, müssen API-Clients gespeicherte Ressourcenmetadaten aus dieser API nach 30 Tagen entweder löschen oder aktualisieren.

  • Der Abschnitt Berichtseigenschaften wurde aktualisiert. Dort wird jetzt darauf hingewiesen, dass Berichte, die Daten für einen Zeitraum ab dem 1. Juni 2018 enthalten, keine Verweise auf YouTube-Ressourcen enthalten, die mindestens 30 Tage vor dem Datum gelöscht wurden, an dem der Bericht generiert wurde.

  • Der Abschnitt Verlaufsdaten in der API-Übersicht wurde aktualisiert. Wenn Sie einen neuen Reporting-Job planen, werden die Verlaufsberichte in der Regel innerhalb von zwei Tagen veröffentlicht. Bisher wurde in der Dokumentation angegeben, dass es bis zu 30 Tage dauern kann, bis solche Berichte verfügbar sind.

  • Der Abschnitt Backfill-Daten in der API-Übersicht wurde aktualisiert, um Backfill-Daten als Datensatz zu definieren, der einen zuvor bereitgestellten Satz ersetzt.

26. April 2018

Version 2 der YouTube Analytics API (Targeted Queries) (v2) ist jetzt öffentlich verfügbar. In der folgenden Liste werden Produkt- und Dokumentationsänderungen im Zusammenhang mit der neuen API-Version aufgeführt:

  • Die v2 API ist fast identisch mit der v1 API. Wahrscheinlich müssen Sie aber Ihren Code aktualisieren, um die unten aufgeführten Änderungen zu berücksichtigen. Alle diese Änderungen werden im neuen Migrationsleitfaden ausführlich erläutert.

    • Die Version der API hat sich von v1 zu v2 geändert.
    • Die Basis-URL für API-Anfragen wurde von https://www.googleapis.com/youtube/analytics/v1 in https://youtubeanalytics.googleapis.com/v2 geändert.
    • Mehrere Parameter für die Methode reports.query haben aktualisierte Namen. Insbesondere Parameternamen, die Bindestriche enthalten, wie end-date in der v1 API, verwenden in der v2 API Camel Case (endDate) anstelle von Bindestrichen. Durch diese Änderung werden die Parameternamen in der gesamten API einheitlich, da in den Methoden der API zum Erstellen und Verwalten von Gruppen bereits Camel Case für Parameternamen verwendet wurde.
    • Die v2 API unterstützt keine Batchanfragen, die an den globalen HTTP-Batchendpunkt von Google (www.googleapis.com/batch) gesendet werden. Wenn Sie Batchanfragen in der v2 API senden, müssen Sie stattdessen den Endpunkt https://youtubeanalytics.googleapis.com/v2 verwenden.

    Außerdem werden einige v1-Funktionen in der v2 API nicht unterstützt:

    • Die Methode reports.query unterstützt die Anfrageparameter alt, quotaUser und userIp nicht mehr.
    • Die v2-API bietet keinen Batch-Endpunkt, der Batches mit Anfragen an verschiedene APIs unterstützt. Ein Batch kann jedoch Anfragen an verschiedene Methoden derselben API enthalten. Diese Einstellung betrifft nicht nur die YouTube Analytics API, sondern alle Google-APIs.
    • Die v2 API unterstützt das JSON-RPC-Protokoll nicht, das in der v1 API unterstützt wurde. Auch diese Einstellung betrifft nicht nur die YouTube Analytics API.

  • Hinweis:Dies ist eine Einstellungsbenachrichtigung.

    Version 1 der API (v1) wird nicht mehr unterstützt und ist noch bis zum 31. Oktober 2018 verfügbar. Alle Anfragen an die v1-API funktionieren nach diesem Datum nicht mehr. Führen Sie daher bitte bis zum 31. Oktober 2018 ein Upgrade auf die v2 API durch, um zu vermeiden, dass Sie nicht mehr über die API auf YouTube Analytics-Daten zugreifen können.

21. Februar 2018

Dieses Update enthält die folgenden Änderungen an der YouTube Analytics API (Targeted Queries):

  • In Berichten zu demografischen Merkmalen von Zuschauern, in denen Zuschauerstatistiken nach Altersgruppe und Geschlecht zusammengefasst werden, wird die Dimension youtubeProduct nicht mehr unterstützt. Mit dieser Dimension wurde der YouTube-Dienst identifiziert, in dem die Nutzeraktivität stattgefunden hat.

18. Januar 2018

Dieses Update enthält die folgenden Änderungen:

  • YouTube Reporting API (Bulk Reports)

    • Die Dimension operating_system, mit der das Softwaresystem des Geräts identifiziert wird, auf dem Aufrufe erfolgt sind, unterstützt jetzt den folgenden Wert:
      • 25: KaiOS

  • YouTube Analytics API (Targeted Queries)

20. Dezember 2017

Dieses Update enthält zwei Änderungen im Zusammenhang mit der YouTube Reporting API:

  • Der API-Server unterstützt jetzt die gzip-Komprimierung für Anfragen zum Herunterladen von Berichten. Die GZIP-Komprimierung wird für andere Arten von API-Anfragen nicht unterstützt. Durch Aktivieren der gzip-Komprimierung wird die für jede API-Antwort benötigte Bandbreite reduziert. Auch wenn für Ihre Anwendung zusätzliche CPU-Zeit zum Dekomprimieren von API-Antworten erforderlich ist, überwiegt in der Regel der Vorteil, weniger Netzwerkressourcen zu verbrauchen.

    Wenn Sie eine mit gzip codierte Antwort erhalten möchten, legen Sie den HTTP-Anfrageheader Accept-Encoding auf gzip fest, wie im folgenden Beispiel gezeigt:

    Accept-Encoding: gzip

    Diese Funktion wird in der API-Übersicht und in der Definition der downloadUrl-Eigenschaft der report-Ressource beschrieben.

  • Die Dokumentation der Dimensionen age group und gender wurde korrigiert, um die tatsächlichen Werte zu zeigen, die die API für diese Dimensionen zurückgibt. Hinweis: Es handelt sich hierbei um eine Korrektur der Dokumentation. Die API-Funktionalität oder das API-Verhalten haben sich nicht geändert. Konkret haben sich die folgenden Werte geändert:

    • Für die Dimension age_group werden Großbuchstaben verwendet. Zwischen dem Wort AGE und den Zahlen in der Altersgruppe stehen Unterstriche. Außerdem werden Unterstriche anstelle von Bindestrichen verwendet. Daher wurden Werte wie age13-17 und age18-24 in AGE_13_17 bzw. AGE_18_24 korrigiert.
    • Für die Dimension gender werden Großbuchstaben verwendet. Die Werte female, male und gender_other wurden also in FEMALE, MALE und GENDER_OTHER korrigiert.

10. August 2017

Am 10. August 2016 wurde in dieser Dokumentation die Einstellung des Messwerts earnings der YouTube Analytics API angekündigt. Gleichzeitig wurde in der API ein neuer Messwert namens estimatedRevenue eingeführt, der dieselben Daten liefert.

Da der Messwert earnings ein wichtiger Messwert war, wurde er ab dem Datum der Ankündigung ein Jahr lang unterstützt. Da dieser Zeitraum nun abgelaufen ist, wird der Messwert earnings nicht mehr unterstützt. Daher wird für API-Anfragen, in denen der Messwert earnings angegeben ist, jetzt der HTTP-Antwortcode 400 zurückgegeben. Wenn Sie Ihre App noch nicht aktualisiert haben, um anstelle der Messwertgruppe earnings die Messwertgruppe estimatedRevenue zu verwenden, holen Sie das bitte so schnell wie möglich nach.

Die API-Dokumentation wurde aktualisiert, um verbleibende Verweise auf die Messwertgruppe earnings zu entfernen.

6. Juli 2017

Dieses Update enthält die folgenden Änderungen:

  • YouTube Analytics API (Targeted Queries)

    • Die API-Dokumentation wurde aktualisiert. API-Antworten enthalten jetzt Daten bis zum letzten Tag im angeforderten Zeitraum, für den alle abgefragten Messwerte verfügbar sind.

      Wenn in einer Anfrage beispielsweise das Enddatum 5. Juli 2017 angegeben ist und Werte für alle angeforderten Messwerte nur bis zum 3. Juli 2017 verfügbar sind, ist das der letzte Tag, für den Daten in die Antwort aufgenommen werden. Das gilt auch, wenn Daten für einige der angeforderten Messwerte für den 4. Juli 2017 verfügbar sind.

    • Für die Dimension adType wird jetzt der Wert reservedBumperInstream unterstützt. Dieser bezieht sich auf eine nicht überspringbare Videoanzeige mit einer Länge von bis zu 6 Sekunden, die vor der Wiedergabe des Videos abgespielt wird. Das Anzeigenformat ist identisch mit der auctionBumperInstream-Anzeige. Dieser Typ bezieht sich jedoch auf Anzeigen, die auf Reservierungsbasis und nicht über eine Auktion verkauft werden.

  • YouTube Reporting API (Bulk Reports)

    • Die Dimension ad_type unterstützt jetzt den Wert 20, der sich auf Bumper-Anzeigen bezieht, die auf Reservierungsbasis verkauft werden. Bumper-Anzeigen sind nicht überspringbare Videoanzeigen, die bis zu sechs Sekunden dauern und vor der Wiedergabe eines Videos abgespielt werden. Der Wert 19 für diese Dimension bezieht sich auch auf Bumper-Anzeigen, die auf Auktionsbasis und nicht auf Reservierungsbasis verkauft werden.

    • Berichtsjobs für die folgenden YouTube Reporting API-Berichte wurden gelöscht:

      • channel_basic_a1
      • channel_province_a1
      • channel_playback_location_a1
      • channel_traffic_source_a1
      • channel_device_os_a1
      • channel_subtitles_a1
      • channel_combined_a1
      • content_owner_basic_a2
      • content_owner_province_a1
      • content_owner_playback_location_a1
      • content_owner_traffic_source_a1
      • content_owner_device_os_a1
      • content_owner_subtitles_a1
      • content_owner_combined_a1
      • content_owner_asset_basic_a1
      • content_owner_asset_province_a1
      • content_owner_asset_playback_location_a1
      • content_owner_asset_traffic_source_a1
      • content_owner_asset_device_os_a1
      • content_owner_asset_combined_a1

      Diese Berichtstypen wurden am 15. September 2016 als eingestellt angekündigt. Nach dem 15. Dezember 2016 wurden keine Berichte mehr für diese Berichtstypen generiert. Zuvor generierte Berichte waren ab dem Zeitpunkt ihrer Erstellung noch 180 Tage lang verfügbar. Einige Berichte waren daher noch bis zum 15. Juni 2017 verfügbar. Da die Berichte jedoch nicht mehr verfügbar sind, werden auch die mit den Berichten verknüpften Jobs nicht mehr benötigt.

24. Mai 2017

Alle Berichtsjobs für die folgenden YouTube Reporting API-Berichte wurden gelöscht:

  • content_owner_ad_performance_a1
  • content_owner_asset_estimated_earnings_a1
  • content_owner_estimated_earnings_a1

Diese Berichtstypen wurden am 22. Juni 2016 als eingestellt angekündigt. Nach dem 22. September 2016 wurden keine Berichte mehr für diese Berichtstypen generiert. Zuvor generierte Berichte waren ab dem Zeitpunkt ihrer Erstellung noch 180 Tage lang verfügbar. Daher waren einige Berichte noch bis zum 22. März 2017 verfügbar. Da die Berichte jedoch nicht mehr verfügbar sind, werden auch die mit den Berichten verknüpften Jobs nicht mehr benötigt.

22. Mai 2017

Dieses Update enthält die folgenden Änderungen:

  • YouTube Reporting API (Bulk Reports)

    • Die Dimension sharing_service, mit der der Dienst identifiziert wird, über den Videos geteilt wurden, unterstützt jetzt die folgenden Werte:
      • 85: YouTube Music
      • 86: YouTube Gaming
      • 87: YouTube Kids
      • 88: YouTube TV

      Außerdem wurde der Name, der zur Identifizierung des Werts 52 verwendet wird, in der Dokumentation zu Kakao (Kakao Talk) aktualisiert, um ihn deutlicher vom Wert 73 (Kakao Story) zu unterscheiden. Diese Änderung hat keine Auswirkungen auf das API-Verhalten oder die Klassifizierung von Videos, die mit diesen Diensten geteilt werden.

  • YouTube Analytics API (Targeted Queries)

    • Die Dimension sharingService unterstützt jetzt die folgenden Werte:
      • YOUTUBE_GAMING
      • YOUTUBE_KIDS
      • YOUTUBE_MUSIC
      • YOUTUBE_TV

28. März 2017

Kanalinhaber, die über YouTube Analytics in Creator Studio auf Umsatzdaten zugreifen können, können diese Umsatzdaten jetzt auch über die YouTube Analytics API abrufen:

17. März 2017

Dieses Update enthält die folgenden Änderungen:

  • Die YouTube Analytics API unterstützt die Messwerte redViews und estimatedRedMinutesWatched, die sich beide auf die Zuschauerzahlen von YouTube Red beziehen. Tatsächlich werden diese Messwerte schon seit einiger Zeit von der API unterstützt und die YouTube Reporting API unterstützt beide Messwerte bereits, wie am 15. September 2016 angekündigt.

    • Mit dem Messwert redViews wird die Anzahl der Aufrufe eines Videos durch YouTube Red-Mitglieder ermittelt.
    • Mit dem Messwert estimatedRedMinutesWatched wird die Anzahl der Minuten angegeben, die YouTube Red-Abonnenten ein Video angesehen haben.

    Die Dokumentation zu Kanalberichten und Berichten für Rechteinhaber wurde aktualisiert. Sie enthält jetzt Informationen dazu, in welchen Berichten die beiden neuen Messwerte verfügbar sind. Sie werden in allen Berichten unterstützt, in denen die Messwerte „views“ und „estimatedMinutesWatched“ bereits unterstützt wurden.

3. März 2017

Dieses Update enthält die folgenden Änderungen:

  • YouTube Reporting API (Bulk Reports)

    • Die Definition der Dimension date wurde korrigiert. Der Dimensionswert bezieht sich auf den Zeitraum, der am angegebenen Tag, Monat und Jahr um 00:00 Uhr Pacific Time beginnt und um 23:59 Uhr Pacific Time endet. Je nach Jahreszeit ist die Pazifische Zeit entweder UTC-7 oder UTC-8.

      Normalerweise repräsentieren Datumsangaben einen Zeitraum von 24 Stunden. Wenn die Uhr jedoch vor- oder zurückgestellt wird, repräsentieren sie einen Zeitraum von 23 bzw. 25 Stunden. Bisher wurde in der Dokumentation angegeben, dass jedes Datum einen eindeutigen 24-Stunden-Zeitraum darstellt und dass die Pacific Time immer UTC-8 ist.

      Diese Korrektur stellt keine Änderung des tatsächlichen API-Verhaltens dar.

    • Die Dimension operating_system, mit der das Softwaresystem des Geräts identifiziert wird, auf dem Aufrufe erfolgt sind, unterstützt jetzt die folgenden Werte:
      • 22: Tizen
      • 23: Firefox
      • 24: RealMedia

    • Alle Berichtsjobs für den Berichtstyp content_owner_basic_a1 wurden gelöscht. Dieser Berichtstyp wurde am 19. August 2016 vollständig eingestellt. Zuvor generierte content_owner_basic_a1-Berichte waren jedoch noch 180 Tage lang nach ihrer Erstellung verfügbar. Einige Berichte waren daher noch bis zum 19. Februar 2017 verfügbar. Da die Berichte jedoch nicht mehr verfügbar sind, werden auch die mit den Berichten verknüpften Jobs nicht mehr benötigt.

  • YouTube Analytics API (Targeted Queries)

    • Die Beschreibung der Dimensionen für time periods wurde korrigiert. Der Dimensionswert bezieht sich auf den Zeitraum, der am angegebenen Tag, Monat und Jahr um 00:00 Uhr Pacific Time beginnt und um 23:59 Uhr Pacific Time endet. Je nach Jahreszeit ist die Pazifische Zeit entweder UTC-7 oder UTC-8.

      Normalerweise repräsentieren Datumsangaben einen Zeitraum von 24 Stunden. Wenn die Uhr jedoch vor- oder zurückgestellt wird, repräsentieren sie einen Zeitraum von 23 bzw. 25 Stunden. Bisher wurde in der Dokumentation angegeben, dass die Pacific Time UTC-8 ist. Außerdem wurde nicht erwähnt, dass ein Tag möglicherweise keinen 24-Stunden-Zeitraum darstellt.

      Diese Korrektur stellt keine Änderung des tatsächlichen API-Verhaltens dar.

    • Die Dokumentation zu Channel-Berichten wurde aktualisiert. Channel-Berichte enthalten derzeit keine Messwerte zu Einnahmen oder zur Anzeigenleistung. Daher gewährt der Bereich https://www.googleapis.com/auth/yt-analytics-monetary.readonly derzeit keinen Zugriff auf monetäre Daten in Kanalberichten.

    • Die Dimension operatingSystem unterstützt drei neue Dimensionswerte:
      • FIREFOX
      • REALMEDIA
      • TIZEN

8. Februar 2017

Die YouTube Analytics API unterstützt jetzt den optionalen Parameter include-historical-channel-data. Dieser Parameter ist nur relevant, wenn Berichte für Rechteinhaber abgerufen werden.

Mit diesem Parameter kann ein Rechteinhaber angeben, dass eine API-Antwort die Daten zur Wiedergabezeit und zu Aufrufen von Kanälen aus dem Zeitraum vor der Verknüpfung der Kanäle mit dem Rechteinhaber enthalten soll. Der Standardparameterwert ist false. Das bedeutet, dass die API-Antwort standardmäßig nur Daten zu Wiedergabezeit und Aufrufen ab dem Zeitpunkt enthält, zu dem Kanäle mit dem Rechteinhaber verknüpft wurden.

Diese Regeln gelten auch, wenn mit der API-Anfrage Daten für mehrere Channels abgerufen werden:

  • Wenn der Parameterwert false ist, basieren die für einen bestimmten Kanal zurückgegebenen Daten zu Wiedergabezeit und Aufrufen auf dem Datum, an dem dieser Kanal mit dem Rechteinhaber verknüpft wurde.

    Es ist wichtig zu beachten, dass verschiedene Kanäle möglicherweise an unterschiedlichen Daten mit einem Rechteinhaber verknüpft wurden. Wenn mit der API-Anfrage Daten für mehrere Kanäle abgerufen werden und der Parameterwert false ist, enthält die API-Antwort Daten zur Wiedergabezeit und zu Aufrufen basierend auf dem Verknüpfungsdatum für jeden Kanal.
  • Wenn der Parameterwert true ist, werden in der Antwort Daten zu Wiedergabezeit und Aufrufen für alle Channels basierend auf den in der API-Anfrage angegebenen Start- und Enddaten zurückgegeben.

15. Dezember 2016

Die folgenden YouTube Reporting API-Berichte werden nicht mehr unterstützt und wurden aus der Dokumentation entfernt. Eine neuere Version der einzelnen Berichte ist verfügbar. Die Mitteilung zur Einstellung für diese Berichte wurde am 15. September 2016 veröffentlicht.

Die Liste der aktuellen Berichtstypen in der API-Referenzdokumentation wurde ebenfalls aktualisiert.

11. November 2016

Dieses Update enthält die folgenden Änderungen:

Die YouTube Reporting API unterstützt drei neue Berichte zu Endcards sowie neue Dimensionen und Messwerte für diese Berichte. Die Berichte enthalten Statistiken zu Impressionen und Klickraten für die Abspanne, die nach dem Ende der Videowiedergabe eingeblendet werden.

8. November 2016

Dieses Update enthält die folgenden Änderungen an der YouTube Analytics API:

  • Die Messwerte in der folgenden Liste wurden vollständig eingestellt und werden nicht mehr unterstützt. Wie am 10. August 2016 angekündigt, werden bereits neue Messwerte unterstützt, die sich auf dieselben Daten beziehen. In der folgenden Tabelle sind der verworfene Messwertname und der neue Messwertname aufgeführt:

    Eingestellter Messwert Neuer Messwert
    adEarnings estimatedAdRevenue
    impressionBasedCpm cpm
    impressions adImpressions
    redPartnerRevenue estimatedRedPartnerRevenue

27. Oktober 2016

YouTube generiert jetzt automatisch eine Reihe von systemverwalteten Berichten zu Werbeeinnahmen für Rechteinhaber, die im Berichtsbereich von YouTube Studio Zugriff auf die entsprechenden Berichte haben. Die neuen systemverwalteten API-Berichte bieten programmatischen Zugriff auf Daten, die auch in den manuell herunterladbaren YouTube Studio-Berichten verfügbar sind.

In der Übersicht über systemverwaltete Berichte finden Sie eine kurze Beschreibung der neuen Berichte und eine Anleitung zum Abrufen der Berichte über die API. Dieser Prozess unterscheidet sich geringfügig vom Abrufen von Massenberichten für YouTube Analytics, da Partner keine Jobs planen müssen, um die Berichte zu generieren.

Die id-Eigenschaft der reportType-Ressource wurde aktualisiert und enthält jetzt eine Liste der vom System verwalteten Berichte, auf die Sie über die API zugreifen können:

  • Monatlicher weltweiter Werbeumsatz pro Video
  • Tägliche Werbeeinnahmen pro Video und Land
  • Monatlicher weltweiter Werbeumsatz pro Asset
  • Tägliche Werbeeinnahmen pro Asset und Land
  • Ansprüche (dieser Bericht enthält keine Umsatzdaten)

27. September 2016

Hinweis:Dies ist eine Einstellungsbenachrichtigung.

Der uniques-Messwert der YouTube Analytics API wurde eingestellt. Dies ist kein Kernmesswert und wird noch bis zum 31. Oktober 2016 unterstützt.

15. September 2016

Dieses Update enthält die folgenden Änderungen an der YouTube Reporting API:

19. August 2016

Dieses Update enthält die folgende Änderung an der YouTube Reporting API:

  • Der Bericht content_owner_basic_a1 wurde vollständig eingestellt und aus der Dokumentation entfernt. YouTube generiert keine neuen Berichte dieses Typs mehr. Bereits generierte Berichte sind jedoch noch 180 Tage lang ab dem Zeitpunkt ihrer Erstellung verfügbar.

    Der content_owner_basic_a1-Bericht wurde durch den content_owner_basic_a2-Bericht ersetzt. Weitere Informationen finden Sie im Revisionsverlauf vom 19. Mai 2016.

11. August 2016

Dieses Update enthält die folgenden Änderungen:

  • Die neu veröffentlichten Nutzungsbedingungen für die YouTube API-Dienste („die aktualisierten Nutzungsbedingungen“), die im YouTube Engineering and Developers Blog ausführlich beschrieben werden, enthalten eine Vielzahl von Aktualisierungen der aktuellen Nutzungsbedingungen. Zusätzlich zu den aktualisierten Nutzungsbedingungen, die am 10. Februar 2017 in Kraft treten, enthält dieses Update mehrere unterstützende Dokumente, in denen die Richtlinien erläutert werden, die Entwickler einhalten müssen.

    Die vollständige Liste der neuen Dokumente finden Sie im Versionsverlauf der aktualisierten Nutzungsbedingungen. Außerdem werden zukünftige Änderungen an den aktualisierten Nutzungsbedingungen oder den zugehörigen Dokumenten ebenfalls in diesem Revisionsverlauf erläutert. Über einen Link im Dokument können Sie einen RSS-Feed abonnieren, in dem Änderungen im Revisionsverlauf aufgeführt sind.

10. August 2016

Dieses Update enthält die folgenden Änderungen:

  • YouTube Analytics API (Targeted Queries)

    • Hinweis:Dies ist eine Einstellungsbenachrichtigung.

      Die Messwerte in der folgenden Tabelle werden eingestellt. Gleichzeitig werden neue Messwerte eingeführt, die sich auf dieselben Daten beziehen. Die alten Messwerte werden also umbenannt. Die YouTube Analytics API unterstützt jedoch beide Messwertnamen bis zu den in der Tabelle aufgeführten Einstellungsdaten.

      Alter Messwertname Neuer Messwertname Supportdatum
      earnings estimatedRevenue 10. August 2017
      adEarnings estimatedAdRevenue 4. November 2016
      redPartnerRevenue estimatedRedPartnerRevenue 4. November 2016
      impressionBasedCpm cpm 4. November 2016
      impressions adImpressions 4. November 2016

      Der Messwert earnings war ein wichtiger Messwert und wird daher ab dem Datum dieser Ankündigung noch ein Jahr lang unterstützt. Die anderen Messwerte, die keine Kernmesswerte waren, werden noch drei Monate lang, bis zum 4. November 2016, unterstützt.

      Bis zum 4. November 2016 konnte in einer API-Anfrage beispielsweise der Messwert impressionBasedCpm, der Messwert cpm oder beide angegeben werden. Danach wird jedoch nur noch der Messwert cpm unterstützt.

    • Die Dimension insightTrafficSourceType unterstützt zwei neue Dimensionswerte:
      • CAMPAIGN_CARD: Diese Zugriffsquelle wird nur für Rechteinhaberberichte unterstützt. Das bedeutet, dass die Aufrufe von beanspruchten, von Nutzern hochgeladenen Videos stammen, die der Rechteinhaber zur Bewerbung der angesehenen Inhalte verwendet hat.
      • END_SCREEN: Die Daten beziehen sich auf Aufrufe, die über den Abspann eines anderen Videos generiert wurden.

      Für beide neuen Zugriffsquellen können Sie auch einen traffic source detail-Bericht abrufen. In beiden Fällen wird mit der Dimension insightTrafficSourceDetail das Video angegeben, von dem der Zuschauer weitergeleitet wurde.

    • Für die Dimension adType wird jetzt der Wert auctionBumperInstream unterstützt. Dieser bezieht sich auf eine nicht überspringbare Videoanzeige mit einer Länge von bis zu 6 Sekunden, die vor der Wiedergabe des Videos abgespielt wird.

  • YouTube Reporting API (Bulk Reports)

    • Die Dimension traffic_source_type unterstützt jetzt die folgenden Werte:
      • 19: Diese Zugriffsquelle wird nur für Rechteinhaberberichte unterstützt. Das bedeutet, dass die Aufrufe von beanspruchten, von Nutzern hochgeladenen Videos stammen, die der Rechteinhaber zur Bewerbung der angesehenen Inhalte verwendet hat.
      • 20: Die Daten beziehen sich auf Aufrufe, die über den Abspann eines anderen Videos generiert wurden.

      Bei beiden neuen Besucherquellen wird mit der Dimension traffic_source_detail das Video identifiziert, von dem der Zuschauer weitergeleitet wurde.

    • Die Liste der wichtigen Messwerte der API wurde korrigiert. estimated_partner_revenue ist jetzt als wichtiger Messwert aufgeführt und earnings wurde aus der Liste entfernt. Der Messwert earnings wurde in der YouTube Reporting API nie unterstützt.

    • Für die Dimension ad_type wird jetzt der Wert 19 unterstützt. Er bezieht sich auf Bumper-Anzeigen, also nicht überspringbare Videoanzeigen mit einer Länge von bis zu 6 Sekunden, die vor der Wiedergabe eines Videos abgespielt werden.

18. Juli 2016

Dieses Update enthält die folgenden Änderungen:

  • YouTube Analytics API (Targeted Queries)

    • Die Listen der unterstützten Messwerte für die folgenden Channel-Berichte wurden aktualisiert und enthalten jetzt auch Messwerte für Karten. Die Unterstützung für Kartenmesswerte in diesen Berichten wurde am 28. Juni 2016 hinzugefügt. Im Revisionsverlauf für dieses Datum wird die Änderung genauer beschrieben. Folgende Berichte sind verfügbar:
      • Grundlegende Nutzeraktivitäten für US‑Bundesstaaten
      • Nutzeraktivitäten in US-Bundesstaaten für bestimmte Zeiträume
      • Nutzeraktivität nach Bundesland
      • Nutzeraktivitäten nach Abo-Status
      • Nutzeraktivität nach Abo-Status für Bundesländer
      • Top-Videos nach Bundesstaat
      • Top-Videos für Abonnenten oder Zuschauer, die deinen Kanal nicht abonniert haben

    • Die Filterlisten für Berichte zur Zuschauerbindung auf Kanalebene und Berichte zur Zuschauerbindung auf Ebene des Rechteinhabers wurden korrigiert. Der Filter video ist erforderlich und der Filter group wird nicht unterstützt.

      Bisher wurde in der Dokumentation für beide Berichte fälschlicherweise angegeben, dass der Bericht mit einem der beiden Filter oder ohne Filter abgerufen werden kann.

  • YouTube Reporting API (Bulk Reports)

    • In der API-Übersicht wurde der Abschnitt, in dem beschrieben wird, wie die Download-URL eines Berichts abgerufen wird, korrigiert. Es wird nun darauf hingewiesen, dass YouTube herunterladbare Berichte auch für Tage generiert, an denen keine Daten verfügbar waren. Diese Berichte enthalten eine Kopfzeile, aber keine zusätzlichen Daten. Diese Informationen wurden bereits am 12. April 2016 im Abschnitt Berichtsmerkmale desselben Dokuments aktualisiert.
    • Die Liste der Dimensionen im content_owner_asset_cards_a1-Bericht wurde korrigiert. Im Bericht wird die Dimension card_id verwendet. Bisher wurde der Dimensionsname in der Dokumentation fälschlicherweise als card_title angegeben.

28. Juni 2016

Die YouTube Analytics API-Dokumentation wurde aktualisiert und enthält jetzt Informationen zur Unterstützung von Infokartenmesswerten in zahlreichen Kanal- und Rechteinhaber-Berichten. Folgende Messwerte werden jetzt unterstützt:

Die Messwerte werden in den folgenden Berichtstypen unterstützt:

22. Juni 2016

Dieses Update enthält die folgenden Änderungen an der YouTube Reporting API. Die erste Änderung betrifft die API im Allgemeinen. Die übrigen Änderungen wirken sich nur auf Berichte von Rechteinhabern aus:

  • Der Abschnitt Berichtsmerkmale in der API-Übersicht wurde aktualisiert. Berichte sind über die API 180 Tage lang verfügbar, nachdem sie generiert wurden.

    Bisher wurde in der Dokumentation angegeben, dass Berichte für einen Zeitraum von bis zu 180 Tagen vor dem Datum verfügbar sind, an dem die API-Anfrage gesendet wird. Das ist zwar technisch richtig, aber der ursprüngliche Text war bestenfalls verwirrend.

  • Die API unterstützt neue Versionen von drei Berichten. Zwei dieser Berichte enthalten auch neue und umbenannte Messwerte:

    • Der Bericht content_owner_ad_rates_a1 ist die neue Version des Berichts content_owner_ad_performance_a1. Der umbenannte Bericht ist mit der vorherigen Version identisch.

    • Zwei Berichte, für die es neue Versionen gibt, wurden umbenannt:

      • Die neue Version des Berichts content_owner_estimated_earnings_a1 heißt content_owner_estimated_revenue_a1.
      • Die neue Version des Berichts content_owner_asset_estimated_earnings_a1 heißt content_owner_asset_estimated_revenue_a1.

      Die beiden neu umbenannten Berichte unterscheiden sich in folgenden Punkten von ihren Vorgängern:

    Wenn Sie bereits Jobs zum Erstellen einer der älteren Versionen dieser Berichte haben, müssen Sie neue Jobs für die umbenannten Berichte erstellen. Mit der Veröffentlichung der neuen Berichtsversionen wurden die Berichte content_owner_ad_performance_a1, content_owner_estimated_earnings_a1 und content_owner_asset_estimated_earnings_a1 eingestellt.

    Wenn Sie Jobs für diese Berichte haben, sollten Sie nicht erwarten, dass YouTube nach dem 22. September 2016 neue Berichte für diese Jobs generiert. Generierte Berichte sind weiterhin 180 Tage lang verfügbar.

  • Die Definition des Attributs id der Ressource reportType wurde aktualisiert, um die aktuelle Gruppe der verfügbaren Berichte widerzuspiegeln.

  • Die Namen von zwei Messwerten wurden in der Dokumentation korrigiert, damit sie mit den Namen in Berichten übereinstimmen. Es handelt sich lediglich um eine Korrektur der Dokumentation. Die tatsächlichen Berichtsinhalte haben sich nicht geändert:

    • Der Name des Messwerts „estimated_partner_adsense_revenue“ wurde in „estimated_partner_ad_sense_revenue“ geändert. Dieser Messwert ist jedoch nur in zwei Berichten enthalten, die mit diesem Update eingestellt werden. Wie oben beschrieben, wurde dieser Messwert in neueren Versionen dieser Berichte in estimated_partner_ad_auction_revenue umbenannt.
    • Der Name des Messwerts „estimated_partner_doubleclick_revenue“ wurde in „estimated_partner_double_click_revenue“ geändert. Dieser Messwert ist nur in zwei Berichten enthalten, die mit diesem Update eingestellt werden. Wie oben beschrieben, wurde dieser Messwert in neueren Versionen dieser Berichte in estimated_partner_ad_reserved_revenue umbenannt.

  • Die Dokumentation zu Dimensionen für die Reporting API wurde aktualisiert. Die Properties elapsed_video_time_percentage und audience_retention_type sind nicht mehr aufgeführt. Diese Dimensionen werden derzeit von keinen Berichten unterstützt, die über die API verfügbar sind.

19. Mai 2016

Dieses Update enthält die folgenden Änderungen an der YouTube Reporting API:

  • Die API unterstützt eine neue Version des Berichts zur Nutzeraktivität für Rechteinhaber. Die Berichtstyp-ID für den neuen Bericht ist content_owner_basic_a2. Im Gegensatz zur vorherigen Version des Berichts, content_owner_basic_a1, werden in der neuen Version die Messwerte likes und dislikes unterstützt.

    Wenn Sie bereits einen Job zum Erstellen des Berichts content_owner_basic_a1 haben, müssen Sie trotzdem einen neuen Job für den Bericht content_owner_basic_a2 erstellen. YouTube migriert Rechteinhaber nicht automatisch zur neuen Berichtsversion und erstellt auch keinen Job zum Generieren der neuen Berichtsversion. In einigen Implementierungen kann das Auftreten eines neuen, unerwarteten Jobs eine schwerwiegende Änderung sein.

    Mit der Einführung des neuen Berichts wurde der Bericht content_owner_basic_a1 eingestellt. Wenn Sie einen Job für diesen Bericht haben, sollten Sie nicht erwarten, dass YouTube nach dem 19. August 2016 neue Berichte für diesen Job generiert. Generierte Berichte sind weiterhin 180 Tage lang verfügbar.

  • Die Ressourcen reportType, job und report unterstützen alle ein neues Attribut, das angibt, ob die zugehörige Ressource einen eingestellten Berichtstyp darstellt:

    • Die deprecateTime-Property der reportType-Ressource gibt das Datum und die Uhrzeit an, zu der der Berichtstyp eingestellt wird. Diese Eigenschaft hat nur einen Wert für Berichte, die als eingestellt angekündigt wurden. Der Wert gibt das Datum an, an dem YouTube keine Berichte dieses Typs mehr generiert.

      Nachdem ein Berichtstyp als eingestellt angekündigt wurde, generiert YouTube noch drei Monate lang Berichte dieses Typs. In dieser Aktualisierung vom 19. Mai 2016 wird beispielsweise die Einstellung des Berichts content_owner_basic_a1 angekündigt. Daher gibt deprecateTime für diesen Berichtstyp einen Zeitpunkt am 19. August 2016 an, nach dem YouTube keine Berichte dieses Typs mehr generiert.

    • Mit der expireTime-Eigenschaft der job-Ressource wird das Datum und die Uhrzeit angegeben, an dem der Job abgelaufen ist oder abläuft. Diese Property hat einen Wert, wenn der mit dem Job verknüpfte Berichtstyp eingestellt wurde oder wenn für den Job generierte Berichte über einen längeren Zeitraum nicht heruntergeladen wurden. Das Datum gibt an, ab wann YouTube keine neuen Berichte mehr für den Job generiert.

    • In der Eigenschaft jobExpireTime der Ressource report wird das Datum und die Uhrzeit angegeben, zu der der mit dem Bericht verknüpfte Job abgelaufen ist oder abläuft. Dieses Attribut enthält denselben Wert wie das Attribut expireTime in der Ressource job, wie im vorherigen Element in dieser Liste beschrieben.

  • Die Methode jobs.create gibt jetzt den HTTP-Antwortcode 400 (Bad Request) zurück, wenn Sie versuchen, einen Job für einen eingestellten Bericht zu erstellen. Außerdem sind in der Dokumentation der Methode jetzt mehrere andere Gründe aufgeführt, die dazu führen, dass eine API-Anfrage fehlschlägt.

12. April 2016

Dieses Update enthält die folgenden Änderungen, die sich alle nur auf die YouTube Reporting API auswirken:

  • YouTube generiert jetzt Daten für den Zeitraum von 180 Tagen vor dem Zeitpunkt, an dem ein Berichterstellungsjob zum ersten Mal geplant wurde. Bisher wurden über die Reporting API keine Verlaufsdaten bereitgestellt. Diese Änderung betrifft alle Jobs, auch solche, die vor dieser Ankündigung erstellt wurden.

    Verlaufsberichte werden veröffentlicht, sobald sie verfügbar sind. Es dauert jedoch etwa einen Monat, bis alle Verlaufsdaten für einen Job veröffentlicht werden. Einen Monat nach der Planung eines Berichtsjobs haben Sie also Zugriff auf Daten aus etwa sieben Monaten. (Alle Verlaufsdaten für Jobs, die vor dieser Ankündigung erstellt wurden, sollten innerhalb eines Monats nach der Ankündigung veröffentlicht werden.)

    Verlaufsdaten sind erst ab dem 1. Juli 2015 verfügbar. Daher enthalten Jobs, die vor dem 28. Dezember 2015 erstellt wurden, weniger als 180 Tage an Verlaufsdaten.

    Diese Änderungen werden alle im neuen Abschnitt Verlaufsdaten in der Übersicht zur Reporting API erläutert.

  • Der Abschnitt Berichtseigenschaften in der Übersicht zur YouTube Reporting API wurde mit den folgenden Änderungen aktualisiert:

    • In der Dokumentation wird jetzt angegeben, dass Berichte 180 Tage nach ihrer Generierung verfügbar sind und daher von API-Clients heruntergeladen werden können. Bisher wurde in der Dokumentation angegeben, dass Berichte für einen Zeitraum von bis zu sechs Monaten vor dem Datum verfügbar sind, an dem die API-Anfrage gesendet wird.

    • Die Dokumentation wurde aktualisiert, um zu berücksichtigen, dass die API jetzt herunterladbare Berichte für Tage generiert, an denen keine Daten verfügbar waren. Diese Berichte enthalten Kopfzeilen, aber keine zusätzlichen Daten.

  • Die YouTube Reporting API unterstützt bald eine Reihe von automatisch generierten, systemverwalteten Berichten, die Daten zu Werbeeinnahmen oder YouTube Red-Abonnement-Einnahmen enthalten. Die Berichte sind für Rechteinhaber verfügbar, die bereits auf manuell herunterladbare Umsatzberichte in YouTube Studio zugreifen können. Die neue API-Funktionalität bietet also programmatischen Zugriff auf diese Daten.

    Die folgenden API-Änderungen werden jetzt angekündigt, um die Einführung von systemverwalteten Berichten vorzubereiten:

    • Die neue systemManaged-Eigenschaft der job-Ressource gibt an, ob die Ressource einen Job beschreibt, mit dem von Systemen verwaltete Berichte generiert werden. YouTube generiert automatisch systemverwaltete Berichte für YouTube-Rechteinhaber. Rechteinhaber können Jobs, mit denen diese Berichte erstellt werden, nicht ändern oder löschen.

    • Der neue includeSystemManaged-Parameter der Methode jobs.list gibt an, ob die API-Antwort Jobs für systemverwaltete Berichte enthalten soll. Der Standardwert des Parameters ist false.

    • Der neue startTimeAtOrAfter-Parameter der jobs.reports.list-Methode gibt an, dass die API-Antwort nur Berichte enthalten soll, wenn die frühesten Daten im Bericht am oder nach dem angegebenen Datum liegen. Entsprechend gibt der Parameter startTimeBefore an, dass die API-Antwort nur Berichte enthalten soll, wenn die frühesten Daten im Bericht vor dem angegebenen Datum liegen.

      Im Gegensatz zum createdAfter-Parameter der Methode, der sich auf den Zeitpunkt bezieht, zu dem der Bericht erstellt wurde, beziehen sich die neuen Parameter auf die Daten im Bericht.

    • Das neue Attribut systemManaged der Ressource reportType gibt an, ob die Ressource einen vom System verwalteten Bericht beschreibt.

    • Der neue Parameter includeSystemManaged der Methode reportTypes.list gibt an, ob die API-Antwort von Google verwaltete Berichte enthalten soll. Der Standardwert des Parameters ist false.

28. März 2016

Die YouTube Reporting API und die YouTube Analytics API geben jetzt Aufrufstatistiken für mehrere zusätzliche Sharing-Dienste zurück.

  • In der YouTube Reporting API unterstützt die Dimension sharing_service die folgenden neuen Werte:
    • 82: Dialogfeld für iOS-Systemaktivitäten
    • 83: Google Inbox
    • 84: Android Messenger
  • In der YouTube Analytics API unterstützt die Dimension sharingService die folgenden neuen Werte:
    • ANDROID_MESSENGER: Android Messenger
    • INBOX: Google Inbox
    • IOS_SYSTEM_ACTIVITY_DIALOG: Dialogfeld für iOS-Systemaktivitäten

16. März 2016

Dieses Update enthält die folgenden Änderungen, die sich sowohl auf die YouTube Reporting API als auch auf die YouTube Analytics API auswirken:

YouTube Reporting API

  • Die Dimension playback_location_type unterstützt zwei neue Dimensionswerte:
    • 7: Die Daten beziehen sich auf Aufrufe auf der YouTube-Startseite oder dem Startbildschirm, im Abo-Feed des Nutzers oder in einer anderen YouTube-Browsing-Funktion.
    • 8: Die Daten beziehen sich auf Aufrufe, die direkt auf der YouTube-Suchergebnisseite erfolgt sind.
  • Die Dimension traffic_source_type unterstützt jetzt 18 als Dimensionswert. Dieser Wert gibt an, dass die Videoaufrufe von einer Seite stammen, auf der alle Videos in einer Playlist aufgeführt sind. Diese Quelle unterscheidet sich vom Quelltyp 14, der angibt, dass die Aufrufe erfolgten, während das Video als Teil einer Playlist wiedergegeben wurde.

YouTube Analytics API

  • Die Dimension insightPlaybackLocationType unterstützt zwei neue Dimensionswerte:
    • BROWSE: Die Daten beziehen sich auf Aufrufe auf der YouTube-Startseite oder dem Startbildschirm, im Abo-Feed des Nutzers oder in einer anderen YouTube-Browsing-Funktion.
    • SEARCH: Die Daten beziehen sich auf Aufrufe, die direkt auf der YouTube-Suchergebnisseite erfolgt sind.
  • Die Dimension insightTrafficSourceType unterstützt jetzt YT_PLAYLIST_PAGE als Dimensionswert. Dieser Wert gibt an, dass die Videoaufrufe von einer Seite stammen, auf der alle Videos in einer Playlist aufgeführt sind. Diese Quelle unterscheidet sich vom Quelltyp PLAYLIST, der angibt, dass die Aufrufe erfolgten, während das Video als Teil einer Playlist wiedergegeben wurde.

8. Februar 2016

Die Liste der für die YouTube Analytics API unterstützten Messwerte wurde aktualisiert. Kartenmesswerte werden nicht mehr als unterstützte Messwerte für diese API aufgeführt. Keiner der Berichte dieser API wurde als Unterstützung für einen der Kartenmesswerte dokumentiert.

Du kannst Kartenmesswerte weiterhin über die YouTube Reporting API abrufen. Diese Messwerte werden in zahlreichen Kanal- und Rechteinhaber-Berichten unterstützt.

6. Januar 2016

In der YouTube Reporting API und der YouTube Analytics API werden Aufrufe, die über ein Chromecast-Gerät erfolgen, jetzt speziell gekennzeichnet.

  • In der YouTube Reporting API wird für die Dimension operating_system der Wert 21 verwendet, um Aufrufe über Chromecast zu identifizieren.
  • In der YouTube Analytics API wird für die Dimension operatingSystem der Wert CHROMECAST verwendet, um Aufrufe über Chromecast zu identifizieren.

21. Dezember 2015

In der Dokumentation wurden die Namen der Messwerte annotation_clickable_impressions und annotation_closable_impressions aktualisiert, damit sie mit den Namen übereinstimmen, die in den Berichten zurückgegeben werden. Bisher wurden die Namen als clickable_annotation_impressions und closable_annotation_impressions dokumentiert.

18. Dezember 2015

Laut EU-Gesetzen müssen bestimmte Informationen für Endnutzer in der EU offengelegt und ihre Einwilligung eingeholt werden. Daher müssen Sie für Endnutzer in der Europäischen Union die Richtlinie zur Einwilligung der Nutzer in der EU einhalten. Wir haben einen Hinweis auf diese Anforderung in unsere Nutzungsbedingungen für die YouTube-APIs aufgenommen.

15. Dezember 2015

Dieses Update enthält die folgenden Änderungen, die sich alle auf die YouTube Analytics API auswirken:

  • Die YouTube Analytics API unterstützt jetzt drei neue Wiedergabedetaildimensionen, die in verschiedenen Berichten für Kanal- und Rechteinhaber verwendet werden können:

    • liveOrOnDemand: Diese Dimension gibt an, ob sich die Daten im Bericht auf Nutzeraktivitäten während einer Liveübertragung beziehen.
    • subscribedStatus: Diese Dimension gibt an, ob die Messwerte für Nutzeraktivitäten in den Daten mit Zuschauern verknüpft sind, die den Kanal des Videos oder der Playlist abonniert haben.
    • youtubeProduct: Mit dieser Dimension wird die YouTube-Property identifiziert, auf der die Nutzeraktivität stattgefunden hat. Mögliche Werte sind die Haupt-YouTube-Website (oder die YouTube App), YouTube Gaming und YouTube Kids.

    Die Dokumentation wurde aktualisiert und enthält jetzt neue Berichte mit Wiedergabedetails, die für Kanäle und Rechteinhaber verfügbar sind. Außerdem wurde in vielen anderen Berichten darauf hingewiesen, dass eine oder mehrere dieser Dimensionen optional als Dimensionen und/oder Filter in diesen Berichten verwendet werden können.

  • Das Format der Tabellen, in denen die Berichte erläutert werden, wurde geändert. So können Sie leichter gültige Kombinationen von Dimensionen, Messwerten und Filtern ermitteln, mit denen die einzelnen Berichte abgerufen werden können. In der folgenden Tabelle, in der der Bericht „Gerätetyp“ für Channels erläutert wird, sehen Sie das neue Format:

    Inhalt
    Abmessungen:
    Erforderlich deviceType
    Verwenden Sie 0 oder mehr. day, liveOrOnDemand, subscribedStatus, youtubeProduct
    Messwerte:
    Mindestens 1 Aufrufe, estimatedMinutesWatched
    Filter:
    „0“ oder „1“ verwenden country, province, continent, subContinent
    „0“ oder „1“ verwenden Video, Gruppe
    Verwenden Sie 0 oder mehr. operatingSystem, liveOrOnDemand, subscribedStatus, youtubeProduct

    Die Terminologie zur Beschreibung von Pflicht- und optionalen Feldern wird in der Dokumentation für channel- und content owner-Berichte erläutert.

  • Bei Filtern, die mehrere Werte unterstützen (video, playlist und channel), werden Entitäten, für die der API-Nutzer keine Daten abrufen kann, jetzt automatisch aus der YouTube Analytics API entfernt. Bisher hat der API-Server nur einen Fehler zurückgegeben, wenn der API-Nutzer nicht auf Daten für mindestens eines der angegebenen Elemente zugreifen konnte.

    Angenommen, ein Nutzer sendet eine API-Anfrage, in der im Filter video 20 Video-IDs aufgeführt sind. Der Nutzer ist Inhaber von 18 Videos. Eine Video-ID verweist jedoch auf ein Video, das einem anderen Kanal gehört, und eine andere ID verweist auf ein Video, das gelöscht wurde und daher nicht mehr vorhanden ist. In diesem Fall gibt der API-Server nicht mehr einen Fehler zurück, sondern entfernt die beiden Videos, auf die der Nutzer nicht zugreifen kann. Die API-Antwort enthält Daten für die 18 Videos, die dem API-Nutzer gehören.

  • Wenn Sie Daten für ein leeres YouTube Analytics-group anfordern, gibt die API jetzt ein leeres Dataset anstelle eines Fehlers zurück.

  • Die Methode groupItems.insert der YouTube Analytics API gibt jetzt einen Fehler vom Typ „Nicht autorisiert“ (HTTP-Antwortcode 403) zurück, wenn Sie versuchen, einer Gruppe eine Entität hinzuzufügen, auf die Sie keinen Zugriff haben. Bisher konnten Sie die Einheit über die API der Gruppe hinzufügen, aber später wurde ein Autorisierungsfehler zurückgegeben, wenn Sie versucht haben, Berichtsdaten für diese Gruppe abzurufen.

  • Die groups.list-Methode der YouTube Analytics API unterstützt jetzt die Paginierung. Wenn die API-Antwort nicht alle verfügbaren Gruppen enthält, gibt der Parameter nextPageToken der Antwort ein Token an, mit dem die nächste Ergebnisseite abgerufen werden kann. Legen Sie den pageToken-Parameter der Methode auf diesen Wert fest, um zusätzliche Ergebnisse abzurufen.

10. November 2015

Dieses Update enthält die folgenden Änderungen:

29. Oktober 2015

Dieses Update enthält die folgenden Änderungen:

  • Die Dokumentation für die Dimension date der YouTube Reporting API wurde korrigiert. Das Datum bezieht sich auf den 24-Stunden-Zeitraum ab 00:00 Uhr Pacific Time (UTC-8). Bisher wurde in der Dokumentation angegeben, dass das Datum um 00:00 Uhr GMT beginnt.

    Außerdem wurde die Dokumentation zur YouTube Analytics API aktualisiert. Dort wird jetzt darauf hingewiesen, dass sich alle datumsbezogenen Dimensionen (day, 7DayTotals, 30DayTotals und month) auf Daten ab 00:00 Uhr pazifischer Zeit (UTC-8) beziehen.

  • Die jobs.reports.list()-Methode der YouTube Reporting API unterstützt jetzt den Abfrageparameter createdAfter. Wenn dieser Parameter angegeben ist, enthält die API-Antwort nur Berichte, die nach dem angegebenen Datum und der angegebenen Uhrzeit erstellt wurden, einschließlich neuer Berichte mit nachgetragenen Daten. Der Parameterwert bezieht sich auf den Zeitpunkt, zu dem der Bericht erstellt wird, und nicht auf die Datumsangaben, die den zurückgegebenen Daten zugeordnet sind.

    Der Parameterwert ist ein Zeitstempel im Format RFC3339 UTC „Zulu“ in Mikrosekunden. Beispiel: "2015-10-02T15:01:23.045678Z".

    Die Best Practices für die YouTube Reporting API wurden ebenfalls aktualisiert. Dort wird jetzt beschrieben, wie du den Parameter createdAfter verwenden kannst, um zu vermeiden, dass derselbe Bericht wiederholt verarbeitet wird.

  • Die Definitionen der Attribute createTime der Ressource job und startTime, endTime und createTime der Ressource report wurden korrigiert. Die Attributwerte sind auf Mikrosekunden genau, nicht auf Nanosekunden. Außerdem wird in allen Definitionen jetzt korrekt angegeben, dass der Property-Wert ein Zeitstempel ist.

8. Oktober 2015

Dieses Update enthält die folgenden Änderungen:

  • Die Dokumentation für die Dimension sharingService der YouTube Analytics API wurde aktualisiert und enthält jetzt eine Liste der möglichen Dimensionswerte. Die Liste enthält eine Reihe neu unterstützter Dienste.

    Die Definition der Dimension sharing_service in der YouTube Reporting API wurde ebenfalls aktualisiert, um die neu unterstützten Werte aufzulisten. Die Enumerationswerte, die größer als 59 sind, sind die neuen in der Liste.

24. September 2015

Dieses Update enthält die folgenden Änderungen:

  • Mit der neuen YouTube Reporting API können Bulk-Berichte mit YouTube Analytics-Daten für einen Kanal oder Rechteinhaber abgerufen werden. Sie ist für Anwendungen konzipiert, mit denen große Datasets importiert werden können und die Tools zum Filtern, Sortieren und Mining dieser Daten bieten.

    Jeder Bericht der YouTube Reporting API enthält einen vordefinierten Satz von Dimensionen und Messwerten. (In YouTube Analytics API-Berichten werden ebenfalls Messwerte und Dimensionen verwendet.) In einem Bericht hat jede Datenzeile eine eindeutige Kombination von Dimensionswerten. Sie können Daten zeilenweise anhand von Dimensionswerten aggregieren, um Messwerte für einzelne Videos, Länder, Live-Videos, Abonnenten usw. zu berechnen.

    Mit der API können Sie Berichtsjobs planen, mit denen jeweils ein Bericht angegeben wird, der von YouTube generiert werden soll. Nachdem Sie einen Job eingerichtet haben, wird täglich ein Bericht generiert, der asynchron heruntergeladen werden kann. Jeder Bericht enthält Daten für einen eindeutigen 24-Stunden-Zeitraum.

  • Obwohl es sich um unterschiedliche APIs handelt, können Entwickler mit der YouTube Analytics API und der YouTube Reporting API YouTube Analytics-Daten abrufen. Da beide APIs Zugriff auf ähnliche Datasets bieten, wird die Dokumentation für die beiden APIs als ein einzelnes Dokument veröffentlicht.

    • Der Tab Anleitungen in der Dokumentation enthält Informationen, die für beide APIs gelten, einschließlich Anleitungen zum Autorisieren von API-Anfragen.
    • Der Tab Bulk-Berichte enthält Referenzdokumentation und andere Inhalte speziell für die YouTube Reporting API.
    • Der Tab Gezielte Anfragen enthält Referenzdokumentation und andere Inhalte speziell für die YouTube Analytics API.
    • Auf dem Tab Beispiele werden Codebeispiele für die beiden APIs aufgeführt.
    • Auf dem Tab Tools finden Sie zusätzliche Ressourcen, die Entwicklern bei der Implementierung der beiden APIs helfen.

20. August 2015

Dieses Update enthält die folgenden Änderungen:

  • Die API-Dokumentation wurde neu strukturiert, um die API verständlicher zu machen. Daher werden in diesen Änderungen keine neuen Funktionen beschrieben:

    • Die Dokumentation enthält jetzt eine Seite mit allen verfügbaren Kanalberichten und eine weitere mit allen verfügbaren Berichten für Rechteinhaber. Bisher gab es in der Dokumentation separate Seiten für Berichte zu Kanalvideos, Berichte zu Kanal-Playlists usw.

    • Die neue Übersicht über das Datenmodell soll eine klarere Einführung in die Funktionsweise der API bieten. In diesem Dokument wird genauer erläutert, wie YouTube Messwerte, Dimensionen und Filter verwendet, um Berichtswerte zu berechnen.

    • Die Methode reports.query der API, mit der Sie Berichte abrufen, ist jetzt separat dokumentiert. Die Informationen auf dieser Seite waren zuvor auf anderen Seiten verfügbar. Auf der neuen Seite finden Sie leichter die Informationen, die Sie zum Abrufen eines Berichts senden müssen.

22. Juli 2015

Dieses Update enthält mehrere Änderungen, die sich alle nur auf Rechteinhaber auswirken:

  • Der neue Messwert adEarnings umfasst die geschätzten Gesamteinnahmen (Nettoumsatz) aus allen von Google verkauften Werbequellen. Es handelt sich nicht um einen Kernmesswert. Die API unterstützt den Messwert adEarnings für alle Berichte, die bereits den Messwert earnings unterstützt haben.

    Außerdem wurde die Definition des Messwerts earnings korrigiert. Der Wert umfasst die geschätzten Gesamteinnahmen aus allen von Google verkauften Werbequellen sowie aus nicht werbebezogenen Quellen. Bisher wurde in der Definition fälschlicherweise angegeben, dass der Messwert nur Einnahmen aus Werbequellen umfasst.

  • Der Messwert primaryAdGrossRevenue wurde eingestellt. Verwenden Sie stattdessen den Messwert grossRevenue, um Umsatzdaten abzurufen.

  • Zusätzlich zum eingestellten Messwert primaryAdGrossRevenue werden die Messwerte monetizedPlaybacks und playbackBasedCpm in Berichten zur Anzeigenleistung nicht mehr unterstützt. In einigen Videoberichten werden diese Messwerte jedoch weiterhin unterstützt.

1. Juni 2015

Dieses Update enthält die folgenden Änderungen:

  • Die API unterstützt jetzt zwei neue Messwerte für Videoberichte: videosAddedToPlaylists und videosRemovedFromPlaylists. Die Listen der Videoberichte für Kanäle und Inhaltsinhaber wurden aktualisiert, um die Berichte zu kennzeichnen, die die neuen Messwerte unterstützen.

    • videosAddedToPlaylists: Die Anzahl der Zugriffe, bei denen Videos im Bereich der Abfrage zu YouTube-Playlists hinzugefügt wurden. Die Videos wurden möglicherweise der Playlist des Videoinhabers oder den Playlists anderer Kanäle hinzugefügt.
    • videosRemovedFromPlaylists: Die Anzahl der Videos im Bereich der Abfrage, die aus YouTube-Playlists entfernt wurden. Die Videos wurden möglicherweise aus der Playlist des Videoinhabers oder aus Playlists anderer Kanäle entfernt.

    Beide Messwerte umfassen Standardplaylists wie die Playlist „Später ansehen“. Playlists, denen ein Video automatisch hinzugefügt wird, z. B. die Upload-Playlist eines Kanals oder der Wiedergabeverlauf eines Nutzers, werden jedoch nicht berücksichtigt. Außerdem spiegeln diese Messwerte die absolute Anzahl der Hinzufügungen und Löschungen wider. Wenn ein Nutzer also ein Video einer Playlist hinzufügt, es dann wieder entfernt und es dann noch einmal hinzufügt, wird in den Messwerten angezeigt, dass das Video zwei Playlists hinzugefügt und aus einer entfernt wurde.

    Daten für diese Messwerte sind ab dem 1. Oktober 2014 verfügbar.

31. März 2015

Dieses Update enthält die folgenden Änderungen:

  • Die Messwerte favoritesAdded und favoritesRemoved werden mit dieser Ankündigung eingestellt. Beide sind wichtige Messwerte und unterliegen der Richtlinie zur Einstellung von Produkten und Diensten, die in den Nutzungsbedingungen beschrieben ist.

16. März 2015

Dieses Update enthält die folgenden Änderungen:

  • Mit dem neuen Parameter currency können Sie Messwerte für Einnahmen in einer anderen Währung als US-Dollar (USD) abrufen. Wenn der Parameter festgelegt ist, werden die Werte für die Messwerte earnings, grossRevenue, playbackBasedCpm und impressionBasedCpm in der API in die angegebene Währung umgerechnet. Die zurückgegebenen Werte sind Schätzungen, die anhand von Wechselkursen berechnet werden, die sich täglich ändern.

    Der Parameterwert ist ein dreistelliger Währungscode nach ISO 4217. Der Standardwert ist USD. Die Parameterdefinition enthält eine Liste der unterstützten Währungscodes.

25. Februar 2015

Dieses Update enthält die folgenden Änderungen:

  • Die API unterstützt jetzt das Erstellen und Verwalten von YouTube Analytics-Gruppen sowie das Abrufen von Berichtsdaten für diese Gruppen.

    • Gruppen erstellen und verwalten

      Mit diesem Update werden die Ressourcen group und groupItem zum Erstellen und Verwalten von Gruppen eingeführt.

      • Die group-Ressource steht für eine Analytics-Gruppe, eine benutzerdefinierte Sammlung von bis zu 200 Kanälen, Videos, Playlists oder Assets. Die API unterstützt die Methoden list, insert, update und delete für diese Ressource.
      • Die groupItem-Ressource stellt ein Element in einer Analytics-Gruppe dar. Die API unterstützt die Methoden list, insert und delete für diese Ressource.

      Sie können beispielsweise eine Gruppe mit der Methode groups.insert erstellen und dann mit der Methode groupItems.insert Elemente zu dieser Gruppe hinzufügen.

    • Berichtsdaten für eine Gruppe abrufen

      Die Dokumentation zu Dimensionen wurde um die Dimension group erweitert. Sie kann als Filter für viele Kanalberichte und Berichte für Rechteinhaber verwendet werden. Wenn Sie den Filter group verwenden, gibt die API Daten für alle Elemente in dieser Gruppe zurück. Derzeit können mit der API keine Berichte für Asset-Gruppen erstellt werden.

    Weitere Informationen zu YouTube Analytics-Gruppen findest du in der YouTube-Hilfe.

13. Februar 2015

Dieses Update enthält die folgenden Änderungen:

  • Die Dimension show wird von der API nicht mehr unterstützt.

28. August 2014

Dieses Update enthält die folgenden Änderungen:

  • Die API unterstützt jetzt die Angabe mehrerer Werte für die Dimensionen video, playlist, channel und show, wenn diese Dimensionen als Filter verwendet werden. Wenn Sie mehrere Werte angeben möchten, legen Sie den Parameterwert filters auf eine durch Kommas getrennte Liste der Video-, Playlist-, Kanal- oder Serien-IDs fest, nach denen die API-Antwort gefiltert werden soll. Im Parameterwert können bis zu 200 IDs angegeben werden.

    Wenn Sie mehrere Werte für denselben Filter angeben, können Sie diesen Filter auch der Liste der Dimensionen hinzufügen, die Sie für die Anfrage angeben. Dies gilt auch, wenn der Filter nicht als unterstützte Dimension für einen bestimmten Bericht aufgeführt ist. Wenn Sie den Filter der Liste der Dimensionen hinzufügen, werden die Ergebnisse in der API auch anhand der Filterwerte gruppiert.

    Vollständige Informationen zu dieser Funktion finden Sie in der Parameterdefinition für filters.

16. Juli 2014

Dieses Update enthält die folgenden Änderungen:

  • Wenn Sie einen Kanalbericht abrufen, können Sie jetzt Daten für den Kanal des authentifizierten Nutzers abrufen, indem Sie den Wert des Parameters ids auf channel==MINE setzen. Sie können den Parameter ids auch weiterhin auf channel==CHANNEL_ID setzen, um Daten für den angegebenen Channel abzurufen.

  • Die API unterstützt jetzt Playlist-Berichte, die Statistiken zu Videoaufrufen enthalten, die im Kontext einer Playlist erfolgen. Playlist-Berichte sind für Kanäle und Rechteinhaber verfügbar.

    Alle Playlist-Berichte unterstützen die Messwerte views und estimatedMinutesWatched. Einige unterstützen auch den Messwert averageViewDuration.

    Außerdem werden in allen Playlist-Berichten die folgenden neuen Messwerte unterstützt. Beachte, dass diese Messwerte nur Playlist-Aufrufe im Web widerspiegeln.

    • playlistStarts: Gibt an, wie häufig Zuschauer die Wiedergabe einer Playlist gestartet haben.
    • viewsPerPlaylistStart: Die durchschnittliche Anzahl der Videoaufrufe, die bei jedem Start einer Playlist erzielt wurden.
    • averageTimeInPlaylist: Die geschätzte durchschnittliche Zeit in Minuten, die ein Zuschauer Videos in einer Playlist angesehen hat, nachdem die Playlist gestartet wurde.

    Für jede Anfrage zum Abrufen eines Playlist-Berichts muss der Filter isCurated verwendet werden, der auf 1 (isCurated==1) festgelegt sein muss.

  • Die API unterstützt jetzt einen Bericht zur Zuschauerbindung. In diesem Bericht wird gemessen, wie gut ein Video Zuschauer binden kann. Mit der neuen Dimension elapsedVideoTimeRatio im Bericht wird gemessen, wie viel vom Video für die entsprechenden Messwerte vergangen ist:

    • Der Messwert audienceWatchRatio gibt das absolute Verhältnis der Zuschauer an, die das Video zu einem bestimmten Zeitpunkt ansehen. Das Verhältnis wird berechnet, indem die Anzahl der Aufrufe eines Videoteils mit der Gesamtzahl der Aufrufe des Videos verglichen wird.

      Es ist möglich, dass ein Teil eines Videos bei einem Aufruf mehrmals oder gar nicht angesehen wird. Wenn Nutzer beispielsweise ein Video zurückspulen und sich denselben Teil mehrmals ansehen, kann das absolute Verhältnis für diesen Teil des Videos größer als 1 sein.

    • Der Messwert relativeRetentionPerformance gibt an, wie gut ein Video Zuschauer während der Wiedergabe im Vergleich zu allen YouTube-Videos ähnlicher Länge binden kann. Ein Wert von 0 bedeutet, dass die Zuschauerbindung des Videos schlechter ist als bei allen anderen Videos ähnlicher Länge. Ein Wert von 1 bedeutet, dass die Zuschauerbindung des Videos besser ist als bei allen anderen Videos ähnlicher Länge. Ein Medianwert von 0,5 bedeutet, dass bei der Hälfte der Videos mit ähnlicher Länge die Zuschauerbindung besser ist und bei der anderen Hälfte schlechter.

    Sie können auch den Filter audienceType verwenden, damit im Bericht nur Daten zu organischen Aufrufen, Aufrufen von TrueView In-Stream-Anzeigen oder Aufrufen von TrueView In-Display-Anzeigen angezeigt werden. Organische Aufrufe sind das direkte Ergebnis von Nutzeraktionen, z. B. einer Suche nach einem Video oder einem Klick auf ein vorgeschlagenes Video.

  • Die API unterstützt mehrere neue Messwerte im Zusammenhang mit Anmerkungen. Die unten aufgeführten Messwerte können mit allen Berichten abgerufen werden, in denen die Messwerte annotationClickThroughRate und annotationCloseRate bisher unterstützt wurden.

    Alle neuen Messwerte sind Kernmesswerte und unterliegen der Richtlinie zur Einstellung. Daten für die neuen Messwerte sind jedoch erst ab dem 16. Juli 2013 verfügbar. Daten für die Messwerte annotationClickThroughRate und annotationCloseRate sind ab dem 10. Juni 2012 verfügbar.

  • GOOGLE_SEARCH wird nicht mehr als separater Wert für die Dimension insightTrafficSourceType erfasst. Stattdessen werden Verweise aus Google-Suchergebnissen jetzt dem Zugriffsquellentyp EXT_URL zugeordnet. Daher ist es auch nicht mehr möglich, einen insightTrafficSourceDetail-Bericht abzurufen, in dem der Filter insightTrafficSourceType auf GOOGLE_SEARCH festgelegt ist.

31. Januar 2014

Dieses Update enthält die folgenden Änderungen:

16. Januar 2014

Dieses Update enthält die folgenden Änderungen:

  • Das Dokument Beispielanfragen wurde neu gestaltet. Die Beispiele sind jetzt in Kategorien gruppiert und werden in einem Tab-Format angezeigt, das dem Format ähnelt, das vor Kurzem für Berichte für Kanal- und Rechteinhaber eingeführt wurde. Im neuen Design sind die Beispiele in die folgenden Kategorien unterteilt:

    • Grundlegende Statistiken
    • Zeitbasiert
    • Zielregion
    • Wiedergabeort
    • Zugriffsquelle
    • Gerät/Betriebssystem
    • Demografische Gruppe
    • Sozial
    • Einnahmen/Anzeigen (nur für Berichte für Rechteinhaber)

  • Das Dokument Beispielanfragen enthält jetzt neue Beispiele für das Abrufen von provinzspezifischen Daten in Kanalberichten oder Berichten für Rechteinhaber.

    • Provinzspezifische Messwerte für US-Bundesstaaten und Washington, D.C.: Dieser Bericht ruft eine Aufschlüsselung der Aufrufzahlen und anderer Statistiken für die Videos eines Kanals nach Provinz ab. Die Daten umfassen US-Bundesstaaten und Washington D.C. Im Beispiel wird die Dimension province verwendet. Außerdem wird der Parameter filters verwendet, um die Antwort auf Ergebnisse für die USA zu beschränken.

    • Demografische Merkmale der Zuschauer in Kalifornien (Altersgruppe und Geschlecht): Dieser Bericht enthält Statistiken zur Altersgruppe und zum Geschlecht von Zuschauern in Kalifornien, die sich Videos eines Kanals oder, bei Berichten für Rechteinhaber, beanspruchte Inhalte eines Rechteinhabers angesehen haben. In diesem Beispiel wird der Parameter filters verwendet, um sicherzustellen, dass die Antwort nur Daten für eine bestimmte Provinz enthält.

  • Die Definition der Dimension province wurde aktualisiert. Wenn province im Parameterwert dimensions enthalten ist, müssen die Daten in der Anfrage auch auf die USA beschränkt werden. Dazu muss country==US im Parameterwert filters enthalten sein.

6. Januar 2014

Dieses Update enthält die folgenden Änderungen:

  • Die Dokumente mit den unterstützten Kanal- und Rechteinhaber-Berichten wurden überarbeitet. Anstelle einer Tabelle mit allen möglichen Berichten werden die Berichte in den einzelnen Dokumenten in Kategorien gruppiert:

    • Grundlegende Statistiken
    • Zeitbasiert
    • Zielregion
    • Wiedergabeort
    • Zugriffsquelle
    • Gerät/Betriebssystem
    • Demografische Gruppe
    • Sozial
    • Top-Videos

    In jedem Dokument werden diese Kategorien als Liste von Tabs angezeigt. Sie können auf einen beliebigen Tab klicken, um die unterstützten Berichte in dieser Kategorie aufzurufen.

  • Die API unterstützt jetzt drei neue geografische Dimensionen: province, continent und subContinent.

    • Mit der Dimension province können Sie Statistiken für US-Bundesstaaten und den District of Columbia abrufen. Die API unterstützt zwei Anwendungsfälle für diese Dimension:

      • Die API unterstützt zwei Berichte, in denen Statistiken nach Bundesstaat aufgeschlüsselt werden. Beide Berichte sind für Kanäle und Rechteinhaber verfügbar.

        • Der Bericht zu den wichtigsten Statistiken enthält verschiedene Statistiken, darunter Aufrufzahlen und geschätzte Wiedergabeminuten.
        • Der zeitbasierte Bericht enthält dieselben Statistiken, aggregiert die Daten aber auf täglicher, 7‑Tages-, 30‑Tages- oder monatlicher Basis.

      • Mit dem Abfrageparameter filters können Sie einen Bericht so einschränken, dass er nur Statistiken für einen bestimmten Bundesstaat enthält. Diese Art der Filterung wird in verschiedenen Berichten unterstützt, darunter geografische Berichte, Berichte zum Wiedergabestandort, Berichte zur Traffic-Quelle, Geräteberichte, Berichte zum Betriebssystem, demografische Berichte und Berichte zu Top-Videos.

    • Mit der Dimension continent wird ein statistischer Regionscode der Vereinten Nationen (UN) angegeben, der einen Kontinent identifiziert. Diese Dimension kann nur als Filter verwendet werden.

    • Mit der Dimension subContinent wird ein statistischer Regionscode der Vereinten Nationen (UN) angegeben, der eine Unterregion eines Kontinents identifiziert. Diese Dimension kann auch nur als Filter verwendet werden.

      Da jede untergeordnete Region nur einem Kontinent zugeordnet ist, müssen Sie den Filter continent nicht zusätzlich verwenden, wenn Sie den Filter subContinent verwenden. Tatsächlich gibt die API einen Fehler zurück, wenn in einer Anfrage beide Dimensionen verwendet werden.

  • Die Dokumentation wurde korrigiert, sodass die Dimension insightTrafficSourceDetail den Wert insightTrafficSourceType PROMOTED nicht als gültigen Filterwert enthält.

30. September 2013

Dieses Update enthält die folgenden Änderungen:

  • Die YouTube Analytics API unterliegt jetzt der in den Nutzungsbedingungen beschriebenen Richtlinie zur Einstellung von Produkten und Diensten. Die nicht zum Kern gehörenden Dimensionen und Messwerte der API unterliegen jedoch nicht der Richtlinie zur Einstellung von Funktionen. Auf den Seiten Dimensionen und Messwerte werden jetzt Kerndimensionen und ‑messwerte aufgeführt. Außerdem wurden die Definitionen auf diesen Seiten aktualisiert, um explizit die wichtigsten Dimensionen und Messwerte zu identifizieren.

  • Die API unterstützt jetzt EXTERNAL_APP als Wert für die Dimension insightPlaybackLocationType. Im Zusammenhang mit dieser Änderung werden Wiedergaben ab dem 10. September 2013 nicht mehr als MOBILE-Wiedergaben kategorisiert. Mobile Wiedergaben, die vor diesem Datum stattgefunden haben, werden jedoch weiterhin mit diesem Wert kategorisiert.

    Mit diesem Update werden mobile Wiedergaben je nach Art der Anwendung, in der sie erfolgen, als WATCH-, EMBEDDED- oder EXTERNAL_APP-Wiedergaben klassifiziert.

  • Die API unterstützt jetzt PLAYLIST als Wert für die Dimension insightTrafficSourceType. Der Wert gibt an, dass Videoaufrufe von einer Playlist stammen. Bisher wurden diese Aufrufe mit der Kategorie YT_OTHER_PAGE der Dimension klassifiziert.

16. Juli 2013

Dieses Update enthält die folgenden Änderungen:

  • Die API unterstützt jetzt das Sortieren von Berichten nach mehreren Dimensionen und Messwerten. Das Dokument mit Beispielanfragen enthält ein neues Beispiel, Anfragen nach mehreren Dimensionen/Messwerten sortieren, das diese Funktion demonstriert. Mit der Anfrage werden Daten zur Traffic-Quelle abgerufen und der Parameter sort hat den Wert day,-views. Die Ergebnisse sind chronologisch sortiert. Innerhalb des Ergebnissatzes für jeden Tag enthält die erste Zeile jedoch Daten für die Traffic-Quelle, die die meisten Aufrufe generiert hat, die zweite Zeile Daten für die Quelle mit der zweithöchsten Anzahl von Aufrufen usw.

  • Die API unterstützt jetzt zwei neue Dimensionen, deviceType und operatingSystem. Mit diesen Dimensionen können Daten zu den Geräten abgerufen werden, auf denen sich Zuschauer deine Videos ansehen. Die API unterstützt Berichte, in denen eine oder beide Dimensionen verwendet werden.

    • Mit dem deviceType-Bericht können Sie Aufrufzahlen und geschätzte Wiedergabezeit für verschiedene Gerätetypen abrufen, darunter Computer, Smartphones und Tablets. Sie können auch den Filter operatingSystem verwenden, um den Bericht zum Gerätetyp auf Statistiken für Geräte mit einem bestimmten Betriebssystem wie Android oder iOS zu beschränken.

    • Mit dem Bericht operatingSystem können Sie Aufrufzahlen und geschätzte Wiedergabezeit für verschiedene Betriebssysteme wie Android, iOS und Linux abrufen. Mit dem Filter deviceType können Sie den Betriebssystembericht auch so einschränken, dass er nur Statistiken für einen bestimmten Gerätetyp enthält, z. B. für Mobilgeräte oder Tablets.

    Die neuen Berichte zu Gerätetyp und Betriebssystem sind für Kanäle und Rechteinhaber verfügbar.

  • Das Dokument Beispielanfragen wurde aktualisiert und enthält jetzt drei Geräteberichte für Kanäle und drei Geräteberichte für Rechteinhaber.

  • Für die Dimension insightPlaybackLocationType kann der Wert YT_OTHER zurückgegeben werden. Er gibt Aufrufe an, die nicht mit einem der anderen Werte der Dimension klassifiziert werden.

23. Mai 2013

Dieses Update enthält die folgenden Änderungen:

10. Mai 2013

Dieses Update enthält die folgenden Änderungen:

6. Mai 2013

Dieses Update enthält die folgenden Änderungen:

  • Über die API können jetzt Messwerte zur Wiedergabezeit – estimatedMinutesWatched, averageViewDuration und averageViewPercentage – zusammen mit anderen Messwerten abgerufen werden, darunter Messwerte zu Aufrufen, Interaktionen, Einnahmen und Anzeigenleistung.

    Die Listen der verfügbaren Kanalberichte und Berichte für Rechteinhaber wurden entsprechend aktualisiert. Die Listen sind jetzt kürzer, da die Messwerte zur Wiedergabezeit in anderen aufgeführten Berichten abgerufen werden können.

    Das Dokument Beispiel-API-Anfragen wurde ebenfalls aktualisiert.

  • Die Berichte, in denen die Dimensionen insightPlaybackLocationDetail und insightTrafficSourceDetail verwendet werden, wurden in folgenden Punkten verbessert:

    • Sie unterstützen jetzt einen optionalen country-Filter.

    • Inhaltsinhaber können diese Berichte jetzt mit einer der folgenden neuen filter-Kombinationen abrufen. Alle diese Kombinationen unterstützen auch den optionalen Filter country.

      • Details zum Wiedergabeort

        • channel,insightPlaybackLocationType==EMBEDDED
        • show,insightPlaybackLocationType==EMBEDDED
        • claimedStatus,insightPlaybackLocationType==EMBEDDED
        • uploaderType,insightPlaybackLocationType==EMBEDDED
        • uploaderType,claimedStatus,insightPlaybackLocationType==EMBEDDED

      • Details zur Besucherquelle

        • channel,insightTrafficSourceType
        • show,insightTrafficSourceType
        • claimedStatus,insightTrafficSourceType
        • uploaderType,insightTrafficSourceType
        • uploaderType,claimedStatus,insightTrafficSourceType

3. Mai 2013

Dieses Update enthält die folgenden Änderungen:

  • Das neue Dokument Beispiel-API-Anfragen enthält Beispiele dafür, wie Sie mit der YouTube Analytics API viele verschiedene Arten von Berichten abrufen können. Jedes Beispiel enthält eine kurze Beschreibung des Berichts, der mit der Anfrage abgerufen wird, sowie die Dimensionen, Messwerte, Filter und Sortierparameter für die Anfrage.

  • Für die Dimension insightTrafficSourceType wird jetzt SUBSCRIBER als gültiger Wert unterstützt. Dieser Wert gibt Aufrufe von Videos an, die über Feeds auf der YouTube-Startseite oder über YouTube-Abo-Funktionen erzielt wurden. Wenn Sie nach dieser Traffic-Quelle filtern, wird im Feld insightTrafficSourceDetail der Startseitenfeed oder eine andere Seite angegeben, von der Aufrufe weitergeleitet wurden.

28. März 2013

Dieses Update enthält die folgenden Änderungen:

  • Die API unterstützt jetzt zwei neue Messwerte: annotationClickThroughRate und annotationCloseRate. Diese beziehen sich auf die Interaktionen der Zuschauer mit Anmerkungen, die während deiner Videos angezeigt werden. Die Listen der Kanalberichte und Berichte für Rechteinhaber wurden aktualisiert, um die Berichte zu kennzeichnen, die die neuen Messwerte unterstützen.

    • annotationClickThroughRate: Das Verhältnis zwischen der Anzahl der Anmerkungen, die Zuschauer angeklickt haben, und der Gesamtzahl der Impressionen anklickbarer Anmerkungen.
    • annotationCloseRate: Das Verhältnis zwischen der Anzahl der Anmerkungen, die Zuschauer geschlossen haben, und der Gesamtzahl der Anmerkungsimpressionen.

21. März 2013

Dieses Update enthält die folgenden Änderungen:

  • Die API unterstützt jetzt Messwerte zu Einnahmen und Anzeigenleistung sowie neue Berichte zur Anzeigenleistung. Die Messwerte und Berichte sind nur für YouTube-Contentpartner verfügbar, die am YouTube-Partnerprogramm teilnehmen.

    • Die neu unterstützten Berichte enthalten Messwerte zur Anzeigenleistung, die auf Wiedergaben und Impressionen basieren. Weitere Informationen zu Berichten zur Anzeigenleistung finden Sie in der Dokumentation zu Berichten für Rechteinhaber.

    • Die neu unterstützten Messwerte sind unten aufgeführt. Die Liste der Berichte für Rechteinhaber wurde aktualisiert. Sie enthält jetzt auch die beiden neuen Berichte, die diese Messwerte unterstützen.

      • earnings – Geschätzte Gesamteinnahmen aus allen von Google verkauften Werbequellen.
      • grossRevenue – Geschätzter Bruttoumsatz von Google- oder DoubleClick-Partnern.
      • primaryAdGrossRevenue – Geschätzter Bruttoumsatz, summiert und klassifiziert nach dem primären Anzeigentyp für die im Bericht enthaltenen Videowiedergaben von Google- oder DoubleClick-Partnern.
      • monetizedPlaybacks – Die Anzahl der Wiedergaben, bei denen mindestens eine Anzeigenimpression ausgeliefert wurde.
      • playbackBasedCpm – Geschätzter Bruttoumsatz pro 1.000 Wiedergaben.
      • impressions – Die Anzahl der ausgelieferten Impressionen, die überprüft wurden.
      • impressionBasedCpm – Geschätzter Bruttoumsatz pro 1.000 Anzeigenimpressionen.

      Hinweis:Ausführliche Informationen finden Sie in den Messwertdefinitionen.

    • Für jede Anfrage, mit der Einnahmen- oder Anzeigenleistungsmesswerte abgerufen werden, muss ein Autorisierungstoken gesendet werden, das Zugriff mit dem neuen Bereich https://www.googleapis.com/auth/yt-analytics-monetary.readonly gewährt.

  • Die API-Dokumentation wurde neu organisiert, sodass verschiedene Berichtstypen auf separaten Seiten erläutert werden. Deshalb gibt es jetzt separate Seiten, auf denen die verschiedenen Arten von Kanalberichten und Berichten für Rechteinhaber erläutert werden.

4. Februar 2013

Dieses Update enthält die folgenden Änderungen:

  • Die API-Referenz enthält jetzt einen Beispielabschnitt mit Codebeispielen, die zeigen, wie die API mit den Clientbibliotheken für Java, JavaScript, Python und Ruby aufgerufen wird. Das JavaScript-Codebeispiel ist dasselbe, das in der Dokumentation zur Beispielanwendung ausführlich beschrieben wird.

14. November 2012

Dieses Update enthält die folgenden Änderungen:

  • Die API-Referenz enthält jetzt die APIs Explorer, mit der Sie die API aufrufen, die API-Anfrage aufrufen und echte Daten in der Antwort abrufen können.

  • Die API unterstützt eine Reihe neuer Berichte für Kanäle und Rechteinhaber, die unten beschrieben werden. Jeder Bericht ist als Kanalbericht oder Bericht für Rechteinhaber verfügbar. Die Seiten Dimensionen und Messwerte wurden ebenfalls entsprechend aktualisiert.

    • Im Bericht zu Wiedergabeorten sehen Sie die Anzahl der Videoaufrufe, die auf verschiedenen Arten von Seiten oder in verschiedenen Anwendungen stattgefunden haben.

    • Im Detailbericht „Wiedergabeort“ sehen Sie, mit welchen eingebetteten Playern die meisten Aufrufe für ein bestimmtes Video erzielt wurden. Dieser Bericht bietet eine detailliertere Ansicht als der Bericht zum Wiedergabeort, da die URLs der Top-Player mit Einbettung identifiziert werden.

    • Im Bericht zu Zugriffsquellen siehst du, wie viele Videoaufrufe von verschiedenen Arten von Referrern stammen.

    • Im Detailbericht zu Traffic-Quellen sehen Sie die Referrer, über die die meisten Aufrufe für ein bestimmtes Video und einen bestimmten Traffic-Quellentyp generiert wurden. So können Sie beispielsweise sehen, welche verknüpften Videos die meisten Aufrufe für ein bestimmtes Video generiert haben. Dieser Bericht wird für mehrere Traffic-Quellen unterstützt.

    • Wiedergabezeitberichte geben Aufschluss darüber, wie viel Zeit Zuschauer mit dem Ansehen deiner Inhalte verbracht haben. In den Berichten können Daten für einen bestimmten Zeitraum (Tag, letzte 7 Tage, letzte 30 Tage usw.) oder ein bestimmtes Land zusammengefasst werden. Wenn in einem Bericht Daten nach Tag oder Land zusammengefasst werden, kann auch die durchschnittliche Länge der einzelnen Videoaufrufe sowie der durchschnittliche Prozentsatz der einzelnen Videos angegeben werden, die sich Nutzer angesehen haben.

2. Oktober 2012

Dieses Update enthält die folgenden Änderungen:

  • Die YouTube Analytics API ist jetzt für alle Entwickler verfügbar. Sie können die API für Ihr Projekt aktivieren, ohne zuerst Zugriff anfordern zu müssen. Klicken Sie dazu im APIs console im Bereich Dienste auf die API.

  • Im neuen Abschnitt Erste Schritte werden die Voraussetzungen und grundlegenden Schritte zum Erstellen einer Anwendung beschrieben, die die YouTube Analytics API verwendet.

12. September 2012

Dieses Update enthält die folgenden Änderungen:

  • Der neue Abschnitt Kontingentnutzung nachvollziehen enthält Richtlinien zur Optimierung der API-Kontingentnutzung. Der API-Server berechnet für jede Anfrage die Kosten und diese Kosten werden von Ihrem API-Nutzungskontingent abgezogen. Da die Abfragekosten für verschiedene Berichtstypen sehr unterschiedlich sein können, sollten Sie Ihr Kontingent effizient nutzen und Ihre Anwendung sollte nur die Messwerte und Daten anfordern, die sie tatsächlich benötigt.

  • Der Abschnitt Zeitliche Dimensionen wurde aktualisiert. Dort wird jetzt erläutert, dass diese Dimensionen angeben, dass Daten in einem Analytics-Bericht anhand eines Zeitraums aggregiert werden sollen. Die API unterstützt jetzt die folgenden zusätzlichen Zeitdimensionen:

    • 7DayTotals: Die Daten im Bericht werden so zusammengefasst, dass jede Zeile Daten für einen Zeitraum von sieben Tagen enthält.
    • 30DayTotals: Die Daten im Bericht werden so zusammengefasst, dass jede Zeile Daten für einen Zeitraum von 30 Tagen enthält.
    • month: Die Daten im Bericht werden nach Kalendermonat zusammengefasst.

    Entsprechend wurde der Abschnitt Verfügbare Berichte aktualisiert, um die Unterstützung der API für Berichte widerzuspiegeln, in denen diese Dimensionen verwendet werden.

  • Der Abschnitt Dimensionen für Berichterstellungsentitäten wurde aktualisiert. API-Anfragen zum Abrufen von Berichten für Rechteinhaber müssen Daten entweder mit einer dieser Dimensionen (video, channel oder show) oder mit einer unterstützten Kombination der Dimensionen claimedStatus und uploaderType filtern.

  • Die API unterstützt jetzt zwei neue Sortieroptionen für Berichte zu Top-Videos. Diese Berichte sind als Kanalberichte oder Berichte für Rechteinhaber verfügbar. Sie enthalten Messwerte (Aufrufe, Kommentare, „Mag ich“-Bewertungen usw.) nach Land und Video. Du kannst diese Berichte jetzt nach der Anzahl der Nutzer sortieren, die den Kanal über die Wiedergabeseite des Videos abonniert oder das Abo gekündigt haben.

  • Die Definitionen der subscribersGained- und subscribersLost-Messwerte wurden aktualisiert. Es wird jetzt erklärt, dass ein Kanal an mehreren Stellen Abonnenten gewinnen oder verlieren kann, z. B. auf der Wiedergabeseite eines Videos, auf der Kanalseite und im Guide auf der YouTube-Startseite. Wenn diese Messwerte in einem videospezifischen Bericht angezeigt werden, enthalten sie nur Statistiken von der Wiedergabeseite des angegebenen Videos.