Creates a reply to an existing comment. Note:To create a top-level comment, use the commentThreads.insert
method.
Quota impact: A call to this method has a quota cost of 50 units.
Common use cases
Request
HTTP request
POST https://www.googleapis.com/youtube/v3/comments
Authorization
This request requires authorization with at least one of the following scopes ( read more about authentication and authorization ).
| Scope |
|---|
https://www.googleapis.com/auth/youtube.force-ssl
|
Parameters
The following table lists the parameters that this query supports. All of the parameters listed are query parameters.
part
string
The
part
parameter identifies the properties that the API response will include. Set the parameter value to snippet
. The snippet
part has a quota cost of 2 units.The following list contains the
part
names that you can include in the parameter value:-
id -
snippet
Request body
Provide a comment resource in the request body. For that resource:
-
You must specify a value for these properties:
-
snippet.textOriginal -
snippet.parentId
-
-
You can set values for these properties:
-
snippet.textOriginal
-
Response
If successful, this method returns a comment resource in the response body.
Errors
The following table identifies error messages that the API could return in response to a call to this method. Please see the error message documentation for more detail.
| Error type | Error detail | Description |
|---|---|---|
badRequest (400)
|
commentTextRequired
|
The comment
resource that is being inserted must specify a value for the snippet.textOriginal
property. Comments cannot be empty. |
badRequest (400)
|
commentTextTooLong
|
The comment
resource that is being inserted contains too many characters in the snippet.textOriginal
property. |
badRequest (400)
|
invalidCustomEmoji
|
The comment
resource that is being inserted contains invalid custom emoji. |
badRequest (400)
|
invalidCommentMetadata
|
The request metadata is invalid. |
badRequest (400)
|
operationNotSupported
|
The API user is not able to insert a comment in reply to the top-level comment identified by the snippet.parentId
property. In a commentThread
resource, the snippet.canReply
property indicates whether the current viewer can reply to the thread. |
badRequest (400)
|
parentCommentIsPrivate
|
The specified parent comment is private. The API does not support replies to private comments. |
badRequest (400)
|
parentIdMissing
|
The comment that is being inserted must be linked to a parent comment. However, the comment
resource in the body of the API request did not specify a value for the snippet.parentId
property. |
badRequest (400)
|
processingFailure
|
The API server failed to successfully process the request. While this can be a transient error, it usually indicates that the request's input is invalid. Check the structure of the comment
resource in the request body to ensure that it is valid. |
forbidden (403)
|
forbidden
|
The comment cannot be created due to insufficient permissions. The request might not be properly authorized. |
forbidden (403)
|
ineligibleAccount
|
The YouTube account used to authorize the API request must be merged with the user's Google account to insert a comment or comment thread. |
notFound (404)
|
parentCommentNotFound
|
The specified parent comment could not be found. Check the value of the snippet.parentId
property in the request body to ensure that it is correct. |
Try it!
Use the APIs Explorer to call this API and see the API request and response.
