Watermarks

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: angolo
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: topRight
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.