Auf dieser Seite werden Änderungen an der YouTube Data API (Version 3) und Aktualisierungen der Dokumentation aufgeführt. Änderungsprotokoll 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
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
-RessourcecontentDetails.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 Parameterhl
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
-Ressourcesnippet.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:
- Das
snippet.videoOwnerChannelId
gibt die ID des Kanals an, über den das Playlist-Video hochgeladen wurde. - Das
snippet.videoOwnerChannelTitle
gibt den Namen des Kanals an, über den das Playlist-Video hochgeladen wurde.
28. Januar 2021
Dieses Update enthält die folgenden Änderungen:
-
Das
playlistItems.delete
,playlistItems.insert
,playlistItems.list
,playlistItems.update
,playlists.delete
,playlists.list
und Alleplaylists.update
-Methoden werden unterstützt Es wird ein neuerplaylistOperationUnsupported
-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
undwatchLaterNotAccessible
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
- Das Attribut
- Die Methode
channels.list
Filterparameter „categoryId
“ - Die Ressource
guideCategories
und dieguideCategories.list
Methode
- Die folgende
-
API-Antworten für die
channels.list
-Methode länger dieprevPageToken
wenn in der API-Anfrage diemanagedByMe
-Parameter antrue
. Diese Änderung hat keine Auswirkungen auf das AttributprevPageToken
für anderechannels.list
-Anfragen. Dies hat keine Auswirkungen aufnextPageToken
Property für Anfragen. -
contentDetails.relatedPlaylists.watchLater
der Ressourcechannel
undcontentDetails.relatedPlaylists.watchHistory
Unterkünfte wurden angekündigt, da er am 11. August 2016 eingestellt wurde. Die Unterstützung der MethodenplaylistItems.insert
undplaylistItems.delete
für diese Playlists wurden ebenfalls vollständig eingestellt und die beiden Properties wurden entfernt. aus der Dokumentation. -
Der Parameter
mySubscribers
der Methodechannels.list
, der am 30. Juli 2013 als veraltet angekündigt, wurden aus der Dokumentation entfernt. Verwenden Sie die Methode Methodesubscriptions.list
undmySubscribers
, um eine Liste der Abonnenten des den Kanal des authentifizierten Nutzers. -
Das
invideoPromotion
-Objekt der Ressourcechannel
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 Ressourcesponsor
wurde verworfen. API-Clients sollten Aufrufe auf aktualisieren.sponsors.list
-Methode zur Verwendung des Verwenden Sie stattdessen die Methodemembers.list
. -
Das neue
membershipsLevel
Ressource eine Preisstufe angibt, die von dem Ersteller verwaltet wird, der die API-Anfrage autorisiert hat. DasmembershipsLevels.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 derchannels.update
-Methode. Bei Videos Diese Eigenschaft kann beim Aufrufen dervideos.insert
odervideos.update
-Methoden.
Beachten Sie, dass diese Eigenschaft nur in API-Antworten enthalten ist, diechannel
odervideo
, 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 derselfDeclaredMadeForKids
-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 Ressourcechannel
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 Domainhttp
anstelle der Domainhttps
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 Domainhttp
zu laden. -
Hinweis: Dies ist eine Ankündigung zu eingestellten Funktionen.
Das Attribut
recordingDetails.location.altitude
der Ressourcevideo
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 Ressourcechannel
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 vonchannels.list
abzurufen, wird ein leeresinvideoPromotion
oder gar keineinvideoPromotion
-Daten zurückgegeben. - Beim Versuch,
invideoPromotion
-Daten beim Aufrufen vonchannels.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. - Beim Versuch, den
16. November 2017
Dieses Update enthält die folgenden Änderungen:
-
Das interaktive Code-Snippet-Tool unterstützt jetzt Node.js-Codebeispiele. Die Beispiele sind auch in der Dokumentation für fast alle API-Methoden 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 ininsert
- undupdate
-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.
- Mit der Funktion
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
undgoogle-auth-oauthlib
anstelle der mittlerweile verworfenenoauth2client
-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:
- Rufen Sie das interaktive Code-Snippet-Tool oder die Dokumentation einer beliebigen API-Methode, z. B. der
channels.list
-Methode, auf. - Klicken Sie über den Codebeispielen auf den Tab
Python
. - Klicken Sie auf die Ein/Aus-Schaltfläche über den Tabs, um von der Darstellung eines Ausschnitts zu einem vollständigen Beispiel zu wechseln.
- 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. - 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.
- Rufen Sie das interaktive Code-Snippet-Tool oder die Dokumentation einer beliebigen API-Methode, z. B. der
29. August 2017
Dieses Update enthält die folgenden Änderungen:
- Die Definition des
forContentOwner
-Parameters dersearch.list
-Methode wurde aktualisiert: Wenn dieser Parameter auftrue
gesetzt ist, muss dertype
-Parameter aufvideo
festgelegt werden. - Die Definition des
regionCode
-Parameters dersearch.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:
-
Hinweis: Dies ist eine Ankündigung zu eingestellten Funktionen.
Die folgenden
video
-Ressourcenattribute werden nicht mehr unterstützt. Die Eigenschaften werden zwar noch bis zum 1. Dezember 2017 unterstützt, es gibt jedoch keine Garantie, dass Videos bis zu diesem Zeitpunkt weiterhin Werte für diese Eigenschaften zurückgeben. Ebenso generierenvideos.insert
- undvideos.update
-Anfragen, die diese Attributwerte festlegen, vor diesem Datum keine Fehler. Es ist jedoch möglich, dass die eingehenden Daten nicht gespeichert werden.
17. Mai 2017
Dieses Update enthält die folgenden Änderungen:
-
Die API-Referenzdokumentation wurde aktualisiert, um Code-Snippets vielseitiger und interaktiver zu machen. Seiten, auf denen API-Methoden wie
channels.list
odervideos.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:
- In neuen Kurzanleitungen wird erklärt, wie du eine einfache Anwendung einrichtest, die YouTube Data API-Anfragen sendet. Aktuell sind Anleitungen für Android, Apps Script, Go, Java, JavaScript, Node.js, PHP, Python und Ruby verfügbar.
30. März 2017
Dieses Update enthält die folgenden Änderungen:
- Die neue
topicDetails.topicCategories[]
-Eigenschaft der Ressourcechannel
enthält eine Liste mit Wikipedia-URLs, die den Inhalt des Kanals beschreiben. Die URLs entsprechen den Themen-IDs, die im AttributtopicDetails.topicIds[]
der Ressource zurückgegeben werden. - Das neue Attribut
contentDetails.videoPublishedAt
der RessourceplaylistItem
gibt den Zeitpunkt an, zu dem das Video auf YouTube veröffentlicht wurde. Die Ressource enthält bereits das Attributsnippet.publishedAt
, das den Zeitpunkt angibt, zu dem das Element der Playlist hinzugefügt wurde. - Wie bei der
channel
-Ressource gibt die Ressourcevideo
jetzt die EigenschafttopicDetails.topicCategories[]
zurück. Diese enthält eine Liste von Wikipedia-URLs, die den Inhalt des Videos beschreiben. Bei Ressourcen vom Typvideo
entsprechen die URLs den Themen-IDs, die im AttributtopicDetails.relevantTopicIds[]
der Ressource zurückgegeben werden. - Die neue
contentDetails.contentRating.mpaatRating
-Eigenschaft dervideo
-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:Name Themen-ID Unternehmen /m/09s1f
Gesundheit /m/0kt51
Militär /m/01h6rj
Politik /m/05qt0
Religion /m/06bvp
- Das Thema
Animated cartoon
, das zuvorEntertainment
untergeordnet war, wurde entfernt. - Das Thema
Children's music
, das zuvorMusic
untergeordnet war, wurde entfernt.
Aufgrund dieser Änderung werden Themen, die sich auf ein Video beziehen, jetzt immer im 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 KategorieSports
untergeordnet war, ist jetztEntertainment
untergeordnet. - Die Kategorie
TV shows
, dieEntertainment
untergeordnet ist, ist neu. - Die Kategorie
Health
, die zuvorLifestyle
untergeordnet war, wurde entfernt.
Es gibt auch einige übergeordnete Kategorien (
Entertainment
,Gaming
,Lifestyle
,Music
undSports
). Jedes Video, das mit einer untergeordneten Kategorie wieTennis
verknüpft ist, wird auch der übergeordneten Kategorie (Sports
) zugeordnet. - Die Kategorie
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
- undvideo
-Ressourcen verknüpft sind. Du kannst auch den SuchparametertopicId
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.
- Das Attribut
topicDetails.topicIds[]
der Ressourcechannel
. - Das Attribut
topicDetails.relevantTopicIds[]
der Ressourcevideo
. - Der Parameter
topicId
der Methodesearch.list
.
- Das Attribut
-
Hinweis: Dies ist eine Ankündigung zu eingestellten Funktionen.
Die folgenden Attribute werden nicht mehr unterstützt:
- Das Attribut
topicDetails.topicIds[]
der Ressourcechannel
. Diese Property wird bis zum 10. November 2017 unterstützt. - Das Attribut
topicDetails.relevantTopicIds[]
der Ressourcevideo
. Diese Property wird bis zum 10. November 2017 unterstützt. - Das Attribut
topicDetails.topicIds[]
der Ressourcevideo
. Diese Property enthält keine Werte nach dem 10. Februar 2017. Nach diesem Datum gibt der EigenschaftswerttopicDetails.relevantTopicIds[]
alle Themen an, die mit einem Video verknüpft sind.
- Das Attribut
-
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 Eigenschaftenplayer.embedHeight
undplayer.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 ParametermaxHeight
odermaxWidth
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
undmaxWidth
. Sie können entweder einen oder beide Parameter verwenden, wenn Sie denplayer
-Teil invideo
-Ressourcen abrufen.Standardmäßig beträgt die Höhe von
<iframe>
, die in der Eigenschaftplayer.embedHtml
zurückgegeben wird, 360 Pixel. Die Breite wird an das Seitenverhältnis des Videos angepasst. Dadurch wird sichergestellt, dass der eingebettete Player keine schwarzen Balken 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
- odermaxWidth
-Parameter nicht festgelegt ist, würde dasplayer.embedHtml
-Tag also einen 640-x-360-Player enthalten.- Wenn der
maxHeight
-Parameter auf720
und dermaxWidth
-Parameter nicht festgelegt ist, gibt die API einen 1280-x-720-Player zurück. - Wenn der
maxWidth
-Parameter auf960
und dermaxHeight
-Parameter nicht festgelegt ist, gibt die API einen 960-x-540-Player zurück. - Wenn der
maxWidth
-Parameter auf960
und dermaxHeight
-Parameter auf450
gesetzt ist, gibt die API einen 800-x-450-Player zurück.
Die neuen oben beschriebenen Eigenschaften
player.embedHeight
undplayer.embedWidth
geben die Abmessungen des Players an. - Wenn der
-
-
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 RessourcechannelSection
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 Ressourcei18nLanguage
wurde korrigiert. Sie zeigt jetzt, dass der Wert den Namen einer Sprache darstellt, wie er in der Sprache geschrieben ist, die durch den Parameterhl
der Methodei18nLanguage.list
angegeben wird. -
Das Attribut
contentDetails.note
der Ressource „playlistItem
“ wurde aktualisiert, um zu beachten, dass die maximale Länge des Attributwerts 280 Zeichen beträgt. -
Die Attribute
contentDetails.startAt
undcontentDetails.endAt
der RessourceplaylistItem
wurden verworfen. Diese Felder werden ignoriert, wenn sie inplaylistItems.insert
- oderplaylistItems.update
-Anfragen festgelegt sind. -
Die Methoden
playlistItems.delete
undplaylistItems.update
unterstützen jetzt den ParameteronBehalfOfContentOwner
, der bereits für mehrere andere Methoden unterstützt wird. Anfragen, die diese Methode verwenden, müssen ebenfalls mit einem Token autorisiert werden, das Zugriff auf den Bereichhttps://www.googleapis.com/auth/youtubepartner
bietet. -
Die Parameter
publishedBefore
undpublishedAfter
der Methodesearch.list
wurden aktualisiert, um anzuzeigen, dass die Parameterwerte eingeschlossen sind. Wenn beispielsweise der ParameterpublishedBefore
festgelegt ist, gibt die API Ressourcen zurück, die vor oder um der angegebenen Zeit erstellt wurden. -
Das Attribut
contentDetails.contentRating.grfilmRating
der Ressourcevideo
unterstützt drei zusätzliche Werte:grfilmK12
,grfilmK15
undgrfilmK18
. -
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 denhome
-Parameter in einer nicht autorisierten Anfrage auftrue
setzen.invalidValue (400)
invalidContentDetails
Die Methode playlistItems.insert
gibt diesen Fehler zurück, um anzugeben, dass dascontentDetails
-Objekt in der Anfrage ungültig ist. Ein Grund für diesen Fehler ist, dass das FeldcontentDetails.note
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
undcontentDetails.relatedPlaylists.watchLater
der Ressourcechannel
in einer Antwort enthalten sind, immer die WerteHL
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 Parameterhome
aufgerufen wird, der auftrue
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
undcontentDetails.relatedPlaylists.watchLater
der Ressourcechannel
enthalten jetzt die WerteHL
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
undWL
, 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 WerteHL
undWL
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 Ressourcevideo
und ihre untergeordneten Attribute werden nicht mehr zurückgegeben. Bisher konnten diese Daten (wie das übergeordnetefileDetails
-Objekt) nur vom Rechteinhaber eines Videos abgerufen werden.
11. August 2016
Dieses Update enthält die folgenden Änderungen:
-
Die neu veröffentlichten Nutzungsbedingungen für die YouTube API-Dienste („aktualisierte Nutzungsbedingungen“), die 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 Ressourcechannel
gibt Themen an, die mit dem Kanal verknüpft sind. - Der
topicDetails
-Teil der Ressourcevideo
gibt die mit dem Video verknüpften Themen an. - Mit dem Parameter
topicId
dersearch.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.
- Der
-
Mehrere API-Felder und Parameter werden ab dem 12. September 2016 eingestellt:
-
Mit dem Parameter
home
der Methodeactivities.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
undcontentDetails.relatedPlaylists.watchLater
der Ressourcechannel
sind nur für einen autorisierten Nutzer sichtbar, der Daten über den eigenen Kanal abruft. Nach dem 12. September 2016 gibtcontentDetails.relatedPlaylists.watchHistory
für alle Channels den WertHL
und die PropertycontentDetails.relatedPlaylists.watchLater
den WertWL
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 WerteHL
undWL
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 Ressourcevideo
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 übergeordnetefileDetails
-Objekt nur von einem Videoinhaber abgerufen werden kann.
-
13. Juni 2016
Dieses Update enthält die folgenden Änderungen:
-
Das Attribut
contentDetails.googlePlusUserId
der Ressourcechannel
wurde 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 inchannel
-Ressourcen enthalten. -
Das Attribut
snippet.authorGoogleplusProfileUrl
der Ressourcecomment
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 incomment
-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 Methodesubscriptions.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.
- Das Bild
-
Die Definition des
part
-Parameters der MethodechannelSection.list
wurde aktualisiert, um zu verdeutlichen, dass dertargeting
-Teil zu einem Preis von2
Kontingenteinheiten abgerufen werden kann. -
Die Methode
videos.list
gibt jetzt einen verbotenen Fehler (403
) zurück, wenn eine nicht ordnungsgemäß autorisierte Anfrage versucht, die TeilefileDetails
,processingDetails
odersuggestions
einer Ressource vom Typvideo
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 Ressourcevideo
gibt das Projektionsformat des Videos an. Gültige Attributwerte sind360
undrectangular
. -
Die Attribute
recordingDetails.location
undfileDetails.recordingLocation
der Ressourcevideo
wurden aktualisiert, um den Unterschied zwischen den beiden Attributen zu 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 Property
-
Die Definition des Attributs
contentDetails.relatedPlaylists.favorites
der Ressourcechannel
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 Methodecomments.insert
,comments.update
,commentThreads.insert
odercommentThreads.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 Methodechannels.update
wurde aktualisiert, um zu verdeutlichen, dasslocalizations
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 Ressourcechannel
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 Ressourcechannel
und alle untergeordneten Attribute wurden eingestellt. -
Die API-Antwort auf eine
search.list
-Anfrage enthält jetzt das AttributregionCode
. 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 istUS
. 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
undsnippet.secondaryReasons[].label
der RessourcevideoAbuseReportReason
wurden aktualisiert. Sie enthalten nun lokalisierten Labeltext für die Gründe des Missbrauchsberichts.Außerdem unterstützt die Methode
videoAbuseReportReasons.list
jetzt den Parameterhl
, der die Sprache angibt, die für den Labeltext in der API-Antwort verwendet werden soll. Der Standardparameterwert isten_US
. -
Die neue
contentDetails.contentRating.ecbmctRating
-Property dervideo
-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 Ressourcevideo
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 Ressourcevideo
unterstützt den neuen Attributwertlegal
.
-
-
Die API unterstützt die folgenden neuen Fehler:
Fehlertyp Fehlerdetails Beschreibung badRequest (400)
notEditable
Die Methoden channelSections.insert
,channelSections.update
undchannelSections.delete
geben diesen Fehler zurück, um anzuzeigen, dass der angegebene Kanalabschnitt nicht erstellt, aktualisiert oder gelöscht werden kann.badRequest (400)
styleRequired
Die Methoden channelSections.insert
undchannelSections.update
geben diesen Fehler zurück, um anzugeben, dass die in der API-Anfrage eingereichte RessourcechannelSection
einen Wert für das Attributsnippet.style
angeben muss.badRequest (400)
typeRequired
Die Methoden channelSections.insert
undchannelSections.update
geben diesen Fehler zurück, um anzugeben, dass die in der API-Anfrage eingereichte RessourcechannelSection
einen Wert für das Attributsnippet.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 RessourcecommentThread
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 ParametervideoId
angegebene Video Kommentare deaktiviert sind.badRequest (400)
commentTextTooLong
Die Methode commentThreads.insert
gibt diesen Fehler zurück, um anzuzeigen, dass die eingefügte Ressourcecomment
zu viele Zeichen im Attributsnippet.topLevelComment.snippet.textOriginal
enthält.invalidValue (400)
videoAlreadyInAnotherSeriesPlaylist
Die Methode playlistItems.insert
gibt diesen Fehler zurück, um 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 Attributsnippet.categoryId
in der hochgeladenenvideo
-Ressource eine ungültige Kategorie-ID angegeben hat. Verwenden Sie die MethodevideoCategories.list
, um unterstützte Kategorien abzurufen.badRequest (400)
invalidDescription
Die Methode videos.update
gibt diesen Fehler zurück, um anzugeben, dass das Attributsnippet.description
in der hochgeladenenvideo
-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 Attributstatus.publishAt
in der hochgeladenen Ressourcevideo
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 dasrecordingDetails
-Objekt in der hochgeladenenvideo
-Ressource ungültige Aufnahmedetails angegeben hat.badRequest (400)
invalidTags
Die Methode videos.update
gibt diesen Fehler zurück, um anzugeben, dass das Attributsnippet.tags
in der hochgeladenenvideo
-Ressource einen ungültigen Wert angegeben hat.badRequest (400)
invalidTitle
Die Methode videos.update
gibt diesen Fehler zurück, um anzugeben, dass die Eigenschaftsnippet.title
in der hochgeladenenvideo
-Ressource einen ungültigen oder leeren Videotitel angegeben hat.badRequest (400)
invalidVideoMetadata
Die Methode videos.update
gibt diesen Fehler zurück, um anzuzeigen, dass die Anfragemetadaten ungültig sind. Dieser Fehler tritt auf, wenn die Anfrage densnippet
-Teil einervideo
-Ressource aktualisiert, aber keinen Wert für die Attributesnippet.title
undsnippet.categoryId
festlegt.
18. Dezember 2015
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
oderupdate
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 Attributesnippet.title
undsnippet.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 diesnippet.defaultLanguage
-Eigenschaft aufen
setzen.Hinweis zum Aktualisieren von
channel
-Ressourcen: Um das Attributsnippet.defaultLanguage
für eine Ressource vom Typchannel
festzulegen, müssen Sie tatsächlich das AttributbrandingSettings.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
- odervideos.list
-Anfrage den Parameterhl
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 dassnippet.localized
-Objekt der Ressource die lokalisierten Werte. Wenn keine lokalisierten Details verfügbar sind, enthält das Objektsnippet.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 Parameterhl
aufde
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 auffr
gesetzt, enthält das Objektsnippet.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 Parameterhl
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 denlocalizations
-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 Parameterwertpart
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 Attributsnippet.defaultLanguage
für diese Ressource nicht festgelegt ist. Dieser Fehler wird von den Methodenchannels.update
,channelSections.insert
,channelSections.update
,playlists.insert
,playlists.update
,videos.insert
undvideos.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 Methodenchannels.update
,channelSections.insert
,channelSections.update
,playlists.insert
undplaylists.update
unterstützt.
4. November 2015
Dieses Update enthält die folgenden Änderungen:
-
Updates für vorhandene Ressourcen und Methoden
-
Der
order
-Parameter dersearch.list
-Methode wurde aktualisiert. Wenn du Liveübertragungen nachviewCount
sortierst, werden die API-Ergebnisse danach sortiert. Anzahl gleichzeitiger Zuschauer während der Übertragung -
Der Parameter
relatedToVideoId
der Methodesearch.list
wurde aktualisiert. Wenn der Parameter festgelegt ist, werden nurpart
,maxResults
,pageToken
,regionCode
,relevanceLanguage
,safeSearch
,type
(muss aufvideo
gesetzt sein) undfields
unterstützt. Diese Aktualisierung spiegelt keine Änderung des API-Verhaltens wider. -
Die Definition der Eigenschaft
snippet.publishedAt
der Ressourcevideo
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 Ressourcevideo
wurde aktualisiert, um Folgendes zu beachten:- Wenn du den Wert dieses Attributs beim Aufrufen der
videos.update
-Methode festlegst, musst du auch denstatus.privacyStatus
-Eigenschaftswert aufprivate
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 derprivacyStatus
des Videos vonprivate
zupublic
.
- Wenn du den Wert dieses Attributs beim Aufrufen der
-
Die Eigenschaft
contentDetails.contentRating.cncRating
der Ressourcevideo
gibt die Einstufung des Videos gemäß der französischen Kommission zur Klassifikation der Kinotografie an. Diese Eigenschaft ersetzt die inzwischen eingestellte EigenschaftcontentDetails.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 keinethumbnail
-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 dieactivities.list
-Methode derzeit keine Ressourcen zu neuen Videokommentaren enthält. Diesnippet.type
undcontentDetails.comment
der Ressource wurden ebenfalls aktualisiert.
-
-
Neue und aktualisierte Fehler
-
Die API unterstützt jetzt die folgenden Fehler:
Fehlerdetails activities.insert
HTTP-Antwortcode badRequest (400)
Grund invalidMetadata
Beschreibung Die Eigenschaft kind
entspricht nicht dem angegebenen ID-Typ.commentThreads.update
comments.insert
comments.update
HTTP-Antwortcode badRequest (400)
Grund commentTextTooLong
Beschreibung Die Ressource comment
, die eingefügt oder aktualisiert wird, enthält zu viele Zeichen im Attributsnippet.topLevelComment.snippet.textOriginal
.playlistItems.insert
playlistItems.update
HTTP-Antwortcode forbidden (403)
Grund playlistItemsNotAccessible
Beschreibung Die Anfrage ist nicht ordnungsgemäß zum Einfügen, Aktualisieren oder Löschen des angegebenen Playlist-Elements autorisiert. playlists.delete
playlists.insert
playlists.update
HTTP-Antwortcode badRequest (400)
Grund playlistForbidden
Beschreibung Dieser Vorgang ist verboten oder die Anfrage ist nicht korrekt autorisiert. search.list
HTTP-Antwortcode badRequest (400)
Grund invalidLocation
Beschreibung Der Wert des Parameters location
und/oderlocationRadius
wurde falsch formatiert.search.list
HTTP-Antwortcode badRequest (400)
Grund invalidRelevanceLanguage
Beschreibung Der Parameterwert „ relevanceLanguage
“ wurde falsch formatiert.subscriptions.insert
HTTP-Antwortcode badRequest (400)
Grund subscriptionForbidden
Beschreibung Dieser 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-Antwortcode badRequest (400)
Grund invalidDefaultBroadcastPrivacySetting
Beschreibung Bei 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 Ressourcevideo
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 auf0
festgelegt.
-
7. August 2015
Dieses Update enthält die folgenden Änderungen:
-
Aktualisierungen vorhandener Ressourcen und Methoden
-
Die Definition des Attributs
snippet.tags[]
der Ressourcevideo
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 ParametershareOnGooglePlus
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 MethodecommentThreads.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 Ressourcevideo
gibt die Sprache an, die im Standard-Audiotrack des Videos gesprochen wird. -
Die Definition der Eigenschaft
contentDetails.licensedContent
der Ressourcevideo
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
undcaptions.update
unterstützen jetzt den ParameteronBehalfOfContentOwner
, 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 Bereichhttps://www.googleapis.com/auth/youtubepartner
bietet.
-
-
Neue und aktualisierte Fehler
-
Die API unterstützt jetzt die folgenden Fehler:
Fehlerdetails videos.rate
HTTP-Antwortcode badRequest (400)
Grund emailNotVerified
Beschreibung Der Nutzer muss seine E-Mail-Adresse bestätigen, bevor er das Video bewerten kann. videos.rate
HTTP-Antwortcode badRequest (400)
Grund videoPurchaseRequired
Beschreibung Leihvideos können nur von Nutzern bewertet werden, die sie ausgeliehen haben. -
Die Methoden
subscriptions.delete
undsubscriptions.insert
unterstützen die FehleraccountClosed
undaccountSuspended
nicht mehr.
-
27. April 2015
Dieses Update enthält die folgenden Änderungen:
-
Neue Ressourcen und Methoden
-
Die neue Ressource
videoAbuseReportReason
enthält Informationen zu einem Grund, warum ein Video gemeldet werden könnte, weil es missbräuchliche Inhalte enthält. Mit der MethodevideoAbuseReportReasons.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 beschriebenevideoAbuseReportReason.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 Methodesearch.list
beschränkt die Suche auf Videos, die über die Anwendung oder Website des Entwicklers hochgeladen wurden. Der ParameterforDeveloper
kann in Verbindung mit optionalen Suchparametern wie dem Parameterq
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 auftrue
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 derchannel
-Ressource können Kanalinhaber ihre Kanäle mit einem bestimmten Land verknüpfen.Hinweis: Um das Attribut
snippet.country
für einechannel
-Ressource festzulegen, müssen Sie tatsächlich das AttributbrandingSettings.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.
-
targeting.languages[]
: Eine Liste der Sprachen für die YouTube-Bewerbung. Nutzer, die eine dieser Sprachen ausgewählt haben, sehen den entsprechenden Kanalabschnitt. -
targeting.regions[]
: Eine Liste der bevorzugten Inhaltsregionen für YouTube. Der Kanalabschnitt ist für Nutzer sichtbar, die eine dieser Regionen ausgewählt haben sowie für Nutzer, für die eine dieser Regionen automatisch ausgewählt wird. -
targeting.countries[]
: Eine Liste der Länder, in denen der Kanalbereich sichtbar ist. Jeder Wert in der Liste ist ein ISO 3166-1 Alpha-2-Ländercode.
-
-
Die Definition des Attributs
contentDetails.duration
der Ressourcevideo
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
undvideos.delete
wurde so korrigiert, dass sie alle den HTTP-Antwortcode204
(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
undchannelSections.update
geben diesen Fehler zurück, wenn die eingefügte RessourcechannelSection
einen ungültigen Wert für das Attributtargeting.countries[]
enthält.badRequest (400)
targetInvalidLanguage
Die Methoden channelSections.insert
undchannelSections.update
geben diesen Fehler zurück, wenn die eingefügte RessourcechannelSection
einen ungültigen Wert für das Attributtargeting.languages[]
enthält.badRequest (400)
targetInvalidRegion
Die Methoden channelSections.insert
undchannelSections.update
geben diesen Fehler zurück, wenn die eingefügte RessourcechannelSection
einen ungültigen Wert für das Attributtargeting.regions[]
enthält.badRequest (400)
operationNotSupported
Die Methode comments.insert
gibt diesen Fehler zurück, wenn der API-Nutzer keinen Kommentar als Antwort auf den Kommentar der obersten Ebene einfügen kann, der durch die Eigenschaftsnippet.parentId
gekennzeichnet ist. In einercommentThread
-Ressource gibt das Attributsnippet.canReply
an, ob der aktuelle Betrachter auf den Thread antworten kann.badRequest (400)
invalidChannelId
Die Methode search.list
gibt diesen Fehler zurück, wenn derchannelId
-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 FehlerinvalidMetadata
undvideoNotFound
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
undcomment
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. EinecommentThread
-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 RessourcecommentThread
verschachtelt sind. Beachten Sie, dass die RessourcecommentThread
nicht unbedingt alle Antworten auf einen Kommentar enthält. Sie müssen die Methodecomments.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 Methodecomments.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. Einecomment
-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 änderncomments.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 Methodencomments.insert
,comments.update
,comments.markAsSpam
,comments.setModerationStatus
,comments.delete
,commentThreads.insert
undcommentThreads.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 Bereichhttps://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 Parameterrating
enthielt. -
Die Methode
subscriptions.insert
unterstützt den FehlersubscriptionLimitExceeded
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 Bereichhttps://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 Parameterwerthome
auftrue
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 PropertiescontentDetails.recommendation.reason
undcontentDetails.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. -
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 Parameterwerthome
auftrue
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. -
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
undvideos.list
der API-Version 3 unterstützen einenid
-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
undchannelSections.update
unterstützen jetzt den ParameteronBehalfOfContentOwner
, 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 dervideo
-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 Parameterid
der Anfrage einen Kanal angibt, der nicht gefunden werden kann.badRequest (400)
manualSortRequiredinvalidValue
Die Methoden playlistItems.insert
undplaylistItems.update
geben diesen Fehler zurück, wenn 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 Elementsnippet.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 derchannelId
-Parameter der Anfrage einen geschlossenen Kanal angibt.forbidden (403)
channelSuspended
Die Methode playlists.list
gibt diesen Fehler zurück, wenn derchannelId
-Parameter der Anfrage einen gesperrten Kanal angibt.forbidden (403)
playlistForbidden
Die Methode playlists.list
gibt diesen Fehler zurück, wenn derid
-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 ParameterchannelId
der Anfrage einen Kanal angibt, der nicht gefunden werden kann.notFound (404)
playlistNotFound
Die Methode playlists.list
gibt diesen Fehler zurück, wenn derid
-Parameter der Anfrage eine Playlist angibt, die nicht gefunden werden kann.notFound (404)
videoNotFound
Die Methode videos.list
gibt diesen Fehler zurück, wenn derid
-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 Parameterrating
enthält.
2. März 2015
Dieses Update enthält die folgenden Änderungen:
-
Die Methode
search.list
unterstützt jetzt den ParameterrelevanceLanguage
, mit dem Sie Ergebnisse anfordern können, die für eine bestimmte Sprache am relevantesten sind.In der Migrationsanleitung für die YouTube Data API (Version 3) wurde die Verwendung dieses neuen Parameters erläutert. Der Parameter schließt eine Funktionslücke, die zwischen der aktuellen API-Version (v3) und der Vorgängerversion (v2) bestand, die bereits eingestellt wurde.
-
Die Migrationsanleitung für die YouTube Data API (Version 3) wurde ebenfalls aktualisiert, um darauf hinzuweisen, dass die speziellen Feeds und Metadatenfelder, die die API Version 2 zur Beschreibung von Filmen, Trailern, TV-Sendungen, TV-Staffeln und TV-Folgen bereitgestellt hat, eingestellt werden.
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 nachGoogleDevelopers
. -
Kontingentkosten: 6 Einheiten
Rufen Sie die Methode
channels.list
auf, um die richtige Kanal-ID zu ermitteln. Setzen Sie den ParameterforUsername
aufGoogleDevelopers
und den Parameterpart
aufcontentDetails
. In der API-Antwort gibt die EigenschaftcontentDetails.relatedPlaylists.uploads
die Playlist-ID für die hochgeladenen Videos des Kanals an.Rufen Sie dann die Methode
playlistItems.list
auf und legen Sie für den ParameterplaylistId
die erfasste ID und den Parameterpart
aufsnippet
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
undsnippet.categoryId
der Ressourcevideo
wurden aktualisiert, um zu verdeutlichen, wie die API Aufrufe der Methodevideos.update
verarbeitet. Wenn Sie diese Methode aufrufen, um densnippet
-Teil einervideo
-Ressource zu aktualisieren, müssen Sie für beide Attribute einen Wert festlegen.Wenn Sie versuchen, den
snippet
-Teil einervideo
-Ressource zu aktualisieren und keinen Wert für beide Attribute festlegen, gibt die API den FehlerinvalidRequest
zurück. Die Beschreibung dieses Fehlers wurde ebenfalls aktualisiert. -
Die Eigenschaft
contentDetails.contentRating.oflcRating
der Ressourcevideo
, die die Bewertung eines Videos durch das neuseeländische Office of Film and Literature Classification angibt, unterstützt jetzt zwei neue Bewertungen:oflcRp13
undoflcRp16
. Diese entsprechen den BewertungenRP13
undRP16
. -
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 Methodesubscriptions.insert
verursacht beispielsweise Kontingentkosten von etwa 50 Einheiten. Die Ressourcesubscription
enthält ebenfalls drei Teile (snippet
,contentDetails
undsubscriberSnippet
), 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 Parameterlocation
undlocationRadius
, 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 Ressourcechannel
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 FehlertooManyPromotedItems
mit dem HTTP-Statuscode400
zurück. -
Die Ressource
channelSection
kann jetzt Informationen zu neuen Arten von empfohlenen Inhalten enthalten. Das Attributsnippet.type
der RessourcechannelSection
unterstützt jetzt die folgenden Werte:postedPlaylists
: Playlists, die vom Kanalinhaber im Aktivitätsfeed des Kanals gepostet wurdenpostedVideos
: Videos, die der Kanalinhaber im Aktivitätsfeed des Kanals gepostet hatsubscriptions
: Kanäle, die der Kanalinhaber abonniert hat
-
Die neue
contentDetails.contentRating.ifcoRating
-Eigenschaft dervideo
-Ressource gibt die Bewertung an, die ein Video vom Irish Film Classification Office erhalten hat. -
Die Definition der Eigenschaft
position.cornerPosition
der Ressourcewatermark
wurde aktualisiert, sodass das Wasserzeichen immer oben rechts im Player angezeigt wird. -
Die Definition des
q
-Parameters für diesearch.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 einensearch.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 EigenschaftswertenextPageToken
undprevPageToken
, um zu bestimmen, ob Paginierungslinks angezeigt werden sollen. -
Die Methoden
watermarks.set
undwatermarks.unset
wurden aktualisiert, um zu verdeutlichen, dass die API den HTTP-Antwortcode204
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 wievideoCategories.list
undguideCategories.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 wiesearch.list
,videos.list
,activities.list
undvideoCategories.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 dervideo
-Ressource wurde aktualisiert, um zu erklären, dass dieses Objekt nur zurückgegeben wird, wenn dieprocessingDetails.fileDetailsAvailability
-Eigenschaft des Videos den Wertavailable
hat.In ähnlicher Weise wurde die Definition des
suggestions
-Objekts dervideo
-Ressource aktualisiert, um zu erklären, dass dieses Objekt nur zurückgegeben wird, wenn dieprocessingDetails.tagSuggestionsAvailability
-Eigenschaft des Videos oder dieprocessingDetails.editorSuggestionsAvailability
-Eigenschaft des Videos den Wertavailable
hat. -
Die Dokumentation für die Methoden
videos.insert
undvideos.update
wurde aktualisiert, um zu verdeutlichen, dass das Attributstatus.publishAt
beim Aufrufen dieser Methoden festgelegt werden kann. -
Die Definition des
invideoPromotion
-Objekts der Ressourcechannel
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 ParameteronBehalfOfContentOwner
nicht unterstützt. Dies war ein Dokumentationsfehler, davideos.rate
-Anfragen, die diesen Parameter festlegen, den Fehler500
zurückgeben.
31. März 2014
Dieses Update enthält die folgenden Änderungen:
-
Mit dem neuen Attribut
status.publishAt
der Ressourcevideo
können Sie das Datum und die Uhrzeit für die geplante Veröffentlichung eines privaten Videos angeben. Diese Eigenschaft kann nur festgelegt werden, wenn der Datenschutzstatus des Videosprivate
lautet und das Video nie veröffentlicht wurde. Diese neue Property unterliegt nicht der Richtlinie zur Einstellung von Produkten und Diensten.
13. März 2014
Dieses Update enthält die folgenden Änderungen:
-
Die API unterstützt jetzt den
contentOwnerDetails
-Teil fürchannel
-Ressourcen. Der neue Teil enthält Kanaldaten, die für YouTube-Partner 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 Ressourcechannel
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, denbrandingSettings
-Teil eines Kanals zu aktualisieren und den Wert derbrandingSettings.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 EigenschaftinvideoPromotion.items[].id.recentlyUploadedBy
eine ungültige Kanal-ID angibt.badRequest (400)
invalidTimingOffset
Die Methode channels.update
gibt diesen Fehler zurück, wenn derinvideoPromotion
-Teil einen ungültigen Zeitversatz angibt.badRequest (400)
tooManyPromotedItems
Die Methode channels.update
gibt diesen Fehler zurück, wenn derinvideoPromotion
-Teil die zulässige Anzahl von beworbenen Artikeln überschreitet.forbidden (403)
promotedVideoNotAllowed
Die Methode channels.update
gibt diesen Fehler zurück, wenn die EigenschaftinvideoPromotion.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 EigenschaftinvideoPromotion.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 eininvideoPromotion.items[].timing
-Objekt angegeben werden.required (400)
requiredWebsiteUrl
In der Methode channels.update
muss für jedes beworbene Element eineinvideoPromotion.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:
-
Die YouTube Data API, Version 3, unterliegt jetzt der Richtlinie zur Einstellung von Produkten und Diensten, die in den Nutzungsbedingungen für YouTube APIs beschrieben wird. Hinweis: Auf der Seite mit den APIs, die der Richtlinie zur Einstellung von Produkten und Diensten unterliegen, sind einige API-Funktionen der Version 3 ausdrücklich von der Richtlinie ausgeschlossen.
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 Parameterstype
aufvideo
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 desbrandingSettings.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.
- Der Wert des Attributs
-
Die Methode
channels.update
unterstützt jetzt Aktualisierungen des AttributsinvideoPromotion.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 ParameteronBehalfOfContentOwner
erfolgt. -
Die Methoden
playlistItems.list
undplaylistItems.insert
unterstützen jetzt den ParameteronBehalfOfContentOwner
, 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
undcontentDetails.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 RessourcevideoCategory
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:
activities.insert
(Go)channelBanners.insert
(Python)channels.update
(Python)playlistItems.list
(Go)search.list
(Go)thumbnails.set
(Java)videos.insert
(Go)
24. Oktober 2013
Dieses Update enthält die folgenden Änderungen:
-
Die API enthält zwei zusätzliche Funktionen 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 sindupcoming
,active
undnone
.-
Die neue Eigenschaft
snippet.liveBroadcastContent
der Ressourcevideo
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 Ressourcevideo
ist ein Objekt, das Metadaten zu einer Live-Videoübertragung enthält. Zum Abrufen dieser Metadaten nehmen SieliveStreamingDetails
in die Liste der Ressourcenteile des Parameterwertspart
auf. Die Metadaten enthalten die folgenden neuen Properties:liveStreamingDetails.actualStartTime
: Der Zeitpunkt, zu dem die Übertragung tatsächlich gestartet wurde. Dieser Wert ist vorhanden, sobald der Status der Übertragungactive
ist.liveStreamingDetails.actualEndTime
: Der Zeitpunkt, zu dem die Übertragung tatsächlich beendet wurde. (Dieser Wert ist vorhanden, sobald die Übertragung beendet ist.)liveStreamingDetails.scheduledStartTime
: Der Zeitpunkt, zu dem die Übertragung geplant ist.liveStreamingDetails.scheduledEndTime
: Der Zeitpunkt, zu dem die Übertragung planmäßig endet. Wenn der Eigenschaftswert leer oder die Eigenschaft nicht vorhanden ist, wird die Übertragung auf unbestimmte Zeit geplant.liveStreamingDetails.concurrentViewers
: Die Anzahl der Personen, die die Liveübertragung ansehen.
Zum Abrufen dieser Metadaten fügen Sie
liveStreamingDetails
in den Parameterwertpart
ein, wenn Sie die Methodevideos.list
,videos.insert
odervideos.update
aufrufen.
Am 1. Oktober 2013 wurden zwei weitere Funktionen zur Identifizierung von Liveübertragungen veröffentlicht: der Parameter
eventType
der Methodesearch.list
und die Eigenschaftsnippet.liveBroadcastContent
des Suchergebnisses. -
-
Die Methode
videos.insert
unterstützt jetzt den ParameternotifySubscribers
, der angibt, ob YouTube eine Benachrichtigung über das neue Video an Nutzer senden soll, die den Kanal des Videos abonnieren. Der Standardwert des Parameters lautetTrue
. Dies bedeutet, dass Abonnenten über neu hochgeladene Videos benachrichtigt werden. Ein Kanalinhaber, der viele Videos hochlädt, kann den Wert jedoch aufFalse
setzen, damit die Abonnenten des Kanals nicht über jedes neue Video benachrichtigt werden. -
Die Liste der Attribute, die beim Aufrufen der Methode
channels.update
geändert werden können, wurde aktualisiert und enthält jetzt die AttributeinvideoPromotion.items[].customMessage
undinvideoPromotion.items[].websiteUrl
. Außerdem wurde die Liste geändert, um diebrandingSettings
-Eigenschaften anzugeben, die änderbar sind. DiesebrandingSettings
-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
undplaylists.delete
unterstützen jetzt den ParameteronBehalfOfContentOwner
, der bereits für mehrere andere Methoden unterstützt wird. -
Die Methode
playlists.insert
unterstützt jetzt den ParameteronBehalfOfContentOwnerChannel
, der bereits für mehrere andere Methoden unterstützt wird. -
Das Attribut
contentDetails.contentRating.tvpgRating
der Ressourcevideo
unterstützt jetzt den Wertpg14
, der der BewertungTV-14
entspricht. -
Die Definition der
snippet.liveBroadcastContent
-Eigenschaft, die Teil der Suchergebnisse ist, wurde korrigiert. Sie zeigt jetzt, dasslive
ein gültiger Eigenschaftswert ist,active
aber kein gültiger Eigenschaftswert. -
Das Attribut
contentDetails.contentRating.mibacRating
der Ressourcevideo
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 Ressourcechannel
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 ParameteronBehalfOfContentOwner
.
1. Oktober 2013
Dieses Update enthält die folgenden Änderungen:
-
Das neue
auditDetails
-Objekt der Ressourcechannel
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 Bereichhttps://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 Ressourcechannel
unterstützt jetzt den WertrecentUpload
. 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
undbrandingSettings.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 sindupcoming
,active
undnone
.- Bei einer
video
-Ressource gibt der Wertupcoming
an, dass es sich um eine Liveübertragung handelt, die noch nicht gestartet wurde. Der Wertactive
hingegen gibt an, dass es sich um eine laufende Liveübertragung handelt. - Bei einer
channel
-Ressource gibt der Wertupcoming
an, dass der Kanal eine geplante Übertragung hat, die noch nicht begonnen hat, während der Wertacive
darauf hinweist, dass auf dem Kanal eine laufende Liveübertragung läuft.
- Bei einer
-
In der Ressource
watermark
wurde das AttributtargetChannelId
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 EigenschafttargetChannelId
jetzt diesen Wert selbst an. Entsprechend wurde auch das AttributtargetChannelId.value
der Ressource entfernt. -
Die Methode
thumbnails.set
unterstützt jetzt den ParameteronBehalfOfContentOwner
, der bereits für mehrere andere Methoden unterstützt wird. -
Die Methode
search.list
unterstützt jetzt den ParametereventType
, der die Suche auf aktive, anstehende oder abgeschlossene Übertragungsereignisse 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 Methodewatermarks.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
undwatermarks.unset
unterstützt werden. -
Die neue
statistics.hiddenSubscriberCount
-Eigenschaft der Ressourcechannel
enthält einen booleschen Wert, der angibt, ob die Anzahl der Abonnenten des Kanals ausgeblendet ist. Der Wert der Property lautet daherfalse
, wenn die Abonnentenzahl des Kanals öffentlich sichtbar ist. -
Die Methode
playlists.list
unterstützt jetzt die ParameteronBehalfOfContentOwner
undonBehalfOfContentOwnerChannel
. Beide Parameter werden bereits für verschiedene andere Methoden unterstützt. -
Die Methode
videos.list
unterstützt jetzt den ParameterregionCode
, der den Inhaltsbereich angibt, für den ein Diagramm abgerufen werden soll. Dieser Parameter kann nur in Verbindung mit dem Parameterchart
verwendet werden. Der Parameterwert ist ein 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 Ressourcechannel
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 aufwebsite
und verwenden Sie die neueinvideoPromotion.items[].id.websiteUrl
-Eigenschaft, um die URL anzugeben. Mit der neueninvideoPromotion.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 OrdnerinvideoPromotion.items[].timing
verschoben. Mit diesem Objekt kannst du jetzt die Zeitdaten für jedes beworbene Element in derinvideoPromotion.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 deminvideoPromotion.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). DasinvideoPromotion.defaultTiming
-Objekt enthält auch eindurationMs
-Feld, das die Standarddauer angibt, für die das hochgestufte Element angezeigt wird.
-
-
Die Eigenschaften
invideoPromotion.items[].type
undinvideoPromotion.items[].videoId
wurden in das ObjektinvideoPromotion.items[].id
verschoben.
-
-
Die Methode
subscriptions.list
unterstützt jetzt die ParameteronBehalfOfContentOwner
undonBehalfOfContentOwnerChannel
. Beide Parameter werden bereits für verschiedene andere Methoden unterstützt. -
In der API-Antwort auf eine
thumbnails.set
-Anfrage wurde derkind
-Eigenschaftswert vonyoutube#thumbnailListResponse
inyoutube#thumbnailSetResponse
geändert. -
Codebeispiele wurden für die folgenden Methoden hinzugefügt:
channels.update
(Java, Python)playlists.insert
(.NET, PHP)subscriptions.insert
(PHP, Python)thumbnails.set
(PHP, Python)videos.insert
(PHP)videos.list
(PHP)videos.rate
(Python)videos.update
(Java, PHP, Python)
Beachten Sie, dass auch das Python-Beispiel für die Methode
playlistItems.insert
entfernt wurde, da die hier gezeigte Funktionalität jetzt von der Methodevideos.rate
ausgeführt wird. -
In
error documentation
wird der folgende neue Anfragekontextfehler beschrieben, der bei jeder API-Methode auftreten kann, die den Anfrageparametermine
unterstützt:Fehlertyp Fehlerdetails Beschreibung badRequest
invalidMine
Der Parameter mine
kann nicht in Anfragen verwendet werden, bei denen der authentifizierte Nutzer ein YouTube-Partner ist. Du kannst entweder denmine
-Parameter entfernen, dich als YouTube-Nutzer durch Entfernen desonBehalfOfContentOwner
-Parameters authentifizieren oder als einer der Partnerkanäle agieren, indem du denonBehalfOfContentOwnerChannel
-Parameter angibst, sofern dieser für die aufgerufene Methode verfügbar ist.
8. August 2013
Dieses Update enthält die folgenden Änderungen:
-
Der Abschnitt Kontingentnutzung in der Anleitung Erste Schritte mit der YouTube Data API wurde aktualisiert, um eine Änderung der Kontingentkosten für Video-Uploads von ungefähr 16.000 auf ungefähr 1.600 Einheiten zu berücksichtigen.
30. Juli 2013
Dieses Update enthält die folgenden Änderungen:
-
In einer
channelBanner
-Ressource wurde der Wert des Attributskind
vonyoutube#channelBannerInsertResponse
inyoutube#channelBannerResource
geändert. Diese Ressource wird als Antwort auf einechannelBanners.insert
-Anfrage zurückgegeben. -
Die neue
brandingSettings.channel.profileColor
-Eigenschaft derchannel
-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 Ressourcesubscription
gibt die Aktivitätstypen an, über die der Abonnent benachrichtigt wird. Gültige Attributwerte sindall
unduploads
. -
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 WertmostPopular
unterstützt. Derchart
-Parameter ist ein Filterparameter. Er kann also nicht in derselben Anfrage wie andere Filterparameter (id
undmyRating
) verwendet werden. - Der Parameter
videoCategoryId
gibt die Videokategorie an, für die das Diagramm abgerufen werden soll. Dieser Parameter kann nur in Verbindung mit dem Parameterchart
verwendet werden. Standardmäßig sind Diagramme nicht auf eine bestimmte Kategorie beschränkt.
- Der Parameter
-
Das neue Attribut
topicDetails.relevantTopicIds[]
dervideo
-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 Ressourcevideo
wurde inrecordingDetails.location.altitude
und die EigenschaftfileDetails.recordingLocation.location.elevation
der Ressource infileDetails.recordingLocation.location.altitude
umbenannt. -
Das
contentDetails.contentRating
-Objekt dervideo
-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 Ressourcevideo
identifiziert Inhalte mit Altersbeschränkung. Der Property-Wert istytAgeRestricted
, 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 Methodechannels.list
wurde eingestellt. Mit der Methodesubscriptions.list
und dem zugehörigen ParametermySubscribers
kannst du eine Liste der Abonnenten des Kanals des authentifizierten Nutzers abrufen. -
Die Methoden
channelBanners.insert
,channels.update
,videos.getRating
undvideos.rate
unterstützen jetzt den ParameteronBehalfOfContentOwner
. Dieser Parameter gibt an, dass der authentifizierte Nutzer im Namen des im Parameterwert angegebenen Rechteinhabers handelt. -
Die Dokumentation der Methode
channels.update
wurde aktualisiert, um zu verdeutlichen, dass diese Methode zum Aktualisieren desbrandingSettings
-Objekts der Ressourcechannel
und ihrer untergeordneten Attribute verwendet werden kann. In der Dokumentation wird jetzt auch die aktualisierte Liste der Attribute aufgeführt, die Sie für dasinvideoPromotion
-Objekt der Ressourcechannel
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 ParameteronBehalfOfContentOwnerChannel
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 Attributsid
im Anfragetext korrekt ist.
10. Juni 2013
Dieses Update enthält die folgenden Änderungen:
-
Mit dem neuen
forUsername
-Parameter derchannels.list
-Methode kannst du Informationen zu einem Kanal abrufen, indem du seinen YouTube-Nutzernamen gibst. -
Die Methode
activities.list
unterstützt jetzt den ParameterregionCode
, der die API anweist, Ergebnisse zurückzugeben, die für das angegebene Land relevant sind. YouTube verwendet diesen Wert, wenn die 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 Methodeplaylists.insert
oderplaylists.update
aufrufen. -
Der Parameter
onBehalfOfContentOwner
, der zuvor für die Methodenchannels.list
undsearch.list
unterstützt wurde, wird jetzt auch für die Methodenvideos.insert
,videos.update
undvideos.delete
unterstützt. Wenn dieser Parameter in einem Aufruf der Methodevideos.insert
verwendet wird, muss in der Anfrage auch ein Wert für den neuenonBehalfOfContentOwnerChannel
-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 ParameteronBehalfOfContentOwner
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 Parameterhome
verwendet, aber nicht korrekt autorisiert ist. -
In der Ressource
channels
wurde das AttributinvideoPromotion.channelId
entfernt, da die Kanal-ID bereits über das Attributid
der Ressource angegeben wurde. -
Im neuen Leitfaden Mit Kanal-IDs arbeiten wird erläutert, wie Kanal-IDs in der API verwendet werden. Das Handbuch ist besonders für Entwickler hilfreich, die von der vorherigen Version der API migrieren und Anwendungen haben, die entweder Inhalte für den
default
-Nutzer anfordern oder 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:
-
Mit der neuen Methode
channelBanners.insert
können Sie ein Bannerbild hochladen, das anschließend mithilfe der neuen EigenschaftbrandingSettings.image.bannerExternalUrl
derchannel
-Ressource als Bannerbild für einen Kanal festgelegt werden kann. -
Die Dokumentation für die Methode
channels.update
wurde aktualisiert und listet nun die Attribute auf, die beim Aufrufen der Methode geändert werden können. -
In der
video
-Ressourcendokumentation wirdunspecified
nicht mehr als gültiger Attributwert für die Attributesuggestions.processingErrors[]
,suggestions.processingHints[]
,suggestions.processingWarnings[]
undsuggestions.editorSuggestions[]
aufgeführt. -
Der Parameter
maxResults
der Methodevideos.list
hat jetzt den Standardwert5
. -
In
error documentation
werden jetzt Fehler für die MethodenchannelBanners.insert
undsubscriptions.list
aufgelistet. Außerdem werden mehrere neue Fehler für die Methodechannels.update
aufgelistet.
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:
-
YouTube identifiziert keine experimentellen API-Funktionen und -Dienste mehr. Stattdessen stellen wir jetzt eine Liste der YouTube APIs bereit, die der Richtlinie zur Einstellung von Produkten und Diensten unterliegen.
8. Mai 2013
Dieses Update enthält die folgenden Änderungen:
-
Kanalressourcen unterstützen jetzt das
inVideoPromotion
-Objekt, das Informationen zu einer 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 Parameterwertpart
in einerchannels.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 desinvideoPromotion
-Teils derchannel
-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 dervideos.list
-Methode kannst du eine Liste von Videos abrufen, die der authentifizierte Nutzer mit der Einstufunglike
oderdislike
bewertet hat.Sowohl der
myRating
-Parameter als auch derid
-Parameter gelten jetzt als Filterparameter. Das bedeutet, dass in einer API-Anfrage genau einer dieser Parameter angegeben werden muss. Bisher war derid
-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 dievideos.list
-Methode aktualisiert, damit sie die Paginierung unterstützt. Beachten Sie jedoch, dass Paging-Parameter nur für Anfragen mit demmyRating
-Parameter unterstützt werden. Seitenumbruchparameter und -informationen werden für Anfragen mit dem Parameterid
nicht unterstützt.-
Der
maxResults
-Parameter gibt die maximale Anzahl von Videos an, die die API in der Ergebnismenge zurückgeben kann, und derpageToken
-Parameter gibt eine bestimmte Seite in der Ergebnismenge an, die du abrufen möchtest. -
Die Ressource
youtube#videoListResponse
, die als Antwort auf einevideos.list
-Anfrage zurückgegeben wird, enthält jetzt das ObjektpageInfo
, das Details wie die Gesamtzahl der Ergebnisse und die Anzahl der Ergebnisse in der aktuellen Ergebnismenge enthält. Die Ressourceyoutube#videoListResponse
kann auch die AttributenextPageToken
undprevPageToken
enthalten, die jeweils ein Token bereitstellen, mit dem eine bestimmte Seite im Ergebnissatz abgerufen werden kann.
-
-
Die Methode
videos.insert
unterstützt die folgenden neuen Parameter:autoLevels
: Setze diesen Parameterwert auftrue
, um YouTube anzuweisen, Licht und Farbe des Videos automatisch zu optimieren.stabilize
: Setze diesen Parameterwert auftrue
, um YouTube anzuweisen, wackelige Bewegungen aufgrund von Kamerabewegungen zu entfernen.
-
Das Attribut
channelTitle
wurde demsnippet
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:
activities.insert
(Ruby)playlistItems.list
(.NET)search.list
(.NET)subscriptions.insert
(Java, Ruby)videos.insert
(.NET, Ruby)
-
Mit dem neuen Parameter
mySubscribers
der Methodesubscriptions.list
können Sie eine Liste der Abonnenten des 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 Methodechannels.list
unterstützt wird. Dieser Parameter wird eingestellt. -
In einer
video
-Ressource ist der Attributwertunspecified
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 istunexpectedParameter
. -
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 alsforbidden
-Fehler mit der FehlerursacheplaylistContainsMaximumNumberOfVideos
gemeldet.
19. April 2013
Dieses Update enthält die folgenden Änderungen:
-
Mit der neuen
videos.rate
-Methode können Nutzer einelike
- oderdislike
-Bewertung für ein Video festlegen oder eine Bewertung 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 Ressourcechannel
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 Attributstatus.privacyStatus
gibt den Datenschutzstatus des Playlist-Elements an.
-
-
Die Ressource
video
enthält die folgenden neuen Attribute:-
Die Eigenschaft
status.publicStatsViewable
gibt an, ob die erweiterten Videostatistiken auf der Wiedergabeseite öffentlich einsehbar sind. Standardmäßig sind diese Statistiken sichtbar. Statistiken wie die Anzahl der Aufrufe und Bewertungen eines Videos sind auch dann öffentlich sichtbar, wenn der Wert dieser Property auffalse
gesetzt ist. Sie können den Wert dieses Attributs festlegen, wenn Sie die Methodevideos.insert
odervideos.update
aufrufen. -
Das
contentDetails.contentRating
-Objekt enthält die Bewertungen, die das Video bei verschiedenen Einstufungsschemata erhalten hat. In der folgenden Liste sind die unterstützten Bewertungssysteme aufgeführt. Außerdem finden Sie dort einen Link zu der Unterkunft, die dem jeweiligen Bewertungssystem zugeordnet ist. Die Property-Definitionen geben die unterstützten Bewertungswerte für jedes System an.Land Bewertungssystem Attribut USA Motion Picture Association of America (MPAA) contentDetails.contentRating.mpaaRating
USA TV Parental Guidelines contentDetails.contentRating.tvpgRating
Australien Australian Classification Board (ACB) contentDetails.contentRating.acbRating
Brasilien Departamento de Justiça, Classificação, Qualificação e Títulos contentDetails.contentRating.djctqRating
Kanada Canadian Home Video Rating System (CHVRS) contentDetails.contentRating.chvrsRating
Frankreich Centre national du cinéma et de l'image animée (französisches Kulturministerium) contentDetails.contentRating.fmocRating
Deutschland Freiwillige Selbstkontrolle der Filmwirtschaft (FSK) contentDetails.contentRating.fskRating
Großbritannien British Board of Film Classification (BBFC) contentDetails.contentRating.bbfcRating
Indien Central Board of Film Certification (CBFC) (Central Board of Film Certification, CBFC) contentDetails.contentRating.cbfcRating
Japan 映倫管理委員號 (EIRIN) contentDetails.contentRating.eirinRating
Korea 영상물등號위원회 (KMRB) contentDetails.contentRating.kmrbRating
Mexiko General Directorate of Radio, Television and Cinematography (RTC) contentDetails.contentRating.rtcRating
Neuseeland Büro für Film- und Literaturklassifizierung contentDetails.contentRating.oflcRating
Russland National Film Registry der Russischen Föderation contentDetails.contentRating.russiaRating
Spanien Instituto de la Cinematografía y de las Artes Audiovisuales (ICAA) contentDetails.contentRating.icaaRating
-
-
Die Dokumentation der Methode
playlistItems.update
wurde aktualisiert, um zu verdeutlichen, dass das Attributsnippet.resourceId
in der Ressource angegeben werden muss, die als Anfragetext gesendet wird. -
Die Methode
search.list
unterstützt jetzt die folgenden Funktionen:-
Der neue
forMine
-Parameter schränkt 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 MethodevideoCategories.list
, um unterstützte Kategorien abzurufen.badRequest
invalidRecordingDetails
metadata specifies invalid recording details.
badRequest
invalidVideoGameRating
Die Metadaten der Anfrage geben eine ungültige Altersfreigabe für das Videospiel an. badRequest
invalidVideoMetadata
Die Metadaten der Anfrage sind ungültig. -
Der Parameter
onBehalfOfContentOwner
wurde aus der Liste der unterstützten Parameter für die Methodenvideos.update
undvideos.delete
entfernt.
12. März 2013
Dieses Update enthält die folgenden Änderungen:
-
Das Attribut
channelTitle
wurde demsnippet
für die folgenden Ressourcen hinzugefügt:activity
: Die 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 Ressourcevideo
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 eineninvalidSnippet
-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
undvideos.update
unterstützen diesen Parameter. -
Der
managedByMe
-Parameter, der von derchannels.list
-Methode unterstützt wird, weist die API an, alle Kanäle des Rechteinhabers zurückzugeben, die imonBehalfOfContentOwner
-Parameter angegeben sind. -
Der
forContentOwner
-Parameter, der von dersearch.list
-Methode unterstützt wird, weist die API an, die Suchergebnisse auf Ressourcen zu beschränken, die dem Rechteinhaber gehören, der imonBehalfOfContentOwner
-Parameter angegeben ist.
-
25. Februar 2013
Dieses Update enthält die folgenden Änderungen:
-
Die API unterstützt mehrere neue Teile und Attribute für
video
-Ressourcen:-
Die neuen Teile für
fileDetails
,processingDetails
undsuggestions
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 sindcreativeCommon
undyoutube
.
-
-
Die Definition des Parameters
part
wurde für die Methodenvideos.list
,videos.insert
undvideos.update
aktualisiert, um die oben beschriebenen neu hinzugefügten Teile sowie den TeilrecordingDetails
aufzulisten, der versehentlich ausgelassen wurde. -
Die neue
contentDetails.googlePlusUserId
-Eigenschaft derchannel
-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
undvideo
zurückgegeben. -
playlistItems.list
unterstützt jetzt denvideoId
-Parameter, der in Verbindung mit demplaylistId
-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 Ressourcechannel
wurde entfernt. Das Attributid
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:
activities.insert
: JavaplaylistItems.insert
– PythonplaylistItems.list
: Java, JavaScript, PHP, Python, Rubyplaylists.insert
: Java, JavaScript, Pythonsearch.list
: Java, JavaScript, Python, Rubyvideos.insert
: Java
-
Eine
activity
-Ressource kann jetzt einechannelItem
-Aktion melden. 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 inrelatedToVideoId
umbenannt. - Der Parameter
published
wurde durch die beiden neuen ParameterpublishedAfter
undpublishedBefore
ersetzt, die im Folgenden beschrieben werden.
- Der Parameter
-
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 einekind
-Eigenschaft, die den Ressourcentyp angibt, z. B. Video oder Playlist. Es enthält außerdem genau eines von mehreren Attributen, z. B.videoId
oderplaylistId
, 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
undpublic
.playlist
contentDetails
object
Dieses Objekt enthält Metadaten zum Inhalt der Playlist. playlist
contentDetails.itemCount
unsigned integer
Die Anzahl der Videos in der Playlist. playlist
player
object
Dieses Objekt enthält Informationen, die du 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
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.