Un recurso watermark
identifica una imagen que se muestra durante las reproducciones de videos de un canal determinado. También puedes especificar un canal de destino al que vinculará la imagen, así como información de sincronización que determina cuándo aparece la marca de agua en las reproducciones de video y el período de tiempo que será visible.
Métodos
La API admite los siguientes métodos para los recursos de watermarks
:
- set
- Carga una imagen de marca de agua a YouTube y la establece para un canal.
- unset
- Elimina una marca de agua. Pruébalo ahora.
Representación de recursos
La estructura JSON a continuación muestra el formato de un recurso de watermarks
:
{ "timing": { "type": string, "offsetMs": unsigned long, "durationMs": unsigned long }, "position": { "type": string, "cornerPosition": string }, "imageUrl": string, "imageBytes": bytes, "targetChannelId": { "value": string } }
Propiedades
La siguiente tabla define las propiedades que aparecen en este recurso:
Propiedades | |
---|---|
timing |
object El objeto timing contiene información sobre el tiempo durante la reproducción de un video en que se mostrará la imagen de marca de agua de un canal. |
timing.type |
string Método de sincronización que determina cuándo se muestra la imagen de marca de agua durante la reproducción del video. Si el valor es offsetFromStart , entonces el campo offsetMs representa un desfase con respecto al inicio del video. Si el valor es offsetFromEnd , entonces el campo offsetMs representa un desfase con respecto al final del video. |
timing.offsetMs |
unsigned long Desfase de tiempo, especificado en milisegundos, que determina cuándo aparece el elemento promocionado durante las reproducciones de video. El valor de la propiedad type determina si el desfase se mide desde el principio o el final del video. |
timing.durationMs |
unsigned long Período de tiempo, en milisegundos, durante el cual se debe mostrar la imagen de marca de agua. |
position |
object El objeto position contiene información sobre la posición espacial en el video donde se va a mostrar la imagen de marca de agua. |
position.type |
string Modo en que el elemento promocionado se ubica en el reproductor de video. Los valores válidos para esta propiedad son:
|
position.cornerPosition |
string Esquina del reproductor donde aparece el elemento promocionado. Los valores válidos para esta propiedad son:
|
imageUrl |
string URL de la imagen de la marca de agua del canal. YouTube genera esta URL y la muestra en la respuesta de la API a una solicitud de watermark.set . |
imageBytes |
bytes Tamaño, en bytes, de la imagen de marca de agua. |
targetChannelId |
string ID de canal de YouTube del canal al que vinculará la imagen de marca de agua. |