Una risorsa watermark
identifica un'immagine visualizzata durante le riproduzioni dei video di un canale specificato. Puoi anche specificare un canale di destinazione a cui collegare l'immagine, nonché i dettagli relativi alla tempistica che stabiliscono quando la filigrana viene visualizzata durante le riproduzioni video e la durata di visibilità.
Metodi
L'API supporta i seguenti metodi per le risorse di watermarks
:
- imposta
- Carica un'immagine filigrana su YouTube e la imposta per un canale.
- non impostato
- Elimina l'immagine della filigrana di un canale. Prova subito.
Rappresentazione delle risorse
La struttura JSON seguente mostra il formato di una risorsa watermarks
:
{ "timing": { "type": string, "offsetMs": unsigned long, "durationMs": unsigned long }, "position": { "type": string, "cornerPosition": string }, "imageUrl": string, "imageBytes": bytes, "targetChannelId": string }
Proprietà
La tabella seguente definisce le proprietà che vengono visualizzate in questa risorsa:
Proprietà | |
---|---|
timing |
object L'oggetto timing include informazioni sul tempo trascorso durante la riproduzione di un video in cui viene visualizzata l'immagine della filigrana di un canale. |
timing.type |
string Il metodo di timestamp che determina quando viene mostrata l'immagine della filigrana durante la riproduzione del video. Se il valore è offsetFromStart , il campo offsetMs rappresenta un offset dall'inizio del video. Se il valore è offsetFromEnd , il campo offsetMs rappresenta un offset dalla fine del video. |
timing.offsetMs |
unsigned long L'offset temporale, specificato in millisecondi, che determina quando l'articolo promosso viene visualizzato durante le riproduzioni video. Il valore della proprietà type determina se l'offset viene misurato dall'inizio o dalla fine del video. |
timing.durationMs |
unsigned long Il periodo di tempo, in millisecondi, in cui deve essere visualizzata l'immagine della filigrana. |
position |
object L'oggetto position include informazioni sulla posizione spaziale del video, dove verrà mostrata l'immagine filigrana. |
position.type |
string Il modo in cui l'elemento promosso viene posizionato nel video player. I valori validi per questa proprietà sono:
|
position.cornerPosition |
string L'angolo del player in cui verrà visualizzato l'articolo promosso. L'elemento viene sempre visualizzato nell'angolo in alto a destra del player. I valori validi per questa proprietà sono:
|
imageUrl |
string L'URL dell'immagine della filigrana del canale. YouTube genererà questo URL e lo restituirà nella risposta dell'API a una richiesta watermark.set . |
imageBytes |
bytes Le dimensioni dell'immagine filigrana, in byte. |
targetChannelId |
string L'ID del canale YouTube del canale a cui rimanda l'immagine filigrana. |