Ein benutzerdefiniertes Video-Thumbnail wird auf YouTube hochgeladen und für ein Video festgelegt.
Diese Methode unterstützt das Hochladen von Medien. Hochgeladene Dateien müssen den folgenden Einschränkungen entsprechen:
- Maximale Dateigröße:2 MB
- Zulässige Medien-MIME-Typen:
image/jpeg
,image/png
,application/octet-stream
Auswirkungen auf das Kontingent:Bei einem Aufruf dieser Methode liegen die Kontingentkosten bei ungefähr 50 Einheiten.
Gängige Anwendungsfälle
Anfragen
HTTP-Anfrage
POST https://www.googleapis.com/upload/youtube/v3/thumbnails/set
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.upload |
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 | ||
videoId |
string Der Parameter videoId gibt eine YouTube-Video-ID an, für die das benutzerdefinierte Video-Thumbnail angegeben wird. |
|
Optionale Parameter | ||
onBehalfOfContentOwner |
string Hinweis:Dieser Parameter ist ausschließlich für YouTube-Content-Partner vorgesehen. Der Parameter onBehalfOfContentOwner gibt an, dass durch die Autorisierungsanmeldedaten ein YouTube-CMS-Nutzer identifiziert wird, der im Namen des Rechteinhabers handelt, der im Parameterwert angegeben ist. Dieser Parameter ist für YouTube-Content-Partner vorgesehen, die Inhaber und Manager vieler verschiedener YouTube-Kanäle sind. Die 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 eigentliche CMS-Konto, mit dem sich der Nutzer authentifiziert, muss mit dem angegebenen YouTube-Rechteinhaber verknüpft sein. |
Anfragetext
Der Text der Anfrage enthält die Miniaturansicht, die Sie hochladen. Der Anfragetext enthält keine thumbnail
-Ressource.
Antwort
Bei Erfolg gibt diese Methode einen Antworttext mit der folgenden Struktur zurück:
{ "kind": "youtube#thumbnailSetResponse", "etag": etag, "items": [ thumbnail resource ] }
Attribute
In der folgenden Tabelle werden die Attribute definiert, die in dieser Ressource angezeigt werden:
Attribute | |
---|---|
kind |
string Identifiziert den Typ der API-Ressource. Der Wert ist youtube#thumbnailSetResponse . |
etag |
etag Das ETag dieser Ressource. |
items[] |
list Eine Liste mit Thumbnails. |
Fehler
In der folgenden Tabelle sehen Sie Fehlermeldungen, die von der API als Reaktion auf einen Aufruf dieser Methode zurückgegeben werden könnten. Weitere Informationen finden Sie in der Dokumentation zu Fehlermeldungen.
Fehlertyp | Fehlerdetails | Beschreibung |
---|---|---|
badRequest (400) |
invalidImage |
Der angegebene Inhalt des Bildes ist ungültig. |
badRequest (400) |
mediaBodyRequired |
Die Anfrage enthält nicht den Bildinhalt. |
forbidden (403) |
forbidden |
Die Miniaturansicht kann für das angegebene Video nicht festgelegt werden. Die Anfrage ist möglicherweise nicht autorisiert. |
forbidden (403) |
forbidden |
Der authentifizierte Nutzer ist nicht berechtigt, benutzerdefinierte Video-Thumbnails hochzuladen und festzulegen. |
notFound (404) |
videoNotFound |
Das Video, bei dem du eine Miniaturansicht einfügen möchtest, kann nicht gefunden werden. Prüfen Sie den Wert des videoId -Parameters der Anfrage. |
tooManyRequests (429) |
uploadRateLimitExceeded |
Der Kanal hat in letzter Zeit zu viele Thumbnails hochgeladen. Bitte versuchen Sie es später noch einmal. |
Jetzt testen
Verwenden Sie APIs Explorer, um diese API aufzurufen und die API-Anfrage und -Antwort anzusehen.