Watermarks

Eine watermark-Ressource identifiziert ein Bild, das während der Wiedergabe von Videos eines bestimmten Kanals angezeigt wird. Sie können auch einen Zielkanal angeben, zu dem das Bild verlinkt wird, sowie Zeitangaben, die bestimmen, wann das Wasserzeichen während der Videowiedergabe erscheint und wie lange es sichtbar ist.

Methoden

Die API unterstützt die folgenden Methoden für watermarks-Ressourcen:

set
Lädt ein Wasserzeichenbild auf YouTube hoch und legt es für einen Kanal fest.
unset
Löscht das Wasserzeichenbild eines Kanals. Hier kannst du die Funktion ausprobieren.

Ressourcendarstellung

Die JSON-Struktur unten zeigt das Format einer watermarks-Ressource:

{
  "timing": {
    "type": string,
    "offsetMs": unsigned long,
    "durationMs": unsigned long
  },
  "position": {
    "type": string,
    "cornerPosition": string
  },
  "imageUrl": string,
  "imageBytes": bytes,
  "targetChannelId": string
}

Attribute

In der folgenden Tabelle werden die Attribute definiert, die in dieser Ressource enthalten sind:

Attribute
timing object
Das timing-Objekt enthält Informationen dazu, wann das Wasserzeichenbild eines Kanals während der Videowiedergabe angezeigt wird.
timing.type string
Die Timing-Methode, mit der festgelegt wird, wann das Wasserzeichenbild während der Videowiedergabe angezeigt wird. Wenn der Wert offsetFromStart ist, stellt das Feld offsetMs einen Offset vom Beginn des Videos dar. Wenn der Wert offsetFromEnd ist, stellt das Feld offsetMs einen Offset vom Ende des Videos dar.
timing.offsetMs unsigned long
Die Zeitverschiebung in Millisekunden, die bestimmt, wann das beworbene Element während der Videowiedergabe angezeigt wird. Der Wert der Eigenschaft type bestimmt, ob der Offset vom Anfang oder Ende des Videos gemessen wird.
timing.durationMs unsigned long
Die Dauer in Millisekunden, für die das Wasserzeichenbild angezeigt werden soll.
position object
Das position-Objekt enthält Informationen zur räumlichen Position im Video, an der das Wasserzeichenbild angezeigt wird.
position.type string
Die Art und Weise, wie das beworbene Element im Videoplayer positioniert wird.

Gültige Werte für diese Eigenschaft sind:
  • Ecke
position.cornerPosition string
Die Ecke des Players, in der das beworbene Element angezeigt wird. Das Element wird immer oben rechts im Player angezeigt.

Gültige Werte für diese Eigenschaft sind:
  • topRight
imageUrl string
Die URL für das Wasserzeichenbild des Kanals. YouTube generiert diese URL und gibt sie in der API-Antwort auf eine watermark.set-Anfrage zurück.
imageBytes bytes
Die Größe des Wasserzeichenbilds in Byte.
targetChannelId string
Die YouTube-Kanal-ID des Kanals, auf den das Wasserzeichenbild verweist.