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:
|
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:
|
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 |