Watermarks

Um recurso watermark identifica uma imagem que aparece durante as reproduções dos vídeos de um canal especificado. Você também pode especificar um canal de destino ao qual a imagem será vinculada, além dos detalhes de sincronismo que determinam quando uma marca d'água aparece durante reproduções de vídeo e o período em que ela estará visível.

Métodos

A API é compatível com os seguintes métodos para recursos watermarks:

set
Envia uma imagem de marca-d'água para o YouTube e a define para um canal.
não definido
Exclui a imagem de marca-d'água de um canal. Faça um teste agora.

Representação de recurso

A estrutura JSON abaixo mostra o formato de um recurso watermarks:

{
  "timing": {
    "type": string,
    "offsetMs": unsigned long,
    "durationMs": unsigned long
  },
  "position": {
    "type": string,
    "cornerPosition": string
  },
  "imageUrl": string,
  "imageBytes": bytes,
  "targetChannelId": string
}

Propriedades

A tabela a seguir define as propriedades que aparecem neste recurso:

Propriedades
timing object
O objeto timing encapsula informações sobre o momento durante a reprodução de um vídeo em que a imagem da marca-d'água de um canal vai aparecer. Esse objeto é obrigatório ao chamar watermarks.set.
timing.type string
O método de marcação de tempo que determina quando a imagem da marca-d'água é exibida durante a reprodução do vídeo. Essa propriedade é obrigatória ao chamar watermarks.set.

Valores válidos:
  • offsetFromStart: o campo offsetMs representa um ajuste de horário relativo ao início do vídeo.
  • offsetFromEnd: o campo offsetMs representa um deslocamento do final do vídeo.
timing.offsetMs unsigned long
O ajuste de tempo, especificado em milissegundos, que determina quando o item promovido aparece durante as reproduções de vídeo. Essa propriedade é obrigatória ao chamar watermarks.set. Quando type é offsetFromEnd, offsetMs precisa ser de pelo menos 1000 milissegundos.
timing.durationMs unsigned long
O período, em milissegundos, em que a imagem da marca d'água deve ser exibida. Esta propriedade é opcional. Se especificada, a duração mínima é de 1000 milissegundos. Quando type for offsetFromEnd, durationMs não poderá exceder offsetMs.
position object
Descontinuado:o objeto position foi descontinuado e é ignorado pelo YouTube. Elas sempre aparecem no canto superior direito do player de vídeo.
imageUrl string
O URL da imagem da marca-d'água do canal. O YouTube vai gerar esse URL e retorná-lo na resposta da API a uma solicitação watermark.set.
imageBytes bytes
O tamanho da imagem da marca-d'água, em bytes.
targetChannelId string
O ID do canal do YouTube a que a imagem da marca-d'água está vinculada.