Überarbeitungsverlauf

Auf dieser Seite findest du Änderungen an der YouTube Data API (Version 3) und Aktualisierungen der Dokumentation. Abonniere diese Änderungsliste.

26. März 2025

Ab dem 31. März 2025 ändert YouTube die Art und Weise, wie Shorts-Aufrufe gezählt werden. Bisher wurde bei Kurzvideos ein Aufruf erst erfasst, wenn ein Kurzvideo eine bestimmte Zeit lang abgespielt wurde. Die Anzahl der Aufrufe entspricht dann der Anzahl der Wiedergaben oder wiederholten Wiedergaben eines Shorts. Die Wiedergabezeit ist dabei unerheblich. Weitere Informationen

Ab dem 31. März 2025 werden in den folgenden Feldern der Data API die Aufrufzahlen für Kurzvideos gemäß dieser Änderung zurückgegeben:

• channels.statistics.viewCount
• videos.statistics.viewCount

30. Oktober 2024

Die API unterstützt jetzt die Identifizierung von Videos, die realistische veränderte oder synthetische (A/S) Inhalte enthalten. Weitere Informationen zu den YouTube-Richtlinien zu Inhalten mit Altersfreigabe

Beispiele für solche Inhalte sind Videos, in denen:

• Wirkt, als ob eine echte Person darin etwas sagt oder tut, was sie nicht gesagt oder getan hat
• veränderte Aufnahmen eines realen Ereignisses oder Orts enthalten
• Es enthält eine realistisch anmutende Szene, die nicht wirklich stattgefunden hat.

Um anzugeben, ob ein Video Inhalte mit Altersfreigabe enthält, legen Sie die Property status.containsSyntheticMedia fest. Diese Eigenschaft kann beim Aufrufen der Methoden videos.insert oder videos.update festgelegt werden. Wenn festgelegt, wird die Property in der Ressource video zurückgegeben.

30. April 2024

Hinweis:Dies ist eine Ankündigung zur Einstellung.

Dieses Update enthält die folgenden Änderungen:

Die API unterstützt nicht mehr das Einfügen oder Abrufen von Kanaldiskussionen. Diese Änderung entspricht der Funktionsweise auf der YouTube-Website, auf der das Posten von Kommentaren auf Kanälen nicht möglich ist.

13. März 2024

Hinweis:Dies ist eine Ankündigung zur Einstellung.

Dieses Update enthält die folgenden Änderungen:

Der Parameter sync für die Methoden captions.insert und captions.update wurde 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 Untertitelspuren Timinginformationen angeben, da der Upload sonst fehlschlägt.

12. März 2024

Dieses Update enthält die folgenden Änderungen:

Die Dokumentation für die captions-Ressource wurde aktualisiert. Die maximale zulässige Länge für das Feld snippet.name beträgt 150 Zeichen. Wenn der Titel länger ist, gibt die API den Fehler nameTooLong zurück.

7. März 2024

Hinweis:Dies ist eine Ankündigung zur Einstellung.

Die Ressourceneigenschaft channel brandingSettings.channel.moderateComments wird nicht mehr unterstützt. 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 videoId-Ressource unter Comments wurden entfernt, da die videoId-Ressource nicht über einen API-Aufruf zurückgegeben wird.

12. September 2023

Hinweis:Dies ist eine Ankündigung zur Einstellung.

Die Methode comments.markAsSpam ist seit mehreren Jahren veraltet. Diese Methode wird bereits auf YouTube nicht mehr unterstützt und wird auch nicht mehr über die API unterstützt.

Allen Dokumenten, in denen auf die Methode comments.markAsSpam verwiesen wird, wurde ein Hinweis auf die Einstellung hinzugefügt.

22. August 2023

Die Methode search.list unterstützt jetzt den Parameter videoPaidProductPlacement. Mit diesem Parameter kannst du die Suchergebnisse so filtern, dass nur Videos angezeigt werden, die vom Creator als bezahlte Werbung gekennzeichnet wurden.

18. August 2023

Die Definition von liveStreamingDetails.concurrentViewers für die video-Ressource wurde aktualisiert. Es wird nun darauf hingewiesen, dass sich die Anzahl der gleichzeitigen Zuschauer, die von der YouTube Data API zurückgegeben wird, von der Anzahl der verarbeiteten, von Spam befreiten gleichzeitigen Zuschauer unterscheiden kann, die über YouTube Analytics verfügbar ist. Weitere Informationen zu Messwerten für Livestreams findest du in der YouTube-Hilfe.

7. August 2023

Wie am 12. Juni 2023 angekündigt, wurde der Parameter relatedToVideoId der Methode search.list eingestellt. Dieser Parameter wird nicht mehr unterstützt und Verweise auf den Parameter wurden aus der API-Dokumentation entfernt.

28. Juni 2023

Die Methode thumbnails.set unterstützt jetzt den Fehler uploadRateLimitExceeded. Dieser gibt an, 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:Dies ist eine Ankündigung zur Einstellung.

Der Parameter relatedToVideoId der Methode search.list wurde eingestellt. YouTube unterstützt den Parameter ab dem 7. August 2023 nicht mehr.

Derzeit wurde in der Dokumentation der search.list-Methode eine entsprechende Ankündigung hinzugefügt. Dieser Parameter wird ab dem 7. August 2023 vollständig aus der search.list-Dokumentation entfernt.

Außerdem wurde aus dem Leitfaden zur API-Implementierung ein Beispiel zum Abrufen ähnlicher Videos entfernt.

22. August 2022

Korrektur der Typanmerkungen für Felder von video.statistics von „unsigned long“ zu „String“.

5. August 2022

YouTube hat die Art und Weise geändert, wie Untertitel-IDs generiert werden. Im Rahmen dieser Änderung werden allen Untertitel-Tracks neue Untertitel-IDs zugewiesen. Diese Änderung ist möglicherweise nicht abwärtskompatibel für Anwendungen, die caption_id-Werte speichern. Sie hat jedoch keine Auswirkungen auf Anwendungen, die keine caption_id-Werte speichern.

Bis zum 1. Dezember 2022 werden mit den Methoden captions.list, captions.update, captions.download und captions.delete sowohl die alten als auch die neuen Untertitel-Track-IDs unterstützt. Ab dem 1. Dezember 2022 werden die alten Untertitel-Track-IDs jedoch nicht mehr unterstützt. Wenn du dann eine dieser API-Methoden mit einer alten Untertitel-Track-ID aufrufst, wird der Fehler captionNotFound zurückgegeben.

Zur Vorbereitung auf diese Änderung solltest du bis zum 1. Dezember 2022 alle gespeicherten Untertiteldaten ersetzen. Das bedeutet, dass du für jedes Video, für das du Untertiteldaten speicherst, die aktuell gespeicherten Daten löschen und dann die Methode captions.list aufrufen solltest, um die aktuellen Untertiteltracks für das Video abzurufen und die Daten wie gewohnt in der API-Antwort zu speichern.

12. Juli 2022

Die Nutzungsbedingungen der YouTube API-Dienste wurden aktualisiert. Weitere Informationen finden Sie in der Versionsgeschichte der Nutzungsbedingungen für YouTube API-Dienste.

27. April 2022

In der Beschreibung der videos.insert-Methode wurde aktualisiert, dass die maximale Dateigröße für hochgeladene Videos von 128 GB auf 256 GB erhöht wurde.

8. April 2022

Die Parameterdefinitionen myRecentSubscribers und mySubscribers der Methode subscriptions.list wurden aktualisiert. Es wird nun darauf hingewiesen, dass die maximale Anzahl der Abonnenten, die von der API zurückgegeben werden, möglicherweise begrenzt ist. Diese Änderung stellt eine Korrektur der Dokumentation dar und keine Änderung des API-Verhaltens.

15. Dezember 2021

Wie am 18. November 2021 angekündigt, wurde die statistics.dislikeCount-Property der video-Ressource im Rahmen der Änderungen, durch die die Anzahl der „Mag ich nicht“-Bewertungen auf der gesamten YouTube-Plattform privat gemacht wird, zu einer privaten Property.

Weitere Informationen zu dieser Änderung findest du im offiziellen YouTube-Blog.

18. November 2021

Im Zusammenhang mit den Änderungen, durch die die Anzahl der „Mag ich nicht“-Bewertungen für Videos auf der gesamten YouTube-Plattform privat gemacht wird, wird die Property statistics.dislikeCount der Ressource video ab dem 13. Dezember 2021 privat. Das bedeutet, dass die Property nur dann in einer API-Antwort vom videos.list-Endpunkt enthalten ist, wenn die API-Anfrage vom Inhaber des Videos authentifiziert wurde.

Der Endpunkt videos.rate ist von dieser Änderung nicht betroffen.

Entwickler, die die Anzahl der „Mag ich nicht“-Bewertungen nicht öffentlich anzeigen, sie aber für ihren API-Client benötigen, können eine Ausnahmegenehmigung beantragen, um auf die Zulassungsliste gesetzt zu 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:Dies ist eine Ankündigung zur Einstellung.

Der commentThreads.update-Endpunkt wurde eingestellt und wird nicht mehr unterstützt. Dieser Endpunkt duplizierte Funktionen, die über andere API-Endpunkte verfügbar sind. Stattdessen können Sie die comments.update

Methode aufrufen und, falls in Ihrem Code eine commentThreads-Ressource erforderlich ist, einen sekundären Aufruf der Methode commentThreads.list ausführen.

1. Juli 2021

Alle Entwickler, die die API-Dienste von YouTube nutzen, müssen eine API-Compliance-Audit bestehen, um mehr als das Standardkontingent von 10.000 Einheiten zu erhalten. Bisher wurden sowohl die Compliance-Audit als auch Anfragen für zusätzliche Kontingenteinheiten von Entwicklern durchgeführt, die das Formular für Audits und Kontingenterhöhungen für YouTube API-Dienste ausgefüllt und eingereicht haben.

Um diese Prozesse zu verdeutlichen und die Anforderungen von Entwicklern, die unsere API-Dienste nutzen, besser zu erfüllen, fügen wir drei neue Formulare und eine Anleitung zum Ausfüllen dieser Formulare hinzu:

• Formular für Anfragen von geprüften Entwicklern: Entwickler, die bereits eine API-Compliance-Audit bestanden haben, können dieses kürzere Formular ausfüllen und einreichen, um eine Erhöhung des zugewiesenen Kontingents zu beantragen.
• Einspruchsformular: Entwickler, deren API-Projekte eine Compliance-Prüfung nicht bestanden haben oder denen eine Erhöhung der Kontingenteinheit verweigert wurde, können dieses Formular ausfüllen und einreichen.
• Formular für Kontrollwechsel: Entwickler oder andere Parteien, die im Namen eines Entwicklers einen API-Client betreiben, bei denen es zu einem Kontrollwechsel im Zusammenhang mit einem API-Projekt kommt (z. B. durch einen Aktienkauf oder -verkauf, eine Fusion oder eine andere Unternehmenstransaktion), müssen dieses Formular ausfüllen und einreichen. So kann das API-Team von YouTube unsere Daten aktualisieren, die Einhaltung des Anwendungsfalls des neuen API-Projekts prüfen und die aktuelle Kontingentzuweisung des Entwicklers überprüfen.

Jedes neue Formular informiert uns über deine beabsichtigte Nutzung der YouTube API und ermöglicht es uns, dir besser zu helfen.

Weitere Informationen finden Sie in unserem neuen Leitfaden zu API-Compliance-Audits.

12. Mai 2021

Hinweis:Dies ist eine Ankündigung zur Einstellung.

Dieses Update umfasst die folgenden API-Änderungen:

• Die Property contentDetails.relatedPlaylists.favorites der Ressource channel wird nicht mehr unterstützt. Die Funktion „Lieblingsvideos“ wurde bereits vor mehreren Jahren eingestellt, wie im Änderungsverlauf vom 28. April 2016 vermerkt ist.

  Vor diesem Update wurde von der API weiterhin eine neue Playlist erstellt, wenn ein API-Client versuchte, einem nicht vorhandenen Favoriten-Video eine Videowiedergabe hinzuzufügen. In diesem Fall wird die Playlist in Zukunft nicht erstellt und die API gibt einen Fehler zurück. Versuche, Favoritenplaylists durch Hinzufügen, Ändern oder Löschen von Elementen zu ändern, sind gemäß vorherigen Ankündigungen ebenfalls eingestellt und können jederzeit Fehler zurückgeben.

• Die folgenden channel-Ressourceneigenschaften wurden eingestellt. Diese Eigenschaften werden bereits in der YouTube Studio-Benutzeroberfläche und auf YouTube nicht unterstützt. Daher werden sie auch nicht mehr über die API unterstützt.

  • brandingSettings.channel.defaultTab
  • brandingSettings.channel.featuredChannelsTitle
  • brandingSettings.channel.featuredChannelsUrls[]
  • brandingSettings.channel.profileColor
  • brandingSettings.channel.showBrowseView
  • brandingSettings.channel.showRelatedChannels

  Alle Properties wurden aus der channel-Ressourcendarstellung entfernt und ihre Definitionen aus der Property-Liste der Ressource. Außerdem wurden Fehler, die mit diesen Properties zusammenhängen, aus der methodenspezifischen Dokumentation entfernt.

• Die folgenden channelSection-Ressourceneigenschaften wurden eingestellt. Diese Eigenschaften werden bereits in der YouTube Studio-Benutzeroberfläche und auf YouTube 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 Zusammenhang mit dieser Änderung wurde auch der Parameter hl der Methode channelSection.list eingestellt, da die von ihm unterstützten Funktionen nicht mehr unterstützt werden.

  Alle Properties wurden aus der channelSection-Ressourcendarstellung entfernt und ihre Definitionen aus der Property-Liste der Ressource. Außerdem wurden Fehler, die mit diesen Properties zusammenhängen, aus der methodenspezifischen Dokumentation entfernt.

• Die folgenden Werte für die Property snippet.type der channelSection-Ressource wurden eingestellt. Diese Werte werden bereits auf YouTube-Kanalseiten nicht unterstützt und daher auch nicht mehr über die API.

  • likedPlaylists
  • likes
  • postedPlaylists
  • postedVideos
  • recentActivity
  • recentPosts

• Die Property snippet.tags[] der Ressource playlist wird nicht mehr unterstützt. Dieses Attribut wird bereits auf YouTube nicht mehr unterstützt und daher auch nicht mehr über die API.

9. Februar 2021

Die Ressource playlistItem unterstützt zwei neue Properties:

• Die Eigenschaft snippet.videoOwnerChannelId identifiziert die ID des Kanals, 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 einen neuen playlistOperationUnsupported-Fehler. Der Fehler tritt auf, wenn bei einer Anfrage versucht wird, eine Aktion auszuführen, die für eine bestimmte Playlist nicht zulässig ist. Ein Nutzer kann beispielsweise kein Video aus der Playlist mit seinen hochgeladenen Videos löschen oder die Playlist selbst löschen.

  In allen Fällen wird bei diesem Fehler der HTTP-Antwortcode 400 (Ungültige Anfrage) zurückgegeben.

• Die Fehler watchHistoryNotAccessible und watchLaterNotAccessible der Methode playlistItems.list wurden aus der Dokumentation entfernt. Der Wiedergabeverlauf und die Merkliste von Nutzern sind zwar nicht über die API zugänglich, 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 über einen eingebetteten YouTube-Player an uns sendest, bevor der Nutzer mit dem Player interagiert hat, um seine Wiedergabeabsicht zu signalisieren. Du kannst die Daten, die mit YouTube geteilt werden, einschränken, bevor ein Nutzer mit dem Player interagiert. Dazu musst du „Autoplay“ auf „false“ setzen.
• Der neue Abschnitt III.E.4.j bezieht sich auf die Prüfung des Status „Inhalte speziell für Kinder“ (MFK) von Inhalten, bevor sie in Websites und Apps eingebettet werden. Sie sind dafür verantwortlich zu wissen, ob Videos, die Sie in Ihren API-Client einbetten, speziell für Kinder erstellt wurden, und die über den eingebetteten Player erhobenen Daten entsprechend zu behandeln. Du musst den Status von Inhalten daher mithilfe des YouTube Data API-Dienstes prüfen, bevor du sie über eingebettete YouTube-Player in deinen API-Client einbettest.

In der neuen Anleitung MadeForKids-Status eines Videos ermitteln wird beschrieben, wie du den MFK-Status eines Videos mithilfe der YouTube Data API abrufen kannst.

Im Zusammenhang mit diesen Änderungen wurde in der Dokumentation zu den Parametern für eingebettete Player eine Erinnerung hinzugefügt, dass bei aktivierter automatischer Wiedergabe die Wiedergabe ohne Nutzerinteraktion mit dem Player erfolgt. Die Erfassung und Weitergabe von Wiedergabedaten erfolgt daher beim Laden der Seite.

8. Oktober 2020

Dieses Update umfasst drei kleine Änderungen an der channel-Ressource:

• Das Objekt snippet.thumbnails, das die Thumbnail-Bilder eines Kanals identifiziert, ist bei neu erstellten Kanälen möglicherweise leer. Es kann bis zu einem Tag dauern, bis es gefüllt ist.
• Die Property statistics.videoCount gibt nur die Anzahl der öffentlichen Videos des Kanals an, auch für die Inhaber. Dieser Wert stimmt mit den Angaben auf der YouTube-Website überein.
• Channel-Keywords, die in der Property brandingSettings.channel.keywords angegeben sind, werden möglicherweise abgeschnitten, wenn sie die maximal zulässige Länge von 500 Zeichen überschreiten oder unescaped Anführungszeichen (") enthalten. Die Beschränkung auf 500 Zeichen gilt nicht pro Keyword, sondern für die Gesamtlänge aller Keywords. Dieses Verhalten entspricht dem auf der YouTube-Website.

9. September 2020

Hinweis:Dies ist eine Ankündigung zur Einstellung.

Dieses Update umfasst die folgenden API-Änderungen. Alle Änderungen treten am oder nach dem 9. September 2020 in Kraft, dem Datum dieser Mitteilung. Aus diesem Grund sollten Entwickler die folgenden API-Funktionen nicht mehr verwenden.

• Die folgenden API-Ressourcen, ‑Methoden, ‑Parameter und ‑Ressourceneigenschaften werden sofort eingestellt und funktionieren ab dem Datum dieser Mitteilung nicht mehr:
  • Die folgenden channel-Ressourceneigenschaften:
    • Die statistics.commentCount-Property
    • Das brandingSettings.image-Objekt und alle untergeordneten Properties
    • Die Liste brandingSettings.hints und alle untergeordneten Properties
  • Der Filterparameter categoryId der Methode channels.list
  • Die guideCategories-Ressource und die guideCategories.list-Methode
• API-Antworten für die Methode channels.list enthalten nicht mehr das Attribut prevPageToken, wenn in der API-Anfrage der Parameter managedByMe auf true festgelegt wird. Diese Änderung hat keine Auswirkungen auf die Property prevPageToken bei anderen channels.list-Anfragen und auch nicht auf die Property nextPageToken bei Anfragen.
• Die Properties contentDetails.relatedPlaylists.watchLater und contentDetails.relatedPlaylists.watchHistory der Ressource channel wurden am 11. August 2016 eingestellt. Die Unterstützung der Methoden playlistItems.insert und playlistItems.delete für diese Playlists wurde ebenfalls eingestellt und die beiden Properties wurden aus der Dokumentation entfernt.
• Der Parameter mySubscribers der Methode channels.list, der am 30. Juli 2013 eingestellt wurde, wurde aus der Dokumentation entfernt. Verwende die Methode subscriptions.list und den Parameter mySubscribers, um eine Liste der Abonnenten des Kanals des authentifizierten Nutzers abzurufen.
• Das invideoPromotion-Objekt der channel-Ressource und alle untergeordneten Properties, die am 27. November 2017 als eingestellt angekündigt wurden, wurden aus der Dokumentation entfernt.

29. Juli 2020

Wir haben die Abrechnung des Kontingents 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

Die meisten API-Aufrufe werden dadurch geringfügig günstiger, bei einigen API-Aufrufen bleiben die Kosten jedoch gleich. Durch diese Änderung erhöhen sich die Kosten für API-Aufrufe nicht. Insgesamt wird Ihr zugewiesenes Kontingent, das Sie in der Google Cloud Console sehen, wahrscheinlich etwas länger reichen.

Wir empfehlen allen Entwicklern dringend, eine Compliance-Prüfung für ihre Projekte durchzuführen, um den dauerhaften Zugriff auf die YouTube API-Dienste zu ermöglichen.

Dieser Eintrag in der Versionsgeschichte wurde ursprünglich am 20. Juli 2020 veröffentlicht.

28. Juli 2020

Alle Videos, die über den videos.insert-Endpunkt aus nicht bestätigten API-Projekten hochgeladen wurden, die nach dem 28. Juli 2020 erstellt wurden, sind nur im Modus „Privat ansehen“ verfügbar. Damit diese Einschränkung aufgehoben werden kann, muss jedes Projekt einer Prüfung unterzogen werden, um die Einhaltung der Nutzungsbedingungen zu überprüfen.

Creator, die zum Hochladen von Videos einen nicht verifizierten API-Client verwenden, erhalten eine E-Mail, in der ihnen mitgeteilt wird, dass ihr Video als „Privat“ gesperrt wurde und dass sie die Einschränkung vermeiden können, indem sie einen offiziellen oder geprüften Client verwenden.

API-Projekte, die vor dem 28. Juli 2020 erstellt wurden, sind derzeit von dieser Änderung nicht betroffen. Wir empfehlen allen Entwicklern jedoch dringend, eine Compliance-Prüfung für ihre Projekte durchzuführen, um den Zugriff auf die YouTube API-Dienste aufrechtzuerhalten.

21. Juli 2020

[Aktualisiert am 28. Juli 2020] Die in diesem Änderungsverlauf erwähnte Dokumentenaktualisierung wurde am 28. Juli 2020 noch einmal veröffentlicht.

Gestern haben wir eine Aktualisierung der Dokumentation zu unserem Verfahren zur Abrechnung des Kontingents veröffentlicht. Aufgrund unvorhergesehener Umstände ist die Änderung des Kontingents jedoch noch nicht in Kraft. Daher wurde die Dokumentation zugunsten der Richtigkeit rückgängig gemacht. Um Verwirrung zu vermeiden, wurde der Eintrag im Änderungsverlauf, der die Änderung erklärt, entfernt. Er wird in Kürze wiederveröffentlicht.

7. Juli 2020

Hinweis:Dies ist eine Ankündigung zur Einstellung.

Die Parameter autoLevels und stabilize der Methode videos.insert sind jetzt veraltet und wurden aus der Dokumentation entfernt. Ihre Werte werden ignoriert und haben keine Auswirkungen auf die Verarbeitung neu hochgeladener Videos.

15. Juni 2020

In der neuen Anleitung Einhaltung der YouTube-Richtlinien für Entwickler findest du Hinweise und Beispiele, wie du dafür sorgen kannst, dass deine API-Clients bestimmte Teile der Nutzungsbedingungen und Richtlinien für YouTube API-Dienste einhalten.

Dieser Leitfaden gibt Aufschluss darüber, wie YouTube bestimmte Aspekte der API-Nutzungsbedingungen durchsetzt, ersetzt aber keine vorhandenen Dokumente. In diesem Leitfaden werden einige der häufigsten Fragen beantwortet, die Entwickler bei der Prüfung der API-Compliance stellen. Wir hoffen, dass diese Informationen Ihnen dabei helfen, die Entwicklung Ihrer Funktionen zu vereinfachen, da Sie besser nachvollziehen können, wie wir unsere Richtlinien auslegen und durchsetzen.

4. Juni 2020

Hinweis:Dies ist eine Aktualisierung einer früheren Ankündigung zur Einstellung.

Die Funktion „Kanalnachricht“ wurde jetzt vollständig eingestellt. Diese Änderung wurde ursprünglich am 17. April 2020 angekündigt und ist jetzt in Kraft getreten. Die Methode activities.insert wird daher nicht mehr unterstützt und die Methode activities.list gibt keine Kanalmeldungen mehr zurück. Weitere Informationen findest du in der YouTube-Hilfe.

17. April 2020

Hinweis:Dies ist eine Ankündigung zur Einstellung.

Die Funktion „Kanalnachrichten“ wird auf YouTube eingestellt. Daher wird die Methode activities.insert eingestellt und die Methode activities.list gibt keine Kanalmeldungen 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 member-Ressource steht für ein Kanalmitglied eines YouTube-Kanals. Ein Mitglied unterstützt einen Creator regelmäßig finanziell und erhält dafür spezielle Vorteile. So können Mitglieder beispielsweise chatten, wenn der Creator den Chatmodus nur für Mitglieder aktiviert.

    Diese Ressource ersetzt die sponsor-Ressource, die in der YouTube Live Streaming API dokumentiert ist. Die Ressource sponsor wird jetzt eingestellt. API-Clients sollten Aufrufe der Methode sponsors.list so aktualisieren, dass stattdessen die Methode members.list verwendet wird.

  • Die neue membershipsLevel-Ressource gibt ein Preisniveau an, das vom Creator verwaltet wird, der die API-Anfrage autorisiert hat. Die Methode membershipsLevels.list ruft eine Liste aller Mitgliedschaftsstufen des Creators ab.

10. Januar 2020

Die API unterstützt jetzt die Erkennung von Inhalten, die sich an Kinder richten. Auf YouTube werden diese als „speziell für Kinder“ gekennzeichnet. Weitere Informationen zu Inhalten speziell für Kinder

Die Ressourcen channel und video unterstützen zwei neue Properties, mit denen Creator und Zuschauer Inhalte speziell für Kinder erkennen können:

• Mit der Property selfDeclaredMadeForKids können Creator angeben, ob ein Kanal oder ein Video speziell für Kinder ist.
  
  Bei Kanälen kann diese Eigenschaft beim Aufrufen der Methode channels.update festgelegt werden. Bei Videos kann diese Property beim Aufrufen der Methoden videos.insert oder videos.update festgelegt werden.
  
  Hinweis: Dieses Attribut ist nur in API-Antworten enthalten, die channel- oder video-Ressourcen enthalten, wenn der Kanalinhaber die API-Anfrage autorisiert hat.
• Über die 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 deine Livestreams festlegst, findest du in der YouTube-Hilfe.

Außerdem haben wir die Nutzungsbedingungen der YouTube API-Dienste und die Richtlinien für Entwickler aktualisiert. Weitere Informationen finden Sie in der Versionsgeschichte der Nutzungsbedingungen für YouTube API-Dienste. Die Änderungen an den Nutzungsbedingungen für YouTube API-Dienste und den Entwicklerrichtlinien treten am 10. Januar 2020 (UTC-8) in Kraft.

10. September 2019

Die API-Referenzdokumentation wurde aktualisiert, um eine Änderung bei der Darstellung der Abonnentenzahlen auf YouTube und damit in API-Antworten widerzuspiegeln. Aufgrund dieser Änderung werden die vom YouTube Data API-Dienst zurückgegebenen Abonnentenzahlen auf drei signifikante Ziffern abgerundet, wenn die Anzahl der Abonnenten mehr als 1.000 Beträgt. Diese Änderung betrifft die Property statistics.subscriberCount der Ressource channel.

Hinweis:Diese Änderung wirkt sich auf diesen Property-Wert auch dann aus, wenn ein Nutzer eine autorisierte Anfrage für Daten zu seinem eigenen Kanal sendet. Kanalinhaber sehen in YouTube Studio weiterhin die exakten Abonnentenzahlen.

Wenn ein Kanal beispielsweise 123.456 Abonnenten hat, enthält das Attribut statistics.subscriberCount den Wert 123000. In der folgenden Tabelle findest du 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 gängige Anwendungsfälle für jede Methode besser zu erläutern und dynamische, hochwertige Codebeispiele über das API Explorer-Widget bereitzustellen. Ein Beispiel hierfür finden Sie in der Dokumentation der Methode channels.list. Auf Seiten mit API-Methoden gibt es jetzt zwei neue Elemente:

  • Mit dem APIs Explorer-Widget können Sie Autorisierungsbereiche auswählen, Beispielparameter und -eigenschaftswerte eingeben und dann tatsächliche API-Anfragen senden und tatsächliche API-Antworten sehen. Das Widget bietet auch eine Vollbildansicht mit vollständigen Codebeispielen, die dynamisch aktualisiert werden, um die von Ihnen eingegebenen Bereiche und Werte zu verwenden.

  • Im Abschnitt Gängige Anwendungsfälle werden ein oder mehrere gängige Anwendungsfälle für die auf der Seite beschriebene Methode beschrieben. Du kannst beispielsweise die Methode channels.list aufrufen, um Daten zu einem bestimmten Kanal oder zu dem 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. Mit diesen Änderungen soll es einfacher sein, Codebeispiele zu finden, die direkt auf den Anwendungsfall anwendbar sind, den Sie in Ihrer eigenen Anwendung implementieren möchten.

  Codebeispiele werden derzeit für Java, JavaScript, PHP, Python und curl unterstützt.

• Das Tool für Codebeispiele wurde ebenfalls aktualisiert und bietet jetzt eine neue Benutzeroberfläche mit den oben beschriebenen Funktionen. Mit diesem Tool können Sie Anwendungsfälle für verschiedene Methoden untersuchen, Werte in den APIs Explorer laden und den APIs Explorer im Vollbildmodus öffnen, um Codebeispiele in Java, JavaScript, PHP und Python zu erhalten.

  Im Rahmen dieser Änderung wurden auch die Seiten entfernt, auf denen zuvor verfügbare Codebeispiele für Java, JavaScript, PHP und Python aufgeführt waren.

• Die Kurzanleitungen für Java, JavaScript, PHP und Python wurden aktualisiert. In den überarbeiteten Anleitungen wird beschrieben, wie Sie ein Beispiel mit einem API-Schlüssel und ein anderes Beispiel mit einer OAuth 2.0-Client-ID ausführen, indem Sie Codebeispiele aus dem APIs Explorer verwenden.

Die oben beschriebenen Änderungen ersetzen ein interaktives Tool, das 2017 in die API-Dokumentation aufgenommen wurde.

9. Juli 2018

Dieses Update enthält die folgenden Änderungen:

• Die Definition der Eigenschaft snippet.thumbnails der channel-Ressource wurde aktualisiert. Wenn du Miniaturansichten in deiner Anwendung darstellst, sollte dein Code die Bild-URLs genau so verwenden, wie sie in API-Antworten zurückgegeben werden. Ihre Anwendung sollte beispielsweise nicht die Domain http anstelle der Domain https in einer URL verwenden, die in einer API-Antwort zurückgegeben wird.

  Ab Juli 2018 sind die URLs von Kanal-Thumbnails nur noch in der Domain https verfügbar. So werden sie auch in API-Antworten angezeigt. Danach werden in deiner Anwendung möglicherweise fehlerhafte Bilder angezeigt, wenn versucht wird, YouTube-Bilder aus der Domain http zu laden.

• Hinweis:Dies ist eine Ankündigung zur Einstellung.

  Die Property recordingDetails.location.altitude der Ressource video wird nicht mehr unterstützt. Es gibt keine Garantie dafür, dass für Videos Werte für dieses Attribut zurückgegeben werden. Auch wenn in API-Anfragen versucht wird, einen Wert für dieses Attribut festzulegen, werden die eingehenden Daten möglicherweise nicht gespeichert.

22. Juni 2018

Der Implementierungsleitfaden, früher Implementierungs- und Migrationsleitfaden, wurde aktualisiert. Die Anleitung zur Migration von der v2 API zur v3 API wurde entfernt. Außerdem wurden Anleitungen für Funktionen entfernt, die in der V3 API inzwischen eingestellt wurden, z. B. für Lieblingsvideos.

27. November 2017

Dieses Update enthält die folgenden Änderungen:

• Hinweis:Dies ist eine Ankündigung zur Einstellung.

  YouTube entfernt die Unterstützung für die Funktionen Angesagtes Video und Vorgestellte Website, die in der API über das invideoPromotion-Objekt der channel-Ressource unterstützt werden. Daher wird dieses Objekt einschließlich aller untergeordneten Properties eingestellt.

  Bis zum 14. Dezember 2017 können Sie weiterhin invideoPromotion-Daten abrufen und festlegen. Nach diesem Datum gilt Folgendes:

  • Wenn Sie beim Aufrufen von channels.list versuchen, den Teil invideoPromotion abzurufen, wird eine leere invideoPromotion oder gar keine invideoPromotion-Daten zurückgegeben.
  • Versuche, invideoPromotion-Daten beim Aufrufen von channels.update zu aktualisieren, werden bis mindestens zum 27. Mai 2018 als erfolgreich abgeschlossen angezeigt. Sie werden jedoch als No-Ops behandelt, d. h., es wird kein Update durchgeführt.

  Nach dem 27. Mai 2018 können bei diesen Anfragen Fehlermeldungen zurückgegeben werden, die beispielsweise darauf hinweisen, 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 zu sehen, z. B. für die Methode channels.list.

  Die anpassbaren Beispiele sollen Ihnen einen nutzungsspezifischen Ausgangspunkt für eine Node.js-Anwendung bieten. Die Funktionsweise ähnelt dem Code in der Node.js-Schnellstartanleitung. Die Beispiele enthalten jedoch einige Dienstfunktionen, die im Schnellstart nicht aufgeführt sind:

  • Die Funktion removeEmptyParameters nimmt eine Liste von Schlüssel/Wert-Paaren entgegen, die den Parametern der API-Anfrage entsprechen, und entfernt die Parameter ohne Werte.
  • Die Funktion createResource nimmt eine Liste von Schlüssel/Wert-Paaren entgegen, die den Properties in einer API-Ressource entsprechen. Anschließend werden die Properties in ein JSON-Objekt umgewandelt, 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 dafür erstellen würde:

    # Key-value pairs:
    {'id': 'ABC123',
     'snippet.title': 'Resource title',
     'snippet.description': 'Resource description',
     'status.privacyStatus': 'private'}
    
    # JSON object:
    {
     'id': 'ABC123',
     'snippet': {
       'title': 'Resource title',
       'description': 'Resource description',
     },
     'status': {
       'privacyStatus': 'private'
     }
    }

  Alle diese Samples können heruntergeladen und lokal ausgeführt werden. Weitere Informationen finden Sie in der Anleitung für das Code-Snippet-Tool unter Voraussetzungen für das lokale Ausführen vollständiger Codebeispiele.

25. Oktober 2017

Dieses Update enthält die folgenden Änderungen:

• Die Python-Codebeispiele im interaktiven Code-Snippet-Tool wurden aktualisiert. Statt der oauth2client-Bibliothek, die jetzt eingestellt wird, werden jetzt die google-auth- und google-auth-oauthlib-Bibliotheken verwendet.

  Zusätzlich zu dieser Änderung bietet das Tool jetzt vollständige Codebeispiele für installierte Python-Anwendungen und Python-Webserveranwendungen, die etwas unterschiedliche Autorisierungsabläufe verwenden. So rufen Sie die vollständigen Samples (und diese Änderung) auf:

  1. Rufen Sie das interaktive Code-Snippet-Tool oder die Dokumentation für eine API-Methode wie die channels.list-Methode auf.
  2. Klicken Sie über den Codebeispielen auf den Tab Python.
  3. Klicken Sie auf den Schalter über den Tabs, um zwischen einem Snippet und einem vollständigen Sample zu wechseln.
     
  4. Auf dem Tab sollte jetzt ein vollständiges Codebeispiel mit dem InstalledAppFlow-Autorisierungsablauf angezeigt werden. In der Beschreibung über dem Beispiel wird dies erläutert und es wird auch ein Link zu einem Beispiel für eine Webserveranwendung angegeben.
  5. Klicken Sie auf den Link, um zum Beispiel für den Webserver zu wechseln. In diesem Beispiel wird das Flask-Framework für Webanwendungen und ein anderer Autorisierungsablauf verwendet.

  Alle diese Samples können heruntergeladen und lokal ausgeführt werden. Wenn Sie die Beispiele ausführen möchten, lesen Sie die Anleitung zum Lokalen Ausführen vollständiger Codebeispiele in der Anleitung für das Code-Snippet-Tool.

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 festgelegt ist, muss der Parameter type auf video festgelegt sein.
• Die Definition des Parameters regionCode der Methode search.list wurde aktualisiert, um zu verdeutlichen, dass die Suchergebnisse mit diesem Parameter auf Videos beschränkt werden, die sich in der angegebenen Region ansehen lassen.
• YouTube hat seine Logos und Symbole aktualisiert. Neue Logos mit dem Zusatz „Entwickelt mit YouTube“ können auf der Seite Branding-Richtlinien heruntergeladen werden. Auf dieser Seite findest du auch weitere neue YouTube-Logos und -Symbole, die du auf der YouTube-Markenwebsite herunterladen kannst.

24. Juli 2017

Dieses Update enthält die folgenden Änderungen:

• Es gibt eine neue Kurzanleitung für die YouTube Data API für iOS. In der Anleitung wird beschrieben, wie du die YouTube Data API in einer einfachen iOS-Anwendung verwendest, die 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
  • Boilerplate-Funktionen verwenden
  • Vorhandene Ressourcen laden (für Aktualisierungsmethoden)

  Hinweis:Das Tool ist auch in der API-Referenzdokumentation für API-Methoden eingebettet (Beispiel).

1. Juni 2017

Dieses Update enthält die folgenden Änderungen:

• Hinweis:Dies ist eine Ankündigung zur Einstellung.

  Die folgenden video-Ressourceneigenschaften werden eingestellt. Die Properties werden zwar bis zum 1. Dezember 2017 unterstützt, es gibt jedoch keine Garantie, dass bis dahin weiterhin Werte für diese Properties zurückgegeben werden. Ebenso führen videos.insert- und videos.update-Anfragen, bei denen diese Property-Werte festgelegt werden, vor diesem Datum nicht zu Fehlern. 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 nutzerfreundlicher und interaktiver zu gestalten. Seiten mit Erläuterungen zu API-Methoden wie channels.list oder videos.rate enthalten jetzt ein interaktives Tool, mit dem Sie Code-Snippets in Java, JavaScript, PHP, Python, Ruby, Apps Script und Go ansehen und anpassen können.

  Für jede Methode zeigt das Tool Code-Snippets für einen oder mehrere Anwendungsfälle an. Jeder Anwendungsfall beschreibt eine gängige Methode zum Aufrufen dieser Methode. Du kannst 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 Property-Werte ändern, werden die Code-Snippets dynamisch aktualisiert, um die von Ihnen angegebenen Werte widerzuspiegeln.

  • Zwischen Code-Snippets und vollständigen Beispielen wechseln Ein Code-Snippet zeigt den Codeabschnitt, in dem die API-Methode aufgerufen wird. Ein vollständiges Beispiel enthält dieses Snippet sowie Boilerplate-Code zum Autorisieren und Senden von Anfragen. Vollständige Samples können kopiert und über die Befehlszeile oder einen lokalen Webserver ausgeführt werden.

  • Anfragen können durch Klicken auf eine Schaltfläche ausgeführt werden. Zum Ausführen von Anfragen müssen Sie das Tool autorisieren, die API in Ihrem Namen aufzurufen.

  Dieses Tool hat den APIs Explorer auf den entsprechenden Seiten ersetzt. Auf jeder Seite wird ein Link angezeigt, über den Sie die Anfrage, an der Sie gerade arbeiten, auch im APIs Explorer laden können.

• Das Tool Data API-Code-Snippets wurde ebenfalls aktualisiert und bietet jetzt eine neue Benutzeroberfläche mit allen oben beschriebenen Funktionen. Die wichtigsten neuen Funktionen auf dieser Seite sind:

  • Unterstützung für API-Anfragen, bei denen Daten geschrieben werden.
  • Unterstützung für Java-Beispiele
  • Flexiblerer und umfassenderer Boilerplate-Code zum Autorisieren von Nutzern und Erstellen von API-Anfragen.

27. April 2017

Dieses Update enthält die folgenden Änderungen:

• In den neuen Kurzanleitungen wird erklärt, wie du eine einfache Anwendung einrichtest, die YouTube Data API-Anfragen stellt. Derzeit 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 Property topicDetails.topicCategories[] der channel-Ressource enthält eine Liste von Wikipedia-URLs, die den Inhalt des Kanals beschreiben. Die URLs entsprechen den Themen-IDs, die in der Property topicDetails.topicIds[] der Ressource zurückgegeben werden.
• Die neue Property contentDetails.videoPublishedAt der playlistItem-Ressource gibt an, wann das Video auf YouTube veröffentlicht wurde. Die Ressource enthält bereits die Property snippet.publishedAt, die angibt, wann der Artikel der Playlist hinzugefügt wurde.
• Wie die channel-Ressource gibt auch die video-Ressource jetzt das Attribut topicDetails.topicCategories[] zurück. Dieses enthält eine Liste von Wikipedia-URLs, die den Inhalt des Videos beschreiben. Bei video-Ressourcen entsprechen die URLs den Themen-IDs, die in der topicDetails.relevantTopicIds[]-Property der Ressource zurückgegeben werden.
• Die neue Property contentDetails.contentRating.mpaatRating der video-Ressource gibt die Altersfreigabe an, die die Motion Picture Association of America einem Filmtrailer oder einer Filmvorschau gegeben hat.

27. Februar 2017

Wie bereits am 11. August 2016 angekündigt, hat YouTube die Liste der unterstützten Themen-IDs durch eine ausgewählte Liste ersetzt. Eine vollständige Liste der unterstützten Themen-IDs ist in den topicDetails-Properties für channel- und video-Ressourcen sowie im topicId-Parameter der search.list-Methode enthalten.

Die ausgewählte Liste wurde in mehreren Punkten geändert:

• Die folgenden Themen wurden als Unterthemen zu Society hinzugefügt:

  Name	Themen-ID
  Unternehmen	/m/09s1f
  Gesundheit	/m/0kt51
  Militär	/m/01h6rj
  Politik	/m/05qt0
  Religion	/m/06bvp

• Das Thema Animated cartoon, das zuvor ein untergeordnetes Element von Entertainment war, wurde entfernt.
• Das Thema Children's music, das zuvor ein untergeordnetes Element von Music war, wurde entfernt.

Aufgrund dieser Änderung werden Themen, die sich auf ein Video beziehen, jetzt immer im Property-Wert topicDetails.relevantTopicIds[] der video-Ressource zurückgegeben.

29. November 2016

Dieses Update enthält die folgenden Änderungen:

• Die Liste der Themen-IDs, die ab dem 10. Februar 2017 unterstützt werden, wurde in drei kleinen Punkten geändert:

  • Die Kategorie Professional wrestling, die zuvor der Kategorie Sports untergeordnet war, ist jetzt Entertainment untergeordnet.
  • Die Kategorie TV shows ist neu und ein untergeordnetes Element von Entertainment.
  • Die Kategorie Health, die zuvor eine untergeordnete Kategorie von Lifestyle war, wurde entfernt.

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

10. November 2016

Dieses Update enthält die folgenden Änderungen:

• Wie am 11. August 2016 angekündigt, erfordern die Einstellung von Freebase und der Freebase API mehrere Änderungen im Zusammenhang mit Themen-IDs. Themen-IDs identifizieren Themen, die mit channel- und video-Ressourcen verknüpft sind. Du kannst auch den Suchparameter topicId verwenden, um Kanäle oder Videos zu einem bestimmten Thema zu finden.

  Ab dem 10. Februar 2017 gibt YouTube nur noch eine kleine Auswahl an Themen-IDs zurück, anstatt wie bisher eine viel detailliertere Auswahl. Außerdem ist nicht garantiert, dass Kanäle und Videos mit Themen verknüpft sind. Das entspricht dem aktuellen API-Verhalten.

  Damit Sie Ihre API-Clients auf diese Änderungen vorbereiten können, wurden die Definitionen der folgenden API-Parameter und ‑Properties aktualisiert. Dort sind jetzt die Themen-IDs aufgeführt, die nach diesem Datum unterstützt werden. Die Liste der Kategorien ist für alle Properties identisch.

  • Die topicDetails.topicIds[]-Property der channel-Ressource.
  • Die topicDetails.relevantTopicIds[]-Property der video-Ressource.
  • Der Parameter topicId der Methode search.list.

• Hinweis:Dies ist eine Ankündigung zur Einstellung.

  Die folgenden Properties werden eingestellt:

  • Die topicDetails.topicIds[]-Property der channel-Ressource. Diese Property wird bis zum 10. November 2017 unterstützt.
  • Die topicDetails.relevantTopicIds[]-Property der video-Ressource. Diese Property wird bis zum 10. November 2017 unterstützt.
  • Die topicDetails.topicIds[]-Property der video-Ressource. Diese Property enthält nach dem 10. Februar 2017 keine Werte mehr. Nach diesem Datum werden im topicDetails.relevantTopicIds[]-Attributwert alle Themen aufgeführt, die mit einem Video verknüpft sind.

• Da Freebase bereits eingestellt wurde, wurde der Leitfaden Mit Freebase-Themen suchen aus der Dokumentation entfernt. Dieser Leitfaden enthielt Codebeispiele, die zeigen, wie eine Anwendung mit der Freebase API funktioniert.

  Außerdem wurden mehrere Codebeispiele zu Themen-IDs aus der Dokumentation der search.list-Methode entfernt.

2. November 2016

Dieses Update enthält die folgenden Änderungen:

• Neue Properties und Parameter

  • Die video-Ressource enthält mehrere neue Properties:

    • Die player.embedHtml-Property enthält ein <iframe>-Tag, mit dem Sie einen Player einbetten können, der das Video abspielt. Die neuen Eigenschaften player.embedHeight und player.embedWidth geben die Abmessungen des eingebetteten Players an. Diese Properties werden nur zurückgegeben, wenn in der API-Anfrage für mindestens einen der Parameter maxHeight oder maxWidth ein Wert angegeben ist. Diese beiden neuen Parameter werden weiter unten in diesem Eintrag im Änderungsverlauf erläutert.

    • Das neue Attribut hasCustomThumbnail gibt an, ob der Video-Uploader ein benutzerdefiniertes Thumbnail für das Video bereitgestellt hat. Diese Eigenschaft ist nur für den Uploader des Videos sichtbar.

    • Die neue fpbRatingReasons[] gibt die Gründe an, aus denen das Video die Altersfreigabe des FPB (Südafrika) erhalten hat.

    • Die neue mcstRating gibt die Altersfreigabe an, die das Video in Vietnam erhalten hat.

  • Die videos.list-Methode unterstützt zwei neue Parameter: maxHeight und maxWidth. Sie können entweder einen oder beide Parameter verwenden, um den player-Teil in video-Ressourcen abzurufen.

    Standardmäßig beträgt die Höhe des <iframe>, der in der player.embedHtml-Eigenschaft zurückgegeben wird, 360 Pixel. Die Breite wird an das Seitenverhältnis des Videos angepasst, damit das Video im eingebetteten Player nicht von schwarzen Balken umrahmt wird. Wenn das Seitenverhältnis eines Videos 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 für das Layout deiner Anwendung geeignet ist. Der API-Server skaliert die Playerabmessungen so, dass der eingebettete Player keine schwarzen Balken um das Video herum hat. Beachte, dass beide Parameter die maximalen Abmessungen des eingebetteten Players angeben. Wenn also beide Parameter angegeben sind, ist eine Dimension möglicherweise immer noch kleiner als der für diese Dimension zulässige Maximalwert.

    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 Parameter maxHeight auf 720 und der Parameter maxWidth nicht festgelegt ist, gibt die API einen Player mit einer Auflösung von 1280 × 720 zurück.
    • Wenn der Parameter maxWidth auf 960 und der Parameter maxHeight nicht festgelegt ist, gibt die API einen Player mit einer Auflösung von 960 × 540 zurück.
    • Wenn der Parameter maxWidth auf 960 und der Parameter maxHeight auf 450 festgelegt ist, gibt die API einen Player mit einer Auflösung von 800 × 450 Pixeln zurück.

    Die neuen Attribute player.embedHeight und player.embedWidth, die oben beschrieben wurden, geben die Abmessungen des Players an.

• Aktualisierungen bestehender Methoden, Properties und Parameter

  • Die Ressourcenbeschreibung für channelSection wurde aktualisiert. Dort wird jetzt darauf hingewiesen, dass ein Kanal ohne Festlegen von Targeting-Daten maximal 10 Bereiche und mit Targeting-Daten maximal 100 Bereiche erstellen kann.

    Außerdem wurde das Attribut targeting der Ressource channelSection aktualisiert, um darauf hinzuweisen, dass Targeting-Optionen nur über die API festgelegt werden können. Targeting-Optionen werden gelöscht, wenn der Kanalbereich über die Benutzeroberfläche auf der YouTube-Website geändert wird.

  • Die Definition der snippet.name-Property der i18nLanguage-Ressource wurde korrigiert, um zu verdeutlichen, dass der Wert den Namen einer Sprache darstellt, wie er in der Sprache geschrieben ist, die durch den hl-Parameter der i18nLanguage.list-Methode angegeben ist.

  • Die Property contentDetails.note der Ressource playlistItem wurde aktualisiert. Die maximale Länge des Property-Werts beträgt jetzt 280 Zeichen.

  • Die Properties contentDetails.startAt und contentDetails.endAt der playlistItem-Ressource 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 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 gewährt.

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

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

  • In der Beschreibung der videos.insert-Methode wurde aktualisiert, dass die maximale Dateigröße für hochgeladene Videos von 64 GB auf 128 GB erhöht wurde.

• Neue und aktualisierte Fehler

  • Die API unterstützt die folgenden neuen Fehler:

    Fehlertyp	Fehlerdetails	Beschreibung
    forbidden (403)	homeParameterDeprecated	Die activities.list-Methode gibt diesen Fehler zurück, um anzugeben, dass die Daten zu den Aktivitäten auf der Startseite des Nutzers über diese API nicht verfügbar sind. Dieser Fehler kann auftreten, wenn Sie den Parameter home in einer nicht autorisierten Anfrage auf true setzen.
    invalidValue (400)	invalidContentDetails	Die playlistItems.insert-Methode 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 länger als 280 Zeichen ist.
    forbidden (403)	watchHistoryNotAccessible	Die playlistItems.list-Methode gibt diesen Fehler zurück, um anzugeben, dass bei der Anfrage versucht wurde, Playlist-Elemente aus dem Wiedergabeverlauf abzurufen, die aber nicht mit der API abgerufen werden können.
    forbidden (403)	watchLaterNotAccessible	Die playlistItems.list-Methode gibt diesen Fehler zurück, um anzugeben, dass bei der Anfrage versucht wurde, Playlist-Elemente vom Typ „Später ansehen“ abzurufen, die aber nicht mit der API abgerufen werden können.
    badRequest (400)	uploadLimitExceeded	Die Methode videos.insert gibt diesen Fehler zurück, um anzugeben, dass die Anzahl der Videos, die auf dem Kanal hochgeladen werden dürfen, überschritten wurde.
    forbidden (403)	forbiddenEmbedSetting	Die Methode videos.update gibt diesen Fehler zurück, um anzugeben, dass bei der API-Anfrage versucht wird, eine ungültige Einbettungseinstellung für das Video festzulegen. Einige Kanäle haben möglicherweise keine Berechtigung, 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 trat bisher bei einigen Playlists auf, z. B. bei den Lieblingsvideos, in denen keine Duplikate erlaubt waren, die aber nicht mehr unterstützt werden. Grundsätzlich sind in Playlists doppelte Videos zulässig.

• Weitere Updates

  • Der Eintrag im Änderungsverlauf vom 15. September 2016 wurde aktualisiert, um klarzustellen, dass die Eigenschaften contentDetails.relatedPlaylists.watchHistory und contentDetails.relatedPlaylists.watchLater der channel-Ressource in einer Antwort immer die Werte HL und WL enthalten. Außerdem sind diese Properties nur enthalten, wenn ein autorisierter Nutzer Daten zu seinem eigenen Kanal abruft.

15. September 2016

Dieses Update enthält die folgenden Änderungen:

• In der Änderungsverlaufsaktualisierung vom 11. August 2016 wurden mehrere Änderungen im Zusammenhang mit Themen-IDs beschrieben. Unter anderem wurde darauf hingewiesen, dass sich die unterstützten Themen-IDs ab dem 10. Februar 2017 ändern werden. Die Liste der unterstützten Themen wird bis zum 10. November 2016 veröffentlicht.

• Die folgenden Änderungen sind jetzt in Kraft. Diese Änderungen wurden in der Aktualisierung des Änderungsverlaufs am 11. August 2016 bekannt gegeben:

  • Wenn die activities.list-Methode mit dem Parameter home auf true festgelegt aufgerufen wird, enthält die API-Antwort jetzt Elemente, die einem abgemeldeten YouTube-Nutzer auf der Startseite angezeigt würden.

    Diese kleine Änderung soll die Nutzerfreundlichkeit verbessern. In dieser Aktualisierung wurde angegeben, dass Anfragen mit dem Parameter home eine leere Liste zurückgeben.

  • Die contentDetails.relatedPlaylists.watchHistory- und contentDetails.relatedPlaylists.watchLater-Properties der channel-Ressource enthalten jetzt für alle Kanäle die Werte HL und WL.

    Diese Properties sind nur für autorisierte Nutzer sichtbar, die Daten zu ihrem eigenen Kanal abrufen. Die Properties enthalten immer die Werte HL und WL, auch wenn ein autorisierter Nutzer Daten zu seinem eigenen Kanal abruft. Daher können die IDs des Wiedergabeverlaufs und der Playlists „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 oder die „Später ansehen“-Playlist eines Kanals jetzt leere Listen zurückgegeben. Das gilt für die neuen Werte HL und WL sowie für alle Wiedergabeverläufe oder Wiedergabelisten-IDs für „Später ansehen“, die dein API-Client möglicherweise bereits gespeichert hat.

• Das fileDetails.recordingLocation-Objekt der video-Ressource und seine untergeordneten Properties werden nicht mehr zurückgegeben. Bisher konnten diese Daten (wie das übergeordnete fileDetails-Objekt) nur vom Inhaber 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 („die aktualisierten Nutzungsbedingungen“) wurden im YouTube Engineering and Developers Blog ausführlich erläutert. Sie enthalten zahlreiche Änderungen an den aktuellen Nutzungsbedingungen. Neben den aktualisierten Nutzungsbedingungen, die am 10. Februar 2017 in Kraft treten, enthält dieses Update mehrere ergänzende Dokumente, in denen die Richtlinien erläutert werden, die Entwickler einhalten müssen.

  Die vollständigen neuen Dokumente sind im Versionsverlauf der aktualisierten Nutzungsbedingungen beschrieben. Außerdem werden in diesem Änderungsverlauf zukünftige Änderungen an den aktualisierten Nutzungsbedingungen oder an den zugehörigen Dokumenten erläutert. Über einen Link in diesem Dokument können Sie einen RSS-Feed mit Änderungen in diesem Änderungsverlauf abonnieren.

• Die Einstellung von Freebase und der Freebase API führt zu mehreren Änderungen im Zusammenhang mit Themen-IDs. Themen-IDs werden in den folgenden API-Ressourcen und -Methoden verwendet:

  • Im topicDetails-Teil der channel-Ressource werden die mit dem Kanal verknüpften Themen angegeben.
  • Im topicDetails-Teil der video-Ressource werden die Themen angegeben, die mit dem Video verknüpft sind.
  • Mit dem Parameter topicId der Methode search.list kannst du nach Videos oder Kanälen zu einem bestimmten Thema suchen.

  Die Änderungen an diesen Funktionen:

  • Ab dem 10. Februar 2017 gibt YouTube nur noch eine kleine Auswahl an Themen-IDs zurück, anstatt wie bisher eine viel detailliertere Auswahl. Diese unterstützten Themen umfassen übergeordnete Kategorien wie Sport oder Basketball, aber keine bestimmten Teams oder Spieler. Wir werden die unterstützten Themen ankündigen, damit Sie Zeit haben, Ihre App auf diese Änderung vorzubereiten.

  • Mit bereits abgerufenen Freebase-Themen-IDs können Sie bis zum 10. Februar 2017 nach Inhalten suchen. Danach können Sie jedoch nur noch die im vorherigen Punkt genannten Themen verwenden, um Suchergebnisse nach Thema abzurufen.

  • Wenn Sie nach dem 10. Februar 2017 versuchen, mit einer Themen-ID nach Ergebnissen zu suchen, die nicht zu den unterstützten Themen-IDs gehört, gibt die API eine leere Ergebnismenge zurück.

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

  • Über den Parameter home der Methode activities.list konnte ein autorisierter Nutzer den Aktivitätsfeed abrufen, der für diesen Nutzer auf der YouTube-Startseite angezeigt wird. Bei Anfragen, bei denen dieser Parameter nach dem 12. September 2016 verwendet wird, wird eine leere Liste zurückgegeben.

  • Die Properties contentDetails.relatedPlaylists.watchHistory und contentDetails.relatedPlaylists.watchLater der channel-Ressource sind nur für autorisierte Nutzer sichtbar, die Daten zu ihrem eigenen Kanal abrufen. Nach dem 12. September 2016 gibt contentDetails.relatedPlaylists.watchHistory den Wert HL und die Property contentDetails.relatedPlaylists.watchLater den Wert WL für alle Kanäle zurück.

    Anfragen zum Abrufen von Playlistdetails (playlists.list) für den Wiedergabeverlauf oder die „Später ansehen“-Playlist eines Kanals werden nach dem 12. September 2016 mit einer leeren Liste beantwortet. Anfragen zum Abrufen von Playlist-Elementen (playlistItems.list) in einer dieser Playlists geben nach diesem Datum ebenfalls eine leere Liste zurück. Das gilt für die neuen Werte HL und WL sowie für alle Wiedergabeverläufe oder Playlist-IDs für „Später ansehen“, die dein API-Client möglicherweise bereits gespeichert hat.

  • Das fileDetails.recordingLocation-Objekt der video-Ressource oder eine seiner untergeordneten Properties werden nach dem 12. September 2016 nicht mehr zurückgegeben. Diese Daten können nur vom Inhaber eines Videos abgerufen werden, da das übergeordnete fileDetails-Objekt nur vom Inhaber eines Videos abgerufen werden kann.

13. Juni 2016

Dieses Update enthält die folgenden Änderungen:

• Die Property contentDetails.googlePlusUserId der Ressource channel wird nicht mehr unterstützt. Bisher war die Property nur vorhanden, wenn der Kanal mit einem Google+-Profil verknüpft war. Nach der Einstellung ist das Attribut nicht mehr in channel-Ressourcen enthalten.

• Die Property snippet.authorGoogleplusProfileUrl der Ressource comment wird nicht mehr unterstützt. Bisher war die Property nur vorhanden, wenn der Kanal mit einem Google+-Profil verknüpft war. Nach der Einstellung ist das Attribut nicht mehr in comment-Ressourcen enthalten.

Da nach der Einstellung keine dieser Properties mehr zurückgegeben werden, wurden beide aus der entsprechenden Ressourcendokumentation entfernt.

31. Mai 2016

Dieses Update enthält die folgenden Änderungen:

• Mit dem neuen Parameter myRecentSubscribers der Methode subscriptions.list kannst du eine Liste der Abonnenten des Kanals des authentifizierten Nutzers in umgekehrter chronologischer Reihenfolge abrufen, d. h. nach dem Zeitpunkt, zu dem sie den Kanal abonniert haben.

  Hinweis: Mit dem neuen Parameter können nur die 1.000 neuesten Abonnenten des Kanals des authentifizierten Nutzers abgerufen werden. Mit dem Parameter mySubscribers kannst du eine vollständige Liste der Abonnenten abrufen. Dieser Parameter, mit dem Abonnenten nicht in einer bestimmten Reihenfolge zurückgegeben werden, schränkt die Anzahl der abrufbaren Abonnenten nicht ein.

• Die Definition der Property snippet.thumbnails.(key) wurde für die Ressourcen activity, playlistItem, playlist, search result, thumbnail und video aktualisiert. Für einige Videos sind jetzt zusätzliche Thumbnail-Bildgrößen verfügbar.

  • Das standard-Bild ist 640 Pixel breit und 480 Pixel hoch.
  • Das maxres-Bild ist 1.280 Pixel breit und 720 Pixel hoch.

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

• Die Methode videos.list gibt jetzt den Fehler forbidden (403) zurück, wenn bei einer nicht ordnungsgemäß autorisierten Anfrage versucht wird, die Teile fileDetails, processingDetails oder suggestions einer video-Ressource abzurufen. Diese Teile sind nur für den Inhaber 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 API-Methoden in Apps Script, Go, JavaScript, PHP, Python und Ruby verfügbar.

Für jede Methode werden Codebeispiele für einen oder mehrere Anwendungsfälle angezeigt. So enthält er beispielsweise fünf Code-Snippets für die Methode search.list:

• Videos nach Keyword auflisten
• Videos nach Standort auflisten
• Live-Veranstaltungen auflisten
• Nach den Videos des authentifizierten Nutzers suchen
• Ähnliche Videos auflisten

Für jeden Anwendungsfall werden die in der API-Anfrage verwendeten Parameter angezeigt. Sie können die Parameterwerte ändern. In diesem Fall aktualisiert das Tool die Code-Snippets entsprechend den von Ihnen angegebenen Parameterwerten.

Schließlich zeigt das Tool die API-Antwort auf jede Anfrage an. Wenn Sie die Anfrageparameter geändert haben, basiert die API-Antwort auf den von Ihnen angegebenen Parameterwerten. Sie müssen das Tool autorisieren, Anfragen in Ihrem Namen zu senden, damit API-Antworten angezeigt werden.

28. April 2016

Dieses Update enthält die folgenden Änderungen:

• Das neue Attribut contentDetails.projection der video-Ressource gibt das Projektionsformat des Videos an. Gültige Attributwerte sind 360 und rectangular.

• Die Properties recordingDetails.location und fileDetails.recordingLocation der video-Ressource wurden aktualisiert, um den Unterschied zwischen den beiden Properties zu erklären:

  • Die Property recordingDetails.location gibt den Ort an, den der Rechteinhaber mit dem Video verknüpfen möchte. Dieser Ort kann bearbeitet werden, ist in öffentlichen Videos suchbar und wird Nutzern bei öffentlichen Videos möglicherweise angezeigt.
  • Der Attributwert fileDetails.recordingLocation ist unveränderlich und entspricht dem Speicherort der ursprünglichen hochgeladenen Videodatei. Der Wert ist nur für den Inhaber des Videos sichtbar.

• Die Definition der Property contentDetails.relatedPlaylists.favorites der channel-Ressource wurde aktualisiert. Der Property-Wert kann jetzt auch eine Playlist-ID enthalten, die auf eine leere Playlist verweist und nicht abgerufen werden kann. Das liegt daran, dass die Funktion „Lieblingsvideos“ bereits eingestellt wurde. Hinweis: Diese Property unterliegt nicht der Richtlinie zur Einstellung von APIs.

• Die Definition des ineligibleAccount-Fehlers, der von den Methoden comments.insert, comments.update, commentThreads.insert oder commentThreads.update zurückgegeben werden kann, wurde aktualisiert. Der Fehler tritt auf, wenn das YouTube-Konto, das zur Autorisierung der API-Anfrage verwendet wurde, 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. Es wird nun darauf hingewiesen, dass auch localizations ein gültiger Wert für diesen Parameter ist.

• Der Abschnitt Kontingentnutzung im Leitfaden für den Einstieg wurde aktualisiert und enthält jetzt einen Link zur Google Developer Console, in der Sie Ihr tatsächliches Kontingent und die Kontingentnutzung sehen können.

16. März 2016

Dieses Update enthält die folgenden Änderungen:

• Aktualisierungen vorhandener Ressourcen und Methoden

  • Die channelBanner-Ressourcendokumentation wurde aktualisiert. Die empfohlene Größe für das hochgeladene Kanalbannerbild ist 2.560 × 1.440 Pixel. Die Mindestgröße (2.048 × 1.152 Pixel) hat sich nicht geändert.

  • Die neue Property snippet.customUrl der channel-Ressource gibt die benutzerdefinierte URL an, die mit dem Kanal verknüpft ist. (Nicht alle Kanäle haben benutzerdefinierte URLs.) In der YouTube-Hilfe erfährst du, welche Voraussetzungen du erfüllen musst, um eine benutzerdefinierte URL zu erhalten, und wie du sie 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 das Attribut regionCode. Die Property gibt den Regionscode an, der für die Suchanfrage verwendet wurde. Der Regionscode weist die API an, Suchergebnisse für das angegebene Land zurückzugeben.

    Der Property-Wert ist ein ISO-Ländercode aus zwei Buchstaben, der die Region angibt. Die Methode i18nRegions.list gibt eine Liste der unterstützten Regionen zurück. Der Standardwert ist US. Wenn eine nicht unterstützte Region angegeben ist, wählt YouTube möglicherweise eine andere Region anstelle des Standardwerts aus, um die Anfrage zu verarbeiten.

  • Die Definitionen der snippet.label- und snippet.secondaryReasons[].label-Attribute der videoAbuseReportReason-Ressource wurden aktualisiert. Es wird nun darauf hingewiesen, dass die Attribute lokalisierte Labeltexte für die Gründe für Missbrauchsmeldungen enthalten.

    Außerdem unterstützt die videoAbuseReportReasons.list-Methode jetzt den Parameter hl, mit dem die Sprache angegeben wird, die für den Labeltext in der API-Antwort verwendet werden soll. Der Standardparameterwert ist en_US.

  • Die neue Property contentDetails.contentRating.ecbmctRating der video-Ressource gibt die Altersfreigabe eines Videos durch die türkische Kommission für Bewertung und Klassifizierung des Ministeriums für Kultur und Tourismus an.

    Darüber hinaus unterstützen API-Properties für andere Altersfreigabesysteme die folgenden neuen Property-Werte:

    • contentDetails.contentRating.fpbRating (Südafrika)
      Bewertung: 10; Property-Wert: fpb10
    • contentDetails.contentRating.moctwRating (Taiwan)
      Altersfreigabe: R-12; Property-Wert: moctwR12
    • contentDetails.contentRating.moctwRating (Taiwan)
      Altersfreigabe: R-15; Property-Wert: moctwR15

  • Das Attribut liveStreamingDetails.activeLiveChatId der video-Ressource enthält die ID des aktiven Livechats, der mit dem Video verknüpft ist. Der Attributwert ist nur vorhanden, wenn es sich bei dem Video um eine aktuelle Liveübertragung handelt, bei der der Livechat aktiviert ist. Nach dem Ende der Übertragung und des Livechats wird die Property nicht mehr für das Video zurückgegeben.

  • Die Property status.rejectionReason der Ressource video unterstützt den neuen Property-Wert 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 Kanalbereich 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 für die in der API-Anfrage eingereichte channelSection-Ressource ein Wert für die Property snippet.style angegeben werden muss.
  badRequest (400)	typeRequired	Die Methoden channelSections.insert und channelSections.update geben diesen Fehler zurück, um anzugeben, dass für die in der API-Anfrage eingereichte channelSection-Ressource ein Wert für die Property snippet.type angegeben werden muss.
  badRequest (400)	processingFailure	Die commentThreads.list-Methode gibt diesen Fehler zurück, um anzugeben, dass der API-Server die Anfrage nicht erfolgreich verarbeiten konnte. Dies kann ein vorübergehender Fehler sein, weist aber in der Regel darauf hin, dass die Eingabe der Anfrage ungültig ist. Prüfen Sie die Struktur der commentThread-Ressource im Anfragetext, um sicherzustellen, dass sie gültig ist.
  forbidden (403)	commentsDisabled	Die Methode commentThreads.list gibt diesen Fehler zurück, um anzugeben, dass für das mit dem 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 comment-Ressource in der snippet.topLevelComment.snippet.textOriginal-Eigenschaft zu viele Zeichen enthält.
  invalidValue (400)	videoAlreadyInAnotherSeriesPlaylist	Die Methode playlistItems.insert gibt diesen Fehler zurück, um anzugeben, dass das Video, das du der Playlist hinzufügen möchtest, bereits in einer anderen Serien-Playlist enthalten ist. Weitere Informationen zu Serienplaylists findest du in der YouTube-Hilfe.
  badRequest (400)	subscriptionForbidden	Die Methode subscriptions.insert gibt diesen Fehler zurück, wenn die maximale Anzahl von Abos erreicht ist oder du in letzter Zeit zu viele Abos erstellt hast. In diesem Fall können Sie die Anfrage nach einigen Stunden noch einmal versuchen.
  badRequest (400)	invalidCategoryId	Die Methode videos.update gibt diesen Fehler zurück, um anzugeben, dass für das Attribut snippet.categoryId in der hochgeladenen video-Ressource eine ungültige Kategorie-ID angegeben wurde. 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 für die Property snippet.description in der hochgeladenen video-Ressource ein ungültiger Wert angegeben wurde.
  badRequest (400)	invalidPublishAt	Die videos.update-Methode gibt diesen Fehler zurück, um anzugeben, dass für die Property status.publishAt in der hochgeladenen video-Ressource eine ungültige geplante Veröffentlichungszeit angegeben wurde.
  badRequest (400)	invalidRecordingDetails	Die videos.update-Methode 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 für die Property snippet.tags in der hochgeladenen video-Ressource ein ungültiger Wert angegeben wurde.
  badRequest (400)	invalidTitle	Die videos.update-Methode gibt diesen Fehler zurück, um anzugeben, dass für die snippet.title-Eigenschaft in der hochgeladenen video-Ressource ein ungültiger oder leerer Videotitel angegeben wurde.
  badRequest (400)	invalidVideoMetadata	Die videos.update-Methode gibt diesen Fehler zurück, um anzugeben, dass die Anfragemetadaten ungültig sind. Dieser Fehler tritt auf, wenn mit der Anfrage der snippet-Teil einer video-Ressource aktualisiert wird, aber kein Wert für die Eigenschaften snippet.title und snippet.categoryId festgelegt wird.

18. Dezember 2015

Gemäß den Gesetzen der Europäischen Union (EU) müssen Endnutzer in der EU bestimmte Informationen erhalten und ihre Einwilligung erteilt haben. Daher müssen Sie für Endnutzer in der Europäischen Union die Richtlinie zur Einwilligung der Nutzer in der EU einhalten. Wir haben in unseren Nutzungsbedingungen für die YouTube API einen Hinweis auf diese Anforderung aufgenommen.

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, das Attribut snippet.title der Ressource channelSection und das Attribut 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. So legen Sie lokalisierte Werte für eine Ressource fest:

  • Achten Sie darauf, dass für die Property snippet.defaultLanguage der Ressource ein Wert festgelegt ist. Dieses Attribut gibt die Sprache der snippet.title- und snippet.description-Properties der Ressource an. Der Wert kann eine unterstützte Anwendungssprache oder die meisten anderen ISO 639-1:2002-Sprachcodes sein. Wenn du beispielsweise ein Video mit einem englischen Titel und einer englischen Beschreibung hochlädst, setzt du die Property snippet.defaultLanguage auf en.

    Hinweis zum Aktualisieren von channel-Ressourcen:Wenn Sie die snippet.defaultLanguage-Eigenschaft für eine channel-Ressource festlegen möchten, müssen Sie die brandingSettings.channel.defaultLanguage-Eigenschaft aktualisieren.

  • Fügen Sie der Ressource, die Sie aktualisieren möchten, das localizations-Objekt hinzu. Jeder Objektschlüssel ist ein String, der eine Anwendungssprache oder einen ISO 639-1:2002-Sprachcode identifiziert. Jeder Schlüssel wird einem Objekt zugeordnet, das den lokalisierten Titel (und die Beschreibung) für die Ressource enthält.

    Im folgenden Beispiel wird die Standardsprache der Ressource auf Englisch festgelegt. Außerdem werden dem Video lokalisierte Titel und Beschreibungen auf Deutsch und Spanisch 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 du beispielsweise eine weitere Anfrage sendest, um dem Video im Beispiel oben portugiesische Daten hinzuzufügen, 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ügen Sie der channels.list-, channelSections.list-, playlists.list- oder videos.list-Anfrage den Parameter hl hinzu, um lokalisierte Daten für eine bestimmte Anwendungssprache abzurufen, die von der YouTube-Website unterstützt wird. 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, mit einer videos.list-Anfrage wurden Daten für das oben beschriebene Video mit lokalisierten deutschen und spanischen Daten abgerufen. Wenn der Parameter hl auf de festgelegt ist, enthält die Ressource die folgenden Daten:

    {
      "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"
        }
        ...
      }
    }

    Wenn der Parameter hl jedoch auf fr festgelegt ist, enthält das snippet.localized-Objekt den englischen Titel und die englische Beschreibung, da Englisch die Standardsprache der Ressource ist und keine lokalisierten französischen Details verfügbar sind.

    Wichtig:Der Parameter hl unterstützt nur Werte, die Anwendungssprachen angeben, die von der YouTube-Website unterstützt werden. Wenn Sie feststellen möchten, ob lokalisierter Text für andere Sprachen verfügbar ist, müssen Sie den Teil localizations der Ressource abrufen und filtern, um festzustellen, ob der lokalisierte Text vorhanden ist.
    
    Sie müssen beispielsweise die vollständige Liste der Lokalisierungen abrufen, um festzustellen, ob lokalisierter Text auf Appalachian English verfügbar ist.
    
    

  • Wenn Sie eine Ressource abrufen, geben Sie localizations in den Parameterwert part ein, um alle lokalisierten Details für diese Ressource abzurufen. Wenn du lokalisierte Daten für eine Sprache abrufen möchtest, die nicht zu den aktuellen Sprachen der YouTube-Anwendung gehört, musst du mit diesem Ansatz alle Lokalisierungen abrufen und dann herausfiltern, 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 gibt an, dass eine Anfrage, bei der versucht wird, das localizations-Objekt für eine Ressource einzufügen oder zu aktualisieren, fehlschlägt, weil die snippet.defaultLanguage-Eigenschaft 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 gibt an, dass einer der Werte im localizations-Objekt einer Ressource nicht validiert werden konnte. Dieser Fehler kann beispielsweise auftreten, wenn das Objekt einen ungültigen Sprachcode enthält. Die 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 vorhandener Ressourcen und Methoden

  • Der Parameter order der Methode search.list wurde aktualisiert. Wenn du Livestreams nach viewCount sortierst, werden die API-Ergebnisse nach der Anzahl der gleichzeitigen Zuschauer sortiert, während die Livestreams noch laufen.

  • Der Parameter relatedToVideoId der Methode search.list wurde aktualisiert. Wenn dieser Parameter festgelegt ist, sind nur die Parameter part, maxResults, pageToken, regionCode, relevanceLanguage, safeSearch, type (muss auf video festgelegt sein) und fields zulässig. Diese Aktualisierung spiegelt keine Änderung des API-Verhaltens wider.

  • Die Definition der Property snippet.publishedAt der Ressource video wurde aktualisiert. Der Property-Wert, der das Datum und die Uhrzeit der Veröffentlichung des Videos angibt, kann sich jetzt von der Zeit unterscheiden, zu der das Video hochgeladen wurde. Wenn ein Video beispielsweise als privates Video hochgeladen und später veröffentlicht wird, gibt der Property-Wert an, wann das Video veröffentlicht wurde. In der aktualisierten Definition wird auch erläutert, wie der Wert für private und nicht gelistete Videos ermittelt wird.

    Diese Änderung hat keine Auswirkungen auf das API-Verhalten.

  • Die Definition der Eigenschaft status.publishAt der Ressource video wurde aktualisiert. Beachten Sie Folgendes:

    • Wenn du den Wert dieser Property beim Aufrufen der videos.update-Methode festlegst, musst du auch den Wert der Property status.privacyStatus auf private setzen, auch wenn das Video bereits privat ist.
    • Wenn in der Anfrage die Veröffentlichung eines Videos für eine Zeit in der Vergangenheit geplant ist, wird es sofort veröffentlicht. Wenn du also das Datum und die Uhrzeit für die Property „status.publishAt“ auf ein Datum in der Vergangenheit festlegst, hat das denselben Effekt wie das Ändern des privacyStatus-Werts des Videos von private in public.

  • Die Property contentDetails.contentRating.cncRating der video-Ressource gibt die Altersfreigabe des Videos durch die französische Commission de classification cinématographique an. Dieses Attribut ersetzt das Attribut contentDetails.contentRating.fmocRating, das eingestellt wird.

  • Die Definition von brandingSettings.channel.keywords in der Ressource channel 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 zuvor dokumentiert. Diese Aktualisierung spiegelt keine Änderung des API-Verhaltens wider.

  • Die Dokumentation für die thumbnails.set-Methode wurde aktualisiert, um korrekt zu verdeutlichen, dass der Anfragetext das Thumbnail-Bild enthält, das du hochlädst und mit einem Video verknüpfst. Der Anfragetext enthält keine thumbnail-Ressource. Bisher stand in der Dokumentation, dass beim Aufrufen dieser Methode kein Anfragetext angegeben werden sollte. Diese Aktualisierung spiegelt keine Änderung des API-Verhaltens wider.

  • Die Beschreibung der activity-Ressource wurde aktualisiert, da die activities.list-Methode derzeit keine Ressourcen zu neuen Videokommentaren enthält. Auch snippet.type und contentDetails.comment der Ressource wurden aktualisiert.

• Neue und aktualisierte Fehler

  • Die API unterstützt jetzt die folgenden Fehler:

    Fehlerdetails
    activities.insert	HTTP-Antwortcode badRequest (400) Grund invalidMetadata Beschreibung Die kind-Property stimmt nicht mit dem angegebenen ID-Typ überein.
    commentThreads.update comments.insert comments.update	HTTP-Antwortcode badRequest (400) Grund commentTextTooLong Beschreibung Die comment-Ressource, die eingefügt oder aktualisiert wird, enthält in der Property snippet.topLevelComment.snippet.textOriginal zu viele Zeichen.
    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 verboten oder die Anfrage ist nicht ordnungsgemäß autorisiert.
    search.list	HTTP-Antwortcode badRequest (400) Grund invalidLocation Beschreibung Der Parameterwert für location und/oder locationRadius ist falsch formatiert.
    search.list	HTTP-Antwortcode badRequest (400) Grund invalidRelevanceLanguage Beschreibung Der Wert des Parameters relevanceLanguage ist falsch formatiert.
    subscriptions.insert	HTTP-Antwortcode badRequest (400) Grund subscriptionForbidden Beschreibung Dieser Fehler tritt in folgenden Fällen auf: Das Abo, das Sie erstellen möchten, ist bereits vorhanden Sie haben bereits die maximale Anzahl von Abos erreicht Du versuchst, deinen eigenen Kanal zu abonnieren. Das ist nicht möglich. Sie haben in letzter Zeit zu viele Abos erstellt und müssen einige Stunden warten, bevor Sie die Anfrage wiederholen können.
    videos.update	HTTP-Antwortcode badRequest (400) Grund invalidDefaultBroadcastPrivacySetting Beschreibung Bei der Anfrage wird versucht, eine ungültige Datenschutzeinstellung für die Standardübertragung festzulegen.

28. August 2015

Dieses Update enthält die folgenden Änderungen:

• Aktualisierungen vorhandener Ressourcen und Methoden

  • Die Property statistics.favoriteCount der Ressource video wird nicht mehr unterstützt.

    Gemäß unserer Einstellungsrichtlinie ist diese Property noch mindestens ein Jahr nach dieser Ankündigung in den video-Ressourcen enthalten. Der Attributwert ist jetzt jedoch immer auf 0 festgelegt.

7. August 2015

Dieses Update enthält die folgenden Änderungen:

• Aktualisierungen vorhandener Ressourcen und Methoden

  • Die Definition des Attributs snippet.tags[] der Ressource video wurde aktualisiert. Sie enthält jetzt mehr Informationen dazu, wie der API-Server die Länge des Attributwerts berechnet. Diese Änderung hat keine Auswirkungen auf das Verhalten der API.

    Insbesondere wird jetzt erläutert, dass der API-Server den Tag-Wert behandelt, als wäre er in Anführungszeichen gesetzt, wenn ein Tag einen Leerraum enthält. Die Anführungszeichen werden auf die Zeichenbeschränkung angerechnet. Unter Berücksichtigung der Zeichenbeschränkung enthält das Tag „Foo-Baz“ also sieben Zeichen, das Tag „Foo Baz“ hingegen neun.

  • Die Methode commentThreads.insert unterstützt den Parameter shareOnGooglePlus nicht mehr. Dieser Parameter gab zuvor an, ob ein Kommentar und Antworten auf diesen Kommentar auch im Google+-Profil des Autors gepostet werden sollten. Wenn der Parameter in einer Anfrage gesendet wird, ignoriert der API-Server ihn, verarbeitet die Anfrage aber ansonsten.

18. Juni 2015

Dieses Update enthält die folgenden Änderungen:

• Aktualisierungen vorhandener Ressourcen und Methoden

  • Der neue Parameter order der Methode commentThreads.list gibt die Reihenfolge an, in der Kommentarthreads in der API-Antwort aufgeführt werden sollen. Threads können nach Zeit oder Relevanz sortiert werden. Standardmäßig werden sie nach Zeit sortiert.

  • Das neue Attribut snippet.defaultAudioLanguage der Ressource video gibt die Sprache an, die im Standardaudiotrack des Videos gesprochen wird.

  • Die Definition des Attributs contentDetails.licensedContent der Ressource video wurde aktualisiert. Es wird jetzt klargestellt, dass die Inhalte ursprünglich auf einen Kanal hochgeladen werden müssen, der mit einem YouTube-Contentpartner verknüpft ist, und dass dieser Partner dann Anspruch darauf erheben muss. Das tatsächliche API-Verhalten ändert sich dadurch nicht.

  • 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 gewährt.

• 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 seine E-Mail-Adresse bestätigen, bevor er das Video bewerten kann.
    videos.rate	HTTP-Antwortcode badRequest (400) Grund videoPurchaseRequired Beschreibung Videos, die du dir ausgeliehen hast, können nur von dir bewertet werden.

  • 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 wurde. Mit der Methode videoAbuseReportReasons.list kannst du eine Liste aller Gründe abrufen, aus denen Videos gemeldet werden könnten.

  • Mit der neuen videos.reportAbuse-Methode können Sie Videos mit missbräuchlichen Inhalten melden. Der Anfragetext enthält ein JSON-Objekt, das das gemeldete Video sowie den Grund dafür angibt, dass es als missbräuchlich eingestuft wurde. Gültige Gründe können mit der oben beschriebenen Methode videoAbuseReportReason.list abgerufen werden.

    Der Leitfaden zur Migration wurde ebenfalls um ein Beispiel für die Meldung eines missbräuchlichen Videos ergänzt. Durch diese Änderung unterstützt die V3-API jetzt alle Funktionen der V2-API, die sie unterstützen soll. Diese Funktionen werden auch im Migrationsleitfaden erläutert.

• Aktualisierungen vorhandener Ressourcen und Methoden

  • Der neue Filterparameter forDeveloper der Methode search.list schränkt die Suche so ein, dass nur Videos zurückgegeben werden, die über die Anwendung oder Website des Entwicklers hochgeladen wurden. Der Parameter forDeveloper kann in Kombination mit optionalen Suchparametern wie dem Parameter q verwendet werden.

    Bei dieser Funktion wird jedes hochgeladene Video automatisch mit der Projektnummer getaggt, die der Anwendung des Entwicklers in der Google Developers Console zugewiesen ist.

    Wenn in einer Suchanfrage der Parameter forDeveloper anschließend auf true festgelegt wird, verwendet der API-Server die Autorisierungsdaten 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, aber nicht identische Funktionen wie die Entwickler-Tags, die von der V2 API unterstützt wurden.

  • Mit der neuen Property snippet.country 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 das Targeting auf channelSection-Ressourcen. Mit dem Targeting auf einen Kanalbereich 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 Spracheingaben für YouTube-Anwendungen. Nutzer, die eine dieser Sprachen ausgewählt haben, sehen den entsprechenden Kanalbereich.

    • targeting.regions[]: Eine Liste der Regionen mit bevorzugten Inhalten auf YouTube. Der Kanalbereich 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 wird.

    • targeting.countries[]: Eine Liste der Länder, in denen der Kanalbereich sichtbar ist. Jeder Wert in der Liste ist ein ALPHA-2-Ländercode nach ISO 3166-1.

  • Die Definition des Attributs contentDetails.duration der Ressource video wurde korrigiert, um zu verdeutlichen, dass der Wert Stunden, Tage usw. umfassen kann.

  • Die Dokumentation für die Methoden channelSections.delete, playlistItems.delete, playlists.delete, subscriptions.delete und videos.delete wurde korrigiert, um zu verdeutlichen, dass bei Erfolg mit diesen Methoden immer ein HTTP-204-Antwortcode (No Content) zurückgegeben wird.

• 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 channelSection-Ressource 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 channelSection-Ressource 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 channelSection-Ressource 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 Kommentar auf oberster Ebene einfügen kann, der durch das Attribut snippet.parentId angegeben ist. 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 im Parameter channelId in der Anfrage eine ungültige Kanal-ID angegeben wurde.
    badRequest (400)	subscriptionForbidden	Die subscriptions.insert-Methode gibt diesen Fehler zurück, wenn der API-Nutzer versucht, seinen eigenen Kanal zu abonnieren.

  • Die captions.update-Methode unterstützt die Fehler invalidMetadata und videoNotFound nicht mehr.

16. April 2015

Dieses Update enthält die folgenden Änderungen:

• Der Migrationsleitfaden wurde aktualisiert. Darin wird jetzt erklärt, wie Anwendungen migriert werden, die noch die Kommentarfunktion der v2 API verwenden.

  Der Leitfaden enthält auch mehrere Kommentarfunktionen, die von der v2 API nicht unterstützt wurden, aber von der v3 API unterstützt werden. Dazu gehören:

  • Kommentare zu einem Kanal abrufen
  • Es werden alle Kommentarthreads abgerufen, die sich auf einen Kanal beziehen. Die API-Antwort kann also Kommentare zum Kanal oder zu seinen Videos enthalten.
  • Text eines Kommentars aktualisieren
  • Kommentare als Spam markieren
  • Moderationsstatus eines Kommentars festlegen

• Der Leitfaden Push-Benachrichtigungen abonnieren wurde aktualisiert, da Benachrichtigungen nicht wie zuvor angegeben auch an den Superfeedr-Hub gesendet werden, sondern nur an den Google PubSubHubBub-Hub.

9. April 2015

Dieses Update enthält die folgenden Änderungen:

• Mit den neuen Ressourcen commentThread und comment der API kannst du Kommentare abrufen, einfügen, aktualisieren, löschen und moderieren.

  • Eine commentThread-Ressource enthält Informationen zu einem YouTube-Kommentar-Thread, der einen Kommentar auf oberster Ebene und ggf. Antworten auf diesen Kommentar enthält. Eine commentThread-Ressource kann Kommentare zu einem Video oder zu einem Kanal enthalten.

    Der Kommentar auf oberster Ebene und die Antworten sind tatsächlich comment-Ressourcen, die in der commentThread-Ressource verschachtelt sind. Die commentThread-Ressource enthält nicht unbedingt alle Antworten auf einen Kommentar. Wenn du alle Antworten für einen bestimmten Kommentar abrufen möchtest, musst du die Methode comments.list verwenden. Außerdem haben einige Kommentare keine Antworten.

    Die API unterstützt die folgenden Methoden für commentThread-Ressourcen:

    • commentThreads.list – Liste der Kommentarthreads abrufen Mit dieser Methode kannst du Kommentare abrufen, die mit einem bestimmten Video oder Kanal verknüpft sind.
    • commentThreads.insert – Erstellen Sie einen neuen Kommentar auf oberster Ebene. Mit der Methode comments.insert kannst du auf einen vorhandenen Kommentar antworten.
    • commentThreads.update: 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 zu einem Kanal darstellen. Außerdem kann es sich um einen Kommentar auf oberster Ebene oder um eine Antwort auf einen Kommentar auf oberster Ebene handeln.

    Die API unterstützt die folgenden Methoden für comment-Ressourcen:

    • comments.list – Liste der Kommentare abrufen Mit dieser Methode kannst du alle Antworten auf einen bestimmten Kommentar abrufen.
    • comments.insert: Hiermit kannst du auf einen vorhandenen Kommentar antworten.
    • comments.update: Kommentar ändern
    • comments.markAsSpam: Du kannst einen oder mehrere Kommentare als Spam melden.
    • comments.setModerationStatus: Hiermit kannst du den Moderationsstatus eines oder mehrerer Kommentare festlegen. Sie können beispielsweise einen Kommentar für die öffentliche Anzeige freigeben oder einen Kommentar als ungeeignet für die Anzeige ablehnen. Die API-Anfrage muss vom Inhaber des Kanals oder des Videos autorisiert werden, mit dem die Kommentare verknüpft sind.
    • comments.delete: Mit dieser Option kannst du einen Kommentar löschen.

  Der neue https://www.googleapis.com/auth/youtube.force-ssl-Umfang der API, der im Versionsverlauf vom 2. April 2015 beschrieben ist, ist für Aufrufe der Methoden comments.insert, comments.update, comments.markAsSpam, comments.setModerationStatus, comments.delete, commentThreads.insert und commentThreads.update erforderlich.

• Im neuen Leitfaden Push-Benachrichtigungen abonnieren wird die neue Unterstützung der API für Push-Benachrichtigungen über PubSubHubBub beschrieben, ein Server-zu-Server-Publish-Subscribe-Protokoll für webzugängliche Ressourcen. Dein PubSubHubBub-Callback-Server kann Atom-Feed-Benachrichtigungen erhalten, wenn ein Kanal eine der folgenden Aktivitäten ausführt:

  • ein Video hochlädt
  • den Titel eines Videos aktualisiert
  • Beschreibung eines Videos aktualisiert

• Der Migrationsleitfaden wurde ebenfalls aktualisiert, um die neue Unterstützung für Push-Benachrichtigungen zu berücksichtigen. Da die V2 API jedoch zahlreiche andere Arten von Push-Benachrichtigungen unterstützte, die in der V3 API nicht unterstützt werden, wird die Unterstützung von PubSubHubBub in diesem Leitfaden weiterhin im Abschnitt Eingestellt aufgeführt.

• Der neue https://www.googleapis.com/auth/youtube.force-ssl-Zugriffsbereich der API ist jetzt ein gültiger Bereich für alle API-Methoden, die zuvor den https://www.googleapis.com/auth/youtube-Zugriffsbereich unterstützten.

• 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 enthält.

• Die Methode subscriptions.insert unterstützt den Fehler subscriptionLimitExceeded nicht mehr. Dieser Fehler gab zuvor an, dass der mit der Anfrage angegebene Abonnent das Limit für die Aborate überschritten hat.

2. April 2015

Dieses Update enthält die folgenden Änderungen:

• Die neue captions-Ressource stellt einen YouTube-Untertiteltrack dar. Ein Untertiteltrack ist genau einem YouTube-Video zugeordnet.

  Die API unterstützt Methoden zum Auflisten, Einfügen, Aktualisieren, Herunterladen und Löschen von Untertiteltracks.

• Die Migrationsanleitung wurde ebenfalls aktualisiert. Dort wird jetzt beschrieben, wie Anwendungen migriert werden, in denen noch die Untertitelfunktion der v2 API verwendet wird.

• Für den neuen https://www.googleapis.com/auth/youtube.force-ssl-Umfang der API muss die Kommunikation mit dem API-Server über eine SSL-Verbindung erfolgen.

  Dieser neue Umfang gewährt denselben Zugriff wie der Umfang https://www.googleapis.com/auth/youtube. Diese beiden Bereiche sind funktional identisch, da der YouTube API-Server nur über einen HTTPS-Endpunkt verfügbar ist. Obwohl für den Bereich https://www.googleapis.com/auth/youtube keine SSL-Verbindung erforderlich ist, gibt es keine andere Möglichkeit, eine API-Anfrage zu stellen.

  Der neue Umfang ist für Aufrufe aller Methoden der caption-Ressource erforderlich.

11. März 2015

Dieses Update enthält die folgenden Änderungen:

• Der Migrationsleitfaden für die YouTube Data API (Version 3) enthält einen neuen Tab namens Neu in der Version 3 der API. Dort sind Funktionen aufgeführt, die von der Version 3 der API unterstützt werden, von der Version 2 aber nicht. Dieselben Funktionen waren zuvor und sind weiterhin auf anderen Tabs im Leitfaden aufgeführt. Auf dem Tab Kanäle (Profile) findest du beispielsweise eine neue Funktion, mit der du die Daten zu In-Video-Werbekampagnen eines Kanals aktualisieren kannst.

• Der Migrationsleitfaden für die YouTube Data API (Version 3) wurde aktualisiert. Die v3 API unterstützt jetzt die folgenden Funktionen der v2 API:

  • Videos melden

• Der Leitfaden zur Migration zur YouTube Data API (Version 3) wurde aktualisiert. Die folgenden v2 API-Funktionen werden in der v3 API nicht unterstützt:

  • Videoempfehlungen abrufen: Die V3 API ruft keine Liste ab, die nur Videos enthält, die für den aktuellen API-Nutzer empfohlen werden. Mit der V3 API kannst du jedoch empfohlene Videos finden, indem du die Methode activities.list aufrufst und den Parameterwert home auf true festlegst.

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

  • Kanalvorschläge abrufen

  • Neue Abovideos abrufen: Die V3 API ruft keine Liste ab, die nur Videos enthält, die vor Kurzem auf Kanäle hochgeladen wurden, die der API-Nutzer abonniert. Mit der Version 3 der API kannst du jedoch neue Abovideos finden, indem du die Methode activities.list aufrufst und den Parameterwert home auf true festlegst.

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

  • Unterstützung von RSS-Feeds

  • Push-Benachrichtigungen für Feedupdates: Die V2 API unterstützte Push-Benachrichtigungen, die entweder mit dem Simple Update Protocol (SUP) oder PubSubHubbub gesendet wurden, um Feeds mit Nutzeraktivitäten für YouTube-Nutzer zu überwachen. Es gab Benachrichtigungen zu neuen Kanalabonnements und wenn Videos bewertet, geteilt, zu Favoriten hinzugefügt, kommentiert oder hochgeladen wurden.

    Die V3 API unterstützt Push-Benachrichtigungen über das PubSubHubbub-Protokoll. Die Benachrichtigungen beziehen sich jedoch nur auf Videouploads und Aktualisierungen von Videotiteln oder Videobeschreibungen.

  • Standort des Kanals: In der v2 API wurde das Tag <yt:location> verwendet, um den Standort des Nutzers anhand der Angaben im öffentlichen YouTube-Profil des Kanals zu ermitteln. Einige Entwickler haben dieses Feld verwendet, um einen Kanal einem bestimmten Land zuzuordnen. Die Daten des Felds konnten jedoch nicht einheitlich für diesen Zweck verwendet werden.

  • Entwickler-Tags festlegen oder abrufen: Mit der Version 2 der API konnten beim Hochladen eines Videos Keywords oder Entwickler-Tags 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. Insbesondere können Entwickler nach Videos suchen, die über die eigene App des Entwicklers hochgeladen wurden. Bei dieser Funktion wird jedes hochgeladene Video automatisch mit der Projektnummer getaggt, die der Anwendung des Entwicklers in der Google Developers Console zugewiesen ist. Der Entwickler verwendet dann dieselbe Projektnummer, um nach Videos zu suchen.

  • Videos nach Veröffentlichungsdatum, Aufrufzahl oder Bewertung auflisten: Mit dem Parameter orderby in der V2 API kannst du Videos in einer Playlist nach Position, Dauer, Veröffentlichungsdatum, Titel und mehreren anderen Werten sortieren. In der V3 API werden Playlist-Elemente in der Regel in aufsteigender Reihenfolge nach Position sortiert. Andere Sortieroptionen sind nicht verfügbar.

    Es gibt jedoch einige Ausnahmen. Bei den folgenden Arten von Playlists wird automatisch ein neuer Upload, ein Lieblingsvideo, ein Video, das du mit „Mag ich“ markiert hast, oder ein Video, das du dir vor Kurzem angesehen hast, als erstes Element (snippet.position=0) hinzugefügt. Jede dieser Listen ist also in der Reihenfolge vom neuesten zum ältesten Element sortiert, basierend darauf, wie oft Elemente der Liste hinzugefügt wurden.

    • Uploads von Nutzern
    • Lieblingsvideos
    • positiv bewertete Videos
    • Wiedergabeverlauf

    Hinweis: Ein neuer Artikel, der der Playlist „Später ansehen“ hinzugefügt wird, wird als letzter Artikel in dieser Liste hinzugefügt. Die Liste ist also nach dem ältesten bis zum neuesten Artikel sortiert.

  • Batchverarbeitung: Die v3 API unterstützt einen der Anwendungsfälle für die Batchverarbeitung, die auch von der v2 API unterstützt wurde. Die Methoden channels.list, channelSections.list, guideCategories.list, playlistItems.list, playlists.list, subscriptions.list, videoCategories.list und videos.list der V3 API unterstützen alle den Parameter id, mit dem eine kommagetrennte 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.

  Durch diese Änderungen werden in der Anleitung jetzt alle Funktionen aufgeführt, die in der alten API (Version 2) unterstützt wurden, aber in der aktuellen API-Version (Version 3) 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 mehrere andere Methoden unterstützt wird.

• Die folgenden Properties und ihre untergeordneten Properties wurden eingestellt:

  • brandingSettings.image.backgroundImageUrl
  • brandingSettings.image.largeBrandedBannerImageImapScript
  • brandingSettings.image.largeBrandedBannerImageUrl
  • brandingSettings.image.smallBrandedBannerImageImapScript
  • brandingSettings.image.smallBrandedBannerImageUrl

  Hinweis: Keine dieser Properties war von der Richtlinie zur Einstellung der API betroffen.

• In der neuen Property contentDetails.contentRating.contentDetails.contentRating.djctqRatingReasons der Ressource video werden die Gründe angegeben, aus denen das Video die DJCQT-Altersfreigabe (Brasilien) erhalten hat.

• Die API unterstützt jetzt die folgenden Fehler:

  Fehlertyp	Fehlerdetails	Beschreibung
  notFound (404)	channelNotFound	Die channels.update-Methode gibt diesen Fehler zurück, wenn im id-Parameter der Anfrage ein Kanal angegeben ist, der nicht gefunden werden kann.
  badRequest (400)	manualSortRequiredinvalidValue	Die Methoden playlistItems.insert und playlistItems.update geben diesen Fehler zurück, wenn in der Anfrage versucht wird, die Position des Playlist-Elements festzulegen, die Playlist aber nicht manuell sortiert wird. Playlist-Elemente können beispielsweise nach Datum oder Beliebtheit sortiert werden. Sie können diesen Fehler beheben, indem Sie das Element snippet.position aus der im Anfragetext gesendeten Ressource entfernen. Wenn das Playlist-Element eine bestimmte Position in der Liste haben soll, musst du zuerst die Sortiereinstellung der Playlist auf Manuell aktualisieren. Diese Einstellung kann im YouTube-Video-Manager angepasst werden.
  forbidden (403)	channelClosed	Die Methode playlists.list gibt diesen Fehler zurück, wenn im channelId-Parameter der Anfrage ein geschlossener Kanal angegeben ist.
  forbidden (403)	channelSuspended	Die Methode playlists.list gibt diesen Fehler zurück, wenn im channelId-Parameter der Anfrage ein gesperrter Kanal angegeben ist.
  forbidden (403)	playlistForbidden	Die playlists.list-Methode gibt diesen Fehler zurück, wenn der id-Parameter der Anfrage die Anfrage nicht unterstützt oder die Anfrage nicht ordnungsgemäß autorisiert ist.
  notFound (404)	channelNotFound	Die playlists.list-Methode gibt diesen Fehler zurück, wenn im channelId-Parameter der Anfrage ein Kanal angegeben ist, der nicht gefunden werden kann.
  notFound (404)	playlistNotFound	Die playlists.list-Methode gibt diesen Fehler zurück, wenn im id-Parameter der Anfrage eine Playlist angegeben ist, die nicht gefunden werden kann.
  notFound (404)	videoNotFound	Die videos.list-Methode gibt diesen Fehler zurück, wenn im id-Parameter der Anfrage ein Video angegeben ist, das nicht gefunden werden kann.
  badRequest (400)	invalidRating	Die Methode videos.rate gibt diesen Fehler zurück, wenn die Anfrage einen unerwarteten Wert für den Parameter rating enthält.

2. März 2015

Dieses Update enthält die folgenden Änderungen:

• Die search.list-Methode unterstützt jetzt den Parameter relevanceLanguage, mit dem Sie Ergebnisse anfordern können, die für eine bestimmte Sprache am relevantesten sind.

  Der Migrationsleitfaden für die YouTube Data API (Version 3) wurde ebenfalls aktualisiert und enthält jetzt eine Anleitung zur Verwendung dieses neuen Parameters. Mit dem Parameter wird eine Funktionslücke geschlossen, die bisher 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. Darin wird darauf hingewiesen, dass die besonderen Feeds und Metadatenfelder, die in der Version 2 der API zur Beschreibung von Filmen, Trailern, Serien, Serienstaffeln und Serienfolgen bereitgestellt wurden, eingestellt werden.

14. Januar 2015

Dieses Update enthält die folgenden Änderungen:

• Der Migrationsleitfaden für die YouTube Data API (Version 3) wurde aktualisiert. Darin wird jetzt erklärt, wie du mit der Version 3 der API Videos mit JavaScript hochladen kannst. Weitere Informationen finden Sie im Abschnitt Video hochladen. Diese Funktion ist mit dem browserbasierten Hochladen vergleichbar, das von der v2 API unterstützt wird. Diese Änderung am Migrationsleitfaden spiegelt keine tatsächliche API-Änderung wider, sondern die Verfügbarkeit neuen Beispielcodes zum Hochladen von Videos mit clientseitigem JavaScript.

  Da das Hochladen von Videos mit der JavaScript-Clientbibliothek und CORS unterstützt wird, wird das browserbasierte Hochladen im Migrationsleitfaden nicht mehr als Funktion aufgeführt, die in der API v3 möglicherweise eingestellt wird.

• Die Dokumentation für die Methode videos.insert wurde um das oben beschriebene neue JavaScript-Codebeispiel ergänzt. Auch die Liste der JavaScript-Codebeispiele für die YouTube Data API (Version 3) wurde 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 zu niedrigeren Kontingentkosten abzurufen. Es gibt 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 finden. Legen Sie den Parameter forUsername auf GoogleDevelopers und den Parameter part auf contentDetails fest. In der API-Antwort gibt das Attribut contentDetails.relatedPlaylists.uploads die Playlist-ID für die hochgeladenen Videos des Kanals an.

    Rufen Sie dann die Methode playlistItems.list auf und legen Sie den Parameter playlistId auf die erfasste ID und den Parameter part auf snippet fest.

8. Oktober 2014

Dieses Update enthält die folgenden Änderungen:

• Die channel-Ressource enthält zwei neue Properties:

  • Die Property status.longUploadsStatus gibt an, ob der Kanal Videos mit einer Länge von mehr als 15 Minuten hochladen kann. Diese Property wird nur zurückgegeben, wenn der Kanalinhaber die API-Anfrage autorisiert hat. Gültige Attributwerte:

    • allowed – Der Kanal kann Videos mit einer Länge von mehr als 15 Minuten hochladen.
    • eligible – Der Kanal ist berechtigt, Videos mit einer Länge von mehr als 15 Minuten hochzuladen, muss die Funktion aber zuerst aktivieren.
    • disallowed – Der Kanal kann keine Videos mit einer Länge von mehr als 15 Minuten hochladen.

    Weitere Informationen zu diesen Werten finden Sie in der Property-Definition. Weitere Informationen zu dieser Funktion findest du in der YouTube-Hilfe.

  • Das Attribut invideoPromotion.useSmartTiming gibt an, ob für die Werbekampagne des Kanals „intelligentes Timing“ verwendet wird. Mit dieser Funktion werden Werbeunterbrechungen an einer Stelle im Video eingeblendet, an der sie mit höherer Wahrscheinlichkeit angeklickt werden und die Wiedergabe weniger stören. Außerdem wird mit dieser Funktion ein einzelnes Werbeangebot für jedes Video ausgewählt.

• Die Definitionen der Attribute snippet.title und snippet.categoryId der video-Ressource wurden aktualisiert, um die Verarbeitung von Aufrufen der Methode videos.update durch die API zu verdeutlichen. Wenn Sie diese Methode aufrufen, um den snippet-Teil einer video-Ressource zu aktualisieren, müssen Sie einen Wert für beide Properties festlegen.

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

• Die Property contentDetails.contentRating.oflcRating der Ressource video, die die Altersfreigabe eines Videos des neuseeländischen Office of Film and Literature Classification angibt, unterstützt jetzt zwei neue Altersfreigaben: oflcRp13 und oflcRp16. Sie entsprechen den Bewertungen RP13 und RP16.

• Die Methode channelBanners.insert unterstützt jetzt den folgenden Fehler:

  Fehlertyp	Fehlerdetails	Beschreibung
  badRequest	bannerAlbumFull	Das Album „Kanalbilder“ des Kanalinhabers enthält zu viele Bilder. Der Kanalinhaber sollte http://photos.google.com aufrufen, die Seite „Alben“ aufrufen und einige Bilder aus diesem Album entfernen.

12. September 2014

Dieses Update enthält die folgenden Änderungen:

• Die Kontingentkosten für einen Aufruf der search.list-Methode haben sich zusätzlich zu den Kosten der angegebenen Ressourcenteile von einer auf zwei 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 das Limit für die Aborate überschritten. In ein paar Stunden können Sie weitere Abos abschließen.

12. August 2014

Dieses Update enthält die folgenden Änderungen:

• In einem neuen Leitfaden mit dem Titel Anwendung zur YouTube Data API (Version 3) migrieren wird erläutert, wie du mit der YouTube Data API (Version 3) Funktionen ausführen kannst, die auch in der YouTube Data API (Version 2) verfügbar sind. Die ältere API wurde am 4. März 2014 offiziell eingestellt. Dieser Leitfaden soll Ihnen dabei helfen, Anwendungen, die noch die v2 API verwenden, auf die neueste API-Version umzustellen.

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 eine Playlist nicht erstellt werden kann, weil der Kanal bereits die maximal zulässige Anzahl an Playlists hat.

18. Juni 2014

Dieses Update enthält die folgenden Änderungen:

• Die Beschreibung jeder API-Methode wurde um die Kontingentkosten ergänzt, die durch einen Aufruf dieser Methode entstehen. Die Definitionen der part-Parameter wurden ebenfalls aktualisiert, um die Kontingentkosten für jeden Teil anzugeben, der in einem API-Aufruf abgerufen werden kann. Ein Aufruf der Methode subscriptions.insert hat beispielsweise Kontingentkosten von etwa 50 Einheiten. Die subscription-Ressource enthält ebenfalls drei Teile (snippet, contentDetails und subscriberSnippet), die jeweils zwei Einheiten kosten.

  Die Kontingentkosten können sich ohne vorherige Ankündigung ändern.

• Die video-Ressource unterstützt jetzt 43 neue Altersfreigabesysteme, die die Altersfreigaben von verschiedenen nationalen Altersfreigabestellen angeben. Die neu unterstützten Altersfreigabesysteme stammen aus Argentinien, Österreich, Belgien, Bulgarien, Chile (Fernsehen), Chile (Film), Tschechien, Kolumbien, Dänemark, Ägypten, Estland, Finnland, Frankreich, Griechenland, Hongkong, Island, Indonesien, Irland, Israel, Italien, Kenia, Lettland, Luxemburg, Malaysia, Malediven, Malta, Niederlande, Nigeria, Norwegen, Peru, Philippinen, Portugal, Rumänien, Singapur, Slowakei, Südafrika, Schweden, Schweiz, Taiwan, Thailand und Venezuela.

28. Mai 2014

Dieses Update enthält die folgenden Änderungen:

• Die search.list-Methode unterstützt jetzt die Parameter location und locationRadius, mit denen du nach Videos suchen kannst, die mit einem geografischen Standort verknüpft sind. Für eine Anfrage muss ein Wert für beide Parameter angegeben werden, damit Ergebnisse nach Standort abgerufen werden können. Wenn eine Anfrage nur einen der beiden Parameter enthält, gibt die API einen Fehler zurück.

  • Der Parameter location gibt die Breiten- und Längengradkoordinaten des Mittelpunkts des kreisförmigen geografischen Gebiets an.

  • Mit dem Parameter locationRadius wird die maximale Entfernung angegeben, die der mit einem Video verknüpfte Ort vom Zentrum des Gebiets haben darf, damit das Video in den Suchergebnissen enthalten ist.

13. Mai 2014

Dieses Update enthält die folgenden Änderungen:

• Die Property invideoPromotion.items[] der Ressource channel wurde aktualisiert. Du kannst normalerweise nur ein beworbenes Element für deinen Kanal festlegen. Wenn Sie versuchen, zu viele beworbene Artikel einzufügen, gibt die API den Fehler tooManyPromotedItems mit dem HTTP-Statuscode 400 zurück.

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

  • postedPlaylists – Playlists, die der Inhaber des Kanals im Aktivitätsfeed des Kanals gepostet hat
  • postedVideos – Videos, die der Inhaber des Kanals 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 Altersfreigabe an, die ein Video vom Irish Film Classification Office erhalten hat.

• Die Definition der Eigenschaft position.cornerPosition der watermark-Ressource wurde aktualisiert. Das Wasserzeichen wird jetzt immer oben rechts im Player angezeigt.

• Die Definition des Parameters q für die Methode search.list wurde aktualisiert. Es wird darauf hingewiesen, dass der boolesche Operator „NICHT“ (-) verwendet werden kann, um Videos auszuschließen, die mit einem bestimmten Suchbegriff verknüpft sind. Der Wert kann auch den booleschen Operator OR (|) verwenden, um Videos zu finden, die mit einem oder mehreren Suchbegriffen verknüpft sind.

• Die Definition der Property pageInfo.totalResults, die in einer API-Antwort auf einen search.list-Aufruf zurückgegeben wird, wurde aktualisiert. Es wird nun darauf hingewiesen, dass der Wert eine Näherung ist und möglicherweise nicht genau ist. Außerdem ist der Höchstwert 1.000.000. Sie sollten diesen Wert nicht zum Erstellen von Paginierungslinks verwenden. Verwenden Sie stattdessen die Property-Werte nextPageToken und prevPageToken, um festzulegen, 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 wird auch als Benutzeroberflächensprache bezeichnet. Für die YouTube-Website kann eine Anwendungssprache basierend auf den Google-Kontoeinstellungen, der Browsersprache oder dem IP-Standort automatisch ausgewählt werden. Nutzer können die gewünschte Benutzeroberflächensprache auch manuell in der Fußzeile der YouTube-Website auswählen.

  Die API unterstützt eine Methode, mit der unterstützte Anwendungssprachen aufgelistet werden. 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 Inhaltsregion auswählen kann. Die Inhaltsregion kann auch als Inhaltslokalisierung bezeichnet werden. Auf der YouTube-Website kann eine Inhaltsregion basierend auf Heuristiken wie der YouTube-Domain oder dem IP-Standort des Nutzers automatisch 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, mit der unterstützte Inhaltsregionen aufgelistet werden. 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 ein Kanal als „Empfohlen“ gekennzeichnet hat. Ein Bereich könnte beispielsweise die neuesten Uploads, die beliebtesten Uploads oder Videos aus einer oder mehreren Playlists eines Kanals enthalten.

  Die API unterstützt Methoden zum Auflisten, Einfügen, Aktualisieren oder Löschen von Kanalbereichen. Du kannst eine Liste der Kanalabschnitte 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, um die Fehlermeldungen zu beschreiben, die die API speziell für diese neuen Methoden unterstützt.

• Die Definition des fileDetails-Objekts der video-Ressource wurde aktualisiert. Es wird jetzt erklärt, dass dieses Objekt nur zurückgegeben wird, wenn die Property processingDetails.fileDetailsAvailability des Videos den Wert available hat.

  Ebenso wurde die Definition des suggestions-Objekts der video-Ressource aktualisiert. Es wird jetzt erklärt, dass dieses Objekt nur zurückgegeben wird, wenn das Attribut processingDetails.tagSuggestionsAvailability oder processingDetails.editorSuggestionsAvailability des Videos den Wert available hat.

• Die Dokumentation für die Methoden videos.insert und videos.update wurde aktualisiert, um darauf hinzuweisen, dass das Attribut status.publishAt beim Aufrufen dieser Methoden festgelegt werden kann.

• Die Definition des invideoPromotion-Objekts der channel-Ressource wurde aktualisiert. Es wird jetzt erklärt, dass das Objekt nur vom Inhaber des Kanals abgerufen werden kann.

• Die Parameterliste für die videos.rate-Methode wurde aktualisiert, um zu verdeutlichen, dass diese Methode den Parameter onBehalfOfContentOwner nicht unterstützt. Dies war ein Dokumentationsfehler, da videos.rate-Anfragen, bei denen dieser Parameter festgelegt ist, einen 500-Fehler zurückgeben.

31. März 2014

Dieses Update enthält die folgenden Änderungen:

• Mit der neuen Property status.publishAt der Ressource video kannst du das Datum und die Uhrzeit angeben, zu der ein privates Video veröffentlicht werden soll. Dieses Attribut kann nur festgelegt werden, wenn der Datenschutzstatus des Videos private ist 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 Teil contentOwnerDetails für channel-Ressourcen. Der neue Teil enthält Kanaldaten, die für mit dem Kanal verknüpfte YouTube-Partner relevant sind. Dazu gehören die ID des mit dem Kanal verknüpften Rechteinhabers sowie das Datum und die Uhrzeit, zu dem die Verknüpfung zwischen dem Rechteinhaber und dem Kanal hergestellt wurde. Hinweis: Dieser neue Teil unterliegt nicht der Einstellungsrichtlinie.

• In der Dokumentation ist jetzt die maximal unterstützte Zeichenanzahl für die folgenden Properties aufgeführt:

  Ressource	Attribut	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. Der Property-Wert ist eine Liste und Kommas zwischen den Elementen in der Liste werden auf das Limit angerechnet.

• Die Property brandingSettings.watch.featuredPlaylistId der Ressource channel wird nicht mehr unterstützt. Wenn Sie versuchen, den Wert festzulegen, gibt die API einen Fehler zurück.

• 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 channels.list-Methode gibt diesen Fehler zurück, wenn in der Anfrage Filterparameter angegeben sind, die nicht zusammen 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 Property brandingSettings.channel.title zu ändern. Hinweis: Die API gibt keinen Fehler zurück, wenn Sie das Attribut weglassen.
  badRequest (400)	invalidRecentlyUploadedBy	Die Methode channels.update gibt diesen Fehler zurück, wenn für das Attribut invideoPromotion.items[].id.recentlyUploadedBy eine ungültige Kanal-ID angegeben wurde.
  badRequest (400)	invalidTimingOffset	Die Methode channels.update gibt diesen Fehler zurück, wenn im Teil invideoPromotion ein ungültiger Zeitversatz angegeben ist.
  badRequest (400)	tooManyPromotedItems	Die Methode channels.update gibt diesen Fehler zurück, wenn im Teil invideoPromotion mehr als die zulässige Anzahl von Anzeigenelementen angegeben ist.
  forbidden (403)	promotedVideoNotAllowed	Die channels.update-Methode gibt diesen Fehler zurück, wenn für die Property invideoPromotion.items[].id.videoId eine Video-ID angegeben ist, 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 für die Property invideoPromotion.items[].id.websiteUrl eine nicht zulässige URL angegeben ist.
  required (400)	requiredTimingType	Die channels.update-Methode gibt diesen Fehler zurück, wenn in einer Anfrage keine Standardzeiteinstellungen für die Auslieferung eines beworbenen Artikels auf YouTube angegeben sind.
  required (400)	requiredTiming	Für die channels.update-Methode muss für jeden beworbenen Artikel ein invideoPromotion.items[].timing-Objekt angegeben werden.
  required (400)	requiredWebsiteUrl	Für die channels.update-Methode muss für jeden beworbenen Artikel eine invideoPromotion.items[].id.websiteUrl-Property angegeben werden.
  badRequest (400)	invalidPublishAt	Die videos.insert-Methode gibt diesen Fehler zurück, wenn in den Anfragemetadaten eine ungültige geplante Veröffentlichungszeit angegeben ist.

4. März 2014

Dieses Update enthält die folgenden Änderungen:

• Die YouTube Data API Version 3 unterliegt jetzt der Richtlinie zur Einstellung von Produkten und Diensten, die in den Nutzungsbedingungen für YouTube APIs beschrieben ist. Auf der Seite mit den APIs, die von der Einstellungsrichtlinie betroffen sind, sind einige v3 API-Funktionen ausdrücklich von der Richtlinie ausgenommen.

5. Dezember 2013

Dieses Update enthält die folgenden Änderungen:

• Die Dokumentation der Methode search.list wurde aktualisiert, um korrekt zu verdeutlichen, dass Sie beim Senden einer Suchanfrage keinen Wert für genau einen Filterparameter angeben müssen. Sie können stattdessen einen Wert für null oder einen Filterparameter festlegen.

• Die Definitionen für die Parameter der search.list-Methode wurden aktualisiert. Sie müssen den Wert des Parameters type auf video festlegen, wenn Sie auch einen Wert für einen der folgenden Parameter angeben:

  • eventType
  • videoCaption
  • videoCategoryId
  • videoDefinition
  • videoDimension
  • videoDuration
  • videoEmbeddable
  • videoLicense
  • videoSyndicated
  • videoType

• Die Mindestgröße für hochgeladene Kanalbannerbilder wurde auf 2.048 × 1.152 Pixel reduziert. Bisher betrug die Mindestgröße 2.120 x 1.192 Pixel. In der Dokumentation der channel-Ressource sind außerdem die maximalen Größen aller Bannerbilder angegeben, die über die API bereitgestellt werden. Die maximale Größe des brandingSettings.image.bannerTvImageUrl-Bilds für Fernsehanwendungen beträgt beispielsweise 2.120 x 1.192 Pixel, das tatsächliche Bild kann aber 2.048 x 1.152 Pixel haben. In der YouTube-Hilfe findest du weitere Informationen zur Optimierung von Kanalbildern für die Anzeige auf verschiedenen Geräten.

• Die Definitionen mehrerer channel-Ressourceneigenschaften wurden aktualisiert, um die folgenden Informationen widerzuspiegeln:

  • Der Wert der Property brandingSettings.channel.description darf maximal 1.000 Zeichen lang sein.
  • Die Property brandingSettings.channel.featuredChannelsTitle darf maximal 30 Zeichen lang sein.
  • Die Property brandingSettings.channel.featuredChannelsUrls[] kann jetzt bis zu 100 Kanäle enthalten.
  • Der Wert der Property brandingSettings.channel.unsubscribedTrailer muss, falls festgelegt, die YouTube-Video-ID eines öffentlichen oder nicht gelisteten Videos angeben, das dem Kanalinhaber gehört.

• Die Methode channels.update unterstützt jetzt Aktualisierungen der Property invideoPromotion.items[].promotedByContentOwner. Mit diesem Attribut wird angegeben, ob der Name des Rechteinhabers bei der Präsentation des Angebots angezeigt wird. Er kann nur festgelegt werden, wenn die API-Anfrage, mit der der Property-Wert festgelegt wird, im Namen des Rechteinhabers über den Parameter onBehalfOfContentOwner erfolgt.

• Die Methoden playlistItems.list und playlistItems.insert unterstützen jetzt den Parameter onBehalfOfContentOwner, der bereits für mehrere andere Methoden unterstützt wird.

• Für die Property contentDetails.contentRating.acbRating kann jetzt eine Altersfreigabe des Australian Classification Board (ACB) für Filme oder der Australian Communications and Media Authority (ACMA) für Kinderfernsehprogramme angegeben werden.

• Die neuen Properties contentDetails.contentRating.catvRating und contentDetails.contentRating.catvfrRating geben die Altersfreigaben an, die ein Video im Rahmen des kanadischen TV-Altersfreigabesystems und des französischsprachigen Altersfreigabesystems der Régie du cinéma erhalten hat, das in Québec verwendet wird.

• Die neue Property snippet.assignable der videoCategory-Ressource gibt an, ob aktualisierte Videos 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 bietet zwei zusätzliche Funktionen, mit denen sich Live-Übertragungen leichter finden und präsentieren lassen:

  Die neue Property snippet.liveBroadcastContent in den Suchergebnissen gibt an, ob eine Video- oder Kanalressource Liveübertragungen enthält. Gültige Werte für die Property sind upcoming, active und none.

  • Die neue snippet.liveBroadcastContent-Eigenschaft der video-Ressource gibt an, ob es sich bei dem Video um eine anstehende oder aktive Livestream-Übertragung handelt. In der folgenden Liste werden die möglichen Werte der Property erläutert:

    • upcoming – Das Video ist eine Live-Übertragung, die noch nicht gestartet wurde.
    • active – Das Video ist eine laufende Liveübertragung.
    • none: Das Video ist keine anstehende oder aktive Liveübertragung. Das ist der Property-Wert für abgeschlossene Übertragungen, die noch auf YouTube angesehen werden können.

  • Das neue Attribut liveStreamingDetails der Ressource video ist ein Objekt, das Metadaten zu einer Live-Videoübertragung enthält. Wenn du diese Metadaten abrufen möchtest, musst du liveStreamingDetails in die Liste der Ressourcenteile des part-Parameterwerts aufnehmen. Die Metadaten enthalten die folgenden neuen Properties:

    • liveStreamingDetails.actualStartTime – Die Uhrzeit, zu der die Übertragung tatsächlich gestartet wurde. Dieser Wert ist vorhanden, sobald der Status der Übertragung active ist.
    • liveStreamingDetails.actualEndTime – Die Uhrzeit, zu der die Übertragung tatsächlich beendet wurde. Dieser Wert ist verfügbar, sobald die Übertragung beendet ist.
    • liveStreamingDetails.scheduledStartTime – Die Uhrzeit, zu der die Übertragung beginnen soll.
    • liveStreamingDetails.scheduledEndTime – Die Uhrzeit, zu der die Übertragung enden soll. Wenn der Property-Wert leer ist oder die Property nicht vorhanden ist, wird die Übertragung auf unbestimmte Zeit geplant.
    • liveStreamingDetails.concurrentViewers – Die Anzahl der Zuschauer, die sich die Übertragung ansehen.

    Wenn Sie diese Metadaten abrufen möchten, geben Sie beim Aufrufen der Methode videos.list, videos.insert oder videos.update den Wert liveStreamingDetails in den Parameter part ein.

  Am 1. Oktober 2013 wurden zwei weitere Funktionen zur Identifizierung von Live-Übertragungen veröffentlicht: der Parameter eventType der Methode search.list und die Property snippet.liveBroadcastContent der Suchergebnisse.

• Die videos.insert-Methode unterstützt jetzt den Parameter notifySubscribers, der angibt, ob YouTube Nutzern, die den Kanal des Videos abonniert haben, eine Benachrichtigung über das neue Video senden soll. Der Standardwert des Parameters ist True. Das bedeutet, dass Abonnenten über neu hochgeladene Videos benachrichtigt werden. Kanalinhaber, die viele Videos hochladen, sollten den Wert jedoch auf False festlegen, damit nicht bei jedem neuen Video eine Benachrichtigung an die Abonnenten des Kanals gesendet wird.

• Die Liste der Attribute, die beim Aufrufen der Methode channels.update geändert werden können, wurde um die Attribute invideoPromotion.items[].customMessage und invideoPromotion.items[].websiteUrl ergänzt. Außerdem wurden die änderbaren brandingSettings-Properties in der Liste gekennzeichnet. Diese brandingSettings-Properties waren bereits bearbeitbar. Die Änderung der Dokumentation bedeutet also keine Änderung an den vorhandenen Funktionen der API.

• Die Methoden playlists.insert, playlists.update und playlists.delete unterstützen jetzt den Parameter onBehalfOfContentOwner, der bereits für mehrere 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 video-Ressource unterstützt jetzt den Wert pg14, der einer TV-14-Einstufung entspricht.

• Die Definition der Eigenschaft snippet.liveBroadcastContent, die Teil der Suchergebnisse ist, wurde korrigiert, um zu verdeutlichen, dass live ein gültiger Eigenschaftswert ist, active jedoch nicht.

• Das Attribut contentDetails.contentRating.mibacRating der video-Ressource unterstützt jetzt zwei zusätzliche Bewertungen:

  • mibacVap (VAP): Kinder sollten von einem Erwachsenen begleitet werden.
  • mibacVm6 (V.M.6): Nur für Zuschauer ab 6 Jahren
  • mibacVm12 (V.M.12): Nur für Zuschauer ab 12 Jahren.

• Mit dem neuen Attribut invideoPromotion.items[].promotedByContentOwner der channel-Ressource wird angegeben, ob der Name des Rechteinhabers bei der Präsentation des Angebots 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 im Abschnitt zum Parameter onBehalfOfContentOwner.

1. Oktober 2013

Dieses Update enthält die folgenden Änderungen:

• Das neue auditDetails-Objekt der channel-Ressource enthält Kanaldaten, die ein Multi-Channel-Netzwerk (MCN) bei der Entscheidung, ob ein bestimmter Kanal akzeptiert oder abgelehnt werden soll, auswerten würde. Jede API-Anfrage, mit der dieser Ressourcenteil abgerufen wird, muss ein Autorisierungstoken mit dem Bereich https://www.googleapis.com/auth/youtubepartner-channel-audit enthalten. Außerdem muss jedes Token, das diesen Umfang verwendet, widerrufen werden, wenn das MCN den Kanal akzeptiert oder ablehnt, oder innerhalb von zwei Wochen nach dem Datum, an dem das Token ausgestellt wurde.

• Die Property invideoPromotion.items[].id.type der Ressource channel unterstützt jetzt den Wert recentUpload. Dieser gibt an, dass das beworbene Element das zuletzt hochgeladene Video eines bestimmten Kanals ist.

  Standardmäßig ist der Kanal derselbe, für den die Daten für In-Video-Anzeigen festgelegt sind. Sie können jedoch das zuletzt hochgeladene Video eines anderen Kanals bewerben, indem Sie den Wert der neuen invideoPromotion.items[].id.recentlyUploadedBy-Property auf die Kanal-ID dieses Kanals festlegen.

• Die channel-Ressource enthält drei neue Properties – brandingSettings.image.bannerTvLowImageUrl, brandingSettings.image.bannerTvMediumImageUrl und brandingSettings.image.bannerTvHighImageUrl –, mit denen die URLs für die Bannerbilder angegeben werden, die auf Kanalseiten in Fernsehanwendungen angezeigt werden.

• Die neue Property snippet.liveBroadcastContent in den Suchergebnissen gibt an, ob eine Video- oder Kanalressource Liveübertragungen enthält. Gültige Werte für die Property sind upcoming, active und none.

  • Bei einer video-Ressource gibt der Wert „upcoming“ an, dass es sich um eine noch nicht gestartete Liveübertragung handelt. Der Wert „active“ gibt an, dass es sich um eine laufende Liveübertragung handelt.
  • Bei einer channel-Ressource gibt der Wert „upcoming“ an, dass für den Kanal eine geplante Übertragung geplant ist, die noch nicht gestartet wurde. Der Wert „acive“ gibt an, dass für den Kanal eine Liveübertragung läuft.

• In der watermark-Ressource wurde das Attribut targetChannelId von einem Objekt in einen String geändert. Anstatt eine untergeordnete Property zu enthalten, die die YouTube-Kanal-ID des Kanals angibt, auf den das Wasserzeichenbild verweist, gibt die targetChannelId-Property diesen Wert jetzt selbst an. Daher wurde die Property 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 search.list-Methode unterstützt jetzt den Parameter eventType, mit dem eine Suche auf aktive, anstehende oder abgeschlossene Übertragungsereignisse beschränkt werden kann.

• Das neue Attribut contentDetails.contentRating.mibacRating gibt die Altersfreigabe an, die ein Video vom italienischen Ministerium für Kultur und Tourismus (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 thumbnails.set-Methode 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 Inhaber des bewerteten Videos die Bewertungen für dieses Video deaktiviert hat.

27. August 2013

Dieses Update enthält die folgenden Änderungen:

• Die neue watermark-Ressource identifiziert ein Bild, das bei der Wiedergabe der Videos eines bestimmten Kanals angezeigt wird. Du kannst auch einen Zielkanal angeben, mit dem das Bild verknüpft werden soll, sowie Timing-Details, die festlegen, wann das Wasserzeichen während der Videowiedergabe angezeigt wird 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.

• Das neue Attribut statistics.hiddenSubscriberCount der Ressource channel enthält einen booleschen Wert, der angibt, ob die Anzahl der Abonnenten des Kanals ausgeblendet ist. Der Wert der Property ist also 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 mehrere andere Methoden unterstützt.

• Die Methode videos.list unterstützt jetzt den Parameter regionCode, mit dem der Inhaltsbereich angegeben wird, 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 der error documentation wird der folgende neue häufige Fehler bei Anfragen beschrieben, der bei mehreren API-Methoden auftreten kann:

  Fehlertyp	Fehlerdetails	Beschreibung
  forbidden	insufficientPermissions	Die mit dem für die Anfrage bereitgestellten OAuth 2.0-Token verknüpften Bereiche reichen nicht aus, um auf die angeforderten Daten zuzugreifen.

15. August 2013

Dieses Update enthält die folgenden Änderungen:

• Das invideoPromotion-Objekt der channel-Ressource hat die folgenden neuen und aktualisierten Eigenschaften:

  • Die API unterstützt jetzt die Angabe einer Website als beworbenes Element. Legen Sie dazu den Wert des Attributs invideoPromotion.items[].id.type auf website fest und geben Sie die URL mit der neuen Property invideoPromotion.items[].id.websiteUrl an. Mit der neuen Property invideoPromotion.items[].customMessage können Sie eine benutzerdefinierte Nachricht für das Angebot definieren.

    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 unter Verknüpfte Websites und Händlerwebsites.

    Wenn du Werbelinks hinzufügst, erklärst du dich damit einverstanden, dass diese Links nicht dazu verwendet werden, Zugriffe auf nicht autorisierte Websites weiterzuleiten, und dass sie den AdWords-Richtlinien, den YouTube-Werberichtlinien, den YouTube-Community-Richtlinien und den YouTube-Nutzungsbedingungen entsprechen.

  • Die Properties im Zusammenhang mit den Zeiteinstellungen für die Anzeige von Anzeigen während der Videowiedergabe wurden umstrukturiert:

    • Das Objekt invideoPromotion.timing wurde in invideoPromotion.items[].timing verschoben. Mit diesem Objekt können Sie jetzt die Zeitangaben für jeden beworbenen Artikel in der Liste invideoPromotion.items[] anpassen.

    • Das neue invideoPromotion.defaultTiming-Objekt gibt die Standardzeiteinstellungen für Ihr Angebot an. Mit diesen Einstellungen legst du fest, wann ein beworbener Artikel während der Wiedergabe eines Videos auf deinem Kanal angezeigt wird. Sie können das Standard-Timing für ein bestimmtes beworbenes Element mit dem Objekt invideoPromotion.items[].timing überschreiben.

    • Mit der neuen Property invideoPromotion.items[].timing.durationMs wird die Dauer in Millisekunden angegeben, für die das Angebot angezeigt werden soll. Das invideoPromotion.defaultTiming-Objekt enthält außerdem ein durationMs-Feld, das die Standarddauer angibt, für die das beworbene Element angezeigt wird.

  • Die Eigenschaften 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 mehrere andere Methoden unterstützt.

• In der API-Antwort auf eine thumbnails.set-Anfrage hat sich der Wert des Attributs 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 darin demonstrierte Funktion jetzt von der Methode videos.rate verarbeitet wird.

• Der error documentation beschreibt den folgenden neuen Fehler im Anfragekontext, 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. Entferne entweder den Parameter mine, authentifiziere dich als YouTube-Nutzer, indem du den Parameter onBehalfOfContentOwner entfernst, oder handle als einer der Kanäle des Partners, indem du den Parameter onBehalfOfContentOwnerChannel angibst, sofern er für die aufgerufene Methode verfügbar ist.

8. August 2013

Dieses Update enthält die folgenden Änderungen:

• Der Abschnitt Kontingentnutzung im Leitfaden Einstieg in die YouTube Data API wurde aktualisiert, da sich die Kontingentkosten für einen Videoupload von etwa 16.000 Einheiten auf etwa 1.600 Einheiten geändert haben.

30. Juli 2013

Dieses Update enthält die folgenden Änderungen:

• In einer channelBanner-Ressource hat sich der Wert des Attributs kind von youtube#channelBannerInsertResponse in 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 zu den Inhalten des Kanals passt. Der Attributwert besteht aus einem Pfundzeichen (#) gefolgt von einem Hexadezimalstring mit sechs Zeichen, z. B. #2793e6.

• Die API unterstützt jetzt die Angabe, ob ein Abo alle Aktivitäten eines Kanals oder nur neue Uploads umfasst. Mit der neuen Property contentDetails.activityType der subscription-Ressource werden die Arten von Aktivitäten angegeben, über die der Abonnent benachrichtigt wird. Gültige Attributwerte sind all und uploads.

• Die videos.list-Methode unterstützt neue Parameter zum Abrufen eines Charts der beliebtesten Videos auf YouTube:

  • Mit dem Parameter chart wird das Diagramm angegeben, das Sie abrufen möchten. Derzeit ist mostPopular der einzige unterstützte Wert. Der Parameter chart ist ein Filterparameter und kann daher nicht in derselben Anfrage wie andere Filterparameter (id und myRating) verwendet werden.
  • Mit dem Parameter videoCategoryId wird die Videokategorie angegeben, 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 Property topicDetails.relevantTopicIds[] der Ressource video enthält eine Liste von Freebase-Themen-IDs, die für das Video oder seinen Inhalt relevant sind. Die Themen dieser Themen können im Video erwähnt oder zu sehen sein.

• Die Property recordingDetails.location.elevation der Ressource video wurde in recordingDetails.location.altitude umbenannt und die Property fileDetails.recordingLocation.location.elevation in fileDetails.recordingLocation.location.altitude.

• Das contentDetails.contentRating-Objekt der video-Ressource gibt die Altersfreigaben an, die ein Video gemäß verschiedenen Altersfreigabesystemen erhalten hat, z. B. die Altersfreigaben der MPAA und TVPG. Für jedes Altersfreigabesystem unterstützt die API jetzt einen Altersfreigabewert, der angibt, dass das Video nicht bewertet wurde. Hinweis: Bei MPAA-Altersfreigaben wird die Einstufung „UNRATED“ häufig verwendet, um ungeschnittene Versionen von Filmen zu kennzeichnen, für die die geschnittene Version eine offizielle Altersfreigabe erhalten hat.

• Das neue Attribut contentDetails.contentRating.ytRating der Ressource video gibt an, ob Inhalte eine Altersbeschränkung haben. Der Attributwert 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 fehlt oder der Property-Wert leer ist, wurden die Inhalte nicht als altersbeschränkt gekennzeichnet.

• Der Parameter mySubscribers der Methode channels.list wurde eingestellt. Verwende die Methode subscriptions.list und den 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 alle 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 darauf hinzuweisen, dass mit dieser Methode das brandingSettings-Objekt der channel-Ressource und die untergeordneten Properties aktualisiert werden können. Außerdem enthält die Dokumentation jetzt eine aktualisierte Liste der Properties, 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 auf eine bestimmte API-Methode zurückzuführen. Gibt an, dass der authentifizierte Nutzer nicht berechtigt ist, im Namen des angegebenen Google-Kontos zu handeln.
  forbidden	authenticatedUserAccountClosed	Dieser Fehler ist nicht auf eine bestimmte API-Methode zurückzuführen. Das YouTube-Konto des authentifizierten Nutzers ist geschlossen. Wenn der Nutzer im Namen eines anderen Google-Kontos handelt, bedeutet dieser Fehler, dass dieses andere Konto geschlossen wurde.
  forbidden	authenticatedUserAccountSuspended	Dieser Fehler ist nicht auf eine bestimmte API-Methode zurückzuführen. Das YouTube-Konto des authentifizierten Nutzers ist gesperrt. Wenn der Nutzer im Namen eines anderen Google-Kontos handelt, bedeutet dieser Fehler, dass dieses andere Konto gesperrt ist.
  forbidden	authenticatedUserNotChannel	Dieser Fehler ist nicht auf eine bestimmte API-Methode zurückzuführen. Der API-Server kann den mit der API-Anfrage verknüpften Channel nicht identifizieren. Wenn die Anfrage autorisiert ist und den Parameter onBehalfOfContentOwner verwendet, sollten Sie auch den Parameter onBehalfOfContentOwnerChannel festlegen.
  forbidden	cmsUserAccountNotFound	Dieser Fehler ist nicht auf eine bestimmte API-Methode zurückzuführen. Der CMS-Nutzer darf nicht im Namen des angegebenen Rechteinhabers handeln.
  notFound	contentOwnerAccountNotFound	Dieser Fehler ist nicht auf eine bestimmte API-Methode zurückzuführen. Das angegebene Konto des Rechteinhabers wurde nicht gefunden.
  badRequest	invalidPart	Dieser Fehler ist nicht auf eine bestimmte API-Methode zurückzuführen. Mit dem Parameter part der Anfrage werden Teile angegeben, 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, wenn das Video, das du aktualisieren möchtest, nicht gefunden werden kann. Prüfe, ob der Wert der Property 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 zu einem Kanal abrufen, indem Sie den YouTube-Nutzernamen angeben.

• Die Methode activities.list unterstützt jetzt den Parameter regionCode, mit dem die API angewiesen wird, 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 für die Generierung des Aktivitätsfeeds liefern.

• Playlist-Ressourcen enthalten jetzt das Attribut snippet.tags. Die Property wird nur für autorisierte Nutzer zurückgegeben, die Daten zu ihren eigenen Playlists abrufen. Autorisierte Nutzer können Playlist-Tags auch beim Aufrufen der Methoden playlists.insert oder playlists.update festlegen.

• Der Parameter onBehalfOfContentOwner, der bisher nur 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 in der Anfrage auch ein Wert für den neuen Parameter onBehalfOfContentOwnerChannel angegeben werden, der den Kanal angibt, dem das Video hinzugefügt werden soll. Der Kanal muss mit dem Rechteinhaber verknüpft sein, der im Parameter onBehalfOfContentOwner angegeben ist.

  Der Parameter gibt an, dass die Autorisierungs-Anmeldedaten 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 richtet sich an Contentpartner, 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 Anmeldedaten für jeden einzelnen Kanal angeben zu müssen.

  Mit diesem Parameter können Contentpartner jetzt Videos auf allen ihren YouTube-Kanälen einfügen, aktualisieren oder löschen.

• In error documentation werden die folgenden neuen Fehler beschrieben:

  Fehlertyp	Fehlerdetails	Beschreibung
  forbidden	insufficientCapabilities	Dieser Fehler ist nicht auf eine bestimmte API-Methode zurückzuführen. Gibt an, dass der CMS-Nutzer, der die API aufruft, nicht über ausreichende Berechtigungen zum Ausführen des angeforderten Vorgangs verfügt. Dieser Fehler ist mit der Verwendung des Parameters onBehalfOfContentOwner verbunden, der für mehrere API-Methoden unterstützt wird.
  unauthorized	authorizationRequired	Die activities.list-Methode gibt diesen Fehler zurück, wenn in der Anfrage der Parameter home verwendet wird, aber nicht ordnungsgemäß autorisiert ist.

• In der channels-Ressource wurde die Property invideoPromotion.channelId entfernt, da die Kanal-ID bereits über die Property id der Ressource angegeben ist.

• Im neuen Leitfaden Mit Channel-IDs arbeiten wird erläutert, wie Channel-IDs in der API verwendet werden. Der Leitfaden ist besonders hilfreich für Entwickler, die von der vorherigen Version der API migrieren und Anwendungen haben, die entweder Inhalte für den Nutzer default anfordern oder davon ausgehen, 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 über das neue Attribut brandingSettings.image.bannerExternalUrl der Ressource channel als Bannerbild für einen Kanal festgelegt werden kann.

• Die Dokumentation zur channels.update-Methode wurde aktualisiert. Dort sind jetzt die Properties aufgeführt, die beim Aufrufen der Methode geändert werden können.

• In der Dokumentation zur video-Ressource wird unspecified nicht mehr als gültiger Property-Wert für die Properties suggestions.processingErrors[], suggestions.processingHints[], suggestions.processingWarnings[] und suggestions.editorSuggestions[] aufgeführt.

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

• In der error documentation werden jetzt Fehler für die Methoden channelBanners.insert und subscriptions.list aufgeführt. Außerdem werden mehrere neue Fehler für die channels.update-Methode 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.

• Die Seite mit Python-Codebeispielen enthält jetzt Beispiele zum Hinzufügen eines Abos, zum Erstellen einer Playlist und zum Aktualisieren eines Videos.

10. Mai 2013

Dieses Update enthält die folgenden Änderungen:

• YouTube kennzeichnet experimentelle API-Funktionen und ‑Dienste nicht mehr. Stattdessen stellen wir jetzt eine Liste der YouTube APIs zur Verfügung, die der Richtlinie zur Einstellung von Produkten und Diensten unterliegen.

8. Mai 2013

Dieses Update enthält die folgenden Änderungen:

• Kanalressourcen unterstützen jetzt das inVideoPromotion-Objekt, das Informationen zu einer Werbekampagne enthält, die mit dem Kanal verknüpft ist. Mit einer In-Video-Werbekampagne kann ein Kanal Thumbnails für ein beworbenes Video im Videoplayer während der Wiedergabe der Videos des Kanals anzeigen.

  Du kannst diese Daten abrufen, indem du invideoPromotion in den Parameterwert part in einer channels.list-Anfrage einfügst.

• Mit der neuen Methode channels.update können die Daten zu In-Video-Werbekampagnen eines Kanals aktualisiert werden. Die Methode unterstützt nur Aktualisierungen am invideoPromotion-Teil der channel-Ressource. Aktualisierungen an anderen Teilen dieser Ressource werden noch nicht unterstützt.

2. Mai 2013

Dieses Update enthält die folgenden Änderungen:

• Für Channel-Ressourcen wird jetzt das Attribut status.isLinked unterstützt. Damit wird angegeben, ob in den Kanaldaten ein Nutzer angegeben ist, der bereits mit einem YouTube-Nutzernamen oder einem Google+-Konto verknüpft ist. Nutzer mit einer solchen Verknüpfung haben bereits eine öffentliche YouTube-Identität, die für verschiedene Aktionen wie das Hochladen von Videos erforderlich ist.

• Aboressourcen unterstützen jetzt den Teil subscriberSnippet. Dieses 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 kannst du eine Liste der Videos abrufen, die der authentifizierte Nutzer mit like oder dislike bewertet hat.

  Der Parameter myRating und der Parameter id gelten jetzt als Filterparameter. Das bedeutet, dass in einer API-Anfrage genau einer der Parameter angegeben werden muss. Bisher war der Parameter id für diese Methode erforderlich.

  Die Methode gibt den Fehler forbidden zurück, wenn bei einer Anfrage versucht wird, Informationen zur Altersfreigabe von Videos abzurufen, die Person aber nicht berechtigt ist, dies zu tun.

• Mit der Einführung des Parameters myRating wurde auch die Methode videos.list aktualisiert, um die Paginierung zu unterstützen. Seitenwechselparameter werden jedoch nur für Anfragen mit dem Parameter myRating unterstützt. Parameter und Informationen für die Seitennavigation werden für Anfragen, bei denen der Parameter id verwendet wird, nicht unterstützt.

  • Mit dem Parameter maxResults wird die maximale Anzahl von Videos angegeben, die die API im Ergebnissatz zurückgeben kann. Der Parameter pageToken gibt eine bestimmte Seite im Ergebnissatz an, die du abrufen möchtest.

  • Die youtube#videoListResponse-Ressource, die als Antwort auf eine videos.list-Anfrage zurückgegeben wird, enthält jetzt das pageInfo-Objekt mit Details wie der Gesamtzahl der Ergebnisse und der Anzahl der Ergebnisse im aktuellen Ergebnissatz. Die youtube#videoListResponse-Ressource kann auch nextPageToken- und prevPageToken-Properties enthalten. Jedes dieser Properties bietet ein Token, mit dem eine bestimmte Seite in der Ergebnismenge abgerufen werden kann.

• Die Methode videos.insert unterstützt die folgenden neuen Parameter:

  • autoLevels: Wenn Sie diesen Parameter auf true festlegen, wird YouTube angewiesen, die Belichtung und Farbe des Videos automatisch zu verbessern.
  • stabilize: Wenn du diesen Parameterwert auf true setzt, wird YouTube angewiesen, das Video anzupassen und Verwacklungen zu entfernen, die durch Kamerabewegungen entstehen.

• Die Property channelTitle wurde der snippet für die folgenden Ressourcen hinzugefügt:

  • playlistItem: Mit diesem Attribut wird der Name des Kanals angegeben, der das Playlist-Element hinzugefügt hat.
  • playlist: Mit diesem Attribut wird der Name des Kanals angegeben, auf dem die Playlist erstellt wurde.
  • subscription: Mit diesem Attribut wird der Name des abonnierten Kanals angegeben.

• 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 kannst du eine Liste der Abonnenten des aktuell authentifizierten Nutzers abrufen. Dieser Parameter kann nur in einer ordnungsgemäß autorisierten Anfrage verwendet werden.

  Hinweis:Diese Funktion soll den Parameter mySubscribers ersetzen, der derzeit für die Methode channels.list unterstützt wird. Dieser Parameter wird eingestellt.

• In einer video-Ressource ist der Eigenschaftswert unspecified nicht mehr für eine der folgenden Properties zulässig:

  • 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 angegebene Grund für den Fehler ist unexpectedParameter.

• Der Fehler, der von der playlistItems.insert-Methode zurückgegeben wird, wenn die Playlist bereits die maximal zulässige Anzahl von Elementen enthält, wurde aktualisiert. Der Fehler wird jetzt als forbidden-Fehler gemeldet und der Fehlergrund 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-Altersfreigabe für ein Video festlegen oder eine Altersfreigabe von einem Video entfernen.

  Die Fehlerdokumentation wurde ebenfalls aktualisiert und enthält jetzt eine Liste der Fehler, die die API als Reaktion auf einen videos.rate-Methodenaufruf zurückgeben kann.

• Thumbnail-Bilder werden in der API-Dokumentation jetzt als separate Ressource aufgeführt. Mit der neuen Methode thumbnails.set kannst du ein benutzerdefiniertes Video-Thumbnail auf YouTube hochladen und für ein Video festlegen.

  Die Fehlerdokumentation wurde ebenfalls aktualisiert und enthält jetzt eine Liste der Fehler, die die API als Reaktion auf einen thumbnails.set-Methodenaufruf zurückgeben kann.

  Diese Änderung hat keine Auswirkungen auf vorhandene Ressourcen, die Thumbnail-Bilder zurückgeben. Miniaturansichten werden in diesen Ressourcen auf die gleiche Weise wie zuvor zurückgegeben. In der Dokumentation sind jetzt jedoch die Namen der verschiedenen Miniaturansichten aufgeführt, die die API zurückgeben kann.

• Im neuen Teil brandingSettings der channel-Ressource werden Einstellungen, Text und Bilder für die Kanalseite und die Wiedergabeseiten von Videos des Kanals angegeben.

• Die playlistItem-Ressource enthält die folgenden neuen Properties:

  • Das neue status-Objekt enthält Statusinformationen zum Playlist-Element und die Property status.privacyStatus gibt den Datenschutzstatus des Playlist-Elements an.

• Die video-Ressource enthält die folgenden neuen Properties:

  • Die Property status.publicStatsViewable gibt an, ob erweiterte Videostatistiken auf der Wiedergabeseite öffentlich einsehbar sind. Standardmäßig sind diese Statistiken sichtbar. Statistiken wie die Aufrufzahlen und Bewertungen eines Videos sind auch dann öffentlich sichtbar, wenn der Wert dieser Property auf false gesetzt ist. Sie können den Wert dieser Property beim Aufrufen der Methode videos.insert oder videos.update festlegen.

  • Das contentDetails.contentRating-Objekt kapselt die Altersfreigaben ein, die das Video nach verschiedenen Altersfreigabesystemen erhalten hat. In der folgenden Liste sind die unterstützten Altersfreigabesysteme aufgeführt. Außerdem finden Sie einen Link zur Property, die mit dem jeweiligen Altersfreigabesystem verknüpft ist. In den Property-Definitionen werden die unterstützten Altersfreigabe-Werte für jedes System angegeben.

    Land	Altersfreigabesystem	Attribut
    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
    Großbritannien	British Board of Film Classification (BBFC)	contentDetails.contentRating.bbfcRating
    Indien	Central Board of Film Certification (CBFC)	contentDetails.contentRating.cbfcRating
    Japan	映倫管理委員会 (EIRIN)	contentDetails.contentRating.eirinRating
    Korea	영상물등급위원회 (KMRB)	contentDetails.contentRating.kmrbRating
    Mexiko	General Directorate of Radio, Television and Cinematography (RTC)	contentDetails.contentRating.rtcRating
    Neuseeland	Office of Film and Literature Classification	contentDetails.contentRating.oflcRating
    Russland	National Film Registry 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 darauf hinzuweisen, dass die Property snippet.resourceId in der Ressource angegeben werden muss, die als Anfragetext gesendet wird.

• Die search.list-Methode unterstützt jetzt die folgenden Funktionen:

  • Mit dem neuen Parameter forMine wird die Suche so eingeschränkt, dass nur die Videos des authentifizierten Nutzers abgerufen werden.

  • Der Parameter order unterstützt jetzt die alphabetische Sortierung der Ergebnisse nach Titel (order=title) oder nach absteigender Anzahl der Videos (order=videoCount).

  • Der neue Parameter safeSearch gibt an, ob eingeschränkt zulässige Inhalte in den Suchergebnissen enthalten sein sollen.

• Die Methode videos.insert unterstützt mehrere neue Fehler, die in der folgenden Tabelle aufgeführt sind:

  Fehlertyp	Fehlerdetails	Beschreibung
  badRequest	invalidCategoryId	Für die Property snippet.categoryId ist eine ungültige Kategorie-ID angegeben. Verwenden Sie die Methode videoCategories.list, um unterstützte Kategorien abzurufen.
  badRequest	invalidRecordingDetails	metadata specifies invalid recording details.
  badRequest	invalidVideoGameRating	Die Metadaten der Anfrage enthalten eine ungültige Altersfreigabe für Videospiele.
  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:

• Die Property channelTitle wurde der snippet für die folgenden Ressourcen hinzugefügt:

  • activity: Das Attribut gibt den Namen des Kanals an, der für die Aktivität verantwortlich ist.
  • search: Mit dieser Property wird der Name des Kanals angegeben, der mit der im Suchergebnis angegebenen Ressource verknüpft ist.
  • video: Mit diesem Attribut wird der Name des Kanals angegeben, auf den das Video hochgeladen wurde.

• Die Methode search.list unterstützt die folgenden neuen Parameter:

  • Mit dem Parameter channelType kannst du eine Suche nach Kanälen einschränken, um alle Kanäle oder nur Serien abzurufen.

  • Mit dem Parameter videoType kannst du die Suche nach Videos einschränken, sodass alle Videos, nur Filme oder nur Folgen von Serien zurückgegeben werden.

• Die Definition des recordingDetails-Teils der video-Ressource wurde aktualisiert. Das Objekt wird nur für ein Video zurückgegeben, wenn die Standortdaten oder die Aufnahmezeit des Videos festgelegt wurden.

• Die playlistItems.update-Methode gibt jetzt den Fehler invalidSnippet zurück, der auftritt, wenn in der API-Anfrage kein gültiges Snippet angegeben ist.

• Mehrere API-Methoden unterstützen neue Parameter, die ausschließlich für YouTube-Inhaltspartner gedacht sind. Zu den YouTube-Inhaltspartnern gehören Film- und Fernsehstudios, Musiklabels und andere Creator, die ihre Inhalte auf YouTube verfügbar machen.

  • Der Parameter onBehalfOfContentOwner gibt an, dass die Autorisierungsdaten der Anfrage einen YouTube CMS-Nutzer identifizieren, der im Namen des im Parameterwert angegebenen Rechteinhabers handelt. Das CMS-Konto, mit dem sich der Nutzer authentifiziert, muss mit dem angegebenen YouTube-Rechteinhaber verknüpft sein.

    Dieser Parameter richtet sich an Contentpartner, 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 Anmeldedaten für jeden einzelnen Kanal angeben zu müssen.

    Dieser Parameter wird von den Methoden channels.list, search.list, videos.delete, videos.list und videos.update unterstützt.

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

  • Der Parameter forContentOwner, der von der Methode search.list unterstützt wird, weist die API an, die Suchergebnisse auf Ressourcen zu beschränken, die dem Rechteinhaber gehören, der im Parameter onBehalfOfContentOwner 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-Bereiche enthalten Informationen für die Inhaber der hochgeladenen Videos. Diese Daten sind in Apps, die Videouploads ermöglichen, sehr nützlich. Sie umfassen Folgendes:

    • Verarbeitungsstatus und -fortschritt
    • Fehler oder andere Probleme bei der Verarbeitung eines Videos
    • Verfügbarkeit von Thumbnail-Bildern
    • Vorschläge zur Verbesserung der Video- oder Metadatenqualität
    • Details zur Originaldatei, die auf YouTube hochgeladen wurde

    Alle diese Teile können nur vom Rechteinhaber des Videos abgerufen werden. In der folgenden Liste werden die neuen Teile kurz beschrieben. In der video-Ressourcendokumentation werden alle Eigenschaften der einzelnen Teile definiert.

    • Das fileDetails-Objekt enthält Informationen zur Videodatei, die auf YouTube hochgeladen wurde, darunter Auflösung, Dauer, Audio- und Videocodecs sowie Streambitraten.

    • Das processingProgress-Objekt enthält Informationen zum Fortschritt der Verarbeitung der hochgeladenen Videodatei auf YouTube. Die Eigenschaften des Objekts geben den aktuellen Verarbeitungsstatus an und schätzen die verbleibende Zeit bis zur vollständigen Verarbeitung des Videos. Außerdem wird hier angezeigt, ob verschiedene Daten- oder Inhaltstypen wie Dateidetails oder Thumbnail-Bilder für das Video verfügbar sind.

      Dieses Objekt ist für Abfragen konzipiert, damit der Video-Uploader den Fortschritt der Verarbeitung der hochgeladenen Videodatei auf YouTube verfolgen kann.

    • Das suggestions-Objekt enthält Vorschläge, wie sich die Videoqualität oder die Metadaten für das hochgeladene Video verbessern lassen.

  • Der Teil contentDetails enthält vier neue Properties. Diese Properties 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 HD-Auflösung verfügbar ist.
    • caption: Gibt an, ob für das Video Untertitel verfügbar sind.
    • licensedContent: Gibt an, ob das Video Inhalte enthält, für die von einem YouTube-Contentpartner ein Anspruch erhoben wurde.

  • Der Teil status enthält zwei neue Properties. Videoinhaber können beim Einfügen oder Aktualisieren eines Videos Werte für beide Properties festlegen. Diese Properties können auch mit nicht authentifizierten Anfragen abgerufen werden.

    • embeddable – Gibt an, ob das Video auf einer anderen Website eingebettet werden kann.
    • license – Gibt die Lizenz des Videos an. Gültige Werte sind creativeCommon und youtube.

• Die Definition des part-Parameters 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 Property contentDetails.googlePlusUserId der channel-Ressource gibt die Google+-Profil-ID an, die mit dem Kanal verknüpft ist. Mit diesem Wert kann ein Link zum Google+-Profil generiert werden.

• Für jedes Miniaturbildobjekt werden jetzt die Breite und Höhe des Bildes angegeben. Thumbnail-Bilder werden derzeit in den Ressourcen activity, channel, playlist, playlistItem, search result, subscription und video zurückgegeben.

• Der Parameter playlistItems.list unterstützt jetzt den Parameter videoId. Dieser kann in Verbindung mit dem Parameter playlistId verwendet werden, um nur das Playlist-Element abzurufen, das das angegebene Video darstellt.

  Die API gibt einen notFound-Fehler zurück, wenn das Video, das durch den Parameter angegeben wird, in der Playlist nicht gefunden werden kann.

• In der Fehlerdokumentation wird ein neuer forbidden-Fehler beschrieben, der darauf hinweist, dass eine Anfrage nicht ordnungsgemäß für die angeforderte Aktion autorisiert ist.

• Die Property snippet.channelId der Ressource channel wurde entfernt. Das Attribut id der Ressource enthält denselben Wert.

30. Januar 2013

Dieses Update enthält die folgenden Änderungen:

• Auf der neuen Seite Fehler sind Fehler aufgeführt, die von der API zurückgegeben werden können. 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:

• Codebeispiele sind jetzt für die in der folgenden Liste aufgeführten Methoden und Sprachen 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

• Für eine activity-Ressource kann jetzt eine channelItem-Aktion erfasst werden, die auftritt, wenn YouTube einem automatisch erstellten YouTube-Kanal ein Video hinzufügt. (YouTube-Algorithmen identifizieren Themen, die auf der YouTube-Website stark vertreten sind, und erstellen automatisch Kanäle für diese Themen.)

• Die folgenden search.list-Parameter wurden aktualisiert:

  • Der Parameter q ist nicht mehr als Filter gekennzeichnet. Das bedeutet:
  • Der Parameter relatedToVideo wurde in relatedToVideoId umbenannt.
  • Der Parameter published wurde durch zwei neue Parameter ersetzt: publishedAfter und publishedBefore. Diese werden unten beschrieben.

• 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 dem angegebenen Zeitpunkt erstellt wurden.
  publishedBefore	datetime	Gibt Ressourcen zurück, die vor dem angegebenen Zeitpunkt erstellt wurden.
  regionCode	string	Gibt Ressourcen für das angegebene Land zurück.
  videoCategoryId	string	Filtern Sie die Videosuchergebnisse, sodass nur Videos angezeigt werden, die mit der angegebenen Videokategorie verknüpft sind.
  videoEmbeddable	string	Sie können die Videosuchergebnisse so filtern, dass nur Videos angezeigt werden, die in einem eingebetteten Player auf einer Webseite wiedergegeben werden können. Legen Sie den Parameterwert auf true fest, um nur einbettbare Videos abzurufen.
  videoSyndicated	string	Mit diesem Parameter kannst du die Videosuchergebnisse so filtern, dass nur Videos angezeigt werden, die außerhalb von YouTube.com wiedergegeben werden können. Wenn du den Parameterwert auf true festlegst, werden nur syndizierte Videos zurückgegeben.

• Mehrere API-Ressourcen unterstützen neue Properties. In der folgenden Tabelle sind die Ressourcen und ihre neuen Properties aufgeführt:

  Ressource	Property-Name	Wert	Beschreibung
  activity	contentDetails.playlistItem.playlistItemId	string	Die Playlist-Element-ID, die YouTube zugewiesen wurde, um das Element in der Playlist eindeutig zu identifizieren.
  activity	contentDetails.channelItem	object	Ein Objekt mit Informationen zu einer Ressource, die einem Kanal hinzugefügt wurde. Diese Property ist nur vorhanden, wenn snippet.type channelItem ist.
  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-Property, die den Ressourcentyp angibt, z. B. „Video“ oder „Playlist“. Außerdem enthält es genau eine von mehreren Eigenschaften (z. B. videoId oder playlistId), die die ID angibt, mit der die Ressource eindeutig identifiziert wird.
  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, mit denen du die Playlist in einem eingebetteten Player abspielen kannst.
  playlist	player.embedHtml	string	Ein <iframe>-Tag, das einen Videoplayer einbettet, über den die Playlist wiedergegeben wird.
  video	recordingDetails	object	Dieses Objekt enthält Informationen, die den Ort und die Zeit der Aufnahme des Videos identifizieren oder beschreiben.
  video	recordingDetails.location	object	Dieses Objekt enthält Informationen zur Geolokalisierung, die mit dem Video verknüpft sind.
  video	recordingDetails.location.latitude	double	Breitengrad in Grad
  video	recordingDetails.location.longitude	double	Längengrad in Grad
  video	recordingDetails.location.elevation	double	Höhe über der Erde in Metern.
  video	recordingDetails.locationDescription	string	Eine Textbeschreibung des Orts, an dem das Video aufgenommen wurde.
  video	recordingDetails.recordingDate	datetime	Datum und Uhrzeit der Aufnahme des Videos. Der Wert wird im ISO 8601-Format (YYYY-MM-DDThh:mm:ss.sZ) angegeben.

• In der Dokumentation für mehrere API-Methoden werden jetzt Eigenschaften angegeben, die im Anfragetext angegeben werden müssen oder die anhand der Werte im Anfragetext aktualisiert werden. In der folgenden Tabelle sind diese Methoden sowie die erforderlichen oder änderbaren Eigenschaften aufgeführt.

  Hinweis:In der Dokumentation anderer Methoden sind möglicherweise bereits erforderliche und bearbeitbare Properties aufgeführt.

  Methode	Attribute
  activities.insert	Erforderliche Eigenschaften: snippet.description Modifizierbare 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 Playlist hat, die bereits im selben Kanal vorhanden ist.

• 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 mit dem Parameter id angegebene Kategorie für die Anleitung kann nicht gefunden werden. Mit der Methode guideCategories.list können Sie eine Liste der gültigen Werte abrufen.
  playlistItems.delete	forbidden	playlistItemsNotAccessible	Die Anfrage ist nicht berechtigt, das angegebene Playlist-Element zu löschen.
  videoCategories.list	notFound	videoCategoryNotFound	Die mit dem Parameter id angegebene Videokategorie kann nicht gefunden werden. Mit der Methode videoCategories.list kannst du eine Liste der gültigen Werte abrufen.