Auf dieser Seite werden Änderungen an der YouTube Data API (v3) und Aktualisierungen der Dokumentation aufgeführt. Dieses Änderungsprotokoll abonnieren
12. September 2023
Hinweis: Diese Mitteilung wird verworfen.
Die Methode comments.markAsSpam
wurde bereits seit mehreren Jahren eingestellt. Diese Methode wird auf YouTube bereits nicht unterstützt und von der API nicht mehr unterstützt.
Alle Dokumente, in denen auf die Methode comments.markAsSpam
verwiesen wird, erhalten einen Hinweis zur Einstellung von Produkten und Diensten.
22. August 2023
Die Methode search.list
unterstützt jetzt den Parameter videoPaidProductPlacement
. Mit diesem Parameter kannst du Suchergebnisse so filtern, dass nur Videos angezeigt werden, die der Creator als bezahlte Werbung angegeben hat.
18. August 2023
Die Definition der liveStreamingDetails.concurrentViewers
der Ressource video
wurde aktualisiert. Die Anzahl gleichzeitiger Zuschauer, die die YouTube Data API zurückgibt, kann sich von der Anzahl der verarbeiteten, bereinigten und gleichzeitigen Zuschauer in YouTube Analytics unterscheiden. Weitere Informationen zu Messwerten für Livestreams findest du in der YouTube-Hilfe.
7. August 2023
Wie am 12. Juni 2023 angekündigt, wurde der Parameter relatedToVideoId
der Methode search.list
eingestellt. Dieser Parameter wird nicht mehr unterstützt und Verweise auf den Parameter wurden aus der API-Dokumentation entfernt.
28. Juni 2023
Die Methode thumbnails.set unterstützt jetzt den Fehler uploadRateLimitExceeded
. Dieser weist darauf hin, dass der Kanal in den letzten 24 Stunden zu viele Thumbnails hochgeladen hat und es später noch einmal versuchen sollte.
12. Juni 2023
Hinweis: Diese Mitteilung wird verworfen.
Der Parameter relatedToVideoId
der Methode search.list wurde verworfen. Ab dem 7. August 2023 wird der Parameter von YouTube nicht mehr unterstützt.
Zu diesem Zeitpunkt wurde der Dokumentation der Methode search.list
ein Hinweis zur Einstellung von Produkten und Diensten hinzugefügt. Dieser Parameter wird am oder nach dem 7. August 2023 vollständig aus der search.list
-Dokumentation entfernt.
Außerdem wurde ein Beispiel zum Abrufen ähnlicher Videos aus dem API-Implementierungsleitfaden entfernt.
22. August 2022
Typ-Annotationen für video.statistics-Felder wurden von einem nicht signierten Long-String zu einem String korrigiert.
5. August 2022
YouTube hat die Art und Weise geändert, wie Untertitel-IDs generiert werden. Im Zuge dieser Änderung weist YouTube allen Untertitel-Tracks neue Untertitel-IDs zu. Diese Änderung kann eine nicht abwärtskompatible Änderung für Anwendungen sein, die caption_id
-Werte speichern. Sie wirkt sich jedoch nicht auf Anwendungen aus, die keine caption_id
-Werte speichern.
Von jetzt bis zum 1. Dezember 2022 werden die Methoden captions.list
, captions.update
, captions.download
und captions.delete
sowohl die alten als auch die neuen Untertiteltrack-IDs unterstützen. Die alten Untertitel-Track-IDs werden von YouTube jedoch ab dem 1. Dezember 2022 nicht mehr unterstützt. Wenn dann eine dieser API-Methoden mit einer alten Untertitel-Track-ID aufgerufen wird, wird der Fehler captionNotFound
ausgelöst.
Zur Vorbereitung auf diese Änderung solltest du bis zum 1. Dezember 2022 alle gespeicherten Untertiteltrack-Daten vollständig ersetzen. Das bedeutet, dass du für jedes Video, für das du Untertiteltrack-Daten speicherst, die aktuell gespeicherten Daten löschen und dann die Methode captions.list
aufrufen solltest, um den aktuellen Satz von Untertiteltracks für das Video abzurufen und die Daten wie gewohnt in der API-Antwort zu speichern.
12. Juli 2022
Die Nutzungsbedingungen der YouTube API-Dienste wurden aktualisiert. Weitere Informationen findest du in den Nutzungsbedingungen für die YouTube API-Dienste – Überarbeitungsverlauf.
27. April 2022
Die Beschreibung der Methode videos.insert
wurde aktualisiert. Die maximale Dateigröße für hochgeladene Videos wurde von 128 GB auf 256 GB erhöht.
8. April 2022
Die Parameterdefinitionen myRecentSubscribers
und mySubscribers
der Methode subscriptions.list
wurden aktualisiert, um zu berücksichtigen, dass die maximale Anzahl der von der API zurückgegebenen Abonnenten möglicherweise begrenzt ist.
Diese Änderung stellt eine Korrektur der Dokumentation dar, keine Änderung des API-Verhaltens.
15. Dezember 2021
Wie am 18. November 2021 angekündigt, ist die statistics.dislikeCount
-Property der video
-Ressource neben den Änderungen, die die Anzahl der „Mag ich nicht“-Bewertungen für Videos auf der gesamten YouTube-Plattform privat machen, jetzt privat.
Weitere Informationen zu dieser Änderung findest du im offiziellen YouTube-Blog.
18. November 2021
Neben den Änderungen, die die Anzahl der „Mag ich nicht“-Bewertungen von Videos auf der gesamten YouTube-Plattform privat machen, wird die Property statistics.dislikeCount
der Ressource video
ab dem 13. Dezember 2021 auf „Privat“ gesetzt. Das bedeutet, dass die Property nur dann in eine API-Antwort vom Endpunkt videos.list
aufgenommen wird, wenn die API-Anfrage vom Videoinhaber authentifiziert wurde.
Der Endpunkt videos.rate
ist von dieser Änderung nicht betroffen.
Entwickler, die die Anzahl der „Mag ich nicht“-Bewertungen nicht öffentlich anzeigen, aber trotzdem die Anzahl der „Mag ich nicht“-Bewertungen für ihren API-Client benötigen, können beantragen, dass sie auf eine Zulassungsliste für eine Ausnahme gesetzt werden. Wenn Sie eine Ausnahme beantragen möchten, müssen Sie dieses Antragsformular ausfüllen.
Weitere Informationen zu dieser Änderung findest du im offiziellen YouTube-Blog.
2. Juli 2021
Hinweis: Diese Mitteilung wird verworfen.
Der Endpunkt commentThreads.update
wurde verworfen und wird nicht mehr unterstützt.
Dieser Endpunkt hat Funktionen dupliziert, die über andere API-Endpunkte verfügbar sind. Stattdessen können Sie die Funktion comments.update
aufrufen.
commentThreads
-Ressource erfordert, führen Sie einen sekundären Aufruf an die commentThreads.list
-Methode aus.
1. Juli 2021
Alle Entwickler, die die API-Dienste von YouTube nutzen, müssen ein API-Compliance-Audit durchlaufen, um mehr als das Standardkontingent von 10.000 Einheiten zu erhalten. Bisher haben Entwickler sowohl den Compliance-Prüfprozess als auch Anfragen für die Zuweisung zusätzlicher Quoteneinheiten das Formular zur Prüfung und Kontingentverlängerung für YouTube API-Dienste ausgefüllt und eingereicht.
Um diese Prozesse zu verdeutlichen und die Anforderungen von Entwicklern, die unsere API-Dienste verwenden, besser zu erfüllen, fügen wir drei neue Formulare und eine Anleitung zum Ausfüllen dieser Formulare hinzu:
- Geprüfte Entwickleranfragen: Entwickler, die bereits ein API-Compliance-Audit bestanden haben, können dieses kürzere Formular ausfüllen und einreichen, um eine Verlängerung des zugewiesenen Kontingents zu beantragen.
- Einspruchsformular: Entwickler, deren API-Projekte eine Compliance-Prüfung nicht bestanden haben oder die eine Erhöhung der Kontingenteinheit abgelehnt haben, können dieses Formular ausfüllen und einreichen.
- Formular für Kontrollwechsel (Change of Control): Entwickler oder jede Partei, die einen API-Client im Namen eines Entwicklers betreibt, bei denen ein Kontrollwechsel (z. B. durch einen Aktienkauf oder -verkauf, eine Fusion oder eine andere Unternehmenstransaktion) im Zusammenhang mit einem API-Projekt stattgefunden hat, müssen dieses Formular ausfüllen und einreichen. So kann das API-Team von YouTube unsere Unterlagen aktualisieren, die Einhaltung der Anwendungsfälle des neuen API-Projekts prüfen und die aktuelle Kontingentzuweisung des Entwicklers überprüfen.
Mit jedem neuen Formular werden wir darüber informiert, wie du die API von YouTube verwendest, damit wir dir besser helfen können.
Weitere Informationen finden Sie in unserem neuen Leitfaden zu API Compliance Audits.
12. Mai 2021
Hinweis: Diese Mitteilung wird verworfen.
Dieses Update umfasst die folgenden API-Änderungen:
-
Das Attribut
contentDetails.relatedPlaylists.favorites
der Ressourcechannel
wurde eingestellt. Die Funktion für Lieblingsvideos wurde bereits seit einigen Jahren eingestellt, wie im Überarbeitungsverlaufseintrag vom 28. April 2016 erwähnt.Vor diesem Update hat die API immer noch eine neue Playlist erstellt, wenn ein API-Client versucht hat, ein Video einer nicht vorhandenen Favoriten-Playlist hinzuzufügen. In diesem Fall wird die Playlist dann nicht mehr erstellt und die API gibt einen Fehler zurück. Auch Versuche, Favoriten-Playlists durch Hinzufügen, Ändern oder Löschen von Elementen zu ändern, werden nach vorherigen Ankündigungen eingestellt und können jederzeit zu Fehlermeldungen führen.
-
Die folgenden
channel
-Ressourcenattribute wurden verworfen. Diese Eigenschaften werden auf der YouTube Studio-Benutzeroberfläche und auf YouTube bereits nicht unterstützt. Daher werden sie auch nicht mehr über die API unterstützt.brandingSettings.channel.defaultTab
brandingSettings.channel.featuredChannelsTitle
brandingSettings.channel.featuredChannelsUrls[]
brandingSettings.channel.profileColor
brandingSettings.channel.showBrowseView
brandingSettings.channel.showRelatedChannels
Alle Properties wurden aus der Ressourcendarstellung
channel
entfernt und ihre Definitionen wurden aus der Attributliste der Ressource entfernt. Außerdem wurden mit diesen Attributen verbundene Fehler aus der methodenspezifischen Dokumentation entfernt. -
Die folgenden
channelSection
-Ressourcenattribute wurden verworfen. Diese Eigenschaften werden auf der YouTube Studio-Benutzeroberfläche und auf YouTube bereits nicht unterstützt. Daher werden sie auch nicht mehr über die API unterstützt.snippet.style
snippet.defaultLanguage
snippet.localized.title
localizations
localizations.(key)
localizations.(key).title
targeting
targeting.languages[]
targeting.regions[]
targeting.countries[]
Im Zuge dieser Änderung wurde auch der Parameter
hl
der MethodechannelSection.list
eingestellt, da die unterstützten Funktionen nicht mehr unterstützt werden.Alle Properties wurden aus der Ressourcendarstellung
channelSection
entfernt und ihre Definitionen wurden aus der Attributliste der Ressource entfernt. Außerdem wurden mit diesen Attributen verbundene Fehler aus der methodenspezifischen Dokumentation entfernt. -
Für das Attribut
snippet.type
der RessourcechannelSection
wurden die folgenden Werte verworfen. Diese Werte werden auf YouTube-Kanalseiten bereits nicht unterstützt und daher werden sie auch nicht mehr über die API unterstützt.likedPlaylists
likes
postedPlaylists
postedVideos
recentActivity
recentPosts
-
Das Attribut
snippet.tags[]
der Ressourceplaylist
wurde eingestellt. Diese Property wird auf YouTube bereits nicht mehr unterstützt und wird daher nicht mehr über die API unterstützt.
9. Februar 2021
Die Ressource playlistItem
unterstützt zwei neue Attribute:
- Die Property
snippet.videoOwnerChannelId
gibt die ID des Kanals an, über den das Playlist-Video hochgeladen wurde. - Die Eigenschaft
snippet.videoOwnerChannelTitle
gibt den Namen des Kanals an, auf dem das Playlist-Video hochgeladen wurde.
28. Januar 2021
Dieses Update enthält die folgenden Änderungen:
-
Die Methoden
playlistItems.delete
,playlistItems.insert
,playlistItems.list
,playlistItems.update
,playlists.delete
,playlists.list
undplaylists.update
unterstützen alle einen neuenplaylistOperationUnsupported
-Fehler. Der Fehler tritt auf, wenn eine Anfrage versucht, einen Vorgang auszuführen, der für eine bestimmte Playlist nicht zulässig ist. Ein Nutzer kann beispielsweise kein Video aus seiner Playlist mit hochgeladenen Videos oder die Playlist selbst löschen.In allen Fällen wird durch diesen Fehler der HTTP-Antwortcode
400
(ungültige Anfrage) zurückgegeben. -
Die Fehler
watchHistoryNotAccessible
undwatchLaterNotAccessible
der MethodeplaylistItems.list
wurden aus der Dokumentation entfernt. Auf den Wiedergabeverlauf und die „Später ansehen“-Listen von Nutzern kann zwar nicht über die API zugegriffen werden, diese Fehler werden jedoch nicht von der API zurückgegeben.
15. Oktober 2020
Die Richtlinien für Entwickler wurden um zwei neue Abschnitte ergänzt:
- Der neue Abschnitt III.E.4.i enthält zusätzliche Informationen zu den Daten, die über den eingebetteten YouTube-Player erhoben und gesendet werden. Du bist für alle Nutzerdaten verantwortlich, die du uns über einen eingebetteten YouTube-Player sendest, bevor der Nutzer mit dem Player interagiert hat, um eine Wiedergabeabsicht anzugeben. Du kannst einschränken, welche Daten mit YouTube geteilt werden, bevor ein Nutzer mit dem Player interagiert, indem du Autoplay auf „false“ setzt.
- Im neuen Abschnitt III.E.4.j geht es darum, den Status „Speziell für Kinder“ von Inhalten zu prüfen, bevor du sie auf deinen Websites und in deinen Apps einbettest. Du bist dafür verantwortlich, zu wissen, ob Videos, die du in deinem API-Client einbettest, speziell für Kinder sind, und die vom eingebetteten Player erhobenen Daten entsprechend zu behandeln. Daher musst du den Status der Inhalte mithilfe des YouTube Data API-Dienstes prüfen, bevor du sie über einen eingebetteten YouTube-Player in deinen API-Client einbettest.
Im neuen Leitfaden Den MadeForKids-Status eines Videos ermitteln wird erläutert, wie du den Status eines Videos als „speziell für Kinder“ mithilfe des YouTube Data API-Dienstes nachschlagen kannst.
Im Zusammenhang mit diesen Änderungen wurde der Dokumentation zu Parametern für den eingebetteten Player ein Hinweis hinzugefügt, dass die Wiedergabe bei Aktivierung von Autoplay ohne Nutzerinteraktion mit dem Player erfolgt. Die Erfassung und Weitergabe von Wiedergabedaten erfolgt daher beim Seitenaufbau.
8. Oktober 2020
Dieses Update umfasst drei kleine Änderungen in Bezug auf die Ressource channel
:
- Das Objekt
snippet.thumbnails
, das die Thumbnail-Bilder eines Kanals identifiziert, ist bei neu erstellten Kanälen möglicherweise leer und es kann bis zu einem Tag dauern, bis es angezeigt wird. - Die Property
statistics.videoCount
gibt nur die Anzahl der öffentlichen Videos des Kanals an, selbst für die Inhaber. Dieses Verhalten entspricht der Anzahl, die auf der YouTube-Website angezeigt wird. - Channel-Keywords, die in der Eigenschaft
brandingSettings.channel.keywords
angegeben sind, werden möglicherweise abgeschnitten, wenn sie die maximal zulässige Länge von 500 Zeichen überschreiten oder Anführungszeichen ohne Escapezeichen enthalten ("
). Die Begrenzung auf 500 Zeichen ist nicht pro Keyword, sondern auf die Gesamtlänge aller Keywords begrenzt. Dieses Verhalten entspricht dem auf der YouTube-Website.
9. September 2020
Hinweis: Diese Mitteilung wird verworfen.
Dieses Update umfasst die folgenden API-Änderungen. Alle Änderungen treten am oder nach dem 9. September 2020, dem Datum dieser Mitteilung, in Kraft. Daher sollten sich Entwickler nicht mehr auf die unten aufgeführten API-Funktionen verlassen.
-
Die folgenden API-Ressourcen, Methoden, Parameter und Ressourcenattribute werden sofort eingestellt und funktionieren ab dem Datum dieser Ankündigung nicht mehr:
- Die folgenden
channel
-Ressourcenattribute:- Das Attribut
statistics.commentCount
- Das Objekt
brandingSettings.image
und alle seine untergeordneten Attribute - Die Liste
brandingSettings.hints
und alle ihre untergeordneten Properties
- Das Attribut
- Der Filterparameter
categoryId
der Methodechannels.list
- Die Ressource
guideCategories
und die MethodeguideCategories.list
- Die folgenden
-
API-Antworten für die Methode
channels.list
enthalten nicht mehr das AttributprevPageToken
, wenn die API-Anfrage den ParametermanagedByMe
auftrue
setzt. Diese Änderung wirkt sich weder auf das AttributprevPageToken
für anderechannels.list
-Anfragen noch auf das AttributnextPageToken
bei anderen Anfragen aus. -
Die Attribute
contentDetails.relatedPlaylists.watchLater
undcontentDetails.relatedPlaylists.watchHistory
der Ressourcechannel
wurden am 11. August 2016 als verworfen angekündigt. Auch die Unterstützung der MethodenplaylistItems.insert
undplaylistItems.delete
für diese Playlists wurde vollständig eingestellt. Die beiden Properties wurden aus der Dokumentation entfernt. -
Der Parameter
mySubscribers
der Methodechannels.list
, der am 30. Juli 2013 als veraltet angekündigt wurde, wurde aus der Dokumentation entfernt. Verwenden Sie die Methodesubscriptions.list
und den zugehörigen ParametermySubscribers
, um eine Liste der Abonnenten des Kanals des authentifizierten Nutzers abzurufen. -
Das
invideoPromotion
-Objekt der Ressourcechannel
und alle untergeordneten Attribute, die am 27. November 2017 als veraltet angekündigt wurden, wurden aus der Dokumentation entfernt.
29. Juli 2020
Wir haben unser Verfahren zur Berechnung von Kontingenten für API-Anfragen vereinfacht, indem wir die zusätzlichen Kosten im Zusammenhang mit dem Parameter part
entfallen. Ab sofort werden nur noch die Grundkosten für die aufgerufene Methode berechnet. Weitere Informationen zum vereinfachten Kontingent finden Sie hier.
Diese Änderung hat zur Folge, dass die Kontingentkosten für die meisten API-Aufrufe geringfügig niedriger sind, während für einige API-Aufrufe weiterhin die gleichen Kosten anfallen. Durch diese Änderung erhöhen sich nicht die Kosten für API-Aufrufe. Die wahrscheinliche Auswirkung ist insgesamt, dass Sie mit Ihrem zugewiesenen Kontingent, das Sie in der Google Cloud Console sehen können, noch mehr gehen wird.
Wir empfehlen allen Entwicklern dringend, für ihre Projekte eine Compliance-Prüfung durchzuführen, um weiterhin den Zugriff auf die YouTube API-Dienste zu ermöglichen.
Dieser Überarbeitungsverlauf wurde ursprünglich am 20. Juli 2020 veröffentlicht.
28. Juli 2020
Alle Videos, die über den Endpunkt videos.insert
aus nicht verifizierten API-Projekten hochgeladen werden, die nach dem 28. Juli 2020 erstellt wurden, werden auf den privaten Modus beschränkt. Damit diese Einschränkung aufgehoben werden kann, muss jedes Projekt einer Prüfung unterzogen werden, um die Einhaltung der Nutzungsbedingungen zu verifizieren.
Creator, die Videos über einen nicht verifizierten API-Client hochladen, erhalten eine E-Mail, in der erklärt wird, dass ihr Video als privat gesperrt ist und sie die Einschränkung durch die Verwendung eines offiziellen oder geprüften Clients vermeiden können.
API-Projekte, die vor dem 28. Juli 2020 erstellt wurden, sind derzeit nicht von dieser Änderung betroffen. Wir empfehlen allen Entwicklern jedoch dringend, für ihre Projekte eine Compliance-Prüfung durchzuführen, um weiterhin den Zugriff auf die YouTube API-Dienste sicherzustellen.
21. Juli 2020
[Aktualisiert am 28. Juli 2020.] Die Aktualisierung der Dokumentation, auf die in diesem Überarbeitungsverlaufseintrag verwiesen wird, wurde am 28. Juli 2020 neu veröffentlicht.
Gestern haben wir eine aktualisierte Dokumentation zu unserem Prozess zur Berechnung von Kontingenten veröffentlicht. Aufgrund unvorhergesehener Umstände ist die Kontingentänderung jedoch noch nicht wirksam. Aus diesem Grund wurde die Dokumentation im Interesse der Richtigkeit zurückgesetzt. Der Überarbeitungsverlauf, in dem die Änderung erläutert wird, wurde entfernt und in naher Zukunft wieder veröffentlicht, um Verwechslungen zu vermeiden.
7. Juli 2020
Hinweis: Diese Mitteilung wird verworfen.
Die Parameter autoLevels
und stabilize
der Methode videos.insert
wurden verworfen und beide Parameter wurden aus der Dokumentation entfernt. Ihre Werte werden ignoriert und haben keinen Einfluss auf die Verarbeitung neu hochgeladener Videos.
15. Juni 2020
Der neue Leitfaden Einhaltung der YouTube-Richtlinien für Entwickler enthält Anleitungen und Beispiele, mit denen du dafür sorgen kannst, dass deine API-Clients bestimmte Teile der Nutzungsbedingungen und Richtlinien (API-Nutzungsbedingungen) der YouTube API-Dienste einhalten.
In diesem Leitfaden erfährst du, wie YouTube bestimmte Aspekte der API-Nutzungsbedingungen durchsetzt. Es werden jedoch keine vorhandenen Dokumente ersetzt. In diesem Leitfaden finden Sie Antworten auf einige der häufigsten Fragen, die Entwickler bei API-Compliance-Audits stellen. Wir hoffen, dass dies die Entwicklung von Features für Sie vereinfacht, denn sie soll Ihnen helfen zu verstehen, wie wir unsere Richtlinien interpretieren und durchsetzen.
4. Juni 2020
Hinweis:Dies ist ein Update zu einer früheren Einstellungsankündigung.
Die Funktion für Kanalbulletins wurde vollständig eingestellt. Diese Änderung wurde ursprünglich am 17. April 2020 angekündigt und ist jetzt in Kraft getreten. Daher wird die Methode activities.insert
nicht mehr unterstützt und die Methode activities.list
gibt keine Kanalbulletins mehr zurück. Weitere Informationen finden Sie in der YouTube-Hilfe.
17. April 2020
Hinweis: Diese Mitteilung wird verworfen.
YouTube stellt die Funktion für Kanalbulletins ein. Daher wird die Methode activities.insert
eingestellt und die Methode activities.list
gibt keine Kanalbulletins mehr zurück. Diese Änderungen treten am oder nach dem 18. Mai 2020 in der API in Kraft. Weitere Informationen finden Sie in der YouTube-Hilfe.
31. März 2020
Dieses Update enthält die folgenden Änderungen:
-
Neue Ressourcen und Methoden
-
Die neue
member
-Ressource stellt ein Kanalmitglied für einen YouTube-Kanal dar. Mitglieder unterstützen einen Creator regelmäßig in finanzieller Hinsicht und erhalten besondere Vorteile. Mitglieder können beispielsweise chatten, wenn der Creator den Modus „Nur für Mitglieder“ für einen Chat aktiviert.Diese Ressource ersetzt die Ressource
sponsor
, die als Teil der YouTube Live Streaming API dokumentiert ist. Die Ressourcesponsor
wurde verworfen. API-Clients sollten Aufrufe an die Methodesponsors.list
aktualisieren, um stattdessen die Methodemembers.list
zu verwenden. -
Die neue
membershipsLevel
-Ressource gibt eine Preisstufe an, die von dem Ersteller verwaltet wird, der die API-Anfrage autorisiert hat. Mit der MethodemembershipsLevels.list
wird eine Liste aller Mitgliedschaftsstufen des Erstellers abgerufen.
-
10. Januar 2020
Die API unterstützt jetzt die Identifizierung von Inhalten, die auf Kinder ausgerichtet sind. Dies wird von YouTube als „speziell für Kinder“ bezeichnet. Weitere Informationen zu Inhalten speziell für Kinder findest du in der YouTube-Hilfe.
Die Ressourcen channel
und video
unterstützen zwei neue Properties, mit denen Creator und Zuschauer Inhalte erkennen können, die speziell für Kinder erstellt wurden:
-
Mit der Property
selfDeclaredMadeForKids
können Creator angeben, ob ein Kanal oder Video speziell für Kinder erstellt wurde.
Bei Channels kann dieses Attribut festgelegt werden, wenn die Methodechannels.update
aufgerufen wird. Bei Videos kann dieses Attribut festgelegt werden, wenn die Methodevideos.insert
odervideos.update
aufgerufen wird.
Dieses Attribut ist nur dann in API-Antworten enthalten, diechannel
- odervideo
-Ressourcen enthalten, wenn der Kanalinhaber die API-Anfrage autorisiert hat. -
Mit der Property
madeForKids
kann jeder Nutzer den Status „speziell für Kinder“ eines Kanals oder Videos abrufen. Der Status kann beispielsweise anhand des Werts des AttributsselfDeclaredMadeForKids
ermittelt werden. Weitere Informationen zum Festlegen der Zielgruppe für deinen Kanal, deine Videos oder deine Übertragungen findest du in der YouTube-Hilfe.
Außerdem haben wir die Nutzungsbedingungen der YouTube API-Dienste und die Richtlinien für Entwickler aktualisiert. Weitere Informationen findest du in den Nutzungsbedingungen für die YouTube API-Dienste – Überarbeitungsverlauf. Die Änderungen an den Nutzungsbedingungen und Richtlinien für Entwickler der YouTube API-Dienste treten am 10. Januar 2020 (UTC -8) in Kraft.
10. September 2019
Die API-Referenzdokumentation wurde aktualisiert, um eine Änderung an der Art und Weise zu berücksichtigen, wie Abonnentenzahlen auf YouTube und folglich auch in API-Antworten gemeldet werden. Infolge dieser Änderung werden die vom YouTube Data API-Dienst zurückgegebenen Abonnentenzahlen auf drei signifikante Stellen abgerundet, wenn die Abonnentenzahlen größer als 1.000 Abonnenten sind. Diese Änderung wirkt sich auf das Attribut statistics.subscriberCount der Ressource channel
aus.
Hinweis:Diese Änderung wirkt sich auch dann auf diesen Attributwert aus, wenn ein Nutzer eine autorisierte Anfrage für Daten zu seinem eigenen Kanal sendet. Kanalinhaber können die exakten Abonnentenzahlen weiterhin in YouTube Studio sehen.
Wenn ein Kanal beispielsweise 123.456 Abonnenten hat, enthält die Property statistics.subscriberCount
den Wert 123000
.
Die folgende Tabelle zeigt Beispiele dafür, wie Abonnentenzahlen in API-Antworten gerundet und in anderen öffentlich sichtbaren YouTube-Benutzeroberflächen abgekürzt werden:
Abonnentenzahl | YouTube Data API | Öffentlich sichtbare YouTube-Benutzeroberflächen |
---|---|---|
1.234 | 1230 | 1230 |
12.345 | 12300 | 12.300 |
123.456 | 123000 | 123.000 |
1.234.567 | 1230000 | 1,23 Mio. |
12.345.678 | 12300000 | 12,3 Mio. |
123,456,789 | 123000000 | 123 Mio. |
4. April 2019
Dieses Update enthält die folgenden Änderungen:
-
Die API-Referenzdokumentation wurde aktualisiert, um häufige Anwendungsfälle für jede Methode besser zu erläutern und dynamische, hochwertige Codebeispiele über das APIs Explorer-Widget bereitzustellen. Ein Beispiel finden Sie in der Dokumentation zur Methode
channels.list
. Es gibt jetzt zwei neue Elemente auf Seiten, die API-Methoden beschreiben:-
Mit dem APIs Explorer-Widget können Sie Autorisierungsbereiche auswählen, Beispielparameter und Eigenschaftswerte eingeben, dann tatsächliche API-Anfragen senden und die tatsächlichen API-Antworten ansehen. Das Widget bietet auch eine Vollbildansicht mit vollständigen Codebeispielen, die dynamisch aktualisiert werden, um die von Ihnen eingegebenen Bereiche und Werte zu verwenden.
-
Im Abschnitt Häufige Anwendungsfälle werden ein oder mehrere gängige Anwendungsfälle für die auf der Seite erläuterte Methode beschrieben. Sie können beispielsweise die Methode
channels.list
aufrufen, um Daten über einen bestimmten Kanal oder Daten über den Kanal des aktuellen Nutzers abzurufen.Über die Links in diesem Abschnitt können Sie den APIs Explorer mit Beispielwerten für Ihren Anwendungsfall füllen oder den Vollbild APIs Explorer mit diesen Werten öffnen. Diese Änderungen sollen es Ihnen erleichtern, Codebeispiele zu sehen, die direkt auf den Anwendungsfall anwendbar sind, den Sie in Ihrer eigenen Anwendung implementieren möchten.
Codebeispiele werden derzeit für Java, JavaScript, PHP, Python und curl unterstützt.
-
-
Das Tool Codebeispiele wurde ebenfalls mit einer neuen Benutzeroberfläche aktualisiert, die alle oben beschriebenen Funktionen bietet. Mit diesem Tool können Sie Anwendungsfälle für verschiedene Methoden untersuchen, Werte in den APIs Explorer laden und den APIs Explorer im Vollbildmodus öffnen, um Codebeispiele in Java, JavaScript, PHP und Python abzurufen.
Im Zusammenhang mit dieser Änderung wurden die Seiten entfernt, auf denen zuvor verfügbare Codebeispiele für Java, JavaScript, PHP und Python aufgeführt waren.
-
Die Kurzanleitungen für Java, JavaScript, PHP und Python wurden aktualisiert. In den überarbeiteten Anleitungen wird anhand von Codebeispielen aus dem APIs Explorer erläutert, wie Sie ein Beispiel mit einem API-Schlüssel und ein weiteres Beispiel mit einer OAuth 2.0-Client-ID ausführen.
Die oben beschriebenen Änderungen ersetzen ein interaktives Tool, das 2017 der API-Dokumentation hinzugefügt wurde.
9. Juli 2018
Dieses Update enthält die folgenden Änderungen:
-
Die Definition der
snippet.thumbnails
-Eigenschaft derchannel
-Ressource wurde aktualisiert. Wenn nun Miniaturansichten in Ihrer Anwendung angezeigt werden, sollten die Bild-URLs in Ihrem Code genau so verwendet werden, wie sie in API-Antworten zurückgegeben werden. Ihre Anwendung sollte in einer URL, die in einer API-Antwort zurückgegeben wird, beispielsweise nicht die Domainhttp
anstelle der Domainhttps
verwenden.Ab Juli 2018 sind URLs von Kanal-Thumbnails nur noch in der Domain
https
verfügbar. So werden die URLs in API-Antworten angezeigt. Danach werden in deiner Anwendung möglicherweise fehlerhafte Bilder angezeigt, wenn sie versucht, YouTube-Bilder aus der Domainhttp
zu laden. -
Hinweis: Diese Mitteilung wird verworfen.
Das Attribut
recordingDetails.location.altitude
der Ressourcevideo
wurde eingestellt. Es gibt keine Garantie, dass Videos Werte für diese Eigenschaft zurückgeben. Auch wenn API-Anfragen versuchen, einen Wert für dieses Attribut festzulegen, ist es möglich, dass die eingehenden Daten nicht gespeichert werden.
22. Juni 2018
Der Implementierungsleitfaden (ehemals Implementierungs- und Migrationsleitfaden) wurde aktualisiert und enthält nun keine Anleitungen für die Migration von der API V2 zur API 3. Außerdem wurden Anleitungen für Funktionen entfernt, die in der v3 API eingestellt wurden, z. B. Lieblingsvideos.
27. November 2017
Dieses Update enthält die folgenden Änderungen:
-
Hinweis: Diese Mitteilung wird verworfen.
YouTube entfernt den Support für die Funktionen Angesagtes Video und Empfohlene Website, die in der API über das
invideoPromotion
-Objekt der Ressourcechannel
unterstützt werden. Aus diesem Grund wird dieses Objekt einschließlich aller untergeordneten Eigenschaften eingestellt.Sie können noch bis zum 14. Dezember 2017
invideoPromotion
-Daten abrufen und festlegen. Nach diesem Datum:- Versuche, den
invideoPromotion
-Teil abzurufen, wennchannels.list
aufgerufen wird, geben ein leeresinvideoPromotion
oder gar keineinvideoPromotion
-Daten zurück. - Wenn versucht wird,
invideoPromotion
-Daten beim Aufrufen vonchannels.update
zu aktualisieren, wird bis mindestens 27. Mai 2018 eine erfolgreiche Antwort zurückgegeben. Sie werden jedoch als managementfrei behandelt, d. h., sie führen keine Aktualisierung durch.
Nach dem 27. Mai 2018 kann es vorkommen, dass bei diesen Anfragen Fehlermeldungen angezeigt werden, die beispielsweise darauf hinweisen, dass
invalidPromotion
ein ungültiger Teil ist. - Versuche, den
16. November 2017
Dieses Update enthält die folgenden Änderungen:
-
Das interaktive Code-Snippet-Tool unterstützt jetzt Node.js-Codebeispiele. Die Beispiele sind auch in der Dokumentation für fast alle API-Methoden verfügbar, z. B. für die Methode
channels.list
.Die anpassbaren Beispiele sollen Ihnen einen fallspezifischen Ausgangspunkt für eine Node.js-Anwendung bieten. Die Funktion ähnelt dem Code in der Node.js-Kurzanleitung. Die Beispiele enthalten jedoch einige Dienstprogrammfunktionen, die in der Kurzanleitung nicht enthalten sind:
- Mit der Funktion
removeEmptyParameters
wird eine Liste von Schlüssel/Wert-Paaren erstellt, die API-Anfrageparametern entsprechen, und entfernt die Parameter, die keine Werte haben. - Die Funktion
createResource
erstellt eine Liste von Schlüssel/Wert-Paaren, die den Attributen in einer API-Ressource entsprechen. Anschließend werden die Attribute in ein JSON-Objekt konvertiert, das ininsert
- undupdate
-Vorgängen verwendet werden kann. Das folgende Beispiel zeigt eine Reihe von Attributnamen und -werten sowie das JSON-Objekt, das der Code dafür erstellen würde:# Key-value pairs: {'id': 'ABC123', 'snippet.title': 'Resource title', 'snippet.description': 'Resource description', 'status.privacyStatus': 'private'} # JSON object: { 'id': 'ABC123', 'snippet': { 'title': 'Resource title', 'description': 'Resource description', }, 'status': { 'privacyStatus': 'private' } }
Alle diese Beispiele sind so konzipiert, dass sie heruntergeladen und lokal ausgeführt werden können. Weitere Informationen zu den Voraussetzungen für die lokale Ausführung vollständiger Codebeispiele finden Sie in der Anleitung zum Code-Snippet-Tool.
- Mit der Funktion
25. Oktober 2017
Dieses Update enthält die folgenden Änderungen:
-
Die Python-Codebeispiele im interaktiven Code-Snippet-Tool wurden aktualisiert, um die Bibliotheken
google-auth
undgoogle-auth-oauthlib
anstelle der mittlerweile eingestelltenoauth2client
-Bibliothek zu verwenden.Zusätzlich zu dieser Änderung stellt das Tool jetzt vollständige Codebeispiele für installierte Python-Anwendungen und Python-Webserveranwendungen bereit, die leicht unterschiedliche Autorisierungsabläufe verwenden. So rufen Sie die vollständigen Beispiele (und diese Änderung) auf:
- Rufen Sie das interaktive Code-Snippet-Tool oder die Dokumentation für eine API-Methode auf, z. B. die
channels.list
-Methode. - Klicken Sie über den Codebeispielen auf den Tab
Python
. - Klicken Sie auf die Ein-/Aus-Schaltfläche über den Tabs, um von der Anzeige eines Snippets zu einem vollständigen Beispiel zu wechseln.
- Auf dem Tab sollte jetzt ein vollständiges Codebeispiel angezeigt werden, in dem der Autorisierungsablauf
InstalledAppFlow
verwendet wird. Die Beschreibung über dem Beispiel erklärt dies und enthält auch einen Link zu einem Beispiel für eine Webserveranwendung. - Klicken Sie auf den Link, um zum Webserverbeispiel zu wechseln. In diesem Beispiel werden das Flask-Framework für Webanwendungen und ein anderer Autorisierungsablauf verwendet.
Alle diese Beispiele sind so konzipiert, dass sie heruntergeladen und lokal ausgeführt werden können. Wenn Sie die Beispiele ausführen möchten, lesen Sie die Anleitung zum lokalen Ausführen vollständiger Codebeispiele in der Anleitung für das Code-Snippet-Tool.
- Rufen Sie das interaktive Code-Snippet-Tool oder die Dokumentation für eine API-Methode auf, z. B. die
29. August 2017
Dieses Update enthält die folgenden Änderungen:
- Die Definition des Parameters
forContentOwner
der Methodesearch.list
wurde aktualisiert. Wenn dieser Parameter auftrue
gesetzt ist, muss der Parametertype
aufvideo
festgelegt werden. - Die Definition des
regionCode
-Parameters der Methodesearch.list
wurde aktualisiert, um zu verdeutlichen, dass der Parameter Suchergebnisse auf Videos beschränkt, die in der angegebenen Region angesehen werden können. - YouTube hat seine Branding-Logos und -Symbole aktualisiert. Neue Logos von „entwickelt mit YouTube“ können auf der Seite Branding-Richtlinien heruntergeladen werden. Andere neue YouTube-Logos und -Symbole werden ebenfalls auf dieser Seite angezeigt und können von der YouTube-Markenwebsite heruntergeladen werden.
24. Juli 2017
Dieses Update enthält die folgenden Änderungen:
- Eine neue YouTube Data API-Kurzanleitung ist für iOS verfügbar. In diesem Leitfaden wird die Verwendung der YouTube Data API in einer einfachen iOS-Anwendung erläutert, die entweder in Objective-C oder Swift geschrieben wurde.
- Das interaktive Code-Snippet-Tool für die YouTube Data API enthält jetzt eine Dokumentation zur Erläuterung einiger Funktionen des Tools:
- API-Anfragen ausführen
- Zwischen Code-Snippets und vollständigen Codebeispielen wechseln
- Boilerplate-Funktionen verwenden
- Vorhandene Ressourcen laden (für Updatemethoden)
Hinweis:Das Tool ist auch in die API-Referenzdokumentation für API-Methoden eingebettet (Beispiel).
1. Juni 2017
Dieses Update enthält die folgenden Änderungen:
-
Hinweis: Diese Mitteilung wird verworfen.
Die folgenden
video
-Ressourcenattribute werden eingestellt. Die Properties werden zwar bis zum 1. Dezember 2017 unterstützt, aber es gibt keine Garantie, dass für Videos bis dahin keine Werte für diese Properties zurückgegeben werden. Ebenso generierenvideos.insert
- undvideos.update
-Anfragen, mit denen diese Attributwerte festgelegt werden, vor diesem Datum keine Fehler. Es ist jedoch möglich, dass die eingehenden Daten nicht gespeichert werden.
17. Mai 2017
Dieses Update enthält die folgenden Änderungen:
-
Die API-Referenzdokumentation wurde aktualisiert, um Code-Snippets umfassender und interaktiver zu gestalten. Seiten, auf denen API-Methoden wie
channels.list
odervideos.rate
erläutert werden, enthalten jetzt ein interaktives Tool, mit dem sich Code-Snippets in Java, JavaScript, PHP, Python, Ruby, Apps Script und Go ansehen und anpassen lassen.Für jede Methode zeigt das Tool Code-Snippets für einen oder mehrere Anwendungsfälle an. In jedem Anwendungsfall wird eine gängige Methode zum Aufrufen dieser Methode beschrieben. Sie können beispielsweise die Methode
channels.list
aufrufen, um Daten zu einem bestimmten Kanal oder zum Kanal des aktuellen Nutzers abzurufen.Sie können auch mit Codebeispielen interagieren:
-
Wenn Sie Parameter- und Attributwerte ändern, werden die Code-Snippets dynamisch an die von Ihnen angegebenen Werte angepasst.
-
Zwischen Code-Snippets und vollständigen Beispielen wechseln Ein Code-Snippet zeigt den Teil des Codes, mit dem die API-Methode aufgerufen wird. Ein vollständiges Beispiel enthält dieses Snippet sowie Boilerplate-Code zum Autorisieren und Senden von Anfragen. Vollständige Beispiele können über die Befehlszeile oder einen lokalen Webserver kopiert und ausgeführt werden.
-
Anfragen können durch Klicken auf eine Schaltfläche ausgeführt werden. (Zum Ausführen von Anfragen müssen Sie das Tool autorisieren, die API in Ihrem Namen aufzurufen.)
Beachten Sie, dass dieses Tool den APIs Explorer auf den Seiten, auf denen es verfügbar ist, ersetzt hat. Auf jeder Seite wird ein Link angezeigt, sodass Sie auch die Anfrage, an der Sie arbeiten, im APIs Explorer laden können.
-
-
Das Tool Data API Code Snippets wurde ebenfalls mit einer neuen Benutzeroberfläche aktualisiert, die alle oben beschriebenen Funktionen bietet. Die wichtigsten neuen Funktionen auf dieser Seite sind:
- Unterstützung für API-Anfragen, die Daten schreiben.
- Unterstützung für Java-Beispiele.
- Flexibler und umfassender Boilerplate-Code für die Autorisierung von Nutzern und die Erstellung von API-Anfragen
27. April 2017
Dieses Update enthält die folgenden Änderungen:
- In neuen Kurzanleitungen wird erklärt, wie du eine einfache Anwendung einrichtest, die Anfragen an die YouTube Data API stellt. Leitfäden sind derzeit für Android, Apps Script, Go, Java, JavaScript, Node.js, PHP, Python und Ruby verfügbar.
30. März 2017
Dieses Update enthält die folgenden Änderungen:
- Die neue
topicDetails.topicCategories[]
-Eigenschaft derchannel
-Ressource enthält eine Liste von Wikipedia-URLs, die die Inhalte des Kanals beschreiben. Die URLs entsprechen den Themen-IDs, die im AttributtopicDetails.topicIds[]
der Ressource zurückgegeben werden. - Die neue
contentDetails.videoPublishedAt
-Property derplaylistItem
-Ressource gibt den Zeitpunkt an, zu dem das Video auf YouTube veröffentlicht wurde. Die Ressource enthält bereits das Attributsnippet.publishedAt
, das den Zeitpunkt angibt, zu dem das Element der Playlist hinzugefügt wurde. - Wie die Ressource
channel
gibt auch die Ressourcevideo
jetzt die EigenschafttopicDetails.topicCategories[]
zurück, die eine Liste von Wikipedia-URLs enthält, die den Inhalt des Videos beschreiben. Bei Ressourcen vom Typvideo
entsprechen die URLs den Themen-IDs, die im AttributtopicDetails.relevantTopicIds[]
der Ressource zurückgegeben werden. - Das neue Attribut
contentDetails.contentRating.mpaatRating
dervideo
-Ressource gibt die Bewertung an, die die Motion Picture Association of America für einen Filmtrailer oder eine Filmvorschau vergeben hat.
27. Februar 2017
Wie ursprünglich am 11. August 2016 angekündigt, hat YouTube die unterstützte Liste von Themen-IDs auf eine ausgewählte Liste umgestellt. Die vollständige Liste der unterstützten Themen-IDs finden Sie in den topicDetails
-Attributen für die Ressourcen channel
und video
sowie im Parameter topicId
der Methode search.list
.
An der ausgewählten Liste gibt es einige Änderungen:
- Die folgenden Themen wurden als Unterthemen von
Society
hinzugefügt:Name Themen-ID Unternehmen /m/09s1f
Zustand /m/0kt51
Militär /m/01h6rj
Politik /m/05qt0
Religion /m/06bvp
- Das Thema
Animated cartoon
, das zuvorEntertainment
untergeordnet war, wurde entfernt. - Das Thema
Children's music
, das zuvorMusic
untergeordnet war, wurde entfernt.
Aufgrund dieser Änderung werden Themen, die sich auf ein Video beziehen, jetzt immer im Attributwert topicDetails.relevantTopicIds[]
der video
-Ressource zurückgegeben.
29. November 2016
Dieses Update enthält die folgenden Änderungen:
-
Es gibt drei kleine Änderungen an der Liste der Themen-IDs, die ab dem 10. Februar 2017 unterstützt werden:
- Die Kategorie
Professional wrestling
, die zuvor der KategorieSports
untergeordnet war, ist jetzt ein untergeordnetes Element vonEntertainment
. - Die Kategorie
TV shows
, dieEntertainment
untergeordnet ist, ist neu. - Die Kategorie
Health
, die bisherLifestyle
untergeordnet war, wurde entfernt.
Beachte auch, dass es einige übergeordnete Kategorien gibt (
Entertainment
,Gaming
,Lifestyle
,Music
undSports
). Jedes Video, das einer untergeordneten Kategorie wieTennis
zugeordnet ist, wird auch dieser übergeordneten Kategorie (Sports
) zugeordnet. - Die Kategorie
10. November 2016
Dieses Update enthält die folgenden Änderungen:
-
Wie erst am 11. August 2016 angekündigt, sind aufgrund der Einstellung von Freebase und Freebase API mehrere Änderungen an den Themen-IDs erforderlich. Mit Themen-IDs werden Themen identifiziert, die mit
channel
- undvideo
-Ressourcen verknüpft sind. Mit dem SuchparametertopicId
können Sie auch nach Kanälen oder Videos zu einem bestimmten Thema suchen.Ab dem 10. Februar 2017 gibt YouTube nur noch eine kleine Anzahl von Themen-IDs anstatt der bisher sehr detaillierteren IDs zurück. Beachten Sie außerdem, dass Kanäle und Videos nicht zwangsläufig mit Themen verknüpft werden, was dem aktuellen API-Verhalten entspricht.
Damit Sie Ihre API-Clients auf diese Änderungen vorbereiten können, wurden die Definitionen der folgenden API-Parameter und -Eigenschaften aktualisiert, um die Themen-IDs aufzulisten, die nach dieser Zeit unterstützt werden. Die Liste der Kategorien ist für alle Unterkünfte gleich.
- Das Attribut
topicDetails.topicIds[]
der Ressourcechannel
. - Das Attribut
topicDetails.relevantTopicIds[]
der Ressourcevideo
. - Der Parameter
topicId
der Methodesearch.list
.
- Das Attribut
-
Hinweis: Diese Mitteilung wird verworfen.
Die folgenden Attribute werden eingestellt:
- Das Attribut
topicDetails.topicIds[]
der Ressourcechannel
. Diese Property wird bis zum 10. November 2017 unterstützt. - Das Attribut
topicDetails.relevantTopicIds[]
der Ressourcevideo
. Diese Property wird bis zum 10. November 2017 unterstützt. - Das Attribut
topicDetails.topicIds[]
der Ressourcevideo
. Nach dem 10. Februar 2017 enthält dieses Attribut keine Werte mehr. Nach diesem Datum werden über den Property-WerttopicDetails.relevantTopicIds[]
alle Themen identifiziert, die mit einem Video verknüpft sind.
- Das Attribut
-
Da Freebase bereits eingestellt wurde, wurde der Leitfaden Searching with Freebase Topics aus der Dokumentation entfernt. Dieser Leitfaden enthält Codebeispiele, die zeigen, wie eine Anwendung mit der Freebase API funktioniert.
Außerdem wurden mehrere Codebeispiele zu Themen-IDs aus der Dokumentation der Methode
search.list
entfernt.
2. November 2016
Dieses Update enthält die folgenden Änderungen:
-
Neue Properties und Parameter
-
Die Ressource
video
enthält mehrere neue Attribute:-
Die Eigenschaft
player.embedHtml
enthält ein<iframe>
-Tag, mit dem du einen Player einbetten kannst, der das Video abspielt. Die neuen Eigenschaftenplayer.embedHeight
undplayer.embedWidth
geben die Abmessungen des eingebetteten Players an. Diese Attribute werden nur zurückgegeben, wenn in der API-Anfrage ein Wert für mindestens einen der ParametermaxHeight
odermaxWidth
angegeben ist. Diese beiden neuen Parameter werden weiter unten in diesem Eintrag zum Überarbeitungsverlauf erläutert. -
Die neue
hasCustomThumbnail
-Property gibt an, ob der Video-Uploader ein benutzerdefiniertes Thumbnail für das Video bereitgestellt hat. Diese Eigenschaft ist nur für den Uploader des Videos sichtbar. -
Im neuen
fpbRatingReasons[]
sind die Gründe aufgeführt, warum das Video die FPB-Bewertung (Südafrika) erhalten hat. -
Das neue
mcstRating
gibt die Altersfreigabe an, die das Video in Vietnam erhalten hat.
-
-
Die Methode
videos.list
unterstützt zwei neue Parameter,maxHeight
undmaxWidth
. Beim Abrufen desplayer
-Teils invideo
-Ressourcen können Sie einen oder beide Parameter verwenden.Standardmäßig beträgt die Höhe des
<iframe>
, der im Attributplayer.embedHtml
zurückgegeben wird, 360 Pixel. Die Breite wird an das Seitenverhältnis des Videos angepasst. Dadurch wird sichergestellt, dass der eingebettete Player keine schwarzen Balken hat, die das Video umrahmen. Bei einem Video mit einem Seitenverhältnis von 16:9 beträgt die Breite des Players also 640 Pixel.Mit den neuen Parametern können Sie festlegen, dass der Einbettungscode anstelle der Standardabmessungen eine Höhe und/oder Breite verwenden soll, die dem Layout Ihrer Anwendung entsprechen. Der API-Server skaliert die Abmessungen des Players entsprechend, um sicherzustellen, dass der eingebettete Player keine schwarzen Balken hat, die das Video umrahmen. Beide Parameter geben die maximalen Abmessungen des eingebetteten Players an. Wenn also beide Parameter angegeben sind, kann eine Dimension trotzdem kleiner sein als der maximal zulässige Wert für diese Dimension.
Angenommen, ein Video hat ein Seitenverhältnis von 16:9. Wenn der Parameter
maxHeight
odermaxWidth
nicht festgelegt ist, würde dasplayer.embedHtml
-Tag also einen Player mit der Größe 640 × 360 enthalten.- Wenn der Parameter
maxHeight
auf720
und der ParametermaxWidth
nicht festgelegt ist, gibt die API einen Player mit der Größe 1280 × 720 zurück. - Wenn der Parameter
maxWidth
auf960
und der ParametermaxHeight
nicht festgelegt ist, gibt die API einen Player mit der Größe 960 × 540 zurück. - Wenn der Parameter
maxWidth
auf960
und der ParametermaxHeight
auf450
gesetzt ist, gibt die API einen Player mit der Größe 800 × 450 zurück.
Die oben beschriebenen neuen Eigenschaften
player.embedHeight
undplayer.embedWidth
geben die Abmessungen des Players an. - Wenn der Parameter
-
-
Änderungen an vorhandenen Methoden, Attributen und Parametern
-
Die Ressourcenbeschreibung
channelSection
wurde aktualisiert. Ein Kanal kann maximal 10 Bereiche erstellen, ohne Targeting-Daten festzulegen, und maximal 100 Bereiche mit Targeting-Daten erstellen.Außerdem wurde das Attribut
targeting
derchannelSection
-Ressource aktualisiert, um zu berücksichtigen, dass Targeting-Optionen nur mit der API festgelegt werden können. Die Ausrichtungsoptionen werden gelöscht, wenn der Kanalabschnitt über die Benutzeroberfläche der YouTube-Website geändert wird. -
Die Definition der
i18nLanguage
-Eigenschaftsnippet.name
der Ressource wurde so korrigiert, dass der Wert den Namen einer Sprache darstellt, so wie er in der Sprache geschrieben ist, die im Parameterhl
der Methodei18nLanguage.list
angegeben ist. -
Das Attribut
contentDetails.note
der RessourceplaylistItem
wurde aktualisiert. Die maximale Länge des Attributwerts beträgt 280 Zeichen. -
Die Attribute
contentDetails.startAt
undcontentDetails.endAt
der RessourceplaylistItem
wurden verworfen. Diese Felder werden ignoriert, wenn sie inplaylistItems.insert
- oderplaylistItems.update
-Anfragen festgelegt sind. -
Die Methoden
playlistItems.delete
undplaylistItems.update
unterstützen jetzt den ParameteronBehalfOfContentOwner
, der bereits für mehrere andere Methoden unterstützt wird. Anfragen, die diese Methode verwenden, müssen außerdem mit einem Token autorisiert werden, das Zugriff auf den Bereichhttps://www.googleapis.com/auth/youtubepartner
bietet. -
Die Parameter
publishedBefore
undpublishedAfter
der Methodesearch.list
wurden aktualisiert, um anzuzeigen, dass die Parameterwerte eingeschlossen sind. Wenn beispielsweise der ParameterpublishedBefore
festgelegt ist, gibt die API Ressourcen zurück, die vor oder um zur angegebenen Zeit erstellt wurden. -
Das Attribut
contentDetails.contentRating.grfilmRating
der Ressourcevideo
unterstützt drei zusätzliche Werte:grfilmK12
,grfilmK15
undgrfilmK18
. -
Die Beschreibung der Methode
videos.insert
wurde aktualisiert. Die maximale Dateigröße für hochgeladene Videos wurde von 64 GB auf 128 GB erhöht.
-
-
Neue und aktualisierte Fehler
-
Die API unterstützt die folgenden neuen Fehler:
Fehlertyp Fehlerdetails Beschreibung forbidden (403)
homeParameterDeprecated
Die Methode activities.list
gibt diesen Fehler zurück, um anzugeben, dass die Aktivitätsdaten für die Startseite des Nutzers nicht über diese API verfügbar sind. Dieser Fehler kann auftreten, wenn Sie den Parameterhome
in einer nicht autorisierten Anfrage auftrue
gesetzt haben.invalidValue (400)
invalidContentDetails
Die Methode playlistItems.insert
gibt diesen Fehler zurück, um anzugeben, dass dascontentDetails
-Objekt in der Anfrage ungültig ist. Dieser Fehler tritt möglicherweise auf, weil das FeldcontentDetails.note
mehr als 280 Zeichen enthält.forbidden (403)
watchHistoryNotAccessible
Die Methode playlistItems.list
gibt diesen Fehler zurück, um anzugeben, dass mit der Anfrage versucht wurde, Playlist-Elemente aus dem Wiedergabeverlauf abzurufen. Diese können jedoch nicht mit der API abgerufen werden.forbidden (403)
watchLaterNotAccessible
Die Methode playlistItems.list
gibt diesen Fehler zurück, um anzugeben, dass mit der Anfrage versucht wurde, Playlist-Elemente des Typs „Später ansehen“ abzurufen. Diese können jedoch nicht mit der API abgerufen werden.badRequest (400)
uploadLimitExceeded
Die Methode videos.insert
gibt diesen Fehler zurück, um anzuzeigen, dass der Kanal die maximale Anzahl von Videos überschritten hat, die hochgeladen werden können.forbidden (403)
forbiddenEmbedSetting
Die Methode videos.update
gibt diesen Fehler zurück, um anzugeben, dass die API-Anfrage versucht, eine ungültige Einbettungseinstellung für das Video festzulegen. Hinweis: Einige Kanäle sind möglicherweise nicht berechtigt, eingebettete Player für Livestreams anzubieten. Weitere Informationen findest du in der YouTube-Hilfe. -
Die Methode
playlistItems.insert
gibt keinen Fehler mehr zurück, wenn du ein doppeltes Video in eine Playlist einfügst. Dieser Fehler ist zuvor bei einigen Playlists (z. B. Lieblingsvideos) aufgetreten, bei denen Duplikate nicht erlaubt waren, die aber nicht mehr unterstützt werden. Im Allgemeinen sind doppelte Videos in Playlists zulässig.
-
-
Weitere Neuerungen
-
Der Überarbeitungsverlaufseintrag für den 15. September 2016 wurde aktualisiert, um zu verdeutlichen, dass immer die Werte
HL
bzw.WL
enthalten sind, wenn die AttributecontentDetails.relatedPlaylists.watchHistory
undcontentDetails.relatedPlaylists.watchLater
der Ressourcechannel
in einer Antwort enthalten sind. Außerdem werden diese Eigenschaften nur dann einbezogen, wenn ein autorisierter Nutzer Daten über den eigenen Kanal des Nutzers abruft.
-
15. September 2016
Dieses Update enthält die folgenden Änderungen:
-
Im Rahmen der Aktualisierung des Überarbeitungsverlaufs vom 11. August 2016 wurden mehrere Änderungen an den Themen-IDs vorgenommen. Unter anderem wurden die unterstützten Themen-IDs ab dem 10. Februar 2017 geändert. Die Liste der unterstützten Themen wird bis zum 10. November 2016 veröffentlicht.
-
Die folgenden Änderungen sind jetzt in Kraft. Diese Änderungen wurden im Rahmen der Aktualisierung des Überarbeitungsverlaufs am 11. August 2016 angekündigt:
-
Wenn die Methode
activities.list
aufgerufen wird und der Parameterhome
auftrue
gesetzt ist, enthält die API-Antwort jetzt ähnliche Elemente wie ein abgemeldeter YouTube-Nutzer auf der Startseite.Dabei handelt es sich um eine kleine Änderung, die eine bessere Nutzererfahrung bieten soll, als in der Aktualisierung des Überarbeitungsverlaufs vom 11. August 2016 beschrieben. Die Aktualisierung hatte ergeben, dass bei Anfragen mit dem Parameter
home
eine leere Liste zurückgegeben wird. -
Die Attribute
contentDetails.relatedPlaylists.watchHistory
undcontentDetails.relatedPlaylists.watchLater
der Ressourcechannel
enthalten jetzt die WerteHL
bzw.WL
für alle Channels.Diese Eigenschaften sind nur für einen autorisierten Nutzer sichtbar, der Daten über den eigenen Kanal des Nutzers abruft. Die Attribute enthalten immer die Werte
HL
undWL
, auch wenn ein autorisierter Nutzer Daten über den eigenen Kanal abruft. Daher können der Wiedergabeverlauf und die Playlist-IDs für „Später ansehen“ nicht über die API abgerufen werden.Außerdem werden bei Anfragen zum Abrufen von Playlist-Details (
playlists.list
) oder Playlist-Elementen (playlistItems.list
) für den Wiedergabeverlauf eines Kanals oder die Playlist „Später ansehen“ jetzt leere Listen zurückgegeben. Dieses Verhalten gilt für die neuen WerteHL
undWL
sowie für alle IDs des Wiedergabeverlaufs oder der Playlist „Später ansehen“, die möglicherweise bereits in deinem API-Client gespeichert wurden.
-
-
Das
fileDetails.recordingLocation
-Objekt der Ressourcevideo
und ihre untergeordneten Attribute werden nicht mehr zurückgegeben. Bisher konnten diese Daten (wie das übergeordnetefileDetails
-Objekt) nur vom Eigentümer eines Videos abgerufen werden.
11. August 2016
Dieses Update enthält die folgenden Änderungen:
-
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. Außerdem werden künftige Änderungen der aktualisierten Nutzungsbedingungen oder dieser ergänzenden Dokumente im Überarbeitungsverlauf erläutert. Über einen Link in diesem Dokument können Sie einen RSS-Feed abonnieren, in dem Änderungen im Überarbeitungsverlauf aufgeführt sind.
-
Die Einstellung von Freebase und Freebase API führt zu mehreren Änderungen in Bezug auf die Themen-IDs. Themen-IDs werden in den folgenden API-Ressourcen und -Methoden verwendet:
- Der
topicDetails
-Teil derchannel
-Ressource identifiziert Themen, die mit dem Kanal verknüpft sind. - Der
topicDetails
-Teil dervideo
-Ressource identifiziert Themen, die mit dem Video verknüpft sind. - Mit dem Parameter
topicId
der Methodesearch.list
können Sie nach Videos oder Kanälen zu einem bestimmten Thema suchen.
Änderungen an diesen Funktionen:
-
Ab dem 10. Februar 2017 gibt YouTube nur noch eine kleine Anzahl von Themen-IDs anstelle der detaillierteren IDs zurück. Dabei werden allgemeine Kategorien wie Sport oder Basketball identifiziert, aber beispielsweise keine bestimmten Teams oder Spieler. Wir werden die unterstützten Themen bekannt geben, damit Sie Zeit haben, Ihre Bewerbung auf diese Änderung vorzubereiten.
-
Alle bereits abgerufenen Freebase-Themen-IDs können bis zum 10. Februar 2017 für die Suche nach Inhalten verwendet werden. Danach können Sie jedoch nur noch die kleinere Gruppe von Themen verwenden, die im vorherigen Element angegeben wurden, um Suchergebnisse nach Thema abzurufen.
-
Wenn Sie nach dem 10. Februar 2017 versuchen, mit einer Themen-ID zu suchen, die nicht zu einer der kleineren unterstützten Themen-IDs gehört, gibt die API einen leeren Ergebnissatz zurück.
- Der
-
Mehrere API-Felder und -Parameter werden am 12. September 2016 eingestellt:
-
Mit dem Parameter
home
der Methodeactivities.list
konnte ein autorisierter Nutzer den Aktivitätsfeed abrufen, der für diesen Nutzer auf der YouTube-Startseite angezeigt werden würde. Bei Anfragen, in denen dieser Parameter nach dem 12. September 2016 verwendet wird, wird eine leere Liste zurückgegeben. -
Die Attribute
contentDetails.relatedPlaylists.watchHistory
undcontentDetails.relatedPlaylists.watchLater
der Ressourcechannel
sind nur für einen autorisierten Nutzer sichtbar, der Daten über den eigenen Kanal des Nutzers abruft. Nach dem 12. September 2016 gibtcontentDetails.relatedPlaylists.watchHistory
den WertHL
und die PropertycontentDetails.relatedPlaylists.watchLater
für alle Kanäle den WertWL
zurück.Bei Anfragen zum Abrufen von Playlist-Details (
playlists.list
) für den Wiedergabeverlauf eines Kanals oder die Playlist „Später ansehen“ wird nach dem 12. September 2016 eine leere Liste zurückgegeben. Bei Anfragen zum Abrufen von Playlist-Elementen (playlistItems.list
) in einer dieser Playlists wird ebenfalls eine leere Liste zurückgegeben. Dies gilt für die neuen WerteHL
undWL
sowie für alle IDs des Wiedergabeverlaufs oder der Playlist „Später ansehen“, die bereits in deinem API-Client gespeichert wurden. -
Das
fileDetails.recordingLocation
-Objekt der Ressourcevideo
oder eine ihrer untergeordneten Properties wird nach dem 12. September 2016 nicht mehr zurückgegeben. Diese Daten können nur vom Rechteinhaber eines Videos abgerufen werden, da das übergeordnetefileDetails
-Objekt nur von einem Videoinhaber abgerufen werden kann.
-
13. Juni 2016
Dieses Update enthält die folgenden Änderungen:
-
Das Attribut
contentDetails.googlePlusUserId
der Ressourcechannel
wurde eingestellt. Bisher war die Property nur vorhanden, wenn der Kanal mit einem Google+ Profil verknüpft war. Nach der Einstellung ist die Property nicht mehr inchannel
-Ressourcen enthalten. -
Das Attribut
snippet.authorGoogleplusProfileUrl
der Ressourcecomment
wurde eingestellt. Bisher war die Property nur vorhanden, wenn der Kanal mit einem Google+ Profil verknüpft war. Nach der Einstellung ist die Property nicht mehr incomment
-Ressourcen enthalten.
Da nach der Einstellung keines dieser Attribute zurückgegeben wird, wurden beide aus der entsprechenden Ressourcendokumentation entfernt.
31. Mai 2016
Dieses Update enthält die folgenden Änderungen:
-
Mit dem neuen
myRecentSubscribers
-Parameter der Methodesubscriptions.list
wird eine Liste der Abonnenten des Kanals des authentifizierten Nutzers in umgekehrter chronologischer Reihenfolge des Zeitpunkts abgerufen, zu dem der Kanal abonniert wurde.Mit dem neuen Parameter können nur die letzten 1.000 Abonnenten des Kanals des authentifizierten Nutzers abgerufen werden. Verwenden Sie den Parameter
mySubscribers
, um eine vollständige Liste der Abonnenten abzurufen. Dieser Parameter, der keine Abonnenten in einer bestimmten Reihenfolge zurückgibt, begrenzt nicht die Anzahl der abzurufenden Abonnenten. -
Die Definition der Eigenschaft
snippet.thumbnails.(key)
wurde für die Ressourcen activity, playlistItem, playlist, Suchergebnis, thumbnail und video aktualisiert. Für einige Videos sind zusätzliche Miniaturansichtsgrößen verfügbar.- Das Bild „
standard
“ ist 640 Pixel breit und 480 Pixel hoch. - Das Bild „
maxres
“ ist 1.280 Pixel breit und 720 Pixel hoch.
- Das Bild „
-
Die Definition des Parameters
part
der MethodechannelSection.list
wurde aktualisiert. Dertargeting
-Teil kann zu einem Preis von2
Kontingenteinheiten abgerufen werden. -
Die Methode
videos.list
gibt jetzt den Fehler verboten (403
) zurück, wenn eine falsch autorisierte Anfrage versucht, die TeilefileDetails
,processingDetails
odersuggestions
einervideo
-Ressource abzurufen. Diese Teile sind nur für den Rechteinhaber des Videos verfügbar.
17. Mai 2016
Das neue Tool Data API Code Snippets bietet kurze Code-Snippets für häufige Anwendungsfälle der YouTube Data API. Code-Snippets sind derzeit für alle schreibgeschützten API-Methoden in Apps Script, Go, JavaScript, PHP, Python und Ruby verfügbar.
Das Tool zeigt für jede Methode Codebeispiele für einen oder mehrere Anwendungsfälle an. Beispielsweise werden fünf Code-Snippets für die Methode search.list
bereitgestellt:
- Videos nach Keyword auflisten
- Videos nach Standort auflisten
- Live-Veranstaltungen auflisten
- Nach Videos des authentifizierten Nutzers suchen
- Ähnliche Videos auflisten
Für jeden Anwendungsfall zeigt das Tool die in der API-Anfrage verwendeten Parameter an. Sie können die Parameterwerte ändern. In diesem Fall aktualisiert das Tool die Code-Snippets entsprechend den angegebenen Parameterwerten.
Schließlich zeigt das Tool die API-Antwort auf jede Anfrage an. Wenn Sie die Anfrageparameter geändert haben, basiert die API-Antwort auf den von Ihnen bereitgestellten Parameterwerten. Sie müssen das Tool autorisieren, in Ihrem Namen Anfragen zu senden, damit API-Antworten angezeigt werden.
28. April 2016
Dieses Update enthält die folgenden Änderungen:
-
Die neue
contentDetails.projection
-Eigenschaft dervideo
-Ressource gibt das Projektionsformat des Videos an. Gültige Attributwerte sind360
undrectangular
. -
Die Attribute
recordingDetails.location
undfileDetails.recordingLocation
der Ressourcevideo
wurden aktualisiert, um den Unterschied zwischen den beiden Attributen zu erläutern:- Die
recordingDetails.location
-Property gibt den Standort an, den der Videoinhaber dem Video zuordnen möchte. Dieser Ort kann bearbeitet, bei öffentlichen Videos gesucht und Nutzern bei öffentlichen Videos angezeigt werden. - Der Eigenschaftswert
fileDetails.recordingLocation
ist unveränderlich und stellt den Speicherort der hochgeladenen Originalvideodatei dar. Der Wert ist nur für den Videoinhaber sichtbar.
- Die
-
Die Definition der Eigenschaft
channel
der RessourcecontentDetails.relatedPlaylists.favorites
wurde aktualisiert, um zu beachten, dass der Eigenschaftswert möglicherweise eine Playlist-ID enthält, die auf eine leere Playlist verweist und nicht abgerufen werden kann. Das liegt daran, dass die Funktion „Lieblingsvideos“ bereits eingestellt wurde. Diese Eigenschaft unterliegt nicht der Richtlinie zur Einstellung der API. -
Die Definition des Fehlers
ineligibleAccount
, die von der Methodecomments.insert
,comments.update
,commentThreads.insert
odercommentThreads.update
zurückgegeben werden kann, wurde aktualisiert, um zu verdeutlichen, dass der Fehler auftritt, wenn das zur Autorisierung der API-Anfrage verwendete YouTube-Konto nicht mit dem Google-Konto des Nutzers zusammengeführt wurde.
20. April 2016
Dieses Update enthält die folgenden Änderungen:
-
Die Definition des
part
-Parameters derchannels.update
-Methode wurde aktualisiert, um anzugeben, dasslocalizations
auch ein gültiger Wert für diesen Parameter ist. -
Der Abschnitt Kontingentnutzung des Startleitfadens wurde aktualisiert und mit der Google Developers Console verknüpft, wo Sie Ihre tatsächliche Kontingent- und Kontingentnutzung einsehen können.
16. März 2016
Dieses Update enthält die folgenden Änderungen:
-
Änderungen an vorhandenen Ressourcen und Methoden
-
Die
channelBanner
-Ressourcendokumentation wurde aktualisiert. Die empfohlene Größe für das hochgeladene Kanalbannerbild beträgt 2.560 x 1.440 Pixel. Die Mindestgröße (2048 x 1152 Pixel) hat sich nicht geändert. -
Das neue Attribut
snippet.customUrl
der Ressourcechannel
gibt die benutzerdefinierte URL an, die mit dem Kanal verknüpft ist. Nicht alle Channels haben benutzerdefinierte URLs. In der YouTube-Hilfe werden die Voraussetzungen für den Erhalt einer benutzerdefinierten URL und das Einrichten der URL erläutert. -
Das
brandingSettings.watch
-Objekt der Ressourcechannel
und alle untergeordneten Attribute wurden verworfen. -
Die API-Antwort auf eine
search.list
-Anfrage enthält jetzt einregionCode
-Attribut. Die Eigenschaft gibt den Regionscode an, der für die Suchanfrage verwendet wurde. Der Regionscode weist das API an, Suchergebnisse für das angegebene Land zurückzugeben.Der Eigenschaftswert ist ein aus zwei Buchstaben bestehender ISO-Ländercode, der die Region identifiziert. Die Methode
i18nRegions.list
gibt eine Liste der unterstützten Regionen zurück. Der Standardwert istUS
. Wenn eine nicht unterstützte Region angegeben ist, kann YouTube dennoch eine andere Region anstelle des Standardwerts für die Verarbeitung der Anfrage auswählen. -
Die Definitionen der Eigenschaften
snippet.label
undsnippet.secondaryReasons[].label
der Ressource „videoAbuseReportReason
“ wurden aktualisiert. Die Eigenschaften enthalten nun lokalisierten Labeltext für die Gründe für die Missbrauchsmeldung.Darüber hinaus unterstützt die Methode
videoAbuseReportReasons.list
jetzt den Parameterhl
, der die Sprache angibt, die für den Labeltext in der API-Antwort verwendet werden soll. Der Standardparameterwert isten_US
. -
Die neue
contentDetails.contentRating.ecbmctRating
-Property dervideo
-Ressource gibt die Bewertung eines Videos durch die türkische Abteilung für Bewertung und Klassifizierung des Ministeriums für Kultur und Tourismus an.Außerdem unterstützen API-Properties für andere Bewertungssysteme die folgenden neuen Attributwerte:
contentDetails.contentRating.fpbRating
(Südafrika)
Bewertung: 10; Wert der Immobilie:fpb10
contentDetails.contentRating.moctwRating
(Taiwan)
Bewertung: R-12; Wert der Immobilie:moctwR12
contentDetails.contentRating.moctwRating
(Taiwan)
Bewertung: R-15; Wert der Immobilie:moctwR15
-
Das Attribut
liveStreamingDetails.activeLiveChatId
der Ressource „video
“ enthält die ID des aktiven Livechats, der mit dem Video verknüpft ist. Der Wert der Eigenschaft ist nur vorhanden, wenn das Video eine aktuelle Liveübertragung ist, für die der Livechat aktiviert ist. Nach dem Ende der Übertragung und dem Ende des Livechats wird die Property für das Video nicht mehr zurückgegeben. -
Das Attribut
status.rejectionReason
der Ressourcevideo
unterstützt den neuen Attributwertlegal
.
-
-
Die API unterstützt die folgenden neuen Fehler:
Fehlertyp Fehlerdetails Beschreibung badRequest (400)
notEditable
Die Methoden channelSections.insert
,channelSections.update
undchannelSections.delete
geben diesen Fehler zurück, um anzugeben, dass der angegebene Kanalabschnitt nicht erstellt, aktualisiert oder gelöscht werden kann.badRequest (400)
styleRequired
Die Methoden channelSections.insert
undchannelSections.update
geben diesen Fehler zurück, um anzugeben, dass die in der API-Anfrage gesendete RessourcechannelSection
einen Wert für das Attributsnippet.style
enthalten muss.badRequest (400)
typeRequired
Die Methoden channelSections.insert
undchannelSections.update
geben diesen Fehler zurück, um anzugeben, dass die in der API-Anfrage gesendete RessourcechannelSection
einen Wert für das Attributsnippet.type
enthalten muss.badRequest (400)
processingFailure
Die Methode commentThreads.list
gibt diesen Fehler zurück, um anzuzeigen, dass der API-Server die Anfrage nicht verarbeiten konnte. Dies kann ein vorübergehender Fehler sein, weist aber in der Regel darauf hin, dass die Eingabe der Anfrage ungültig ist. Prüfen Sie die Struktur der RessourcecommentThread
im Anfragetext, um sicherzustellen, dass sie gültig ist.forbidden (403)
commentsDisabled
Die Methode commentThreads.list
gibt diesen Fehler zurück, um anzuzeigen, dass für das durch den ParametervideoId
angegebene Video Kommentare deaktiviert wurden.badRequest (400)
commentTextTooLong
Die Methode commentThreads.insert
gibt diesen Fehler zurück, um anzugeben, dass die eingefügte Ressourcecomment
zu viele Zeichen im Attributsnippet.topLevelComment.snippet.textOriginal
enthält.invalidValue (400)
videoAlreadyInAnotherSeriesPlaylist
Die Methode playlistItems.insert
gibt diesen Fehler zurück, um anzugeben, dass das Video, das du der Playlist hinzufügen möchtest, bereits in einer anderen Serienplaylist enthalten ist. Weitere Informationen zu Serien-Playlists findest du in der YouTube-Hilfe.badRequest (400)
subscriptionForbidden
Die Methode subscriptions.insert
gibt diesen Fehler zurück, um anzuzeigen, dass Sie die maximale Anzahl an Abos erreicht haben oder in letzter Zeit zu viele Abos erstellt haben. In letzterem Fall können Sie die Anfrage nach einigen Stunden wiederholen.badRequest (400)
invalidCategoryId
Die Methode videos.update
gibt diesen Fehler zurück, um anzugeben, dass das Attributsnippet.categoryId
in der hochgeladenen Ressource vom Typvideo
eine ungültige Kategorie-ID angegeben hat. Verwenden Sie die MethodevideoCategories.list
, um unterstützte Kategorien abzurufen.badRequest (400)
invalidDescription
Die Methode videos.update
gibt diesen Fehler zurück, um anzugeben, dass das Attributsnippet.description
in der hochgeladenen Ressourcevideo
einen ungültigen Wert angegeben hat.badRequest (400)
invalidPublishAt
Die Methode videos.update
gibt diesen Fehler zurück, um anzugeben, dass das Attributstatus.publishAt
in der hochgeladenen Ressource vom Typvideo
eine ungültige geplante Veröffentlichungszeit angegeben hat.badRequest (400)
invalidRecordingDetails
Die Methode videos.update
gibt diesen Fehler zurück, um anzugeben, dass dasrecordingDetails
-Objekt in der hochgeladenenvideo
-Ressource ungültige Aufnahmedetails angegeben hat.badRequest (400)
invalidTags
Die Methode videos.update
gibt diesen Fehler zurück, um anzugeben, dass das Attributsnippet.tags
in der hochgeladenen Ressourcevideo
einen ungültigen Wert angegeben hat.badRequest (400)
invalidTitle
Die Methode videos.update
gibt diesen Fehler zurück, um anzugeben, dass diesnippet.title
-Eigenschaft in der hochgeladenenvideo
-Ressource einen ungültigen oder leeren Videotitel angegeben hat.badRequest (400)
invalidVideoMetadata
Die Methode videos.update
gibt diesen Fehler zurück, um anzuzeigen, dass die Metadaten der Anfrage ungültig sind. Dieser Fehler tritt auf, wenn die Anfrage densnippet
-Teil einervideo
-Ressource aktualisiert, aber keinen Wert für die Attributesnippet.title
undsnippet.categoryId
festlegt.
18. Dezember 2015
Gemäß den Gesetzen der Europäischen Union (EU) müssen Endnutzern in der EU bestimmte Informationen offengelegt und Einwilligungen von Endnutzern eingeholt werden. Für Endnutzer in der Europäischen Union müssen Sie daher die Richtlinie zur Einwilligung der Nutzer in der EU einhalten. Einen entsprechenden Hinweis finden Sie in den Nutzungsbedingungen für die YouTube API.
19. November 2015
Die API unterstützt jetzt die Möglichkeit, lokalisierten Text für die Attribute snippet.title
und snippet.description
der Ressourcen playlist
und video
, die Attribute snippet.title
der Ressource channelSection
und snippet.description
der Ressource channel
festzulegen und abzurufen.
-
Lokalisierte Titel und Beschreibungen festlegen
Sie können lokalisierte Werte für eine Ressource festlegen, wenn Sie die Methode
insert
oderupdate
für diese Ressource aufrufen. Führen Sie die beiden folgenden Schritte aus, um lokalisierte Werte für eine Ressource festzulegen:-
Für das Attribut
snippet.defaultLanguage
der Ressource muss ein Wert festgelegt sein. Dieses Attribut gibt die Sprache der Attributesnippet.title
undsnippet.description
der Ressource an. Der Wert kann eine beliebige unterstützte Anwendungssprache oder die meisten anderen Sprachcodes gemäß ISO 639-1:2002 sein. Wenn du beispielsweise ein Video mit einem englischen Titel und einer Beschreibung hochlädst, würdest du die Propertysnippet.defaultLanguage
aufen
setzen.Hinweis zum Aktualisieren von
channel
-Ressourcen:Wenn Sie das Attributsnippet.defaultLanguage
für eine Ressource vom Typchannel
festlegen möchten, müssen Sie das AttributbrandingSettings.channel.defaultLanguage
aktualisieren. -
Fügen Sie der Ressource, die Sie aktualisieren möchten, das Objekt
localizations
hinzu. Jeder Objektschlüssel ist ein String, der eine Anwendungssprache oder einen Sprachcode gemäß ISO 639-1:2002 identifiziert. Jeder Schlüssel ist einem Objekt zugeordnet, das den lokalisierten Titel (und die Beschreibung) für die Ressource enthält.Im folgenden Beispiel-Snippet wird als Standardsprache der Ressource Englisch festgelegt. Außerdem werden dem Video lokalisierte deutsche und spanische Titel und Beschreibungen hinzugefügt:
{ "kind": "youtube#video", ... "snippet": { "title": "Playing soccer", "description": "We play soccer in the park on Sundays.", "defaultLanguage": "en", ... }, "localizations": "de": { "title": "Fußball spielen", "description": "Wir spielen Fußball im Park am Sonntag" }, "es": { "title": "Jugar al fútbol", "description": "Nosotros jugamos fútbol en el parque los domingos", } } }
Wichtig:Wenn Sie die lokalisierten Daten für eine Ressource aktualisieren, muss Ihre API-Anfrage alle vorhandenen lokalisierten Versionen der Daten enthalten. Wenn Sie beispielsweise im Beispiel oben eine Anfrage zum Hinzufügen von portugiesischen Daten zum Video gesendet haben, muss die Anfrage die lokalisierten Daten für Deutsch, Spanisch und Portugiesisch enthalten.
-
-
Lokalisierte Werte abrufen
Die API unterstützt zwei Möglichkeiten zum Abrufen lokalisierter Werte für eine Ressource:
-
Füge den
hl
-Parameter deinerchannels.list
-,channelSections.list
-,playlists.list
- odervideos.list
-Anfrage hinzu, um lokalisierte Daten für eine bestimmte App-Sprache abzurufen, die von der YouTube-Website unterstützt wird. Wenn lokalisierte Ressourcendetails in dieser Sprache verfügbar sind, enthält dassnippet.localized
-Objekt der Ressource die lokalisierten Werte. Wenn jedoch keine lokalisierten Details verfügbar sind, enthält dassnippet.localized
-Objekt Ressourcendetails in der Standardsprache der Ressource.Angenommen, mit einer
videos.list
-Anfrage wurden Daten für das oben beschriebene Video mit lokalisierten deutschen und spanischen Daten abgerufen. Wenn der Parameterhl
aufde
gesetzt würde, würde die Ressource die folgenden Daten enthalten:{ "kind": "youtube#video", ... "snippet": { "title": "Playing soccer", "description": "We play soccer in the park on Sundays.", "defaultLanguage": "en", "localized": { "title": "Fußball spielen", "description": "Wir spielen Fußball im Park am Sonntag" } ... } }
Wird der Parameter
hl
jedoch auffr
gesetzt, enthält das Objektsnippet.localized
den englischen Titel und die Beschreibung, da Englisch die Standardsprache für die Ressource ist und keine lokalisierten französischen Details verfügbar sind.Wichtig:Der Parameterhl
unterstützt nur Werte, mit denen die von der YouTube-Website unterstützten Anwendungssprachen angegeben werden. Um festzustellen, ob lokalisierter Text für andere Sprachen verfügbar ist, musst du denlocalizations
-Teil für die Ressource und einen Filter abrufen, um festzustellen, ob der lokalisierte Text vorhanden ist.
Beispielsweise müsstest du die vollständige Liste der Lokalisierungen abrufen, um festzustellen, ob lokalisierter Text auf Appalachen-Englisch verfügbar ist.
-
Füge beim Abrufen einer Ressource
localizations
in den Parameterwertpart
ein, um alle lokalisierten Details für diese Ressource abzurufen. Wenn du lokalisierte Daten für eine Sprache abrufst, die nicht der aktuellen YouTube-App-Sprache entspricht, musst du mit diesem Ansatz alle Lokalisierungen abrufen und anschließend filtern, um festzustellen, ob die gewünschten lokalisierten Daten vorhanden sind.
-
-
Fehler im Zusammenhang mit lokalisierten Textwerten
Die API unterstützt außerdem die folgenden neuen Fehler für lokalisierte Textwerte:
Fehlertyp Fehlerdetails Beschreibung badRequest (400)
defaultLanguageNotSetError
Dieser Fehler weist darauf hin, dass eine Anfrage, bei der versucht wird, das Objekt localizations
für eine Ressource einzufügen oder zu aktualisieren, fehlschlägt, weil das Attributsnippet.defaultLanguage
für diese Ressource nicht festgelegt ist. Die Methodenchannels.update
,channelSections.insert
,channelSections.update
,playlists.insert
,playlists.update
,videos.insert
undvideos.update
unterstützen diesen Fehler.badRequest (400)
localizationValidationError
Dieser Fehler weist darauf hin, dass einer der Werte im localizations
-Objekt einer Ressource nicht validiert werden konnte. Dieser Fehler kann beispielsweise auftreten, wenn das Objekt einen ungültigen Sprachcode enthält. Die Methodenchannels.update
,channelSections.insert
,channelSections.update
,playlists.insert
undplaylists.update
unterstützen diesen Fehler.
4. November 2015
Dieses Update enthält die folgenden Änderungen:
-
Änderungen an vorhandenen Ressourcen und Methoden
-
Der Parameter
order
der Methodesearch.list
wurde aktualisiert. Wenn du Liveübertragungen nachviewCount
sortierst, werden die API-Ergebnisse nach der Anzahl der gleichzeitigen Zuschauer sortiert, während die Übertragungen noch läuft. -
Der Parameter
relatedToVideoId
der Methodesearch.list
wurde aktualisiert. Wenn der Parameter festgelegt ist, werden nur noch die Parameterpart
,maxResults
,pageToken
,regionCode
,relevanceLanguage
,safeSearch
,type
(die aufvideo
gesetzt sein müssen) undfields
unterstützt werden. Diese Aktualisierung spiegelt keine Änderung des API-Verhaltens wider. -
Die Definition der
snippet.publishedAt
-Eigenschaft dervideo
-Ressource wurde aktualisiert. Der Eigenschaftswert, der das Datum und die Uhrzeit der Veröffentlichung des Videos angibt, kann sich von dem Zeitpunkt des Uploads des Videos unterscheiden. Wenn ein Video beispielsweise als privates Video hochgeladen und später veröffentlicht wird, gibt der Property-Wert den Zeitpunkt an, zu dem das Video veröffentlicht wurde. Die aktualisierte Definition erklärt außerdem, wie der Wert für private und nicht gelistete Videos ausgefüllt wird.Diese Änderung spiegelt keine Änderung des API-Verhaltens wider.
-
Die Definition des Attributs
status.publishAt
der Ressourcevideo
wurde aktualisiert:- Wenn du den Wert dieser Eigenschaft beim Aufrufen der
videos.update
-Methode festlegst, musst du auch denstatus.privacyStatus
-Eigenschaftswert aufprivate
setzen, auch wenn das Video bereits privat ist. - Wenn durch den Antrag die Veröffentlichung eines Videos in der Vergangenheit geplant wird, wird es sofort veröffentlicht. Wenn du die Eigenschaft
status.publishAt
auf ein Datum und eine Uhrzeit in der Vergangenheit setzt, hat das dieselbe Auswirkung wie die Änderung derprivacyStatus
des Videos vonprivate
zupublic
.
- Wenn du den Wert dieser Eigenschaft beim Aufrufen der
-
Die Eigenschaft
contentDetails.contentRating.cncRating
dervideo
-Ressource gibt die Bewertung des Videos durch die französische Klassifikationskommission der Klassifikationskommission an. Dieses Attribut ersetzt das AttributcontentDetails.contentRating.fmocRating
, das mittlerweile eingestellt wurde. -
Die Definition der
channel
-Ressource brandingSettings.channel.keywords wurde aktualisiert, um korrekt wiederzugeben, dass der Eigenschaftswert eine durch Leerzeichen getrennte Liste von Strings und keine durch Kommas getrennte Liste enthält, wie zuvor beschrieben. Diese Aktualisierung spiegelt keine Änderung des API-Verhaltens wider. -
Die Dokumentation für die Methode
thumbnails.set
wurde aktualisiert, um genau wiederzugeben, dass der Hauptteil der Anfrage das Thumbnail enthält, das Sie hochladen und mit einem Video verknüpfen. Der Anfragetext enthält keinethumbnail
-Ressource. Bisher wurde in der Dokumentation angegeben, dass Sie beim Aufrufen dieser Methode keinen Anfragetext angeben sollten. Diese Aktualisierung spiegelt keine Änderung des API-Verhaltens wider. -
Die Beschreibung der Ressource
activity
wurde aktualisiert, um zu berücksichtigen, dass die Methodeactivities.list
derzeit keine Ressourcen für neue Videokommentare enthält. Diesnippet.type
undcontentDetails.comment
der Ressource wurden ebenfalls aktualisiert.
-
-
Neue und aktualisierte Fehler
-
Die API unterstützt jetzt die folgenden Fehler:
Fehlerdetails activities.insert
HTTP-Antwortcode badRequest (400)
Grund invalidMetadata
Beschreibung Das Attribut kind
stimmt nicht mit dem angegebenen ID-Typ überein.commentThreads.update
comments.insert
comments.update
HTTP-Antwortcode badRequest (400)
Grund commentTextTooLong
Beschreibung Die Ressource comment
, die eingefügt oder aktualisiert wird, enthält zu viele Zeichen im Attributsnippet.topLevelComment.snippet.textOriginal
.playlistItems.insert
playlistItems.update
HTTP-Antwortcode forbidden (403)
Grund playlistItemsNotAccessible
Beschreibung Die Anfrage ist nicht berechtigt, das angegebene Playlist-Element einzufügen, zu aktualisieren oder zu löschen. playlists.delete
playlists.insert
playlists.update
HTTP-Antwortcode badRequest (400)
Grund playlistForbidden
Beschreibung Dieser Vorgang ist unzulässig oder die Anfrage ist nicht ordnungsgemäß autorisiert. search.list
HTTP-Antwortcode badRequest (400)
Grund invalidLocation
Beschreibung Der Parameterwert location
und/oderlocationRadius
war falsch formatiert.search.list
HTTP-Antwortcode badRequest (400)
Grund invalidRelevanceLanguage
Beschreibung Der Parameterwert relevanceLanguage
war falsch formatiert.subscriptions.insert
HTTP-Antwortcode badRequest (400)
Grund subscriptionForbidden
Beschreibung Dieser Fehler tritt auf, wenn eine der folgenden Bedingungen erfüllt ist: - Das Abo, das Sie erstellen möchten, ist bereits vorhanden
- Du hast bereits die maximale Anzahl an Abos erreicht
- Du versuchst, deinen eigenen Kanal zu abonnieren. Dies wird nicht unterstützt.
- Sie haben in letzter Zeit zu viele Abos erstellt und müssen einige Stunden warten, bevor Sie die Anfrage wiederholen können.
videos.update
HTTP-Antwortcode badRequest (400)
Grund invalidDefaultBroadcastPrivacySetting
Beschreibung Bei der Anfrage wird versucht, eine ungültige Datenschutzeinstellung für die Standardübertragung festzulegen.
-
28. August 2015
Dieses Update enthält die folgenden Änderungen:
-
Änderungen an vorhandenen Ressourcen und Methoden
-
Das Attribut
statistics.favoriteCount
der Ressourcevideo
wurde eingestellt.Gemäß unserer Einstellungsrichtlinie wird diese Property nach dieser Ankündigung noch mindestens ein Jahr lang in
video
-Ressourcen enthalten sein. Der Attributwert ist jetzt jedoch immer auf0
festgelegt.
-
7. August 2015
Dieses Update enthält die folgenden Änderungen:
-
Änderungen an vorhandenen Ressourcen und Methoden
-
Die Definition der Eigenschaft
video
der Ressourcesnippet.tags[]
wurde aktualisiert und enthält nun mehr Informationen darüber, wie der API-Server die Länge des Eigenschaftswerts berechnet. Beachten Sie, dass diese Aktualisierung keine Änderung im Verhalten der API widerspiegelt.Insbesondere erklärt die Definition nun, dass der API-Server den Tag-Wert so behandelt, als wäre er in Anführungszeichen gesetzt, wenn ein Tag ein Leerzeichen enthält. Die Anführungszeichen werden dann auf die Zeichenbeschränkung angerechnet. Im Sinne der Zeichenbeschränkung enthält das Tag Foo-Baz sieben Zeichen, das Tag Foo Baz jedoch neun Zeichen.
-
Die Methode
commentThreads.insert
unterstützt den ParametershareOnGooglePlus
nicht mehr, der zuvor angegeben hat, ob ein Kommentar und Antworten auf diesen Kommentar auch im Google+ Profil des Autors gepostet werden sollen. Wenn der Parameter bei einer Anfrage übermittelt wird, ignoriert der API-Server den Parameter, verarbeitet die Anfrage aber ansonsten.
-
18. Juni 2015
Dieses Update enthält die folgenden Änderungen:
-
Änderungen an vorhandenen Ressourcen und Methoden
-
Der neue Parameter
order
der MethodecommentThreads.list
gibt die Reihenfolge an, in der die API-Antwort Kommentarthreads auflisten soll. Threads können nach Zeit oder Relevanz sortiert werden. Standardmäßig werden sie nach Zeit sortiert. -
Die neue
snippet.defaultAudioLanguage
-Eigenschaft dervideo
-Ressource gibt die Sprache des Standard-Audiotracks des Videos an. -
Die Definition der
contentDetails.licensedContent
-Property dervideo
-Ressource wurde aktualisiert, um klarzustellen, dass die Inhalte ursprünglich auf einen Kanal hochgeladen worden sein müssen, der mit einem YouTube-Contentpartner verknüpft ist, und dann von diesem Partner Anspruch erhoben haben. Dies stellt keine Änderung des tatsächlichen API-Verhaltens dar. -
Die Methoden
captions.delete
,captions.download
,captions.insert
,captions.list
undcaptions.update
unterstützen jetzt den ParameteronBehalfOfContentOwner
, der bereits für mehrere andere Methoden unterstützt wird. Anfragen, die diese Methode verwenden, müssen außerdem mit einem Token autorisiert werden, das Zugriff auf den Bereichhttps://www.googleapis.com/auth/youtubepartner
bietet.
-
-
Neue und aktualisierte Fehler
-
Die API unterstützt jetzt die folgenden Fehler:
Fehlerdetails videos.rate
HTTP-Antwortcode badRequest (400)
Grund emailNotVerified
Beschreibung Der Nutzer muss vor der Bewertung des Videos seine E-Mail-Adresse bestätigen. videos.rate
HTTP-Antwortcode badRequest (400)
Grund videoPurchaseRequired
Beschreibung Leihvideos können nur von Nutzern bewertet werden, die sie ausgeliehen haben. -
Die Methoden
subscriptions.delete
undsubscriptions.insert
unterstützen die FehleraccountClosed
undaccountSuspended
nicht mehr.
-
27. April 2015
Dieses Update enthält die folgenden Änderungen:
-
Neue Ressourcen und Methoden
-
Die neue
videoAbuseReportReason
-Ressource enthält Informationen zu einem Grund, warum ein Video wegen missbräuchlicher Inhalte gemeldet wurde. Mit der MethodevideoAbuseReportReasons.list
kannst du eine Liste aller Gründe abrufen, aus denen Videos möglicherweise gemeldet werden. -
Die neue Methode
videos.reportAbuse
bietet eine Möglichkeit, ein Video mit missbräuchlichen Inhalten zu melden. Der Text der Anfrage enthält ein JSON-Objekt, das das gemeldete Video sowie den Grund für die mutmaßlich missbräuchliche Inhalte angibt. Über die oben beschriebene MethodevideoAbuseReportReason.list
können Sie gültige Gründe abrufen.Die Migrationsanleitung wurde ebenfalls um ein Beispiel für das Melden eines missbräuchlichen Videos ergänzt. Mit dieser Änderung unterstützt die API V3 jetzt alle Funktionen der API V2, die voraussichtlich unterstützt werden. Diese Funktionen werden auch in der Migrationsanleitung erläutert.
-
-
Änderungen an vorhandenen Ressourcen und Methoden
-
Der neue
forDeveloper
-Filterparameter dersearch.list
-Methode beschränkt die Suche auf Videos, die über die Anwendung oder Website des Entwicklers hochgeladen wurden. Der ParameterforDeveloper
kann in Verbindung mit optionalen Suchparametern wie dem Parameterq
verwendet werden.Bei dieser Funktion wird jedes hochgeladene Video automatisch mit der Projektnummer getaggt, die der App des Entwicklers in der Google Developers Console zugeordnet ist.
Wenn der Parameter
forDeveloper
anschließend auftrue
gesetzt wird, verwendet der API-Server die Autorisierungsanmeldedaten der Anfrage, um den Entwickler zu identifizieren. Daher kann ein Entwickler die Ergebnisse auf Videos beschränken, die über seine eigene App oder Website hochgeladen wurden, nicht jedoch auf Videos, die über andere Apps oder Websites hochgeladen wurden.Die neue Funktion ähnelt den von der API V2 unterstützten Entwickler-Tags.
-
Mit der neuen
snippet.country
-Property derchannel
-Ressource können Kanalinhaber ihre Kanäle mit einem bestimmten Land verknüpfen.Hinweis: Um das Attribut
snippet.country
für einechannel
-Ressource festzulegen, müssen Sie das AttributbrandingSettings.channel.country
aktualisieren. -
Die API unterstützt jetzt das Targeting für
channelSection
-Ressourcen. Mit dem Targeting auf Kanalabschnitte kann die Sichtbarkeit eines Inhaltsbereichs auf Nutzer beschränkt werden, die bestimmte Kriterien erfüllen.Die API enthält drei Ausrichtungsoptionen. Ein Nutzer muss alle Targeting-Einstellungen erfüllen, damit ein Kanalbereich sichtbar ist.
-
targeting.languages[]
: Eine Liste der YouTube-Anwendungssprachen. Nutzern, die eine dieser Sprachen ausgewählt haben, wird der entsprechende Kanalabschnitt angezeigt. -
targeting.regions[]
: Eine Liste der bevorzugten Inhaltsregionen für YouTube. Der Channel-Bereich ist für Nutzer sichtbar, die eine dieser Regionen ausgewählt haben oder für die eine dieser Regionen automatisch ausgewählt wurde. -
targeting.countries[]
: Eine Liste der Länder, in denen der Kanalabschnitt angezeigt wird. Jeder Wert in der Liste ist ein Ländercode gemäß ISO 3166-1 alpha-2.
-
-
Die Definition der
contentDetails.duration
-Eigenschaft dervideo
-Ressource wurde korrigiert, sodass der Wert Stunden, Tage usw. widerspiegeln kann. -
Die Dokumentation für die Methode
channelSections.delete
,playlistItems.delete
,playlists.delete
,subscriptions.delete
undvideos.delete
wurde korrigiert, um zu verdeutlichen, dass diese Methoden im Erfolgsfall den HTTP-Antwortcode204
(No Content
) zurückgeben.
-
-
Neue und aktualisierte Fehler
-
Die API unterstützt jetzt die folgenden Fehler:
Fehlertyp Fehlerdetails Beschreibung badRequest (400)
targetInvalidCountry
Die Methoden channelSections.insert
undchannelSections.update
geben diesen Fehler zurück, wenn die eingefügte RessourcechannelSection
einen ungültigen Wert für das Attributtargeting.countries[]
enthielt.badRequest (400)
targetInvalidLanguage
Die Methoden channelSections.insert
undchannelSections.update
geben diesen Fehler zurück, wenn die eingefügte RessourcechannelSection
einen ungültigen Wert für das Attributtargeting.languages[]
enthielt.badRequest (400)
targetInvalidRegion
Die Methoden channelSections.insert
undchannelSections.update
geben diesen Fehler zurück, wenn die eingefügte RessourcechannelSection
einen ungültigen Wert für das Attributtargeting.regions[]
enthielt.badRequest (400)
operationNotSupported
Die Methode comments.insert
gibt diesen Fehler zurück, wenn der API-Nutzer keinen Kommentar als Antwort auf den Kommentar der obersten Ebene einfügen kann, der durch das Attributsnippet.parentId
angegeben wird. Bei einercommentThread
-Ressource gibt das Attributsnippet.canReply
an, ob der aktuelle Betrachter auf den Thread antworten kann.badRequest (400)
invalidChannelId
Die Methode search.list
gibt diesen Fehler zurück, wenn der ParameterchannelId
in der Anfrage eine ungültige Kanal-ID angegeben hat.badRequest (400)
subscriptionForbidden
Die Methode subscriptions.insert
gibt diesen Fehler zurück, wenn der API-Nutzer versucht, den eigenen Kanal zu abonnieren. -
Die Methode
captions.update
unterstützt die FehlerinvalidMetadata
undvideoNotFound
nicht mehr.
-
16. April 2015
Dieses Update enthält die folgenden Änderungen:
-
Das Migrationshandbuch wurde aktualisiert und erklärt, wie Anwendungen migriert werden, die noch die Kommentarfunktion von Version 2 der API verwenden.
Der Leitfaden enthält auch verschiedene Kommentarfunktionen, die von der API V2 nicht unterstützt wurden, aber von der API V3 unterstützt werden. Dazu gehören:
- Kommentare zu einem Kanal abrufen
- Alle Kommentarthreads zu einem Kanal abrufen, d. h., die API-Antwort kann Kommentare zum Kanal oder zu seinen Videos enthalten.
- Text eines Kommentars aktualisieren
- Kommentare als Spam markieren
- Moderationsstatus eines Kommentars festlegen
-
Der Leitfaden zum Abonnieren von Push-Benachrichtigungen wurde aktualisiert, um zu berücksichtigen, dass Benachrichtigungen nur an den Google PubSubHubBub-Hub und nicht wie zuvor erwähnt an den Superfeedr-Hub gesendet werden.
9. April 2015
Dieses Update enthält die folgenden Änderungen:
-
Mit den neuen Ressourcen
commentThread
undcomment
der API können Sie Kommentare abrufen, einfügen, aktualisieren, löschen und moderieren.-
Eine
commentThread
-Ressource enthält Informationen zu einem YouTube-Kommentarthread, der sich aus einem Kommentar auf oberster Ebene sowie ggf. Antworten auf diesen Kommentar zusammensetzt. EinecommentThread
-Ressource kann Kommentare zu einem Video oder einem Kanal darstellen.Der Kommentar der obersten Ebene und die Antworten sind eigentlich
comment
Ressourcen, die in der RessourcecommentThread
verschachtelt sind. Wichtig: Die RessourcecommentThread
enthält nicht unbedingt alle Antworten auf einen Kommentar. Du musst die Methodecomments.list
verwenden, wenn du alle Antworten für einen bestimmten Kommentar abrufen möchtest. Außerdem gibt es auf einige Kommentare keine Antworten.Die API unterstützt die folgenden Methoden für
commentThread
-Ressourcen:commentThreads.list
: Liste der Kommentarthreads abrufen Mit dieser Methode kannst du Kommentare abrufen, die mit einem bestimmten Video oder Kanal verknüpft sind.commentThreads.insert
: Damit wird ein neuer Kommentar auf oberster Ebene erstellt. Verwenden Sie die Methodecomments.insert
, um auf einen vorhandenen Kommentar zu antworten.commentThreads.update
: Damit kannst du einen Kommentar auf oberster Ebene ändern.
-
Eine
comment
-Ressource enthält Informationen zu einem einzelnen YouTube-Kommentar. Einecomment
-Ressource kann einen Kommentar zu einem Video oder einem Kanal darstellen. Außerdem kann es sich bei dem Kommentar um einen Top-Level-Kommentar oder um eine Antwort auf einen Top-Level-Kommentar handeln.Die API unterstützt die folgenden Methoden für
comment
-Ressourcen:comments.list
: Liste mit Kommentaren abrufen Mit dieser Methode kannst du alle Antworten auf einen bestimmten Kommentar abrufen.comments.insert
: Damit wird eine Antwort auf einen vorhandenen Kommentar erstellt.comments.update
: Kommentare bearbeiten.comments.markAsSpam
: Einen oder mehrere Kommentare als Spam melden.comments.setModerationStatus
: Legt den Moderationsstatus für einen oder mehrere Kommentare fest. So können Sie beispielsweise einen Kommentar löschen, damit er öffentlich angezeigt wird, oder einen Kommentar ablehnen, da er für die Anzeige nicht geeignet ist. Die API-Anfrage muss vom Inhaber des mit den Kommentaren verknüpften Kanals oder Videos autorisiert werden.comments.delete
: Ein Kommentar wird gelöscht.
Beachten Sie, dass der neue API-Bereich
https://www.googleapis.com/auth/youtube.force-ssl
, der im Überarbeitungsverlauf vom 2. April 2015 beschrieben wird, für Aufrufe der Methodencomments.insert
,comments.update
,comments.markAsSpam
,comments.setModerationStatus
,comments.delete
,commentThreads.insert
undcommentThreads.update
erforderlich ist. -
-
Im neuen Leitfaden Push-Benachrichtigungen abonnieren wird erläutert, wie die API Push-Benachrichtigungen über PubSubHubBub unterstützt, ein Server-zu-Server-Veröffentlichungs-/Abo-Protokoll für über das Web zugängliche Ressourcen. Ihr PubSubHubBub-Callback-Server kann Atom-Feed-Benachrichtigungen erhalten, wenn ein Kanal eine der folgenden Aktivitäten ausführt:
- ein Video hochlädt
- aktualisiert den Titel eines Videos
- aktualisiert die Beschreibung eines Videos
-
Der Migrationsleitfaden wurde ebenfalls aktualisiert, um die neue Unterstützung für Push-Benachrichtigungen zu berücksichtigen. Da die API V2 jedoch zahlreiche andere Arten von Push-Benachrichtigungen unterstützte, die von der API V3 nicht unterstützt werden, wird die PubSubHubBub-Unterstützung weiterhin im Abschnitt Verworfen dieses Leitfadens aufgeführt.
-
Der neue API-Bereich
https://www.googleapis.com/auth/youtube.force-ssl
ist jetzt ein gültiger Bereich für jede API-Methode, die zuvor denhttps://www.googleapis.com/auth/youtube
-Bereich unterstützt hat. -
Die API unterstützt jetzt die folgenden Fehler:
Fehlertyp Fehlerdetails Beschreibung badRequest (400)
invalidRating
Die Methode videos.rate
gibt diesen Fehler zurück, wenn die Anfrage einen unerwarteten Wert für den Parameterrating
enthielt. -
Die Methode
subscriptions.insert
unterstützt den FehlersubscriptionLimitExceeded
nicht mehr, der zuvor darauf hinweist, dass der mit der Anfrage identifizierte Abonnent die Ratenbegrenzung für Abos überschritten hatte.
2. April 2015
Dieses Update enthält die folgenden Änderungen:
-
Die neue
captions
-Ressource steht für einen YouTube-Untertiteltrack. Ein Untertiteltrack ist mit genau einem YouTube-Video verknüpft.Die API unterstützt Methoden zum Auflisten, Einfügen, Aktualisieren, Herunterladen und Löschen von Untertiteltracks.
-
Das Migrationshandbuch wurde ebenfalls aktualisiert. Es wird jetzt erklärt, wie Anwendungen migriert werden können, die noch Untertitelfunktionen in Version 2 der API verwenden.
-
Der neue API-Bereich
https://www.googleapis.com/auth/youtube.force-ssl
erfordert die Kommunikation mit dem API-Server über eine SSL-Verbindung.Dieser neue Bereich gewährt denselben Zugriff wie der Bereich
https://www.googleapis.com/auth/youtube
. Funktional sind diese beiden Bereiche identisch, da der YouTube API-Server nur über einen HTTPS-Endpunkt verfügbar ist. Obwohl der Bereichhttps://www.googleapis.com/auth/youtube
keine SSL-Verbindung erfordert, gibt es eigentlich keine andere Möglichkeit, eine API-Anfrage zu stellen.Der neue Bereich ist für Aufrufe aller Methoden der
caption
-Ressource erforderlich.
11. März 2015
Dieses Update enthält die folgenden Änderungen:
-
Die Migrationsanleitung für die YouTube Data API (Version 3) enthält einen neuen Tab namens Neu in der v3 API. Dort sind Funktionen aufgeführt, die von der API für Version 3 unterstützt werden, die von der API für Version 2 nicht unterstützt werden. Dieselben Funktionen wie bisher sind auch auf anderen Tabs in der Übersicht aufgeführt. Die neue Funktion, mit der erklärt wird, wie die Daten zu In-Video-Werbekampagnen eines Kanals aktualisiert werden, ist auch auf dem Tab Kanäle (Profile) aufgeführt.
-
Die Migrationsanleitung für die YouTube Data API (Version 3) wurde aktualisiert. Die API unterstützt nun die folgenden API-Funktionen von Version 2:
-
Die Migrationsanleitung für Version 3 der YouTube Data API wurde aktualisiert. Die folgenden Funktionen der API V2 werden in Version 3 nicht mehr unterstützt:
-
Videoempfehlungen abrufen: Die API Version 3 ruft keine Liste ab, die nur Videos enthält, die für den aktuellen API-Nutzer empfohlen werden. Du kannst jedoch die API v3 verwenden, um empfohlene Videos zu finden, indem du die Methode
activities.list
aufrufst und den Wert des Parametershome
auftrue
festlegst.In der API-Antwort entspricht eine Ressource einem empfohlenen Video, wenn der Wert der
snippet.type
-Propertyrecommendation
ist. In diesem Fall enthalten die PropertiescontentDetails.recommendation.reason
undcontentDetails.recommendation.seedResourceId
Informationen dazu, warum das Video empfohlen wurde. Es gibt keine Garantie, dass die Antwort eine bestimmte Anzahl von empfohlenen Videos enthält. -
Neue Abovideos abrufen: Die API V3 ruft keine Liste ab, die nur Videos enthält, die kürzlich auf Kanäle hochgeladen wurden, die der API-Nutzer abonniert hat. Du kannst jedoch die API v3 verwenden, um neue Abovideos zu finden. Rufe dazu die Methode
activities.list
auf und setze den Wert des Parametershome
auftrue
.In der API-Antwort entspricht eine Ressource einem neuen Abovideo, wenn der Wert des Attributs
snippet.type
upload
ist. Beachte, dass es keine Garantie gibt, dass die Antwort eine bestimmte Anzahl neuer Abovideos enthält. -
Push-Benachrichtigungen für Feedaktualisierungen: Die API V2 unterstützte Push-Benachrichtigungen und verwendet entweder das Simple Update Protocol (SUP) oder PubSubHubbub, um die Feeds der Nutzeraktivitäten für YouTube-Nutzer im Blick zu behalten. Es wurden Benachrichtigungen über neue Kanalabos und darüber informiert, wann Videos bewertet, geteilt, als Favoriten markiert, kommentiert oder hochgeladen wurden.
Version 3 der API unterstützt zwar Push-Benachrichtigungen über das PubSubHubbub-Protokoll, decken jedoch nur Videouploads und Aktualisierungen von Videotiteln oder -beschreibungen ab.
-
Kanalstandort: In der API Version 2 wurde das Tag
<yt:location>
verwendet, um den Standort des Nutzers so zu identifizieren, wie er im öffentlichen YouTube-Profil des Kanals angegeben ist. Einige Entwickler haben dieses Feld zwar verwendet, um einen Kanal mit einem bestimmten Land zu verknüpfen, die Daten des Felds konnten jedoch nicht konsistent für diesen Zweck verwendet werden. -
Entwickler-Tags festlegen oder abrufen: Mit der API Version 2 konnten beim Upload des Videos Keywords oder Entwickler-Tags mit einem Video verknüpft werden. Entwickler-Tags werden YouTube-Nutzern nicht angezeigt, aber Videoinhaber konnten Videos abrufen, die mit einem bestimmten Entwickler-Tag übereinstimmen.
Die API v3 bietet eine ähnliche, aber nicht identische Funktion. Entwickler können nach Videos suchen, die über ihre eigene App hochgeladen wurden. Bei dieser Funktion wird jedes hochgeladene Video automatisch mit der Projektnummer getaggt, die der App des Entwicklers in der Google Developers Console zugeordnet ist. Der Entwickler verwendet dann dieselbe Projektnummer, um nach Videos zu suchen.
-
Videos nach Veröffentlichungsdatum, Anzahl der Aufrufe oder Bewertung auflisten: In Version 2 der API kannst du mit dem Parameter
orderby
Videos in einer Playlist nach Position, Dauer, Veröffentlichungsdatum, Titel und verschiedenen anderen Werten sortieren. In der API Version 3 werden Playlist-Elemente normalerweise in aufsteigender Reihenfolge nach Position sortiert. Andere Sortieroptionen sind nicht verfügbar.Es gibt jedoch einige Ausnahmen. Ein neues Video, ein neues Lieblingsvideo, ein Video mit „Mag ich“-Bewertung oder ein kürzlich angesehenes Video wird bei den folgenden Arten von Playlists automatisch als erstes Element (
snippet.position
=0
) hinzugefügt. Somit wird jede dieser Listen effektiv in der Reihenfolge vom neuesten zum ältesten Element basierend auf dem Zeitpunkt sortiert, zu dem die Elemente zur Liste hinzugefügt wurden.- Nutzeruploads
- Lieblingsvideos
- positiv bewertete Videos
- Wiedergabeverlauf
Ein neuer Titel, der der Playlist „Später ansehen“ hinzugefügt wurde, wird jedoch als letztes Element in der Liste hinzugefügt. Die Liste wird also faktisch aufsteigend sortiert.
-
Batchverarbeitung: Die API V3 unterstützt einen der Anwendungsfälle der Batchverarbeitung, die bereits von der API V2 unterstützt wurden. Die Methoden
channels.list
,channelSections.list
,guideCategories.list
,playlistItems.list
,playlists.list
,subscriptions.list
,videoCategories.list
undvideos.list
der API V3 unterstützen alle den Parameterid
, mit dem eine durch Kommas getrennte Liste von IDs (Video-IDs, Kanal-IDs usw.) angegeben werden kann. Mit diesen Methoden können Sie mit einer einzigen Anfrage eine Liste mehrerer Ressourcen abrufen.
Mit diesen Änderungen werden nun alle Funktionen aufgeführt, die in der alten API (v2) unterstützt wurden und in der aktuellen API-Version (v3) eingestellt werden.
-
4. März 2015
Dieses Update enthält die folgenden Änderungen:
-
Die Methoden
channelSections.delete
undchannelSections.update
unterstützen jetzt den ParameteronBehalfOfContentOwner
, der bereits für mehrere andere Methoden unterstützt wird. -
Die folgenden Properties und ihre untergeordneten Properties wurden eingestellt:
brandingSettings.image.backgroundImageUrl
brandingSettings.image.largeBrandedBannerImageImapScript
brandingSettings.image.largeBrandedBannerImageUrl
brandingSettings.image.smallBrandedBannerImageImapScript
brandingSettings.image.smallBrandedBannerImageUrl
Hinweis:Keine dieser Eigenschaften unterliegt der Richtlinie zur Einstellung von APIs.
-
Die neue
contentDetails.contentRating.contentDetails.contentRating.djctqRatingReasons
-Property dervideo
-Ressource gibt die Gründe an, warum das Video die DJCQT-Bewertung (Brasilien) erhalten hat. -
Die API unterstützt jetzt die folgenden Fehler:
Fehlertyp Fehlerdetails Beschreibung notFound (404)
channelNotFound
Die Methode channels.update
gibt diesen Fehler zurück, wenn der Parameterid
der Anfrage einen Kanal angibt, der nicht gefunden werden kann.badRequest (400)
manualSortRequiredinvalidValue
Die Methoden playlistItems.insert
undplaylistItems.update
geben diesen Fehler zurück, wenn die Anfrage versucht, die Position des Playlist-Elements festzulegen, die Playlist aber keine manuelle Sortierung verwendet. Playlists können beispielsweise nach Datum oder Beliebtheit sortiert werden. Sie können diesen Fehler beheben, indem Sie das Elementsnippet.position
aus der Ressource entfernen, die im Anfragetext gesendet wurde. Wenn das Playlist-Element eine bestimmte Position in der Liste haben soll, musst du zuerst die Reihenfolge der Playlist in Manuell ändern. Diese Einstellung kann im Video-Manager von YouTube angepasst werden.forbidden (403)
channelClosed
Die Methode playlists.list
gibt diesen Fehler zurück, wenn der ParameterchannelId
der Anfrage einen Kanal angibt, der geschlossen wurde.forbidden (403)
channelSuspended
Die Methode playlists.list
gibt diesen Fehler zurück, wenn der ParameterchannelId
der Anfrage einen Kanal angibt, der gesperrt wurde.forbidden (403)
playlistForbidden
Die Methode playlists.list
gibt diesen Fehler zurück, wenn der Parameterid
der Anfrage die Anfrage nicht unterstützt oder die Anfrage nicht ordnungsgemäß autorisiert ist.notFound (404)
channelNotFound
Die Methode playlists.list
gibt diesen Fehler zurück, wenn der ParameterchannelId
der Anfrage einen Kanal angibt, der nicht gefunden werden kann.notFound (404)
playlistNotFound
Die Methode playlists.list
gibt diesen Fehler zurück, wenn der Parameterid
der Anfrage eine Playlist angibt, die nicht gefunden werden kann.notFound (404)
videoNotFound
Die Methode videos.list
gibt diesen Fehler zurück, wenn der Parameterid
der Anfrage ein Video angibt, das nicht gefunden werden kann.badRequest (400)
invalidRating
Die Methode videos.rate
gibt diesen Fehler zurück, wenn die Anfrage einen unerwarteten Wert für den Parameterrating
enthält.
2. März 2015
Dieses Update enthält die folgenden Änderungen:
-
Die Methode
search.list
unterstützt jetzt den ParameterrelevanceLanguage
, mit dem Sie Ergebnisse anfordern können, die für eine bestimmte Sprache am relevantesten sind.Die Migrationsanleitung für die YouTube Data API (v3) wurde ebenfalls aktualisiert, um die Verwendung dieses neuen Parameters zu erläutern. Der Parameter beseitigt eine Funktionslücke, die zuvor zwischen der aktuellen API-Version (v3) und der vorherigen Version (v2) bestand, die bereits eingestellt wurde.
-
Der Migrationsleitfaden für die YouTube Data API (Version 3) wurde ebenfalls aktualisiert, um auf die Einstellung der speziellen Feeds und Metadatenfelder hinzuweisen, die in Version 2 zur Beschreibung von Filmen, Trailern, TV-Sendungen, Serienstaffeln und TV-Folgen bereitgestellt wurden.
14. Januar 2015
Dieses Update enthält die folgenden Änderungen:
-
Die Migrationsanleitung für die YouTube Data API (Version 3) wurde aktualisiert. Jetzt wird erklärt, wie du mit der API Version 3 Videos mithilfe von JavaScript hochladen kannst. Weitere Informationen findest du im Abschnitt Video hochladen. Diese Funktion ist vergleichbar mit der Funktion für browserbasierte Uploads, die von der API Version 2 unterstützt wird. Hinweis: Diese Änderung des Migrationsleitfadens bezieht sich nicht auf eine tatsächliche API-Änderung, sondern auf die Verfügbarkeit von neuem Beispielcode für das Hochladen von Videos mit clientseitigem JavaScript.
Da das Hochladen von Videos mit der JavaScript-Clientbibliothek und CORS unterstützt wird, wird das browserbasierte Hochladen in der Migrationsanleitung nicht mehr als Funktion aufgeführt, die in Version 3 der API eingestellt wurde.
-
Die Dokumentation für die Methode
videos.insert
wurde aktualisiert und enthält jetzt das oben beschriebene neue JavaScript-Codebeispiel. Die Liste der JavaScript-Codebeispiele für die YouTube Data API (Version 3) wurde ebenfalls aktualisiert.
11. November 2014
Dieses Update enthält die folgenden Änderungen:
-
Die Kontingentkosten für einen Aufruf der Methode
search.list
wurden auf 100 Einheiten erhöht.Wichtig:In vielen Fällen können Sie andere API-Methoden verwenden, um Informationen zu niedrigeren Kontingentkosten abzurufen. Es gibt zwei Möglichkeiten, Videos zu finden, die auf dem GoogleDevelopers-Kanal hochgeladen wurden:
-
Kontingentkosten: 100 Einheiten
Rufen Sie die Methode
search.list
auf und suchen Sie nachGoogleDevelopers
. -
Kontingentkosten: 6 Einheiten
Rufe die Methode
channels.list
auf, um die richtige Kanal-ID zu ermitteln. Legen Sie den ParameterforUsername
aufGoogleDevelopers
und den Parameterpart
aufcontentDetails
fest. In der API-Antwort gibt die EigenschaftcontentDetails.relatedPlaylists.uploads
die Playlist-ID für die hochgeladenen Videos des Kanals an.Rufen Sie dann die Methode
playlistItems.list
auf und legen Sie den ParameterplaylistId
auf die erfasste ID und den Parameterpart
aufsnippet
fest.
-
8. Oktober 2014
Dieses Update enthält die folgenden Änderungen:
-
Die Ressource
channel
enthält zwei neue Attribute:-
Die Eigenschaft
status.longUploadsStatus
gibt an, ob der Kanal die Voraussetzungen zum Hochladen von Videos erfüllt, die länger als 15 Minuten sind. Diese Eigenschaft wird nur zurückgegeben, wenn der Kanalinhaber die API-Anfrage autorisiert hat. Gültige Attributwerte sind:allowed
: Auf dem Kanal können Videos mit einer Länge von mehr als 15 Minuten hochgeladen werden.eligible
: Auf dem Kanal können Videos mit einer Länge von mehr als 15 Minuten hochgeladen werden, allerdings muss die Funktion zuerst aktiviert werden.disallowed
: Auf dem Kanal können keine Videos mit einer Länge von mehr als 15 Minuten hochgeladen werden.
Weitere Informationen zu diesen Werten finden Sie in der Property-Definition. Weitere Informationen zu dieser Funktion findest du in der YouTube-Hilfe.
-
Die Property
invideoPromotion.useSmartTiming
gibt an, ob für die Werbekampagne des Kanals Smart Timing verwendet wird. Mit dieser Funktion wird Werbung an einer Stelle im Video präsentiert, an der sie mit höherer Wahrscheinlichkeit angeklickt werden und die Wiedergabe nicht stören. Diese Funktion wählt außerdem eine einzelne Werbung aus, die dann in jedem Video angezeigt wird.
-
-
Die Definitionen der Attribute
snippet.title
undsnippet.categoryId
der Ressourcevideo
wurden aktualisiert, um zu verdeutlichen, wie die API Aufrufe an die Methodevideos.update
verarbeitet. Wenn Sie diese Methode aufrufen, um densnippet
-Teil einervideo
-Ressource zu aktualisieren, müssen Sie für beide Attribute einen Wert festlegen.Wenn Sie versuchen, den
snippet
-Teil einervideo
-Ressource zu aktualisieren und keinen Wert für beide Attribute festlegen, gibt die API den FehlerinvalidRequest
zurück. Die Beschreibung dieses Fehlers wurde ebenfalls aktualisiert. -
Die
contentDetails.contentRating.oflcRating
-Property dervideo
-Ressource, die die Bewertung eines Videos durch das neuseeländische Office of Film and Literature Classification angibt, unterstützt jetzt zwei neue Einstufungen:oflcRp13
undoflcRp16
. Sie entsprechen den BewertungenRP13
bzw.RP16
. -
Die Methode
channelBanners.insert
unterstützt jetzt den folgenden Fehler:Fehlertyp Fehlerdetails Beschreibung badRequest
bannerAlbumFull
Das Album mit den YouTube-Kanalbildern des Kanalinhabers enthält zu viele Bilder. Der Kanalinhaber muss http://photos.google.com aufrufen, die Seite mit den Alben aufrufen und einige davon von den Bildern aus diesem Album entfernen.
12. September 2014
Dieses Update enthält die folgenden Änderungen:
-
Die Kontingentkosten für einen Aufruf der Methode
search.list
haben sich von einer Einheit auf zwei Einheiten zusätzlich zu den Kosten für die angegebenen Ressourcenteile geändert.
13. August 2014
Dieses Update enthält die folgenden Änderungen:
-
Die Methode
subscriptions.insert
unterstützt jetzt den folgenden Fehler:Fehlertyp Fehlerdetails Beschreibung badRequest
subscriptionLimitExceeded
Der mit der Anfrage angegebene Abonnent hat die Ratenbegrenzung für Abos überschritten. In wenigen Stunden können Sie versuchen, weitere Abos abzuschließen.
12. August 2014
Dieses Update enthält die folgenden Änderungen:
-
In der neuen Anleitung Anwendung zur YouTube Data API (Version 3) migrieren wird erläutert, wie du die YouTube Data API (Version 3) verwendest, um die in der YouTube Data API (Version 2) verfügbaren Funktionen auszuführen. Die ältere API wurde offiziell am 4. März 2014 eingestellt. Dieser Leitfaden soll Sie bei der Migration von Anwendungen, die noch die v2 API verwenden, auf die neueste API-Version unterstützen.
8. Juli 2014
Dieses Update enthält die folgenden Änderungen:
-
Die Methode
playlists.insert
unterstützt jetzt den folgenden Fehler:Fehlertyp Fehlerdetails Beschreibung badRequest
maxPlaylistExceeded
Dieser Fehler tritt auf, wenn keine Playlist erstellt werden kann, weil der Kanal bereits die maximal zulässige Anzahl von Playlists enthält.
18. Juni 2014
Dieses Update enthält die folgenden Änderungen:
-
Die Beschreibung jeder API-Methode wurde aktualisiert und enthält jetzt die Kontingentkosten, die bei einem Aufruf der jeweiligen Methode anfallen. In ähnlicher Weise wurden die Definitionen der
part
-Parameter aktualisiert, um die Kontingentkosten für jeden Teil anzugeben, der in einem API-Aufruf abgerufen werden kann. Ein Aufruf der Methodesubscriptions.insert
hat beispielsweise Kontingentkosten von etwa 50 Einheiten. Die Ressourcesubscription
besteht ebenfalls aus drei Teilen (snippet
,contentDetails
undsubscriberSnippet
), die jeweils zwei Einheiten kosten.Beachten Sie, dass sich die Kontingentkosten ohne Vorwarnung ändern können.
-
Die Ressource
video
unterstützt jetzt 43 neue Altersfreigabesysteme, die die Altersfreigaben ermitteln, die Videos von verschiedenen nationalen Einstufungsstellen erhalten haben. Die neuen unterstützten Bewertungssysteme kommen aus Argentinien,Österreich,Österreich,Belgium, Bulgarien, Chile (television), Chile (film), Tschechische Republik, Kolumbien, Dänemark Dänisch EstoniaFin
28. Mai 2014
Dieses Update enthält die folgenden Änderungen:
-
Die Methode
search.list
unterstützt jetzt die Parameterlocation
undlocationRadius
, mit denen Sie nach Videos suchen können, die einem geografischen Standort zugeordnet sind. Eine Anfrage muss einen Wert für beide Parameter angeben, um Ergebnisse basierend auf dem Standort abzurufen, und das API gibt einen Fehler zurück, wenn eine Anfrage nur einen der beiden Parameter enthält.-
Der Parameter
location
gibt die Breiten- und Längengradkoordinaten im Mittelpunkt des kreisförmigen geografischen Bereichs an. -
Der Parameter
locationRadius
gibt die maximale Entfernung an, die der mit einem Video verknüpfte Standort von der Mitte des Bereichs sein darf, damit das Video weiterhin in den Suchergebnissen enthalten ist.
-
13. Mai 2014
Dieses Update enthält die folgenden Änderungen:
-
Die Eigenschaft
invideoPromotion.items[]
der Ressource „channel
“ wurde aktualisiert. Du kannst jetzt normalerweise nur ein beworbenes Element für deinen Kanal festlegen. Wenn Sie versuchen, zu viele beworbene Artikel einzufügen, gibt die API den FehlertooManyPromotedItems
mit dem HTTP-Statuscode400
zurück. -
Die Ressource
channelSection
kann jetzt Informationen zu einigen neuen Arten von empfohlenen Inhalten enthalten. Das Attributsnippet.type
der RessourcechannelSection
unterstützt jetzt die folgenden Werte:postedPlaylists
: Playlists, die der Kanalinhaber im Aktivitätsfeed des Kanals gepostet hatpostedVideos
: Videos, die der Kanalinhaber im Aktivitätsfeed des Kanals gepostet hatsubscriptions
: Kanäle, die der Kanalinhaber abonniert hat
-
Die neue
contentDetails.contentRating.ifcoRating
-Property dervideo
-Ressource gibt die Einstufung eines Videos vom Irish Film Classification Office an. -
Die Definition der
position.cornerPosition
-Eigenschaft derwatermark
-Ressource wurde aktualisiert. Das Wasserzeichen wird nun immer oben rechts im Player angezeigt. -
Die Definition des
q
-Parameters für diesearch.list
-Methode wurde aktualisiert. Der Suchbegriff kann jetzt den booleschen NOT-Operator (-
) verwenden, um Videos auszuschließen, die mit einem bestimmten Suchbegriff verknüpft sind. Der Wert kann auch den booleschen Operator ODER (|
) verwenden, um Videos zu finden, die mit einem von mehreren Suchbegriffen verknüpft sind. -
Die Definition des Attributs
pageInfo.totalResults
, die in einer API-Antwort auf einensearch.list
-Aufruf zurückgegeben wird, wurde aktualisiert. Der Wert ist nun eine Näherung und stellt möglicherweise keinen genauen Wert dar. Darüber hinaus beträgt der Maximalwert 1.000.000. Sie sollten diesen Wert nicht zum Erstellen von Paginierungslinks verwenden. Verwenden Sie stattdessen die AttributwertenextPageToken
undprevPageToken
, um zu bestimmen, ob Paginierungslinks angezeigt werden sollen. -
Die Methoden
watermarks.set
undwatermarks.unset
wurden aktualisiert, um zu berücksichtigen, dass die API bei erfolgreichen Anfragen an diese Methoden einen HTTP-204
-Antwortcode zurückgibt.
2. Mai 2014
Dieses Update enthält die folgenden Änderungen:
-
Die neue
i18nLanguage
-Ressource gibt eine Anwendungssprache an, die von der YouTube-Website unterstützt wird. Die Anwendungssprache kann auch als UI-Sprache bezeichnet werden. Für die YouTube-Website könnte basierend auf den Google-Kontoeinstellungen, der Browsersprache oder dem IP-Standort automatisch eine Anwendungssprache ausgewählt werden. Nutzer können die gewünschte UI-Sprache auch manuell in der Fußzeile der YouTube-Website auswählen.Die API unterstützt eine Methode zum Auflisten unterstützter Anwendungssprachen. Unterstützte Sprachen können als Wert des Parameters
hl
verwendet werden, wenn API-Methoden wievideoCategories.list
undguideCategories.list
aufgerufen werden. -
Die neue
i18nRegion
-Ressource gibt ein geografisches Gebiet an, das ein YouTube-Nutzer als bevorzugte Region für Inhalte auswählen kann. Der Inhaltsbereich kann auch als Inhaltsgebietsschema bezeichnet werden. Für die YouTube-Website kann auf Grundlage von Heuristiken wie der YouTube-Domain oder dem IP-Standort des Nutzers automatisch ein Content-Bereich ausgewählt werden. Nutzer können die gewünschte Content-Region auch manuell aus der Fußzeile der YouTube-Website auswählen.Die API unterstützt eine Methode zum Auflisten unterstützter Inhaltsbereiche. Unterstützte Regionscodes können als Wert des Parameters
regionCode
verwendet werden, wenn API-Methoden wiesearch.list
,videos.list
,activities.list
undvideoCategories.list
aufgerufen werden.
7. April 2014
Dieses Update enthält die folgenden Änderungen:
-
Die neue
channelSection
-Ressource enthält Informationen zu einer Reihe von Videos, die auf einem Kanal vorgestellt werden. Ein Bereich kann beispielsweise die neuesten Uploads eines Kanals, die beliebtesten Uploads oder Videos aus einer oder mehreren Playlists enthalten.Die API unterstützt Methoden zum Auflisten, Einfügen, Aktualisieren oder Löschen von Kanalabschnitten. Du kannst eine Liste mit Kanalabschnitten für den Kanal des authentifizierten Nutzers abrufen, indem du eine bestimmte Kanal-ID oder eine Liste eindeutiger Kanalabschnitts-IDs angibst.
Die Fehlerdokumentation wurde ebenfalls aktualisiert und enthält nun die Fehlermeldungen, die die API speziell für diese neuen Methoden unterstützt.
-
Die Definition des
fileDetails
-Objekts dervideo
-Ressource wurde aktualisiert, um zu verdeutlichen, dass dieses Objekt nur zurückgegeben wird, wenn dieprocessingDetails.fileDetailsAvailability
-Eigenschaft des Videos den Wertavailable
hat.Die Definition des
suggestions
-Objekts dervideo
-Ressource wurde aktualisiert, um zu erklären, dass dieses Objekt nur dann zurückgegeben wird, wenn dieprocessingDetails.tagSuggestionsAvailability
-Eigenschaft des Videos oder dieprocessingDetails.editorSuggestionsAvailability
-Eigenschaft des Videos den Wertavailable
hat. -
Die Dokumentation für die Methoden
videos.insert
undvideos.update
wurde aktualisiert, um zu berücksichtigen, dass beim Aufrufen dieser Methoden das Attributstatus.publishAt
festgelegt werden kann. -
Die Definition des
invideoPromotion
-Objekts der Ressourcechannel
wurde aktualisiert, um zu verdeutlichen, dass das Objekt nur vom Inhaber des Kanals abgerufen werden kann. -
Die Parameterliste für die Methode
videos.rate
wurde aktualisiert, um zu verdeutlichen, dass diese Methode den ParameteronBehalfOfContentOwner
nicht unterstützt. Dies war ein Dokumentationsfehler, davideos.rate
-Anfragen, die diesen Parameter festlegen, den Fehler500
zurückgeben.
31. März 2014
Dieses Update enthält die folgenden Änderungen:
-
Mit der neuen
status.publishAt
-Property dervideo
-Ressource kannst du das Datum und die Uhrzeit für die Veröffentlichung eines privaten Videos angeben. Diese Eigenschaft kann nur festgelegt werden, wenn der Datenschutzstatus des Videosprivate
lautet und das Video noch nie veröffentlicht wurde. Diese neue Property unterliegt nicht der Richtlinie zur Einstellung von Produkten und Diensten.
13. März 2014
Dieses Update enthält die folgenden Änderungen:
-
Die API unterstützt jetzt den
contentOwnerDetails
-Teil fürchannel
-Ressourcen. Der neue Teil enthält Kanaldaten, die für mit dem Kanal verknüpfte YouTube-Partner relevant sind, darunter die ID des mit dem Kanal verknüpften Rechteinhabers sowie Datum und Uhrzeit der Verknüpfung des Rechteinhabers und des Kanals. Hinweis: Dieser neue Teil unterliegt nicht der Einstellungsrichtlinie. -
In der Dokumentation ist jetzt die maximal unterstützte Zeichenlänge für die folgenden Eigenschaften aufgeführt:
Ressource Property Maximale Länge channel
invideoPromotion.items[].customMessage
40 Zeichen video
snippet.title
100 Zeichen video
snippet.description
5.000 Byte video
snippet.tags
500 Zeichen Beachten Sie, dass es sich bei dem Attributwert um eine Liste handelt und dass Kommas zwischen den Elementen in der Liste auf den Grenzwert angerechnet werden. -
Das Attribut
brandingSettings.watch.featuredPlaylistId
der Ressourcechannel
wurde eingestellt. Die API gibt einen Fehler zurück, wenn Sie versuchen, den Wert festzulegen. -
Die folgenden
video
-Ressourceneigenschaften wurden der Liste der Werte hinzugefügt, die beim Einfügen oder Aktualisieren eines Videos festgelegt werden können: -
In der Fehlerdokumentation wird jetzt der HTTP-Antwortcode für jeden Fehlertyp angegeben.
-
Die API unterstützt jetzt die folgenden Fehler:
Fehlertyp Fehlerdetails Beschreibung badRequest (400)
invalidCriteria
Die Methode channels.list
gibt diesen Fehler zurück, wenn in der Anfrage Filterparameter angegeben sind, die nicht in Kombination miteinander verwendet werden können.badRequest (400)
channelTitleUpdateForbidden
Die Methode channels.update
gibt diesen Fehler zurück, wenn du versuchst, denbrandingSettings
-Teil eines Kanals zu aktualisieren und den Wert derbrandingSettings.channel.title
-Eigenschaft zu ändern. Beachten Sie, dass die API den Fehler nicht zurückgibt, wenn Sie die Eigenschaft auslassen.badRequest (400)
invalidRecentlyUploadedBy
Die Methode channels.update
gibt diesen Fehler zurück, wenn die EigenschaftinvideoPromotion.items[].id.recentlyUploadedBy
eine ungültige Kanal-ID angibt.badRequest (400)
invalidTimingOffset
Die Methode channels.update
gibt diesen Fehler zurück, wenn derinvideoPromotion
-Teil einen ungültigen Zeitversatz angibt.badRequest (400)
tooManyPromotedItems
Die Methode channels.update
gibt diesen Fehler zurück, wenn derinvideoPromotion
-Teil mehr als die zulässige Anzahl von hochgestuften Elementen angibt.forbidden (403)
promotedVideoNotAllowed
Die Methode channels.update
gibt diesen Fehler zurück, wenn die PropertyinvideoPromotion.items[].id.videoId
eine Video-ID angibt, die entweder nicht gefunden oder nicht als beworbenes Element verwendet werden kann.forbidden (403)
websiteLinkNotAllowed
Die Methode channels.update
gibt diesen Fehler zurück, wenn die PropertyinvideoPromotion.items[].id.websiteUrl
eine unzulässige URL angibt.required (400)
requiredTimingType
Die Methode channels.update
gibt diesen Fehler zurück, wenn in einer Anfrage keine Standardzeiteinstellungen für den Zeitpunkt angegeben sind, zu dem YouTube ein beworbenes Element anzeigen soll.required (400)
requiredTiming
In der Methode channels.update
muss für jedes beworbene Element eininvideoPromotion.items[].timing
-Objekt angegeben werden.required (400)
requiredWebsiteUrl
Bei der Methode channels.update
muss für jedes beworbene Element eineinvideoPromotion.items[].id.websiteUrl
-Eigenschaft angegeben werden.badRequest (400)
invalidPublishAt
Die Methode videos.insert
gibt diesen Fehler zurück, wenn die Metadaten der Anfrage eine ungültige geplante Veröffentlichungszeit angeben.
4. März 2014
Dieses Update enthält die folgenden Änderungen:
-
Version 3 der YouTube Data API unterliegt jetzt der Richtlinie zur Einstellung von Produkten und Diensten, die in den Nutzungsbedingungen der YouTube APIs beschrieben ist. Hinweis: Auf der Seite mit den APIs, die der Richtlinie zur Einstellung von Produkten und Diensten unterliegen, werden einige Funktionen der API Version 3 von der Richtlinie ausgeschlossen.
5. Dezember 2013
Dieses Update enthält die folgenden Änderungen:
-
Die Dokumentation zur Methode
search.list
wurde aktualisiert, um zu verdeutlichen, dass Sie beim Senden einer Suchanfrage keinen Wert für genau einen Filterparameter angeben müssen. Stattdessen können Sie einen Wert für Null-Filterparameter oder für einen einzelnen Filterparameter festlegen. -
Die Definitionen der Parameter der
search.list
-Methode wurden aktualisiert. Sie müssen nun den Wert destype
-Parameters aufvideo
festlegen, wenn Sie auch einen Wert für einen der folgenden Parameter angeben:eventType
videoCaption
videoCategoryId
videoDefinition
videoDimension
videoDuration
videoEmbeddable
videoLicense
videoSyndicated
videoType
-
Die Mindestgröße von hochgeladenen Kanalbannerbildern wurde auf 2048 x 1152 Pixel reduziert. Früher betrug die Mindestgröße 2.120 x 1.192 Pixel. Beachten Sie außerdem, dass in der Dokumentation zu
channel
-Ressourcen die maximale Größe aller Bannerbilder angegeben ist, die von der API ausgeliefert werden. Die maximale Größe desbrandingSettings.image.bannerTvImageUrl
-Bildes für Fernsehanwendungen beträgt beispielsweise 2.120 x 1.192 Pixel, das tatsächliche Bild kann jedoch 2.048 x 1.152 Pixel groß sein. In der YouTube-Hilfe findest du weitere Informationen zur Optimierung von Kanalbildern für die Anzeige auf verschiedenen Gerätetypen. -
Mehrere Definitionen von
channel
-Ressourcenattributen wurden aktualisiert, um die folgenden Informationen zu berücksichtigen:- Der Wert des Attributs
brandingSettings.channel.description
darf maximal 1.000 Zeichen lang sein. - Das Attribut
brandingSettings.channel.featuredChannelsTitle
darf maximal 30 Zeichen lang sein. - In der Property
brandingSettings.channel.featuredChannelsUrls[]
können jetzt bis zu 100 Channels aufgelistet werden. - Wenn der Eigenschaftswert
brandingSettings.channel.unsubscribedTrailer
festgelegt ist, muss er die YouTube-Video-ID eines öffentlichen oder nicht gelisteten Videos angeben, dessen Inhaber der Kanalinhaber ist.
- Der Wert des Attributs
-
Die Methode
channels.update
unterstützt jetzt Aktualisierungen des AttributsinvideoPromotion.items[].promotedByContentOwner
. Diese Eigenschaft gibt an, ob der Name des Inhaltseigentümers bei der Anzeige der Werbung angezeigt wird. Sie kann nur festgelegt werden, wenn die API-Anfrage, mit der der Attributwert festgelegt wird, mit dem ParameteronBehalfOfContentOwner
im Namen des Rechteinhabers erfolgt. -
Die Methoden
playlistItems.list
undplaylistItems.insert
unterstützen jetzt den ParameteronBehalfOfContentOwner
, der bereits für mehrere andere Methoden unterstützt wird. -
In der Property
contentDetails.contentRating.acbRating
kann jetzt entweder vom Australian Classification Board (ACB) eine Altersfreigabe für Filme oder von der Australian Communications and Media Authority (ACMA) für Fernsehprogramme für Kinder angegeben werden. -
Die neuen Properties
contentDetails.contentRating.catvRating
undcontentDetails.contentRating.catvfrRating
geben die Bewertungen an, die ein Video nach dem kanadischen TV-Klassifizierungssystem und dem in Québec verwendeten französischsprachigen Altersfreigabesystem Régie du cinéma erhalten hat. -
Die neue
snippet.assignable
-Property dervideoCategory
-Ressource gibt an, ob dieser Videokategorie aktualisierte oder neu hochgeladene Videos zugeordnet werden können. -
Für die folgenden Methoden wurden Codebeispiele hinzugefügt:
activities.insert
(Go)channelBanners.insert
(Python)channels.update
(Python)playlistItems.list
(Go)search.list
(Go)thumbnails.set
(Java)videos.insert
(Go)
24. Oktober 2013
Dieses Update enthält die folgenden Änderungen:
-
Die API umfasst zwei zusätzliche Funktionen, die dabei helfen, Liveübertragungen zu finden und anzuzeigen:
Die neue
snippet.liveBroadcastContent
-Eigenschaft in den Suchergebnissen gibt an, ob eine Video- oder Kanalressource Liveübertragungen enthält. Gültige Attributwerte sindupcoming
,active
undnone
.-
Die neue
snippet.liveBroadcastContent
-Property dervideo
-Ressource gibt an, ob das Video eine anstehende oder aktive Liveübertragung ist. In der folgenden Liste werden die möglichen Werte der Property erläutert:upcoming
: Das Video ist eine Liveübertragung, die noch nicht begonnen hat.active
: Das Video ist eine laufende Liveübertragung.none
: Das Video ist keine anstehende oder aktive Liveübertragung. Dies ist der Property-Wert für abgeschlossene Übertragungen, die noch auf YouTube sichtbar sind.
-
Das neue Attribut
liveStreamingDetails
der Ressourcevideo
ist ein Objekt, das Metadaten zu einer Live-Videoübertragung enthält. Zum Abrufen dieser Metadaten nehmen SieliveStreamingDetails
in die Liste der Ressourcenteile des Parameterwertspart
auf. Die Metadaten enthalten die folgenden neuen Attribute:liveStreamingDetails.actualStartTime
: Uhrzeit, zu der die Übertragung tatsächlich begonnen hat Dieser Wert ist vorhanden, sobald der Status der Übertragungactive
lautet.liveStreamingDetails.actualEndTime
: Der Zeitpunkt, zu dem die Übertragung tatsächlich beendet wurde. Dieser Wert wird angezeigt, sobald die Übertragung beendet ist.liveStreamingDetails.scheduledStartTime
: Die Uhrzeit, zu der die Übertragung planmäßig beginnen soll.liveStreamingDetails.scheduledEndTime
: Der Zeitpunkt, zu dem die Übertragung planmäßig endet. Wenn der Eigenschaftswert leer oder das Attribut nicht vorhanden ist, wird die Übertragung planmäßig auf unbestimmte Zeit fortgesetzt.liveStreamingDetails.concurrentViewers
: Die Anzahl an Zuschauern, die sich die Liveübertragung ansehen.
Fügen Sie zum Abrufen dieser Metadaten
liveStreamingDetails
in denpart
-Parameterwert ein, wenn Sie die Methodevideos.list
,videos.insert
odervideos.update
aufrufen.
Am 1. Oktober 2013 wurden zwei weitere Funktionen zur Identifizierung von Liveübertragungen veröffentlicht: der Parameter
eventType
der Methodesearch.list
und die Eigenschaftsnippet.liveBroadcastContent
des Suchergebnisses. -
-
Die Methode
videos.insert
unterstützt jetzt den ParameternotifySubscribers
, der angibt, ob YouTube eine Benachrichtigung über das neue Video an Nutzer senden soll, die den Kanal des Videos abonnieren. Der Standardwert des Parameters lautetTrue
. Dies bedeutet, dass Abonnenten über neu hochgeladene Videos benachrichtigt werden. Ein Kanalinhaber, der viele Videos hochlädt, kann den Wert jedoch aufFalse
setzen, damit er nicht jedes neue Video an die Abonnenten des Kanals sendet. -
Die Liste der Attribute, die beim Aufrufen der Methode
channels.update
geändert werden können, wurde aktualisiert und enthält nun die AttributeinvideoPromotion.items[].customMessage
undinvideoPromotion.items[].websiteUrl
. Außerdem wurde die Liste geändert, um diebrandingSettings
-Properties anzugeben, die änderbar sind. DiesebrandingSettings
-Eigenschaften konnten bereits geändert werden, sodass die Änderung der Dokumentation keine Änderung der bestehenden Funktionalität der API widerspiegelt. -
Die Methoden
playlists.insert
,playlists.update
undplaylists.delete
unterstützen jetzt den ParameteronBehalfOfContentOwner
, der bereits für mehrere andere Methoden unterstützt wird. -
Die Methode
playlists.insert
unterstützt jetzt den ParameteronBehalfOfContentOwnerChannel
, der bereits für einige andere Methoden unterstützt wird. -
Das Attribut
contentDetails.contentRating.tvpgRating
der Ressourcevideo
unterstützt jetzt den Wertpg14
, der der BewertungTV-14
entspricht. -
Die Definition der Eigenschaft
snippet.liveBroadcastContent
, die Teil der Suchergebnisse ist, wurde korrigiert, um zu verdeutlichen, dasslive
ein gültiger Eigenschaftswert ist,active
jedoch kein gültiger Eigenschaftswert. -
Das Attribut
contentDetails.contentRating.mibacRating
der Ressourcevideo
unterstützt jetzt zwei zusätzliche Bewertungen:mibacVap
(VAP): Kinder sollten von einem Erwachsenen begleitet werden.mibacVm6
(V.M.6): Nur für Zuschauer ab 6 Jahren.mibacVm12
(V.M.12): Nur für Zuschauer ab 12 Jahren.
-
Die neue
invideoPromotion.items[].promotedByContentOwner
-Eigenschaft derchannel
-Ressource gibt an, ob der Name des Rechteinhabers bei der Anzeige der Werbung angezeigt wird. Dieses Feld kann nur festgelegt werden, wenn die API-Anfrage, durch die der Wert festgelegt wird, im Namen des Rechteinhabers erfolgt. Weitere Informationen finden Sie im Abschnitt zum ParameteronBehalfOfContentOwner
.
1. Oktober 2013
Dieses Update enthält die folgenden Änderungen:
-
Das neue
auditDetails
-Objekt derchannel
-Ressource enthält Kanaldaten, die ein Multi-Channel-Netzwerk (MCN) auswerten würde, um zu bestimmen, ob ein bestimmter Kanal akzeptiert oder abgelehnt wird. Beachten Sie, dass jede API-Anfrage, mit der dieser Ressourcenteil abgerufen wird, ein Autorisierungstoken mit dem Bereichhttps://www.googleapis.com/auth/youtubepartner-channel-audit
enthalten muss. Darüber hinaus muss jedes Token, das diesen Bereich verwendet, widerrufen werden, wenn das MCN den Kanal akzeptiert oder ablehnt oder innerhalb von zwei Wochen nach Ausstellung des Tokens. -
Die Eigenschaft
invideoPromotion.items[].id.type
der Ressourcechannel
unterstützt jetzt den WertrecentUpload
. Dieser Wert gibt an, dass das beworbene Element das zuletzt hochgeladene Video eines bestimmten Kanals ist.Der Kanal ist standardmäßig derjenige, für den die Daten zur In-Video-Werbung festgelegt sind. Du kannst jedoch das zuletzt hochgeladene Video eines anderen Kanals bewerben, indem du den Wert der neuen
invideoPromotion.items[].id.recentlyUploadedBy
-Eigenschaft auf die Kanal-ID für diesen Kanal festlegst. -
Die Ressource
channel
enthält drei neue Eigenschaften –brandingSettings.image.bannerTvLowImageUrl
,brandingSettings.image.bannerTvMediumImageUrl
,brandingSettings.image.bannerTvHighImageUrl
–, die die URLs für die Bannerbilder angeben, die auf Kanalseiten in Fernsehanwendungen angezeigt werden. -
Die neue
snippet.liveBroadcastContent
-Eigenschaft in den Suchergebnissen gibt an, ob eine Video- oder Kanalressource Liveübertragungen enthält. Gültige Attributwerte sindupcoming
,active
undnone
.- Bei einer
video
-Ressource bedeutet der Wertupcoming
, dass das Video eine Liveübertragung ist, die noch nicht begonnen hat. Der Wertactive
gibt an, dass es sich um eine laufende Liveübertragung handelt. - Bei einer
channel
-Ressource bedeutet der Wertupcoming
, dass die geplante Übertragung auf dem Kanal noch nicht begonnen hat. Der Wertacive
gibt an, dass auf dem Kanal eine laufende Liveübertragung vorhanden ist.
- Bei einer
-
In der Ressource
watermark
wurde das AttributtargetChannelId
von einem Objekt in einen String geändert. Statt eine untergeordnete Eigenschaft zu enthalten, die die YouTube-Kanal-ID des Kanals angibt, mit dem das Wasserzeichenbild verknüpft ist, gibt dietargetChannelId
-Eigenschaft jetzt diesen Wert selbst an. Dementsprechend wurde das AttributtargetChannelId.value
der Ressource entfernt. -
Die Methode
thumbnails.set
unterstützt jetzt den ParameteronBehalfOfContentOwner
, der bereits für einige andere Methoden unterstützt wird. -
Die Methode
search.list
unterstützt jetzt den ParametereventType
, der die Suche auf aktive, anstehende oder abgeschlossene Übertragungen einschränkt. -
Die neue
contentDetails.contentRating.mibacRating
-Property gibt die Bewertung an, die ein Video vom italienischen Ministero dei Beni e delle Attivita Culturali e del Turismo erhalten hat. -
Die API unterstützt jetzt die folgenden Fehler:
Fehlertyp Fehlerdetails Beschreibung badRequest
invalidImage
Die Methode thumbnails.set
gibt diesen Fehler zurück, wenn der bereitgestellte Bildinhalt ungültig ist.forbidden
videoRatingDisabled
Die Methode videos.rate
gibt diesen Fehler zurück, wenn der Eigentümer des gerade bewerteten Videos Bewertungen für dieses Video deaktiviert hat.
27. August 2013
Dieses Update enthält die folgenden Änderungen:
-
Die neue
watermark
-Ressource identifiziert ein Bild, das bei der Wiedergabe der Videos eines bestimmten Kanals angezeigt wird. Sie können auch einen Zielkanal angeben, mit dem das Bild verknüpft werden soll, sowie Zeitangaben, die bestimmen, wann das Wasserzeichen während der Videowiedergabe erscheint und wie lange es sichtbar ist.Mit der
watermarks.set
-Methode wird das Wasserzeichenbild eines Kanals hochgeladen und festgelegt. Mit der Methodewatermarks.unset
wird das Wasserzeichenbild eines Kanals gelöscht.In der Fehlerdokumentation werden die Fehlermeldungen beschrieben, die die API speziell für die Methoden
watermarks.set
undwatermarks.unset
unterstützt. -
Das neue Attribut
statistics.hiddenSubscriberCount
der Ressourcechannel
enthält einen booleschen Wert, der angibt, ob die Anzahl der Abonnenten des Kanals ausgeblendet ist. Daher lautet der Wert der Eigenschaftfalse
, wenn die Abonnentenzahl des Kanals öffentlich sichtbar ist. -
Die Methode
playlists.list
unterstützt jetzt die ParameteronBehalfOfContentOwner
undonBehalfOfContentOwnerChannel
. Beide Parameter werden bereits für einige andere Methoden unterstützt. -
Die Methode
videos.list
unterstützt jetzt den ParameterregionCode
, der den Inhaltsbereich angibt, für den ein Diagramm abgerufen werden soll. Dieser Parameter kann nur in Verbindung mit dem Parameterchart
verwendet werden. Der Parameterwert ist ein Alpha-2-Ländercode gemäß ISO 3166-1. -
In
error documentation
wird der folgende neue häufige Anfragefehler beschrieben, der bei mehreren API-Methoden auftreten kann:Fehlertyp Fehlerdetails Beschreibung forbidden
insufficientPermissions
Die mit dem OAuth 2.0-Token verknüpften Bereiche für die Anfrage reichen nicht aus, um auf die angeforderten Daten zuzugreifen.
15. August 2013
Dieses Update enthält die folgenden Änderungen:
-
Das Objekt
invideoPromotion
der Ressourcechannel
hat die folgenden neuen und aktualisierten Attribute:-
In der API kann jetzt eine Website als beworbener Artikel angegeben werden. Setzen Sie dazu den Wert des Attributs
invideoPromotion.items[].id.type
aufwebsite
und verwenden Sie das neue AttributinvideoPromotion.items[].id.websiteUrl
, um die URL anzugeben. Mit der neuen EigenschaftinvideoPromotion.items[].customMessage
kannst du außerdem eine benutzerdefinierte Nachricht definieren, die für das Angebot angezeigt wird.Links können zu verknüpften Websites, Händlerwebsites oder Websites sozialer Netzwerke führen. Weitere Informationen zum Aktivieren von Links für deine Inhalte findest du in der YouTube-Hilfe für verknüpfte Websites und Händlerwebsites.
Indem Sie Werbelinks hinzufügen, erklären Sie sich damit einverstanden, dass diese Links nicht dazu verwendet werden, Zugriffe auf nicht autorisierte Websites weiterzuleiten, und dass diese Links den AdWords-Richtlinien, den YouTube-Werberichtlinien, den YouTube-Community-Richtlinien und den YouTube-Nutzungsbedingungen entsprechen.
-
Die Eigenschaften in Bezug auf die Timing-Einstellungen für die Anzeige beworbener Artikel während der Videowiedergabe wurden neu strukturiert:
-
Das Objekt
invideoPromotion.timing
wurde in den OrdnerinvideoPromotion.items[].timing
verschoben. Mit diesem Objekt kannst du jetzt die Zeitdaten für jedes hochgestufte Element in derinvideoPromotion.items[]
-Liste anpassen. -
Über das neue
invideoPromotion.defaultTiming
-Objekt werden Standard-Timing-Einstellungen für dein Angebot festgelegt. Mit diesen Einstellungen kannst du festlegen, wann ein beworbener Artikel bei der Wiedergabe eines Videos auf deinem Kanal angezeigt wird. Du kannst das Standardtiming für jeden beworbenen Artikel mit dem ObjektinvideoPromotion.items[].timing
überschreiben. -
Mit der neuen
invideoPromotion.items[].timing.durationMs
-Property wird angegeben, wie lange das Angebot in Millisekunden zu sehen sein soll. DasinvideoPromotion.defaultTiming
-Objekt enthält auch eindurationMs
-Feld, das die Standarddauer angibt, für die der beworbene Artikel angezeigt wird.
-
-
Die Properties
invideoPromotion.items[].type
undinvideoPromotion.items[].videoId
wurden in das ObjektinvideoPromotion.items[].id
verschoben.
-
-
Die Methode
subscriptions.list
unterstützt jetzt die ParameteronBehalfOfContentOwner
undonBehalfOfContentOwnerChannel
. Beide Parameter werden bereits für einige andere Methoden unterstützt. -
In der API-Antwort auf eine
thumbnails.set
-Anfrage wurde der Attributwertkind
vonyoutube#thumbnailListResponse
inyoutube#thumbnailSetResponse
geändert. -
Für die folgenden Methoden wurden Codebeispiele hinzugefügt:
channels.update
(Java, Python)playlists.insert
(.NET, PHP)subscriptions.insert
(PHP, Python)thumbnails.set
(PHP, Python)videos.insert
(PHP)videos.list
(PHP)videos.rate
(Python)videos.update
(Java, PHP, Python)
Das Python-Beispiel für die Methode
playlistItems.insert
wurde ebenfalls entfernt, da die gezeigte Funktionalität jetzt von der Methodevideos.rate
verarbeitet wird. -
In
error documentation
wird der folgende neue Anfragekontextfehler beschrieben, der bei jeder API-Methode auftreten kann, die den Anfrageparametermine
unterstützt:Fehlertyp Fehlerdetails Beschreibung badRequest
invalidMine
Der Parameter mine
kann nicht in Anfragen verwendet werden, bei denen der authentifizierte Nutzer ein YouTube-Partner ist. Du solltest entweder denmine
-Parameter entfernen, dich durch Entfernen desonBehalfOfContentOwner
-Parameters als YouTube-Nutzer authentifizieren oder als einer der Partnerkanäle agieren, indem du denonBehalfOfContentOwnerChannel
-Parameter angibst, sofern für die aufgerufene Methode verfügbar.
8. August 2013
Dieses Update enthält die folgenden Änderungen:
-
Der Abschnitt Kontingentnutzung im Leitfaden Erste Schritte mit der YouTube Data API wurde aktualisiert, um eine Änderung der Kontingentkosten für einen Video-Upload von ungefähr 16.000 Einheiten auf ungefähr 1.600 Einheiten zu berücksichtigen.
30. Juli 2013
Dieses Update enthält die folgenden Änderungen:
-
In einer
channelBanner
-Ressource hat sich der Wert des Attributskind
vonyoutube#channelBannerInsertResponse
zuyoutube#channelBannerResource
geändert. Diese Ressource wird als Antwort auf einechannelBanners.insert
-Anfrage zurückgegeben. -
Mit der neuen
brandingSettings.channel.profileColor
-Eigenschaft derchannel
-Ressource wird eine auffällige Farbe angegeben, die zu den Inhalten des Kanals passt. Der Attributwert besteht aus einem Pfundzeichen (#
) gefolgt von einem sechsstelligen Hexadezimalstring, z. B.#2793e6
. -
Mit der API kannst du jetzt angeben, ob ein Abo für alle Aktivitäten eines Kanals oder nur für neue Uploads gilt. Das neue Attribut
contentDetails.activityType
der Ressourcesubscription
gibt die Arten von Aktivitäten an, über die der Abonnent benachrichtigt wird. Gültige Attributwerte sindall
unduploads
. -
Die Methode
videos.list
unterstützt neue Parameter zum Abrufen eines Diagramms der beliebtesten Videos auf YouTube:- Der Parameter
chart
gibt das Diagramm an, das Sie abrufen möchten. Derzeit wird nur der WertmostPopular
unterstützt. Derchart
-Parameter ist ein Filterparameter. Das bedeutet, dass er nicht in derselben Anfrage wie andere Filterparameter (id
undmyRating
) verwendet werden kann. - Der Parameter
videoCategoryId
gibt die Videokategorie an, für die das Diagramm abgerufen werden soll. Dieser Parameter kann nur in Verbindung mit dem Parameterchart
verwendet werden. Standardmäßig sind Diagramme nicht auf eine bestimmte Kategorie beschränkt.
- Der Parameter
-
Das neue Attribut
topicDetails.relevantTopicIds[]
dervideo
-Ressource enthält eine Liste mit IDs der Freebase-Themen, die für das Video oder dessen Inhalt relevant sind. Die Themen dieser Themen können im Video erwähnt oder im Video vorkommen. -
Das Attribut
recordingDetails.location.elevation
der Ressourcevideo
wurde inrecordingDetails.location.altitude
umbenannt und das AttributfileDetails.recordingLocation.location.elevation
wurde infileDetails.recordingLocation.location.altitude
umbenannt. -
Das Objekt
contentDetails.contentRating
dervideo
-Ressource gibt die Altersfreigaben an, die ein Video nach verschiedenen Einstufungsschemata erhalten hat, einschließlich MPAA-Bewertungen, TVPG-Bewertungen usw. Die API unterstützt jetzt für jedes Bewertungssystem einen Bewertungswert, der angibt, dass das Video noch nicht bewertet wurde. Beachten Sie, dass bei MPAA-Altersfreigaben häufig die Einstufung "Nicht bewertet" verwendet wird, um ungeschnittene Versionen von Filmen zu kennzeichnen, für die die geschnittene Version des Films eine offizielle Einstufung erhalten hat. -
Das neue Attribut
contentDetails.contentRating.ytRating
der Ressourcevideo
identifiziert Inhalte mit Altersbeschränkung. Der Property-Wert istytAgeRestricted
, wenn YouTube festgestellt hat, dass das Video Inhalte enthält, die für Nutzer unter 18 Jahren unangemessen sind. Wenn die Property nicht vorhanden oder der Property-Wert leer ist, wurde der Inhalt nicht als Altersbeschränkung eingestuft. -
Der Parameter
mySubscribers
der Methodechannels.list
wurde verworfen. Verwende die Methodesubscriptions.list
und den zugehörigen ParametermySubscribers
, um eine Liste der Abonnenten des Kanals des authentifizierten Nutzers abzurufen. -
Die Methoden
channelBanners.insert
,channels.update
,videos.getRating
undvideos.rate
unterstützen jetzt alle den ParameteronBehalfOfContentOwner
. Dieser Parameter gibt an, dass der authentifizierte Nutzer im Namen des im Parameterwert angegebenen Rechteinhabers handelt. -
Die Dokumentation der Methode
channels.update
wurde aktualisiert, um die Tatsache zu berücksichtigen, dass mit dieser Methode das ObjektbrandingSettings
der Ressourcechannel
und ihre untergeordneten Attribute aktualisiert werden können. In der Dokumentation finden Sie jetzt auch die aktualisierte Liste der Attribute, die Sie für dasinvideoPromotion
-Objekt der Ressourcechannel
festlegen können. -
In der
error documentation
werden die folgenden neuen Fehler beschrieben:Fehlertyp Fehlerdetails Beschreibung forbidden
accountDelegationForbidden
Dieser Fehler bezieht sich nicht nur auf eine bestimmte API-Methode. Sie weist darauf hin, dass der authentifizierte Nutzer nicht berechtigt ist, im Namen des angegebenen Google-Kontos zu handeln. forbidden
authenticatedUserAccountClosed
Dieser Fehler bezieht sich nicht nur auf eine bestimmte API-Methode. Das bedeutet, dass das YouTube-Konto des authentifizierten Nutzers geschlossen ist. Wenn der Nutzer im Auftrag eines anderen Google-Kontos handelt, bedeutet diese Fehlermeldung, dass das andere Konto geschlossen wurde. forbidden
authenticatedUserAccountSuspended
Dieser Fehler bezieht sich nicht nur auf eine bestimmte API-Methode. Das bedeutet, dass das YouTube-Konto des authentifizierten Nutzers gesperrt ist. Falls der Nutzer im Auftrag eines anderen Google-Kontos handelt, bedeutet diese Fehlermeldung, dass das andere Konto gesperrt wurde. forbidden
authenticatedUserNotChannel
Dieser Fehler bezieht sich nicht nur auf eine bestimmte API-Methode. Sie gibt an, dass der API-Server den mit der API-Anfrage verknüpften Kanal nicht identifizieren kann. Wenn die Anfrage autorisiert ist und den Parameter onBehalfOfContentOwner
verwendet, sollten Sie auch den ParameteronBehalfOfContentOwnerChannel
festlegen.forbidden
cmsUserAccountNotFound
Dieser Fehler bezieht sich nicht nur auf eine bestimmte API-Methode. Der CMS-Nutzer darf nicht im Namen des angegebenen Rechteinhabers handeln. notFound
contentOwnerAccountNotFound
Dieser Fehler bezieht sich nicht nur auf eine bestimmte API-Methode. Das angegebene Rechteinhaber-Konto wurde nicht gefunden. badRequest
invalidPart
Dieser Fehler bezieht sich nicht nur auf eine bestimmte API-Methode. Der Parameter part
der Anfrage gibt Teile an, die nicht gleichzeitig geschrieben werden können.badRequest
videoChartNotFound
Die Methode videos.list
gibt diesen Fehler zurück, wenn in der Anfrage ein nicht unterstütztes oder nicht verfügbares Videodiagramm angegeben ist.notFound
videoNotFound
Die Methode videos.update
gibt diesen Fehler zurück, um anzuzeigen, dass das Video, das Sie aktualisieren möchten, nicht gefunden wurde. Prüfen Sie, ob der Wert des Attributsid
im Anfragetext korrekt ist.
10. Juni 2013
Dieses Update enthält die folgenden Änderungen:
-
Mit dem neuen
forUsername
-Parameter derchannels.list
-Methode können Sie Informationen zu einem Kanal abrufen, indem Sie den zugehörigen YouTube-Nutzernamen angeben. -
Die Methode
activities.list
unterstützt jetzt den ParameterregionCode
, der die API anweist, Ergebnisse zurückzugeben, die für das angegebene Land relevant sind. YouTube verwendet diesen Wert, wenn die vorherige Aktivität des autorisierten Nutzers auf YouTube nicht genügend Informationen bietet, um den Aktivitätsfeed zu generieren. -
Playlist-Ressourcen enthalten jetzt das Attribut
snippet.tags
. Die Property wird nur an autorisierte Nutzer zurückgegeben, die Daten zu ihren eigenen Playlists abrufen. Autorisierte Nutzer können auch Playlist-Tags festlegen, wenn sie die Methodenplaylists.insert
oderplaylists.update
aufrufen. -
Der Parameter
onBehalfOfContentOwner
, der bisher für die Methodenchannels.list
undsearch.list
unterstützt wurde, wird jetzt auch für die Methodenvideos.insert
,videos.update
undvideos.delete
unterstützt. Wenn dieser Parameter in einem Aufruf dervideos.insert
-Methode verwendet wird, muss die Anfrage auch einen Wert für den neuenonBehalfOfContentOwnerChannel
-Parameter angeben, der den Kanal identifiziert, zu dem das Video hinzugefügt wird. Der Kanal muss mit dem Rechteinhaber verknüpft sein, der durch den ParameteronBehalfOfContentOwner
angegeben wird.Der Parameter gibt an, dass die Autorisierungsdaten der Anfrage einen YouTube CMS-Nutzer identifizieren, der im Namen des im Parameterwert angegebenen Rechteinhabers handelt. Das CMS-Konto, mit dem sich der Nutzer authentifiziert, muss mit dem angegebenen YouTube-Rechteinhaber verknüpft sein.
Dieser Parameter ist für Content-Partner vorgesehen, die viele verschiedene YouTube-Kanäle haben und verwalten. Der Parameter ermöglicht es diesen Partnern, sich einmal zu authentifizieren und Zugriff auf alle ihre Video- und Kanaldaten zu erhalten, ohne Authentifizierungsdaten für jeden einzelnen Kanal angeben zu müssen.
Insbesondere in Bezug auf diese Version ermöglicht der Parameter einem Content-Partner nun das Einfügen, Aktualisieren oder Löschen von Videos in allen YouTube-Kanälen, die dem Partner gehören.
-
In der
error documentation
werden die folgenden neuen Fehler beschrieben:Fehlertyp Fehlerdetails Beschreibung forbidden
insufficientCapabilities
Dieser Fehler bezieht sich nicht nur auf eine bestimmte API-Methode. Es gibt an, dass der CMS-Nutzer, der die API aufruft, nicht über ausreichende Berechtigungen verfügt, um den angeforderten Vorgang auszuführen. Dieser Fehler hängt mit der Verwendung des Parameters onBehalfOfContentOwner
zusammen, der für mehrere API-Methoden unterstützt wird.unauthorized
authorizationRequired
Die Methode activities.list
gibt diesen Fehler zurück, wenn die Anfrage den Parameterhome
verwendet, aber nicht ordnungsgemäß autorisiert ist. -
In der Ressource
channels
wurde das AttributinvideoPromotion.channelId
entfernt, da die Channel-ID bereits über das Attributid
der Ressource angegeben wurde. -
Im neuen Leitfaden Mit Kanal-IDs arbeiten wird erläutert, wie Kanal-IDs in der API verwendet werden. Das Handbuch ist besonders nützlich für Entwickler, die von der vorherigen Version der API migrieren und Anwendungen haben, die entweder Inhalte für den
default
-Nutzer anfordern oder die auf der Annahme basieren, dass jeder YouTube-Kanal einen eindeutigen Nutzernamen hat, was mittlerweile nicht mehr der Fall ist.
22. Mai 2013
Dieses Update enthält die folgenden Änderungen:
-
Mit der neuen
channelBanners.insert
-Methode kannst du ein Bannerbild hochladen, das anschließend mithilfe der neuenbrandingSettings.image.bannerExternalUrl
-Eigenschaft derchannel
-Ressource als Bannerbild für einen Kanal festgelegt werden kann. -
Die Dokumentation für die Methode
channels.update
wurde aktualisiert und listet die Attribute auf, die beim Aufrufen der Methode geändert werden können. -
In der
video
-Ressourcendokumentation wirdunspecified
nicht mehr als gültiger Attributwert für die Propertiessuggestions.processingErrors[]
,suggestions.processingHints[]
,suggestions.processingWarnings[]
undsuggestions.editorSuggestions[]
aufgeführt. -
Der Parameter
maxResults
der Methodevideos.list
hat jetzt den Standardwert5
. -
error documentation
listet jetzt Fehler für die MethodenchannelBanners.insert
undsubscriptions.list
auf. Außerdem werden mehrere neue Fehler für die Methodechannels.update
aufgeführt.
14. Mai 2013
Dieses Update enthält die folgenden Änderungen:
-
Eigenständige Seiten enthalten jetzt Codebeispiele für Java, .NET, PHP und Ruby.
-
Die Seite mit Python-Codebeispielen enthält jetzt Beispiele zum Hinzufügen eines Abos, zum Erstellen einer Playlist und zum Aktualisieren eines Videos.
10. Mai 2013
Dieses Update enthält die folgenden Änderungen:
-
YouTube identifiziert keine experimentellen API-Funktionen und -Dienste mehr. Stattdessen stellen wir jetzt eine Liste der YouTube APIs bereit, die der Richtlinie zur Einstellung von Produkten und Diensten unterliegen.
8. Mai 2013
Dieses Update enthält die folgenden Änderungen:
-
Kanalressourcen unterstützen jetzt das Objekt
inVideoPromotion
, das Informationen zu einer mit dem Kanal verknüpften Werbekampagne enthält. Ein Kanal kann eine In-Video-Werbekampagne verwenden, um Thumbnail-Bilder für ein gesponsertes Video im Videoplayer anzuzeigen, während die Videos des Kanals wiedergegeben werden.Sie können diese Daten abrufen, indem Sie in einer
channels.list
-AnfrageinvideoPromotion
in den Parameterwertpart
aufnehmen. -
Mit der neuen
channels.update
-Methode können die Daten der In-Video-Werbekampagne eines Kanals aktualisiert werden. Die Methode unterstützt nur Aktualisierungen desinvideoPromotion
-Teils derchannel
-Ressource. Aktualisierungen für andere Teile dieser Ressource werden noch nicht unterstützt.
2. Mai 2013
Dieses Update enthält die folgenden Änderungen:
-
Kanalressourcen unterstützen jetzt die
status.isLinked
-Property, die angibt, ob die Kanaldaten einen Nutzer identifizieren, der bereits mit einem YouTube-Nutzernamen oder einem Google+ Konto verknüpft ist. Ein Nutzer, der einen dieser Links hat, verfügt bereits über eine öffentliche YouTube-Identität. Diese ist Voraussetzung für verschiedene Aktionen, z. B. das Hochladen von Videos. -
Aboressourcen unterstützen jetzt den
subscriberSnippet
-Teil. Das eingekapselte Objekt enthält Snippet-Daten für den Kanal des Abonnenten. -
Die API unterstützt jetzt die Methode
videos.getRating
, mit der die Bewertungen abgerufen werden, die der authentifizierte Nutzer einer Liste mit einem oder mehreren Videos gegeben hat. -
Mit dem neuen Parameter
myRating
der Methodevideos.list
können Sie eine Liste von Videos abrufen, die der authentifizierte Nutzer mit einer Bewertung vonlike
oderdislike
bewertet hat.Die Parameter
myRating
undid
werden jetzt beide als Filterparameter betrachtet. Das bedeutet, dass in einer API-Anfrage genau einer der Parameter angegeben werden muss. Bisher war der Parameterid
ein erforderlicher Parameter für diese Methode.Die Methode gibt den Fehler
forbidden
für Anfragen zurück, mit denen versucht wird, Informationen zur Videobewertung abzurufen, aber nicht über die entsprechende Berechtigung verfügen. -
Mit der Einführung des Parameters
myRating
wurde auch die Methodevideos.list
aktualisiert, um die Paginierung zu unterstützen. Seitenparameter werden jedoch nur für Anfragen mit dem ParametermyRating
unterstützt. (Paging-Parameter und -Informationen werden für Anfragen mit demid
-Parameter nicht unterstützt.)-
Der Parameter
maxResults
gibt die maximale Anzahl von Videos an, die die API in den Ergebnissen zurückgeben kann, und der ParameterpageToken
gibt eine bestimmte Seite in der Ergebnismenge an, die Sie abrufen möchten. -
Die Ressource
youtube#videoListResponse
, die als Antwort auf einevideos.list
-Anfrage zurückgegeben wird, enthält jetzt das ObjektpageInfo
, das Details wie die Gesamtzahl der Ergebnisse und die Anzahl der Ergebnisse im aktuellen Ergebnissatz enthält. Die Ressourceyoutube#videoListResponse
kann auch die AttributenextPageToken
undprevPageToken
enthalten, die jeweils ein Token bereitstellen, mit dem eine bestimmte Seite im Ergebnissatz abgerufen werden kann.
-
-
Die Methode
videos.insert
unterstützt die folgenden neuen Parameter:autoLevels
: Setze diesen Parameterwert auftrue
, um YouTube anzuweisen, Licht und Farbe des Videos automatisch zu optimieren.stabilize
: Setze diesen Parameterwert auftrue
, um YouTube anzuweisen, Verwacklungen infolge von Kamerabewegungen zu entfernen.
-
Das Attribut
channelTitle
wurde demsnippet
für die folgenden Ressourcen hinzugefügt:playlistItem
: Die Eigenschaft gibt den Namen des Kanals an, über den das Playlist-Element hinzugefügt wurde.playlist
: Die Eigenschaft gibt den Namen des Kanals an, der die Playlist erstellt hat.subscription
: Die Eigenschaft gibt den Namen des abonnierten Kanals an.
-
Für die folgenden Methoden wurden Codebeispiele hinzugefügt:
activities.insert
(Ruby)playlistItems.list
(.NET)search.list
(.NET)subscriptions.insert
(Java, Ruby)videos.insert
(.NET, Ruby)
-
Mit dem neuen Parameter
mySubscribers
der Methodesubscriptions.list
können Sie eine Liste der Abonnenten des aktuell authentifizierten Nutzers abrufen. Dieser Parameter kann nur in einer ordnungsgemäß autorisierten Anfrage verwendet werden.Hinweis: Diese Funktion ersetzt den Parameter
mySubscribers
, der derzeit für die Methodechannels.list
unterstützt wird. Dieser Parameter wird eingestellt. -
In einer
video
-Ressource ist der Attributwertunspecified
nicht mehr ein möglicher Wert für folgende Attribute: -
API-Anfragen, die einen unerwarteten Parameter enthalten, geben jetzt den Fehler
badRequest
zurück und als Grund für den Fehler wirdunexpectedParameter
gemeldet. -
Der Fehler, den die Methode
playlistItems.insert
zurückgibt, wenn die Playlist bereits die maximal zulässige Anzahl von Elementen enthält. Der Fehler wird jetzt alsforbidden
-Fehler gemeldet und die Fehlerursache istplaylistContainsMaximumNumberOfVideos
.
19. April 2013
Dieses Update enthält die folgenden Änderungen:
-
Mit der neuen
videos.rate
-Methode können Nutzer einelike
- oderdislike
-Bewertung für ein Video festlegen oder eine Bewertung für ein Video entfernen.Die Fehlerdokumentation wurde ebenfalls aktualisiert und enthält nun eine Liste der Fehler, die die API möglicherweise als Antwort auf einen
videos.rate
-Methodenaufruf zurückgibt. -
Thumbnail-Bilder werden in der API-Dokumentation jetzt als separate Ressource identifiziert. Mit der neuen
thumbnails.set
-Methode kannst du ein benutzerdefiniertes Video-Thumbnail auf YouTube hochladen und für ein Video festlegen.Die Fehlerdokumentation wurde ebenfalls aktualisiert und enthält nun eine Liste der Fehler, die die API möglicherweise als Antwort auf einen
thumbnails.set
-Methodenaufruf zurückgibt.Diese Änderung wirkt sich nicht wirklich auf vorhandene Ressourcen aus, die Miniaturansichten zurückgeben. Miniaturansichten werden in diesen Ressourcen auf dieselbe Weise wie zuvor zurückgegeben. Allerdings werden jetzt in der Dokumentation die Namen der verschiedenen Miniaturansichtsgrößen aufgeführt, die von der API zurückgegeben werden könnten.
-
Der neue
brandingSettings
-Teil derchannel
-Ressource identifiziert Einstellungen, Text und Bilder für die Kanalseite und die Videowiedergabeseiten des Kanals. -
Die Ressource
playlistItem
enthält die folgenden neuen Attribute:-
Das neue
status
-Objekt enthält Statusinformationen über das Playlist-Element und diestatus.privacyStatus
-Eigenschaft gibt den Datenschutzstatus des Playlist-Elements an.
-
-
Die Ressource
video
enthält die folgenden neuen Attribute:-
Die Eigenschaft
status.publicStatsViewable
gibt an, ob erweiterte Videostatistiken auf der Wiedergabeseite öffentlich sichtbar sind. Diese Statistiken sind standardmäßig sichtbar. Statistiken wie die Anzahl der Aufrufe und Bewertungen eines Videos sind auch dann öffentlich sichtbar, wenn der Wert dieser Eigenschaft auffalse
gesetzt ist. Sie können den Wert dieses Attributs festlegen, wenn Sie die Methodevideos.insert
odervideos.update
aufrufen. -
Das Objekt
contentDetails.contentRating
enthält die Bewertungen, die das Video nach verschiedenen Bewertungsschemata erhalten hat. In der folgenden Liste sind die unterstützten Bewertungssysteme aufgeführt. Außerdem finden Sie hier einen Link zu den entsprechenden Unterkünften für jedes Bewertungssystem. Die Property-Definitionen identifizieren die unterstützten Bewertungswerte für jedes System.Land Bewertungssystem Property USA Motion Picture Association of America (MPAA) contentDetails.contentRating.mpaaRating
USA TV Parental Guidelines contentDetails.contentRating.tvpgRating
Australien Australian Classification Board (ACB) contentDetails.contentRating.acbRating
Brasilien Departamento de Justiça, Classificação, Qualificação e Títulos contentDetails.contentRating.djctqRating
Kanada Kanadisches Heimvideo-Bewertungssystem (CHVRS) contentDetails.contentRating.chvrsRating
Frankreich Centre national du cinéma et de l'image animée (französisches Kulturministerium) contentDetails.contentRating.fmocRating
Deutschland Freiwillige Selbstkontrolle der Filmwirtschaft (FSK) contentDetails.contentRating.fskRating
Vereinigtes Königreich British Board of Film Classification (BBFC) contentDetails.contentRating.bbfcRating
Indien Central Board of Film Certification (CBFC) contentDetails.contentRating.cbfcRating
Japan 映倫管理委員號 (EIRIN) contentDetails.contentRating.eirinRating
Korea 영상물등파위원회 (KMRB) contentDetails.contentRating.kmrbRating
Mexiko Generaldirektion für Radio, Fernsehen und Kamera (RTC) contentDetails.contentRating.rtcRating
Neuseeland Amt für Film- und Literaturklassifikation contentDetails.contentRating.oflcRating
Russland Nationales Filmregister der Russischen Föderation contentDetails.contentRating.russiaRating
Spanien Instituto de la Cinematografía y de las Artes Audiovisuales (ICAA) contentDetails.contentRating.icaaRating
-
-
Die Dokumentation der Methode
playlistItems.update
wurde aktualisiert, um die Tatsache zu berücksichtigen, dass das Attributsnippet.resourceId
in der als Anfragetext gesendeten Ressource angegeben werden muss. -
Die Methode
search.list
unterstützt jetzt die folgenden Funktionen:-
Der neue
forMine
-Parameter schränkt eine Suche so ein, dass nur die Videos des authentifizierten Nutzers abgerufen werden. -
Mit dem Parameter
order
können Ergebnisse jetzt alphabetisch nach Titel (order=title
) oder nach Anzahl der Videos in absteigender Reihenfolge (order=videoCount
) sortiert werden. -
Der neue
safeSearch
-Parameter gibt an, ob Suchergebnisse eingeschränkte Inhalte enthalten sollen.
-
-
Die Methode
videos.insert
unterstützt mehrere neue Fehler, die in der folgenden Tabelle aufgeführt sind:Fehlertyp Fehlerdetails Beschreibung badRequest
invalidCategoryId
Die Eigenschaft snippet.categoryId
gibt eine ungültige Kategorie-ID an. Verwenden Sie die MethodevideoCategories.list
, um unterstützte Kategorien abzurufen.badRequest
invalidRecordingDetails
metadata specifies invalid recording details.
badRequest
invalidVideoGameRating
Die Metadaten der Anfrage geben eine ungültige Altersfreigabe für das Videospiel an. badRequest
invalidVideoMetadata
Die Metadaten der Anfrage sind ungültig. -
Der Parameter
onBehalfOfContentOwner
wurde aus der Liste der unterstützten Parameter für die Methodenvideos.update
undvideos.delete
entfernt.
12. März 2013
Dieses Update enthält die folgenden Änderungen:
-
Das Attribut
channelTitle
wurde demsnippet
für die folgenden Ressourcen hinzugefügt:activity
: Die Property gibt den Namen des Kanals an, der für die Aktivität verantwortlich ist.search
: Die Eigenschaft gibt den Namen des Kanals an, der mit der Ressource verknüpft ist, die das Suchergebnis angibt.video
: Die Property gibt den Namen des Kanals an, über den das Video hochgeladen wurde.
-
Die Methode
search.list
unterstützt die folgenden neuen Parameter:-
Mit dem Parameter
channelType
kannst du die Suche nach Kanälen auf alle Kanäle oder nur auf Sendungen beschränken. -
Mit dem Parameter
videoType
kannst du die Suche nach Videos einschränken, um alle Videos oder nur Filme oder Folgen von Serien abzurufen.
-
-
Die Definition des
recordingDetails
-Teils dervideo
-Ressource wurde aktualisiert. Das Objekt wird nur dann für ein Video zurückgegeben, wenn die Daten zur Standortbestimmung oder die Aufzeichnungszeit des Videos festgelegt wurden. -
Die Methode
playlistItems.update
gibt jetzt den FehlerinvalidSnippet
zurück, der zurückgegeben wird, wenn in der API-Anfrage kein gültiges Snippet angegeben ist. -
Mehrere API-Methoden unterstützen neue Parameter, die ausschließlich für YouTube-Content-Partner bestimmt sind. Zu den YouTube-Content-Partnern gehören Film- und Fernsehstudios, Plattenfirmen und andere Ersteller von Inhalten, die ihre Inhalte auf YouTube zur Verfügung stellen.
-
Der Parameter
onBehalfOfContentOwner
gibt an, dass in den Autorisierungsdaten der Anfrage ein YouTube CMS-Nutzer identifiziert wird, der im Namen des im Parameterwert angegebenen Rechteinhabers handelt. Das CMS-Konto, mit dem sich der Nutzer authentifiziert, muss mit dem angegebenen YouTube-Rechteinhaber verknüpft sein.Dieser Parameter ist für Content-Partner vorgesehen, die viele verschiedene YouTube-Kanäle haben und verwalten. Der Parameter ermöglicht es diesen Partnern, sich einmal zu authentifizieren und Zugriff auf alle ihre Video- und Kanaldaten zu erhalten, ohne Authentifizierungsdaten für jeden einzelnen Kanal angeben zu müssen.
Die Methoden
channels.list
,search.list
,videos.delete
,videos.list
undvideos.update
unterstützen diesen Parameter. -
Der von der
channels.list
-Methode unterstütztemanagedByMe
-Parameter weist die API an, alle Kanäle des Rechteinhabers zurückzugeben, die mit demonBehalfOfContentOwner
-Parameter angegeben werden. -
Der von der
search.list
-Methode unterstützteforContentOwner
-Parameter weist die API an, Suchergebnisse auf Ressourcen zu beschränken, die dem Rechteinhaber gehören, der mit demonBehalfOfContentOwner
-Parameter angegeben wird.
-
25. Februar 2013
Dieses Update enthält die folgenden Änderungen:
-
Die API unterstützt mehrere neue Teile und Eigenschaften für
video
-Ressourcen:-
Die neuen Abschnitte
fileDetails
,processingDetails
undsuggestions
bieten Videoinhabern Informationen zu ihren hochgeladenen Videos. Diese Daten sind in Anwendungen, die Videouploads ermöglichen, sehr nützlich und umfassen Folgendes:- Verarbeitungsstatus und Fortschritt
- Fehler oder andere Probleme bei der Verarbeitung eines Videos
- Verfügbarkeit von Thumbnail-Bildern
- Vorschläge zur Verbesserung der Qualität von Videos oder Metadaten
- Details zur Originaldatei, die auf YouTube hochgeladen wurde
Alle diese Teile können nur vom Videoinhaber abgerufen werden. In der folgenden Liste werden die neuen Teile kurz beschrieben. In der
video
-Ressourcendokumentation werden alle Eigenschaften definiert, die die einzelnen Teile enthalten.-
Das
fileDetails
-Objekt enthält Informationen zur Videodatei, die auf YouTube hochgeladen wurde, einschließlich Auflösung, Dauer, Audio- und Video-Codecs, Stream-Bitraten und mehr. -
Das Objekt
processingProgress
enthält Informationen zum Fortschritt bei der Verarbeitung der hochgeladenen Videodatei durch YouTube. Die Eigenschaften des Objekts geben den aktuellen Verarbeitungsstatus an und schätzen die verbleibende Zeit, bis YouTube das Video verarbeitet hat. Dieser Teil gibt auch an, ob verschiedene Arten von Daten oder Inhalten wie Dateidetails oder Miniaturansichten für das Video verfügbar sind.Dieses Objekt ist für den Abruf vorgesehen, damit der Video-Uploader den Fortschritt von YouTube bei der Verarbeitung der hochgeladenen Videodatei verfolgen kann.
-
Das
suggestions
-Objekt enthält Vorschläge zur Verbesserung der Videoqualität oder der Metadaten für das hochgeladene Video.
-
Der
contentDetails
-Teil enthält vier neue Attribute. Diese Attribute können mit nicht authentifizierten Anfragen abgerufen werden.dimension
: Gibt an, ob das Video in 2D oder 3D verfügbar ist.definition
: Gibt an, ob das Video in Standard oder High Definition verfügbar ist.caption
: Gibt an, ob für das Video Untertitel verfügbar sind.licensedContent
: Gibt an, ob das Video Inhalte enthält, auf die ein YouTube-Contentpartner Anspruch erhoben hat.
-
Der Teil
status
enthält zwei neue Attribute. Videoeigentümer können beim Einfügen oder Aktualisieren eines Videos Werte für beide Eigenschaften festlegen. Diese Attribute können auch mit nicht authentifizierten Anfragen abgerufen werden.embeddable
: Gibt an, ob das Video auf einer anderen Website eingebettet werden kann.license
: Gibt die Lizenz des Videos an. Gültige Werte sindcreativeCommon
undyoutube
.
-
-
Die Definition des Parameters
part
wurde für die Methodenvideos.list
,videos.insert
undvideos.update
aktualisiert, um die oben beschriebenen neu hinzugefügten Teile sowie den TeilrecordingDetails
aufzulisten, der versehentlich weggelassen wurde. -
Die neue Eigenschaft
contentDetails.googlePlusUserId
der Ressourcechannel
gibt die mit dem Kanal verknüpfte Google+ Profil-ID an. Dieser Wert kann verwendet werden, um einen Link zum Google+ Profil zu generieren. -
Für jedes Miniaturansicht-Bildobjekt werden nun Breite und Höhe des Bildes angegeben. Miniaturansichten werden derzeit in Ressourcen vom Typ
activity
,channel
,playlist
,playlistItem
,search result
,subscription
undvideo
zurückgegeben. -
playlistItems.list
unterstützt jetzt denvideoId
-Parameter, der zusammen mit demplaylistId
-Parameter verwendet werden kann, um nur das Playlist-Element abzurufen, das das angegebene Video repräsentiert.Die API gibt den Fehler
notFound
zurück, wenn das durch den Parameter identifizierte Video nicht in der Playlist gefunden wird. -
In der Fehlerdokumentation wird ein neuer
forbidden
-Fehler beschrieben, der angibt, dass eine Anfrage für die angeforderte Aktion nicht ordnungsgemäß autorisiert ist. -
Das Attribut
snippet.channelId
der Ressourcechannel
wurde entfernt. Das Attributid
der Ressource hat denselben Wert.
30. Januar 2013
Dieses Update enthält die folgenden Änderungen:
-
Auf der neuen error-Seite werden Fehler aufgelistet, die die API zurückgeben kann. Die Seite enthält allgemeine Fehler, die bei mehreren verschiedenen API-Methoden auftreten können, sowie methodenspezifische Fehler.
16. Januar 2013
Dieses Update enthält die folgenden Änderungen:
-
Für die in der folgenden Liste aufgeführten Methoden und Sprachen sind jetzt Codebeispiele verfügbar:
activities.insert
– JavaplaylistItems.insert
– PythonplaylistItems.list
: Java, JavaScript, PHP, Python, Rubyplaylists.insert
: Java, JavaScript, Pythonsearch.list
: Java, JavaScript, Python, Rubyvideos.insert
– Java
-
Eine
activity
-Ressource kann jetzt einechannelItem
-Aktion melden, die auftritt, wenn YouTube einem automatisch generierten YouTube-Kanal ein Video hinzufügt. YouTube ermittelt anhand von Algorithmen Themen, die auf der YouTube-Website häufig vorkommen, und erstellt automatisch Kanäle für diese Themen. -
Die folgenden
search.list
-Parameter wurden aktualisiert:- Der Parameter
q
ist nicht mehr als Filter gekennzeichnet. - Der Parameter
relatedToVideo
wurde inrelatedToVideoId
umbenannt. - Der Parameter
published
wurde durch die beiden neuen ParameterpublishedAfter
undpublishedBefore
ersetzt, die unten beschrieben werden.
- Der Parameter
-
Die Methode
search.list
unterstützt die folgenden neuen Parameter:Parametername Wert Beschreibung channelId
string
Gibt Ressourcen zurück, die vom angegebenen Kanal erstellt wurden. publishedAfter
datetime
Gibt Ressourcen zurück, die nach der angegebenen Zeit erstellt wurden. publishedBefore
datetime
Gibt Ressourcen zurück, die vor dem angegebenen Zeitpunkt erstellt wurden. regionCode
string
Gibt Ressourcen für das angegebene Land zurück. videoCategoryId
string
Sie können die Videosuchergebnisse so filtern, dass nur Videos enthalten sind, die der angegebenen Videokategorie zugeordnet sind. videoEmbeddable
string
Sie können die Videosuchergebnisse so filtern, dass nur Videos angezeigt werden, die in einem eingebetteten Player auf einer Webseite abgespielt werden können. Setze den Parameterwert auf true
, um nur einzubettende Videos abzurufen.videoSyndicated
string
Filtere die Videosuchergebnisse so, dass nur Videos enthalten sind, die außerhalb von YouTube.com abgespielt werden können. Setze den Parameterwert auf true
, um nur syndizierte Videos abzurufen. -
Mehrere API-Ressourcen unterstützen neue Attribute. In der folgenden Tabelle sind die Ressourcen und ihre neuen Eigenschaften aufgeführt:
Ressource Property-Name Wert Beschreibung activity
contentDetails.playlistItem.playlistItemId
string
Die ID des Playlist-Elements, die YouTube zugewiesen hat, um das Element in der Playlist eindeutig zu identifizieren. activity
contentDetails.channelItem
object
Ein Objekt, das Informationen zu einer Ressource enthält, die einem Channel hinzugefügt wurde. Dieses Attribut ist nur vorhanden, wenn snippet.type
den WertchannelItem
hat.activity
contentDetails.channelItem.resourceId
object
Ein Objekt, das die Ressource identifiziert, die dem Kanal hinzugefügt wurde. Wie andere resourceId
-Properties enthält sie einekind
-Eigenschaft, die den Ressourcentyp angibt, z. B. Video oder Playlist. Es enthält auch genau eine von mehreren Eigenschaften –videoId
,playlistId
usw. –, die die ID angibt, die diese Ressource eindeutig identifiziert.channel
status
object
Dieses Objekt enthält Informationen zum Datenschutzstatus des Kanals. channel
status.privacyStatus
string
Der Datenschutzstatus des Kanals. Gültige Werte sind private
undpublic
.playlist
contentDetails
object
Dieses Objekt enthält Metadaten zum Inhalt der Playlist. playlist
contentDetails.itemCount
unsigned integer
Die Anzahl der Videos in der Playlist. playlist
player
object
Dieses Objekt enthält Informationen, mit denen du die Playlist in einem eingebetteten Player abspielen würdest. playlist
player.embedHtml
string
Ein <iframe>
-Tag, das einen Videoplayer einbettet, der die Playlist wiedergibt.video
recordingDetails
object
Dieses Objekt enthält Informationen, die den Ort und die Uhrzeit der Videoaufzeichnung identifizieren oder beschreiben. video
recordingDetails.location
object
Dieses Objekt enthält Standortinformationen, die mit dem Video verknüpft sind. video
recordingDetails.location.latitude
double
Breitengrad in Grad video
recordingDetails.location.longitude
double
Längengrad in Grad video
recordingDetails.location.elevation
double
Höhe über der Erde in Metern video
recordingDetails.locationDescription
string
Eine Textbeschreibung des Ortes, an dem das Video aufgezeichnet wurde. video
recordingDetails.recordingDate
datetime
Datum und Uhrzeit der Videoaufzeichnung Der Wert wird im Format ISO 8601 ( YYYY-MM-DDThh:mm:ss.sZ
) angegeben. -
In der Dokumentation für mehrere API-Methoden werden nun Eigenschaften angegeben, die im Anfragetext angegeben werden müssen oder basierend auf den Werten im Anfragetext aktualisiert werden. In der folgenden Tabelle sind diese Methoden sowie die erforderlichen oder änderbaren Eigenschaften aufgeführt.
Hinweis:In der Dokumentation für andere Methoden werden möglicherweise bereits erforderliche und änderbare Eigenschaften aufgeführt.
Methode Attribute activities.insert
Erforderliche Attribute: snippet.description
snippet.description
contentDetails.bulletin.resourceId
playlists.update
Erforderliche Attribute: id
playlistItems.update
Erforderliche Attribute: id
videos.update
Erforderliche Attribute: id
-
Die API meldet keinen
playlistAlreadyExists
-Fehler mehr, wenn du versuchst, eine Playlist zu erstellen oder zu aktualisieren, die denselben Titel wie eine bereits auf demselben Kanal vorhandene Playlist hat. -
Mehrere API-Methoden unterstützen neue Fehlertypen. In der folgenden Tabelle sind die Methode und die neu unterstützten Fehler aufgeführt:
Methode Fehlertyp Fehlerdetails Beschreibung guideCategories.list
notFound
notFound
Die durch den Parameter id
identifizierte Guide-Kategorie wurde nicht gefunden. Verwenden Sie die Methode guideCategories.list, um eine Liste gültiger Werte abzurufen.playlistItems.delete
forbidden
playlistItemsNotAccessible
Die Anfrage ist nicht berechtigt, das angegebene Playlist-Element zu löschen. videoCategories.list
notFound
videoCategoryNotFound
Die durch den Parameter id
angegebene Videokategorie kann nicht gefunden werden. Verwenden Sie die Methode videoCategories.list, um eine Liste gültiger Werte abzurufen.