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)

channelOrVideoIdMissing

Each comment thread must be linked to a channel or video.

If the comment applies to a channel, make sure that the resource specified in the request body provides a value for the snippet.channelId property. A comment that applies to a channel appears on the channel's Discussion tab.

If the comment applies to a video, make sure the resource specifies values for both the snippet.channelId and snippet.videoId properties. A comment that applies to a video appears on the video's watch page.

badRequest (400)

commentTextRequired

The comment resource that is being inserted must specify a value for the snippet.topLevelComment.snippet.textOriginal property. Comments cannot be empty.

badRequest (400)

commentTextTooLong

The comment resource that is being inserted contains too many characters in the snippet.topLevelComment.snippet.textOriginal property.

badRequest (400)

invalidCommentThreadMetadata

The request metadata is invalid.

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 commentThread resource in the request body to ensure that it is valid.

forbidden (403)

forbidden

The comment thread could not 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)

channelNotFound

The specified channel could not be found. Check the value of the snippet.channelId property to ensure it is correct.

notFound (404)

videoNotFound

The specified video could not be found. Check the value of the snippet.videoId property to ensure it is correct.