Auf dieser Seite werden Änderungen an der YouTube Data API (v3) und Aktualisierungen der Dokumentation aufgeführt. Änderungsprotokoll abonnieren
30. April 2024
Hinweis: Diese Mitteilung wird eingestellt.
Dieses Update enthält die folgenden Änderungen:
Die API unterstützt das Einfügen oder Abrufen von Kanaldiskussionen nicht mehr. Diese Änderung entspricht der auf der YouTube-Website unterstützten Funktion, mit der keine Kommentare auf Kanälen gepostet werden können.
13. März 2024
Hinweis: Diese Mitteilung wird eingestellt.
Dieses Update enthält die folgenden Änderungen:
Die Parameter sync
für die Methoden captions.insert
und captions.update
wurden eingestellt. YouTube unterstützt den Parameter ab dem 12. April 2024 nicht mehr.
Aufgrund dieser Änderung müssen Entwickler beim Einfügen oder Aktualisieren von Untertiteltracks Zeitinformationen angeben. Andernfalls schlägt der Upload fehl.
12. März 2024
Dieses Update enthält die folgenden Änderungen:
Die Dokumentation für die Ressource captions
wurde aktualisiert. Die maximal zulässige Länge für das Feld snippet.name
beträgt 150 Zeichen. Die API gibt den Fehler nameTooLong
zurück, wenn der Trackname länger ist.
7. März 2024
Hinweis: Diese Mitteilung wird eingestellt.
Das channel
-Ressourcenattribut brandingSettings.channel.moderateComments
wurde eingestellt. YouTube unterstützt den Parameter ab dem 7. März 2024 nicht mehr.
31. Januar 2024
Dieses Update enthält die folgenden Änderungen:
Mit dem neuen Parameter forHandle
der Methode channels.list
kannst du Informationen zu einem Kanal abrufen, indem du seinen YouTube-Alias angibst.
9. November 2023
Alle Verweise auf die Ressource videoId
unter Comments
wurden entfernt, da die Ressource videoId
nicht über einen API-Aufruf zurückgegeben wird.
12. September 2023
Hinweis: Diese Mitteilung wird eingestellt.
Die Methode comments.markAsSpam
wurde vor einigen Jahren eingestellt. Diese Methode wird auf YouTube bereits nicht mehr unterstützt und nicht mehr über die API unterstützt.
Allen Dokumenten wurde ein Hinweis zu veralteten Versionen hinzugefügt, der auf die Methode comments.markAsSpam
verweist.
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 video
-Ressource wurde aktualisiert. Die von der YouTube Data API zurückgegebene Anzahl gleichzeitiger Zuschauer kann sich von der Anzahl der verarbeiteten, Spam-bereinigten gleichzeitigen Betrachter in YouTube Analytics unterscheiden. In der YouTube-Hilfe findest du weitere Informationen zu Messwerten für Livestreams.
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 darauf 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 eingestellt.
Der Parameter relatedToVideoId
der Methode search.list wurde eingestellt. Der Parameter wird von YouTube ab dem 7. August 2023 nicht mehr unterstützt.
Derzeit wurde der Dokumentation der Methode search.list
ein Hinweis zu veralteten Versionen hinzugefügt. Dieser Parameter wird am oder nach dem 7. August 2023 vollständig aus der search.list
-Dokumentation entfernt.
Außerdem wurde im API-Implementierungsleitfaden ein Beispiel zum Abrufen ähnlicher Videos entfernt.
22. August 2022
Typanmerkungen für video.statistics-Felder wurden in einen String von nicht signiertem Long-Wert korrigiert.
5. August 2022
YouTube hat die Art und Weise geändert, wie Untertitel-IDs generiert werden. Im Zuge dieser Änderung werden allen Untertiteltracks neue Untertitel-IDs zugewiesen. Diese Änderung ist möglicherweise nicht abwärtskompatibel für Anwendungen, die caption_id
-Werte speichern. Sie wirkt sich jedoch nicht auf Anwendungen aus, die keine caption_id
-Werte speichern.
Bis zum 1. Dezember 2022 unterstützen die Methoden captions.list
, captions.update
, captions.download
und captions.delete
sowohl die alten als auch die neuen Untertiteltrack-IDs. Die alten Untertitel-Track-IDs werden allerdings ab dem 1. Dezember 2022 nicht mehr von YouTube unterstützt. Wenn dann eine dieser API-Methoden mit einer alten Untertitel-Track-ID aufgerufen wird, wird der Fehler captionNotFound
ausgegeben.
Zur Vorbereitung auf diese Änderung solltest du bis zum 1. Dezember 2022 alle gespeicherten Daten zu Untertiteltracks 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 für die YouTube API-Dienste wurden aktualisiert. Weitere Informationen finden Sie in den Nutzungsbedingungen für die YouTube API-Dienste – Änderungsverlauf.
27. April 2022
Die Methodenbeschreibung 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 beachten, dass die maximale Anzahl von Abonnenten, die von der API zurückgegeben werden, möglicherweise begrenzt ist.
Diese Änderung bezieht sich auf eine Korrektur der Dokumentation und nicht auf eine Änderung des API-Verhaltens.
15. Dezember 2021
Wie am 18. November 2021 angekündigt, ist aufgrund der Änderungen, die die Anzahl der „Mag ich nicht“-Bewertungen für Videos auf der gesamten YouTube-Plattform privat machen, jetzt die Property statistics.dislikeCount
der video
-Ressource privat.
Weitere Informationen zu dieser Änderung findest du im offiziellen YouTube-Blog.
18. November 2021
Im Rahmen der Änderungen, die die Anzahl der „Mag ich nicht“-Bewertungen für Videos auf der gesamten YouTube-Plattform privat halten, wird die Property statistics.dislikeCount
der video
-Ressource ab dem 13. Dezember 2021 auf „Privat“ gesetzt. Die Property wird also nur dann in eine API-Antwort vom Endpunkt videos.list
aufgenommen, 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 eingestellt.
Der Endpunkt commentThreads.update
wurde verworfen und wird nicht mehr unterstützt.
Diese 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 durchführen, um mehr als die Standardkontingente von 10.000 Einheiten zu erhalten. Bislang wurden sowohl der Compliance-Audit-Prozess als auch die Anträge auf Aufteilung zusätzlicher Kontingenteinheiten von Entwicklern durchgeführt, die das YouTube API-Dienste-Formular für Audits und Kontingentverlängerungen ausgefüllt und eingereicht haben.
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 einen Leitfaden zum Ausfüllen dieser Formulare hinzu:
- Geprüftes Entwickleranfragenformular: 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 die Compliance-Prüfung nicht bestanden haben oder bei denen eine Erhöhung der Kontingenteinheit abgelehnt wurde, können dieses Formular ausfüllen und einreichen.
- Formular zur Änderung der Kontrolle: Entwickler oder eine 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 über deine geplante Nutzung der YouTube API informiert, damit wir dich besser unterstützen können.
Weitere Informationen finden Sie in unserem neuen Leitfaden zu API Compliance Audits.
12. Mai 2021
Hinweis: Diese Mitteilung wird eingestellt.
Dieses Update umfasst die folgenden API-Änderungen:
-
Das Attribut
contentDetails.relatedPlaylists.favorites
der Ressourcechannel
wurde eingestellt. Die Funktion „Favoriten“ wurde bereits seit mehreren Jahren eingestellt, wie im Überarbeitungsverlauf am 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 Favoritenplaylist hinzuzufügen. Die Playlist wird dann in diesem Fall nicht erstellt und die API gibt einen Fehler zurück. Versuche, Favoriten-Playlists durch Hinzufügen, Modifizieren oder Löschen von Elementen zu ändern, werden ebenfalls gemäß früheren Ankündigungen eingestellt. Es können jederzeit Fehlermeldungen zurückgegeben werden.
-
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 Attribute wurden aus der Darstellung der
channel
-Ressource entfernt und ihre Definitionen wurden aus der Attributliste der Ressource entfernt. Außerdem wurden die mit diesen Attributen verbundenen 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 Attribute wurden aus der Darstellung der
channelSection
-Ressource entfernt und ihre Definitionen wurden aus der Attributliste der Ressource entfernt. Außerdem wurden die mit diesen Attributen verbundenen Fehler aus der methodenspezifischen Dokumentation entfernt. -
Für das Attribut
snippet.type
der RessourcechannelSection
wurden die folgenden Werte eingestellt. Diese Werte werden auf YouTube-Kanalseiten bereits nicht mehr unterstützt und deshalb 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 deshalb wird sie auch nicht mehr über die API unterstützt.
9. Februar 2021
Die Ressource playlistItem
unterstützt zwei neue Attribute:
- Die Eigenschaft
snippet.videoOwnerChannelId
gibt die ID des Kanals an, auf dem 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. Dieser 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
zurückgegeben (ungültige Anfrage). -
Die Fehler
watchHistoryNotAccessible
undwatchLaterNotAccessible
der MethodeplaylistItems.list
wurden aus der Dokumentation entfernt. Nutzer können über die API zwar nicht auf ihren Wiedergabeverlauf und ihre „Später ansehen“-Listen zugreifen, diese Fehler werden jedoch nicht von der API zurückgegeben.
15. Oktober 2020
Den Richtlinien für Entwickler wurden zwei neue Abschnitte hinzugefügt:
- 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 die Absicht der Wiedergabe anzugeben. Du kannst einschränken, welche Daten an YouTube weitergegeben werden, bevor ein Nutzer mit dem Player interagiert. Setze dazu Autoplay auf "false".
- Im neuen Abschnitt III.E.4.j geht es darum, den Status von Inhalten speziell für Kinder zu prüfen, bevor du sie auf deinen Websites oder in deinen Apps einbettest. Du bist dafür verantwortlich, zu wissen, wenn Videos, die du in deinen API-Client einbettest, speziell für Kinder erstellt wurden 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 abfragen kannst.
Im Zusammenhang mit diesen Änderungen wurde die Dokumentation zu Parametern für den eingebetteten Player um eine Erinnerung ergänzt. Diese weist darauf hin, dass die Wiedergabe ohne Nutzerinteraktion mit dem Player erfolgt, wenn du Autoplay aktivierst. 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
snippet.thumbnails
-Objekt, das die Thumbnail-Bilder eines Kanals identifiziert, kann bei neu erstellten Kanälen leer sein. Es kann bis zu einem Tag dauern, bis das Objekt gefüllt wird. - Die Property
statistics.videoCount
gibt nur die Anzahl der öffentlichen Videos des Kanals an, auch für die Inhaber. Dies 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 sie nicht maskierte Anführungszeichen ("
) enthalten. Beachten Sie, dass die Beschränkung auf 500 Zeichen keine Beschränkung pro Keyword, sondern eine Begrenzung der Gesamtlänge aller Keywords darstellt. Dies entspricht dem Verhalten auf der YouTube-Website.
9. September 2020
Hinweis: Diese Mitteilung wird eingestellt.
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 Mitteilung nicht mehr:
- Die folgenden Attribute der
channel
-Ressource:- Das Attribut
statistics.commentCount
- Das
brandingSettings.image
-Objekt und alle untergeordneten Eigenschaften - Die Liste
brandingSettings.hints
und alle ihre untergeordneten Eigenschaften
- Das Attribut
- Der Filterparameter
categoryId
der Methodechannels.list
- Die Ressource
guideCategories
und die MethodeguideCategories.list
- Die folgenden Attribute der
-
Wenn in der API-Anfrage der Parameter
managedByMe
auftrue
festgelegt wird, enthalten API-Antworten für die Methodechannels.list
nicht mehr das AttributprevPageToken
. Diese Änderung wirkt sich weder auf das AttributprevPageToken
bei anderenchannels.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. Die Unterstützung der MethodenplaylistItems.insert
undplaylistItems.delete
für diese Playlists wurde ebenfalls 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. Verwende die Methodesubscriptions.list
und den zugehörigen ParametermySubscribers
, um eine Liste der Abonnenten des Kanals des authentifizierten Nutzers abzurufen. -
Das
invideoPromotion
-Objekt derchannel
-Ressource 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 für den Parameter part
entfernt haben. Ab sofort werden nur 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 etwas niedriger sind, während für einige API-Aufrufe die gleichen Kosten anfallen. Durch diese Änderung erhöhen sich nicht die Kosten für API-Aufrufe. Insgesamt ist es wahrscheinlich, dass Sie Ihr zugewiesenes Kontingent, das Sie in der Google Cloud Console einsehen können, etwas länger nutzen wird.
Wir empfehlen allen Entwicklern dringend, für ihre Projekte eine Compliance-Prüfung durchzuführen, um weiterhin Zugriff auf die YouTube API-Dienste zu haben.
Dieser Überarbeitungsverlaufseintrag wurde ursprünglich am 20. Juli 2020 veröffentlicht.
28. Juli 2020
Für alle Videos, die über den Endpunkt videos.insert
aus nicht bestätigten API-Projekten hochgeladen werden, die nach dem 28. Juli 2020 erstellt wurden, ist der private Wiedergabemodus verfügbar. Damit diese Einschränkung aufgehoben wird, muss jedes Projekt einem Audit unterzogen werden, um die Einhaltung der Nutzungsbedingungen zu verifizieren.
Creator, die Videos über einen nicht bestätigten API-Client hochladen, erhalten eine E-Mail, in der sie darüber informiert werden, dass ihr Video als „Privat“ gesperrt ist und sie die Einschränkung durch die Verwendung eines offiziellen oder geprüften Clients umgehen 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 Zugriff auf die YouTube API-Dienste zu erhalten.
21. Juli 2020
[Aktualisiert am 28. Juli 2020.] Die Dokumentation, auf die in diesem Überarbeitungsverlauf verwiesen wird, wurde am 28. Juli 2020 wieder veröffentlicht.
Gestern haben wir eine aktualisierte Dokumentation zum Prozess zur Berechnung von Kontingenten veröffentlicht. Aufgrund unvorhergesehener Umstände ist die Kontingentänderung jedoch noch nicht in Kraft. Aus diesem Grund wurde die Dokumentation auf Fehlerfreiheit zurückgesetzt. Um Verwirrung zu vermeiden, wurde der Überarbeitungsverlaufseintrag, in dem die Änderung erläutert wird, entfernt und wird in naher Zukunft wieder veröffentlicht.
7. Juli 2020
Hinweis: Diese Mitteilung wird eingestellt.
Die Parameter autoLevels
und stabilize
der Methode videos.insert
wurden verworfen und beide Parameter aus der Dokumentation entfernt. Die entsprechenden 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.
Dieser Leitfaden bietet einen Einblick, wie YouTube bestimmte Aspekte der API-Nutzungsbedingungen durchsetzt, ersetzt jedoch keine vorhandenen Dokumente. Der Leitfaden beantwortet einige der häufigsten Fragen, die Entwickler bei API-Compliance-Audits stellen. Wir hoffen, dass diese Informationen Ihnen helfen werden, die Interpretation und Durchsetzung unserer Richtlinien zu verstehen und Ihnen die Entwicklung von Features zu erleichtern.
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 findest du in der YouTube-Hilfe.
17. April 2020
Hinweis: Diese Mitteilung wird eingestellt.
Die Funktion für Kanalbulletins wird auf YouTube eingestellt. Aus diesem Grund 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 findest du in der YouTube-Hilfe.
31. März 2020
Dieses Update enthält die folgenden Änderungen:
-
Neue Ressourcen und Methoden
-
Die neue Ressource
member
steht für ein Kanalmitglied eines YouTube-Kanals. Ein Mitglied unterstützt einen Creator regelmäßig und erhält besondere Vorteile. Mitglieder können beispielsweise chatten, wenn der Creator den „Nur für Mitglieder“-Modus für einen Chat aktiviert.Diese Ressource ersetzt die Ressource
sponsor
, die im Rahmen 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 identifiziert eine Preisstufe, 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 Erkennung von Inhalten, die auf Kinder ausgerichtet sind. YouTube bezeichnet sie als „speziell für Kinder“. 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 ein Video speziell für Kinder erstellt wurde.
Bei Kanälen kann diese Eigenschaft durch Aufrufen der Methodechannels.update
festgelegt werden. 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 der PropertyselfDeclaredMadeForKids
ermittelt werden. Weitere Informationen dazu, wie du die Zielgruppe für deinen Kanal, deine Videos oder Sendungen festlegst, findest du in der YouTube-Hilfe.
Wir haben auch die Nutzungsbedingungen für die YouTube API-Dienste und die Richtlinien für Entwickler aktualisiert. Weitere Informationen finden Sie in den Nutzungsbedingungen für die YouTube API-Dienste – Änderungsverlauf. Die Änderungen an den Nutzungsbedingungen für die YouTube API-Dienste und den Richtlinien für Entwickler treten am 10. Januar 2020 (Pacific Time) in Kraft.
10. September 2019
Die API-Referenzdokumentation wurde aktualisiert, um eine Änderung hinsichtlich der Art und Weise zu berücksichtigen, wie Abonnentenzahlen auf YouTube und folglich auch in API-Antworten gemeldet werden. Aufgrund dieser Änderung wird die vom YouTube Data API-Dienst zurückgegebene Abonnentenzahl bei einer Abonnentenzahl von mehr als 1.000 Abonnenten auf drei signifikante Stellen abgerundet. Diese Änderung wirkt sich auf die Eigenschaft 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 aber weiterhin in YouTube Studio sehen.
Wenn ein Kanal beispielsweise 123.456 Abonnenten hat, enthält die Eigenschaft 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 erklären und dynamische, hochwertige Codebeispiele über das APIs Explorer-Widget bereitzustellen. In der Dokumentation der Methode
channels.list
finden Sie ein Beispiel. 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 und dann tatsächliche API-Anfragen senden und die tatsächlichen API-Antworten ansehen. Das Widget bietet außerdem 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 häufige Anwendungsfälle für die auf der Seite erläuterte Methode beschrieben. Beispielsweise können Sie 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 APIs Explorer im Vollbildmodus mit diesen Werten öffnen. Diese Änderungen sollen Ihnen die Suche nach Codebeispielen erleichtern, die sich direkt auf den Anwendungsfall beziehen, den Sie in Ihrer eigenen Anwendung implementieren möchten.
Codebeispiele werden derzeit für Java, JavaScript, PHP, Python und curl unterstützt.
-
-
Das Codebeispiele-Tool 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 erkunden, Werte in APIs Explorer laden und den APIs Explorer im Vollbildmodus öffnen, um Codebeispiele in Java, JavaScript, PHP und Python zu erhalten.
Im Zuge dieser Änderung wurden auch die Seiten entfernt, auf denen zuvor verfügbare Codebeispiele für Java, JavaScript, PHP und Python aufgelistet waren.
-
Die Kurzanleitungen für Java, JavaScript, PHP und Python wurden aktualisiert. In den überarbeiteten Anleitungen wird anhand von Codebeispielen aus APIs Explorer erläutert, wie ein Beispiel mit einem API-Schlüssel und ein anderes Beispiel mit einer OAuth 2.0-Client-ID ausgeführt wird.
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. Beachten Sie nun, dass Ihr Code die Bild-URLs genau so verwenden sollte, wie sie in API-Antworten zurückgegeben werden, wenn Miniaturansichten in Ihrer Anwendung angezeigt werden. Ihre Anwendung sollte beispielsweise in einer URL, die in einer API-Antwort zurückgegeben wird, 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 auch 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 eingestellt.
Das Attribut
recordingDetails.location.altitude
der Ressourcevideo
wurde eingestellt. Es gibt keine Garantie, dass Videos Werte für diese Property zurückgeben. Es ist auch möglich, dass eingehende Daten nicht gespeichert werden, auch wenn API-Anfragen versuchen, einen Wert für dieses Attribut festzulegen.
22. Juni 2018
Der Implementierungsleitfaden, früher bekannt als Implementierungs- und Migrationsleitfaden, wurde aktualisiert und enthält nun keine Anleitung für die Migration von API V2 zur API V3. Darüber hinaus wurden auch Anleitungen für Funktionen entfernt, die in Version 3 der API eingestellt wurden, z. B. Lieblingsvideos.
27. November 2017
Dieses Update enthält die folgenden Änderungen:
-
Hinweis: Diese Mitteilung wird eingestellt.
YouTube stellt die Unterstützung für die Funktionen Angesagtes Video und Angesagte Website ein, die in der API über das
invideoPromotion
-Objekt derchannel
-Ressource unterstützt werden. Aus diesem Grund wird dieses Objekt einschließlich aller untergeordneten Eigenschaften eingestellt.Sie können noch bis zum 14. Dezember 2017 Daten vom Typ
invideoPromotion
abrufen und festlegen. Nach diesem Datum gilt Folgendes:- Wenn versucht wird, den
invideoPromotion
-Teil abzurufen, wennchannels.list
aufgerufen wird, wird ein leeresinvideoPromotion
oder gar keineinvideoPromotion
-Daten zurückgegeben. - Wenn versucht wird,
invideoPromotion
-Daten beim Aufrufen vonchannels.update
zu aktualisieren, wird mindestens bis zum 27. Mai 2018 eine erfolgreiche Antwort zurückgegeben. Sie werden aber als managementfrei behandelt, d. h., es wird keine Aktualisierung durchgeführt.
Nach dem 27. Mai 2018 ist es möglich, dass bei diesen Anfragen Fehlermeldungen zurückgegeben werden, z. B. dass
invalidPromotion
ein ungültiger Teil ist. - Wenn versucht wird, 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 sichtbar, z. B. für die Methode
channels.list
.Die anpassbaren Beispiele sollen Ihnen einen anwendungsfallspezifischen Ausgangspunkt für eine Node.js-Anwendung bieten. Die Funktion ähnelt dem Code in der Node.js-Kurzanleitung. Die Beispiele enthalten jedoch einige Dienstfunktionen, die in der Kurzanleitung nicht enthalten sind:
- Die Funktion
removeEmptyParameters
verwendet eine Liste von Schlüssel/Wert-Paaren, die API-Anfrageparametern entsprechen, und entfernt die Parameter, die keine Werte haben. - Die Funktion
createResource
verwendet 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 für sie 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 finden Sie unter den Voraussetzungen für die lokale Ausführung vollständiger Codebeispiele in der Anleitung für das Code-Snippet-Tool.
- Die Funktion
25. Oktober 2017
Dieses Update enthält die folgenden Änderungen:
-
Die Python-Codebeispiele im interaktiven Code-Snippet-Tool wurden aktualisiert, sodass die Bibliotheken
google-auth
undgoogle-auth-oauthlib
anstelle der mittlerweile eingestelltenoauth2client
-Bibliothek verwendet werden.Zusätzlich zu dieser Änderung stellt das Tool jetzt vollständige Codebeispiele für installierte Python-Anwendungen und Python-Webserveranwendungen zur Verfügung, die leicht unterschiedliche Autorisierungsabläufe verwenden. So sehen Sie sich die vollständigen Beispiele (und diese Änderung) an:
- Rufen Sie das interaktive Code-Snippet-Tool oder die Dokumentation für eine API-Methode auf, z. B. die Methode
channels.list
. - 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
InstalledAppFlow
-Autorisierungsablauf 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 Webserver-Beispiel zu wechseln. In diesem Beispiel werden das gcloud-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 lokal 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 Methode
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
gesetzt werden. - Die Definition des Parameters
regionCode
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 die Branding-Logos und -Symbole aktualisiert. Neue „Mit YouTube entwickelt“-Logos können auf der Seite mit den Branding-Richtlinien heruntergeladen werden. Weitere 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:
- Für iOS ist eine neue Kurzanleitung zur YouTube Data API verfügbar. In diesem Leitfaden wird erläutert, wie die YouTube Data API in einer einfachen iOS-Anwendung verwendet wird, die entweder in Objective-C oder Swift geschrieben ist.
- Das interaktive Code-Snippet-Tool für die YouTube Data API enthält jetzt eine Dokumentation, in der einige der Funktionen des Tools erläutert werden:
- API-Anfragen ausführen
- Zwischen Code-Snippets und vollständigen Codebeispielen wechseln
- Textbausteinfunktionen verwenden
- Vorhandene Ressourcen laden (für Aktualisierungsmethoden)
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 eingestellt.
Die folgenden
video
-Ressourcenattribute werden eingestellt. Die Properties werden zwar noch bis zum 1. Dezember 2017 unterstützt, es kann aber nicht garantiert werden, dass bis dahin für Videos weiterhin Werte für diese Properties zurückgegeben werden. Ebenso generierenvideos.insert
- undvideos.update
-Anfragen, bei 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 beliebter und interaktiver zu machen. Seiten, auf denen API-Methoden wie
channels.list
odervideos.rate
erläutert werden, bieten jetzt ein interaktives Tool, mit dem sich Code-Snippets in Java, JavaScript, PHP, Python, Ruby, Apps Script und Go ansehen und anpassen lassen.Das Tool zeigt für jede Methode 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 Eigenschaftswerte ändern, werden die Code-Snippets dynamisch aktualisiert, sodass sie die von Ihnen angegebenen Werte widerspiegeln.
-
Zwischen Code-Snippets und vollständigen Beispielen wechseln. Ein Code-Snippet zeigt den Teil des Codes, der die API-Methode aufruft. Ein vollständiges Beispiel enthält dieses Snippet sowie den 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 durch Klicken auf eine Schaltfläche ausführen. Um Anfragen auszuführen, müssen Sie das Tool autorisieren, die API in Ihrem Namen aufzurufen.
Beachten Sie, dass dieses Tool den APIs Explorer auf den Seiten ersetzt, auf denen es verfügbar ist. Auf jeder Seite wird ein Link angezeigt, damit Sie die Anfrage, an der Sie arbeiten, auch 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 zum Autorisieren von Nutzern und Erstellen 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 YouTube Data API-Anfragen stellt. Aktuell sind Anleitungen 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 mit Wikipedia-URLs, die die Inhalte des Kanals beschreiben. Die URLs entsprechen den Themen-IDs, die in dertopicDetails.topicIds[]
-Eigenschaft der Ressource zurückgegeben werden. - Die neue
contentDetails.videoPublishedAt
-Eigenschaft derplaylistItem
-Ressource gibt den Zeitpunkt an, zu dem das Video auf YouTube veröffentlicht wurde. Die Ressource enthält bereits die Eigenschaftsnippet.publishedAt
, die den Zeitpunkt angibt, an dem das Element zur Playlist hinzugefügt wurde. - Wie die
channel
-Ressource gibt auch dievideo
-Ressource jetzt die EigenschafttopicDetails.topicCategories[]
zurück, die eine Liste von Wikipedia-URLs enthält, die den Inhalt des Videos beschreiben. Beivideo
-Ressourcen entsprechen die URLs den Themen-IDs, die in dertopicDetails.relevantTopicIds[]
-Eigenschaft der Ressource zurückgegeben werden. - Die neue Property
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 Liste der unterstützten Themen-IDs auf eine Liste mit ausgewählten Themen umgestellt. Die vollständige Liste der unterstützten Themen-IDs finden Sie in den topicDetails
-Eigenschaften 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 untergeordnete Themen 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 Eigenschaftswert 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 jetztEntertainment
untergeordnet. - Die Kategorie
TV shows
, dieEntertainment
untergeordnet ist, ist neu. - Die Kategorie
Health
, die zuvor „Lifestyle
“ untergeordnet war, wurde entfernt.
Es gibt einige übergeordnete Kategorien (
Entertainment
,Gaming
,Lifestyle
,Music
undSports
). Jedes Video, das mit einer untergeordneten Kategorie wieTennis
verknüpft ist, wird auch der übergeordneten Kategorie (Sports
) zugewiesen. - 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 der Freebase API mehrere Änderungen an den Themen-IDs erforderlich. Mit Themen-IDs werden Themen identifiziert, die mit
channel
- undvideo
-Ressourcen verknüpft sind. Mithilfe des SuchparameterstopicId
können Sie auch nach Kanälen oder Videos zu einem bestimmten Thema suchen.Ab dem 10. Februar 2017 gibt YouTube eine kleine Gruppe von Themen-IDs anstelle der bisher sehr detaillierteren IDs zurück. Es ist auch nicht sicher, dass Kanäle und Videos 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. Beachten Sie, dass die Liste der Kategorien für alle Unterkünfte gleich ist.
- Das Attribut
topicDetails.topicIds[]
der Ressourcechannel
. - Das Attribut
topicDetails.relevantTopicIds[]
der Ressourcevideo
. - Der Parameter
topicId
der Methodesearch.list
.
- Das Attribut
-
Hinweis: Diese Mitteilung wird eingestellt.
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
. Diese Property enthält nach dem 10. Februar 2017 keine Werte. Nach diesem Datum werden durch den EigenschaftswerttopicDetails.relevantTopicIds[]
alle Themen ermittelt, die mit einem Video verknüpft sind.
- Das Attribut
-
Da Freebase bereits eingestellt wird, wurde die Anleitung Searching with Freebase Topics aus der Dokumentation entfernt. Dieser Leitfaden lieferte Codebeispiele, die zeigen, wie eine Anwendung mit der Freebase API funktioniert.
Außerdem wurden mehrere Codebeispiele im Zusammenhang mit 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
player.embedHtml
-Eigenschaft 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 später in diesem Überarbeitungsverlaufseintrag erläutert. -
Die neue
hasCustomThumbnail
-Eigenschaft gibt an, ob der Uploader ein benutzerdefiniertes Thumbnail für das Video bereitgestellt hat. Diese Property ist nur für den Uploader des Videos sichtbar. -
Das neue
fpbRatingReasons[]
gibt Gründe an, warum das Video seine FPB-Einstufung (Südafrika) erhalten hat. -
Das neue
mcstRating
gibt die Altersfreigabe an, die das Video in Vietnam erhalten hat.
-
-
Die Methode
videos.list
unterstützt die beiden neuen ParametermaxHeight
undmaxWidth
. Beim Abrufen desplayer
-Teils invideo
-Ressourcen können Sie einen oder beide Parameter verwenden.Standardmäßig beträgt die Höhe von
<iframe>
, die in der Eigenschaftplayer.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 einrahmen. Wenn das Seitenverhältnis beispielsweise 16:9 ist, beträgt die Breite des Players 640 Pixel.Mit den neuen Parametern kannst du angeben, dass der Einbettungscode anstelle der Standardabmessungen eine Höhe und/oder Breite verwenden soll, die dem Layout deiner App entspricht. 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 werden, kann eine Dimension dennoch kleiner als der für diese Dimension maximal zulässige Wert sein.
Angenommen, ein Video hat ein Seitenverhältnis von 16:9. Das
player.embedHtml
-Tag würde also einen 640 × 360 Pixel großen Player enthalten, wenn der ParametermaxHeight
odermaxWidth
nicht festgelegt ist.- Wenn der
maxHeight
-Parameter auf720
gesetzt ist, dermaxWidth
-Parameter aber nicht, gibt die API einen Player mit einer Größe von 1280 × 720 zurück. - Wenn der
maxWidth
-Parameter auf960
gesetzt ist, dermaxHeight
-Parameter aber nicht, gibt die API einen Player mit einer Größe von 960 × 540 Pixeln zurück. - Wenn der Parameter
maxWidth
auf960
und der ParametermaxHeight
auf450
gesetzt sind, gibt die API einen Player mit einer Größe von 800 × 450 zurück.
Die oben beschriebenen neuen Eigenschaften
player.embedHeight
undplayer.embedWidth
geben die Abmessungen des Players an. - Wenn der
-
-
Änderungen an bestehenden Methoden, Attributen und Parametern
-
Die Ressourcenbeschreibung
channelSection
wurde aktualisiert, um zu beachten, dass ein Kanal maximal 10 Regale mit Targeting-Daten erstellen kann, ohne dass Targeting-Daten festgelegt werden.Außerdem wurde die Eigenschaft
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 Eigenschaft
snippet.name
deri18nLanguage
-Ressource wurde so korrigiert, dass der Wert den Namen einer Sprache darstellt, wie er in der Sprache geschrieben ist, die durch den Parameterhl
der Methodei18nLanguage.list
angegeben wird. -
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 eingestellt. 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 einige 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 anzugeben, dass die Parameterwerte eingeschlossen sind. Wenn beispielsweise der ParameterpublishedBefore
festgelegt ist, gibt die API Ressourcen zurück, die vor oder zum angegebenen Zeitpunkt erstellt wurden. -
Das Attribut
contentDetails.contentRating.grfilmRating
der Ressourcevideo
unterstützt drei zusätzliche Werte:grfilmK12
,grfilmK15
undgrfilmK18
. -
Die Methodenbeschreibung
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 der 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. Ein Grund für diesen Fehler ist, dass das FeldcontentDetails.note
mehr als 280 Zeichen enthält.forbidden (403)
watchHistoryNotAccessible
Die Methode playlistItems.list
gibt diesen Fehler zurück, um anzugeben, dass in 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 in 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 anzugeben, 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. Beachte, dass einige Kanäle möglicherweise nicht berechtigt sind, 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 bisher bei einigen Playlists aufgetreten, z. B. bei Lieblingsvideos, bei denen Duplikate nicht erlaubt waren, die aber nicht mehr unterstützt werden. In der Regel sind doppelte Videos in Playlists zulässig.
-
-
Weitere Updates
-
Der Eintrag zum Überarbeitungsverlauf vom 15. September 2016 wurde aktualisiert, um klarzustellen, dass immer dann, wenn die Attribute
contentDetails.relatedPlaylists.watchHistory
undcontentDetails.relatedPlaylists.watchLater
der Ressourcechannel
in einer Antwort enthalten sind, immer die WerteHL
bzw.WL
enthalten sind. Außerdem werden diese Eigenschaften nur aufgenommen, wenn ein autorisierter Nutzer Daten über den eigenen Kanal abruft.
-
15. September 2016
Dieses Update enthält die folgenden Änderungen:
-
In der Aktualisierung des Überarbeitungsverlaufs vom 11. August 2016 wurden verschiedene Änderungen im Zusammenhang mit Themen-IDs beschrieben. Unter anderem wurde die Reihe der unterstützten Themen-IDs ab dem 10. Februar 2017 geändert. Eine Liste der unterstützten Themen wird bis zum 10. November 2016 veröffentlicht.
-
Die folgenden Änderungen sind jetzt in Kraft. Die folgenden Änderungen wurden in der Aktualisierung des Überarbeitungsverlaufs am 11. August 2016 bekannt gegeben:
-
Wenn die Methode
activities.list
aufgerufen und der Parameterhome
auftrue
gesetzt ist, enthält die API-Antwort jetzt ähnliche Elemente wie ein abgemeldeter YouTube-Nutzer auf der Startseite.Mit dieser kleinen Änderung soll die Nutzerfreundlichkeit verbessert werden als in der Aktualisierung des Überarbeitungsverlaufs vom 11. August 2016 beschrieben. Zu diesem Update wurde festgelegt, 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 für alle Channels die entsprechenden WerteHL
undWL
.Diese Attribute 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 Kanal des Nutzers abruft. Daher können die IDs des Wiedergabeverlaufs und der Playlist „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 und der „Später ansehen“-Playlist, die dein API-Client möglicherweise bereits gespeichert hat.
-
-
Das
fileDetails.recordingLocation
-Objekt dervideo
-Ressource und ihre untergeordneten Eigenschaften werden nicht mehr zurückgegeben. Bisher konnten diese Daten (wie das übergeordnetefileDetails
-Objekt) nur vom Rechteinhaber eines Videos abgerufen werden.
11. August 2016
Dieses Update enthält die folgenden Änderungen:
-
Die neu veröffentlichten Nutzungsbedingungen für die YouTube API-Dienste („Aktualisierte Nutzungsbedingungen“), die im YouTube Engineering and Developers Blog ausführlich erörtert werden, enthalten zahlreiche Aktualisierungen der aktuellen Nutzungsbedingungen. Zusätzlich zu den aktualisierten Nutzungsbedingungen, die am 10. Februar 2017 in Kraft treten, enthält diese Aktualisierung mehrere Dokumente, in denen die Richtlinien erläutert werden, die Entwickler einhalten müssen.
Die vollständigen neuen Dokumente finden Sie im Überarbeitungsverlauf für die aktualisierten Nutzungsbedingungen. Darüber hinaus werden künftige Änderungen der aktualisierten Nutzungsbedingungen oder der entsprechenden Dokumente in diesem Überarbeitungsverlauf erläutert. Sie können einen RSS-Feed abonnieren, der Änderungen in diesem Überarbeitungsverlauf auflistet, und zwar über einen Link in dem Dokument.
-
Die Einstellung von Freebase und der 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 Teil
topicDetails
derchannel
-Ressource gibt die mit dem Kanal verknüpften Themen an. - Der
topicDetails
-Teil dervideo
-Ressource identifiziert die mit dem Video verknüpften Themen. - Mit dem Parameter
topicId
der Methodesearch.list
können Sie nach Videos oder Kanälen zu einem bestimmten Thema suchen.
Das sind die Änderungen:
-
Ab dem 10. Februar 2017 gibt YouTube eine kleine Gruppe von Themen-IDs anstelle der bisher sehr detaillierteren IDs zurück. Mit diesen unterstützten Themen lassen sich übergeordnete Kategorien wie Sport oder Basketball identifizieren, aber beispielsweise nicht bestimmte Teams oder Spieler. Wir werden die unterstützten Themen bekannt geben, damit Sie Zeit haben, Ihre Bewerbung auf diese Änderung vorzubereiten.
-
Alle Freebase-Themen-IDs, die Sie bereits abgerufen haben, 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 Themen abzurufen.
-
Wenn Sie nach dem 10. Februar 2017 versuchen, mit einer Themen-ID zu suchen, die nicht zur kleineren Gruppe der unterstützten Themen-IDs gehört, gibt die API einen leeren Ergebnissatz zurück.
- Der Teil
-
Ab dem 12. September 2016 werden einige API-Felder und -Parameter eingestellt:
-
Der Parameter
home
der Methodeactivities.list
ermöglichte einem autorisierten Nutzer, den Aktivitätsfeed abzurufen, der auf der YouTube-Startseite dieses Nutzers angezeigt werden würde. Bei Anfragen, bei 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 Kanal des Nutzers abruft. Nach dem 12. September 2016 gibtcontentDetails.relatedPlaylists.watchHistory
den WertHL
und die PropertycontentDetails.relatedPlaylists.watchLater
für alle Channels den WertWL
zurück.Nach dem 12. September 2016 wird bei Anfragen zum Abrufen von Playlist-Details (
playlists.list
) für den Wiedergabeverlauf eines Kanals oder die Playlist „Später ansehen“ eine leere Liste zurückgegeben. Bei Anfragen zum Abrufen von Playlist-Elementen (playlistItems.list
) in einer dieser Playlists wird auch nach dieser Zeit eine leere Liste zurückgegeben. Dies gilt für die neuen Werte „HL
“ und „WL
“ sowie für alle IDs des Wiedergabeverlaufs oder der „Später ansehen“-Playlist, die dein API-Client möglicherweise bereits gespeichert hat. -
Das
fileDetails.recordingLocation
-Objekt dervideo
-Ressource oder eine ihrer untergeordneten Eigenschaften wird nach dem 12. September 2016 nicht mehr zurückgegeben. Diese Daten können nur vom Videoinhaber 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 keine dieser Attribute zurückgegeben wird, wurden sie aus der entsprechenden Ressourcendokumentation entfernt.
31. Mai 2016
Dieses Update enthält die folgenden Änderungen:
-
Der neue Parameter
myRecentSubscribers
der Methodesubscriptions.list
ruft eine Liste der Abonnenten des Kanals des authentifizierten Nutzers in umgekehrter chronologischer Reihenfolge ab dem Zeitpunkt ab, zu dem er den Kanal abonniert hat.Mit dem neuen Parameter können nur die letzten 1.000 Abonnenten des Kanals des authentifizierten Nutzers abgerufen werden. Verwende den Parameter
mySubscribers
, um eine vollständige Liste der Abonnenten abzurufen. Dieser Parameter, der keine Abonnenten in einer bestimmten Reihenfolge zurückgibt, schränkt die Anzahl der abzurufenden Abonnenten nicht ein. -
Die Definition der Property
snippet.thumbnails.(key)
wurde für die Ressourcen activity, playlistItem, playlist, Suchergebnis, thumbnail und Video aktualisiert. Beachten Sie, dass für einige Videos zusätzliche Größen für Miniaturansichten verfügbar sind.- 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 nun zu einem Preis von2
Kontingenteinheiten abgerufen werden. -
Die Methode
videos.list
gibt jetzt einen verbotenen (403
) Fehler zurück, wenn eine nicht ordnungsgemäß 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 gängige 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
Das Tool zeigt für jeden Anwendungsfall die in der API-Anfrage verwendeten Parameter an. Sie können die Parameterwerte ändern. In diesem Fall aktualisiert das Tool die Code-Snippets, damit sie den von Ihnen bereitgestellten Parameterwerten entsprechen.
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 angegebenen Parameterwerten. Beachten Sie, dass Sie das Tool autorisieren müssen, Anfragen in Ihrem Namen 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
-Eigenschaft gibt den Ort an, den der Videoinhaber mit dem Video verknüpfen möchte. Dieser Standort kann bearbeitet, bei öffentlichen Videos gesucht und Nutzern für öffentliche Videos angezeigt werden. - Der
fileDetails.recordingLocation
-Eigenschaftswert ist unveränderlich und stellt den Speicherort der hochgeladenen Originaldatei dar. Der Wert ist nur für den Videoinhaber sichtbar.
- Die
-
Die Definition der
contentDetails.relatedPlaylists.favorites
-Eigenschaft derchannel
-Ressource wurde aktualisiert. Hinweis: Der Eigenschaftswert enthält möglicherweise eine Playlist-ID, die auf eine leere Playlist verweist und nicht abgerufen werden kann. Das liegt daran, dass die Funktion „Favoriten“ bereits eingestellt wurde. Hinweis: 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 Parameters
part
der Methodechannels.update
wurde aktualisiert. Hinweis:localizations
ist auch für diesen Parameter ein gültiger Wert. -
Der Abschnitt Kontingentnutzung des Startleitfadens wurde aktualisiert und mit der Google Developers Console verknüpft. Dort können Sie Ihr tatsächliches Kontingent und Ihre Kontingentnutzung einsehen.
16. März 2016
Dieses Update enthält die folgenden Änderungen:
-
Aktualisierungen für vorhandene Ressourcen und Methoden
-
Die Dokumentation zur Ressource „
channelBanner
“ wurde aktualisiert. Die empfohlene Größe für das hochgeladene Kanalbannerbild beträgt 2560 × 1440 Pixel. Die Mindestgröße (2048 x 1152 Pixel) hat sich nicht geändert. -
Die neue
snippet.customUrl
-Eigenschaft derchannel
-Ressource gibt die mit dem Kanal verknüpfte benutzerdefinierte URL an. Nicht alle Kanäle haben benutzerdefinierte URLs. In der YouTube-Hilfe wird erklärt, welche Voraussetzungen du erfüllen musst, um eine benutzerdefinierte URL zu erhalten. Außerdem erfährst du, wie du die URL einrichtest. -
Das
brandingSettings.watch
-Objekt derchannel
-Ressource und alle untergeordneten Attribute wurden eingestellt. -
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. Mit dem Regionscode wird die API angewiesen, Suchergebnisse für das angegebene Land zurückzugeben.Der Eigenschaftswert ist ein aus zwei Buchstaben bestehender ISO-Ländercode zur Identifizierung der Region. Die Methode
i18nRegions.list
gibt eine Liste der unterstützten Regionen zurück. Der Standardwert istUS
. Wenn eine nicht unterstützte Region angegeben wird, kann YouTube zur Verarbeitung der Anfrage trotzdem eine andere Region anstelle des Standardwerts auswählen. -
Die Definitionen der Eigenschaften
snippet.label
undsnippet.secondaryReasons[].label
dervideoAbuseReportReason
-Ressource wurden aktualisiert. Die Eigenschaften enthalten nun lokalisierten Labeltext für die Gründe für den Missbrauchsbericht.Außerdem 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 Standardwert für den Parameter isten_US
. -
Die neue Property
contentDetails.contentRating.ecbmctRating
dervideo
-Ressource gibt die Bewertung eines Videos durch die türkische Behörde 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 Eigenschaftswerte:
contentDetails.contentRating.fpbRating
(Südafrika)
Bewertung: 10; Wert der Unterkunft:fpb10
contentDetails.contentRating.moctwRating
(Taiwan)
Bewertung: R-12; Wert der Immobilie:moctwR12
contentDetails.contentRating.moctwRating
(Taiwan)
Bewertung: R-15; Wert der Immobilie:moctwR15
-
Die
liveStreamingDetails.activeLiveChatId
-Property dervideo
-Ressource enthält die ID des aktiven Livechats, der mit dem Video verknüpft ist. Der Eigenschaftswert 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 anzugeben, dass der API-Server die Anfrage nicht verarbeiten konnte. Dies kann zwar 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 dercommentThread
-Ressource 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 sind.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 sich das Video, das du der Playlist hinzufügen möchtest, bereits in einer anderen Serienplaylist befindet. 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 dass Sie 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 die Eigenschaftsnippet.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 Ressource vom Typvideo
einen ungültigen Wert angegeben hat.badRequest (400)
invalidPublishAt
Die Methode videos.update
gibt diesen Fehler zurück, um anzugeben, dass für das Attributstatus.publishAt
in der hochgeladenen Ressource vom Typvideo
eine ungültige geplante Veröffentlichungszeit angegeben ist.badRequest (400)
invalidRecordingDetails
Die Methode videos.update
gibt diesen Fehler zurück, um anzugeben, dass für dasrecordingDetails
-Objekt in der hochgeladenenvideo
-Ressource ungültige Aufnahmedetails angegeben wurden.badRequest (400)
invalidTags
Die Methode videos.update
gibt diesen Fehler zurück, um anzugeben, dass das Attributsnippet.tags
in der hochgeladenen Ressource vom Typvideo
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 anzugeben, 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 Endnutzer in der EU bestimmte Informationen offenlegen und Einwilligungen dieser Endnutzer einholen. Für Endnutzer in der Europäischen Union müssen Sie daher die Richtlinie zur Einwilligung der Nutzer in der EU einhalten. Wir haben den Nutzungsbedingungen für die YouTube API einen Hinweis auf diese Anforderung hinzugefügt.
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 folgenden beiden Schritte aus, um lokalisierte Werte für eine Ressource festzulegen:-
Achten Sie darauf, dass für das Attribut
snippet.defaultLanguage
der Ressource ein Wert festgelegt ist. Dieses Attribut gibt die Sprache der Attributesnippet.title
undsnippet.description
der Ressource an. Als Wert kann eine beliebige unterstützte Anwendungssprache oder die meisten anderen ISO 639-1:2002-Sprachcodes verwendet werden. Wenn du beispielsweise ein Video mit englischem Titel und Beschreibung hochlädst, setze die Eigenschaftsnippet.defaultLanguage
aufen
.Hinweis zum Aktualisieren von
channel
-Ressourcen:Wenn Sie das Attributsnippet.defaultLanguage
für einechannel
-Ressource 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 Englisch als Standardsprache der Ressource festgelegt. Außerdem werden einem 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 senden, 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 in deinechannels.list
-,channelSections.list
-,playlists.list
- odervideos.list
-Anfrage ein, um lokalisierte Daten für eine bestimmte Anwendungssprache, die von der YouTube-Website unterstützt wird, abzurufen. 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, eine
videos.list
-Anfrage hat Daten für das oben beschriebene Video mit lokalisierten deutschen und spanischen Daten abgerufen. Wenn der Parameterhl
aufde
gesetzt wäre, 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" } ... } }
Würde jedoch der Parameter
hl
auffr
gesetzt, würde dassnippet.localized
-Objekt den englischen Titel und die Beschreibung enthalten, 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 zur Angabe der Anwendungssprachen, die von der YouTube-Website unterstützt werden. Um festzustellen, ob lokalisierter Text für andere Sprachen verfügbar ist, musst du denlocalizations
-Teil für die Ressource und den 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 für Appalachen-Englisch verfügbar ist.
-
Nimm beim Abrufen einer Ressource
localizations
in den Parameterwertpart
auf, um alle lokalisierten Details für diese Ressource abzurufen. Wenn du lokalisierte Daten für eine Sprache abrufst, die keine aktuelle Sprache der YouTube-Anwendung ist, musst du so vorgehen, um alle Lokalisierungen abzurufen und anschließend zu 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 localizations
-Objekt für eine Ressource einzufügen oder zu aktualisieren, fehlschlägt, da 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 Objekt localizations
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:
-
Aktualisierungen für vorhandene Ressourcen und Methoden
-
Der Parameter
order
der Methodesearch.list
wurde aktualisiert. Wenn Sie Liveübertragungen nachviewCount
sortieren, werden die API-Ergebnisse nach der Anzahl der gleichzeitigen Zuschauer der Broadcasts sortiert, während die Broadcasts noch laufen. -
Der Parameter
relatedToVideoId
der Methodesearch.list
wurde aktualisiert. Wenn er festgelegt ist, werden nur noch die anderen unterstützten Parameterpart
,maxResults
,pageToken
,regionCode
,relevanceLanguage
,safeSearch
,type
(muss aufvideo
gesetzt sein) undfields
sind. 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 Eigenschaftswert den Zeitpunkt an, zu dem das Video veröffentlicht wurde. In der aktualisierten Definition wird auch erläutert, 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
dervideo
-Ressource 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. - Wird durch die Anfrage die Veröffentlichung eines Videos in der Vergangenheit geplant, wird es sofort veröffentlicht. Wenn du also die
status.publishAt
-Property auf ein Datum und eine Uhrzeit in der Vergangenheit festlegst, hat dies dieselbe Auswirkung wie eine Ä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 gemäß der französischen Klassifikationskommission der Kinematografie der französischen Kommission an. Dieses Attribut ersetzt das AttributcontentDetails.contentRating.fmocRating
, das jetzt eingestellt wurde. -
Die Definition der Ressource brandingSettings.channel.keywords der
channel
-Ressource wurde aktualisiert, um korrekt widerzuspiegeln, dass der Property-Wert eine durch Leerzeichen getrennte Liste von Strings und keine durch Kommas getrennte Liste enthält, wie bereits dokumentiert. Diese Aktualisierung spiegelt keine Änderung des API-Verhaltens wider. -
Die Dokumentation für die Methode
thumbnails.set
wurde aktualisiert, um zu verdeutlichen, dass der Anfragetext das Thumbnail enthält, das du hochlädst und mit einem Video verknüpfst. 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
entspricht nicht dem angegebenen ID-Typ.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 Wert des Parameters relevanceLanguage
war falsch formatiert.subscriptions.insert
HTTP-Antwortcode badRequest (400)
Grund subscriptionForbidden
Beschreibung Dieser Fehler tritt auf, wenn eine der folgenden Bedingungen zutrifft: - Das Abo, das Sie erstellen möchten, ist bereits vorhanden
- Du hast die maximale Anzahl an Abos bereits erreicht
- Du versuchst, deinen eigenen Kanal zu abonnieren. Dies wird nicht unterstützt.
- Du hast in letzter Zeit zu viele Abos erstellt und musst einige Stunden warten, bevor du die Anfrage wiederholen kannst.
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:
-
Aktualisierungen für vorhandene Ressourcen und Methoden
-
Das Attribut
statistics.favoriteCount
der Ressourcevideo
wurde eingestellt.Gemäß unserer Richtlinie zur Einstellung von Produkten und Diensten ist diese Property nach dieser Ankündigung noch mindestens ein Jahr lang in
video
-Ressourcen enthalten. Allerdings ist der Attributwert jetzt immer auf0
festgelegt.
-
7. August 2015
Dieses Update enthält die folgenden Änderungen:
-
Aktualisierungen für vorhandene Ressourcen und Methoden
-
Die Definition des Attributs
snippet.tags[]
dervideo
-Ressource wurde aktualisiert, um mehr Informationen darüber zu liefern, wie der API-Server die Länge des Attributwerts berechnet. Hinweis: Diese Aktualisierung spiegelt keine Änderung am API-Verhalten wider.Die Definition erklärt jetzt, dass, wenn ein Tag ein Leerzeichen enthält, der API-Server den Tag-Wert so behandelt, als wäre er in Anführungszeichen eingeschlossen, und die Anführungszeichen werden auf die Zeichenbeschränkung angerechnet. Um die Zeichenbeschränkung einzuhalten, enthält das Tag Foo-Baz also 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 eine Anfrage den Parameter sendet, ignoriert der API-Server den Parameter, verarbeitet die Anfrage aber ansonsten.
-
18. Juni 2015
Dieses Update enthält die folgenden Änderungen:
-
Aktualisierungen für vorhandene 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 an, die im Standard-Audiotrack des Videos gesprochen wird. -
Die Definition der Eigenschaft
contentDetails.licensedContent
dervideo
-Ressource wurde aktualisiert, um klarzustellen, dass der Inhalt ursprünglich auf einen Kanal hochgeladen worden sein muss, der mit einem YouTube-Contentpartner verknüpft ist, und anschließend 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 wird. Mit der MethodevideoAbuseReportReasons.list
kannst du eine Liste aller Gründe abrufen, aus denen Videos gemeldet werden können. -
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 dafür angibt, warum das Video missbräuchliche Inhalte enthält. Über die oben beschriebenevideoAbuseReportReason.list
-Methode können Sie gültige Gründe abrufen.Die Migrationsanleitung wurde ebenfalls um ein Beispiel zum Melden eines missbräuchlichen Videos ergänzt. Mit dieser Änderung unterstützt die v3 API nun alle Funktionen der API v2, die voraussichtlich unterstützt werden. Diese Funktionen werden auch alle in der Migrationsanleitung erläutert.
-
-
Aktualisierungen für vorhandene Ressourcen und Methoden
-
Der neue Filterparameter
forDeveloper
dersearch.list
-Methode schränkt die Suche auf Videos ein, die über die Anwendung oder Website des Entwicklers hochgeladen wurden. DerforDeveloper
-Parameter kann in Verbindung mit optionalen Suchparametern wie demq
-Parameter verwendet werden.Für diese Funktion wird jedes hochgeladene Video automatisch mit der Projektnummer getaggt, die in der Google Developers Console mit der App des Entwicklers verknüpft ist.
Wenn der Parameter
forDeveloper
in einer Suchanfrage nachträglich 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 die eigene App oder Website des Entwicklers hochgeladen wurden, aber nicht auf Videos, die über andere Apps oder Websites hochgeladen wurden.Die neue Funktion bietet ähnliche, wenn auch nicht dieselben Funktionen wie die Entwickler-Tags, die von der API v2 unterstützt wurden.
-
Mit der neuen
snippet.country
-Property derchannel
-Ressource können Kanalinhaber ihre Kanäle mit einem bestimmten Land verknüpfen.Hinweis: Wenn Sie das Attribut
snippet.country
für einechannel
-Ressource festlegen möchten, müssen Sie das AttributbrandingSettings.channel.country
aktualisieren. -
Die API unterstützt jetzt Targeting für
channelSection
-Ressourcen. Mit dem Targeting auf Kanalabschnitte kannst du die Sichtbarkeit eines Inhaltsbereichs auf Nutzer beschränken, die bestimmte Kriterien erfüllen.Die API bietet drei Targeting-Optionen. Ein Nutzer muss alle Targeting-Einstellungen erfüllen, damit ein Kanalbereich sichtbar ist.
-
targeting.languages[]
: Eine Liste der Sprachen der YouTube-Anwendung. Nutzer, die eine dieser Sprachen ausgewählt haben, sehen den entsprechenden Kanalabschnitt. -
targeting.regions[]
: Eine Liste der für YouTube bevorzugten Inhaltsregionen. Der Kanalabschnitt ist für Nutzer sichtbar, die eine dieser Regionen ausgewählt haben sowie für Nutzer, für die eine dieser Regionen automatisch ausgewählt wurde. -
targeting.countries[]
: Eine Liste der Länder, in denen der Kanalabschnitt sichtbar ist. Jeder Wert in der Liste ist ein Ländercode gemäß ISO 3166-1 alpha-2.
-
-
Die Definition der Eigenschaft
contentDetails.duration
dervideo
-Ressource wurde korrigiert, sodass der Wert Stunden, Tage usw. widerspiegeln kann. -
Die Dokumentation für die Methoden
channelSections.delete
,playlistItems.delete
,playlists.delete
,subscriptions.delete
undvideos.delete
wurde korrigiert, sodass alle diese Methoden bei Erfolg 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[]
enthält.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[]
enthält.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[]
enthält.badRequest (400)
operationNotSupported
Die Methode comments.insert
gibt diesen Fehler zurück, wenn der API-Nutzer keinen Kommentar als Antwort auf den durch die Eigenschaftsnippet.parentId
angegebenen Kommentar der obersten Ebene einfügen kann. In 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:
-
Die Migrationsanleitung wurde aktualisiert. Sie enthält jetzt Informationen dazu, wie Anwendungen migriert werden, die noch die Kommentarfunktion der API V2 nutzen.
In diesem Leitfaden werden auch verschiedene Kommentarfunktionen beschrieben, die von der API V2 nicht unterstützt wurden, aber von der API 3.0 unterstützt werden. Dazu gehören:
- Kommentare zu einem Kanal abrufen
- Es werden alle Kommentarthreads zu einem Kanal abgerufen, 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 bereits erwähnt an den Superfeedr-Hub gesendet werden.
9. April 2015
Dieses Update enthält die folgenden Änderungen:
-
Mit den neuen API-Ressourcen
commentThread
undcomment
können Sie Kommentare abrufen, einfügen, aktualisieren, löschen und moderieren.-
Eine
commentThread
-Ressource enthält Informationen zu einem YouTube-Kommentarthread, der aus einem Kommentar der obersten Ebene und den Antworten auf diesen Kommentar besteht. EinecommentThread
-Ressource kann Kommentare zu einem Video oder Kanal darstellen.Der Kommentar der obersten Ebene und die Antworten sind
comment
-Ressourcen, die in dercommentThread
-Ressource verschachtelt sind. Wichtig: Die RessourcecommentThread
enthält nicht unbedingt alle Antworten auf einen Kommentar. Du musst die Methodecomments.list
verwenden, wenn du alle Antworten auf 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
: Ruft eine Liste von Kommentarthreads ab. Mit dieser Methode kannst du Kommentare zu einem bestimmten Video oder Kanal abrufen.commentThreads.insert
: Hier 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 bearbeiten.
-
Eine
comment
-Ressource enthält Informationen zu einem einzelnen YouTube-Kommentar. Einecomment
-Ressource kann einen Kommentar zu einem Video oder Kanal darstellen. Außerdem kann es sich bei dem Kommentar um einen Kommentar der obersten Ebene oder eine Antwort auf einen Kommentar der obersten Ebene handeln.Die API unterstützt die folgenden Methoden für
comment
-Ressourcen:comments.list
: Ruft eine Liste mit Kommentaren ab. Mit dieser Methode kannst du alle Antworten auf einen bestimmten Kommentar abrufen.comments.insert
: Eine Antwort auf einen vorhandenen Kommentar erstellen.comments.update
: Damit kannst du einen Kommentar ändern.comments.markAsSpam
: Einen oder mehrere Kommentare als Spam melden.comments.setModerationStatus
: Damit wird der Moderationsstatus für einen oder mehrere Kommentare festgelegt. Du kannst beispielsweise einen Kommentar löschen, damit er öffentlich angezeigt werden kann, oder einen Kommentar ablehnen, da er nicht für die Anzeige geeignet ist. Die API-Anfrage muss vom Inhaber des Kanals oder Videos autorisiert werden, der mit den Kommentaren verknüpft ist.comments.delete
: Einen Kommentar löschen.
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-Publish/Subscribe-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:
- lädt ein Video hoch
- aktualisiert den Titel eines Videos
- aktualisiert die Beschreibung eines Videos
-
Die Migrationsanleitung wurde ebenfalls aktualisiert und enthält nun die neue Unterstützung für Push-Benachrichtigungen. Da die v2 API jedoch zahlreiche andere Arten von Push-Benachrichtigungen unterstützt hat, 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 alle API-Methoden, für die zuvor derhttps://www.googleapis.com/auth/youtube
-Bereich unterstützt wurde. -
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. -
Der Fehler
subscriptionLimitExceeded
, der zuvor darauf hingewiesen hat, dass der mit der Anfrage angegebene Abonnent die Ratenbegrenzung für Abos überschritten hatte, wird von der Methodesubscriptions.insert
nicht mehr unterstützt.
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.
-
Die Migrationsanleitung wurde ebenfalls aktualisiert und erklärt, wie Anwendungen migriert werden, die noch die Untertitelfunktionen in der 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
. Die Funktionen dieser beiden Bereiche sind identisch, da der YouTube API-Server nur über einen HTTPS-Endpunkt verfügbar ist. Daher gibt es keine andere Möglichkeit, eine API-Anfrage zu stellen, obwohl für den Bereichhttps://www.googleapis.com/auth/youtube
keine SSL-Verbindung erforderlich ist.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 den neuen Tab Neu in der API für Version 3. Dort werden Funktionen aufgeführt, die von der API für Version 3 unterstützt, von der API für Version 2 jedoch nicht. Die Funktionen, die früher verfügbar waren, finden sich auch auf anderen Tabs im Leitfaden. Beispielsweise ist die neue Funktion, in der erklärt wird, wie die Daten zu In-Video-Werbekampagnen eines Kanals aktualisiert werden, auch auf dem Tab Kanäle (Profile) aufgeführt.
-
Die Migrationsanleitung für die YouTube Data API (Version 3) wurde aktualisiert. Version 3 der API wird nun folgende API-Funktionen von Version 2 unterstützen:
-
Die Migrationsanleitung für die YouTube Data API (Version 3) wurde aktualisiert. Die folgenden API-Funktionen der Version 2 werden in Version 3 der API nicht mehr unterstützt:
-
Videoempfehlungen abrufen: Die API v3 ruft keine Liste ab, die nur für den aktuellen API-Nutzer empfohlene Videos enthält. Du kannst jedoch die API v3 verwenden, um empfohlene Videos zu finden. Rufe dazu die Methode
activities.list
auf und setze den Parameterwerthome
auftrue
.In der API-Antwort entspricht eine Ressource einem empfohlenen Video, wenn der Wert der
snippet.type
-Eigenschaftrecommendation
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 vor Kurzem auf vom API-Nutzer abonnierte Kanäle hochgeladen wurden. Du kannst jedoch mit der API v3 nach neuen Abovideos suchen, indem du die Methode
activities.list
aufrufst und den Parameterwerthome
auftrue
setzt.In der API-Antwort entspricht eine Ressource einem neuen Abovideo, wenn der Wert der
snippet.type
-Eigenschaftupload
ist. Es gibt keine Garantie, dass die Antwort eine bestimmte Anzahl neuer Abovideos enthält. -
Push-Benachrichtigungen für Feedaktualisierungen: Die API V2 unterstützte Push-Benachrichtigungen und nutzte 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 bei neuen Kanalabos und bei Bewertungen, Teilen, Favoriten, Kommentaren oder Uploads angezeigt.
Version 3 der API unterstützt Push-Benachrichtigungen, die das PubSubHubbub-Protokoll verwenden. Die Benachrichtigungen beziehen sich jedoch nur auf Videouploads und Aktualisierungen von Videotiteln oder Videobeschreibungen.
-
Kanalstandort: Bei der API V2 wurde das Tag
<yt:location>
verwendet, um den Standort des Nutzers so zu identifizieren, wie er im öffentlichen YouTube-Profil des Kanals angegeben wurde. Einige Entwickler haben dieses Feld genutzt, um einen Kanal mit einem bestimmten Land zu verknüpfen. Die Daten des Felds konnten jedoch nicht einheitlich für diesen Zweck verwendet werden. -
Entwickler-Tags festlegen oder abrufen: In der API V2 konnten beim Hochladen des Videos Keywords oder Entwickler-Tags mit einem Video verknüpft werden. Entwickler-Tags werden YouTube-Nutzern nicht angezeigt, Videoinhaber können jedoch 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 die App des Entwicklers hochgeladen wurden. Für diese Funktion wird jedes hochgeladene Video automatisch mit der Projektnummer getaggt, die in der Google Developers Console mit der App des Entwicklers verknüpft ist. Der Entwickler verwendet dann dieselbe Projektnummer, um nach Videos zu suchen.
-
Videos nach Veröffentlichungsdatum, Anzahl der Aufrufe oder Bewertung auflisten: In der API V2 kannst du mit dem Parameter
orderby
Videos in einer Playlist nach Position, Dauer, Veröffentlichungsdatum, Titel und verschiedenen anderen Werten sortieren. In der API v3 werden Playlist-Elemente in der Regel in aufsteigender Reihenfolge nach Position sortiert. Andere Sortieroptionen sind nicht verfügbar.Es gibt jedoch einige Ausnahmen. Bei folgenden Playlist-Typen wird ein neuer Upload, ein Lieblingsvideo, ein Video mit „Mag ich“ oder ein kürzlich angesehenes Video automatisch als erstes Element (
snippet.position
=0
) hinzugefügt. So wird jede dieser Listen effektiv vom neuesten zum ältesten Element geordnet, basierend auf den Zeitpunkten, zu denen die Elemente zur Liste hinzugefügt wurden.- Nutzeruploads
- Lieblingsvideos
- positiv bewertete Videos
- Wiedergabeverlauf
Beachte jedoch, dass ein neuer Inhalt, der der Playlist „Später ansehen“ hinzugefügt wird, als letzter Eintrag in der Liste hinzugefügt wird. Die Liste wird also vom ältesten zum neuesten Element sortiert.
-
Batchverarbeitung: Die API v3 unterstützt einen der Anwendungsfälle für die Batchverarbeitung, die 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 im Leitfaden nun alle Funktionen identifiziert, 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 einige andere Methoden unterstützt wird. -
Die folgenden Attribute und ihre untergeordneten Eigenschaften 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 Property
contentDetails.contentRating.contentDetails.contentRating.djctqRatingReasons
dervideo
-Ressource gibt die Gründe an, warum das Video die Bewertung DJCQT (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. Beispielsweise können Playlist-Elemente nach Datum oder Beliebtheit sortiert werden. Sie können diesen Fehler beheben, indem Sie dassnippet.position
-Element 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 Einstellung für die Reihenfolge der Playlist zu 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 geschlossenen Kanal angibt.forbidden (403)
channelSuspended
Die Methode playlists.list
gibt diesen Fehler zurück, wenn der ParameterchannelId
der Anfrage einen gesperrten Kanal angibt.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 nicht gefundenes Video angibt.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 (Version 3) wurde ebenfalls aktualisiert und erläutert, wie der neue Parameter verwendet wird. Der Parameter schließt 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. Die speziellen Feeds und Metadatenfelder der API Version 2 zur Beschreibung von Filmen, Trailern, TV-Sendungen, Serienstaffeln und -folgen wurden eingestellt.
14. Januar 2015
Dieses Update enthält die folgenden Änderungen:
-
Die Migrationsanleitung für die YouTube Data API (Version 3) wurde aktualisiert. Sie enthält jetzt Informationen dazu, 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 V2 unterstützt wird. Hinweis: Diese Änderung der Migrationsanleitung spiegelt keine tatsächliche API-Änderung wider. Es geht vielmehr um die Verfügbarkeit eines neuen Beispielcodes für das Hochladen von Videos mit clientseitigem JavaScript.
Da Videos über die JavaScript-Clientbibliothek und CORS hochgeladen werden können, wird der browserbasierte Upload nicht mehr als Funktion aufgeführt, die in Version 3 der API möglicherweise nicht mehr verfügbar ist.
-
Die Dokumentation für die Methode
videos.insert
wurde aktualisiert und enthält nun 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 geändert.Wichtig:In vielen Fällen können Sie andere API-Methoden verwenden, um Informationen mit niedrigeren Kontingentkosten abzurufen. Du hast beispielsweise zwei Möglichkeiten, Videos zu finden, die auf den Kanal GoogleDevelopers 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 setzen Sie den ParameterplaylistId
auf die erfasste ID und den Parameterpart
aufsnippet
.
-
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 Videos hochladen kann, 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
: Der Kanal kann Videos hochladen, die länger als 15 Minuten sind, muss aber zuerst die Funktion aktivieren.disallowed
: Der Kanal kann keine Videos hochladen, die länger als 15 Minuten sind.
Weitere Informationen zu diesen Werten finden Sie in der Property-Definition. Weitere Informationen zu dieser Funktion findest du in der YouTube-Hilfe.
-
Die Eigenschaft
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 es wahrscheinlicher ist, dass Nutzer darauf klicken, ohne das Wiedergabeerlebnis zu beeinträchtigen. Außerdem wird für jedes Video eine einzelne Werbung ausgewählt.
-
-
Die Definitionen der Attribute
snippet.title
undsnippet.categoryId
der Ressourcevideo
wurden aktualisiert, um zu verdeutlichen, wie die API Aufrufe der 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 Property
contentDetails.contentRating.oflcRating
dervideo
-Ressource, die die Bewertung eines Videos durch das neuseeländische Office of Film and Literature Classification identifiziert, unterstützt jetzt zwei neue Bewertungen: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 des YouTube-Kanalbilds des Kanalinhabers enthält zu viele Bilder. Der Kanalinhaber muss http://photos.google.com aufrufen, die Seite "Alben" aufrufen und einige Bilder aus dem Album entfernen.
12. September 2014
Dieses Update enthält die folgenden Änderungen:
-
Die Kontingentkosten für einen Aufruf der Methode
search.list
haben sich zusätzlich zu den Kosten für die angegebenen Ressourcenteile von 1 Einheit in 2 Einheiten 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 einigen Stunden können Sie versuchen, weitere Abos abzuschließen.
12. August 2014
Dieses Update enthält die folgenden Änderungen:
-
In einer neuen Anleitung mit dem Titel Deine Anwendung zur YouTube Data API migrieren (Version 3) wird erläutert, wie du mit der YouTube Data API (Version 3) Funktionen der YouTube Data API (Version 2) nutzen kannst. Die ältere API wurde offiziell am 4. März 2014 eingestellt. Dieser Leitfaden soll Ihnen helfen, Anwendungen, die noch die v2-API verwenden, zur neuesten API-Version zu migrieren.
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 der einzelnen API-Methoden wurde aktualisiert und enthält nun die Kontingentkosten, die bei einem Aufruf dieser 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
verursacht beispielsweise Kontingentkosten von etwa 50 Einheiten. Die Ressourcesubscription
besteht außerdem aus drei Teilen (snippet
,contentDetails
undsubscriberSnippet
), die jeweils zwei Einheiten kosten.Denken Sie daran, dass sich Kontingentkosten ohne Vorwarnung ändern können.
-
Die Ressource „
video
“ unterstützt jetzt 43 neue Altersfreigabesysteme, mit denen die Altersfreigaben ermittelt werden, die Videos von verschiedenen nationalen Einstufungsagenturen erhalten haben. Die neuen unterstützten Bewertungssysteme sind Argentinien, Österreich, Österreich, Belgien, Österreich{/05, Thai, Vereinigtes Königreich, {45, Thai, Vereinigtes Königreich, <77}Irland, {46, Dänemark, {45, Dänemark, {45, Dänemark, {45, Dänemark, {17, Dänemark, <77}; {37, T + 7, 7 , {18, <7}, , , .
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 mit einem geografischen Standort verknüpft sind. In einer Anfrage muss für beide Parameter ein Wert angegeben werden, um Ergebnisse basierend auf dem Standort abzurufen. Das API gibt einen Fehler zurück, wenn eine Anfrage nur einen der beiden Parameter enthält.-
Mit dem Parameter
location
werden die Koordinaten für Breiten- und Längengrad in der Mitte des kreisförmigen geografischen Bereichs angegeben. -
Der
locationRadius
-Parameter 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 angezeigt wird.
-
13. Mai 2014
Dieses Update enthält die folgenden Änderungen:
-
Die
invideoPromotion.items[]
-Eigenschaft derchannel
-Ressource wurde aktualisiert, um zu beachten, dass du in der Regel nur einen beworbenen Artikel für deinen Kanal festlegen kannst. 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 Property
contentDetails.contentRating.ifcoRating
dervideo
-Ressource gibt die Bewertung an, die ein Video vom Irish Film Classification Office erhalten hat. -
Die Definition der
position.cornerPosition
-Eigenschaft derwatermark
-Ressource wurde aktualisiert, um zu beachten, dass das Wasserzeichen immer oben rechts im Player angezeigt wird. -
Die Definition des
q
-Parameters für diesearch.list
-Methode wurde aktualisiert. Jetzt ist zu beachten, dass der Suchbegriff den booleschen Operator NOT (-
) verwenden kann, um Videos auszuschließen, die mit einem bestimmten Suchbegriff verknüpft sind. Für den Wert kann auch der boolesche Operator ODER (|
) verwendet werden, um Videos zu finden, die mit einem von mehreren Suchbegriffen verknüpft sind. -
Die Definition der Eigenschaft
pageInfo.totalResults
, die in einer API-Antwort auf einensearch.list
-Aufruf zurückgegeben wird, wurde aktualisiert. Der Wert ist nun ein Näherungswert und stellt keinen exakten Wert dar. Darüber hinaus beträgt der Maximalwert 1.000.000. Sie sollten diesen Wert nicht zum Erstellen von Links zur Paginierung 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 den HTTP-Antwortcode204
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 kann automatisch eine Anwendungssprache basierend auf den Google-Kontoeinstellungen, der Browsersprache oder dem IP-Standort 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 eine Inhaltsregion ausgewählt werden. Nutzer können die gewünschte Inhaltsregion auch manuell in der Fußzeile der YouTube-Website auswählen.Die API unterstützt eine Methode zum Auflisten unterstützter Inhaltsregionen. 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 von einem Kanal empfohlen 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.Auch die Definition des
suggestions
-Objekts dervideo
-Ressource wurde aktualisiert, um zu erklären, dass das Objekt nur 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, sodass klar wird, dass beim Aufrufen dieser Methoden die Eigenschaftstatus.publishAt
festgelegt werden kann. -
Die Definition des
invideoPromotion
-Objekts derchannel
-Ressource wurde aktualisiert, um zu verdeutlichen, dass das Objekt nur vom Kanalinhaber abgerufen werden kann. -
Die Parameterliste für die Methode
videos.rate
wurde aktualisiert, um zu berücksichtigen, dass die Methode den ParameteronBehalfOfContentOwner
nicht unterstützt. Dabei handelte es sich um einen Dokumentationsfehler, davideos.rate
-Anfragen, die diesen Parameter festlegen, einen500
-Fehler zurückgeben.
31. März 2014
Dieses Update enthält die folgenden Änderungen:
-
Mit der neuen
status.publishAt
-Eigenschaft dervideo
-Ressource kannst du das Datum und die Uhrzeit für die Veröffentlichung eines privaten Videos festlegen. 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 Einstellungsrichtlinie.
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 YouTube-Partner, die mit dem Kanal verknüpft sind, relevant sind, darunter die ID des mit dem Kanal verknüpften Rechteinhabers sowie Datum und Uhrzeit der Verknüpfung zwischen Rechteinhaber und Kanal. Hinweis: Dieser neue Teil unterliegt nicht der Richtlinie zur Einstellung von Produkten und Diensten. -
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 der Wert der Eigenschaft eine Liste ist und Kommas zwischen Elementen in der Liste auf das Limit 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 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 der EigenschaftbrandingSettings.channel.title
zu ändern. Hinweis: Die API gibt den Fehler nicht zurück, wenn Sie die Eigenschaft weglassen.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 beworbenen Artikeln angibt.forbidden (403)
promotedVideoNotAllowed
Die Methode channels.update
gibt diesen Fehler zurück, wenn dieinvideoPromotion.items[].id.videoId
-Property eine Video-ID angibt, die entweder nicht gefunden werden kann oder nicht als beworbenes Element verwendet werden kann.forbidden (403)
websiteLinkNotAllowed
Die Methode channels.update
gibt diesen Fehler zurück, wenn die EigenschaftinvideoPromotion.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 Standardeinstellungen für den Zeitpunkt angegeben sind, wann YouTube einen beworbenen Artikel anzeigen soll.required (400)
requiredTiming
Bei der Methode channels.update
muss für jeden beworbenen Artikel eininvideoPromotion.items[].timing
-Objekt angegeben werden.required (400)
requiredWebsiteUrl
Bei der Methode channels.update
muss für jeden beworbenen Artikel eineinvideoPromotion.items[].id.websiteUrl
-Eigenschaft angegeben werden.badRequest (400)
invalidPublishAt
Die Methode videos.insert
gibt diesen Fehler zurück, wenn in den Metadaten der Anfrage ein ungültiger geplanter Veröffentlichungszeitpunkt angegeben ist.
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 für die YouTube APIs beschrieben ist. Auf der Seite mit den APIs, die der Richtlinie zur Einstellung von Produkten und Diensten unterliegen, sind einige Funktionen der API v3 nicht der Richtlinie unterliegen.
5. Dezember 2013
Dieses Update enthält die folgenden Änderungen:
-
Die Dokumentation der Methode
search.list
wurde aktualisiert, um zu berücksichtigen, 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 Methode
search.list
wurden aktualisiert. Wichtig ist, dass Sie den Wert des Parameterstype
aufvideo
setzen müssen, 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 für hochgeladene Kanalbanner wurde auf 2048 x 1152 Pixel reduziert. Früher betrug die Mindestgröße 2.120 x 1.192 Pixel. Außerdem ist in der Dokumentation zur Ressource
channel
die maximale Größe aller Bannerbilder angegeben, die von der API bereitgestellt werden. Beispielsweise beträgt die maximale Größe desbrandingSettings.image.bannerTvImageUrl
-Bildes für Fernsehanwendungen 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 für
channel
-Ressourcenattribute wurden aktualisiert, um die folgenden Informationen zu berücksichtigen:- Der Wert des Attributs
brandingSettings.channel.description
darf maximal 1.000 Zeichen lang sein. - Die Eigenschaft
brandingSettings.channel.featuredChannelsTitle
darf maximal 30 Zeichen lang sein. - In der Property
brandingSettings.channel.featuredChannelsUrls[]
können jetzt bis zu 100 Kanäle 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 der EigenschaftinvideoPromotion.items[].promotedByContentOwner
. Diese Eigenschaft gibt an, ob der Name des Rechteinhabers beim Anzeigen der Werbung angezeigt wird. Es kann nur festgelegt werden, wenn die API-Anfrage, mit der der Eigenschaftswert festgelegt wird, im Namen des Rechteinhabers mit dem ParameteronBehalfOfContentOwner
gestellt wird. -
Die Methoden
playlistItems.list
undplaylistItems.insert
unterstützen jetzt den ParameteronBehalfOfContentOwner
, der bereits für einige andere Methoden unterstützt wird. -
In der Property
contentDetails.contentRating.acbRating
kann jetzt eine Altersfreigabe für Filme durch das Australian Classification Board (ACB) oder für Kinderfernsehen durch die Australian Communications and Media Authority (ACMA) festgelegt werden. -
Die neuen Properties
contentDetails.contentRating.catvRating
undcontentDetails.contentRating.catvfrRating
geben die Altersfreigaben 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
-Eigenschaft dervideoCategory
-Ressource gibt an, ob aktualisierte oder neu hochgeladene Videos dieser Videokategorie 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, mit denen sich Liveübertragungen leichter finden und anzeigen lassen:
Die neue Eigenschaft
snippet.liveBroadcastContent
in den Suchergebnissen gibt an, ob eine Video- oder Kanalressource über Liveübertragungen verfügt. Gültige Attributwerte sindupcoming
,active
undnone
.-
Die neue Eigenschaft
snippet.liveBroadcastContent
der Ressourcevideo
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 wird live übertragen.none
: Das Video ist keine anstehende oder aktive Liveübertragung. Dies ist der Eigenschaftswert für abgeschlossene Übertragungen, die noch auf YouTube sichtbar sind.
-
Die neue
liveStreamingDetails
-Eigenschaft dervideo
-Ressource ist ein Objekt, das Metadaten zu einer Live-Videoübertragung enthält. Zum Abrufen dieser Metadaten nehmen SieliveStreamingDetails
in die Liste der Ressourcenteile für den Parameterwertpart
auf. Die Metadaten enthalten die folgenden neuen Attribute:liveStreamingDetails.actualStartTime
: Die Uhrzeit, zu der die Übertragung tatsächlich begonnen hat. Dieser Wert ist vorhanden, sobald der Status der Übertragungactive
lautet.liveStreamingDetails.actualEndTime
: Die Uhrzeit, zu der die Übertragung tatsächlich beendet wurde. Dieser Wert wird angezeigt, sobald die Übertragung beendet ist.liveStreamingDetails.scheduledStartTime
: Die Uhrzeit, zu der die Übertragung geplant ist.liveStreamingDetails.scheduledEndTime
: Der Zeitpunkt, zu dem die Übertragung planmäßig endet. Wenn der Attributwert leer oder das Attribut nicht vorhanden ist, wird die Übertragung auf unbestimmte Zeit ausgeführt.liveStreamingDetails.concurrentViewers
: Die Anzahl der Zuschauer, die sich die Liveübertragung ansehen.
Fügen Sie zum Abrufen dieser Metadaten
liveStreamingDetails
in den Parameterwertpart
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, sollte den Wert jedoch aufFalse
setzen, damit die Abonnenten des Kanals nicht über jedes neue Video benachrichtigt werden. -
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
-Attribute zu identifizieren, die geändert werden können. DiesebrandingSettings
-Attribute konnten bereits geändert werden, sodass die Änderung in 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 einige andere Methoden unterstützt wird. -
Die Methode
playlists.insert
unterstützt jetzt den ParameteronBehalfOfContentOwnerChannel
, der bereits für mehrere andere Methoden unterstützt wird. -
Das Attribut
contentDetails.contentRating.tvpgRating
der Ressourcevideo
unterstützt jetzt den Wertpg14
, was der BewertungTV-14
entspricht. -
Die Definition der
snippet.liveBroadcastContent
-Eigenschaft, die Teil der Suchergebnisse ist, wurde korrigiert. Sie bedeutet nun, dasslive
ein gültiger Attributwert,active
aber kein gültiger Eigenschaftswert ist. -
Das Attribut
contentDetails.contentRating.mibacRating
der Ressourcevideo
unterstützt jetzt zwei zusätzliche Bewertungen:mibacVap
(VAP): Kinder sollten in Begleitung eines Erwachsenen sein.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, mit der der Wert festgelegt wird, im Namen des Rechteinhabers erfolgt. Weitere Informationen finden Sie unter dem ParameteronBehalfOfContentOwner
.
1. Oktober 2013
Dieses Update enthält die folgenden Änderungen:
-
Das neue
auditDetails
-Objekt derchannel
-Ressource enthält Kanaldaten, die von einem Multi-Channel-Netzwerk (MCN) ausgewertet werden, um zu ermitteln, 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 Geltungsbereich 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
derchannel
-Ressource unterstützt jetzt den WertrecentUpload
. Dies bedeutet, dass das beworbene Element das zuletzt hochgeladene Video von einem bestimmten Kanal ist.Der Kanal ist standardmäßig mit dem Kanal identisch, 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
-Property auf die Kanal-ID des Kanals setzt. -
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 Eigenschaft
snippet.liveBroadcastContent
in den Suchergebnissen gibt an, ob eine Video- oder Kanalressource über Liveübertragungen verfügt. Gültige Attributwerte sindupcoming
,active
undnone
.- Bei einer
video
-Ressource gibt der Wertupcoming
an, dass das Video eine Liveübertragung ist, die noch nicht gestartet wurde. Der Wertactive
gibt an, dass das Video eine laufende Liveübertragung ist. - Bei einer
channel
-Ressource gibt der Wertupcoming
an, dass auf dem Kanal eine geplante Übertragung noch nicht begonnen hat. Der Wertacive
gibt an, dass auf dem Kanal gerade eine Liveübertragung läuft.
- Bei einer
-
In der Ressource
watermark
wurde das AttributtargetChannelId
von einem Objekt in einen String geändert. Anstelle einer untergeordneten Eigenschaft, 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 mehrere andere Methoden unterstützt wird. -
Die Methode
search.list
unterstützt jetzt den ParametereventType
, der die Suche auf aktive, anstehende oder abgeschlossene Übertragungsereignisse beschrä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 angegebene Bildinhalt ungültig ist.forbidden
videoRatingDisabled
Die Methode videos.rate
gibt diesen Fehler zurück, wenn der Eigentümer des bewerteten Videos Bewertungen für dieses Video deaktiviert hat.
27. August 2013
Dieses Update enthält die folgenden Änderungen:
-
Die neue
watermark
-Ressource gibt ein Bild an, das während der Wiedergabe von 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 Methode
watermarks.set
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. -
Die neue
statistics.hiddenSubscriberCount
-Eigenschaft derchannel
-Ressource 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 Ländercode gemäß ISO 3166-1 alpha-2. -
In
error documentation
wird der folgende neue häufige Anfragefehler beschrieben, der bei mehreren API-Methoden auftreten kann:Fehlertyp Fehlerdetails Beschreibung forbidden
insufficientPermissions
Die Bereiche, die dem für die Anfrage bereitgestellten OAuth 2.0-Token zugeordnet sind, reichen für den Zugriff auf die angeforderten Daten nicht aus.
15. August 2013
Dieses Update enthält die folgenden Änderungen:
-
Das
invideoPromotion
-Objekt derchannel
-Ressource hat die folgenden neuen und aktualisierten Attribute:-
Die API unterstützt jetzt die Möglichkeit, eine Website als beworbenen Artikel anzugeben. Setzen Sie dazu den Attributwert
invideoPromotion.items[].id.type
aufwebsite
und verwenden Sie das neue AttributinvideoPromotion.items[].id.websiteUrl
, um die URL anzugeben. Mit der neuen EigenschaftinvideoPromotion.items[].customMessage
können Sie außerdem eine benutzerdefinierte Nachricht definieren, die für die Werbeaktion angezeigt werden soll.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 zu verknüpften Websites und Händlerwebsites.
Wenn 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 sie den AdWords-Richtlinien, den YouTube-Anzeigenrichtlinien, den YouTube-Community-Richtlinien und den YouTube-Nutzungsbedingungen entsprechen.
-
Die Eigenschaften, die sich auf die Timing-Einstellungen für die Anzeige beworbener Artikel während der Videowiedergabe beziehen, wurden neu strukturiert:
-
Das
invideoPromotion.timing
-Objekt wurde ininvideoPromotion.items[].timing
verschoben. Mit diesem Objekt kannst du jetzt die Zeitangaben für jedes beworbene Element in derinvideoPromotion.items[]
-Liste anpassen. -
Über das neue
invideoPromotion.defaultTiming
-Objekt werden Standardeinstellungen für die Zeit des Angebots festgelegt. Mit diesen Einstellungen wird festgelegt, wann ein beworbener Artikel während der Wiedergabe eines Videos deines Kanals angezeigt wird. Mit dem ObjektinvideoPromotion.items[].timing
können Sie das Standardzeitlimit für jeden beworbenen Artikel überschreiben. -
Die neue
invideoPromotion.items[].timing.durationMs
-Eigenschaft gibt an, wie lange das Angebot in Millisekunden zu sehen sein soll. DasinvideoPromotion.defaultTiming
-Objekt enthält auch eindurationMs
-Feld, das die Standarddauer angibt, die der beworbene Artikel angezeigt wird.
-
-
Die Properties
invideoPromotion.items[].type
undinvideoPromotion.items[].videoId
wurden in dasinvideoPromotion.items[].id
-Objekt 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 hat sich der Attributwertkind
vonyoutube#thumbnailListResponse
zuyoutube#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 Kanäle des Partners agieren, indem du den ParameteronBehalfOfContentOwnerChannel
bereitstellst, sofern dieser für die aufgerufene Methode verfügbar ist.
8. August 2013
Dieses Update enthält die folgenden Änderungen:
-
Der Abschnitt Kontingentnutzung des Leitfadens Erste Schritte mit der YouTube Data API wurde aktualisiert und enthält nun eine Änderung der Kontingentkosten für einen Video-Upload von etwa 16.000 auf rund 1.600 Einheiten.
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. -
Die neue
brandingSettings.channel.profileColor
-Eigenschaft derchannel
-Ressource gibt eine auffällige Farbe an, die die Inhalte des Kanals ergänzt. Der Eigenschaftswert besteht aus einem Pfundzeichen (#
), gefolgt von einem sechsstelligen Hexadezimalstring, z. B.#2793e6
. -
Mit der API kann jetzt angegeben werden, ob ein Abo für alle Aktivitäten eines Kanals oder nur für neue Uploads gilt. Die neue
contentDetails.activityType
-Eigenschaft dersubscription
-Ressource 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 istmostPopular
der einzige unterstützte Wert. Beachten Sie, dass derchart
-Parameter ein Filterparameter ist. Er kann also nicht in derselben Anfrage wie andere Filterparameter (id
undmyRating
) verwendet werden. - 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
-
Die neue
topicDetails.relevantTopicIds[]
-Eigenschaft dervideo
-Ressource stellt eine Liste der Freebase-Themen-IDs bereit, die für das Video oder seinen Inhalt relevant sind. Die Themen dieser Themen können im Video erwähnt werden oder selbst 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
contentDetails.contentRating
-Objekt dervideo
-Ressource gibt die Bewertungen an, die ein Video nach verschiedenen Bewertungssystemen erhalten hat, einschließlich MPAA-Bewertungen, TVPG-Einstufungen usw. Die API unterstützt nun für jedes Bewertungssystem einen Bewertungswert, der angibt, dass das Video noch nicht bewertet wurde. Beachten Sie, dass bei den MPAA-Altersfreigaben häufig die Einstufung "Nicht bewertet" verwendet wird, um ungeschnittene Versionen von Filmen zu identifizieren, für die die geschnittene Version des Films offiziell eingestuft wurde. -
Mit der neuen Eigenschaft
contentDetails.contentRating.ytRating
dervideo
-Ressource werden Inhalte mit Altersbeschränkung angegeben. Der Wert der Eigenschaft istytAgeRestricted
, wenn YouTube festgestellt hat, dass das Video Inhalte enthält, die für Nutzer unter 18 Jahren nicht geeignet sind. Wenn die Property nicht vorhanden oder der Property-Wert leer ist, wurden die Inhalte nicht als Altersbeschränkung eingestuft. -
Der Parameter
mySubscribers
der Methodechannels.list
wurde eingestellt. 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 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 ist jetzt auch die aktualisierte Liste der Attribute aufgeführt, die Sie für dasinvideoPromotion
-Objekt derchannel
-Ressource festlegen können. -
In
error documentation
werden die folgenden neuen Fehler beschrieben:Fehlertyp Fehlerdetails Beschreibung forbidden
accountDelegationForbidden
Dieser Fehler ist nicht spezifisch für eine bestimmte API-Methode. Er weist darauf hin, dass der authentifizierte Nutzer nicht berechtigt ist, im Namen des angegebenen Google-Kontos zu handeln. forbidden
authenticatedUserAccountClosed
Dieser Fehler ist nicht spezifisch für eine bestimmte API-Methode. Darin wird angegeben, dass das YouTube-Konto des authentifizierten Nutzers geschlossen wurde. Wenn der Nutzer im Namen eines anderen Google-Kontos handelt, weist dieser Fehler darauf hin, dass das andere Konto geschlossen wurde. forbidden
authenticatedUserAccountSuspended
Dieser Fehler ist nicht spezifisch für eine bestimmte API-Methode. Darin wird angegeben, dass das YouTube-Konto des authentifizierten Nutzers gesperrt ist. Wenn der Nutzer im Namen eines anderen Google-Kontos handelt, weist dieser Fehler darauf hin, dass das andere Konto gesperrt ist. forbidden
authenticatedUserNotChannel
Dieser Fehler ist nicht spezifisch für eine bestimmte API-Methode. Er weist darauf hin, 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 ist nicht spezifisch für eine bestimmte API-Methode. Der CMS-Nutzer ist nicht berechtigt, im Namen des angegebenen Rechteinhabers zu handeln. notFound
contentOwnerAccountNotFound
Dieser Fehler ist nicht spezifisch für eine bestimmte API-Methode. Das angegebene Rechteinhaber-Konto wurde nicht gefunden. badRequest
invalidPart
Dieser Fehler ist nicht spezifisch für 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 anzugeben, 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 Parameter
forUsername
der Methodechannels.list
können Sie Informationen über einen Kanal abrufen, indem Sie dessen 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 bisherigen Aktivitäten des autorisierten Nutzers auf YouTube nicht genügend Informationen zum Generieren des Aktivitätsfeeds liefern. -
Playlist-Ressourcen enthalten jetzt die Property
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 zuvor 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 Autorisierungsanmeldedaten 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 besitzen und verwalten. Mit diesem Parameter können sich diese Partner einmal authentifizieren und auf alle ihre Video- und Kanaldaten zugreifen, ohne für jeden einzelnen Kanal Anmeldedaten zur Authentifizierung 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
error documentation
werden die folgenden neuen Fehler beschrieben:Fehlertyp Fehlerdetails Beschreibung forbidden
insufficientCapabilities
Dieser Fehler ist nicht spezifisch für eine bestimmte API-Methode. Dies bedeutet, 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. -
Das Attribut
invideoPromotion.channelId
wurde aus der Ressourcechannels
entfernt, da die Kanal-ID bereits mit dem 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 für Entwickler hilfreich, die von der vorherigen Version der API migrieren und Anwendungen haben, die entweder Inhalte für den
default
-Nutzer anfordern oder auf der Annahme basieren, dass jeder YouTube-Kanal einen eindeutigen Nutzernamen hat, was nicht mehr der Fall ist.
22. Mai 2013
Dieses Update enthält die folgenden Änderungen:
-
Mit der neuen Methode
channelBanners.insert
kannst du ein Bannerbild hochladen, das anschließend mit der neuen EigenschaftbrandingSettings.image.bannerExternalUrl
der Ressourcechannel
als Bannerbild für einen Kanal festgelegt werden kann. -
Die Dokumentation für die Methode
channels.update
wurde aktualisiert, um die Attribute aufzulisten, die beim Aufrufen der Methode geändert werden können. -
In der Dokumentation zu
video
-Ressourcen wirdunspecified
nicht mehr als gültiger Attributwert für die Attributesuggestions.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:
-
Auf eigenständigen Seiten werden jetzt Codebeispiele für Java, .NET, PHP und Ruby aufgeführt.
-
Auf der Seite mit Python-Codebeispielen findest du 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 kann keine experimentellen API-Funktionen und -Dienste mehr identifizieren. Wir stellen dir jetzt stattdessen eine Liste der YouTube APIs zur Verfügung, die dieser Richtlinie zur Einstellung von Produkten und Diensten unterliegen.
8. Mai 2013
Dieses Update enthält die folgenden Änderungen:
-
Channelressourcen 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 nutzen, um während der Wiedergabe der Videos des Kanals Thumbnail-Bilder für ein gesponsertes Video im Videoplayer einzublenden.Sie können diese Daten abrufen, indem Sie
invideoPromotion
in den Parameterwertpart
in einerchannels.list
-Anfrage aufnehmen. -
Die neue Methode
channels.update
kann verwendet werden, um die Daten zu In-Video-Werbekampagnen eines Kanals zu aktualisieren. Die Methode unterstützt nur Aktualisierungen des TeilsinvideoPromotion
der Ressourcechannel
und noch keine Aktualisierungen für andere Teile dieser Ressource.
2. Mai 2013
Dieses Update enthält die folgenden Änderungen:
-
Kanalressourcen unterstützen jetzt die Eigenschaft
status.isLinked
, die angibt, ob anhand der Kanaldaten ein Nutzer identifiziert werden kann, der bereits mit einem YouTube-Nutzernamen oder einem Google+ Konto verknüpft ist. Ein Nutzer mit einem dieser Links hat bereits eine öffentliche YouTube-Identität, die Voraussetzung für verschiedene Aktionen, z. B. das Hochladen von Videos, ist. -
Aboressourcen unterstützen jetzt den
subscriberSnippet
-Teil. Das von diesem Objekt umschlossene 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 der Videos abrufen, die der authentifizierte Nutzer mit der Bewertunglike
oderdislike
bewertet hat.Der
myRating
-Parameter und derid
-Parameter werden nun als Filterparameter betrachtet, d. h., in einer API-Anfrage muss genau einer der Parameter angegeben werden. Bisher war der Parameterid
für diese Methode erforderlich.Die Methode gibt den Fehler
forbidden
für Anfragen zurück, bei denen versucht wird, Informationen zur Videobewertung abzurufen, aber nicht über die erforderliche Berechtigung dazu 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 der Ergebnismenge zurückgeben kann. Der ParameterpageToken
identifiziert eine bestimmte Seite in der Ergebnismenge, 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 im aktuellen Ergebnissatz enthaltenen Ergebnisse 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, Beleuchtung und Farbe des Videos automatisch zu optimieren.stabilize
: Wenn du diesen Parameterwert auftrue
setzt, weist YouTube das Video an, indem verwackelte Elemente infolge von Kamerabewegungen beseitigt werden.
-
Das Attribut
channelTitle
wurde demsnippet
für die folgenden Ressourcen hinzugefügt:playlistItem
: Die Eigenschaft gibt den Namen des Kanals an, der das Playlist-Element hinzugefügt hat.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 derzeit authentifizierten Nutzers abrufen. Dieser Parameter kann nur in einer ordnungsgemäß autorisierten Anfrage verwendet werden.Hinweis: Diese Funktion soll den
mySubscribers
-Parameter ersetzen, der derzeit für die Methodechannels.list
unterstützt wird. Dieser Parameter wird eingestellt. -
In einer
video
-Ressource ist der Attributwertunspecified
für keines der folgenden Attribute mehr möglich: -
API-Anfragen, die einen unerwarteten Parameter enthalten, geben jetzt den Fehler
badRequest
zurück. Der gemeldete Grund für den Fehler istunexpectedParameter
. -
Der Fehler, den die Methode
playlistItems.insert
zurückgibt, wenn die Playlist bereits die maximal zulässige Anzahl von Elementen enthält, wurde aktualisiert. Der Fehler wird jetzt alsforbidden
-Fehler gemeldet. 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 von einem 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 ausgewiesen. 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 zurückgegeben wie zuvor, allerdings werden jetzt in der Dokumentation die Namen der verschiedenen Miniaturansichten aufgeführt, die von der API zurückgegeben werden könnten.
-
Der neue
brandingSettings
-Teil derchannel
-Ressource enthält 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. 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 die erweiterten Videostatistiken auf der Wiedergabeseite öffentlich einsehbar sind. Diese Statistiken können standardmäßig aufgerufen werden. 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
contentDetails.contentRating
-Objekt enthält Bewertungen, die das Video gemäß verschiedenen Bewertungssystemen erhalten hat. In der folgenden Liste sind die unterstützten Bewertungssysteme aufgeführt. Außerdem finden Sie hier einen Link zu den Unterkünften, die mit dem jeweiligen Bewertungssystem verknüpft sind. Die Unterkunftsdefinitionen identifizieren die unterstützten Bewertungswerte für jedes System.Land Altersfreigabesystem 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 Canadian Home Video Rating System (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 영상물등frisch위원회 (KMRB) contentDetails.contentRating.kmrbRating
Mexiko Generaldirektion für Radio, Fernsehen und Kinematografie (RTC) contentDetails.contentRating.rtcRating
Neuseeland Office of Film and Literature Klassifizierung 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 zu berücksichtigen, dass das Attributsnippet.resourceId
in der Ressource angegeben werden muss, die als Anfragetext gesendet wird. -
Die Methode
search.list
unterstützt jetzt die folgenden Funktionen:-
Der neue
forMine
-Parameter schränkt die Suche auf die Videos des authentifizierten Nutzers ein. -
Mit dem
order
-Parameter können jetzt Ergebnisse 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 durch das Suchergebnis identifiziert wird.video
: Die Eigenschaft 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
können Sie die Suche nach Channels einschränken, um entweder alle Channels oder nur Sendungen abzurufen. -
Mit dem Parameter
videoType
können Sie eine Suche nach Videos einschränken, um alle Videos oder nur Filme oder Folgen von Serien abzurufen.
-
-
Die Definition des Abschnitts
recordingDetails
dervideo
-Ressource wurde aktualisiert. Das Objekt wird für ein Video nur dann zurückgegeben, wenn die Daten zur Standortbestimmung oder die Aufzeichnungszeit des Videos festgelegt wurden. -
Bei der Methode
playlistItems.update
wird jetzt der FehlerinvalidSnippet
zurückgegeben, 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 Content-Partnern von YouTube gehören Film- und Fernsehstudios, Musiklabels und andere Content-Creator, die ihre Inhalte auf YouTube zur Verfügung stellen.
-
Der Parameter
onBehalfOfContentOwner
gibt an, dass über die Autorisierungsanmeldedaten 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 besitzen und verwalten. Mit diesem Parameter können sich diese Partner einmal authentifizieren und auf alle ihre Video- und Kanaldaten zugreifen, ohne für jeden einzelnen Kanal Anmeldedaten zur Authentifizierung angeben zu müssen.
Die Methoden
channels.list
,search.list
,videos.delete
,videos.list
undvideos.update
unterstützen diesen Parameter alle. -
Der von der Methode
channels.list
unterstütztemanagedByMe
-Parameter weist die API an, alle Kanäle des Rechteinhabers zurückzugeben, die mit dem ParameteronBehalfOfContentOwner
angegeben sind. -
Der von der Methode
search.list
unterstützteforContentOwner
-Parameter weist die API an, Suchergebnisse auf Ressourcen zu beschränken, die dem Rechteinhaber gehören, der imonBehalfOfContentOwner
-Parameter angegeben ist.
-
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
fileDetails
-,processingDetails
- undsuggestions
-Abschnitte enthalten Informationen für Videoinhaber zu ihren hochgeladenen Videos. Diese Daten sind sehr nützlich in Anwendungen, die Video-Uploads ermöglichen, und umfassen Folgendes:- Verarbeitungsstatus und -fortschritt
- Fehler oder andere Probleme bei der Verarbeitung eines Videos
- Verfügbarkeit von Miniaturansichten
- Vorschläge zur Verbesserung der Video- oder Metadatenqualität
- Details zur hochgeladenen Originaldatei auf YouTube
Alle diese Teile können nur vom Videoinhaber abgerufen werden. In der folgenden Liste werden die neuen Teile kurz beschrieben. In der Dokumentation zur Ressource
video
sind alle Attribute definiert, die in den einzelnen Teilen enthalten sind.-
Das
fileDetails
-Objekt enthält Informationen zur Videodatei, die auf YouTube hochgeladen wurde, darunter Auflösung, Dauer, Audio- und Video-Codecs, Stream-Bitraten und mehr. -
Das
processingProgress
-Objekt enthält Informationen über den Fortschritt 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 z. B. Dateidetails oder Miniaturansichten, für das Video verfügbar sind.Dieses Objekt ist für die Abfrage 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 Teil
contentDetails
enthält vier neue Eigenschaften. 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 Content enthält, auf den ein YouTube-Content-Partner Anspruch erhoben hat.
-
Der Teil
status
enthält zwei neue Eigenschaften. Videoinhaber können beim Einfügen oder Aktualisieren eines Videos Werte für beide Properties 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 für das Video 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
contentDetails.googlePlusUserId
-Property derchannel
-Ressource gibt die mit dem Kanal verknüpfte Google+ Profil-ID an. Mit diesem Wert kann ein Link zum Google+ Profil generiert werden. -
Für jedes Miniaturbildobjekt werden nun die Breite und Höhe des Bildes angegeben. Miniaturansichten werden derzeit in den Ressourcen
activity
,channel
,playlist
,playlistItem
,search result
,subscription
undvideo
zurückgegeben. -
playlistItems.list
unterstützt jetzt denvideoId
-Parameter. Dieser kann zusammen mit demplaylistId
-Parameter verwendet werden, um nur das Playlist-Element abzurufen, das das angegebene Video darstellt.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 Seite Fehler 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 Methoden und Sprachen, die in der folgenden Liste aufgeführt sind, 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 mithilfe 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
q
-Parameter 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
-
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 der angegebenen Zeit 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 der angegebenen Videokategorie enthalten sind. videoEmbeddable
string
Du kannst die Videosuchergebnisse so filtern, dass nur Videos enthalten sind, die in einem eingebetteten Player auf einer Webseite abgespielt werden können. Setze den Parameterwert auf true
, um nur einzubettende Videos abzurufen.videoSyndicated
string
Filtern Sie die Videosuchergebnisse so, dass nur Videos enthalten sind, die außerhalb von YouTube.com abgespielt werden können. Setzen Sie 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 Attribute aufgeführt:
Ressource Property-Name Wert Beschreibung activity
contentDetails.playlistItem.playlistItemId
string
Die ID des Playlistelements, 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. Außerdem enthält es genau eines von mehreren Attributen –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, die du zum Abspielen der Playlist in einem eingebetteten Player verwenden 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 Zeit, zu der das Video aufgezeichnet wurde, identifizieren oder beschreiben. video
recordingDetails.location
object
Dieses Objekt enthält mit dem Video verknüpfte Standortinformationen. 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 Orts, an dem das Video aufgenommen 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 jetzt Eigenschaften identifiziert, die im Anfragetext angegeben werden müssen oder auf der Grundlage von 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 sind möglicherweise bereits erforderliche und änderbare Attribute aufgeführt.
Methode Attribute activities.insert
Erforderliche Eigenschaften: snippet.description
snippet.description
contentDetails.bulletin.resourceId
playlists.update
Erforderliche Eigenschaften: id
playlistItems.update
Erforderliche Eigenschaften: id
videos.update
Erforderliche Eigenschaften: id
-
Die API meldet keinen
playlistAlreadyExists
-Fehler mehr, wenn du versuchst, eine Playlist zu erstellen oder zu aktualisieren, die denselben Titel wie eine bereits im selben Kanal vorhandene Playlist haben würde. -
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
angegebene 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 wurde nicht gefunden. Verwenden Sie die Methode videoCategories.list, um eine Liste gültiger Werte abzurufen.