PlaylistItems: insert

Fügt einer Playlist eine Ressource hinzu.

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

Gängige Anwendungsfälle

Anfragen

HTTP-Anfrage

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

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

Der Parameter onBehalfOfContentOwner gibt an, dass die Autorisierungsanmeldedaten der Anfrage einen YouTube CMS-Nutzer identifizieren, der im Namen des im Parameterwert angegebenen Rechteinhabers handelt. Dieser Parameter ist für YouTube-Content-Partner vorgesehen, die viele verschiedene YouTube-Kanäle besitzen und verwalten. Rechteinhaber können sich einmalig authentifizieren und auf alle ihre Video- und Kanaldaten zugreifen, ohne für jeden einzelnen Kanal Anmeldedaten zur Authentifizierung angeben zu müssen. Das CMS-Konto, mit dem sich der Nutzer authentifiziert, muss mit dem angegebenen YouTube-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:

    • snippet.playlistId
    • snippet.resourceId

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

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

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) playlistContainsMaximumNumberOfVideos Die Playlist enthält bereits die maximal zulässige Anzahl von Elementen.
forbidden (403) playlistItemsNotAccessible Die Anfrage ist nicht berechtigt, das angegebene Playlist-Element einzufügen.
invalidValue (400) invalidContentDetails Die Property contentDetails in der Anfrage ist ungültig. Möglicherweise ist das Feld contentDetails.note länger als 280 Zeichen.
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) 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.
invalidValue (400) videoAlreadyInAnotherSeriesPlaylist Das Video, das du der Playlist hinzufügen möchtest, ist bereits in einer anderen Serien-Playlist enthalten.
notFound (404) playlistNotFound Die Playlist, die mit dem Parameter playlistId der Anfrage identifiziert wurde, kann nicht gefunden werden.
notFound (404) videoNotFound Das Video, das du der Playlist hinzufügen möchtest, wurde nicht gefunden. Prüfe, ob der Wert der Property videoId korrekt ist.
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) resourceIdRequired Die Anfrage muss eine Ressource enthalten, in der das Objekt snippet eine resourceId angibt.
invalidValue (400) playlistOperationUnsupported Die API unterstützt das Einfügen von Videos in die angegebene Playlist nicht. Du kannst beispielsweise kein Video in deine Playlist mit hochgeladenen Videos einfügen.

Testen!

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