Crée une réponse à un commentaire existant. Remarque : Pour créer un commentaire de premier niveau, utilisez la méthode commentThreads.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/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
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 :
|
Corps de la requête
Indiquez 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 les propriétés suivantes:
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 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) |
commentTextRequired |
La ressource comment en cours d'insertion doit spécifier une valeur pour la propriété snippet.textOriginal . Vous devez indiquer un commentaire. |
badRequest (400) |
commentTextTooLong |
La ressource comment insérée est trop longue dans la propriété snippet.textOriginal . |
badRequest (400) |
invalidCustomEmoji |
La ressource comment insérée 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 spécifié est privé. L'API ne permet pas de répondre aux commentaires privés. |
badRequest (400) |
parentIdMissing |
Le commentaire inséré doit être lié à un commentaire parent. Cependant, la ressource comment dans le corps de la requête API n'a pas spécifié de valeur pour la propriété snippet.parentId . |
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 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. 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) |
parentCommentNotFound |
Le commentaire parent spécifié est introuvable. Vérifiez la valeur de la propriété snippet.parentId dans le corps de la requête 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.