Watermarks

Um recurso watermark identifica uma imagem exibida durante reproduções de 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 suporta os seguintes métodos para recursos watermarks:

set
Envia uma imagem de marca d'água para o YouTube e define-a para um canal.
unset
Exclui uma marca d'água. 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": {
    "value": string
  }
}

Propriedades

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

Propriedades
timing object
O objeto timing encapsula informações sobre o tempo em que a imagem de marca d'água de um canal é exibida durante a reprodução do vídeo.
timing.type string
O método de sincronismo que determina quando a imagem de marca d'água é exibida durante a reprodução do vídeo. Se o valor for offsetFromStart, o campo offsetMs representará um deslocamento do início do vídeo. Se o valor for offsetFromEnd, o campo offsetMs representará um deslocamento do final do vídeo.
timing.offsetMs unsigned long
O ajuste de horário especificado em milissegundos que determina quando o item promovido aparece durante as reproduções do vídeo. O valor da propriedade type determina se o deslocamento é medido do início ou do final do vídeo.
timing.durationMs unsigned long
O período em milissegundos em que a imagem de marca d'água deve ser exibida.
position object
O objeto position encapsula informações sobre a posição espacial no vídeo em que a imagem de marca d'água será exibida.
position.type string
A maneira na qual o item promovido é posicionado no player de vídeo.

Os valores válidos para esta propriedade são:
  • canto
position.cornerPosition string
O canto do player em que o item promovido aparecerá.

Os valores válidos para esta propriedade são:
  • bottomLeft
  • bottomRight
  • topLeft
  • topRight
imageUrl string
O URL para a imagem de marca d'água do canal. O YouTube gerará este URL e irá retorná-lo na resposta da API a uma solicitação watermark.set.
imageBytes bytes
O tamanho da imagem de marca d'água em bytes.
targetChannelId string O ID do canal do YouTube ao qual a imagem de marca d'água vinculará.