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, auf den 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 während der Videowiedergabe das Wasserzeichenbild eines Kanals angezeigt wird. Dieses Objekt ist erforderlich, wenn Sie watermarks.set aufrufen.
timing.type string
Die Timing-Methode, die bestimmt, wann das Wasserzeichenbild während der Videowiedergabe angezeigt wird. Diese Property ist erforderlich, wenn watermarks.set aufgerufen wird.

Gültige Werte:
  • offsetFromStart: Das Feld offsetMs stellt einen Offset vom Beginn des Videos dar.
  • offsetFromEnd: Das Feld offsetMs stellt 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. Diese Property ist erforderlich, wenn watermarks.set aufgerufen wird. Wenn type gleich offsetFromEnd ist, muss offsetMs mindestens 1000 Millisekunden betragen.
timing.durationMs unsigned long
Die Dauer in Millisekunden, für die das Wasserzeichenbild angezeigt werden soll. Dieses Attribut ist optional. Falls angegeben, beträgt die Mindestdauer 1000 Millisekunden. Wenn type offsetFromEnd ist, darf durationMs nicht größer als offsetMs sein.
position object
Nicht mehr unterstützt:Das position-Objekt wird nicht mehr unterstützt und von YouTube ignoriert. Wasserzeichen werden immer oben rechts im Videoplayer angezeigt.
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.