Überarbeitungsverlauf

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

10. Juli 2025

Ab dem 21. Juli 2025 wird YouTube die Inhalte anpassen, die vom mostPopular-Diagramm der Methode video.list zurückgegeben werden. Bisher wurden im mostPopular-Chart die Videos aufgeführt, die in der Liste „Aktuelle Trends“ präsentiert wurden. In den mostPopular-Charts werden jetzt Videos aus den Trendcharts für Musik, Filme und Gaming angezeigt. Diese API-Änderung erfolgt parallel zur Einstellung der Seite „Trends“ auf YouTube.

26. März 2025

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

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

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

30. Oktober 2024

Die API unterstützt jetzt die Möglichkeit, Videos zu identifizieren, die realistisch aussehende veränderte oder synthetische (V/S) Inhalte enthalten. Weitere Informationen zu den YouTube-Richtlinien für Inhalte zu Alkohol und Tabak

Beispiele für A/S-Inhalte:

• Den Anschein erwecken, dass eine echte Person etwas sagt oder tut, was sie nicht gesagt oder getan hat
• Aufnahmen eines realen Ereignisses oder Orts verändern
• Es enthält eine realistisch anmutende Szene, die nicht wirklich stattgefunden hat

Um anzugeben, ob ein Video Inhalte für Erwachsene enthält, legen Sie die Eigenschaft status.containsSyntheticMedia fest. Dieses Attribut 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 auf der YouTube-Website unterstützten Funktion, bei der keine Kommentare auf Kanälen gepostet werden können.

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 Untertitel-Tracks Zeitinformationen angeben, da der Upload sonst fehlschlägt.

12. März 2024

Dieses Update enthält die folgenden Änderungen:

Die Dokumentation für die Ressource captions wurde aktualisiert. Das Feld snippet.name darf jetzt maximal 150 Zeichen lang sein. Wenn der Trackname länger ist, gibt die API den Fehler nameTooLong zurück.

7. März 2024

Hinweis:Dies ist eine Ankündigung zur Einstellung.

Das Ressourcenattribut 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 können Sie Informationen zu einem Kanal abrufen, indem Sie seinen YouTube-Alias angeben.

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 auf YouTube nicht mehr unterstützt und ist auch nicht mehr über die API verfügbar.

Allen Dokumenten, in denen auf die Methode comments.markAsSpam verwiesen wird, wurde eine Mitteilung zur Einstellung hinzugefügt.

22. August 2023

Die Methode search.list unterstützt jetzt den Parameter videoPaidProductPlacement. Mit diesem Parameter können Sie Suchergebnisse filtern, sodass nur Videos angezeigt werden, die der Creator als bezahlte Werbung gekennzeichnet hat.

18. August 2023

Die Definition der video-Ressource liveStreamingDetails.concurrentViewers wurde aktualisiert. Es wird nun darauf hingewiesen, dass die Anzahl der gleichzeitigen Zuschauer, die von der YouTube Data API zurückgegeben wird, von der verarbeiteten, von Spam bereinigten Anzahl der gleichzeitigen Zuschauer in YouTube Analytics abweichen kann. 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 darauf wurden aus der API-Dokumentation entfernt.

28. Juni 2023

Die Methode thumbnails.set unterstützt jetzt den Fehler uploadRateLimitExceeded. Dieser gibt an, dass auf dem Kanal in den letzten 24 Stunden zu viele Thumbnails hochgeladen wurden. Der Nutzer sollte es später noch einmal versuchen.

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.

Der Dokumentation der Methode search.list wurde eine Mitteilung zur Einstellung hinzugefügt. Dieser Parameter wird am oder nach dem 7. August 2023 vollständig aus der search.list-Dokumentation entfernt.

Außerdem wurde ein Beispiel, das zeigt, wie ähnliche Videos abgerufen werden, aus dem Implementierungsleitfaden für die API entfernt.

22. August 2022

Korrigierte Typanmerkungen für video.statistics-Felder 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, in denen caption_id-Werte gespeichert werden. Anwendungen, in denen keine caption_id-Werte gespeichert werden, sind davon jedoch nicht betroffen.

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

Um sich auf diese Änderung vorzubereiten, sollten Sie alle gespeicherten Untertitel-Track-Daten bis zum 1. Dezember 2022 vollständig ersetzen. Das bedeutet, dass Sie für jedes Video, für das Sie Untertitel-Track-Daten speichern, die aktuell gespeicherten Daten löschen und dann die Methode captions.list aufrufen sollten, um die aktuellen Untertitel-Tracks für das Video abzurufen. Speichern Sie die Daten in der API-Antwort wie gewohnt.

12. Juli 2022

Die Nutzungsbedingungen der YouTube-API-Dienste wurden aktualisiert. Weitere Informationen finden Sie im Revisionsverlauf der Nutzungsbedingungen für YouTube-APIs.

27. April 2022

Die Methodenbeschreibung für videos.insert wurde aktualisiert. Die maximale Dateigröße für hochgeladene Videos wurde von 128 GB auf 256 GB erhöht.

8. April 2022

Die Parameterdefinitionen myRecentSubscribers und mySubscribers der Methode subscriptions.list wurden aktualisiert, um darauf hinzuweisen, dass die maximale Anzahl der von der API zurückgegebenen Abonnenten begrenzt sein kann. Es handelt sich lediglich um eine Korrektur der Dokumentation, das API-Verhalten bleibt unverändert.

15. Dezember 2021

Wie am 18. November 2021 angekündigt, ist die statistics.dislikeCount-Eigenschaft der video-Ressource im Zusammenhang mit Änderungen, durch die die Anzahl der Dislikes von Videos auf der gesamten YouTube-Plattform privat wird, jetzt privat.

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 auf der gesamten YouTube-Plattform privat wird, wird die statistics.dislikeCount-Eigenschaft der video-Ressource ab dem 13. Dezember 2021 privat. Das bedeutet, dass das Attribut nur in einer API-Antwort vom videos.list-Endpunkt enthalten ist, wenn die API-Anfrage vom Videoinhaber authentifiziert wurde.

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

Entwickler, die die Anzahl der Dislikes nicht öffentlich anzeigen und die Anzahl der Dislikes für ihren API-Client benötigen, können eine Ausnahme beantragen. 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 hat Funktionen dupliziert, die über andere API-Endpunkte verfügbar sind. Stattdessen können Sie die comments.update

und, falls für Ihren Code eine commentThreads-Ressource erforderlich ist, einen sekundären Aufruf der Methode commentThreads.list.

1. Juli 2021

Alle Entwickler, die die API-Dienste von YouTube nutzen, müssen ein API-Compliance-Audit durchlaufen, um ein Kontingent von mehr als den standardmäßigen 10.000 Einheiten zu erhalten. Bisher wurden sowohl das Compliance-Audit als auch Anfragen nach zusätzlichen 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 Entwicklern mit bestandener Prüfung: Entwickler, die bereits eine API-Compliance-Prüfung bestanden haben, können dieses kürzere Formular ausfüllen und einreichen, um eine Erhöhung des zugewiesenen Kontingents zu beantragen.
• Beschwerdeformular: Entwickler, deren API-Projekte bei einem Compliance-Audit nicht bestanden haben oder denen eine Erhöhung des Kontingents verweigert wurde, können dieses Formular ausfüllen und einreichen.
• Formular für Kontrollwechsel: Entwickler oder andere Parteien, die einen API-Client im Namen eines Entwicklers betreiben und bei denen es zu einem Kontrollwechsel kommt (z. B. durch einen Aktienkauf oder -verkauf, eine Fusion oder eine andere Unternehmenstransaktion) in Verbindung mit einem API-Projekt, müssen dieses Formular ausfüllen und einreichen. So kann das YouTube-API-Team unsere Aufzeichnungen aktualisieren, die Einhaltung der Anwendungsfallrichtlinien für das neue API-Projekt prüfen und das aktuelle Kontingent des Entwicklers bestätigen.

Jedes neue Formular informiert uns über die beabsichtigte Nutzung der YouTube-API und ermöglicht es uns, Sie besser zu unterstützen.

Weitere Informationen finden Sie in unserem Leitfaden zu API-Compliance-Prüfungen.

12. Mai 2021

Hinweis:Dies ist eine Ankündigung zur Einstellung.

Dieses Update umfasst die folgenden API-Änderungen:

• Die channel-Ressource contentDetails.relatedPlaylists.favorites wird nicht mehr unterstützt. Die Funktion „Lieblingsvideos“ wurde bereits vor mehreren Jahren eingestellt, wie im Revisionsverlauf vom 28. April 2016 beschrieben.

  Vor diesem Update wurde über die API eine neue Playlist erstellt, wenn ein API-Client versuchte, ein Video zu einer nicht vorhandenen Favoritenplaylist hinzuzufügen. Künftig wird die Playlist in diesem Fall nicht erstellt und die API gibt einen Fehler zurück. Versuche, Favoriten-Playlists durch Hinzufügen, Ändern oder Löschen von Elementen zu ändern, sind gemäß früheren Ankündigungen ebenfalls eingestellt und können jederzeit Fehler zurückgeben.

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

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

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

• Die folgenden channelSection-Ressourceneigenschaften wurden eingestellt. Diese Eigenschaften werden in der YouTube Studio-Benutzeroberfläche und auf YouTube bereits nicht mehr 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 unterstützt werden.

  Alle Attribute wurden aus der Ressourcendarstellung channelSection entfernt und ihre Definitionen wurden aus der Attributliste der Ressource entfernt. Außerdem wurden Fehler, die mit diesen Attributen zusammenhängen, aus der methodenspezifischen Dokumentation entfernt.

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

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

• Die playlist-Ressource wird nicht mehr unterstützt. Das Attribut „snippet.tags[]“ wird nicht mehr unterstützt. Diese Eigenschaft wird auf YouTube bereits nicht mehr unterstützt und daher auch nicht mehr über die API.

9. Februar 2021

Die Ressource playlistItem unterstützt zwei neue Attribute:

• Die snippet.videoOwnerChannelId-Eigenschaft gibt die ID des Kanals an, auf dem das Playlist-Video hochgeladen wurde.
• Die snippet.videoOwnerChannelTitle-Eigenschaft gibt den Namen des Kanals an, auf dem das Playlist-Video hochgeladen wurde.

28. Januar 2021

Dieses Update enthält die folgenden Änderungen:

• Die Methoden playlistItems.delete, playlistItems.insert, playlistItems.list, playlistItems.update, playlists.delete, playlists.list und playlists.update unterstützen alle den neuen Fehler playlistOperationUnsupported. Der Fehler tritt auf, wenn in einer Anfrage versucht wird, eine Operation auszuführen, die für eine bestimmte Playlist nicht zulässig ist. Ein Nutzer kann beispielsweise kein Video aus der Playlist mit hochgeladenen Videos löschen und auch die Playlist selbst nicht löschen.

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

• Die Fehler watchHistoryNotAccessible und watchLaterNotAccessible der Methode playlistItems.list wurden aus der Dokumentation entfernt. Der Wiedergabeverlauf und die Liste „Später ansehen“ von Nutzern sind zwar nicht über die API zugänglich, diese speziellen Fehler werden aber nicht von der API zurückgegeben.

15. Oktober 2020

Den Entwicklerrichtlinien wurden zwei neue Abschnitte hinzugefügt:

• Im neuen Abschnitt III.E.4.i finden Sie zusätzliche Informationen zu den Daten, die über den eingebetteten YouTube-Player erhoben und gesendet werden. Sie sind für alle Nutzerdaten verantwortlich, die Sie uns über einen eingebetteten YouTube-Player senden, bevor der Nutzer mit dem Player interagiert hat, um die Wiedergabe zu starten. Sie können die Daten, die mit YouTube geteilt werden, begrenzen, bevor ein Nutzer mit dem Player interagiert. Stellen Sie dazu „Autoplay“ auf „false“.
• Der neue Abschnitt III.E.4.j bezieht sich auf die Prüfung des Status „Speziell für Kinder“ von Inhalten, bevor Sie sie in Ihre Websites und Apps einbetten. Sie sind dafür verantwortlich, zu wissen, wann Videos, die Sie in Ihren API-Client einbetten, speziell für Kinder erstellt wurden, und Daten, die über den eingebetteten Player erhoben werden, entsprechend zu behandeln. Daher müssen Sie den Status von Inhalten über den YouTube Data API-Dienst prüfen, bevor Sie sie über eingebettete YouTube-Player in Ihren API-Client einbetten.

Im neuen Leitfaden Status „Für Kinder“ eines Videos ermitteln wird beschrieben, wie Sie den Status „Für Kinder“ eines Videos mit dem YouTube Data API-Dienst abrufen.

Im Zusammenhang mit diesen Änderungen wurde der Dokumentation zu Parametern für eingebettete Player eine Erinnerung hinzugefügt. Darin wird erklärt, 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 snippet.thumbnails-Objekt, 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 wird.
• Die Property statistics.videoCount gibt nur die Anzahl der öffentlichen Videos des Kanals an, auch für Inhaber. Dieses Verhalten entspricht den Zählungen auf der YouTube-Website.
• Channel-Keywords, die in der Property brandingSettings.channel.keywords angegeben sind, werden möglicherweise gekürzt, wenn sie die maximal zulässige Länge von 500 Zeichen überschreiten oder nicht maskierte Anführungszeichen (") enthalten. Das Limit von 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 Ankündigung. Daher sollten Entwickler die unten aufgeführten API-Funktionen nicht mehr verwenden.

• Die folgenden API-Ressourcen, Methoden, Parameter und Ressourcenattribute werden sofort eingestellt und funktionieren ab dem Datum dieser Ankündigung oder danach nicht mehr:
  • Die folgenden Attribute der channel-Ressource:
    • Die statistics.commentCount-Property
    • Das brandingSettings.image-Objekt und alle seine untergeordneten Attribute
    • Die Liste brandingSettings.hints und alle untergeordneten Attribute
  • Der categoryId-Filterparameter der channels.list-Methode
  • Die Ressource guideCategories und die Methode guideCategories.list
• API-Antworten für die Methode channels.list enthalten die Eigenschaft prevPageToken nicht mehr, wenn in der API-Anfrage der Parameter managedByMe auf true festgelegt ist. Diese Änderung hat keine Auswirkungen auf die prevPageToken-Eigenschaft für andere channels.list-Anfragen und auch nicht auf die nextPageToken-Eigenschaft für Anfragen.
• Die Attribute contentDetails.relatedPlaylists.watchLater und contentDetails.relatedPlaylists.watchHistory der Ressource channel wurden am 11. August 2016 als eingestellt angekündigt. Die Unterstützung der Methoden playlistItems.insert und playlistItems.delete für diese Playlists wurde ebenfalls eingestellt und die beiden Eigenschaften wurden aus der Dokumentation entfernt.
• Der Parameter mySubscribers der Methode channels.list, dessen Einstellung am 30. Juli 2013 angekündigt wurde, wurde aus der Dokumentation entfernt. Mit der Methode subscriptions.list und dem zugehörigen Parameter mySubscribers können Sie eine Liste der Abonnenten des Kanals des authentifizierten Nutzers abrufen.
• Das invideoPromotion-Objekt der channel-Ressource und alle untergeordneten Attribute, die am 27. November 2017 als eingestellt angekündigt wurden, wurden aus der Dokumentation entfernt.

29. Juli 2020

Wir haben die Berechnung des Kontingents für API-Anfragen vereinfacht, indem wir die zusätzlichen Kosten für den Parameter part entfernt haben. Ab sofort berechnen wir nur noch die Basiskosten für die aufgerufene Methode. Weitere Informationen zum vereinfachten Kontingent

Die meisten API-Aufrufe haben dann geringere Kontingentkosten, einige API-Aufrufe kosten weiterhin dasselbe. Diese Änderung führt nicht zu höheren Kosten für API-Aufrufe. Insgesamt wird sich das wahrscheinlich so auswirken, dass Ihr zugewiesenes Kontingent, das Sie in der Google Cloud Console sehen können, etwas länger reicht.

Wir empfehlen allen Entwicklern dringend, für ihre Projekte einen Compliance-Audit durchzuführen, um den fortgesetzten Zugriff auf die YouTube API-Dienste sicherzustellen.

Dieser Eintrag im Revisionsverlauf wurde ursprünglich am 20. Juli 2020 veröffentlicht.

28. Juli 2020

Alle Videos, die über den videos.insert-Endpunkt von nicht bestätigten API-Projekten hochgeladen werden, die nach dem 28. Juli 2020 erstellt wurden, werden auf den privaten Anzeigemodus beschränkt. Um diese Einschränkung aufzuheben, muss jedes Projekt geprüft werden, um die Einhaltung der Nutzungsbedingungen zu bestätigen.

Creator, die einen nicht verifizierten API-Client zum Hochladen von Videos verwenden, erhalten eine E-Mail, in der erklärt 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 nicht von dieser Änderung betroffen. Wir empfehlen jedoch dringend, dass alle Entwickler für ihre Projekte einen Compliance-Audit durchführen, um den fortgesetzten Zugriff auf die YouTube API-Dienste sicherzustellen.

21. Juli 2020

[Aktualisiert am 28. Juli 2020] Die in diesem Eintrag im Überarbeitungsverlauf erwähnte Aktualisierung der Dokumentation wurde am 28. Juli 2020 neu veröffentlicht.

Gestern haben wir eine Aktualisierung der Dokumentation zu unserem Verfahren für die Berechnung von Kontingenten veröffentlicht. Aufgrund unvorhergesehener Umstände ist die Änderung des Kontingents jedoch noch nicht in Kraft getreten. Aus diesem Grund wurde die Dokumentation im Interesse der Richtigkeit zurückgesetzt. Um Verwirrung zu vermeiden, wurde der Eintrag im Überarbeitungsverlauf, in dem die Änderung erläutert wird, entfernt und wird in naher Zukunft neu verö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

Der neue Leitfaden Einhaltung der YouTube-Richtlinien für Entwickler enthält Anleitungen und Beispiele, die Ihnen helfen sollen, sicherzustellen, dass Ihre API-Clients bestimmte Abschnitte der Nutzungsbedingungen und Richtlinien für die YouTube-API-Dienste (API-Nutzungsbedingungen) einhalten.

Diese Anleitung gibt Aufschluss darüber, wie YouTube bestimmte Aspekte der API-Nutzungsbedingungen durchsetzt, ersetzt jedoch keine bestehenden Dokumente. In dieser Anleitung werden einige der häufigsten Fragen beantwortet, die Entwickler bei API-Compliance-Prüfungen stellen. Wir hoffen, dass diese Informationen die Entwicklung von Funktionen 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 Einstellung.

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

17. April 2020

Hinweis:Dies ist eine Ankündigung zur Einstellung.

YouTube stellt die Funktion „Kanalmitteilungen“ ein. Daher wird die Methode activities.insert eingestellt und die Methode activities.list gibt keine Kanalmitteilungen 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 repräsentiert ein Kanalmitglied für einen YouTube-Kanal. Mitglieder unterstützen Creator regelmäßig finanziell und erhalten dafür besondere Vorteile. Mitglieder können beispielsweise chatten, wenn der Creator den Modus „Nur für Mitglieder“ für einen Chat aktiviert.

    Diese Ressource ersetzt die sponsor-Ressource, die in der YouTube Live Streaming API dokumentiert ist. Die sponsor-Ressource ist jetzt veraltet. API-Clients sollten Aufrufe der sponsors.list-Methode aktualisieren, um stattdessen die members.list-Methode zu verwenden.

  • Die neue membershipsLevel-Ressource identifiziert eine vom Creator verwaltete Preisstufe, der die API-Anfrage autorisiert hat. Mit der Methode membershipsLevels.list wird eine Liste aller Mitgliedschaftsstufen des Creators abgerufen.

10. Januar 2020

Die API unterstützt jetzt die Möglichkeit, Inhalte zu identifizieren, die speziell für Kinder erstellt wurden. YouTube bezeichnet diese Inhalte als „speziell für Kinder“. Weitere Informationen zu Inhalten speziell für Kinder findest du in der YouTube-Hilfe.

Die Ressourcen channel und video unterstützen zwei neue Eigenschaften, mit denen Creator und Zuschauer Inhalte, die speziell für Kinder erstellt wurden, identifizieren können:

• Mit der Eigenschaft selfDeclaredMadeForKids können Creator angeben, ob ein Kanal oder ein Video speziell für Kinder ist.
  
  Für Channels 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.
  
  Dieses Attribut ist nur in API-Antworten enthalten, die channel- oder video-Ressourcen enthalten, wenn der Kanalinhaber die API-Anfrage autorisiert hat.
• Mit der Eigenschaft madeForKids kann jeder Nutzer den Status „speziell für Kinder“ eines Kanals oder Videos abrufen. Der Status kann beispielsweise anhand des Werts der Eigenschaft selfDeclaredMadeForKids ermittelt werden. Weitere Informationen zum Festlegen der Zielgruppe für deinen Kanal, deine Videos oder deine Livestreams findest du in der YouTube-Hilfe.

Wir haben auch die Nutzungsbedingungen der YouTube API-Dienste und die Richtlinien für Entwickler aktualisiert. Weitere Informationen finden Sie im Revisionsverlauf der Nutzungsbedingungen für YouTube-APIs. Die Änderungen an den Nutzungsbedingungen für YouTube API-Dienste und den Entwicklerrichtlinien treten am 10. Januar 2020 um 09:00 Uhr (Pazifische Zeit) in Kraft.

10. September 2019

Die API-Referenzdokumentation wurde aktualisiert, um eine Änderung bei der Art und Weise widerzuspiegeln, wie Abonnentenzahlen auf YouTube und folglich in API-Antworten gemeldet werden. Durch die Änderung werden Abonnentenzahlen, die vom YouTube Data API-Dienst zurückgegeben werden, ab 1.000 Abonnenten auf drei signifikante Stellen abgerundet. Diese Änderung betrifft die Property statistics.subscriberCount der Ressource channel.

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

Wenn ein Kanal beispielsweise 123.456 Abonnenten hat, enthält das Attribut statistics.subscriberCount den Wert 123000. In der folgenden Tabelle siehst 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 APIs Explorer-Widget bereitzustellen. Ein Beispiel finden Sie in der Dokumentation zur Methode channels.list. Auf Seiten, auf denen API-Methoden beschrieben werden, gibt es jetzt zwei neue Elemente:

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

  • Im Abschnitt Häufige Anwendungsfälle werden ein oder mehrere häufige Anwendungsfälle für die auf der Seite beschriebene Methode beschrieben. Sie können beispielsweise die Methode channels.list aufrufen, um Daten zu einem bestimmten Kanal oder zum Kanal des aktuellen Nutzers abzurufen.

    Über die Links in diesem Abschnitt können Sie APIs Explorer mit Beispielwerten für Ihren Anwendungsfall füllen oder APIs Explorer im Vollbildmodus mit diesen Werten öffnen. Diese Änderungen sollen es Ihnen erleichtern, 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 Codebeispiele wurde ebenfalls aktualisiert und bietet jetzt eine neue Benutzeroberfläche mit allen oben beschriebenen Funktionen. Mit diesem Tool können Sie Anwendungsfälle für verschiedene Methoden untersuchen, Werte in den APIs Explorer laden und den Vollbild-APIs Explorer öffnen, um Codebeispiele in Java, JavaScript, PHP und Python zu erhalten.

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

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

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 des Attributs snippet.thumbnails der Ressource channel wurde aktualisiert. Wenn Sie Thumbnails in Ihrer Anwendung anzeigen, sollte Ihr Code die Bild-URLs genau so verwenden, wie sie in API-Antworten zurückgegeben werden. Ihre Anwendung sollte beispielsweise in einer URL, die in einer API-Antwort zurückgegeben wird, nicht die http-Domain anstelle der https-Domain verwenden.

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

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

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

22. Juni 2018

Die Implementierungsanleitung, die früher als Implementierungs- und Migrationsanleitung bezeichnet wurde, 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 Angesagte 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:

  • Bei dem Versuch, den invideoPromotion-Teil beim Aufrufen von channels.list abzurufen, wird ein leerer invideoPromotion-Wert zurückgegeben oder es werden überhaupt keine invideoPromotion-Daten zurückgegeben.
  • Versuche, invideoPromotion-Daten beim Aufrufen von channels.update zu aktualisieren, geben bis mindestens 27. Mai 2018 eine erfolgreiche Antwort zurück. Sie werden jedoch als No-Ops behandelt, d. h., es wird keine Aktualisierung durchgeführt.

  Nach dem 27. Mai 2018 kann es sein, dass 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 Tool für Code-Snippets 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 anwendungsfallspezifischen Ausgangspunkt für eine Node.js-Anwendung bieten. Die Funktionalität ähnelt dem Code in der Node.js-Kurzanleitung. Die Beispiele enthalten jedoch einige Hilfsfunktionen, die im Schnellstart nicht vorkommen:

  • Die Funktion removeEmptyParameters verwendet eine Liste von Schlüssel/Wert-Paaren, die API-Anfrageparametern entsprechen, und entfernt die Parameter ohne Werte.
  • Die Funktion createResource akzeptiert eine Liste von Schlüssel/Wert-Paaren, die den Attributen in einer API-Ressource entsprechen. Anschließend werden die Attribute in ein JSON-Objekt konvertiert, das in insert- und update-Vorgängen verwendet werden kann. Im folgenden Beispiel sehen Sie eine Reihe von Attributnamen und ‑werten sowie das JSON-Objekt, das der Code dafür erstellen würde:

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

  Alle diese Beispiele sind so konzipiert, dass sie heruntergeladen und lokal ausgeführt werden können. Weitere Informationen finden Sie in der Anleitung zum Tool für Code-Snippets 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 und verwenden jetzt die Bibliotheken google-auth und google-auth-oauthlib anstelle der Bibliothek oauth2client, die jetzt eingestellt ist.

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

  1. Rufen Sie das interaktive Code-Snippet-Tool oder die Dokumentation für eine beliebige API-Methode auf, z. B. die Methode channels.list.
  2. Klicken Sie über den Codebeispielen auf den Tab Python.
  3. Klicken Sie über den Tabs auf den Schalter, um von einem Ausschnitt zu einem vollständigen Beispiel zu wechseln.
     
  4. Auf dem Tab sollte nun ein vollständiges Codebeispiel angezeigt werden, in dem der InstalledAppFlow-Autorisierungsablauf verwendet wird. Die Beschreibung über dem Beispiel erläutert dies und verweist auch auf ein Beispiel für eine Webserveranwendung.
  5. Klicken Sie auf den Link, um zum Webserverbeispiel zu wechseln. In diesem Beispiel werden das Flask-Framework für Webanwendungen und ein anderer Autorisierungsablauf verwendet.

  Alle diese Beispiele sind so konzipiert, dass sie heruntergeladen und lokal ausgeführt werden können. Wenn Sie die Beispiele ausführen möchten, folgen Sie der Anleitung zum Ausführen vollständiger Codebeispiele lokal in der Anleitung zum 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 werden.
• Die Definition des Parameters regionCode der Methode search.list wurde aktualisiert, um klarzustellen, dass der Parameter die Suchergebnisse auf Videos beschränkt, die in der angegebenen Region angesehen werden können.
• YouTube hat seine Branding-Logos und ‑Symbole aktualisiert. Neue Logos für „Developed with YouTube“ können auf der Seite Branding-Richtlinien heruntergeladen werden. Auf dieser Seite sind auch andere neue YouTube-Logos und ‑Symbole zu sehen, die von der YouTube-Markenwebsite heruntergeladen werden können.

24. Juli 2017

Dieses Update enthält die folgenden Änderungen:

• Es gibt eine neue iOS für iOS. In dieser Anleitung wird beschrieben, wie Sie die YouTube Data API in einer einfachen iOS-Anwendung verwenden, 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 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 die 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 Eigenschaften werden zwar bis zum 1. Dezember 2017 unterstützt, es gibt jedoch keine Garantie, dass Videos bis dahin weiterhin Werte für diese Eigenschaften zurückgeben. Ebenso werden für videos.insert- und videos.update-Anfragen, mit denen diese Attributwerte festgelegt werden, vor diesem Datum keine Fehler generiert. 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 häufiger und interaktiver zu gestalten. Auf Seiten, auf denen API-Methoden wie channels.list oder videos.rate erläutert werden, finden Sie 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 werden im Tool Code-Snippets für einen oder mehrere Anwendungsfälle angezeigt. Jeder Anwendungsfall beschreibt eine gängige Methode zum Aufrufen der jeweiligen Methode. Sie können beispielsweise die Methode channels.list aufrufen, um Daten zu einem bestimmten Kanal oder zum Kanal des aktuellen Nutzers abzurufen.

  Sie können auch mit Codebeispielen interagieren:

  • Sie können Parameter- und Property-Werte ändern. Die Code-Snippets werden dann dynamisch aktualisiert, um die von Ihnen angegebenen Werte zu berücksichtigen.

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

  • Anfragen durch Klicken auf eine Schaltfläche ausführen 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 Seiten ersetzt, auf denen es verfügbar ist. 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 nun eine neue Benutzeroberfläche mit allen oben beschriebenen Funktionen. Die wichtigsten neuen Funktionen auf dieser Seite sind:

  • Unterstützung für API-Anfragen, mit denen Daten geschrieben werden.
  • Unterstützung für Java-Beispiele.
  • Flexiblerer und umfassenderer Boilerplate-Code für die Autorisierung von Nutzern und das Erstellen von API-Anfragen.

27. April 2017

Dieses Update enthält die folgenden Änderungen:

• In neuen Kurzanleitungen wird erläutert, wie Sie eine einfache Anwendung einrichten, 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 topicDetails.topicCategories[]-Eigenschaft 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 topicDetails.topicIds[]-Property der Ressource zurückgegeben werden.
• Die neue contentDetails.videoPublishedAt-Property der playlistItem-Ressource gibt den Zeitpunkt an, zu dem das Video auf YouTube veröffentlicht wurde. Die Ressource enthält bereits die Eigenschaft snippet.publishedAt, die angibt, wann das Element der Playlist hinzugefügt wurde.
• Wie bei der channel-Ressource wird bei der video-Ressource jetzt die Eigenschaft topicDetails.topicCategories[] zurückgegeben, die eine Liste von Wikipedia-URLs enthält, die den Inhalt des Videos beschreiben. Bei video-Ressourcen entsprechen die URLs den Themen-IDs, die in der topicDetails.relevantTopicIds[]-Property der Ressource zurückgegeben werden.
• Die neue contentDetails.contentRating.mpaatRating-Property der video-Ressource gibt die Altersfreigabe an, die die Motion Picture Association of America für einen Filmtrailer oder eine Filmvorschau erteilt hat.

27. Februar 2017

Wie ursprünglich am 11. August 2016 angekündigt, hat YouTube die Liste der unterstützten Themen-IDs auf eine kuratierte Liste umgestellt. Die vollständige Liste der unterstützten Themen-IDs ist in den topicDetails-Attributen für channel- und video-Ressourcen sowie im Parameter topicId der Methode search.list enthalten.

Beachten Sie, dass es mehrere Änderungen an der kuratierten Liste gibt:

• Die folgenden Themen wurden als untergeordnete Themen von 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 Thema von Entertainment war, wurde entfernt.
• Das Thema Children's music, das zuvor ein untergeordnetes Thema von Music war, wurde entfernt.

Durch diese Änderung werden Themen, die mit einem Video zusammenhängen, jetzt immer im Eigenschaftswert topicDetails.relevantTopicIds[] der video-Ressource zurückgegeben.

29. November 2016

Dieses Update enthält die folgenden Änderungen:

• Ab dem 10. Februar 2017 gibt es drei kleine Änderungen an der Liste der unterstützten Themen-IDs:

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

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

10. November 2016

Dieses Update enthält die folgenden Änderungen:

• Wie erstmals am 11. August 2016 angekündigt, erfordert die Einstellung von Freebase und der Freebase API mehrere Änderungen im Zusammenhang mit Themen-IDs. Mit Themen-IDs werden Themen identifiziert, die mit channel- und video-Ressourcen verknüpft sind. Außerdem können Sie mit dem Suchparameter topicId nach Kanälen oder Videos zu einem bestimmten Thema suchen.

  Ab dem 10. Februar 2017 gibt YouTube nur noch eine kleine Anzahl von Themen-IDs zurück, anstatt der bisherigen, viel detaillierteren IDs. Außerdem werden Kanäle und Videos nicht zwangsläufig mit Themen verknüpft. 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 ‑Attribute aktualisiert, um die Themen-IDs aufzulisten, die danach unterstützt werden. Die Liste der Kategorien ist für alle Properties gleich.

  • 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 Eigenschaften 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 Eigenschaft enthält nach dem 10. Februar 2017 keine Werte mehr. Danach werden mit dem Property-Wert topicDetails.relevantTopicIds[] alle Themen identifiziert, die mit einem Video verknüpft sind.

• Da Freebase bereits eingestellt wurde, wurde die Anleitung Mit Freebase-Themen suchen aus der Dokumentation entfernt. Dieser Leitfaden enthielt Codebeispiele, die zeigten, wie eine Anwendung mit der Freebase API funktionieren würde.

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

2. November 2016

Dieses Update enthält die folgenden Änderungen:

• Neue Properties und Parameter

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

    • Die Eigenschaft player.embedHtml enthält ein <iframe>-Tag, mit dem Sie einen Player einbetten können, in dem das Video abgespielt wird. Die neuen Attribute player.embedHeight und player.embedWidth geben die Abmessungen des eingebetteten Players an. Diese Attribute werden nur zurückgegeben, wenn in der API-Anfrage ein Wert für mindestens einen der Parameter maxHeight oder maxWidth angegeben ist. Diese beiden neuen Parameter werden weiter unten in diesem Revisionsverlaufseintrag 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 für die Altersfreigabe des FPB (Südafrika) für das Video an.

    • 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 einen oder beide Parameter verwenden, wenn Sie den player-Teil in video-Ressourcen abrufen.

    Standardmäßig beträgt die Höhe des <iframe>, das in der Eigenschaft player.embedHtml zurückgegeben wird, 360 px. Die Breite wird an das Seitenverhältnis des Videos angepasst, sodass der eingebettete Player keine schwarzen Balken um das Video herum hat. Wenn das Seitenverhältnis eines Videos beispielsweise 16:9 ist, beträgt die Breite des Players 640 Pixel.

    Mit den neuen Parametern können Sie festlegen, dass der Einbettungscode anstelle der Standardabmessungen eine Höhe und/oder Breite verwenden soll, die für das Layout Ihrer Anwendung geeignet ist. Der API-Server passt die Player-Abmessungen entsprechend an, damit der eingebettete Player keine schwarzen Balken um das Video herum hat. Beide Parameter geben die maximalen Abmessungen des eingebetteten Players an. Wenn also beide Parameter angegeben sind, kann eine Dimension immer noch kleiner als der für diese Dimension zulässige Höchstbetrag sein.

    Angenommen, ein Video hat ein Seitenverhältnis von 16:9. Das player.embedHtml-Tag würde also einen Player mit einer Größe von 640 × 360 Pixeln 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 gesetzt 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 den Abmessungen 800 × 450 zurück.

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

• Aktualisierungen vorhandener Methoden, Attribute und Parameter

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

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

  • Die Definition der snippet.name-Property der i18nLanguage-Ressource wurde korrigiert. Der Wert stellt den Namen einer Sprache dar, wie er in der Sprache geschrieben wird, die durch den hl-Parameter der i18nLanguage.list-Methode angegeben wird.

  • Die contentDetails.note-Eigenschaft der playlistItem-Ressource wurde aktualisiert. Der maximale Wert der Eigenschaft beträgt 280 Zeichen.

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

  • Die Methoden playlistItems.delete und playlistItems.update unterstützen jetzt den Parameter onBehalfOfContentOwner, der bereits für mehrere andere Methoden unterstützt wird. Anfragen, die diese Methode verwenden, müssen auch mit einem Token autorisiert werden, das Zugriff auf den Bereich https://www.googleapis.com/auth/youtubepartner bietet.

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

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

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

• Neue und aktualisierte Fehler

  • Die API unterstützt die folgenden neuen Fehler:

    Fehlertyp	Fehlerdetails	Beschreibung
    forbidden (403)	homeParameterDeprecated	Die activities.list-Methode gibt diesen Fehler zurück, um anzugeben, dass die Aktivitätsdaten 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 Methode playlistItems.insert gibt diesen Fehler zurück, um anzugeben, dass das contentDetails-Objekt in der Anfrage ungültig ist. Ein Grund für diesen Fehler ist, dass das Feld contentDetails.note länger als 280 Zeichen ist.
    forbidden (403)	watchHistoryNotAccessible	Die Methode playlistItems.list gibt diesen Fehler zurück, um anzugeben, dass mit der Anfrage versucht wurde, Playlist-Elemente des Typs „Wiedergabeverlauf“ abzurufen. Diese können jedoch nicht über die API abgerufen werden.
    forbidden (403)	watchLaterNotAccessible	Die Methode playlistItems.list gibt diesen Fehler zurück, um anzugeben, dass mit der Anfrage versucht wurde, Elemente der Playlist „Später ansehen“ abzurufen. Diese können jedoch nicht über die API abgerufen werden.
    badRequest (400)	uploadLimitExceeded	Die Methode videos.insert gibt diesen Fehler zurück, um anzugeben, dass der Kanal die Anzahl der Videos überschritten hat, die hochgeladen werden dürfen.
    forbidden (403)	forbiddenEmbedSetting	Die Methode videos.update gibt diesen Fehler zurück, um anzugeben, dass in 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 Sie ein doppeltes Video in eine Playlist einfügen. Dieser Fehler trat zuvor bei einigen Playlists auf, z. B. bei Playlists mit Lieblingsvideos, in denen keine Duplikate zulässig waren, die aber nicht mehr unterstützt werden. Im Allgemeinen sind doppelte Videos in Playlists zulässig.

• Weitere Updates

  • Der Revisionsverlaufseintrag vom 15. September 2016 wurde aktualisiert, um klarzustellen, dass die Eigenschaften contentDetails.relatedPlaylists.watchHistory und contentDetails.relatedPlaylists.watchLater der Ressource channel in einer Antwort immer die Werte HL bzw. WL enthalten. Außerdem werden diese Eigenschaften nur berücksichtigt, wenn ein autorisierter Nutzer Daten zum eigenen Kanal abruft.

15. September 2016

Dieses Update enthält die folgenden Änderungen:

• In der Versionsverlaufsaktualisierung vom 11. August 2016 wurden mehrere Änderungen im Zusammenhang mit Themen-IDs besprochen, darunter die Tatsache, dass sich die unterstützten Themen-IDs ab dem 10. Februar 2017 ändern. Die Liste der unterstützten Themen wird bis zum 10. November 2016 veröffentlicht.

• Die folgenden Änderungen sind jetzt in Kraft. Diese Änderungen wurden am 11. August 2016 im Revisionsverlauf angekündigt:

  • Wenn die Methode activities.list mit dem Parameter home auf true gesetzt aufgerufen wird, enthält die API-Antwort jetzt Elemente, die denen ähneln, die ein nicht angemeldeter YouTube-Nutzer auf der Startseite sieht.

    Diese geringfügige Änderung soll die Nutzerfreundlichkeit im Vergleich zum Verhalten, das im Update des Revisionsverlaufs vom 11. August 2016 beschrieben wird, verbessern. In diesem Update wurde angegeben, dass bei Anfragen mit dem Parameter home eine leere Liste zurückgegeben wird.

  • Die Attribute contentDetails.relatedPlaylists.watchHistory und contentDetails.relatedPlaylists.watchLater der Ressource channel enthalten jetzt für alle Channels die Werte HL bzw. WL.

    Diese Eigenschaften sind nur für einen autorisierten Nutzer sichtbar, der Daten zum eigenen Kanal abruft. Die Eigenschaften enthalten immer die Werte HL und WL, auch wenn ein autorisierter Nutzer Daten zum eigenen Kanal abruft. Die IDs des Wiedergabeverlaufs und der Playlist „Später ansehen“ können daher nicht über die API abgerufen werden.

    Außerdem geben Anfragen zum Abrufen von Playlistdetails (playlists.list) oder Playlistelementen (playlistItems.list) für den Wiedergabeverlauf oder die Playlist „Später ansehen“ eines Kanals jetzt leere Listen zurück. Dieses Verhalten gilt für die neuen Werte HL und WL sowie für alle IDs für Wiedergabeverlauf oder „Später ansehen“-Wiedergabelisten, die Ihr API-Client möglicherweise bereits gespeichert hat.

• Das fileDetails.recordingLocation-Objekt der video-Ressource und seine untergeordneten Attribute werden nicht mehr zurückgegeben. Bisher konnten diese Daten (z. B. 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“), die im YouTube Engineering and Developers Blog ausführlich beschrieben werden, enthalten eine Vielzahl von Aktualisierungen der aktuellen Nutzungsbedingungen. Zusätzlich zu den aktualisierten Nutzungsbedingungen, die am 10. Februar 2017 in Kraft treten, enthält dieses Update mehrere unterstützende Dokumente, in denen die Richtlinien erläutert werden, die Entwickler einhalten müssen.

  Die vollständige Liste der neuen Dokumente finden Sie im Versionsverlauf der aktualisierten Nutzungsbedingungen. Außerdem werden zukünftige Änderungen an den aktualisierten Nutzungsbedingungen oder den zugehörigen Dokumenten ebenfalls in diesem Revisionsverlauf erläutert. Über einen Link im Dokument können Sie einen RSS-Feed abonnieren, in dem Änderungen im Revisionsverlauf aufgeführt sind.

• 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 Themen angegeben, die mit dem Kanal verknüpft sind.
  • Im topicDetails-Teil der video-Ressource werden Themen angegeben, die mit dem Video verknüpft sind.
  • Mit dem Parameter topicId der Methode search.list können Sie nach Videos oder Kanälen zu einem bestimmten Thema suchen.

  Die Änderungen an diesen Funktionen sind:

  • Ab dem 10. Februar 2017 gibt YouTube nur noch eine kleine Gruppe von Themen-IDs zurück, anstatt der bisherigen, viel detaillierteren Gruppe von IDs. Mit dieser Gruppe unterstützter Themen werden übergeordnete Kategorisierungen wie Sport oder Basketball identifiziert, aber beispielsweise keine bestimmten Teams oder Spieler. Wir werden die unterstützten Themen rechtzeitig bekannt geben, damit Sie Ihre Anwendung auf diese Änderung vorbereiten können.

  • Alle Freebase-Themen-IDs, die Sie bereits abgerufen haben, können bis zum 10. Februar 2017 zum Suchen nach Inhalten verwendet werden. Danach können Sie jedoch nur noch die kleinere Gruppe von Themen verwenden, die im vorherigen Punkt genannt werden, um Suchergebnisse nach Thema abzurufen.

  • Wenn Sie nach dem 10. Februar 2017 versuchen, mit einer Themen-ID, die nicht in der kleineren Gruppe der unterstützten Themen-IDs enthalten ist, nach Ergebnissen zu suchen, gibt die API ein leeres Ergebnis-Set zurück.

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

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

  • Die Eigenschaften contentDetails.relatedPlaylists.watchHistory und contentDetails.relatedPlaylists.watchLater der Ressource channel sind nur für autorisierte Nutzer sichtbar, die Daten zum 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 Channels zurück.

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

  • Das fileDetails.recordingLocation-Objekt der video-Ressource oder eine seiner untergeordneten Eigenschaften wird 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 von einem Videoinhaber abgerufen werden kann.

13. Juni 2016

Dieses Update enthält die folgenden Änderungen:

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

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

Da nach der Einstellung keine dieser Eigenschaften zurückgegeben wird, wurden beide Eigenschaften aus der entsprechenden Ressourcendokumentation entfernt.

31. Mai 2016

Dieses Update enthält die folgenden Änderungen:

• Mit dem neuen Parameter myRecentSubscribers der Methode subscriptions.list wird eine Liste der Abonnenten des Kanals des authentifizierten Nutzers in umgekehrter chronologischer Reihenfolge des Zeitpunkts abgerufen, zu dem sie den Kanal abonniert haben.

  Mit dem neuen Parameter können nur die 1.000 neuesten Abonnenten des Kanals des authentifizierten Nutzers abgerufen werden. Verwenden Sie den Parameter mySubscribers, um eine vollständige Liste der Abonnenten abzurufen. Dieser Parameter gibt Abonnenten nicht in einer bestimmten Reihenfolge zurück und begrenzt nicht die Anzahl der Abonnenten, die abgerufen werden können.

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

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

• Die Definition des Parameters part der Methode channelSection.list wurde aktualisiert. Der targeting-Teil kann gegen 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 Rechteinhaber des Videos verfügbar.

17. Mai 2016

Das neue Tool Data API Code Snippets (Code-Snippets für die Data API) bietet kurze Code-Snippets für häufige Anwendungsfälle der YouTube Data API. Code-Snippets sind derzeit für alle schreibgeschützten API-Methoden in Apps Script, Go, JavaScript, PHP, Python und Ruby verfügbar.

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

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

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

Schließlich wird die API-Antwort auf jede Anfrage angezeigt. 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 verdeutlichen:

  • Mit der Property recordingDetails.location wird der Ort angegeben, den der Videoinhaber mit dem Video verknüpfen möchte. Dieser Ort kann bearbeitet werden, ist in öffentlichen Videos suchbar und wird Nutzern möglicherweise in öffentlichen Videos angezeigt.
  • Der Wert der fileDetails.recordingLocation-Eigenschaft ist unveränderlich und gibt den Standort an, der mit der ursprünglichen hochgeladenen Videodatei verknüpft ist. Der Wert ist nur für den Rechteinhaber des Videos sichtbar.

• Die Definition der contentDetails.relatedPlaylists.favorites-Property der channel-Ressource wurde aktualisiert. Der Property-Wert kann eine Playlist-ID enthalten, die auf eine leere Playlist verweist, die nicht abgerufen werden kann. Das liegt daran, dass die Funktion „Lieblingsvideos“ bereits eingestellt wurde. Diese Eigenschaft unterliegt nicht der API-Einstellungsrichtlinie.

• Die Definition des Fehlers ineligibleAccount, der von der Methode 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 wird, 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 localizations auch ein gültiger Wert für diesen Parameter ist.

• Der Abschnitt Kontingentnutzung in der Kurzanleitung wurde aktualisiert und enthält jetzt einen Link zur Google Developers Console, in der Sie Ihr tatsächliches Kontingent und die Kontingentnutzung einsehen können.

16. März 2016

Dieses Update enthält die folgenden Änderungen:

• Aktualisierungen vorhandener Ressourcen und Methoden

  • Die Ressourcendokumentation für channelBanner wurde aktualisiert. Das hochgeladene Kanalbannerbild sollte eine Größe von 2.560 × 1.440 Pixeln haben. Die Mindestgröße (2.048 × 1.152 Pixel) hat sich nicht geändert.

  • Die neue snippet.customUrl-Property der channel-Ressource gibt die benutzerdefinierte URL an, die dem Kanal zugeordnet ist. Nicht alle Kanäle haben benutzerdefinierte URLs. In der YouTube-Hilfe findest du Informationen zu den Teilnahmevoraussetzungen für eine benutzerdefinierte URL und dazu, 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. Mit der Property wird der Regionscode angegeben, der für die Suchanfrage verwendet wurde. Der Regionscode weist die API an, Suchergebnisse für das angegebene Land zurückzugeben.

    Der Eigenschaftswert 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 als den Standardwert aus, um die Anfrage zu bearbeiten.

  • Die Definitionen der Attribute snippet.label und snippet.secondaryReasons[].label der videoAbuseReportReason-Ressource wurden aktualisiert. Sie enthalten jetzt lokalisierten Labeltext für die Gründe für den Missbrauchsbericht.

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

  • Die neue contentDetails.contentRating.ecbmctRating-Eigenschaft der video-Ressource gibt die Altersfreigabe eines Videos durch das türkische Evaluation and Classification Board des Ministeriums für Kultur und Tourismus an.

    Außerdem unterstützen API-Attribute für andere Bewertungssysteme die folgenden neuen Attributwerte:

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

  • Die video-Ressource enthält in der Eigenschaft liveStreamingDetails.activeLiveChatId 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 Eigenschaft für das Video nicht mehr zurückgegeben.

  • Die status.rejectionReason-Property der video-Ressource 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 Kanalabschnitt nicht erstellt, aktualisiert oder gelöscht werden kann.
  badRequest (400)	styleRequired	Die Methoden channelSections.insert und channelSections.update geben diesen Fehler zurück, um anzugeben, dass für die in der API-Anfrage übermittelte 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 übermittelte channelSection-Ressource ein Wert für das Attribut 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 zwar ein vorübergehender Fehler sein, deutet aber in der Regel darauf hin, dass die Eingabe der Anfrage ungültig ist. Prüfen Sie die Struktur der commentThread-Ressource im Anfragebody, um sicherzustellen, dass sie gültig ist.
  forbidden (403)	commentsDisabled	Die Methode commentThreads.list gibt diesen Fehler zurück, um anzugeben, dass die Kommentare für das Video, das durch den Parameter videoId identifiziert wird, deaktiviert wurden.
  badRequest (400)	commentTextTooLong	Die Methode commentThreads.insert gibt diesen Fehler zurück, um anzugeben, dass die einzufügende comment-Ressource zu viele Zeichen in der Eigenschaft snippet.topLevelComment.snippet.textOriginal enthält.
  invalidValue (400)	videoAlreadyInAnotherSeriesPlaylist	Die Methode playlistItems.insert gibt diesen Fehler zurück, um anzugeben, dass das Video, das Sie der Playlist hinzufügen möchten, bereits in einer anderen Serien-Playlist enthalten ist. Weitere Informationen zu Serien-Playlists findest du in der YouTube-Hilfe.
  badRequest (400)	subscriptionForbidden	Die Methode subscriptions.insert gibt diesen Fehler zurück, um anzugeben, dass Sie die maximale Anzahl von Abos erreicht haben oder dass Sie in letzter Zeit zu viele Abos erstellt haben. In diesem Fall können Sie die Anfrage nach einigen Stunden noch einmal senden.
  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 das Attribut snippet.description in der hochgeladenen video-Ressource ein ungültiger Wert angegeben wurde.
  badRequest (400)	invalidPublishAt	Die Methode videos.update gibt diesen Fehler zurück, um anzugeben, dass für das Attribut 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 das recordingDetails-Objekt in der hochgeladenen video-Ressource ungültige Aufnahmedetails enthält.
  badRequest (400)	invalidTags	Die Methode videos.update gibt diesen Fehler zurück, um anzugeben, dass für das Attribut 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 das Attribut snippet.title 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 Metadaten der Anfrage 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

Laut EU-Gesetzen müssen bestimmte Informationen für Endnutzer in der EU offengelegt und ihre Einwilligung eingeholt werden. Daher müssen Sie für Endnutzer in der Europäischen Union die Richtlinie zur Einwilligung der Nutzer in der EU einhalten. Wir haben einen Hinweis auf diese Anforderung in unsere YouTube-API-Nutzungsbedingungen aufgenommen.

19. November 2015

Die API unterstützt jetzt das Festlegen und Abrufen von lokalisiertem 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.

• 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. Um lokalisierte Werte für eine Ressource festzulegen, müssen Sie Folgendes tun:

  • Achten Sie darauf, dass für die Property snippet.defaultLanguage der Ressource ein Wert festgelegt ist. Mit dieser Property wird die Sprache der Properties snippet.title und snippet.description der Ressource angegeben. Der Wert kann eine beliebige unterstützte Anwendungssprache oder die meisten anderen ISO 639-1:2002-Sprachcodes sein. Wenn Sie beispielsweise ein Video mit einem englischen Titel und einer englischen Beschreibung hochladen, legen Sie die Property snippet.defaultLanguage auf en fest.

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

  • Fügen Sie das localizations-Objekt der Ressource hinzu, die Sie aktualisieren. 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-Snippet wird die Standardsprache der Ressource auf Englisch festgelegt. Außerdem werden einem 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 Sie beispielsweise eine nachfolgende Anfrage zum Hinzufügen portugiesischer Daten zum Video im obigen Beispiel senden, muss die Anfrage die lokalisierten Daten für Deutsch, Spanisch und Portugiesisch enthalten.

• Lokalisierte Werte abrufen

  Die API unterstützt zwei Möglichkeiten, lokalisierte Werte für eine Ressource abzurufen:

  • Fügen Sie den Parameter hl in Ihre Anfrage channels.list, channelSections.list, playlists.list oder videos.list ein, um lokalisierte Daten für eine bestimmte von der YouTube-Website unterstützte Anwendungssprache abzurufen. Wenn lokalisierte Ressourcendetails in dieser Sprache verfügbar sind, enthält das snippet.localized-Objekt der Ressource die lokalisierten Werte. Wenn jedoch keine lokalisierten Details verfügbar sind, enthält das snippet.localized-Objekt Ressourcendetails in der Standardsprache der Ressource.

    Angenommen, bei 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 wäre, würde die Ressource die folgenden Daten enthalten:

    {
      "kind": "youtube#video",
      ...
      "snippet": {
        "title": "Playing soccer",
        "description": "We play soccer in the park on Sundays.",
        "defaultLanguage": "en",
        "localized": {
          "title": "Fußball spielen",
          "description": "Wir spielen Fußball im Park am Sonntag"
        }
        ...
      }
    }

    Wenn der Parameter hl jedoch auf fr festgelegt wäre, würde das snippet.localized-Objekt den englischen Titel und die englische Beschreibung enthalten, da Englisch die Standardsprache für die Ressource ist und lokalisierte französische Details nicht verfügbar sind.

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

  • Wenn Sie eine Ressource abrufen, fügen Sie localizations in den Parameterwert part ein, um alle lokalisierten Details für diese Ressource abzurufen. Wenn Sie lokalisierte Daten für eine Sprache abrufen, die keine aktuelle YouTube-App-Sprache ist, müssen Sie alle Lokalisierungen abrufen und dann filtern, um festzustellen, ob die gewünschten lokalisierten Daten vorhanden sind.

• Fehler im Zusammenhang mit lokalisierten Textwerten

  Die API unterstützt auch die folgenden neuen Fehler für lokalisierte Textwerte:

  Fehlertyp	Fehlerdetails	Beschreibung
  badRequest (400)	defaultLanguageNotSetError	Dieser Fehler gibt an, dass eine Anfrage zum Einfügen oder Aktualisieren des localizations-Objekts für eine Ressource fehlgeschlagen ist, 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 weist darauf hin, dass einer der Werte im localizations-Objekt einer Ressource nicht validiert werden konnte. Dieser Fehler kann beispielsweise auftreten, wenn das Objekt einen ungültigen Sprachcode enthält. Die 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 der Livestreams sortiert, solange die Livestreams noch laufen.

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

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

    Diese Änderung spiegelt keine Änderung des API-Verhaltens wider.

  • Die Definition des Attributs status.publishAt der Ressource video wurde aktualisiert und enthält jetzt folgenden Hinweis:

    • Wenn Sie den Wert dieses Attributs beim Aufrufen der Methode videos.update festlegen, müssen Sie auch den Attributwert status.privacyStatus auf private setzen, auch wenn das Video bereits privat ist.
    • Wenn durch die Anfrage ein Video für die Veröffentlichung zu einem Zeitpunkt in der Vergangenheit geplant wird, wird es sofort veröffentlicht. Daher hat es denselben Effekt, wenn Sie die Eigenschaft status.publishAt auf ein Datum und eine Uhrzeit in der Vergangenheit festlegen, als wenn Sie die privacyStatus des Videos von private in public ändern.

  • Die contentDetails.contentRating.cncRating-Property der video-Ressource gibt die Altersfreigabe des Videos von der Commission de classification cinematographique in Frankreich an. Dieses Attribut ersetzt das Attribut contentDetails.contentRating.fmocRating, das jetzt eingestellt wird.

  • Die Definition von brandingSettings.channel.keywords der channel-Ressource wurde aktualisiert, um korrekt widerzuspiegeln, dass der Property-Wert eine durch Leerzeichen getrennte Liste von Strings und nicht eine durch Kommas getrennte Liste enthält, wie zuvor dokumentiert. Diese Aktualisierung spiegelt keine Änderung des API-Verhaltens wider.

  • Die Dokumentation für die Methode thumbnails.set wurde aktualisiert, um korrekt wiederzugeben, dass der Text der Anfrage das Thumbnail-Bild enthält, das Sie hochladen und mit einem Video verknüpfen. Der Anfragetext enthält keine thumbnail-Ressource. Bisher hieß es in der Dokumentation, dass Sie beim Aufrufen dieser Methode keinen Anfragetext angeben sollten. Diese Aktualisierung spiegelt keine Änderung des API-Verhaltens wider.

  • Die Beschreibung der activity-Ressource wurde aktualisiert, um zu berücksichtigen, dass die activities.list-Methode derzeit keine Ressourcen für neue Videokommentare enthält. Die snippet.type und contentDetails.comment der Ressource wurden ebenfalls aktualisiert.

• Neue und aktualisierte Fehler

  • Die API unterstützt jetzt die folgenden Fehler:

    Fehlerdetails
    activities.insert	HTTP-Antwortcode badRequest (400) Grund invalidMetadata Beschreibung Die kind-Property stimmt nicht mit dem Typ der angegebenen ID ü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 zu viele Zeichen im Attribut snippet.topLevelComment.snippet.textOriginal.
    playlistItems.insert playlistItems.update	HTTP-Antwortcode forbidden (403) Grund playlistItemsNotAccessible Beschreibung Die Anfrage ist nicht richtig autorisiert, um 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 richtig autorisiert.
    search.list	HTTP-Antwortcode badRequest (400) Grund invalidLocation Beschreibung Der Wert des Parameters location und/oder locationRadius wurde falsch formatiert.
    search.list	HTTP-Antwortcode badRequest (400) Grund invalidRelevanceLanguage Beschreibung Der Wert des Parameters relevanceLanguage wurde falsch formatiert.
    subscriptions.insert	HTTP-Antwortcode badRequest (400) Grund subscriptionForbidden Beschreibung Dieser Fehler tritt auf, wenn eine der folgenden Bedingungen erfüllt ist: Das Abo, das du erstellen möchtest, ist bereits vorhanden Sie haben bereits die maximale Anzahl an Abos erreicht Du versuchst, deinen eigenen Kanal zu abonnieren. Das ist nicht möglich. Sie haben in letzter Zeit zu viele Abos abgeschlossen. Warten Sie einige Stunden, bevor Sie die Anfrage noch einmal senden.
    videos.update	HTTP-Antwortcode badRequest (400) Grund invalidDefaultBroadcastPrivacySetting Beschreibung Mit 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 statistics.favoriteCount-Property der video-Ressource wurde eingestellt.

    Gemäß unserer Einstellungsrichtlinie wird diese Property noch mindestens ein Jahr nach dieser Ankündigung in video-Ressourcen enthalten sein. Der Attributwert wird jetzt aber immer auf 0 gesetzt.

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, um weitere Informationen dazu zu liefern, wie der API-Server die Länge des Attributwerts berechnet. Diese Aktualisierung hat keine Auswirkungen auf das Verhalten der API.

    Konkret wird jetzt erklärt, dass der API-Server den Tag-Wert so behandelt, als wäre er in Anführungszeichen eingeschlossen, wenn ein Tag ein Leerzeichen enthält. Die Anführungszeichen werden auf das Zeichenlimit angerechnet. Für die Zeichenbeschränkung enthält das Tag „Foo-Baz“ also sieben Zeichen, das Tag „Foo Baz“ jedoch neun Zeichen.

  • Die Methode commentThreads.insert unterstützt den Parameter shareOnGooglePlus nicht mehr. Dieser Parameter hat zuvor angegeben, ob ein Kommentar und Antworten auf diesen Kommentar auch im Google+‑Profil des Autors gepostet werden sollen. Wenn der Parameter in einer Anfrage übergeben 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

  • Mit dem neuen order-Parameter der commentThreads.list-Methode wird die Reihenfolge angegeben, in der die Kommentar-Threads in der API-Antwort aufgeführt werden sollen. Threads können nach Zeit oder Relevanz sortiert werden. Standardmäßig werden sie nach Zeit sortiert.

  • Mit dem neuen Attribut snippet.defaultAudioLanguage der Ressource video wird die Sprache angegeben, die im Standard-Audio-Track des Videos gesprochen wird.

  • Die Definition des Attributs contentDetails.licensedContent der video-Ressource wurde aktualisiert, um klarzustellen, dass die Inhalte ursprünglich auf einen Kanal hochgeladen werden müssen, der mit einem YouTube-Content-Partner verknüpft ist, und dann von diesem Partner beansprucht werden müssen. 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 auch mit einem Token autorisiert werden, das Zugriff auf den Bereich https://www.googleapis.com/auth/youtubepartner bietet.

• Neue und aktualisierte Fehler

  • Die API unterstützt jetzt die folgenden Fehler:

    Fehlerdetails
    videos.rate	HTTP-Antwortcode badRequest (400) Grund emailNotVerified Beschreibung Die Nutzerin muss ihre E‑Mail-Adresse bestätigen, bevor sie das Video bewerten kann.
    videos.rate	HTTP-Antwortcode badRequest (400) Grund videoPurchaseRequired Beschreibung Leihvideos können nur von Nutzern bewertet werden, die sie ausgeliehen haben.

  • Die Methoden subscriptions.delete und subscriptions.insert unterstützen die Fehler accountClosed und accountSuspended nicht mehr.

27. April 2015

Dieses Update enthält die folgenden Änderungen:

• Neue Ressourcen und Methoden

  • Die neue videoAbuseReportReason-Ressource enthält Informationen zu einem Grund, aus dem ein Video als missbräuchliche Inhalte gekennzeichnet wird. Mit der Methode videoAbuseReportReasons.list können Sie eine Liste aller Gründe abrufen, aus denen Videos möglicherweise gekennzeichnet werden.

  • Mit der neuen Methode videos.reportAbuse können Sie Videos mit missbräuchlichen Inhalten melden. Der Text der Anfrage enthält ein JSON-Objekt, in dem das Video angegeben wird, das gemeldet wird, sowie der Grund dafür, dass das Video als missbräuchlich eingestuft wird. Gültige Gründe können mit der oben beschriebenen Methode videoAbuseReportReason.list abgerufen werden.

    Der Migrationsleitfaden wurde ebenfalls aktualisiert und enthält jetzt ein Beispiel für das Melden eines missbräuchlichen Videos. Mit dieser Änderung unterstützt die v3-API jetzt alle Funktionen der v2-API, die sie unterstützen soll. Diese Funktionen werden auch alle im Migrationsleitfaden erläutert.

• Aktualisierungen vorhandener Ressourcen und Methoden

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

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

    Wenn in einer Suchanfrage der Parameter forDeveloper auf true gesetzt wird, verwendet der API-Server die Autorisierungsanmeldedaten der Anfrage, um den Entwickler zu identifizieren. Ein Entwickler kann die Ergebnisse daher auf Videos beschränken, die über die eigene App oder Website des Entwicklers hochgeladen wurden, nicht aber auf Videos, die über andere Apps oder Websites hochgeladen wurden.

    Die neue Funktion bietet eine ähnliche, aber nicht identische Funktionalität wie die Entwicklertags, die von der v2 API unterstützt wurden.

  • Mit der neuen snippet.country-Property der channel-Ressource können Kanalinhaber ihre Kanäle einem bestimmten Land zuordnen.

    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 für channelSection-Ressourcen. Mit der Ausrichtung von Kanalabschnitten können Sie die Sichtbarkeit eines Inhaltsabschnitts auf Nutzer beschränken, die bestimmte Kriterien erfüllen.

    Die API bietet drei Targeting-Optionen. Ein Nutzer muss alle Targeting-Einstellungen für einen Kanalabschnitt erfüllen, damit dieser sichtbar ist.

    • targeting.languages[]: Eine Liste der Sprachen der YouTube-Anwendung. Nutzer, die eine dieser Sprachen ausgewählt haben, können den entsprechenden Kanalabschnitt sehen.

    • targeting.regions[]: Eine Liste mit YouTube-Regionen mit bevorzugten Inhalten. Der Kanalabschnitt ist für Nutzer sichtbar, die eine dieser Regionen ausgewählt haben, sowie für Nutzer, für die eine dieser Regionen automatisch ausgewählt wurde.

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

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

  • Die Dokumentation für die Methoden channelSections.delete, playlistItems.delete, playlists.delete, subscriptions.delete und videos.delete wurde korrigiert. Bei erfolgreicher Ausführung geben diese Methoden alle den HTTP-Antwortcode 204 (No Content) zurück.

• 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 der obersten Ebene einfügen kann, der durch das Attribut snippet.parentId angegeben wird. In einer commentThread-Ressource gibt die Eigenschaft 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 der Anfrage eine ungültige Channel-ID angegeben wurde.
    badRequest (400)	subscriptionForbidden	Die Methode subscriptions.insert gibt diesen Fehler zurück, wenn der API-Nutzer versucht, den 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:

• Die Anleitung zur Migration wurde aktualisiert und enthält jetzt Informationen zur Migration von Anwendungen, die noch die Kommentarfunktion der v2 API verwenden.

  Im Leitfaden werden auch mehrere Kommentarfunktionen beschrieben, 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
  • Alle Kommentar-Threads abrufen, die sich auf einen Kanal beziehen. Die API-Antwort kann also Kommentare zum Kanal oder zu einem seiner Videos enthalten.
  • Text eines Kommentars aktualisieren
  • Kommentare als Spam markieren
  • Moderationsstatus eines Kommentars festlegen

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

9. April 2015

Dieses Update enthält die folgenden Änderungen:

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

  • Eine commentThread-Ressource enthält Informationen zu einem YouTube-Kommentarbereich, der aus einem Kommentar der obersten Ebene und ggf. Antworten auf diesen Kommentar besteht. Eine commentThread-Ressource kann Kommentare zu einem Video oder einem Kanal darstellen.

    Der Kommentar der obersten Ebene und die Antworten sind comment-Ressourcen, die in der commentThread-Ressource verschachtelt sind. Die commentThread-Ressource enthält nicht unbedingt alle Antworten auf einen Kommentar. Wenn Sie alle Antworten auf einen bestimmten Kommentar abrufen möchten, müssen Sie die Methode comments.list verwenden. Außerdem gibt es für einige Kommentare keine Antworten.

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

    • commentThreads.list – Ruft eine Liste mit Kommentarthreads ab. Mit dieser Methode können Sie Kommentare abrufen, die einem bestimmten Video oder Kanal zugeordnet sind.
    • commentThreads.insert: Erstellt einen neuen Kommentar der obersten Ebene. Verwenden Sie die Methode comments.insert, um auf einen vorhandenen Kommentar zu antworten.
    • commentThreads.update – Einen Kommentar auf oberster Ebene ändern.

  • Eine comment-Ressource enthält Informationen zu einem einzelnen YouTube-Kommentar. Eine comment-Ressource kann einen Kommentar zu einem Video oder einem Kanal darstellen. Außerdem kann es sich um einen Kommentar auf oberster Ebene oder eine Antwort auf einen Kommentar auf oberster Ebene handeln.

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

    • comments.list – Eine Liste mit Kommentaren abrufen. Mit dieser Methode können Sie alle Antworten auf einen bestimmten Kommentar abrufen.
    • comments.insert: Eine Antwort auf einen vorhandenen Kommentar erstellen.
    • comments.update: Kommentar bearbeiten.
    • comments.markAsSpam – Einen oder mehrere Kommentare als Spam markieren.
    • comments.setModerationStatus: Legen Sie den Moderationsstatus für einen oder mehrere Kommentare fest. Sie können beispielsweise einen Kommentar für die öffentliche Anzeige freigeben oder ihn als nicht geeignet ablehnen. Die API-Anfrage muss vom Inhaber des Kanals oder Videos autorisiert werden, mit dem die Kommentare verknüpft sind.
    • comments.delete – Einen Kommentar löschen.

  Der neue https://www.googleapis.com/auth/youtube.force-ssl-Bereich der API, der im Versionsverlauf vom 2. April 2015 beschrieben wird, 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 erläutert. Dabei handelt es sich um ein Server-zu-Server-Protokoll für die Veröffentlichung und das Abonnieren von Webressourcen. Ihr PubSubHubBub-Callback-Server kann Atom-Feed-Benachrichtigungen empfangen, wenn auf einem Kanal eine der folgenden Aktivitäten stattfindet:

  • ein Video hochlädt
  • Aktualisiert den Titel eines Videos
  • Aktualisiert die Beschreibung eines Videos

• Der Migrationsleitfaden wurde ebenfalls aktualisiert und enthält jetzt Informationen zur neuen Unterstützung von Push-Benachrichtigungen. Da die v2-API jedoch zahlreiche andere Arten von Push-Benachrichtigungen unterstützt hat, die in der v3-API nicht unterstützt werden, wird die Erwähnung der PubSubHubBub-Unterstützung weiterhin im Abschnitt Eingestellt dieses Leitfadens aufgeführt.

• Der neue https://www.googleapis.com/auth/youtube.force-ssl-Bereich der API ist jetzt ein gültiger Bereich für jede API-Methode, die zuvor den https://www.googleapis.com/auth/youtube-Bereich unterstützt hat.

• Die API unterstützt jetzt die folgenden Fehler:

  Fehlertyp	Fehlerdetails	Beschreibung
  badRequest (400)	invalidRating	Die Methode videos.rate gibt diesen Fehler zurück, wenn die Anfrage einen unerwarteten Wert für den Parameter rating enthält.

• Die Methode subscriptions.insert unterstützt den Fehler subscriptionLimitExceeded nicht mehr. Dieser Fehler hat zuvor angegeben, dass der mit der Anfrage identifizierte Abonnent das Ratenlimit für Abonnements ü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 Untertitel-Tracks.

• Die Migrationsanleitung wurde ebenfalls aktualisiert und enthält jetzt Informationen zur Migration von Anwendungen, die noch die Untertitelfunktion in der v2 API verwenden.

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

  Dieser neue Bereich gewährt denselben Zugriff wie der Bereich https://www.googleapis.com/auth/youtube. Tatsächlich sind diese beiden Bereiche funktional identisch, da der YouTube API-Server nur über einen HTTPS-Endpunkt verfügbar ist. Auch wenn 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 Bereich ist für Aufrufe aller Methoden der Ressource caption erforderlich.

11. März 2015

Dieses Update enthält die folgenden Änderungen:

• Die Migrationsanleitung für die YouTube Data API (v3) enthält einen neuen Tab mit dem Namen Neues in der v3 API. Dort sind Funktionen aufgeführt, die von der v3 API unterstützt werden, von der v2 API jedoch nicht. Die gleichen Funktionen wurden zuvor und werden weiterhin auf anderen Tabs im Leitfaden aufgeführt. Die neue Funktion, mit der Sie die Daten von Werbekampagnen in Videos eines Kanals aktualisieren können, ist beispielsweise auch auf dem Tab Channels (profiles) (Kanäle (Profile)) aufgeführt.

• Der Migrationsleitfaden für die YouTube Data API (v3) wurde aktualisiert. Die v3 API unterstützt jetzt auch die folgende Funktion der v2 API:

  • Video melden

• Der Migrationsleitfaden für die YouTube Data API (v3) wurde aktualisiert. Die folgenden v2-API-Funktionen werden in der v3-API nicht unterstützt:

  • Videoempfehlungen abrufen: Mit der v3-API wird keine Liste abgerufen, die nur Videos enthält, die für den aktuellen API-Nutzer empfohlen werden. Du kannst jedoch die V3-API verwenden, um empfohlene Videos zu finden. Rufe dazu die Methode activities.list auf und setze den Parameterwert home auf true.

    In der API-Antwort entspricht eine Ressource einem empfohlenen Video, wenn der Wert der 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 empfohlener Videos enthält.

  • Kanaleinstellungen abrufen

  • Neue Abo-Videos abrufen: Mit der v3-API wird keine Liste abgerufen, die nur Videos enthält, die vor Kurzem auf Kanälen hochgeladen wurden, die der API-Nutzer abonniert hat. Du kannst aber die v3 API verwenden, um neue Abo-Videos zu finden. Rufe dazu die Methode activities.list auf und lege den Parameterwert home auf true fest.

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

  • Unterstützung von RSS‑Feeds

  • Push-Benachrichtigungen für Feed-Updates: Die v2-API unterstützte Push-Benachrichtigungen, die entweder das Simple Update Protocol (SUP) oder PubSubHubbub verwendeten, um die Aktivitätsfeeds von YouTube-Nutzern zu überwachen. Benachrichtigungen wurden für neue Kanalabos und für Videos gesendet, die bewertet, geteilt, als Favoriten markiert, kommentiert oder hochgeladen wurden.

    Die v3-API unterstützt Push-Benachrichtigungen über das PubSubHubbub-Protokoll. Die Benachrichtigungen beziehen sich jedoch nur auf Video-Uploads und Aktualisierungen von Videotiteln oder ‑beschreibungen.

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

  • Entwicklertags festlegen oder abrufen: Mit der v2 API konnten bei einem Video zum Zeitpunkt des Uploads Keywords oder Entwicklertags verknüpft werden. Entwickler-Tags wurden YouTube-Nutzern nicht angezeigt, aber Videoinhaber konnten Videos abrufen, die einem bestimmten Entwickler-Tag entsprachen.

    Die v3-API bietet eine ähnliche, aber nicht identische Funktion. Konkret kann ein Entwickler nach Videos suchen, die von seiner eigenen Anwendung hochgeladen wurden. Bei dieser Funktion wird jedes hochgeladene Video automatisch mit der Projektnummer getaggt, die mit der Anwendung des Entwicklers in der Google Developers Console verknüpft ist. Der Entwickler verwendet dann dieselbe Projektnummer, um nach Videos zu suchen.

  • Videos nach Veröffentlichungsdatum, Aufrufzahl oder Bewertung auflisten: In der v2 API können Sie mit dem Parameter orderby Videos in einer Playlist nach Position, Dauer, Veröffentlichungsdatum, Titel und mehreren anderen Werten sortieren. In der v3 API werden Playlistenelemente in der Regel aufsteigend nach Position sortiert. Andere Sortieroptionen sind nicht verfügbar.

    Es gibt jedoch einige Ausnahmen. Ein neuer Upload, ein als Favorit markiertes Video, ein geliktes Video oder ein kürzlich angesehenes Video wird automatisch als erstes Element (snippet.position=0) für die folgenden Arten von Playlists hinzugefügt. Jede dieser Listen ist also nach dem Zeitpunkt sortiert, zu dem die Elemente der Liste hinzugefügt wurden, und zwar vom neuesten zum ältesten Element.

    • Uploads durch Nutzer
    • gespeicherte Videos
    • positiv bewertete Videos
    • Wiedergabeverlauf

    Ein neues Element, das der Playlist „Später ansehen“ hinzugefügt wird, wird jedoch als letztes Element in dieser Liste eingefügt. Die Liste ist also effektiv vom ältesten zum neuesten Element sortiert.

  • Batchverarbeitung: Die v3 API unterstützt einen der Anwendungsfälle für die Batchverarbeitung, die von der v2 API unterstützt wurden. 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 durch Kommas getrennte Liste von IDs (Video-IDs, Kanal-IDs usw.) angegeben werden kann. Mit diesen Methoden können Sie mit einer einzigen Anfrage eine Liste mit mehreren Ressourcen abrufen.

  Durch diese Änderungen werden in der Anleitung nun alle Funktionen aufgeführt, die in der alten API (v2) unterstützt wurden und in der aktuellen API-Version (v3) eingestellt werden.

4. März 2015

Dieses Update enthält die folgenden Änderungen:

• Die Methoden channelSections.delete und channelSections.update unterstützen jetzt den Parameter onBehalfOfContentOwner, der bereits für mehrere andere Methoden unterstützt wird.

• Die folgenden Eigenschaften und ihre untergeordneten Eigenschaften wurden eingestellt:

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

  Hinweis:Keine dieser Eigenschaften unterlag der API Deprecation Policy.

• Die neue contentDetails.contentRating.contentDetails.contentRating.djctqRatingReasons-Property der video-Ressource gibt die Gründe an, warum das Video die DJCQT-Altersfreigabe (Brasilien) erhalten hat.

• Die API unterstützt jetzt die folgenden Fehler:

  Fehlertyp	Fehlerdetails	Beschreibung
  notFound (404)	channelNotFound	Die Methode channels.update gibt diesen Fehler zurück, wenn im Parameter id 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 mit der Anfrage versucht wird, die Position des Playlistenelements festzulegen, die Playlist jedoch 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 Ressource entfernen, die im Anfragebody gesendet wird. Wenn das Playlist-Element eine bestimmte Position in der Liste haben soll, müssen Sie zuerst die Sortierungseinstellung 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 Parameter channelId der Anfrage ein geschlossener Kanal angegeben ist.
  forbidden (403)	channelSuspended	Die Methode playlists.list gibt diesen Fehler zurück, wenn im Parameter channelId 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 richtig autorisiert ist.
  notFound (404)	channelNotFound	Die Methode playlists.list gibt diesen Fehler zurück, wenn im Parameter channelId der Anfrage ein Kanal angegeben ist, der nicht gefunden werden kann.
  notFound (404)	playlistNotFound	Die Methode playlists.list gibt diesen Fehler zurück, wenn im Parameter id der Anfrage eine Playlist angegeben ist, die nicht gefunden werden kann.
  notFound (404)	videoNotFound	Die Methode videos.list gibt diesen Fehler zurück, wenn im Parameter id 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.

  Auch die Migrationsanleitung für die YouTube Data API (v3) wurde aktualisiert und enthält jetzt eine Beschreibung der 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 verworfen wurde.

• Der Migrationsleitfaden für die YouTube Data API (v3) wurde ebenfalls aktualisiert. Er enthält jetzt Informationen zur Einstellung der speziellen Feeds und Metadatenfelder, die in der v2-API zur Beschreibung von Filmen, Trailern, Serien, Staffeln und Folgen verfügbar waren.

14. Januar 2015

Dieses Update enthält die folgenden Änderungen:

• Der Migrationsleitfaden für die YouTube Data API (v3) wurde aktualisiert. Er enthält jetzt eine Anleitung dazu, wie du mit der v3-API Videos mit JavaScript hochladen kannst. Weitere Informationen finden Sie im Abschnitt Video hochladen. Diese Funktion ist vergleichbar mit der browserbasierten Uploadfunktion, die von der v2 API unterstützt wird. Diese Änderung des Migrationsleitfadens spiegelt keine tatsächliche API-Änderung wider, sondern die Verfügbarkeit von neuem Beispielcode 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 V3-API möglicherweise eingestellt wird.

• Die Dokumentation für die Methode videos.insert wurde aktualisiert und enthält das oben beschriebene neue JavaScript-Codebeispiel. Die Liste der JavaScript-Codebeispiele für die YouTube Data API (v3) wurde ebenfalls aktualisiert.

11. November 2014

Dieses Update enthält die folgenden Änderungen:

• Die Kontingentkosten für einen Aufruf der Methode search.list wurden auf 100 Einheiten geändert.

  Wichtig:In vielen Fällen können Sie andere API-Methoden verwenden, um Informationen zu geringeren Kontingentkosten abzurufen. Hier sind zwei Beispiele dafür, wie du Videos findest, 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

    Rufen Sie die Methode channels.list auf, um die richtige Kanal-ID zu finden. Setzen Sie den Parameter forUsername auf GoogleDevelopers und den Parameter part auf contentDetails. 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 Attribute:

  • Die status.longUploadsStatus-Eigenschaft gibt an, ob auf dem Kanal Videos hochgeladen werden können, die länger als 15 Minuten sind. Diese Property wird nur zurückgegeben, wenn der Kanalinhaber die API-Anfrage autorisiert hat. Gültige Attributwerte:

    • allowed – Auf dem Kanal können Videos mit einer Länge von mehr als 15 Minuten hochgeladen werden.
    • eligible: Auf dem Kanal können Videos mit einer Länge von mehr als 15 Minuten hochgeladen werden. Die Funktion muss jedoch erst aktiviert werden.
    • disallowed: Auf dem Kanal können keine Videos mit einer Länge von mehr als 15 Minuten hochgeladen werden.

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

  • Die Eigenschaft invideoPromotion.useSmartTiming gibt an, ob für die Werbekampagne des Channels „Smart Timing“ verwendet wird. Mit dieser Funktion werden Werbeaktionen an einer Stelle im Video präsentiert, an der sie mit größerer Wahrscheinlichkeit angeklickt werden und die Wiedergabe weniger stören. Außerdem wird für jedes Video nur eine Promotion ausgewählt.

• Die Definitionen der Attribute snippet.title und snippet.categoryId der Ressource video 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 Attribute festlegen.

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

• Die contentDetails.contentRating.oflcRating-Property der video-Ressource, mit der die Altersfreigabe eines Videos durch das neuseeländische Office of Film and Literature Classification angegeben wird, 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 „YouTube-Kanal-Art“ des Kanalinhabers enthält zu viele Bilder. Der Kanalinhaber sollte http://photos.google.com aufrufen, zur Seite „Alben“ gehen und einige Bilder aus dem Album entfernen.

12. September 2014

Dieses Update enthält die folgenden Änderungen:

• Die Kontingentkosten für einen Aufruf der Methode search.list haben sich von 1 Einheit auf 2 Einheiten zuzüglich der Kosten der angegebenen Ressourcenteile geändert.

13. August 2014

Dieses Update enthält die folgenden Änderungen:

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

  Fehlertyp	Fehlerdetails	Beschreibung
  badRequest	subscriptionLimitExceeded	Der mit der Anfrage identifizierte Abonnent hat das Abo-Ratenlimit überschritten. In einigen Stunden können weitere Abos abgeschlossen werden.

12. August 2014

Dieses Update enthält die folgenden Änderungen:

• Im neuen Leitfaden Anwendung zur YouTube Data API (v3) migrieren wird beschrieben, wie Sie die YouTube Data API (v3) verwenden, um Funktionen auszuführen, die in der YouTube Data API (v2) verfügbar sind. Die ältere API wurde am 4. März 2014 offiziell eingestellt. Diese Anleitung soll Ihnen helfen, Anwendungen, die noch die v2-API verwenden, zur neuesten API-Version zu migrieren.

8. Juli 2014

Dieses Update enthält die folgenden Änderungen:

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

  Fehlertyp	Fehlerdetails	Beschreibung
  badRequest	maxPlaylistExceeded	Dieser Fehler tritt auf, wenn eine Playlist nicht erstellt werden kann, weil der Kanal bereits die maximal zulässige Anzahl an Playlists enthält.

18. Juni 2014

Dieses Update enthält die folgenden Änderungen:

• Die Beschreibung jeder API-Methode wurde aktualisiert und enthält nun die Kontingentkosten, die durch einen Aufruf dieser Methode entstehen. Außerdem wurden die Definitionen von part-Parametern 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 einen Kontingentaufwand von etwa 50 Einheiten. Die Ressource subscription enthält ebenfalls drei Teile (snippet, contentDetails und subscriberSnippet), die jeweils zwei Einheiten kosten.

  Die Kosten für Kontingente können sich ohne Vorwarnung ändern.

• Die video-Ressource unterstützt jetzt 43 neue Inhaltseinstufungssysteme, die die Einstufungen angeben, die Videos von verschiedenen nationalen Einstufungsagenturen erhalten haben. Die neu unterstützten Altersfreigabesysteme stammen aus Argentinien, Österreich, Belgien, Bulgarien, Chile (Fernsehen), Chile (Filme), 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 Sie nach Videos suchen können, die mit einem geografischen Standort verknüpft sind. In einer Anfrage muss für beide Parameter ein Wert angegeben werden, damit Ergebnisse basierend auf dem Standort abgerufen werden. Die API gibt einen Fehler zurück, wenn eine Anfrage nur einen der beiden Parameter enthält.

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

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

13. Mai 2014

Dieses Update enthält die folgenden Änderungen:

• Die invideoPromotion.items[]-Property der channel-Ressource wurde aktualisiert. Dort wird jetzt darauf hingewiesen, dass du in der Regel nur ein beworbenes Element für deinen Kanal festlegen kannst. Wenn Sie versuchen, zu viele beworbene Artikel einzufügen, gibt die API einen tooManyPromotedItems-Fehler mit dem HTTP-Statuscode 400 zurück.

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

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

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

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

• Die Definition des Parameters q für die Methode search.list wurde aktualisiert. Es wird nun darauf hingewiesen, dass für den Suchbegriff der boolesche Operator NOT (-) 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 von 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 Schätzung ist und möglicherweise keinen genauen Wert darstellt. Außerdem beträgt der Höchstwert 1.000.000. Sie sollten diesen Wert nicht verwenden, um Paginierungslinks zu erstellen. Verwenden Sie stattdessen die Eigenschaftswerte nextPageToken und prevPageToken, um zu bestimmen, ob Paginierungslinks angezeigt werden sollen.

• Die Methoden watermarks.set und watermarks.unset wurden aktualisiert, um zu berücksichtigen, dass die API für erfolgreiche 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 Sprache der Anwendung kann auch als Sprache der Benutzeroberfläche bezeichnet werden. Auf der YouTube-Website kann eine Anwendungssprache automatisch anhand der Google-Kontoeinstellungen, der Browsersprache oder des IP-Standorts ausgewählt werden. Nutzer können die gewünschte Sprache der Benutzeroberfläche auch manuell in der YouTube-Website-Fußzeile auswählen.

  Die API unterstützt eine Methode zum Auflisten der unterstützten Anwendungssprachen. Unterstützte Sprachen können als Wert des Parameters hl beim Aufrufen von API-Methoden wie videoCategories.list und guideCategories.list verwendet 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 Inhaltssprache bezeichnet werden. Auf der YouTube-Website kann eine Inhaltsregion automatisch anhand von Heuristiken wie der YouTube-Domain oder dem IP-Standort des Nutzers ausgewählt werden. Nutzer können die gewünschte Inhaltsregion aber auch manuell in der YouTube-Website-Fußzeile auswählen.

  Die API unterstützt eine Methode zum Auflisten der unterstützten Inhaltsregionen. Unterstützte Ländercodes können als Wert des Parameters regionCode beim Aufrufen von API-Methoden wie search.list, videos.list, activities.list und videoCategories.list verwendet 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 Empfehlungen ausgewählt hat. Ein Bereich kann 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 Kanalabschnitten. Sie können eine Liste der Kanalabschnitte für den Kanal des authentifizierten Nutzers abrufen, indem Sie eine bestimmte Kanal-ID oder eine Liste eindeutiger Kanalabschnitts-IDs angeben.

  Die Fehlerdokumentation wurde ebenfalls aktualisiert und enthält jetzt eine Beschreibung der Fehlermeldungen, die von der API speziell für diese neuen Methoden unterstützt werden.

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

  Außerdem 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 zu berücksichtigen, 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 widerzuspiegeln, dass diese Methode den Parameter onBehalfOfContentOwner nicht unterstützt. Das 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 status.publishAt-Eigenschaft der video-Ressource können Sie das Datum und die Uhrzeit angeben, zu der ein privates Video veröffentlicht werden soll. Diese Eigenschaft kann nur festgelegt werden, wenn der Datenschutzstatus des Videos private ist und das Video noch nie veröffentlicht wurde. Für diese neue Property gilt die Einstellung von Produkten nicht.

13. März 2014

Dieses Update enthält die folgenden Änderungen:

• Die API unterstützt jetzt den contentOwnerDetails-Teil für channel-Ressourcen. Der neue Teil enthält Kanaldaten, die für mit dem Kanal verknüpfte YouTube-Partner relevant sind, einschließlich der ID des mit dem Kanal verknüpften Rechteinhabers sowie des Datums und der Uhrzeit, zu der der Rechteinhaber und der Kanal verknüpft wurden. Dieser neue Teil unterliegt nicht der Richtlinie zur Einstellung.

• In der Dokumentation ist jetzt die maximal unterstützte Zeichenlänge für die folgenden Eigenschaften 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 Attributwert ist eine Liste und Kommas zwischen Elementen in der Liste werden auf das Limit angerechnet.

• Die brandingSettings.watch.featuredPlaylistId-Property der channel-Ressource wurde eingestellt. Die API gibt einen Fehler zurück, wenn Sie versuchen, den Wert festzulegen.

• Die folgenden video-Ressourceneigenschaften wurden der Liste der Werte hinzugefügt, die beim Einfügen oder Aktualisieren eines Videos festgelegt werden können:

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

• In der Fehlerdokumentation wird jetzt der HTTP-Antwortcode für jeden Fehlertyp angegeben.

• Die API unterstützt jetzt die folgenden Fehler:

  Fehlertyp	Fehlerdetails	Beschreibung
  badRequest (400)	invalidCriteria	Die 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 Sie versuchen, den brandingSettings-Teil eines Kanals zu aktualisieren und den Wert der brandingSettings.channel.title-Property zu ändern. Hinweis: Die API gibt den Fehler nicht zurück, wenn Sie das Attribut weglassen.
  badRequest (400)	invalidRecentlyUploadedBy	Die channels.update-Methode gibt diesen Fehler zurück, wenn im Attribut invideoPromotion.items[].id.recentlyUploadedBy eine ungültige Channel-ID angegeben ist.
  badRequest (400)	invalidTimingOffset	Die channels.update-Methode gibt diesen Fehler zurück, wenn im invideoPromotion-Teil ein ungültiger Timing-Offset angegeben ist.
  badRequest (400)	tooManyPromotedItems	Die Methode channels.update gibt diesen Fehler zurück, wenn im Teil invideoPromotion mehr beworbene Artikel als zulässig angegeben sind.
  forbidden (403)	promotedVideoNotAllowed	Die channels.update-Methode gibt diesen Fehler zurück, wenn für das Attribut 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 das Attribut invideoPromotion.items[].id.websiteUrl eine URL angegeben wird, die nicht zulässig ist.
  required (400)	requiredTimingType	Die Methode channels.update gibt diesen Fehler zurück, wenn in einer Anfrage keine Standardeinstellungen für die Zeitangabe angegeben sind, wann YouTube ein beworbenes Element präsentieren soll.
  required (400)	requiredTiming	Für jedes beworbene Element muss in der channels.update-Methode ein invideoPromotion.items[].timing-Objekt angegeben werden.
  required (400)	requiredWebsiteUrl	Für jedes beworbene Element muss in der channels.update-Methode eine invideoPromotion.items[].id.websiteUrl-Property angegeben werden.
  badRequest (400)	invalidPublishAt	Die Methode videos.insert 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 v3 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 der Richtlinie zur Einstellung von APIs unterliegen, sind einige v3-API-Funktionen ausdrücklich von der Richtlinie ausgeschlossen.

5. Dezember 2013

Dieses Update enthält die folgenden Änderungen:

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

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

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

• Die Mindestgröße für hochgeladene Kanalbannerbilder wurde auf 2.048 × 1.152 Pixel reduziert. (Bisher betrug die Mindestgröße 2.120 × 1.192 Pixel.) Außerdem wird in der Dokumentation zur channel-Ressource die maximale Größe aller Bannerbilder angegeben, die über die API ausgeliefert werden. Die maximale Größe des brandingSettings.image.bannerTvImageUrl-Bilds für TV-Apps beträgt beispielsweise 2.120 × 1.192 Pixel, das tatsächliche Bild kann aber auch 2.048 × 1.152 Pixel groß sein. In der YouTube-Hilfe findest du weitere Informationen zur Optimierung von Kanalbildern für die Anzeige auf verschiedenen Gerätetypen.

• Mehrere Attributdefinitionen für die channel-Ressource wurden aktualisiert, um die folgenden Informationen zu berücksichtigen:

  • Der Wert der Eigenschaft brandingSettings.channel.description darf maximal 1.000 Zeichen lang sein.
  • Die Eigenschaft brandingSettings.channel.featuredChannelsTitle darf maximal 30 Zeichen lang sein.
  • In der Eigenschaft brandingSettings.channel.featuredChannelsUrls[] können jetzt bis zu 100 Channels aufgeführt werden.
  • Wenn der Wert der Property brandingSettings.channel.unsubscribedTrailer festgelegt ist, muss er 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. Diese Property gibt an, ob der Name des Rechteinhabers angezeigt wird, wenn das Angebot präsentiert wird. Er kann nur festgelegt werden, wenn die API-Anfrage, mit der der Attributwert festgelegt wird, im Namen des Rechteinhabers mit dem 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.

• Mit der Eigenschaft 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 Attribute contentDetails.contentRating.catvRating und contentDetails.contentRating.catvfrRating geben die Altersfreigaben an, die ein Video gemäß dem kanadischen TV Classification System bzw. dem französischsprachigen Régie du cinéma-Altersfreigabe-System, das in Québec verwendet wird, erhalten hat.

• Die neue snippet.assignable-Property der videoCategory-Ressource gibt an, ob aktualisierte oder neu hochgeladene Videos mit dieser Videokategorie verknüpft 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 enthält zwei zusätzliche Funktionen, mit denen sich Live-Übertragungen leichter finden und präsentieren lassen:

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

  • Die neue snippet.liveBroadcastContent-Eigenschaft der video-Ressource gibt an, ob es sich bei dem Video um eine bevorstehende oder aktive Liveü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 begonnen hat.
    • active: Das Video ist eine laufende Liveübertragung.
    • none: Das Video ist keine bevorstehende oder aktive Liveübertragung. Das ist der Property-Wert für abgeschlossene Übertragungen, die weiterhin auf YouTube angesehen werden können.

  • Die neue liveStreamingDetails-Eigenschaft der video-Ressource ist ein Objekt, das Metadaten zu einer Live-Videoübertragung enthält. Wenn Sie diese Metadaten abrufen möchten, fügen Sie liveStreamingDetails in die Liste der Ressourcenbestandteile des Parameterwerts part ein. Die Metadaten enthalten die folgenden neuen Attribute:

    • liveStreamingDetails.actualStartTime: Die Uhrzeit, zu der die Übertragung tatsächlich begonnen hat. Dieser Wert ist verfügbar, sobald der Status der Übertragung active ist.
    • liveStreamingDetails.actualEndTime: Die Uhrzeit, zu der die Übertragung tatsächlich beendet wurde. Dieser Wert ist erst nach Ende des Livestreams verfügbar.
    • liveStreamingDetails.scheduledStartTime – Die Uhrzeit, zu der die Übertragung planmäßig beginnen soll.
    • liveStreamingDetails.scheduledEndTime – Die Uhrzeit, zu der die Übertragung enden soll. Wenn der Attributswert leer ist oder das Attribut nicht vorhanden ist, wird die Übertragung auf unbestimmte Zeit geplant.
    • liveStreamingDetails.concurrentViewers: Die Anzahl der Zuschauer, die sich die Liveübertragung ansehen.

    Um diese Metadaten abzurufen, fügen Sie liveStreamingDetails in den Parameterwert part ein, wenn Sie die Methode videos.list, videos.insert oder videos.update aufrufen.

  Am 1. Oktober 2013 wurden zwei weitere Funktionen zur Identifizierung von Livestream-Inhalten veröffentlicht: der eventType-Parameter der search.list-Methode und die snippet.liveBroadcastContent-Property des Suchergebnisses.

• Die Methode videos.insert unterstützt jetzt den Parameter notifySubscribers, der angibt, ob YouTube eine Benachrichtigung über das neue Video an Nutzer senden soll, die den Kanal des Videos abonniert haben. Der Standardwert des Parameters ist True. Das bedeutet, dass Abonnenten über neu hochgeladene Videos benachrichtigt werden. Ein Kanalinhaber, der viele Videos hochlädt, kann den Wert jedoch auch auf False festlegen, um zu vermeiden, dass Abonnenten des Kanals für jedes neue Video eine Benachrichtigung erhalten.

• 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 erweitert. Außerdem wurde die Liste so geändert, dass die brandingSettings-Properties, die geändert werden können, gekennzeichnet sind. Diese brandingSettings-Properties waren bereits modifizierbar. Die Änderung der Dokumentation spiegelt also keine Änderung der vorhandenen API-Funktionen wider.

• 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 Ressource video unterstützt jetzt den Wert pg14, der einer TV-14-Bewertung entspricht.

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

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

  • mibacVap (VAP) – Kinder sollten von einem Erwachsenen begleitet werden.
  • mibacVm6 (V.M.6) – Keine Personen unter 6 Jahren zugelassen.
  • mibacVm12 (V.M.12) – Keine Personen unter 12 Jahren zugelassen.

• Die neue invideoPromotion.items[].promotedByContentOwner-Eigenschaft der channel-Ressource gibt an, ob der Name des Rechteinhabers bei der Anzeige des Angebots zu sehen ist. Dieses Feld kann nur festgelegt werden, wenn die API-Anfrage, mit der der Wert festgelegt wird, im Namen des Rechteinhabers erfolgt. Weitere Informationen finden Sie unter dem Parameter onBehalfOfContentOwner.

1. Oktober 2013

Dieses Update enthält die folgenden Änderungen:

• Das neue auditDetails-Objekt der channel-Ressource enthält Kanaldaten, die ein Multi-Channel-Netzwerk (MCN) auswerten würde, um zu entscheiden, ob ein bestimmter Kanal akzeptiert oder abgelehnt werden soll. Für jede API-Anfrage, mit der dieser Ressourcenteil abgerufen wird, muss ein Autorisierungstoken mit dem Bereich https://www.googleapis.com/auth/youtubepartner-channel-audit angegeben werden. Außerdem muss jedes Token, das diesen Bereich verwendet, widerrufen werden, wenn das MCN den Kanal annimmt oder ablehnt, oder innerhalb von zwei Wochen nach dem Ausstellungsdatum des Tokens.

• Die invideoPromotion.items[].id.type-Property der channel-Ressource unterstützt jetzt den Wert recentUpload. Dieser gibt an, dass es sich bei dem beworbenen Artikel um das zuletzt hochgeladene Video eines bestimmten Kanals handelt.

  Standardmäßig ist der Channel derselbe, für den die Daten zur In-Video-Werbung festgelegt sind. Du kannst aber das zuletzt hochgeladene Video eines anderen Kanals bewerben, indem du den Wert der neuen invideoPromotion.items[].id.recentlyUploadedBy-Eigenschaft auf die Kanal-ID dieses Kanals festlegst.

• Die channel-Ressource enthält drei neue Eigenschaften: brandingSettings.image.bannerTvLowImageUrl, brandingSettings.image.bannerTvMediumImageUrl und brandingSettings.image.bannerTvHighImageUrl. Diese geben die URLs für die Bannerbilder an, die auf Kanalseiten in TV-Anwendungen angezeigt werden.

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

  • Bei einer video-Ressource gibt der Wert upcoming an, dass das Video eine Liveübertragung ist, die noch nicht begonnen hat. Der Wert active gibt an, dass das Video eine laufende Liveübertragung ist.
  • Bei einer channel-Ressource gibt der Wert upcoming an, dass der Kanal eine geplante Übertragung hat, die noch nicht begonnen hat, während der Wert acive angibt, dass der Kanal eine laufende Liveübertragung hat.

• 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, mit dem das Wasserzeichenbild verknüpft ist, wird dieser Wert jetzt in der targetChannelId-Property selbst angegeben. Die targetChannelId.value-Property der Ressource wurde daher 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 so eingeschränkt werden kann, dass nur aktive, anstehende oder abgeschlossene Broadcast-Ereignisse zurückgegeben werden.

• Die neue contentDetails.contentRating.mibacRating-Eigenschaft gibt die Altersfreigabe an, die ein Video vom italienischen Ministero dei Beni e delle Attività 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 bereitgestellte Bildinhalt ungültig ist.
  forbidden	videoRatingDisabled	Die Methode videos.rate gibt diesen Fehler zurück, wenn der Inhaber des zu bewertenden Videos die Bewertungen für dieses Video deaktiviert hat.

27. August 2013

Dieses Update enthält die folgenden Änderungen:

• Mit der neuen watermark-Ressource wird ein Bild identifiziert, das bei der Wiedergabe von Videos eines bestimmten Kanals angezeigt wird. Sie können auch einen Zielkanal angeben, auf den das Bild verweist, sowie Zeitangaben, die bestimmen, 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 von der API speziell für die Methoden watermarks.set und watermarks.unset unterstützt werden.

• Die neue statistics.hiddenSubscriberCount-Eigenschaft der channel-Ressource enthält einen booleschen Wert, der angibt, ob die Anzahl der Abonnenten des Kanals verborgen 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, der die Inhaltsregion angibt, für die ein Diagramm abgerufen werden soll. Dieser Parameter kann nur in Verbindung mit dem Parameter chart verwendet werden. Der Parameterwert ist ein ISO 3166-1 Alpha-2-Ländercode.

• Die error documentation beschreibt den folgenden neuen häufigen Anforderungsfehler, 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:

  • In der API kann jetzt eine Website als beworbenes Element angegeben werden. Dazu legen Sie den Wert des Attributs invideoPromotion.items[].id.type auf website fest und geben die URL mit dem neuen Attribut invideoPromotion.items[].id.websiteUrl an. Mit dem neuen Attribut invideoPromotion.items[].customMessage können Sie eine benutzerdefinierte Nachricht für das Angebot definieren.

    Links können auf verknüpfte Websites, Händlerwebsites oder Websites sozialer Netzwerke verweisen. Weitere Informationen zum Aktivieren von Links für deine Inhalte findest du in der YouTube-Hilfe unter Verknüpfte Websites und Händlerwebsites.

    Durch das Hinzufügen von Werbelinks erklärst du dich damit einverstanden, dass diese Links nicht verwendet werden, um Traffic auf nicht autorisierte Websites umzuleiten, und dass diese Links den AdWords-Richtlinien, den YouTube-Werberichtlinien, den YouTube-Community-Richtlinien und den YouTube-Nutzungsbedingungen entsprechen.

  • Die Attribute für die Timing-Einstellungen für die Anzeige beworbener Artikel während der Videowiedergabe wurden neu strukturiert:

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

    • Mit dem neuen invideoPromotion.defaultTiming-Objekt werden Standardeinstellungen für den Zeitraum Ihres Angebots festgelegt. Mit diesen Einstellungen wird festgelegt, wann ein beworbenes Produkt 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 dem neuen Attribut invideoPromotion.items[].timing.durationMs wird die Anzeigedauer des Angebots in Millisekunden angegeben. Das invideoPromotion.defaultTiming-Objekt enthält auch ein durationMs-Feld, das die Standarddauer für die Anzeige des beworbenen Artikels angibt.

  • Die Attribute invideoPromotion.items[].type und invideoPromotion.items[].videoId wurden beide 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 gezeigte Funktion jetzt von der Methode videos.rate übernommen wird.

• Der error documentation-Fehler 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. Entfernen Sie entweder den Parameter mine, authentifizieren Sie sich als YouTube-Nutzer, indem Sie den Parameter onBehalfOfContentOwner entfernen, oder geben Sie den Parameter onBehalfOfContentOwnerChannel an, sofern er für die aufgerufene Methode verfügbar ist, um als einer der Kanäle des Partners zu agieren.

8. August 2013

Dieses Update enthält die folgenden Änderungen:

• Der Abschnitt Kontingentnutzung im Leitfaden Erste Schritte mit der YouTube Data API wurde aktualisiert. Die Kontingentkosten für einen Video-Upload sind von etwa 16.000 Einheiten auf etwa 1.600 Einheiten gesunken.

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 die Inhalte des Kanals ergänzt. Der Attributwert ist ein Rautezeichen (#), gefolgt von einem sechsstelligen hexadezimalen String, z. B. #2793e6.

• Die API unterstützt jetzt die Möglichkeit, anzugeben, ob ein Abo für alle Aktivitäten eines Kanals oder nur für neue Uploads gilt. Die neue contentDetails.activityType-Property der subscription-Ressource gibt die Arten von Aktivitäten an, ü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:

  • Der Parameter chart gibt das Diagramm an, das Sie abrufen möchten. Derzeit ist der einzige unterstützte Wert mostPopular. Der Parameter chart ist ein Filterparameter. Er kann also nicht im selben Request 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 topicDetails.relevantTopicIds[]-Eigenschaft der video-Ressource enthält eine Liste von Freebase-Themen-IDs, die für das Video oder seine Inhalte relevant sind. Die Themen können im Video erwähnt werden oder im Video zu sehen sein.

• Das Attribut recordingDetails.location.elevation der video-Ressource wurde in recordingDetails.location.altitude umbenannt und das Attribut fileDetails.recordingLocation.location.elevation in fileDetails.recordingLocation.location.altitude.

• Das contentDetails.contentRating-Objekt der video-Ressource gibt die Altersfreigaben an, die ein Video in verschiedenen Bewertungssystemen erhalten hat, darunter MPAA- und TVPG-Bewertungen. Für jedes Einstufungssystem unterstützt die API jetzt einen Einstufungswert, der angibt, dass das Video nicht eingestuft wurde. Bei MPAA-Altersfreigaben wird die Einstufung „Unrated“ häufig für ungekürzte Versionen von Filmen verwendet, für die die gekürzte Version des Films eine offizielle Altersfreigabe erhalten hat.

• Die neue contentDetails.contentRating.ytRating-Eigenschaft der video-Ressource gibt Inhalte mit Altersbeschränkung an. Der Attributwert ist ytAgeRestricted, wenn YouTube das Video als Inhalte identifiziert hat, die für Nutzer unter 18 Jahren nicht geeignet sind. Wenn das Attribut fehlt oder der Attributwert leer ist, wurden die Inhalte nicht als Inhalte mit Altersbeschränkung identifiziert.

• Der Parameter mySubscribers der Methode channels.list wurde eingestellt. Mit der Methode subscriptions.list und dem zugehörigen Parameter mySubscribers können Sie eine Liste der Abonnenten des Kanals des authentifizierten Nutzers abrufen.

• 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 zur Methode channels.update wurde aktualisiert, um zu berücksichtigen, dass diese Methode zum Aktualisieren des brandingSettings-Objekts der Ressource channel und seiner untergeordneten Attribute verwendet werden kann. In der Dokumentation finden Sie jetzt auch die aktualisierte Liste der Eigenschaften, die Sie für das invideoPromotion-Objekt der channel-Ressource festlegen können.

• Die error documentation beschreibt die folgenden neuen Fehler:

  Fehlertyp	Fehlerdetails	Beschreibung
  forbidden	accountDelegationForbidden	Dieser Fehler ist nicht spezifisch für eine bestimmte API-Methode. Dies weist darauf hin, dass der authentifizierte Nutzer nicht berechtigt ist, im Namen des angegebenen Google-Kontos zu handeln.
  forbidden	authenticatedUserAccountClosed	Dieser Fehler ist nicht spezifisch für eine bestimmte API-Methode. Das bedeutet, dass das YouTube-Konto des authentifizierten Nutzers geschlossen wurde. Wenn der Nutzer im Namen eines anderen Google-Kontos handelt, bedeutet dieser Fehler, dass dieses andere Konto geschlossen ist.
  forbidden	authenticatedUserAccountSuspended	Dieser Fehler ist nicht auf eine bestimmte API-Methode beschränkt. Das bedeutet, dass das YouTube-Konto des authentifizierten Nutzers gesperrt ist. Wenn der Nutzer im Namen eines anderen Google-Kontos handelt, weist dieser Fehler darauf hin, dass dieses andere Konto gesperrt ist.
  forbidden	authenticatedUserNotChannel	Dieser Fehler ist nicht auf eine bestimmte API-Methode beschränkt. Dies weist darauf hin, dass der API-Server den mit der API-Anfrage verknüpften Channel nicht identifizieren kann. Wenn die Anfrage autorisiert ist und den Parameter onBehalfOfContentOwner verwendet, sollten Sie auch den Parameter onBehalfOfContentOwnerChannel festlegen.
  forbidden	cmsUserAccountNotFound	Dieser Fehler ist nicht auf eine bestimmte API-Methode beschränkt. Der CMS-Nutzer darf nicht im Namen des angegebenen Rechteinhabers handeln.
  notFound	contentOwnerAccountNotFound	Dieser Fehler ist nicht auf eine bestimmte API-Methode beschränkt. Das angegebene Konto des Rechteinhabers wurde nicht gefunden.
  badRequest	invalidPart	Dieser Fehler ist nicht spezifisch für eine bestimmte API-Methode. Der Parameter part der Anfrage gibt Teile an, die nicht gleichzeitig geschrieben werden können.
  badRequest	videoChartNotFound	Die Methode videos.list gibt diesen Fehler zurück, wenn in der Anfrage ein nicht unterstütztes oder nicht verfügbares Video-Diagramm angegeben ist.
  notFound	videoNotFound	Die Methode videos.update gibt diesen Fehler zurück, um anzugeben, dass das Video, das Sie aktualisieren möchten, nicht gefunden werden kann. Prüfen Sie den Wert der Property id im Anfragetext, um sicherzustellen, dass er 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. Damit wird die API angewiesen, 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 Erstellung 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 auch Playlist-Tags festlegen, wenn sie die Methoden playlists.insert oder playlists.update aufrufen.

• Der Parameter onBehalfOfContentOwner, der zuvor für die Methoden channels.list und search.list unterstützt wurde, wird jetzt auch für die Methoden videos.insert, videos.update und videos.delete unterstützt. Wenn dieser Parameter in einem Aufruf der Methode videos.insert verwendet wird, muss in der Anfrage auch ein Wert für den neuen Parameter onBehalfOfContentOwnerChannel angegeben werden, der den Kanal identifiziert, dem das Video hinzugefügt wird. Der Kanal muss mit dem Rechteinhaber verknüpft sein, der im Parameter onBehalfOfContentOwner angegeben ist.

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

  Dieser Parameter ist für Content-Partner gedacht, die viele verschiedene YouTube-Kanäle besitzen und verwalten. Mit dem Parameter können sich diese Partner einmal authentifizieren und auf alle ihre Video- und Kanaldaten zugreifen, ohne für jeden einzelnen Kanal Anmeldedaten für die Authentifizierung angeben zu müssen.

  Mit dem Parameter kann ein Content-Partner Videos in allen YouTube-Kanälen, die ihm gehören, einfügen, aktualisieren oder löschen.

• Die error documentation beschreibt die folgenden neuen Fehler:

  Fehlertyp	Fehlerdetails	Beschreibung
  forbidden	insufficientCapabilities	Dieser Fehler ist nicht spezifisch für eine bestimmte API-Methode. Dies weist darauf hin, dass der CMS-Nutzer, der die API aufruft, nicht die erforderlichen Berechtigungen zum Ausführen des angeforderten Vorgangs hat. Dieser Fehler hängt mit der Verwendung des Parameters onBehalfOfContentOwner zusammen, 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, die Anfrage 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 wird.

• Im neuen Leitfaden Mit Channel-IDs arbeiten wird erläutert, wie die API Channel-IDs verwendet. 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 default-Nutzer anfordern oder darauf basieren, dass jeder YouTube-Kanal einen eindeutigen Nutzernamen hat. Das ist nicht mehr der Fall.

22. Mai 2013

Dieses Update enthält die folgenden Änderungen:

• Mit der neuen Methode channelBanners.insert können Sie ein Bannerbild hochladen, das anschließend mit dem neuen Attribut brandingSettings.image.bannerExternalUrl der Ressource channel als Bannerbild für einen Kanal festgelegt werden kann.

• Die Dokumentation für die channels.update-Methode wurde aktualisiert und enthält jetzt eine Liste der Eigenschaften, die beim Aufrufen der Methode geändert werden können.

• In der Dokumentation für die 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.

• Im 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 Methode channels.update aufgeführt.

14. Mai 2013

Dieses Update enthält die folgenden Änderungen:

• Auf den einzelnen Seiten sind jetzt Codebeispiele für Java, .NET, PHP und Ruby aufgeführt.

• Auf der Seite mit Python-Codebeispielen finden Sie jetzt Beispiele für das Hinzufügen eines Abos, das Erstellen einer Playlist und das 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 bereit, die der Richtlinie zur Einstellung von Produkten und Diensten unterliegen.

8. Mai 2013

Dieses Update enthält die folgenden Änderungen:

• Kanalressourcen unterstützen jetzt das inVideoPromotion-Objekt, das Informationen zu einer Werbekampagne enthält, die mit dem Kanal verknüpft ist. Mit einer In-Video-Werbekampagne können auf einem Kanal während der Wiedergabe von Videos des Kanals Thumbnail-Bilder für ein beworbenes Video im Videoplayer angezeigt werden.

  Sie können diese Daten abrufen, indem Sie invideoPromotion in den part-Parameterwert in einer channels.list-Anfrage einfügen.

• Mit der neuen Methode channels.update können die Daten einer Werbekampagne in einem Video aktualisiert werden. Beachten Sie, dass die Methode nur Aktualisierungen des invideoPromotion-Teils der channel-Ressource unterstützt und noch keine Aktualisierungen anderer Teile dieser Ressource.

2. Mai 2013

Dieses Update enthält die folgenden Änderungen:

• Kanalressourcen unterstützen jetzt die status.isLinked-Property, die angibt, ob die Kanaldaten einen Nutzer identifizieren, der bereits mit einem YouTube-Nutzernamen oder einem Google+-Konto verknüpft ist. Nutzer, die einen dieser Links haben, haben bereits eine öffentliche YouTube-Identität. Das ist eine Voraussetzung für verschiedene Aktionen, z. B. das Hochladen von Videos.

• Aboressourcen unterstützen jetzt den subscriberSnippet-Teil. 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 myRating-Parameter der Methode videos.list können Sie eine Liste von Videos abrufen, die der authentifizierte Nutzer mit like oder dislike bewertet hat.

  Der Parameter myRating und der Parameter id gelten jetzt beide 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 für Anfragen zurück, mit denen versucht wird, Informationen zur Altersfreigabe von Videos abzurufen, für die jedoch keine entsprechende Autorisierung vorliegt.

• Mit der Einführung des Parameters myRating wurde auch die Methode videos.list aktualisiert, um die Paginierung zu unterstützen. Beachten Sie jedoch, dass Paging-Parameter nur für Anfragen mit dem Parameter myRating unterstützt werden. Seitenwechselparameter und ‑informationen werden für Anfragen, die den Parameter id verwenden, nicht unterstützt.

  • Mit dem Parameter maxResults wird die maximale Anzahl von Videos angegeben, die von der API im Ergebnissatz zurückgegeben werden können. Mit dem Parameter pageToken wird eine bestimmte Seite im Ergebnissatz angegeben, die abgerufen werden soll.

  • 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 Ressource youtube#videoListResponse kann auch die Eigenschaften nextPageToken und prevPageToken enthalten, die jeweils ein Token bereitstellen, mit dem eine bestimmte Seite in der Ergebnismenge abgerufen werden kann.

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

  • autoLevels: Wenn du diesen Parameterwert auf true setzt, werden Beleuchtung und Farbe des Videos automatisch von YouTube optimiert.
  • stabilize: Wenn du diesen Parameterwert auf true setzt, wird das Video auf YouTube angepasst, um Verwacklungen durch Kamerabewegungen zu entfernen.

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

  • playlistItem: Mit dieser Property wird der Name des Kanals angegeben, der das Playlist-Element hinzugefügt hat.
  • playlist – Das Attribut gibt den Namen des Kanals an, der die Playlist erstellt hat.
  • subscription: Das Attribut gibt den Namen des abonnierten Kanals an.

• Für die folgenden Methoden wurden Codebeispiele hinzugefügt:

  • activities.insert (Ruby)
  • playlistItems.list (.NET)
  • search.list (.NET)
  • subscriptions.insert (Java, Ruby)
  • videos.insert (.NET, Ruby)

• Mit dem neuen Parameter mySubscribers der Methode subscriptions.list können Sie eine Liste der Abonnenten des 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 die folgenden Eigenschaften möglich:

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

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

• Der Fehler, der von der Methode playlistItems.insert zurückgegeben wird, wenn die Playlist bereits die maximal zulässige Anzahl an 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 kann ein Nutzer einem Video eine like- oder dislike-Altersfreigabe zuweisen oder eine Altersfreigabe aus einem Video entfernen.

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

• Thumbnails werden in der API-Dokumentation jetzt als separate Ressource identifiziert. Mit der neuen thumbnails.set-Methode können Sie ein benutzerdefiniertes Video-Thumbnail auf YouTube hochladen und für ein Video festlegen.

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

  Diese Änderung hat keine Auswirkungen auf vorhandene Ressourcen, die Vorschaubilder zurückgeben. Miniaturbilder werden in diesen Ressourcen auf dieselbe Weise zurückgegeben wie zuvor. In der Dokumentation sind jetzt jedoch die Namen der verschiedenen Miniaturgrößen aufgeführt, die von der API zurückgegeben werden können.

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

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

  • Das neue status-Objekt enthält Statusinformationen zum Playlist-Element und mit der status.privacyStatus-Eigenschaft wird der Datenschutzstatus des Playlist-Elements angegeben.

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

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

  • Das contentDetails.contentRating-Objekt kapselt die Bewertungen, die das Video in verschiedenen Bewertungssystemen erhalten hat. In der folgenden Liste sind die unterstützten Altersfreigabesysteme aufgeführt. Außerdem finden Sie dort einen Link zur jeweiligen Property. Die Attributdefinitionen geben die unterstützten Altersfreigabewerte für jedes System an.

    Land	Altersfreigabesystem	Attribut
    United States	Motion Picture Association of America (MPAA)	contentDetails.contentRating.mpaaRating
    United States	TV Parental Guidelines	contentDetails.contentRating.tvpgRating
    Australia	Australian Classification Board (ACB)	contentDetails.contentRating.acbRating
    Brazil	Departamento de Justiça, Classificação, Qualificação e Títulos	contentDetails.contentRating.djctqRating
    Canada	Canadian Home Video Rating System (CHVRS)	contentDetails.contentRating.chvrsRating
    France	Centre national du cinéma et de l'image animée (Französisches Ministerium für Kultur)	contentDetails.contentRating.fmocRating
    Germany	Freiwillige Selbstkontrolle der Filmwirtschaft (FSK)	contentDetails.contentRating.fskRating
    Great Britain	British Board of Film Classification (BBFC)	contentDetails.contentRating.bbfcRating
    India	Central Board of Film Certification (CBFC)	contentDetails.contentRating.cbfcRating
    Japan	映倫管理委員会 (EIRIN)	contentDetails.contentRating.eirinRating
    Korea	영상물등급위원회 (KMRB)	contentDetails.contentRating.kmrbRating
    Mexico	General Directorate of Radio, Television and Cinematography (RTC)	contentDetails.contentRating.rtcRating
    New Zealand	Office of Film and Literature Classification	contentDetails.contentRating.oflcRating
    Russia	Nationales Filmregister der Russischen Föderation	contentDetails.contentRating.russiaRating
    Spain	Instituto de la Cinematografía y de las Artes Audiovisuales (ICAA)	contentDetails.contentRating.icaaRating

• Die Dokumentation zur Methode playlistItems.update wurde aktualisiert. Das Attribut snippet.resourceId muss in der Ressource angegeben werden, die als Anfragetext gesendet wird.

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

  • Der neue Parameter forMine schränkt eine Suche so ein, dass nur die Videos des authentifizierten Nutzers abgerufen werden.

  • Der Parameter order unterstützt jetzt die Möglichkeit, Ergebnisse alphabetisch nach Titel (order=title) oder nach Anzahl der Videos in absteigender Reihenfolge (order=videoCount) zu sortieren.

  • Der neue Parameter safeSearch gibt an, ob Suchergebnisse eingeschränkte Inhalte enthalten sollen.

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

  Fehlertyp	Fehlerdetails	Beschreibung
  badRequest	invalidCategoryId	Für die Property snippet.categoryId wurde eine ungültige Kategorie-ID angegeben. Verwenden Sie die Methode videoCategories.list, um unterstützte Kategorien abzurufen.
  badRequest	invalidRecordingDetails	Der Wert metadata gibt ungültige Aufzeichnungsdetails an.
  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 Channels an, der für die Aktivität verantwortlich ist.
  • search: Die Property gibt den Namen des Kanals an, der mit der Ressource verknüpft ist, die im Suchergebnis identifiziert wird.
  • video: Mit dieser Eigenschaft wird der Name des Kanals angegeben, auf dem das Video hochgeladen wurde.

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

  • Mit dem Parameter channelType können Sie eine Suche nach Kanälen einschränken, um alle Kanäle oder nur Sendungen abzurufen.

  • Mit dem Parameter videoType können Sie die Suche nach Videos einschränken, um alle Videos oder nur Filme oder nur Folgen von Serien abzurufen.

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

• Die Methode playlistItems.update gibt jetzt den Fehler invalidSnippet zurück, der zurückgegeben wird, wenn in der API-Anfrage kein gültiger Ausschnitt angegeben ist.

• Mehrere API-Methoden unterstützen neue Parameter, die ausschließlich für YouTube-Inhaltspartner vorgesehen sind. Zu den YouTube-Inhaltspartnern gehören Film- und Fernsehstudios, Musiklabels und andere Content-Creator, die ihre Inhalte auf YouTube zur Verfügung stellen.

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

    Dieser Parameter ist für Content-Partner gedacht, die viele verschiedene YouTube-Kanäle besitzen und verwalten. Mit dem Parameter können sich diese Partner einmal authentifizieren und auf alle ihre Video- und Kanaldaten zugreifen, ohne für jeden einzelnen Kanal Anmeldedaten für die Authentifizierung 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 zurückzugeben, die dem im Parameter onBehalfOfContentOwner angegebenen Rechteinhaber gehören.

  • 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 Attribute für video-Ressourcen:

  • Die neuen Abschnitte fileDetails, processingDetails und suggestions enthalten Informationen zu den hochgeladenen Videos. Diese Daten sind sehr nützlich in Anwendungen, die das Hochladen von Videos ermöglichen, und umfassen Folgendes:

    • Verarbeitungsstatus und ‑fortschritt
    • Fehler oder andere Probleme, die bei der Verarbeitung eines Videos aufgetreten sind
    • Verfügbarkeit von Thumbnails
    • 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 Attribute definiert, die die einzelnen Teile enthalten.

    • Das fileDetails-Objekt enthält Informationen zur Videodatei, die auf YouTube hochgeladen wurde, einschließlich der Auflösung, Dauer, Audio- und Videocodecs, Stream-Bitraten und mehr.

    • Das processingProgress-Objekt enthält Informationen zum Fortschritt der Verarbeitung der hochgeladenen Videodatei durch YouTube. Die Attribute des Objekts geben den aktuellen Verarbeitungsstatus an und schätzen die verbleibende Zeit, bis YouTube die Verarbeitung des Videos abgeschlossen hat. In diesem Teil wird auch angegeben, ob für das Video verschiedene Arten von Daten oder Inhalten wie Dateidetails oder Thumbnails verfügbar sind.

      Dieses Objekt ist so konzipiert, dass es abgefragt werden kann, damit der Video-Uploader den Fortschritt der Verarbeitung der hochgeladenen Videodatei durch YouTube verfolgen kann.

    • Das suggestions-Objekt enthält Vorschläge, die Möglichkeiten zur Verbesserung der Videoqualität oder der Metadaten für das hochgeladene Video aufzeigen.

  • Der Teil contentDetails enthält vier neue Attribute. 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 ein Content-Partner von YouTube Anspruch erhoben hat.

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

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

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

• Die neue contentDetails.googlePlusUserId-Property 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.

• In jedem 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 playlistItems.list unterstützt jetzt den Parameter videoId, der in Verbindung mit dem Parameter playlistId verwendet werden kann, um nur das Playlist-Element abzurufen, das das angegebene Video repräsentiert.

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

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

• Das Attribut 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 werden 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 Methoden und Sprachen in der folgenden Liste 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 die channelItem-Aktion gemeldet werden, die auftritt, wenn YouTube ein Video zu einem automatisch generierten YouTube-Kanal hinzufügt. (Der YouTube-Algorithmus ermittelt Themen, die auf der YouTube-Website sehr präsent sind, und erstellt automatisch Kanäle für diese Themen.)

• Die folgenden search.list-Parameter wurden aktualisiert:

  • Der Parameter q ist nicht mehr als Filter vorgesehen. Das bedeutet, dass …
  • 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 Channel 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	Filtert die Videosuchergebnisse so, dass nur Videos angezeigt werden, die der angegebenen Videokategorie zugeordnet sind.
  videoEmbeddable	string	Sie können die Ergebnisse der Videosuche filtern, sodass 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 einbettungsfähige Videos abzurufen.
  videoSyndicated	string	Filtert die Suchergebnisse nach Videos, die außerhalb von YouTube.com wiedergegeben werden können. Wenn Sie den Parameterwert auf true festlegen, werden nur syndizierte Videos abgerufen.

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

  Ressource	Property-Name	Wert	Beschreibung
  activity	contentDetails.playlistItem.playlistItemId	string	Die Playlistenelement-ID, die YouTube zur eindeutigen Identifizierung des Elements in der Playlist zugewiesen hat.
  activity	contentDetails.channelItem	object	Ein Objekt mit Informationen zu einer Ressource, die einem Channel 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 Channel 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 sie genau eine von mehreren Eigenschaften – videoId, playlistId usw. –, 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 Sichtbarkeitsstatus des Kanals. Gültige Werte sind private und public.
  playlist	contentDetails	object	Dieses Objekt enthält Metadaten zum Inhalt der Playlist.
  playlist	contentDetails.itemCount	unsigned integer	Die Anzahl der Videos in der Playlist.
  playlist	player	object	Dieses Objekt enthält Informationen, die Sie zum Abspielen der Playlist in einem eingebetteten Player benötigen.
  playlist	player.embedHtml	string	Ein <iframe>-Tag, mit dem ein Videoplayer eingebettet wird, in dem die Playlist wiedergegeben wird.
  video	recordingDetails	object	Dieses Objekt enthält Informationen, die den Ort und die Zeit der Videoaufnahme identifizieren oder beschreiben.
  video	recordingDetails.location	object	Dieses Objekt enthält Geolocation-Informationen, die mit dem Video verknüpft sind.
  video	recordingDetails.location.latitude	double	Breitengrad in Grad
  video	recordingDetails.location.longitude	double	Längengrad in Grad
  video	recordingDetails.location.elevation	double	Höhe über der Erde in Metern.
  video	recordingDetails.locationDescription	string	Eine Textbeschreibung des Ortes, an dem das Video 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 basierend auf Werten im Anfragetext aktualisiert werden. In der Tabelle unten sind diese Methoden sowie die erforderlichen oder änderbaren Eigenschaften aufgeführt.

  Hinweis:In der Dokumentation für andere Methoden sind möglicherweise bereits erforderliche und änderbare Properties aufgeführt.

  Methode	Attribute
  activities.insert	Erforderliche Attribute snippet.description Modifizierbare Attribute snippet.description contentDetails.bulletin.resourceId
  playlists.update	Erforderliche Attribute id
  playlistItems.update	Erforderliche Attribute id
  videos.update	Erforderliche Attribute id

• Die API gibt keinen playlistAlreadyExists-Fehler mehr zurück, wenn Sie versuchen, 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 wurde nicht gefunden. Mit der Methode guideCategories.list können Sie eine Liste der gültigen Werte abrufen.
  playlistItems.delete	forbidden	playlistItemsNotAccessible	Die Anfrage ist nicht ordnungsgemäß autorisiert, um das angegebene Playlist-Element zu löschen.
  videoCategories.list	notFound	videoCategoryNotFound	Die mit dem Parameter id angegebene Videokategorie wurde nicht gefunden. Mit der Methode videoCategories.list können Sie eine Liste der gültigen Werte abrufen.