Überarbeitungsverlauf

Auf dieser Seite findest du Informationen zu API-Änderungen und Aktualisierungen der Dokumentation für die YouTube Reporting API und die YouTube Analytics API. Beide APIs ermöglichen es Entwicklern, auf YouTube Analytics-Daten zuzugreifen, allerdings auf unterschiedliche Weise. Änderungsprotokoll abonnieren Abo

7. April 2024

Die YouTube Analytics API (Gezielte Anfragen) hat mehrere Aktualisierungen zu Playlist-Berichten von Rechteinhabern. Die Änderungen sind dieselben wie die am 19. Januar 2024 angekündigten Berichte zu Kanalplaylists.

Der folgende Überarbeitungsverlaufseintrag enthält fast dieselben Informationen wie der Eintrag vom 19. Januar 2024. In Berichten zu Rechteinhaber-Playlists wird die Dimension isCurated allerdings noch bis zum 31. Dezember 2024 unterstützt, in Berichten zu Kanalplaylists hingegen noch bis zum 30. Juni 2024.

  • Hinweis: Diese Mitteilung wird eingestellt.

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

    Damit die Abwärtskompatibilität erhalten bleibt, musst du beim Entfernen der Dimension isCurated auch deinen Code so aktualisieren, dass der Messwert playlistViews statt des Messwerts views nur für Playlist-Berichte abgerufen wird. Da der Messwert views in Playlist-Berichten weiterhin unterstützt wird, wenn auch mit einer anderen Bedeutung, gibt die API auch dann 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.

    Neben der Dimension isCurated werden in den neuen Berichten folgende API-Funktionen nicht mehr unterstützt:

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

  • Der Abschnitt Playlist-Berichte in der Dokumentation zu Rechteinhaberberichten wurde aktualisiert und enthält nun detailliertere Erläuterungen zu den Messwerttypen, die für Playlist-Berichte unterstützt werden:

    • Zusammengefasste Videomesswerte liefern Messwerte zu Nutzeraktivitäten und Impressionen, die für alle Videos in den Playlists des Rechteinhabers zusammengefasst werden, die ebenfalls diesem Rechteinhaber gehören. Aggregierte Videomesswerte werden nur für API-Anfragen ohne die Dimension isCurated unterstützt.
    • Messwerte innerhalb der Playlist spiegeln Nutzeraktivität und -interaktionen im Kontext der Playlist-Seite wider. Diese Messwerte umfassen auch Aufrufe von Videos ohne eigene Eigentumsrechte in der Playlist, aber nur, wenn diese Aufrufe im Kontext der Playlist erfolgt sind.
    • Im Abschnitt Unterstützte Playlist-Messwerte findest du die zusammengefassten Messwerte für Videos und Playlists, die in Playlist-Berichten unterstützt werden.

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

  • Das Verhalten des Messwerts views hängt jetzt davon ab, ob für die API-Anfrage zum Abrufen des Playlist-Berichts die Dimension isCurated verwendet wurde:

    • Wenn eine Anfrage die Dimension isCurated enthält, ist der Messwert views ein In-Playlist-Messwert, der angibt, wie oft Videos im Kontext der Playlists des 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. Dabei spielt es keine Rolle, ob diese Aufrufe im Playlist-Kontext erfolgt sind. Die zusammengefasste Gesamtzahl umfasst nur Aufrufe von Videos, deren Inhaber der Rechteinhaber des Kanals mit der Playlist ist.

      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 Rechteinhaberberichten 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 zum Definieren von zeitbasierten Playlist-Berichten.

19. Januar 2024

Bei der YouTube Analytics API (Gezielte Anfragen) gibt es mehrere Aktualisierungen im Zusammenhang mit den Berichten zu Kanalplaylists. Die Aktualisierungen umfassen eine eingestellte Dimension und mehrere neue und aktualisierte Messwerte:

  • Hinweis: Diese Mitteilung wird eingestellt.

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

    Damit die Abwärtskompatibilität erhalten bleibt, musst du beim Entfernen der Dimension isCurated auch deinen Code so aktualisieren, dass der Messwert playlistViews statt des Messwerts views nur für Playlist-Berichte abgerufen wird. Da der Messwert views in Playlist-Berichten weiterhin unterstützt wird, wenn auch mit einer anderen Bedeutung, gibt die API auch dann 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.

    Neben der Dimension isCurated werden in den neuen Berichten folgende API-Funktionen nicht mehr unterstützt:

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

  • Der Abschnitt Playlist-Berichte in der Dokumentation zu Kanalberichten wurde aktualisiert. Er enthält nun detailliertere Erläuterungen zu den Messwerttypen, die für Playlist-Berichte unterstützt werden:

    • Zusammengefasste Videomesswerte umfassen Messwerte zur Nutzeraktivität und zu Impressionen, die für alle Videos in den Playlists des Kanals zusammengefasst werden, die ebenfalls zu diesem Kanal gehören. Aggregierte Videomesswerte werden nur für API-Anfragen ohne die Dimension isCurated unterstützt.
    • Messwerte innerhalb der Playlist spiegeln Nutzeraktivität und -interaktionen im Kontext der Playlist-Seite wider. Diese Messwerte umfassen auch Aufrufe von Videos ohne eigene Eigentumsrechte in der Playlist, aber nur, wenn diese Aufrufe im Kontext der Playlist erfolgt sind.
    • Im Abschnitt Unterstützte Playlist-Messwerte findest du die zusammengefassten Messwerte für Videos und Playlists, die in Playlist-Berichten unterstützt werden.

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

  • Das Verhalten des Messwerts views hängt jetzt davon ab, ob für die API-Anfrage zum Abrufen des Playlist-Berichts die Dimension isCurated verwendet wurde:

    • Wenn eine Anfrage die Dimension isCurated enthält, ist der Messwert views ein In-Playlist-Messwert, der angibt, wie oft Videos im Kontext der Playlists des Kanals angesehen wurden.
    • Wenn eine Anfrage die Dimension isCurated nicht enthält, ist der Messwert views ein aggregierter Videomesswert, der angibt, wie oft das Video in den Playlists des Kanals insgesamt angesehen wurde. Dabei spielt es keine Rolle, ob diese Aufrufe im Playlist-Kontext stattgefunden haben. Die zusammengefasste Gesamtzahl umfasst nur Aufrufe von Videos, die dem Kanal gehören, 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 Kanalberichten enthält jetzt für jeden Playlist-Bericht Tabellen mit unterstützten Messwerten für diesen Bericht, je nachdem, ob die API-Anfrage die Dimension isCurated enthält. Ein Beispiel findest du im Abschnitt zum Definieren von zeitbasierten Playlist-Berichten.

4. Dezember 2023

Die YouTube Analytics API (Targeting-Abfragen) wurde aktualisiert, um zwei insightTrafficSourceType-Dimensionswerte zusammenzuführen. Bisher wurde anhand der Dimension zwischen Videos, die Teil einer Playlist (PLAYLIST) abgespielt wurden, und Aufrufen über eine Seite, auf der alle Videos einer Playlist aufgeführt sind (YT_PLAYLIST_PAGE), unterschieden. In Zukunft werden beide Arten von Aufrufen dem Dimensionswert PLAYLIST zugeordnet.

15. Dezember 2022

Die YouTube Analytics API (Targeting-Suchanfragen) unterstützt zwei neue Dimensionen und einen neuen Bericht:

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

  • Die neue Dimension creatorContentType gibt die Art von YouTube-Inhalten an, die den Messwerten zur Nutzeraktivität in der Datenzeile zugeordnet werden. Unterstützte Werte sind LIVE_STREAM, SHORTS, STORY und VIDEO_ON_DEMAND.

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

  • Der Leitfaden zu Beispielanfragen an die YouTube Analytics API enthält jetzt Beispiele für beide neuen Dimensionen.

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

26. August 2022

Die YouTube Analytics API (Targeting-Anfragen) und die YouTube Reporting API (Bulk-Berichte) unterstützen einen neuen Wert für die Zugriffsquellendetails:

  • 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 der Traffic von der Podcasts-Landingpage weitergeleitet wurde.
  • Wenn der Wert der Dimension traffic_source_type in der YouTube Reporting API (Bulk Reports) 3 ist, kann der Wert traffic_source_detail auf podcasts gesetzt werden. Das bedeutet, dass der Traffic von der Podcasts-Landingpage weitergeleitet wurde.

11. Februar 2022

Die gültigen Werte für die Dimension gender ändern sich am oder nach dem 11. August 2022. Dies könnte eine nicht abwärtskompatible Änderung Ihrer API-Implementierung sein. Gemäß dem Abschnitt Abwärtsinkompatible Änderungen der Nutzungsbedingungen der YouTube API-Dienste wird diese Änderung sechs Monate vor ihrem Inkrafttreten angekündigt. Bitte aktualisieren Sie Ihre API-Implementierung vor dem 11. August 2022, um einen nahtlosen Übergang auf die neuen Werte zu ermöglichen.

Folgende Änderungen werden vorgenommen:

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

9. Februar 2022

Seit dem 13. Dezember 2021 wurden zwei Messwerte aktualisiert, um Zugriffe in Schleifen auszuschließen. Diese Änderung betrifft sowohl die YouTube Analytics API (Targeting Queries) als auch die YouTube Reporting API (Bulk Reports).

2. Februar 2022

Die YouTube Reporting API (Bulk Reports) unterstützt einen neuen Dimensionswert für Besucherquellen, der angibt, dass die Aufrufe über Live Redirects stammen:

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

Bei diesem Zugriffsquellentyp gibt die Dimension traffic_source_detail die Kanal-ID an, von der der Zuschauer gekommen ist.

23. September 2020

Die YouTube Analytics API (Gezielte Anfragen) und die YouTube Reporting API (Bulk-Berichte) unterstützen beide einen neuen Dimensionswert für Besucherquellen. Dieser gibt an, dass der Zuschauer durch vertikales Wischen beim Ansehen von YouTube Shorts weitergeleitet wurde:

  • In der YouTube Analytics API (Targeting-Abfragen) unterstützt die Dimension insightTrafficSourceType den Wert SHORTS.
  • In der YouTube Reporting API (Bulk Reports) unterstützt die Dimension traffic_source_type den Wert 24.

Die Dimension „Zugriffsquellendetails“ (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 Suchanfragen) auswirken:

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

13. Februar 2020

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

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

Mit den neuen Werten werden Benachrichtigungen zu hochgeladenen Videos und Livestreams, die zuvor als uploaded gemeldet wurden, in zwei Kategorien unterteilt:

  • uploaded_push: Aufrufe über Push-Benachrichtigungen, die beim Hochladen eines Videos an Abonnenten gesendet wurden
  • uploaded_other: Aufrufe, die über Benachrichtigungen erfolgen, die Abonnenten beim Hochladen eines Videos erhalten haben. Das betrifft beispielsweise E-Mail- oder Posteingangsbenachrichtigungen.

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

Zur Erinnerung: Diese Werte stellen keine Benachrichtigungen selbst dar, sondern die Zugriffsquellen, die zu bestimmten YouTube-Aufrufen geführt haben. Wenn eine Berichtszeile beispielsweise views=3, traffic_source_type=17 (NOTIFICATION) und traffic_source_detail=uploaded_push enthält, gibt die Zeile an, dass drei Aufrufe daraus resultierten, dass Zuschauer auf Push-Benachrichtigungen geklickt haben, die beim Upload des Videos gesendet wurden.

15. Oktober 2019

Dieses Update umfasst die folgenden Änderungen in Bezug auf die YouTube Analytics API (Targeting-Suchanfragen):

  • Hinweis: Diese Mitteilung wird eingestellt.

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

    Hinweis: Nutzer können einige Daten für diese Dimensionen reproduzieren, indem sie die Dimension day abfragen und Daten über einen Zeitraum von 7 oder 30 Tagen aggregieren oder ableiten. Beispiel:

    • Die Anzahl der Aufrufe für einen Zeitraum von sieben Tagen kann berechnet werden, indem die Anzahl der Aufrufe an jedem Tag dieses Zeitraums aggregiert wird.
    • Um den Prozentsatz der Zuschauer für einen Zeitraum von sieben Tagen zu berechnen, wird die Anzahl der Aufrufe pro Tag mit dem Prozentsatz der Zuschauer für diesen Tag multipliziert. So wird die Anzahl der Zuschauer ermittelt, die angemeldet waren, als sich das Video an diesem Tag angesehen hat. Die Anzahl der angemeldeten Zuschauer kann dann für den gesamten Zeitraum addiert und durch die Gesamtzahl der Aufrufe in diesem Zeitraum geteilt werden, um den Prozentsatz der Zuschauer für den gesamten Zeitraum zu erhalten.
    • Die Anzahl der einzelnen Nutzer über einen Zeitraum von sieben Tagen kann nicht berechnet werden, da ein einzelner Nutzer an verschiedenen Tagen als einzelner Nutzer gezählt werden kann. Unter Umständen ist es jedoch möglich, die Dimension month anstelle der Dimension 30DayTotals zu verwenden, um Daten zur Anzahl der einzelnen Nutzer über einen Zeitraum von 30 Tagen zu extrapolieren. Die Dimension month bezieht sich auf Kalendermonate, während die Dimension 30DayTotals 30-Tage-Zeiträume basierend auf dem angegebenen Start- und Enddatum berechnet.

27. Juni 2019

Dieses Update umfasst die folgenden Änderungen in Bezug auf die YouTube Analytics API (Targeting-Suchanfragen):

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

1. November 2018

Dieses Update umfasst die folgenden Änderungen in Bezug auf die YouTube Analytics API (Targeting-Suchanfragen):

17. September 2018

Dieses Update umfasst die folgenden Änderungen in Bezug auf die YouTube Analytics API (Targeting-Suchanfragen):

  • Im neuen Abschnitt zur Datenanonymisierung in der Übersicht über das Datenmodell wird erläutert, dass einige YouTube Analytics-Daten eingeschränkt sind, wenn die Messwerte einen bestimmten Grenzwert nicht erreichen. Dies kann in verschiedenen Fällen passieren. In der Praxis bedeutet dies, dass ein Bericht in folgenden Fällen möglicherweise nicht alle oder gar keine Daten enthält:

    1. ein Video oder Kanal in einem bestimmten Zeitraum nur wenige Zugriffe hat,

      oder

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

    In diesem neuen Abschnitt werden auch die Datentypen erläutert, die in YouTube Analytics-Berichten eingeschränkt sein können.

  • Die Dokumente zu Kanalberichten und Berichten zu Rechteinhabern wurden aktualisiert, um zu berücksichtigen, dass die Messwerte redViews und estimatedRedMinutesWatched für Berichte zu Wiedergabeort, Zugriffsquellen, Gerätetyp oder Betriebssystem nicht mehr unterstützt werden.

18. Juni 2018

Dieses Update umfasst die folgenden Änderungen an der YouTube Analytics (Targeting Queries) API:

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

      Bei der ersten Option wird ein Bereich verwendet, bei dem es sich um einen nicht schreibgeschützten Bereich handelt, während bei der zweiten Option zwei schreibgeschützte Bereiche verwendet werden.

23. Mai 2018

Dieses Update umfasst die folgenden Änderungen an der YouTube Analytics (Targeting Queries) API:

  • Die API-Übersicht enthält den neuen Abschnitt zusammengefasste Messwerte und gelöschte Elemente. Dort wird erläutert, wie in API-Antworten Daten im Zusammenhang mit gelöschten Ressourcen wie Videos, Playlists oder Kanälen verarbeitet werden.
  • Der Abschnitt Best Practices in der API-Übersicht wurde aktualisiert. Wir möchten dich daran erinnern, dass du mit der YouTube Data API zusätzliche Metadaten für Ressourcen abrufen kannst, die in Antworten der YouTube Analytics API identifiziert wurden. Gemäß den Richtlinien für Entwickler der YouTube API-Dienste (Abschnitte III.E.4.b bis III.E.4.d) müssen API-Clients gespeicherte Ressourcenmetadaten nach 30 Tagen aus dieser API entweder löschen oder aktualisieren.

22. Mai 2018

Diese Aktualisierung umfasst die folgenden Änderungen in Bezug auf die YouTube Reporting API (Bulk-Berichte):

  • Die folgenden Änderungen sollen derzeit voraussichtlich im Juli 2018 in Kraft treten. Die neuen Richtlinien gelten weltweit für alle Berichts- und Berichterstellungsjobs.

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

      Bisher waren alle API-Berichte ab ihrer Erstellung 180 Tage lang verfügbar. Nach dem Inkrafttreten dieser Richtlinienänderung können Sie auch nicht mehr über die API auf Berichte mit Verlaufsdaten zugreifen, die älter als 30 Tage sind. Alle anderen Berichte, die älter als 60 Tage sind, können ebenfalls nicht mehr aufgerufen werden. Aus diesem Grund sind Berichte, die vor der Richtlinienänderung erstellt wurden, bis zu 180 Tage lang verfügbar.

    • Nach der Änderung erstellt YouTube bei der Planung eines Berichterstellungsjobs ab diesem Tag Berichte, die die 30 Tage vor der Planung des Jobs abdecken. Vor der Änderung generiert YouTube bei der Planung eines Berichterstellungsjobs Berichte, die die 180 Tage vor der Planung des Jobs abdecken.

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

  • Der Abschnitt Berichtmerkmale wurde aktualisiert. Obwohl Berichtsdaten nicht gefiltert sind, enthalten Berichte, die Daten für einen Zeitraum ab dem 1. Juni 2018 enthalten, keine Verweise auf YouTube-Ressourcen, die mindestens 30 Tage vor dem Erstellungsdatum des Berichts gelöscht wurden.

  • Der Abschnitt Verlaufsdaten der API-Übersicht wurde aktualisiert. Wenn Sie einen neuen Berichtjob planen, werden die Berichte zu bisherigen Daten in der Regel innerhalb weniger Tage veröffentlicht. Zuvor wurde in der Dokumentation angegeben, dass es bis zu 30 Tage dauern kann, bis solche Berichte verfügbar sind.

  • Der Abschnitt Backfill-Daten der API-Übersicht wurde aktualisiert. Backfill-Daten werden jetzt deutlicher als ein Datensatz definiert, der einen zuvor übermittelten Datensatz ersetzt.

26. April 2018

Version 2 der YouTube Analytics (Gezielte Suchanfragen) API (Version 2) ist jetzt öffentlich verfügbar. In der folgenden Liste sind Änderungen an Produkten und der Dokumentation im Zusammenhang mit der neuen API-Version aufgeführt:

  • Die v2 API ist fast identisch mit der v1 API. Wahrscheinlich müssen Sie jedoch den Code an die unten aufgeführten Änderungen anpassen. Alle diese Änderungen werden im neuen Migrationsleitfaden ausführlich erläutert.

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

    Außerdem werden einige Funktionen der Version 1 von der API V2 nicht unterstützt:

    • Die Methode reports.query unterstützt die Anfrageparameter alt, quotaUser und userIp nicht mehr.
    • Die API V2 bietet keinen Batchendpunkt, der Batches mit Anfragen an verschiedene APIs unterstützt. Ein Batch kann jedoch aus Anfragen an verschiedene Methoden derselben API bestehen. Diese Änderung betrifft nicht nur die YouTube Analytics API, da Google den globalen Batchendpunkt für alle seine APIs einstellt.
    • Das JSON-RPC-Protokoll, das in API Version 1 unterstützt wurde, wird von der API V2 nicht unterstützt. Diese Änderung betrifft nicht nur die YouTube Analytics API.

  • Hinweis: Diese Mitteilung wird eingestellt.

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

21. Februar 2018

Dieses Update umfasst die folgenden Änderungen an der YouTube Analytics (Targeting Queries) API:

  • Berichte zu demografischen Merkmalen von Zuschauern, in denen Wiedergabestatistiken auf Grundlage der Altersgruppe und des Geschlechts der Zuschauer zusammengefasst werden, unterstützen nicht mehr die Dimension youtubeProduct. Mit ihr wird der YouTube-Dienst ermittelt, bei dem die Nutzeraktivität stattgefunden hat.

18. Januar 2018

Dieses Update enthält die folgenden Änderungen:

  • YouTube Reporting API (Bulk-Berichte)

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

  • YouTube Analytics API (gezielte Suchanfragen)

    • Die Dimension „operatingSystem“ unterstützt den Dimensionswert „KAIOS“.

20. Dezember 2017

Diese Aktualisierung umfasst zwei Änderungen, die die YouTube Reporting API betreffen:

  • Der API-Server unterstützt jetzt die gzip-Komprimierung für Anfragen zum Herunterladen von Berichten. Die gzip-Komprimierung wird für andere Arten von API-Anfragen nicht unterstützt. Durch Aktivieren der gzip-Komprimierung wird die für die jeweilige API-Antwort benötigte Bandbreite reduziert. Und obwohl Ihre Anwendung zum Dekomprimieren von API-Antworten zusätzliche CPU-Zeit benötigt, überwiegt der Nutzen von weniger Netzwerkressourcen diese Kosten in der Regel.

    Um eine mit gzip codierte Antwort zu erhalten, setze den Accept-Encoding-HTTP-Anfrageheader auf gzip, wie im folgenden Beispiel gezeigt:

    Accept-Encoding: gzip

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

  • Die Dokumentation der Dimensionen age group und gender wurde korrigiert. Sie zeigt nun die tatsächlichen Werte an, die die API für diese Dimensionen zurückgibt. Hinweis: Hierbei handelt es sich um eine Korrektur der Dokumentation, die keine Änderung der API-Funktionalität oder des API-Verhaltens widerspiegelt. Die folgenden Werte haben sich geändert:

    • Die Werte für die Dimension „age_group“ enthalten Großbuchstaben, Unterstriche zwischen dem Wort „AGE“ und den Ziffern in der Altersgruppe und Unterstriche statt Bindestriche. Daher wurden Werte wie age13-17 und age18-24 zu AGE_13_17 bzw. AGE_18_24 korrigiert.
    • Die Werte für die Dimension „gender“ werden in Großbuchstaben verwendet. 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 angekündigt, dass der Messwert earnings der YouTube Analytics API eingestellt wird. Gleichzeitig wurde in der API ein neuer Messwert namens estimatedRevenue unterstützt, der dieselben Daten liefert.

Da der Messwert „earnings“ ein wichtiger Messwert war, wurde er ab dem Datum der Bekanntgabe ein Jahr lang unterstützt. Der Messwert earnings wird jetzt jedoch nicht mehr unterstützt. Daher geben API-Anfragen, die den Messwert earnings angeben, 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 und die verbleibenden Verweise auf den Messwert earnings wurden entfernt.

6. Juli 2017

Dieses Update enthält die folgenden Änderungen:

  • YouTube Analytics API (gezielte Suchanfragen)

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

      Wenn in einer Anfrage beispielsweise der 5. Juli 2017 als Enddatum angegeben ist und die Werte für alle angeforderten Messwerte nur bis zum 3. Juli 2017 verfügbar sind, wird dies das letzte Datum sein, an dem Daten in die Antwort aufgenommen werden. Das gilt auch dann, wenn für einige der angeforderten Messwerte ab dem 4. Juli 2017 Daten verfügbar sind.

    • Für die Dimension „adType“ wird jetzt der Wert „reservedBumperInstream“ unterstützt, der sich auf eine nicht überspringbare Videoanzeige mit einer Dauer von bis zu sechs Sekunden bezieht, die abgespielt wird, bevor ein Video wiedergegeben werden kann. Das Anzeigenformat ist mit der auctionBumperInstream-Anzeige identisch. Dieser Typ bezieht sich jedoch auf Anzeigen, die reserviert und nicht auf Auktionsbasis verkauft werden.

  • YouTube Reporting API (Bulk-Berichte)

    • Für die Dimension „ad_type“ wird jetzt der Wert „20“ unterstützt, der sich auf Bumper-Anzeigen bezieht, die reserviert sind. Bumper-Anzeigen sind nicht überspringbare Videoanzeigen, die bis zu sechs Sekunden dauern und vor der Wiedergabe eines Videos wiedergegeben werden. Der Wert 19 für diese Dimension bezieht sich auch auf Bumper-Anzeigen, die per Auktion und nicht reserviert verkauft werden.

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

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

      Diese Berichtstypen wurden am 15. September 2016 als eingestellt angekündigt und nach dem 15. Dezember 2016 wurden keine entsprechenden Berichte mehr erstellt. Zuvor erstellte Berichte waren ab dem Zeitpunkt ihrer Erstellung noch 180 Tage lang verfügbar. Daher waren einige Berichte erst seit dem 15. Juni 2017 verfügbar. Da die Berichte jedoch nicht mehr verfügbar sind, werden die mit den Berichten verknüpften Jobs auch nicht benötigt.

24. Mai 2017

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

  • content_owner_ad_performance_a1
  • content_owner_asset_estimated_earnings_a1
  • content_owner_estimated_earnings_a1

Diese Berichtstypen wurden am 22. Juni 2016 als eingestellt angekündigt und nach dem 22. September 2016 nicht mehr dafür erstellt. Zuvor erstellte Berichte waren ab dem Zeitpunkt ihrer Erstellung noch 180 Tage lang verfügbar. Daher waren einige Berichte erst seit dem 22. März 2017 verfügbar. Da die Berichte jedoch nicht mehr verfügbar sind, werden die mit den Berichten verknüpften Jobs auch nicht benötigt.

22. Mai 2017

Dieses Update enthält die folgenden Änderungen:

  • YouTube Reporting API (Bulk-Berichte)

    • Die Dimension sharing_service, die den Dienst identifiziert, über den Videos freigegeben wurden, unterstützt jetzt die folgenden Werte:

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

      Außerdem wurde der Name zur Identifizierung des Werts „52“ in der Dokumentation in Kakao (Kakao Talk) geändert, damit er sich klarer vom Wert 73 (Kakao Story) unterscheiden kann. Diese Änderung wirkt sich nicht auf das API-Verhalten oder die Klassifizierung von Videos aus, die mit diesen Diensten geteilt werden.

  • YouTube Analytics API (gezielte Suchanfragen)

    • Für die Dimension sharingService werden jetzt folgende Werte unterstützt:

      • 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 jetzt auch über die YouTube Analytics API auf diese Umsatzdaten zugreifen:

17. März 2017

Dieses Update enthält die folgenden Änderungen:

  • Die YouTube Analytics API unterstützt die Messwerte redViews und estimatedRedMinutesWatched, die sich beide auf YouTube Red-Zuschauer beziehen. Die API unterstützt diese Messwerte bereits seit einiger Zeit. Wie am 15. September 2016 angekündigt, unterstützt die YouTube Reporting API beide Messwerte.

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

    Die Dokumentation zu Kanalberichten und Berichten zu Rechteinhabern wurde aktualisiert und zeigt nun an, in welchen Berichten die beiden neuen Messwerte unterstützt werden. Sie werden in allen Berichten unterstützt, in denen die Messwerte „views“ und „estimatedMinutesWatched“ bereits unterstützt werden.

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

      Obwohl Datumsangaben normalerweise einen 24-Stunden-Zeitraum darstellen, repräsentieren Daten, an denen die Uhren vorwärts verschoben werden, einen 23-Stunden-Zeitraum und Daten, an denen die Uhren rückwärts angepasst werden, einen 25-Stunden-Zeitraum. Zuvor stand in der Dokumentation fest, dass jedes Datum einen eindeutigen 24-Stunden-Zeitraum darstellte und dass die Zeitzone U.S. Pacific immer UTC-8 galt.

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

    • Die Dimension operating_system, die das Softwaresystem des Geräts ermittelt, auf dem die Aufrufe erfolgten, unterstützt jetzt folgende Werte:
      • 22: Tizen
      • 23: Firefox
      • 24: RealMedia

    • Alle Berichterstellungsjobs für den Berichtstyp content_owner_basic_a1 wurden gelöscht. Dieser Berichtstyp wurde am 19. August 2016 vollständig eingestellt. Zuvor erstellte content_owner_basic_a1-Berichte waren jedoch noch 180 Tage lang verfügbar, nachdem sie generiert wurden. Daher waren einige Berichte erst seit dem 19. Februar 2017 verfügbar. Da die Berichte jedoch nicht mehr verfügbar sind, werden die mit den Berichten verknüpften Jobs auch nicht benötigt.

  • YouTube Analytics API (gezielte Suchanfragen)

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

      Obwohl Datumsangaben normalerweise einen 24-Stunden-Zeitraum darstellen, repräsentieren Daten, an denen die Uhren vorwärts verschoben werden, einen 23-Stunden-Zeitraum und Daten, an denen die Uhren rückwärts angepasst werden, einen 25-Stunden-Zeitraum. Zuvor war in der Dokumentation angegeben, dass die Zeitzone U.S. Pacific (UTC-8) als UTC-8 gilt, und es wurde nicht erwähnt, dass ein Tag möglicherweise keinen 24-Stunden-Zeitraum darstellt.

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

    • Die Dokumentation zu Channelberichten wurde aktualisiert. Channelberichte enthalten derzeit keine Messwerte zu Einnahmen und Anzeigenleistung. Aktuell wird über den Bereich https://www.googleapis.com/auth/yt-analytics-monetary.readonly kein Zugriff auf monetäre Daten in Channelberichten gewährt.

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

8. Februar 2017

Die YouTube Analytics API unterstützt jetzt den optionalen include-historical-channel-data-Parameter. Dieser Parameter ist nur beim Abrufen von Rechteinhaberberichten relevant.

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

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

  • Wenn der Parameterwert false lautet, 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.

    Bedenke dabei, dass verschiedene Kanäle möglicherweise zu unterschiedlichen Zeitpunkten mit einem Rechteinhaber verknüpft wurden. Wenn mit der API-Anfrage Daten für mehrere Kanäle abgerufen werden und der Parameterwert false lautet, enthält die API-Antwort Daten zu Wiedergabezeit und Aufrufen basierend auf dem Verknüpfungsdatum des jeweiligen Kanals.
  • Wenn der Parameterwert true lautet, werden in der Antwort Wiedergabezeit- und Aufrufdaten für alle Kanäle basierend auf dem in der API-Anfrage angegebenen Start- und Enddatum 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 Ankündigung für diese Berichte wurde am 15. September 2016 angekündigt.)

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 Abspannelement-Berichte sowie neue Dimensionen und Messwerte für diese Berichte. Die Berichte enthalten Statistiken zu Impressionen und Klicks für die Abspanne, die nach dem Ende der Wiedergabe eines Videos eingeblendet werden.

    8. November 2016

    Dieses Update umfasst die folgenden Änderungen an der YouTube Analytics API:

    • Die Messwerte in der folgenden Liste wurden vollständig eingestellt und werden nicht mehr unterstützt. Wie am 10. August 2016 angekündigt, werden neue Messwerte, die sich auf dieselben Daten beziehen, bereits unterstützt. In der folgenden Tabelle sehen Sie den eingestellten Messwertnamen und den neuen Messwertnamen:

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

    27. Oktober 2016

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

    Unter Übersicht über vom System verwaltete Berichte finden Sie eine kurze Übersicht über die neuen Berichte und wie sie über die API abgerufen werden. Dieser Vorgang unterscheidet sich geringfügig von dem Verfahren zum Abrufen von Bulk-Berichten für YouTube Analytics, da Partner zum Erstellen von Berichten keine Aufträge planen müssen.

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

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

    27. September 2016

    Hinweis: Diese Mitteilung wird eingestellt.

    Der Messwert „uniques“ der YouTube Analytics API wurde eingestellt. Dies ist kein zentraler Messwert und wird bis zum 31. Oktober 2016 unterstützt.

    15. September 2016

    Diese Aktualisierung umfasst die folgenden Änderungen an der YouTube Reporting API:

    19. August 2016

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

    • Der Bericht „content_owner_basic_a1“ wurde vollständig eingestellt und aus der Dokumentation entfernt. YouTube erstellt keine neuen Berichte dieses Typs mehr. Bereits generierte Berichte sind jedoch noch 180 Tage lang verfügbar, nachdem sie generiert wurden.

      Anstelle des Berichts content_owner_basic_a1 wird der Bericht content_owner_basic_a2 durch den Überarbeitungsverlauf vom 19. Mai 2016 ersetzt.

    11. August 2016

    Dieses Update enthält die folgenden Änderungen:

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

      Die vollständigen neuen Dokumente finden Sie im Überarbeitungsverlauf für die aktualisierten Nutzungsbedingungen. Darüber hinaus werden künftige Änderungen der aktualisierten Nutzungsbedingungen oder der entsprechenden Dokumente in diesem Überarbeitungsverlauf erläutert. Sie können einen RSS-Feed abonnieren, der Änderungen in diesem Überarbeitungsverlauf auflistet, und zwar über einen Link in dem Dokument.

    10. August 2016

    Dieses Update enthält die folgenden Änderungen:

    • YouTube Analytics API (gezielte Suchanfragen)

      • Hinweis: Diese Mitteilung wird eingestellt.

        Die Messwerte in der folgenden Tabelle werden nicht mehr unterstützt. Gleichzeitig werden neue Messwerte eingeführt, die sich auf dieselben Daten beziehen. Das bedeutet, dass die alten Messwerte umbenannt werden. Bis zu den in der Tabelle aufgeführten Einstellungsdaten werden von der YouTube Analytics API beide Messwertnamen unterstützt.

        Alter Messwertname Neuer Messwertname Datum der Unterstützung
        earnings estimatedRevenue 10. August 2017
        adEarnings estimatedAdRevenue 4. November 2016
        redPartnerRevenue estimatedRedPartnerRevenue 4. November 2016
        impressionBasedCpm cpm 4. November 2016
        impressions adImpressions 4. November 2016

        Der Messwert earnings war ein Hauptmesswert und wird ab dem Datum dieser Ankündigung für ein Jahr unterstützt. Die anderen Messwerte, bei denen es sich nicht um die Kernmesswerte handelt, werden drei Monate lang bis zum 4. November 2016 unterstützt.

        Bis zum 4. November 2016 können in einer API-Anfrage beispielsweise die Messwerte impressionBasedCpm und cpm oder beides angegeben werden. Danach wird jedoch nur noch der Messwert cpm unterstützt.

      • Die Dimension insightTrafficSourceType unterstützt zwei neue Dimensionswerte:
        • CAMPAIGN_CARD: Diese Zugriffsquelle wird nur für Rechteinhaberberichte unterstützt. Er weist darauf hin, dass die Aufrufe von von Nutzern hochgeladenen Videos stammen, auf die Anspruch erhoben wurde, mit denen der Rechteinhaber den aufgerufenen Inhalt beworben hat.
        • END_SCREEN: Die Daten beziehen sich auf Aufrufe über den Abspann eines anderen Videos.

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

      • Für die Dimension „adType“ wird jetzt der Wert „auctionBumperInstream“ unterstützt, der sich auf eine nicht überspringbare Videoanzeige mit einer Dauer von bis zu sechs Sekunden bezieht, die abgespielt wird, bevor ein Video wiedergegeben werden kann.

    • YouTube Reporting API (Bulk-Berichte)

      • Für die Dimension traffic_source_type werden jetzt folgende Werte unterstützt:
        • 19: Diese Zugriffsquelle wird nur für Rechteinhaberberichte unterstützt. Er weist darauf hin, dass die Aufrufe von von Nutzern hochgeladenen Videos stammen, auf die Anspruch erhoben wurde, mit denen der Rechteinhaber den aufgerufenen Inhalt beworben hat.
        • 20: Die Daten beziehen sich auf Aufrufe über den Abspann eines anderen Videos.

        Bei beiden neuen Zugriffsquellen gibt die Dimension traffic_source_detail das Video an, von dem der Zuschauer gekommen ist.

      • Die Liste der Kernmesswerte der API wurde korrigiert: estimated_partner_revenue als Hauptmesswert aufgeführt und earnings aus dieser Liste entfernt. Der Messwert earnings wurde in der YouTube Reporting API noch nie unterstützt.

      • Für die Dimension „ad_type“ wird jetzt der Wert „19“ unterstützt, der sich auf Bumper-Anzeigen bezieht. Das sind nicht überspringbare Videoanzeigen, die bis zu sechs Sekunden dauern und vor der Wiedergabe eines Videos wiedergegeben werden.

    18. Juli 2016

    Dieses Update enthält die folgenden Änderungen:

    • YouTube Analytics API (gezielte Suchanfragen)

      • Die Listen der unterstützten Messwerte für die folgenden Kanalberichte wurden aktualisiert und enthalten nun Kartenmesswerte. Seit dem 28. Juni 2016 werden in diesen Berichten jetzt Kartenmesswerte unterstützt. Im Überarbeitungsverlauf für diesen Tag wird die Änderung genauer erläutert. Folgende Berichte sind verfügbar:
        • Grundlegende Nutzeraktivitäten für US-Bundesstaaten
        • Nutzeraktivitäten in US-Bundesstaaten für bestimmte Zeiträume
        • Nutzeraktivität nach Bundesland
        • Nutzeraktivitäten nach Abostatus
        • Nutzeraktivitäten nach Abostatus für Provinzen
        • Top-Videos nach Bundesstaat
        • Top-Videos für Zuschauer mit und ohne Abo

      • Die Filterlisten für die Berichte zur Zuschauerbindung für Kanäle und die Berichte zur Zuschauerbindung von Rechteinhabern wurden korrigiert. Der Filter video ist erforderlich, der Filter group wird jedoch nicht unterstützt.

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

    • YouTube Reporting API (Bulk-Berichte)

      • In der API-Übersicht wurde der Abschnitt zum Abrufen der Download-URL eines Berichts korrigiert, um zu verdeutlichen, dass YouTube herunterladbare Berichte für Tage generiert, an denen keine Daten verfügbar waren. Diese Berichte enthalten eine Kopfzeile, aber keine zusätzlichen Daten. Diese Informationen wurden bereits am 12. April 2016 im Abschnitt Berichtsmerkmale desselben Dokuments aktualisiert.
      • Die Liste der Dimensionen im Bericht „content_owner_asset_cards_a1“ wurde korrigiert, da im Bericht jetzt die Dimension „card_id“ verwendet wird. Bisher wurde der Dimensionsname in der Dokumentation fälschlicherweise als card_title aufgeführt.

    28. Juni 2016

    Die Dokumentation zur YouTube Analytics API wurde aktualisiert, um die Unterstützung für Kartenmesswerte in zahlreichen Berichten zu Kanälen und Rechteinhabern zu berücksichtigen. Folgende Messwerte werden jetzt unterstützt:

    Die Messwerte werden in den folgenden Berichtstypen unterstützt:

    22. Juni 2016

    Dieses Update enthält die folgenden Änderungen an der YouTube Reporting API. Die erste Änderung betrifft allgemein die API, die übrigen Änderungen nur Berichte zu Rechteinhabern:

    • Der Abschnitt Berichtsmerkmale der API-Übersicht wurde aktualisiert, um zu verdeutlichen, dass Berichte ab ihrer Generierung 180 Tage lang über die API verfügbar sind.

      Zuvor stand in der Dokumentation bis zu 180 Tage vor dem Datum, an dem die API-Anfrage gesendet wurde, Berichte zur Verfügung. Auch wenn der Originaltext technisch wahr ist, war er bestenfalls ziemlich verwirrend.

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

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

      • Zwei Berichte in 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 neu umbenannten Berichte unterscheiden sich in folgenden Punkten von ihren Vorgänger:

      Falls Sie bereits Aufträge zum Erstellen einer älteren Version der Berichte haben, müssen Sie neue Aufträge 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 Sie Jobs für einen dieser Berichte haben, können Sie nicht davon ausgehen, dass YouTube nach dem 22. September 2016 neue Berichte für diese Jobs erstellt. Die erstellten Berichte sind ab dem Zeitpunkt ihrer Erstellung noch 180 Tage verfügbar.

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

    • In der Dokumentation wurden die Namen von zwei Messwerten korrigiert, damit sie mit den Namen in Berichten übereinstimmen. Dies ist eine reine Dokumentationskorrektur und spiegelt keine Änderung des eigentlichen Berichtsinhalts wider:

      • Der Name des Messwerts „estimated_partner_adsense_revenue“ wurde in „estimated_partner_ad_sense_revenue“ geändert. Dieser Messwert erscheint jedoch nur in zwei Berichten, die mit diesem Update nicht mehr unterstützt werden. Wie oben beschrieben wurde dieser Messwert in neueren Versionen dieser Berichte in estimated_partner_ad_auction_revenue umbenannt.
      • Der Name des Messwerts „estimated_partner_doubleclick_revenue“ wurde in „estimated_partner_double_click_revenue“ geändert. Dieser Messwert erscheint nur in zwei Berichten, die mit diesem Update nicht mehr unterstützt 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, sodass die Properties elapsed_video_time_percentage und audience_retention_type nicht mehr aufgeführt werden. Diese Dimensionen werden derzeit in den Berichten, die über die API verfügbar sind, nicht unterstützt.

    19. Mai 2016

    Diese Aktualisierung umfasst die folgenden Änderungen an der YouTube Reporting API:

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

      Wenn Sie bereits einen Job zum Erstellen des Berichts content_owner_basic_a1 haben, müssen Sie trotzdem einen neuen Job für den Bericht content_owner_basic_a2 erstellen. YouTube migriert Rechteinhaber nicht automatisch zur neuen Berichtsversion und erstellt auch nicht automatisch einen Job zum Generieren der neuen Berichtsversion. In einigen Implementierungen kann das Erscheinungsbild eines neuen, unerwarteten Jobs zu einer funktionsgefährdenden Änderung führen.

      Im Zusammenhang mit der Veröffentlichung des neuen Berichts wurde der Bericht content_owner_basic_a1 eingestellt. Wenn Sie einen Job für diesen Bericht haben, können Sie davon ausgehen, dass YouTube nach dem 19. August 2016 keine neuen Berichte für diesen Job erstellt. Die erstellten Berichte sind ab dem Zeitpunkt ihrer Erstellung noch 180 Tage verfügbar.

    • Die Ressourcen reportType, job und report unterstützen alle eine neue Property, die angibt, ob die verknüpfte Ressource einen eingestellten Berichtstyp darstellt:

      • Die Eigenschaft deprecateTime der reportType-Ressource gibt mit Datum und Uhrzeit an, wann der Berichtstyp verworfen wird. Diese Property hat nur einen Wert für Berichte, die als veraltet bekannt gegeben werden. Der Wert steht für das Datum, ab dem YouTube keine Berichte dieses Typs mehr generiert.

        Nachdem ein Berichtstyp als eingestellt bekannt gegeben wurde, erstellt YouTube weitere drei Monate lang Berichte dieses Typs. Beispielsweise haben wir durch die Änderung vom 19. Mai 2016 bekannt gegeben, dass der Bericht content_owner_basic_a1 eingestellt wird. Daher gibt die deprecateTime für diesen Berichtstyp den 19. August 2016 an, nach dem YouTube keine Berichte dieses Typs mehr erstellt.

      • Das Attribut expireTime der job-Ressource gibt mit Datum und Uhrzeit an, wann der Job abgelaufen ist oder abläuft. Diese Eigenschaft hat einen Wert, wenn der mit dem Job verknüpfte Berichtstyp veraltet ist oder wenn für den Job generierte Berichte längere Zeit nicht heruntergeladen wurden. Dieses Datum gibt den Zeitpunkt an, nach dem YouTube keine neuen Berichte für den Job mehr erstellt.

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

    • Die Methode jobs.create gibt jetzt einen 400-HTTP-Antwortcode (Bad Request) zurück, wenn Sie versuchen, einen Job für einen verworfenen Bericht zu erstellen. Darüber hinaus werden in der Dokumentation der Methode jetzt mehrere weitere Gründe aufgeführt, die zum Fehlschlagen einer API-Anfrage führen.

    12. April 2016

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

    • YouTube generiert jetzt Daten für die 180 Tage vor der Planung eines Berichtjobs. Bisher wurden über die Reporting API keine Verlaufsdaten bereitgestellt. Diese Änderung betrifft alle Jobs, auch die, die vor dieser Ankündigung erstellt wurden.

      Berichte zu bisherigen Daten werden veröffentlicht, sobald sie verfügbar sind. Es dauert jedoch etwa einen Monat, bis alle bisherigen Daten für eine Stelle veröffentlicht werden. Sie haben also einen Monat nach der Planung eines Berichterstellungsjobs Zugriff auf Daten von etwa sieben Monaten. (Alle Verlaufsdaten für Stellen, die vor dieser Ankündigung erstellt wurden, sollten innerhalb eines Monats nach der Ankündigung veröffentlicht werden.)

      Beachten Sie, dass Verlaufsdaten erst seit dem 1. Juli 2015 verfügbar sind. Daher weisen Arbeitsplätze, die vor dem 28. Dezember 2015 geschaffen wurden, weniger als 180 Tage an Verlaufsdaten auf.

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

    • Der Abschnitt Berichtsmerkmale in der Übersicht zur YouTube Reporting API wurde aktualisiert:

      • In der Dokumentation steht jetzt, dass Berichte nach ihrer Generierung für einen Zeitraum von 180 Tagen verfügbar und somit für API-Clients zum Download verfügbar sind. Zuvor stand in der Dokumentation bis zu sechs Monate vor dem Datum, an dem die API-Anfrage gesendet wurde, Berichte zur Verfügung.

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

    • Die YouTube Reporting API unterstützt demnächst eine Reihe von automatisch erstellten, vom System verwalteten Berichten, die Daten zu Werbeeinnahmen oder YouTube Premium-Aboeinnahmen enthalten. Die Berichte sind für Rechteinhaber verfügbar, die in YouTube Creator Studio bereits manuell auf Umsatzberichte zum Herunterladen zugreifen können. Die neue API-Funktion bietet also programmatischen Zugriff auf diese Daten.

      Als Vorbereitung auf die Einführung der vom System verwalteten Berichte werden die folgenden API-Änderungen angekündigt:

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

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

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

        Im Gegensatz zum Parameter createdAfter der Methode, der sich auf den Zeitpunkt der Berichterstellung bezieht, beziehen sich die neuen Parameter auf die Daten im Bericht.

      • Die neue systemManaged-Eigenschaft der reportType-Ressource gibt an, ob die Ressource einen vom System verwalteten Bericht beschreibt.

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

    28. März 2016

    Über die YouTube Reporting API und die YouTube Analytics API werden jetzt Aufrufstatistiken für verschiedene zusätzliche Dienste zum Teilen zurückgegeben.

    • In der YouTube Reporting API unterstützt die Dimension sharing_service die folgenden neuen Werte:
      • 82: Dialogfeld zur iOS-Systemaktivität
      • 83: Google-Posteingang
      • 84: Android Messenger
    • In der YouTube Analytics API unterstützt die Dimension sharingService die folgenden neuen Werte:
      • ANDROID_MESSENGER: Android Messenger
      • INBOX: Google-Posteingang
      • IOS_SYSTEM_ACTIVITY_DIALOG: Dialogfeld zur 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 auf der Startseite oder dem Startbildschirm von YouTube, im Abofeed des Nutzers oder in einer anderen YouTube-Suchfunktion.
      • 8: Die Daten beziehen sich auf Aufrufe, die direkt auf der YouTube-Suchergebnisseite erfolgt sind.
    • Die Dimension „traffic_source_type“ unterstützt jetzt „18“ als Dimensionswert. Dieser Wert gibt an, dass die Videoaufrufe von einer Seite stammen, auf der alle Videos einer Playlist aufgeführt sind. Diese Quelle unterscheidet sich vom Quelltyp 14. Dieser Wert gibt an, dass die Aufrufe während der Wiedergabe des Videos als Teil einer Playlist erfolgt sind.

    YouTube Analytics API

    • Die Dimension insightPlaybackLocationType unterstützt zwei neue Dimensionswerte:
      • BROWSE: Die Daten beziehen sich auf Aufrufe auf der Startseite oder dem Startbildschirm von YouTube, im Abofeed des Nutzers oder in einer anderen YouTube-Suchfunktion.
      • SEARCH: Die Daten beziehen sich auf Aufrufe, die direkt auf der YouTube-Suchergebnisseite erfolgt sind.
    • Die Dimension „insightTrafficSourceType“ unterstützt jetzt „YT_PLAYLIST_PAGE“ als Dimensionswert. Dieser Wert gibt an, dass die Videoaufrufe von einer Seite stammen, auf der alle Videos einer Playlist aufgeführt sind. Diese Quelle unterscheidet sich vom Quelltyp PLAYLIST. Dieser gibt an, dass die Aufrufe bei der Wiedergabe des Videos als Teil einer Playlist erfolgt sind.

    8. Februar 2016

    Die Liste der für die YouTube Analytics API unterstützten Messwerte wurde aktualisiert. Kartenmesswerte werden nun nicht mehr als unterstützte Messwerte für diese API aufgeführt. (Keiner der Berichte der API hatte nachgewiesen, dass er einen der Kartenmesswerte unterstützt hat.)

    Hinweis: Du kannst Messwerte zu Infokarten weiterhin über die YouTube Reporting API abrufen, die diese Messwerte für zahlreiche Berichte zu Kanälen und Rechteinhabern unterstützt.

    6. Januar 2016

    Sowohl die YouTube Reporting API als auch die YouTube Analytics API identifizieren jetzt speziell Aufrufe, die über Chromecast erfolgen.

    • In der YouTube Reporting API wird für die Dimension operating_system der Wert 21 verwendet, um Aufrufe zu identifizieren, die über Chromecast erfolgen.
    • In der YouTube Analytics API wird für die Dimension operatingSystem der Wert CHROMECAST verwendet, um Aufrufe 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 offenlegen und Einwilligungen dieser Endnutzer einholen. Für Endnutzer in der Europäischen Union müssen Sie daher die Richtlinie zur Einwilligung der Nutzer in der EU einhalten. Wir haben den Nutzungsbedingungen für die YouTube API einen Hinweis auf diese Anforderung hinzugefügt.

    15. Dezember 2015

    Dieses Update enthält die folgenden Änderungen, die alle die YouTube Analytics API betreffen:

    • Die YouTube Analytics API unterstützt jetzt drei neue Dimensionen für Wiedergabedetails, die in verschiedenen Berichten zu Kanälen und Rechteinhabern verwendet werden können:

      • liveOrOnDemand: Diese Dimension gibt an, ob die Daten im Bericht Nutzeraktivitäten während einer Liveübertragung beschreiben.
      • subscribedStatus: Diese Dimension gibt an, ob die Messwerte zur Nutzeraktivität in den Daten Zuschauern zugeordnet werden, 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, um neue Berichte zu Wiedergabedetails zu finden, die für Kanäle und Rechteinhaber zur Verfügung stehen. Außerdem wurden viele andere Berichte aktualisiert, um zu beachten, dass eine oder mehrere dieser Dimensionen optional als Dimensionen und/oder Filter in diesen Berichten verwendet werden können.

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

      Inhalt
      Abmessungen:
      Erforderlich deviceType
      0 oder mehr verwenden day, liveOrOnDemand, subscribedStatus, youtubeProduct
      Messwerte:
      Mindestens 1 verwenden Aufrufe, estimatedMinutesWatched
      Filter:
      „0“ oder „1“ verwenden Land, Provinz, Kontinent, subContinent
      „0“ oder „1“ verwenden Video, Gruppe
      0 oder mehr verwenden operatingSystem, liveOrOnDemand, subscribedStatus, youtubeProduct

      Die Terminologie, die Pflichtfelder und optionale Felder beschreibt, wird in der Dokumentation zu Kanal- und Rechteinhaberberichten erläutert.

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

      Angenommen, ein Nutzer sendet eine API-Anfrage, in der der Filter video 20 Video-IDs auflistet. Der Nutzer besitzt 18 Videos. Eine Video-ID kennzeichnet jedoch ein Video, das einem anderen Kanal gehört, und eine andere ID für ein gelöschtes Video, das daher nicht mehr existiert. In diesem Fall gibt der API-Server nicht mehr einen Fehler zurück, sondern löscht jetzt die beiden Videos, auf die der Nutzer keinen Zugriff hat. Die API-Antwort enthält dann Daten für die 18 Videos, die dem API-Nutzer gehören.

    • Wenn du Daten für ein leeres group in YouTube Analytics anfragen, gibt die API jetzt einen leeren Datensatz und keinen Fehler zurück.

    • Die groupItems.insert-Methode der YouTube Analytics API gibt jetzt einen nicht autorisierten Fehler (403-HTTP-Antwortcode) zurück, wenn du versuchst, einer Gruppe eine Entität hinzuzufügen, aber keinen Zugriff auf diese Entität hast. Früher hätten Sie mit der API die Entität der Gruppe hinzufügen können, aber später wurde beim Versuch, Berichtsdaten für diese Gruppe abzurufen, ein nicht autorisierter Fehler zurückgegeben.

    • 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 Parameter pageToken der Methode auf diesen Wert fest, um zusätzliche Ergebnisse abzurufen.

    10. November 2015

    Dieses Update enthält die folgenden Änderungen:

    29. Oktober 2015

    Dieses Update enthält die folgenden Änderungen:

    • In der Dokumentation für die Dimension „date“ der YouTube Reporting API wurde korrigiert, dass sie sich nun auf den 24-Stunden-Zeitraum ab 00:00 Uhr Pacific Time (UTC-8) bezieht. Zuvor stand in der Dokumentation als Startdatum 00:00 Uhr (GMT) fest.

      Außerdem wurde die Dokumentation zur YouTube Analytics API aktualisiert. Alle datumsbezogenen Dimensionen (day, 7DayTotals, 30DayTotals und month) beziehen sich jetzt auf Zeiträume, die um 00:00 Uhr Pacific Time (UTC-8) beginnen.

    • Die jobs.reports.list()-Methode der YouTube Reporting API unterstützt jetzt den createdAfter-Abfrageparameter. Falls angegeben, gibt dieser Parameter an, dass in der API-Antwort nur Berichte aufgeführt werden sollen, die nach dem angegebenen Datum und der angegebenen Uhrzeit erstellt wurden, einschließlich neuer Berichte mit Daten, die aufgefüllt wurden. Beachten Sie, dass sich der Parameterwert auf den Zeitpunkt der Berichterstellung bezieht und nicht auf das Datum, das den zurückgegebenen Daten zugeordnet ist.

      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. Darin wird erläutert, wie du mithilfe des createdAfter-Parameters die wiederholte Verarbeitung desselben Berichts vermeiden kannst.

    • Die Definitionen der createTime-Eigenschaft der job-Ressource und der startTime-, endTime- und createTime-Attribute der report-Ressource wurden korrigiert, um zu beachten, dass die Eigenschaftswerte auf Mikrosekunden und nicht auf Nanosekunden genau sind. Darüber hinaus geben alle Definitionen nun korrekt wieder, dass der Attributwert ein Zeitstempel ist.

    8. Oktober 2015

    Dieses Update enthält die folgenden Änderungen:

    • Die Dokumentation für die Dimension „sharingService“ der YouTube Analytics API wurde aktualisiert und enthält nun eine Liste möglicher Dimensionswerte. Die Liste enthält eine Reihe neuer unterstützter Dienste.

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

    24. September 2015

    Dieses Update enthält die folgenden Änderungen:

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

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

      Mit der API kannst du Berichterstellungsjobs planen, von denen jeder einen Bericht identifiziert, der von YouTube erstellt werden soll. Sobald Sie einen Job eingerichtet haben, erstellt YouTube einen täglichen Bericht, der asynchron heruntergeladen werden kann. Jeder Bericht enthält Daten für einen eindeutigen Zeitraum von 24 Stunden.

    • Es handelt sich zwar um unterschiedliche APIs, mit der YouTube Analytics API und der YouTube Reporting API können Entwickler aber auch YouTube Analytics-Daten abrufen. Da beide APIs Zugriff auf ähnliche Datensätze ermöglichen, wird die Dokumentation für die beiden APIs als ein Satz Dokumentation veröffentlicht.

      • Der Tab Leitfäden in der Dokumentation enthält allgemeine Informationen für beide APIs, 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 Gezielte Abfragen enthält eine Referenzdokumentation und andere Inhalte speziell für die YouTube Analytics API.
      • Auf dem Tab Beispiele finden Sie Codebeispiele, die für eine der beiden APIs verfügbar sind.
      • Auf dem Tab Tools werden zusätzliche Ressourcen aufgeführt, mit denen Entwickler eine der beiden APIs implementieren können.

    20. August 2015

    Dieses Update enthält die folgenden Änderungen:

    • Die API-Dokumentation wurde neu strukturiert, um die API verständlicher zu machen. Daher beziehen sich diese Änderungen nicht auf neue Funktionen:

      • Die Dokumentation enthält jetzt eine Seite mit allen verfügbaren Kanalberichten und eine weitere Seite mit allen verfügbaren Rechteinhaberberichten. Bisher war die Dokumentation auf separaten Seiten unter anderem für Kanalvideoberichte und Kanalplaylists enthalten.

      • Die neue Datenmodellübersicht bietet eine klarere Einführung in die Funktionsweise der API. Insbesondere wird erläutert, wie YouTube Messwerte, Dimensionen und Filter zur Berechnung von Berichtwerten verwendet.

      • Die reports.query-Methode der API, die Sie zum Abrufen von Berichten verwenden, ist jetzt separat dokumentiert. Die Informationen auf dieser Seite befanden sich zuvor auf einigen anderen Seiten. Auf der neuen Seite können Sie leichter erkennen, welche Informationen zum Abrufen eines Berichts gesendet werden müssen.

    22. Juli 2015

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

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

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

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

    • Neben dem eingestellten Messwert primaryAdGrossRevenue werden in Berichten zur Anzeigenleistung die Messwerte monetizedPlaybacks und playbackBasedCpm nicht mehr unterstützt. Mehrere Videoberichte unterstützen diese Messwerte jedoch weiterhin.

    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, sodass nur die Berichte angezeigt werden, die die neuen Messwerte unterstützen.

      • videosAddedToPlaylists: Gibt an, wie oft Videos im Bereich der Abfrage YouTube-Playlists hinzugefügt wurden. Möglicherweise wurden die Videos der Playlist des Videoinhabers oder den Playlists anderer Kanäle hinzugefügt.
      • videosRemovedFromPlaylists: Gibt an, wie oft Videos, die in der Abfrage enthalten waren, aus YouTube-Playlists entfernt wurden. Möglicherweise wurden die Videos aus der Playlist des Videoinhabers oder aus den Playlists anderer Kanäle entfernt.

      Beide Messwerte umfassen Standardplaylists wie die Playlist „Später ansehen“. Dabei werden jedoch keine Playlists berücksichtigt, zu denen ein Video automatisch hinzugefügt wird. Dazu zählen beispielsweise die Playlist „Uploads“ eines Kanals oder der Wiedergabeverlauf eines Nutzers. Diese Messwerte spiegeln die absolute Anzahl der Hinzufügungen und Löschungen wider. Wenn ein Nutzer also ein Video zu einer Playlist hinzufügt, es entfernt und anschließend wieder hinzufügt, zeigen die Messwerte an, dass das Video zu zwei Playlists und aus einer entfernt wurde.

      Daten für diese Messwerte stehen seit dem 1. Oktober 2014 zur Verfügung.

    31. März 2015

    Dieses Update enthält die folgenden Änderungen:

    • Die Messwerte favoritesAdded und favoritesRemoved werden ab dieser Ankündigung nicht mehr unterstützt. Dies sind beide Kernmesswerte und unterliegen der in den Nutzungsbedingungen festgelegten Richtlinie zur Einstellung von Produkten und Diensten.

    16. März 2015

    Dieses Update enthält die folgenden Änderungen:

    • Mit dem neuen Parameter currency können Sie Messwerte zu Einnahmen 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 auf Grundlage von Wechselkursen berechnet wurden, die sich täglich ändern.

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

    25. Februar 2015

    Dieses Update enthält die folgenden Änderungen:

    • Mit der API können jetzt YouTube Analytics-Gruppen erstellt und verwaltet sowie Berichtsdaten für diese Gruppen abgerufen werden.

      • Gruppen erstellen und verwalten

        Dieses Update enthält die Ressourcen group und groupItem zum Erstellen und Verwalten von Gruppen.

        • Die Ressource group 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 Ressource groupItem steht für ein Element in einer Analytics-Gruppe. Die API unterstützt die Methoden list, insert und delete für diese Ressource.

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

      • Berichtsdaten für eine Gruppe abrufen

        Die Dokumentation zu Dimensionen wurde aktualisiert und enthält nun die Dimension group, die als Filter für viele Channelberichte und Berichte zu Rechteinhabern verwendet werden kann. Wenn Sie den group-Filter verwenden, gibt die API Daten für alle Elemente in dieser Gruppe zurück. Mit der API können derzeit keine Berichte für Asset-Gruppen erstellt werden.

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

    13. Februar 2015

    Dieses Update enthält die folgenden Änderungen:

    • Die API unterstützt die Dimension show nicht mehr.

    28. August 2014

    Dieses Update enthält die folgenden Änderungen:

    • In der API können jetzt mehrere Werte für die Dimensionen video, playlist, channel und show angegeben werden, wenn diese Dimensionen als Filter verwendet werden. Wenn du mehrere Werte angeben möchtest, setze den filters-Parameterwert auf eine durch Kommas getrennte Liste der Video-, Playlist-, Kanal- oder Sendungs-IDs, für die die API-Antwort gefiltert werden soll. Für den Parameterwert können bis zu 200 IDs angegeben werden.

      Wenn Sie mehrere Werte für denselben Filter angeben, können Sie ihn der Liste der Dimensionen hinzufügen, die Sie für die Anfrage angeben. Das gilt auch dann, wenn der Filter für einen bestimmten Bericht nicht als unterstützte Dimension aufgeführt ist. Wenn Sie den Filter zur Liste der Dimensionen hinzufügen, verwendet die API die Filterwerte auch zum Gruppieren der Ergebnisse.

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

    16. Juli 2014

    Dieses Update enthält die folgenden Änderungen:

    • Beim Abrufen eines Channelberichts können Sie jetzt Daten für den Channel des authentifizierten Nutzers abrufen. Dazu setzen Sie den Wert des Parameters ids auf channel==MINE. Sie können den ids-Parameter auch weiterhin auf channel==CHANNEL_ID setzen, um Daten für den angegebenen Kanal abzurufen.

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

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

      Darüber hinaus unterstützen alle Playlist-Berichte die folgenden neuen Messwerte. Jeder dieser Messwerte spiegelt nur Playlist-Aufrufe im Web wider.

      • playlistStarts: Gibt an, wie oft die Wiedergabe einer Playlist durch Zuschauer gestartet wurde.
      • viewsPerPlaylistStart: Die durchschnittliche Anzahl an Videoaufrufen, die nach dem Start einer Playlist stattgefunden haben.
      • averageTimeInPlaylist: Die geschätzte durchschnittliche Zeit in Minuten, die ein Zuschauer nach dem Start der Playlist Videos in einer Playlist angesehen hat.

      Alle Anfragen zum Abrufen eines Playlist-Berichts müssen den isCurated-Filter verwenden, der auf 1 (isCurated==1) gesetzt sein muss.

    • Die API unterstützt jetzt einen Bericht zur Zuschauerbindung. In diesem Bericht wird die Fähigkeit eines Videos bewertet, sein Publikum zu binden. Mit der neuen Dimension elapsedVideoTimeRatio des Berichts wird die verstrichene Videodauer für die entsprechenden Messwerte erfasst:

      • Der Messwert audienceWatchRatio gibt das absolute Verhältnis der Zuschauer an, die sich das Video an einer bestimmten Stelle im Video ansehen. Das Verhältnis wird berechnet, indem die Häufigkeit, mit der ein Teil eines Videos angesehen wurde, mit der Gesamtzahl der Aufrufe des Videos verglichen wird.

        Ein Teil des Videos kann während eines bestimmten Aufrufs mehrmals oder gar nicht angesehen werden. Wenn Nutzer beispielsweise zurückspulen und denselben Teil eines Videos mehrmals ansehen, kann das absolute Verhältnis für diesen Teil des Videos größer als 1 sein.

      • Der Messwert relativeRetentionPerformance gibt an, wie gut ein Video die Zuschauer während der Wiedergabe im Vergleich zu allen YouTube-Videos ähnlicher Länge fesselt. Ein Wert von 0 bedeutet, dass die Nutzerbindung durch das Video schlechter als jedes andere Video ähnlicher Länge ist. Ein Wert von 1 bedeutet, dass das Video die Zuschauerbindung besser einspart als jedes andere Video ähnlicher Länge. Ein Medianwert von 0,5 bedeutet, dass die Hälfte der Videos ähnlicher Länge Zuschauer besser an sich binden und die andere Hälfte schlechter an sich binden.

      Sie können auch den Filter audienceType verwenden, damit der Bericht nur Daten enthält, die mit organischen Aufrufen, Aufrufen über TrueView In-Stream-Anzeigen oder Aufrufe über TrueView In-Display-Anzeigen verknüpft sind. (Organische Aufrufe sind das direkte Ergebnis von Nutzeraktionen, z. B. einer Suche nach einem Video oder einem Klick auf ein vorgeschlagenes Video.)

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

      Alle neuen Messwerte sind Kernmesswerte und unterliegen der Richtlinie zur Einstellung von Produkten und Diensten. Beachten Sie jedoch, dass Daten für die neuen Messwerte ab dem 16. Juli 2013 verfügbar sind. (Daten zu den Messwerten annotationClickThroughRate und annotationCloseRate stehen seit dem 10. Juni 2012 zur Verfügung.)

    • „GOOGLE_SEARCH“ wird nicht mehr als separater Wert für die Dimension „insightTrafficSourceType“ erfasst. Stattdessen werden Verweise aus Google-Suchergebnissen jetzt dem Besucherquellentyp „EXT_URL“ zugeordnet. Daher ist es nicht mehr möglich, einen insightTrafficSourceDetail-Bericht abzurufen, bei 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 zu Beispielanfragen wurde umgestaltet, um Beispiele in Kategorien zu gruppieren. Dabei wird ein Tab-Format verwendet, das dem vor Kurzem für Kanal- und Rechteinhaberberichte veröffentlichten Format ähnelt. Mit dem neuen Design werden die Beispiele in die folgenden Kategorien gruppiert:

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

    • Das Dokument zu Beispielanfragen enthält jetzt neue Beispiele für den Abruf von Daten zu Provinzen in Kanalberichten oder Berichten zu Rechteinhabern.

      • Provinzspezifische Messwerte für US-Bundesstaaten und Washington D.C.: Mit diesem Bericht wird eine Aufschlüsselung der Aufrufzahlen nach Provinz nach Provinz sowie andere Statistiken für die Videos eines Kanals abgerufen. Die Daten beziehen sich auf US-Bundesstaaten und Washington D.C. Im Beispiel wird die Dimension province und der Parameter filters verwendet, um die Antwort auf Ergebnisse für die USA einzuschränken.

      • Demografische Merkmale der Zuschauer in Kalifornien (Altersgruppe und Geschlecht): In diesem Bericht werden Statistiken zur Altersgruppe und zum Geschlecht von Zuschauern in Kalifornien abgerufen, die sich Videos eines Kanals angesehen haben. In Berichten zu Inhalten des Rechteinhabers werden außerdem die beanspruchten Inhalte eines Rechteinhabers angezeigt. 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 außerdem auf die USA beschränkt werden. Dazu wird country==US in den Parameterwert filters aufgenommen.

    6. Januar 2014

    Dieses Update enthält die folgenden Änderungen:

    • Die Dokumente mit den unterstützten Berichten zu Kanälen und Rechteinhabern wurden überarbeitet. Anstatt eine Tabelle bereitzustellen, in der alle möglichen Berichte aufgelistet sind, 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. Klicken Sie auf einen beliebigen Tab, um die unterstützten Berichte dieser Kategorie zu sehen.

    • 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 für den District of Kolumbien abrufen. Die API unterstützt zwei Verwendungsmöglichkeiten für diese Dimension:

        • Die API unterstützt zwei Berichte, die Statistiken nach Bundesstaat aufschlüsseln. Beide Berichte sind für Kanäle und Rechteinhaber verfügbar.

          • Der Bericht enthält verschiedene Statistiken, darunter die Anzahl der Aufrufe und die geschätzte Wiedergabezeit in Minuten.
          • Der zeitbasierte Bericht liefert die gleichen Statistiken, fasst die Daten jedoch für jeweils 7 Tage, 30 Tage oder jeden Monat zusammen.

        • Mithilfe des Abfrageparameters filters können Sie festlegen, dass ein Bericht nur Statistiken für einen bestimmten Status enthält. Mehrere Berichte unterstützen diese Art der Filterung, z. B. Berichte nach Standort, zu Wiedergabeorten, zu Zugriffsquellen, zu Geräten, zum Betriebssystem, nach demografischen Merkmalen und zu den Top-Videos.

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

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

        Da jede Subregion nur einem Kontinent zugeordnet ist, muss nicht zusätzlich der continent-Filter verwendet werden, wenn Sie den subContinent-Filter nutzen. Die API gibt einen Fehler zurück, wenn in einer Anfrage beide Dimensionen verwendet werden.

    • Die Dokumentation wurde korrigiert und die Dimension „insightTrafficSourceDetail“ enthält nun nicht mehr den Wert „insightTrafficSourceType“ (PROMOTED) als gültigen Filterwert.

    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 zu den Kernbereichen gehörenden Dimensionen der API und Messwerte, die nicht zu den Kernmesswerten gehören, unterliegen jedoch nicht der Richtlinie zur Einstellung von Produkten und Diensten. Auf den Seiten Dimensionen und metrics werden nun Kerndimensionen und -messwerte aufgelistet. Außerdem wurden die Definitionen auf diesen Seiten aktualisiert, um Kerndimensionen und -messwerte explizit anzugeben.

    • Die API unterstützt jetzt EXTERNAL_APP als Wert für die Dimension insightPlaybackLocationType. Im Rahmen dieser Aktualisierung werden Wiedergaben ab dem 10. September 2013 nicht mehr als MOBILE-Wiedergaben kategorisiert. Wiedergaben von Mobilgeräten, die vor diesem Datum stattgefunden haben, werden jedoch weiterhin anhand dieses Werts kategorisiert.

      Mit diesem Update werden mobile Wiedergaben jetzt abhängig von der Art der App als WATCH-, EMBEDDED- oder EXTERNAL_APP-Wiedergaben eingestuft.

    • Die API unterstützt jetzt PLAYLIST als Wert für die Dimension insightTrafficSourceType. Der Wert gibt an, dass Videoaufrufe über eine Playlist verwiesen wurden. Bisher wurden diese Aufrufe mithilfe der Kategorie YT_OTHER_PAGE der Dimension klassifiziert.

    16. Juli 2013

    Dieses Update enthält die folgenden Änderungen:

    • Die API unterstützt jetzt die Möglichkeit, Berichte nach mehreren Dimensionen und Messwerten zu sortieren. Das Beispiel-Request-Dokument enthält ein neues Beispiel, in dem diese Funktionalität veranschaulicht wird: Anfragen nach mehreren Dimensionen/Messwerten sortieren. Die Anfrage ruft Daten zu Besucherquellen ab und hat den sort-Parameterwert day,-views. Die Ergebnisse sind chronologisch sortiert, aber in der ersten Zeile der Ergebnismenge für jeden Tag enthält die erste Zeile Daten für die Besucherquelle, über die die meisten Aufrufe generiert wurden, die zweite Zeile die Daten für die Quelle, von der die nächsthöhere Anzahl an Aufrufen generiert wurde, und so weiter.

    • Die API unterstützt jetzt die beiden neuen Dimensionen deviceType und operatingSystem. Damit lassen sich Daten zu den Geräten abrufen, auf denen sich Zuschauer deine Videos ansehen. Die API unterstützt Berichte, in denen eine oder beide Dimensionen verwendet werden.

      • Mit dem Bericht „deviceType“ kannst du die Anzahl der Aufrufe und die geschätzte Wiedergabezeit für verschiedene Gerätetypen abrufen, z. B. Computer, Smartphones und Tablets. Mit dem Filter „operatingSystem“ können Sie auch festlegen, dass der Bericht zu Gerätetypen nur Statistiken für Geräte mit einem bestimmten Betriebssystem enthält, z. B. Android oder iOS.

      • Mit dem Bericht „operatingSystem“ kannst du die Anzahl der Aufrufe und die geschätzte Wiedergabezeit für verschiedene Betriebssysteme abrufen, z. B. Android, iOS oder Linux. Mit dem Filter deviceType können Sie auch festlegen, dass der Betriebssystembericht nur Statistiken für einen bestimmten Gerätetyp enthält, z. B. Mobilgeräte oder Tablets.

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

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

    • Für die Dimension „insightPlaybackLocationType“ wird unter Umständen der Wert YT_OTHER zurückgegeben. Damit werden Aufrufe angegeben, die nicht unter Verwendung eines der anderen Werte der Dimension klassifiziert wurden.

    23. Mai 2013

    Dieses Update enthält die folgenden Änderungen:

    10. Mai 2013

    Dieses Update enthält die folgenden Änderungen:

    6. Mai 2013

    Dieses Update enthält die folgenden Änderungen:

    • Die API unterstützt jetzt die Möglichkeit, Messwerte zur Wiedergabezeit (estimatedMinutesWatched, averageViewDuration und averageViewPercentage) in Verbindung mit anderen Messwerten wie Aufruf-, Engagement-, Einnahmen- und Anzeigenleistungs-Messwerte abzurufen.

      Die Listen verfügbarer Kanalberichte und Rechteinhaberberichte wurden entsprechend aktualisiert. Die Listen sind jetzt kürzer, da die Messwerte für die Wiedergabezeit im Rahmen anderer aufgeführten 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 so optimiert:

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

      • Rechteinhaber können diese Berichte jetzt mit jeder 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 zu Zugriffsquellen

          • 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 viele verschiedene Arten von Berichten mit YouTube Analytics API abgerufen werden können. Jedes Beispiel enthält eine kurze Beschreibung des Berichts, der durch die Anfrage abgerufen wird. Anschließend werden die Dimensionen, Messwerte, Filter und Sortierparameter für die Anfrage angezeigt.

    • Für die Dimension „insightTrafficSourceType“ wird jetzt der Wert „SUBSCRIBER“ als gültiger Wert unterstützt. Dieser Wert identifiziert Videoaufrufe, die über Feeds auf der YouTube-Startseite oder über YouTube-Abofunktionen generiert wurden. Wenn Sie nach dieser Besucherquelle filtern, gibt das Feld insightTrafficSourceDetail den Startseitenfeed oder eine andere Seite an, von der Aufrufe weitergeleitet wurden.

    28. März 2013

    Dieses Update enthält die folgenden Änderungen:

    21. März 2013

    Dieses Update enthält die folgenden Änderungen:

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

      • Die neu unterstützten Berichte unterstützen wiedergabebasierte Messwerte zur Anzeigenleistung und Messwerte, die auf Impressionen basieren. Weitere Informationen zu Berichten zur Anzeigenleistung findest du in der Dokumentation zu Rechteinhaberberichten.

      • Die neuen unterstützten Messwerte sind unten aufgeführt. Die Liste der Berichte für Rechteinhaber wurde aktualisiert und enthält nun die Berichte, die diese Messwerte unterstützen. Dazu gehören auch die beiden neuen Berichte.

        • earnings: Geschätzte Gesamteinnahmen aus allen von Google verkauften Werbequellen.
        • grossRevenue: geschätzter Bruttoumsatz von Google- oder DoubleClick-Partnern.
        • primaryAdGrossRevenue: Die geschätzten Bruttoeinnahmen von Google oder DoubleClick-Partnern, zusammengefasst und unter dem primären Anzeigentyp für die Videowiedergaben klassifiziert, die im Bericht enthalten sind.
        • monetizedPlaybacks: Die Anzahl der Wiedergaben, bei denen mindestens eine Anzeigenimpression ausgeliefert wurde.
        • playbackBasedCpm: geschätzte Bruttoeinnahmen pro 1.000 Wiedergaben.
        • impressions: Anzahl der verifizierten Anzeigenimpressionen, die erzielt wurden.
        • impressionBasedCpm: geschätzte Bruttoeinnahmen pro 1.000 Anzeigenimpressionen.

        Hinweis:Weitere Informationen finden Sie in den Definitionen der Messwerte.

      • Jede Anfrage zum Abrufen von Messwerten zu Einnahmen oder Anzeigenleistung muss ein Autorisierungstoken senden, das Zugriff mit dem neuen Bereich https://www.googleapis.com/auth/yt-analytics-monetary.readonly gewährt.

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

    4. Februar 2013

    Dieses Update enthält die folgenden Änderungen:

    • Das API-Referenzhandbuch 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 derselbe, der in der Dokumentation der Beispielanwendung ausführlich erläutert wird.

    14. November 2012

    Dieses Update enthält die folgenden Änderungen:

    • Das API-Referenzhandbuch enthält jetzt das APIs Explorer, mit dem Sie die API aufrufen, die API-Anfrage ansehen und echte Daten aus der Antwort abrufen können.

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

      • Der Bericht zum Wiedergabeort gibt die Anzahl der Videoaufrufe an, die auf verschiedenen Arten von Seiten oder Apps stattgefunden haben.

      • Der Detailbericht zum Wiedergabeort zeigt die eingebetteten Player an, die für ein bestimmtes Video die meisten Aufrufe generiert haben. Er bietet eine detailliertere Ansicht als der Bericht zu Wiedergabeorten, da die URLs der beliebtesten eingebetteten Player identifiziert werden.

      • Der Zugriffsquellenbericht gibt die Anzahl der Videoaufrufe an, die über verschiedene Arten von Verweis-URLs erfolgten.

      • Im Detailbericht zu Zugriffsquellen sind die Verweis-URLs angegeben, die für ein bestimmtes Video und einen bestimmten Besucherquellentyp die meisten Aufrufe generiert haben. In diesem Bericht kannst du beispielsweise die ähnlichen Videos finden, die die meisten Zugriffe auf ein bestimmtes Video generiert haben. Dieser Bericht wird für mehrere Besucherquellen unterstützt.

      • Berichte zur Wiedergabezeit geben Aufschluss darüber, wie lange Zuschauer damit verbracht haben, sich deine Inhalte anzusehen. In den Berichten können Daten für einen bestimmten Zeitraum (Tag, letzte 7 Tage, letzte 30 Tage usw.) oder ein bestimmtes Land zusammengefasst werden. Wenn in einem Bericht Daten entweder nach Tag oder Land gesammelt werden, kann er auch die durchschnittliche Länge jedes Videoaufrufs sowie den durchschnittlichen Prozentsatz jedes Videos angeben, das die Nutzer angesehen haben.

    2. Oktober 2012

    Dieses Update enthält die folgenden Änderungen:

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

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

    12. September 2012

    Dieses Update enthält die folgenden Änderungen:

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

    • Der Bereich Zeitliche Dimensionen wurde aktualisiert. Jetzt geben wir an, dass in einem Analytics-Bericht Daten basierend auf einem Zeitraum zusammengefasst werden sollten. Die API unterstützt jetzt die folgenden zusätzlichen zeitlichen Dimensionen:

      • 7DayTotals: Die Daten im Bericht werden zusammengefasst, sodass jede Zeile die Daten eines Zeitraums von sieben Tagen enthält.
      • 30DayTotals: Die Daten im Bericht werden zusammengefasst, sodass jede Zeile die Daten eines Zeitraums von 30 Tagen enthält.
      • month: Die Daten im Bericht werden nach Kalendermonat zusammengefasst.

      Auch der Abschnitt Verfügbare Berichte wurde aktualisiert, um zu verdeutlichen, dass die API Berichte mit diesen Dimensionen unterstützt.

    • Der Abschnitt Dimensionen von Berichtsentitäten wurde aktualisiert. Bei API-Anfragen zum Abrufen von Rechteinhaberberichten müssen Daten entweder nach einer dieser Dimensionen (video, channel oder show) oder einer unterstützten Kombination der Dimensionen claimedStatus und uploaderType gefiltert werden.

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

    • Die Definitionen der metrics subscribersGained und subscribersLost wurden aktualisiert, um zu verdeutlichen, dass ein Kanal an verschiedenen Stellen Abonnenten gewinnen oder verlieren kann, z. B. auf der Videowiedergabe- und der Kanalseite sowie in der Übersicht auf der YouTube-Startseite. Wenn diese Messwerte in einem Videobericht erscheinen, enthalten sie nur Statistiken der Wiedergabeseite des entsprechenden Videos.