Watermarks

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:
  • 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 filigrana, in byte.
targetChannelId string
L'ID del canale YouTube del canale a cui rimanda l'immagine filigrana.