Um recurso watermark
identifica uma imagem que é exibida durante a reprodução 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
:
- definir
- Faz upload de uma imagem de marca d'água no YouTube e a define para um canal.
- unset
- 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 tempo em que um vídeo da imagem de marca-d'água de um canal é reproduzido durante a reprodução do vídeo. |
timing.type |
string O método de tempo 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 vai representar um deslocamento desde o início do vídeo. Se o valor for offsetFromEnd , o campo offsetMs vai representar um deslocamento do fim 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 fim do vídeo. |
timing.durationMs |
unsigned long O período, em milissegundos, que a imagem de marca-d'água exibirá. |
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 como o item promovido é posicionado no player de vídeo. Os valores válidos para essa propriedade são:
|
position.cornerPosition |
string O canto do player em que o item promovido será exibido. O item sempre aparece no canto superior direito do player. Os valores válidos para essa propriedade são:
|
imageUrl |
string O URL da imagem de marca d'água do canal. O YouTube vai gerar e enviar esse URL na resposta da API para 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 ao qual a imagem de marca d'água direciona. |