Watermarks

Eine watermark-Ressource gibt ein Bild an, das während der Wiedergabe der Videos eines bestimmten Kanals angezeigt wird. Sie können auch einen Zielkanal angeben, mit dem das Bild verknüpft werden soll, sowie Zeitangaben, die bestimmen, wann das Wasserzeichen während der Videowiedergabe angezeigt wird und wie lange es sichtbar ist.

Methoden

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

Festlegen

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

unset

Das Wasserzeichenbild eines Kanals wird gelöscht. Hier kannst du die Funktion ausprobieren.

Ressourcendarstellung

Die folgende JSON-Struktur 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 angezeigt werden:

Attribute
timing	object Das timing-Objekt enthält Informationen zur Zeit, während der ein Video als Wasserzeichen angezeigt wird.
timing.type	string Die Timing-Methode, die bestimmt, wann das Wasserzeichenbild während der Videowiedergabe angezeigt wird. Wenn der Wert offsetFromStart ist, stellt das Feld offsetMs einen Versatz ab dem Start des Videos dar. Wenn der Wert offsetFromEnd ist, stellt das Feld offsetMs einen Versatz vom Ende des Videos dar.
timing.offsetMs	unsigned long Der Zeitunterschied in Millisekunden, der bestimmt, wann das gesponserte Element während der Videowiedergabe erscheint. Der Wert der Eigenschaft type bestimmt, ob der Versatz vom Anfang oder Ende des Videos aus gemessen wird.
timing.durationMs	unsigned long Die Zeit in Millisekunden, die das Wasserzeichenbild angezeigt werden soll.
position	object Das Objekt position enthält Informationen zur räumlichen Position im Video, wo das Wasserzeichenbild zu sehen ist.
position.type	string Die Positionierung des beworbenen Elements im Videoplayer. Für diese Property sind folgende Werte gültig: Ecke
position.cornerPosition	string Die Ecke des Players, in der das hochgestufte Element erscheint. 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, mit dem das Wasserzeichenbild verknüpft ist