Überarbeitungsverlauf

Auf dieser Seite werden API-Änderungen und Dokumentationsupdates für die YouTube Reporting API und die YouTube Analytics API aufgeführt. Beide APIs ermöglichen Entwicklern den Zugriff auf YouTube Analytics-Daten, wenn auch auf unterschiedliche Weise.

30. Oktober 2026

Die YouTube Reporting API unterstützt jetzt die folgenden vom System verwalteten Berichte für Rechteinhaber:

Kategorie Berichtsname Berichtstyp-ID
Finanzielle Zusammenfassungen Monatliche Zusammenfassung der Kanalanpassungen content_owner_channel_adjustments_summary_a1
Finanzielle Zusammenfassungen Monatlicher Umsatz über Transaktionen für kostenpflichtige Funktionen content_owner_transactions_paid_features_revenue_a1
Finanzielle Zusammenfassungen Monatlicher TVOD-Transaktionsumsatz nach Titel und Land tvod_content_owner_country_title_tvod_revenue_a1
Finanzielle Zusammenfassungen Monatlicher TVOD-Transaktionsumsatz nach Land tvod_content_owner_country_transactions_tvod_revenue_a1
Shorts Monatliche Erstellung von Shorts aus Musiklabel-Assets music_content_owner_shorts_asset_creations_a1
Shorts Monatliche Aufrufe von Shorts-Inhalten von Musiklabels music_content_owner_shorts_asset_views_a1
Shorts Monatliche Erstellung von Shorts-Assets von Musikverlagen publisher_content_owner_shorts_asset_creations_a1
Shorts Monatliche Aufrufe von Shorts-Assets von Musikverlagen publisher_content_owner_shorts_asset_views_a1
Steuern Monatlicher zusammenfassender Bericht zu Steuerrückerstattungen für MCN-Partnerkanäle content_owner_affiliate_tax_refund_summary_a1
Assets Wöchentlicher SRMF-Bericht publisher_content_owner_weekly_srmf
Assets Täglicher Statusbericht zu Anfragen für offizielle Künstlerkanäle content_owner_oac_request_status_a1
Assets Täglicher Qualitätsbericht zu Anfragen für offizielle Künstlerkanäle content_owner_oac_quality_status_a1

13. September 2026

Die YouTube Reporting API unterstützt jetzt Version 1.1 des wöchentlichen Referenzberichts für Rechteinhaber (content_owner_active_references_a2).

In Version 1.1 werden die folgenden Änderungen eingeführt:

  • Fügt das Feld status_detail hinzu, das zusätzliche Details oder Gründe für den Status der Referenzdatei enthält.
  • Das Feld asset_owners wird aktualisiert, sodass anstelle von Partnercodes die Anzeigenamen oder externen IDs von Rechteinhabern verwendet werden.

Die vorherige Version des Berichts, Version 1.0 (content_owner_active_references_a1), ist weiterhin verfügbar.

9. September 2026

Die Dokumentation zur YouTube Analytics API und zur YouTube Reporting API wurde um die folgenden Ergänzungen und Erläuterungen erweitert:

  • SLA für Datenaktualität und Latenz: Dem Abschnitt Datenmodell wurde ein eigener Bereich hinzugefügt, in dem die Verzögerung bei der Datenverarbeitung von 48 bis 72 Stunden und die Kürzung des Enddatums auf den letzten vollständig verarbeiteten Tag erläutert werden. Außerdem wird die Methode videos.list der YouTube Data API für Echtzeit-Videostatistiken empfohlen.

  • Finanzielle Messwerte in Kanalberichten: Die Dokumentation zur Autorisierung von Kanalberichten wurde aktualisiert. Es wurde klargestellt, dass Messwerte zum geschätzten Umsatz und zur Anzeigenleistung für Kanalberichte unterstützt werden, die mit dem Bereich https://www.googleapis.com/auth/yt-analytics-monetary.readonly autorisiert wurden, wenn der Kanal Mitglied des YouTube-Partnerprogramms (YPP) ist. Bei nicht monetarisierten Kanälen wird HTTP 403 Forbidden zurückgegeben.

  • Abfrageeinschränkungen und Parameterkompatibilität: Unter Berichtstabellen wurde ein Hinweis hinzugefügt, dass ungültige oder sich gegenseitig ausschließende Kombinationen von Dimensionen, Messwerten und Filtern den HTTP-Fehler 400 badRequest ("The query is not supported.") zurückgeben.

  • Leere Dimensionswerte in Bulk-Berichten: Die Eigenschaften von Berichten der YouTube Reporting API wurden aktualisiert. Dimensionsspalten wie video_id oder channel_id enthalten jetzt leere Strings, um aggregierte Messwerte für gelöschte Ressourcen beizubehalten und Ereignisse auf Kanalebene darzustellen.

27. August 2026

YouTube wird die Zählung öffentlicher Aufrufe für alle Videoformate angleichen: Videos im Langformat, Livestreams und Shorts. YouTube zählt öffentliche Aufrufe ab dem Moment, in dem die Wiedergabe eines Videos beginnt.

Die Voraussetzungen für die Monetarisierung und die meisten wichtigen Leistungsmesswerte sind davon nicht betroffen, da sie weiterhin auf Interaktionsmesswerten basieren. Die Einnahmen von Creatorinnen und Creatorn basieren weiterhin auf den Messwerten „Shorts-Aufrufe“ und „Wiedergabezeit“, die in YouTube Analytics im erweiterten Modus eingesehen werden können.

An den Teilnahmevoraussetzungen für das YouTube-Partnerprogramm ändert sich nichts. Die Teilnahmevoraussetzungen für das YouTube-Partnerprogramm heißen jetzt „qualifizierte Shorts-Aufrufe“ und „qualifizierte Wiedergabezeit“ (vorher „gültige öffentliche Shorts-Aufrufe“ und „gültige Wiedergabezeit von öffentlichen Videos“).

Weitere Informationen findest du unter Die Leistung deiner Inhalte auf YouTube verstehen.

Messwert Status Trigger Verwendet für
Ansicht Aktualisiert Das Video wird ab dem ersten Frame abgespielt (einschließlich automatischer Wiedergabe, Mauszeiger darüber halten und zum Abspielen klicken/tippen). Standardmäßige Anzahl öffentlicher Aufrufe.
Engaged View Nicht geändert Die Wiedergabe wird nach dem ersten Frame fortgesetzt oder der Nutzer klickt/tippt, um die Wiedergabe zu starten. Monetarisierung über das YouTube-Partnerprogramm, die meisten wichtigen Analysen (Klickrate, durchschnittliche Wiedergabedauer) und Berichte zur Interaktion.
Thumbnail-Impression Nicht geändert Die Miniaturansicht wird ohne Interaktion oder Autoplay angezeigt. Misst die Sichtbarkeit und Verpackung auf Feedebene.

Aktualisierungen der API-Dokumentation: Die Definition des Messwerts engagedViews wurde in der Dokumentation zu den Messwerten der YouTube Analytics API und den Messwerten der YouTube Reporting API aktualisiert.

25. Juni 2026

Die Dokumentation zur YouTube Analytics API (gezielte Abfragen) wurde aktualisiert. Der Bericht Nutzeraktivität nach Stadt für Rechteinhaber wurde entfernt. Dieser Bericht wird für Rechteinhaber nicht unterstützt. Abfragen von Rechteinhabern zur Nutzeraktivität nach Stadt liefern keine Ergebnisse.

9. März 2026

Die Dimensionen ageGroup (YouTube Analytics API) und age_group (YouTube Reporting API) umfassen jetzt auch Nutzer, die laut Schätzung von YouTube unter 18 Jahre alt sind.

15. Januar 2026

Die YouTube Reporting API unterstützt jetzt Berichte zur Reichweite für Kanäle und Rechteinhaber. In Berichten zur Reichweite finden Sie Statistiken zu Impressionen von Video-Thumbnails und Klickraten.

  • Die Berichte channel_reach_basic_a1 und channel_reach_combined_a1 sind für Kanäle verfügbar.
  • Die Berichte content_owner_reach_basic_a1 und content_owner_reach_combined_a1 sind für Rechteinhaber verfügbar.

Diese Berichte unterstützen die folgenden neuen Messwerte:

  • video_thumbnail_impressions
  • video_thumbnail_impressions_ctr

22. September 2025

Die zuvor angekündigte Einstellung von Berichten wurde vom 30. September 2025 auf den 31. Oktober 2025 verschoben. Frühere Versionen von Berichten, die aufgrund von Änderungen bei der Zählung der Aufrufe von Shorts aktualisiert wurden, sind bis dahin weiterhin verfügbar. Eine Ausnahme bilden der Bericht zu Ansprüchen v1.0 (content_owner_active_claims_a1) und der Bericht zu Ansprüchen v1.1 (content_owner_active_claims_a2), die am 30. September eingestellt werden.

24. Juni 2025

Wie am 26. März 2025 angekündigt, wird die Bulk-Berichte API im Rahmen der neuen Änderung bei der Zählung von Shorts-Aufrufen aktualisiert. Die folgenden Änderungen wurden vorgenommen:

  • Für jeden Bericht, der Aufrufe enthält, wurden neue Berichtsversionen erstellt. Das betrifft die meisten Berichte. Die Version jedes betroffenen Berichts wurde um eins erhöht, z. B. von Version a2 auf Version a3.
  • Bei Shorts entspricht die Anzahl der Aufrufe jetzt der Anzahl der Wiedergaben oder wiederholten Wiedergaben eines Shorts. Bei Videos gibt es keine Änderung.
  • Aktualisierte Berichte enthalten eine neue Spalte, engaged_views, in der die bisherige Zählweise für Aufrufe verwendet wird.

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

Frühere Berichtsversionen sind bis zum 30. September 2025 verfügbar. Nach dem 30. September 2025 werden die vorherigen Versionen eingestellt. Migrieren Sie zu den aktuellen Versionen.

Beachten Sie bei der Verarbeitung der Berichte die Best Practices, damit zukünftige Änderungen an Berichten Ihre Verarbeitungspipelines nicht beeinträchtigen.

In den folgenden Tabellen sind die neuen Berichtsversionen für die einzelnen Berichtstypen aufgeführt:

Bulk-Datenberichte für YouTube Analytics

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
Berichte für Rechteinhaber – 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
Berichte für Rechteinhaber – 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
Berichte für Rechteinhaber – 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

Systemverwaltete Berichte – Finanzen (Nicht-Musik)

Berichte für Rechteinhaber – Shorts-Berichte (Nicht-Musik)
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 Ländern 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

Berichte für Rechteinhaber – Anspruchsberichte
Berichtsname Vorherige Version Aktuelle Version
Aktive Ansprüche content_owner_active_claims_a2 content_owner_active_claims_a3
Berichte für Rechteinhaber – Berichte zu Videometadaten
Berichtsname Vorherige Version Aktuelle Version
Videometadaten content_owner_video_metadata_a3 content_owner_video_metadata_a4
Berichte für Rechteinhaber – 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 API für gezielte Abfragen 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 spiegelt die bisherige Zählweise wider. engagedViews wird in allen Berichten zusammen mit views verfügbar sein.

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

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

22. April 2025

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

26. März 2025

Dieses Update enthält die folgende Änderung im Zusammenhang mit der YouTube Analytics API und der YouTube Reporting API:

Ab dem 31. März 2025 ändert sich die Art und Weise, wie wir Shorts-Aufrufe zählen. Bisher wurde 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 entspricht die Anzahl der views der Anzahl der Wiedergaben oder wiederholten Wiedergaben eines Shorts.
  • Ein neuer Messwert, engagedViews, wird verfügbar sein und die bisherige Methode zur Zählung von Aufrufen widerspiegeln.
  • Wenn du Inhaberin oder Inhaber eines Kanals bist oder berechtigt bist, auf die Daten eines Kanals zuzugreifen, kannst du sowohl die aktualisierten Aufrufe als auch die aktiven Wiedergaben abrufen.

Gezielte Abfragen werden bis zum 30. April aktualisiert, Bulk-Berichte bis zum 30. Juni. Bis dahin werden Aufrufe nach der alten Methode gezählt. Die Anzahl der Aufrufe von Shorts und Kanälen stimmt nicht mit den Analytics-Daten in Studio überein.

Außerdem wurde die bereits angekündigte Einstellung des Berichts „Daily Claims“ (Version 1.0) verschoben.

In diesem Überarbeitungsverlauf sehen Sie, wann Änderungen an den APIs vorgenommen wurden.

3. März 2025

Dieses Update enthält die folgende Änderung im Zusammenhang mit der YouTube Reporting API:

Hinweis: Dies ist eine Mitteilung über die Einstellung von Funktionen.

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 neuesten täglichen Bericht zu Ansprüchen.

15. November 2024

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

Die Dokumentation zur YouTube Analytics API (gezielte Abfragen) wurde aktualisiert. Bei Berichten zu Zugriffsquellen gibt die Methode reports.query der API jetzt einen Fehler zurück, wenn das Produkt aus Anzahl der abgefragten Videos × Anzahl der Tage im Zeitraum 50.000 überschreitet. Beispiel: Bei einer Abfrage, mit der Daten für 500 Video-IDs abgerufen werden, können Daten für maximal 100 Tage angefordert werden.

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

Wenn du die Anzahl der Zeilen reduzieren möchtest, die eine Anfrage zurückgibt, teile deine Abfrage in mehrere Abfragen auf, in denen weniger Videos oder kürzere Zeiträume angegeben sind. In der Regel werden Bulk-Berichte für große Datensätze empfohlen.

6. Mai 2024

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

  • Der Bericht Nutzeraktivität nach DMA ist ein geografischer Bericht, der Statistiken zur Nutzeraktivität nach Designated Market Area (DMA) enthält. Für diesen Bericht müssen Sie den Parameterwert filters auf country==US festlegen.

  • Im Bericht Gleichzeitige Zuschauer wird die Anzahl der gleichzeitigen Zuschauer für verschiedene Teile eines einzelnen per Livestream übertragenen Videos angezeigt.

  • Der Bericht Kündigungen von Mitgliedern enthält Statistiken dazu, warum Nutzer ihre Kanalmitgliedschaft gekündigt haben.

    In diesem Bericht wird die neue Dimension membershipsCancellationSurveyReason verwendet, die angibt, warum ein Nutzer eine Kanalmitgliedschaft gekündigt hat. Außerdem wird der neue Messwert membershipsCancellationSurveyResponses verwendet, der angibt, wie viele Kanalmitgliedschaften aus diesem Grund gekündigt wurden.

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

7. April 2024

Die YouTube Analytics API (gezielte Abfragen) enthält mehrere Updates zu Playlist-Berichten für Rechteinhaber. Die Änderungen sind dieselben wie die am 19. Januar 2024 angekündigten Änderungen an Berichten zu Kanal-Playlists.

Der folgende Eintrag im Überarbeitungsverlauf enthält fast dieselben Informationen wie der Eintrag vom 19. Januar 2024. Beachte jedoch, dass Playlist-Berichte für Rechteinhaber die Dimension isCurated bis zum 31. Dezember 2024 unterstützen, während die Dimension für Playlist-Berichte für Kanäle bis zum 30. Juni 2024 unterstützt wird.

  • Hinweis: Dies ist eine Mitteilung über die Einstellung von Funktionen.

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

    Wenn du die Dimension isCurated entfernst, musst du auch deinen Code aktualisieren, um die Abwärtskompatibilität zu gewährleisten. Rufe dann den Messwert playlistViews anstelle des Messwerts views ab, aber nur für Playlistberichte. Da der Messwert views für Playlistberichte weiterhin unterstützt wird, wenn auch mit einer anderen Bedeutung, gibt die API weiterhin Daten zurück, wenn du den Messwertnamen nicht aktualisierst. Natürlich können Sie Ihre Anwendung so ändern, dass sowohl views als auch playlistViews abgerufen und angezeigt werden.

    Zusätzlich zur Dimension isCurated werden die folgenden API-Funktionen 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 werden die API-Funktionen an die in der Studio-Anwendung verfügbaren Funktionen angepasst.
    • 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. Mit dieser Änderung wird die API-Funktionalität an die in der Studio-Anwendung verfügbaren Funktionen angepasst.

  • Der Abschnitt Playlist-Berichte in der Dokumentation zu Berichten für Rechteinhaber wurde aktualisiert, um die für Playlist-Berichte unterstützten Messwerttypen genauer zu erläutern:

    • Aggregierte Videomesswerte liefern Messwerte zu Nutzeraktivitäten und Impressionen, die für alle Videos in den Playlists des Rechteinhabers aggregiert werden, die auch diesem Rechteinhaber gehören. Aggregierte Videomesswerte werden nur für API-Anfragen unterstützt, die die Dimension isCurated nicht verwenden.
    • Messwerte in der Playlist spiegeln die Nutzeraktivität und das Engagement im Kontext der Playlistseite wider. Diese Messwerte enthalten auch Daten zu Aufrufen von Videos in der Playlist, die nicht dir gehören, aber nur, wenn diese Aufrufe im Kontext der Playlist erfolgt sind.
    • Im Abschnitt Unterstützte Playlist-Messwerte werden die aggregierten Video- und Playlist-Messwerte aufgeführt, die für Playlist-Berichte unterstützt werden.

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

  • Das Verhalten des Messwerts views hängt jetzt davon ab, ob in der 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 Playlist-Messwert, der angibt, 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, unabhängig davon, ob diese Aufrufe im Kontext der Playlist erfolgten. Die Gesamtzahl umfasst nur Aufrufe von Videos, die dem Rechteinhaber gehören, der mit dem Kanal verknüpft ist, zu 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 angesehen wurden. Dieser Messwert umfasst die Aufrufe aller Videos in der Playlist, unabhängig davon, zu welchem Kanal sie gehören.

  • Die Dokumentation zu Rechteinhaberberichten enthält jetzt für jeden Playlistbericht Tabellen mit den unterstützten Messwerten für diesen Bericht, je nachdem, ob die API-Anfrage die Dimension isCurated enthält. Ein Beispiel findest du im Abschnitt Zeitbasierte Playlist-Berichte.

19. Januar 2024

Die YouTube Analytics API (gezielte Abfragen) enthält mehrere Updates im Zusammenhang mit Berichten zu Kanal-Playlists. Die Updates umfassen eine eingestellte Dimension sowie mehrere neue und aktualisierte Messwerte:

  • Hinweis: Dies ist eine Mitteilung über die Einstellung von Funktionen.

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

    Wenn du die Dimension isCurated entfernst, musst du auch deinen Code aktualisieren, um die Abwärtskompatibilität zu gewährleisten. Rufe dann den Messwert playlistViews anstelle des Messwerts views ab, aber nur für Playlistberichte. Da der Messwert views für Playlistberichte weiterhin unterstützt wird, wenn auch mit einer anderen Bedeutung, gibt die API weiterhin Daten zurück, wenn du den Messwertnamen nicht aktualisierst. Natürlich können Sie Ihre Anwendung so ändern, dass sowohl views als auch playlistViews abgerufen und angezeigt werden.

    Zusätzlich zur Dimension isCurated werden die folgenden API-Funktionen 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 werden die API-Funktionen an die in der Studio-Anwendung verfügbaren Funktionen angepasst.
    • 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. Mit dieser Änderung wird die API-Funktionalität an die in der Studio-Anwendung verfügbaren Funktionen angepasst.

  • Der Abschnitt Playlist-Berichte in der Dokumentation zu Kanalberichten wurde aktualisiert, um die Arten von Messwerten, die für Playlist-Berichte unterstützt werden, genauer zu erläutern:

    • Aggregierte Videomesswerte enthalten Messwerte zu Nutzeraktivitäten und Impressionen, die für alle Videos in den Playlists des Kanals aggregiert werden, die auch diesem Kanal gehören. Aggregierte Videomesswerte werden nur für API-Anfragen unterstützt, die die Dimension isCurated nicht verwenden.
    • Messwerte in der Playlist spiegeln die Nutzeraktivität und das Engagement im Kontext der Playlistseite wider. Diese Messwerte enthalten auch Daten zu Aufrufen von Videos in der Playlist, die nicht dir gehören, aber nur, wenn diese Aufrufe im Kontext der Playlist erfolgt sind.
    • Im Abschnitt Unterstützte Playlist-Messwerte werden die aggregierten Video- und Playlist-Messwerte aufgeführt, die für Playlist-Berichte unterstützt werden.

  • Die folgenden neuen Messwerte in der Playlist werden für Playlistberichte 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 die API-Anfrage zum Abrufen der Berichte nicht die Dimension isCurated verwendet. Definitionen der einzelnen Messwerte finden Sie in der Dokumentation zu Messwerten:

  • Das Verhalten des Messwerts views hängt jetzt davon ab, ob in der 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 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 von Videos in den Playlists des Kanals angibt, unabhängig davon, ob diese Aufrufe im Kontext der Playlist erfolgten. Die 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 angesehen wurden. Dieser Messwert umfasst die Aufrufe aller Videos in der Playlist, unabhängig davon, zu welchem Kanal sie gehören.

  • Die Dokumentation zu Kanalberichten enthält jetzt für jeden Playlist-Bericht Tabellen mit den unterstützten Messwerten für diesen Bericht, je nachdem, ob die API-Anfrage die Dimension isCurated enthält. Ein Beispiel findest du im Abschnitt Zeitbasierte Playlist-Berichte.

4. Dezember 2023

Die YouTube Analytics API (gezielte Abfragen) wurde aktualisiert, um zwei Dimensionswerte vom Typ insightTrafficSourceType zusammenzuführen. Bisher wurde bei der Dimension zwischen Videos, die als Teil einer Playlist abgespielt wurden (PLAYLIST), und Aufrufen, die von einer Seite mit allen Videos einer Playlist stammen (YT_PLAYLIST_PAGE), unterschieden. Zukünftig werden beide Arten von Aufrufen mit dem Dimensionswert PLAYLIST verknüpft.

15. Dezember 2022

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

  • Ein neuer Bericht enthält die Nutzeraktivität nach Stadt. Dieser Bericht ist für Kanäle und Rechteinhaber verfügbar. Dieser Bericht enthält die neue Dimension city, die die von YouTube geschätzte Stadt angibt, in der die Nutzeraktivität stattgefunden hat.

  • Die neue Dimension „creatorContentType“ gibt den Typ des YouTube-Inhalts an, der mit den Messwerten für die Nutzeraktivität 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 von Kanälen und Rechteinhabern unterstützt.

  • Der Leitfaden zu Beispielanfragen für die YouTube Analytics API enthält 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 Traffic-Quellen:

  • Wenn in der YouTube Analytics API (gezielte Abfragen) der Wert der Dimension insightTrafficSourceType SUBSCRIBER ist, kann der Wert insightTrafficSourceDetail auf podcasts gesetzt werden. Das bedeutet, dass der Traffic von der Podcast-Zielseite stammt.
  • Wenn in der YouTube Reporting (Bulk-Berichte) API der Wert der Dimension traffic_source_type 3 ist, kann der Wert traffic_source_detail auf podcasts gesetzt werden. Das bedeutet, dass der Traffic von der Podcast-Zielseite stammt.

11. Februar 2022

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

Die konkreten Änderungen sind:

  • In der YouTube Analytics API (gezielte Abfragen) unterstützt die Dimension gender derzeit zwei Werte: female und male. Ab dem 11. August 2022 werden für diese Dimension drei Werte unterstützt: female, male und user_specified.
  • In der YouTube Reporting API (Bulk-Berichte) unterstützt die Dimension gender derzeit drei Werte: FEMALE, MALE und GENDER_OTHER. Ab dem 11. August 2022 werden die unterstützten Werte in FEMALE, MALE und USER_SPECIFIED geändert.

9. Februar 2022

Zwei Messwerte wurden am 13. Dezember 2021 aktualisiert, um Traffic von Clips in Endlosschleife 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-Berichte) unterstützt einen neuen Wert für die Dimension „Traffic-Quelle“, der angibt, dass die Aufrufe von Live Redirects stammen:

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

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

23. September 2020

Die YouTube Analytics API (gezielte Abfragen) und die YouTube Reporting API (Bulk-Berichte) unterstützen beide einen neuen Dimensionswert für die Traffic-Quelle, der angibt, dass der Zuschauer durch vertikales Wischen im YouTube Shorts-Wiedergabebereich weitergeleitet wurde:

  • In der YouTube Analytics API (gezielte Abfragen) unterstützt die Dimension insightTrafficSourceType den Wert SHORTS.
  • In der YouTube Reporting API (Bulk-Berichte) 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 (gezielte Abfragen) auswirken:

  • Die maximale Größe einer YouTube Analytics-Berichtsgruppe wurde von 200 auf 500 Entitäten 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 im Zusammenhang mit der YouTube Analytics API (gezielte Abfragen) und der YouTube Reporting API (Bulk-Berichte). Weitere Informationen zu diesen Änderungen findest du in der YouTube-Hilfe.

In beiden APIs ändert sich die Gruppe der möglichen Werte für die Details der Zugriffsquelle für Benachrichtigungen. In gezielten Abfragen werden Benachrichtigungen als insightTrafficSourceType=NOTIFICATION gemeldet. In Bulk-Berichten werden Benachrichtigungen als traffic_source_type=17 gemeldet.

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

  • uploaded_push: Aufrufe, die über Push-Benachrichtigungen generiert wurden, die beim Upload eines Videos an Abonnenten gesendet wurden
  • uploaded_other: Aufrufe, die über andere Benachrichtigungen als Push-Benachrichtigungen generiert wurden, z. B. E-Mail-Benachrichtigungen oder Benachrichtigungen im Posteingang, die an Abonnenten gesendet wurden, als ein Video hochgeladen wurde.

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

Zur Erinnerung: Diese Werte stehen nicht für die Benachrichtigungen selbst, sondern für 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 ist, bedeutet das, dass drei Aufrufe von Zuschauern stammen, die auf Push-Benachrichtigungen geklickt haben, die beim Hochladen des Videos gesendet wurden.

15. Oktober 2019

Dieses Update enthält die folgenden Änderungen im Zusammenhang mit der YouTube Analytics API (gezielte Abfragen):

  • Hinweis: Dies ist eine Mitteilung über die Einstellung von Funktionen.

    YouTube entfernt die Unterstützung für die Dimensionen 7DayTotals und 30DayTotals. Sie können noch bis zum 15. April 2020 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 die Dimension day abfragen und Daten über Zeiträume von sieben 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 aggregiert wird.
    • Der Wert „viewerPercentage“ für einen Zeitraum von sieben Tagen kann berechnet werden, indem die Anzahl der Aufrufe pro Tag mit dem Wert „viewerPercentage“ 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 viewerPercentage 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 kannst du 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 die Dimension 30DayTotals 30-Tage-Zeiträume basierend auf dem angegebenen Start- und Enddatum berechnet.

27. Juni 2019

Dieses Update enthält die folgenden Änderungen im Zusammenhang mit der YouTube Analytics API (gezielte Abfragen):

  • Da Version 1 der API jetzt vollständig eingestellt wurde, wurde die Dokumentation aktualisiert, um Verweise auf diese Version zu entfernen. Dazu gehören der Hinweis zur Einstellung und die Migrationsanleitung, in der erklärt wird, wie Sie auf Version 2 aktualisieren.

1. November 2018

Dieses Update enthält die folgenden Änderungen im Zusammenhang mit der YouTube Analytics API (gezielte Abfragen):

  • Version 1 der API wurde eingestellt. Falls noch nicht geschehen, aktualisieren Sie Ihre API-Clients so schnell wie möglich auf Version 2 der API, um Dienstunterbrechungen zu minimieren. Weitere Informationen finden Sie in der Migrationsanleitung.

    Der Zeitplan für diese Einstellung wurde ursprünglich am 26. April 2018 angekündigt.

17. September 2018

Dieses Update enthält die folgenden Änderungen im Zusammenhang mit der YouTube Analytics API (gezielte Abfragen):

  • Im neuen Abschnitt Datenanonymisierung im Übersichtsartikel Datenmodell wird erklärt, dass einige YouTube Analytics-Daten eingeschränkt sind, wenn die 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 während eines bestimmten Zeitraums nur wenige Zugriffe hat,

      oder

    2. Du hast einen Filter oder eine Dimension wie „Zugriffsquelle“ oder „Land“ ausgewählt, für die die Werte einen bestimmten Grenzwert nicht erreichen.

    Der neue Abschnitt enthält auch eine Erläuterung der Datentypen, die in YouTube Analytics-Berichten möglicherweise eingeschränkt sind.

  • Die Dokumente zu Kanalberichten und Rechteinhaberberichten wurden aktualisiert. Die Messwerte redViews und estimatedRedMinutesWatched werden für Berichte zu Wiedergabeort, Zugriffsquelle und Gerätetyp/Betriebssystem nicht mehr unterstützt.

18. Juni 2018

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

  • 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 eine der folgenden Optionen haben:
      • den Bereich https://www.googleapis.com/auth/youtube
        oder
      • den Bereich https://www.googleapis.com/auth/youtube.readonly
        und
        den Bereich https://www.googleapis.com/auth/yt-analytics.readonly

      Bei der ersten Option wird ein Zugriffsbereich verwendet, der ein Lese-/Schreibbereich ist, während bei der zweiten Option zwei Lesezugriff-Bereiche verwendet werden.

23. Mai 2018

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

  • Die API-Übersicht enthält einen neuen Abschnitt, Zusammengefasste Messwerte und gelöschte Elemente, in dem erläutert wird, wie API-Antworten mit Daten umgehen, 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 jetzt darauf hingewiesen, dass du die YouTube Data API verwenden kannst, um zusätzliche Metadaten für Ressourcen abzurufen, die in Antworten der YouTube Analytics API identifiziert wurden. Gemäß den Richtlinien für Entwickler der YouTube API-Dienste (Abschnitte III.E.4.b bis III.E.4.d) müssen API-Clients gespeicherte Ressourcenmetadaten von 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 treten voraussichtlich im Juli 2018 in Kraft. Die neuen Richtlinien gelten weltweit für alle Berichte und Berichtsjobs.

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

      Vor dieser Ankündigung waren alle API-Berichte 180 Tage lang verfügbar, nachdem sie generiert wurden. Sobald 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 ebenfalls nicht mehr verfügbar. In der Dokumentation wird jetzt darauf hingewiesen, dass Berichte, die vor der Richtlinienänderung erstellt wurden, bis zu 180 Tage lang verfügbar sind.

    • Nach der Änderung werden Berichte ab dem Tag, an dem Sie einen Berichterstellungsjob planen, und für den Zeitraum von 30 Tagen vor dem Planungszeitpunkt erstellt. Vor der Änderung wurden beim Planen eines Berichtsauftrags Berichte für den Zeitraum von 180 Tagen vor dem Planungszeitpunkt erstellt.

  • Der Abschnitt Best Practices wurde aktualisiert. Dort wird jetzt darauf hingewiesen, dass du die YouTube Data API verwenden kannst, um zusätzliche Metadaten für Ressourcen abzurufen, die in Berichten identifiziert wurden. Gemäß den Richtlinien für Entwickler der YouTube API-Dienste (Abschnitte III.E.4.b bis III.E.4.d) müssen API-Clients gespeicherte Ressourcenmetadaten von dieser API nach 30 Tagen entweder löschen oder aktualisieren.

  • Der Abschnitt Berichtsmerkmale wurde aktualisiert. Es wird darauf hingewiesen, dass Berichtsdaten zwar nicht gefiltert werden, Berichte mit Daten für einen Zeitraum ab dem 1. Juni 2018 jedoch keine Verweise auf YouTube-Ressourcen enthalten, die mindestens 30 Tage vor dem Erstellungsdatum des Berichts gelöscht wurden.

  • Der Abschnitt Verlaufsdaten in der API-Übersicht wurde aktualisiert. Wenn Sie einen neuen Berichtsjob planen, werden die Verlaufsberichte in der Regel innerhalb weniger Tage veröffentlicht. Bisher hieß es in der Dokumentation, 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 klarer als Datensatz zu definieren, der einen zuvor bereitgestellten Datensatz ersetzt.

26. April 2018

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

  • Die v2 API ist fast identisch mit der v1 API. Sie müssen Ihren Code jedoch wahrscheinlich aktualisieren, um die unten aufgeführten Änderungen zu berücksichtigen. Alle diese Änderungen werden in der neuen Migrationsanleitung ausführlich beschrieben.

    • Die API-Version wurde von v1 zu v2 geändert.
    • Die Basis-URL für API-Anfragen hat sich von https://www.googleapis.com/youtube/analytics/v1 zu https://youtubeanalytics.googleapis.com/v2 geändert.
    • Mehrere Parameter für die Methode reports.query haben aktualisierte Namen. Insbesondere werden Parameternamen, die Bindestriche enthalten, wie end-date in der v1 API, in der v2 API in Camel-Case-Schreibweise (endDate) statt mit Bindestrichen angegeben. Durch diese Änderung werden die Parameternamen in der gesamten API einheitlich, da die API-Methoden zum Erstellen und Verwalten von Gruppen bereits die Camel-Case-Schreibweise für Parameternamen verwendet haben.
    • 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 aus Anfragen an verschiedene Methoden derselben API bestehen. Diese Einstellung betrifft nicht nur die YouTube Analytics API, da Google den globalen Batch-Endpunkt für alle APIs einstellt.
    • Die v2 API unterstützt das JSON-RPC-Protokoll nicht, das in API v1 unterstützt wurde. Noch einmal: Diese Einstellung ist nicht auf die YouTube Analytics API beschränkt.

  • Hinweis: Dies ist eine Mitteilung über die Einstellung von Funktionen.

    Version 1 der API (v1) wurde eingestellt und wird bis zum 31. Oktober 2018 unterstützt. Alle Anfragen an die v1 API funktionieren nach diesem Datum nicht mehr. Führe daher bis spätestens 31. Oktober 2018 ein Upgrade auf die v2 API durch, damit du weiterhin über die API auf YouTube Analytics-Daten zugreifen kannst.

21. Februar 2018

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

  • Berichte zur Leistung nach demografischen Merkmalen von Zuschauern, in denen Wiedergabestatistiken nach Altersgruppe und Geschlecht der Zuschauer zusammengefasst werden, unterstützen die Dimension youtubeProduct nicht mehr. Mit dieser Dimension wird der YouTube-Dienst identifiziert, auf dem die Nutzeraktivität stattgefunden hat.

18. Januar 2018

Dieses Update enthält die folgenden Änderungen:

  • YouTube Reporting API (Bulk-Berichte)

    • Die Dimension operating_system, die das Softwaresystem des Geräts angibt, auf dem die Wiedergabe erfolgt ist, unterstützt jetzt den folgenden Wert:
      • 25: KaiOS

  • YouTube Analytics API (gezielte Abfragen)

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. Beachten Sie, dass die gzip-Komprimierung für andere Arten von API-Anfragen nicht unterstützt wird. Durch Aktivierung der gzip-Komprimierung wird die für jede API-Antwort benötigte Bandbreite reduziert. Auch wenn Ihre Anwendung zusätzliche CPU-Zeit benötigt, um API-Antworten zu dekomprimieren, überwiegt der Vorteil, weniger Netzwerkressourcen zu verbrauchen, in der Regel diese Kosten.

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

    Accept-Encoding: gzip

    Diese Funktion wird in der API-Übersicht und in der Definition des Attributs downloadUrl der Ressource report erläutert.

  • Die Dokumentation der Dimensionen age group und gender wurde korrigiert, um die tatsächlichen Werte anzuzeigen, die die API für diese Dimensionen zurückgibt. Dies ist eine Korrektur der Dokumentation und spiegelt keine Änderung der API-Funktionalität oder des API-Verhaltens wider. Die folgenden Werte haben sich geändert:

    • Die Werte für die Dimension age_group werden in Großbuchstaben angegeben, enthalten Unterstriche zwischen dem Wort AGE und den Zahlen in der Altersgruppe und verwenden Unterstriche anstelle von Bindestrichen. Werte wie age13-17 und age18-24 wurden daher in AGE_13_17 bzw. AGE_18_24 korrigiert.
    • Für die Werte der Dimension gender werden Großbuchstaben verwendet. Die Werte female, male und gender_other wurden daher 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 die API um einen neuen Messwert namens estimatedRevenue erweitert, der dieselben Daten liefert.

Da der Messwert earnings ein wichtiger Messwert war, wurde er ein Jahr lang ab dem Datum der Ankündigung unterstützt. Dieser Zeitraum ist nun abgelaufen und der Messwert „earnings“ wird nicht mehr unterstützt. API-Anfragen, die den Messwert earnings angeben, geben jetzt den HTTP-Antwortcode 400 zurück. Wenn Sie Ihre App noch nicht aktualisiert haben, um den Messwert estimatedRevenue anstelle des Messwerts earnings zu verwenden, sollten Sie dies so schnell wie möglich tun.

Die API-Dokumentation wurde aktualisiert, um verbleibende Verweise auf den Messwert earnings zu entfernen.

6. Juli 2017

Dieses Update enthält die folgenden Änderungen:

  • YouTube Analytics API (gezielte Abfragen)

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

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

    • Die Dimension adType unterstützt jetzt den Wert reservedBumperInstream, der sich auf eine nicht überspringbare Videoanzeige von bis zu 6 Sekunden bezieht, die vor der Wiedergabe eines Videos abgespielt wird. Das Anzeigenformat ist mit der auctionBumperInstream-Anzeige identisch, aber dieser Typ bezieht sich auf Anzeigen, die auf Reservierungs- statt auf Auktionsbasis verkauft werden.

  • YouTube Reporting API (Bulk-Berichte)

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

    • Berichtsaufträge 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 und nach dem 15. Dezember 2016 wurden keine Berichte mehr für diese Berichtstypen erstellt. Zuvor generierte Berichte waren noch 180 Tage lang verfügbar, nachdem sie generiert wurden. Daher waren einige Berichte bis zum 15. Juni 2017 verfügbar. Da die Berichte jedoch nicht mehr verfügbar sind, werden die mit den Berichten verknüpften Jobs auch nicht mehr benötigt.

24. Mai 2017

Alle Berichtsaufträge 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 und nach dem 22. September 2016 wurden keine Berichte mehr für diese Berichtstypen erstellt. Zuvor generierte Berichte waren noch 180 Tage lang verfügbar, nachdem sie generiert wurden. Einige Berichte waren daher bis zum 22. März 2017 verfügbar. Da die Berichte jedoch nicht mehr verfügbar sind, werden die mit den Berichten verknüpften Jobs auch nicht mehr benötigt.

22. Mai 2017

Dieses Update enthält die folgenden Änderungen:

  • YouTube Reporting API (Bulk-Berichte)

    • Die Dimension sharing_service, die den Dienst identifiziert, ü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 in Kakao (Kakao Talk) geändert, um ihn besser 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 (gezielte Abfragen)

    • 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 YouTube Premium-Zuschauerzahlen beziehen. Tatsächlich werden diese Messwerte von der API schon seit einiger Zeit unterstützt. Die YouTube Reporting API unterstützt beide Messwerte bereits, wie am 15. September 2016 angekündigt wurde.

    • Der Messwert redViews gibt an, wie oft ein Video von YouTube Red-Mitgliedern angesehen wurde.
    • Der Messwert estimatedRedMinutesWatched gibt die Anzahl der Minuten an, die YouTube Red-Mitglieder ein Video angesehen haben.

    Die Dokumentation zu Kanalberichten und Rechteinhaberberichten wurde aktualisiert, um zu zeigen, welche Berichte die beiden neuen Messwerte unterstützen. 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-Berichte)

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

      Ein Datum steht normalerweise für einen Zeitraum von 24 Stunden. An Tagen, an denen die Uhr vorgestellt wird, sind es jedoch 23 Stunden und an Tagen, an denen die Uhr zurückgestellt wird, 25 Stunden. (Zuvor hieß es in der Dokumentation, 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, die das Softwaresystem des Geräts identifiziert, auf dem die Wiedergabe erfolgt ist, 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 verfügbar, nachdem sie generiert wurden. Einige Berichte waren daher noch bis zum 19. Februar 2017 verfügbar. Da die Berichte jedoch nicht mehr verfügbar sind, werden die mit den Berichten verknüpften Jobs auch nicht mehr benötigt.

  • YouTube Analytics API (gezielte Abfragen)

    • Die Beschreibung der Dimensionen im Zusammenhang mit time periods wurde korrigiert. Der Dimensionswert bezieht sich auf den Zeitraum von 00:00 Uhr Pacific Time bis 23:59 Uhr Pacific Time am angegebenen Tag, Monat und Jahr. Je nach Jahreszeit ist die Pacific Time entweder UTC-7 oder UTC-8.

      Ein Datum steht normalerweise für einen Zeitraum von 24 Stunden. An Tagen, an denen die Uhr vorgestellt wird, sind es jedoch 23 Stunden und an Tagen, an denen die Uhr zurückgestellt wird, 25 Stunden. (In der Dokumentation wurde zuvor angegeben, dass die Pacific Time UTC-8 ist. Die Möglichkeit, dass ein Tag nicht 24 Stunden lang ist, wurde nicht erwähnt.)

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

    • Die Dokumentation zu Kanalberichten wurde aktualisiert. Es wird jetzt darauf hingewiesen, dass Kanalberichte derzeit keine Messwerte zu Einnahmen oder zur Anzeigenleistung enthalten. 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 beim Abrufen von Rechteinhaberberichten relevant.

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

Diese Regeln gelten auch, wenn die API-Anfrage Daten für mehrere Kanäle abruft:

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

    Dabei ist zu beachten, dass verschiedene Kanäle möglicherweise zu unterschiedlichen Zeitpunkten 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 Wiedergabezeit- und Aufrufdaten basierend auf dem Verknüpfungsdatum für den jeweiligen Kanal.
  • Wenn der Parameterwert true ist, werden in der Antwort Wiedergabezeit- und Aufrufdaten für alle Kanäle 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. Es ist eine neuere Version des Berichts verfügbar. Die Mitteilung zur Einstellung dieser 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 Abspannberichte sowie neue Dimensionen und Messwerte für diese Berichte. Die Berichte enthalten Impressions- und Klickstatistiken für die Abspanne, die nach dem Ende eines Videos angezeigt 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 neue Messwerte, die sich auf dieselben Daten beziehen, bereits unterstützt. In der folgenden Tabelle sind der verworfene und der neue Messwertname aufgeführt:

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

27. Oktober 2016

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

Die Übersicht über systemverwaltete Berichte bietet einen kurzen Überblick über die neuen Berichte und erklärt, wie sie über die API abgerufen werden können. Dieser Vorgang unterscheidet sich geringfügig vom Abrufen von Bulk-Berichten für YouTube Analytics, da Partner keine Jobs zum Erstellen der Berichte planen müssen.

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

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

27. September 2016

Hinweis: Dies ist eine Mitteilung über die Einstellung von Funktionen.

Der Messwert uniques der YouTube Analytics API wurde eingestellt. Dies ist kein Kernmesswert und wird 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 verfügbar, nachdem sie generiert wurden.

    Der Bericht content_owner_basic_a1 wird durch den Bericht content_owner_basic_a2 ersetzt, wie im Eintrag im Überarbeitungsverlauf vom 19. Mai 2016 erläutert.

11. August 2016

Dieses Update enthält die folgenden Änderungen:

  • Die neu veröffentlichten Nutzungsbedingungen für YouTube API-Dienste („die aktualisierten Nutzungsbedingungen“), die im YouTube Engineering and Developers Blog ausführlich erläutert werden, enthalten zahlreiche 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ändigen neuen Dokumente werden im Überarbeitungsverlauf für die aktualisierten Nutzungsbedingungen beschrieben. Zukünftige Änderungen an den aktualisierten Nutzungsbedingungen oder den zugehörigen Dokumenten werden ebenfalls in diesem Überarbeitungsverlauf erläutert.

10. August 2016

Dieses Update enthält die folgenden Änderungen:

  • YouTube Analytics API (gezielte Abfragen)

    • Hinweis: Dies ist eine Mitteilung über die Einstellung von Funktionen.

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

      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 Hauptmesswert und wird daher ein Jahr lang ab dem Datum dieser Ankündigung unterstützt. Die anderen Messwerte, die keine Kernmesswerte waren, werden drei Monate lang bis zum 4. November 2016 unterstützt.

      Bis zum 4. November 2016 kann in einer API-Anfrage beispielsweise der Messwert impressionBasedCpm, der Messwert cpm oder beide angegeben werden. Nach diesem Datum 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. Sie gibt an, dass die Aufrufe von von Nutzern hochgeladenen Videos stammen, auf die Anspruch erhoben wurde und 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 Traffic-Quellen können Sie auch einen traffic source detail-Bericht abrufen. In beiden Fällen wird das Video, von dem der Zuschauer weitergeleitet wurde, durch die Dimension insightTrafficSourceDetail identifiziert.

    • Die Dimension adType unterstützt jetzt den Wert auctionBumperInstream, der sich auf eine nicht überspringbare Videoanzeige von bis zu 6 Sekunden bezieht, die vor der Wiedergabe eines Videos abgespielt wird.

  • YouTube Reporting API (Bulk-Berichte)

    • Die Dimension traffic_source_type unterstützt jetzt die folgenden Werte:
      • 19: Diese Zugriffsquelle wird nur für Rechteinhaberberichte unterstützt. Sie gibt an, dass die Aufrufe von von Nutzern hochgeladenen Videos stammen, auf die Anspruch erhoben wurde und 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 in der Dimension traffic_source_detail das Video angegeben, von dem der Zuschauer weitergeleitet wurde.

    • Die Liste der zentralen Messwerte der API wurde korrigiert. estimated_partner_revenue wird jetzt als zentraler Messwert aufgeführt und earnings wurde aus der Liste entfernt. Der Messwert earnings wurde in der YouTube Reporting API noch nie unterstützt.

    • Die Dimension ad_type unterstützt jetzt den Wert 19, der sich auf Bumper-Anzeigen bezieht. Das sind nicht überspringbare Videoanzeigen, die bis zu sechs Sekunden dauern und vor der Wiedergabe eines Videos angesehen werden müssen.

18. Juli 2016

Dieses Update enthält die folgenden Änderungen:

  • YouTube Analytics API (gezielte Abfragen)

    • Die Listen der unterstützten Messwerte für die folgenden Kanalberichte wurden um Kartenmesswerte erweitert. Die Unterstützung für Infokarten-Messwerte in diesen Berichten wurde am 28. Juni 2016 hinzugefügt. Der Eintrag im Überarbeitungsverlauf für dieses Datum enthält weitere Informationen zu dieser Änderung. Die Berichte sind:
      • Grundlegende Nutzeraktivität für US-Bundesstaaten
      • Nutzeraktivität in US-Bundesstaaten für bestimmte Zeiträume
      • Nutzeraktivität nach Bundesland
      • Nutzeraktivität nach Abostatus
      • Nutzeraktivität nach Abostatus für Provinzen
      • Top-Videos nach Bundesstaat
      • Top-Videos für Abonnenten oder Nicht-Abonnenten

    • Die Filterlisten für Berichte zur Zuschauerbindung auf Kanalebene und Berichte zur Zuschauerbindung für Rechteinhaber 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-Berichte)

    • In der API-Übersicht wurde der Abschnitt, in dem erklärt wird, wie die Download-URL eines Berichts abgerufen wird, korrigiert. Dort wird jetzt angegeben, dass YouTube herunterladbare Berichte 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 Bericht „content_owner_asset_cards_a1“ wurde korrigiert, um zu zeigen, dass im Bericht die Dimension „card_id“ verwendet wird. Zuvor wurde der Dimensionsname in der Dokumentation fälschlicherweise als card_title angegeben.

28. Juni 2016

Die Dokumentation zur YouTube Analytics API wurde aktualisiert, um die Unterstützung für Infokarten-Messwerte in zahlreichen Berichten für Kanäle und Rechteinhaber zu berücksichtigen. Die neu unterstützten Messwerte sind:

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 nur Rechteinhaberberichte:

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

    Bisher hieß es in der Dokumentation, dass Berichte für einen Zeitraum von bis zu 180 Tagen vor dem Datum der API-Anfrage verfügbar sind. Das ist zwar technisch gesehen auch richtig, aber der ursprüngliche Text war bestenfalls ziemlich 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 neu 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“.

      Beide umbenannten Berichte unterscheiden sich von ihren Vorgängern in folgenden Punkten:

    Wenn Sie bereits Jobs zum Erstellen älterer Versionen dieser Berichte haben, müssen Sie neue Jobs für die umbenannten Berichte erstellen. Im Zusammenhang 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 du Jobs für einen dieser Berichte hast, solltest du nicht davon ausgehen, dass YouTube nach dem 22. September 2016 neue Berichte für diese Jobs generiert. Generierte Berichte sind ab dem Zeitpunkt ihrer Erstellung 180 Tage lang verfügbar.

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

  • Die Namen von zwei Messwerten wurden in der Dokumentation korrigiert, damit sie mit den Namen in Berichten übereinstimmen. Dies ist lediglich eine Korrektur der Dokumentation und spiegelt keine Änderung des tatsächlichen Berichtsinhalts wider:

    • Der Name des Messwerts estimated_partner_adsense_revenue wurde in estimated_partner_ad_sense_revenue geändert. Dieser Messwert wird jedoch nur in zwei Berichten angezeigt, 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 wird nur in zwei Berichten angezeigt, 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 den Dimensionen für die Reporting API wurde aktualisiert. Die Properties elapsed_video_time_percentage und audience_retention_type werden nicht mehr aufgeführt. Diese Dimensionen werden derzeit von keinem der über die API verfügbaren Berichte unterstützt.

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 lautet 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 nicht automatisch einen Job, um die neue Berichtsversion zu generieren. In einigen Implementierungen kann das Auftreten eines neuen, unerwarteten Jobs eine funktionsgefährdende Änderung sein.

    Im Zusammenhang mit der Veröffentlichung des neuen Berichts wurde der Bericht content_owner_basic_a1 eingestellt. Wenn du einen Job für diesen Bericht hast, solltest du nicht erwarten, dass YouTube nach dem 19. August 2016 neue Berichte für diesen Job erstellt. Generierte Berichte sind ab dem Zeitpunkt ihrer Erstellung 180 Tage lang verfügbar.

  • Die Ressourcen reportType, job und report unterstützen alle eine neue Property, die angibt, ob die zugehörige Ressource einen verworfenen Berichtstyp darstellt:

    • Das Attribut deprecateTime der Ressource reportType gibt das Datum und die Uhrzeit an, zu der der Berichtstyp eingestellt wird. Diese Property hat nur einen Wert für Berichte, die als veraltet 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 diesem Update vom 19. Mai 2016 wird beispielsweise die Einstellung des Berichts content_owner_basic_a1 angekündigt. Daher wird im Feld deprecateTime für diesen Berichtstyp eine Uhrzeit am 19. August 2016 angegeben, nach der YouTube keine Berichte dieses Typs mehr erstellt.

    • Das Attribut expireTime der Ressource job gibt das Datum und die Uhrzeit an, zu der der Job abgelaufen ist oder ablaufen wird. 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 Property jobExpireTime der Ressource report wird das Datum und die Uhrzeit angegeben, zu der der mit dem Bericht verknüpfte Job abgelaufen ist oder ablaufen wird. Diese Property enthält denselben Wert wie die Property 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, einschließlich derer, die vor dieser Ankündigung erstellt wurden.

    Berichte zu bisherigen Daten werden veröffentlicht, sobald sie verfügbar sind. Es dauert jedoch etwa einen Monat, bis alle Verlaufsdaten für einen Job veröffentlicht sind. Einen Monat nach dem Planen eines Berichtsauftrags haben Sie also Zugriff auf Daten für etwa sieben Monate. (Alle Verlaufsdaten für Jobs, die vor dieser Ankündigung erstellt wurden, sollten innerhalb eines Monats nach der Ankündigung gepostet werden.)

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

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

  • Der Abschnitt Berichtsmerkmale in der Übersicht zur YouTube Reporting API wurde aktualisiert und enthält jetzt die folgenden Änderungen:

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

    • Die Dokumentation wurde aktualisiert, um zu verdeutlichen, 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 automatisch generierter, systemverwalteter Berichte, die Daten zu Werbeeinnahmen oder YouTube Red-Aboeinnahmen enthalten. Die Berichte sind für Rechteinhaber verfügbar, die bereits Zugriff auf manuell herunterladbare Umsatzberichte in YouTube Studio haben. Die neue API-Funktion bietet also programmatischen Zugriff auf diese Daten.

    Die folgenden API-Änderungen werden jetzt zur Vorbereitung auf die Einführung systemverwalteter Berichte angekündigt:

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

    • Der neue Parameter includeSystemManaged 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 Parameter startTimeAtOrAfter der Methode jobs.reports.list gibt an, dass die API-Antwort nur Berichte enthalten soll, wenn die frühesten Daten im Bericht am oder nach dem angegebenen Datum liegen. Ebenso 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 Parameter createdAfter der Methode, der sich auf den Zeitpunkt der Erstellung des Berichts bezieht, 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 vom System 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 Dienste zum Teilen 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, die auf der YouTube-Startseite oder dem Startbildschirm, im Abofeed des Nutzers oder in einer anderen YouTube-Suchfunktion stattgefunden haben.
    • 8: Die Daten beziehen sich auf Aufrufe, die direkt auf der YouTube-Suchergebnisseite stattgefunden haben.
  • 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 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, die auf der YouTube-Startseite oder dem Startbildschirm, im Abofeed des Nutzers oder in einer anderen YouTube-Suchfunktion stattgefunden haben.
    • SEARCH: Die Daten beziehen sich auf Aufrufe, die direkt auf der YouTube-Suchergebnisseite stattgefunden haben.
  • 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 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 abgespielt wurde.

8. Februar 2016

Die Liste der von der YouTube Analytics API unterstützten Messwerte wurde aktualisiert. Messwerte für Infokarten werden nicht mehr als unterstützte Messwerte für diese API aufgeführt. (In keinem der Berichte dieser API wurde dokumentiert, dass sie einen der Kartenmesswerte unterstützen.)

Du kannst Messwerte zu Infokarten weiterhin über die YouTube Reporting API abrufen. Diese API unterstützt diese Messwerte für zahlreiche Kanal- und Rechteinhaberberichte.

6. Januar 2016

Die YouTube Reporting API und die YouTube Analytics API identifizieren jetzt speziell Aufrufe, die über ein Chromecast-Gerät erfolgen.

  • 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 in der 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 in den Berichten zurückgegebenen Namen übereinstimmen. Zuvor wurden die Namen als clickable_annotation_impressions und closable_annotation_impressions dokumentiert.

18. Dezember 2015

Gemäß den Gesetzen der Europäischen Union (EU) müssen Endnutzern in der EU bestimmte Informationen 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 die Nutzungsbedingungen der YouTube API 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 Dimensionen für Wiedergabedetails, die in verschiedenen Berichten für Kanäle und Rechteinhaber verwendet werden können:

    • liveOrOnDemand: Diese Dimension gibt an, ob die Daten im Bericht Nutzeraktivitäten während einer Liveübertragung beschreiben.
    • subscribedStatus: Diese Dimension gibt an, ob die Messwerte zur Nutzeraktivität 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 YouTube-Website (oder YouTube App), YouTube Gaming und YouTube Kids.

    Die Dokumentation wurde aktualisiert, um neue Wiedergabedetailberichte zu identifizieren, die für Kanäle und Rechteinhaber verfügbar sind. Außerdem wurden viele andere Berichte aktualisiert, um darauf hinzuweisen, 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, damit Sie gültige Kombinationen von Dimensionen, Messwerten und Filtern, die zum Abrufen der einzelnen Berichte verwendet werden können, leichter erkennen können. In der folgenden Tabelle, in der der Bericht „Gerätetyp“ für Kanäle erläutert wird, ist das neue Format zu sehen:

    Attribut Wert
    Abmessungen:
    Erforderlich deviceType
    Verwenden Sie 0 oder mehr day, liveOrOnDemand, subscribedStatus, youtubeProduct
    Messwerte:
    Mindestens 1 verwenden views, estimatedMinutesWatched
    Filter:
    Verwenden Sie „0“ oder „1“. country, province, continent, subContinent
    Verwenden Sie „0“ oder „1“. video, group
    Verwenden Sie 0 oder mehr operatingSystem, liveOrOnDemand, subscribedStatus, youtubeProduct

    Die Terminologie für Pflichtfelder und optionale Felder wird in der Dokumentation zu Kanalberichten und Rechteinhaberberichten erläutert.

  • Die YouTube Analytics API entfernt jetzt automatisch Entitäten, für die der API-Nutzer keine Daten abrufen kann, aus Filtern, die mehrere Werte unterstützen (video, playlist und channel). 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 identifiziert jedoch ein Video, das einem anderen Kanal gehört, und eine andere ID identifiziert ein Video, das gelöscht wurde und daher nicht mehr existiert. In diesem Fall gibt der API-Server keinen Fehler zurück, sondern lässt die beiden Videos, auf die der Nutzer nicht zugreifen kann, weg. Die API-Antwort enthält dann Daten für die 18 Videos, die dem API-Nutzer gehören.

  • Wenn du Daten für eine leere YouTube Analytics-group anforderst, gibt die API jetzt einen leeren Datensatz anstelle eines Fehlers zurück.

  • Die Methode groupItems.insert der YouTube Analytics API gibt jetzt den Fehler „Nicht autorisiert“ (HTTP-Antwortcode 403) zurück, wenn du versuchst, einer Gruppe eine Entität hinzuzufügen, auf die du keinen Zugriff hast. Bisher konnten Sie die Entität über die API zur Gruppe hinzufügen, erhielten aber später eine Fehlermeldung, wenn Sie versuchten, Berichtsdaten für diese Gruppe abzurufen.

  • Die Methode groups.list der YouTube Analytics API unterstützt jetzt die Paginierung. Wenn die API-Antwort nicht alle verfügbaren Gruppen enthält, wird im Parameter nextPageToken der Antwort ein Token angegeben, mit dem die nächste Ergebnisseite abgerufen werden kann. Legen Sie den Parameter pageToken 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. Datumsangaben beziehen sich jetzt auf den 24-Stunden-Zeitraum, der um 00:00 Uhr Pacific Time (UTC-8) beginnt. Bisher hieß es in der Dokumentation, 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 Datumsangaben ab 00:00 Uhr Pacific Time (UTC-8) beziehen.

  • Die Methode jobs.reports.list() der YouTube Reporting API unterstützt jetzt den Suchparameter createdAfter. Wenn dieser Parameter angegeben ist, werden in der API-Antwort nur Berichte aufgeführt, die nach dem angegebenen Datum und der angegebenen Uhrzeit erstellt wurden, einschließlich neuer Berichte mit nachträglich eingefügten Daten. Der Parameterwert bezieht sich auf den Zeitpunkt, zu dem der Bericht erstellt wird, und nicht auf die Daten, die mit den zurückgegebenen Daten verknüpft 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 erklärt, wie du mit dem Parameter createdAfter verhindern kannst, dass derselbe Bericht wiederholt verarbeitet wird.

  • Die Definitionen des Attributs createTime der Ressource job und der Attribute startTime, endTime und createTime der Ressource report wurden korrigiert, um darauf hinzuweisen, dass die Attributwerte auf Mikrosekunden und nicht auf Nanosekunden genau sind. Außerdem wird in allen Definitionen jetzt korrekt angegeben, dass der Attributwert 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 möglicher Dimensionswerte. Die Liste enthält eine Reihe neu unterstützter Dienste.

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

24. September 2015

Dieses Update enthält die folgenden Änderungen:

  • Die neue YouTube Reporting API ruft Bulk-Datenberichte ab, die YouTube Analytics-Daten für einen Kanal oder Rechteinhaber enthalten. Es ist für Anwendungen konzipiert, die große Datasets importieren können und Tools zum Filtern, Sortieren und Mining dieser Daten bieten.

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

    Mit der API kannst du Berichtsjobs planen, die jeweils einen Bericht identifizieren, den YouTube erstellen soll. Nachdem du einen Job eingerichtet hast, erstellt YouTube einen täglichen Bericht, der asynchron heruntergeladen werden kann. Jeder Bericht enthält Daten für einen eindeutigen Zeitraum von 24 Stunden.

  • Obwohl es sich um unterschiedliche APIs handelt, können Entwickler sowohl mit der YouTube Analytics API als auch mit der YouTube Reporting API YouTube Analytics-Daten abrufen. Da beide APIs Zugriff auf ähnliche Datensätze bieten, wird die Dokumentation für die beiden APIs als ein einziger Dokumentationssatz 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 Abfragen enthält Referenzdokumentation und andere Inhalte speziell für die YouTube Analytics API.
    • Auf dem Tab Beispiele finden Sie Codebeispiele für beide APIs.
    • Auf dem Tab Tools sind zusätzliche Ressourcen aufgeführt, die Entwicklern bei der Implementierung der beiden APIs helfen können.

20. August 2015

Dieses Update enthält die folgenden Änderungen:

  • Die API-Dokumentation wurde umstrukturiert, um die API verständlicher zu machen. Diese Änderungen beschreiben also keine neuen Funktionen:

    • Die Dokumentation enthält jetzt eine Seite, auf der alle verfügbaren Kanalberichte aufgeführt sind, und eine weitere Seite, auf der alle verfügbaren Berichte für Rechteinhaber aufgeführt sind. Bisher gab es in der Dokumentation separate Seiten für Kanalvideoberichte, Kanalplaylistberichte usw.

    • Die neue Übersicht über das Datenmodell soll eine klarere Einführung in die Funktionsweise der API bieten. Insbesondere wird in diesem Dokument 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 zu finden. Auf der neuen Seite können Sie die Informationen, die Sie zum Abrufen eines Berichts senden müssen, leichter finden.

22. Juli 2015

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

  • Der neue Messwert „adEarnings“ umfasst die geschätzten Gesamteinnahmen (Nettoumsatz) aus allen von Google verkauften Werbequellen. Es ist kein Kernmesswert. Die API unterstützt den Messwert adEarnings für alle Berichte, die bereits den Messwert earnings unterstützen.

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

  • 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 mehreren Videoberichten sind diese Messwerte jedoch weiterhin verfügbar.

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 Rechteinhaber wurden aktualisiert, um die Berichte zu kennzeichnen, die die neuen Messwerte unterstützen.

    • videosAddedToPlaylists: Gibt an, wie oft Videos im Bereich der Abfrage zu YouTube-Playlists hinzugefügt wurden. Die Videos können der Playlist des Videoinhabers oder den Playlists anderer Kanäle hinzugefügt worden sein.
    • videosRemovedFromPlaylists: Gibt an, wie oft Videos im Bereich der Abfrage aus YouTube-Playlists entfernt wurden. Die Videos wurden möglicherweise aus der Playlist des Videoinhabers oder aus den Playlists anderer Kanäle entfernt.

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

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

31. März 2015

Dieses Update enthält die folgenden Änderungen:

16. März 2015

Dieses Update enthält die folgenden Änderungen:

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

    Der Parameterwert ist ein dreistelliger ISO 4217-Währungscode. 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 Ressource group stellt eine Analytics-Gruppe dar, 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 Ressource groupItem 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, die als Filter für viele Kanalberichte und Rechteinhaberberichte verwendet werden kann. Wenn Sie den Filter group verwenden, gibt die API Daten für alle Elemente in dieser Gruppe zurück. Die API unterstützt derzeit nicht die Erstellung von Berichten für Asset-Gruppen.

    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 du mehrere Werte angeben möchtest, setze den Parameterwert filters auf eine durch Kommas getrennte Liste der Video-, Playlist-, Kanal- oder Serien-IDs, nach denen die API-Antwort gefiltert werden soll. Der Parameterwert kann bis zu 200 IDs enthalten.

    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. Das gilt auch, wenn der Filter für einen bestimmten Bericht nicht als unterstützte Dimension aufgeführt ist. Wenn Sie den Filter der Liste der Dimensionen hinzufügen, verwendet die API die Filterwerte auch zum Gruppieren der Ergebnisse.

    Ausführliche Informationen zu dieser Funktion finden Sie in der Definition des Parameters filters.

16. Juli 2014

Dieses Update enthält die folgenden Änderungen:

  • Wenn du einen Kanalbericht abrufst, kannst du jetzt Daten für den Kanal des authentifizierten Nutzers abrufen, indem du den Wert des Parameters ids auf channel==MINE setzt. (Du kannst den Parameter ids auch weiterhin auf channel==CHANNEL_ID setzen, um Daten für den angegebenen Kanal abzurufen.)

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

    Alle Playlistberichte unterstützen die Messwerte views und estimatedMinutesWatched, einige auch den Messwert averageViewDuration.

    Außerdem werden in allen Playlist-Berichten die folgenden neuen Messwerte unterstützt. Diese Messwerte beziehen sich nur auf Playlist-Aufrufe im Web.

    • playlistStarts: Die Gesamtzahl von zuschauerseitigen Wiedergabestarts einer Playlist
    • 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.

    Bei jeder 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 die Zuschauerbindung eines Videos gemessen. Mit der neuen Dimension elapsedVideoTimeRatio des Berichts wird der Anteil des Videos gemessen, der für die entsprechenden Messwerte verstrichen ist:

    • Der Messwert audienceWatchRatio gibt den absoluten Anteil der Zuschauer an, die sich das Video an der angegebenen Stelle ansehen. Das Verhältnis wird berechnet, indem die Anzahl der Aufrufe eines Videosegments mit der Gesamtzahl der Aufrufe des Videos verglichen wird.

      Beachte, dass ein Teil eines Videos bei einem Videoaufruf mehr als einmal (oder gar nicht) angesehen werden kann. Wenn Nutzer beispielsweise denselben Teil eines Videos mehrmals zurückspulen und 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 bindet. Ein Wert von 0 bedeutet, dass das Video Zuschauer schlechter bindet als jedes andere Video ähnlicher Länge. Ein Wert von 1 bedeutet, dass das Video Zuschauer besser bindet als jedes andere Video ähnlicher Länge. Ein Medianwert von 0,5 bedeutet, dass die Hälfte der Videos ähnlicher Länge die Zuschauer besser bindet, während die andere Hälfte die Zuschauer schlechter bindet.

    Du kannst auch den Filter audienceType verwenden, damit der Bericht nur Daten zu organischen Aufrufen, Aufrufen von TrueView In-Stream-Anzeigen oder Aufrufen von TrueView In-Display-Anzeigen enthält. 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, die zuvor die Messwerte annotationClickThroughRate und annotationCloseRate unterstützt haben.

    Alle neuen Messwerte sind Kernmesswerte und unterliegen der Richtlinie zur Einstellung von Produkten und Diensten. Beachten Sie jedoch, dass Daten für die neuen Messwerte ab dem 16. Juli 2013 verfügbar sind. (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 Traffic-Quellentyp EXT_URL zugeordnet. Daher ist es auch nicht mehr möglich, einen insightTrafficSourceDetail-Bericht abzurufen, bei 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 mit den Beispielanfragen wurde überarbeitet. Die Beispiele sind jetzt in Kategorien gruppiert und werden in einem Tab-Format angezeigt, das dem kürzlich veröffentlichten Format für Kanal- und Rechteinhaberberichte ähnelt. 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 Berichterstellung für Rechteinhaber)

  • Das Dokument mit den Beispielanfragen enthält jetzt neue Beispiele für das Abrufen von provinzspezifischen Daten in Kanal- oder Rechteinhaberberichten.

    • Provinzspezifische Messwerte für US-Bundesstaaten und Washington, D.C.: Dieser Bericht enthält eine Aufschlüsselung der Aufrufzahlen und anderer Statistiken für die Videos eines Kanals nach Provinz. Die Daten decken US-Bundesstaaten und Washington, D.C. ab.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 zu Altersgruppe und Geschlecht der Zuschauer in Kalifornien, die sich die Videos eines Kanals oder, bei Berichten für Rechteinhaber, die beanspruchten Inhalte eines Rechteinhabers angesehen haben. In diesem Beispiel wird der Parameter filters verwendet, damit 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, muss die Anfrage auch die Daten auf die USA beschränken, indem country==US im Parameterwert filters enthalten ist.

6. Januar 2014

Dieses Update enthält die folgenden Änderungen:

  • Die Dokumente, in denen die unterstützten Berichte für Kanäle und Rechteinhaber aufgeführt sind, wurden überarbeitet. Anstatt eine Tabelle mit allen möglichen Berichten bereitzustellen, werden die Berichte in jedem Dokument in Kategorien unterteilt:

    • 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 Verwendungszwecke für diese Dimension:

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

        • Der Bericht mit den wichtigsten Statistiken enthält verschiedene Statistiken, darunter die Anzahl der Aufrufe und die geschätzte Wiedergabezeit in Minuten.
        • Der zeitbasierte Bericht enthält dieselben Statistiken, die Daten werden jedoch auf täglicher, 7-tägiger, 30-tägiger oder monatlicher Basis aggregiert.

      • Mit dem Suchparameter filters können Sie einen Bericht so einschränken, dass er nur Statistiken für einen bestimmten Status enthält. Diese Art der Filterung wird von mehreren Berichten unterstützt, darunter Standortberichte, Wiedergabeorten, Zugriffsquellen, Geräten, Betriebssystemen, Berichte zur Leistung nach demografischen Merkmalen und Top-Videos.

    • Die Dimension continent gibt einen statistischen Regionscode der Vereinten Nationen (UN) an, der einen Kontinent identifiziert. Diese Dimension kann nur als Filter verwendet werden.

    • Die Dimension subContinent gibt einen statistischen Regionscode der Vereinten Nationen (UN) an, der eine Subregion eines Kontinents identifiziert. Diese Dimension kann auch nur als Filter verwendet werden.

      Da jede Subregion nur einem Kontinent zugeordnet ist, müssen Sie den Filter continent nicht verwenden, wenn Sie den Filter subContinent verwenden. Die API gibt sogar einen Fehler zurück, wenn in einer Anfrage beide Dimensionen verwendet werden.

  • Die Dokumentation wurde korrigiert, sodass die Dimension insightTrafficSourceDetail den insightTrafficSourceType-Wert 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 Richtlinie zur Einstellung von Produkten und Diensten, die in den Nutzungsbedingungen beschrieben ist. Die nicht zentralen Dimensionen und Messwerte der API unterliegen jedoch nicht der Richtlinie zur Einstellung von Produkten und Diensten. Die Seiten Dimensionen und Messwerte wurden aktualisiert und enthalten jetzt die Kerndimensionen und -messwerte. Außerdem wurden die Definitionen auf diesen Seiten aktualisiert, um die wichtigsten Dimensionen und Messwerte explizit zu kennzeichnen.

  • Die API unterstützt jetzt EXTERNAL_APP als Wert für die Dimension insightPlaybackLocationType. Im Zusammenhang mit diesem Update werden Wiedergaben seit 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 jetzt je nach Art der App, in der die Wiedergabe erfolgt, 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 über eine Playlist generiert wurden. 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 die Möglichkeit, Berichte nach mehreren Dimensionen und Messwerten zu sortieren. Das Dokument mit Beispielanfragen enthält ein neues Beispiel, Anfragen nach mehreren Dimensionen/Messwerten sortieren, in dem diese Funktion demonstriert wird. Mit der Anfrage werden Daten zur Zugriffsquelle abgerufen. Der Parameterwert sort ist day,-views. Die Ergebnisse sind chronologisch sortiert. Innerhalb der Ergebnismenge für jeden Tag enthält die erste Zeile jedoch Daten für die Zugriffsquelle, 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 denen du Daten zu den Geräten abrufen kannst, auf denen Zuschauer deine Videos ansehen. Die API unterstützt Berichte, die eine oder beide Dimensionen verwenden.

    • Mit dem Bericht deviceType kannst du die Anzahl der Aufrufe und die geschätzte Wiedergabezeit für verschiedene Gerätetypen abrufen, darunter Computer, Mobilgeräte 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 kannst du die Anzahl der Aufrufe und die geschätzte Wiedergabezeit für verschiedene Betriebssysteme wie Android, iOS und Linux abrufen. Sie können auch den Filter deviceType verwenden, um den Bericht zu Betriebssystemen auf Statistiken für einen bestimmten Gerätetyp zu beschränken, z. B. Mobilgeräte oder Tablets.

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

  • Das Dokument mit den Beispielanfragen wurde um drei Geräteberichte für Kanäle und drei Geräteberichte für Rechteinhaber erweitert.

  • Die Dimension insightPlaybackLocationType kann den Wert YT_OTHER zurückgeben. Damit werden Aufrufe identifiziert, die nicht mit einem der anderen Werte der Dimension klassifiziert sind.

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:

  • Die API unterstützt jetzt die Möglichkeit, Messwerte zur Wiedergabezeit (estimatedMinutesWatched, averageViewDuration und averageViewPercentage) in Verbindung mit anderen Messwerten abzurufen, darunter Messwerte zu Aufrufen, Interaktionen, Einnahmen und Anzeigenleistung.

    Die Listen der verfügbaren Kanalberichte und Rechteinhaberberichte wurden entsprechend aktualisiert. Die Listen sind jetzt kürzer, da die Messwerte zur Wiedergabezeit im Rahmen anderer aufgeführter Berichte abgerufen werden können.

    Das Dokument Beispiel-API-Anfragen wurde ebenfalls aktualisiert.

  • Die Berichte, in denen die Dimensionen insightPlaybackLocationDetail und insightTrafficSourceDetail verwendet werden, wurden folgendermaßen verbessert:

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

    • Rechteinhaber können diese Berichte jetzt mit einer der folgenden neuen filter-Kombinationen abrufen. Beachten Sie, dass alle diese Kombinationen auch den optionalen Filter country unterstützen.

      • Details zum Ort der Wiedergabe

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

      • Details zur Traffic-Quelle

        • 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, die zeigen, 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, und zeigt dann die Dimensionen, Messwerte, Filter und Sortierparameter für die Anfrage.

  • Die Dimension insightTrafficSourceType unterstützt jetzt SUBSCRIBER als gültigen Wert. Dieser Wert gibt die Anzahl der Videoaufrufe an, die über Feeds auf der YouTube-Startseite oder über YouTube-Abofunktionen generiert wurden. Wenn du nach dieser Zugriffsquelle filterst, wird im Feld insightTrafficSourceDetail der Startseitenfeed oder eine andere Seite angegeben, von der die Aufrufe stammen.

28. März 2013

Dieses Update enthält die folgenden Änderungen:

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

    • annotationClickThroughRate: Das Verhältnis zwischen der Anzahl der Anmerkungen, auf die Zuschauer geklickt haben, und der Gesamtzahl der Impressionen anklickbarer Anmerkungen.
    • annotationCloseRate: Das Verhältnis der von Zuschauern geschlossenen Anmerkungen zur 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-Inhaltspartner verfügbar, die am YouTube-Partnerprogramm teilnehmen.

    • Die neu unterstützten Berichte enthalten wiedergabebasierte und impressionsbasierte Messwerte zur Anzeigenleistung. Weitere Informationen zu Berichten zur Anzeigenleistung findest du 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, um die Berichte zu identifizieren, die diese Messwerte unterstützen, einschließlich der beiden neuen Berichte.

      • earnings: Geschätzte Gesamteinnahmen aus allen von Google verkauften Werbequellen.
      • grossRevenue: Geschätzte Bruttoeinnahmen von Google- oder DoubleClick-Partnern.
      • primaryAdGrossRevenue: Geschätzte Bruttoeinnahmen, summiert und klassifiziert nach dem primären Anzeigentyp für die Videowiedergaben, die der Bericht abdeckt, von Google- oder DoubleClick-Partnern.
      • monetizedPlaybacks: Die Anzahl der Wiedergaben, bei denen mindestens eine Anzeigenimpression erzielt wurde.
      • playbackBasedCpm: Geschätzte Bruttoeinnahmen pro 1.000 Wiedergaben.
      • impressions: Die Anzahl der ausgelieferten bestätigten Anzeigenimpressionen.
      • impressionBasedCpm: Geschätzte Bruttoeinnahmen pro 1.000 Anzeigenimpressionen.

      Hinweis: Ausführliche Informationen finden Sie in den Definitionen von Messwerten.

    • Bei jeder Anfrage, mit der Einnahmen oder Leistungsmesswerte zur Anzeigenleistung abgerufen werden, muss ein Autorisierungstoken gesendet werden, das den Zugriff über den neuen https://www.googleapis.com/auth/yt-analytics-monetary.readonly-Bereich gewährt.

  • Die API-Dokumentation wurde neu organisiert, sodass verschiedene Arten von Berichten auf separaten Seiten erläutert werden. Daher gibt es jetzt separate Seiten, auf denen die verschiedenen Arten von Kanalberichten und Rechteinhaberberichten erläutert werden.

4. Februar 2013

Dieses Update enthält die folgenden Änderungen:

  • Der API-Referenzleitfaden enthält jetzt einen Abschnitt mit Beispielen, in dem Codebeispiele für den Aufruf der API mit den Java-, JavaScript-, Python- und Ruby-Clientbibliotheken aufgeführt sind. Das JavaScript-Codebeispiel ist dasselbe, das in der Dokumentation zur Beispielanwendung ausführlich erläutert wird.

14. November 2012

Dieses Update enthält die folgenden Änderungen:

  • Der API-Referenzleitfaden enthält jetzt den APIs Explorer, mit dem Sie die API aufrufen, die API-Anfrage sehen 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 Rechteinhaberbericht verfügbar. Die Seiten zu Dimensionen und Messwerten wurden ebenfalls entsprechend aktualisiert.

    • Im Bericht „Wiedergabeort“ wird die Anzahl der Videoaufrufe auf verschiedenen Arten von Seiten oder Anwendungen angegeben.

    • Im Detailbericht zum Wiedergabeort werden die eingebetteten Player aufgeführt, die die meisten Aufrufe für ein bestimmtes Video generiert haben. Er bietet eine detailliertere Ansicht als der Bericht „Wiedergabeort“, da die URLs der am häufigsten eingebetteten Player identifiziert werden.

    • Im Bericht zu Zugriffsquellen wird die Anzahl der Videoaufrufe aufgeführt, die von verschiedenen Arten von Verweisen stammen.

    • Im Detailbericht zu Zugriffsquellen werden die Verweise aufgeführt, die die meisten Aufrufe für ein bestimmtes Video und einen bestimmten Zugriffsquellentyp generiert haben. In diesem Bericht siehst du beispielsweise, über welche ähnlichen Videos die meisten Zugriffe auf ein bestimmtes Video generiert wurden. Dieser Bericht wird für mehrere Traffic-Quellen unterstützt.

    • In Berichten zur Wiedergabezeit wird angegeben, wie lange sich Zuschauer deine Inhalte angesehen haben. In den Berichten können Daten für einen bestimmten Zeitraum (Tag, die letzten sieben Tage, die letzten 30 Tage usw.) oder ein bestimmtes Land zusammengefasst werden. Wenn in einem Bericht Daten nach Tag oder Land aggregiert werden, kann auch die durchschnittliche Länge jedes Videoaufrufs sowie der durchschnittliche Prozentsatz jedes Videos, den sich Nutzer angesehen haben, angegeben werden.

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 im Bereich Dienste in der APIs console aktivieren, ohne vorher Zugriff anfordern zu müssen.

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

12. September 2012

Dieses Update enthält die folgenden Änderungen:

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

  • Der Abschnitt Zeitliche Dimensionen wurde aktualisiert. Er enthält jetzt die Information, dass diese Dimensionen angeben, dass in einem Analytics-Bericht Daten basierend auf einem Zeitraum aggregiert werden sollen. Die API unterstützt jetzt die folgenden zusätzlichen zeitlichen Dimensionen:

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

    Der Abschnitt Verfügbare Berichte wurde ebenfalls aktualisiert, um die Unterstützung der API für Berichte mit diesen Dimensionen widerzuspiegeln.

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

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

  • Die Definitionen der Messwerte subscribersGained und subscribersLost wurden aktualisiert. Es wird jetzt erklärt, dass ein Kanal an mehreren Stellen Abonnenten gewinnen oder verlieren kann, z. B. auf der Wiedergabeseite des 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.