Watermarks: set

Hiermit wird ein Wasserzeichenbild auf YouTube hochgeladen und für einen Kanal festgelegt.

Diese Methode unterstützt den Medienupload. Hochgeladene Dateien müssen den folgenden Einschränkungen entsprechen:

  • Maximale Dateigröße:10 MB
  • Zulässige MIME-Typen für Medien:image/jpeg, image/png, application/octet-stream

Auswirkungen auf das Kontingent:Ein Aufruf dieser Methode hat Kontingentkosten in Höhe von 50 Einheiten.

Anfrage

HTTP-Anfrage

POST https://www.googleapis.com/upload/youtube/v3/watermarks/set

Autorisierung

Für diese Anfrage ist eine Autorisierung mit mindestens einem der folgenden Bereiche erforderlich. Weitere Informationen zu Authentifizierung und Autorisierung finden Sie unter OAuth 2.0-Autorisierung implementieren.

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
channelId string
Der Parameter channelId gibt die YouTube-Kanal-ID an, für die das Wasserzeichen bereitgestellt wird.
Optionale Parameter
onBehalfOfContentOwner string
Hinweis:Dieser Parameter ist ausschließlich für YouTube-Contentpartner gedacht.

Der Parameter onBehalfOfContentOwner gibt an, dass die Autorisierungsdaten der Anfrage einen YouTube CMS-Nutzer identifizieren, der im Namen des im Parameterwert angegebenen Rechteinhabers handelt. Dieser Parameter richtet sich an YouTube-Contentpartner, die viele verschiedene YouTube-Kanäle haben und verwalten. So können Rechteinhaber sich einmal authentifizieren und auf alle ihre Video- und Kanaldaten zugreifen, ohne für jeden einzelnen Kanal Anmeldedaten 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 watermark-Ressource an.

Antwort

Bei Erfolg gibt diese Methode den HTTP-Statuscode 204 No Content zurück.

Fehler

In der folgenden Tabelle sind die Fehlermeldungen aufgeführt, die die API als Antwort auf einen Aufruf dieser Methode zurückgeben kann. Weitere Informationen findest du unter YouTube Data API – Fehler.

Fehlertyp Fehlerdetails Beschreibung
badRequest (400) imageFormatUnsupported Das von Ihnen bereitgestellte Bild hat ein nicht unterstütztes Format.
badRequest (400) imageTooTall Das von Ihnen bereitgestellte Bild ist zu hoch.
badRequest (400) imageTooWide Das von Ihnen bereitgestellte Bild ist zu breit.
badRequest (400) mediaBodyRequired Die Anfrage enthält keine Bildinhalte.
forbidden (403) forbidden Das Wasserzeichen kann für den angegebenen Kanal nicht festgelegt werden. Die Anfrage ist möglicherweise nicht ordnungsgemäß autorisiert oder der Parameter channelId ist auf einen ungültigen Wert festgelegt.

Testen!

Verwenden Sie die APIs Explorer, um diese API aufzurufen und die API-Anfrage und ‑Antwort zu sehen.