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