Una risorsa watermark
identifica un'immagine che viene visualizzata durante le riproduzioni dei video di un canale specifico. Puoi anche specificare un canale di destinazione a cui verrà collegata l'immagine, nonché dettagli sui tempi che determinano il momento in cui la filigrana verrà visualizzata durante le riproduzioni video e la durata della sua visibilità.
Metodi
L'API supporta i seguenti metodi per le risorse watermarks
:
- imposta
- Carica un'immagine della 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 riportata di seguito 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à visualizzate in questa risorsa:
Proprietà | |
---|---|
timing |
object L'oggetto timing racchiude informazioni sul tempo necessario durante la riproduzione di un video durante il quale viene visualizzata l'immagine della filigrana di un canale. |
timing.type |
string Il metodo di temporizzazione che determina quando l'immagine della filigrana viene visualizzata durante la riproduzione 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 Lo scarto, specificato in millisecondi, che determina il momento in cui l'elemento promosso viene visualizzato durante le riproduzioni del 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, durante il quale deve essere visualizzata l'immagine della filigrana. |
position |
object L'oggetto position racchiude informazioni sulla posizione spaziale del video in cui verrà visualizzata l'immagine della filigrana. |
position.type |
string Il modo in cui l'articolo 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 della filigrana, espresse in byte. |
targetChannelId |
string L'ID del canale YouTube a cui rimanda l'immagine della filigrana. |