Watermarks

Eine watermark-Ressource gibt ein Bild an, das während der Wiedergabe von 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 erscheint und wie lange es sichtbar ist.

Methoden

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

fest
Lädt ein Wasserzeichen auf YouTube hoch und legt es für einen Kanal fest.
unset
Entfernt das Wasserzeichenbild des Kanals. 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 zu dem Zeitpunkt, während einer Videowiedergabe das Wasserzeichenbild eines Kanals angezeigt wird.
timing.type string
Mit der Zeitmethode wird bestimmt, wann das Wasserzeichen während der Videowiedergabe angezeigt wird. Wenn der Wert offsetFromStart ist, stellt das Feld offsetMs einen Versatz vom 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 Zeitversatz in Millisekunden, der bestimmt, wann das beworbene Element bei der Videowiedergabe erscheint. Der Wert der type-Eigenschaft bestimmt, ob der Offset 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 position-Objekt enthält Informationen zur räumlichen Position im Video, an der das Wasserzeichenbild angezeigt wird.
position.type string
Die Positionierung des beworbenen Produkts im Videoplayer.

Gültige Werte für diese Unterkunft:
  • Ecke
position.cornerPosition string
Die Ecke des Players, in der das beworbene 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.