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.