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
:
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é:
|
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:
|
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. |