Ajoute un message à 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 répertoriés sont des paramètres de requête.
Paramètres | ||
---|---|---|
Paramètres obligatoires | ||
part |
string Le paramètre part a deux fonctions. Il identifie les propriétés qui seront définies par l'opération d'écriture, ainsi que celles qui seront 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
: utiliseztextMessageEvent
snippet.textMessageDetails.messageText
Réponse
Lorsque cette méthode fonctionne, elle renvoie une ressource "liveChatMessage" dans le corps de la 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 sur les 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 le 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 au cours d'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.