Überarbeitungsverlauf

Auf dieser Seite werden Änderungen an der YouTube Data API (v3) und Aktualisierungen der Dokumentation aufgeführt. Änderungsprotokoll abonnieren

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.

. Wenn Ihr Code eine 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 Ressource channel 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 Methode channelSection.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 Ressource channelSection 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 Ressource playlist 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 und playlists.update unterstützen alle einen neuen playlistOperationUnsupported-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 und watchLaterNotAccessible der Methode playlistItems.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
  • Der Filterparameter categoryId der Methode channels.list
  • Die Ressource guideCategories und die Methode guideCategories.list
• Wenn in der API-Anfrage der Parameter managedByMe auf true festgelegt wird, enthalten API-Antworten für die Methode channels.list nicht mehr das Attribut prevPageToken. Diese Änderung wirkt sich weder auf das Attribut prevPageToken bei anderen channels.list-Anfragen noch auf das Attribut nextPageToken bei anderen Anfragen aus.
• Die Attribute contentDetails.relatedPlaylists.watchLater und contentDetails.relatedPlaylists.watchHistory der Ressource channel wurden am 11. August 2016 als verworfen angekündigt. Die Unterstützung der Methoden playlistItems.insert und playlistItems.delete für diese Playlists wurde ebenfalls vollständig eingestellt. Die beiden Properties wurden aus der Dokumentation entfernt.
• Der Parameter mySubscribers der Methode channels.list, der am 30. Juli 2013 als veraltet angekündigt wurde, wurde aus der Dokumentation entfernt. Verwende die Methode subscriptions.list und den zugehörigen Parameter mySubscribers, um eine Liste der Abonnenten des Kanals des authentifizierten Nutzers abzurufen.
• Das invideoPromotion-Objekt der channel-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 Ressource sponsor wurde verworfen. API-Clients sollten Aufrufe an die Methode sponsors.list aktualisieren, um stattdessen die Methode members.list zu verwenden.

  • Die neue membershipsLevel-Ressource identifiziert eine Preisstufe, die von dem Ersteller verwaltet wird, der die API-Anfrage autorisiert hat. Mit der Methode membershipsLevels.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 Methode channels.update festgelegt werden. Bei Videos kann dieses Attribut festgelegt werden, wenn die Methode videos.insert oder videos.update aufgerufen wird.
  
  Dieses Attribut ist nur dann in API-Antworten enthalten, die channel- oder video-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 Property selfDeclaredMadeForKids 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 der channel-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 Domain http anstelle der Domain https 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 Domain http zu laden.

• Hinweis: Diese Mitteilung wird eingestellt.

  Das Attribut recordingDetails.location.altitude der Ressource video 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 der channel-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, wenn channels.list aufgerufen wird, wird ein leeres invideoPromotion oder gar keine invideoPromotion-Daten zurückgegeben.
  • Wenn versucht wird, invideoPromotion-Daten beim Aufrufen von channels.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.

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 in insert- und update-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.

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 und google-auth-oauthlib anstelle der mittlerweile eingestellten oauth2client-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:

  1. Rufen Sie das interaktive Code-Snippet-Tool oder die Dokumentation für eine API-Methode auf, z. B. die Methode channels.list.
  2. Klicken Sie über den Codebeispielen auf den Tab Python.
  3. Klicken Sie auf die Ein/Aus-Schaltfläche über den Tabs, um von der Anzeige eines Snippets zu einem vollständigen Beispiel zu wechseln.
     
  4. 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.
  5. 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.

29. August 2017

Dieses Update enthält die folgenden Änderungen:

• Die Definition des Parameters forContentOwner der Methode search.list wurde aktualisiert. Wenn dieser Parameter auf true gesetzt ist, muss der Parameter type auf video gesetzt werden.
• Die Definition des Parameters regionCode der Methode search.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 generieren videos.insert- und videos.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.

  • recordingDetails.locationDescription
  • recordingDetails.location.latitude
  • recordingDetails.location.longitude

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 oder videos.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 der channel-Ressource enthält eine Liste mit Wikipedia-URLs, die die Inhalte des Kanals beschreiben. Die URLs entsprechen den Themen-IDs, die in der topicDetails.topicIds[]-Eigenschaft der Ressource zurückgegeben werden.
• Die neue contentDetails.videoPublishedAt-Eigenschaft der playlistItem-Ressource gibt den Zeitpunkt an, zu dem das Video auf YouTube veröffentlicht wurde. Die Ressource enthält bereits die Eigenschaft snippet.publishedAt, die den Zeitpunkt angibt, an dem das Element zur Playlist hinzugefügt wurde.
• Wie die channel-Ressource gibt auch die video-Ressource jetzt die Eigenschaft topicDetails.topicCategories[] zurück, die eine Liste von Wikipedia-URLs enthält, die den Inhalt des Videos beschreiben. Bei video-Ressourcen entsprechen die URLs den Themen-IDs, die in der topicDetails.relevantTopicIds[]-Eigenschaft der Ressource zurückgegeben werden.
• Die neue Property contentDetails.contentRating.mpaatRating der video-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 zuvor Entertainment untergeordnet war, wurde entfernt.
• Das Thema Children's music, das zuvor Music 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 Kategorie Sports untergeordnet war, ist jetzt Entertainment untergeordnet.
  • Die Kategorie TV shows, die Entertainment untergeordnet ist, ist neu.
  • Die Kategorie Health, die zuvor „Lifestyle“ untergeordnet war, wurde entfernt.

  Es gibt einige übergeordnete Kategorien (Entertainment, Gaming, Lifestyle, Music und Sports). Jedes Video, das mit einer untergeordneten Kategorie wie Tennis verknüpft ist, wird auch der übergeordneten Kategorie (Sports) zugewiesen.

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- und video-Ressourcen verknüpft sind. Mithilfe des Suchparameters topicId 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 Ressource channel.
  • Das Attribut topicDetails.relevantTopicIds[] der Ressource video.
  • Der Parameter topicId der Methode search.list.

• Hinweis: Diese Mitteilung wird eingestellt.

  Die folgenden Attribute werden eingestellt:

  • Das Attribut topicDetails.topicIds[] der Ressource channel. Diese Property wird bis zum 10. November 2017 unterstützt.
  • Das Attribut topicDetails.relevantTopicIds[] der Ressource video. Diese Property wird bis zum 10. November 2017 unterstützt.
  • Das Attribut topicDetails.topicIds[] der Ressource video. Diese Property enthält nach dem 10. Februar 2017 keine Werte. Nach diesem Datum werden durch den Eigenschaftswert topicDetails.relevantTopicIds[] alle Themen ermittelt, die mit einem Video verknüpft sind.

• 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 Eigenschaften player.embedHeight und player.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 Parameter maxHeight oder maxWidth 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 Parameter maxHeight und maxWidth. Beim Abrufen des player-Teils in video-Ressourcen können Sie einen oder beide Parameter verwenden.

    Standardmäßig beträgt die Höhe von <iframe>, die in der Eigenschaft player.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 Parameter maxHeight oder maxWidth nicht festgelegt ist.

    • Wenn der maxHeight-Parameter auf 720 gesetzt ist, der maxWidth-Parameter aber nicht, gibt die API einen Player mit einer Größe von 1280 × 720 zurück.
    • Wenn der maxWidth-Parameter auf 960 gesetzt ist, der maxHeight-Parameter aber nicht, gibt die API einen Player mit einer Größe von 960 × 540 Pixeln zurück.
    • Wenn der Parameter maxWidth auf 960 und der Parameter maxHeight auf 450 gesetzt sind, gibt die API einen Player mit einer Größe von 800 × 450 zurück.

    Die oben beschriebenen neuen Eigenschaften player.embedHeight und player.embedWidth geben die Abmessungen des Players an.

• Ä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 der channelSection-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 der i18nLanguage-Ressource wurde so korrigiert, dass der Wert den Namen einer Sprache darstellt, wie er in der Sprache geschrieben ist, die durch den Parameter hl der Methode i18nLanguage.list angegeben wird.

  • Das Attribut contentDetails.note der Ressource playlistItem wurde aktualisiert. Die maximale Länge des Attributwerts beträgt 280 Zeichen.

  • Die Attribute contentDetails.startAt und contentDetails.endAt der Ressource playlistItem wurden eingestellt. Diese Felder werden ignoriert, wenn sie in playlistItems.insert- oder playlistItems.update-Anfragen festgelegt sind.

  • Die Methoden playlistItems.delete und playlistItems.update unterstützen jetzt den Parameter onBehalfOfContentOwner, 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 Bereich https://www.googleapis.com/auth/youtubepartner bietet.

  • Die Parameter publishedBefore und publishedAfter der Methode search.list wurden aktualisiert, um anzugeben, dass die Parameterwerte eingeschlossen sind. Wenn beispielsweise der Parameter publishedBefore festgelegt ist, gibt die API Ressourcen zurück, die vor oder zum angegebenen Zeitpunkt erstellt wurden.

  • Das Attribut contentDetails.contentRating.grfilmRating der Ressource video unterstützt drei zusätzliche Werte: grfilmK12, grfilmK15 und grfilmK18.

  • 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 Parameter home in einer nicht autorisierten Anfrage auf true gesetzt haben.
    invalidValue (400)	invalidContentDetails	Die Methode playlistItems.insert gibt diesen Fehler zurück, um anzugeben, dass das contentDetails-Objekt in der Anfrage ungültig ist. Ein Grund für diesen Fehler ist, dass das Feld contentDetails.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 und contentDetails.relatedPlaylists.watchLater der Ressource channel in einer Antwort enthalten sind, immer die Werte HL 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 Parameter home auf true 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 und contentDetails.relatedPlaylists.watchLater der Ressource channel enthalten jetzt für alle Channels die entsprechenden Werte HL und WL.

    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 und WL, 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 Werte HL und WL 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 der video-Ressource und ihre untergeordneten Eigenschaften werden nicht mehr zurückgegeben. Bisher konnten diese Daten (wie das übergeordnete fileDetails-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 der channel-Ressource gibt die mit dem Kanal verknüpften Themen an.
  • Der topicDetails-Teil der video-Ressource identifiziert die mit dem Video verknüpften Themen.
  • Mit dem Parameter topicId der Methode search.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.

• Ab dem 12. September 2016 werden einige API-Felder und -Parameter eingestellt:

  • Der Parameter home der Methode activities.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 und contentDetails.relatedPlaylists.watchLater der Ressource channel sind nur für einen autorisierten Nutzer sichtbar, der Daten über den Kanal des Nutzers abruft. Nach dem 12. September 2016 gibt contentDetails.relatedPlaylists.watchHistory den Wert HL und die Property contentDetails.relatedPlaylists.watchLater für alle Channels den Wert WL 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 der video-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 übergeordnete fileDetails-Objekt nur von einem Videoinhaber abgerufen werden kann.

13. Juni 2016

Dieses Update enthält die folgenden Änderungen:

• Das Attribut contentDetails.googlePlusUserId der Ressource channel 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 in channel-Ressourcen enthalten.

• Das Attribut snippet.authorGoogleplusProfileUrl der Ressource comment 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 in comment-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 Methode subscriptions.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.

• Die Definition des Parameters part der Methode channelSection.list wurde aktualisiert. Der targeting-Teil kann nun zu einem Preis von 2 Kontingenteinheiten abgerufen werden.

• Die Methode videos.list gibt jetzt einen verbotenen (403) Fehler zurück, wenn eine nicht ordnungsgemäß autorisierte Anfrage versucht, die Teile fileDetails, processingDetails oder suggestions einer video-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 der video-Ressource gibt das Projektionsformat des Videos an. Gültige Attributwerte sind 360 und rectangular.

• Die Attribute recordingDetails.location und fileDetails.recordingLocation der Ressource video 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 Definition der contentDetails.relatedPlaylists.favorites-Eigenschaft der channel-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 Methode comments.insert, comments.update, commentThreads.insert oder commentThreads.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 Methode channels.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 der channel-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 der channel-Ressource und alle untergeordneten Attribute wurden eingestellt.

  • Die API-Antwort auf eine search.list-Anfrage enthält jetzt ein regionCode-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 ist US. 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 und snippet.secondaryReasons[].label der videoAbuseReportReason-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 Parameter hl, der die Sprache angibt, die für den Labeltext in der API-Antwort verwendet werden soll. Der Standardwert für den Parameter ist en_US.

  • Die neue Property contentDetails.contentRating.ecbmctRating der video-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 der video-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 Ressource video unterstützt den neuen Attributwert legal.

• Die API unterstützt die folgenden neuen Fehler:

  Fehlertyp	Fehlerdetails	Beschreibung
  badRequest (400)	notEditable	Die Methoden channelSections.insert, channelSections.update und channelSections.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 und channelSections.update geben diesen Fehler zurück, um anzugeben, dass die in der API-Anfrage gesendete Ressource channelSection einen Wert für das Attribut snippet.style enthalten muss.
  badRequest (400)	typeRequired	Die Methoden channelSections.insert und channelSections.update geben diesen Fehler zurück, um anzugeben, dass die in der API-Anfrage gesendete Ressource channelSection einen Wert für das Attribut snippet.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 der commentThread-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 Parameter videoId angegebene Video Kommentare deaktiviert sind.
  badRequest (400)	commentTextTooLong	Die Methode commentThreads.insert gibt diesen Fehler zurück, um anzugeben, dass die eingefügte Ressource comment zu viele Zeichen im Attribut snippet.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 Eigenschaft snippet.categoryId in der hochgeladenen Ressource vom Typ video eine ungültige Kategorie-ID angegeben hat. Verwenden Sie die Methode videoCategories.list, um unterstützte Kategorien abzurufen.
  badRequest (400)	invalidDescription	Die Methode videos.update gibt diesen Fehler zurück, um anzugeben, dass das Attribut snippet.description in der hochgeladenen Ressource vom Typ video einen ungültigen Wert angegeben hat.
  badRequest (400)	invalidPublishAt	Die Methode videos.update gibt diesen Fehler zurück, um anzugeben, dass für das Attribut status.publishAt in der hochgeladenen Ressource vom Typ video 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 das recordingDetails-Objekt in der hochgeladenen video-Ressource ungültige Aufnahmedetails angegeben wurden.
  badRequest (400)	invalidTags	Die Methode videos.update gibt diesen Fehler zurück, um anzugeben, dass das Attribut snippet.tags in der hochgeladenen Ressource vom Typ video einen ungültigen Wert angegeben hat.
  badRequest (400)	invalidTitle	Die Methode videos.update gibt diesen Fehler zurück, um anzugeben, dass die snippet.title-Eigenschaft in der hochgeladenen video-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 den snippet-Teil einer video-Ressource aktualisiert, aber keinen Wert für die Attribute snippet.title und snippet.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 oder update 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 Attribute snippet.title und snippet.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 Eigenschaft snippet.defaultLanguage auf en.

    Hinweis zum Aktualisieren von channel-Ressourcen:Wenn Sie das Attribut snippet.defaultLanguage für eine channel-Ressource festlegen möchten, müssen Sie das Attribut brandingSettings.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 deine channels.list-, channelSections.list-, playlists.list- oder videos.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 das snippet.localized-Objekt der Ressource die lokalisierten Werte. Wenn jedoch keine lokalisierten Details verfügbar sind, enthält das snippet.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 Parameter hl auf de 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 auf fr gesetzt, würde das snippet.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 Parameter hl 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 den localizations-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 Parameterwert part 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 Attribut snippet.defaultLanguage für diese Ressource nicht festgelegt ist. Die Methoden channels.update, channelSections.insert, channelSections.update, playlists.insert, playlists.update, videos.insert und videos.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 Methoden channels.update, channelSections.insert, channelSections.update, playlists.insert und playlists.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 Methode search.list wurde aktualisiert. Wenn Sie Liveübertragungen nach viewCount sortieren, werden die API-Ergebnisse nach der Anzahl der gleichzeitigen Zuschauer der Broadcasts sortiert, während die Broadcasts noch laufen.

  • Der Parameter relatedToVideoId der Methode search.list wurde aktualisiert. Wenn er festgelegt ist, werden nur noch die anderen unterstützten Parameter part, maxResults, pageToken, regionCode, relevanceLanguage, safeSearch, type (muss auf video gesetzt sein) und fields sind. Diese Aktualisierung spiegelt keine Änderung des API-Verhaltens wider.

  • Die Definition der snippet.publishedAt-Eigenschaft der video-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 der video-Ressource wurde aktualisiert:

    • Wenn du den Wert dieser Eigenschaft beim Aufrufen der videos.update-Methode festlegst, musst du auch den status.privacyStatus-Eigenschaftswert auf private 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 der privacyStatus des Videos von private zu public.

  • Die Eigenschaft contentDetails.contentRating.cncRating der video-Ressource gibt die Bewertung des Videos gemäß der französischen Klassifikationskommission der Kinematografie der französischen Kommission an. Dieses Attribut ersetzt das Attribut contentDetails.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 keine thumbnail-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 Methode activities.list derzeit keine Ressourcen für neue Videokommentare enthält. Die snippet.type und contentDetails.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 Attribut snippet.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/oder locationRadius 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 Ressource video 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 auf 0 festgelegt.

7. August 2015

Dieses Update enthält die folgenden Änderungen:

• Aktualisierungen für vorhandene Ressourcen und Methoden

  • Die Definition des Attributs snippet.tags[] der video-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 Parameter shareOnGooglePlus 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 Methode commentThreads.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 der video-Ressource gibt die Sprache an, die im Standard-Audiotrack des Videos gesprochen wird.

  • Die Definition der Eigenschaft contentDetails.licensedContent der video-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 und captions.update unterstützen jetzt den Parameter onBehalfOfContentOwner, 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 Bereich https://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 und subscriptions.insert unterstützen die Fehler accountClosed und accountSuspended 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 Methode videoAbuseReportReasons.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 beschriebene videoAbuseReportReason.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 der search.list-Methode schränkt die Suche auf Videos ein, die über die Anwendung oder Website des Entwicklers hochgeladen wurden. Der forDeveloper-Parameter kann in Verbindung mit optionalen Suchparametern wie dem q-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 auf true 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 der channel-Ressource können Kanalinhaber ihre Kanäle mit einem bestimmten Land verknüpfen.

    Hinweis: Wenn Sie das Attribut snippet.country für eine channel-Ressource festlegen möchten, müssen Sie das Attribut brandingSettings.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 der video-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 und videos.delete wurde korrigiert, sodass alle diese Methoden bei Erfolg den HTTP-Antwortcode 204 (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 und channelSections.update geben diesen Fehler zurück, wenn die eingefügte Ressource channelSection einen ungültigen Wert für das Attribut targeting.countries[] enthält.
    badRequest (400)	targetInvalidLanguage	Die Methoden channelSections.insert und channelSections.update geben diesen Fehler zurück, wenn die eingefügte Ressource channelSection einen ungültigen Wert für das Attribut targeting.languages[] enthält.
    badRequest (400)	targetInvalidRegion	Die Methoden channelSections.insert und channelSections.update geben diesen Fehler zurück, wenn die eingefügte Ressource channelSection einen ungültigen Wert für das Attribut targeting.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 Eigenschaft snippet.parentId angegebenen Kommentar der obersten Ebene einfügen kann. In einer commentThread-Ressource gibt das Attribut snippet.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 Parameter channelId 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 Fehler invalidMetadata und videoNotFound 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 und comment 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. Eine commentThread-Ressource kann Kommentare zu einem Video oder Kanal darstellen.

    Der Kommentar der obersten Ebene und die Antworten sind comment-Ressourcen, die in der commentThread-Ressource verschachtelt sind. Wichtig: Die Ressource commentThread enthält nicht unbedingt alle Antworten auf einen Kommentar. Du musst die Methode comments.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 Methode comments.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. Eine comment-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 Methoden comments.insert, comments.update, comments.markAsSpam, comments.setModerationStatus, comments.delete, commentThreads.insert und commentThreads.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 der https://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 Parameter rating 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 Methode subscriptions.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 Bereich https://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:

  • Videos melden

• 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 Parameterwert home auf true.

    In der API-Antwort entspricht eine Ressource einem empfohlenen Video, wenn der Wert der snippet.type-Eigenschaft recommendation ist. In diesem Fall enthalten die Properties contentDetails.recommendation.reason und contentDetails.recommendation.seedResourceId Informationen dazu, warum das Video empfohlen wurde. Es gibt keine Garantie, dass die Antwort eine bestimmte Anzahl von empfohlenen Videos enthält.

  • Kanalvorschläge abrufen

  • 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 Parameterwert home auf true setzt.

    In der API-Antwort entspricht eine Ressource einem neuen Abovideo, wenn der Wert der snippet.type-Eigenschaft upload ist. Es gibt keine Garantie, dass die Antwort eine bestimmte Anzahl neuer Abovideos enthält.

  • Unterstützung für RSS-Feeds

  • 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 und videos.list der API V3 unterstützen alle den Parameter id, 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 und channelSections.update unterstützen jetzt den Parameter onBehalfOfContentOwner, 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 der video-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 Parameter id der Anfrage einen Kanal angibt, der nicht gefunden werden kann.
  badRequest (400)	manualSortRequiredinvalidValue	Die Methoden playlistItems.insert und playlistItems.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 das snippet.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 Parameter channelId der Anfrage einen geschlossenen Kanal angibt.
  forbidden (403)	channelSuspended	Die Methode playlists.list gibt diesen Fehler zurück, wenn der Parameter channelId der Anfrage einen gesperrten Kanal angibt.
  forbidden (403)	playlistForbidden	Die Methode playlists.list gibt diesen Fehler zurück, wenn der Parameter id 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 Parameter channelId der Anfrage einen Kanal angibt, der nicht gefunden werden kann.
  notFound (404)	playlistNotFound	Die Methode playlists.list gibt diesen Fehler zurück, wenn der Parameter id der Anfrage eine Playlist angibt, die nicht gefunden werden kann.
  notFound (404)	videoNotFound	Die Methode videos.list gibt diesen Fehler zurück, wenn der Parameter id 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 Parameter rating enthält.

2. März 2015

Dieses Update enthält die folgenden Änderungen:

• Die Methode search.list unterstützt jetzt den Parameter relevanceLanguage, 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 nach GoogleDevelopers.

  • Kontingentkosten: 6 Einheiten

    Rufe die Methode channels.list auf, um die richtige Kanal-ID zu ermitteln. Legen Sie den Parameter forUsername auf GoogleDevelopers und den Parameter part auf contentDetails fest. In der API-Antwort gibt die Eigenschaft contentDetails.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 Parameter playlistId auf die erfasste ID und den Parameter part auf snippet.

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 und snippet.categoryId der Ressource video wurden aktualisiert, um zu verdeutlichen, wie die API Aufrufe der Methode videos.update verarbeitet. Wenn Sie diese Methode aufrufen, um den snippet-Teil einer video-Ressource zu aktualisieren, müssen Sie für beide Attribute einen Wert festlegen.

  Wenn Sie versuchen, den snippet-Teil einer video-Ressource zu aktualisieren und keinen Wert für beide Attribute festlegen, gibt die API den Fehler invalidRequest zurück. Die Beschreibung dieses Fehlers wurde ebenfalls aktualisiert.

• Die Property contentDetails.contentRating.oflcRating der video-Ressource, die die Bewertung eines Videos durch das neuseeländische Office of Film and Literature Classification identifiziert, unterstützt jetzt zwei neue Bewertungen: oflcRp13 und oflcRp16. Sie entsprechen den Bewertungen RP13 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 Methode subscriptions.insert verursacht beispielsweise Kontingentkosten von etwa 50 Einheiten. Die Ressource subscription besteht außerdem aus drei Teilen (snippet, contentDetails und subscriberSnippet), 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 Parameter location und locationRadius, 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 der channel-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 Fehler tooManyPromotedItems mit dem HTTP-Statuscode 400 zurück.

• Die Ressource channelSection kann jetzt Informationen zu einigen neuen Arten von empfohlenen Inhalten enthalten. Das Attribut snippet.type der Ressource channelSection unterstützt jetzt die folgenden Werte:

  • postedPlaylists: Playlists, die der Kanalinhaber im Aktivitätsfeed des Kanals gepostet hat
  • postedVideos: Videos, die der Kanalinhaber im Aktivitätsfeed des Kanals gepostet hat
  • subscriptions: Kanäle, die der Kanalinhaber abonniert hat

• Die neue Property contentDetails.contentRating.ifcoRating der video-Ressource gibt die Bewertung an, die ein Video vom Irish Film Classification Office erhalten hat.

• Die Definition der position.cornerPosition-Eigenschaft der watermark-Ressource wurde aktualisiert, um zu beachten, dass das Wasserzeichen immer oben rechts im Player angezeigt wird.

• Die Definition des q-Parameters für die search.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 einen search.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 Attributwerte nextPageToken und prevPageToken, um zu bestimmen, ob Paginierungslinks angezeigt werden sollen.

• Die Methoden watermarks.set und watermarks.unset wurden aktualisiert, um zu berücksichtigen, dass die API bei erfolgreichen Anfragen an diese Methoden den HTTP-Antwortcode 204 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 wie videoCategories.list und guideCategories.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 wie search.list, videos.list, activities.list und videoCategories.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 der video-Ressource wurde aktualisiert, um zu verdeutlichen, dass dieses Objekt nur zurückgegeben wird, wenn die processingDetails.fileDetailsAvailability-Eigenschaft des Videos den Wert available hat.

  Auch die Definition des suggestions-Objekts der video-Ressource wurde aktualisiert, um zu erklären, dass das Objekt nur zurückgegeben wird, wenn die processingDetails.tagSuggestionsAvailability-Eigenschaft des Videos oder die processingDetails.editorSuggestionsAvailability-Eigenschaft des Videos den Wert available hat.

• Die Dokumentation für die Methoden videos.insert und videos.update wurde aktualisiert, sodass klar wird, dass beim Aufrufen dieser Methoden die Eigenschaft status.publishAt festgelegt werden kann.

• Die Definition des invideoPromotion-Objekts der channel-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 Parameter onBehalfOfContentOwner nicht unterstützt. Dabei handelte es sich um einen Dokumentationsfehler, da videos.rate-Anfragen, die diesen Parameter festlegen, einen 500-Fehler zurückgeben.

31. März 2014

Dieses Update enthält die folgenden Änderungen:

• Mit der neuen status.publishAt-Eigenschaft der video-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 Videos private 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ür channel-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 Ressource channel 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:

  • recordingDetails.locationDescription
  • recordingDetails.location.latitude
  • recordingDetails.location.longitude
  • recordingDetails.recordingDate

• 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, den brandingSettings-Teil eines Kanals zu aktualisieren und den Wert der Eigenschaft brandingSettings.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 Eigenschaft invideoPromotion.items[].id.recentlyUploadedBy eine ungültige Kanal-ID angibt.
  badRequest (400)	invalidTimingOffset	Die Methode channels.update gibt diesen Fehler zurück, wenn der invideoPromotion-Teil einen ungültigen Zeitversatz angibt.
  badRequest (400)	tooManyPromotedItems	Die Methode channels.update gibt diesen Fehler zurück, wenn der invideoPromotion-Teil mehr als die zulässige Anzahl von beworbenen Artikeln angibt.
  forbidden (403)	promotedVideoNotAllowed	Die Methode channels.update gibt diesen Fehler zurück, wenn die invideoPromotion.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 Eigenschaft invideoPromotion.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 ein invideoPromotion.items[].timing-Objekt angegeben werden.
  required (400)	requiredWebsiteUrl	Bei der Methode channels.update muss für jeden beworbenen Artikel eine invideoPromotion.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 Parameters type auf video 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 des brandingSettings.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.

• Die Methode channels.update unterstützt jetzt Aktualisierungen der Eigenschaft invideoPromotion.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 Parameter onBehalfOfContentOwner gestellt wird.

• Die Methoden playlistItems.list und playlistItems.insert unterstützen jetzt den Parameter onBehalfOfContentOwner, 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 und contentDetails.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 der videoCategory-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 sind upcoming, active und none.

  • Die neue Eigenschaft snippet.liveBroadcastContent der Ressource video 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 der video-Ressource ist ein Objekt, das Metadaten zu einer Live-Videoübertragung enthält. Zum Abrufen dieser Metadaten nehmen Sie liveStreamingDetails in die Liste der Ressourcenteile für den Parameterwert part 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 Übertragung active 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 Parameterwert part ein, wenn Sie die Methode videos.list, videos.insert oder videos.update aufrufen.

  Am 1. Oktober 2013 wurden zwei weitere Funktionen zur Identifizierung von Liveübertragungen veröffentlicht: der Parameter eventType der Methode search.list und die Eigenschaft snippet.liveBroadcastContent des Suchergebnisses.

• Die Methode videos.insert unterstützt jetzt den Parameter notifySubscribers, der angibt, ob YouTube eine Benachrichtigung über das neue Video an Nutzer senden soll, die den Kanal des Videos abonnieren. Der Standardwert des Parameters lautet True. Dies bedeutet, dass Abonnenten über neu hochgeladene Videos benachrichtigt werden. Ein Kanalinhaber, der viele Videos hochlädt, sollte den Wert jedoch auf False 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 Attribute invideoPromotion.items[].customMessage und invideoPromotion.items[].websiteUrl. Außerdem wurde die Liste geändert, um die brandingSettings-Attribute zu identifizieren, die geändert werden können. Diese brandingSettings-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 und playlists.delete unterstützen jetzt den Parameter onBehalfOfContentOwner, der bereits für einige andere Methoden unterstützt wird.

• Die Methode playlists.insert unterstützt jetzt den Parameter onBehalfOfContentOwnerChannel, der bereits für mehrere andere Methoden unterstützt wird.

• Das Attribut contentDetails.contentRating.tvpgRating der Ressource video unterstützt jetzt den Wert pg14, was der Bewertung TV-14 entspricht.

• Die Definition der snippet.liveBroadcastContent-Eigenschaft, die Teil der Suchergebnisse ist, wurde korrigiert. Sie bedeutet nun, dass live ein gültiger Attributwert, active aber kein gültiger Eigenschaftswert ist.

• Das Attribut contentDetails.contentRating.mibacRating der Ressource video 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 der channel-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 Parameter onBehalfOfContentOwner.

1. Oktober 2013

Dieses Update enthält die folgenden Änderungen:

• Das neue auditDetails-Objekt der channel-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 Bereich https://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 der channel-Ressource unterstützt jetzt den Wert recentUpload. 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 sind upcoming, active und none.

  • Bei einer video-Ressource gibt der Wert upcoming an, dass das Video eine Liveübertragung ist, die noch nicht gestartet wurde. Der Wert active gibt an, dass das Video eine laufende Liveübertragung ist.
  • Bei einer channel-Ressource gibt der Wert upcoming an, dass auf dem Kanal eine geplante Übertragung noch nicht begonnen hat. Der Wert acive gibt an, dass auf dem Kanal gerade eine Liveübertragung läuft.

• In der Ressource watermark wurde das Attribut targetChannelId 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 die targetChannelId-Eigenschaft jetzt diesen Wert selbst an. Dementsprechend wurde das Attribut targetChannelId.value der Ressource entfernt.

• Die Methode thumbnails.set unterstützt jetzt den Parameter onBehalfOfContentOwner, der bereits für mehrere andere Methoden unterstützt wird.

• Die Methode search.list unterstützt jetzt den Parameter eventType, 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 Methode watermarks.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 und watermarks.unset unterstützt.

• Die neue statistics.hiddenSubscriberCount-Eigenschaft der channel-Ressource enthält einen booleschen Wert, der angibt, ob die Anzahl der Abonnenten des Kanals ausgeblendet ist. Daher lautet der Wert der Eigenschaft false, wenn die Abonnentenzahl des Kanals öffentlich sichtbar ist.

• Die Methode playlists.list unterstützt jetzt die Parameter onBehalfOfContentOwner und onBehalfOfContentOwnerChannel. Beide Parameter werden bereits für einige andere Methoden unterstützt.

• Die Methode videos.list unterstützt jetzt den Parameter regionCode, der den Inhaltsbereich angibt, für den ein Diagramm abgerufen werden soll. Dieser Parameter kann nur in Verbindung mit dem Parameter chart 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 der channel-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 auf website und verwenden Sie das neue Attribut invideoPromotion.items[].id.websiteUrl, um die URL anzugeben. Mit der neuen Eigenschaft invideoPromotion.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 in invideoPromotion.items[].timing verschoben. Mit diesem Objekt kannst du jetzt die Zeitangaben für jedes beworbene Element in der invideoPromotion.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 Objekt invideoPromotion.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. Das invideoPromotion.defaultTiming-Objekt enthält auch ein durationMs-Feld, das die Standarddauer angibt, die der beworbene Artikel angezeigt wird.

  • Die Properties invideoPromotion.items[].type und invideoPromotion.items[].videoId wurden in das invideoPromotion.items[].id-Objekt verschoben.

• Die Methode subscriptions.list unterstützt jetzt die Parameter onBehalfOfContentOwner und onBehalfOfContentOwnerChannel. Beide Parameter werden bereits für einige andere Methoden unterstützt.

• In der API-Antwort auf eine thumbnails.set-Anfrage hat sich der Attributwert kind von youtube#thumbnailListResponse zu youtube#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 Methode videos.rate verarbeitet wird.

• In error documentation wird der folgende neue Anfragekontextfehler beschrieben, der bei jeder API-Methode auftreten kann, die den Anfrageparameter mine 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 den mine-Parameter entfernen, dich durch Entfernen des onBehalfOfContentOwner-Parameters als YouTube-Nutzer authentifizieren oder als einer der Kanäle des Partners agieren, indem du den Parameter onBehalfOfContentOwnerChannel 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 Attributs kind von youtube#channelBannerInsertResponse zu youtube#channelBannerResource geändert. Diese Ressource wird als Antwort auf eine channelBanners.insert-Anfrage zurückgegeben.

• Die neue brandingSettings.channel.profileColor-Eigenschaft der channel-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 der subscription-Ressource gibt die Arten von Aktivitäten an, über die der Abonnent benachrichtigt wird. Gültige Attributwerte sind all und uploads.

• 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 ist mostPopular der einzige unterstützte Wert. Beachten Sie, dass der chart-Parameter ein Filterparameter ist. Er kann also nicht in derselben Anfrage wie andere Filterparameter (id und myRating) 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 Parameter chart verwendet werden. Standardmäßig sind Diagramme nicht auf eine bestimmte Kategorie beschränkt.

• Die neue topicDetails.relevantTopicIds[]-Eigenschaft der video-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 Ressource video wurde in recordingDetails.location.altitude umbenannt und das Attribut fileDetails.recordingLocation.location.elevation wurde in fileDetails.recordingLocation.location.altitude umbenannt.

• Das contentDetails.contentRating-Objekt der video-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 der video-Ressource werden Inhalte mit Altersbeschränkung angegeben. Der Wert der Eigenschaft ist ytAgeRestricted, 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 Methode channels.list wurde eingestellt. Verwende die Methode subscriptions.list und den zugehörigen Parameter mySubscribers, um eine Liste der Abonnenten des Kanals des authentifizierten Nutzers abzurufen.

• Die Methoden channelBanners.insert, channels.update, videos.getRating und videos.rate unterstützen jetzt den Parameter onBehalfOfContentOwner. 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 Objekt brandingSettings der Ressource channel 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 das invideoPromotion-Objekt der channel-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 Parameter onBehalfOfContentOwnerChannel 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 Attributs id im Anfragetext korrekt ist.

10. Juni 2013

Dieses Update enthält die folgenden Änderungen:

• Mit dem neuen Parameter forUsername der Methode channels.list können Sie Informationen über einen Kanal abrufen, indem Sie dessen YouTube-Nutzernamen angeben.

• Die Methode activities.list unterstützt jetzt den Parameter regionCode, 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 Methoden playlists.insert oder playlists.update aufrufen.

• Der Parameter onBehalfOfContentOwner, der zuvor für die Methoden channels.list und search.list unterstützt wurde, wird jetzt auch für die Methoden videos.insert, videos.update und videos.delete unterstützt. Wenn dieser Parameter in einem Aufruf der videos.insert-Methode verwendet wird, muss die Anfrage auch einen Wert für den neuen onBehalfOfContentOwnerChannel-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 Parameter onBehalfOfContentOwner 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 Parameter home verwendet, aber nicht ordnungsgemäß autorisiert ist.

• Das Attribut invideoPromotion.channelId wurde aus der Ressource channels entfernt, da die Kanal-ID bereits mit dem Attribut id 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 Eigenschaft brandingSettings.image.bannerExternalUrl der Ressource channel 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 wird unspecified nicht mehr als gültiger Attributwert für die Attribute suggestions.processingErrors[], suggestions.processingHints[], suggestions.processingWarnings[] und suggestions.editorSuggestions[] aufgeführt.

• Der Parameter maxResults der Methode videos.list hat jetzt den Standardwert 5.

• error documentation listet jetzt Fehler für die Methoden channelBanners.insert und subscriptions.list auf. Außerdem werden mehrere neue Fehler für die Methode channels.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 Parameterwert part in einer channels.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 Teils invideoPromotion der Ressource channel 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 Methode videos.list können Sie eine Liste der Videos abrufen, die der authentifizierte Nutzer mit der Bewertung like oder dislike bewertet hat.

  Der myRating-Parameter und der id-Parameter werden nun als Filterparameter betrachtet, d. h., in einer API-Anfrage muss genau einer der Parameter angegeben werden. Bisher war der Parameter id 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 Methode videos.list aktualisiert, um die Paginierung zu unterstützen. Seitenparameter werden jedoch nur für Anfragen mit dem Parameter myRating unterstützt. (Paging-Parameter und -Informationen werden für Anfragen mit dem id-Parameter nicht unterstützt.)

  • Der Parameter maxResults gibt die maximale Anzahl von Videos an, die die API in der Ergebnismenge zurückgeben kann. Der Parameter pageToken identifiziert eine bestimmte Seite in der Ergebnismenge, die Sie abrufen möchten.

  • Die Ressource youtube#videoListResponse, die als Antwort auf eine videos.list-Anfrage zurückgegeben wird, enthält jetzt das Objekt pageInfo, das Details wie die Gesamtzahl der Ergebnisse und die Anzahl der im aktuellen Ergebnissatz enthaltenen Ergebnisse enthält. Die Ressource youtube#videoListResponse kann auch die Attribute nextPageToken und prevPageToken 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 auf true, um YouTube anzuweisen, Beleuchtung und Farbe des Videos automatisch zu optimieren.
  • stabilize: Wenn du diesen Parameterwert auf true setzt, weist YouTube das Video an, indem verwackelte Elemente infolge von Kamerabewegungen beseitigt werden.

• Das Attribut channelTitle wurde dem snippet 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 Methode subscriptions.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 Methode channels.list unterstützt wird. Dieser Parameter wird eingestellt.

• In einer video-Ressource ist der Attributwert unspecified für keines der folgenden Attribute mehr möglich:

  • fileDetails.fileType
  • fileDetails.videoStreams[].rotation
  • processingDetails.processingStatus
  • processingDetails.processingFailureReason
  • fileDetails.fileType

• API-Anfragen, die einen unerwarteten Parameter enthalten, geben jetzt den Fehler badRequest zurück. Der gemeldete Grund für den Fehler ist unexpectedParameter.

• 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 als forbidden-Fehler gemeldet. Die Fehlerursache ist playlistContainsMaximumNumberOfVideos.

19. April 2013

Dieses Update enthält die folgenden Änderungen:

• Mit der neuen videos.rate-Methode können Nutzer eine like- oder dislike-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 der channel-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. Die status.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 auf false gesetzt ist. Sie können den Wert dieses Attributs festlegen, wenn Sie die Methode videos.insert oder videos.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 Attribut snippet.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 Methode videoCategories.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 Methoden videos.update und videos.delete entfernt.

12. März 2013

Dieses Update enthält die folgenden Änderungen:

• Das Attribut channelTitle wurde dem snippet 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 der video-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 Fehler invalidSnippet 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 und videos.update unterstützen diesen Parameter alle.

  • Der von der Methode channels.list unterstützte managedByMe-Parameter weist die API an, alle Kanäle des Rechteinhabers zurückzugeben, die mit dem Parameter onBehalfOfContentOwner angegeben sind.

  • Der von der Methode search.list unterstützte forContentOwner-Parameter weist die API an, Suchergebnisse auf Ressourcen zu beschränken, die dem Rechteinhaber gehören, der im onBehalfOfContentOwner-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- und suggestions-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 sind creativeCommon und youtube.

• Die Definition des Parameters part wurde für die Methoden videos.list, videos.insert und videos.update aktualisiert, um die oben beschriebenen neu hinzugefügten Teile sowie den Teil recordingDetails aufzulisten, der versehentlich weggelassen wurde.

• Die neue contentDetails.googlePlusUserId-Property der channel-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 und video zurückgegeben.

• playlistItems.list unterstützt jetzt den videoId-Parameter. Dieser kann zusammen mit dem playlistId-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 Ressource channel wurde entfernt. Das Attribut id 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 – Java
  • playlistItems.insert – Python
  • playlistItems.list: Java, JavaScript, PHP, Python, Ruby
  • playlists.insert: Java, JavaScript, Python
  • search.list: Java, JavaScript, Python, Ruby
  • videos.insert – Java

• Eine activity-Ressource kann jetzt eine channelItem-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 in relatedToVideoId umbenannt.
  • Der Parameter published wurde durch die beiden neuen Parameter publishedAfter und publishedBefore ersetzt, die unten beschrieben werden.

• 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 Wert channelItem 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 eine kind-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 und public.
  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 Anpassbare Eigenschaften: 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.