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 sur le quota : un appel à cette méthode a un coût de quota de 50 unités.

Cas d'utilisation courants

Requête

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

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

Paramètres

Le tableau suivant répertorie les paramètres acceptés par 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 identifie les propriétés que la réponse de l'API inclura. Définissez la valeur du paramètre sur snippet. La partie snippet a un coût de quota de 2 unités.

La liste suivante contient les noms part que vous pouvez inclure dans la valeur du paramètre :
  • id
  • replies
  • snippet

Corps de la requête

Fournissez une ressource commentThread dans le corps de la requête.

Pour cette ressource, vous devez spécifier une valeur pour les propriétés suivantes :

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

Réponse

Si la requête aboutit, cette méthode renvoie une ressource commentThread 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 à cette méthode. Pour en savoir plus, consultez la documentation sur les messages d'erreur.

Type d'erreur Détails de l'erreur Description
badRequest (400) channelOrVideoIdMissing Chaque fil de commentaires doit être associé à une vidéo. Assurez-vous que la ressource spécifie des valeurs pour les propriétés snippet.channelId et snippet.videoId. Un commentaire sur une vidéo s'affiche sur la page de lecture de la vidéo.
badRequest (400) commentTextRequired La ressource comment insérée doit spécifier une valeur pour la propriété snippet.topLevelComment.snippet.textOriginal. Les commentaires ne peuvent pas être vides.
badRequest (400) commentTextTooLong La ressource comment insérée contient trop de caractères 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 puisse s'agir d'une erreur temporaire, elle 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 Le fil de commentaires n'a pas pu être créé en raison d'autorisations insuffisantes. Il est possible que la requête ne soit pas correctement autorisée.
forbidden (403) ineligibleAccount Le compte YouTube utilisé pour autoriser la requête API doit être fusionné avec le compte Google de l'utilisateur pour insérer un commentaire ou un fil de commentaires.
notFound (404) channelNotFound Le canal spécifié 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 l'APIs Explorer pour appeler cette API et afficher la requête et la réponse de l'API.