Auf dieser Seite findest du Informationen zu API-Änderungen und Aktualisierungen der Dokumentation für die YouTube Reporting API und die YouTube Analytics API. Beide APIs ermöglichen es Entwicklern, auf YouTube Analytics-Daten zuzugreifen, allerdings auf unterschiedliche Weise. Änderungsprotokoll abonnieren
6. Mai 2024
Die YouTube Analytics API (Gezielte Anfragen) unterstützt drei neue Berichte für Kanäle:
-
Der Bericht Nutzeraktivität nach DMA ist ein Bericht nach Standort, der Statistiken zur Nutzeraktivität nach DMA (Designated Market Area) enthält. Für diesen Bericht müssen Sie den Parameterwert
filters
aufcountry==US
setzen. -
Der Bericht Gleichzeitige Zuschauer gibt Aufschluss über die Anzahl gleichzeitiger Zuschauer für verschiedene Abschnitte eines Livestreams.
-
Der Bericht Kündigungen von Mitgliedern enthält Statistiken dazu, warum Nutzer ihre Kanalmitgliedschaft gekündigt haben.
Für diesen Bericht wird die neue Dimension
membershipsCancellationSurveyReason
verwendet, die angibt, warum ein Nutzer eine Kanalmitgliedschaft gekündigt hat. Außerdem wird der neue MesswertmembershipsCancellationSurveyResponses
verwendet, der angibt, wie viele Kanalmitgliedschaften aus diesem Grund gekündigt wurden.
Der Bericht Zuschauerbindung wurde so optimiert, dass er jetzt drei neue Messwerte unterstützt:
7. April 2024
Die YouTube Analytics API (Gezielte Anfragen) hat mehrere Aktualisierungen zu Playlist-Berichten von Rechteinhabern. Die Änderungen sind dieselben wie die am 19. Januar 2024 angekündigten Berichte zu Kanalplaylists.
Der folgende Überarbeitungsverlaufseintrag enthält fast dieselben Informationen wie der Eintrag vom 19. Januar 2024. In Berichten zu Rechteinhaber-Playlists wird die Dimension isCurated
allerdings noch bis zum 31. Dezember 2024 unterstützt, in Berichten zu Kanalplaylists hingegen noch bis zum 30. Juni 2024.
-
Hinweis: Diese Mitteilung wird eingestellt.
Die Dimension „
isCurated
“ wurde für Berichte zu Playlists von Rechteinhabern eingestellt. Sie wird ab dem 31. Dezember 2024 nicht mehr unterstützt. Die Definition dieser Dimension wurde entsprechend aktualisiert.Damit die Abwärtskompatibilität erhalten bleibt, musst du beim Entfernen der Dimension
isCurated
auch deinen Code so aktualisieren, dass der MesswertplaylistViews
statt des Messwertsviews
nur für Playlist-Berichte abgerufen wird. Da der Messwertviews
in Playlist-Berichten weiterhin unterstützt wird, wenn auch mit einer anderen Bedeutung, gibt die API auch dann Daten zurück, wenn du den Messwertnamen nicht aktualisierst. Natürlich können Sie Ihre Anwendung so ändern, dass sowohlviews
als auchplaylistViews
abgerufen und angezeigt werden.Neben der Dimension
isCurated
werden in den neuen Berichten folgende API-Funktionen nicht mehr unterstützt:- Standortfilter wie
continent
undsubcontinent
werden für die neuen Berichte zu Kanalplaylists nicht unterstützt. - Die Messwerte
redViews
undestimatedRedMinutesWatched
werden für die neuen Berichte zu Kanalplaylists nicht mehr unterstützt. Diese Messwerte waren in YouTube Studio noch nicht verfügbar. Durch diese Änderung wird die API-Funktionalität an die in der Studio App angepasst. - Die Dimensionen
subscribedStatus
undyoutubeProduct
werden in Berichten zu Channelplaylists nicht mehr als Filter unterstützt. Diese Filter waren bisher noch nicht in YouTube Studio verfügbar. Durch diese Änderung wird die API-Funktionalität an die in der Studio App angepasst.
- Standortfilter wie
-
Der Abschnitt Playlist-Berichte in der Dokumentation zu Rechteinhaberberichten wurde aktualisiert und enthält nun detailliertere Erläuterungen zu den Messwerttypen, die für Playlist-Berichte unterstützt werden:
- Zusammengefasste Videomesswerte liefern Messwerte zu Nutzeraktivitäten und Impressionen, die für alle Videos in den Playlists des Rechteinhabers zusammengefasst werden, die ebenfalls diesem Rechteinhaber gehören. Aggregierte Videomesswerte werden nur für API-Anfragen ohne die Dimension
isCurated
unterstützt. - Messwerte innerhalb der Playlist spiegeln Nutzeraktivität und -interaktionen im Kontext der Playlist-Seite wider. Diese Messwerte umfassen auch Aufrufe von Videos ohne eigene Eigentumsrechte in der Playlist, aber nur, wenn diese Aufrufe im Kontext der Playlist erfolgt sind.
- Im Abschnitt Unterstützte Playlist-Messwerte findest du die zusammengefassten Messwerte für Videos und Playlists, die in Playlist-Berichten unterstützt werden.
- Zusammengefasste Videomesswerte liefern Messwerte zu Nutzeraktivitäten und Impressionen, die für alle Videos in den Playlists des Rechteinhabers zusammengefasst werden, die ebenfalls diesem Rechteinhaber gehören. Aggregierte Videomesswerte werden nur für API-Anfragen ohne die Dimension
-
Die folgenden neuen In-Playlist-Messwerte werden für Playlist-Berichte für Rechteinhaber unterstützt. Diese Messwerte werden nur unterstützt, wenn in der API-Anfrage zum Abrufen der Berichte die Dimension
isCurated
nicht verwendet wird. Definitionen der einzelnen Messwerte finden Sie in der metrics: -
Das Verhalten des Messwerts
views
hängt jetzt davon ab, ob für die API-Anfrage zum Abrufen des Playlist-Berichts die DimensionisCurated
verwendet wurde:- Wenn eine Anfrage die Dimension
isCurated
enthält, ist der Messwertviews
ein In-Playlist-Messwert, der angibt, wie oft Videos im Kontext der Playlists des Rechteinhabers angesehen wurden. - Wenn eine Anfrage die Dimension
isCurated
nicht enthält, ist der Messwertviews
ein aggregierter Videomesswert, der angibt, wie oft Videos in den Playlists des Rechteinhabers insgesamt angesehen wurden. Dabei spielt es keine Rolle, ob diese Aufrufe im Playlist-Kontext erfolgt sind. Die zusammengefasste Gesamtzahl umfasst nur Aufrufe von Videos, deren Inhaber der Rechteinhaber des Kanals mit der Playlist ist.
In diesen Berichten, in denen die DimensionisCurated
nicht verwendet wird, gibt der MesswertplaylistViews
an, wie oft Videos im Kontext der Playlist angesehen wurden. Bei diesem Messwert werden die Aufrufe aller Videos in der Playlist gezählt, unabhängig davon, zu welchem Kanal sie gehören.
- Wenn eine Anfrage die Dimension
-
Die Dokumentation zu Rechteinhaberberichten enthält jetzt für jeden Playlist-Bericht Tabellen mit den unterstützten Messwerten für diesen Bericht, je nachdem, ob die API-Anfrage die Dimension
isCurated
enthält. Ein Beispiel findest du im Abschnitt zum Definieren von zeitbasierten Playlist-Berichten.
19. Januar 2024
Bei der YouTube Analytics API (Gezielte Anfragen) gibt es mehrere Aktualisierungen im Zusammenhang mit den Berichten zu Kanalplaylists. Die Aktualisierungen umfassen eine eingestellte Dimension und mehrere neue und aktualisierte Messwerte:
-
Hinweis: Diese Mitteilung wird eingestellt.
Die Dimension
isCurated
wurde für Channelberichte eingestellt. Sie wird ab dem 30. Juni 2024 nicht mehr unterstützt. Die Definition dieser Dimension wurde entsprechend aktualisiert.Damit die Abwärtskompatibilität erhalten bleibt, musst du beim Entfernen der Dimension
isCurated
auch deinen Code so aktualisieren, dass der MesswertplaylistViews
statt des Messwertsviews
nur für Playlist-Berichte abgerufen wird. Da der Messwertviews
in Playlist-Berichten weiterhin unterstützt wird, wenn auch mit einer anderen Bedeutung, gibt die API auch dann Daten zurück, wenn du den Messwertnamen nicht aktualisierst. Natürlich können Sie Ihre Anwendung so ändern, dass sowohlviews
als auchplaylistViews
abgerufen und angezeigt werden.Neben der Dimension
isCurated
werden in den neuen Berichten folgende API-Funktionen nicht mehr unterstützt:- Standortfilter wie
continent
undsubcontinent
werden für die neuen Berichte zu Kanalplaylists nicht unterstützt. - Die Messwerte
redViews
undestimatedRedMinutesWatched
werden für die neuen Berichte zu Kanalplaylists nicht mehr unterstützt. Diese Messwerte waren in YouTube Studio noch nicht verfügbar. Durch diese Änderung wird die API-Funktionalität an die in der Studio App angepasst. - Die Dimensionen
subscribedStatus
undyoutubeProduct
werden in Berichten zu Channelplaylists nicht mehr als Filter unterstützt. Diese Filter waren bisher noch nicht in YouTube Studio verfügbar. Durch diese Änderung wird die API-Funktionalität an die in der Studio App angepasst.
- Standortfilter wie
-
Der Abschnitt Playlist-Berichte in der Dokumentation zu Kanalberichten wurde aktualisiert. Er enthält nun detailliertere Erläuterungen zu den Messwerttypen, die für Playlist-Berichte unterstützt werden:
- Zusammengefasste Videomesswerte umfassen Messwerte zur Nutzeraktivität und zu Impressionen, die für alle Videos in den Playlists des Kanals zusammengefasst werden, die ebenfalls zu diesem Kanal gehören. Aggregierte Videomesswerte werden nur für API-Anfragen ohne die Dimension
isCurated
unterstützt. - Messwerte innerhalb der Playlist spiegeln Nutzeraktivität und -interaktionen im Kontext der Playlist-Seite wider. Diese Messwerte umfassen auch Aufrufe von Videos ohne eigene Eigentumsrechte in der Playlist, aber nur, wenn diese Aufrufe im Kontext der Playlist erfolgt sind.
- Im Abschnitt Unterstützte Playlist-Messwerte findest du die zusammengefassten Messwerte für Videos und Playlists, die in Playlist-Berichten unterstützt werden.
- Zusammengefasste Videomesswerte umfassen Messwerte zur Nutzeraktivität und zu Impressionen, die für alle Videos in den Playlists des Kanals zusammengefasst werden, die ebenfalls zu diesem Kanal gehören. Aggregierte Videomesswerte werden nur für API-Anfragen ohne die Dimension
-
Die folgenden neuen In-Playlist-Messwerte werden in Playlist-Berichten für Kanäle unterstützt. Diese Messwerte werden für Rechteinhaber-Berichte noch nicht unterstützt. Diese Messwerte werden nur unterstützt, wenn in der API-Anfrage zum Abrufen der Berichte die Dimension
isCurated
nicht verwendet wird. Definitionen der einzelnen Messwerte finden Sie in der metrics: -
Das Verhalten des Messwerts
views
hängt jetzt davon ab, ob für die API-Anfrage zum Abrufen des Playlist-Berichts die DimensionisCurated
verwendet wurde:- Wenn eine Anfrage die Dimension
isCurated
enthält, ist der Messwertviews
ein In-Playlist-Messwert, der angibt, wie oft Videos im Kontext der Playlists des Kanals angesehen wurden. - Wenn eine Anfrage die Dimension
isCurated
nicht enthält, ist der Messwertviews
ein aggregierter Videomesswert, der angibt, wie oft das Video in den Playlists des Kanals insgesamt angesehen wurde. Dabei spielt es keine Rolle, ob diese Aufrufe im Playlist-Kontext stattgefunden haben. Die zusammengefasste Gesamtzahl umfasst nur Aufrufe von Videos, die dem Kanal gehören, zu dem die Playlist gehört.
In diesen Berichten, in denen die DimensionisCurated
nicht verwendet wird, gibt der MesswertplaylistViews
an, wie oft Videos im Kontext der Playlist angesehen wurden. Bei diesem Messwert werden die Aufrufe aller Videos in der Playlist gezählt, unabhängig davon, zu welchem Kanal sie gehören.
- Wenn eine Anfrage die Dimension
-
Die Dokumentation zu Kanalberichten enthält jetzt für jeden Playlist-Bericht Tabellen mit unterstützten Messwerten für diesen Bericht, je nachdem, ob die API-Anfrage die Dimension
isCurated
enthält. Ein Beispiel findest du im Abschnitt zum Definieren von zeitbasierten Playlist-Berichten.
4. Dezember 2023
Die YouTube Analytics API (Targeting-Abfragen) wurde aktualisiert, um zwei insightTrafficSourceType
-Dimensionswerte zusammenzuführen. Bisher wurde anhand der Dimension zwischen Videos, die Teil einer Playlist (PLAYLIST
) abgespielt wurden, und Aufrufen über eine Seite, auf der alle Videos einer Playlist aufgeführt sind (YT_PLAYLIST_PAGE
), unterschieden. In Zukunft werden beide Arten von Aufrufen dem Dimensionswert PLAYLIST
zugeordnet.
15. Dezember 2022
Die YouTube Analytics API (Targeting-Suchanfragen) unterstützt zwei neue Dimensionen und einen neuen Bericht:
-
Ein neuer Bericht gibt Aufschluss über die Nutzeraktivität nach Stadt. Dieser Bericht ist für Kanäle und Rechteinhaber verfügbar. Dieser Bericht enthält die neue Dimension
city
, mit der nach Schätzung von YouTube die Stadt ermittelt wird, in der die Nutzeraktivität stattgefunden hat. -
Die neue Dimension
creatorContentType
gibt die Art von YouTube-Inhalten an, die den Messwerten zur Nutzeraktivität in der Datenzeile zugeordnet werden. Unterstützte Werte sindLIVE_STREAM
,SHORTS
,STORY
undVIDEO_ON_DEMAND
.Die Dimension
creatorContentType
wird als optionale Dimension für alle Berichte zu Kanälen und Rechteinhabern unterstützt. -
Der Leitfaden zu Beispielanfragen an die YouTube Analytics API enthält jetzt Beispiele für beide neuen Dimensionen.
-
Verweise auf die Dimensionen
7DayTotals
und30DayTotals
wurden aus der Dokumentation entfernt. Die Einstellung dieser Dimensionen wurde im Oktober 2019 angekündigt.
26. August 2022
Die YouTube Analytics API (Targeting-Anfragen) und die YouTube Reporting API (Bulk-Berichte) unterstützen einen neuen Wert für die Zugriffsquellendetails:
- Wenn der Wert der Dimension
insightTrafficSourceType
in der YouTube Analytics API (Gezielte Abfragen)SUBSCRIBER
ist, kann der WertinsightTrafficSourceDetail
aufpodcasts
gesetzt werden. Das bedeutet, dass der Traffic von der Podcasts-Landingpage weitergeleitet wurde. - Wenn der Wert der Dimension
traffic_source_type
in der YouTube Reporting API (Bulk Reports)3
ist, kann der Werttraffic_source_detail
aufpodcasts
gesetzt werden. Das bedeutet, dass der Traffic von der Podcasts-Landingpage weitergeleitet wurde.
11. Februar 2022
Die gültigen Werte für die Dimension gender
ändern sich am oder nach dem 11. August 2022. Dies könnte eine nicht abwärtskompatible Änderung Ihrer API-Implementierung sein. Gemäß dem Abschnitt Abwärtsinkompatible Änderungen der Nutzungsbedingungen der YouTube API-Dienste wird diese Änderung sechs Monate vor ihrem Inkrafttreten angekündigt. Bitte aktualisieren Sie Ihre API-Implementierung vor dem 11. August 2022, um einen nahtlosen Übergang auf die neuen Werte zu ermöglichen.
Folgende Änderungen werden vorgenommen:
- In der YouTube Analytics API (Gezielte Anfragen) unterstützt die Dimension
gender
derzeit zwei Werte:female
undmale
. Ab dem 11. August 2022 unterstützt diese Dimension drei Werte:female
,male
unduser_specified
. - In der YouTube Reporting API (Bulk Reports) unterstützt die Dimension
gender
derzeit drei Werte:FEMALE
,MALE
undGENDER_OTHER
. Am oder nach dem 11. August 2022 werden die unterstützten Werte inFEMALE
,MALE
undUSER_SPECIFIED
geändert.
9. Februar 2022
Seit dem 13. Dezember 2021 wurden zwei Messwerte aktualisiert, um Zugriffe in Schleifen auszuschließen. Diese Änderung betrifft sowohl die YouTube Analytics API (Targeting Queries) als auch die YouTube Reporting API (Bulk Reports).
- In der YouTube Analytics API (Targeting-Anfragen) schließen die Messwerte
averageViewDuration
undaverageViewPercentage
seit dem 13. Dezember 2021 Zugriffe in Schleifen aus. - In der YouTube Reporting API (Bulk Reports) schließen die Messwerte
average_view_duration_seconds
undaverage_view_duration_percentage
seit dem 13. Dezember 2021 Zugriffe in Schleifen von Clips aus.
2. Februar 2022
Die YouTube Reporting API (Bulk Reports) unterstützt einen neuen Dimensionswert für Besucherquellen, der angibt, dass die Aufrufe über Live Redirects stammen:
- In der YouTube Reporting API (Bulk Reports) unterstützt die Dimension
traffic_source_type
den Wert28
.
Bei diesem Zugriffsquellentyp gibt die Dimension traffic_source_detail
die Kanal-ID an, von der der Zuschauer gekommen ist.
23. September 2020
Die YouTube Analytics API (Gezielte Anfragen) und die YouTube Reporting API (Bulk-Berichte) unterstützen beide einen neuen Dimensionswert für Besucherquellen. Dieser gibt an, dass der Zuschauer durch vertikales Wischen beim Ansehen von YouTube Shorts weitergeleitet wurde:
- In der YouTube Analytics API (Targeting-Abfragen) unterstützt die Dimension
insightTrafficSourceType
den WertSHORTS
. - In der YouTube Reporting API (Bulk Reports) unterstützt die Dimension
traffic_source_type
den Wert24
.
Die Dimension „Zugriffsquellendetails“ (insightTrafficSourceDetail
in der YouTube Analytics API oder traffic_source_detail
in der YouTube Reporting API) wird für diesen neuen Zugriffsquellentyp nicht ausgefüllt.
20. Juli 2020
Dieses Update umfasst zwei Änderungen, die sich auf die YouTube Analytics API (Gezielte Suchanfragen) auswirken:
- Die maximale Größe einer YouTube Analytics-Berichtsgruppe wurde von 200 auf 500 Elemente erhöht.
- Der Parameter
filters
der Methodereports.query
gibt eine Liste von Filtern an, die beim Abrufen von YouTube Analytics-Daten angewendet werden sollen. Der Parameter unterstützt die Möglichkeit, mehrere Werte für die Filtervideo
,playlist
undchannel
anzugeben. Außerdem wurde die maximale Anzahl von IDs, die für diese Filter angegeben werden können, von 200 auf 500 erhöht.
13. Februar 2020
Diese Aktualisierung enthält die folgenden Änderungen in Bezug auf die YouTube Analytics (Targeting Queries) API und die YouTube Reporting (Bulk Reports) API. Weitere Informationen zu diesen Änderungen findest du in der YouTube-Hilfe.
In beiden APIs ändert sich die Gruppe der möglichen Detailwerte für Besucherquellen für Benachrichtigungen.
In gezielten Abfragen werden Benachrichtigungen als insightTrafficSourceType=NOTIFICATION
gemeldet. In Bulk-Berichten werden Benachrichtigungen als traffic_source_type=17
gemeldet.
Mit den neuen Werten werden Benachrichtigungen zu hochgeladenen Videos und Livestreams, die zuvor als uploaded
gemeldet wurden, in zwei Kategorien unterteilt:
uploaded_push
: Aufrufe über Push-Benachrichtigungen, die beim Hochladen eines Videos an Abonnenten gesendet wurdenuploaded_other
: Aufrufe, die über Benachrichtigungen erfolgen, die Abonnenten beim Hochladen eines Videos erhalten haben. Das betrifft beispielsweise E-Mail- oder Posteingangsbenachrichtigungen.
Diese Werte werden für den Zeitraum ab dem 13.01.2020 (13. Januar 2020) zurückgegeben.
Zur Erinnerung: Diese Werte stellen keine Benachrichtigungen selbst dar, sondern die Zugriffsquellen, die zu bestimmten YouTube-Aufrufen geführt haben. Wenn eine Berichtszeile beispielsweise views=3
, traffic_source_type=17
(NOTIFICATION
) und traffic_source_detail=uploaded_push
enthält, gibt die Zeile an, dass drei Aufrufe daraus resultierten, dass Zuschauer auf Push-Benachrichtigungen geklickt haben, die beim Upload des Videos gesendet wurden.
15. Oktober 2019
Dieses Update umfasst die folgenden Änderungen in Bezug auf die YouTube Analytics API (Targeting-Suchanfragen):
-
Hinweis: Diese Mitteilung wird eingestellt.
YouTube entfernt die Unterstützung für die Dimensionen
7DayTotals
und30DayTotals
. Sie können noch bis zum 15. April 2020 Daten mit diesen Dimensionen abrufen. An oder nach diesem Datum wird bei Versuchen, Berichte mit der Dimension7DayTotals
oder30DayTotals
abzurufen, ein Fehler zurückgegeben.Hinweis: Nutzer können einige Daten für diese Dimensionen reproduzieren, indem sie die Dimension
day
abfragen und Daten über einen Zeitraum von 7 oder 30 Tagen aggregieren oder ableiten. Beispiel:- Die Anzahl der Aufrufe für einen Zeitraum von sieben Tagen kann berechnet werden, indem die Anzahl der Aufrufe an jedem Tag dieses Zeitraums aggregiert wird.
- Um den Prozentsatz der Zuschauer für einen Zeitraum von sieben Tagen zu berechnen, wird die Anzahl der Aufrufe pro Tag mit dem Prozentsatz der Zuschauer für diesen Tag multipliziert. So wird die Anzahl der Zuschauer ermittelt, die angemeldet waren, als sich das Video an diesem Tag angesehen hat. Die Anzahl der angemeldeten Zuschauer kann dann für den gesamten Zeitraum addiert und durch die Gesamtzahl der Aufrufe in diesem Zeitraum geteilt werden, um den Prozentsatz der Zuschauer für den gesamten Zeitraum zu erhalten.
- Die Anzahl der einzelnen Nutzer über einen Zeitraum von sieben Tagen kann nicht berechnet werden, da ein einzelner Nutzer an verschiedenen Tagen als einzelner Nutzer gezählt werden kann. Unter Umständen ist es jedoch möglich, die Dimension
month
anstelle der Dimension30DayTotals
zu verwenden, um Daten zur Anzahl der einzelnen Nutzer über einen Zeitraum von 30 Tagen zu extrapolieren. Die Dimensionmonth
bezieht sich auf Kalendermonate, während die Dimension30DayTotals
30-Tage-Zeiträume basierend auf dem angegebenen Start- und Enddatum berechnet.
27. Juni 2019
Dieses Update umfasst die folgenden Änderungen in Bezug auf die YouTube Analytics API (Targeting-Suchanfragen):
-
Da Version 1 der API inzwischen vollständig eingestellt ist, wurde die Dokumentation aktualisiert und Verweise auf diese Version entfernt, einschließlich des Hinweises zur Einstellung und des Migrationsleitfadens, in dem die Aktualisierung auf Version 2 erläutert wird.
1. November 2018
Dieses Update umfasst die folgenden Änderungen in Bezug auf die YouTube Analytics API (Targeting-Suchanfragen):
-
Version 1 der API wird nicht mehr unterstützt. Sofern noch nicht geschehen, sollten Sie Ihre API-Clients so bald wie möglich auf Version 2 der API aktualisieren, um Dienstunterbrechungen zu minimieren. Weitere Informationen finden Sie in der Migrationsanleitung.
Hinweis: Der Zeitplan für die Einstellung wurde ursprünglich am 26. April 2018 angekündigt.
17. September 2018
Dieses Update umfasst die folgenden Änderungen in Bezug auf die YouTube Analytics API (Targeting-Suchanfragen):
-
Im neuen Abschnitt zur Datenanonymisierung in der Übersicht über das Datenmodell wird erläutert, dass einige YouTube Analytics-Daten eingeschränkt sind, wenn die Messwerte einen bestimmten Grenzwert nicht erreichen. Dies kann in verschiedenen Fällen passieren. In der Praxis bedeutet dies, dass ein Bericht in folgenden Fällen möglicherweise nicht alle oder gar keine Daten enthält:
-
ein Video oder Kanal in einem bestimmten Zeitraum nur wenige Zugriffe hat,
oder
-
Sie einen Filter oder eine Dimension (z. B. Besucherquelle oder Land) ausgewählt haben, für die die Werte einen bestimmten Grenzwert nicht erreichen.
In diesem neuen Abschnitt werden auch die Datentypen erläutert, die in YouTube Analytics-Berichten eingeschränkt sein können.
-
-
Die Dokumente zu Kanalberichten und Berichten zu Rechteinhabern wurden aktualisiert, um zu berücksichtigen, dass die Messwerte
redViews
undestimatedRedMinutesWatched
für Berichte zu Wiedergabeort, Zugriffsquellen, Gerätetyp oder Betriebssystem nicht mehr unterstützt werden.
18. Juni 2018
Dieses Update umfasst die folgenden Änderungen an der YouTube Analytics (Targeting Queries) API:
- Die Umfangsanforderungen für die folgenden Methoden haben sich geändert:
- Anfragen an die Methode
reports.query
müssen Zugriff auf den Bereichhttps://www.googleapis.com/auth/youtube.readonly
haben. - Anfragen an die Methode
groupItems.list
müssen Zugriff auf Folgendes haben:https://www.googleapis.com/auth/youtube
-Bereich
oder- den Bereich
https://www.googleapis.com/auth/youtube.readonly
und
den Bereichhttps://www.googleapis.com/auth/yt-analytics.readonly
Bei der ersten Option wird ein Bereich verwendet, bei dem es sich um einen nicht schreibgeschützten Bereich handelt, während bei der zweiten Option zwei schreibgeschützte Bereiche verwendet werden.
- Anfragen an die Methode
23. Mai 2018
Dieses Update umfasst die folgenden Änderungen an der YouTube Analytics (Targeting Queries) API:
- Die API-Übersicht enthält den neuen Abschnitt zusammengefasste Messwerte und gelöschte Elemente. Dort wird erläutert, wie in API-Antworten Daten im Zusammenhang mit gelöschten Ressourcen wie Videos, Playlists oder Kanälen verarbeitet werden.
- Der Abschnitt Best Practices in der API-Übersicht wurde aktualisiert. Wir möchten dich daran erinnern, dass du mit der YouTube Data API zusätzliche Metadaten für Ressourcen abrufen kannst, die in Antworten der YouTube Analytics API identifiziert wurden. Gemäß den Richtlinien für Entwickler der YouTube API-Dienste (Abschnitte III.E.4.b bis III.E.4.d) müssen API-Clients gespeicherte Ressourcenmetadaten nach 30 Tagen aus dieser API entweder löschen oder aktualisieren.
22. Mai 2018
Diese Aktualisierung umfasst die folgenden Änderungen in Bezug auf die YouTube Reporting API (Bulk-Berichte):
- Die folgenden Änderungen sollen derzeit voraussichtlich im Juli 2018 in Kraft treten. Die neuen Richtlinien gelten weltweit für alle Berichts- und Berichterstellungsjobs.
-
Nach der Änderung sind die meisten API-Berichte, einschließlich Backfill-Berichte, ab Erstellung 60 Tage lang verfügbar. Berichte mit Verlaufsdaten sind jedoch ab Erstellung 30 Tage lang verfügbar.
Bisher waren alle API-Berichte ab ihrer Erstellung 180 Tage lang verfügbar. Nach dem Inkrafttreten dieser Richtlinienänderung können Sie auch nicht mehr über die API auf Berichte mit Verlaufsdaten zugreifen, die älter als 30 Tage sind. Alle anderen Berichte, die älter als 60 Tage sind, können ebenfalls nicht mehr aufgerufen werden. Aus diesem Grund sind Berichte, die vor der Richtlinienänderung erstellt wurden, bis zu 180 Tage lang verfügbar.
-
Nach der Änderung erstellt YouTube bei der Planung eines Berichterstellungsjobs ab diesem Tag Berichte, die die 30 Tage vor der Planung des Jobs abdecken. Vor der Änderung generiert YouTube bei der Planung eines Berichterstellungsjobs Berichte, die die 180 Tage vor der Planung des Jobs abdecken.
-
-
Der Abschnitt Best Practices wurde aktualisiert, um dich daran zu erinnern, dass du mit der YouTube Data API zusätzliche Metadaten für Ressourcen abrufen kannst, die in Berichten identifiziert wurden. Gemäß den Richtlinien für Entwickler der YouTube API-Dienste (Abschnitte III.E.4.b bis III.E.4.d) müssen API-Clients gespeicherte Ressourcenmetadaten nach 30 Tagen aus dieser API entweder löschen oder aktualisieren.
-
Der Abschnitt Berichtmerkmale wurde aktualisiert. Obwohl Berichtsdaten nicht gefiltert sind, enthalten Berichte, die Daten für einen Zeitraum ab dem 1. Juni 2018 enthalten, keine Verweise auf YouTube-Ressourcen, die mindestens 30 Tage vor dem Erstellungsdatum des Berichts gelöscht wurden.
-
Der Abschnitt Verlaufsdaten der API-Übersicht wurde aktualisiert. Wenn Sie einen neuen Berichtjob planen, werden die Berichte zu bisherigen Daten in der Regel innerhalb weniger Tage veröffentlicht. Zuvor wurde in der Dokumentation angegeben, dass es bis zu 30 Tage dauern kann, bis solche Berichte verfügbar sind.
-
Der Abschnitt Backfill-Daten der API-Übersicht wurde aktualisiert. Backfill-Daten werden jetzt deutlicher als ein Datensatz definiert, der einen zuvor übermittelten Datensatz ersetzt.
26. April 2018
Version 2 der YouTube Analytics (Gezielte Suchanfragen) API (Version 2) ist jetzt öffentlich verfügbar. In der folgenden Liste sind Änderungen an Produkten und der Dokumentation im Zusammenhang mit der neuen API-Version aufgeführt:
-
Die v2 API ist fast identisch mit der v1 API. Wahrscheinlich müssen Sie jedoch den Code an die unten aufgeführten Änderungen anpassen. Alle diese Änderungen werden im neuen Migrationsleitfaden ausführlich erläutert.
- Die API-Version wurde von
v1
zuv2
geändert. - Die Basis-URL für API-Anfragen wurde von
https://www.googleapis.com/youtube/analytics/v1
zuhttps://youtubeanalytics.googleapis.com/v2
geändert. - Mehrere Parameter für die Methode
reports.query
haben aktualisierte Namen. Insbesondere Parameternamen, die Bindestriche enthalten, wieend-date
in der API V1, verwenden in der API V1 die Camel-Case-Schreibweise (endDate
) anstelle von Bindestrichen. Durch diese Änderung werden Parameternamen im gesamten API einheitlich, da bei den API-Methoden zum Erstellen und Verwalten von Gruppen bereits die Camel-Case-Schreibweise für Parameternamen verwendet wird. - Die API V2 unterstützt keine Batchanfragen, die an den globalen HTTP-Batchendpunkt von Google (
www.googleapis.com/batch
) gesendet werden. Wenn Sie Batchanfragen über die API V2 senden, müssen Sie stattdessen den Endpunkthttps://youtubeanalytics.googleapis.com/v2
verwenden.
Außerdem werden einige Funktionen der Version 1 von der API V2 nicht unterstützt:
- Die Methode
reports.query
unterstützt die Anfrageparameteralt
,quotaUser
unduserIp
nicht mehr. - Die API V2 bietet keinen Batchendpunkt, der Batches mit Anfragen an verschiedene APIs unterstützt. Ein Batch kann jedoch aus Anfragen an verschiedene Methoden derselben API bestehen. Diese Änderung betrifft nicht nur die YouTube Analytics API, da Google den globalen Batchendpunkt für alle seine APIs einstellt.
- Das JSON-RPC-Protokoll, das in API Version 1 unterstützt wurde, wird von der API V2 nicht unterstützt. Diese Änderung betrifft nicht nur die YouTube Analytics API.
- Die API-Version wurde von
-
Hinweis: Diese Mitteilung wird eingestellt.
Version 1 der API (v1) wurde eingestellt und wird bis zum 31. Oktober 2018 unterstützt. Alle Anfragen an die v1 API funktionieren nach diesem Datum nicht mehr. Führe deshalb bis zum 31. Oktober 2018 ein Upgrade auf die Version 2 der API aus, damit du weiterhin über die API auf YouTube Analytics-Daten zugreifen kannst.
21. Februar 2018
Dieses Update umfasst die folgenden Änderungen an der YouTube Analytics (Targeting Queries) API:
- Berichte zu demografischen Merkmalen von Zuschauern, in denen Wiedergabestatistiken auf Grundlage der Altersgruppe und des Geschlechts der Zuschauer zusammengefasst werden, unterstützen nicht mehr die Dimension
youtubeProduct
. Mit ihr wird der YouTube-Dienst ermittelt, bei dem die Nutzeraktivität stattgefunden hat.
18. Januar 2018
Dieses Update enthält die folgenden Änderungen:
-
YouTube Reporting API (Bulk-Berichte)
- Die Dimension
operating_system
, die das Softwaresystem des Geräts ermittelt, auf dem die Aufrufe erfolgt sind, unterstützt jetzt den folgenden Wert:25
: KaiOS
- Die Dimension
-
YouTube Analytics API (gezielte Suchanfragen)
- Die Dimension „
operatingSystem
“ unterstützt den Dimensionswert „KAIOS
“.
- Die Dimension „
20. Dezember 2017
Diese Aktualisierung umfasst zwei Änderungen, die die YouTube Reporting API betreffen:
-
Der API-Server unterstützt jetzt die gzip-Komprimierung für Anfragen zum Herunterladen von Berichten. Die gzip-Komprimierung wird für andere Arten von API-Anfragen nicht unterstützt. Durch Aktivieren der gzip-Komprimierung wird die für die jeweilige API-Antwort benötigte Bandbreite reduziert. Und obwohl Ihre Anwendung zum Dekomprimieren von API-Antworten zusätzliche CPU-Zeit benötigt, überwiegt der Nutzen von weniger Netzwerkressourcen diese Kosten in der Regel.
Um eine mit gzip codierte Antwort zu erhalten, setze den
Accept-Encoding
-HTTP-Anfrageheader aufgzip
, wie im folgenden Beispiel gezeigt:Accept-Encoding: gzip
Diese Funktion wird in der API-Übersicht und in der Definition der Property
downloadUrl
derreport
-Ressource erläutert. -
Die Dokumentation der Dimensionen
age group
undgender
wurde korrigiert. Sie zeigt nun die tatsächlichen Werte an, die die API für diese Dimensionen zurückgibt. Hinweis: Hierbei handelt es sich um eine Korrektur der Dokumentation, die keine Änderung der API-Funktionalität oder des API-Verhaltens widerspiegelt. Die folgenden Werte haben sich geändert:- Die Werte für die Dimension „
age_group
“ enthalten Großbuchstaben, Unterstriche zwischen dem Wort „AGE
“ und den Ziffern in der Altersgruppe und Unterstriche statt Bindestriche. Daher wurden Werte wieage13-17
undage18-24
zuAGE_13_17
bzw.AGE_18_24
korrigiert. - Die Werte für die Dimension „
gender
“ werden in Großbuchstaben verwendet. Daher wurden die Wertefemale
,male
undgender_other
inFEMALE
,MALE
undGENDER_OTHER
korrigiert.
- Die Werte für die Dimension „
10. August 2017
Am 10. August 2016 wurde in dieser Dokumentation angekündigt, dass der Messwert earnings
der YouTube Analytics API eingestellt wird. Gleichzeitig wurde in der API ein neuer Messwert namens estimatedRevenue
unterstützt, der dieselben Daten liefert.
Da der Messwert „earnings
“ ein wichtiger Messwert war, wurde er ab dem Datum der Bekanntgabe ein Jahr lang unterstützt. Der Messwert earnings
wird jetzt jedoch nicht mehr unterstützt. Daher geben API-Anfragen, die den Messwert earnings
angeben, jetzt den HTTP-Antwortcode 400
zurück. Wenn Sie Ihre App noch nicht so aktualisiert haben, dass der Messwert estimatedRevenue
anstelle des Messwerts earnings
verwendet wird, tun Sie dies bitte so bald wie möglich.
Die API-Dokumentation wurde aktualisiert und die verbleibenden Verweise auf den Messwert earnings
wurden entfernt.
6. Juli 2017
Dieses Update enthält die folgenden Änderungen:
-
YouTube Analytics API (gezielte Suchanfragen)
-
Die API-Dokumentation wurde aktualisiert, um die Tatsache zu berücksichtigen, dass API-Antworten Daten bis zum letzten Tag im angeforderten Zeitraum enthalten, für den alle abgefragten Messwerte verfügbar sind.
Wenn in einer Anfrage beispielsweise der 5. Juli 2017 als Enddatum angegeben ist und die Werte für alle angeforderten Messwerte nur bis zum 3. Juli 2017 verfügbar sind, wird dies das letzte Datum sein, an dem Daten in die Antwort aufgenommen werden. Das gilt auch dann, wenn für einige der angeforderten Messwerte ab dem 4. Juli 2017 Daten verfügbar sind.
-
Für die Dimension „
adType
“ wird jetzt der Wert „reservedBumperInstream
“ unterstützt, der sich auf eine nicht überspringbare Videoanzeige mit einer Dauer von bis zu sechs Sekunden bezieht, die abgespielt wird, bevor ein Video wiedergegeben werden kann. Das Anzeigenformat ist mit derauctionBumperInstream
-Anzeige identisch. Dieser Typ bezieht sich jedoch auf Anzeigen, die reserviert und nicht auf Auktionsbasis verkauft werden.
-
-
YouTube Reporting API (Bulk-Berichte)
-
Für die Dimension „
ad_type
“ wird jetzt der Wert „20
“ unterstützt, der sich auf Bumper-Anzeigen bezieht, die reserviert sind. Bumper-Anzeigen sind nicht überspringbare Videoanzeigen, die bis zu sechs Sekunden dauern und vor der Wiedergabe eines Videos wiedergegeben werden. Der Wert19
für diese Dimension bezieht sich auch auf Bumper-Anzeigen, die per Auktion und nicht reserviert verkauft werden. -
Berichtsjobs für die folgenden YouTube Reporting API-Berichte wurden gelöscht:
channel_basic_a1
channel_province_a1
channel_playback_location_a1
channel_traffic_source_a1
channel_device_os_a1
channel_subtitles_a1
channel_combined_a1
content_owner_basic_a2
content_owner_province_a1
content_owner_playback_location_a1
content_owner_traffic_source_a1
content_owner_device_os_a1
content_owner_subtitles_a1
content_owner_combined_a1
content_owner_asset_basic_a1
content_owner_asset_province_a1
content_owner_asset_playback_location_a1
content_owner_asset_traffic_source_a1
content_owner_asset_device_os_a1
content_owner_asset_combined_a1
Diese Berichtstypen wurden am 15. September 2016 als eingestellt angekündigt und nach dem 15. Dezember 2016 wurden keine entsprechenden Berichte mehr erstellt. Zuvor erstellte Berichte waren ab dem Zeitpunkt ihrer Erstellung noch 180 Tage lang verfügbar. Daher waren einige Berichte erst seit dem 15. Juni 2017 verfügbar. Da die Berichte jedoch nicht mehr verfügbar sind, werden die mit den Berichten verknüpften Jobs auch nicht benötigt.
-
24. Mai 2017
Alle Berichterstellungsjobs für die folgenden YouTube Reporting API-Berichte wurden gelöscht:
content_owner_ad_performance_a1
content_owner_asset_estimated_earnings_a1
content_owner_estimated_earnings_a1
Diese Berichtstypen wurden am 22. Juni 2016 als eingestellt angekündigt und nach dem 22. September 2016 nicht mehr dafür erstellt. Zuvor erstellte Berichte waren ab dem Zeitpunkt ihrer Erstellung noch 180 Tage lang verfügbar. Daher waren einige Berichte erst seit dem 22. März 2017 verfügbar. Da die Berichte jedoch nicht mehr verfügbar sind, werden die mit den Berichten verknüpften Jobs auch nicht benötigt.
22. Mai 2017
Dieses Update enthält die folgenden Änderungen:
-
YouTube Reporting API (Bulk-Berichte)
- Die Dimension
sharing_service
, die den Dienst identifiziert, über den Videos freigegeben wurden, unterstützt jetzt die folgenden Werte:85
: YouTube Music86
: YouTube Gaming87
: YouTube Kids88
: YouTube TV
Außerdem wurde der Name zur Identifizierung des Werts „
52
“ in der Dokumentation in Kakao (Kakao Talk) geändert, damit er sich klarer vom Wert73
(Kakao Story) unterscheiden kann. Diese Änderung wirkt sich nicht auf das API-Verhalten oder die Klassifizierung von Videos aus, die mit diesen Diensten geteilt werden.
- Die Dimension
-
YouTube Analytics API (gezielte Suchanfragen)
- Für die Dimension
sharingService
werden jetzt folgende Werte unterstützt:YOUTUBE_GAMING
YOUTUBE_KIDS
YOUTUBE_MUSIC
YOUTUBE_TV
- Für die Dimension
28. März 2017
Kanalinhaber, die über YouTube Analytics in Creator Studio auf Umsatzdaten zugreifen können, können jetzt auch über die YouTube Analytics API auf diese Umsatzdaten zugreifen:
-
Die API unterstützt die folgenden umsatzbezogenen Messwerte:
adImpressions
cpm
estimatedAdRevenue
estimatedRedPartnerRevenue
estimatedRevenue
grossRevenue
monetizedPlaybacks
playbackBasedCpm
Diese Messwerte werden für die folgenden Berichte unterstützt:
-
Kanalinhaber können jetzt außerdem einen Bericht zur Anzeigenleistung abrufen, der die Dimensionen
adType
sowie die optionale Dimensionday
unterstützt. -
Die Beispielanfrage an die YouTube Analytics API enthält jetzt einen Abschnitt für Umsatzberichte für Kanäle.
17. März 2017
Dieses Update enthält die folgenden Änderungen:
-
Die YouTube Analytics API unterstützt die Messwerte
redViews
undestimatedRedMinutesWatched
, die sich beide auf YouTube Red-Zuschauer beziehen. Die API unterstützt diese Messwerte bereits seit einiger Zeit. Wie am 15. September 2016 angekündigt, unterstützt die YouTube Reporting API beide Messwerte.- Der Messwert
redViews
gibt an, wie oft ein Video von YouTube Red-Abonnenten angesehen wurde. - Der Messwert
estimatedRedMinutesWatched
gibt die Anzahl der Minuten an, die YouTube Red-Mitglieder ein Video angesehen haben.
Die Dokumentation zu Kanalberichten und Berichten zu Rechteinhabern wurde aktualisiert und zeigt nun an, in welchen Berichten die beiden neuen Messwerte unterstützt werden. Sie werden in allen Berichten unterstützt, in denen die Messwerte „
views
“ und „estimatedMinutesWatched
“ bereits unterstützt werden. - Der Messwert
3. März 2017
Dieses Update enthält die folgenden Änderungen:
-
YouTube Reporting API (Bulk-Berichte)
-
Die Definition der Dimension
date
wurde korrigiert. Der Dimensionswert bezieht sich nun auf den Zeitraum, der um 00:00 Uhr Pacific Time beginnt und um 23:59 Uhr Pacific Time am angegebenen Tag, Monat und Jahr endet. Je nach Jahreszeit entspricht die Zeitzone Pacific Time entweder UTC-7 oder UTC-8.Obwohl Datumsangaben normalerweise einen 24-Stunden-Zeitraum darstellen, repräsentieren Daten, an denen die Uhren vorwärts verschoben werden, einen 23-Stunden-Zeitraum und Daten, an denen die Uhren rückwärts angepasst werden, einen 25-Stunden-Zeitraum. Zuvor stand in der Dokumentation fest, dass jedes Datum einen eindeutigen 24-Stunden-Zeitraum darstellte und dass die Zeitzone U.S. Pacific immer UTC-8 galt.
Diese Korrektur stellt keine Änderung des tatsächlichen API-Verhaltens dar.
- Die Dimension
operating_system
, die das Softwaresystem des Geräts ermittelt, auf dem die Aufrufe erfolgten, unterstützt jetzt folgende Werte:22
: Tizen23
: Firefox24
: RealMedia
-
Alle Berichterstellungsjobs für den Berichtstyp
content_owner_basic_a1
wurden gelöscht. Dieser Berichtstyp wurde am 19. August 2016 vollständig eingestellt. Zuvor erstelltecontent_owner_basic_a1
-Berichte waren jedoch noch 180 Tage lang verfügbar, nachdem sie generiert wurden. Daher waren einige Berichte erst seit dem 19. Februar 2017 verfügbar. Da die Berichte jedoch nicht mehr verfügbar sind, werden die mit den Berichten verknüpften Jobs auch nicht benötigt.
-
-
YouTube Analytics API (gezielte Suchanfragen)
-
Die Beschreibung der Dimensionen in Bezug auf
time periods
wurde korrigiert. Der Dimensionswert bezieht sich nun auf den Zeitraum, der um 00:00 Uhr Pacific Time beginnt und um 23:59 Uhr Pacific Time am angegebenen Tag, Monat und Jahr endet. Je nach Jahreszeit entspricht die Zeitzone Pacific Time entweder UTC-7 oder UTC-8.Obwohl Datumsangaben normalerweise einen 24-Stunden-Zeitraum darstellen, repräsentieren Daten, an denen die Uhren vorwärts verschoben werden, einen 23-Stunden-Zeitraum und Daten, an denen die Uhren rückwärts angepasst werden, einen 25-Stunden-Zeitraum. Zuvor war in der Dokumentation angegeben, dass die Zeitzone U.S. Pacific (UTC-8) als UTC-8 gilt, und es wurde nicht erwähnt, dass ein Tag möglicherweise keinen 24-Stunden-Zeitraum darstellt.
Diese Korrektur stellt keine Änderung des tatsächlichen API-Verhaltens dar.
-
Die Dokumentation zu Channelberichten wurde aktualisiert. Channelberichte enthalten derzeit keine Messwerte zu Einnahmen und Anzeigenleistung. Aktuell wird über den Bereich
https://www.googleapis.com/auth/yt-analytics-monetary.readonly
kein Zugriff auf monetäre Daten in Channelberichten gewährt. - Die Dimension
operatingSystem
unterstützt drei neue Dimensionswerte:FIREFOX
REALMEDIA
TIZEN
-
8. Februar 2017
Die YouTube Analytics API unterstützt jetzt den optionalen include-historical-channel-data
-Parameter. Dieser Parameter ist nur beim Abrufen von Rechteinhaberberichten relevant.
Mit dem Parameter kann ein Rechteinhaber angeben, dass eine API-Antwort die Wiedergabezeit- und Aufrufdaten der Kanäle aus dem Zeitraum vor der Verknüpfung der Kanäle mit dem Rechteinhaber enthalten soll. Der Standardparameterwert lautet false
. Das bedeutet, dass die API-Antwort standardmäßig nur Daten zu Wiedergabezeit und Aufrufen ab dem Zeitpunkt enthält, an dem Kanäle mit dem Rechteinhaber verknüpft wurden.
Diese Regeln gelten auch, wenn die API-Anfrage Daten für mehrere Kanäle abruft:
- Wenn der Parameterwert
false
lautet, basieren die für einen bestimmten Kanal zurückgegebenen Daten zu Wiedergabezeit und Aufrufen auf dem Datum, an dem der Kanal mit dem Rechteinhaber verknüpft wurde.
Bedenke dabei, dass verschiedene Kanäle möglicherweise zu unterschiedlichen Zeitpunkten mit einem Rechteinhaber verknüpft wurden. Wenn mit der API-Anfrage Daten für mehrere Kanäle abgerufen werden und der Parameterwertfalse
lautet, enthält die API-Antwort Daten zu Wiedergabezeit und Aufrufen basierend auf dem Verknüpfungsdatum des jeweiligen Kanals. - Wenn der Parameterwert
true
lautet, werden in der Antwort Wiedergabezeit- und Aufrufdaten für alle Kanäle basierend auf dem in der API-Anfrage angegebenen Start- und Enddatum zurückgegeben.
15. Dezember 2016
Die folgenden YouTube Reporting API-Berichte werden nicht mehr unterstützt und aus der Dokumentation entfernt. Von jedem Bericht ist eine neuere Version verfügbar. (Die Ankündigung für diese Berichte wurde am 15. September 2016 angekündigt.)
-
Kanalberichte
channel_basic_a1
: Ersetzt durch den Bericht „channel_basic_a2
“.channel_province_a1
: Ersetzt durch den Bericht „channel_province_a2
“.channel_playback_location_a1
: Ersetzt durch den Bericht „channel_playback_location_a2
“.channel_traffic_source_a1
: Ersetzt durch den Bericht „channel_traffic_source_a2
“.channel_device_os_a1
: Ersetzt durch den Bericht „channel_device_os_a2
“.channel_subtitles_a1
: Ersetzt durch den Bericht „channel_subtitles_a2
“.channel_combined_a1
: Ersetzt durch den Bericht „channel_combined_a2
“.
-
Berichte zu Rechteinhabern
content_owner_basic_a2
: Ersetzt durch den Bericht „content_owner_basic_a3
“.content_owner_province_a1
: Ersetzt durch den Bericht „content_owner_province_a2
“.content_owner_playback_location_a1
: Ersetzt durch den Bericht „content_owner_playback_location_a2
“.content_owner_traffic_source_a1
: Ersetzt durch den Bericht „content_owner_traffic_source_a2
“.content_owner_device_os_a1
: Ersetzt durch den Bericht „content_owner_device_os_a2
“.content_owner_subtitles_a1
: Ersetzt durch den Bericht „content_owner_subtitles_a2
“.content_owner_combined_a1
: Ersetzt durch den Bericht „content_owner_combined_a2
“.content_owner_asset_basic_a1
: Ersetzt durch den Bericht „content_owner_asset_basic_a2
“.content_owner_asset_province_a1
: Ersetzt durch den Bericht „content_owner_asset_province_a2
“.content_owner_asset_playback_location_a1
: Ersetzt durch den Bericht „content_owner_asset_playback_location_a2
“.content_owner_asset_traffic_source_a1
: Ersetzt durch den Bericht „content_owner_asset_traffic_source_a2
“.content_owner_asset_device_os_a1
: Ersetzt durch den Bericht „content_owner_asset_device_os_a2
“.content_owner_asset_combined_a1
: Ersetzt durch den Bericht „content_owner_asset_combined_a2
“.
Die Liste der aktuellen Berichtstypen in der API-Referenzdokumentation wurde ebenfalls aktualisiert.
11. November 2016
Dieses Update enthält die folgenden Änderungen:
-
Berichte zu Abspannen
- Der Abspannbericht für Kanalvideos enthält Statistiken zu allen Videos eines Kanals.
- Der Abspannbericht für Videos von Rechteinhabern enthält Statistiken zu Videos auf den Kanälen eines Rechteinhabers.
- Der Abspannbericht für Assets von Rechteinhabern enthält Statistiken für die Assets, die mit den Videos verknüpft sind, nach denen die Abspanne eingeblendet werden.
-
Abmessungen des Abspanns
end_screen_element_type
: Die Art des Abspannelements, das mit der Statistik verknüpft ist.end_screen_element_id
: Die ID, mit der YouTube das Abspannelement eindeutig identifiziert.
Messwerte für den Abspann
Hinweis: Daten für Abspannmesswerte sind seit dem 1. Mai 2016 verfügbar.
end_screen_element_impressions
: Die Gesamtzahl der Impressionen für Abspannelemente. Für jedes eingeblendete Abspannelement wird eine Impression erfasst.end_screen_element_clicks
: Gibt an, wie oft Abspannelemente angeklickt wurden.end_screen_element_click_rate
: Die Klickrate für Abspannelemente.
-
Die folgenden Berichte werden nicht mehr unterstützt und aus der Dokumentation entfernt. Von jedem Bericht ist eine neuere Version verfügbar. (Die Ankündigung für diese Berichte wurde am 22. Juni 2016 angekündigt.)
content_owner_ad_performance_a1
: Ersetzt durch den Bericht „content_owner_ad_rates_a1
“.content_owner_estimated_earnings_a1
: Ersetzt durch den Bericht „content_owner_estimated_revenue_a1
“.content_owner_asset_estimated_earnings_a1
: Ersetzt durch den Bericht „content_owner_asset_estimated_revenue_a1
“.
-
Die Messwerte in der folgenden Liste wurden vollständig eingestellt und werden nicht mehr unterstützt. Wie am 10. August 2016 angekündigt, werden neue Messwerte, die sich auf dieselben Daten beziehen, bereits unterstützt. In der folgenden Tabelle sehen Sie den eingestellten Messwertnamen und den neuen Messwertnamen:
Eingestellter Messwert Neuer Messwert adEarnings
estimatedAdRevenue
impressionBasedCpm
cpm
impressions
adImpressions
redPartnerRevenue
estimatedRedPartnerRevenue
- Monatlicher, weltweiter Werbeumsatz pro Video
- Täglicher Werbeumsatz pro Video pro Land
- Weltweite Werbeeinnahmen pro Asset pro Monat
- Täglicher Werbeumsatz pro Land und Asset
- Ansprüche (dieser Bericht enthält keine Umsatzdaten)
-
Die API unterstützt zwei neue Messwerte zu YouTube Red-Zuschauerzahlen:
red_views
: Gibt an, wie oft ein Video von YouTube Red-Mitgliedern angesehen wurde.red_watch_time_minutes
: die Anzahl der Minuten, die YouTube Red-Mitglieder ein Video angesehen haben.
-
Die API unterstützt neue Versionen von 20 Berichten. Alle neuen Versionen unterstützen die neuen Messwerte
red_views
undred_watch_time_minutes
.In jedem Bericht ist in der neuen Berichtstyp-ID eine Zahl höher als in der alten. (Die alten Versionen dieser Berichte sind mittlerweile veraltet, wie weiter unten in diesem Überarbeitungsverlauf beschrieben.) Beispielsweise wurde der Bericht
channel_basic_a1
inzwischen eingestellt und durch den Berichtchannel_basic_a2
ersetzt.In den folgenden Listen sind die IDs der neuen Berichtstypen aufgeführt:
Videoberichte des Kanals
Berichte zu Videos für Rechteinhaber
Asset-Berichte für Rechteinhaber
-
Hinweis: Diese Mitteilung wird eingestellt.
Wenn Sie bereits Aufträge zum Erstellen einer der älteren Versionen der oben aufgeführten Berichte haben, müssen Sie neue Aufträge für die umbenannten Berichte erstellen. Im Zusammenhang mit der Veröffentlichung der neuen Berichtversionen wurden die folgenden Berichtversionen eingestellt:
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
Wenn Sie Jobs für einen dieser Berichte haben, können Sie nicht davon ausgehen, dass YouTube nach dem 15. Dezember 2016 neue Berichte für diese Jobs erstellt. Die erstellten Berichte sind ab dem Zeitpunkt ihrer Erstellung noch 180 Tage verfügbar.
-
Der Bericht „
content_owner_basic_a1
“ wurde vollständig eingestellt und aus der Dokumentation entfernt. YouTube erstellt keine neuen Berichte dieses Typs mehr. Bereits generierte Berichte sind jedoch noch 180 Tage lang verfügbar, nachdem sie generiert wurden.Anstelle des Berichts
content_owner_basic_a1
wird der Berichtcontent_owner_basic_a2
durch den Überarbeitungsverlauf vom 19. Mai 2016 ersetzt. -
Die neu veröffentlichten Nutzungsbedingungen für die YouTube API-Dienste („Aktualisierte Nutzungsbedingungen“), die im YouTube Engineering and Developers Blog ausführlich erörtert werden, enthalten zahlreiche Aktualisierungen der aktuellen Nutzungsbedingungen. Zusätzlich zu den aktualisierten Nutzungsbedingungen, die am 10. Februar 2017 in Kraft treten, enthält diese Aktualisierung mehrere Dokumente, in denen die Richtlinien erläutert werden, die Entwickler einhalten müssen.
Die vollständigen neuen Dokumente finden Sie im Überarbeitungsverlauf für die aktualisierten Nutzungsbedingungen. Darüber hinaus werden künftige Änderungen der aktualisierten Nutzungsbedingungen oder der entsprechenden Dokumente in diesem Überarbeitungsverlauf erläutert. Sie können einen RSS-Feed abonnieren, der Änderungen in diesem Überarbeitungsverlauf auflistet, und zwar über einen Link in dem Dokument.
-
YouTube Analytics API (gezielte Suchanfragen)
-
Hinweis: Diese Mitteilung wird eingestellt.
Die Messwerte in der folgenden Tabelle werden nicht mehr unterstützt. Gleichzeitig werden neue Messwerte eingeführt, die sich auf dieselben Daten beziehen. Das bedeutet, dass die alten Messwerte umbenannt werden. Bis zu den in der Tabelle aufgeführten Einstellungsdaten werden von der YouTube Analytics API beide Messwertnamen unterstützt.
Alter Messwertname Neuer Messwertname Datum der Unterstützung earnings
estimatedRevenue
10. August 2017 adEarnings
estimatedAdRevenue
4. November 2016 redPartnerRevenue
estimatedRedPartnerRevenue
4. November 2016 impressionBasedCpm
cpm
4. November 2016 impressions
adImpressions
4. November 2016 Der Messwert
earnings
war ein Hauptmesswert und wird ab dem Datum dieser Ankündigung für ein Jahr unterstützt. Die anderen Messwerte, bei denen es sich nicht um die Kernmesswerte handelt, werden drei Monate lang bis zum 4. November 2016 unterstützt.Bis zum 4. November 2016 können in einer API-Anfrage beispielsweise die Messwerte
impressionBasedCpm
undcpm
oder beides angegeben werden. Danach wird jedoch nur noch der Messwertcpm
unterstützt. - Die Dimension
insightTrafficSourceType
unterstützt zwei neue Dimensionswerte:CAMPAIGN_CARD
: Diese Zugriffsquelle wird nur für Rechteinhaberberichte unterstützt. Er weist darauf hin, dass die Aufrufe von von Nutzern hochgeladenen Videos stammen, auf die Anspruch erhoben wurde, mit denen der Rechteinhaber den aufgerufenen Inhalt beworben hat.END_SCREEN
: Die Daten beziehen sich auf Aufrufe über den Abspann eines anderen Videos.
Für beide neuen Besucherquellen können Sie auch einen
traffic source detail
-Bericht abrufen. In beiden Fällen gibt die DimensioninsightTrafficSourceDetail
das Video an, von dem aus der Zuschauer weitergeleitet wurde. -
Für die Dimension „
adType
“ wird jetzt der Wert „auctionBumperInstream
“ unterstützt, der sich auf eine nicht überspringbare Videoanzeige mit einer Dauer von bis zu sechs Sekunden bezieht, die abgespielt wird, bevor ein Video wiedergegeben werden kann.
-
-
YouTube Reporting API (Bulk-Berichte)
- Für die Dimension
traffic_source_type
werden jetzt folgende Werte unterstützt:19
: Diese Zugriffsquelle wird nur für Rechteinhaberberichte unterstützt. Er weist darauf hin, dass die Aufrufe von von Nutzern hochgeladenen Videos stammen, auf die Anspruch erhoben wurde, mit denen der Rechteinhaber den aufgerufenen Inhalt beworben hat.20
: Die Daten beziehen sich auf Aufrufe über den Abspann eines anderen Videos.
Bei beiden neuen Zugriffsquellen gibt die Dimension
traffic_source_detail
das Video an, von dem der Zuschauer gekommen ist. -
Die Liste der Kernmesswerte der API wurde korrigiert:
estimated_partner_revenue
als Hauptmesswert aufgeführt undearnings
aus dieser Liste entfernt. Der Messwertearnings
wurde in der YouTube Reporting API noch nie unterstützt. -
Für die Dimension „
ad_type
“ wird jetzt der Wert „19
“ unterstützt, der sich auf Bumper-Anzeigen bezieht. Das sind nicht überspringbare Videoanzeigen, die bis zu sechs Sekunden dauern und vor der Wiedergabe eines Videos wiedergegeben werden.
- Für die Dimension
-
YouTube Analytics API (gezielte Suchanfragen)
- Die Listen der unterstützten Messwerte für die folgenden Kanalberichte wurden aktualisiert und enthalten nun Kartenmesswerte. Seit dem 28. Juni 2016 werden in diesen Berichten jetzt Kartenmesswerte unterstützt. Im Überarbeitungsverlauf für diesen Tag wird die Änderung genauer erläutert. Folgende Berichte sind verfügbar:
- Grundlegende Nutzeraktivitäten für US-Bundesstaaten
- Nutzeraktivitäten in US-Bundesstaaten für bestimmte Zeiträume
- Nutzeraktivität nach Bundesland
- Nutzeraktivitäten nach Abostatus
- Nutzeraktivitäten nach Abostatus für Provinzen
- Top-Videos nach Bundesstaat
- Top-Videos für Zuschauer mit und ohne Abo
-
Die Filterlisten für die Berichte zur Zuschauerbindung für Kanäle und die Berichte zur Zuschauerbindung von Rechteinhabern wurden korrigiert. Der Filter
video
ist erforderlich, der Filtergroup
wird jedoch nicht unterstützt.Bisher wurde in der Dokumentation für beide Berichte fälschlicherweise angegeben, dass der Bericht mit einem dieser beiden Filter oder mit keinem dieser Filter abgerufen werden kann.
- Die Listen der unterstützten Messwerte für die folgenden Kanalberichte wurden aktualisiert und enthalten nun Kartenmesswerte. Seit dem 28. Juni 2016 werden in diesen Berichten jetzt Kartenmesswerte unterstützt. Im Überarbeitungsverlauf für diesen Tag wird die Änderung genauer erläutert. Folgende Berichte sind verfügbar:
-
YouTube Reporting API (Bulk-Berichte)
- In der API-Übersicht wurde der Abschnitt zum Abrufen der Download-URL eines Berichts korrigiert, um zu verdeutlichen, dass YouTube herunterladbare Berichte für Tage generiert, an denen keine Daten verfügbar waren. Diese Berichte enthalten eine Kopfzeile, aber keine zusätzlichen Daten. Diese Informationen wurden bereits am 12. April 2016 im Abschnitt Berichtsmerkmale desselben Dokuments aktualisiert.
- Die Liste der Dimensionen im Bericht „
content_owner_asset_cards_a1
“ wurde korrigiert, da im Bericht jetzt die Dimension „card_id
“ verwendet wird. Bisher wurde der Dimensionsname in der Dokumentation fälschlicherweise alscard_title
aufgeführt.
- Grundlegende Statistiken(Kanäle, Rechteinhaber)
- Zeitbasiert(Kanäle, Rechteinhaber)
- Standort des Nutzers (Kanäle, Rechteinhaber)
- Nutzeraktivitäten nach Abostatus (Kanäle, Rechteinhaber)
- Top-Videos (Kanäle, Rechteinhaber)
-
Der Abschnitt Berichtsmerkmale der API-Übersicht wurde aktualisiert, um zu verdeutlichen, dass Berichte ab ihrer Generierung 180 Tage lang über die API verfügbar sind.
Zuvor stand in der Dokumentation bis zu 180 Tage vor dem Datum, an dem die API-Anfrage gesendet wurde, Berichte zur Verfügung. Auch wenn der Originaltext technisch wahr ist, war er bestenfalls ziemlich verwirrend.
-
Die API unterstützt neue Versionen von drei Berichten. Zwei dieser Berichte enthalten auch neue und umbenannte Messwerte:
-
Der Bericht „
content_owner_ad_rates_a1
“ ist die neue Version des Berichts „content_owner_ad_performance_a1
“. Der neu umbenannte Bericht ist mit der vorherigen Version identisch. -
Zwei Berichte in neuen Versionen wurden umbenannt:
- Die neue Version des Berichts „
content_owner_estimated_earnings_a1
“ heißt „content_owner_estimated_revenue_a1
“. - Die neue Version des Berichts „
content_owner_asset_estimated_earnings_a1
“ heißt „content_owner_asset_estimated_revenue_a1
“.
Die beiden neu umbenannten Berichte unterscheiden sich in folgenden Punkten von ihren Vorgänger:
- Sie fügen den neuen Messwert
estimated_partner_red_revenue
hinzu, der die Gesamteinnahmen aus YouTube Red-Abos schätzt. - Sie fügen den neuen Messwert
estimated_partner_transaction_revenue
hinzu, mit dem der Umsatz aus Transaktionen wie kostenpflichtigen Inhalten und der Finanzierung durch Fans abzüglich etwaiger Erstattungen, die von Partnern berechnet werden, geschätzt wird. - Der Messwert
estimated_partner_ad_sense_revenue
wird inestimated_partner_ad_auction_revenue
umbenannt. - Der Messwert
estimated_partner_double_click_revenue
wird inestimated_partner_ad_reserved_revenue
umbenannt.
- Die neue Version des Berichts „
Falls Sie bereits Aufträge zum Erstellen einer älteren Version der Berichte haben, müssen Sie neue Aufträge für die umbenannten Berichte erstellen. Im Zusammenhang mit der Veröffentlichung der neuen Berichtsversionen wurden die Berichte
content_owner_ad_performance_a1
,content_owner_estimated_earnings_a1
undcontent_owner_asset_estimated_earnings_a1
eingestellt.Wenn Sie Jobs für einen dieser Berichte haben, können Sie nicht davon ausgehen, dass YouTube nach dem 22. September 2016 neue Berichte für diese Jobs erstellt. Die erstellten Berichte sind ab dem Zeitpunkt ihrer Erstellung noch 180 Tage verfügbar.
-
-
Die Definition der Eigenschaft
id
der Ressource „reportType
“ wurde aktualisiert, um die aktuell verfügbaren Berichte widerzuspiegeln. -
In der Dokumentation wurden die Namen von zwei Messwerten korrigiert, damit sie mit den Namen in Berichten übereinstimmen. Dies ist eine reine Dokumentationskorrektur und spiegelt keine Änderung des eigentlichen Berichtsinhalts wider:
- Der Name des Messwerts „
estimated_partner_adsense_revenue
“ wurde in „estimated_partner_ad_sense_revenue
“ geändert. Dieser Messwert erscheint jedoch nur in zwei Berichten, die mit diesem Update nicht mehr unterstützt werden. Wie oben beschrieben wurde dieser Messwert in neueren Versionen dieser Berichte inestimated_partner_ad_auction_revenue
umbenannt. - Der Name des Messwerts „
estimated_partner_doubleclick_revenue
“ wurde in „estimated_partner_double_click_revenue
“ geändert. Dieser Messwert erscheint nur in zwei Berichten, die mit diesem Update nicht mehr unterstützt werden. Wie oben beschrieben wurde dieser Messwert in neueren Versionen dieser Berichte inestimated_partner_ad_reserved_revenue
umbenannt.
- Der Name des Messwerts „
-
Die Dokumentation zu Dimensionen für die Reporting API wurde aktualisiert, sodass die Properties
elapsed_video_time_percentage
undaudience_retention_type
nicht mehr aufgeführt werden. Diese Dimensionen werden derzeit in den Berichten, die über die API verfügbar sind, nicht unterstützt. -
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 Messwertelikes
unddislikes
.Wenn Sie bereits einen Job zum Erstellen des Berichts
content_owner_basic_a1
haben, müssen Sie trotzdem einen neuen Job für den Berichtcontent_owner_basic_a2
erstellen. YouTube migriert Rechteinhaber nicht automatisch zur neuen Berichtsversion und erstellt auch nicht automatisch einen Job zum Generieren der neuen Berichtsversion. In einigen Implementierungen kann das Erscheinungsbild eines neuen, unerwarteten Jobs zu einer funktionsgefährdenden Änderung führen.Im Zusammenhang mit der Veröffentlichung des neuen Berichts wurde der Bericht
content_owner_basic_a1
eingestellt. Wenn Sie einen Job für diesen Bericht haben, können Sie davon ausgehen, dass YouTube nach dem 19. August 2016 keine neuen Berichte für diesen Job erstellt. Die erstellten Berichte sind ab dem Zeitpunkt ihrer Erstellung noch 180 Tage verfügbar. -
Die Ressourcen
reportType
,job
undreport
unterstützen alle eine neue Property, die angibt, ob die verknüpfte Ressource einen eingestellten Berichtstyp darstellt:-
Die Eigenschaft
deprecateTime
derreportType
-Ressource gibt mit Datum und Uhrzeit an, wann der Berichtstyp verworfen wird. Diese Property hat nur einen Wert für Berichte, die als veraltet bekannt gegeben werden. Der Wert steht für das Datum, ab dem YouTube keine Berichte dieses Typs mehr generiert.Nachdem ein Berichtstyp als eingestellt bekannt gegeben wurde, erstellt YouTube weitere drei Monate lang Berichte dieses Typs. Beispielsweise haben wir durch die Änderung vom 19. Mai 2016 bekannt gegeben, dass der Bericht
content_owner_basic_a1
eingestellt wird. Daher gibt diedeprecateTime
für diesen Berichtstyp den 19. August 2016 an, nach dem YouTube keine Berichte dieses Typs mehr erstellt. -
Das Attribut
expireTime
derjob
-Ressource gibt mit Datum und Uhrzeit an, wann der Job abgelaufen ist oder abläuft. Diese Eigenschaft hat einen Wert, wenn der mit dem Job verknüpfte Berichtstyp veraltet ist oder wenn für den Job generierte Berichte längere Zeit nicht heruntergeladen wurden. Dieses Datum gibt den Zeitpunkt an, nach dem YouTube keine neuen Berichte für den Job mehr erstellt. -
Das Attribut
jobExpireTime
derreport
-Ressource gibt mit Datum und Uhrzeit das Datum und die Uhrzeit an, zu dem der mit dem Bericht verknüpfte Job entweder abgelaufen ist oder abläuft. Diese Eigenschaft enthält denselben Wert wie die EigenschaftexpireTime
in der Ressourcejob
, wie im vorherigen Element in dieser Liste beschrieben.
-
-
Die Methode
jobs.create
gibt jetzt einen400
-HTTP-Antwortcode (Bad Request
) zurück, wenn Sie versuchen, einen Job für einen verworfenen Bericht zu erstellen. Darüber hinaus werden in der Dokumentation der Methode jetzt mehrere weitere Gründe aufgeführt, die zum Fehlschlagen einer API-Anfrage führen. -
YouTube generiert jetzt Daten für die 180 Tage vor der Planung eines Berichtjobs. Bisher wurden über die Reporting API keine Verlaufsdaten bereitgestellt. Diese Änderung betrifft alle Jobs, auch die, die vor dieser Ankündigung erstellt wurden.
Berichte zu bisherigen Daten werden veröffentlicht, sobald sie verfügbar sind. Es dauert jedoch etwa einen Monat, bis alle bisherigen Daten für eine Stelle veröffentlicht werden. Sie haben also einen Monat nach der Planung eines Berichterstellungsjobs Zugriff auf Daten von etwa sieben Monaten. (Alle Verlaufsdaten für Stellen, die vor dieser Ankündigung erstellt wurden, sollten innerhalb eines Monats nach der Ankündigung veröffentlicht werden.)
Beachten Sie, dass Verlaufsdaten erst seit dem 1. Juli 2015 verfügbar sind. Daher weisen Arbeitsplätze, die vor dem 28. Dezember 2015 geschaffen wurden, weniger als 180 Tage an Verlaufsdaten auf.
Diese Änderungen werden alle im neuen Abschnitt Verlaufsdaten der Reporting API – Übersicht erläutert.
-
Der Abschnitt Berichtsmerkmale in der Übersicht zur YouTube Reporting API wurde aktualisiert:
-
In der Dokumentation steht jetzt, dass Berichte nach ihrer Generierung für einen Zeitraum von 180 Tagen verfügbar und somit für API-Clients zum Download verfügbar sind. Zuvor stand in der Dokumentation bis zu sechs Monate vor dem Datum, an dem die API-Anfrage gesendet wurde, Berichte zur Verfügung.
-
Die Dokumentation wurde aktualisiert, um darauf hinzuweisen, dass die API jetzt herunterladbare Berichte für Tage generiert, an denen keine Daten verfügbar waren. Diese Berichte enthalten Kopfzeilen, aber keine zusätzlichen Daten.
-
-
Die YouTube Reporting API unterstützt demnächst eine Reihe von automatisch erstellten, vom System verwalteten Berichten, die Daten zu Werbeeinnahmen oder YouTube Premium-Aboeinnahmen enthalten. Die Berichte sind für Rechteinhaber verfügbar, die in YouTube Creator Studio bereits manuell auf Umsatzberichte zum Herunterladen zugreifen können. Die neue API-Funktion bietet also programmatischen Zugriff auf diese Daten.
Als Vorbereitung auf die Einführung der vom System verwalteten Berichte werden die folgenden API-Änderungen angekündigt:
-
Die neue
systemManaged
-Eigenschaft derjob
-Ressource gibt an, ob die Ressource einen Job beschreibt, der systemverwaltete Berichte generiert. YouTube erstellt automatisch vom System verwaltete Berichte für YouTube-Rechteinhaber. Rechteinhaber können Jobs, die diese Berichte erstellen, nicht ändern oder löschen. -
Der neue Parameter
includeSystemManaged
der Methodejobs.list
gibt an, ob die API-Antwort Jobs für vom System verwaltete Berichte enthalten soll. Der Standardwert des Parameters istfalse
. -
Der neue Parameter
startTimeAtOrAfter
der Methodejobs.reports.list
gibt an, dass die API-Antwort nur dann Berichte enthalten darf, wenn die frühesten Daten im Bericht dem angegebenen Datum entsprechen oder danach liegen. Ebenso gibt der ParameterstartTimeBefore
an, dass die API-Antwort nur Berichte enthalten soll, wenn die frühesten Daten im Bericht vor dem angegebenen Datum liegen.Im Gegensatz zum Parameter
createdAfter
der Methode, der sich auf den Zeitpunkt der Berichterstellung bezieht, beziehen sich die neuen Parameter auf die Daten im Bericht. -
Die neue
systemManaged
-Eigenschaft derreportType
-Ressource gibt an, ob die Ressource einen vom System verwalteten Bericht beschreibt. -
Der neue Parameter
includeSystemManaged
der MethodereportTypes.list
gibt an, ob die API-Antwort vom System verwaltete Berichte enthalten soll. Der Standardwert des Parameters istfalse
.
-
- In der YouTube Reporting API unterstützt die Dimension
sharing_service
die folgenden neuen Werte:82
: Dialogfeld zur iOS-Systemaktivität83
: Google-Posteingang84
: Android Messenger
- In der YouTube Analytics API unterstützt die Dimension
sharingService
die folgenden neuen Werte:ANDROID_MESSENGER
: Android MessengerINBOX
: Google-PosteingangIOS_SYSTEM_ACTIVITY_DIALOG
: Dialogfeld zur iOS-Systemaktivität
- Die Dimension
playback_location_type
unterstützt zwei neue Dimensionswerte:7
: Die Daten beziehen sich auf Aufrufe auf der Startseite oder dem Startbildschirm von YouTube, im Abofeed des Nutzers oder in einer anderen YouTube-Suchfunktion.8
: Die Daten beziehen sich auf Aufrufe, die direkt auf der YouTube-Suchergebnisseite erfolgt sind.
- Die Dimension „
traffic_source_type
“ unterstützt jetzt „18
“ als Dimensionswert. Dieser Wert gibt an, dass die Videoaufrufe von einer Seite stammen, auf der alle Videos einer Playlist aufgeführt sind. Diese Quelle unterscheidet sich vom Quelltyp14
. Dieser Wert gibt an, dass die Aufrufe während der Wiedergabe des Videos als Teil einer Playlist erfolgt sind. - Die Dimension
insightPlaybackLocationType
unterstützt zwei neue Dimensionswerte:BROWSE
: Die Daten beziehen sich auf Aufrufe auf der Startseite oder dem Startbildschirm von YouTube, im Abofeed des Nutzers oder in einer anderen YouTube-Suchfunktion.SEARCH
: Die Daten beziehen sich auf Aufrufe, die direkt auf der YouTube-Suchergebnisseite erfolgt sind.
- Die Dimension „
insightTrafficSourceType
“ unterstützt jetzt „YT_PLAYLIST_PAGE
“ als Dimensionswert. Dieser Wert gibt an, dass die Videoaufrufe von einer Seite stammen, auf der alle Videos einer Playlist aufgeführt sind. Diese Quelle unterscheidet sich vom QuelltypPLAYLIST
. Dieser gibt an, dass die Aufrufe bei der Wiedergabe des Videos als Teil einer Playlist erfolgt sind. - In der YouTube Reporting API wird für die Dimension
operating_system
der Wert21
verwendet, um Aufrufe zu identifizieren, die über Chromecast erfolgen. - In der YouTube Analytics API wird für die Dimension
operatingSystem
der WertCHROMECAST
verwendet, um Aufrufe zu identifizieren, die über Chromecast erfolgen. -
Die YouTube Analytics API unterstützt jetzt drei neue Dimensionen für Wiedergabedetails, die in verschiedenen Berichten zu Kanälen und Rechteinhabern verwendet werden können:
liveOrOnDemand
: Diese Dimension gibt an, ob die Daten im Bericht Nutzeraktivitäten während einer Liveübertragung beschreiben.subscribedStatus
: Diese Dimension gibt an, ob die Messwerte zur Nutzeraktivität in den Daten Zuschauern zugeordnet werden, die den Kanal des Videos oder der Playlist abonniert haben.youtubeProduct
: Diese Dimension gibt die YouTube-Property an, auf der die Nutzeraktivität stattgefunden hat. Mögliche Werte sind die YouTube-Website (oder YouTube App), YouTube Gaming und YouTube Kids.
Die Dokumentation wurde aktualisiert, um neue Berichte zu Wiedergabedetails zu finden, die für Kanäle und Rechteinhaber zur Verfügung stehen. Außerdem wurden viele andere Berichte aktualisiert, um zu beachten, dass eine oder mehrere dieser Dimensionen optional als Dimensionen und/oder Filter in diesen Berichten verwendet werden können.
-
Das Format der Tabellen, in denen die Berichte erläutert werden, wurde geändert, damit Sie gültige Kombinationen von Dimensionen, Messwerten und Filtern leichter ermitteln können, mit denen sich die einzelnen Berichte abrufen lassen. In der folgenden Tabelle wird der Bericht „Gerätetyp“ für Channels erläutert. Darin wird das neue Format dargestellt:
Inhalt Abmessungen: Erforderlich deviceType 0 oder mehr verwenden day, liveOrOnDemand, subscribedStatus, youtubeProduct Messwerte: Mindestens 1 verwenden Aufrufe, estimatedMinutesWatched Filter: „0“ oder „1“ verwenden Land, Provinz, Kontinent, subContinent „0“ oder „1“ verwenden Video, Gruppe 0 oder mehr verwenden operatingSystem, liveOrOnDemand, subscribedStatus, youtubeProduct Die Terminologie, die Pflichtfelder und optionale Felder beschreibt, wird in der Dokumentation zu Kanal- und Rechteinhaberberichten erläutert.
-
Die YouTube Analytics API löscht jetzt automatisch Entitäten, für die der API-Nutzer keine Daten aus Filtern abrufen kann, die mehrere Werte unterstützen (
video
,playlist
undchannel
). Bisher hat der API-Server nur einen Fehler zurückgegeben, wenn der API-Nutzer für mindestens eines der angegebenen Elemente nicht auf die Daten zugreifen konnte.Angenommen, ein Nutzer sendet eine API-Anfrage, in der der Filter
video
20 Video-IDs auflistet. Der Nutzer besitzt 18 Videos. Eine Video-ID kennzeichnet jedoch ein Video, das einem anderen Kanal gehört, und eine andere ID für ein gelöschtes Video, das daher nicht mehr existiert. In diesem Fall gibt der API-Server nicht mehr einen Fehler zurück, sondern löscht jetzt die beiden Videos, auf die der Nutzer keinen Zugriff hat. Die API-Antwort enthält dann Daten für die 18 Videos, die dem API-Nutzer gehören. -
Wenn du Daten für ein leeres
group
in YouTube Analytics anfragen, gibt die API jetzt einen leeren Datensatz und keinen Fehler zurück. -
Die
groupItems.insert
-Methode der YouTube Analytics API gibt jetzt einen nicht autorisierten Fehler (403
-HTTP-Antwortcode) zurück, wenn du versuchst, einer Gruppe eine Entität hinzuzufügen, aber keinen Zugriff auf diese Entität hast. Früher hätten Sie mit der API die Entität der Gruppe hinzufügen können, aber später wurde beim Versuch, Berichtsdaten für diese Gruppe abzurufen, ein nicht autorisierter Fehler zurückgegeben. -
Die
groups.list
-Methode der YouTube Analytics API unterstützt jetzt die Paginierung. Wenn die API-Antwort nicht alle verfügbaren Gruppen enthält, gibt der ParameternextPageToken
der Antwort ein Token an, mit dem die nächste Ergebnisseite abgerufen werden kann. Legen Sie den ParameterpageToken
der Methode auf diesen Wert fest, um zusätzliche Ergebnisse abzurufen. -
Die YouTube Analytics API unterstützt jetzt den Messwert
redPartnerRevenue
, mit dem der geschätzte Gesamtumsatz aus YouTube Red-Abos für die ausgewählten Berichtsdimensionen angegeben wird. Der Wert des Messwerts spiegelt Einnahmen aus Musik- und anderen Inhalten wider und wird am Monatsende angepasst.Die Liste der Berichte zu Rechteinhabern der YouTube Analytics API wurde aktualisiert. Sie enthält jetzt die Videoberichte, die den Messwert
redPartnerRevenue
unterstützen:- Grundlegende Statistiken
- Zeitbasiert
- Standort der Nutzer
- Top-Videos: Für diesen Bericht wird
redPartnerRevenue
auch als Sortiermesswert unterstützt. Das bedeutet, dass du eine Liste von Videos abrufen kannst, die nach ihren YouTube Red-Einnahmen sortiert sind.
-
In der Berichtsdefinition Top-Videos für die YouTube Analytics API ist jetzt angegeben, dass dieser Bericht auch die folgenden Messwerte zu Einnahmen unterstützt:
earnings
,adEarnings
,grossRevenue
,monetizedPlaybacks
,playbackBasedCpm
,impressions
undimpressionBasedCpm
. -
In der Dokumentation für die Dimension „
date
“ der YouTube Reporting API wurde korrigiert, dass sie sich nun auf den 24-Stunden-Zeitraum ab 00:00 Uhr Pacific Time (UTC-8) bezieht. Zuvor stand in der Dokumentation als Startdatum 00:00 Uhr (GMT) fest.Außerdem wurde die Dokumentation zur YouTube Analytics API aktualisiert. Alle datumsbezogenen Dimensionen (
day
,7DayTotals
,30DayTotals
undmonth
) beziehen sich jetzt auf Zeiträume, die um 00:00 Uhr Pacific Time (UTC-8) beginnen. -
Die
jobs.reports.list()
-Methode der YouTube Reporting API unterstützt jetzt dencreatedAfter
-Abfrageparameter. Falls angegeben, gibt dieser Parameter an, dass in der API-Antwort nur Berichte aufgeführt werden sollen, die nach dem angegebenen Datum und der angegebenen Uhrzeit erstellt wurden, einschließlich neuer Berichte mit Daten, die aufgefüllt wurden. Beachten Sie, dass sich der Parameterwert auf den Zeitpunkt der Berichterstellung bezieht und nicht auf das Datum, das den zurückgegebenen Daten zugeordnet ist.Der Parameterwert ist ein Zeitstempel im Format RFC3339 UTC „Zulu“ in Mikrosekunden. Beispiel:
"2015-10-02T15:01:23.045678Z"
.Die Best Practices für die YouTube Reporting API wurden ebenfalls aktualisiert. Darin wird erläutert, wie du mithilfe des
createdAfter
-Parameters die wiederholte Verarbeitung desselben Berichts vermeiden kannst. -
Die Definitionen der
createTime
-Eigenschaft derjob
-Ressource und derstartTime
-,endTime
- undcreateTime
-Attribute derreport
-Ressource wurden korrigiert, um zu beachten, dass die Eigenschaftswerte auf Mikrosekunden und nicht auf Nanosekunden genau sind. Darüber hinaus geben alle Definitionen nun korrekt wieder, dass der Attributwert ein Zeitstempel ist. -
Die Dokumentation für die Dimension „
sharingService
“ der YouTube Analytics API wurde aktualisiert und enthält nun eine Liste möglicher Dimensionswerte. Die Liste enthält eine Reihe neuer unterstützter Dienste.Die Definition der Dimension „
sharing_service
“ der YouTube Reporting API wurde aktualisiert, um die neuen unterstützten Werte aufzulisten. Die neuen enum-Werte, die größer als59
sind, sind die neuen Werte in der Liste. -
Die neue YouTube Reporting API ruft Bulk-Datenberichte ab, die YouTube Analytics-Daten für einen Kanal oder Rechteinhaber enthalten. Es wurde für Anwendungen entwickelt, die große Datasets importieren können und Tools zum Filtern, Sortieren und Mining dieser Daten bieten.
Jeder Bericht der YouTube Reporting API enthält vordefinierte Dimensionen und Messwerte. In YouTube Analytics API-Berichten werden auch Messwerte und Dimensionen verwendet. In einem Bericht hat jede Datenzeile eine eindeutige Kombination von Dimensionswerten. Sie können Daten zeilenübergreifend auf der Grundlage von Dimensionswerten aggregieren, um Messwerte für einzelne Videos, Länder, Livevideos, abonnierte Nutzer usw. zu berechnen.
Mit der API kannst du Berichterstellungsjobs planen, von denen jeder einen Bericht identifiziert, der von YouTube erstellt werden soll. Sobald Sie einen Job eingerichtet haben, erstellt YouTube einen täglichen Bericht, der asynchron heruntergeladen werden kann. Jeder Bericht enthält Daten für einen eindeutigen Zeitraum von 24 Stunden.
-
Es handelt sich zwar um unterschiedliche APIs, mit der YouTube Analytics API und der YouTube Reporting API können Entwickler aber auch YouTube Analytics-Daten abrufen. Da beide APIs Zugriff auf ähnliche Datensätze ermöglichen, wird die Dokumentation für die beiden APIs als ein Satz Dokumentation veröffentlicht.
- Der Tab Leitfäden in der Dokumentation enthält allgemeine Informationen für beide APIs, einschließlich einer Anleitung zum Autorisieren von API-Anfragen.
- Der Tab Bulk-Berichte enthält Referenzdokumentation und andere Inhalte speziell für die YouTube Reporting API.
- Der Tab Gezielte Abfragen enthält eine Referenzdokumentation und andere Inhalte speziell für die YouTube Analytics API.
- Auf dem Tab Beispiele finden Sie Codebeispiele, die für eine der beiden APIs verfügbar sind.
- Auf dem Tab Tools werden zusätzliche Ressourcen aufgeführt, mit denen Entwickler eine der beiden APIs implementieren können.
-
Die API-Dokumentation wurde neu strukturiert, um die API verständlicher zu machen. Daher beziehen sich diese Änderungen nicht auf neue Funktionen:
-
Die Dokumentation enthält jetzt eine Seite mit allen verfügbaren Kanalberichten und eine weitere Seite mit allen verfügbaren Rechteinhaberberichten. Bisher war die Dokumentation auf separaten Seiten unter anderem für Kanalvideoberichte und Kanalplaylists enthalten.
-
Die neue Datenmodellübersicht bietet eine klarere Einführung in die Funktionsweise der API. Insbesondere wird erläutert, wie YouTube Messwerte, Dimensionen und Filter zur Berechnung von Berichtwerten verwendet.
-
Die
reports.query
-Methode der API, die Sie zum Abrufen von Berichten verwenden, ist jetzt separat dokumentiert. Die Informationen auf dieser Seite befanden sich zuvor auf einigen anderen Seiten. Auf der neuen Seite können Sie leichter erkennen, welche Informationen zum Abrufen eines Berichts gesendet werden müssen.
-
-
Der neue Messwert
adEarnings
beinhaltet die geschätzten Gesamteinnahmen (Nettoumsatz) aus allen von Google verkauften Werbequellen. Es handelt sich nicht um einen zentralen Messwert. Die API unterstützt den MesswertadEarnings
für alle Berichte, in denen der Messwertearnings
bereits unterstützt wird.Außerdem wurde die Definition des Messwerts „
earnings
“ korrigiert. Der Wert beinhaltet nun die geschätzten Gesamteinnahmen aus allen von Google verkauften Werbequellen sowie aus nicht werbebezogenen Quellen. Bisher wurde in der Definition fälschlicherweise angegeben, dass der Messwert nur Einnahmen aus Werbequellen enthielt. -
Der Messwert „
primaryAdGrossRevenue
“ wurde eingestellt. Verwenden Sie stattdessen den MesswertgrossRevenue
, um Umsatzdaten abzurufen. -
Neben dem eingestellten Messwert
primaryAdGrossRevenue
werden in Berichten zur Anzeigenleistung die MesswertemonetizedPlaybacks
undplaybackBasedCpm
nicht mehr unterstützt. Mehrere Videoberichte unterstützen diese Messwerte jedoch weiterhin. -
Die API unterstützt jetzt zwei neue Messwerte für Videoberichte:
videosAddedToPlaylists
undvideosRemovedFromPlaylists
. Die Listen der Videoberichte für Kanäle und Rechteinhaber wurden aktualisiert, sodass nur die Berichte angezeigt werden, die die neuen Messwerte unterstützen.videosAddedToPlaylists
: Gibt an, wie oft Videos im Bereich der Abfrage YouTube-Playlists hinzugefügt wurden. Möglicherweise wurden die Videos der Playlist des Videoinhabers oder den Playlists anderer Kanäle hinzugefügt.videosRemovedFromPlaylists
: Gibt an, wie oft Videos, die in der Abfrage enthalten waren, aus YouTube-Playlists entfernt wurden. Möglicherweise wurden die Videos aus der Playlist des Videoinhabers oder aus den Playlists anderer Kanäle entfernt.
Beide Messwerte umfassen Standardplaylists wie die Playlist „Später ansehen“. Dabei werden jedoch keine Playlists berücksichtigt, zu denen ein Video automatisch hinzugefügt wird. Dazu zählen beispielsweise die Playlist „Uploads“ eines Kanals oder der Wiedergabeverlauf eines Nutzers. Diese Messwerte spiegeln die absolute Anzahl der Hinzufügungen und Löschungen wider. Wenn ein Nutzer also ein Video zu einer Playlist hinzufügt, es entfernt und anschließend wieder hinzufügt, zeigen die Messwerte an, dass das Video zu zwei Playlists und aus einer entfernt wurde.
Daten für diese Messwerte stehen seit dem 1. Oktober 2014 zur Verfügung.
-
Die Messwerte
favoritesAdded
undfavoritesRemoved
werden ab dieser Ankündigung nicht mehr unterstützt. Dies sind beide Kernmesswerte und unterliegen der in den Nutzungsbedingungen festgelegten Richtlinie zur Einstellung von Produkten und Diensten. -
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 Messwerteearnings
,grossRevenue
,playbackBasedCpm
undimpressionBasedCpm
in die angegebene Währung um. Die zurückgegebenen Werte sind Schätzungen, die auf Grundlage von Wechselkursen berechnet wurden, die sich täglich ändern.Der Parameterwert ist ein dreistelliger Währungscode gemäß ISO 4217. Der Standardwert ist
USD
. Die Parameterdefinition enthält eine Liste der unterstützten Währungscodes. -
Mit der API können jetzt YouTube Analytics-Gruppen erstellt und verwaltet sowie Berichtsdaten für diese Gruppen abgerufen werden.
-
Gruppen erstellen und verwalten
Dieses Update enthält die Ressourcen
group
undgroupItem
zum Erstellen und Verwalten von Gruppen.- Die Ressource
group
steht für eine Analytics-Gruppe, eine benutzerdefinierte Sammlung von bis zu 200 Kanälen, Videos, Playlists oder Assets. Die API unterstützt die Methodenlist
,insert
,update
unddelete
für diese Ressource. - Die Ressource
groupItem
steht für ein Element in einer Analytics-Gruppe. Die API unterstützt die Methodenlist
,insert
unddelete
für diese Ressource.
Sie können also beispielsweise eine Gruppe mit der Methode
groups.insert
erstellen und ihr dann mit der MethodegroupItems.insert
Elemente hinzufügen. - Die Ressource
-
Berichtsdaten für eine Gruppe abrufen
Die Dokumentation zu Dimensionen wurde aktualisiert und enthält nun die Dimension
group
, die als Filter für viele Channelberichte und Berichte zu Rechteinhabern verwendet werden kann. Wenn Sie dengroup
-Filter verwenden, gibt die API Daten für alle Elemente in dieser Gruppe zurück. Mit der API können derzeit keine Berichte für Asset-Gruppen erstellt werden.
Weitere Informationen zu Gruppen in YouTube Analytics findest du in der YouTube-Hilfe.
-
-
Die API unterstützt die Dimension
show
nicht mehr. -
In der API können jetzt mehrere Werte für die Dimensionen
video
,playlist
,channel
undshow
angegeben werden, wenn diese Dimensionen als Filter verwendet werden. Wenn du mehrere Werte angeben möchtest, setze denfilters
-Parameterwert auf eine durch Kommas getrennte Liste der Video-, Playlist-, Kanal- oder Sendungs-IDs, für die die API-Antwort gefiltert werden soll. Für den Parameterwert können bis zu 200 IDs angegeben werden.Wenn Sie mehrere Werte für denselben Filter angeben, können Sie ihn der Liste der Dimensionen hinzufügen, die Sie für die Anfrage angeben. Das gilt auch dann, wenn der Filter für einen bestimmten Bericht nicht als unterstützte Dimension aufgeführt ist. Wenn Sie den Filter zur Liste der Dimensionen hinzufügen, verwendet die API die Filterwerte auch zum Gruppieren der Ergebnisse.
Ausführliche Informationen zu dieser Funktion finden Sie in der Parameterdefinition
filters
. -
Beim Abrufen eines Channelberichts können Sie jetzt Daten für den Channel des authentifizierten Nutzers abrufen. Dazu setzen Sie den Wert des Parameters
ids
aufchannel==MINE
. Sie können denids
-Parameter auch weiterhin aufchannel==CHANNEL_ID
setzen, um Daten für den angegebenen Kanal abzurufen. -
Die API unterstützt jetzt Playlist-Berichte, die Statistiken zu Videoaufrufen enthalten, die im Kontext einer Playlist erfolgen. Playlist-Berichte sind für Kanäle und Rechteinhaber verfügbar.
Alle Playlist-Berichte unterstützen die Messwerte
views
undestimatedMinutesWatched
, einige auch den MesswertaverageViewDuration
.Darüber hinaus unterstützen alle Playlist-Berichte die folgenden neuen Messwerte. Jeder dieser Messwerte spiegelt nur Playlist-Aufrufe im Web wider.
playlistStarts
: Gibt an, wie oft die Wiedergabe einer Playlist durch Zuschauer gestartet wurde.viewsPerPlaylistStart
: Die durchschnittliche Anzahl an Videoaufrufen, die nach dem Start einer Playlist stattgefunden haben.averageTimeInPlaylist
: Die geschätzte durchschnittliche Zeit in Minuten, die ein Zuschauer nach dem Start der Playlist Videos in einer Playlist angesehen hat.
Alle Anfragen zum Abrufen eines Playlist-Berichts müssen den
isCurated
-Filter verwenden, der auf1
(isCurated==1
) gesetzt sein muss. -
Die API unterstützt jetzt einen Bericht zur Zuschauerbindung. In diesem Bericht wird die Fähigkeit eines Videos bewertet, sein Publikum zu binden. Mit der neuen Dimension
elapsedVideoTimeRatio
des Berichts wird die verstrichene Videodauer für die entsprechenden Messwerte erfasst:-
Der Messwert
audienceWatchRatio
gibt das absolute Verhältnis der Zuschauer an, die sich das Video an einer bestimmten Stelle im Video ansehen. Das Verhältnis wird berechnet, indem die Häufigkeit, mit der ein Teil eines Videos angesehen wurde, mit der Gesamtzahl der Aufrufe des Videos verglichen wird.Ein Teil des Videos kann während eines bestimmten Aufrufs mehrmals oder gar nicht angesehen werden. Wenn Nutzer beispielsweise zurückspulen und denselben Teil eines Videos mehrmals ansehen, kann das absolute Verhältnis für diesen Teil des Videos größer als
1
sein. -
Der Messwert
relativeRetentionPerformance
gibt an, wie gut ein Video die Zuschauer während der Wiedergabe im Vergleich zu allen YouTube-Videos ähnlicher Länge fesselt. Ein Wert von 0 bedeutet, dass die Nutzerbindung durch das Video schlechter als jedes andere Video ähnlicher Länge ist. Ein Wert von 1 bedeutet, dass das Video die Zuschauerbindung besser einspart als jedes andere Video ähnlicher Länge. Ein Medianwert von 0,5 bedeutet, dass die Hälfte der Videos ähnlicher Länge Zuschauer besser an sich binden und die andere Hälfte schlechter an sich binden.
Sie können auch den Filter
audienceType
verwenden, damit der Bericht nur Daten enthält, die mit organischen Aufrufen, Aufrufen über TrueView In-Stream-Anzeigen oder Aufrufe über TrueView In-Display-Anzeigen verknüpft sind. (Organische Aufrufe sind das direkte Ergebnis von Nutzeraktionen, z. B. einer Suche nach einem Video oder einem Klick auf ein vorgeschlagenes Video.) -
-
Die API unterstützt mehrere neue Messwerte im Zusammenhang mit Annotationen. Die unten aufgeführten Messwerte können mit allen Berichten abgerufen werden, in denen bisher die Messwerte
annotationClickThroughRate
undannotationCloseRate
unterstützt wurden.annotationImpressions
: Die Gesamtzahl der Anmerkungsimpressionen.annotationClickableImpressions
: Die Anzahl der Anmerkungen, die angezeigt wurden und angeklickt werden konnten.annotationClosableImpressions
: Die Anzahl der Anmerkungen, die angezeigt wurden und geschlossen werden konnten.annotationClicks
: Die Gesamtzahl der angeklickten Anmerkungen.annotationCloses
: Die Gesamtzahl der geschlossenen Anmerkungen.
Alle neuen Messwerte sind Kernmesswerte und unterliegen der Richtlinie zur Einstellung von Produkten und Diensten. Beachten Sie jedoch, dass Daten für die neuen Messwerte ab dem 16. Juli 2013 verfügbar sind. (Daten zu den Messwerten
annotationClickThroughRate
undannotationCloseRate
stehen seit dem 10. Juni 2012 zur Verfügung.) -
„
GOOGLE_SEARCH
“ wird nicht mehr als separater Wert für die Dimension „insightTrafficSourceType
“ erfasst. Stattdessen werden Verweise aus Google-Suchergebnissen jetzt dem Besucherquellentyp „EXT_URL
“ zugeordnet. Daher ist es nicht mehr möglich, eineninsightTrafficSourceDetail
-Bericht abzurufen, bei dem derinsightTrafficSourceType
-Filter aufGOOGLE_SEARCH
festgelegt ist. -
Das Dokument Berichte zu Rechteinhabern wurde aktualisiert, um zu verdeutlichen, dass die Messwerte
subscribersGained
undsubscribersLost
jetzt für Inhalte abgerufen werden können, auf die ein Rechteinhaber Anspruch erhoben hat oder die von einem Rechteinhaber hochgeladen wurden.Die Änderung ist im ersten Bericht zu grundlegenden Statistiken für Rechteinhaber sichtbar, der jetzt die Filter
claimedStatus
unduploaderType
unterstützt. -
Das Dokument zu Beispielanfragen wurde umgestaltet, um Beispiele in Kategorien zu gruppieren. Dabei wird ein Tab-Format verwendet, das dem vor Kurzem für Kanal- und Rechteinhaberberichte veröffentlichten Format ähnelt. Mit dem neuen Design werden die Beispiele in die folgenden Kategorien gruppiert:
- Grundlegende Statistiken
- Zeitbasiert
- Zielregion
- Wiedergabeort
- Zugriffsquelle
- Gerät/Betriebssystem
- Demografische Gruppe
- Sozial
- Einnahmen/Werbung (nur für Rechteinhaber-Berichte)
-
Das Dokument zu Beispielanfragen enthält jetzt neue Beispiele für den Abruf von Daten zu Provinzen in Kanalberichten oder Berichten zu Rechteinhabern.
-
Provinzspezifische Messwerte für US-Bundesstaaten und Washington D.C.: Mit diesem Bericht wird eine Aufschlüsselung der Aufrufzahlen nach Provinz nach Provinz sowie andere Statistiken für die Videos eines Kanals abgerufen. Die Daten beziehen sich auf US-Bundesstaaten und Washington D.C. Im Beispiel wird die Dimension
province
und der Parameterfilters
verwendet, um die Antwort auf Ergebnisse für die USA einzuschränken. -
Demografische Merkmale der Zuschauer in Kalifornien (Altersgruppe und Geschlecht): In diesem Bericht werden Statistiken zur Altersgruppe und zum Geschlecht von Zuschauern in Kalifornien abgerufen, die sich Videos eines Kanals angesehen haben. In Berichten zu Inhalten des Rechteinhabers werden außerdem die beanspruchten Inhalte eines Rechteinhabers angezeigt. In diesem Beispiel wird der Parameter
filters
verwendet, damit die Antwort nur Daten für eine bestimmte Provinz enthält.
-
-
Die Definition der Dimension „
province
“ wurde aktualisiert. Wennprovince
im Parameterwertdimensions
enthalten ist, müssen die Daten in der Anfrage außerdem auf die USA beschränkt werden. Dazu wirdcountry==US
in den Parameterwertfilters
aufgenommen. -
Die Dokumente mit den unterstützten Berichten zu Kanälen und Rechteinhabern wurden überarbeitet. Anstatt eine Tabelle bereitzustellen, in der alle möglichen Berichte aufgelistet sind, werden die Berichte in jedem Dokument in Kategorien gruppiert:
- Grundlegende Statistiken
- Zeitbasiert
- Zielregion
- Wiedergabeort
- Zugriffsquelle
- Gerät/Betriebssystem
- Demografische Gruppe
- Sozial
- Top-Videos
In jedem Dokument werden diese Kategorien als Liste von Tabs angezeigt. Klicken Sie auf einen beliebigen Tab, um die unterstützten Berichte dieser Kategorie zu sehen.
-
Die API unterstützt jetzt drei neue geografische Dimensionen:
province
,continent
undsubContinent
.-
Mit der Dimension
province
können Sie Statistiken für US-Bundesstaaten und für den District of Kolumbien abrufen. Die API unterstützt zwei Verwendungsmöglichkeiten für diese Dimension:-
Die API unterstützt zwei Berichte, die Statistiken nach Bundesstaat aufschlüsseln. Beide Berichte sind für Kanäle und Rechteinhaber verfügbar.
- Der Bericht enthält verschiedene Statistiken, darunter die Anzahl der Aufrufe und die geschätzte Wiedergabezeit in Minuten.
- Der zeitbasierte Bericht liefert die gleichen Statistiken, fasst die Daten jedoch für jeweils 7 Tage, 30 Tage oder jeden Monat zusammen.
-
Mithilfe des Abfrageparameters
filters
können Sie festlegen, dass ein Bericht nur Statistiken für einen bestimmten Status enthält. Mehrere Berichte unterstützen diese Art der Filterung, z. B. Berichte nach Standort, zu Wiedergabeorten, zu Zugriffsquellen, zu Geräten, zum Betriebssystem, nach demografischen Merkmalen und zu den Top-Videos.
-
-
Die Dimension
continent
gibt einen statistischen Regionscode der Vereinten Nationen (UN) an, der einen Kontinent angibt. Diese Dimension kann nur als Filter verwendet werden. -
Die Dimension
subContinent
gibt einen statistischen Regionscode der Vereinten Nationen (UN) an, der eine Subregion eines Kontinents angibt. Diese Dimension kann auch nur als Filter verwendet werden.Da jede Subregion nur einem Kontinent zugeordnet ist, müssen Sie nicht zusätzlich den
continent
-Filter verwenden, wenn Sie densubContinent
-Filter nutzen. Die API gibt einen Fehler zurück, wenn in einer Anfrage beide Dimensionen verwendet werden.
-
-
Die Dokumentation wurde korrigiert und die Dimension „
insightTrafficSourceDetail
“ enthält nun nicht mehr den Wert „insightTrafficSourceType
“ (PROMOTED
) als gültigen Filterwert. -
Die YouTube Analytics API unterliegt jetzt der Richtlinie zur Einstellung von Produkten und Diensten, die in den Nutzungsbedingungen beschrieben ist. Die nicht zu den Kernbereichen gehörenden Dimensionen der API und Messwerte, die nicht zu den Kernmesswerten gehören, unterliegen jedoch nicht der Richtlinie zur Einstellung von Produkten und Diensten. Auf den Seiten Dimensionen und metrics werden nun Kerndimensionen und -messwerte aufgelistet. Außerdem wurden die Definitionen auf diesen Seiten aktualisiert, um Kerndimensionen und -messwerte explizit anzugeben.
-
Die API unterstützt jetzt
EXTERNAL_APP
als Wert für die DimensioninsightPlaybackLocationType
. Im Rahmen dieser Aktualisierung werden Wiedergaben ab dem 10. September 2013 nicht mehr alsMOBILE
-Wiedergaben kategorisiert. Wiedergaben von Mobilgeräten, die vor diesem Datum stattgefunden haben, werden jedoch weiterhin anhand dieses Werts kategorisiert.Mit diesem Update werden mobile Wiedergaben jetzt abhängig von der Art der App als
WATCH
-,EMBEDDED
- oderEXTERNAL_APP
-Wiedergaben eingestuft. -
Die API unterstützt jetzt
PLAYLIST
als Wert für die DimensioninsightTrafficSourceType
. Der Wert gibt an, dass Videoaufrufe über eine Playlist verwiesen wurden. Bisher wurden diese Aufrufe mithilfe der KategorieYT_OTHER_PAGE
der Dimension klassifiziert. -
Die API unterstützt jetzt die Möglichkeit, Berichte nach mehreren Dimensionen und Messwerten zu sortieren. Das Beispiel-Request-Dokument enthält ein neues Beispiel, in dem diese Funktionalität veranschaulicht wird: Anfragen nach mehreren Dimensionen/Messwerten sortieren. Die Anfrage ruft Daten zu Besucherquellen ab und hat den
sort
-Parameterwertday,-views
. Die Ergebnisse sind chronologisch sortiert, aber in der ersten Zeile der Ergebnismenge für jeden Tag enthält die erste Zeile Daten für die Besucherquelle, über die die meisten Aufrufe generiert wurden, die zweite Zeile die Daten für die Quelle, von der die nächsthöhere Anzahl an Aufrufen generiert wurde, und so weiter. -
Die API unterstützt jetzt die beiden neuen Dimensionen
deviceType
undoperatingSystem
. Damit lassen sich Daten zu den Geräten abrufen, auf denen sich Zuschauer deine Videos ansehen. Die API unterstützt Berichte, in denen eine oder beide Dimensionen verwendet werden.-
Mit dem Bericht „
deviceType
“ kannst du die Anzahl der Aufrufe und die geschätzte Wiedergabezeit für verschiedene Gerätetypen abrufen, z. B. Computer, Smartphones und Tablets. Mit dem Filter „operatingSystem
“ können Sie auch festlegen, dass der Bericht zu Gerätetypen nur Statistiken für Geräte mit einem bestimmten Betriebssystem enthält, z. B. Android oder iOS. -
Mit dem Bericht „
operatingSystem
“ kannst du die Anzahl der Aufrufe und die geschätzte Wiedergabezeit für verschiedene Betriebssysteme abrufen, z. B. Android, iOS oder Linux. Mit dem FilterdeviceType
können Sie auch festlegen, dass der Betriebssystembericht nur Statistiken für einen bestimmten Gerätetyp enthält, z. B. Mobilgeräte oder Tablets.
Die neuen Berichte zum Gerätetyp und zu Betriebssystem sind für Kanäle und Rechteinhaber verfügbar.
-
-
Das Dokument zu Beispielanfragen wurde aktualisiert und enthält nun drei Geräteberichte für Kanäle und drei Geräteberichte für Rechteinhaber.
-
Für die Dimension „
insightPlaybackLocationType
“ wird unter Umständen der WertYT_OTHER
zurückgegeben. Damit werden Aufrufe angegeben, die nicht unter Verwendung eines der anderen Werte der Dimension klassifiziert wurden. -
Das Dokument Berichte zu Rechteinhabern wurde aktualisiert. Jetzt kannst du den Top-Videobericht in absteigender Reihenfolge nach Einnahmen sortieren, um die Videos mit den höchsten Einnahmen zu ermitteln. Dies ist der erste Bericht in der zweiten Tabelle des Abschnitts Berichte zur Nutzeraktivität und zu Einnahmen.
-
YouTube kann keine experimentellen API-Funktionen und -Dienste mehr identifizieren. Wir stellen dir jetzt stattdessen eine Liste der YouTube APIs zur Verfügung, die dieser Richtlinie zur Einstellung von Produkten und Diensten unterliegen.
-
Die API unterstützt jetzt die Möglichkeit, Messwerte zur Wiedergabezeit (
estimatedMinutesWatched
,averageViewDuration
undaverageViewPercentage
) in Verbindung mit anderen Messwerten wie Aufruf-, Engagement-, Einnahmen- und Anzeigenleistungs-Messwerte abzurufen.Die Listen verfügbarer Kanalberichte und Rechteinhaberberichte wurden entsprechend aktualisiert. Die Listen sind jetzt kürzer, da die Messwerte für die Wiedergabezeit im Rahmen anderer aufgeführten Berichte abgerufen werden können.
Das Dokument Beispiel-API-Anfragen wurde ebenfalls aktualisiert.
-
Die Berichte, in denen die Dimensionen
insightPlaybackLocationDetail
undinsightTrafficSourceDetail
verwendet werden, wurden so optimiert:-
Sie unterstützen jetzt einen optionalen
country
-Filter. -
Rechteinhaber können diese Berichte jetzt mit jeder der folgenden neuen
filter
-Kombinationen abrufen. Alle diese Kombinationen unterstützen auch den optionalen Filtercountry
.-
Details zum Wiedergabeort
channel,insightPlaybackLocationType==EMBEDDED
show,insightPlaybackLocationType==EMBEDDED
claimedStatus,insightPlaybackLocationType==EMBEDDED
uploaderType,insightPlaybackLocationType==EMBEDDED
uploaderType,claimedStatus,insightPlaybackLocationType==EMBEDDED
-
Details zu Zugriffsquellen
channel,insightTrafficSourceType
show,insightTrafficSourceType
claimedStatus,insightTrafficSourceType
uploaderType,insightTrafficSourceType
uploaderType,claimedStatus,insightTrafficSourceType
-
-
-
Das neue Dokument Beispiel-API-Anfragen enthält Beispiele, die zeigen, wie viele verschiedene Arten von Berichten mit YouTube Analytics API abgerufen werden können. Jedes Beispiel enthält eine kurze Beschreibung des Berichts, der durch die Anfrage abgerufen wird. Anschließend werden die Dimensionen, Messwerte, Filter und Sortierparameter für die Anfrage angezeigt.
-
Für die Dimension „
insightTrafficSourceType
“ wird jetzt der Wert „SUBSCRIBER
“ als gültiger Wert unterstützt. Dieser Wert identifiziert Videoaufrufe, die über Feeds auf der YouTube-Startseite oder über YouTube-Abofunktionen generiert wurden. Wenn Sie nach dieser Besucherquelle filtern, gibt das FeldinsightTrafficSourceDetail
den Startseitenfeed oder eine andere Seite an, von der Aufrufe weitergeleitet wurden. -
Die API unterstützt jetzt die beiden neuen Messwerte
annotationClickThroughRate
undannotationCloseRate
, die sich auf Zuschauerinteraktionen mit Anmerkungen beziehen, die in deinen Videos eingeblendet werden. Die Listen der Kanalberichte und Berichte zu Rechteinhabern wurden aktualisiert, um die Berichte zu identifizieren, die die neuen Messwerte unterstützen.annotationClickThroughRate
: Das Verhältnis der Anmerkungen, die Zuschauer angeklickt haben, zur Gesamtzahl der anklickbaren Anmerkungsimpressionen.annotationCloseRate
: Das Verhältnis der von Zuschauern geschlossenen Anmerkungen zur Gesamtzahl der Anmerkungsimpressionen.
-
Die API unterstützt jetzt Messwerte zu Einnahmen und Anzeigenleistung sowie neue Berichte zur Anzeigenleistung. Die Messwerte und Berichte sind nur für YouTube-Contentpartner verfügbar, die am YouTube-Partnerprogramm teilnehmen.
-
Die neu unterstützten Berichte unterstützen wiedergabebasierte Messwerte zur Anzeigenleistung und Messwerte, die auf Impressionen basieren. Weitere Informationen zu Berichten zur Anzeigenleistung findest du in der Dokumentation zu Rechteinhaberberichten.
-
Die neuen unterstützten Messwerte sind unten aufgeführt. Die Liste der Berichte für Rechteinhaber wurde aktualisiert und enthält nun die Berichte, die diese Messwerte unterstützen. Dazu gehören auch die beiden neuen Berichte.
earnings
: Geschätzte Gesamteinnahmen aus allen von Google verkauften Werbequellen.grossRevenue
: geschätzter Bruttoumsatz von Google- oder DoubleClick-Partnern.primaryAdGrossRevenue
: Die geschätzten Bruttoeinnahmen von Google oder DoubleClick-Partnern, zusammengefasst und unter dem primären Anzeigentyp für die Videowiedergaben klassifiziert, die im Bericht enthalten sind.monetizedPlaybacks
: Die Anzahl der Wiedergaben, bei denen mindestens eine Anzeigenimpression ausgeliefert wurde.playbackBasedCpm
: geschätzte Bruttoeinnahmen pro 1.000 Wiedergaben.impressions
: Anzahl der verifizierten Anzeigenimpressionen, die erzielt wurden.impressionBasedCpm
: geschätzte Bruttoeinnahmen pro 1.000 Anzeigenimpressionen.
Hinweis:Weitere Informationen finden Sie in den Definitionen der Messwerte.
-
Jede Anfrage zum Abrufen von Messwerten zu Einnahmen oder Anzeigenleistung muss ein Autorisierungstoken senden, das Zugriff mit dem neuen Bereich
https://www.googleapis.com/auth/yt-analytics-monetary.readonly
gewährt.
-
-
Die API-Dokumentation wurde umstrukturiert, sodass verschiedene Berichtstypen auf separaten Seiten erläutert werden. Daher gibt es jetzt separate Seiten, auf denen die verschiedenen Arten von Kanalberichten und Rechteinhaberberichten erläutert werden.
-
Das API-Referenzhandbuch enthält jetzt einen Abschnitt Beispiele mit Codebeispielen, die zeigen, wie die API mit den Java-, JavaScript-, Python- und Ruby-Clientbibliotheken aufgerufen wird. Das JavaScript-Codebeispiel ist derselbe, der in der Dokumentation der Beispielanwendung ausführlich erläutert wird.
-
Das API-Referenzhandbuch enthält jetzt das APIs Explorer, mit dem Sie die API aufrufen, die API-Anfrage ansehen und echte Daten aus der Antwort abrufen können.
-
Die API unterstützt eine Reihe neuer Berichte für Kanäle und Rechteinhaber, die im Folgenden beschrieben werden. Jeder Bericht ist als Kanalbericht oder Bericht für Rechteinhaber verfügbar. Die Seiten Dimensionen und metrics wurden ebenfalls entsprechend aktualisiert.
-
Der Bericht zum Wiedergabeort gibt die Anzahl der Videoaufrufe an, die auf verschiedenen Arten von Seiten oder Apps stattgefunden haben.
-
Der Detailbericht zum Wiedergabeort zeigt die eingebetteten Player an, die für ein bestimmtes Video die meisten Aufrufe generiert haben. Er bietet eine detailliertere Ansicht als der Bericht zu Wiedergabeorten, da die URLs der beliebtesten eingebetteten Player identifiziert werden.
-
Der Zugriffsquellenbericht gibt die Anzahl der Videoaufrufe an, die über verschiedene Arten von Verweis-URLs erfolgten.
-
Im Detailbericht zu Zugriffsquellen sind die Verweis-URLs angegeben, die für ein bestimmtes Video und einen bestimmten Besucherquellentyp die meisten Aufrufe generiert haben. In diesem Bericht kannst du beispielsweise die ähnlichen Videos finden, die die meisten Zugriffe auf ein bestimmtes Video generiert haben. Dieser Bericht wird für mehrere Besucherquellen unterstützt.
-
Berichte zur Wiedergabezeit geben Aufschluss darüber, wie lange Zuschauer damit verbracht haben, sich deine Inhalte anzusehen. In den Berichten können Daten für einen bestimmten Zeitraum (Tag, letzte 7 Tage, letzte 30 Tage usw.) oder ein bestimmtes Land zusammengefasst werden. Wenn in einem Bericht Daten entweder nach Tag oder Land gesammelt werden, kann er auch die durchschnittliche Länge jedes Videoaufrufs sowie den durchschnittlichen Prozentsatz jedes Videos angeben, das die Nutzer angesehen haben.
-
-
YouTube Analytics API ist jetzt für alle Entwickler verfügbar. Sie können die API für Ihr Projekt aktivieren, ohne zuvor Zugriff anfordern zu müssen. Verwenden Sie dazu den Bereich Dienste in APIs console.
-
Im neuen Abschnitt Erste Schritte werden die Voraussetzungen und grundlegenden Schritte zum Erstellen einer Anwendung beschrieben, die YouTube Analytics API verwendet.
-
Der neue Abschnitt Informationen zur Kontingentnutzung enthält Richtlinien zur Optimierung Ihrer API-Kontingentnutzung. Der API-Server berechnet die Abfragekosten für jede Anfrage. Diese Kosten werden von Ihrem API-Nutzungskontingent abgezogen. Da verschiedene Berichtstypen sehr unterschiedliche Abfragekosten verursachen können, sollten Sie Ihr Kontingent effizient nutzen und Ihre Anwendung nur die Messwerte und Daten anfordern, die sie tatsächlich benötigt.
-
Der Bereich Zeitliche Dimensionen wurde aktualisiert. Jetzt geben wir an, dass in einem Analytics-Bericht Daten basierend auf einem Zeitraum zusammengefasst werden sollten. Die API unterstützt jetzt die folgenden zusätzlichen zeitlichen Dimensionen:
7DayTotals
: Die Daten im Bericht werden zusammengefasst, sodass jede Zeile die Daten eines Zeitraums von sieben Tagen enthält.30DayTotals
: Die Daten im Bericht werden zusammengefasst, sodass jede Zeile die Daten eines Zeitraums von 30 Tagen enthält.month
: Die Daten im Bericht werden nach Kalendermonat zusammengefasst.
Auch der Abschnitt Verfügbare Berichte wurde aktualisiert, um zu verdeutlichen, dass die API Berichte mit diesen Dimensionen unterstützt.
-
Der Abschnitt Dimensionen von Berichtsentitäten wurde aktualisiert. Bei API-Anfragen zum Abrufen von Rechteinhaberberichten müssen Daten entweder nach einer dieser Dimensionen (
video
,channel
odershow
) oder einer unterstützten Kombination der DimensionenclaimedStatus
unduploaderType
gefiltert werden. -
Die API unterstützt jetzt zwei neue Sortieroptionen für Berichte zu den Top-Videos. Diese Berichte, die als Kanalberichte oder Berichte zu Rechteinhabern verfügbar sind, enthalten Messwerte (Aufrufe, Kommentare, „Mag ich“-Bewertungen usw.) auf Länderbasis und schlüsseln diese nach Video auf. Du kannst diese Berichte jetzt nach der Anzahl der Nutzer sortieren, die einen Kanal über die Wiedergabeseite des Videos abonniert oder das Abo beendet haben.
-
Die Definitionen der metrics
subscribersGained
undsubscribersLost
wurden aktualisiert, um zu verdeutlichen, dass ein Kanal an verschiedenen Stellen Abonnenten gewinnen oder verlieren kann, z. B. auf der Videowiedergabe- und der Kanalseite sowie in der Übersicht auf der YouTube-Startseite. Wenn diese Messwerte in einem Videobericht erscheinen, enthalten sie nur Statistiken der Wiedergabeseite des entsprechenden Videos.
Die YouTube Reporting API unterstützt drei neue Abspannelement-Berichte sowie neue Dimensionen und Messwerte für diese Berichte. Die Berichte enthalten Statistiken zu Impressionen und Klicks für die Abspanne, die nach dem Ende der Wiedergabe eines Videos eingeblendet werden.
In der YouTube-Hilfe findest du weitere Informationen dazu, wie du deinen Videos Abspanne hinzufügst.
8. November 2016
Dieses Update umfasst die folgenden Änderungen an der YouTube Analytics API:
27. Oktober 2016
YouTube erstellt jetzt automatisch eine Reihe von systemverwalteten Berichten zu Werbeeinnahmen für Rechteinhaber, die in YouTube Creator Studio im Abschnitt Berichte Zugriff auf die entsprechenden Berichte haben. Die neuen systemverwalteten API-Berichte bieten programmatischen Zugriff auf Daten, die auch in den manuell herunterladbaren Creator Studio-Berichten verfügbar sind.
Unter Übersicht über vom System verwaltete Berichte finden Sie eine kurze Übersicht über die neuen Berichte und wie sie über die API abgerufen werden. Dieser Vorgang unterscheidet sich geringfügig von dem Verfahren zum Abrufen von Bulk-Berichten für YouTube Analytics, da Partner zum Erstellen von Berichten keine Aufträge planen müssen.
Die Eigenschaft id
der Ressource reportType
wurde aktualisiert und enthält nun eine Liste der vom System verwalteten Berichte, auf die Sie über die API zugreifen können:
27. September 2016
Hinweis: Diese Mitteilung wird eingestellt.
Der Messwert „uniques
“ der YouTube Analytics API wurde eingestellt. Dies ist kein zentraler Messwert und wird bis zum 31. Oktober 2016 unterstützt.
15. September 2016
Diese Aktualisierung umfasst die folgenden Änderungen an der YouTube Reporting API:
19. August 2016
Dieses Update enthält die folgende Änderung an der YouTube Reporting API:
11. August 2016
Dieses Update enthält die folgenden Änderungen:
10. August 2016
Dieses Update enthält die folgenden Änderungen:
18. Juli 2016
Dieses Update enthält die folgenden Änderungen:
28. Juni 2016
Die Dokumentation zur YouTube Analytics API wurde aktualisiert, um die Unterstützung für Kartenmesswerte in zahlreichen Berichten zu Kanälen und Rechteinhabern zu berücksichtigen. Folgende Messwerte werden jetzt unterstützt:
Die Messwerte werden in den folgenden Berichtstypen unterstützt:
22. Juni 2016
Dieses Update enthält die folgenden Änderungen an der YouTube Reporting API. Die erste Änderung betrifft allgemein die API, die übrigen Änderungen nur Berichte zu Rechteinhabern:
19. Mai 2016
Diese Aktualisierung umfasst die folgenden Änderungen an der YouTube Reporting API:
12. April 2016
Dieses Update enthält die folgenden Änderungen, die alle nur die YouTube Reporting API betreffen:
28. März 2016
Über die YouTube Reporting API und die YouTube Analytics API werden jetzt Aufrufstatistiken für verschiedene zusätzliche Dienste zum Teilen zurückgegeben.
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
YouTube Analytics API
8. Februar 2016
Die Liste der für die YouTube Analytics API unterstützten Messwerte wurde aktualisiert. Kartenmesswerte werden nun nicht mehr als unterstützte Messwerte für diese API aufgeführt. (Keiner der Berichte der API hatte nachgewiesen, dass er einen der Kartenmesswerte unterstützt hat.)
Hinweis: Du kannst Messwerte zu Infokarten weiterhin über die YouTube Reporting API abrufen, die diese Messwerte für zahlreiche Berichte zu Kanälen und Rechteinhabern unterstützt.
6. Januar 2016
Sowohl die YouTube Reporting API als auch die YouTube Analytics API identifizieren jetzt speziell Aufrufe, die über Chromecast erfolgen.
21. Dezember 2015
In der Dokumentation wurden die Namen der Messwerte annotation_clickable_impressions
und annotation_closable_impressions
aktualisiert, damit sie mit den Namen übereinstimmen, die in den Berichten zurückgegeben werden. Bisher wurden die Namen als clickable_annotation_impressions
und closable_annotation_impressions
dokumentiert.
18. Dezember 2015
Gemäß den Gesetzen der Europäischen Union (EU) müssen Endnutzer in der EU bestimmte Informationen offenlegen und Einwilligungen dieser Endnutzer einholen. Für Endnutzer in der Europäischen Union müssen Sie daher die Richtlinie zur Einwilligung der Nutzer in der EU einhalten. Wir haben den Nutzungsbedingungen für die YouTube API einen Hinweis auf diese Anforderung hinzugefügt.
15. Dezember 2015
Dieses Update enthält die folgenden Änderungen, die alle die YouTube Analytics API betreffen:
10. November 2015
Dieses Update enthält die folgenden Änderungen:
29. Oktober 2015
Dieses Update enthält die folgenden Änderungen:
8. Oktober 2015
Dieses Update enthält die folgenden Änderungen:
24. September 2015
Dieses Update enthält die folgenden Änderungen:
20. August 2015
Dieses Update enthält die folgenden Änderungen:
22. Juli 2015
Dieses Update enthält mehrere Änderungen, die alle nur für Rechteinhaber gelten:
1. Juni 2015
Dieses Update enthält die folgenden Änderungen:
31. März 2015
Dieses Update enthält die folgenden Änderungen:
16. März 2015
Dieses Update enthält die folgenden Änderungen:
25. Februar 2015
Dieses Update enthält die folgenden Änderungen:
13. Februar 2015
Dieses Update enthält die folgenden Änderungen:
28. August 2014
Dieses Update enthält die folgenden Änderungen:
16. Juli 2014
Dieses Update enthält die folgenden Änderungen:
31. Januar 2014
Dieses Update enthält die folgenden Änderungen:
16. Januar 2014
Dieses Update enthält die folgenden Änderungen:
6. Januar 2014
Dieses Update enthält die folgenden Änderungen:
30. September 2013
Dieses Update enthält die folgenden Änderungen:
16. Juli 2013
Dieses Update enthält die folgenden Änderungen:
23. Mai 2013
Dieses Update enthält die folgenden Änderungen:
10. Mai 2013
Dieses Update enthält die folgenden Änderungen:
6. Mai 2013
Dieses Update enthält die folgenden Änderungen:
3. Mai 2013
Dieses Update enthält die folgenden Änderungen:
28. März 2013
Dieses Update enthält die folgenden Änderungen:
21. März 2013
Dieses Update enthält die folgenden Änderungen:
4. Februar 2013
Dieses Update enthält die folgenden Änderungen:
14. November 2012
Dieses Update enthält die folgenden Änderungen:
2. Oktober 2012
Dieses Update enthält die folgenden Änderungen:
12. September 2012
Dieses Update enthält die folgenden Änderungen: