Comments: insert

Crée une réponse à un commentaire existant. Remarque:Pour créer un commentaire de premier niveau, utilisez la méthode commentThreads.insert.

Impact sur les quotas:un appel à cette méthode entraîne un coût du quota de 50 unités.

Cas d'utilisation courants

Requête

Requête HTTP

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

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 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 identifie les propriétés qui seront incluses dans la réponse de l'API. Définissez la valeur du paramètre sur snippet. La partie snippet a un coût de quota de deux unités.

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

Corps de la requête

Fournissez une ressource de commentaire dans le corps de la requête. Pour cette ressource:

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

    • snippet.textOriginal
    • snippet.parentId

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

    • snippet.textOriginal

Réponse

Lorsque cette méthode fonctionne, elle renvoie une ressource de commentaire 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
badRequest (400) commentTextRequired La ressource comment à insérer doit spécifier une valeur pour la propriété snippet.textOriginal. Les commentaires ne peuvent pas être vides.
badRequest (400) commentTextTooLong La ressource comment en cours d'insertion contient trop de caractères dans la propriété snippet.textOriginal.
badRequest (400) invalidCustomEmoji La ressource comment en cours d'insertion contient des emoji personnalisés non valides.
badRequest (400) invalidCommentMetadata Les métadonnées de la requête ne sont pas valides.
badRequest (400) operationNotSupported L'utilisateur de l'API ne peut pas insérer de commentaire en réponse au commentaire de premier niveau identifié par la propriété snippet.parentId. Dans une ressource commentThread, la propriété snippet.canReply indique si le lecteur actuel peut répondre au fil de discussion.
badRequest (400) parentCommentIsPrivate Le commentaire parent indiqué est privé. L'API ne permet pas de répondre aux commentaires privés.
badRequest (400) parentIdMissing Le commentaire en cours d'insertion doit être lié à un commentaire parent. Cependant, la ressource comment dans le corps de la requête API n'a spécifié aucune valeur pour la propriété snippet.parentId.
badRequest (400) processingFailure Le serveur d'API n'a pas réussi à 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 comment dans le corps de la requête pour vous assurer qu'elle est valide.
forbidden (403) forbidden Impossible de créer le commentaire, car les autorisations sont insuffisantes. La requête n'a peut-être pas été 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 permettre l'insertion d'un commentaire ou d'un fil de commentaires.
notFound (404) parentCommentNotFound Impossible de trouver le commentaire parent spécifié. Vérifiez que la valeur de la propriété snippet.parentId dans le corps de la requête est correcte.

Essayer

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