Watermarks

Une ressource watermark identifie une image qui s'affiche pendant la lecture des vidéos d'une chaîne spécifique. Vous pouvez également spécifier une chaîne cible vers laquelle l'image redirigera, ainsi que des codes temporels qui déterminent quand le filigrane s'affiche pendant la lecture des vidéos et leur durée d'affichage.

Méthodes

L'API accepte les méthodes suivantes pour les ressources watermarks:

set
Mise en ligne d'une image en filigrane sur YouTube et définition pour une chaîne
unset
Supprime l'image en filigrane d'une chaîne. Essayer

Représentation des ressources

La structure JSON ci-dessous présente 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 la durée d'affichage d'une image de filigrane pendant la lecture d'une vidéo.
timing.type string
Méthode de synchronisation qui détermine le moment où l'image en 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 horaire, exprimé en millisecondes, qui détermine le moment où l'élément promu s'affiche pendant la lecture de la vidéo. La valeur de la propriété type détermine si le décalage est mesuré depuis le début ou la fin de la vidéo.
timing.durationMs unsigned long
Durée d'affichage, en millisecondes, de l'image en filigrane.
position object
L'objet position encapsule les informations sur la position spatiale de la vidéo dans laquelle l'image en filigrane sera affichée.
position.type string
manière dont l'élément promu est positionné dans le lecteur vidéo.

Valeurs valides pour cette propriété:
  • coin
position.cornerPosition string
Le coin du lecteur dans lequel l'article promu s'affiche. L'élément apparaît toujours dans l'angle supérieur droit du lecteur.

Les valeurs valides pour cette propriété sont les suivantes:
  • topRight
imageUrl string
URL de l'image en filigrane de la chaîne. YouTube génère cette URL et la renvoie 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 pointe l'image en filigrane.