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

LiveChatMessages: insert

Ajoute un message ou un sondage à un chat en direct.

Cas d'utilisation courants

Requête

Requête HTTP

POST https://www.googleapis.com/youtube/v3/liveChat/messages

Autorisation

Une autorisation est requise pour cette requête. Celle-ci doit inclure au moins l'un des champs d'application suivants. En savoir plus sur le processus d'authentification et d'autorisation

Champ d'application
`https://www.googleapis.com/auth/youtube`
`https://www.googleapis.com/auth/youtube.force-ssl`

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
`part`	`string` Le paramètre `part` a une double finalité. Il identifie les propriétés que l'opération d'écriture définira, ainsi que celles incluses dans la réponse de l'API. Définissez la valeur du paramètre sur `snippet`.

Corps de la requête

Fournissez une ressource liveChatMessage dans le corps de la requête. Pour cette ressource, vous devez spécifier des valeurs pour ces propriétés

snippet.liveChatId
snippet.type - sélectionnez l'une des options suivantes: textMessageEvent ou pollEvent
Si le type est textMessageEvent, inclure snippet.textMessageDetails.messageText
Si le type est pollEvent, ajoutez snippet.pollDetails avec les valeurs suivantes:
- snippet.pollDetails.metadata.options.questionText
- Liste de snippet.pollDetails.metadata.options.optionText. Vous devez indiquer au moins deux éléments et pas plus de cinq éléments. Les éléments sont affichés de manière séquentielle dans l'ordre dans lequel ils sont listés.

Réponse

Lorsque cette méthode fonctionne, elle renvoie une ressource liveChatMessage dans le corps de réponse.

Erreurs

Le tableau suivant identifie les messages d'erreur que l'API peut renvoyer en réponse à un appel de cette méthode. Pour en savoir plus, consultez la documentation relative aux messages d'erreur.

Type d'erreur	Détails de l'erreur	Description
`forbidden (403)`	`forbidden`	Vous ne disposez pas des autorisations nécessaires pour créer le message spécifié.
`forbidden (403)`	`liveChatDisabled`	Le chat en direct spécifié a été désactivé par son propriétaire. Il est donc impossible d'y ajouter des messages.
`forbidden (403)`	`liveChatEnded`	Le chat en direct spécifié n'est plus en direct.
`invalidValue (400)`	`messageTextInvalid`	Le texte du message (`snippet.textMessageDetails.messageText`) n'est pas valide.
`notFound (404)`	`liveChatNotFound`	Le chat en direct identifié dans la requête API n'existe pas. Cette erreur se produit si le chat a été supprimé par son propriétaire.
`required (400)`	`liveChatIdRequired`	La ressource liveChatMessage doit inclure et spécifier une valeur pour la propriété `snippet.liveChatId`.
`required (400)`	`messageTextRequired`	La ressource liveChatMessage doit inclure et spécifier une valeur pour la propriété `snippet.textMessageDetails.messageText`.
`required (400)`	`typeRequired`	La ressource liveChatMessage doit inclure et spécifier une valeur pour la propriété `snippet.type`. Définissez la valeur du paramètre sur `text`.
`required (400)`	`preconditionCheckFailed`	Un sondage actif épinglé existe déjà.
`rateLimitExceeded`	`rateLimitExceeded`	L'utilisateur a publié trop de messages de chat sur une période donnée.

Essayer

Utilisez APIs Explorer pour appeler cette API, et afficher la requête et la réponse de l'API.