PlaylistItems: update

Ändert ein Playlist-Element. Du könntest zum Beispiel die Position des jeweiligen Elements in der Playlist aktualisieren.

Kontingentauswirkung: Ein Aufruf dieser Methode hat Kontingentkosten von 50 Einheiten.

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).

Bereich
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. Sie identifiziert die Attribute, die vom Schreibvorgang festgelegt werden, sowie die Attribute, die die API-Antwort enthalten wird.

Hinweis: Diese Methode überschreibt die vorhandenen Werte für alle änderbaren Attribute, die in den Teilen enthalten sind, die der Parameterwert angibt. Beispielsweise kann für ein Playlist-Element eine Start- und eine Endzeit angegeben werden, die angibt, wann der Teil des Videos abgespielt werden soll, wenn Nutzer das Video in der Playlist ansehen. Wenn deine Anfrage ein Playlist-Element aktualisiert, mit dem diese Werte festgelegt werden, und der part-Parameterwert der Anfrage den contentDetails-Teil enthält, werden die Start- und Endzeit des Playlist-Elements auf den Wert aktualisiert, der im Anfragetext angegeben ist. 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 Sie in den Parameterwert aufnehmen können:
  • contentDetails
  • id
  • snippet
  • status
Optionale Parameter
onBehalfOfContentOwner string
Hinweis:Der Parameter onBehalfOfContentOwner ist ausschließlich für YouTube-Contentpartner gedacht und kann nur in einer entsprechend autorisierten Anfrage verwendet werden.

Dieser Parameter wurde für YouTube-Contentpartner entwickelt, die viele verschiedene YouTube-Kanäle haben und verwalten. Nutzer, die mit dem Rechteinhaber verbunden sind, können sich einmal 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, identifiziert sein Wert einen Rechteinhaber und anhand der Autorisierungsdaten der Anfrage wird ein YouTube-Nutzer identifiziert, 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:

  • Sie müssen einen Wert für diese Attribute angeben:

    • id
    • snippet.playlistId
    • snippet.resourceId

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

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

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

Antwort

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

Fehler

In der folgenden Tabelle finden Sie Fehlermeldungen, die die API als Antwort auf einen Aufruf dieser Methode zurückgeben könnte. Weitere Informationen finden Sie in der Dokumentation zu Fehlermeldungen.

Fehlertyp Fehlerdetails Beschreibung
forbidden (403) playlistItemsNotAccessible Die Anfrage ist nicht autorisiert, das angegebene Playlist-Element zu aktualisieren.
invalidValue (400) invalidPlaylistItemPosition Die Anfrage 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 kennzeichnet das Element, das der Playlist hinzugefügt wird, z.B. youtube#video.
invalidValue (400) invalidSnippet In der Anfrage ist kein gültiges snippet-Attribut angegeben.
invalidValue (400) manualSortRequired Die Anfrage versucht, die Position des Playlist-Elements festzulegen, aber die Playlist verwendet keine manuelle Sortierung. Playlist-Elemente können beispielsweise nach Datum oder Beliebtheit sortiert werden. Sie können den Fehler beheben, indem Sie das snippet.position-Element aus der Ressource entfernen, die durch die Anfrage eingefügt wird. Wenn das Playlist-Element eine bestimmte Position in der Liste haben soll, musst du zuerst die Option Reihenfolge der Playlist in den Einstellungen der Playlist zu Manuell ändern. Diese Einstellungen kannst du im Video-Manager von YouTube anpassen.
notFound (404) playlistItemNotFound Das mit der Eigenschaft id der Anfrage angegebene Playlist-Element konnte nicht gefunden werden.
notFound (404) playlistNotFound Die mit dem Parameter playlistId der Anfrage identifizierte Playlist wurde nicht gefunden.
required (400) channelIdRequired In der Anfrage ist kein Wert für das erforderliche Attribut channelId angegeben.
required (400) playlistIdRequired In der Anfrage ist kein Wert für das erforderliche Attribut playlistId angegeben.
required (400) playlistItemIdRequired Die in der Anfrage angegebene Ressource des Playlist-Elements muss das Attribut id verwenden, um das zu aktualisierende Playlist-Element zu identifizieren.
invalidValue (400) playlistOperationUnsupported Die API unterstützt die Aktualisierung von Videos in der angegebenen Playlist nicht. So kannst du beispielsweise kein Video in der Playlist „Hochgeladene Videos“ aktualisieren.

Jetzt testen

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