Watermarks

Un recurso watermark identifica una imagen que se muestra durante las reproducciones de videos de un canal específico. 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 watermarks:

configurar

Sube una imagen de marca de agua a YouTube y la configura para un canal.

unset

Borra la imagen de marca de agua de un canal. Pruébala ahora.

Representación de recursos

La estructura JSON a continuación muestra el formato de un recurso watermarks:

{
  "timing": {
    "type": string,
    "offsetMs": unsigned long,
    "durationMs": unsigned long
  },
  "position": {
    "type": string,
    "cornerPosition": string
  },
  "imageUrl": string,
  "imageBytes": bytes,
  "targetChannelId": 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 el que se mostrará la imagen de marca de agua de un canal.
timing.type	string Es el 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, el campo offsetMs representa un desfase con respecto al inicio del video. Si el valor es offsetFromEnd, el campo offsetMs representa un desfase con respecto al final del video.
timing.offsetMs	unsigned long Es la compensación horaria, especificada 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 Corresponde al tiempo (en milisegundos) que debe mostrarse la imagen de marca de agua.
position	object El objeto position contiene información sobre la posición espacial en el video donde se mostrará la imagen de marca de agua.
position.type	string Es la forma en que el elemento promocionado se posiciona en el reproductor de video. Los valores válidos para esta propiedad son los siguientes: corner
position.cornerPosition	string Esquina del reproductor en la que aparecerá el elemento promocionado. El elemento siempre aparece en la esquina superior derecha del reproductor. Los valores válidos para esta propiedad son los siguientes: topRight
imageUrl	string Corresponde a la URL de la imagen de marca de agua del canal. YouTube generará esta URL y la mostrará en la respuesta de la API a una solicitud watermark.set.
imageBytes	bytes El tamaño de la imagen de marca de agua en bytes.
targetChannelId	string ID del canal de YouTube al que vincula la imagen de marca de agua