{ "type": "object", "description": "A commentThread resource contains information about a YouTube comment thread, which comprises a top-level comment and replies.", "properties": { "kind": { "type": "string", "description": "Identifies the API resource's type. Value is youtube#commentThread.", "example": "youtube#video" }, "etag": { "type": "string", "description": "The Etag of this resource.", "example": "XI7nbFXulYBIpL0ayR_gDh3eu1k" }, "id": { "type": "string", "description": "The ID that YouTube uses to uniquely identify the comment thread.", "example": "abc123def456" }, "snippet": { "type": "object", "description": "The snippet object contains basic details about the comment thread.", "example": "example_value", "properties": { "channelId": { "type": "string", "description": "The YouTube channel that is associated with the comments in the thread." }, "videoId": { "type": "string", "description": "The ID of the video that the comments refer to." }, "topLevelComment": { "type": "object", "description": "A comment resource contains information about a single YouTube comment.", "properties": { "kind": { "type": "string", "description": "Identifies the API resource's type. Value is youtube#comment.", "example": "youtube#video" }, "etag": { "type": "string", "description": "The Etag of this resource.", "example": "XI7nbFXulYBIpL0ayR_gDh3eu1k" }, "id": { "type": "string", "description": "The ID that YouTube uses to uniquely identify the comment.", "example": "abc123def456" }, "snippet": { "type": "object", "description": "The snippet object contains basic details about the comment.", "example": "example_value", "properties": { "textOriginal": { "type": "string", "description": "The original text of the comment as it was initially posted." }, "textDisplay": { "type": "string", "description": "The comment text as displayed to users." }, "authorDisplayName": { "type": "string", "description": "The display name of the user who posted the comment." }, "authorProfileImageUrl": { "type": "string", "description": "The URL for the avatar of the user who posted the comment." }, "authorChannelUrl": { "type": "string", "description": "A link to the YouTube channel of the comment's author." }, "authorChannelId": { "type": "object", "description": "An object that encapsulates information about the comment author's YouTube channel.", "properties": { "value": { "type": "string", "description": "The author's YouTube channel ID." } } }, "likeCount": { "type": "integer", "description": "The total number of likes that the comment has received." }, "viewerRating": { "type": "string", "description": "The rating the viewer has given to this comment. Note that this property does not currently identify dislike ratings." }, "publishedAt": { "type": "string", "description": "The date and time when the comment was originally published.", "format": "date-time" }, "updatedAt": { "type": "string", "description": "The date and time when the comment was last updated.", "format": "date-time" }, "videoId": { "type": "string", "description": "The ID of the video the comment refers to." }, "parentId": { "type": "string", "description": "The unique ID of the parent comment." }, "canRate": { "type": "boolean", "description": "Indicates whether the current viewer can rate the comment." }, "moderationStatus": { "type": "string", "description": "The comment's moderation status.", "enum": [ "heldForReview", "likelySpam", "published", "rejected" ] } } } }, "required": [ "kind", "etag" ] }, "canReply": { "type": "boolean", "description": "Whether the current viewer can reply to the thread." }, "totalReplyCount": { "type": "integer", "description": "The total number of replies that have been submitted in response to the top-level comment." }, "isPublic": { "type": "boolean", "description": "Indicates whether the thread, including all of its comments and comment replies, is visible to all YouTube users." } } }, "replies": { "type": "object", "description": "The replies object contains a list of replies to the top-level comment.", "example": "example_value", "properties": { "comments": { "type": "array", "description": "A limited number of replies to the top-level comment.", "items": { "type": "object", "description": "A comment resource contains information about a single YouTube comment.", "properties": { "kind": { "type": "string", "description": "Identifies the API resource's type. Value is youtube#comment.", "example": "youtube#video" }, "etag": { "type": "string", "description": "The Etag of this resource.", "example": "XI7nbFXulYBIpL0ayR_gDh3eu1k" }, "id": { "type": "string", "description": "The ID that YouTube uses to uniquely identify the comment.", "example": "abc123def456" }, "snippet": { "type": "object", "description": "The snippet object contains basic details about the comment.", "example": "example_value", "properties": { "textOriginal": { "type": "string", "description": "The original text of the comment as it was initially posted." }, "textDisplay": { "type": "string", "description": "The comment text as displayed to users." }, "authorDisplayName": { "type": "string", "description": "The display name of the user who posted the comment." }, "authorProfileImageUrl": { "type": "string", "description": "The URL for the avatar of the user who posted the comment." }, "authorChannelUrl": { "type": "string", "description": "A link to the YouTube channel of the comment's author." }, "authorChannelId": { "type": "object", "description": "An object that encapsulates information about the comment author's YouTube channel.", "properties": { "value": { "type": "object" } } }, "likeCount": { "type": "integer", "description": "The total number of likes that the comment has received." }, "viewerRating": { "type": "string", "description": "The rating the viewer has given to this comment. Note that this property does not currently identify dislike ratings." }, "publishedAt": { "type": "string", "description": "The date and time when the comment was originally published.", "format": "date-time" }, "updatedAt": { "type": "string", "description": "The date and time when the comment was last updated.", "format": "date-time" }, "videoId": { "type": "string", "description": "The ID of the video the comment refers to." }, "parentId": { "type": "string", "description": "The unique ID of the parent comment." }, "canRate": { "type": "boolean", "description": "Indicates whether the current viewer can rate the comment." }, "moderationStatus": { "type": "string", "description": "The comment's moderation status.", "enum": [ "heldForReview", "likelySpam", "published", "rejected" ] } } } }, "required": [ "kind", "etag" ] } } } } }, "required": [ "kind", "etag" ], "$schema": "https://json-schema.org/draft/2020-12/schema", "title": "CommentThread", "x-schema-source": "openapi", "x-source-url": "openapi/youtube-data-api-openapi.yml" }