PlaylistImages: insert

Fügt ein Bild zu einer Playlist hinzu.

Diese Methode unterstützt das Hochladen von Medien. Hochgeladene Dateien müssen den folgenden Vorgaben entsprechen:

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

Auswirkungen auf das Kontingent:Ein Aufruf dieser Methode hat Kontingentkosten von 50 Einheiten.

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

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 gibt eine durch Kommas getrennte Liste mit einer oder mehreren playlistImage-Ressourcen die die API-Antwort enthält.

Wenn der Parameter bezeichnet eine Property, die untergeordnete Properties enthält, die untergeordneten Properties in der Antwort enthalten sein.
Optionale Parameter
onBehalfOfContentOwner string
Dieser Parameter kann nur in einer ordnungsgemäß autorisierten Anfrage verwendet werden. Hinweis: Dieser Parameter ist ausschließlich für YouTube-Contentpartner vorgesehen.

Der Parameter onBehalfOfContentOwner gibt an, dass die Anmeldedaten für die Autorisierung 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 nur einmal authentifizieren und erhalten Zugriff auf alle ihre Video- und Kanaldaten, ohne dass sie für jeden einzelnen Kanal Anmeldedaten zur Authentifizierung angeben 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-Inhaltspartner vorgesehen.

Die onBehalfOfContentOwnerChannel-Parameter gibt die YouTube-Kanal-ID des Kanals an, auf dem ein Video wiedergegeben wird. hinzugefügt. Dieser Parameter ist erforderlich, wenn in einer Anfrage ein Wert für die Methode onBehalfOfContentOwner-Parameter und kann nur in in Verbindung mit diesem Parameter. Außerdem muss der Antrag die über ein CMS-Konto autorisiert wurden, das mit dem Rechteinhaber verknüpft ist, wird durch den Parameter onBehalfOfContentOwner angegeben. Die Funktion Kanal, den der Wert des Parameters onBehalfOfContentOwnerChannel mit dem Rechteinhaber verknüpft sein muss, wird durch den Parameter onBehalfOfContentOwner angegeben.

Dies ist für YouTube-Content-Partner vorgesehen, die viele verschiedenen YouTube-Kanälen. Rechteinhaber können sich einmalig authentifizieren. und Aktionen für den im Parameter angegebenen Kanal ausführen. ohne Anmeldedaten für die Authentifizierung angeben zu müssen, einen separaten Kanal.

Anfragetext

Gib im Anfragetext eine playlistImages-Ressource an.

Für diese Ressource:

  • 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

Wenn der Vorgang erfolgreich ist, wird mit dieser Methode eine Ressource vom Typ "playlistImages" im Antworttext zurückgegeben.