LiveChatMessages: insert

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 est textMessageEvent.
    • 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.