Cette page a été traduite par l'API Cloud Translation.

Watermarks

Une ressource watermark identifie une image qui s'affiche lors de la lecture des vidéos d'une chaîne spécifiée. Vous pouvez également spécifier un canal cible vers lequel l'image sera associée, ainsi que des informations temporelles qui déterminent le moment où le filigrane apparaît lors de la lecture de la vidéo et sa durée de visibilité.

Méthodes

L'API est compatible avec les méthodes suivantes pour les ressources watermarks:

ensemble: Elle importe une image en filigrane sur YouTube et la définit pour une chaîne.
unset: Supprime le filigrane d'une chaîne. Essayer

Représentation des ressources

La structure JSON ci-dessous illustre le format d'une ressource watermarks:

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

Propriétés

Le tableau suivant définit les propriétés qui apparaissent dans cette ressource:

Propriétés
`timing`	`object` L'objet `timing` encapsule les informations sur le moment de la lecture d'une vidéo où l'image en filigrane d'une chaîne s'affiche.
`timing.type`	`string` Méthode de codes temporels qui détermine le moment où l'image du filigrane s'affiche pendant la lecture de la vidéo. Si la valeur est `offsetFromStart`, le champ `offsetMs` représente un décalage par rapport au début de la vidéo. Si la valeur est `offsetFromEnd`, le champ `offsetMs` représente un décalage par rapport à la fin de la vidéo.
`timing.offsetMs`	`unsigned long` Décalage temporel, spécifié en millisecondes, qui détermine le moment où l'élément promu apparaît lors de la lecture de la vidéo. La valeur de la propriété `type` détermine si le décalage est mesuré à partir du début ou de la fin de la vidéo.
`timing.durationMs`	`unsigned long` Durée d'affichage, en millisecondes, de l'image du filigrane.
`position`	`object` L'objet `position` encapsule les informations sur la position spatiale dans la vidéo où l'image en filigrane s'affichera.
`position.type`	`string` Manière dont l'élément promu est positionné dans le lecteur vidéo. Les valeurs acceptées pour cette propriété sont les suivantes: coin
`position.cornerPosition`	`string` Angle du lecteur où s'affichera l'élément mis en avant. L'élément apparaît toujours dans l'angle supérieur droit du lecteur. Les valeurs acceptées pour cette propriété sont les suivantes: `topRight`
`imageUrl`	`string` URL de l'image du filigrane de la chaîne. YouTube va générer cette URL et la renvoyer dans la réponse de l'API à une requête `watermark.set`.
`imageBytes`	`bytes` Taille de l'image du filigrane, en octets.
`targetChannelId`	`string` ID de la chaîne YouTube vers laquelle renvoie l'image en filigrane.