PlaylistItems: update

Ändert einen Playlist-Inhalt. Du kannst beispielsweise die Position des Elements in der Playlist aktualisieren.

Auswirkungen auf Kontingente:Bei einem Aufruf dieser Methode fallen Kontingentkosten von 50 Einheiten an.

Gängige Anwendungsfälle

Anfragen

HTTP-Anfrage

PUT https://www.googleapis.com/youtube/v3/playlistItems

Autorisierung

Diese Anfrage benötigt eine Autorisierung mit mindestens einem der folgenden Bereiche (weitere Informationen zu Authentifizierung und Autorisierung).

Umfang
https://www.googleapis.com/auth/youtubepartner
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

Parameter

In der folgenden Tabelle sind die Parameter aufgeführt, die von dieser Abfrage unterstützt werden. Alle aufgeführten Parameter sind Abfrageparameter.

Parameter
Erforderliche Parameter
part string
Der Parameter part dient in diesem Vorgang zwei Zwecken. Damit werden die Attribute festgelegt, die der Schreibvorgang festlegt, sowie die Attribute, die in der API-Antwort enthalten sind.

Diese Methode überschreibt die vorhandenen Werte für alle änderbaren Attribute, die in den vom Parameterwert angegebenen Teilen enthalten sind. Beispielsweise kann ein Playlist-Eintrag eine Start- und Endzeit angeben, um festzulegen, zu welchem Zeitpunkt das Video wiedergegeben werden soll, wenn sich Nutzer das Video in der Playlist ansehen. Wenn deine Anfrage ein Playlist-Element aktualisiert, das diese Werte festlegt, und der part-Parameterwert der Anfrage den contentDetails-Teil enthält, werden die Start- und Endzeiten des Playlist-Elements auf den Wert aktualisiert, den der Anfragetext angibt. Wenn im Anfragetext keine Werte angegeben sind, werden die vorhandenen Start- und Endzeiten entfernt und durch die Standardeinstellungen ersetzt.

Die folgende Liste enthält die part-Namen, die du in den Parameterwert aufnehmen kannst:
  • contentDetails
  • id
  • snippet
  • status
Optionale Parameter
onBehalfOfContentOwner string
Hinweis:Der Parameter onBehalfOfContentOwner ist ausschließlich für Content-Partner von YouTube vorgesehen und kann nur in einer ordnungsgemäß autorisierten Anfrage verwendet werden.

Dieser Parameter ist für YouTube-Content-Partner vorgesehen, die viele verschiedene YouTube-Kanäle besitzen und verwalten. Nutzer, die mit dem Rechteinhaber verknüpft sind, können sich einmalig authentifizieren und dann auf alle Video- und Kanaldaten des Rechteinhabers zugreifen und diese verwalten, ohne für jeden einzelnen Kanal Anmeldedaten zur Authentifizierung angeben zu müssen.

Wenn der Parameter vorhanden ist, gibt sein Wert einen Rechteinhaber an und die Autorisierungsanmeldedaten der Anfrage identifizieren einen YouTube-Nutzer, der berechtigt ist, im Namen dieses Rechteinhabers zu handeln. Das Konto, mit dem sich der Nutzer authentifiziert, muss in den Einstellungen von YouTube Studio mit dem angegebenen Rechteinhaber verknüpft sein.

Anfragetext

Geben Sie im Anfragetext eine playlistItem-Ressource an. Für diese Ressource:

  • Für diese Eigenschaften müssen Sie einen Wert angeben:

    • id
    • snippet.playlistId
    • snippet.resourceId

  • Sie können Werte für diese Attribute festlegen:

    • snippet.position
    • contentDetails.note
    • contentDetails.startAt
    • contentDetails.endAt

    Wenn Sie eine Aktualisierungsanfrage einreichen und in Ihrer Anfrage kein Wert für eine Property angegeben ist, die bereits einen Wert hat, wird der vorhandene Wert der Property gelöscht.

Antwort

Wenn der Vorgang erfolgreich ist, wird mit dieser Methode eine playlistItem-Ressource im Antworttext zurückgegeben.

Fehler

In der folgenden Tabelle sind Fehlermeldungen aufgeführt, die von der API möglicherweise als Antwort auf einen Aufruf dieser Methode zurückgegeben werden. Weitere Informationen finden Sie in der Dokumentation zu Fehlermeldungen.

Fehlertyp Fehlerdetails Beschreibung
forbidden (403) playlistItemsNotAccessible Die Anfrage ist nicht berechtigt, das angegebene Playlist-Element zu aktualisieren.
invalidValue (400) invalidPlaylistItemPosition Bei der Anfrage wird versucht, die Position des Playlist-Elements auf einen ungültigen oder nicht unterstützten Wert zu setzen. Prüfen Sie den Wert des Attributs position in der snippet der Ressource.
invalidValue (400) invalidResourceType Die für die Ressourcen-ID angegebene type wird für diesen Vorgang nicht unterstützt. Die Ressourcen-ID gibt das Element an, das der Playlist hinzugefügt wird, z.B. youtube#video.
invalidValue (400) invalidSnippet In der Anfrage ist keine gültige snippet-Property angegeben.
invalidValue (400) manualSortRequired In der Anfrage wird versucht, die Position des Playlist-Elements festzulegen. In der Playlist wird jedoch keine manuelle Sortierung verwendet. Playlist-Elemente können zum Beispiel nach Datum oder Beliebtheit sortiert sein. Sie können den Fehler beheben, indem Sie das Element snippet.position aus der Ressource entfernen, die in der Anfrage eingefügt wird. Wenn du möchtest, dass der Playlist-Eintrag eine bestimmte Position in der Liste hat, musst du die Playlist-Option Playlist in den Playlist-Einstellungen zuerst zu Manuell ändern. Diese Einstellungen können im YouTube-Video-Manager angepasst werden.
notFound (404) playlistItemNotFound Das Playlist-Element, das mit der Eigenschaft id der Anfrage identifiziert wurde, wurde nicht gefunden.
notFound (404) playlistNotFound Die Playlist, die mit dem Parameter playlistId der Anfrage identifiziert wurde, kann nicht gefunden werden.
required (400) channelIdRequired In der Anfrage ist kein Wert für die erforderliche channelId-Property angegeben.
required (400) playlistIdRequired In der Anfrage ist kein Wert für die erforderliche playlistId-Property angegeben.
required (400) playlistItemIdRequired Die in der Anfrage angegebene Playlist-Elementressource muss das Attribut id verwenden, um das Playlist-Element zu identifizieren, das aktualisiert wird.
invalidValue (400) playlistOperationUnsupported Die API unterstützt nicht die Aktualisierung von Videos in der angegebenen Playlist. Du kannst zum Beispiel ein Video in deiner Playlist mit hochgeladenen Videos nicht aktualisieren.

Testen!

Verwenden Sie APIs Explorer, um diese API aufzurufen und die API-Anfrage und -Antwort anzusehen.