Überarbeitungsverlauf

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

30. April 2024

Hinweis: Dies ist eine Ankündigung zu eingestellten Funktionen.

Dieses Update enthält die folgenden Änderungen:

Die API unterstützt das Einfügen oder Abrufen von Kanaldiskussionen nicht mehr. Diese Änderung entspricht der Funktion auf der YouTube-Website, bei der das Posten von Kommentaren auf Kanälen nicht unterstützt wird.

13. März 2024

Hinweis: Dies ist eine Ankündigung zu eingestellten Funktionen.

Dieses Update enthält die folgenden Änderungen:

Der sync-Parameter für die captions.insert und captions.update Methoden wurde eingestellt. YouTube wird die Unterstützung für zum 12. April 2024.

Aufgrund dieser Änderung müssen Entwickler Zeitangaben beim Einfügen oder aktualisierst du Untertiteltracks. Andernfalls schlägt der Upload fehl.

12. März 2024

Dieses Update enthält die folgenden Änderungen:

Die Dokumentation für die Ressource captions wurde aktualisiert, um zu verdeutlichen, dass die maximal zulässige Länge für die snippet.name 150 Zeichen enthält. Die API gibt nameTooLong zurück. wenn der Name länger ist.

7. März 2024

Hinweis: Dies ist eine Ankündigung zu eingestellten Funktionen.

Das Ressourcenattribut channel brandingSettings.channel.moderateComments wurde verworfen. YouTube wird beendet. unterstützt den Parameter seit dem 7. März 2024.

31. Januar 2024

Dieses Update enthält die folgenden Änderungen:

Die neue forHandle der Methode channels.list kannst du Informationen zu einem Kanal abrufen, indem du seinen YouTube-Alias angibst.

9. November 2023

Alle Verweise auf die Ressource videoId unter Comments wurden entfernt, da die Ressource videoId nicht über einen API-Aufruf zurückgegeben wird.

12. September 2023

Hinweis: Dies ist eine Ankündigung zu eingestellten Funktionen.

Die Methode comments.markAsSpam wird seit einigen Jahren eingestellt. Diese Methode wird auf YouTube bereits nicht unterstützt und ist keine nicht mehr über die API unterstützt.

Allen Dokumenten, die auf die comments.markAsSpam-Methode.

22. August 2023

Die Methode search.list unterstützt jetzt die videoPaidProductPlacement . Mit diesem Parameter kannst du Suchergebnisse so filtern, dass nur Videos enthalten sind, die Creator hat angegeben, dass sie über bezahlte Werbung verfügen.

18. August 2023

Die Definition der video-Ressource liveStreamingDetails.concurrentViewers wurde aktualisiert, um darauf hinzuweisen, dass die von der YouTube Data API zurückgegebene Anzahl gleichzeitiger Zuschauer möglicherweise sich von der Anzahl der gleichzeitig verarbeiteten, von Spam entfernten Zuschauer unterscheiden, die über YouTube verfügbar sind. Analytics. Die YouTube-Hilfe finden Sie weitere Informationen zu Messwerten für das Livestreaming.

7. August 2023

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

28. Juni 2023

Die Methode thumbnails.set unterstützt jetzt uploadRateLimitExceeded-Fehler, der darauf hinweist, dass auf dem Kanal zu viele Videos hochgeladen wurden in den letzten 24 Stunden angezeigt. Versuche es später noch einmal.

12. Juni 2023

Hinweis: Dies ist eine Ankündigung zu eingestellten Funktionen.

Für die Methode search.list Der Parameter relatedToVideoId wurde eingestellt. YouTube wird die Unterstützung für Parameter vom 7. August 2023.

Derzeit wurde den search.list-Methoden ein Hinweis zur Einstellung hinzugefügt. Dokumentation. Dieser Parameter wird vollständig aus der search.list-Dokumentation entfernt am oder nach dem 7. August 2023.

Außerdem wurde ein Beispiel, das zeigt, wie ähnliche Videos abgerufen werden können, aus dem API-Implementierungsleitfaden entfernt.

22. August 2022

Typanmerkungen für video.statistics wurden korrigiert. von Feldern ohne Vorzeichen in einen String.

5. August 2022

YouTube hat die Art und Weise geändert, wie Untertitel-IDs generiert werden. Im Rahmen dieser Änderung Allen Untertitel-Tracks neue Untertitel-IDs zuweisen Diese Änderung ist möglicherweise nicht abwärtskompatibel für Anwendungen ändern, die caption_id-Werte, obwohl es nicht Anwendungen betreffen, die keine caption_id-Werte.

Von jetzt bis zum 1. Dezember 2022 captions.list, captions.update, captions.download und und captions.delete werden folgende Aktionen ausgeführt: unterstützen sowohl die alten als auch die neuen Untertiteltrack-IDs. Ab dem 1. Dezember 2022 werden die alten Untertiteltrack-IDs nicht mehr unterstützt. Beim Aufrufen einer dieser API-Methoden mit einer alten Untertiteltrack-ID führt zu einer captionNotFound Fehler.

Als Vorbereitung auf diese Änderung solltest du alle gespeicherten Untertiteltrack-Daten vollständig ersetzen. bis zum 1. Dezember 2022. Das bedeutet, dass du für alle Videos, für die du Untertiteltracks speicherst, löschen, löschen Sie die aktuell gespeicherten Daten und rufen Sie dann die Methode captions.list-Methode zum Abrufen des aktuellen Untertiteltracks für das Video und speichern die Daten in der API-Antwort, wie Sie es tun würden, .

12. Juli 2022

Die Nutzungsbedingungen der YouTube API-Dienste wurden aktualisiert. Bitte siehe Nutzungsbedingungen der YouTube API-Dienste – Überarbeitung unter „Verlauf“.

27. April 2022

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

8. April 2022

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

15. Dezember 2021

Wie am 18. November 2021 in Zusammenarbeit mit „Mag ich nicht“-Bewertungen ändern zählt auf der gesamten YouTube-Plattform als privat, die Ressource video statistics.dislikeCount. Property ist jetzt privat.

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

18. November 2021

In Verbindung mit den Änderungen an Sichtbarkeit von „Mag ich nicht“-Bewertungen auf der gesamten YouTube-Plattform auf „Privat“ setzen, video statistics.dislikeCount wird am 13. Dezember 2021 als privat gekennzeichnet. Das bedeutet, dass die Property in einer API-Antwort vom Endpunkt videos.list enthalten sein, wenn die API-Anfrage vom Videoinhaber authentifiziert wurden.

Der Endpunkt videos.rate ist nicht betroffen durch diese Änderung.

Entwickler, die die Anzahl der „Mag ich nicht“-Bewertungen nicht öffentlich anzeigen und trotzdem die Anzahl der „Mag ich nicht“-Bewertungen für ihre Der API-Client kann beantragen, dass er auf die Zulassungsliste gesetzt wird, um eine Ausnahme zu erhalten. Um eine Ausnahme zu beantragen, müssen Sie muss dies erledigen Antragsformular einreichen.

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

2. Juli 2021

Hinweis: Dies ist eine Ankündigung zu eingestellten Funktionen.

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

Methode Wenn Ihr Code eine commentThreads-Ressource benötigt, führen Sie einen sekundären Aufruf an die commentThreads.list-Methode.

1. Juli 2021

Alle Entwickler, die die API-Dienste von YouTube verwenden, müssen sich einer API-Compliance-Prüfung unterziehen, damit ihnen ein höheres Kontingent von 10.000 Einheiten zugewiesen werden kann. Bisher wurden sowohl die Complianceprüfung als auch Anfragen für die Zuweisung zusätzlicher Kontingenteinheiten von Entwicklern durchgeführt, die das Formular für YouTube API-Dienste – Audit und Kontingenterweiterung ausgefüllt und eingereicht haben.

Um diese Prozesse zu verdeutlichen und die Anforderungen der Entwickler, die unsere API-Dienste verwenden, besser zu erfüllen, fügen wir drei neue Formulare und einen Leitfaden zum Ausfüllen dieser Formulare hinzu:

  • Anfrageformular für geprüfte Entwickler: Entwickler, die bereits eine Prüfung der API-Compliance bestanden haben, können dieses kürzere Formular ausfüllen und einreichen, um eine Verlängerung des zugewiesenen Kontingents zu beantragen.
  • Einspruchsformular: Entwickler, deren API-Projekte die Complianceprüfung nicht bestanden haben oder deren Erhöhung abgelehnt wurde, können dieses Formular ausfüllen und einreichen.
  • Formular für den Kontrollwechsel: Entwickler oder andere Parteien, die einen API-Client im Namen eines Entwicklers betreiben und bei denen ein Kontrollwechsel (z. B. durch einen Aktienkauf oder ‐verkauf, eine Fusion oder eine andere Unternehmenstransaktion) im Zusammenhang mit einem API-Projekt auftritt, müssen dieses Formular ausfüllen und einreichen. So kann das API-Team von YouTube unsere Aufzeichnungen aktualisieren, die Compliance des neuen API-Projekts prüfen und die aktuelle Kontingentzuweisung des Entwicklers validieren.

In jedem neuen Formular werden wir über deine beabsichtigte Nutzung der YouTube-API informiert, damit wir dir besser helfen können.

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

12. Mai 2021

Hinweis: Dies ist eine Ankündigung zu eingestellten Funktionen.

Dieses Update behandelt die folgenden API-Änderungen:

  • Die channel-Ressource contentDetails.relatedPlaylists.favorites wurde eingestellt. Die Funktion „Videos ansehen“ wurde für wie in der Überarbeitung vom 28. April 2016 angemerkt, Verlaufseintrag.

    Vor diesem Update hat die API immer noch eine neue Playlist erstellt, wenn ein API-Client versuchte, Hinzufügen eines Videos zu einer nicht vorhandenen Favoriten-Playlist Künftig wird die Playlist nicht mehr die in diesem Fall erstellt wurden, und die API gibt einen Fehler zurück. Versuche, Favoritenplaylists zu ändern durch Hinzufügen, Ändern oder Löschen von Elementen, werden ebenfalls gemäß vorherigen Ankündigungen eingestellt und Fehler zurückgegeben.

  • Die folgende channel-Ressource werden nicht mehr unterstützt. Diese Eigenschaften werden auf der Benutzeroberfläche von YouTube Studio bereits nicht unterstützt und auf YouTube. 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 Unterkünfte wurden aus dem channel Ressourcendarstellung und ihre Definitionen wurden aus den Unterkunftsliste. Außerdem können Fehler die mit diesen Attributen verknüpft sind, wurden aus der methodenspezifischen Dokumentation entfernt.

  • Die folgende channelSection-Ressource werden nicht mehr unterstützt. Diese Eigenschaften werden auf der Benutzeroberfläche von YouTube Studio bereits nicht unterstützt und auf YouTube. 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[]

    Aufgrund dieser Änderung wird die Methode channelSection.list Der Parameter hl enthält auch wurden eingestellt, da die unterstützten Funktionen nicht unterstützt werden.

    Alle Unterkünfte wurden aus dem channelSection Ressourcendarstellung und ihre Definitionen wurden aus den Unterkunftsliste. Außerdem können Fehler die mit diesen Attributen verknüpft sind, wurden aus der methodenspezifischen Dokumentation entfernt.

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

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

  • Die playlist-Ressource Die Property „snippet.tags[]“ wurde eingestellt. Diese Property wird bereits nicht unterstützt und wird deshalb nicht mehr über die API unterstützt.

9. Februar 2021

Die Ressource playlistItem unterstützt zwei neue Attribute:

28. Januar 2021

Dieses Update enthält die folgenden Änderungen:

  • Das playlistItems.delete, playlistItems.insert, playlistItems.list, playlistItems.update, playlists.delete, playlists.list und Alle playlists.update-Methoden werden unterstützt Es wird ein neuer playlistOperationUnsupported-Fehler angezeigt. Der Fehler tritt auf, wenn eine Anfrage versucht, einen Vorgang ausführen, der für eine bestimmte Playlist nicht zulässig ist Nutzende können beispielsweise Ein Video aus der Playlist mit hochgeladenen Videos oder der Playlist selbst löschen.

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

  • Die Methode playlistItems.list watchHistoryNotAccessible und watchLaterNotAccessible Fehler wurden aus der Dokumentation entfernt. Während Nutzer „Wiedergabeverlauf“ und „Später ansehen“ nicht über die API zugänglich sind, werden diese Fehler nicht zurückgegeben.

15. Oktober 2020

Es wurden zwei neue Abschnitte zum Bereich Developer Richtlinien:

  • Der neue Abschnitt III.E.4.i enthält folgende Bestimmungen: zusätzliche Informationen zu den Daten, die über den eingebetteten YouTube-Player erfasst und gesendet werden. Ich sind für alle Nutzerdaten verantwortlich, die du uns über einen eingebetteten YouTube-Player vor dem Abschluss Der Nutzer hat mit dem Player interagiert, um die Absicht der Wiedergabe anzugeben. Sie können einschränken, welche Daten bevor ein Nutzer mit dem Player interagiert, indem Autoplay auf "false" gesetzt wird.
  • Der neue Abschnitt III.E.4.j bezieht sich auf den Status von Inhalten zu prüfen, bevor du sie auf deiner Website einbettest. Apps. Du bist dafür verantwortlich zu wissen, wann Videos erstellt werden, die du in deinen API-Client einbettest und die über den eingebetteten Player erhobenen Daten entsprechend behandeln. Daher müssen Sie Prüfe den Status von Inhalten mit dem YouTube Data API-Dienst, bevor du sie in deine API einbettest. Client über eingebettete YouTube-Player

Der neue MadeForKids-Status eines Videos ermitteln erfährst du, wie du den Status eines Videos als speziell für Kinder mithilfe der YouTube Data API-Dienst

Im Zusammenhang mit diesen Änderungen wurde dem Dokumentation zu den Embedded Player-Parametern, in der erklärt wird, dass Wenn du Autoplay aktivierst, erfolgt die Wiedergabe ohne Interaktion des Nutzers mit dem Player. Wiedergabe Die Datenerhebung und -freigabe erfolgt daher beim Seitenaufbau.

8. Oktober 2020

Dieses Update umfasst drei kleine Änderungen channel-Ressource:

  • Das snippet.thumbnails das die Thumbnail-Bilder eines Kanals identifiziert, bei neu erstellten und es kann bis zu einem Tag dauern, bis diese Daten angezeigt werden.
  • Das statistics.videoCount gibt nur die Anzahl der öffentlichen Videos des Kanals an, auch für die Inhaber. Dieses Verhalten stimmt mit der Anzahl auf der YouTube-Website überein.
  • Keywords für den Kanal, die in den brandingSettings.channel.keywords Property, werden möglicherweise abgeschnitten, wenn sie die maximal zulässige Länge von 500 Zeichen überschreiten, oder wenn sie Anführungszeichen ohne Escapezeichen enthalten ("). Beachten Sie, dass der 500-Zeichen- Das Limit ist keine Begrenzung pro Keyword, sondern eine Begrenzung der Gesamtlänge aller Keywords. Dieses Verhalten entspricht dem auf der YouTube-Website.

9. September 2020

Hinweis: Dies ist eine Ankündigung zu eingestellten Funktionen.

Dieses Update behandelt die folgenden API-Änderungen. Alle Änderungen treten am oder nach dem Datum dieser Mitteilung, 9. September 2020. Vor diesem Hintergrund sollten Entwickler nutzen eine der unten aufgeführten API-Funktionen.

  • Die folgenden API-Ressourcen, Methoden, Parameter und Ressourcenattribute wurden eingestellt sofort und ab dem Datum dieser Ankündigung nicht mehr funktionieren: <ph type="x-smartling-placeholder">
      </ph>
    • Die folgende channel-Ressource Eigenschaften: <ph type="x-smartling-placeholder">
        </ph>
      • Das Attribut statistics.commentCount
      • Das brandingSettings.image-Objekt und alle untergeordneten Attribute
      • Die Liste brandingSettings.hints und alle untergeordneten Attribute
    • Die Methode channels.list Filterparameter „categoryId“
    • Die Ressource guideCategories und die guideCategories.list Methode
  • API-Antworten für die channels.list-Methode länger die prevPageToken wenn in der API-Anfrage die managedByMe-Parameter an true. Diese Änderung hat keine Auswirkungen auf das Attribut prevPageToken für andere channels.list-Anfragen. Dies hat keine Auswirkungen auf nextPageToken Property für Anfragen.
  • contentDetails.relatedPlaylists.watchLater der Ressource channel und contentDetails.relatedPlaylists.watchHistory Unterkünfte wurden angekündigt, da er am 11. August 2016 eingestellt wurde. Die Unterstützung der Methoden playlistItems.insert und playlistItems.delete für diese Playlists wurden ebenfalls vollständig eingestellt und die beiden Properties wurden entfernt. aus der Dokumentation.
  • Der Parameter mySubscribers der Methode channels.list, der am 30. Juli 2013 als veraltet angekündigt, wurden aus der Dokumentation entfernt. Verwenden Sie die Methode Methode subscriptions.list und mySubscribers, um eine Liste der Abonnenten des den Kanal des authentifizierten Nutzers.
  • Das invideoPromotion-Objekt der Ressource channel und alle untergeordneten Elemente die am 27. November 2017 aus der Dokumentation entfernt.

29. Juli 2020

Wir haben unser Verfahren zur Berechnung von Kontingenten für API-Anfragen vereinfacht, indem wir die zusätzlichen Kosten in Verbindung mit dem Parameter part. Ab sofort stellen wir Ihnen nur noch die Basiskosten für die aufgerufene Methode. Weitere Informationen zur vereinfachten hier.

Diese Änderung hat zur Folge, dass die meisten API-Aufrufe geringfügig niedrigere Kontingentkosten haben, während werden für einige API-Aufrufe die Kosten jedoch gleich bleiben. Durch diese Änderung erhöhen sich die Kosten der APIs nicht. Anrufe. Insgesamt ist die wahrscheinliche Auswirkung darauf, dass Ihr zugewiesenes Kontingent, das Sie in den Google Cloud Console.

Wir empfehlen allen Entwicklern dringend, Compliance-Audit für ihre um dauerhaften Zugriff auf die YouTube API-Dienste zu gewährleisten.

Dieser Überarbeitungsverlaufseintrag wurde ursprünglich am 20. Juli 2020 veröffentlicht.

28. Juli 2020

Alle Videos, die über videos.insert hochgeladen wurden Endpunkt aus nicht verifizierten API-Projekten, die nach dem 28. Juli 2020 erstellt wurden, sind auf privaten Ansichtsmodus nutzen. Um diese Einschränkung aufzuheben, muss jedes Projekt einer Prüfung Einhaltung der Nutzungsbedingungen:

Creator, die Videos über einen nicht verifizierten API-Client hochladen, erhalten eine E-Mail, in der erklärt wird, sein Video als „Privat“ gesperrt ist und dass er die Einschränkung vermeiden kann, indem er oder geprüften Kunden.

API-Projekte, die vor dem 28. Juli 2020 erstellt wurden, sind derzeit nicht von dieser Änderung betroffen. Wir empfehlen jedoch allen Entwicklern, Compliance-Audit durchführen für ihre Projekte, um den weiteren Zugriff auf die YouTube API-Dienste zu gewährleisten.

21. Juli 2020

[Aktualisiert am 28. Juli 2020.] Das Dokumentationsupdate, auf das in dieser Version verwiesen wird der am 28. Juli 2020 neu veröffentlicht wurde.

Gestern haben wir eine aktualisierte Dokumentation zu unserem Verfahren zur Berechnung von Kontingenten veröffentlicht. Aufgrund unvorhergesehener Umstände ist die Kontingentänderung jedoch noch nicht in Kraft getreten. Daher die Dokumentation im Interesse der Richtigkeit rückgängig gemacht wurde. Um Verwirrung zu vermeiden, Verlaufseintrag zur Erläuterung der Änderung wurde entfernt und wird in naher Zukunft wieder veröffentlicht.

7. Juli 2020

Hinweis: Dies ist eine Ankündigung zu eingestellten Funktionen.

Die Methode videos.insert Die Parameter autoLevels und stabilize wurden eingestellt und beide wurden aus der Dokumentation entfernt. Ihre Werte werden ignoriert und wirken sich nicht auf die wie neu hochgeladene Videos verarbeitet werden.

15. Juni 2020

Die neue Einhaltung der YouTube-Entwicklerrichtlinien Richtlinien enthält Anleitungen und Beispiele, mit denen Sie sicherstellen können, dass Ihre API-Clients die Richtlinien einhalten auf bestimmte Teile der YouTube API-Dienste Nutzungsbedingungen und Richtlinien (API-Nutzungsbedingungen).

Diese Anleitung bietet Einblicke darin, wie YouTube bestimmte Aspekte der API-Nutzungsbedingungen durchsetzt. keine vorhandenen Dokumente ersetzen. Der Leitfaden beantwortet einige der am häufigsten gestellten Fragen, bei API-Compliance-Audits fragen. Wir hoffen, dass die Entwicklung von Funktionen dadurch vereinfacht wird, damit Sie verstehen, wie wir unsere Richtlinien auslegen und durchsetzen.

4. Juni 2020

Hinweis:Dies ist ein Update zu einer vorherigen Einstellungsankündigung.

Das Kanalbulletin wurde inzwischen vollständig eingestellt. Diese Änderung wurde ursprünglich angekündigt und ist nun in Kraft getreten. Daher activities.insert-Methode ist nein nicht mehr unterstützt wird und activities.list gibt keine Kanalbulletins mehr zurück. Weitere Informationen finden Sie in der YouTube-Hilfe

17. April 2020

Hinweis: Dies ist eine Ankündigung zu eingestellten Funktionen.

Das Kanalbulletin wird von YouTube eingestellt. Daher activities.insert-Methode wird eingestellt und die activities.list gibt keine Kanalbulletins mehr zurück. Diese Änderungen treten in der API am oder nach dem 18. Mai 2020. Weitere Informationen finden Sie in der YouTube-Hilfe

31. März 2020

Dieses Update enthält die folgenden Änderungen:

  • Neue Ressourcen und Methoden

    • Die neue Ressource member stellt ein Mitglied eines YouTube-Kanals Ein Mitglied unterstützt eine Person und erhalte 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 , die als Teil der YouTube Live Streaming API dokumentiert sind. Die Die Ressource sponsor wurde verworfen. API-Clients sollten Aufrufe auf aktualisieren. sponsors.list-Methode zur Verwendung des Verwenden Sie stattdessen die Methode members.list.

    • Das neue membershipsLevel Ressource eine Preisstufe angibt, die von dem Ersteller verwaltet wird, der die API-Anfrage autorisiert hat. Das membershipsLevels.list ruft eine Liste aller Mitgliedschaftsstufen des Erstellers ab.

10. Januar 2020

Die API unterstützt nun die Identifizierung von Inhalten für Kinder, die von YouTube aufgerufen werden. „speziell für Kinder“. Weitere Informationen zum „speziell für Kinder“ in der YouTube-Hilfe.

Die channel und Ressourcen vom Typ „video“ unterstützen zwei neue Properties, So können Creator und Zuschauer Inhalte speziell für Kinder erkennen:

  • Mit der Eigenschaft selfDeclaredMadeForKids können Creator angeben, channel oder Video als „speziell für Kinder“ gekennzeichnet.

    Für Channels kann diese Eigenschaft beim Aufrufen der channels.update-Methode. Bei Videos Diese Eigenschaft kann beim Aufrufen der videos.insert oder videos.update-Methoden.

    Beachten Sie, dass diese Eigenschaft nur in API-Antworten enthalten ist, die channel oder video, wenn der Kanalinhaber die API-Anfrage autorisiert hat.
  • Mit der Property madeForKids kann jeder Nutzer Inhalte speziell für Kinder abrufen. Status eines Kanals oder Video. Der Status kann beispielsweise wird anhand des Werts der selfDeclaredMadeForKids-Eigenschaft festgelegt. Weitere Informationen finden Sie in der YouTube-Hilfe Informationen zum Festlegen der Zielgruppe für deinen Kanal, deine Videos oder deine Übertragungen

Außerdem haben wir die Nutzungsbedingungen und die Richtlinien für Entwickler der YouTube API-Dienste aktualisiert. Bitte siehe Nutzungsbedingungen der YouTube API-Dienste – Überarbeitung unter „Verlauf“. Die Änderungen an den Nutzungsbedingungen der YouTube API-Dienste und Die Richtlinien für Entwickler treten am 10. Januar 2020 (Pacific Time) in Kraft.

10. September 2019

Die API-Referenzdokumentation wurde entsprechend aktualisiert. Die Anzahl wird auf YouTube und folglich auch in den API-Antworten angegeben. Aufgrund dieser Änderung Die vom YouTube Data API-Dienst zurückgegebenen Abonnentenzahlen werden auf drei signifikante Abonnentenzahlen mit mehr als 1.000 Abonnenten. Diese Änderung betrifft die channel Ressource statistics.subscriberCount Property.

Hinweis: Diese Änderung betrifft den Attributwert auch dann, wenn ein Nutzer sendet eine autorisierte Anfrage nach Daten über ihren eigenen Kanal. Kanalinhaber können weiterhin exakte Abonnentenzahlen in YouTube Studio.

Wenn ein Kanal beispielsweise 123.456 Abonnenten hat, Die Property statistics.subscriberCount enthält den Wert 123000. Die folgende Tabelle zeigt Beispiele dafür, wie Abonnentenzahlen in API-Antworten gerundet werden. abgekürzt in anderen öffentlich sichtbaren YouTube-Benutzeroberflächen:

Abonnentenzahl YouTube Data API Öffentlich sichtbare YouTube-Benutzeroberflächen
1.234 1230 1230
12.345 12300 12.300
123.456 123000 123.000
1.234.567 1230000 1,23 Mio.
12.345.678 12300000 12,3 Mio.
123,456,789 123000000 123 Mio.

4. April 2019

Dieses Update enthält die folgenden Änderungen:

  • Die API-Referenzdokumentation wurde aktualisiert, um häufige Anwendungsfälle für jede Methode besser zu erläutern und dynamische, hochwertige Codebeispiele über das APIs Explorer-Widget bereitzustellen. Ein Beispiel finden Sie in der Dokumentation der Methode channels.list. Es gibt jetzt zwei neue Elemente auf Seiten, die API-Methoden beschreiben:

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

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

      Über die Links in diesem Abschnitt können Sie den APIs Explorer mit Beispielwerten für Ihren Anwendungsfall füllen oder den APIs Explorer im Vollbildmodus öffnen, in dem diese Werte bereits eingetragen sind. Diese Änderungen sollen es Ihnen leichter machen, Codebeispiele zu sehen, die direkt auf den Anwendungsfall anwendbar sind, den Sie in Ihrer eigenen Anwendung implementieren möchten.

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

  • Das Codebeispiel-Tool wurde ebenfalls mit einer neuen Benutzeroberfläche aktualisiert, die alle oben beschriebenen Funktionen bietet. Mit diesem Tool können Sie Anwendungsfälle für verschiedene Methoden untersuchen, Werte in den APIs Explorer laden und den APIs Explorer im Vollbildmodus öffnen, um Codebeispiele in Java, JavaScript, PHP und Python abzurufen.

    Im Zuge dieser Änderung wurden die Seiten entfernt, auf denen zuvor verfügbare Codebeispiele für Java, JavaScript, PHP und Python aufgelistet wurden.

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

Die oben beschriebenen Änderungen ersetzen ein interaktives Tool, das 2017 der API-Dokumentation hinzugefügt wurde.

9. Juli 2018

Dieses Update enthält die folgenden Änderungen:

  • Die Definition der Eigenschaft snippet.thumbnails der Ressource channel wurde aktualisiert. Sie enthält jetzt folgende Änderungen: Wenn Miniaturansichten in Ihrer Anwendung angezeigt werden, müssen im Code die Bild-URLs genauso verwendet werden, 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 Domain http anstelle der Domain https verwenden.

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

  • Hinweis: Dies ist eine Ankündigung zu eingestellten Funktionen.

    Das Attribut recordingDetails.location.altitude der Ressource video wurde verworfen. Es kann nicht garantiert werden, dass Videos Werte für diese Property zurückgeben. Auch wenn API-Anfragen versuchen, einen Wert für diese Eigenschaft festzulegen, ist es möglich, dass die eingehenden Daten nicht gespeichert werden.

22. Juni 2018

Der Implementierungsleitfaden (bisher: Implementierungs- und Migrationsleitfaden wurde aktualisiert, um Anweisungen für die Migration aus der von v2 zur v3-API wechseln. Außerdem wurden Anleitungen für Funktionen entfernt, die in Version 3 des APIs verworfen, z. B. Favoriten.

27. November 2017

Dieses Update enthält die folgenden Änderungen:

  • Hinweis: Dies ist eine Ankündigung zu eingestellten Funktionen.

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

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

    • Beim Versuch, den invideoPromotion-Teil beim Aufrufen von channels.list abzurufen, wird ein leeres invideoPromotion oder gar keine invideoPromotion-Daten zurückgegeben.
    • Beim Versuch, invideoPromotion-Daten beim Aufrufen von channels.update zu aktualisieren, wird mindestens bis zum 27. Mai 2018 eine erfolgreiche Antwort zurückgegeben. Sie werden jedoch als managementfrei betrachtet, was bedeutet, dass keine Aktualisierung durchgeführt wird.

    Nach dem 27. Mai 2018 können bei diesen Anfragen Fehlermeldungen zurückgegeben werden, die beispielsweise darauf hinweisen, dass invalidPromotion ein ungültiger Teil ist.

16. November 2017

Dieses Update enthält die folgenden Änderungen:

  • Das interaktive Code-Snippet-Tool unterstützt jetzt Node.js-Codebeispiele. Die Beispiele sind auch in der Dokumentation für fast alle API-Methoden verfügbar, z. B. die Methode channels.list.

    Die anpassbaren Beispiele sollen Ihnen einen anwendungsfallspezifischen Ausgangspunkt für eine Node.js-Anwendung bieten. Die Funktion ähnelt dem Code in der Node.js-Kurzanleitung. Die Beispiele enthalten jedoch einige Dienstprogrammfunktionen, die in der Kurzanleitung nicht angezeigt werden:

    • Mit der Funktion removeEmptyParameters werden aus einer Liste von Schlüssel/Wert-Paaren, die API-Anfrageparametern entsprechen, die Parameter entfernt, die keine Werte haben.
    • Die Funktion createResource erstellt eine Liste von Schlüssel/Wert-Paaren, die den Attributen in einer API-Ressource entsprechen. Anschließend werden die Attribute in ein JSON-Objekt konvertiert, das in insert- und update-Vorgängen verwendet werden kann. Das folgende Beispiel zeigt eine Reihe von Attributnamen und -werten sowie das JSON-Objekt, das mit dem Code für sie erstellt werden 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 für den Download und die lokale Ausführung vorgesehen. Weitere Informationen finden Sie in den Voraussetzungen zum lokalen Ausführen vollständiger Codebeispiele in der Anleitung für das Code-Snippet-Tool.

25. Oktober 2017

Dieses Update enthält die folgenden Änderungen:

  • Die Python-Codebeispiele im interaktiven Code-Snippet-Tool wurden aktualisiert und verwenden nun die Bibliotheken google-auth und google-auth-oauthlib anstelle der mittlerweile verworfenen oauth2client-Bibliothek.

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

    1. Rufen Sie das interaktive Code-Snippet-Tool oder die Dokumentation einer beliebigen API-Methode, z. B. der channels.list-Methode, auf.
    2. Klicken Sie über den Codebeispielen auf den Tab Python.
    3. Klicken Sie auf die Ein/Aus-Schaltfläche über den Tabs, um von der Darstellung eines Ausschnitts zu einem vollständigen Beispiel zu wechseln.
    4. Auf dem Tab sollte jetzt ein vollständiges Codebeispiel angezeigt werden, in dem der InstalledAppFlow-Autorisierungsvorgang verwendet wird. Die Beschreibung über dem Beispiel erklärt dies und enthält auch einen Link zu einem Beispiel für eine Webserveranwendung.
    5. Klicken Sie auf den Link, um zum Webserverbeispiel zu wechseln. In diesem Beispiel werden das Flask-Webanwendungs-Framework und ein anderer Autorisierungsablauf verwendet.

    Alle diese Beispiele sind für den Download und die lokale Ausführung vorgesehen. Wenn Sie die Beispiele ausführen möchten, folgen Sie der Anleitung zum lokalen Ausführen vollständiger Codebeispiele in der Anleitung für das Code-Snippet-Tool.

29. August 2017

Dieses Update enthält die folgenden Änderungen:

  • Die Definition des forContentOwner-Parameters der search.list-Methode wurde aktualisiert: Wenn dieser Parameter auf true gesetzt ist, muss der type-Parameter auf video festgelegt werden.
  • Die Definition des regionCode-Parameters der search.list-Methode wurde aktualisiert, um klarzustellen, dass der Parameter Suchergebnisse auf Videos beschränkt, die in der angegebenen Region angesehen werden können.
  • YouTube hat seine Markenlogos und -symbole aktualisiert. Neu "entwickelt mit YouTube" können Sie auf der Seite mit den Markenrichtlinien herunterladen. Auf dieser Seite werden auch andere neue YouTube-Logos und -Symbole angezeigt und können von der YouTube-Markenwebsite heruntergeladen werden.

24. Juli 2017

Dieses Update enthält die folgenden Änderungen:

  • Für iOS ist eine neue Kurzanleitung zur YouTube Data API verfügbar. In diesem Leitfaden wird die Verwendung der YouTube Data API in einer einfachen iOS-App erläutert, die entweder in Objective-C oder Swift geschrieben wurde.
  • Das interaktive Code-Snippet-Tool für die YouTube Data API enthält jetzt eine Dokumentation, in der einige der Funktionen des Tools erläutert werden: <ph type="x-smartling-placeholder">
      </ph>
    • 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:

17. Mai 2017

Dieses Update enthält die folgenden Änderungen:

  • Die API-Referenzdokumentation wurde aktualisiert, um Code-Snippets vielseitiger und interaktiver zu machen. Seiten, auf denen API-Methoden wie channels.list oder videos.rate erklärt werden, enthalten jetzt ein interaktives Tool, mit dem Sie Code-Snippets in Java, JavaScript, PHP, Python, Ruby, Apps Script und Go ansehen und anpassen können.

    Für jede Methode zeigt das Tool Code-Snippets für einen oder mehrere Anwendungsfälle an. In jedem Anwendungsfall wird eine gängige Methode zum Aufrufen dieser Methode beschrieben. Du kannst beispielsweise die Methode channels.list aufrufen, um Daten zu einem bestimmten Kanal oder zum Kanal des aktuellen Nutzers abzurufen.

    Sie können auch mit Codebeispielen interagieren:

    • Ändern Sie Parameter- und Eigenschaftswerte. Die Code-Snippets werden dynamisch aktualisiert, um die von Ihnen angegebenen Werte widerzuspiegeln.

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

    • Anfragen 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.

    Beachten Sie, dass dieses Tool den APIs Explorer auf den Seiten ersetzt hat, auf denen es verfügbar ist. Auf jeder Seite wird ein Link angezeigt, über den Sie auch die Anfrage laden können, an der Sie gerade im APIs Explorer arbeiten.

  • Das Tool Code-Snippets für die Daten-API wurde ebenfalls mit einer neuen Benutzeroberfläche aktualisiert, die alle oben beschriebenen Funktionen bietet. Auf dieser Seite sind die wichtigsten neuen Funktionen verfügbar:

    • Unterstützung für API-Anfragen, die Daten schreiben.
    • Unterstützung für Java-Beispiele
    • Flexibler und umfassender Boilerplate-Code zum Autorisieren von Nutzern und zum Erstellen von API-Anfragen.

27. April 2017

Dieses Update enthält die folgenden Änderungen:

30. März 2017

Dieses Update enthält die folgenden Änderungen:

  • Die neue topicDetails.topicCategories[]-Eigenschaft der Ressource channel enthält eine Liste mit Wikipedia-URLs, die den Inhalt des Kanals beschreiben. Die URLs entsprechen den Themen-IDs, die im Attribut topicDetails.topicIds[] der Ressource zurückgegeben werden.
  • Das neue Attribut contentDetails.videoPublishedAt der Ressource playlistItem gibt den Zeitpunkt an, zu dem das Video auf YouTube veröffentlicht wurde. Die Ressource enthält bereits das Attribut snippet.publishedAt, das den Zeitpunkt angibt, zu dem das Element der Playlist hinzugefügt wurde.
  • Wie bei der channel-Ressource gibt die Ressource video jetzt die Eigenschaft topicDetails.topicCategories[] zurück. Diese enthält eine Liste von Wikipedia-URLs, die den Inhalt des Videos beschreiben. Bei Ressourcen vom Typ video entsprechen die URLs den Themen-IDs, die im Attribut topicDetails.relevantTopicIds[] der Ressource zurückgegeben werden.
  • Die neue contentDetails.contentRating.mpaatRating-Eigenschaft der video-Ressource gibt die Bewertung an, die die Motion Picture Association of America für einen Filmtrailer oder eine Filmvorschau gegeben hat.

27. Februar 2017

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

Es gibt jedoch einige Änderungen an der Liste der ausgewählten Elemente:

  • Die folgenden Themen wurden als untergeordnete Themen von Society hinzugefügt:
    NameThemen-ID
    Unternehmen/m/09s1f
    Gesundheit/m/0kt51
    Militär/m/01h6rj
    Politik/m/05qt0
    Religion/m/06bvp
  • Das Thema Animated cartoon, das zuvor Entertainment untergeordnet war, wurde entfernt.
  • Das Thema Children's music, das zuvor Music untergeordnet war, wurde entfernt.

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

29. November 2016

Dieses Update enthält die folgenden Änderungen:

  • Es gibt drei kleine Änderungen an der Liste der Themen-IDs, die ab dem 10. Februar 2017 unterstützt werden:

    • Die Kategorie Professional wrestling, die zuvor der Kategorie Sports untergeordnet war, ist jetzt Entertainment untergeordnet.
    • Die Kategorie TV shows, die Entertainment untergeordnet ist, ist neu.
    • Die Kategorie Health, die zuvor Lifestyle untergeordnet war, wurde entfernt.

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

10. November 2016

Dieses Update enthält die folgenden Änderungen:

  • Wie zuerst am 11. August 2016 angekündigt, sind für die Einstellung von Freebase und der Freebase API mehrere Änderungen an den Themen-IDs erforderlich. Mit Themen-IDs werden Themen identifiziert, die mit channel- und video-Ressourcen verknüpft sind. Du kannst auch den Suchparameter topicId verwenden, um nach Kanälen oder Videos zu suchen, die zu einem bestimmten Thema gehören.

    Ab dem 10. Februar 2017 gibt YouTube nur noch wenige Themen-IDs statt der viel detaillierteren IDs zurück, die bisher ausgegeben wurden. Außerdem können Kanäle und Videos nicht zwangsläufig mit Themen in Verbindung gebracht werden, was dem aktuellen API-Verhalten entspricht.

    Damit Sie Ihre API-Clients auf diese Änderungen vorbereiten können, wurden die Definitionen der folgenden API-Parameter und -Eigenschaften aktualisiert, sodass die Themen-IDs aufgelistet werden, die ab diesem Zeitpunkt unterstützt werden. Die Liste der Kategorien ist für alle Unterkünfte gleich.

  • Hinweis: Dies ist eine Ankündigung zu eingestellten Funktionen.

    Die folgenden Attribute werden nicht mehr unterstützt:

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

  • Da Freebase bereits eingestellt wurde, wurde der Leitfaden Mit Freebase-Themen suchen aus der Dokumentation entfernt. Diese Anleitung enthält Codebeispiele, um zu zeigen, wie eine Anwendung mit der Freebase API funktioniert.

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

2. November 2016

Dieses Update enthält die folgenden Änderungen:

  • Neue Properties und Parameter

    • Die Ressource video enthält mehrere neue Attribute:

      • Die player.embedHtml-Eigenschaft enthält ein <iframe>-Tag, mit dem du einen Player einbetten kannst, der das Video wiedergibt. Die neuen Eigenschaften player.embedHeight und player.embedWidth geben die Abmessungen des eingebetteten Players an. Diese Eigenschaften werden nur zurückgegeben, wenn in der API-Anfrage ein Wert für mindestens einen der Parameter maxHeight oder maxWidth angegeben wird. Diese beiden neuen Parameter werden weiter unten in diesem Überarbeitungsverlaufseintrag erläutert.

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

      • Die neue fpbRatingReasons[] gibt die Gründe an, warum das Video die FPB-Einstufung (Südafrika) erhalten hat.

      • Das neue mcstRating gibt die Bewertung an, die das Video in Vietnam erhalten hat.

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

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

      Mit den neuen Parametern kannst du festlegen, dass der Einbettungscode anstelle der Standardabmessungen eine Höhe und/oder Breite verwendet, die dem Layout deiner Anwendung entspricht. Der API-Server skaliert die Playerabmessungen entsprechend, um sicherzustellen, dass der eingebettete Player keine schwarzen Balken um das Video hat. Mit beiden Parametern wird die maximale Größe des eingebetteten Players festgelegt. Wenn also beide Parameter angegeben sind, kann eine Dimension trotzdem kleiner als der maximal zulässige Wert für diese Dimension sein.

      Angenommen, ein Video hat ein Seitenverhältnis von 16:9. Wenn der maxHeight- oder maxWidth-Parameter nicht festgelegt ist, würde das player.embedHtml-Tag also einen 640-x-360-Player enthalten.

      • Wenn der maxHeight-Parameter auf 720 und der maxWidth-Parameter nicht festgelegt ist, gibt die API einen 1280-x-720-Player zurück.
      • Wenn der maxWidth-Parameter auf 960 und der maxHeight-Parameter nicht festgelegt ist, gibt die API einen 960-x-540-Player zurück.
      • Wenn der maxWidth-Parameter auf 960 und der maxHeight-Parameter auf 450 gesetzt ist, gibt die API einen 800-x-450-Player zurück.

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

  • Aktualisierungen bestehender Methoden, Attribute und Parameter

    • Die Ressourcenbeschreibung channelSection wurde aktualisiert, um zu verdeutlichen, dass in einem Channel maximal 10 Regale ohne Festlegung von Targeting-Daten und maximal 100 Regale mit Targeting-Daten erstellt werden können.

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

    • Die Definition des Attributs snippet.name der Ressource i18nLanguage wurde korrigiert. Sie zeigt jetzt, dass der Wert den Namen einer Sprache darstellt, wie er in der Sprache geschrieben ist, die durch den Parameter hl der Methode i18nLanguage.list angegeben wird.

    • Das Attribut contentDetails.note der Ressource „playlistItem“ wurde aktualisiert, um zu beachten, dass die maximale Länge des Attributwerts 280 Zeichen beträgt.

    • Die Attribute contentDetails.startAt und contentDetails.endAt der Ressource playlistItem wurden verworfen. 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 ebenfalls 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 anzuzeigen, dass die Parameterwerte eingeschlossen sind. Wenn beispielsweise der Parameter publishedBefore festgelegt ist, gibt die API Ressourcen zurück, die vor oder um der angegebenen Zeit erstellt wurden.

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

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

  • Neue und aktualisierte Fehler

    • Die API unterstützt die folgenden neuen Fehler:

      Fehlertyp Fehlerdetails Beschreibung
      forbidden (403) homeParameterDeprecated Die Methode activities.list gibt diesen Fehler zurück, um anzuzeigen, dass die Startseitenaktivitätsdaten des Nutzers über diese API nicht verfügbar sind. Dieser Fehler kann auftreten, wenn Sie den home-Parameter 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 anzuzeigen, dass bei der Anfrage versucht wurde, den Wiedergabeverlauf abzurufen. Playlist-Elemente. Diese können jedoch nicht mit der API abgerufen werden.
      forbidden (403) watchLaterNotAccessible Die Methode playlistItems.list gibt diesen Fehler zurück, um anzugeben, dass die Anfrage versucht hat, „Später ansehen“ abzurufen Playlist-Elemente. Diese können jedoch nicht mit der API abgerufen werden.
      badRequest (400) uploadLimitExceeded Die Methode videos.insert gibt diesen Fehler zurück, um anzuzeigen, dass die Anzahl der Videos, die für den Kanal hochgeladen werden können, überschritten wurde.
      forbidden (403) forbiddenEmbedSetting Die Methode videos.update gibt diesen Fehler zurück, um anzugeben, dass die API-Anfrage versucht, eine ungültige Einbettungseinstellung für das Video festzulegen. Beachte, dass einige Kanäle möglicherweise nicht berechtigt sind, eingebettete Player für Livestreams anzubieten. Weitere Informationen findest du in der YouTube-Hilfe.

    • Die Methode playlistItems.insert gibt keinen Fehler mehr zurück, wenn du einer Playlist ein doppeltes Video hinzufügst. Dieser Fehler ist in der Vergangenheit bei einigen Playlists aufgetreten, z. B. bei Lieblingsvideos, für die keine Duplikate zugelassen wurden, die aber nicht mehr unterstützt werden. Doppelte Videos sind bei Playlists in der Regel nicht zulässig.

  • Weitere Updates

    • Der Überarbeitungsverlaufseintrag für den 15. September 2016 wurde aktualisiert, um klarzustellen, dass jedes Mal, wenn die Attribute contentDetails.relatedPlaylists.watchHistory und contentDetails.relatedPlaylists.watchLater der Ressource channel in einer Antwort enthalten sind, immer die Werte HL bzw. WL enthalten sind. Darüber hinaus werden diese Eigenschaften nur eingeschlossen, wenn ein autorisierter Nutzer Daten über den eigenen Kanal abruft.

15. September 2016

Dieses Update enthält die folgenden Änderungen:

  • In der Aktualisierung des Überarbeitungsverlaufs vom 11. August 2016 wurden verschiedene Änderungen an Themen-IDs vorgenommen, darunter die Tatsache, dass sich die unterstützten Themen-IDs ab dem 10. Februar 2017 ändern. Die Liste der unterstützten Themen wird am 10. November 2016 veröffentlicht.

  • Die folgenden Änderungen sind jetzt in Kraft. Diese Änderungen wurden im Überarbeitungsverlauf am 11. August 2016 bekannt gegeben:

    • Wenn die Methode activities.list mit dem Parameter home aufgerufen wird, der auf true gesetzt ist, enthält die API-Antwort jetzt ähnliche Elemente wie ein abgemeldeter YouTube-Nutzer auf der Startseite.

      Mit dieser geringfügigen Änderung möchten wir die Nutzererfahrung verbessern als in der Aktualisierung des Überarbeitungsverlaufs am 11. August 2016 beschrieben. Bei dieser Aktualisierung wurde angegeben, dass Anfragen mit dem Parameter home eine leere Liste zurückgeben würden.

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

      Diese Eigenschaften sind nur für autorisierte Nutzer sichtbar, die Daten über den eigenen Kanal abrufen. Die Eigenschaften enthalten immer die Werte HL und WL, auch wenn ein autorisierter Nutzer Daten über den eigenen Kanal abruft. Der Wiedergabeverlauf und die Playlist-IDs „Später ansehen“ können daher nicht über die API abgerufen werden.

      Außerdem geben Anfragen zum Abrufen von Playlist-Details (playlists.list) oder Playlist-Elementen (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 des Wiedergabeverlaufs oder der Playlist-IDs mit späterer Wiedergabe, die dein API-Client möglicherweise bereits gespeichert hat.

  • Das fileDetails.recordingLocation-Objekt der Ressource video und ihre untergeordneten Attribute werden nicht mehr zurückgegeben. Bisher konnten diese Daten (wie das übergeordnete fileDetails-Objekt) nur vom Rechteinhaber eines Videos abgerufen werden.

11. August 2016

Dieses Update enthält die folgenden Änderungen:

  • Die neu veröffentlichten Nutzungsbedingungen für die YouTube API-Dienste („aktualisierte Nutzungsbedingungen“), die ausführlich im YouTube-Blog für Entwickler und Entwickler erörtert werden, enthalten zahlreiche Aktualisierungen der aktuellen Nutzungsbedingungen. Zusätzlich zu den aktualisierten Nutzungsbedingungen, die am 10. Februar 2017 in Kraft treten, enthält diese Aktualisierung mehrere Begleitdokumente, in denen die Richtlinien erläutert werden, die Entwickler einhalten müssen.

    Die vollständige Liste der neuen Dokumente wird im Überarbeitungsverlauf der aktualisierten Nutzungsbedingungen beschrieben. Darüber hinaus werden zukünftige Änderungen an den aktualisierten Nutzungsbedingungen oder an diesen Begleitdokumenten ebenfalls in diesem Überarbeitungsverlauf erläutert. Sie können über einen Link im Dokument einen RSS-Feed abonnieren, in dem die Änderungen in diesem Überarbeitungsverlauf aufgeführt sind.

  • Die Einstellung von Freebase und der Freebase API führt zu verschiedenen Änderungen in Bezug auf Themen-IDs. Themen-IDs werden in den folgenden API-Ressourcen und -Methoden verwendet:

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

    Die Änderungen an diesen Funktionen sind:

    • Seit dem 10. Februar 2017 gibt YouTube nur noch wenige Themen-IDs zurück, statt der viel detaillierteren IDs, die bisher ausgegeben wurden. Diese Gruppe unterstützter Themen identifiziert übergeordnete Kategorisierungen wie Sport oder Basketball, aber beispielsweise keine spezifischen Teams oder Spieler. Wir werden die unterstützten Themen ankündigen, damit du genügend Zeit hast, deine App auf diese Änderung vorzubereiten.

    • Alle bereits abgerufenen Freebase-Themen-IDs können bis zum 10. Februar 2017 für die Suche nach Inhalten verwendet werden. Danach können Sie jedoch nur noch die kleinere Auswahl an Themen verwenden, die im vorherigen Element ermittelt wurden, um Suchergebnisse nach Thema abzurufen.

    • Wenn Sie nach dem 10. Februar 2017 versuchen, mithilfe einer Themen-ID nach Ergebnissen zu suchen, die nicht in der kleineren Anzahl unterstützter Themen-IDs enthalten ist, gibt die API einen leeren Ergebnissatz zurück.

  • Mehrere API-Felder und Parameter werden ab dem 12. September 2016 eingestellt:

    • Mit dem Parameter home der Methode activities.list konnte ein autorisierter Nutzer den Aktivitätsfeed abrufen, der für diesen Nutzer auf der YouTube-Startseite angezeigt werden soll. Nach dem 12. September 2016 wird bei Anfragen mit diesem Parameter eine leere Liste zurückgegeben.

    • Die Attribute contentDetails.relatedPlaylists.watchHistory und contentDetails.relatedPlaylists.watchLater der Ressource channel sind nur für einen autorisierten Nutzer sichtbar, der Daten über den eigenen Kanal abruft. Nach dem 12. September 2016 gibt contentDetails.relatedPlaylists.watchHistory für alle Channels den Wert HL und die Property contentDetails.relatedPlaylists.watchLater den Wert WL zurück.

      Bei Anfragen zum Abrufen von Playlist-Details (playlists.list) für den Wiedergabeverlauf oder die Playlist "Später ansehen" eines Kanals wird nach dem 12. September 2016 eine leere Liste zurückgegeben. Bei Anfragen zum Abrufen von Playlist-Elementen (playlistItems.list) in einer dieser Playlists wird nach diesem Zeitraum ebenfalls eine leere Liste zurückgegeben. Dies gilt für die neuen Werte HL und WL sowie für alle IDs des Wiedergabeverlaufs oder der Playlist-IDs der "Später ansehen", die dein API-Client möglicherweise bereits gespeichert hat.

    • Das fileDetails.recordingLocation-Objekt der Ressource video und alle untergeordneten Attribute werden nach dem 12. September 2016 nicht mehr zurückgegeben. Diese Daten können nur vom Rechteinhaber 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:

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

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

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

31. Mai 2016

Dieses Update enthält die folgenden Änderungen:

  • Der neue myRecentSubscribers-Parameter der Methode subscriptions.list ruft eine Liste der Abonnenten des Kanals des authentifizierten Nutzers ab. Diese Liste ist in umgekehrter chronologischer Reihenfolge der Zeit, zu der der Nutzer den Kanal abonniert hat, geordnet.

    Beachte, dass der neue Parameter nur den Abruf der letzten 1.000 Abonnenten des Kanals des authentifizierten Nutzers unterstützt. Eine vollständige Liste der Abonnenten kannst du mit dem Parameter mySubscribers abrufen. Dieser Parameter, der keine Abonnenten in einer bestimmten Reihenfolge zurückgibt, beschränkt nicht die Anzahl der abzurufenden Abonnenten.

  • Die Definition der Eigenschaft snippet.thumbnails.(key) wurde für die Ressourcen activity, playlistItem, playlist, Suchergebnis, thumbnail und video aktualisiert, um zu verdeutlichen, dass für einige Videos zusätzliche Bildgrößen für Miniaturansichten verfügbar sind.

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

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

  • Die Methode videos.list gibt jetzt einen verbotenen Fehler (403) zurück, wenn eine nicht ordnungsgemäß autorisierte Anfrage versucht, die Teile fileDetails, processingDetails oder suggestions einer Ressource vom Typ video abzurufen. Diese Teile sind nur für den Rechteinhaber des Videos verfügbar.

17. Mai 2016

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

Für jede Methode zeigt das Tool Codebeispiele für einen oder mehrere Anwendungsfälle an. Beispielsweise bietet sie fünf Code-Snippets für die Methode search.list:

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

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

Schließlich zeigt das Tool die API-Antwort auf jede Anfrage an. Wenn Sie die Anfrageparameter geändert haben, basiert die API-Antwort auf Ihren 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 Ressource video gibt das Projektionsformat des Videos an. Gültige Attributwerte sind 360 und rectangular.

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

    • Die Property recordingDetails.location gibt den Standort an, den der Videoeigentümer mit dem Video verknüpfen möchte. Dieser Speicherort kann in öffentlichen Videos bearbeitet werden, kann dort gesucht werden und kann Nutzern auch bei öffentlichen Videos angezeigt werden.
    • Der fileDetails.recordingLocation-Eigenschaftswert ist unveränderlich und steht für den Speicherort, der der hochgeladenen Originalvideodatei zugeordnet ist. Der Wert ist nur für den Videoinhaber sichtbar.

  • Die Definition des Attributs contentDetails.relatedPlaylists.favorites der Ressource channel wurde aktualisiert, um zu beachten, dass der Attributwert möglicherweise eine Playlist-ID enthält, die auf eine leere Playlist verweist und nicht abgerufen werden kann. Das liegt daran, dass die Funktion „Favoriten“ bereits eingestellt wurde. Beachten Sie, dass diese Eigenschaft nicht der Richtlinie zur Einstellung von APIs unterliegt.

  • Die Definition des Fehlers ineligibleAccount, der von der Methode comments.insert, comments.update, commentThreads.insert oder commentThreads.update zurückgegeben werden kann, wurde aktualisiert, um anzugeben, dass der Fehler auftritt, wenn das zum Autorisieren der API-Anfrage verwendete YouTube-Konto nicht mit dem Google-Konto des Nutzers zusammengeführt wurde.

20. April 2016

Dieses Update enthält die folgenden Änderungen:

  • Die Definition des Parameters part der Methode channels.update wurde aktualisiert, um zu verdeutlichen, dass localizations auch ein gültiger Wert für diesen Parameter ist.

  • Der Abschnitt Kontingentnutzung im Startleitfaden wurde aktualisiert und enthält nun einen Link zur Google Developers Console, in der Sie Ihre tatsächliche Kontingent- und Kontingentnutzung sehen können.

16. März 2016

Dieses Update enthält die folgenden Änderungen:

  • Updates für vorhandene Ressourcen und Methoden

    • Die channelBanner-Ressourcendokumentation wurde aktualisiert, da die empfohlene Größe für das hochgeladene Kanalbannerbild 2560 x 1440 Pixel beträgt. Die Mindestgröße (2048 x 1152 Pixel) hat sich nicht geändert.

    • Das neue Attribut snippet.customUrl der Ressource channel gibt die mit dem Kanal verknüpfte benutzerdefinierte URL an. Nicht alle Kanäle haben benutzerdefinierte URLs. In der YouTube-Hilfe erfährst du, welche Voraussetzungen du erfüllen musst, um eine benutzerdefinierte URL zu erhalten, und wie du die URL einrichtest.

    • Das brandingSettings.watch-Objekt der Ressource channel und alle untergeordneten Attribute wurden eingestellt.

    • Die API-Antwort auf eine search.list-Anfrage enthält jetzt das Attribut regionCode. Die Property gibt den Regionscode an, der für die Suchanfrage verwendet wurde. Der Regionscode weist die API an, Suchergebnisse für das angegebene Land zurückzugeben.

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

    • Die Definitionen der Attribute snippet.label und snippet.secondaryReasons[].label der Ressource videoAbuseReportReason wurden aktualisiert. Sie enthalten nun lokalisierten Labeltext für die Gründe des Missbrauchsberichts.

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

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

      Darüber hinaus unterstützen API-Eigenschaften für andere Bewertungssysteme die folgenden neuen Eigenschaftswerte:

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

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

    • Das Attribut status.rejectionReason der Ressource video unterstützt den neuen Attributwert legal.

  • Die API unterstützt die folgenden neuen Fehler:

    Fehlertyp Fehlerdetails Beschreibung
    badRequest (400) notEditable Die Methoden channelSections.insert, channelSections.update und channelSections.delete geben diesen Fehler zurück, um anzuzeigen, dass der angegebene Kanalabschnitt nicht erstellt, aktualisiert oder gelöscht werden kann.
    badRequest (400) styleRequired Die Methoden channelSections.insert und channelSections.update geben diesen Fehler zurück, um anzugeben, dass die in der API-Anfrage eingereichte Ressource channelSection einen Wert für das Attribut snippet.style angeben muss.
    badRequest (400) typeRequired Die Methoden channelSections.insert und channelSections.update geben diesen Fehler zurück, um anzugeben, dass die in der API-Anfrage eingereichte Ressource channelSection einen Wert für das Attribut snippet.type angeben muss.
    badRequest (400) processingFailure Die Methode commentThreads.list gibt diesen Fehler zurück, um anzugeben, dass der API-Server die Anfrage nicht verarbeiten konnte. Dies kann zwar ein vorübergehender Fehler sein, weist jedoch in der Regel darauf hin, dass die Anfrageeingabe ungültig ist. Prüfen Sie die Struktur der Ressource commentThread im Anfragetext auf Gültigkeit.
    forbidden (403) commentsDisabled Die Methode commentThreads.list gibt diesen Fehler zurück, um anzuzeigen, dass für das durch den Parameter videoId angegebene Video Kommentare deaktiviert sind.
    badRequest (400) commentTextTooLong Die Methode commentThreads.insert gibt diesen Fehler zurück, um anzuzeigen, dass die eingefügte Ressource comment zu viele Zeichen im Attribut snippet.topLevelComment.snippet.textOriginal enthält.
    invalidValue (400) videoAlreadyInAnotherSeriesPlaylist Die Methode playlistItems.insert gibt diesen Fehler zurück, um anzuzeigen, dass sich das Video, das du der Playlist hinzufügen möchtest, bereits in einer anderen Serienplaylist befindet. Weitere Informationen zu Serien-Playlists findest du in der YouTube-Hilfe.
    badRequest (400) subscriptionForbidden Die Methode subscriptions.insert gibt diesen Fehler zurück, um anzuzeigen, dass Sie die maximale Anzahl von Abos erreicht oder zu viele neue Abos erstellt haben. Im letzteren Fall können Sie die Anfrage nach einigen Stunden wiederholen.
    badRequest (400) invalidCategoryId Die Methode videos.update gibt diesen Fehler zurück, um anzugeben, dass das Attribut snippet.categoryId in der hochgeladenen video-Ressource eine ungültige Kategorie-ID angegeben hat. Verwenden Sie die Methode videoCategories.list, um unterstützte Kategorien abzurufen.
    badRequest (400) invalidDescription Die Methode videos.update gibt diesen Fehler zurück, um anzugeben, dass das Attribut snippet.description in der hochgeladenen video-Ressource einen ungültigen Wert angegeben hat.
    badRequest (400) invalidPublishAt Die Methode videos.update gibt diesen Fehler zurück, um anzugeben, dass für das Attribut status.publishAt in der hochgeladenen Ressource video ein ungültiger Zeitpunkt für die geplante Veröffentlichung angegeben ist.
    badRequest (400) invalidRecordingDetails Die Methode videos.update gibt diesen Fehler zurück, um anzugeben, dass das recordingDetails-Objekt in der hochgeladenen video-Ressource ungültige Aufnahmedetails angegeben hat.
    badRequest (400) invalidTags Die Methode videos.update gibt diesen Fehler zurück, um anzugeben, dass das Attribut snippet.tags in der hochgeladenen video-Ressource einen ungültigen Wert angegeben hat.
    badRequest (400) invalidTitle Die Methode videos.update gibt diesen Fehler zurück, um anzugeben, dass die Eigenschaft snippet.title in der hochgeladenen video-Ressource einen ungültigen oder leeren Videotitel angegeben hat.
    badRequest (400) invalidVideoMetadata Die Methode videos.update gibt diesen Fehler zurück, um anzuzeigen, dass die Anfragemetadaten ungültig sind. Dieser Fehler tritt auf, wenn die Anfrage den snippet-Teil einer video-Ressource aktualisiert, aber keinen Wert für die Attribute snippet.title und snippet.categoryId festlegt.

18. Dezember 2015

Die Gesetze der Europäischen Union (EU) schreiben vor, dass Endnutzern in der EU bestimmte Informationen offengelegt und ihre Einwilligungen eingeholt werden müssen. Für Endnutzer in der Europäischen Union müssen Sie daher die Richtlinie zur Einwilligung der Nutzer in der EU einhalten. Diese Anforderung wurde den Nutzungsbedingungen für die YouTube API hinzugefügt.

19. November 2015

Die API unterstützt jetzt die Möglichkeit, lokalisierten Text für die Attribute snippet.title und snippet.description der Ressourcen playlist und video, das Attribut snippet.title der Ressource channelSection und das Attribut snippet.description der Ressource channel festzulegen und abzurufen.

  • Lokalisierte Titel und Beschreibungen festlegen

    Sie können lokalisierte Werte für eine Ressource festlegen, wenn Sie die Methode insert oder update für diese Ressource aufrufen. Um lokalisierte Werte für eine Ressource festzulegen, führen Sie die beiden folgenden Schritte aus:

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

      Hinweis zum Aktualisieren von channel-Ressourcen: Um das Attribut snippet.defaultLanguage für eine Ressource vom Typ channel festzulegen, müssen Sie tatsächlich das Attribut brandingSettings.channel.defaultLanguage aktualisieren.

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

      Im folgenden Beispiel-Snippet wird die Standardsprache der Ressource auf Englisch festgelegt. Außerdem werden einem Video lokalisierte deutsche und spanische Titel und Beschreibungen hinzugefügt:

      {
  "kind": "youtube#video",
  ...
  "snippet": {
    "title": "Playing soccer",
    "description": "We play soccer in the park on Sundays.",
    "defaultLanguage": "en",
    ...
  },
  "localizations":
    "de": {
      "title": "Fußball spielen",
      "description": "Wir spielen Fußball im Park am Sonntag"
    },
    "es": {
      "title": "Jugar al fútbol",
      "description": "Nosotros jugamos fútbol en el parque los domingos",
    }
  }
}

      • Wichtig:Wenn Sie die lokalisierten Daten für eine Ressource aktualisieren, muss Ihre API-Anfrage alle vorhandenen lokalisierten Versionen der Daten enthalten. Wenn du beispielsweise eine nachfolgende Anfrage zum Hinzufügen portugiesischer Daten zum Video im obigen Beispiel gesendet hast, muss die Anfrage die lokalisierten Daten für Deutsch, Spanisch und Portugiesisch enthalten.

  • Lokalisierte Werte abrufen

    Die API unterstützt zwei Möglichkeiten zum Abrufen lokalisierter Werte für eine Ressource:

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

      Angenommen, eine videos.list-Anfrage hat Daten für das oben beschriebene Video mit lokalisierten deutschen und spanischen Daten abgerufen. Wenn der Parameter hl auf de gesetzt wird, enthält die Ressource die folgenden Daten:

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

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

      Wichtig:Der Parameter hl unterstützt nur Werte zur Identifizierung von Anwendungssprachen, die von der YouTube-Website unterstützt werden. Um festzustellen, ob lokalisierter Text für andere Sprachen verfügbar ist, musst du den localizations-Teil für die Ressource abrufen und den Filter anwenden, um festzustellen, ob der lokalisierte Text vorhanden ist.

      Beispielsweise musst du die vollständige Liste der Lokalisierungen abrufen, um festzustellen, ob lokalisierter Text in Appalachen-Englisch verfügbar ist.

    • Füge beim Abrufen einer Ressource localizations in den Parameterwert part ein, um alle lokalisierten Details für diese Ressource abzurufen. Wenn du lokalisierte Daten für eine Sprache abrufst, die keine aktuelle Sprache für die YouTube-Anwendung ist, musst du auf diese Weise alle Lokalisierungen abrufen und dann mithilfe von Filtern ermitteln, ob die gewünschten lokalisierten Daten vorhanden sind.

  • Fehler im Zusammenhang mit lokalisierten Textwerten

    Die API unterstützt außerdem die folgenden neuen Fehler für lokalisierte Textwerte:

    Fehlertyp Fehlerdetails Beschreibung
    badRequest (400) defaultLanguageNotSetError Dieser Fehler weist darauf hin, dass eine Anfrage, die versucht, das localizations-Objekt für eine Ressource einzufügen oder zu aktualisieren, fehlschlägt, weil das Attribut snippet.defaultLanguage für diese Ressource nicht festgelegt ist. Dieser Fehler wird von den Methoden channels.update, channelSections.insert, channelSections.update, playlists.insert, playlists.update, videos.insert und videos.update unterstützt.
    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. Dieser Fehler wird von den Methoden channels.update, channelSections.insert, channelSections.update, playlists.insert und playlists.update unterstützt.

4. November 2015

Dieses Update enthält die folgenden Änderungen:

  • Updates für vorhandene Ressourcen und Methoden

    • Der order-Parameter der search.list-Methode wurde aktualisiert. Wenn du Liveübertragungen nach viewCount sortierst, werden die API-Ergebnisse danach sortiert. Anzahl gleichzeitiger Zuschauer während der Übertragung

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

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

      Diese Änderung entspricht nicht einem veränderten API-Verhalten.

    • Die Definition des Attributs status.publishAt der Ressource video wurde aktualisiert, um Folgendes zu beachten:

      • Wenn du den Wert dieses Attributs beim Aufrufen der videos.update-Methode festlegst, musst du auch den status.privacyStatus-Eigenschaftswert auf private setzen, selbst wenn das Video bereits privat ist.
      • Wenn die Veröffentlichung eines Videos durch die Anfrage zu einem früheren Zeitpunkt geplant wird, wird es sofort veröffentlicht. Wenn du die Eigenschaft status.publishAt auf ein Datum und eine Uhrzeit in der Vergangenheit setzt, hat das dieselbe Auswirkung wie beim Ändern der privacyStatus des Videos von private zu public.

    • Die Eigenschaft contentDetails.contentRating.cncRating der Ressource video gibt die Einstufung des Videos gemäß der französischen Kommission zur Klassifikation der Kinotografie an. Diese Eigenschaft ersetzt die inzwischen eingestellte Eigenschaft contentDetails.contentRating.fmocRating.

    • Die Definition für brandingSettings.channel.keywords der Ressource channel wurde aktualisiert, damit klar ist, dass der Attributwert wie zuvor dokumentiert eine durch Leerzeichen getrennte Liste von Strings und keine durch Kommas getrennte Liste enthält. Diese Aktualisierung spiegelt keine Änderung des API-Verhaltens wider.

    • Die Dokumentation für die Methode thumbnails.set wurde aktualisiert, um deutlich zu machen, dass der Text der Anfrage das Thumbnail-Bild enthält, das du hochlädst und mit einem Video verknüpfst. Der Anfragetext enthält keine thumbnail-Ressource. Zuvor wurde in der Dokumentation angegeben, dass Sie beim Aufrufen dieser Methode keinen Anfragetext angeben sollten. Diese Aktualisierung spiegelt keine Änderung des API-Verhaltens wider.

    • Die Beschreibung der Ressource activity wurde aktualisiert, um zu verdeutlichen, dass die activities.list-Methode derzeit keine Ressourcen zu neuen Videokommentaren 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-AntwortcodebadRequest (400)
      GrundinvalidMetadata
      BeschreibungDie Eigenschaft kind entspricht nicht dem angegebenen ID-Typ.
      commentThreads.update
      comments.insert
      comments.update
      HTTP-AntwortcodebadRequest (400)
      GrundcommentTextTooLong
      BeschreibungDie Ressource comment, die eingefügt oder aktualisiert wird, enthält zu viele Zeichen im Attribut snippet.topLevelComment.snippet.textOriginal.
      playlistItems.insert
      playlistItems.update
      HTTP-Antwortcodeforbidden (403)
      GrundplaylistItemsNotAccessible
      BeschreibungDie Anfrage ist nicht ordnungsgemäß zum Einfügen, Aktualisieren oder Löschen des angegebenen Playlist-Elements autorisiert.
      playlists.delete
      playlists.insert
      playlists.update
      HTTP-AntwortcodebadRequest (400)
      GrundplaylistForbidden
      BeschreibungDieser Vorgang ist verboten oder die Anfrage ist nicht korrekt autorisiert.
      search.list
      HTTP-AntwortcodebadRequest (400)
      GrundinvalidLocation
      BeschreibungDer Wert des Parameters location und/oder locationRadius wurde falsch formatiert.
      search.list
      HTTP-AntwortcodebadRequest (400)
      GrundinvalidRelevanceLanguage
      BeschreibungDer Parameterwert „relevanceLanguage“ wurde falsch formatiert.
      subscriptions.insert
      HTTP-AntwortcodebadRequest (400)
      GrundsubscriptionForbidden
      BeschreibungDieser Fehler tritt auf, wenn einer der folgenden Punkte zutrifft:
      • Das Abo, das Sie erstellen möchten, ist bereits vorhanden
      • Du hast die maximale Anzahl an Abos bereits erreicht
      • Du versuchst, deinen eigenen Kanal zu abonnieren. Dies wird nicht unterstützt.
      • Sie haben in letzter Zeit zu viele Abos erstellt und müssen einige Stunden warten, bevor Sie die Anfrage wiederholen können.
      videos.update
      HTTP-AntwortcodebadRequest (400)
      GrundinvalidDefaultBroadcastPrivacySetting
      BeschreibungBei der Anfrage wird versucht, eine ungültige Datenschutzeinstellung für den Standard-Broadcast festzulegen.

28. August 2015

Dieses Update enthält die folgenden Änderungen:

  • Updates für vorhandene Ressourcen und Methoden

    • Das Attribut statistics.favoriteCount der Ressource video wurde verworfen.

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

7. August 2015

Dieses Update enthält die folgenden Änderungen:

  • Updates für vorhandene Ressourcen und Methoden

    • Die Definition des Attributs snippet.tags[] der Ressource video wurde aktualisiert, um weitere Informationen dazu bereitzustellen, wie der API-Server die Länge des Attributwerts berechnet. Beachten Sie, dass diese Aktualisierung keine Änderung des Verhaltens der API widerspiegelt.

      Insbesondere wird in der Definition Folgendes erklärt: Wenn ein Tag ein Leerzeichen enthält, behandelt der API-Server den Tag-Wert so, als wäre er in Anführungszeichen gesetzt, und die Anführungszeichen werden auf die Zeichenbeschränkung angerechnet. Zum Zweck der Zeichenbeschränkung enthält das Tag Foo-Baz also sieben Zeichen, während das Tag Foo Baz neun Zeichen enthält.

    • Die Methode commentThreads.insert unterstützt den Parameter shareOnGooglePlus nicht mehr, der zuvor angegeben hat, ob ein Kommentar und Antworten auf diesen Kommentar auch im Google+ Profil des Autors gepostet werden sollen. Wird der Parameter von einer Anfrage gesendet, ignoriert der API-Server den Parameter, verarbeitet die Anfrage aber ansonsten.

18. Juni 2015

Dieses Update enthält die folgenden Änderungen:

  • Updates für vorhandene Ressourcen und Methoden

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

    • Die neue Eigenschaft snippet.defaultAudioLanguage der Ressource video gibt die Sprache an, die im Standard-Audiotrack des Videos gesprochen wird.

    • Die Definition der Eigenschaft contentDetails.licensedContent der Ressource video wurde aktualisiert, um klarzustellen, dass die Inhalte ursprünglich auf einen Kanal hochgeladen worden sein müssen, der mit einem YouTube-Inhaltspartner verknüpft ist, und dann von diesem Partner Anspruch erhoben haben muss. Dies stellt keine Änderung des tatsächlichen API-Verhaltens dar.

    • Die Methoden captions.delete, captions.download, captions.insert, captions.list und captions.update unterstützen jetzt den Parameter onBehalfOfContentOwner, der bereits für mehrere andere Methoden unterstützt wird. Anfragen, die diese Methode verwenden, müssen ebenfalls 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-AntwortcodebadRequest (400)
      GrundemailNotVerified
      BeschreibungDer Nutzer muss seine E-Mail-Adresse bestätigen, bevor er das Video bewerten kann.
      videos.rate
      HTTP-AntwortcodebadRequest (400)
      GrundvideoPurchaseRequired
      BeschreibungLeihvideos 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 Ressource videoAbuseReportReason enthält Informationen zu einem Grund, warum ein Video gemeldet werden könnte, weil es missbräuchliche Inhalte enthält. Mit der Methode videoAbuseReportReasons.list kannst du eine Liste aller Gründe abrufen, aus denen Videos gemeldet werden können.

    • Mit der neuen videos.reportAbuse-Methode kannst du Videos melden, die missbräuchliche Inhalte enthalten. Der Text der Anfrage enthält ein JSON-Objekt, das das gemeldete Video sowie den Grund für missbräuchliche Inhalte angibt. Zulässige Gründe können über die oben beschriebene videoAbuseReportReason.list-Methode abgerufen werden.

      Der Migrationsleitfaden wurde aktualisiert und enthält ein Beispiel für die Meldung eines missbräuchlichen Videos. Durch diese Änderung unterstützt die API V3 jetzt alle API-Funktionen der Version 2, die voraussichtlich unterstützt werden. Diese Funktionen werden auch im Migrationsleitfaden erläutert.

  • Updates für vorhandene Ressourcen und Methoden

    • Der neue Filterparameter forDeveloper der Methode search.list beschränkt die Suche auf Videos, 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 der App des Entwicklers in der Google Developers Console zugeordnet ist.

      Wird der forDeveloper-Parameter anschließend durch eine Suchanfrage auf true gesetzt, identifiziert der API-Server den Entwickler anhand der Autorisierungsanmeldedaten der Anfrage. Daher kann ein Entwickler die Ergebnisse auf Videos beschränken, die über die eigene App oder Website des Entwicklers hochgeladen wurden, aber nicht auf Videos, die über andere Apps oder Websites hochgeladen wurden.

      Die neue Funktion bietet ähnliche, wenn auch nicht identische Funktionen für Entwickler-Tags, die von Version 2 der API unterstützt wurden.

    • Mit der neuen snippet.country-Eigenschaft der channel-Ressource können Kanalinhaber ihre Kanäle mit einem bestimmten Land verknüpfen.

      Hinweis: Um das Attribut snippet.country für eine channel-Ressource festzulegen, müssen Sie tatsächlich das Attribut brandingSettings.channel.country aktualisieren.

    • Die API unterstützt jetzt das Targeting für channelSection-Ressourcen. Mit Kanalabschnitts-Targeting können Sie die Sichtbarkeit eines Inhaltsbereichs auf Nutzer beschränken, die bestimmte Kriterien erfüllen.

      Die API bietet drei Targeting-Optionen. Ein Nutzer muss alle Ausrichtungseinstellungen erfüllen, damit ein Channelbereich sichtbar ist.

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

    • Die Dokumentation für die Methoden channelSections.delete, playlistItems.delete, playlists.delete, subscriptions.delete und videos.delete wurde so korrigiert, dass sie alle den HTTP-Antwortcode 204 (No Content) zurückgeben, wenn der Vorgang erfolgreich war.

  • Neue und aktualisierte Fehler

    • Die API unterstützt jetzt die folgenden Fehler:

      Fehlertyp Fehlerdetails Beschreibung
      badRequest (400) targetInvalidCountry Die Methoden channelSections.insert und channelSections.update geben diesen Fehler zurück, wenn die eingefügte Ressource channelSection einen ungültigen Wert für das Attribut targeting.countries[] enthält.
      badRequest (400) targetInvalidLanguage Die Methoden channelSections.insert und channelSections.update geben diesen Fehler zurück, wenn die eingefügte Ressource channelSection einen ungültigen Wert für das Attribut targeting.languages[] enthält.
      badRequest (400) targetInvalidRegion Die Methoden channelSections.insert und channelSections.update geben diesen Fehler zurück, wenn die eingefügte Ressource channelSection einen ungültigen Wert für das Attribut targeting.regions[] enthält.
      badRequest (400) operationNotSupported Die Methode comments.insert gibt diesen Fehler zurück, wenn der API-Nutzer keinen Kommentar als Antwort auf den Kommentar der obersten Ebene einfügen kann, der durch die Eigenschaft snippet.parentId gekennzeichnet ist. In einer commentThread-Ressource gibt das Attribut snippet.canReply an, ob der aktuelle Betrachter auf den Thread antworten kann.
      badRequest (400) invalidChannelId Die Methode search.list gibt diesen Fehler zurück, wenn der channelId-Parameter in der Anfrage eine ungültige Kanal-ID angibt.
      badRequest (400) subscriptionForbidden Die Methode subscriptions.insert gibt diesen Fehler zurück, wenn der API-Nutzer versucht, den eigenen Kanal zu abonnieren.

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

16. April 2015

Dieses Update enthält die folgenden Änderungen:

  • Das Migrationshandbuch wurde aktualisiert, um zu erklären, wie Anwendungen migriert werden, die noch die Kommentarfunktion von Version 2 der API verwenden.

    In diesem Leitfaden werden auch verschiedene Kommentarfunktionen aufgeführt, die von der API v2 nicht unterstützt wurden, aber in der API v3 unterstützt werden. Dazu gehören:

    • Kommentare zu einem Kanal abrufen
    • Alle Kommentarthreads abrufen, die sich auf einen Kanal beziehen, d. h., die API-Antwort kann Kommentare zum Kanal oder zu seinen Videos enthalten.
    • Den Text eines Kommentars aktualisieren
    • Kommentare als Spam markieren
    • Moderationsstatus eines Kommentars festlegen

  • Der Leitfaden Push-Benachrichtigungen abonnieren wurde aktualisiert, um der Tatsache Rechnung zu tragen, dass Benachrichtigungen nur an den Google PubSubHubBub-Hub und nicht an den Superfeedr-Hub gesendet werden.

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-Kommentarthread, der einen Kommentar auf oberster Ebene und, falls vorhanden, Antworten auf diesen Kommentar umfasst. Eine commentThread-Ressource kann Kommentare zu einem Video oder einem Kanal darstellen.

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

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

      • commentThreads.list – Ruft eine Liste von Kommentarthreads ab. Mit dieser Methode kannst du Kommentare zu einem bestimmten Video oder Kanal abrufen.
      • commentThreads.insert – Erstellt einen neuen Kommentar auf oberster Ebene. (Verwenden Sie die Methode comments.insert, um auf einen vorhandenen Kommentar zu antworten.)
      • commentThreads.update: Hiermit kannst du 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. Der Kommentar kann auch ein Kommentar auf oberster Ebene oder die Antwort auf einen Kommentar der obersten Ebene sein.

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

      • comments.list: Ruft eine Kommentarliste ab. Mit dieser Methode kannst du alle Antworten auf einen bestimmten Kommentar abrufen.
      • comments.insert: Eine Antwort auf einen vorhandenen Kommentar erstellen.
      • comments.update: Kommentar ändern
      • comments.markAsSpam: Hiermit kannst du einen oder mehrere Kommentare als Spam melden.
      • comments.setModerationStatus: Hier legen Sie den Moderationsstatus für einen oder mehrere Kommentare fest. Du kannst beispielsweise einen Kommentar löschen, damit er öffentlich angezeigt wird, oder ihn ablehnen, sodass er nicht angezeigt werden kann. Die API-Anfrage muss vom Inhaber des Kanals oder Videos autorisiert werden, das mit den Kommentaren verknüpft ist.
      • comments.delete: Löscht einen Kommentar.

    Beachten Sie, dass der neue https://www.googleapis.com/auth/youtube.force-ssl-Bereich der API, der im Überarbeitungsverlauf am 2. April 2015 beschrieben wird, für Aufrufe der Methoden comments.insert, comments.update, comments.markAsSpam, comments.setModerationStatus, comments.delete, commentThreads.insert und commentThreads.update erforderlich ist.

  • Im neuen Leitfaden Push-Benachrichtigungen abonnieren wird die neue Unterstützung der API für Push-Benachrichtigungen über PubSubHubBub erläutert, ein Server-zu-Server-Veröffentlichungs-/Subscribe-Protokoll für über das Web zugängliche Ressourcen. Ihr PubSubHubBub-Callback-Server kann Atom-Feed-Benachrichtigungen empfangen, wenn ein Kanal eine der folgenden Aktivitäten ausführt:

    • lädt ein Video hoch.
    • aktualisiert den Titel eines Videos
    • aktualisiert die Beschreibung eines Videos

  • Der Migrationsleitfaden wurde ebenfalls aktualisiert, um auf die neue Unterstützung von Push-Benachrichtigungen hinzuweisen. Da die API V2 jedoch zahlreiche andere Push-Benachrichtigungstypen unterstützt hat, die in der API V3 nicht unterstützt werden, ist die Erwähnung der PubSubHubBub-Unterstützung weiterhin im Abschnitt Verworfen 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 Bereich https://www.googleapis.com/auth/youtube 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 enthielt.

  • Die Methode subscriptions.insert unterstützt den Fehler subscriptionLimitExceeded nicht mehr, der zuvor angegeben hatte, dass der mit der Anfrage identifizierte Abonnent die Ratenbegrenzung für Abos überschritten hat.

2. April 2015

Dieses Update enthält die folgenden Änderungen:

  • Die neue Ressource captions steht für einen YouTube-Untertiteltrack. Ein Untertiteltrack ist genau einem YouTube-Video zugeordnet.

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

  • Die Migrationsanleitung wurde ebenfalls aktualisiert und erklärt, wie du Anwendungen migrieren kannst, die in Version 2 der API noch die Untertitelfunktion nutzen.

  • Der neue https://www.googleapis.com/auth/youtube.force-ssl-Bereich der API erfordert die Kommunikation mit dem API-Server über eine SSL-Verbindung.

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

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

11. März 2015

Dieses Update enthält die folgenden Änderungen:

  • Die Migrationsanleitung für die YouTube Data API (Version 3) enthält den neuen Tab Neu in Version 3 der API, auf dem Funktionen aufgeführt werden, die von Version 3 der API und von Version 2 nicht unterstützt werden. Die gleichen Funktionen waren zuvor und sind weiterhin auf anderen Tabs in der Übersicht aufgeführt. Die neue Funktion zum Aktualisieren der In-Video-Kampagnendaten eines Kanals ist beispielsweise auch auf dem Tab Kanäle (Profile) aufgeführt.

  • Die Migrationsanleitung für die YouTube Data API (Version 3) wurde mit dem Hinweis aktualisiert, dass Version 3 der API die folgende API-Funktion der Version 2 unterstützt:

  • Die Migrationsanleitung für die YouTube Data API (Version 3) wurde mit dem Hinweis aktualisiert, dass die folgenden Funktionen der API v2 in der API v3 nicht unterstützt werden:

    • Videoempfehlungen abrufen: Version 3 der API ruft keine Liste ab, die nur Videos enthält, die für den aktuellen API-Nutzer empfohlen werden. Du kannst jedoch mit der API v3 nach empfohlenen Videos suchen, indem du die Methode activities.list aufrufst und den Parameterwert home auf true setzt.

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

    • Kanalvorschläge abrufen

    • Neue abonnierte Videos abrufen: Die API Version 3 ruft keine Liste ab, die nur Videos enthält, die kürzlich in Kanäle hochgeladen wurden, die der API-Nutzer abonniert hat. Du kannst jedoch Version 3 der API verwenden, um neue Abovideos zu finden, indem du die Methode activities.list aufrufst und den Parameterwert home auf true setzt.

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

    • Unterstützung von RSS-Feeds

    • Push-Benachrichtigungen für Feedaktualisierungen: Die API Version 2 unterstützte Push-Benachrichtigungen und nutzte entweder das Simple Update Protocol (SUP) oder PubSubHubbub, um die Feeds der Nutzeraktivitäten für YouTube-Nutzer zu überwachen. Benachrichtigungen wurden für neue Kanalabos und für Videos gesendet, die bewertet, geteilt, als Favoriten markiert, kommentiert oder hochgeladen wurden.

      Version 3 der API unterstützt Push-Benachrichtigungen mithilfe des PubSubHubbub-Protokolls, aber die Benachrichtigungen beziehen sich nur auf Videouploads und Aktualisierungen von Videotiteln oder Videobeschreibungen.

    • Kanalstandort: Version 2 der API hat das Tag <yt:location> verwendet, um den im öffentlichen YouTube-Profil des Kanals eingegebenen Standort des Nutzers zu identifizieren. Einige Entwickler haben dieses Feld zwar verwendet, um einen Kanal mit einem bestimmten Land zu verknüpfen, die Daten des Felds konnten jedoch nicht konsistent für diesen Zweck verwendet werden.

    • Entwickler-Tags festlegen oder abrufen: Version 2 der API unterstützte die Möglichkeit, Keywords oder Entwickler-Tags mit einem Video zu verknüpfen, als das Video hochgeladen wurde. Entwickler-Tags werden YouTube-Nutzern nicht angezeigt, aber Videoinhaber können Videos abrufen, die mit einem bestimmten Entwickler-Tag übereinstimmen.

      Version 3 des APIs bietet eine ähnliche, aber nicht identische Funktion. Insbesondere 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 der App des Entwicklers in der Google Developers Console zugeordnet ist. Der Entwickler verwendet dann dieselbe Projektnummer, um nach Videos zu suchen.

    • Videos nach Veröffentlichungsdatum, Anzahl der Aufrufe oder Bewertung auflisten: In der API Version 2 kannst du mit dem orderby-Parameter Videos in einer Playlist nach Position, Dauer, Veröffentlichungsdatum, Titel und verschiedenen anderen Werten sortieren. In der API v3 werden Playlist-Elemente normalerweise in aufsteigender Reihenfolge nach Positionen sortiert. Andere Sortieroptionen sind nicht verfügbar.

      Es gibt jedoch einige Ausnahmen. Ein neuer Upload, ein Favorit, ein Video mit „Mag ich“-Bewertung oder ein kürzlich angesehenes Video wird für die folgenden Playlists automatisch als erstes Element hinzugefügt (snippet.position=0). Jede dieser Listen wird also effektiv in der Reihenfolge vom neuesten zum ältesten Element sortiert, basierend auf dem Zeitpunkt, zu dem die Elemente zur Liste hinzugefügt wurden.

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

      Beachte jedoch, dass im Abschnitt "Später ansehen" Playlist wird als letztes Element zu dieser Liste hinzugefügt, sodass die Liste effektiv vom ältesten zum neuesten Element sortiert wird.

    • Batch-Verarbeitung: Version 3 der API unterstützt einen der Anwendungsfälle für die Batch-Verarbeitung, den die Version 2 der API unterstützt hat. Die Methoden channels.list, channelSections.list, guideCategories.list, playlistItems.list, playlists.list, subscriptions.list, videoCategories.list und videos.list der API-Version 3 unterstützen einen id-Parameter, mit dem eine durch Kommas getrennte Liste von IDs (Video-IDs, Kanal-IDs usw.) angegeben werden kann. Mit diesen Methoden können Sie eine Liste mehrerer Ressourcen mit einer einzigen Anfrage abrufen.

    Mit diesen Änderungen werden im Leitfaden jetzt alle Funktionen identifiziert, die in der alten API (v2) unterstützt wurden und in der aktuellen API-Version (v3) nicht mehr unterstützt werden.

4. März 2015

Dieses Update enthält die folgenden Änderungen:

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

  • Die folgenden Properties und ihre untergeordneten Properties wurden eingestellt:

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

    Hinweis:Keine dieser Properties galt der Richtlinie zur Einstellung von APIs.

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

  • Die API unterstützt jetzt die folgenden Fehler:

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

2. März 2015

Dieses Update enthält die folgenden Änderungen:

14. Januar 2015

Dieses Update enthält die folgenden Änderungen:

  • Die Migrationsanleitung für die YouTube Data API (v3) wurde aktualisiert, um zu erklären, wie du API v3 zum Hochladen von Videos mithilfe von JavaScript verwendest. Weitere Informationen findest du im Abschnitt Video hochladen. Diese Funktion ist mit der browserbasierten Uploadfunktion vergleichbar, die Version 2 der API unterstützt. Diese Änderung im Migrationsleitfaden spiegelt keine tatsächliche API-Änderung wider, sondern die Verfügbarkeit eines neuen Beispielcodes zum Hochladen von Videos mit clientseitigem JavaScript.

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

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

11. November 2014

Dieses Update enthält die folgenden Änderungen:

  • Die Kontingentkosten für einen Aufruf der Methode search.list wurden auf 100 Einheiten erhöht.

    Wichtig:In vielen Fällen können Sie andere API-Methoden verwenden, um Informationen zu niedrigeren Kontingentkosten abzurufen. Sehen wir uns als Beispiel diese beiden Möglichkeiten an, um Videos zu finden, die auf den 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 ermitteln. Setzen Sie den Parameter forUsername auf GoogleDevelopers und den Parameter part auf contentDetails. In der API-Antwort gibt die Eigenschaft contentDetails.relatedPlaylists.uploads die Playlist-ID für die hochgeladenen Videos des Kanals an.

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

8. Oktober 2014

Dieses Update enthält die folgenden Änderungen:

  • Die Ressource channel enthält zwei neue Attribute:

    • Die Eigenschaft status.longUploadsStatus gibt an, ob auf dem Kanal Videos mit einer Länge von mehr als 15 Minuten hochgeladen werden können. Diese Eigenschaft 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: Der Kanal ist berechtigt, Videos mit einer Länge von mehr als 15 Minuten hochzuladen, muss aber zuerst die Funktion aktivieren.
      • 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 auch in der YouTube-Hilfe.

    • Die Eigenschaft invideoPromotion.useSmartTiming gibt an, ob in der Werbekampagne des Kanals Smart Timing verwendet wird. Mit dieser Funktion wird versucht, Werbung an einer Stelle im Video zu zeigen, an der die Wahrscheinlichkeit höher ist, dass darauf geklickt wird und die Wiedergabe nicht gestört wird. Bei dieser Funktion wird außerdem jeweils nur eine Werbung berücksichtigt, die für jedes Video eingeblendet wird.

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

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

  • Die Eigenschaft contentDetails.contentRating.oflcRating der Ressource video, die die Bewertung eines Videos durch das neuseeländische Office of Film and Literature Classification angibt, unterstützt jetzt zwei neue Bewertungen: oflcRp13 und oflcRp16. Diese entsprechen den Bewertungen RP13 und RP16.

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

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

12. September 2014

Dieses Update enthält die folgenden Änderungen:

  • Die Kontingentkosten für einen Aufruf der Methode search.list wurden von 1 Einheit in 2 Einheiten geändert (zusätzlich zu den Kosten für die angegebenen Ressourcenteile).

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 bei der Anfrage angegebene Abonnent hat die Ratenbegrenzung für Abos überschritten. Sie können in ein paar Stunden weitere Abos ausprobieren.

12. August 2014

Dieses Update enthält die folgenden Änderungen:

  • In einer neuen Anleitung mit dem Titel Anwendung zur YouTube Data API (Version 3) migrieren wird erläutert, wie du mit der YouTube Data API (Version 3) die in der YouTube Data API (Version 2) verfügbaren Funktionen ausführen kannst. Die ältere API wurde offiziell am 4. März 2014 eingestellt. Der Leitfaden soll Sie bei der Migration von Anwendungen, die noch Version 2 der API verwenden, zur neuesten API-Version unterstützen.

8. Juli 2014

Dieses Update enthält die folgenden Änderungen:

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

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

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. In ähnlicher Weise wurden die Definitionen der part-Parameter aktualisiert, um die Kontingentkosten für jedes Teil anzugeben, das über einen API-Aufruf abgerufen werden kann. Ein Aufruf der Methode subscriptions.insert verursacht beispielsweise Kontingentkosten von etwa 50 Einheiten. Die Ressource subscription enthält ebenfalls drei Teile (snippet, contentDetails und subscriberSnippet), von denen jeder Teil Kosten in Höhe von zwei Einheiten hat.

    Bitte beachten Sie, dass sich Kontingentkosten ohne Vorwarnung ändern können.

  • Die Ressource video unterstützt inzwischen 43 neue Inhaltseinstufungssysteme, die die Einstufungen ermitteln, die Videos von verschiedenen nationalen Einstufungsstellen erhalten haben. Die neu unterstützten Bewertungssysteme sind Argentinien, Österreich, Belgien, Bulgarien, Chile (television), Chile (film), T Tschische Republik, Kolumbien, Dänemark, Ägyp, E-Ägyp, E2.} Esto Ägyp, E2.} Esto Ägyp, E2.

28. Mai 2014

Dieses Update enthält die folgenden Änderungen:

  • Die Methode search.list unterstützt jetzt die Parameter location und locationRadius, mit denen du nach Videos suchen kannst, die einem bestimmten Standort zugeordnet sind. In einer Anfrage muss ein Wert für beide Parameter angegeben werden, um Ergebnisse basierend auf dem Standort abzurufen. 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 im Mittelpunkt des kreisförmigen geografischen Bereichs an.

    • Der Parameter locationRadius gibt die maximale Entfernung an, die der mit einem Video verknüpfte Standort von der Mitte des Bereichs entfernt sein darf, damit das Video weiterhin in den Suchergebnissen angezeigt wird.

13. Mai 2014

Dieses Update enthält die folgenden Änderungen:

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

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

    • postedPlaylists: Playlists, die vom Kanalinhaber im Aktivitätsfeed des Kanals gepostet wurden
    • 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-Eigenschaft der video-Ressource gibt die Bewertung an, die ein Video vom Irish Film Classification Office erhalten hat.

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

  • Die Definition des q-Parameters für die search.list-Methode wurde aktualisiert, um zu beachten, dass der Suchbegriff den booleschen Operator NOT (-) verwenden kann, um Videos auszuschließen, die mit einem bestimmten Suchbegriff verknüpft sind. Für den Wert kann auch der boolesche ODER-Operator (|) verwendet werden, um Videos zu finden, die mit einem von mehreren Suchbegriffen verknüpft sind.

  • Die Definition des Attributs pageInfo.totalResults, die in einer API-Antwort auf einen search.list-Aufruf zurückgegeben wird, wurde aktualisiert, um zu verdeutlichen, dass es sich bei dem Wert um einen Näherungswert handelt und er möglicherweise keinen genauen Wert darstellt. Darüber hinaus beträgt der Maximalwert 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 verdeutlichen, dass die API den HTTP-Antwortcode 204 für erfolgreiche Anfragen an diese Methoden zurückgibt.

2. Mai 2014

Dieses Update enthält die folgenden Änderungen:

  • Die neue Ressource i18nLanguage identifiziert eine Anwendungssprache, die von der YouTube-Website unterstützt wird. Die Anwendungssprache kann auch als UI-Sprache bezeichnet werden. Für die YouTube-Website kann eine Anwendungssprache basierend auf den Google-Kontoeinstellungen, der Browsersprache oder dem IP-Standort automatisch ausgewählt werden. Außerdem kann der Nutzer die gewünschte UI-Sprache auch manuell über die Fußzeile der YouTube-Website auswählen.

    Die API unterstützt eine Methode zum Auflisten unterstützter Anwendungssprachen. Unterstützte Sprachen können als Wert des Parameters hl verwendet werden, wenn API-Methoden wie videoCategories.list und guideCategories.list aufgerufen werden.

  • Die neue Ressource i18nRegion gibt ein geografisches Gebiet an, das ein YouTube-Nutzer als bevorzugte Inhaltsregion auswählen kann. Der Inhaltsbereich kann auch als Inhaltssprache bezeichnet werden. Für die YouTube-Website kann anhand von Heuristiken wie der YouTube-Domain oder dem IP-Standort des Nutzers automatisch ein Content-Bereich ausgewählt werden. Außerdem kann der Nutzer die gewünschte Inhaltsregion auch manuell über die Fußzeile der YouTube-Website auswählen.

    Die API unterstützt eine Methode zum Auflisten unterstützter Inhaltsregionen. Unterstützte Regionscodes können als Wert des Parameters regionCode verwendet werden, wenn API-Methoden wie search.list, videos.list, activities.list und videoCategories.list aufgerufen werden.

7. April 2014

Dieses Update enthält die folgenden Änderungen:

  • Die neue Ressource channelSection enthält Informationen zu einer Reihe von Videos, die in einem Kanal empfohlen werden. In einem Abschnitt können beispielsweise die neuesten Uploads eines Kanals, die beliebtesten Uploads oder Videos aus einer oder mehreren Playlists enthalten sein.

    Die API unterstützt Methoden zum Auflisten, Einfügen, Aktualisieren oder Löschen von Kanalabschnitten. Sie können eine Liste mit Kanalabschnitten 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, um die von der API unterstützten Fehlermeldungen speziell für diese neuen Methoden zu beschreiben.

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

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

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

  • Die Definition des invideoPromotion-Objekts der Ressource channel wurde aktualisiert, um zu erklären, dass das Objekt nur vom Inhaber des Kanals abgerufen werden kann.

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

31. März 2014

Dieses Update enthält die folgenden Änderungen:

13. März 2014

Dieses Update enthält die folgenden Änderungen:

  • Die API unterstützt jetzt den contentOwnerDetails-Teil für channel-Ressourcen. Der neue Teil enthält Kanaldaten, die für YouTube-Partner relevant sind, die mit dem Kanal verknüpft sind. Dazu gehören die ID des Rechteinhabers, der mit dem Kanal verknüpft ist, sowie Datum und Uhrzeit der Verknüpfung zwischen Rechteinhaber und Kanal. Beachten Sie, dass dieser neue Teil nicht der Richtlinie zur Einstellung von Produkten und Diensten unterliegt.

  • In der Dokumentation wird 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. Beachten Sie, dass der Eigenschaftswert eine Liste ist und Kommas zwischen den Elementen in der Liste auf den Grenzwert angerechnet werden.

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

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

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

  • Die API unterstützt jetzt die folgenden Fehler:

    Fehlertyp Fehlerdetails Beschreibung
    badRequest (400) invalidCriteria Die Methode channels.list gibt diesen Fehler zurück, wenn in der Anfrage Filterparameter angegeben werden, die nicht in Kombination verwendet werden können.
    badRequest (400) channelTitleUpdateForbidden Die Methode channels.update gibt diesen Fehler zurück, wenn du versuchst, den brandingSettings-Teil eines Kanals zu aktualisieren und den Wert der brandingSettings.channel.title-Eigenschaft zu ändern. Die API gibt keinen Fehler zurück, wenn Sie die Eigenschaft weglassen.
    badRequest (400) invalidRecentlyUploadedBy Die Methode channels.update gibt diesen Fehler zurück, wenn die Eigenschaft invideoPromotion.items[].id.recentlyUploadedBy eine ungültige Kanal-ID angibt.
    badRequest (400) invalidTimingOffset Die Methode channels.update gibt diesen Fehler zurück, wenn der invideoPromotion-Teil einen ungültigen Zeitversatz angibt.
    badRequest (400) tooManyPromotedItems Die Methode channels.update gibt diesen Fehler zurück, wenn der invideoPromotion-Teil die zulässige Anzahl von beworbenen Artikeln überschreitet.
    forbidden (403) promotedVideoNotAllowed Die Methode channels.update gibt diesen Fehler zurück, wenn die Eigenschaft invideoPromotion.items[].id.videoId eine Video-ID angibt, die entweder nicht gefunden werden kann oder nicht als beworbenes Element verwendet werden kann.
    forbidden (403) websiteLinkNotAllowed Die Methode channels.update gibt diesen Fehler zurück, wenn die Eigenschaft invideoPromotion.items[].id.websiteUrl eine nicht zulässige URL angibt.
    required (400) requiredTimingType Die Methode channels.update gibt diesen Fehler zurück, wenn in einer Anfrage keine Standardeinstellungen für die Zeitangabe angegeben werden, wann YouTube ein beworbenes Element anzeigen soll.
    required (400) requiredTiming In der Methode channels.update muss für jedes beworbene Element ein invideoPromotion.items[].timing-Objekt angegeben werden.
    required (400) requiredWebsiteUrl In der Methode channels.update muss für jedes beworbene Element eine invideoPromotion.items[].id.websiteUrl-Eigenschaft angegeben werden.
    badRequest (400) invalidPublishAt Die Methode videos.insert gibt diesen Fehler zurück, wenn in den Anfragemetadaten ein ungültiger Zeitpunkt der geplanten Veröffentlichung angegeben ist.

4. März 2014

Dieses Update enthält die folgenden Änderungen:

5. Dezember 2013

Dieses Update enthält die folgenden Änderungen:

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

  • Die Definitionen der Parameter der Methode search.list wurden aktualisiert. Sie müssen den Wert des Parameters type auf video setzen, 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 der hochgeladenen Kanalbannerbilder wurde auf 2048 mal 1152 Pixel reduziert. Zuvor war die Mindestgröße 2.120 x 1.192 Pixel. Beachten Sie darüber hinaus, dass die channel-Ressourcendokumentation die maximalen Größen aller Bannerbilder angibt, die von der API bereitgestellt werden. Die maximale Größe des brandingSettings.image.bannerTvImageUrl-Bilds für Fernsehanwendungen beträgt beispielsweise 2.120 x 1.192 Pixel, aber das tatsächliche Bild kann 2.048 x 1.152 Pixel groß sein. In der YouTube-Hilfe findest du weitere Informationen dazu, wie du Kanalbilder für die Darstellung auf verschiedenen Gerätetypen optimieren kannst.

  • Mehrere Definitionen von channel-Ressourcenattributen wurden aktualisiert, um die folgenden Informationen widerzuspiegeln:

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

  • Die Methode channels.update unterstützt jetzt Aktualisierungen des Attributs invideoPromotion.items[].promotedByContentOwner. Diese Eigenschaft gibt an, ob der Name des Rechteinhabers bei der Anzeige der Werbung angezeigt wird. Es kann nur festgelegt werden, wenn die API-Anfrage, die den Attributwert festlegt, 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.

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

  • Die neuen Properties contentDetails.contentRating.catvRating und contentDetails.contentRating.catvfrRating identifizieren die Altersfreigaben, die ein Video nach dem kanadischen TV-Klassifizierungssystem bzw. dem französischsprachigen Altersfreigabesystem Régie du cinéma erhalten hat, das in Quebec verwendet wird.

  • Das neue Attribut snippet.assignable der Ressource videoCategory gibt an, ob aktualisierte oder neu hochgeladene Videos mit dieser Videokategorie verknüpft werden können.

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

24. Oktober 2013

Dieses Update enthält die folgenden Änderungen:

  • Die API enthält zwei zusätzliche Funktionen für das Auffinden und Präsentieren von Live-Übertragungsinhalten:

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

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

    • Das neue Attribut liveStreamingDetails der Ressource video ist ein Objekt, das Metadaten zu einer Live-Videoübertragung enthält. Zum Abrufen dieser Metadaten nehmen Sie liveStreamingDetails in die Liste der Ressourcenteile des Parameterwerts part auf. Die Metadaten enthalten die folgenden neuen Properties:

      Zum Abrufen dieser Metadaten 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 Liveübertragungen veröffentlicht: der Parameter eventType der Methode search.list und die Eigenschaft snippet.liveBroadcastContent des Suchergebnisses.

  • Die Methode videos.insert unterstützt jetzt den Parameter notifySubscribers, der angibt, ob YouTube eine Benachrichtigung über das neue Video an Nutzer senden soll, die den Kanal des Videos abonnieren. Der Standardwert des Parameters lautet True. Dies bedeutet, dass Abonnenten über neu hochgeladene Videos benachrichtigt werden. Ein Kanalinhaber, der viele Videos hochlädt, kann den Wert jedoch auf False setzen, damit die Abonnenten des Kanals nicht über jedes neue Video benachrichtigt werden.

  • Die Liste der Attribute, die beim Aufrufen der Methode channels.update geändert werden können, wurde aktualisiert und enthält jetzt die Attribute invideoPromotion.items[].customMessage und invideoPromotion.items[].websiteUrl. Außerdem wurde die Liste geändert, um die brandingSettings-Eigenschaften anzugeben, die änderbar sind. Diese brandingSettings-Attribute waren bereits änderbar, sodass die Änderung in der Dokumentation keine Änderungen an den bestehenden Funktionen der API widerspiegelt.

  • 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 der Bewertung TV-14 entspricht.

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

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

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

  • Die neue Eigenschaft invideoPromotion.items[].promotedByContentOwner der Ressource channel gibt an, ob der Name des Rechteinhabers beim Anzeigen der Werbeaktion angezeigt wird. Dieses Feld kann nur festgelegt werden, wenn die API-Anfrage, die den Wert festlegt, im Namen des Rechteinhabers gestellt wird. Weitere Informationen finden Sie im Parameter onBehalfOfContentOwner.

1. Oktober 2013

Dieses Update enthält die folgenden Änderungen:

  • Das neue auditDetails-Objekt der Ressource channel enthält Kanaldaten, die ein Multi-Channel-Netzwerk (MCN) auswerten würde, um zu entscheiden, ob ein bestimmter Kanal akzeptiert oder abgelehnt wird. Beachten Sie, dass jede API-Anfrage, die diesen Ressourcenteil abruft, ein Autorisierungstoken bereitstellen muss, das den Bereich https://www.googleapis.com/auth/youtubepartner-channel-audit enthält. Außerdem muss jedes Token, das diesen Geltungsbereich nutzt, widerrufen werden, wenn das MCN den Kanal akzeptiert oder ablehnt oder innerhalb von zwei Wochen nach der Ausstellung des Tokens.

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

    Standardmäßig ist der Kanal der gleiche, für den die Daten zu In-Video-Werbung festgelegt wurden. Du kannst jedoch das zuletzt hochgeladene Video eines anderen Kanals bewerben, indem du den Wert der neuen invideoPromotion.items[].id.recentlyUploadedBy-Property auf die Kanal-ID für diesen Kanal setzt.

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

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

    • Bei einer video-Ressource gibt der Wert upcoming an, dass es sich um eine Liveübertragung handelt, die noch nicht gestartet wurde. Der Wert active hingegen gibt an, dass es sich um eine laufende Liveübertragung handelt.
    • 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 darauf hinweist, dass auf dem Kanal eine laufende Liveübertragung läuft.

  • In der Ressource watermark wurde das Attribut targetChannelId von einem Objekt in einen String geändert. Statt eine untergeordnete Eigenschaft zu enthalten, die die YouTube-Kanal-ID des Kanals angibt, mit dem das Wasserzeichenbild verknüpft ist, gibt die Eigenschaft targetChannelId jetzt diesen Wert selbst an. Entsprechend wurde auch das Attribut targetChannelId.value der Ressource entfernt.

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

  • Die Methode search.list unterstützt jetzt den Parameter eventType, der die Suche auf aktive, anstehende oder abgeschlossene Übertragungsereignisse einschränkt.

  • Die neue contentDetails.contentRating.mibacRating-Property enthält die Bewertung, die ein Video vom italienischen Ministero dei Beni e delle Attivita Culturali e del Turismo erhalten hat.

  • Die API unterstützt jetzt die folgenden Fehler:

    Fehlertyp Fehlerdetails Beschreibung
    badRequest invalidImage Die Methode thumbnails.set gibt diesen Fehler zurück, wenn der bereitgestellte Bildinhalt ungültig ist.
    forbidden videoRatingDisabled Die Methode videos.rate gibt diesen Fehler zurück, wenn der Inhaber des bewerteten Videos die Altersfreigabe für dieses Video deaktiviert hat.

27. August 2013

Dieses Update enthält die folgenden Änderungen:

  • Die neue Ressource watermark identifiziert ein Bild, das während der Wiedergabe der Videos eines bestimmten Kanals angezeigt wird. Sie können auch einen Zielkanal angeben, mit dem das Bild verknüpft wird, sowie Zeitdetails, die bestimmen, wann das Wasserzeichen während der Videowiedergabe erscheint und wie lange es sichtbar ist.

    Mit der Methode watermarks.set wird das Wasserzeichen eines Kanals hochgeladen und festgelegt. Mit der Methode watermarks.unset wird das Wasserzeichen 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 Ressource channel enthält einen booleschen Wert, der angibt, ob die Anzahl der Abonnenten des Kanals ausgeblendet ist. Der Wert der Property lautet daher 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 verschiedene andere Methoden unterstützt.

  • Die Methode videos.list unterstützt jetzt den Parameter regionCode, der den Inhaltsbereich angibt, für den ein Diagramm abgerufen werden soll. Dieser Parameter kann nur in Verbindung mit dem Parameter chart verwendet werden. Der Parameterwert ist ein Alpha-2-Ländercode nach ISO 3166-1.

  • In der error documentation wird der folgende neue häufige Anfragefehler beschrieben, der bei mehreren API-Methoden auftreten kann:

    Fehlertyp Fehlerdetails Beschreibung
    forbidden insufficientPermissions Die mit dem für die Anfrage angegebenen OAuth 2.0-Tokens verknüpften Bereiche reichen für den Zugriff auf die angeforderten Daten nicht aus.

15. August 2013

Dieses Update enthält die folgenden Änderungen:

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

    • Die API unterstützt jetzt die Möglichkeit, eine Website als beworbener Artikel anzugeben. Setzen Sie dazu den Wert der invideoPromotion.items[].id.type-Eigenschaft auf website und verwenden Sie die neue invideoPromotion.items[].id.websiteUrl-Eigenschaft, um die URL anzugeben. Mit der neuen invideoPromotion.items[].customMessage-Property kannst du auch eine benutzerdefinierte Nachricht definieren, die für das Angebot angezeigt werden soll.

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

      Durch das Hinzufügen von Werbelinks erklären Sie sich damit einverstanden, dass diese Links nicht dazu verwendet werden, Zugriffe auf nicht autorisierte Websites weiterzuleiten. Außerdem erklären Sie sich damit einverstanden, dass diese Links den AdWords-Richtlinien, den YouTube-Werberichtlinien, den YouTube-Community-Richtlinien und den YouTube-Nutzungsbedingungen entsprechen.

    • Die Eigenschaften der Zeiteinstellungen für die Anzeige beworbener Artikel während der Videowiedergabe wurden umstrukturiert:

      • Das Objekt invideoPromotion.timing wurde in den Ordner invideoPromotion.items[].timing verschoben. Mit diesem Objekt kannst du jetzt die Zeitdaten für jedes beworbene Element in der invideoPromotion.items[]-Liste anpassen.

      • Das neue invideoPromotion.defaultTiming-Objekt gibt Standardeinstellungen für den zeitlichen Ablauf deiner Werbeaktion an. Mit diesen Einstellungen wird festgelegt, wann ein beworbener Artikel bei der Wiedergabe eines Videos auf deinem Kanal angezeigt wird. Mit dem invideoPromotion.items[].timing-Objekt kannst du die Standardzeit für jeden beworbenen Artikel überschreiben.

      • Die neue invideoPromotion.items[].timing.durationMs-Eigenschaft gibt an, wie lange das Angebot angezeigt werden soll (in Millisekunden). Das invideoPromotion.defaultTiming-Objekt enthält auch ein durationMs-Feld, das die Standarddauer angibt, für die das hochgestufte Element angezeigt wird.

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

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

  • In der API-Antwort auf eine thumbnails.set-Anfrage wurde der kind-Eigenschaftswert von youtube#thumbnailListResponse in youtube#thumbnailSetResponse geändert.

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

    Beachten Sie, dass auch das Python-Beispiel für die Methode playlistItems.insert entfernt wurde, da die hier gezeigte Funktionalität jetzt von der Methode videos.rate ausgeführt wird.

  • In error documentation wird der folgende neue Anfragekontextfehler beschrieben, der bei jeder API-Methode auftreten kann, die den Anfrageparameter mine unterstützt:

    Fehlertyp Fehlerdetails Beschreibung
    badRequest invalidMine Der Parameter mine kann nicht in Anfragen verwendet werden, bei denen der authentifizierte Nutzer ein YouTube-Partner ist. Du kannst entweder den mine-Parameter entfernen, dich als YouTube-Nutzer durch Entfernen des onBehalfOfContentOwner-Parameters authentifizieren oder als einer der Partnerkanäle agieren, indem du den onBehalfOfContentOwnerChannel-Parameter angibst, sofern dieser für die aufgerufene Methode verfügbar ist.

8. August 2013

Dieses Update enthält die folgenden Änderungen:

30. Juli 2013

Dieses Update enthält die folgenden Änderungen:

  • In einer channelBanner-Ressource wurde 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 hervorgehobene Farbe an, die zum Inhalt des Kanals passt. Der Eigenschaftswert besteht aus einem Pfundzeichen (#), gefolgt von einem sechsstelligen hexadezimalen String wie z. B. #2793e6.

  • Mit der API kannst du jetzt angeben, ob ein Abo für alle Aktivitäten des Kanals oder nur für neue Uploads gilt. Das neue Attribut contentDetails.activityType der Ressource subscription gibt die Aktivitätstypen an, über die der Abonnent benachrichtigt wird. Gültige Attributwerte sind all und uploads.

  • Die Methode videos.list unterstützt neue Parameter zum Abrufen eines Diagramms mit den beliebtesten Videos auf YouTube:

    • Der Parameter chart gibt das Diagramm an, das Sie abrufen möchten. Derzeit wird nur der Wert mostPopular unterstützt. Der chart-Parameter ist ein Filterparameter. Er kann also nicht in derselben Anfrage wie andere Filterparameter (id und myRating) verwendet werden.
    • Der Parameter videoCategoryId gibt die Videokategorie an, für die das Diagramm abgerufen werden soll. Dieser Parameter kann nur in Verbindung mit dem Parameter chart verwendet werden. Standardmäßig sind Diagramme nicht auf eine bestimmte Kategorie beschränkt.

  • Das neue Attribut topicDetails.relevantTopicIds[] der video-Ressource bietet eine Liste von Freebase-Themen-IDs, die für das Video oder seinen Inhalt relevant sind. Die Themen dieser Themen können im Video erwähnt werden oder darin vorkommen.

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

  • Das contentDetails.contentRating-Objekt der video-Ressource gibt die Bewertungen an, die ein Video nach verschiedenen Bewertungsschemata erhalten hat, einschließlich MPAA-Altersfreigaben, TVPG-Altersfreigaben usw. Die API unterstützt jetzt für jedes Bewertungssystem einen Wert, der angibt, dass das Video noch nicht bewertet wurde. Beachten Sie, dass bei MPAA-Altersfreigaben ein "nicht bewertetes" Label Das Rating wird häufig verwendet, um ungeschnittene Versionen von Filmen zu kennzeichnen, für die die geschnittene Version des Films eine offizielle Bewertung erhalten hat.

  • Das neue Attribut contentDetails.contentRating.ytRating der Ressource video identifiziert Inhalte mit Altersbeschränkung. Der Property-Wert ist ytAgeRestricted, wenn YouTube Inhalte aufweist, die für Nutzer unter 18 Jahren nicht geeignet sind. Wenn die Eigenschaft fehlt oder der Eigenschaftswert leer ist, wurden die Inhalte nicht als mit einer Altersbeschränkung versehen eingestuft.

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

  • Die Methoden channelBanners.insert, channels.update, videos.getRating und videos.rate unterstützen jetzt den Parameter onBehalfOfContentOwner. Dieser Parameter gibt an, dass der authentifizierte Nutzer im Namen des im Parameterwert angegebenen Rechteinhabers handelt.

  • Die Dokumentation der Methode channels.update wurde aktualisiert, um zu verdeutlichen, dass diese Methode zum Aktualisieren des brandingSettings-Objekts der Ressource channel und ihrer untergeordneten Attribute verwendet werden kann. In der Dokumentation wird jetzt auch die aktualisierte Liste der Attribute aufgeführt, die Sie für das invideoPromotion-Objekt der Ressource channel festlegen können.

  • In der error documentation werden die folgenden neuen Fehler beschrieben:

    Fehlertyp Fehlerdetails Beschreibung
    forbidden accountDelegationForbidden Dieser Fehler bezieht sich nicht auf eine bestimmte API-Methode. Es gibt an, dass der authentifizierte Nutzer nicht autorisiert ist, im Namen des angegebenen Google-Kontos zu handeln.
    forbidden authenticatedUserAccountClosed Dieser Fehler bezieht sich nicht auf eine bestimmte API-Methode. Dies bedeutet, dass das YouTube-Konto des authentifizierten Nutzers geschlossen wurde. Wenn der Nutzer im Namen eines anderen Google-Kontos handelt, bedeutet dieser Fehler, dass das andere Konto geschlossen wurde.
    forbidden authenticatedUserAccountSuspended Dieser Fehler bezieht sich nicht auf eine bestimmte API-Methode. Dies bedeutet, dass das YouTube-Konto des authentifizierten Nutzers gesperrt ist. Wenn der Nutzer im Namen eines anderen Google-Kontos handelt, bedeutet dieser Fehler, dass das andere Konto gesperrt ist.
    forbidden authenticatedUserNotChannel Dieser Fehler bezieht sich nicht auf eine bestimmte API-Methode. Es gibt an, dass der API-Server den mit der API-Anfrage verknüpften Kanal nicht identifizieren kann. Wenn die Anfrage autorisiert ist und den Parameter onBehalfOfContentOwner verwendet, sollten Sie auch den Parameter onBehalfOfContentOwnerChannel festlegen.
    forbidden cmsUserAccountNotFound Dieser Fehler bezieht sich nicht auf eine bestimmte API-Methode. Der CMS-Nutzer darf nicht im Namen des angegebenen Rechteinhabers handeln.
    notFound contentOwnerAccountNotFound Dieser Fehler bezieht sich nicht auf eine bestimmte API-Methode. Das angegebene Rechteinhaberkonto wurde nicht gefunden.
    badRequest invalidPart Dieser Fehler bezieht sich nicht auf eine bestimmte API-Methode. Der part-Parameter der Anfrage gibt Teile an, die nicht gleichzeitig geschrieben werden können.
    badRequest videoChartNotFound Die Methode videos.list gibt diesen Fehler zurück, wenn in der Anfrage ein nicht unterstütztes oder nicht verfügbares Videodiagramm angegeben wird.
    notFound videoNotFound Die Methode videos.update gibt diesen Fehler zurück, um anzuzeigen, dass das Video, das du aktualisieren möchtest, nicht gefunden wurde. Prüfen Sie, ob der Wert des Attributs id im Anfragetext korrekt ist.

10. Juni 2013

Dieses Update enthält die folgenden Änderungen:

  • Mit dem neuen forUsername-Parameter der channels.list-Methode kannst du Informationen zu einem Kanal abrufen, indem du seinen YouTube-Nutzernamen gibst.

  • Die Methode activities.list unterstützt jetzt den Parameter regionCode, der die API anweist, Ergebnisse zurückzugeben, die für das angegebene Land relevant sind. YouTube verwendet diesen Wert, wenn die vorherigen Aktivitäten des autorisierten Nutzers auf YouTube nicht genügend Informationen liefern, um den Aktivitätsfeed zu generieren.

  • Playlist-Ressourcen enthalten jetzt die Property snippet.tags. Die Eigenschaft wird nur an autorisierte Nutzer zurückgegeben, die Daten zu ihren eigenen Playlists abrufen. Autorisierte Nutzer können auch Playlist-Tags festlegen, wenn sie die Methode 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 onBehalfOfContentOwnerChannel-Parameter angegeben werden, der den Kanal identifiziert, zu dem das Video hinzugefügt wird. Der Kanal muss mit dem Rechteinhaber verknüpft sein, den der Parameter onBehalfOfContentOwner angibt.

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

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

    Insbesondere in Bezug auf diese Version ermöglicht der Parameter nun einem Content-Partner, Videos in allen YouTube-Kanälen, die dem Partner gehören, einzufügen, zu aktualisieren oder zu löschen.

  • In der error documentation werden die folgenden neuen Fehler beschrieben:

    Fehlertyp Fehlerdetails Beschreibung
    forbidden insufficientCapabilities Dieser Fehler bezieht sich nicht auf eine bestimmte API-Methode. Dieser gibt an, dass der CMS-Nutzer, der die API aufruft, nicht über die erforderlichen Berechtigungen zum Ausführen des angeforderten Vorgangs verfügt. Dieser Fehler hängt mit der Verwendung des Parameters onBehalfOfContentOwner zusammen, der für verschiedene API-Methoden unterstützt wird.
    unauthorized authorizationRequired Die Methode activities.list gibt diesen Fehler zurück, wenn die Anfrage den Parameter home verwendet, aber nicht korrekt autorisiert ist.

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

  • Im neuen Leitfaden Mit Kanal-IDs arbeiten wird erläutert, wie Kanal-IDs in der API verwendet werden. Das Handbuch ist besonders für Entwickler hilfreich, die von der vorherigen Version der API migrieren und Anwendungen haben, die entweder Inhalte für den default-Nutzer anfordern oder die auf der Annahme beruhen, dass jeder YouTube-Kanal einen eindeutigen Nutzernamen hat. Dies ist nicht mehr der Fall.

22. Mai 2013

Dieses Update enthält die folgenden Änderungen:

14. Mai 2013

Dieses Update enthält die folgenden Änderungen:

  • Eigenständige Seiten enthalten jetzt Codebeispiele für Java, .NET, PHP und Ruby.

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

10. Mai 2013

Dieses Update enthält die folgenden Änderungen:

8. Mai 2013

Dieses Update enthält die folgenden Änderungen:

  • Kanalressourcen unterstützen jetzt das inVideoPromotion-Objekt, das Informationen zu einer mit dem Kanal verknüpften Werbekampagne enthält. Ein Kanal kann eine In-Video-Werbekampagne verwenden, um Thumbnail-Bilder für ein gesponsertes Video im Videoplayer während der Wiedergabe der Videos des Kanals anzuzeigen.

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

  • Die neue Methode channels.update kann verwendet werden, um die Daten einer In-Video-Werbekampagne in einem Kanal zu aktualisieren. Beachten Sie, dass die Methode nur Aktualisierungen des invideoPromotion-Teils der channel-Ressource unterstützt, jedoch noch keine Aktualisierungen anderer Teile dieser Ressource.

2. Mai 2013

Dieses Update enthält die folgenden Änderungen:

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

  • 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 videos.list-Methode kannst du eine Liste von Videos abrufen, die der authentifizierte Nutzer mit der Einstufung like oder dislike bewertet hat.

    Sowohl der myRating-Parameter als auch der id-Parameter gelten jetzt als Filterparameter. Das bedeutet, dass in einer API-Anfrage genau einer dieser Parameter angegeben werden muss. Bisher war der id-Parameter ein erforderlicher Parameter für diese Methode.

    Die Methode gibt den Fehler forbidden für Anfragen zurück, bei denen versucht wird, Informationen zur Videobewertung abzurufen, aber nicht ordnungsgemäß dazu autorisiert sind.

  • Mit der Einführung des myRating-Parameters wurde auch die videos.list-Methode aktualisiert, damit sie die Paginierung unterstützt. Beachten Sie jedoch, dass Paging-Parameter nur für Anfragen mit dem myRating-Parameter unterstützt werden. Seitenumbruchparameter und -informationen werden für Anfragen mit dem Parameter id nicht unterstützt.

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

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

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

    • autoLevels: Setze diesen Parameterwert auf true, um YouTube anzuweisen, Licht und Farbe des Videos automatisch zu optimieren.
    • stabilize: Setze diesen Parameterwert auf true, um YouTube anzuweisen, wackelige Bewegungen aufgrund von Kamerabewegungen zu entfernen.

  • Das Attribut channelTitle wurde dem snippet für die folgenden Ressourcen hinzugefügt:

    • playlistItem: Die Eigenschaft gibt den Namen des Kanals an, über den das Playlist-Element hinzugefügt wurde.
    • playlist: Die Eigenschaft gibt den Namen des Kanals an, über den die Playlist erstellt wurde.
    • subscription: Die Eigenschaft gibt den Namen des abonnierten Kanals an.

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

  • 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 mySubscribers-Parameter ersetzen, der derzeit für die Methode channels.list unterstützt wird. Dieser Parameter wird eingestellt.

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

  • API-Anfragen, die einen unerwarteten Parameter enthalten, geben jetzt den Fehler badRequest zurück und 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 von Elementen enthält, wurde aktualisiert. Der Fehler wird jetzt als forbidden-Fehler mit der Fehlerursache playlistContainsMaximumNumberOfVideos gemeldet.

19. April 2013

Dieses Update enthält die folgenden Änderungen:

  • Mit der neuen videos.rate-Methode können Nutzer eine like- oder dislike-Bewertung für ein Video festlegen oder eine Bewertung aus einem Video entfernen.

    Die Fehlerdokumentation wurde ebenfalls aktualisiert und listet nun die Fehler auf, die die API möglicherweise als Antwort auf einen videos.rate-Methodenaufruf zurückgibt.

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

    Die Fehlerdokumentation wurde ebenfalls aktualisiert und listet nun die Fehler auf, die die API möglicherweise als Antwort auf einen thumbnails.set-Methodenaufruf zurückgibt.

    Beachten Sie, dass sich diese Änderung nicht wirklich auf vorhandene Ressourcen auswirkt, die Miniaturansichten zurückgeben. Miniaturansichten werden in diesen Ressourcen auf die gleiche Weise zurückgegeben wie zuvor, obwohl in der Dokumentation jetzt die Namen der verschiedenen Miniaturansichten aufgeführt sind, die von der API zurückgegeben werden könnten.

  • Der neue brandingSettings-Teil der Ressource channel enthält die Einstellungen, Texte und Bilder für die Kanalseite und die Videowiedergabeseiten des Kanals.

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

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

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

  • Die Dokumentation der Methode playlistItems.update wurde aktualisiert, um zu verdeutlichen, dass das Attribut snippet.resourceId in der Ressource angegeben werden muss, die als Anfragetext gesendet wird.

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

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

    • Mit dem Parameter order können Ergebnisse jetzt alphabetisch nach Titel (order=title) oder nach Anzahl der Videos in absteigender Reihenfolge (order=videoCount) sortiert werden.

    • Der neue safeSearch-Parameter gibt an, ob die 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 Das Attribut snippet.categoryId gibt eine ungültige Kategorie-ID an. Verwenden Sie die Methode videoCategories.list, um unterstützte Kategorien abzurufen.
    badRequest invalidRecordingDetails metadata specifies invalid recording details.
    badRequest invalidVideoGameRating Die Metadaten der Anfrage geben eine ungültige Altersfreigabe für das Videospiel an.
    badRequest invalidVideoMetadata Die Metadaten der Anfrage sind ungültig.

  • Der Parameter onBehalfOfContentOwner wurde aus der Liste der unterstützten Parameter für die Methoden videos.update und videos.delete entfernt.

12. März 2013

Dieses Update enthält die folgenden Änderungen:

  • Das Attribut channelTitle wurde dem snippet für die folgenden Ressourcen hinzugefügt:

    • activity: Die Eigenschaft gibt den Namen des Kanals an, der für die Aktivität verantwortlich ist.
    • search: Das Attribut gibt den Namen des Kanals an, der mit der Ressource verknüpft ist, die das Suchergebnis identifiziert.
    • video: Die Eigenschaft gibt den Namen des Kanals an, auf dem das Video hochgeladen wurde.

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

    • Mit dem Parameter channelType können Sie die Suche nach Kanälen auf alle Kanäle oder nur auf Sendungen beschränken.

    • Mit dem Parameter videoType können Sie die Suche nach Videos so einschränken, dass entweder alle Videos oder nur Filme oder nur Folgen von Serien abgerufen werden.

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

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

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

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

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

      Die Methoden channels.list, search.list, videos.delete, videos.list und videos.update unterstützen diesen Parameter.

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

    • Der forContentOwner-Parameter, der von der search.list-Methode unterstützt wird, weist die API an, die Suchergebnisse auf Ressourcen zu beschränken, die dem Rechteinhaber gehören, der im onBehalfOfContentOwner-Parameter angegeben ist.

25. Februar 2013

Dieses Update enthält die folgenden Änderungen:

  • Die API unterstützt mehrere neue Teile und Attribute für video-Ressourcen:

    • Die neuen Teile für fileDetails, processingDetails und suggestions bieten Rechteinhabern Informationen zu ihren hochgeladenen Videos. Diese Daten sind sehr nützlich in Anwendungen, die Videouploads ermöglichen und umfassen Folgendes:

      • Verarbeitungsstatus und -fortschritt
      • Fehler oder andere Probleme bei der Verarbeitung eines Videos
      • Verfügbarkeit von Miniaturansichten
      • Vorschläge zur Verbesserung der Video- oder Metadatenqualität
      • Details zur auf YouTube hochgeladenen Originaldatei

      All diese Teile können nur vom Videoinhaber abgerufen werden. In der folgenden Liste werden die neuen Teile kurz beschrieben. In der video-Ressourcendokumentation werden alle Attribute definiert, die die einzelnen Teile enthalten.

      • Das fileDetails-Objekt enthält Informationen zur Videodatei, die auf YouTube hochgeladen wurde, z. B. die Auflösung, die Dauer, die Audio- und Video-Codecs und die Stream-Bitraten.

      • Das processingProgress-Objekt enthält Informationen zum Fortschritt von YouTube bei der Verarbeitung der hochgeladenen Videodatei. Die Eigenschaften 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 verschiedene Arten von Daten oder Inhalten für das Video verfügbar sind, z. B. Dateidetails oder Thumbnails.

        Dieses Objekt soll abgefragt werden, damit der Uploader des Videos den Fortschritt verfolgen kann, den YouTube bei der Verarbeitung der hochgeladenen Videodatei gemacht hat.

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

    • Der Teil contentDetails enthält vier neue Eigenschaften. Diese Attribute können mit nicht authentifizierten Anfragen abgerufen werden.

      • dimension: Gibt an, ob das Video in 2D oder 3D verfügbar ist.
      • definition: Gibt an, ob das Video in Standard- oder High Definition verfügbar ist.
      • caption: Gibt an, ob für das Video Untertitel verfügbar sind.
      • licensedContent: Gibt an, ob das Video Content enthält, auf den ein YouTube-Content-Partner Anspruch erhoben hat.

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

      • embeddable: Gibt an, ob das Video auf einer anderen Website eingebettet werden kann.
      • license: Gibt die Lizenz des Videos an. Gültige Werte 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 wurde.

  • Die neue contentDetails.googlePlusUserId-Eigenschaft 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 erstellt werden.

  • Bei jedem Thumbnail-Bildobjekt werden jetzt die Breite und Höhe des Bilds angegeben. Miniaturansichten werden derzeit in den Ressourcen activity, channel, playlist, playlistItem, search result, subscription und video zurückgegeben.

  • playlistItems.list unterstützt jetzt den videoId-Parameter, der in Verbindung mit dem playlistId-Parameter 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 durch den Parameter identifizierte Video nicht in der Playlist gefunden wird.

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

  • Das Attribut snippet.channelId der Ressource channel wurde entfernt. Das Attribut id der Ressource bietet denselben Wert.

30. Januar 2013

Dieses Update enthält die folgenden Änderungen:

  • Auf der neuen Seite Fehler werden Fehler aufgelistet, die die API zurückgeben kann. Die Seite enthält allgemeine Fehler, die bei mehreren verschiedenen API-Methoden auftreten können, sowie methodenspezifische Fehler.

16. Januar 2013

Dieses Update enthält die folgenden Änderungen:

  • Codebeispiele sind jetzt für die in der folgenden Liste aufgeführten Methoden und Sprachen verfügbar:

  • Eine activity-Ressource kann jetzt eine channelItem-Aktion melden. Diese tritt auf, wenn YouTube einem automatisch generierten YouTube-Kanal ein Video hinzufügt. YouTube ermittelt mithilfe von Algorithmen Themen, die auf der YouTube-Website häufig vorkommen, und erstellt automatisch Kanäle zu diesen Themen.

  • Die folgenden search.list-Parameter wurden aktualisiert:

    • Der Parameter q ist nicht mehr als Filter festgelegt. Das bedeutet, dass...
    • Der Parameter relatedToVideo wurde in relatedToVideoId umbenannt.
    • Der Parameter published wurde durch die beiden neuen Parameter publishedAfter und publishedBefore ersetzt, die im Folgenden beschrieben werden.

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

    Parametername Wert Beschreibung
    channelId string Gibt Ressourcen zurück, die vom angegebenen Kanal erstellt wurden.
    publishedAfter datetime Gibt Ressourcen zurück, die nach der angegebenen Zeit erstellt wurden.
    publishedBefore datetime Gibt Ressourcen zurück, die vor der angegebenen Zeit erstellt wurden.
    regionCode string Gibt Ressourcen für das angegebene Land zurück.
    videoCategoryId string Filtert Videosuchergebnisse so, dass sie nur Videos enthalten, die der angegebenen Videokategorie zugeordnet sind.
    videoEmbeddable string Filtern Sie die Videosuchergebnisse so, dass sie nur Videos enthalten, die in einem eingebetteten Player auf einer Webseite abgespielt werden können. Setze den Parameterwert auf true, um nur einbettbare Videos abzurufen.
    videoSyndicated string Filtere die Videosuchergebnisse so, dass sie nur Videos enthalten, die außerhalb von YouTube.com abgespielt werden können. Setze den Parameterwert auf true, um nur syndizierte Videos abzurufen.

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

    Ressource Property-Name Wert Beschreibung
    activity contentDetails.playlistItem.playlistItemId string Die ID des Playlist-Elements, die YouTube zugewiesen hat, um das Element in der Playlist eindeutig zu identifizieren.
    activity contentDetails.channelItem object Ein Objekt, das Informationen zu einer Ressource enthält, die einem Kanal hinzugefügt wurde. Dieses Attribut ist nur vorhanden, wenn snippet.type channelItem ist.
    activity contentDetails.channelItem.resourceId object Ein Objekt, das die Ressource identifiziert, die dem Kanal hinzugefügt wurde. Wie andere resourceId-Attribute enthält es eine kind-Eigenschaft, die den Ressourcentyp angibt, z. B. Video oder Playlist. Es enthält außerdem genau eines von mehreren Attributen, z. B. videoId oder playlistId, mit der die ID angegeben wird, die diese Ressource eindeutig identifiziert.
    channel status object Dieses Objekt enthält Informationen zum Datenschutzstatus des Kanals.
    channel status.privacyStatus string Der Datenschutzstatus des Kanals. Gültige Werte sind private und public.
    playlist contentDetails object Dieses Objekt enthält Metadaten zum Inhalt der Playlist.
    playlist contentDetails.itemCount unsigned integer Die Anzahl der Videos in der Playlist.
    playlist player object Dieses Objekt enthält Informationen, die du verwenden würdest, um die Playlist in einem eingebetteten Player abzuspielen.
    playlist player.embedHtml string Ein <iframe>-Tag, das einen Videoplayer einbettet, der die Playlist wiedergibt.
    video recordingDetails object Dieses Objekt enthält Informationen zur Identifizierung oder Beschreibung des Ortes und der Zeit, zu der das Video aufgezeichnet wurde.
    video recordingDetails.location object Dieses Objekt enthält mit dem Video verknüpfte Geolocation-Informationen.
    video recordingDetails.location.latitude double Breitengrad in Grad
    video recordingDetails.location.longitude double Längengrad in Grad
    video recordingDetails.location.elevation double Die Höhe über der Erde in Metern.
    video recordingDetails.locationDescription string Eine Textbeschreibung des Orts, an dem das Video aufgezeichnet wurde.
    video recordingDetails.recordingDate datetime Datum und Uhrzeit der Videoaufzeichnung. Der Wert wird im Format ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) angegeben.

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

    Hinweis:In der Dokumentation zu anderen Methoden sind möglicherweise bereits erforderliche und änderbare Eigenschaften aufgeführt.

    Methode Attribute
    activities.insert Erforderliche Attribute:
    • snippet.description
    Änderbare Eigenschaften:
    • snippet.description
    • contentDetails.bulletin.resourceId
    playlists.update Erforderliche Attribute:
    • id
    playlistItems.update Erforderliche Attribute:
    • id
    videos.update Erforderliche Attribute:
    • id

  • Die API meldet keinen playlistAlreadyExists-Fehler mehr, wenn du versuchst, eine Playlist zu erstellen oder zu aktualisieren, die denselben Titel wie eine bereits auf demselben Kanal vorhandene Playlist hat.

  • Mehrere API-Methoden unterstützen neue Fehlertypen. In der folgenden Tabelle sind die Methode und die neu unterstützten Fehler aufgeführt:

    Methode Fehlertyp Fehlerdetails Beschreibung
    guideCategories.list notFound notFound Die durch den Parameter id angegebene Guide-Kategorie wurde nicht gefunden. Verwenden Sie die Methode guideCategories.list, um eine Liste gültiger Werte abzurufen.
    playlistItems.delete forbidden playlistItemsNotAccessible Die Anfrage zum Löschen des angegebenen Playlist-Elements ist nicht ordnungsgemäß autorisiert.
    videoCategories.list notFound videoCategoryNotFound Die durch den Parameter id angegebene Videokategorie wurde nicht gefunden. Verwenden Sie die Methode videoCategories.list, um eine Liste gültiger Werte abzurufen.