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 sincronizzazione 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. Questo oggetto è obbligatorio quando viene chiamato watermarks.set.
timing.type string
Il metodo di temporizzazione che determina quando l'immagine della filigrana viene visualizzata durante la riproduzione del video. Questa proprietà è obbligatoria quando viene chiamato watermarks.set.

I valori validi sono:
  • offsetFromStart: il campo offsetMs rappresenta un offset dall'inizio del video.
  • 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. Questa proprietà è obbligatoria quando viene chiamato watermarks.set. Quando type è offsetFromEnd, offsetMs deve essere almeno 1000 millisecondi.
timing.durationMs unsigned long
Il periodo di tempo, in millisecondi, in cui deve essere visualizzata l'immagine della filigrana. Questa proprietà è facoltativa. Se specificata, la durata minima è di 1000 millisecondi. Quando type è offsetFromEnd, durationMs non deve superare offsetMs.
position object
Obsoleto:l'oggetto position è obsoleto e ignorato da YouTube. Le filigrane vengono sempre visualizzate nell'angolo in alto a destra del video player.
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.