Youtube · Schema
CommentListResponse
A list of comment resources matching the request criteria.
GoogleMediaSocialStreamingVideoVideos
Properties
| Name | Type | Description |
|---|---|---|
| kind | string | Identifies the API resource's type. Value is youtube#commentListResponse. |
| etag | string | The Etag of this resource. |
| nextPageToken | string | The token for the next page of results. |
| pageInfo | object | Paging details for a list operation, including information about the total number of resources and the number per page. |
| items | array | A list of comments that match the request criteria. |
JSON Schema
{
"type": "object",
"description": "A list of comment resources matching the request criteria.",
"properties": {
"kind": {
"type": "string",
"description": "Identifies the API resource's type. Value is youtube#commentListResponse.",
"example": "youtube#video"
},
"etag": {
"type": "string",
"description": "The Etag of this resource.",
"example": "XI7nbFXulYBIpL0ayR_gDh3eu1k"
},
"nextPageToken": {
"type": "string",
"description": "The token for the next page of results.",
"example": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9"
},
"pageInfo": {
"type": "object",
"description": "Paging details for a list operation, including information about the total number of resources and the number per page.",
"properties": {
"totalResults": {
"type": "integer",
"description": "The total number of results in the result set.",
"example": 42
},
"resultsPerPage": {
"type": "integer",
"description": "The number of results included in the API response.",
"example": 10
}
}
},
"items": {
"type": "array",
"description": "A list of comments that match the request criteria.",
"example": [],
"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": "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"
]
}
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"title": "CommentListResponse",
"x-schema-source": "openapi",
"x-source-url": "openapi/youtube-data-api-openapi.yml"
}