Ajoute un message à un chat en direct. Actuellement, l'API ne permet d'insérer que des SMS.
Cas d'utilisation courants
Demande
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
Portée |
---|
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 | ||
---|---|---|
Réglages 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 les propriétés que la réponse de l'API inclura. Définissez la valeur du paramètre sur snippet . |
Corps de la requête
Indiquez une ressource liveChatMessage dans le corps de la requête. Pour cette ressource:
-
Vous devez spécifier une valeur pour ces propriétés:
snippet.liveChatId
snippet.type
: actuellement, la seule valeur acceptée esttextMessageEvent
.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 pourrait renvoyer en réponse à un appel à cette méthode. Veuillez consulter la documentation sur les messages d'erreur pour en savoir plus.
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 propriétaire du chat en direct a été désactivé. Par conséquent, il est 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 demande d'API n'existe pas. Cette erreur se produit si le chat a été supprimé par son propriétaire. |
rateLimitExceeded |
rateLimitExceeded |
L'utilisateur a publié trop de messages de chat sur une période donnée. |
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 |
Essayer
Utilisez APIs Explorer pour appeler cette API et afficher la requête API et la réponse.