Watermarks

Una risorsa watermark identifica un'immagine che viene visualizzata durante la riproduzione dei video di un canale specifico. Puoi anche specificare un canale di destinazione a cui l'immagine verrà collegata, nonché i dettagli di temporizzazione che determinano quando viene visualizzata la filigrana durante la riproduzione dei video e per quanto tempo è visibile.

Metodi

L'API supporta i seguenti metodi per le risorse watermarks:

set
Carica un'immagine filigrana su YouTube e la imposta per un canale.
unset
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 contiene informazioni sull'ora durante la riproduzione di un video in cui verrà visualizzata l'immagine del watermark di un canale.
timing.type string
Il metodo di temporizzazione che determina quando l'immagine della filigrana viene visualizzata 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'elemento promozionale viene visualizzato durante la riproduzione dei 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 contiene informazioni sulla posizione spaziale all'interno del video in cui verrà visualizzata l'immagine della filigrana.
position.type string
Il modo in cui l'elemento promozionale 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'elemento promozionale. 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, in byte.
targetChannelId string
L'ID del canale YouTube a cui rimanda l'immagine della filigrana.