Überarbeitungsverlauf

Auf dieser Seite findest du API-Änderungen und Aktualisierungen der Dokumentation für die YouTube Reporting API und die YouTube Analytics API. Mit beiden APIs können Entwickler auf YouTube Analytics-Daten zugreifen, wenn auch auf unterschiedliche Weise. Änderungsprotokoll abonnieren Abonnieren

6. Mai 2024

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

Darüber hinaus sollte die Zielgruppe Der Bericht „Bindung“ wurde um drei neue Messwerte erweitert:

7. April 2024

Die YouTube Analytics (Targeted Queries) API hat einige Aktualisierungen im Zusammenhang mit Rechteinhabern vorgenommen. Playlist-Berichte. Die Aktualisierungen entsprechen denen zu Kanal-Playlist-Berichten, die am 19. Januar 2024 angekündigt wurde.

Der folgende Überarbeitungsverlaufseintrag enthält dieselben Informationen wie im Eintrag vom 19. Januar 2024. Beachten Sie jedoch, dass der Inhaltseigentümer Playlist-Berichte die isCurated Dimension bis 31. Dezember 2024. Die Dimension wird allerdings noch bis zum 30. Juni 2024.

  • Hinweis: Dies ist eine Ankündigung zu eingestellten Funktionen.

    Das isCurated wurde in den Playlist-Berichten für Rechteinhaber eingestellt. Es wird nicht mehr ab dem 31. Dezember 2024 unterstützt. Die Definition dieser Dimension wurde aktualisiert entsprechend anpassen.

    Zur Aufrechterhaltung der Abwärtskompatibilität, wenn du das isCurated entfernst Dimension verwenden, müssen Sie auch Ihren Code aktualisieren, um den Messwert playlistViews abzurufen anstelle des Messwerts views nur für Playlist-Berichte. Seit dem views wird für Playlist-Berichte weiterhin unterstützt, auch wenn die API eine andere Bedeutung hat. wenn Sie den Messwertnamen nicht aktualisieren. Natürlich können Sie Ihre Anwendung um sowohl views als auch playlistViews abzurufen und anzuzeigen.

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

    • Standortfilter wie continent und subcontinent sind nicht die in den neuen Channel-Playlist-Berichten unterstützt werden.
    • Die Messwerte redViews und estimatedRedMinutesWatched sind nicht mehr verfügbar die in den neuen Channel-Playlist-Berichten unterstützt werden. Diese Messwerte waren in YouTube Studio nicht verfügbar. Durch diese Änderung werden die API-Funktionen an die Funktionen der Studio-Anwendung angepasst.
    • Die Dimensionen subscribedStatus und youtubeProduct sind nicht mehr verfügbar werden als Filter für Kanal-Playlist-Berichte unterstützt. Diese Filter waren nicht verfügbar in YouTube Studio. Durch diese Änderung werden die API-Funktionen also an die Funktionen angepasst, die in in der Studio-Anwendung.

  • Playlist-Berichte der Dokumentation zu Rechteinhaberberichten wurde aktualisiert, um Folgende Arten von Messwerten werden in Playlist-Berichten unterstützt:

    • Zusammengefasste Videomesswerte stellen Messwerte zur Nutzeraktivität und zu Impressionen bereit, die für alle Videos im Playlists, die auch diesem Rechteinhaber gehören Zusammengefasste Videomesswerte sind wird nur für API-Anfragen unterstützt, in denen die Dimension isCurated nicht verwendet wird.
    • Messwerte in Playlists Nutzeraktivitäten und -interaktionen im Kontext der Playlist-Seite widerspiegeln. Diese Messwerte Daten einschließen enthält auch Aufrufe von Videos, die dir nicht gehören, aber wenn diese Aufrufe im Zusammenhang mit der Playlist erfolgten.
    • Die unterstützten Playlist-Messwerte enthält die zusammengefassten Video- und Playlist-Messwerte, für Playlist-Berichte unterstützt.

  • Die folgenden neuen In-Playlist-Messwerte werden für Playlist-Berichte für als Rechteinhaber hinzufügen. Beachten Sie, dass diese Messwerte nur unterstützt werden, wenn die API-Anfrage zum Abrufen In den Berichten wird die Dimension isCurated nicht verwendet. Weitere Informationen finden Sie in der metrics-Dokumentation für Definitionen der einzelnen Messwerte:

  • Das Verhalten von views hängt nun davon ab, ob die API-Anfrage, mit der der Playlist-Bericht abgerufen wurde, Dimension „isCurated“:

    • Wenn eine Anfrage die Dimension isCurated enthält, wird der Der Messwert "views" ist eine In-Playlist der angibt, wie oft Videos im Kontext des die Playlists des Rechteinhabers.
    • Wenn eine Anfrage die Dimension isCurated nicht enthält, wird der Der Messwert „views“ ist ein aggregierter Videomesswert, der die Gesamtzahl angibt wie oft Videos in den Playlists des Rechteinhabers angesehen wurden, unabhängig davon, ob diese Aufrufe im Zusammenhang mit der Playlist erfolgten. Die Gesamtsumme enthält nur Aufrufe von Videos, die dem Rechteinhaber gehören, der mit dem Kanal verknüpft ist, zu dem die Playlist gehört.

      In Berichten, in denen die Dimension isCurated nicht verwendet wird, Der Messwert „playlistViews“ gibt an, wie oft Videos angesehen wurden im Kontext der Playlist. Bei diesem Messwert werden die Aufrufe für alle Videos in der Playlist gezählt, unabhängig davon, welchem Kanal sie gehören.

  • Für jeden Playlist-Bericht enthält das Feld Rechteinhaberberichte enthält die Dokumentation nun Tabellen mit unterstützten Messwerten für den jeweiligen Bericht, je nachdem, Gibt an, ob die API-Anfrage die Dimension isCurated enthält. Weitere Informationen finden Sie im Abschnitt zeitbasierte Playlist-Berichte finden Sie ein Beispiel.

19. Januar 2024

Die YouTube Analytics (Targeted Queries) API hat einige Aktualisierungen in Bezug auf Kanalplaylists vorgenommen Berichte. Die Aktualisierungen umfassen eine eingestellte Dimension und mehrere neue und aktualisierte Messwerte:

  • Hinweis: Dies ist eine Ankündigung zu eingestellten Funktionen.

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

    Zur Aufrechterhaltung der Abwärtskompatibilität, wenn du das isCurated entfernst Dimension verwenden, müssen Sie auch Ihren Code aktualisieren, um den Messwert playlistViews abzurufen anstelle des Messwerts views nur für Playlist-Berichte. Seit dem views wird für Playlist-Berichte weiterhin unterstützt, auch wenn die API eine andere Bedeutung hat. wenn Sie den Messwertnamen nicht aktualisieren. Natürlich können Sie Ihre Anwendung um sowohl views als auch playlistViews abzurufen und anzuzeigen.

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

    • Standortfilter wie continent und subcontinent sind nicht die in den neuen Channel-Playlist-Berichten unterstützt werden.
    • Die Messwerte redViews und estimatedRedMinutesWatched sind nicht mehr verfügbar die in den neuen Channel-Playlist-Berichten unterstützt werden. Diese Messwerte waren in YouTube Studio nicht verfügbar. Durch diese Änderung werden die API-Funktionen an die Funktionen der Studio-Anwendung angepasst.
    • Die Dimensionen subscribedStatus und youtubeProduct sind nicht mehr verfügbar werden als Filter für Kanal-Playlist-Berichte unterstützt. Diese Filter waren nicht verfügbar in YouTube Studio. Durch diese Änderung werden die API-Funktionen also an die Funktionen angepasst, die in in der Studio-Anwendung.

  • Playlist-Berichte der Dokumentation zu Channelberichten wurde aktualisiert, um Folgende Arten von Messwerten werden in Playlist-Berichten unterstützt:

    • Zusammengefasste Videomesswerte stellen Messwerte zur Nutzeraktivität und zu Impressionen bereit, die für alle Videos im Playlists, die zu diesem Kanal gehören. Zusammengefasste Videomesswerte sind wird nur für API-Anfragen unterstützt, in denen die Dimension isCurated nicht verwendet wird.
    • Messwerte in Playlists Nutzeraktivitäten und -interaktionen im Kontext der Playlist-Seite widerspiegeln. Diese Messwerte Daten einschließen enthält auch Aufrufe von Videos, die dir nicht gehören, aber wenn diese Aufrufe im Zusammenhang mit der Playlist erfolgten.
    • Die unterstützten Playlist-Messwerte enthält die zusammengefassten Video- und Playlist-Messwerte, für Playlist-Berichte unterstützt.

  • Die folgenden neuen In-Playlist-Messwerte werden für Playlist-Berichte für Kanäle unterstützt. Diese Messwerte werden für Rechteinhaberberichte noch nicht unterstützt. Diese Messwerte sind nur unterstützt, wenn in der API-Anfrage zum Abrufen der Berichte nicht das Feld isCurated. Weitere Informationen finden Sie in der metrics-Dokumentation für Definitionen der einzelnen Messwerte:

  • Das Verhalten von views hängt nun davon ab, ob die API-Anfrage, mit der der Playlist-Bericht abgerufen wurde, Dimension „isCurated“:

    • Wenn eine Anfrage die Dimension isCurated enthält, wird der Der Messwert "views" ist eine In-Playlist der angibt, wie oft Videos im Kontext des Playlists des Kanals.
    • Wenn eine Anfrage die Dimension isCurated nicht enthält, wird der Der Messwert „views“ ist ein aggregierter Videomesswert, der die Gesamtzahl angibt wie oft dieses Video in den Playlists des Kanals angesehen wurde, unabhängig davon, ob diese Aufrufe im Zusammenhang mit der Playlist erfolgten. Die Gesamtsumme enthält nur Aufrufe von Videos, die dem Kanal gehören, zu dem die Playlist gehört

      In Berichten, in denen die Dimension isCurated nicht verwendet wird, Der Messwert „playlistViews“ gibt an, wie oft Videos angesehen wurden im Kontext der Playlist. Bei diesem Messwert werden die Aufrufe für alle Videos in der Playlist gezählt, unabhängig davon, welchem Kanal sie gehören.

  • Die Kanalberichte für jeden Playlist-Bericht enthält die Dokumentation nun Tabellen mit unterstützten Messwerten für den jeweiligen Bericht, je nachdem, Gibt an, ob die API-Anfrage die Dimension isCurated enthält. Weitere Informationen finden Sie im Abschnitt zeitbasierte Playlist-Berichte finden Sie ein Beispiel.

4. Dezember 2023

Die YouTube Analytics (Targeted Queries) API wurde aktualisiert und führt nun insightTrafficSourceType Dimensionswerte. Bisher wurde zwischen Videos unterschieden, die als Teil einer Playlist wiedergegeben wurden. (PLAYLIST) und Aufrufe über eine Seite, auf der alle Videos in einer Playlist aufgeführt sind (YT_PLAYLIST_PAGE) Künftig werden beide Arten von Datenansichten dem Dimensionswert „PLAYLIST“.

15. Dezember 2022

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

  • In einem neuen Bericht werden Nutzeraktivitäten nach Stadt angezeigt. Dieser Bericht ist verfügbar für Channels und Rechteinhaber. Dieser Bericht enthält die neuen city verwendet, die die Stadt nach Einschätzung von YouTube angibt, in der die Nutzeraktivität stattgefunden hat.

  • Das neue creatorContentType gibt an, welche Art von YouTube-Content der Nutzeraktivität zugeordnet ist. in die Datenzeile ein. Unterstützte Werte: LIVE_STREAM, SHORTS, STORY und VIDEO_ON_DEMAND.

    Die Dimension creatorContentType wird als optionale Dimension für alle Kanal- und Rechteinhaber-Videoberichten.

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

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

26. August 2022

Die YouTube Analytics (Targeted Queries) API und die YouTube Reporting API (Bulk Reports) einen neuen Detailwert für Besucherquellen unterstützen:

  • Wenn in der YouTube Analytics API (Targeted Queries) API insightTrafficSourceType Dimensionswert SUBSCRIBER ist, dann insightTrafficSourceDetail kann auf podcasts festgelegt werden, was bedeutet, dass der Traffic über den Podcasts-Landingpage.
  • Wenn in der YouTube Reporting API (Bulk Reports) API traffic_source_type Dimensionswert 3 ist, dann traffic_source_detail Wert kann auf podcasts festgelegt werden, was bedeutet, dass der Traffic über den Podcasts-Landingpage.

11. Februar 2022

Die Gruppe der gültigen Werte für die Dimension „gender“ ändert sich am oder nach dem August 11. Oktober 2022. Dies könnte eine nicht abwärtskompatible Änderung in Ihrer API-Implementierung sein. In Übereinstimmung mit den Rückwärts Inkompatible Änderungen der Nutzungsbedingungen für YouTube API-Dienste enthält, wird diese Änderung sechs Monate vor dem Inkrafttreten bekannt gegeben. API-Implementierung aktualisieren vor dem 11. August 2022, um eine nahtlose Umstellung auf die neuen Werte zu ermöglichen.

Es werden folgende Änderungen vorgenommen:

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

9. Februar 2022

Zwei auszuschließende Messwerte wurden aktualisiert Clips-Traffic als Schleife 13. Dezember 2021. Diese Änderung betrifft sowohl die YouTube Analytics (Targeted Queries) API und die YouTube Reporting API (Bulk Reports).

2. Februar 2022

Diese YouTube Reporting API (Bulk Reports) unterstützt einen neuen Dimensionswert für Besucherquellen, mit dem gibt an, dass die Aufrufe aus Live Redirects:

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

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

23. September 2020

Die YouTube Analytics (Targeted Queries) API und die YouTube Reporting API (Bulk Reports) einen neuen Dimensionswert für Besucherquellen unterstützen, der angibt, dass der Nutzer über in der Wiedergabe von YouTube Shorts vertikal wischen:

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

Die Dimension „Details zu Besucherquellen“: 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 (Targeted Queries) API auswirken:

  • Die maximale Größe eines YouTube Analytics-Berichts. Gruppe von 200 auf 500 Elemente erhöht.
  • Die Methode reports.query filters gibt eine Liste von Filtern an, die beim Abrufen von YouTube Analytics angewendet werden sollen. Daten. Mit dem Parameter können mehrere Werte für den Parameter video, playlist, und channel-Filter und die Die maximale Anzahl der IDs, die für diese Filter angegeben werden können, wurde von 200 auf 500 IDs erhöht.

13. Februar 2020

Dieses Update umfasst die folgenden Änderungen in Bezug auf YouTube Analytics (Targeting-Suchanfragen) API und YouTube Reporting (Bulk Reports) API. Weitere Informationen zu diesen Änderungen finden Sie in der YouTube-Hilfe

In beiden APIs ändert sich die Gruppe der möglichen Werte für Details zu Besucherquellen für Benachrichtigungen. Geben Sie unter Gezielte Suchanfragen Folgendes ein: Benachrichtigungen werden als insightTrafficSourceType=NOTIFICATION gemeldet. In Bulk-Berichte Benachrichtigungen werden als traffic_source_type=17 gemeldet.

Mit den neuen Werten werden Benachrichtigungen zu hochgeladenen Videos und Livestreams aufgeteilt. gemeldet als uploaded, in zwei Kategorien:

  • uploaded_push: Aufrufe über Push-Benachrichtigungen, die gesendet wurden an Abonnenten, wenn ein Video hochgeladen wurde
  • uploaded_other: Aufrufe, die aus Nicht-Push-Benachrichtigungen stammen, z. B. E-Mail- oder Posteingang-Benachrichtigungen, die an Abonnenten gesendet werden, wenn ein Video hochgeladen wurde.

Diese Werte werden für den Zeitraum zurückgegeben, der am 13. Januar 2020 (13. Januar 2020) beginnt.

Zur Erinnerung: Diese Werte stellen nicht die Benachrichtigungen selbst dar, sondern den Traffic. die bestimmte YouTube-Aufrufe generiert haben. Wenn in einer Berichtszeile beispielsweise views=3 steht, traffic_source_type=17 (NOTIFICATION) und traffic_source_detail=uploaded_push gibt die Zeile an, dass drei Aufrufe indem Zuschauer auf Push-Benachrichtigungen geklickt haben, die beim Upload des Videos gesendet wurden.

15. Oktober 2019

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

  • Hinweis: Dies ist eine Ankündigung zu eingestellten Funktionen.

    YouTube unterstützt die Dimensionen 7DayTotals und 30DayTotals nicht mehr. Bis zum 15. April 2020 können Sie noch Daten mit diesen Dimensionen abrufen. An oder nach diesem Datum wird beim Abrufen von Berichten mit der Dimension 7DayTotals oder 30DayTotals ein Fehler zurückgegeben.

    Nutzer können einige der Daten für diese Dimensionen reproduzieren, indem sie eine Abfrage mit der Dimension day ausführen und Daten aus Zeiträumen von sieben oder 30 Tagen aggregieren oder ableiten. Beispiel:

    • Die Anzahl der Aufrufe für einen Zeitraum von sieben Tagen kann berechnet werden, indem die Anzahl der Aufrufe von jedem Tag des Zeitraums zusammengefasst wird.
    • Der Prozentsatz der Zuschauer für einen Zeitraum von sieben Tagen kann berechnet werden, indem die Anzahl der täglichen Aufrufe mit dem Prozentsatz der Zuschauer an diesem Tag multipliziert wird, um die Anzahl der Nutzer zu ermitteln, die bei der Wiedergabe des Videos an diesem Tag angemeldet waren. Anschließend kann die Anzahl der angemeldeten Zuschauer für den gesamten Zeitraum hinzugefügt und durch die Gesamtzahl der Aufrufe in diesem Zeitraum geteilt werden, um den Prozentsatz der angemeldeten Zuschauer für den gesamten Zeitraum zu ermitteln.
    • Die Anzahl der einzelnen Zuschauer über einen Zeitraum von sieben Tagen kann nicht berechnet werden, da derselbe Zuschauer an verschiedenen Tagen als einzelner Nutzer berechnet werden kann. Möglicherweise können Sie jedoch die Dimension month anstelle der Dimension 30DayTotals verwenden, um Daten zur Anzahl der einzelnen Betrachter über einen Zeitraum von 30 Tagen zu extrapolieren. Die Dimension month bezieht sich auf Kalendermonate, während die Dimension 30DayTotals 30-Tage-Zeiträume basierend auf dem angegebenen Start- und Enddatum berechnet.

27. Juni 2019

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

  • Da Version 1 der API inzwischen vollständig veraltet ist, wurde die Dokumentation aktualisiert, um Verweise auf diese Version zu entfernen, einschließlich des Einstellungshinweises und des Migrationsleitfadens, in dem das Update auf Version 2 erläutert wird.

1. November 2018

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

17. September 2018

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

  • Im neuen Abschnitt Datenanonymisierung im Übersichtsdokument zum Datenmodell wird erläutert, dass einige YouTube Analytics-Daten begrenzt sind, wenn Messwerte einen bestimmten Grenzwert nicht erreichen. Dies kann in einer Vielzahl von Fällen geschehen. In der Praxis bedeutet dies, dass ein Bericht in folgenden Fällen möglicherweise nicht alle oder nur bestimmte Daten enthält:

    1. die Zugriffe auf ein Video oder einen Kanal innerhalb eines bestimmten Zeitraums begrenzt sind,

      oder

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

    In dem neuen Abschnitt werden auch die Datentypen erläutert, die in YouTube Analytics-Berichten möglicherweise eingeschränkt sind.

  • Die Dokumente Kanalberichte und Berichte zu Rechteinhabern wurden aktualisiert, um der Tatsache Rechnung zu tragen, dass die Messwerte redViews und estimatedRedMinutesWatched für Berichte zu Wiedergabeort, Zugriffsquellen und Gerätetyp/Betriebssystem nicht mehr unterstützt werden.

18. Juni 2018

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

  • Die Anforderungen an den Umfang für die folgenden Methoden haben sich geändert: <ph type="x-smartling-placeholder">
      </ph>
    • 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: <ph type="x-smartling-placeholder">
        </ph>
      • den https://www.googleapis.com/auth/youtube-Bereich
        oder
      • der https://www.googleapis.com/auth/youtube.readonly-Bereich
        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 Lese-/Schreibbereich handelt, während bei der zweiten Option zwei schreibgeschützte Bereiche zum Einsatz kommen.

23. Mai 2018

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

  • Die API-Übersicht enthält einen neuen Abschnitt Aggregierte Messwerte und gelöschte Elemente, in dem erläutert wird, wie API-Antworten Daten verarbeiten, die mit gelöschten Ressourcen verknüpft sind, z. B. Videos, Playlists oder Kanäle.
  • Der Abschnitt Best Practices in der API-Übersicht wurde aktualisiert, um dich daran zu erinnern, dass du mit der YouTube Data API zusätzliche Metadaten für Ressourcen abrufen kannst, die in YouTube Analytics API-Antworten 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 aus dieser API nach 30 Tagen entweder löschen oder aktualisieren.

22. Mai 2018

Dieses Update umfasst die folgenden Änderungen im Zusammenhang mit der YouTube Reporting API (Bulk Reports):

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

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

      Bis zu dieser Ankündigung waren alle API-Berichte ab Erstellung 180 Tage lang verfügbar. Hinweis: Sobald diese Richtlinienänderung in Kraft tritt, können Berichte mit Verlaufsdaten, die älter als 30 Tage sind, nicht mehr über die API aufgerufen werden. Alle anderen Berichte, die älter als 60 Tage sind, sind ebenfalls nicht mehr verfügbar. Daher steht jetzt in der Dokumentation, dass Berichte, die vor der Richtlinienänderung erstellt wurden, bis zu 180 Tage verfügbar sind.

    • Nach der Änderung generiert YouTube bei der Planung eines Berichterstellungsjobs ab diesem Tag Berichte für die 30 Tage vor der Planung des Jobs. Vor der Änderung generiert YouTube beim Planen eines Berichtsauftrags 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 aufgeführt sind. Gemäß den Richtlinien für Entwickler der YouTube API-Dienste (Abschnitte III.E.4.b bis III.E.4.d) müssen API-Clients gespeicherte Ressourcenmetadaten aus dieser API nach 30 Tagen entweder löschen oder aktualisieren.

  • Der Abschnitt Berichtsmerkmale wurde aktualisiert. Obwohl Berichtdaten nicht gefiltert sind, enthalten Berichte mit Daten aus einem Zeitraum ab dem 1. Juni 2018 keine Verweise auf YouTube-Ressourcen, die mindestens 30 Tage vor dem Erstellungsdatum gelöscht wurden.

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

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

26. April 2018

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

  • Die API V2 ist mit der API V1 nahezu identisch. Wahrscheinlich müssen Sie jedoch Ihren Code aktualisieren, damit die unten aufgeführten Änderungen berücksichtigt werden. Alle diese Änderungen werden im neuen Migrationsleitfaden ausführlich erläutert.

    • Die API-Version wurde von v1 in v2 geändert.
    • Die Basis-URL für API-Anfragen wurde von https://www.googleapis.com/youtube/analytics/v1 in https://youtubeanalytics.googleapis.com/v2 geändert.
    • Mehrere Parameter für die Methode reports.query haben aktualisierte Namen. Insbesondere verwenden Parameternamen, die Bindestriche enthalten, wie end-date in der API V1, in der API V2 die Camel-Case-Schreibweise (endDate) anstelle von Bindestrichen. Durch diese Änderung werden Parameternamen im gesamten API einheitlich, da bei den Methoden der API zum Erstellen und Verwalten von Gruppen bereits die Camel-Case-Schreibweise für Parameternamen verwendet wurde.
    • Die API v2 unterstützt keine Batchanfragen, die an den globalen HTTP-Batch-Endpunkt 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 in der API V2 nicht unterstützt:

    • Die Methode reports.query unterstützt die Anfrageparameter alt, quotaUser und userIp nicht mehr.
    • Die Version 2 der API bietet keinen Batch-Endpunkt, der Batches unterstützt, die aus Anfragen an verschiedene APIs bestehen. Ein Batch kann jedoch aus Anfragen an verschiedene Methoden derselben API bestehen. Diese Einstellung gilt nicht speziell für die YouTube Analytics API, da Google den globalen Batch-Endpunkt für alle seine APIs einstellt.
    • Die API v2 unterstützt nicht das JSON-RPC-Protokoll, das in API v1 unterstützt wurde. Diese Einstellung bezieht sich nicht nur auf die YouTube Analytics API.

  • Hinweis: Dies ist eine Ankündigung zu eingestellten Funktionen.

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

21. Februar 2018

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

  • Berichte zur Leistung nach demografischen Merkmalen enthalten Statistiken zu Aufrufen basierend auf Altersgruppe und Geschlecht unterstützt die Dimension „youtubeProduct“ nicht mehr, mit der der YouTube-Dienst identifiziert wird, in 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, mit der das Softwaresystem des Geräts angegeben wird, auf dem Aufrufe erfolgten, unterstützt jetzt den folgenden Wert: <ph type="x-smartling-placeholder">
        </ph>
      • 25: KaiOS

  • YouTube Analytics API (Zielabfragen)

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

20. Dezember 2017

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

  • Der API-Server unterstützt jetzt die gzip-Komprimierung für Anfragen zum Herunterladen von Berichten. Beachten Sie, dass die gzip-Komprimierung für andere Arten von API-Anfragen nicht unterstützt wird. Durch Aktivieren der gzip-Komprimierung wird die für jede API-Antwort benötigte Bandbreite reduziert. Und während Ihre Anwendung zum Dekomprimieren von API-Antworten zusätzliche CPU-Zeit benötigt, überwiegt der Vorteil der geringeren Netzwerkressourcen in der Regel diese Kosten.

    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 des Attributs downloadUrl der Ressource report erläutert.

  • Die Dokumentation der Dimensionen age group und gender wurde korrigiert. Sie enthält jetzt die tatsächlichen Werte, die die API für diese Dimensionen zurückgibt. Dabei handelt es sich um eine Korrektur der Dokumentation, die keine Änderungen der API-Funktionalität oder des API-Verhaltens widerspiegelt. Insbesondere die folgenden Werte haben sich geändert:

    • Die Werte für die Dimension „age_group“ enthalten Großbuchstaben, enthalten Unterstriche zwischen dem Wort „AGE“ und den Ziffern in der Altersgruppe und verwenden Unterstriche anstelle von Bindestrichen. Daher wurden Werte wie age13-17 und age18-24 in AGE_13_17 bzw. AGE_18_24 korrigiert.
    • Die Werte für die Dimension „gender“ enthalten Großbuchstaben. Daher wurden die Werte female, male und gender_other zu 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 unterstützt die API den neuen Messwert estimatedRevenue, der dieselben Daten bereitstellt.

Da der Messwert earnings ein Kernmesswert war, wurde er ab dem Datum der Ankündigung ein Jahr lang unterstützt. Da dieser Zeitraum nun vorbei ist, wird der Messwert earnings jedoch nicht mehr unterstützt. API-Anfragen, die den Messwert earnings angeben, geben daher jetzt den HTTP-Antwortcode 400 zurück. Wenn Sie Ihre App noch nicht so aktualisiert haben, dass der Messwert estimatedRevenue anstelle des Messwerts earnings verwendet wird, tun Sie dies bitte so bald wie möglich.

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

6. Juli 2017

Dieses Update enthält die folgenden Änderungen:

  • YouTube Analytics API (Zielabfragen)

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

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

    • Für die Dimension „adType“ wird jetzt der Wert „reservedBumperInstream“ unterstützt. Dieser Wert bezieht sich auf eine bis zu sechs Sekunden lange, nicht überspringbare Videoanzeige, die vor der Wiedergabe eines Videos abgespielt wird. Das Anzeigenformat ist mit der Anzeige „auctionBumperInstream“ identisch. Dieser Typ bezieht sich jedoch auf Anzeigen, die auf Reservierungsbasis und nicht auf Auktionsbasis verkauft werden.

  • YouTube Reporting API (Bulk-Berichte)

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

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

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

      Diese Berichtstypen wurden am 15. September 2016 eingestellt und sind seit dem 15. Dezember 2016 nicht mehr für diese Berichtstypen verfügbar. Zuvor erstellte Berichte waren noch 180 Tage lang verfügbar. Einige Berichte waren daher 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 ebenfalls nicht benötigt.

24. Mai 2017

Alle Berichtserstellungsjobs 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 veraltet angekündigt und werden nach dem 22. September 2016 nicht mehr für diese Berichtstypen generiert. Zuvor erstellte Berichte waren noch 180 Tage lang verfügbar. Einige Berichte waren daher 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 ebenfalls 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, der zum Teilen von Videos verwendet wurde, unterstützt jetzt die folgenden Werte:

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

      Außerdem wurde der Name, mit dem der Wert 52 identifiziert wird, in der Dokumentation zu Kakao (Kakao Talk) aktualisiert, um ihn deutlicher vom Wert 73 (Kakao Story) zu unterscheiden. Diese Änderung spiegelt keine Änderungen am API-Verhalten oder der Klassifizierung von Videos wider, die mit diesen Diensten geteilt werden.

  • YouTube Analytics API (Zielabfragen)

    • Die Dimension sharingService unterstützt jetzt die folgenden Werte:

      • YOUTUBE_GAMING
      • YOUTUBE_KIDS
      • YOUTUBE_MUSIC
      • YOUTUBE_TV

28. März 2017

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

17. März 2017

Dieses Update enthält die folgenden Änderungen:

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

    • Der Messwert redViews gibt an, wie oft ein Video von YouTube Red-Abonnenten angesehen wurde.
    • Der Messwert estimatedRedMinutesWatched gibt an, wie viele Minuten lang YouTube Red-Abonnenten ein Video angesehen haben.

    In der Dokumentation zu Kanalberichten und Rechteinhabern siehst du jetzt, welche Berichte die beiden neuen Messwerte unterstützen. Sie werden in allen Berichten unterstützt, in denen bereits die Messwerte views und estimatedMinutesWatched 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 jetzt auf den Zeitraum, der um 00:00 Uhr PT beginnt und um 23:59 Uhr endet. Pacific Time (PT) am angegebenen Tag, Monat und Jahr. Je nach Jahreszeit ist UTC-7 oder UTC-8 für die Zeitzone U.S. Pacific erforderlich.

      Obwohl Datumsangaben in der Regel einen 24-Stunden-Zeitraum darstellen, stellen Daten, an denen die Uhr vorwärts gestellt wird, einen 23-Stunden-Zeitraum und Daten, bei denen die Uhr rückwärts gestellt wird, einen 25-Stunden-Zeitraum dar. (Bisher wurde in der Dokumentation angegeben, dass jedes Datum einen eindeutigen 24-Stunden-Zeitraum darstellte und dass die Pacific-Zeit immer UTC-8 war.)

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

    • Die Dimension operating_system, mit der das Softwaresystem des Geräts angegeben wird, auf dem Aufrufe erfolgten, unterstützt jetzt die folgenden Werte: <ph type="x-smartling-placeholder">
        </ph>
      • 22: Tizen
      • 23: Firefox
      • 24: RealMedia

    • Alle Berichtsjobs für den Berichtstyp „content_owner_basic_a1“ wurden gelöscht. Dieser Berichtstyp ist seit dem 19. August 2016 nicht mehr verfügbar. Die zuvor erstellten content_owner_basic_a1-Berichte waren jedoch noch 180 Tage lang verfügbar. Einige Berichte waren daher 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 ebenfalls nicht benötigt.

  • YouTube Analytics API (Zielabfragen)

    • Die Beschreibung der Dimensionen, die sich auf time periods beziehen, wurde korrigiert: Der Dimensionswert bezieht sich jetzt auf den Zeitraum, der um 00:00 Uhr Pacific Time beginnt und um 23:59 Uhr endet. Pacific Time (PT) am angegebenen Tag, Monat und Jahr Je nach Jahreszeit ist UTC-7 oder UTC-8 für die Zeitzone U.S. Pacific erforderlich.

      Obwohl Datumsangaben in der Regel einen 24-Stunden-Zeitraum darstellen, stellen Daten, an denen die Uhr vorwärts gestellt wird, einen 23-Stunden-Zeitraum und Daten, bei denen die Uhr rückwärts gestellt wird, einen 25-Stunden-Zeitraum dar. Früher war in der Dokumentation angegeben, dass die Zeitzone UTC-8 war, 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, um zu beachten, dass Channelberichte derzeit keine Messwerte zu Einnahmen oder Anzeigenleistung enthalten. Aus diesem Grund gewährt der Bereich https://www.googleapis.com/auth/yt-analytics-monetary.readonly derzeit keinen Zugriff auf monetäre Daten in Channelberichten.

    • Die Dimension operatingSystem unterstützt drei neue Dimensionswerte: <ph type="x-smartling-placeholder">
        </ph>
      • FIREFOX
      • REALMEDIA
      • TIZEN

8. Februar 2017

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

Mit dem Parameter kann ein Rechteinhaber angeben, dass eine API-Antwort die Wiedergabezeit- und Aufrufdaten aus dem Zeitraum vor der Verknüpfung der Kanäle mit dem Rechteinhaber. Der Standardparameterwert ist false. Das bedeutet, dass die API-Antwort standardmäßig nur Daten zur Wiedergabezeit und zu Aufrufen ab dem Zeitpunkt enthält, zu 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 dieser Kanal mit dem Rechteinhaber verknüpft wurde.

    Beachte dabei, dass verschiedene Kanäle zu unterschiedlichen Zeitpunkten mit einem Rechteinhaber verknüpft wurden. Wenn über die API-Anfrage Daten für mehrere Kanäle abgerufen werden und der Parameterwert false lautet, enthält die API-Antwort Daten zur Wiedergabezeit und zu Aufrufen basierend auf dem Verknüpfungsdatum des jeweiligen Kanals.
  • Wenn der Parameterwert true lautet, gibt die Antwort die Wiedergabezeit und Aufrufdaten für alle Kanäle zurück, basierend auf dem in der API-Anfrage angegebenen Start- und Enddatum.

15. Dezember 2016

Die folgenden Berichte der YouTube Reporting API werden nicht mehr unterstützt und aus der Dokumentation entfernt. Für jeden Bericht ist eine neuere Version verfügbar. Die Ankündigung der Einstellung dieser Berichte erfolgte am 15. September 2016.

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

11. November 2016

Dieses Update enthält die folgenden Änderungen:

    Die YouTube Reporting API unterstützt drei neue Abspannberichte sowie neue Dimensionen und Messwerte für diese Berichte. Die Berichte enthalten Impressions- und Klickstatistiken für die Abspanne, die nach dem Ende der Wiedergabe eines Videos angezeigt 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 bereits neue Messwerte unterstützt, die sich auf dieselben Daten beziehen. In der folgenden Tabelle sehen Sie den Namen des eingestellten Messwerts und den neuen Namen:

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

    27. Oktober 2016

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

    In der Übersicht über vom System verwaltete Berichte erhalten Sie einen kurzen Überblick über die neuen Berichte und erfahren, wie sie über die API abgerufen werden. Dieser Vorgang unterscheidet sich geringfügig von dem für das Abrufen von Bulk-Berichten für YouTube Analytics, da Partner zum Generieren der Berichte keine Jobs planen müssen.

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

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

    27. September 2016

    Hinweis: Dies ist eine Ankündigung zu eingestellten Funktionen.

    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

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

    19. August 2016

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

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

      Der Bericht content_owner_basic_a1 ersetzt den Bericht content_owner_basic_a2, wie im Überarbeitungsverlaufseintrag vom 19. Mai 2016 erläutert.

    11. August 2016

    Dieses Update enthält die folgenden Änderungen:

    • Die neu veröffentlichten Nutzungsbedingungen für die YouTube API-Dienste („aktualisierte Nutzungsbedingungen“), die ausführlich im YouTube-Blog für Entwickler und Entwickler 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 Begleitdokumente, in denen die Richtlinien erläutert werden, die Entwickler einhalten müssen.

      Die vollständige Liste der neuen Dokumente wird im Überarbeitungsverlauf der aktualisierten Nutzungsbedingungen beschrieben. Darüber hinaus werden zukünftige Änderungen an den aktualisierten Nutzungsbedingungen oder an diesen Begleitdokumenten ebenfalls in diesem Überarbeitungsverlauf erläutert. Sie können über einen Link im Dokument einen RSS-Feed abonnieren, in dem die Änderungen in diesem Überarbeitungsverlauf aufgeführt sind.

    10. August 2016

    Dieses Update enthält die folgenden Änderungen:

    • YouTube Analytics API (Zielabfragen)

      • Hinweis: Dies ist eine Ankündigung zu eingestellten Funktionen.

        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. Die YouTube Analytics API unterstützt jedoch beide Messwertnamen bis zu den in der Tabelle aufgeführten Einstellungsterminen.

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

        Der Messwert earnings war ein Hauptmesswert. Er wird ab dem Datum dieser Bekanntgabe ein Jahr lang unterstützt. Die anderen Messwerte, bei denen es sich nicht um die Hauptmesswerte handelt, werden für drei Monate bis zum 4. November 2016 verfügbar sein.

        Bis zum 4. November 2016 können in einer API-Anfrage beispielsweise der Messwert impressionBasedCpm, der Messwert cpm oder beides angegeben werden. Nach diesem Datum wird jedoch nur noch der Messwert cpm unterstützt.

      • Die Dimension insightTrafficSourceType unterstützt zwei neue Dimensionswerte: <ph type="x-smartling-placeholder">
          </ph>
        • CAMPAIGN_CARD: Diese Zugriffsquelle wird nur für Rechteinhaberberichte unterstützt. Es gibt an, dass die Aufrufe von beanspruchten und von Nutzern hochgeladenen Videos stammten, mit denen der Rechteinhaber die angesehenen Inhalte beworben hat.
        • END_SCREEN: Die Daten beziehen sich auf Aufrufe, die über den Abspann eines anderen Videos erfolgt sind.

        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 der Nutzer weitergeleitet wurde.

      • Für die Dimension „adType“ wird jetzt der Wert „auctionBumperInstream“ unterstützt. Dieser Wert bezieht sich auf eine bis zu sechs Sekunden lange, nicht überspringbare Videoanzeige, die vor der Wiedergabe eines Videos abgespielt wird.

    • YouTube Reporting API (Bulk-Berichte)

      • Die Dimension traffic_source_type unterstützt jetzt die folgenden Werte: <ph type="x-smartling-placeholder">
          </ph>
        • 19: Diese Zugriffsquelle wird nur für Rechteinhaberberichte unterstützt. Es gibt an, dass die Aufrufe von beanspruchten und von Nutzern hochgeladenen Videos stammten, mit denen der Rechteinhaber die angesehenen Inhalte beworben hat.
        • 20: Die Daten beziehen sich auf Aufrufe, die über den Abspann eines anderen Videos erfolgt sind.

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

      • Die Liste der Kernmesswerte der API wurde so korrigiert, dass estimated_partner_revenue als Kernmesswert auflistet und earnings aus dieser Liste entfernt wird. 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. Bumper-Anzeigen sind nicht überspringbare Videoanzeigen mit einer Länge von bis zu 6 Sekunden, die vor der Wiedergabe eines Videos wiedergegeben werden.

    18. Juli 2016

    Dieses Update enthält die folgenden Änderungen:

    • YouTube Analytics API (Zielabfragen)

      • Die Listen der unterstützten Messwerte für die folgenden Kanalberichte wurden aktualisiert und enthalten jetzt Kartenmesswerte. Die Unterstützung für Kartenmesswerte in diesen Berichten wurde am 28. Juni 2016 hinzugefügt. Im Eintrag zum Überarbeitungsverlauf für dieses Datum wird die Änderung ausführlicher erläutert. Die Berichte sind: <ph type="x-smartling-placeholder">
          </ph>
        • Grundlegende Nutzeraktivität für US-Bundesstaaten
        • Nutzeraktivität in US-Bundesstaaten über bestimmte Zeiträume
        • Nutzeraktivität nach Bundesland
        • Nutzeraktivität nach Abostatus
        • Nutzeraktivität nach Abostatus für Provinzen
        • Top-Videos nach Bundesstaat
        • Top-Videos für Zuschauer mit oder ohne Abo

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

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

    • YouTube Reporting API (Bulk-Berichte)

      • In der API-Übersicht wurde der Abschnitt, in dem erklärt wird, wie die Download-URL eines Berichts abgerufen wird, so korrigiert, dass YouTube für Tage, an denen keine Daten verfügbar waren, herunterladbare Berichte erstellt. 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 und weist darauf hin, dass im Bericht 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 von Infokartenmesswerten in zahlreichen Kanal- und Rechteinhaberberichten 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 die API im Allgemeinen, die verbleibenden Änderungen betreffen nur Berichte zu Rechteinhabern:

    • Der Abschnitt Berichtsmerkmale in der API-Übersicht wurde aktualisiert, um klarzustellen, dass Berichte ab dem Zeitpunkt ihrer Erstellung noch 180 Tage über die API verfügbar sind.

      Bisher wurde in der Dokumentation festgelegt, dass Berichte bis zu 180 Tage vor dem Datum der API-Anfrage verfügbar sind. Der ursprüngliche Text war zwar technisch gesehen, aber im besten Fall eher verwirrend.

    • Die API unterstützt neue Versionen von drei Berichten. Zwei dieser Berichte enthalten außerdem 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 mit neuen Versionen wurden umbenannt:

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

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

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

      Wenn du Jobs für einen dieser Berichte hast, solltest du nicht erwarten, dass YouTube nach dem 22. September 2016 neue Berichte für diese Jobs erstellt. Generierte Berichte sind ab Erstellung noch 180 Tage lang verfügbar.

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

    • Die Namen der beiden Messwerte wurden in der Dokumentation korrigiert, damit sie mit den Namen in Berichten übereinstimmen. Dabei handelt es sich lediglich um eine Fehlerbehebung, die keine Änderung am Inhalt des Berichts widerspiegelt:

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

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

    19. Mai 2016

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

    • Die API unterstützt eine neue Version des Berichts zur Nutzeraktivität für Rechteinhaber. Die Berichtstyp-ID für den neuen Bericht 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 content_owner_basic_a1-Berichts haben, müssen Sie trotzdem einen neuen Job für den content_owner_basic_a2-Bericht erstellen. YouTube migriert Rechteinhaber nicht automatisch zur neuen Berichtsversion und erstellt nicht automatisch einen Job zum Generieren der neuen Berichtsversion. In einigen Implementierungen kann das Erscheinungsbild eines neuen, unerwarteten Jobs zu einer nicht abwärtskompatiblen Änderung führen.

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

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

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

        Nachdem ein Berichtstyp als veraltet angekündigt wurde, erstellt YouTube weitere drei Monate lang Berichte dieses Typs. In dieser Aktualisierung vom 19. Mai 2016 wird beispielsweise bekannt gegeben, dass der Bericht „content_owner_basic_a1“ eingestellt wird. Das deprecateTime für diesen Berichtstyp gibt also den 19. August 2016 an, nach dem YouTube keine Berichte dieses Typs mehr erstellt.

      • Das Attribut expireTime der Ressource job 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 über einen längeren Zeitraum nicht heruntergeladen wurden. Das Datum kennzeichnet den Zeitpunkt, nach dem YouTube keine neuen Berichte mehr für den Job erstellt.

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

    • Die Methode jobs.create gibt jetzt einen 400-HTTP-Antwortcode (Bad Request) zurück, wenn Sie versuchen, einen Job für einen eingestellten 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 sich alle nur auf die YouTube Reporting API auswirken:

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

      Historische Berichte werden veröffentlicht, sobald sie verfügbar sind. Es dauert jedoch etwa einen Monat, bis alle historischen Daten für einen Job verfügbar sind. Einen Monat nach der Planung eines Berichterstellungsjobs haben Sie also Zugriff auf Daten für ungefähr sieben Monate. (Alle historischen Daten für Jobs, die vor dieser Bekanntgabe erstellt wurden, sollten innerhalb eines Monats nach der Bekanntgabe veröffentlicht werden.)

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

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

    • Im Abschnitt Berichtsmerkmale in der Übersicht über die YouTube Reporting API wurden folgende Änderungen vorgenommen:

      • Laut der Dokumentation sind Berichte 180 Tage nach ihrer Erstellung verfügbar und können somit von API-Clients heruntergeladen werden. Zuvor wurde in der Dokumentation angegeben, dass Berichte bis zu sechs Monate vor dem Datum der API-Anfrage verfügbar waren.

      • Die Dokumentation wurde aktualisiert, um der Tatsache Rechnung zu tragen, dass die API jetzt für Tage Berichte zum Herunterladen generiert, für die keine Daten verfügbar waren. Diese Berichte enthalten Kopfzeilen, aber keine zusätzlichen Daten.

    • Die YouTube Reporting API unterstützt bald eine Reihe von automatisch generierten, vom System verwalteten Berichten, die Daten zu Werbeeinnahmen oder YouTube Premium-Aboeinnahmen enthalten. Die Berichte stehen Rechteinhabern zur Verfügung, die bereits auf manuell herunterladbare Umsatzberichte in YouTube Studio zugreifen können. Die neue API-Funktion bietet programmatischen Zugriff auf diese Daten.

      Als Vorbereitung auf die Einführung von systemverwalteten Berichten werden derzeit die folgenden API-Änderungen angekündigt:

      • Das neue Attribut systemManaged der Ressource job gibt an, ob sie einen Job beschreibt, der vom System verwaltete Berichte generiert. YouTube erstellt automatisch vom System verwaltete Berichte für YouTube-Rechteinhaber. Die Jobs, durch die diese Berichte erstellt werden, können von Rechteinhabern nicht geändert oder gelöscht werden.

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

      • Der neue Parameter startTimeAtOrAfter der Methode jobs.reports.list gibt an, dass die API-Antwort nur dann Berichte enthalten soll, wenn die frühesten Daten im Bericht am oder nach dem angegebenen Datum liegen. Ebenso gibt der Parameter startTimeBefore an, dass die API-Antwort nur dann 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 Berichtserstellung bezieht, beziehen sich die neuen Parameter auf die Daten im Bericht.

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

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

    28. März 2016

    Die YouTube Reporting API und die YouTube Analytics API geben nun Aufrufstatistiken für verschiedene zusätzliche Freigabedienste zurück.

    • In der YouTube Reporting API unterstützt die Dimension „sharing_service“ die folgenden neuen Werte: <ph type="x-smartling-placeholder">
        </ph>
      • 82: Dialogfeld für iOS-Systemaktivität
      • 83: Google-Posteingang
      • 84: Android Messenger
    • In der YouTube Analytics API unterstützt die Dimension „sharingService“ die folgenden neuen Werte: <ph type="x-smartling-placeholder">
        </ph>
      • ANDROID_MESSENGER: Android Messenger
      • INBOX: Google-Posteingang
      • IOS_SYSTEM_ACTIVITY_DIALOG: Dialogfeld für 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: <ph type="x-smartling-placeholder">
        </ph>
      • 7: Die Daten beziehen sich auf Aufrufe, die auf der YouTube-Startseite oder dem Startbildschirm, im Abofeed des Nutzers oder über eine andere YouTube-Suchfunktion stattgefunden haben.
      • 8: Die Daten beziehen sich auf Aufrufe, die direkt auf der YouTube-Suchergebnisseite erfolgten.
    • In der Dimension „traffic_source_type“ wird jetzt 18 als Dimensionswert unterstützt. Dieser Wert gibt an, dass die Videoaufrufe von einer Seite stammen, auf der alle Videos in einer Playlist aufgeführt sind. Diese Quelle unterscheidet sich vom Quelltyp 14, der angibt, dass die Aufrufe erfolgt sind, während das Video als Teil einer Playlist wiedergegeben wurde.

    YouTube Analytics API

    • Die Dimension insightPlaybackLocationType unterstützt zwei neue Dimensionswerte: <ph type="x-smartling-placeholder">
        </ph>
      • BROWSE: Die Daten beziehen sich auf Aufrufe, die auf der YouTube-Startseite oder dem Startbildschirm, im Abofeed des Nutzers oder über eine andere YouTube-Suchfunktion stattgefunden haben.
      • SEARCH: Die Daten beziehen sich auf Aufrufe, die direkt auf der YouTube-Suchergebnisseite erfolgten.
    • In der Dimension „insightTrafficSourceType“ wird jetzt YT_PLAYLIST_PAGE als Dimensionswert unterstützt. Dieser Wert gibt an, dass die Videoaufrufe von einer Seite stammen, auf der alle Videos in einer Playlist aufgeführt sind. Diese Quelle unterscheidet sich vom Quelltyp PLAYLIST, der angibt, dass die Aufrufe erfolgt sind, während das Video als Teil einer Playlist wiedergegeben wurde.

    8. Februar 2016

    Die Liste der für die YouTube Analytics API unterstützten Messwerte wurde aktualisiert, sodass Kartenmesswerte nicht mehr als unterstützte Messwerte für diese API aufgeführt werden. In keinem der Berichte dieser API wurde nachgewiesen, dass sie einen oder mehrere Kartenmesswerte unterstützen.

    Du kannst Kartenmesswerte weiterhin über die YouTube Reporting API abrufen, die diese Messwerte für zahlreiche Kanalberichte und Rechteinhaber unterstützt.

    6. Januar 2016

    Die YouTube Reporting API und die YouTube Analytics API erkennen 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. Zuvor waren die Namen als clickable_annotation_impressions und closable_annotation_impressions dokumentiert.

    18. Dezember 2015

    Die Gesetze der Europäischen Union (EU) schreiben vor, dass Endnutzern in der EU bestimmte Informationen offengelegt und ihre Einwilligungen eingeholt werden müssen. Für Endnutzer in der Europäischen Union müssen Sie daher die Richtlinie zur Einwilligung der Nutzer in der EU einhalten. Diese Anforderung wurde den Nutzungsbedingungen für die YouTube API hinzugefügt.

    15. Dezember 2015

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

    • 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 mit Zuschauern verknüpft sind, die den Kanal des Videos oder der Playlist abonniert haben.
      • youtubeProduct: Diese Dimension gibt die YouTube-Property an, in 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 verfügbar sind. Viele andere Berichte wurden außerdem 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. Jetzt können Sie leichter gültige Kombinationen von Dimensionen, Messwerten und Filtern ermitteln, mit denen sich die einzelnen Berichte abrufen lassen. In der Tabelle unten wird der „Gerätetyp“ erläutert. für Channels wird das neue Format angezeigt:

      Inhalt
      Abmessungen:
      Erforderlich deviceType
      Verwenden Sie 0 oder mehr day, liveOrOnDemand, subscribedStatus, youtubeProduct
      Messwerte:
      Verwenden Sie mindestens einen Aufrufe, estimatedMinutesWatched
      Filter:
      0 oder 1 verwenden Land, Provinz, Kontinent, subContinent
      0 oder 1 verwenden Video, Gruppe
      Verwenden Sie 0 oder mehr operatingSystem, liveOrOnDemand, subscribedStatus, youtubeProduct.

      Die Terminologie, in der erforderliche und optionale Felder beschrieben werden, wird in der Dokumentation zu Kanalberichten und Rechteinhabern-Berichten 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 nicht auf Daten für mindestens eines der angegebenen Elemente zugreifen konnte.

      Angenommen, ein Nutzer sendet eine API-Anfrage, in der der video-Filter 20 Video-IDs auflistet. Der Nutzer ist Inhaber von 18 Videos. Eine Video-ID identifiziert jedoch ein Video, das einem anderen Kanal gehört, und eine andere ID identifiziert ein Video, das gelöscht wurde und daher nicht mehr existiert. Anstatt einen Fehler zurückzugeben, löscht der API-Server jetzt die beiden Videos, auf die der Nutzer nicht zugreifen kann, und die API-Antwort enthält Daten für die 18 Videos, die dem API-Nutzer gehören.

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

    • Die Methode groupItems.insert der YouTube Analytics API gibt jetzt einen nicht autorisierten Fehler (403-HTTP-Antwortcode) zurück, wenn du versuchst, eine Entität zu einer Gruppe hinzuzufügen, aber keinen Zugriff auf diese Entität hast. Bisher hätte die API es Ihnen ermöglicht, die Entität zur Gruppe hinzuzufügen. Später wurde jedoch beim Versuch, Berichtsdaten für diese Gruppe abzurufen, ein nicht autorisierter Fehler zurückgegeben.

    • Die Methode groups.list der YouTube Analytics API unterstützt jetzt den Seitenumbruch. 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 die Daten auf den 24-Stunden-Zeitraum beginnend um 00:00 Uhr Pacific Time (UTC-8) verweisen. Zuvor war in der Dokumentation angegeben, dass das Datum um 00:00 Uhr (GMT) begann.

      Darüber hinaus wurde die Dokumentation zur YouTube Analytics API aktualisiert. Dabei wurde berücksichtigt, dass sich alle datumsbezogenen Dimensionen (day, 7DayTotals, 30DayTotals und month) auf Daten ab 00:00 Uhr Pacific Time (UTC-8) beziehen.

    • Die Methode jobs.reports.list() der YouTube Reporting API unterstützt jetzt den Abfrageparameter createdAfter. Wenn dieser Parameter angegeben wird, gibt er an, dass die API-Antwort nur Berichte auflisten soll, die nach dem angegebenen Datum und der angegebenen Uhrzeit erstellt wurden, einschließlich neuer Berichte mit Daten, die auf einem Backfill beruhen. Beachten Sie, dass sich der Parameterwert auf den Erstellungszeitpunkt des Berichts bezieht, nicht auf die den zurückgegebenen Daten zugeordneten Datumsangaben.

      Der Parameterwert ist ein Zeitstempel in RFC3339 UTC "Zulu" bis auf Mikrosekunden genau. Beispiel: "2015-10-02T15:01:23.045678Z".

      Außerdem wurden die Best Practices für die YouTube Reporting API aktualisiert. Sie enthalten nun Informationen dazu, wie Sie mit dem Parameter createdAfter die wiederholte Verarbeitung desselben Berichts vermeiden können.

    • Die Definitionen des Attributs createTime der Ressource job und der Attribute startTime, endTime und createTime der Ressource report wurden so korrigiert, dass die Attributwerte auf Mikrosekunden und nicht auf Nanosekunden genau sind. Außerdem geben alle Definitionen nun genau 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 jetzt eine Liste der möglichen Dimensionswerte. Die Liste enthält eine Reihe neu unterstützter Dienste.

      Die Definition der Dimension „sharing_service“ der YouTube Reporting API wurde ebenfalls aktualisiert und enthält jetzt die neuen unterstützten Werte. Die neuen Enum-Werte, die größer als 59 sind, sind die neuen in der Liste.

    24. September 2015

    Dieses Update enthält die folgenden Änderungen:

    • Über die neue YouTube Reporting API können Bulk-Datenberichte abgerufen werden, 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 die 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 ebenfalls Messwerte und Dimensionen verwendet. In einem Bericht enthält jede Datenzeile eine eindeutige Kombination von Dimensionswerten. Sie können Daten zeilenübergreifend basierend auf Dimensionswerten aggregieren, um Messwerte für einzelne Videos, Länder, Livevideos, abonnierte Nutzer usw. zu berechnen.

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

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

      • Der Tab Leitfäden in der Dokumentation enthält Informationen, die für beide APIs gelten, einschließlich Anleitungen zum Autorisieren von API-Anfragen.
      • Der Tab Bulk-Berichte enthält die Referenzdokumentation und andere Inhalte speziell für die YouTube Reporting API.
      • Der Tab Zielabfragen enthält die Referenzdokumentation und andere Inhalte speziell für die YouTube Analytics API.
      • Auf dem Tab Beispiele finden Sie Codebeispiele, die für die beiden APIs verfügbar sind.
      • Auf dem Tab Tools finden Sie zusätzliche Ressourcen, die Entwickler bei der Implementierung der beiden APIs unterstützen.

    20. August 2015

    Dieses Update enthält die folgenden Änderungen:

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

      • Die Dokumentation enthält jetzt eine Seite, auf der alle verfügbaren Kanalberichte aufgelistet sind, und eine weitere, auf der alle verfügbaren Rechteinhaberberichte aufgelistet sind. Bisher enthielt die Dokumentation separate Seiten für Kanalvideoberichte, Kanalplaylist-Berichte usw.

      • Die neue Übersicht über das Datenmodell soll eine verständlichere Einführung in die Funktionsweise der API bieten. In diesem Dokument geht es insbesondere darum, wie YouTube Messwerte, Dimensionen und Filter zur Berechnung von Berichtswerten 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 die Informationen, die Sie zum Abrufen eines Berichts benötigen, leichter identifizieren können.

    22. Juli 2015

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

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

      Außerdem wurde die Definition des Messwerts „earnings“ korrigiert, um der Tatsache Rechnung zu tragen, dass sein Wert die geschätzten Gesamteinnahmen aus allen von Google verkauften Werbequellen sowie aus nicht werbebezogenen Quellen umfasst. Bisher wurde in der Definition fälschlicherweise angegeben, dass der Messwert nur Einnahmen aus Anzeigenquellen umfasste.

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

    • Zusätzlich zum eingestellten Messwert primaryAdGrossRevenue werden in den Berichten zur Anzeigenleistung die Messwerte monetizedPlaybacks und playbackBasedCpm nicht mehr unterstützt. Einige Videoberichte unterstützen diese Messwerte jedoch noch.

    1. Juni 2015

    Dieses Update enthält die folgenden Änderungen:

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

      • videosAddedToPlaylists: Gibt an, wie oft Videos im Umfang der Abfrage YouTube-Playlists hinzugefügt wurden. Es ist möglich, dass die Videos zur Playlist des Rechteinhabers oder zur Playlist eines anderen Kanals hinzugefügt wurden. Playlists.
      • videosRemovedFromPlaylists: Gibt an, wie oft Videos im Umfang der Suchanfrage aus YouTube-Playlists entfernt wurden. Es ist möglich, dass die Videos aus der Playlist des Videoinhabers oder von den Inhalten anderer Kanäle entfernt wurden. Playlists.

      Beide Messwerte enthalten Standard-Playlists wie „Später ansehen“ . Es werden jedoch keine Playlists gezählt, denen ein Video automatisch hinzugefügt wird, z. B. die Upload-Playlist eines Kanals oder der Wiedergabeverlauf eines Nutzers. Diese Messwerte spiegeln die absolute Anzahl der Hinzufügungen und Löschungen wider. Wenn also ein Nutzer ein Video zu einer Playlist hinzufügt, es dann und noch einmal hinzufügt, geben die Messwerte an, dass das Video zwei Playlists hinzugefügt und aus einer entfernt wurde.

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

    31. März 2015

    Dieses Update enthält die folgenden Änderungen:

    • Die Messwerte „favoritesAdded“ und „favoritesRemoved“ sind ab dieser Bekanntgabe nicht mehr verfügbar. Dabei handelt es sich sowohl um Kernmesswerte als auch um die Richtlinie zur Einstellung von Produkten und Diensten, die in den Nutzungsbedingungen dargelegt sind.

    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. Bei den zurückgegebenen Werten handelt es sich um Schätzungen, die unter Verwendung täglich wechselnder Wechselkurse berechnet wurden.

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

    25. Februar 2015

    Dieses Update enthält die folgenden Änderungen:

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

      • Gruppen erstellen und verwalten

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

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

        Sie können also beispielsweise eine Gruppe mit der Methode groups.insert erstellen und dieser Gruppe dann Elemente mit der Methode groupItems.insert 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 Kanalberichte und Rechteinhaberberichte verwendet werden kann. Wenn Sie den Filter group verwenden, gibt die API Daten für alle Elemente in dieser Gruppe zurück. Hinweis: In der API können derzeit keine Berichte für Asset-Gruppen erstellt werden.

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

    13. Februar 2015

    Dieses Update enthält die folgenden Änderungen:

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

    28. August 2014

    Dieses Update enthält die folgenden Änderungen:

    • 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 Parameterwert filters auf eine durch Kommas getrennte Liste der IDs von Videos, Playlists, Kanälen oder Serien, nach denen die API-Antwort gefiltert werden soll. Der Parameterwert kann bis zu 200 IDs angeben.

      Wenn Sie mehrere Werte für denselben Filter angeben, können Sie diesen Filter auch der Liste der Dimensionen hinzufügen, die Sie für die Anfrage angeben. Dies gilt auch dann, wenn der Filter nicht als unterstützte Dimension für einen bestimmten Bericht 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 filters-Parameterdefinition.

    16. Juli 2014

    Dieses Update enthält die folgenden Änderungen:

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

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

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

      Außerdem werden in allen Playlist-Berichten die folgenden neuen Messwerte unterstützt: Jeder dieser Messwerte bezieht sich nur auf Playlist-Aufrufe, die im Web erfolgt sind.

      • playlistStarts: Gibt an, wie oft die Wiedergabe einer Playlist von Zuschauern gestartet wurde.
      • viewsPerPlaylistStart: Die durchschnittliche Anzahl an Videoaufrufen, die pro Aufruf einer Playlist erzielt wurden.
      • averageTimeInPlaylist: Die geschätzte durchschnittliche Zeit in Minuten, die ein Zuschauer Videos in einer Playlist angesehen hat, nachdem die Playlist gestartet wurde.

      Jede Anfrage zum Abrufen eines Playlist-Berichts muss den Filter isCurated verwenden, der auf 1 (isCurated==1) gesetzt sein muss.

    • Die API unterstützt jetzt einen Bericht zur Zuschauerbindung. Mit diesem Bericht wird gemessen, inwieweit ein Video Zuschauer binden kann. Mit der neuen Dimension elapsedVideoTimeRatio des Berichts wird die Wiedergabedauer des Videos für die entsprechenden Messwerte gemessen:

      • 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.

        Beachte, dass ein Teil eines Videos mehrmals oder gar nicht in einem bestimmten Videoaufruf angesehen werden kann. Wenn Nutzer beispielsweise zurückspulen und denselben Teil eines Videos mehrmals ansehen, kann das absolute Seitenverhältnis für diesen Teil des Videos größer als 1 sein.

      • Der Messwert „relativeRetentionPerformance“ gibt an, wie gut die Zuschauerbindung eines Videos während der Wiedergabe im Vergleich zu allen YouTube-Videos ähnlicher Länge ist. Ein Wert von 0 bedeutet, dass das Video die Zuschauer schlechter fesselt als mit jedem anderen Video ähnlicher Länge. Ein Wert von 1 bedeutet, dass das Video die Zuschauer besser an sich bindet als jedes andere Video ähnlicher Länge. Ein Medianwert von 0,5 bedeutet, dass die Hälfte der Videos ähnlicher Länge Zuschauer besser und die Hälfte der Videos weniger Zuschauer an sich bindet.

      Sie können auch den audienceType-Filter verwenden, damit der Bericht nur Daten zurückgibt, die mit organischen Aufrufen, Aufrufen von TrueView In-Stream-Anzeigen oder Aufrufen von TrueView In-Display-Anzeigen verknüpft sind. (Organische Aufrufe sind direkte Ergebnisse 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 zuvor die Messwerte annotationClickThroughRate und annotationCloseRate unterstützt wurden.

      Alle neuen Messwerte sind Kernmesswerte und unterliegen der Richtlinie zur Einstellung von Produkten und Diensten. Daten für die neuen Messwerte stehen jedoch seit dem 16. Juli 2013 zur Verfügung. Daten für die Messwerte 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 von Google-Suchergebnissen jetzt dem Besucherquellentyp „EXT_URL“ zugeordnet. Daher ist es auch nicht mehr möglich, einen insightTrafficSourceDetail-Bericht abzurufen, in dem der Filter insightTrafficSourceType auf GOOGLE_SEARCH gesetzt ist.

    31. Januar 2014

    Dieses Update enthält die folgenden Änderungen:

    16. Januar 2014

    Dieses Update enthält die folgenden Änderungen:

    • Das Dokument Beispielanfragen wurde neu gestaltet, um Beispiele in Kategorien zu gruppieren. Dabei wird ein Tabformat verwendet, das dem kürzlich veröffentlichten Kanal- und Rechteinhaberbericht ähnelt. Beim neuen Design werden die Beispiele in die folgenden Kategorien unterteilt:

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

    • Das Dokument Beispielanfragen enthält jetzt neue Beispiele für den Abruf provinzspezifische Daten in Kanal- oder Rechteinhaberberichten.

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

      • Demografische Merkmale der Zuschauer in Kalifornien (Altersgruppe und Geschlecht): Dieser Bericht enthält Statistiken zur Altersgruppe und zum Geschlecht von Zuschauern in Kalifornien, die Videos eines Kanals angesehen haben, oder im Fall von Rechteinhaberberichten die Inhalte eines Rechteinhabers, auf die Anspruch erhoben wurde. In diesem Beispiel wird der Parameter filters verwendet, damit die Antwort nur Daten für eine bestimmte Provinz enthält.

    • Die Definition der Dimension province wurde aktualisiert. Wenn province im Parameterwert dimensions enthalten ist, muss die Anfrage außerdem Daten auf die USA beschränken, indem country==US in den Parameterwert filters aufgenommen wird.

    6. Januar 2014

    Dieses Update enthält die folgenden Änderungen:

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

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

      In jedem Dokument werden diese Kategorien in Form einer Liste von Tabs angezeigt. Wenn Sie auf einen beliebigen Tab klicken, sehen Sie die unterstützten Berichte in dieser Kategorie.

    • 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 Distrikt 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 mit den wichtigsten Statistiken umfasst verschiedene Statistiken, einschließlich der Anzahl der Aufrufe und der geschätzten Wiedergabezeit in Minuten.
          • Der zeitbasierte Bericht liefert die gleichen Statistiken, sammelt jedoch Daten für einen Tag, sieben Tage, 30 Tage oder einen Monat.

        • Mit dem Abfrageparameter filters können Sie einen Bericht auf Statistiken für einen bestimmten Bundesstaat beschränken. Diese Art der Filterung wird von verschiedenen Berichten unterstützt, darunter Berichte nach Standort, zu Wiedergabeorten, zu Zugriffsquellen, zu Geräten, zu Betriebssystemen, zu demografischen Merkmalen und zu den beliebtesten Videos.

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

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

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

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

    30. September 2013

    Dieses Update enthält die folgenden Änderungen:

    • Die YouTube Analytics API unterliegt jetzt der Richtlinie zur Einstellung von Produkten und Diensten, die in den Nutzungsbedingungen beschrieben wird. Die nicht grundlegenden Dimensionen und Messwerte der API unterliegen jedoch nicht der Richtlinie zur Einstellung von Produkten und Diensten. Auf den Seiten Dimensionen und Messwerte werden jetzt Kerndimensionen und -messwerte aufgeführt. Außerdem wurden die Definitionen auf diesen Seiten aktualisiert, um Kerndimensionen und -messwerte explizit zu kennzeichnen.

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

      Mit diesem Update werden Wiedergaben auf Mobilgeräten jetzt je nach Art der App, in der sie erfolgen, entweder als WATCH-, EMBEDDED- oder EXTERNAL_APP-Wiedergaben klassifiziert.

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

    16. Juli 2013

    Dieses Update enthält die folgenden Änderungen:

    • Die API unterstützt jetzt die Möglichkeit, Berichte nach mehreren Dimensionen und Messwerten zu sortieren. Das Dokument zu Beispielanfragen enthält ein neues Beispiel, das diese Funktion veranschaulicht: Anfragen nach mehreren Dimensionen/Messwerten sortieren. Mit der Anfrage werden Daten zu Besucherquellen abgerufen. Der sort-Parameterwert ist day,-views. Die Ergebnisse sind chronologisch sortiert. Innerhalb der Ergebnismenge für jeden Tag enthält die erste Zeile jedoch Daten für die Besucherquelle, die die meisten Aufrufe generiert hat, die zweite Zeile enthält Daten für die Quelle, die die nächsthöhere Anzahl an Aufrufen generiert hat usw.

    • Die API unterstützt jetzt zwei neue Dimensionen: deviceType und operatingSystem, mit denen Daten zu den Geräten abgerufen werden können, auf denen sich Nutzer 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. Sie können auch den Filter operatingSystem verwenden, um den Bericht zu Gerätetypen auf Statistiken für Geräte mit einem bestimmten Betriebssystem wie Android oder iOS zu beschränken.

      • Mit dem Bericht „operatingSystem“ kannst du die Anzahl der Aufrufe und die geschätzte Wiedergabezeit für verschiedene Betriebssysteme wie Android, iOS oder Linux abrufen. Sie können auch den Filter deviceType verwenden, um den Betriebssystembericht auf Statistiken für einen bestimmten Gerätetyp wie Mobilgeräte oder Tablets zu beschränken.

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

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

    • Die Dimension „insightPlaybackLocationType“ gibt möglicherweise den Wert YT_OTHER zurück. Damit werden Aufrufe identifiziert, die nicht mit einem der anderen Werte der Dimension klassifiziert sind.

    23. Mai 2013

    Dieses Update enthält die folgenden Änderungen:

    • Das Dokument mit den Berichten für Rechteinhaber wurde aktualisiert, um zu verdeutlichen, dass du den Bericht zu den erfolgreichsten Videos in absteigender Reihenfolge der Einnahmen sortieren kannst, um die Videos mit den höchsten Einnahmen zu ermitteln. Dieser Bericht ist der erste Bericht, der in der zweiten Tabelle im Abschnitt Berichte zur Nutzeraktivität und Abrechnung aufgeführt wird.

    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 – zusammen mit anderen Messwerten wie Aufrufmesswerten, Interaktionsmesswerten, Einnahmenmesswerten und Anzeigenleistungsmesswerten abzurufen.

      Die Listen der verfügbaren Kanalberichte und Rechteinhaberberichte wurden entsprechend aktualisiert. Die Listen sind jetzt kürzer, da die Wiedergabezeitmesswerte im Rahmen anderer aufgelisteter 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 wie folgt optimiert:

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

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

        • Details zum Wiedergabeort

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

        • Details zur 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 Berichtstypen mithilfe von YouTube Analytics API abgerufen werden. Jedes Beispiel enthält eine kurze Beschreibung des Berichts, den die Anfrage abruft. Anschließend werden die Dimensionen, Messwerte, Filter und Sortierparameter für die Anfrage angezeigt.

    • Die Dimension „insightTrafficSourceType“ unterstützt jetzt SUBSCRIBER als gültigen Wert. Dieser Wert gibt Videoaufrufe an, die über Feeds auf der YouTube-Startseite oder über YouTube-Abofunktionen weitergeleitet wurden. Wenn du nach dieser Besucherquelle filterst, gibt das Feld insightTrafficSourceDetail den Startseitenfeed oder eine andere Seite an, von der Aufrufe stammen.

    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. Auf die Messwerte und Berichte können nur YouTube-Contentpartner zugreifen, die am YouTube-Partnerprogramm teilnehmen.

      • Die neu unterstützten Berichte unterstützen sowohl wiedergabebasierte Messwerte zur Anzeigenleistung als auch impressionsbasierte Messwerte zur Anzeigenleistung. Weitere Informationen über Berichte zur Anzeigenleistung findest du in der Dokumentation zu Berichten zu Rechteinhabern.

      • Die neu unterstützten Messwerte sind unten aufgeführt. In der Liste der Rechteinhaberberichte werden jetzt die Berichte aufgeführt, 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: Der geschätzte Bruttoumsatz von Google- oder DoubleClick-Partnern, summiert und unter dem primären Anzeigentyp für die im Bericht abgedeckten Videowiedergaben.
        • monetizedPlaybacks: Die Anzahl der Wiedergaben, bei denen mindestens eine Anzeigenimpression erzielt wurde.
        • playbackBasedCpm: Die geschätzten Bruttoeinnahmen pro 1.000 Wiedergaben.
        • impressions: Die Anzahl der bestätigten Anzeigenimpressionen, die erzielt wurden.
        • impressionBasedCpm: geschätzte Bruttoeinnahmen pro 1.000 Anzeigenimpressionen.

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

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

    • Die API-Dokumentation wurde neu strukturiert, sodass die verschiedenen Berichtstypen auf separaten Seiten erläutert werden. Deshalb gibt es jetzt separate Seiten, auf denen die verschiedenen Arten von Kanalberichten und Rechteinhabern erläutert werden.

    4. Februar 2013

    Dieses Update enthält die folgenden Änderungen:

    • Das Referenzhandbuch der API enthält jetzt einen Abschnitt Beispiele mit Codebeispielen, die zeigen, wie die API mit den Java-, JavaScript-, Python- und Ruby-Clientbibliotheken aufgerufen wird. Das JavaScript-Codebeispiel ist identisch mit dem, das ausführlich in der Dokumentation zur Beispielanwendung erläutert wird.

    14. November 2012

    Dieses Update enthält die folgenden Änderungen:

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

    • 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 Rechteinhaberbericht verfügbar. Die Seiten Dimensionen und Messwerte wurden ebenfalls entsprechend aktualisiert.

      • Der Bericht zu Wiedergabeorten gibt die Anzahl der Videoaufrufe auf verschiedenen Arten von Seiten oder Apps an.

      • Der Detailbericht zum Wiedergabeort gibt die eingebetteten Player an, die die meisten Aufrufe für ein bestimmtes Video generiert haben. Dieser Bericht liefert eine detailliertere Ansicht als der Bericht zum Wiedergabeort, da die URLs mit den Top-eingebetteten Playern ermittelt werden.

      • Der Bericht zu Zugriffsquellen gibt die Anzahl der Videoaufrufe an, die auf verschiedene Arten von Verweis-URLs zurückzuführen sind.

      • Der Detailbericht zu Zugriffsquellen gibt an, über welche Verweis-URLs ein bestimmtes Video und ein bestimmter Zugriffsquellentyp die meisten Aufrufe generiert haben. In diesem Bericht findest du beispielsweise die ähnlichen Videos, über die ein bestimmtes Video die meisten Zugriffe erzielt hat. Dieser Bericht wird für verschiedene Besucherquellen unterstützt.

      • Berichte zur Wiedergabezeit geben Aufschluss darüber, wie lange Zuschauer deine Inhalte angesehen haben. In den Berichten können Daten für einen bestimmten Zeitraum (Tag, vorherige 7 Tage, 30 Tage usw.) oder für ein bestimmtes Land zusammengefasst werden. Wenn in einem Bericht Daten nach Tag oder Land aggregiert werden, können auch die durchschnittliche Länge der einzelnen Videoaufrufe sowie der durchschnittliche Prozentsatz der einzelnen Videos angegeben werden, die sich Nutzer angesehen haben.

    2. Oktober 2012

    Dieses Update enthält die folgenden Änderungen:

    • YouTube Analytics API ist jetzt für alle Entwickler verfügbar. Sie können die API für Ihr Projekt aktivieren, ohne zuerst den Zugriff über das Steuerfeld Dienste im APIs console anfordern zu müssen.

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

    12. September 2012

    Dieses Update enthält die folgenden Änderungen:

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

    • Im Abschnitt Zeitliche Dimensionen wurde erläutert, dass diese Dimensionen angeben, dass in einem Analytics-Bericht Daten basierend auf einem bestimmten Zeitraum zusammengefasst werden sollen. Die API unterstützt jetzt die folgenden zusätzlichen zeitlichen Dimensionen:

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

      Der Abschnitt Verfügbare Berichte wurde entsprechend aktualisiert, damit die API-Unterstützung für Berichte mit diesen Dimensionen unterstützt.

    • Der Abschnitt Dimensionen für Berichtentitäten wurde aktualisiert. Bei API-Anfragen zum Abrufen von Rechteinhaberberichten müssen Daten 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 beliebtesten Videos. Diese Berichte, die als Kanal- oder Rechteinhaberberichte verfügbar sind, enthalten Messwerte (Aufrufe, Kommentare, „Mag ich“-Bewertungen usw.) für einzelne Länder 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 abbestellt haben.

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