PlaylistImages: insert

Fügt einer Playlist ein Bild hinzu.

Diese Methode unterstützt den Media-Upload. Hochgeladene Dateien müssen die folgenden Einschränkungen erfüllen:

  • Maximale Dateigröße:50 MB
  • Zulässiges Seitenverhältnis:1:1 (quadratisch)
  • Zulässige Media-MIME-Typen:image/jpeg, image/png

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

Anfrage

HTTP-Anfrage

POST https://www.googleapis.com/youtube/v3/playlistImages

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

Mit dem part Parameter wird eine durch Kommas getrennte Liste mit einer oder mehreren Eigenschaften der Ressource playlistImage angegeben, die in der API-Antwort enthalten sein sollen.

Wenn der Parameter eine Eigenschaft angibt, die untergeordnete Eigenschaften enthält, werden diese untergeordneten Eigenschaften in die Antwort aufgenommen.
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 onBehalfOfContentOwner Parameter gibt an, dass die Autorisierungsdaten der Anfrage einen YouTube-CMS-Nutzer identifizieren, der im Namen des im Parameterwert angegebenen Content-Inhabers handelt. Dieser Parameter ist für YouTube-Content-Partner vorgesehen, die viele verschiedene YouTube-Kanäle besitzen und verwalten. So können Rechteinhaber sich einmal authentifizieren und auf alle ihre Video- und Kanaldaten zugreifen, ohne für jeden einzelnen Kanal Authentifizierungsdaten angeben zu müssen. Das CMS-Konto, mit dem sich der Nutzer authentifiziert, muss mit dem angegebenen YouTube-Rechteinhaber verknüpft sein.
onBehalfOfContentOwnerChannel 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 onBehalfOfContentOwnerChannelParameter gibt die YouTube-Kanal-ID des Kanals an, dem ein Video hinzugefügt wird. Dieser Parameter ist erforderlich, wenn in einer Anfrage ein Wert für den onBehalfOfContentOwner Parameter angegeben wird. Er kann nur in Verbindung mit diesem Parameter verwendet werden. Außerdem muss die Anfrage mit einem CMS-Konto autorisiert werden, das mit dem Content-Inhaber verknüpft ist, der im onBehalfOfContentOwner Parameter angegeben ist. Schließlich muss der Kanal, der im Parameterwert onBehalfOfContentOwnerChannel angegeben ist, mit dem Content-Inhaber verknüpft sein, der im onBehalfOfContentOwner Parameter angegeben ist.

Dieser Parameter ist für YouTube-Content-Partner vorgesehen, die viele verschiedene YouTube-Kanäle besitzen und verwalten. So können Content-Inhaber sich einmal authentifizieren und Aktionen im Namen des im Parameterwert angegebenen Kanals ausführen, ohne für jeden einzelnen Kanal Authentifizierungsdaten angeben zu müssen.

Anfragetext

Geben Sie im Anfragetext eine playlistImages-Ressource an.

Für diese Ressource gilt:

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

    • snippet.playlistId
    • snippet.type

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

    • snippet.width
    • snippet.height

Antwort

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