Überarbeitungsverlauf

Auf dieser Seite werden API-Änderungen und Aktualisierungen der Dokumentation sowohl für die YouTube Reporting API als auch für die YouTube Analytics API aufgeführt. Mit beiden APIs können Entwickler auf YouTube Analytics-Daten zugreifen, allerdings auf unterschiedliche Weise. Abonniere diese Änderungsliste. Abonnieren

15. November 2024

Hinweis:Die folgende Änderung tritt am 18. November 2024 in Kraft.

In der Dokumentation der YouTube Analytics API (gezielte Abfragen) wurde aktualisiert, dass die reports.query-Methode der API für Berichte zu Besucherquellen jetzt einen Fehler zurückgibt,wenn das Produkt aus Anzahl der abgefragten Videos × Anzahl der Tage im Zeitraum 50.000 übersteigt. 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 wirkt sich sowohl auf Berichte für Kanäle als auch für Rechteinhaber aus.

Wenn du die Anzahl der Zeilen verringern möchtest, die bei einer Anfrage zurückgegeben werden, kannst du die Abfrage in mehrere Abfragen aufteilen, in denen weniger Videos angegeben oder kürzere Zeiträume festgelegt werden. Für große Datenmengen werden in der Regel Bulk-Berichte empfohlen.

6. Mai 2024

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

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

7. April 2024

Die YouTube Analytics API (gezielte Abfragen) wurde in Bezug auf Playlist-Berichte für Rechteinhaber aktualisiert. Die Änderungen entsprechen denen, die am 19. Januar 2024 für Berichte zu Kanalplaylists angekündigt wurden.

Der folgende Eintrag im Änderungsverlauf enthält fast dieselben Informationen wie der Eintrag vom 19. Januar 2024. Hinweis: In Playlist-Berichten für Rechteinhaber wird die Dimension isCurated jedoch nur noch bis zum 31. Dezember 2024 unterstützt. In Kanalplaylist-Berichten ist sie noch bis zum 30. Juni 2024 verfügbar.

  • Hinweis:Dies ist eine Ankündigung zur Einstellung.

    Die Dimension isCurated wird für Playlist-Berichte von Rechteinhabern nicht mehr unterstützt. 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 deinen Code aktualisieren, um nur für Playlist-Berichte den Messwert playlistViews statt views abzurufen. Da der Messwert views weiterhin für Playlist-Berichte unterstützt wird, jedoch 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 in den neuen Berichten die folgenden API-Funktionen nicht mehr unterstützt:

    • Standortfilter wie continent und subcontinent werden in den neuen Berichten zu Kanalplaylists nicht unterstützt.
    • Die Messwerte redViews und estimatedRedMinutesWatched werden in den neuen Berichten zu Kanalplaylists nicht mehr unterstützt. Diese Messwerte waren in YouTube Studio nicht verfügbar. Mit dieser Änderung werden die API-Funktionen an die Funktionen in der Studio-Anwendung angepasst.
    • Die Dimensionen subscribedStatus und youtubeProduct werden nicht mehr als Filter für Berichte zu Kanalplaylists unterstützt. Diese Filter waren in YouTube Studio nicht verfügbar. Mit dieser Änderung werden die API-Funktionen an die Funktionen in der Studio App angepasst.

  • Der Abschnitt Playlist-Berichte in der Dokumentation zu Berichten für Rechteinhaber wurde aktualisiert. Dort werden die Messwerte, die für Playlist-Berichte unterstützt werden, jetzt ausführlicher erläutert:

    • Zusammengefasste Videomesswerte umfassen Nutzeraktivitäten und Impressionsmesswerte, die für alle Videos in den Playlists des Rechteinhabers zusammengefasst werden. Aggregierte Videomesswerte werden nur für API-Anfragen unterstützt, bei denen die Dimension isCurated nicht verwendet wird.
    • Messwerte für Playlists geben Aufschluss über die Nutzeraktivität und das Nutzer-Engagement im Kontext der Playlist-Seite. Diese Messwerte umfassen auch Daten zu Aufrufen von Videos, die nicht dir gehören, aber nur dann, wenn diese Aufrufe im Kontext der Playlist erfolgt sind.
    • Im Abschnitt Unterstützte Messwerte für Playlists werden die zusammengefassten Videomesswerte und Playlist-Messwerte aufgeführt, die für Playlist-Berichte unterstützt werden.

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

  • Das Verhalten des Messwerts views hängt jetzt davon ab, ob bei 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. Er gibt an, wie oft Videos im Kontext der Playlists des Rechteinhabers angesehen wurden.
    • Wenn eine Anfrage die Dimension isCurated nicht enthält, ist der Messwert views ein aggregierter Videomesswert, der angibt, wie oft Videos in den Playlists des Rechteinhabers insgesamt angesehen wurden, unabhängig davon, ob diese Aufrufe im Playlist-Kontext stattfanden. 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. Bei diesem Messwert werden die Aufrufe aller Videos in der Playlist gezählt, unabhängig davon, zu welchem Kanal sie gehören.

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

19. Januar 2024

Die YouTube Analytics API (gezielte Abfragen) wurde in Bezug auf Berichte zu Kanalplaylists aktualisiert. Die Aktualisierungen umfassen eine eingestellte Dimension und mehrere neue und aktualisierte Messwerte:

  • Hinweis:Dies ist eine Ankündigung zur Einstellung.

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

    Wenn du die Dimension isCurated entfernst, musst du deinen Code aktualisieren, um nur für Playlist-Berichte den Messwert playlistViews statt views abzurufen. Da der Messwert views weiterhin für Playlist-Berichte unterstützt wird, jedoch 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 in den neuen Berichten die folgenden API-Funktionen nicht mehr unterstützt:

    • Standortfilter wie continent und subcontinent werden in den neuen Berichten zu Kanalplaylists nicht unterstützt.
    • Die Messwerte redViews und estimatedRedMinutesWatched werden in den neuen Berichten zu Kanalplaylists nicht mehr unterstützt. Diese Messwerte waren in YouTube Studio nicht verfügbar. Mit dieser Änderung werden die API-Funktionen an die Funktionen in der Studio-Anwendung angepasst.
    • Die Dimensionen subscribedStatus und youtubeProduct werden nicht mehr als Filter für Berichte zu Kanalplaylists unterstützt. Diese Filter waren in YouTube Studio nicht verfügbar. Mit dieser Änderung werden die API-Funktionen an die Funktionen in der Studio App angepasst.

  • Der Abschnitt Playlist-Berichte in der Dokumentation zu Kanalberichten wurde aktualisiert. Dort werden die Messwerttypen, die für Playlist-Berichte unterstützt werden, jetzt ausführlicher erläutert:

    • Zusammengefasste Videomesswerte umfassen Messwerte zu Nutzeraktivitäten und Impressionen, die für alle Videos in den Playlists des Kanals zusammengefasst werden, die dem Kanal auch gehören. Aggregierte Videomesswerte werden nur für API-Anfragen unterstützt, bei denen die Dimension isCurated nicht verwendet wird.
    • Messwerte für Playlists geben Aufschluss über die Nutzeraktivität und das Nutzer-Engagement im Kontext der Playlist-Seite. Diese Messwerte umfassen auch Daten zu Aufrufen von Videos, die nicht dir gehören, aber nur dann, wenn diese Aufrufe im Kontext der Playlist erfolgt sind.
    • Im Abschnitt Unterstützte Messwerte für Playlists werden die zusammengefassten Videomesswerte und Playlist-Messwerte aufgeführt, die für Playlist-Berichte unterstützt werden.

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

  • Das Verhalten des Messwerts views hängt jetzt davon ab, ob bei 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 Messwert für die Playlist. Er gibt an, 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 angibt, wie oft das Video in den Playlists des Kanals insgesamt angesehen wurde, unabhängig davon, ob diese Aufrufe im Playlist-Kontext stattfanden. Die Gesamtzahl umfasst nur Aufrufe von Videos, die dem Kanalinhaber der Playlist gehören.

      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. Bei diesem Messwert werden die Aufrufe aller Videos in der Playlist gezählt, unabhängig davon, zu welchem Kanal sie gehören.

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

4. Dezember 2023

Die YouTube Analytics API (gezielte Abfragen) wurde aktualisiert, um zwei insightTrafficSourceType-Dimensionswerte zusammenzuführen. Bisher wurde in der Dimension zwischen Wiedergaben von Videos unterschieden, die im Rahmen einer Playlist abgespielt wurden (PLAYLIST), und Wiedergaben, die über eine Seite mit allen Videos in einer Playlist aufgerufen wurden (YT_PLAYLIST_PAGE). Künftig werden beide Arten von Wiedergaben dem Dimensionswert PLAYLIST zugeordnet.

15. Dezember 2022

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

  • In einem neuen Bericht werden Nutzeraktivitäten nach Städten aufgeschlüsselt. Dieser Bericht ist für Kanäle und Rechteinhaber verfügbar. Dieser Bericht enthält die neue Dimension city. Sie gibt die Schätzung von YouTube für die Stadt an, in der die Nutzeraktivität stattgefunden hat.

  • Die neue Dimension creatorContentType gibt an, welche Art von YouTube-Inhalten den Messwerten für Nutzeraktivitäten in der Datenzeile zugeordnet ist. Unterstützte Werte sind LIVE_STREAM, SHORTS, STORY und VIDEO_ON_DEMAND.

    Die Dimension creatorContentType wird als optionale Dimension für alle Videoberichte zu Kanälen und Rechteinhabern unterstützt.

  • Der Leitfaden für Beispielanfragen der 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

Sowohl die YouTube Analytics API (gezielte Abfragen) als auch die YouTube Reporting API (Bulk-Berichte) unterstützen einen neuen Detailwert für Zugriffsquellen:

  • Wenn der Wert der Dimension insightTrafficSourceType in der YouTube Analytics API (gezielte Abfragen) SUBSCRIBER ist, kann der Wert insightTrafficSourceDetail auf podcasts gesetzt werden. Das bedeutet, dass die Zugriffe über die Zielseite „Podcasts“ erfolgt sind.
  • Wenn der Wert der Dimension traffic_source_type in der YouTube Reporting API (Bulk Reports API) 3 ist, kann der Wert traffic_source_detail auf podcasts gesetzt werden. Das bedeutet, dass die Zugriffe über die Zielseite der Podcasts erfolgt sind.

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 an Ihrer API-Implementierung sein. Gemäß dem Abschnitt Abwärtsinkompatible Änderungen der Nutzungsbedingungen der YouTube API-Dienste wird diese Änderung sechs Monate vor Inkrafttreten angekündigt. Bitte aktualisieren Sie Ihre API-Implementierung vor dem 11. August 2022, um eine reibungslose Umstellung auf die neuen Werte zu ermöglichen.

Die Änderungen betreffen Folgendes:

  • In der YouTube Analytics API (gezielte Abfragen) werden für die Dimension gender derzeit zwei Werte unterstützt: 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 Reports API) werden für die Dimension gender derzeit drei Werte unterstützt: FEMALE, MALE und GENDER_OTHER. Ab dem 11. August 2022 werden nur noch die Werte FEMALE, MALE und USER_SPECIFIED unterstützt.

9. Februar 2022

Zwei Messwerte wurden am 13. Dezember 2021 aktualisiert, um Zugriffe auf Looping-Clips auszuschließen. Diese Änderung betrifft sowohl die YouTube Analytics API (gezielte Abfragen) als auch die YouTube Reporting API (Bulk-Berichte).

2. Februar 2022

Diese YouTube-API für Berichte (Bulk-Berichte) unterstützt einen neuen Wert für die Dimension „Trafficquelle“, der angibt, dass die Aufrufe über Live-Weiterleitungen erfolgt sind:

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

Bei diesem Trafficquellentyp gibt die Dimension traffic_source_detail die Kanal-ID an, über die der Zuschauer weitergeleitet wurde.

23. September 2020

Sowohl die YouTube Analytics API (gezielte Abfragen) als auch die YouTube Reporting API (Bulk-Berichte) unterstützen einen neuen Dimensionswert für die Zugriffsquelle, der angibt, dass der Zuschauer durch Wischen vertikal in YouTube Shorts weitergeleitet wurde:

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

Die Detaildimension „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. Mit dem Parameter können mehrere Werte für die Filter video, playlist und channel angegeben werden. Die maximale Anzahl der IDs, die für diese Filter angegeben werden können, wurde von 200 auf 500 erhöht.

13. Februar 2020

Dieses Update enthält die folgenden Änderungen an 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 ändern sich die möglichen Detailwerte für Besucherquellen für Benachrichtigungen. In gezielten Abfragen werden Benachrichtigungen als insightTrafficSourceType=NOTIFICATION erfasst. In Bulk-Berichten werden Benachrichtigungen als traffic_source_type=17 erfasst.

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

  • uploaded_push – Aufrufe, die über Push-Benachrichtigungen erzielt wurden, die Abonnenten beim Upload eines Videos gesendet wurden
  • uploaded_other: Aufrufe, die über nicht pushbasierte Benachrichtigungen wie E-Mails oder Benachrichtigungen im Posteingang entstanden sind, die an Abonnenten gesendet wurden, wenn ein Video hochgeladen wurde.

Diese Werte werden für den Zeitraum ab dem 13. Januar 2020 zurückgegeben.

Zur Erinnerung: Diese Werte beziehen sich nicht auf Benachrichtigungen selbst, sondern auf 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 angezeigt werden, bedeutet das, dass drei Aufrufe dadurch zustande gekommen sind, dass Zuschauer auf Push-Benachrichtigungen geklickt haben, die beim Hochladen des Videos gesendet wurden.

15. Oktober 2019

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

  • Hinweis:Dies ist eine Ankündigung zur Einstellung.

    YouTube unterstützt die Dimensionen 7DayTotals und 30DayTotals nicht mehr. Bis zum 15. April 2020 können Sie Daten mithilfe dieser Dimensionen abrufen. Ab diesem Datum werden beim Abrufen von Berichten mithilfe der Dimension 7DayTotals oder 30DayTotals Fehler zurückgegeben.

    Nutzer können einige der Daten für diese Dimensionen reproduzieren, indem sie Abfragen mit der Dimension day stellen und Daten über einen Zeitraum von sieben oder 30 Tagen aggregieren oder ableiten. Beispiel:

    • Die Anzahl der Aufrufe für einen Zeitraum von sieben Tagen lässt sich berechnen, indem die Anzahl der Aufrufe für jeden Tag dieses Zeitraums zusammengefasst wird.
    • Der Prozentsatz der Zuschauer für einen Zeitraum von sieben Tagen wird berechnet, indem die Anzahl der Aufrufe pro Tag mit dem Prozentsatz der Zuschauer für diesen Tag multipliziert wird. So erhältst du die Anzahl der Zuschauer, die bei der Wiedergabe des Videos an diesem Tag angemeldet waren. Anschließend kannst du die Anzahl der angemeldeten Zuschauer für den gesamten Zeitraum addieren und durch die Gesamtzahl der Aufrufe für diesen Zeitraum teilen, um den Prozentsatz der Zuschauer für den gesamten Zeitraum zu erhalten.
    • Die Anzahl der einzelnen Zuschauer für einen Zeitraum von sieben Tagen kann nicht berechnet werden, da derselbe Zuschauer an verschiedenen Tagen als einzelner Zuschauer gezählt werden könnte. Möglicherweise 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 mit der Dimension 30DayTotals 30-Tage-Zeiträume basierend auf dem angegebenen Start- und Enddatum berechnet werden.

27. Juni 2019

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

  • Da Version 1 der API jetzt vollständig eingestellt wurde, wurden aus der Dokumentation Verweise auf diese Version entfernt, einschließlich der Mitteilung zur Einstellung und des Migrationsleitfadens, in dem die Aktualisierung auf Version 2 erläutert wird.

1. November 2018

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

  • Version 1 der API wird eingestellt. Bitte aktualisieren Sie Ihre API-Clients so bald wie möglich auf Version 2 der API, um Dienstunterbrechungen zu minimieren. Weitere Informationen finden Sie im Migrationsleitfaden.

    Der Zeitplan für diese Einstellung wurde ursprünglich am 26. April 2018 bekannt gegeben.

17. September 2018

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

  • Im neuen Abschnitt Datenanonymisierung des Übersichtsdokuments zum Datenmodell wird erläutert, dass einige YouTube Analytics-Daten eingeschränkt sind, wenn die Messwerte einen bestimmten Grenzwert nicht erreichen. Das kann verschiedene Ursachen haben. In der Praxis bedeutet das, dass ein Bericht möglicherweise nicht alle oder keine Ihrer Daten enthält, wenn:

    1. ein Video oder Kanal im ausgewählten Zeitraum nicht genügend Zugriffe hat,

      oder

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

    Außerdem wird dort erläutert, welche Datentypen in YouTube Analytics-Berichten möglicherweise eingeschränkt sind.

  • Die Dokumente zu Kanalberichten und Berichten für Rechteinhaber wurden aktualisiert. Die Messwerte redViews und estimatedRedMinutesWatched werden in Berichten zu Wiedergabestandort, Besucherquelle 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 Gültigkeitsanforderungen für die folgenden Methoden haben sich geändert:
    • Anfragen an die reports.query-Methode müssen Zugriff auf den Bereich https://www.googleapis.com/auth/youtube.readonly haben.
    • Anfragen an die groupItems.list-Methode müssen Zugriff auf Folgendes haben:
      • den https://www.googleapis.com/auth/youtube-Umfang
        oder
      • den https://www.googleapis.com/auth/youtube.readonly-Umfang
        und
        den https://www.googleapis.com/auth/yt-analytics.readonly-Umfang

      Bei der ersten Option wird ein Bereich mit Schreib-/Lesezugriff verwendet, bei der zweiten Option zwei Bereiche mit Lesezugriff.

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 Aggregierte Messwerte und gelöschte Elemente, in dem erläutert wird, wie in API-Antworten mit Daten umgegangen wird, die mit gelöschten Ressourcen wie Videos, Playlists oder Kanälen verknüpft sind.
  • Im Abschnitt Best Practices der API-Übersicht wurde darauf hingewiesen, dass du mit der YouTube Data API zusätzliche Metadaten für Ressourcen abrufen kannst, die in YouTube Analytics API-Antworten angegeben sind. 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 aus dieser API nach 30 Tagen entweder löschen oder aktualisieren.

22. Mai 2018

Dieses Update enthält die folgenden Änderungen an 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 Berichtsaufträge.

    • 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 nach der Erstellung verfügbar.

      Vor dieser Ankündigung waren alle API-Berichte 180 Tage lang nach ihrer Erstellung verfügbar. Nach Inkrafttreten dieser Richtlinienänderung können Berichte mit Verlaufsdaten, die älter als 30 Tage sind, nicht mehr über die API abgerufen werden. Auf alle anderen Berichte, die älter als 60 Tage sind, kann dann ebenfalls nicht mehr zugegriffen werden. Daher wird in der Dokumentation jetzt angegeben, dass Berichte, die vor der Richtlinienänderung erstellt wurden, bis zu 180 Tage lang verfügbar sind.

    • Wenn Sie nach der Änderung einen Berichterstellungsjob planen, generiert YouTube Berichte ab diesem Tag und für den Zeitraum von 30 Tagen vor der Planung des Jobs. Vor der Änderung wurden bei der Planung eines Berichterstellungsjobs Berichte für den Zeitraum von 180 Tagen vor dem geplanten Zeitpunkt erstellt.

  • Im Abschnitt Best Practices wurde darauf hingewiesen, dass du mit der YouTube Data API zusätzliche Metadaten für in Berichten aufgeführte Ressourcen abrufen kannst. 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 aus dieser API nach 30 Tagen entweder löschen oder aktualisieren.

  • Im Abschnitt Berichtsmerkmale wurde ergänzt, dass Berichte, die Daten für einen Zeitraum ab dem 1. Juni 2018 enthalten, keine Verweise auf YouTube-Ressourcen enthalten, die mindestens 30 Tage vor dem Datum der Berichterstellung gelöscht wurden. Berichtsdaten werden nicht gefiltert.

  • Im Abschnitt Verlaufsdaten der API-Übersicht wurde aktualisiert, dass Verlaufsberichte nach der Planung eines neuen Berichtsjobs in der Regel innerhalb weniger Tage veröffentlicht werden. Bisher wurde in der Dokumentation angegeben, dass es bis zu 30 Tage dauern kann, bis solche Berichte verfügbar sind.

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

26. April 2018

Version 2 der YouTube Analytics API (Targeted Queries API, v2) ist jetzt öffentlich verfügbar. In der folgenden Liste sind 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 an die unten aufgeführten Änderungen anpassen. Alle diese Änderungen werden im neuen Migrationsleitfaden ausführlich erläutert.

    • Die API-Version hat sich von v1 zu v2 geändert.
    • Die Basis-URL für API-Anfragen wurde von https://www.googleapis.com/youtube/analytics/v1 in https://youtubeanalytics.googleapis.com/v2 geändert.
    • Mehrere Parameter für die Methode reports.query wurden umbenannt. Insbesondere werden Parameternamen, die Bindestriche enthalten, wie end-date in der v1 API, in der v2 API nicht mit Bindestriche, sondern in Camel Case (endDate) geschrieben. Durch diese Änderung sind die Parameternamen in der gesamten API einheitlich, da die Methoden zum Erstellen und Verwalten von Gruppen in der API bereits Camel Case 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 reports.query-Methode unterstützt die Anfrageparameter alt, quotaUser und userIp nicht mehr.
    • Die V2 API bietet keinen Batch-Endpunkt, der Batches aus Anfragen an verschiedene APIs unterstützt. Ein Batch kann jedoch aus Anfragen an verschiedene Methoden derselben API bestehen. Diese Einstellung gilt nicht nur für die YouTube Analytics API, sondern für alle APIs von Google.
    • Die API v2 unterstützt nicht das JSON-RPC-Protokoll, das in der API v1 unterstützt wurde. Diese Einstellung gilt nicht nur für die YouTube Analytics API.

  • Hinweis:Dies ist eine Ankündigung zur Einstellung.

    Version 1 der API (v1) wird jetzt eingestellt und wird nur noch bis zum 31. Oktober 2018 unterstützt. Alle Anfragen an die v1 API funktionieren nach diesem Datum nicht mehr. Führe daher bis zum 31. Oktober 2018 ein Upgrade auf die v2 API aus, 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):

  • In Berichten zu demografischen Merkmalen von Zuschauern, in denen Wiedergabestatistiken nach Altersgruppe und Geschlecht der Zuschauer zusammengefasst werden, wird die Dimension youtubeProduct nicht mehr unterstützt. Diese Dimension gibt an, auf welchem YouTube-Dienst die Nutzeraktivität stattgefunden hat.

18. Januar 2018

Dieses Update enthält die folgenden Änderungen:

  • YouTube Reporting API (Bulk-Berichte)

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

  • YouTube Analytics API (gezielte Abfragen)

20. Dezember 2017

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

  • Der API-Server unterstützt jetzt die GZIP-Komprimierung für Anfragen, bei denen Berichte heruntergeladen werden. Die GZIP-Komprimierung wird für andere Arten von API-Anfragen nicht unterstützt. Durch Aktivierung der GZIP-Komprimierung wird die für jede API-Antwort benötigte Bandbreite reduziert. Auch wenn Ihre Anwendung zusätzliche CPU-Zeit für die Dekomprimierung von API-Antworten benötigt, überwiegen in der Regel die Vorteile der geringeren Netzwerkressourcennutzung.

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

    Accept-Encoding: gzip

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

  • Die Dokumentation der Dimensionen age group und gender wurde korrigiert, sodass die tatsächlichen Werte angezeigt werden, die die API für diese Dimensionen zurückgibt. Hinweis: Dies ist eine Korrektur der Dokumentation und keine Änderung an der API-Funktion oder dem API-Verhalten. Insbesondere haben sich die folgenden Werte geändert:

    • Werte für die Dimension age_group müssen Großbuchstaben enthalten und Unterstriche zwischen dem Wort AGE und den Zahlen in der Altersgruppe. Außerdem dürfen nur Unterstriche und keine Bindestriche verwendet werden. So wurden Werte wie age13-17 und age18-24 in AGE_13_17 und AGE_18_24 korrigiert.
    • Werte für die Dimension gender müssen in Großbuchstaben geschrieben sein. Daher wurden die Werte female, male und gender_other in FEMALE, MALE und GENDER_OTHER korrigiert.

10. August 2017

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

Da der Messwert earnings ein Hauptmesswert war, wurde er ab dem Datum der Ankündigung ein Jahr lang unterstützt. Nach Ablauf dieses Jahres wird der Messwert earnings jedoch nicht mehr unterstützt. Daher geben API-Anfragen, bei denen der Messwert earnings angegeben ist, jetzt den HTTP-Antwortcode 400 zurück. Wenn Sie Ihre App noch nicht so aktualisiert haben, dass der Messwert estimatedRevenue anstelle des Messwerts earnings verwendet wird, tun Sie dies bitte so bald wie möglich.

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 darauf hinzuweisen, dass API-Antworten Daten bis zum letzten Tag des angeforderten Zeitraums 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 dies das letzte Datum, für das Daten in der Antwort enthalten sind. Das gilt auch, wenn Daten für einige der angeforderten Messwerte für den 4. Juli 2017 verfügbar sind.

    • Die Dimension adType unterstützt jetzt den Wert reservedBumperInstream. Er bezieht sich auf eine nicht überspringbare Videoanzeige mit einer Länge von bis zu 6 Sekunden, die vor der Wiedergabe eines Videos abgespielt wird. Das Anzeigenformat ist mit der auctionBumperInstream-Anzeige identisch. Dieser Typ bezieht sich jedoch auf Anzeigen, die nicht auf Auktionsbasis, sondern im Rahmen von Reservierungen verkauft werden.

  • YouTube Reporting API (Bulk-Berichte)

    • Die Dimension ad_type unterstützt jetzt den Wert 20, der sich auf Bumper-Anzeigen bezieht, die auf vorab gebuchten Basis verkauft werden. Bumper-Anzeigen sind nicht überspringbare Videoanzeigen mit einer Länge von bis zu 6 Sekunden, die vor der Wiedergabe eines Videos eingeblendet werden. Der Wert 19 für diese Dimension bezieht sich auch auf Bumper-Anzeigen, die nicht auf vorab reservierter Basis, sondern in Auktionen verkauft werden.

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

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

      Diese Berichtstypen wurden am 15. September 2016 eingestellt. Seit dem 15. Dezember 2016 werden keine Berichte mehr für diese Berichtstypen erstellt. Bisher generierte Berichte waren noch 180 Tage nach der Erstellung verfügbar. Daher waren einige Berichte noch bis zum 15. Juni 2017 verfügbar. Da die Berichte jedoch nicht mehr verfügbar sind, sind auch die zugehörigen Jobs nicht mehr erforderlich.

24. Mai 2017

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

  • content_owner_ad_performance_a1
  • content_owner_asset_estimated_earnings_a1
  • content_owner_estimated_earnings_a1

Diese Berichtstypen wurden am 22. Juni 2016 eingestellt. Nach dem 22. September 2016 wurden keine Berichte mehr für diese Berichtstypen erstellt. Bisher generierte Berichte waren noch 180 Tage nach der Erstellung verfügbar. Einige Berichte waren also noch bis zum 22. März 2017 verfügbar. Da die Berichte jedoch nicht mehr verfügbar sind, sind auch die zugehörigen Jobs nicht mehr erforderlich.

22. Mai 2017

Dieses Update enthält die folgenden Änderungen:

  • YouTube Reporting API (Bulk-Berichte)

    • Die Dimension sharing_service, mit der der Dienst angegeben wird, über den Videos geteilt wurden, unterstützt jetzt die folgenden Werte:

      • 85: YouTube Music
      • 86: YouTube Gaming
      • 87: YouTube Kids
      • 88: YouTube TV

      Außerdem wurde der Name, der für den Wert 52 verwendet wird, in der Dokumentation in Kakao (Kakao Talk) geändert, um ihn besser vom Wert 73 (Kakao Story) unterscheiden zu können. Diese Änderung hat keine Auswirkungen auf das API-Verhalten oder die Klassifizierung von Videos, die mit diesen Diensten geteilt wurden.

  • 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 Daten jetzt auch über die YouTube Analytics API abrufen:

17. März 2017

Dieses Update enthält die folgenden Änderungen:

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 jetzt auf den Zeitraum, der am angegebenen Tag, Monat und Jahr um 00:00 Uhr Pacific Time beginnt und um 23:59 Uhr Pacific Time endet. Je nach Jahreszeit entspricht die pazifische Zeit UTC-7 oder UTC-8.

      Datumsangaben beziehen sich normalerweise auf einen 24-Stunden-Zeitraum. Datumsangaben, an denen die Uhren vor- oder zurückgestellt werden, beziehen sich auf einen 23- bzw. 25-Stunden-Zeitraum. Bisher wurde in der Dokumentation angegeben, dass jedes Datum einen eindeutigen 24-Stunden-Zeitraum darstellt und dass die Pacific Time immer UTC-8 war.

      Hinweis: Diese Korrektur ändert nichts am tatsächlichen API-Verhalten.

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

    • Alle Berichtsjobs für den Berichtstyp content_owner_basic_a1 wurden gelöscht. Dieser Berichtstyp wurde am 19. August 2016 eingestellt. Bisher erstellte content_owner_basic_a1-Berichte waren jedoch noch 180 Tage nach ihrer Erstellung verfügbar. Daher waren einige Berichte noch bis zum 19. Februar 2017 verfügbar. Da die Berichte jedoch nicht mehr verfügbar sind, sind auch die zugehörigen Jobs nicht mehr erforderlich.

  • YouTube Analytics API (gezielte Abfragen)

    • In der Beschreibung der Dimensionen, die sich auf time periods beziehen, wurde korrigiert, dass sich der Dimensionswert auf den Zeitraum bezieht, der am angegebenen Tag, Monat und Jahr um 00:00 Uhr Pacific Time beginnt und um 23:59 Uhr Pacific Time endet. Je nach Jahreszeit entspricht die pazifische Zeit UTC-7 oder UTC-8.

      Datumsangaben beziehen sich normalerweise auf einen 24-Stunden-Zeitraum. Datumsangaben, an denen die Uhren vor- oder zurückgestellt werden, beziehen sich auf einen 23- bzw. 25-Stunden-Zeitraum. Bisher wurde in der Dokumentation angegeben, dass die Pacific Time UTC-8 ist, und es wurde nicht erwähnt, dass ein Tag möglicherweise nicht 24 Stunden umfasst.

      Hinweis: Diese Korrektur ändert nichts am tatsächlichen API-Verhalten.

    • In der Dokumentation zu Kanalberichten wurde ergänzt, dass Kanalberichte derzeit keine Messwerte zu Einnahmen oder Anzeigenleistung enthalten. Daher gewährt der Umfang 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 Berichten für Rechteinhaber relevant.

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

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

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

    Beachte, dass verschiedene Kanäle möglicherweise an unterschiedlichen Tagen mit einem Rechteinhaber verknüpft wurden. Wenn über die API-Anfrage Daten für mehrere Kanäle abgerufen werden und der Parameterwert false ist, enthält die API-Antwort Wiedergabezeit- und Wiedergabedaten basierend auf dem Verknüpfungsdatum für jeden jeweiligen Kanal.
  • Wenn der Parameterwert true ist, werden in der Antwort die Wiedergabezeit und die Wiedergabedaten 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 aus der Dokumentation entfernt. Von jedem Bericht ist eine neuere Version 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 Endscreen-Berichte sowie neue Dimensionen und Messwerte für diese Berichte. Die Berichte enthalten Impressions- und Klickstatistiken für die Abspanne, die nach der Videowiedergabe eingeblendet werden.

    8. November 2016

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

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

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

    27. Oktober 2016

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

    In der Übersicht über systemverwaltete Berichte finden Sie einen kurzen Überblick über die neuen Berichte und eine Anleitung zum Abrufen über die API. Dieser Vorgang unterscheidet sich geringfügig vom Abrufen von Bulk-Berichten für YouTube Analytics, da Partner keine Jobs für die Berichterstellung planen müssen.

    Das Attribut id der Ressource reportType wurde um eine Liste der systemverwalteten Berichte ergänzt, auf die Sie über die API zugreifen können:

    • Monatlicher, weltweiter Werbeumsatz 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 Ankündigung zur Einstellung.

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

    15. September 2016

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

    19. August 2016

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

    • Der Bericht content_owner_basic_a1 wurde eingestellt und aus der Dokumentation entfernt. YouTube generiert keine neuen Berichte dieser Art mehr. Bereits erstellte Berichte sind jedoch noch 180 Tage lang verfügbar.

      Der content_owner_basic_a1-Bericht wurde durch den content_owner_basic_a2-Bericht ersetzt, wie im Eintrag im Änderungsverlauf vom 19. Mai 2016 erläutert.

    11. August 2016

    Dieses Update enthält die folgenden Änderungen:

    • Die neu veröffentlichten Nutzungsbedingungen für die YouTube API-Dienste („die aktualisierten Nutzungsbedingungen“) wurden im YouTube Engineering and Developers Blog ausführlich erläutert. Sie enthalten zahlreiche Änderungen an den aktuellen Nutzungsbedingungen. Neben den aktualisierten Nutzungsbedingungen, die am 10. Februar 2017 in Kraft treten, enthält dieses Update mehrere ergänzende Dokumente, in denen die Richtlinien erläutert werden, die Entwickler einhalten müssen.

      Die vollständigen neuen Dokumente sind im Versionsverlauf der aktualisierten Nutzungsbedingungen beschrieben. Außerdem werden in diesem Änderungsverlauf zukünftige Änderungen an den aktualisierten Nutzungsbedingungen oder an den zugehörigen Dokumenten erläutert. Über einen Link in diesem Dokument können Sie einen RSS-Feed mit Änderungen in diesem Änderungsverlauf abonnieren.

    10. August 2016

    Dieses Update enthält die folgenden Änderungen:

    • YouTube Analytics API (gezielte Abfragen)

      • Hinweis:Dies ist eine Ankündigung zur Einstellung.

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

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

        Bis zum 4. November 2016 können Sie in einer API-Anfrage beispielsweise den Messwert impressionBasedCpm, den Messwert cpm oder beide angeben. Danach wird nur noch der Messwert cpm unterstützt.

      • Die Dimension insightTrafficSourceType unterstützt zwei neue Dimensionswerte:
        • CAMPAIGN_CARD: Diese Zugriffsquelle wird nur für Berichte für Rechteinhaber unterstützt. Sie gibt an, dass die Aufrufe von von Nutzern hochgeladenen Videos stammen, auf die der Rechteinhaber Anspruch erhoben hat und mit denen er für die angesehenen Inhalte geworben hat.
        • END_SCREEN: Die Daten beziehen sich auf Aufrufe, die über den Endscreen eines anderen Videos gestartet wurden.

        Für beide neuen Zugriffsquellen können Sie auch einen traffic source detail-Bericht abrufen. In beiden Fällen gibt die Dimension insightTrafficSourceDetail das Video an, über das der Zuschauer weitergeleitet wurde.

      • Die Dimension adType unterstützt jetzt den Wert auctionBumperInstream. Er bezieht sich auf eine nicht überspringbare Videoanzeige mit einer Länge von bis zu 6 Sekunden, 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 Berichte für Rechteinhaber unterstützt. Sie gibt an, dass die Aufrufe von von Nutzern hochgeladenen Videos stammen, auf die der Rechteinhaber Anspruch erhoben hat und mit denen er für die angesehenen Inhalte geworben hat.
        • 20: Die Daten beziehen sich auf Aufrufe, die über den Endscreen eines anderen Videos gestartet wurden.

        Bei beiden neuen Besucherquellen gibt die Dimension traffic_source_detail das Video an, über das der Zuschauer weitergeleitet wurde.

      • In der Liste der Kernmesswerte der API wurde estimated_partner_revenue als Kernmesswert hinzugefügt und earnings daraus entfernt. Der Messwert earnings wurde in der YouTube Reporting API nie unterstützt.

      • Die Dimension ad_type unterstützt jetzt den Wert 19, der sich auf Bumper-Anzeigen bezieht. Das sind nicht überspringbare Videoanzeigen mit einer Länge von bis zu 6 Sekunden, die vor der Wiedergabe eines Videos eingeblendet werden.

    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 ergänzt. Die Unterstützung für Kartenmesswerte in diesen Berichten wurde tatsächlich am 28. Juni 2016 hinzugefügt. Im Eintrag im Änderungsverlauf für dieses Datum wird die Änderung ausführlicher erläutert. Die Berichte sind:
        • Grundlegende Nutzeraktivitäten für US-Bundesstaaten
        • Nutzeraktivitäten in US-Bundesstaaten für bestimmte Zeiträume
        • Nutzeraktivität nach Bundesland
        • Nutzeraktivitäten nach Abostatus
        • Nutzeraktivität nach abonniertem Status für Bundesländer
        • Top-Videos nach Bundesland
        • Top-Videos für Abonnenten und Zuschauer ohne Abo

      • Die Filterlisten wurden sowohl für Berichte zur Zuschauerbindung von Kanälen als auch für Berichte zur Zuschauerbindung von Rechteinhabern korrigiert. Der Filter video ist jetzt erforderlich und der Filter group wird nicht mehr unterstützt.

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

    • YouTube Reporting API (Bulk-Berichte)

      • In der API-Übersicht wurde der Abschnitt zum Abrufen der Download-URL eines Berichts korrigiert. Dort wird jetzt darauf hingewiesen, dass YouTube auch für Tage, an denen keine Daten verfügbar waren, Berichte zum Download generiert. 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 verdeutlichen, dass im Bericht die Dimension card_id verwendet wird. Bisher wurde in der Dokumentation fälschlicherweise card_title als Dimensionsname angegeben.

    28. Juni 2016

    Die Dokumentation zur YouTube Analytics API wurde aktualisiert, um die Unterstützung von Kartenmesswerten in zahlreichen Kanalberichten und Berichten für Rechteinhaber widerzuspiegeln. 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 wirken sich nur auf Berichte für Rechteinhaber aus:

    • Der Abschnitt Berichtsmerkmale in der API-Übersicht wurde aktualisiert. Dort wird jetzt erläutert, dass Berichte 180 Tage lang nach der Generierung über die API verfügbar sind.

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

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

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

      • Zwei Berichte mit neuen Versionen wurden umbenannt:

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

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

      Wenn Sie bereits Jobs zum Erstellen der älteren 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 diese Berichte hast, solltest du nicht davon ausgehen, dass YouTube nach dem 22. September 2016 neue Berichte für diese Jobs generiert. Generierte Berichte sind noch 180 Tage nach der Erstellung verfügbar.

    • Die Definition der id-Eigenschaft der reportType-Ressource wurde aktualisiert, um die aktuell verfügbaren Berichte widerzuspiegeln.

    • Die Namen von zwei Messwerten in der Dokumentation wurden korrigiert, damit sie mit den Namen in Berichten übereinstimmen. Dies ist lediglich eine Dokumentationsänderung und hat keine Auswirkungen auf den Inhalt der Berichte:

      • 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. Wie bereits erwähnt, wird dieser Messwert nur in zwei Berichten angezeigt, die mit dieser Aktualisierung eingestellt werden. Wie oben beschrieben, wurde dieser Messwert in neueren Versionen dieser Berichte in estimated_partner_ad_reserved_revenue umbenannt.

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

    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 ID des Berichtstyps 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 content_owner_basic_a1-Berichts haben, müssen Sie trotzdem einen neuen Job für den content_owner_basic_a2-Bericht erstellen. YouTube migriert Rechteinhaber nicht automatisch zur neuen Berichtsversion und erstellt auch keinen Job, um die neue Berichtsversion zu generieren. Bei einigen Implementierungen kann das Auftreten eines neuen, unerwarteten Jobs eine gravierende Änderung darstellen.

      Im Zusammenhang mit der Einführung des neuen Berichts wurde der content_owner_basic_a1-Bericht eingestellt. Wenn Sie einen Job für diesen Bericht haben, sollten Sie nicht davon ausgehen, dass YouTube nach dem 19. August 2016 neue Berichte für diesen Job generiert. Generierte Berichte sind noch 180 Tage nach der Erstellung verfügbar.

    • Die Ressourcen reportType, job und report unterstützen alle eine neue Property, mit der angegeben wird, ob die zugehörige Ressource einen eingestellten Berichtstyp darstellt:

      • Die Property 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 eingestellt angekündigt wurden. Der Wert entspricht dem Datum, an dem YouTube keine Berichte mehr dieses Typs generiert.

        Nachdem ein Berichtstyp eingestellt wurde, generiert YouTube noch drei Monate lang Berichte dieses Typs. In dieser Mitteilung vom 19. Mai 2016 wird beispielsweise die Einstellung des Berichts content_owner_basic_a1 angekündigt. Die deprecateTime für diesen Berichtstyp gibt also eine Uhrzeit am 19. August 2016 an, nach der YouTube keine Berichte mehr dieses Typs generiert.

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

      • Mit der jobExpireTime-Eigenschaft der report-Ressource werden das Datum und die Uhrzeit angegeben, an dem bzw. zu dem der mit dem Bericht verknüpfte Job abgelaufen ist bzw. abläuft. Dieses Attribut enthält denselben Wert wie das Attribut expireTime in der job-Ressource, wie im vorherigen Element 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 werden in der Dokumentation der Methode jetzt mehrere weitere Gründe aufgeführt, die dazu führen können, dass eine API-Anfrage fehlschlägt.

    12. April 2016

    Dieses Update enthält die folgenden Änderungen, die sich ausschließlich auf die YouTube Reporting API auswirken:

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

      Verlaufsberichte werden veröffentlicht, sobald sie verfügbar sind. Es dauert jedoch etwa einen Monat, bis alle Verlaufsdaten für einen Job veröffentlicht sind. Ein Monat nach der Planung eines Berichtsauftrags haben Sie also Zugriff auf etwa sieben Monate an Daten. Alle bisherigen Daten zu Stellen, die vor dieser Ankündigung erstellt wurden, sollten innerhalb eines Monats nach der Ankündigung veröffentlicht werden.

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

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

    • Der Abschnitt Berichtsmerkmale in der Übersicht der YouTube Reporting API wurde um die folgenden Änderungen ergänzt:

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

      • Die Dokumentation wurde aktualisiert, da die API jetzt auch 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 im Creator Studio auf manuell herunterladbare Umsatzberichte zugreifen können. Die neue API-Funktion bietet also programmatischen Zugriff auf diese Daten.

      Die folgenden API-Änderungen werden jetzt im Hinblick 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 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 jobs.reports.list-Methode gibt an, dass die API-Antwort nur Berichte enthalten sollte, wenn die frühesten Daten im Bericht auf oder nach dem angegebenen Datum liegen. Der Parameter startTimeBefore gibt 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 bezieht, zu dem der Bericht erstellt wurde, beziehen sich die neuen Parameter auf die Daten im Bericht.

      • Das neue Attribut systemManaged der reportType-Ressource gibt an, ob die Ressource einen systemverwalteten Bericht beschreibt.

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

    28. März 2016

    Die YouTube Reporting API und die YouTube Analytics API geben jetzt Wiedergabestatistiken für mehrere zusätzliche Dienste zum Teilen von Inhalten zurück.

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

    16. März 2016

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

    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 in einer Playlist aufgeführt sind. Diese Quelle unterscheidet sich vom Quelltyp 14, der angibt, dass die Aufrufe stattgefunden haben, 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 in einer Playlist aufgeführt sind. Diese Quelle unterscheidet sich vom Quelltyp PLAYLIST, der angibt, dass die Aufrufe stattgefunden haben, während das Video als Teil einer Playlist wiedergegeben wurde.

    8. Februar 2016

    Die Liste der für die YouTube Analytics API unterstützten Messwerte wurde aktualisiert. Kartenmesswerte werden dort nicht mehr aufgeführt. (Keiner der Berichte dieser API wurde als unterstützend für die Kartenmesswerte dokumentiert.)

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

    6. Januar 2016

    Sowohl die YouTube Reporting API als auch die YouTube Analytics API erfassen jetzt Aufrufe, die über ein Chromecast-Gerät erfolgen.

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

    21. Dezember 2015

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

    18. Dezember 2015

    Gemäß den Gesetzen der Europäischen Union (EU) müssen Endnutzer in der EU bestimmte Informationen erhalten und ihre Einwilligung erteilt haben. Daher müssen Sie für Endnutzer in der Europäischen Union die Richtlinie zur Einwilligung der Nutzer in der EU einhalten. Wir haben in unseren Nutzungsbedingungen für die YouTube API einen Hinweis auf diese Anforderung 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 einer Vielzahl von Berichten für Kanäle und Rechteinhaber verwendet werden können:

      • liveOrOnDemand: Diese Dimension gibt an, ob die Daten im Bericht Nutzeraktivitäten beschreiben, die während einer Liveübertragung stattgefunden haben.
      • subscribedStatus: Diese Dimension gibt an, ob die Messwerte für die Nutzeraktivität in den Daten mit Zuschauern verknüpft sind, die den Kanal des Videos oder der Playlist abonniert haben.
      • youtubeProduct: Diese Dimension gibt die YouTube-Property an, 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 und enthält jetzt Informationen zu neuen Berichten zu Wiedergabedetails, die für Kanäle und Rechteinhaber verfügbar sind. Außerdem wurde in vielen anderen Berichten darauf hingewiesen, dass eine oder mehrere dieser Dimensionen optional als Dimensionen und/oder Filter in diesen Berichten verwendet werden können.

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

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

      Die Terminologie für Pflicht- und optionale Felder wird in der Dokumentation zu Kanalberichten und Berichten zu Rechteinhabern erläutert.

    • Die YouTube Analytics API entfernt jetzt automatisch Entitäten aus Filtern, die mehrere Werte unterstützen (video, playlist und channel), für die der API-Nutzer keine Daten abrufen kann. Bisher gab der API-Server nur einen Fehler zurück, 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 20 Video-IDs mit dem Filter video aufgeführt sind. 18 der Videos gehören dem Nutzer. Eine Video-ID verweist jedoch auf ein Video, das einem anderen Kanal gehört, und eine andere ID auf ein Video, das gelöscht wurde und daher nicht mehr existiert. In diesem Fall gibt der API-Server anstelle eines Fehlers die beiden Videos zurück, auf die der Nutzer nicht zugreifen kann. Die API-Antwort enthält dann Daten zu den 18 Videos, deren Inhaber der API-Nutzer ist.

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

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

    • Die groups.list-Methode der YouTube Analytics API unterstützt jetzt die Paginierung. Wenn die API-Antwort nicht alle verfügbaren Gruppen enthält, gibt der Parameter nextPageToken der Antwort ein Token an, mit dem die nächste Ergebnisseite abgerufen werden kann. Legen Sie den pageToken-Parameter der Methode auf diesen Wert fest, um weitere 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 wurde in der Dokumentation angegeben, dass das Datum um 00:00 Uhr (GMT) beginnt.

      Außerdem wurde in der Dokumentation zur YouTube Analytics API darauf hingewiesen, dass sich alle datumsbezogenen Dimensionen (day, 7DayTotals, 30DayTotals und month) auf Datumsangaben ab 00:00 Uhr (UTC-8) beziehen.

    • Die jobs.reports.list()-Methode der YouTube Reporting API unterstützt jetzt den Abfrageparameter createdAfter. Wenn dieser Parameter angegeben ist, werden in der API-Antwort nur Berichte aufgeführt, die nach dem angegebenen Datum und Uhrzeit erstellt wurden, einschließlich neuer Berichte mit nachgetragenen Daten. Der Parameterwert bezieht sich auf den Zeitpunkt der Berichterstellung und nicht auf die mit den zurückgegebenen Daten verknüpften Datumsangaben.

      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 der Attribute createTime der Ressource job und startTime, endTime und createTime der Ressource report wurden korrigiert, um darauf hinzuweisen, dass die Attributwerte auf Mikrosekunden, nicht auf Nanosekunden genau sind. Außerdem wird in allen Definitionen jetzt korrekt angegeben, dass der Property-Wert ein Zeitstempel ist.

    8. Oktober 2015

    Dieses Update enthält die folgenden Änderungen:

    • Die Dokumentation für die Dimension sharingService der YouTube Analytics API wurde um eine Liste möglicher Dimensionswerte ergänzt. Die Liste enthält eine Reihe von neu unterstützten Diensten.

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

    24. September 2015

    Dieses Update enthält die folgenden Änderungen:

    • Die neue YouTube Reporting API kann Bulk-Datenberichte zu YouTube Analytics-Daten für einen Kanal oder Rechteinhaber abrufen. Sie ist für Anwendungen konzipiert, die große Datensätze importieren können und Tools zum Filtern, Sortieren und Erschließen dieser Daten bieten.

      Jeder Bericht der YouTube Reporting API enthält eine vordefinierte Reihe von Dimensionen und Messwerten. In YouTube Analytics API-Berichten werden ebenfalls Messwerte und Dimensionen verwendet. In einem Bericht enthält jede Datenzeile eine eindeutige Kombination von Dimensionswerten. Du kannst Daten basierend auf Dimensionswerten in Zeilen zusammenfassen, um Messwerte für einzelne Videos, Länder, Livestreams, Abonnenten usw. zu berechnen.

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

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

      • Der Tab Anleitungen in der Dokumentation enthält Informationen, die für beide APIs gelten, einschließlich einer Anleitung zum Autorisieren von API-Anfragen.
      • Der Tab Bulk-Berichte enthält Referenzdokumentation und andere Inhalte speziell für die YouTube Reporting API.
      • Der Tab Zielgerichtete Abfragen enthält Referenzdokumente und andere Inhalte speziell für die YouTube Analytics API.
      • Auf dem Tab Samples (Beispiele) sind Codebeispiele für die beiden APIs aufgeführt.
      • Auf dem Tab Tools finden Entwickler zusätzliche Ressourcen, die ihnen bei der Implementierung der beiden APIs helfen.

    20. August 2015

    Dieses Update enthält die folgenden Änderungen:

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

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

      • Die neue Übersicht über das Datenmodell soll eine klarere Einführung in die Funktionsweise der API bieten. In diesem Dokument wird insbesondere erläutert, wie YouTube Messwerte, Dimensionen und Filter zur Berechnung von Berichtswerten verwendet.

      • Die reports.query-Methode der API, mit der Berichte abgerufen werden, wird jetzt separat dokumentiert. Die Informationen auf dieser Seite waren zuvor auf anderen Seiten zu finden. Auf der neuen Seite können Sie leichter erkennen, welche Informationen Sie zum Abrufen eines Berichts senden müssen.

    22. Juli 2015

    Dieses Update enthält mehrere Änderungen, die nur für Rechteinhaber gelten:

    • Der neue Messwert adEarnings enthält die geschätzten Gesamteinnahmen (Nettoumsatz) aus allen von Google verkauften Werbequellen. Er ist kein Kernmesswert. Die API unterstützt den Messwert „adEarnings“ für alle Berichte, in denen bereits der Messwert „earnings“ unterstützt wurde.

      Außerdem wurde die Definition des Messwerts earnings korrigiert, um zu berücksichtigen, dass sein Wert die geschätzten Gesamteinnahmen aus allen von Google verkauften Werbequellen sowie aus anderen Quellen enthält. 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.

    • Neben dem eingestellten Messwert primaryAdGrossRevenue werden in Berichten zur Anzeigenleistung auch die Messwerte monetizedPlaybacks und playbackBasedCpm nicht mehr unterstützt. Diese Messwerte werden jedoch in mehreren Videoberichten weiterhin unterstützt.

    1. Juni 2015

    Dieses Update enthält die folgenden Änderungen:

    • Die API unterstützt jetzt zwei neue Messwerte für Videoberichte: videosAddedToPlaylists und videosRemovedFromPlaylists. Die Listen der Videoberichte für Kanäle und Rechteinhaber wurden aktualisiert. Dort sind jetzt die Berichte aufgeführt, die die neuen Messwerte unterstützen.

      • videosAddedToPlaylists: Gibt an, wie oft Videos im Umfang der Suchanfrage YouTube-Playlists hinzugefügt wurden. Die Videos könnten der Playlist des Videoinhabers oder der Playlists anderer Kanäle hinzugefügt worden sein.
      • videosRemovedFromPlaylists – Die Häufigkeit, mit der Videos im Radius der Suchanfrage 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 Standardplaylists wie „Später ansehen“. Playlists, denen ein Video automatisch hinzugefügt wird, werden jedoch nicht gezählt. Dazu gehören beispielsweise die Upload-Playlist eines Kanals oder der Wiedergabeverlauf eines Nutzers. Beachten Sie außerdem, dass diese Messwerte die absolute Anzahl der Hinzufügungen und Löschungen widerspiegeln. Wenn ein Nutzer also ein Video einer Playlist hinzufügt, es dann entfernt und wieder hinzufügt, wird in den Messwerten angezeigt, dass das Video zwei Playlists hinzugefügt und aus einer entfernt wurde.

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

    31. März 2015

    Dieses Update enthält die folgenden Änderungen:

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

    16. März 2015

    Dieses Update enthält die folgenden Änderungen:

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

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

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

      • Berichtsdaten für eine Gruppe abrufen

        Die Dokumentation zu Dimensionen wurde um die Dimension group ergänzt. Sie kann als Filter für viele Kanalberichte und Berichte für Rechteinhaber verwendet werden. Wenn Sie den Filter group verwenden, gibt die API Daten für alle Elemente in dieser Gruppe zurück. Derzeit ist es nicht möglich, über die API Berichte für Asset-Gruppen zu erstellen.

      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 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 Sendungs-IDs, für die 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, werden die Ergebnisse in der API auch anhand der Filterwerte gruppiert.

      Ausführliche Informationen zu dieser Funktion finden Sie in der Parameterdefinition für filters.

    16. Juli 2014

    Dieses Update enthält die folgenden Änderungen:

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

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

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

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

      • playlistStarts: Gibt an, wie oft Zuschauer die Wiedergabe einer Playlist gestartet haben.
      • viewsPerPlaylistStart: Die durchschnittliche Anzahl der Videoaufrufe, die jedes Mal erzielt wurden, wenn eine Playlist gestartet wurde.
      • averageTimeInPlaylist: Die geschätzte durchschnittliche Wiedergabedauer in Minuten, die ein Zuschauer nach dem Starten der Playlist mit Videos in der Playlist verbracht hat.

      Für alle Anfragen zum Abrufen eines Playlist-Berichts muss der Filter isCurated verwendet werden. Dieser muss auf 1 (isCurated==1) festgelegt sein.

    • Die API unterstützt jetzt einen Bericht zur Zuschauerbindung. In diesem Bericht wird gemessen, wie gut Zuschauer ein Video bis zum Ende ansehen. Mit der neuen Dimension elapsedVideoTimeRatio im Bericht wird der für die entsprechenden Messwerte verstrichene Anteil des Videos gemessen:

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

        Hinweis: Ein Teil eines Videos kann bei einer bestimmten Videowiedergabe mehrmals oder gar nicht angesehen werden. Wenn sich Nutzer beispielsweise einen bestimmten Teil eines Videos mehrmals vor- und zurückspulen und ansehen, kann das absolute Verhältnis für diesen Teil des Videos über 1 liegen.

      • Der Messwert relativeRetentionPerformance gibt Aufschluss darüber, wie gut sich Zuschauer ein Video im Vergleich zu allen YouTube-Videos mit ähnlicher Länge ansehen. Ein Wert von 0 bedeutet, dass die Zuschauerbindung bei diesem Video schlechter ist als bei allen anderen Videos ähnlicher Länge. Ein Wert von 1 bedeutet, dass die Zuschauerbindung bei diesem Video besser ist als bei allen anderen Videos ähnlicher Länge. Ein Medianwert von 0,5 bedeutet, dass bei der Hälfte der Videos mit ähnlicher Länge die Zuschauerbindung besser ist als bei der anderen Hälfte.

      Mit dem Filter audienceType können Sie festlegen, dass im Bericht nur Daten zu organischen Aufrufen, Aufrufen über TrueView In-Stream-Anzeigen oder Aufrufen über TrueView In-Display-Anzeigen zurückgegeben werden. (Organische Aufrufe sind das direkte Ergebnis einer Nutzeraktion, z. B. einer Suche nach einem Video oder eines Klicks auf ein vorgeschlagenes Video.)

    • Die API unterstützt mehrere neue Messwerte im Zusammenhang mit Anmerkungen. Die unten aufgeführten Messwerte können in 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 Messwerten. Für die neuen Messwerte sind jedoch Daten ab dem 16. Juli 2013 verfügbar. (Daten für die Messwerte annotationClickThroughRate und annotationCloseRate sind seit dem 10. Juni 2012 verfügbar.)

    • GOOGLE_SEARCH wird nicht mehr als separater Wert für die Dimension insightTrafficSourceType erfasst. Stattdessen werden Verweise aus den Google-Suchergebnissen jetzt dem Besucherquellentyp EXT_URL zugeordnet. Daher ist es auch nicht mehr möglich, einen insightTrafficSourceDetail-Bericht abzurufen, in dem der insightTrafficSourceType-Filter 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 Beispielanfragen wurde überarbeitet. Beispiele werden jetzt in Kategorien gruppiert und es wird ein Tab-Format verwendet, das dem kürzlich für Berichte zu Kanälen und Rechteinhabern eingeführten ähnelt. Im neuen Design sind Beispiele in die folgenden Kategorien unterteilt:

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

    • Das Dokument Beispielanfragen enthält jetzt neue Beispiele zum Abrufen provinzspezifischer Daten in Kanal- oder Rechteinhaberberichten.

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

      • Demografische Merkmale von Zuschauern in Kalifornien (Altersgruppe und Geschlecht): In diesem Bericht findest du Statistiken zur Altersgruppe und zum Geschlecht von Zuschauern in Kalifornien, die sich die Videos eines Kanals angesehen haben. Bei Berichten für Rechteinhaber findest du entsprechende Statistiken zu den Inhalten des Rechteinhabers. 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, müssen die Daten in der Anfrage auch auf die USA beschränkt werden, indem country==US in den Parameterwert filters aufgenommen wird.

    6. Januar 2014

    Dieses Update enthält die folgenden Änderungen:

    • Die Dokumente, in denen die unterstützten Kanal- und Rechteinhaberberichte aufgeführt sind, wurden überarbeitet. Anstatt eine Tabelle mit allen möglichen Berichten bereitzustellen, werden die Berichte in jedem Dokument in Kategorien gruppiert:

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

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

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

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

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

          • Der Bericht zu den wichtigsten Statistiken enthält verschiedene Statistiken, darunter die Anzahl der Aufrufe und die geschätzte Wiedergabezeit.
          • Der zeitbasierte Bericht enthält dieselben Statistiken, die Daten werden jedoch auf Tages-, Wochen-, 30-Tage- oder Monatsbasis zusammengefasst.

        • Mit dem Abfrageparameter 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 in mehreren Berichten unterstützt, darunter Berichte zu geografischen Standorten, Wiedergabestandorten, Besucherquellen, Geräten, Betriebssystemen, 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 Teilregion eines Kontinents identifiziert. Diese Dimension kann auch nur als Filter verwendet werden.

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

    • Die Dokumentation wurde korrigiert, sodass die Dimension insightTrafficSourceDetail den 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 dieser Richtlinie. Auf den Seiten Dimensionen und Messwerte sind jetzt die wichtigsten Dimensionen und Messwerte aufgeführt. Außerdem wurden die Definitionen auf diesen Seiten aktualisiert, um die wichtigsten Dimensionen und Messwerte explizit zu identifizieren.

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

      Mit diesem Update werden mobile Wiedergaben jetzt je nach Art der Anwendung, in der sie stattfinden, 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 erzielt wurden. Bisher wurden diese Ansichten anhand der YT_OTHER_PAGE-Kategorie der Dimension klassifiziert.

    16. Juli 2013

    Dieses Update enthält die folgenden Änderungen:

    • Die API unterstützt jetzt das Sortieren von Berichten nach mehreren Dimensionen und Messwerten. Das Dokument mit Beispielanfragen enthält ein neues Beispiel, Anfragen nach mehreren Dimensionen/Messwerten sortieren, das diese Funktion veranschaulicht. Die Anfrage ruft Daten zu Besucherquellen ab und hat den Parameterwert sort = day,-views. Die Ergebnisse sind chronologisch sortiert. Innerhalb des Ergebnissatzes für jeden Tag enthält die erste Zeile Daten für die Besucherquelle mit den meisten Aufrufen, 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 Daten zu den Geräten abgerufen werden können, auf denen sich Zuschauer deine Videos ansehen. Die API unterstützt Berichte, in denen eine oder beide Dimensionen verwendet werden.

      • Im Bericht deviceType kannst du die Anzahl der Aufrufe und die geschätzte Wiedergabezeit für verschiedene Gerätetypen abrufen, darunter Computer, Smartphones und Tablets. Mit dem Filter operatingSystem können Sie den Bericht zum Gerätetyp so einschränken, dass er nur Statistiken für Geräte mit einem bestimmten Betriebssystem enthält, z. B. Android oder iOS.

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

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

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

    • Die Dimension insightPlaybackLocationType kann den Wert YT_OTHER zurückgeben. Dieser Wert gibt Aufrufe an, die nicht mit einem der anderen Werte der Dimension klassifiziert werden.

    23. Mai 2013

    Dieses Update enthält die folgenden Änderungen:

    10. Mai 2013

    Dieses Update enthält die folgenden Änderungen:

    6. Mai 2013

    Dieses Update enthält die folgenden Änderungen:

    • Die API unterstützt jetzt das Abrufen von Wiedergabezeitmesswerten (estimatedMinutesWatched, averageViewDuration und averageViewPercentage) in Verbindung mit anderen Messwerten, einschließlich Wiedergabe-, Interaktions-, Umsatz- und Anzeigenleistungmesswerten.

      Die Listen der verfügbaren Kanalberichte und Berichte für Rechteinhaber wurden entsprechend aktualisiert. Die Listen sind jetzt sogar kürzer, da die Messwerte für die 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 auf folgende Weise erweitert:

      • Sie unterstützen jetzt den optionalen Filter country.

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

        • Details zum Wiedergabeort

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

        • Details zur Besucherquelle

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

    3. Mai 2013

    Dieses Update enthält die folgenden Änderungen:

    • Das neue Dokument Beispiel-API-Anfragen enthält Beispiele, 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, sowie die Dimensionen, Messwerte, Filter und Sortierparameter für die Anfrage.

    • Die Dimension insightTrafficSourceType unterstützt jetzt SUBSCRIBER als gültigen Wert. Dieser Wert gibt Videoaufrufe an, die über Feeds auf der YouTube-Startseite oder über YouTube-Abofunktionen erzielt wurden. Wenn Sie nach dieser Besucherquelle filtern, wird im Feld insightTrafficSourceDetail der Startseitenfeed oder eine andere Seite angegeben, über die die Aufrufe erzielt wurden.

    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 Interaktionen von Zuschauern mit Anmerkungen beziehen, die in deinen Videos eingeblendet werden. Die Listen der Kanalberichte und Berichte für Rechteinhaber wurden aktualisiert, um die Berichte zu identifizieren, die die neuen Messwerte unterstützen.

      • annotationClickThroughRate: Das Verhältnis zwischen den Anmerkungen, auf die Zuschauer geklickt haben, und der Gesamtzahl der Impressionen für anklickbare 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 impressionbasierte 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. Sie enthält jetzt auch die beiden neuen Berichte, in denen diese Messwerte enthalten sind.

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

        Hinweis:Ausführliche Informationen finden Sie in den Definitionen der Messwerte.

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

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

    4. Februar 2013

    Dieses Update enthält die folgenden Änderungen:

    • Der Referenzleitfaden der API enthält jetzt einen Abschnitt Beispiele mit Codebeispielen, die zeigen, wie die API mit den Java-, JavaScript-, Python- und Ruby-Clientbibliotheken aufgerufen wird. Das JavaScript-Codebeispiel ist dasselbe, das in der Dokumentation der Beispielanwendung ausführlich beschrieben wird.

    14. November 2012

    Dieses Update enthält die folgenden Änderungen:

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

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

      • Im Bericht zu Wiedergabeorten wird die Anzahl der Videoaufrufe auf verschiedenen Arten von Seiten oder in verschiedenen Apps angegeben.

      • Im Detailbericht zu Wiedergabeorten werden die eingebetteten Player aufgeführt, die für ein bestimmtes Video die meisten Aufrufe generiert haben. Er bietet eine detailliertere Übersicht als der Bericht zum Wiedergabestandort, da die URLs der Top-eingebetteten Player angegeben werden.

      • Im Bericht zu Zugriffsquellen wird die Anzahl der Videoaufrufe angegeben, die über verschiedene Verweisquellen erzielt wurden.

      • Im Detailbericht zu Besucherquellen werden die Verweisquellen aufgeführt, über die die meisten Aufrufe für ein bestimmtes Video und einen bestimmten Besucherquellentyp generiert wurden. In diesem Bericht findest du beispielsweise die ähnlichen Videos, über die die meisten Zugriffe auf ein bestimmtes Video erzielt wurden. Dieser Bericht wird für mehrere Zugriffsquellen unterstützt.

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

    2. Oktober 2012

    Dieses Update enthält die folgenden Änderungen:

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

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

    12. September 2012

    Dieses Update enthält die folgenden Änderungen:

    • Im neuen Abschnitt Kontingentnutzung verstehen finden Sie Richtlinien zur Optimierung der API-Kontingentnutzung. Der API-Server berechnet für jede Anfrage Abfragekosten, die von Ihrem API-Nutzungskontingent abgezogen werden. 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.

    • Im Abschnitt Zeitdimensionen wird jetzt erläutert, dass mit diesen Dimensionen angegeben wird, dass Daten in einem Analytics-Bericht nach einem bestimmten Zeitraum zusammengefasst werden sollen. Die API unterstützt jetzt die folgenden zusätzlichen Zeitdimensionen:

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

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

    • Im Abschnitt Dimensionen für die Berichtseinheit wurde ergänzt, dass API-Anfragen zum Abrufen von Berichten für Rechteinhaber Daten entweder mit einer dieser Dimensionen (video, channel oder show) oder mit einer unterstützten Kombination der Dimensionen claimedStatus und uploaderType filtern müssen.

    • Die API unterstützt jetzt zwei neue Sortieroptionen für Berichte zu Top-Videos. Diese Berichte, die als Kanalberichte oder Berichte für Rechteinhaber verfügbar sind, enthalten Messwerte (Aufrufe, Kommentare, „Mag ich“-Bewertungen usw.) nach Land und sind nach Video aufgeschlüsselt. Du kannst diese Berichte jetzt nach der Anzahl der Nutzer sortieren, die einen Kanal über die Wiedergabeseite des Videos abonniert oder wieder gekündigt 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 Leitfaden auf der YouTube-Startseite. Wenn diese Messwerte in einem videospezifischen Bericht enthalten sind, umfassen sie nur Statistiken von der Wiedergabeseite des jeweiligen Videos.