LiveBroadcasts: cuepoint

Insère un point de repère dans une diffusion en direct. Le point de repère peut déclencher une coupure publicitaire.

Remarque:Cette méthode remplace la méthode liveCuepoints.insert, qui nécessitait que les demandes soient autorisées par un compte associé à un propriétaire de contenu YouTube. Cette méthode n'a pas les mêmes exigences d'autorisation.

Requête

Requête HTTP

POST https://www.googleapis.com/youtube/v3/liveBroadcasts/cuepoint

Autorisation

Cette requête nécessite une autorisation avec au moins l'un des champs d'application suivants. Pour en savoir plus sur l'authentification et l'autorisation, consultez Implémenter l'authentification OAuth 2.0.

Portée
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl
https://www.googleapis.com/auth/youtubepartner

Paramètres

Le tableau suivant répertorie les paramètres compatibles avec cette requête. Tous les paramètres listés sont des paramètres de requête.

Paramètres
Paramètres obligatoires
id string
Le paramètre id identifie la diffusion dans laquelle le point de repère est inséré. La diffusion doit être en cours de diffusion lorsque vous insérez le repère.
Paramètres facultatifs
onBehalfOfContentOwner string
Ce paramètre ne peut être utilisé que dans une requête autorisée appropriée.
Remarque:Ce paramètre est destiné exclusivement aux propriétaires de contenu YouTube qui possèdent et gèrent de nombreuses chaînes YouTube différentes. Il permet aux propriétaires de contenu de s'authentifier une seule fois et d'effectuer des actions au nom du canal spécifié dans la valeur du paramètre, sans avoir à fournir des identifiants d'authentification différents pour chaque canal distinct. Le compte avec lequel l'utilisateur s'authentifie doit être associé au propriétaire de contenu YouTube spécifié.
Le paramètre onBehalfOfContentOwner indique que les identifiants d'autorisation de la requête identifient un utilisateur YouTube agissant au nom du titulaire de contenu YouTube spécifié dans la valeur du paramètre. Ce paramètre est destiné aux partenaires de contenus YouTube qui possèdent et gèrent de nombreuses chaînes YouTube différentes.
onBehalfOfContentOwnerChannel string
Ce paramètre ne peut être utilisé que dans une requête autorisée appropriée.
Remarque:Ce paramètre est destiné exclusivement aux propriétaires de contenu YouTube qui possèdent et gèrent de nombreuses chaînes YouTube différentes. Il permet aux propriétaires de contenu de s'authentifier une seule fois et d'effectuer des actions au nom du canal spécifié dans la valeur du paramètre, sans avoir à fournir d'identifiants d'authentification pour chaque canal distinct.
Le paramètre onBehalfOfContentOwnerChannel spécifie l'ID de la chaîne YouTube associée à la diffusion dans laquelle le point de repère est inséré. Ce paramètre est obligatoire lorsqu'une requête spécifie une valeur pour le paramètre onBehalfOfContentOwner. Il ne peut être utilisé qu'avec ce paramètre. Les exigences suivantes s'appliquent également :
  • La demande doit être autorisée avec un compte utilisateur associé au propriétaire du contenu spécifié par le paramètre onBehalfOfContentOwner.
  • La chaîne spécifiée par la valeur du paramètre onBehalfOfContentOwnerChannel doit être associée au propriétaire du contenu spécifié par le paramètre onBehalfOfContentOwner.

Corps de la requête

Fournissez une ressource cuepoint dans le corps de la requête. La structure JSON suivante montre le format d'une ressource cuepoint:

{
    "id": string,
    "insertionOffsetTimeMs": long,
    "walltimeMs": datetime,
    "durationSecs": unsigned integer,
    "cueType": string
  }
 Dans le corps de la requête, le champ cueType est obligatoire et doit être défini sur cueTypeAd. Vous pouvez également définir des valeurs pour les propriétés suivantes :
  • durationSecs
  • insertionOffsetTimeMs (ne doit pas être défini si walltimeMs est défini)
  • walltimeMs (ne doit pas être défini si insertionOffsetTimeMs est défini)

Propriétés

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

Propriétés
id string
Valeur attribuée par YouTube pour identifier de manière unique le point de repère. Notez que cette valeur est différente du paramètre id obligatoire, qui identifie la diffusion. Cette valeur peut être omise lorsque vous envoyez une requête pour insérer un repère. La valeur sera renseignée dans la réponse de l'API.
insertionOffsetTimeMs long
La valeur de la propriété identifie un décalage temporel, en millisecondes, au moment où le point de repère doit être inséré. La valeur est mesurée à partir du début du flux de surveillance. Sa valeur par défaut est