Watermarks: set

Lädt ein Wasserzeichenbild auf YouTube hoch und legt es für einen Kanal fest.

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

  • Maximale Dateigröße:10 MB
  • Akzeptierte Media-MIME-Typen:image/jpeg, image/png, application/octet-stream

Kontingentauswirkung:Ein Aufruf dieser Methode hat Kontingentkosten 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 zur Authentifizierung und Autorisierung finden Sie unter OAuth 2.0-Autorisierung implementieren.

Bereich
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-Inhaltspartner 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 gedacht, 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 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. Die Ressource enthält die folgenden Attribute:

  • timing (object, erforderlich): Kapselt das Timing für die Wasserzeichenanzeige.
    • timing.type (string, erforderlich): Auf offsetFromStart oder offsetFromEnd festlegen.
    • timing.offsetMs (unsigned long, erforderlich): Start-Offset in Millisekunden. Muss mindestens 1000 ms betragen, wenn type offsetFromEnd ist.
    • timing.durationMs (unsigned long, optional): Sichtbare Dauer in Millisekunden (mindestens 1000 ms). Wenn type offsetFromEnd ist, darf offsetMs nicht überschritten werden.
  • targetChannelId (string, optional): Die YouTube-Kanal-ID, auf die das Wasserzeichen verweist. Wird dieser Parameter weggelassen, wird auf den Kanal verlinkt, der durch channelId identifiziert wird.
  • position (object, eingestellt): Wird von YouTube ignoriert. Wasserzeichen werden immer oben rechts platziert.

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 finden Sie 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 nicht den Bildinhalt.
forbidden (403) forbidden Das Wasserzeichen kann für den angegebenen Kanal nicht festgelegt werden. Die Anfrage ist möglicherweise nicht richtig autorisiert oder der Parameter channelId ist auf einen ungültigen Wert festgelegt.

Testen!

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