PlaylistItems: update

Ändert ein Playlist-Element. Sie können beispielsweise die Position des Elements in der Playlist aktualisieren.

Auswirkungen auf das Kontingent:Ein Aufruf dieser Methode kostet 50 Kontingenteinheiten.

Gängige Anwendungsfälle

Anfrage

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 hat bei diesem Vorgang zwei Funktionen. Er gibt die Eigenschaften an, die durch den Schreibvorgang festgelegt werden, sowie die Eigenschaften, die in der API-Antwort enthalten sein sollen.

Beachten Sie, dass mit dieser Methode die vorhandenen Werte für alle veränderlichen Eigenschaften überschrieben werden, die in den Teilen enthalten sind, die durch den Parameterwert angegeben werden. Für ein Playlist-Element können beispielsweise eine Start- und eine Endzeit angegeben werden, die den Teil des Videos identifizieren, der wiedergegeben werden soll, wenn sich Nutzer das Video in der Playlist ansehen. Wenn Sie ein Playlist-Element aktualisieren, in dem diese Werte festgelegt sind, und der Parameterwert part der Anfrage den Teil contentDetails enthält, werden die Start- und Endzeiten des Playlist-Elements auf die im Anfragetext angegebenen Werte aktualisiert. 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 onBehalfOfContentOwner Parameter ist ausschließlich für YouTube-Contentpartner vorgesehen und kann nur in einer ordnungsgemäß autorisierten Anfrage verwendet werden.

Dieser Parameter ist für YouTube-Contentpartner gedacht, die viele verschiedene YouTube-Kanäle besitzen und verwalten. Er ermöglicht es Nutzern, die mit dem Rechteinhaber verbunden sind, sich einmal zu authentifizieren und dann auf alle Video- und Kanaldaten des Rechteinhabers zuzugreifen und diese zu verwalten, ohne für jeden einzelnen Kanal Authentifizierungsdaten angeben zu müssen.

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

Anfragetext

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

  • Sie müssen einen Wert für diese Eigenschaften 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 der Anfrage kein Wert für eine Eigenschaft angegeben ist, die bereits einen Wert hat, wird der vorhandene Wert der Eigenschaft gelöscht.

Antwort

Bei Erfolg gibt diese Methode eine playlistItem-Ressource im Antworttext zurück.

Fehler

In der folgenden Tabelle sind die Fehlermeldungen aufgeführt, die die API als Antwort auf einen Aufruf dieser Methode zurückgeben kann. Weitere Informationen finden Sie in der Dokumentation zu Fehlermeldungen.

Fehlertyp Fehlerdetails Beschreibung
forbidden (403) playlistItemsNotAccessible Die Anfrage ist nicht ordnungsgemäß autorisiert, um 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 festzulegen. Prüfen Sie den Wert der Eigenschaft position im snippet der Ressource.
invalidValue (400) invalidResourceType Der 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-Eigenschaft 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 Element snippet.position aus der Ressource entfernen, die mit der Anfrage eingefügt wird. Wenn das Playlist-Element eine bestimmte Position in der Liste haben soll, müssen Sie zuerst in den Playlist-Einstellungen die Option Sortierung auf Manuell aktualisieren. Diese Einstellungen können Sie im YouTube-Videomanager anpassen.
notFound (404) playlistItemNotFound Das Playlist-Element, das mit der Eigenschaft id der Anfrage identifiziert wird, kann nicht gefunden werden.
notFound (404) playlistNotFound Die Playlist, die mit dem Parameter playlistId der Anfrage identifiziert wird, kann nicht gefunden werden.
required (400) channelIdRequired In der Anfrage ist kein Wert für die erforderliche Eigenschaft channelId angegeben.
required (400) playlistIdRequired In der Anfrage ist kein Wert für die erforderliche Eigenschaft playlistId angegeben.
required (400) playlistItemIdRequired In der in der Anfrage angegebenen Playlist-Element-Ressource muss die Eigenschaft id verwendet werden, um das zu aktualisierende Playlist-Element zu identifizieren.
invalidValue (400) playlistOperationUnsupported Die API unterstützt die Aktualisierung von Videos in der angegebenen Playlist nicht. Sie können beispielsweise kein Video in der Playlist „Hochgeladene Videos“ aktualisieren.

Testen!

Mit dem APIs Explorer können Sie diese API aufrufen und die API-Anfrage und -Antwort ansehen.