Auf dieser Seite werden API-Änderungen und Aktualisierungen der Dokumentation für die YouTube Reporting API und die YouTube Analytics API aufgeführt. Beide APIs ermöglichen es Entwicklern, auf YouTube Analytics-Daten zuzugreifen, wenn auch auf unterschiedliche Weise. Dieses Änderungsprotokoll abonnieren
4. Dezember 2023
Die YouTube Analytics (Targeting Queries) API wurde aktualisiert, sodass jetzt zwei insightTrafficSourceType
-Dimensionswerte zusammengeführt werden. Bisher wurde mit der Dimension zwischen Videos, die als Teil einer Playlist abgespielt wurden (PLAYLIST
) und Aufrufen unterschieden, die über eine Seite erfolgten, auf der alle Videos einer Playlist aufgeführt sind (YT_PLAYLIST_PAGE
). Zukünftig werden beide Arten von Aufrufen dem Dimensionswert PLAYLIST
zugeordnet.
15. Dezember 2022
Die YouTube Analytics API (Targeting-Anfragen) unterstützt zwei neue Dimensionen und einen neuen Bericht:
-
In einem neuen Bericht werden die Nutzeraktivitäten nach Stadt aufgeführt. Dieser Bericht ist für Kanäle und Rechteinhaber verfügbar. Dieser Bericht enthält die neue Dimension
city
, die eine Schätzung der Stadt angibt, in der die Nutzeraktivität stattgefunden hat. -
Die neue Dimension
creatorContentType
gibt die Art von YouTube-Inhalten an, die mit den Messwerten zur Nutzeraktivität in der Datenzeile verknüpft ist. Unterstützte Werte sindLIVE_STREAM
,SHORTS
,STORY
undVIDEO_ON_DEMAND
.Die Dimension „
creatorContentType
“ wird als optionale Dimension für alle Berichte zu Videos von 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 (Gezielte Anfragen) und die YouTube Reporting (Bulk Reports) API unterstützen beide einen neuen Detailwert für Besucherquellen:
- Wenn in der YouTube Analytics API (Targeting Queries) API der Wert der Dimension
insightTrafficSourceType
aufSUBSCRIBER
festgelegt ist, kann der WertinsightTrafficSourceDetail
aufpodcasts
gesetzt werden. Das bedeutet, dass der Traffic von der Podcasts-Landingpage weitergeleitet wurde. - Wenn in der YouTube Reporting (Bulk Reports) API der Wert der Dimension
traffic_source_type
auf3
gesetzt 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. Möglicherweise handelt es sich um eine nicht abwärtskompatible Änderung an Ihrer API-Implementierung. 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 zu den neuen Werten 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 den Traffic in Form von Schleifenclips auszuschließen. Diese Änderung betrifft sowohl die YouTube Analytics (Gezielte Suchanfragen) API als auch die YouTube Reporting (Bulk Reports) API.
- Seit dem 13. Dezember 2021 schließen die Messwerte
averageViewDuration
undaverageViewPercentage
in der YouTube Analytics (Gezielte Anfragen) API in Schleifen-Clips-Traffic aus. - In der YouTube Reporting (Bulk Reports) API schließen die Messwerte
average_view_duration_seconds
undaverage_view_duration_percentage
seit dem 13. Dezember 2021 in Schleifen-Clips-Traffic aus.
2. Februar 2022
Diese YouTube Reporting (Bulk Reports) API unterstützt einen neuen Dimensionswert für Zugriffsquellen, 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 (Targeting Queries) und die YouTube Reporting (Bulk Reports) API unterstützen beide einen neuen Dimensionswert für Zugriffsquellen. Dieser zeigt an, dass der Zuschauer durch vertikales Wischen im YouTube Shorts-Wiedergabeformat auf deine Website gelangt ist:
- In der YouTube Analytics API (Targeting Queries) API 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 „Details zu Zugriffsquellen“ – insightTrafficSourceDetail
in der YouTube Analytics API oder traffic_source_detail
in der YouTube Reporting API – wird für diesen neuen Besucherquellentyp nicht ausgefüllt.
20. Juli 2020
Diese Aktualisierung umfasst zwei Änderungen, die sich auf die YouTube Analytics (Targeting Queries) API 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 der Satz möglicher Detailwerte für Besucherquellen für Benachrichtigungen.
In Targeting-Abfragen werden Benachrichtigungen als insightTrafficSourceType=NOTIFICATION
gemeldet. In Bulk-Berichten werden Benachrichtigungen als traffic_source_type=17
gemeldet.
Durch die neuen Werte werden Benachrichtigungen zu hochgeladenen Videos und Livestreams, die zuvor als uploaded
gemeldet wurden, in zwei Kategorien unterteilt:
uploaded_push
– Aufrufe über Push-Benachrichtigungen, die Abonnenten beim Hochladen eines Videos gesendet habenuploaded_other
: Aufrufe, die über andere Kanäle als Push-Benachrichtigungen (z. B. E-Mail- oder Posteingangsbenachrichtigungen) stammen, die Abonnenten beim Hochladen eines Videos erhalten haben.
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, über die bestimmte YouTube-Aufrufe erzielt wurden. Wenn in einer Berichtszeile beispielsweise views=3
, traffic_source_type=17
(NOTIFICATION
) und traffic_source_detail=uploaded_push
angezeigt werden, gibt die Zeile an, dass drei Aufrufe durch Nutzer erfolgten, die auf Push-Benachrichtigungen geklickt haben, die beim Hochladen des Videos gesendet wurden.
15. Oktober 2019
Diese Aktualisierung enthält die folgenden Änderungen in Bezug auf die YouTube Analytics (Targeting Queries) API:
-
Hinweis:Diese Ankündigung wird eingestellt.
Die Dimensionen
7DayTotals
und30DayTotals
werden von YouTube nicht mehr unterstützt. Bis zum 15. April 2020 können Sie noch Daten mit diesen Dimensionen abrufen. An oder nach diesem Datum wird ein Fehler zurückgegeben, wenn Berichte mit der Dimension7DayTotals
oder30DayTotals
abgerufen werden.Nutzer können einige Daten für diese Dimensionen reproduzieren, indem sie eine Abfrage mit der Dimension
day
ausführen und Daten über einen Zeitraum von 7 oder 30 Tagen aggregieren oder ableiten. Beispiel:- Die Anzahl der Aufrufe über einen Zeitraum von sieben Tagen kann berechnet werden, indem die Anzahl der Aufrufe von jedem Tag dieses Zeitraums aggregiert wird.
- Der Prozentsatz der Zuschauer für einen Zeitraum von sieben Tagen lässt sich berechnen, indem du die Anzahl der Aufrufe pro Tag mit dem Prozentsatz der Zuschauer für diesen Tag multiplizierest. So erhältst du die Anzahl der Zuschauer, die beim Ansehen des Videos an diesem Tag angemeldet waren. Anschließend kannst du die Anzahl der angemeldeten Zuschauer für den gesamten Zeitraum addieren und durch die Gesamtzahl der Aufrufe in diesem Zeitraum teilen. So erhältst du den Prozentsatz für Zuschauer für den gesamten Zeitraum.
- Die Anzahl der einzelnen Nutzer für einen Zeitraum von sieben Tagen kann nicht berechnet werden, da derselbe Nutzer als einzelner Nutzer an verschiedenen Tagen berechnet werden kann. Sie können jedoch möglicherweise die Dimension
month
anstelle der Dimension30DayTotals
verwenden, um Daten zur Anzahl der einzelnen Nutzer über einen Zeitraum von 30 Tagen zu extrapolieren. Die Dimensionmonth
bezieht sich auf Kalendermonate, während mit der Dimension30DayTotals
30-Tage-Zeiträume basierend auf dem angegebenen Start- und Enddatum berechnet werden.
27. Juni 2019
Diese Aktualisierung enthält die folgenden Änderungen in Bezug auf die YouTube Analytics (Targeting Queries) API:
-
Da Version 1 der API jetzt vollständig eingestellt ist, wurde die Dokumentation aktualisiert und Verweise auf diese Version entfernt, einschließlich des Hinweises zu veralteten Versionen und der Migrationsanleitung, in der die Aktualisierung auf Version 2 erläutert wird.
1. November 2018
Diese Aktualisierung enthält die folgenden Änderungen in Bezug auf die YouTube Analytics (Targeting Queries) API:
-
Version 1 der API ist jetzt veraltet. 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.
Der Zeitplan für diese Einstellung wurde ursprünglich am 26. April 2018 angekündigt.
17. September 2018
Diese Aktualisierung enthält die folgenden Änderungen in Bezug auf die YouTube Analytics (Targeting Queries) API:
-
Im neuen Abschnitt Datenanonymisierung im Übersichtsdokument zum 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 möglicherweise nicht alle oder gar keine Daten enthält, wenn:
-
ein Video oder Kanal während eines bestimmten Zeitraums nur wenige Zugriffe hat,
oder
-
Sie einen Filter oder eine Dimension wie Besucherquelle oder Land ausgewählt haben, für den bzw. die die Werte einen bestimmten Grenzwert nicht erreichen.
In dem neuen Abschnitt werden auch die Datentypen erläutert, die in YouTube Analytics-Berichten möglicherweise eingeschränkt sind.
-
-
Die Dokumente Kanalberichte und Rechteinhaberberichte wurden aktualisiert, um die Tatsache zu berücksichtigen, dass die Messwerte
redViews
undestimatedRedMinutesWatched
für Berichte zu Wiedergabeort, Besucherquelle und Gerätetyp/Betriebssystem nicht mehr unterstützt werden.
18. Juni 2018
Diese Aktualisierung umfasst die folgenden Änderungen an der YouTube Analytics (Targeting Queries) API:
- Die Anforderungen für den Umfang der 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 zufällig 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
Diese Aktualisierung umfasst die folgenden Änderungen an der YouTube Analytics (Targeting Queries) API:
- Die API-Übersicht enthält einen neuen Abschnitt, zusammengefasste Messwerte und gelöschte Elemente. Darin wird erläutert, wie API-Antworten mit gelöschten Ressourcen wie Videos, Playlists oder Kanälen verbundene Daten verarbeiten.
- Der Abschnitt Best Practices in der API-Übersicht wurde aktualisiert, um dich daran zu erinnern, dass du mit der YouTube Data API zusätzliche Metadaten für Ressourcen abrufen kannst, die in Antworten der YouTube Analytics API identifiziert wurden. Wie in den Richtlinien für Entwickler der YouTube API-Dienste (Abschnitte III.E.4.b bis III.E.4.d) angegeben, 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 (Bulk Reports) API:
- Die folgenden Änderungen sollen derzeit im Juli 2018 in Kraft treten. Die neuen Richtlinien gelten weltweit für alle Berichte und Berichterstellungsjobs.
-
Nach der Änderung sind die meisten API-Berichte, einschließlich Backfill-Berichte, ab dem Zeitpunkt ihrer 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. Wir möchten noch einmal darauf hinweisen, dass ab dem Inkrafttreten dieser Richtlinienänderung auch keine Berichte zu Verlaufsdaten mehr als 30 Tage über die API verfügbar 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, jetzt bis zu 180 Tage lang verfügbar.
-
Wenn Sie nach der Änderung einen Berichterstellungsjob planen, erstellt YouTube ab diesem Tag Berichte, die die 30 Tage vor der Planung des Jobs abdecken. Wenn Sie vor der Änderung einen Berichterstellungsjob planen, erstellt YouTube Berichte für die 180 Tage vor der Planung des Jobs.
-
-
Der Abschnitt Best Practices wurde aktualisiert, um dich daran zu erinnern, dass du mit der YouTube Data API zusätzliche Metadaten für in Berichten identifizierte Ressourcen abrufen kannst. Wie in den Richtlinien für Entwickler der YouTube API-Dienste (Abschnitte III.E.4.b bis III.E.4.d) angegeben, müssen API-Clients gespeicherte Ressourcenmetadaten nach 30 Tagen aus dieser API entweder löschen oder aktualisieren.
-
Der Abschnitt Berichtsmerkmale wurde aktualisiert. Obwohl Berichtsdaten nicht gefiltert wurden, 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 Datum der Berichterstellung gelöscht wurden.
-
Der Abschnitt Verlaufsdaten in der API-Übersicht wurde aktualisiert. Wenn Sie einen neuen Berichterstellungsjob planen, werden die Berichte zu bisherigen Daten in der Regel innerhalb weniger Tage veröffentlicht. Laut der Dokumentation kann es bis zu 30 Tage dauern, bis solche Berichte verfügbar sind.
-
Der Abschnitt Backfill-Daten der API-Übersicht wurde aktualisiert, um Backfill-Daten deutlicher als Datenpools zu definieren, die zuvor übermittelte Daten ersetzen.
26. April 2018
Version 2 der YouTube Analytics (Targeting Queries) API (Version 2) ist jetzt öffentlich verfügbar. In der folgenden Liste sind Änderungen an Produkten und Dokumentationen im Zusammenhang mit der neuen API-Version aufgeführt:
-
Die API v2 ist fast identisch mit der API v1. Wahrscheinlich ist es jedoch erforderlich, dass Sie Ihren Code aktualisieren, um die unten aufgeführten Änderungen widerzuspiegeln. All 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 sind 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 mit der API V2 senden, müssen Sie stattdessen den Endpunkthttps://youtubeanalytics.googleapis.com/v2
verwenden.
Außerdem werden einige Funktionen von Version 1 von 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 aus Anfragen an verschiedene APIs unterstützt. Ein Batch kann jedoch aus Anfragen an verschiedene Methoden desselben APIs bestehen. Diese Einstellung bezieht sich nicht nur auf 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 Einstellung bezieht sich nicht nur auf die YouTube Analytics API.
- Die API-Version wurde von
-
Hinweis:Diese Ankündigung wird eingestellt.
Version 1 der API (v1) wurde eingestellt und wird bis zum 31. Oktober 2018 unterstützt. Nach diesem Datum funktionieren alle Anfragen an die v1 API nicht mehr. Deshalb solltest du bis zum 31. Oktober 2018 auf die Version 2 der API aktualisieren, damit du weiterhin über die API auf YouTube Analytics-Daten zugreifen kannst.
21. Februar 2018
Diese Aktualisierung umfasst die folgenden Änderungen an der YouTube Analytics (Targeting Queries) API:
- Berichte zur Leistung nach demografischen Merkmalen, in denen Wiedergabestatistiken auf Grundlage der Altersgruppe und des Geschlechts der Zuschauer zusammengefasst werden, unterstützen nicht mehr die Dimension „
youtubeProduct
“, die den YouTube-Dienst identifiziert, bei dem die Nutzeraktivität aufgetreten ist.
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 erfolgten, 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. Für andere Arten von API-Anfragen wird die GZIP-Komprimierung nicht unterstützt. Durch Aktivieren der gzip-Komprimierung wird die für jede API-Antwort benötigte Bandbreite reduziert. Und obwohl Ihre Anwendung zum Dekomprimieren von API-Antworten zusätzliche CPU-Zeit benötigt, überwiegt der Vorteil, weniger Netzwerkressourcen zu verbrauchen, diese Kosten.
Um eine mit gzip codierte Antwort zu erhalten, setzen Sie 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 des Attributs
downloadUrl
der Ressourcereport
erläutert. -
Die Dokumentation für die Dimensionen
age group
undgender
wurde korrigiert und zeigt jetzt die tatsächlichen Werte an, die die API für diese Dimensionen zurückgibt. Beachten Sie, dass dies eine Korrektur in der Dokumentation ist und keine Änderung der API-Funktionalität oder des Verhaltens widerspiegelt. Insbesondere haben sich die folgenden Werte geändert:- Die Werte für die Dimension „
age_group
“ umfassen Großbuchstaben, Unterstriche zwischen dem Wort „AGE
“ und den Ziffern in der Altersgruppe und Unterstriche anstelle von Bindestrichen. Daher wurden Werte wieage13-17
undage18-24
zuAGE_13_17
bzw.AGE_18_24
korrigiert. - In den Werten der Dimension „
gender
“ werden Großbuchstaben verwendet. Daher wurden die Wertefemale
,male
undgender_other
zuFEMALE
,MALE
undGENDER_OTHER
korrigiert.
- Die Werte für die Dimension „
10. August 2017
Am 10. August 2016 wurde in dieser Dokumentation bekannt gegeben, dass der Messwert earnings
der YouTube Analytics API eingestellt wird. Gleichzeitig wurde in der API ein neuer Messwert mit dem Namen estimatedRevenue
unterstützt, der dieselben Daten liefert.
Da der Messwert „earnings
“ ein wichtiger Messwert war, wurde er ab dem Datum der Ankündigung ein Jahr lang unterstützt. Da dieser einjährige Zeitraum nun zu Ende ist, wird der Messwert earnings
jedoch nicht mehr unterstützt. Daher wird bei API-Anfragen, die den Messwert earnings
angeben, jetzt der HTTP-Antwortcode 400
zurückgegeben. Wenn du deine App noch nicht aktualisiert hast, um den Messwert estimatedRevenue
anstelle des Messwerts earnings
zu verwenden, tu 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, werden in der Antwort letzte Daten berücksichtigt. Das gilt auch dann, wenn Daten für einige der angeforderten Messwerte für den 4. Juli 2017 verfügbar sind.
-
Die Dimension „
adType
“ unterstützt jetzt den WertreservedBumperInstream
, der sich auf eine nicht überspringbare Videoanzeige 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 auf Reservierungsbasis und nicht auf Auktionsbasis verkauft werden.
-
-
YouTube Reporting API (Bulk-Berichte)
-
Für die Dimension „
ad_type
“ wird jetzt der Wert20
unterstützt, der sich auf Bumper-Anzeigen bezieht, die auf Reservierungsbasis verkauft werden. 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 über eine Auktion und nicht über einen reservierten Kauf verkauft werden. -
Berichterstellungsjobs 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 180 Tage lang verfügbar. Daher waren einige Berichte erst seit dem 15. Juni 2017 verfügbar. Da die Reports jedoch nicht mehr verfügbar sind, werden die mit den Reports 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. Nach dem 22. September 2016 wurden keine entsprechenden Berichte mehr generiert. Zuvor erstellte Berichte waren ab dem Zeitpunkt ihrer Erstellung 180 Tage lang verfügbar. Daher waren einige Berichte erst seit dem 22. März 2017 verfügbar. Da die Reports jedoch nicht mehr verfügbar sind, werden die mit den Reports 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 angibt, über den Videos freigegeben wurden, unterstützt jetzt die folgenden Werte:85
: YouTube Music86
: YouTube Gaming87
: YouTube Kids88
: YouTube TV
Darüber hinaus wurde der Name zur Identifizierung des Werts
52
in der Dokumentation in Kakao (Kakao Talk) geändert, um ihn deutlicher vom Wert73
(Kakao Story) zu unterscheiden. Diese Änderung hat keine Auswirkungen auf das API-Verhalten oder die Klassifizierung von Videos, 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 auch einen Bericht zur Anzeigenleistung abrufen, der die Dimensionen
adType
undday
unterstützt. -
Die Beispielanfragen für die YouTube Analytics API enthalten jetzt einen Abschnitt für Berichte zum Umsatz von Kanälen.
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 die YouTube Red-Zuschauerzahlen beziehen. Die API unterstützt diese Messwerte bereits seit einiger Zeit und die YouTube Reporting API unterstützt bereits beide Messwerte, wie am 15. September 2016 angekündigt.- Der Messwert
redViews
gibt an, wie oft ein Video von YouTube Red-Abonnenten angesehen wurde. - Der Messwert
estimatedRedMinutesWatched
gibt die Anzahl der Minuten an, die YouTube Red-Abonnenten ein Video angesehen haben.
Die Dokumentation zu Kanalberichten und Berichten zu Rechteinhabern wurde aktualisiert. Jetzt sehen Sie, 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 am angegebenen Tag, Monat und Jahr um 23:59 Uhr Pacific Time endet. Je nach Jahreszeit entspricht die Zeitzone entweder UTC-7 oder UTC-8.Obwohl ein Datum in der Regel 24 Stunden entspricht, handelt es sich bei einem Datum, an dem die Uhren vorwärts bewegt werden, um einen 23-Stunden-Zeitraum und ein Datum, an dem die Uhren rückwärts bewegt werden, einem 25-Stunden-Zeitraum. Zuvor war in der Dokumentation angegeben, dass jedes Datum einen eindeutigen 24-Stunden-Zeitraum darstellte und dass die Pacific Time immer UTC-8 war.
Beachten Sie, dass diese Korrektur keine Änderung des tatsächlichen API-Verhaltens darstellt.
- 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. Allerdings waren zuvor generiertecontent_owner_basic_a1
-Berichte ab dem Zeitpunkt ihrer Erstellung noch 180 Tage lang verfügbar. Daher waren einige Berichte erst am 19. Februar 2017 verfügbar. Da die Reports jedoch nicht mehr verfügbar sind, werden die mit den Reports 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 am angegebenen Tag, Monat und Jahr um 23:59 Uhr Pacific Time endet. Je nach Jahreszeit entspricht die Zeitzone entweder UTC-7 oder UTC-8.Obwohl ein Datum in der Regel 24 Stunden entspricht, handelt es sich bei einem Datum, an dem die Uhren vorwärts bewegt werden, um einen 23-Stunden-Zeitraum und ein Datum, an dem die Uhren rückwärts bewegt werden, einem 25-Stunden-Zeitraum. Zuvor wurde in der Dokumentation angegeben, dass die Pacific Time UTC-8 war, und es wurde nicht erwähnt, dass ein Tag möglicherweise keinen 24-Stunden-Zeitraum darstellt.
Beachten Sie, dass diese Korrektur keine Änderung des tatsächlichen API-Verhaltens darstellt.
-
Die Dokumentation zu Channelberichten wurde aktualisiert. Channelberichte enthalten derzeit keine Messwerte zu Einnahmen oder Anzeigenleistung. Daher bietet der Bereich
https://www.googleapis.com/auth/yt-analytics-monetary.readonly
derzeit keinen Zugriff auf monetäre Daten in Channelberichten. - Die Dimension
operatingSystem
unterstützt drei neue Dimensionswerte:FIREFOX
REALMEDIA
TIZEN
-
8. Februar 2017
Die YouTube Analytics API unterstützt jetzt den optionalen Parameter include-historical-channel-data
. Dieser Parameter ist nur beim Abrufen von Rechteinhaberberichten relevant.
Mit dem Parameter kann ein Rechteinhaber angeben, dass eine API-Antwort die Wiedergabezeit und Aufrufdaten 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 Wiedergabezeit- und Aufrufdaten ab dem Zeitpunkt enthält, an dem die Kanäle mit dem Rechteinhaber verknüpft wurden.
Diese Regeln gelten auch, wenn die API-Anfrage Daten für mehrere Kanäle abruft:
- Wenn der Parameterwert
false
lautet, basieren die zurückgegebenen Daten zu Wiedergabezeit und Aufrufen für einen bestimmten Kanal auf dem Datum, an dem dieser Kanal mit dem Rechteinhaber verknüpft wurde.
Denken Sie daran, dass unterschiedliche 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 für den jeweiligen Kanal. - Wenn der Parameterwert
true
lautet, gibt die Antwort Wiedergabezeit- und Aufrufdaten für alle Kanäle basierend auf dem in der API-Anfrage angegebenen Start- und Enddatum zurück.
15. Dezember 2016
Die folgenden YouTube Reporting API-Berichte werden nicht mehr unterstützt und aus der Dokumentation entfernt. Für jeden Bericht ist eine neuere Version verfügbar. Diese Berichte wurden am 15. September 2016 eingestellt.
-
Kanalberichte
channel_basic_a1
wird durch den Bericht „channel_basic_a2
“ ersetzt.channel_province_a1
wird durch den Bericht „channel_province_a2
“ ersetzt.channel_playback_location_a1
wird durch den Bericht „channel_playback_location_a2
“ ersetzt.channel_traffic_source_a1
wird durch den Bericht „channel_traffic_source_a2
“ ersetzt.channel_device_os_a1
wird durch den Bericht „channel_device_os_a2
“ ersetzt.channel_subtitles_a1
wird durch den Bericht „channel_subtitles_a2
“ ersetzt.channel_combined_a1
wird durch den Bericht „channel_combined_a2
“ ersetzt.
-
Berichte zu Rechteinhabern
content_owner_basic_a2
wird durch den Bericht „content_owner_basic_a3
“ ersetzt.content_owner_province_a1
wird durch den Bericht „content_owner_province_a2
“ ersetzt.content_owner_playback_location_a1
wird durch den Bericht „content_owner_playback_location_a2
“ ersetzt.content_owner_traffic_source_a1
wird durch den Bericht „content_owner_traffic_source_a2
“ ersetzt.content_owner_device_os_a1
wird durch den Bericht „content_owner_device_os_a2
“ ersetzt.content_owner_subtitles_a1
wird durch den Bericht „content_owner_subtitles_a2
“ ersetzt.content_owner_combined_a1
wird durch den Bericht „content_owner_combined_a2
“ ersetzt.content_owner_asset_basic_a1
wird durch den Bericht „content_owner_asset_basic_a2
“ ersetzt.content_owner_asset_province_a1
wird durch den Bericht „content_owner_asset_province_a2
“ ersetzt.content_owner_asset_playback_location_a1
wird durch den Bericht „content_owner_asset_playback_location_a2
“ ersetzt.content_owner_asset_traffic_source_a1
wird durch den Bericht „content_owner_asset_traffic_source_a2
“ ersetzt.content_owner_asset_device_os_a1
wird durch den Bericht „content_owner_asset_device_os_a2
“ ersetzt.content_owner_asset_combined_a1
wird durch den Bericht „content_owner_asset_combined_a2
“ ersetzt.
Die Liste der aktuellen Berichtstypen in der API-Referenzdokumentation wurde ebenfalls aktualisiert.
11. November 2016
Dieses Update enthält die folgenden Änderungen:
-
Abspannberichte
- Der Abspannbericht für Kanalvideos enthält Statistiken für alle 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 Inhalte von Rechteinhabern enthält Statistiken für die mit den Videos verknüpften Inhalte, nach denen die Abspanne eingeblendet werden.
-
Abmessungen des Abspanns
end_screen_element_type
: Der Typ des mit der Statistik verknüpften Abspannelements.end_screen_element_id
: Das ist die ID, die YouTube verwendet, um das Abspannelement eindeutig zu identifizieren.
Messwerte zum Abspann
Hinweis: Daten zu Abspann-Messwerten stehen seit dem 1. Mai 2016 zur Verfügung.
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. Für jeden Bericht ist eine neuere Version verfügbar. Diese Berichte wurden am 22. Juni 2016 eingestellt.
content_owner_ad_performance_a1
wird durch den Bericht „content_owner_ad_rates_a1
“ ersetzt.content_owner_estimated_earnings_a1
wird durch den Bericht „content_owner_estimated_revenue_a1
“ ersetzt.content_owner_asset_estimated_earnings_a1
wird durch den Bericht „content_owner_asset_estimated_revenue_a1
“ ersetzt.
-
Die Messwerte in der folgenden Liste wurden vollständig eingestellt und werden nicht mehr unterstützt. Wie am 10. August 2016 angekündigt, werden bereits neue Messwerte unterstützt, die sich auf dieselben Daten beziehen. Die folgende Tabelle zeigt den eingestellten Messwertnamen und den neuen Messwertnamen:
Eingestellter Messwert Neuer Messwert adEarnings
estimatedAdRevenue
impressionBasedCpm
cpm
impressions
adImpressions
redPartnerRevenue
estimatedRedPartnerRevenue
- Monatliche, weltweite Werbeeinnahmen pro Video
- Täglicher Werbeumsatz pro Land und Video
- Monatlicher, weltweiter Werbeumsatz pro Asset
- Täglicher Werbeumsatz pro Land und Asset
- Ansprüche (dieser Bericht enthält keine Umsatzdaten)
-
Die API unterstützt zwei neue Messwerte zu den YouTube Red-Zuschauerzahlen:
red_views
: gibt an, wie oft ein Video von YouTube Red-Abonnenten angesehen wurde.red_watch_time_minutes
: Dies ist die Anzahl der Minuten, die YouTube Red-Abonnenten 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
.Für jeden Bericht ist die Zahl in der neuen Berichtstyp-ID eine Zahl höher als in der alten Berichtstyp-ID. Die alten Versionen dieser Berichte werden nun wie weiter unten in diesem Überarbeitungsverlauf beschrieben eingestellt. Beispielsweise wurde der Bericht
channel_basic_a1
inzwischen eingestellt und durch den Berichtchannel_basic_a2
ersetzt.In den folgenden Listen sind die neuen Berichtstyp-IDs aufgeführt:
Berichte zu Kanalvideos
Berichte zu Videos von Rechteinhabern
Asset-Berichte für Rechteinhaber
-
Hinweis:Diese Ankündigung 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, sollten Sie nicht davon ausgehen, dass YouTube nach dem 15. Dezember 2016 neue Berichte für diese Jobs erstellt. Die generierten Berichte sind ab dem Zeitpunkt ihrer Erstellung 180 Tage lang verfügbar.
-
Der Bericht „
content_owner_basic_a1
“ wurde vollständig eingestellt und aus der Dokumentation entfernt. YouTube generiert keine neuen Berichte dieses Typs mehr. Berichte, die bereits erstellt wurden, sind aber noch 180 Tage lang verfügbar, nachdem sie generiert wurden.Anstelle des Berichts
content_owner_basic_a1
wird der Berichtcontent_owner_basic_a2
ersetzt, wie im Überarbeitungsverlauf vom 19. Mai 2016 erläutert. -
Die neu veröffentlichten Nutzungsbedingungen der 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 zukünftige Änderungen an den aktualisierten Nutzungsbedingungen oder an diesen Begleitdokumenten im Überarbeitungsverlauf erläutert. Sie können einen RSS-Feed abonnieren, der die Änderungen im Überarbeitungsverlauf über einen Link in diesem Dokument auflistet.
-
YouTube Analytics API (gezielte Suchanfragen)
-
Hinweis:Diese Ankündigung wird eingestellt.
Die Messwerte in der folgenden Tabelle werden eingestellt. Gleichzeitig werden neue Messwerte eingeführt, die sich auf dieselben Daten beziehen. Das bedeutet, dass die alten Messwerte umbenannt werden, wobei die YouTube Analytics API beide Messwertnamen bis zu dem in der Tabelle angegebenen Einstellungsdatum unterstützt.
Alter Messwertname Neuer Messwertname Supportdatum earnings
estimatedRevenue
10. August 2017 adEarnings
estimatedAdRevenue
4. November 2016 redPartnerRevenue
estimatedRedPartnerRevenue
4. November 2016 impressionBasedCpm
cpm
4. November 2016 impressions
adImpressions
4. November 2016 Der Messwert
earnings
war ein Hauptmesswert und wird ab dem Datum dieser Ankündigung ein Jahr lang unterstützt. Die anderen Messwerte, bei denen es sich nicht um Kernmesswerte handelte, werden drei Monate lang bis zum 4. November 2016 unterstützt.Bis zum 4. November 2016 kann in einer API-Anfrage beispielsweise der Messwert
impressionBasedCpm
,cpm
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. Es zeigt an, dass die Aufrufe von beanspruchten, von Nutzern hochgeladenen Videos stammen, mit denen der Rechteinhaber den angesehenen Inhalt beworben hat.END_SCREEN
: Die Daten beziehen sich auf Aufrufe über den Abspann eines anderen Videos.
Du kannst für beide neuen Zugriffsquellen auch einen
traffic source detail
-Bericht abrufen. In beiden Fällen gibt die DimensioninsightTrafficSourceDetail
das Video an, von dem der Zuschauer verwiesen wurde. -
Die Dimension „
adType
“ unterstützt jetzt den WertauctionBumperInstream
, der sich auf eine nicht überspringbare Videoanzeige 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. Es zeigt an, dass die Aufrufe von beanspruchten, von Nutzern hochgeladenen Videos stammen, mit denen der Rechteinhaber den angesehenen 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, über das der Zuschauer verwiesen wurde. -
Die Liste der Kernmesswerte der API wurde korrigiert:
estimated_partner_revenue
als Hauptmesswert aufgeführt.earnings
wird nun aus der Liste entfernt. Der Messwertearnings
wurde in der YouTube Reporting API noch nie unterstützt. -
Die Dimension „
ad_type
“ unterstützt jetzt den Wert „19
“, der sich auf Bumper-Anzeigen bezieht. Das sind nicht überspringbare Videoanzeigen, die bis zu sechs Sekunden dauern und vor der Wiedergabe eines Videos 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. Die Unterstützung für Kartenmesswerte in diesen Berichten wurde am 28. Juni 2016 hinzugefügt. Im Überarbeitungsverlauf für dieses Datum wird die Änderung genauer erläutert. Folgende Berichte sind verfügbar:
- Grundlegende Nutzeraktivität in US-Bundesstaaten
- Nutzeraktivität 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 und für die Berichte zur Zuschauerbindung wurden korrigiert, um zu verdeutlichen, dass der Filter
video
erforderlich ist und der Filtergroup
nicht unterstützt wird.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. Die Unterstützung für Kartenmesswerte in diesen Berichten wurde am 28. Juni 2016 hinzugefügt. Im Überarbeitungsverlauf für dieses Datum wird die Änderung genauer erläutert. Folgende Berichte sind verfügbar:
-
YouTube Reporting API (Bulk-Berichte)
- Im Abschnitt API-Übersicht wird im Abschnitt zum Abrufen der Download-URL eines Berichts erklärt, dass YouTube herunterladbare Berichte für Tage generiert, an denen keine Daten verfügbar waren. Diese Berichte enthalten eine Kopfzeile, aber keine zusätzlichen Daten. Diese Informationen wurden bereits am 12. April 2016 im Abschnitt Berichtsmerkmale desselben Dokuments aktualisiert.
- Die Liste der Dimensionen im Bericht „
content_owner_asset_cards_a1
“ wurde korrigiert, um zu zeigen, dass im Bericht die Dimension „card_id
“ verwendet wird. Bisher wurde in der Dokumentation fälschlicherweise der Dimensionsname alscard_title
aufgeführt.
- Grundlegende Statistiken(Kanäle, Rechteinhaber)
- Zeitbasiert(Kanäle, Rechteinhaber)
- Geografie der Nutzer (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 Erstellung 180 Tage lang über die API verfügbar sind.
Bisher stand in der Dokumentation fest, dass Berichte bis zu 180 Tage vor dem Datum verfügbar sind, an dem die API-Anfrage gesendet wurde. Der Originaltext ist zwar auch technisch gesehen richtig, bestenfalls aber 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ßtcontent_owner_estimated_revenue_a1
. - Die neue Version des Berichts „
content_owner_asset_estimated_earnings_a1
“ heißtcontent_owner_asset_estimated_revenue_a1
.
Die beiden neu umbenannten Berichte unterscheiden sich in folgenden Punkten von ihren Vorgängerversionen:
- Er fügt den neuen Messwert
estimated_partner_red_revenue
hinzu, mit dem die Gesamteinnahmen aus YouTube Red-Abos geschätzt werden. - 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 in Rechnung gestellt werden, geschätzt wird. - Er benennt den Messwert
estimated_partner_ad_sense_revenue
inestimated_partner_ad_auction_revenue
um. - Er benennt den Messwert
estimated_partner_double_click_revenue
inestimated_partner_ad_reserved_revenue
um.
- Die neue Version des Berichts „
Wenn Sie bereits Aufträge zum Erstellen einer der älteren Versionen dieser 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, sollten Sie nicht davon ausgehen, dass YouTube nach dem 22. September 2016 neue Berichte für diese Jobs erstellt. Die generierten Berichte sind ab dem Zeitpunkt ihrer Erstellung 180 Tage lang verfügbar.
-
-
Die Definition der
id
-Property der RessourcereportType
wurde aktualisiert, um die aktuell verfügbaren Berichte widerzuspiegeln. -
Die Namen von zwei Messwerten wurden in der Dokumentation korrigiert, damit sie mit den Namen in Berichten übereinstimmen. Hierbei handelt es sich um eine reine Dokumentationskorrektur, die keine Änderung des tatsächlichen Berichtsinhalts widerspiegelt:
- Der Name des Messwerts
estimated_partner_adsense_revenue
wurde zuestimated_partner_ad_sense_revenue
geändert. Dieser Messwert erscheint jedoch nur in zwei Berichten, die mit diesem Update eingestellt werden. Wie oben beschrieben wurde dieser Messwert in neueren Versionen der Berichte inestimated_partner_ad_auction_revenue
umbenannt. - Der Name des Messwerts
estimated_partner_doubleclick_revenue
wurde zuestimated_partner_double_click_revenue
geändert. Dieser Messwert erscheint nur in zwei Berichten, die mit diesem Update eingestellt werden. Wie oben beschrieben wurde dieser Messwert in neueren Versionen der Berichte inestimated_partner_ad_reserved_revenue
umbenannt.
- Der Name des Messwerts
-
Die Dokumentation zu Dimensionen für die Reporting API wurde aktualisiert. Die Properties
elapsed_video_time_percentage
undaudience_retention_type
werden jetzt nicht mehr aufgeführt. Diese Dimensionen werden derzeit in keinen Berichten unterstützt, die über die API verfügbar sind. -
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
.Auch wenn Sie bereits einen Job zum Erstellen des Berichts
content_owner_basic_a1
haben, müssen Sie 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 Aussehen eines neuen, unerwarteten Jobs zu einer funktionsgefährdenden Änderung führen.Im Zusammenhang mit der Veröffentlichung des neuen Berichts wurde der
content_owner_basic_a1
-Bericht eingestellt. Wenn Sie über einen Job für diesen Bericht verfügen, sollten Sie nicht davon ausgehen, dass YouTube nach dem 19. August 2016 neue Berichte für diesen Job generiert. Die generierten Berichte sind ab dem Zeitpunkt ihrer Erstellung 180 Tage lang verfügbar. -
Die Ressourcen
reportType
,job
undreport
unterstützen alle eine neue Property, die angibt, ob es sich bei der zugehörigen Ressource um einen eingestellten Berichtstyp handelt:-
Die Eigenschaft
deprecateTime
der RessourcereportType
gibt an, mit welchem Datum und zu welcher Uhrzeit der Berichtstyp eingestellt wird. Diese Property hat nur einen Wert für Berichte, die als eingestellt bekannt gegeben wurden, und der Wert gibt das Datum an, ab dem YouTube keine Berichte dieses Typs mehr erstellt.Nachdem ein Berichtstyp als eingestellt angekündigt wird, erstellt YouTube weitere drei Monate lang Berichte dieses Typs. Mit dieser Aktualisierung am 19. Mai 2016 wird beispielsweise die Einstellung des Berichts
content_owner_basic_a1
angekündigt. Daher gibtdeprecateTime
für diesen Berichtstyp den 19. August 2016 an, nach dem YouTube keine Berichte dieses Typs mehr erstellt. -
Das Attribut
expireTime
der Ressourcejob
gibt mit Datum und Uhrzeit an, wann der Job abgelaufen ist oder abläuft. Diese Eigenschaft hat einen Wert, wenn der mit dem Job verknüpfte Berichtstyp veraltet ist oder wenn für den Job generierte Berichte über einen längeren Zeitraum nicht heruntergeladen wurden. Das Datum gibt den Zeitpunkt an, nach dem YouTube keine neuen Berichte für den Job mehr erstellt. -
Die
jobExpireTime
-Property derreport
-Ressource gibt mit Datum und Uhrzeit an, wann der mit dem Bericht verknüpfte Job entweder abgelaufen ist oder abläuft. Diese Eigenschaft enthält denselben Wert wie das AttributexpireTime
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 aufgelistet, die zum Scheitern einer API-Anfrage führen. -
YouTube generiert jetzt Daten für die 180 Tage vor der Planung eines Berichterstellungsjobs. Bisher wurden über die Reporting API keine Verlaufsdaten ausgegeben. Diese Änderung betrifft alle Jobs, auch diejenigen, 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 historischen Daten für einen Job veröffentlicht wurden. Sie haben also einen Monat nach der Planung eines Berichterstellungsjobs Zugriff auf Daten von etwa sieben Monaten. (Alle Verlaufsdaten für Jobs, die vor dieser Ankündigung erstellt wurden, sollten innerhalb eines Monats nach der Ankündigung veröffentlicht werden.)
Verlaufsdaten stehen erst seit dem 1. Juli 2015 zur Verfügung. Daher weisen Stellen, die vor dem 28. Dezember 2015 geschaffen wurden, Verlaufsdaten von weniger als 180 Tagen auf.
Alle diese Änderungen werden im neuen Abschnitt Verlaufsdaten in der Übersicht über die Reporting API erläutert.
-
Im Abschnitt Berichteigenschaften der Übersicht über die YouTube Reporting API wurden folgende Änderungen vorgenommen:
-
Aus der Dokumentation geht jetzt hervor, dass Berichte 180 Tage nach ihrer Erstellung 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 die Tatsache zu berücksichtigen, dass die API jetzt herunterladbare Berichte für Tage generiert, an denen keine Daten verfügbar waren. Diese Berichte enthalten zwar Kopfzeilen, jedoch keine zusätzlichen Daten.
-
-
Die YouTube Reporting API unterstützt demnächst eine Reihe automatisch erstellter, systemverwalteter Berichte, die Daten zu Werbeeinnahmen oder YouTube Red-Aboeinnahmen enthalten. Rechteinhaber, die in YouTube Creator Studio bereits auf manuell herunterladbare Umsatzberichte zugreifen können, stehen die Berichte zur Verfügung. Die neue API-Funktion bietet also programmatischen Zugriff auf diese Daten.
Als Vorbereitung auf die Einführung der systemverwalteten Berichte werden die folgenden API-Änderungen angekündigt:
-
Die neue
systemManaged
-Property 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
includeSystemManaged
-Parameter der Methodejobs.list
gibt an, ob die API-Antwort Jobs für systemverwaltete Berichte enthalten soll. Der Standardwert des Parameters istfalse
. -
Der neue
startTimeAtOrAfter
-Parameter der Methodejobs.reports.list
gibt an, dass die API-Antwort nur Berichte enthalten soll, 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 Erstellungszeitpunkt des Berichts bezieht, beziehen sich die neuen Parameter auf die Daten im Bericht. -
Die neue
systemManaged
-Property derreportType
-Ressource gibt an, ob die Ressource einen vom System verwalteten Bericht beschreibt. -
Der neue
includeSystemManaged
-Parameter 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 werden für die Dimension
sharing_service
die folgenden neuen Werte unterstützt:82
: Dialogfeld zur iOS-Systemaktivität83
: Google-Posteingang84
: Android Messenger
- In der YouTube Analytics API werden für die Dimension
sharingService
die folgenden neuen Werte unterstützt: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 mit einer anderen YouTube-Suchfunktion.8
: Die Daten beziehen sich auf Aufrufe, die direkt auf der YouTube-Suchergebnisseite erfolgten.
- 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 gibt an, dass die Aufrufe erfolgt sind, während das Video als Teil einer Playlist wiedergegeben wurde. - 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 mit einer anderen YouTube-Suchfunktion.SEARCH
: Die Daten beziehen sich auf Aufrufe, die direkt auf der YouTube-Suchergebnisseite erfolgten.
- 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 erfolgt sind, während das Video als Teil einer Playlist wiedergegeben wurde. - In der YouTube Reporting API wird für die Dimension „
operating_system
“ der Wert „21
“ verwendet, um Aufrufe zu identifizieren, die über Chromecast erfolgen. - In der YouTube Analytics API wird für die Dimension
operatingSystem
der 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 mit Zuschauern verknüpft sind, die den Kanal des Videos oder der Playlist abonniert haben.youtubeProduct
: Diese Dimension gibt die YouTube-Property an, auf der die Nutzeraktivität stattgefunden hat. Mögliche Werte sind die YouTube-Website (oder YouTube App), YouTube Gaming und YouTube Kids.
Die Dokumentation wurde aktualisiert und enthält jetzt neue Berichte zu Wiedergabedetails, die für Kanäle und Rechteinhaber zur Verfügung stehen. Außerdem wurden viele weitere Berichte aktualisiert. Sie können jetzt optional eine oder mehrere dieser Dimensionen als Dimensionen und/oder Filter in diesen Berichten verwenden.
-
Das Format der Tabellen, in denen die Berichte erklärt werden, wurde geändert, damit Sie gültige Kombinationen aus Dimensionen, Messwerten und Filtern einfacher ermitteln können, mit denen die einzelnen Berichte abgerufen werden können. In der folgenden Tabelle wird das neue Format für den Bericht „Gerätetyp“ für Channels erläutert:
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 erforderliche und optionale Felder beschreibt, wird in der Dokumentation zu Berichten zu Kanälen und Rechteinhabern 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 ist Eigentümer von 18 dieser Videos. Eine Video-ID identifiziert jedoch ein Video, das einem anderen Kanal gehört, während eine andere ID ein Video identifiziert, das gelöscht wurde und daher nicht mehr existiert. In diesem Fall gibt der API-Server jetzt nicht mehr einen Fehler zurück, sondern löscht jetzt die beiden Videos, auf die der Nutzer nicht zugreifen kann. Die API-Antwort enthält dann Daten für die 18 Videos, die dem API-Nutzer gehören. -
Wenn du Daten für einen leeren YouTube Analytics-
group
anforderst, gibt die API jetzt einen leeren Datensatz anstelle eines Fehlers 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. Bisher war es über die API möglich, die Entität der Gruppe hinzuzufügen. Später wurde jedoch ein nicht autorisierter Fehler zurückgegeben, als Sie versucht haben, Berichtsdaten für diese Gruppe abzurufen. -
Die
groups.list
-Methode der YouTube Analytics API unterstützt jetzt die Paginierung. Wenn die API-Antwort nicht alle verfügbaren Gruppen enthält, gibt der ParameternextPageToken
der Antwort ein Token an, mit dem die nächste Ergebnisseite abgerufen werden kann. Setzen Sie den ParameterpageToken
der Methode auf diesen Wert, um zusätzliche Ergebnisse abzurufen. -
Die YouTube Analytics API unterstützt jetzt den Messwert
redPartnerRevenue
, der den geschätzten Gesamtumsatz aus YouTube Red-Abos für die ausgewählten Berichtsdimensionen angibt. Der Messwert spiegelt die Einnahmen aus Musik- und anderen Inhalten wider und wird am Monatsende angepasst.Die Liste der Berichte zu Rechteinhabern für die YouTube Analytics API wurde aktualisiert, um die Videoberichte zu ermitteln, die den Messwert
redPartnerRevenue
unterstützen:- Grundlegende Statistiken
- Zeitbasiert
- Standort des Nutzers
- Top-Videos: Für diesen Bericht wird
redPartnerRevenue
auch als Sortiermesswert unterstützt. Das bedeutet, dass du eine Liste von Videos abrufen kannst, sortiert nach ihren YouTube Red-Einnahmen.
-
In der Berichtsdefinition Top-Videos für die YouTube Analytics API wird jetzt berücksichtigt, 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 auf den 24-Stunden-Zeitraum ab 00:00 Uhr Pacific Time (UTC-8) bezieht. Zuvor wurde in der Dokumentation angegeben, dass das Datum um 00:00 Uhr (GMT) begann.Außerdem wurde die Dokumentation zur YouTube Analytics API aktualisiert. Alle datumsbezogenen Dimensionen (
day
,7DayTotals
,30DayTotals
undmonth
) beziehen sich nun auf Datumsangaben, die um 00:00 Uhr Pacific Time (UTC-8) beginnen. -
Die
jobs.reports.list()
-Methode der YouTube Reporting API unterstützt jetzt den AbfrageparametercreatedAfter
. Wenn dieser Parameter angegeben ist, gibt er 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-Backfill. Der Parameterwert bezieht sich auf den Erstellungszeitpunkt des Berichts 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 erklärt, wie du mit dem
createdAfter
-Parameter die wiederholte Verarbeitung desselben Berichts vermeiden kannst. -
Die Definitionen der Attribute
createTime
der Ressourcejob
und der EigenschaftenstartTime
,endTime
undcreateTime
der Ressourcereport
wurden korrigiert, um zu gewährleisten, dass die Eigenschaftswerte auf Mikrosekunden und nicht auf Nanosekunden genau sind. Außerdem spiegeln alle Definitionen nun korrekt wider, dass der Attributwert ein Zeitstempel ist. -
Die Dokumentation für die Dimension „
sharingService
“ der YouTube Analytics API wurde aktualisiert und um eine Liste möglicher Dimensionswerte ergänzt. Die Liste enthält eine Reihe neuer unterstützter Dienste.Die Definition der Dimension „
sharing_service
“ der YouTube Reporting API wurde ebenfalls aktualisiert, um die neu unterstützten Werte aufzulisten. Die enum-Werte, die größer 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 einen Rechteinhaber enthalten. Es wurde für Anwendungen entwickelt, die große Datasets importieren und Tools zum Filtern, Sortieren und Mining dieser Daten bereitstellen können.
Jeder Bericht der YouTube Reporting API enthält vordefinierte Dimensionen und Messwerte. Für YouTube Analytics API-Berichte werden auch Messwerte und Dimensionen verwendet. In einem Bericht enthält 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 generiert werden soll. Sobald Sie einen Job eingerichtet haben, erstellt YouTube täglich einen Bericht, der asynchron heruntergeladen werden kann. Jeder Bericht enthält Daten für einen einzelnen 24-Stunden-Zeitraum.
-
Es handelt sich zwar um unterschiedliche APIs, aber mit der YouTube Analytics API und der YouTube Reporting API können Entwickler YouTube Analytics-Daten abrufen. Da die beiden APIs Zugriff auf ähnliche Datensätze ermöglichen, wird die Dokumentation für die beiden APIs als ein einziger Dokumentationssatz veröffentlicht.
- Der Tab Leitfäden in der Dokumentation enthält allgemeine Informationen zu beiden APIs, einschließlich einer Anleitung zum Autorisieren von API-Anfragen.
- Der Tab Bulk-Berichte enthält Referenzdokumentation und weitere Inhalte speziell für die YouTube Reporting API.
- Der Tab Gezielte Suchanfragen enthält Referenzdokumentation und weitere Inhalte speziell für die YouTube Analytics API.
- Auf dem Tab Beispiele finden Sie Codebeispiele, die für jede der beiden APIs verfügbar sind.
- Auf dem Tab Tools finden Sie zusätzliche Ressourcen, die Entwicklern bei der Implementierung einer der beiden APIs helfen können.
-
Die API-Dokumentation wurde neu strukturiert, um die API leichter verständlich 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 Berichten von Rechteinhabern. Bisher enthielt die Dokumentation separate Seiten für Berichte zu Kanalvideos und zu Kanalplaylists.
-
Die neue Datenmodellübersicht bietet eine klarere Einführung in die Funktionsweise der API. In diesem Dokument wird insbesondere erläutert, wie YouTube Messwerte, Dimensionen und Filter zur Berechnung von Berichtwerten verwendet.
-
Die Methode
reports.query
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 Sie zum Abrufen eines Berichts senden müssen.
-
-
Der neue Messwert
adEarnings
enthält die geschätzten Gesamteinnahmen (Nettoumsatz) aus allen von Google verkauften Werbequellen. Er ist kein zentraler Messwert. Die API unterstützt den MesswertadEarnings
für alle Berichte, die den Messwertearnings
bereits unterstützt haben.Außerdem wurde die Definition des Messwerts
earnings
korrigiert, da er nun die geschätzten Gesamteinnahmen aus allen von Google verkauften Werbequellen sowie aus nicht werbebezogenen Quellen enthält. Bisher wurde in der Definition fälschlicherweise angegeben, dass der Messwert nur Einnahmen aus Werbequellen umfasste. -
Der Messwert „
primaryAdGrossRevenue
“ wurde eingestellt. Verwende stattdessen den Messwert „grossRevenue
“, um Umsatzdaten abzurufen. -
Zusätzlich zum eingestellten Messwert
primaryAdGrossRevenue
werden in Berichten zur Anzeigenleistung die MesswertemonetizedPlaybacks
undplaybackBasedCpm
nicht mehr unterstützt. In mehreren Videoberichten werden diese Messwerte jedoch weiterhin unterstützt. -
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, um zu ermitteln, welche Berichte die neuen Messwerte unterstützen.videosAddedToPlaylists
: Gibt an, wie oft Videos im Gültigkeitsbereich der Anfrage YouTube-Playlists hinzugefügt wurden. Die Videos können der Playlist des Videoinhabers oder den Playlists anderer Kanäle hinzugefügt werden.videosRemovedFromPlaylists
: Gibt an, wie oft Videos, die in der Suchanfrage 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, denen ein Video automatisch hinzugefügt wird. Das gilt zum Beispiel für die Playlist „Uploads“ eines Kanals oder den Wiedergabeverlauf eines Nutzers. Beachten Sie auch, dass diese Messwerte die absolute Anzahl der Hinzufügungen und Löschungen widerspiegeln. Wenn also ein Nutzer ein Video zu einer Playlist hinzufügt, es dann entfernt und anschließend wieder hinzufügt, zeigen die Messwerte an, dass das Video zu zwei Playlists hinzugefügt 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. Beides sind 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 anhand 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 dieser Gruppe dann mit der MethodegroupItems.insert
Elemente hinzufügen. - Die Ressource
-
Berichtsdaten für eine Gruppe abrufen
Die Dokumentation zu Dimensionen wurde aktualisiert und um die Dimension
group
ergänzt, die als Filter für viele Channelberichte und Berichte zu Rechteinhabern verwendet werden kann. Wenn Sie den Filtergroup
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. -
Die API unterstützt jetzt die Möglichkeit, mehrere Werte für die Dimensionen
video
,playlist
,channel
undshow
anzugeben, wenn diese Dimensionen als Filter verwendet werden. Wenn du mehrere Werte angeben möchtest, setze den Wert des Parametersfilters
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 diesen Filter auch in die Liste der Dimensionen aufnehmen, 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 der Liste der Dimensionen hinzufügen, verwendet die API die Filterwerte auch zur Gruppierung der Ergebnisse.
Ausführliche Informationen zu dieser Funktion finden Sie in der Parameterdefinition
filters
. -
Beim Abrufen eines Channelberichts kannst du jetzt Daten für den Kanal des authentifizierten Nutzers abrufen, indem du den Wert des Parameters
ids
aufchannel==MINE
setzt. Sie können den Parameterids
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 im Kontext einer Playlist enthalten. Playlist-Berichte sind für Kanäle und Rechteinhaber verfügbar.
Alle Playlist-Berichte unterstützen die Messwerte
views
undestimatedMinutesWatched
, einige auch den MesswertaverageViewDuration
.Außerdem unterstützen alle Playlist-Berichte die folgenden neuen Messwerte. Jeder dieser Messwerte bezieht sich nur auf Playlist-Aufrufe im Web.
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 stattfanden.averageTimeInPlaylist
: Die geschätzte durchschnittliche Zeit in Minuten, die ein Zuschauer sich Videos in einer Playlist angesehen hat, nachdem die Playlist gestartet wurde.
Alle Anfragen zum Abrufen eines Playlist-Berichts müssen den Filter
isCurated
verwenden, der auf1
(isCurated==1
) festgelegt sein muss. -
Die API unterstützt jetzt einen Bericht zur Zuschauerbindung. In diesem Bericht wird gemessen, wie gut ein Video sein Publikum binden kann. Mit der neuen Dimension „
elapsedVideoTimeRatio
“ des Berichts wird die Zeit gemessen, die im Video für die entsprechenden Messwerte verstrichen ist:-
Der Messwert
audienceWatchRatio
gibt das absolute Verhältnis der Zuschauer an, die sich das Video an einer bestimmten Stelle im Video ansehen. Das Verhältnis wird berechnet, indem die Häufigkeit, mit der ein Teil eines Videos angesehen wurde, mit der Gesamtzahl der Aufrufe des Videos verglichen wird.Beachte, dass ein Teil eines Videos pro Videoaufruf mehrmals oder gar nicht angesehen werden kann. Wenn Nutzer beispielsweise ein Video mehrmals zurückspulen und denselben Teil eines Videos ansehen, kann das absolute Verhältnis für diesen Teil des Videos größer als
1
sein. -
Der Messwert
relativeRetentionPerformance
gibt an, wie gut die Zuschauerbindung während der Wiedergabe eines Videos im Vergleich zu allen YouTube-Videos ähnlicher Länge ist. Ein Wert von 0 bedeutet, dass die Nutzerbindung über das Video schlechter als jedes andere Video ähnlicher Länge ist. Ein Wert von 1 bedeutet, dass die Nutzer mit dem Video eine bessere Bindung haben als jedes andere Video ähnlicher Länge. Ein Medianwert von 0,5 gibt an, dass die Hälfte der Videos ähnlicher Länge die Zuschauer besser anspricht, während die andere Hälfte die Zuschauer schlechter hält.
Sie können auch den
audienceType
-Filter verwenden, damit der Bericht nur Daten zurückgibt, die mit organischen Aufrufen, Aufrufen über TrueView In-Stream-Anzeigen oder über TrueView In-Display-Anzeigen verknüpft sind. (Organische Aufrufe sind das direkte Ergebnis einer Nutzeraktion, z. B. einer Suche nach einem Video oder einem Klick auf ein vorgeschlagenes Video.) -
-
Die API unterstützt mehrere neue Messwerte im Zusammenhang mit Annotationen. Die unten aufgeführten Messwerte können mit allen Berichten abgerufen werden, in denen zuvor die Messwerte
annotationClickThroughRate
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. Daten für die neuen Messwerte sind jedoch ab dem 16. Juli 2013 verfügbar. (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. Verweise aus Google-Suchergebnissen werden jetzt stattdessen dem Besucherquellentyp „EXT_URL
“ zugeordnet. Daher ist es nicht mehr möglich, eineninsightTrafficSourceDetail
-Bericht abzurufen, bei dem derinsightTrafficSourceType
-Filter aufGOOGLE_SEARCH
gesetzt ist. -
Das Dokument Berichte zu Rechteinhabern wurde aktualisiert, um zu berücksichtigen, 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, sodass Beispiele in Kategorien gruppiert werden. 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/Anzeigen (nur für Rechteinhaber-Berichte)
-
Das Dokument zu Beispielanfragen enthält jetzt neue Beispiele für das Abrufen 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 zu den Videos eines Kanals abgerufen. Die Daten beziehen sich auf US-Bundesstaaten und Washington D.C. Im Beispiel werden 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): Dieser Bericht ruft Statistiken zur Altersgruppe und zum Geschlecht von Zuschauern in Kalifornien ab, die sich Videos eines Kanals angesehen haben. In Berichten von Rechteinhabern werden außerdem Statistiken zur Altersgruppe und zum Geschlecht von Zuschauern abgerufen, auf die Anspruch erhoben wurde. In diesem Beispiel wird der Parameter
filters
verwendet, damit die Antwort nur Daten für eine bestimmte Provinz enthält.
-
-
Die Definition der Dimension „
province
“ wurde aktualisiert: Wenn „province
“ im Parameterwertdimensions
enthalten ist, müssen die Daten in der Anfrage auch auf die USA beschränkt werden. Dazu wirdcountry==US
in den Parameterwertfilters
aufgenommen. -
Die Dokumente, in denen die unterstützten Berichte zu Kanälen und Rechteinhabern aufgeführt sind, wurden neu gestaltet. 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 in 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 Distrikt Kolumbien abrufen. Die API unterstützt zwei Verwendungsmöglichkeiten für diese Dimension:-
Das API unterstützt zwei Berichte, in denen Statistiken für die einzelnen Bundesstaaten aufgeführt werden. Beide Berichte sind für Kanäle und Rechteinhaber verfügbar.
- Der grundlegende Statistikbericht enthält verschiedene Statistiken, darunter die Anzahl der Aufrufe und die geschätzte Wiedergabezeit in Minuten.
- Der zeitbasierte Bericht stellt die gleichen Statistiken bereit, fasst die Daten jedoch täglich, 7 Tage, 30 Tage oder monatlich zusammen.
-
Mit dem Abfrageparameter
filters
können Sie festlegen, dass ein Bericht nur Statistiken für einen bestimmten Status enthält. Diese Art der Filterung wird in mehreren Berichten unterstützt, darunter Berichte nach Standort, Wiedergabeorten, Berichte zu Zugriffsquellen, Geräteberichte, Berichte zu Betriebssystem, Berichte zur Leistung nach demografischen Merkmalen und Berichte zu Top-Videos.
-
-
Die Dimension
continent
gibt einen statistischen Regionscode der Vereinten Nationen (UN) an, der einen Kontinent identifiziert. Diese Dimension kann nur als Filter verwendet werden. -
Die Dimension
subContinent
gibt einen statistischen Regionscode der Vereinten Nationen (UN) an, der eine Subregion eines Kontinents angibt. Diese Dimension kann auch nur als Filter verwendet werden.Da jede Subregion nur einem Kontinent zugeordnet ist, ist es nicht erforderlich, auch den Filter
continent
zu verwenden, wenn Sie den FiltersubContinent
verwenden. 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 deninsightTrafficSourceType
-WertPROMOTED
nicht mehr als gültigen Filterwert. -
Die YouTube Analytics API unterliegt jetzt der Richtlinie zur Einstellung von Produkten und Diensten, wie in den Nutzungsbedingungen beschrieben. Die nicht auf Kernfunktionen bezogenen Dimensionen und Messwerte der API unterliegen jedoch nicht der Richtlinie zur Einstellung von Produkten und Diensten. Auf den Seiten Dimensionen und metrics werden nun die wichtigsten Dimensionen und Messwerte aufgeführt. Außerdem wurden die Definitionen auf diesen Seiten aktualisiert, um Kerndimensionen und -messwerte explizit zu identifizieren.
-
Die API unterstützt jetzt
EXTERNAL_APP
als Wert für die DimensioninsightPlaybackLocationType
. Im Zusammenhang mit diesem Update werden Wiedergaben seit dem 10. September 2013 nicht mehr alsMOBILE
-Wiedergaben kategorisiert. Wiedergaben auf Mobilgeräten, die vor diesem Datum stattgefunden haben, werden jedoch weiterhin mit diesem Wert kategorisiert.Mit diesem Update werden mobile Wiedergaben jetzt je nach Art der App als
WATCH
-,EMBEDDED
- oderEXTERNAL_APP
-Wiedergaben klassifiziert. -
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 mit der KategorieYT_OTHER_PAGE
der Dimension klassifiziert. -
Die API unterstützt jetzt die Möglichkeit, Berichte nach mehreren Dimensionen und Messwerten zu sortieren. Das Beispielanfragendokument enthält ein neues Beispiel, Anfragen nach mehreren Dimensionen/Messwerten sortieren, in dem diese Funktionalität veranschaulicht wird. Die Anfrage ruft Besucherquellendaten ab und hat für den
sort
-Parameterwertday,-views
. Die Ergebnisse werden chronologisch sortiert, aber innerhalb der Ergebnismenge für jeden Tag enthält die erste Zeile Daten für die Besucherquelle, die die meisten Aufrufe generiert hat, die zweite Zeile die Daten für die Quelle, die die nächsthöhere Anzahl an Aufrufen generiert hat usw. -
Die API unterstützt jetzt zwei neue Dimensionen,
deviceType
undoperatingSystem
, mit denen Daten zu den Geräten abgerufen werden können, auf denen sich Zuschauer deine Videos ansehen. Die API unterstützt Berichte, in denen eine oder beide Dimensionen verwendet werden.-
Im Bericht „
deviceType
“ findest du die Anzahl der Aufrufe und die geschätzte Wiedergabezeit für verschiedene Gerätetypen wie 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. -
Im Bericht „
operatingSystem
“ findest du die Anzahl der Aufrufe und die geschätzte Wiedergabezeit für verschiedene Betriebssysteme wie Android, iOS oder Linux. Mit dem Filter „deviceType
“ können Sie den Betriebssystembericht so einschränken, dass er nur Statistiken für einen bestimmten Gerätetyp enthält, z. B. Mobilgeräte oder Tablets.
Die neuen Berichte zu Gerätetyp und Betriebssystem sind für Kanäle und Rechteinhaber verfügbar.
-
-
Das Dokument zu Beispielanfragen wurde aktualisiert und enthält jetzt drei Geräteberichte für Kanäle und drei Geräteberichte für Rechteinhaber.
-
Für die Dimension „
insightPlaybackLocationType
“ kann der WertYT_OTHER
zurückgegeben werden. Damit werden Datenansichten angegeben, die nicht mit einem der anderen Werte der Dimension klassifiziert wurden. -
Das Dokument Berichte zu Rechteinhabern wurde aktualisiert. Jetzt kannst du den Bericht zu den erfolgreichsten Videos in absteigender Reihenfolge nach Einnahmen sortieren, um die Videos mit den höchsten Einnahmen zu ermitteln. Dieser Bericht ist der erste, der in der zweiten Tabelle im Bereich Berichte zu Nutzeraktivitäten und Einnahmen aufgeführt ist.
-
YouTube identifiziert keine experimentellen API-Funktionen und -Dienste mehr. Stattdessen stellen wir jetzt eine Liste der YouTube-APIs bereit, die dieser Richtlinie zur Einstellung von Produkten und Diensten unterliegen.
-
Mit der API können jetzt Messwerte zur Wiedergabezeit (
estimatedMinutesWatched
,averageViewDuration
undaverageViewPercentage
) in Verbindung mit anderen Messwerten wie Aufruf-, Engagement-, Einnahme- und Anzeigenleistungsmesswerten abgerufen werden.Die Listen der verfügbaren Kanalberichte und Berichte zu Rechteinhabern wurden entsprechend aktualisiert. Die Listen sind jetzt kürzer, da die Messwerte zur Wiedergabezeit im Rahmen anderer aufgeführten Berichte abgerufen werden können.
Das Dokument Beispiel für API-Anfragen wurde ebenfalls aktualisiert.
-
Die Berichte mit den Dimensionen
insightPlaybackLocationDetail
undinsightTrafficSourceDetail
wurden folgendermaßen optimiert:-
Sie unterstützen jetzt den 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 zur 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 Berichtstypen mit dem YouTube Analytics API abgerufen werden können. Jedes Beispiel enthält eine kurze Beschreibung des Berichts, der von der Anfrage abgerufen wird, und zeigt dann die Dimensionen, Messwerte, Filter und Sortierparameter für die Anfrage an.
-
Für die Dimension „
insightTrafficSourceType
“ wird jetzt „SUBSCRIBER
“ als gültiger Wert unterstützt. Dieser Wert ermittelt 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 die Aufrufe weitergeleitet wurden. -
Die API unterstützt jetzt zwei neue Messwerte,
annotationClickThroughRate
undannotationCloseRate
. Sie beziehen sich auf Zuschauerinteraktionen mit Anmerkungen, die während deiner Videos angezeigt werden. Die Listen der Kanalberichte und Berichte zu Rechteinhabern wurden aktualisiert, um zu ermitteln, welche Berichte die neuen Messwerte unterstützen.annotationClickThroughRate
: Das Verhältnis von 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 impressionsbasierte Messwerte zur Anzeigenleistung. Weitere Informationen zu Berichten zur Anzeigenleistung findest du in der Dokumentation zu Berichten zu Rechteinhabern.
-
Die neuen unterstützten Messwerte sind unten aufgeführt. Die Liste der Berichte zu Rechteinhabern wurde aktualisiert und enthält jetzt die Berichte, die diese Messwerte unterstützen. Dazu gehören auch die beiden neuen Berichte.
earnings
: Die geschätzten Gesamteinnahmen aus allen von Google verkauften Werbequellen.grossRevenue
: geschätzter Bruttoumsatz von Google oder DoubleClick-Partnern.primaryAdGrossRevenue
: Der geschätzte Bruttoumsatz von Google oder DoubleClick-Partnern, summiert und unter dem primären Anzeigentyp für die Videowiedergaben, die im Bericht behandelt werden, klassifiziert.monetizedPlaybacks
: Das ist die Anzahl der Wiedergaben, bei denen mindestens eine Anzeigenimpression zu sehen war.playbackBasedCpm
: geschätzter Bruttoumsatz pro 1.000 Wiedergaben.impressions
: Dieser Wert gibt die Anzahl der erzielten verifizierten Anzeigenimpressionen an.impressionBasedCpm
: geschätzter Bruttoumsatz pro 1.000 Anzeigenimpressionen.
Hinweis:Ausführliche 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 Berichten zu Rechteinhabern erläutert werden.
-
Das API-Referenzhandbuch enthält nun einen Abschnitt Beispiele mit Codebeispielen, die zeigen, wie die API mithilfe der 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 die APIs Explorer, mit der 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 zu Rechteinhabern 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.
-
Im Detailbericht zum Wiedergabeort werden die eingebetteten Player angegeben, 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 am häufigsten eingebetteten Player identifiziert werden.
-
Der Bericht zu Zugriffsquellen gibt die Anzahl der Videoaufrufe an, die über verschiedene Arten von Verweis-URLs generiert wurden.
-
Im Detailbericht zu Zugriffsquellen werden die Verweis-URLs aufgeführt, die für ein bestimmtes Video und einen bestimmten Zugriffsquellentyp die meisten Aufrufe generiert haben. In diesem Bericht kannst du beispielsweise die ähnlichen Videos sehen, über die die meisten Zugriffe auf ein bestimmtes Video erzielt wurden. Dieser Bericht wird für verschiedene Zugriffsquellen unterstützt.
-
Die Berichte zur Wiedergabezeit geben an, wie lange Zuschauer damit verbracht haben, deine Inhalte anzusehen. In den Berichten können Daten für einen bestimmten Zeitraum – Tag, letzte 7 Tage, vorherige 30 Tage usw. – oder ein Land zusammengefasst werden. Wenn in einem Bericht Daten nach Tag oder Land zusammengefasst werden, kann er auch die durchschnittliche Länge jedes Videoaufrufs sowie den durchschnittlichen Prozentsatz jedes Videos angeben, den die Nutzer angesehen haben.
-
-
YouTube Analytics API ist jetzt für alle Entwickler verfügbar. Sie können die API für Ihr Projekt im Bereich Dienste in APIs console aktivieren, ohne vorher Zugriff anfordern zu müssen.
-
Im neuen Abschnitt Erste Schritte werden die Voraussetzungen und grundlegenden Schritte zum Erstellen einer Anwendung beschrieben, die das YouTube Analytics API verwendet.
-
Der neue Abschnitt Informationen zur Kontingentnutzung enthält Richtlinien zur Optimierung Ihrer API-Kontingentnutzung. Der API-Server berechnet für jede Anfrage die Abfragekosten, die von Ihrem API-Nutzungskontingent abgezogen werden. Da bei verschiedenen Berichtstypen unter Umständen stark unterschiedliche Abfragekosten anfallen, 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, um zu verdeutlichen, dass in einem Analytics-Bericht Daten basierend auf einem bestimmten Zeitraum aggregiert werden sollen. Die API unterstützt jetzt die folgenden zusätzlichen zeitlichen Dimensionen:
7DayTotals
: Die Daten im Bericht werden zusammengefasst, sodass jede Zeile Daten für einen Zeitraum von sieben Tagen enthält.30DayTotals
: Die Daten im Bericht werden zusammengefasst, sodass jede Zeile Daten für einen Zeitraum von 30 Tagen enthält.month
: Die Daten im Bericht werden nach Kalendermonat zusammengefasst.
Auch der Bereich Verfügbare Berichte wurde aktualisiert, um zu verdeutlichen, dass die API Berichte mit diesen Dimensionen unterstützt.
-
Der Abschnitt Dimensionen für Berichtselemente wurde aktualisiert. Bei API-Anfragen zum Abrufen von Rechteinhaberberichten müssen Daten entweder anhand 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 beliebtesten Videos. Diese Berichte, die als Kanalberichte oder Berichte zu Rechteinhabern verfügbar sind, enthalten Messwerte (Aufrufe, Kommentare, „Mag ich“-Bewertungen usw.) pro Land und schlüsseln diese Messwerte nach Video auf. Du kannst diese Berichte jetzt nach der Anzahl der Nutzer sortieren, die einen Kanal über die Wiedergabeseite des Videos abonniert oder gekündigt haben.
-
Die Definitionen der metrics
subscribersGained
undsubscribersLost
wurden aktualisiert, um zu verdeutlichen, dass ein Kanal Abonnenten an verschiedenen Stellen gewinnen oder verlieren kann, z. B. auf der Videowiedergabe-, der Kanalseite und der Übersicht, die auf der YouTube-Startseite angezeigt wird. Wenn diese Messwerte in einem videospezifischen Bericht erscheinen, enthalten sie nur Statistiken von der Wiedergabeseite des angegebenen Videos.
Die YouTube Reporting API unterstützt drei neue Abspannelemente sowie neue Dimensionen und Messwerte für diese Berichte. Die Berichte enthalten Impressions- und Klickstatistiken für die Abspanne, die nach Ende der Wiedergabe eines Videos angezeigt werden.
In der YouTube-Hilfe findest du weitere Informationen zum Hinzufügen von Abspannen in deinen Videos.
8. November 2016
Diese Aktualisierung umfasst die folgenden Änderungen an der YouTube Analytics API:
27. Oktober 2016
YouTube erstellt jetzt automatisch eine Reihe von vom System verwalteten Berichten zu Werbeeinnahmen für Rechteinhaber, die Zugriff auf die entsprechenden Berichte im Abschnitt Berichte von YouTube Studio haben. Die neuen systemverwalteten API-Berichte bieten einen programmatischen Zugriff auf Daten, die auch in den manuell herunterladbaren Berichten in Creator Studio verfügbar sind.
Die Übersicht über vom System verwaltete Berichte bietet einen kurzen Überblick über die neuen Berichte und erläutert, wie sie über die API abgerufen werden. Dieser Prozess unterscheidet sich geringfügig vom Abrufen von Bulk-Berichten für YouTube Analytics, da Partner zum Generieren der Berichte keine Jobs planen müssen.
Das Attribut 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 Ankündigung wird eingestellt.
Der Messwert „uniques
“ der YouTube Analytics API wurde eingestellt. Dies ist kein Hauptmesswert, der bis zum 31. Oktober 2016 unterstützt wird.
15. September 2016
Diese Aktualisierung umfasst die folgenden Änderungen an der YouTube Reporting API:
19. August 2016
Diese Aktualisierung 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 Infokartenmesswerte in zahlreichen Berichten zu Kanälen und Rechteinhabern zu berücksichtigen. Folgende Messwerte werden neu unterstützt:
Die Messwerte werden in den folgenden Berichtstypen unterstützt:
22. Juni 2016
Diese Aktualisierung 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
Diese Aktualisierung umfasst die folgenden Änderungen, die alle nur die YouTube Reporting API betreffen:
28. März 2016
Das YouTube Reporting API und das YouTube Analytics API geben jetzt Statistiken zu Aufrufen für verschiedene zusätzliche Dienste zum Teilen von Inhalten zurück.
16. März 2016
Diese Aktualisierung umfasst 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 unterstützten Messwerte für die YouTube Analytics API wurde aktualisiert. Infokartenmesswerte werden jetzt nicht mehr als unterstützte Messwerte für diese API aufgeführt. (Keiner der Berichte dieser API wurde dokumentiert, dass er einen der Kartenmesswerte unterstützt.)
Du kannst Infokartenmesswerte 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 Endnutzern in der EU bestimmte Informationen offengelegt und Einwilligungen dieser Endnutzer eingeholt werden. Endnutzer in der Europäischen Union müssen daher die Richtlinie zur Einwilligung der Nutzer in der EU einhalten. Wir haben einen Hinweis auf diese Anforderung in unseren Nutzungsbedingungen für die YouTube API hinzugefügt.
15. Dezember 2015
Diese Aktualisierung umfasst 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
Diese Aktualisierung umfasst 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: