CommentThreads: insert

Crée un commentaire de premier niveau. Pour ajouter une réponse à un commentaire existant, utilisez plutôt la méthode comments.insert.

Impact du quota : un appel à cette méthode a un coût de quota de 50 unités.

Cas d'utilisation courants

Demande

Requête HTTP :

POST https://www.googleapis.com/youtube/v3/commentThreads

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.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 identifie les propriétés qui seront incluses dans la réponse de l'API. Définissez la valeur du paramètre sur snippet. Le coût de quota de la partie snippet est de 2 unités. La liste suivante contient les noms de part que vous pouvez inclure dans la valeur du paramètre : id replies snippet

Corps de la requête

Indiquez une ressource commentThread dans le corps de la requête. Pour cette ressource:

• Vous devez spécifier une valeur pour ces propriétés:

  • snippet.channelId
  • snippet.topLevelComment.snippet.textOriginal

• Vous pouvez définir des valeurs pour les propriétés suivantes:

  • snippet.channelId
  • snippet.videoId
  • snippet.topLevelComment.snippet.textOriginal

Réponse

Lorsque cette méthode fonctionne, elle renvoie une ressource commentThread 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
badRequest (400)	channelOrVideoIdMissing	Chaque fil de commentaires doit être associé à une chaîne ou à une vidéo. Si le commentaire s'applique à un canal, assurez-vous que la ressource spécifiée dans le corps de la requête fournit une valeur pour la propriété snippet.channelId. Un commentaire qui s'applique à une chaîne s'affiche dans l'onglet Discussion de la chaîne. Si le commentaire s'applique à une vidéo, assurez-vous que la ressource spécifie des valeurs pour les propriétés snippet.channelId et snippet.videoId. Un commentaire qui s'applique à une vidéo apparaît sur sa page de lecture.
badRequest (400)	commentTextRequired	La ressource comment en cours d'insertion doit spécifier une valeur pour la propriété snippet.topLevelComment.snippet.textOriginal. Vous devez indiquer un commentaire.
badRequest (400)	commentTextTooLong	La ressource comment insérée est trop longue dans la propriété snippet.topLevelComment.snippet.textOriginal.
badRequest (400)	invalidCommentThreadMetadata	Les métadonnées de la requête ne sont pas valides.
badRequest (400)	processingFailure	Le serveur d'API n'a pas pu traiter la requête. Bien qu'il s'agisse d'une erreur temporaire, cela indique généralement que l'entrée de la requête n'est pas valide. Vérifiez la structure de la ressource commentThread dans le corps de la requête pour vous assurer qu'elle est valide.
forbidden (403)	forbidden	Impossible de créer le fil de commentaires, car les autorisations sont insuffisantes. Il est possible que la demande ne soit pas autorisée correctement.
forbidden (403)	ineligibleAccount	Le compte YouTube utilisé pour autoriser la requête API doit être fusionné avec le compte Google de l'utilisateur pour pouvoir insérer un commentaire ou un fil de commentaires.
notFound (404)	channelNotFound	La chaîne spécifiée est introuvable. Vérifiez la valeur de la propriété snippet.channelId pour vous assurer qu'elle est correcte.
notFound (404)	videoNotFound	La vidéo spécifiée est introuvable. Vérifiez la valeur de la propriété snippet.videoId pour vous assurer qu'elle est correcte.

Essayer

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