insert(part, body=None, x__xgafv=None)
Inserts a new resource into this collection.
Retrieves a list of resources, possibly filtered.
list_next(previous_request, previous_response)
Retrieves the next page of results.
update(part, body=None, x__xgafv=None)
Updates an existing resource.
insert(part, body=None, x__xgafv=None)
Inserts a new resource into this collection.
Args:
part: string, The <code><strong>part</strong></code> parameter identifies the properties
that the API response will include. Set the parameter value to
<code>snippet</code>. The <code>snippet</code> part has a quota cost of 2
units. (required) (repeated)
body: object, The request body.
The object takes the form of:
{ # A <code><strong>comment thread</strong></code> represents information that
# applies to a top level comment and all its replies. It can also include the
# top level comment itself and some of the replies.
"id": "A String", # The ID that YouTube uses to uniquely identify the comment thread.
"snippet": { # Basic details about a comment thread. # The <code>snippet</code> object contains basic details about the comment
# thread and also the top level comment.
"channelId": "A String", # The YouTube channel the comments in the thread refer to or the channel
# with the video the comments refer to. If video_id isn't set the comments
# refer to the channel itself.
"totalReplyCount": 42, # The total number of replies (not including the top level comment).
"videoId": "A String", # The ID of the video the comments refer to, if any. No video_id implies a
# channel discussion comment.
"canReply": True or False, # Whether the current viewer of the thread can reply to it. This is viewer
# specific - other viewers may see a different value for this field.
"isPublic": True or False, # Whether the thread (and therefore all its comments) is visible to all
# YouTube users.
"topLevelComment": { # A <code><strong>comment</strong></code> represents a single YouTube comment. # The top level comment of this thread.
"etag": "A String", # Etag of this resource.
"id": "A String", # The ID that YouTube uses to uniquely identify the comment.
"snippet": { # Basic details about a comment, such as its author and text. # The <code>snippet</code> object contains basic details about the comment.
"canRate": True or False, # Whether the current viewer can rate this comment.
"moderationStatus": "A String", # The comment's moderation status. Will not be set if the comments were
# requested through the id filter.
"authorChannelId": { # The id of the author's YouTube channel, if any.
"value": "A String",
},
"authorDisplayName": "A String", # The name of the user who posted the comment.
"textDisplay": "A String", # The comment's text. The format is either plain text or HTML dependent on
# what has been requested. Even the plain text representation may differ
# from the text originally posted in that it may replace video links with
# video titles etc.
"likeCount": 42, # The total number of likes this comment has received.
"viewerRating": "A String", # The rating the viewer has given to this comment. For the time being this
# will never return RATE_TYPE_DISLIKE and instead return RATE_TYPE_NONE.
# This may change in the future.
"authorChannelUrl": "A String", # Link to the author's YouTube channel, if any.
"authorProfileImageUrl": "A String", # The URL for the avatar of the user who posted the comment.
"channelId": "A String", # The id of the corresponding YouTube channel. In case of a channel comment
# this is the channel the comment refers to. In case of a video comment
# it's the video's channel.
"updatedAt": "A String", # The date and time when was last updated . The value is
# specified in <a href="//www.w3.org/TR/NOTE-datetime">ISO 8601</a>
# format.
"publishedAt": "A String", # The date and time when the comment was orignally published. The value is
# specified in <a href="//www.w3.org/TR/NOTE-datetime">ISO 8601</a>
# format.
"parentId": "A String", # The unique id of the parent comment, only set for replies.
"videoId": "A String", # The ID of the video the comment refers to, if any.
"textOriginal": "A String", # The comment's original raw text as initially posted or last updated. The
# original text will only be returned if it is accessible to the viewer,
# which is only guaranteed if the viewer is the comment's author.
},
"kind": "youtube#comment", # Identifies what kind of resource this is. Value: the fixed string
# <code>"youtube#comment"</code>.
},
},
"replies": { # Comments written in (direct or indirect) reply to the top level comment. # The <code>replies</code> object contains a limited number of replies (if
# any) to the top level comment found in the snippet.
"comments": [ # A limited number of replies. Unless the number of replies returned equals
# total_reply_count in the snippet the returned replies are only a subset
# of the total number of replies.
{ # A <code><strong>comment</strong></code> represents a single YouTube comment.
"etag": "A String", # Etag of this resource.
"id": "A String", # The ID that YouTube uses to uniquely identify the comment.
"snippet": { # Basic details about a comment, such as its author and text. # The <code>snippet</code> object contains basic details about the comment.
"canRate": True or False, # Whether the current viewer can rate this comment.
"moderationStatus": "A String", # The comment's moderation status. Will not be set if the comments were
# requested through the id filter.
"authorChannelId": { # The id of the author's YouTube channel, if any.
"value": "A String",
},
"authorDisplayName": "A String", # The name of the user who posted the comment.
"textDisplay": "A String", # The comment's text. The format is either plain text or HTML dependent on
# what has been requested. Even the plain text representation may differ
# from the text originally posted in that it may replace video links with
# video titles etc.
"likeCount": 42, # The total number of likes this comment has received.
"viewerRating": "A String", # The rating the viewer has given to this comment. For the time being this
# will never return RATE_TYPE_DISLIKE and instead return RATE_TYPE_NONE.
# This may change in the future.
"authorChannelUrl": "A String", # Link to the author's YouTube channel, if any.
"authorProfileImageUrl": "A String", # The URL for the avatar of the user who posted the comment.
"channelId": "A String", # The id of the corresponding YouTube channel. In case of a channel comment
# this is the channel the comment refers to. In case of a video comment
# it's the video's channel.
"updatedAt": "A String", # The date and time when was last updated . The value is
# specified in <a href="//www.w3.org/TR/NOTE-datetime">ISO 8601</a>
# format.
"publishedAt": "A String", # The date and time when the comment was orignally published. The value is
# specified in <a href="//www.w3.org/TR/NOTE-datetime">ISO 8601</a>
# format.
"parentId": "A String", # The unique id of the parent comment, only set for replies.
"videoId": "A String", # The ID of the video the comment refers to, if any.
"textOriginal": "A String", # The comment's original raw text as initially posted or last updated. The
# original text will only be returned if it is accessible to the viewer,
# which is only guaranteed if the viewer is the comment's author.
},
"kind": "youtube#comment", # Identifies what kind of resource this is. Value: the fixed string
# <code>"youtube#comment"</code>.
},
],
},
"etag": "A String", # Etag of this resource.
"kind": "youtube#commentThread", # Identifies what kind of resource this is. Value: the fixed string
# <code>"youtube#commentThread"</code>.
}
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{ # A <code><strong>comment thread</strong></code> represents information that
# applies to a top level comment and all its replies. It can also include the
# top level comment itself and some of the replies.
"id": "A String", # The ID that YouTube uses to uniquely identify the comment thread.
"snippet": { # Basic details about a comment thread. # The <code>snippet</code> object contains basic details about the comment
# thread and also the top level comment.
"channelId": "A String", # The YouTube channel the comments in the thread refer to or the channel
# with the video the comments refer to. If video_id isn't set the comments
# refer to the channel itself.
"totalReplyCount": 42, # The total number of replies (not including the top level comment).
"videoId": "A String", # The ID of the video the comments refer to, if any. No video_id implies a
# channel discussion comment.
"canReply": True or False, # Whether the current viewer of the thread can reply to it. This is viewer
# specific - other viewers may see a different value for this field.
"isPublic": True or False, # Whether the thread (and therefore all its comments) is visible to all
# YouTube users.
"topLevelComment": { # A <code><strong>comment</strong></code> represents a single YouTube comment. # The top level comment of this thread.
"etag": "A String", # Etag of this resource.
"id": "A String", # The ID that YouTube uses to uniquely identify the comment.
"snippet": { # Basic details about a comment, such as its author and text. # The <code>snippet</code> object contains basic details about the comment.
"canRate": True or False, # Whether the current viewer can rate this comment.
"moderationStatus": "A String", # The comment's moderation status. Will not be set if the comments were
# requested through the id filter.
"authorChannelId": { # The id of the author's YouTube channel, if any.
"value": "A String",
},
"authorDisplayName": "A String", # The name of the user who posted the comment.
"textDisplay": "A String", # The comment's text. The format is either plain text or HTML dependent on
# what has been requested. Even the plain text representation may differ
# from the text originally posted in that it may replace video links with
# video titles etc.
"likeCount": 42, # The total number of likes this comment has received.
"viewerRating": "A String", # The rating the viewer has given to this comment. For the time being this
# will never return RATE_TYPE_DISLIKE and instead return RATE_TYPE_NONE.
# This may change in the future.
"authorChannelUrl": "A String", # Link to the author's YouTube channel, if any.
"authorProfileImageUrl": "A String", # The URL for the avatar of the user who posted the comment.
"channelId": "A String", # The id of the corresponding YouTube channel. In case of a channel comment
# this is the channel the comment refers to. In case of a video comment
# it's the video's channel.
"updatedAt": "A String", # The date and time when was last updated . The value is
# specified in <a href="//www.w3.org/TR/NOTE-datetime">ISO 8601</a>
# format.
"publishedAt": "A String", # The date and time when the comment was orignally published. The value is
# specified in <a href="//www.w3.org/TR/NOTE-datetime">ISO 8601</a>
# format.
"parentId": "A String", # The unique id of the parent comment, only set for replies.
"videoId": "A String", # The ID of the video the comment refers to, if any.
"textOriginal": "A String", # The comment's original raw text as initially posted or last updated. The
# original text will only be returned if it is accessible to the viewer,
# which is only guaranteed if the viewer is the comment's author.
},
"kind": "youtube#comment", # Identifies what kind of resource this is. Value: the fixed string
# <code>"youtube#comment"</code>.
},
},
"replies": { # Comments written in (direct or indirect) reply to the top level comment. # The <code>replies</code> object contains a limited number of replies (if
# any) to the top level comment found in the snippet.
"comments": [ # A limited number of replies. Unless the number of replies returned equals
# total_reply_count in the snippet the returned replies are only a subset
# of the total number of replies.
{ # A <code><strong>comment</strong></code> represents a single YouTube comment.
"etag": "A String", # Etag of this resource.
"id": "A String", # The ID that YouTube uses to uniquely identify the comment.
"snippet": { # Basic details about a comment, such as its author and text. # The <code>snippet</code> object contains basic details about the comment.
"canRate": True or False, # Whether the current viewer can rate this comment.
"moderationStatus": "A String", # The comment's moderation status. Will not be set if the comments were
# requested through the id filter.
"authorChannelId": { # The id of the author's YouTube channel, if any.
"value": "A String",
},
"authorDisplayName": "A String", # The name of the user who posted the comment.
"textDisplay": "A String", # The comment's text. The format is either plain text or HTML dependent on
# what has been requested. Even the plain text representation may differ
# from the text originally posted in that it may replace video links with
# video titles etc.
"likeCount": 42, # The total number of likes this comment has received.
"viewerRating": "A String", # The rating the viewer has given to this comment. For the time being this
# will never return RATE_TYPE_DISLIKE and instead return RATE_TYPE_NONE.
# This may change in the future.
"authorChannelUrl": "A String", # Link to the author's YouTube channel, if any.
"authorProfileImageUrl": "A String", # The URL for the avatar of the user who posted the comment.
"channelId": "A String", # The id of the corresponding YouTube channel. In case of a channel comment
# this is the channel the comment refers to. In case of a video comment
# it's the video's channel.
"updatedAt": "A String", # The date and time when was last updated . The value is
# specified in <a href="//www.w3.org/TR/NOTE-datetime">ISO 8601</a>
# format.
"publishedAt": "A String", # The date and time when the comment was orignally published. The value is
# specified in <a href="//www.w3.org/TR/NOTE-datetime">ISO 8601</a>
# format.
"parentId": "A String", # The unique id of the parent comment, only set for replies.
"videoId": "A String", # The ID of the video the comment refers to, if any.
"textOriginal": "A String", # The comment's original raw text as initially posted or last updated. The
# original text will only be returned if it is accessible to the viewer,
# which is only guaranteed if the viewer is the comment's author.
},
"kind": "youtube#comment", # Identifies what kind of resource this is. Value: the fixed string
# <code>"youtube#comment"</code>.
},
],
},
"etag": "A String", # Etag of this resource.
"kind": "youtube#commentThread", # Identifies what kind of resource this is. Value: the fixed string
# <code>"youtube#commentThread"</code>.
}
list(part, searchTerms=None, maxResults=None, videoId=None, order=None, moderationStatus=None, allThreadsRelatedToChannelId=None, pageToken=None, id=None, channelId=None, textFormat=None, x__xgafv=None)
Retrieves a list of resources, possibly filtered.
Args:
part: string, The <code><strong>part</strong></code> parameter specifies a
comma-separated list of one or more <code>commentThread</code> resource
properties that the API response will include. (required) (repeated)
searchTerms: string, Limits the returned comment threads to those matching the specified
key words. Not compatible with the 'id' filter.
maxResults: integer, The <code><strong>maxResults</strong></code> parameter specifies the
maximum number of items that should be returned in the result set.
videoId: string, Returns the comment threads of the specified video.
order: string, A parameter
moderationStatus: string, Limits the returned comment threads to those with the specified
moderation status. Not compatible with the 'id' filter.
Valid values: published, heldForReview, likelySpam.
allThreadsRelatedToChannelId: string, Returns the comment threads of all videos of the channel and the
channel comments as well.
pageToken: string, The <code><strong>pageToken</strong></code> parameter identifies a specific
page in the result set that should be returned. In an API response, the
<code>nextPageToken</code> and <code>prevPageToken</code> properties
identify other pages that could be retrieved.
id: string, Returns the comment threads with the given IDs for Stubby or Apiary. (repeated)
channelId: string, Returns the comment threads for all the channel comments (ie does not
include comments left on videos).
textFormat: string, The requested text format for the returned comments.
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{
"visitorId": "A String", # The <code>visitorId</code> identifies the visitor.
"pageInfo": { # Paging details for lists of resources, including total number of items # General pagination information.
# available and number of resources returned in a single page.
"resultsPerPage": 42, # The number of results included in the API response.
"totalResults": 42, # The total number of results in the result set.
},
"items": [ # A list of comment threads that match the request criteria.
{ # A <code><strong>comment thread</strong></code> represents information that
# applies to a top level comment and all its replies. It can also include the
# top level comment itself and some of the replies.
"id": "A String", # The ID that YouTube uses to uniquely identify the comment thread.
"snippet": { # Basic details about a comment thread. # The <code>snippet</code> object contains basic details about the comment
# thread and also the top level comment.
"channelId": "A String", # The YouTube channel the comments in the thread refer to or the channel
# with the video the comments refer to. If video_id isn't set the comments
# refer to the channel itself.
"totalReplyCount": 42, # The total number of replies (not including the top level comment).
"videoId": "A String", # The ID of the video the comments refer to, if any. No video_id implies a
# channel discussion comment.
"canReply": True or False, # Whether the current viewer of the thread can reply to it. This is viewer
# specific - other viewers may see a different value for this field.
"isPublic": True or False, # Whether the thread (and therefore all its comments) is visible to all
# YouTube users.
"topLevelComment": { # A <code><strong>comment</strong></code> represents a single YouTube comment. # The top level comment of this thread.
"etag": "A String", # Etag of this resource.
"id": "A String", # The ID that YouTube uses to uniquely identify the comment.
"snippet": { # Basic details about a comment, such as its author and text. # The <code>snippet</code> object contains basic details about the comment.
"canRate": True or False, # Whether the current viewer can rate this comment.
"moderationStatus": "A String", # The comment's moderation status. Will not be set if the comments were
# requested through the id filter.
"authorChannelId": { # The id of the author's YouTube channel, if any.
"value": "A String",
},
"authorDisplayName": "A String", # The name of the user who posted the comment.
"textDisplay": "A String", # The comment's text. The format is either plain text or HTML dependent on
# what has been requested. Even the plain text representation may differ
# from the text originally posted in that it may replace video links with
# video titles etc.
"likeCount": 42, # The total number of likes this comment has received.
"viewerRating": "A String", # The rating the viewer has given to this comment. For the time being this
# will never return RATE_TYPE_DISLIKE and instead return RATE_TYPE_NONE.
# This may change in the future.
"authorChannelUrl": "A String", # Link to the author's YouTube channel, if any.
"authorProfileImageUrl": "A String", # The URL for the avatar of the user who posted the comment.
"channelId": "A String", # The id of the corresponding YouTube channel. In case of a channel comment
# this is the channel the comment refers to. In case of a video comment
# it's the video's channel.
"updatedAt": "A String", # The date and time when was last updated . The value is
# specified in <a href="//www.w3.org/TR/NOTE-datetime">ISO 8601</a>
# format.
"publishedAt": "A String", # The date and time when the comment was orignally published. The value is
# specified in <a href="//www.w3.org/TR/NOTE-datetime">ISO 8601</a>
# format.
"parentId": "A String", # The unique id of the parent comment, only set for replies.
"videoId": "A String", # The ID of the video the comment refers to, if any.
"textOriginal": "A String", # The comment's original raw text as initially posted or last updated. The
# original text will only be returned if it is accessible to the viewer,
# which is only guaranteed if the viewer is the comment's author.
},
"kind": "youtube#comment", # Identifies what kind of resource this is. Value: the fixed string
# <code>"youtube#comment"</code>.
},
},
"replies": { # Comments written in (direct or indirect) reply to the top level comment. # The <code>replies</code> object contains a limited number of replies (if
# any) to the top level comment found in the snippet.
"comments": [ # A limited number of replies. Unless the number of replies returned equals
# total_reply_count in the snippet the returned replies are only a subset
# of the total number of replies.
{ # A <code><strong>comment</strong></code> represents a single YouTube comment.
"etag": "A String", # Etag of this resource.
"id": "A String", # The ID that YouTube uses to uniquely identify the comment.
"snippet": { # Basic details about a comment, such as its author and text. # The <code>snippet</code> object contains basic details about the comment.
"canRate": True or False, # Whether the current viewer can rate this comment.
"moderationStatus": "A String", # The comment's moderation status. Will not be set if the comments were
# requested through the id filter.
"authorChannelId": { # The id of the author's YouTube channel, if any.
"value": "A String",
},
"authorDisplayName": "A String", # The name of the user who posted the comment.
"textDisplay": "A String", # The comment's text. The format is either plain text or HTML dependent on
# what has been requested. Even the plain text representation may differ
# from the text originally posted in that it may replace video links with
# video titles etc.
"likeCount": 42, # The total number of likes this comment has received.
"viewerRating": "A String", # The rating the viewer has given to this comment. For the time being this
# will never return RATE_TYPE_DISLIKE and instead return RATE_TYPE_NONE.
# This may change in the future.
"authorChannelUrl": "A String", # Link to the author's YouTube channel, if any.
"authorProfileImageUrl": "A String", # The URL for the avatar of the user who posted the comment.
"channelId": "A String", # The id of the corresponding YouTube channel. In case of a channel comment
# this is the channel the comment refers to. In case of a video comment
# it's the video's channel.
"updatedAt": "A String", # The date and time when was last updated . The value is
# specified in <a href="//www.w3.org/TR/NOTE-datetime">ISO 8601</a>
# format.
"publishedAt": "A String", # The date and time when the comment was orignally published. The value is
# specified in <a href="//www.w3.org/TR/NOTE-datetime">ISO 8601</a>
# format.
"parentId": "A String", # The unique id of the parent comment, only set for replies.
"videoId": "A String", # The ID of the video the comment refers to, if any.
"textOriginal": "A String", # The comment's original raw text as initially posted or last updated. The
# original text will only be returned if it is accessible to the viewer,
# which is only guaranteed if the viewer is the comment's author.
},
"kind": "youtube#comment", # Identifies what kind of resource this is. Value: the fixed string
# <code>"youtube#comment"</code>.
},
],
},
"etag": "A String", # Etag of this resource.
"kind": "youtube#commentThread", # Identifies what kind of resource this is. Value: the fixed string
# <code>"youtube#commentThread"</code>.
},
],
"nextPageToken": "A String", # The token that can be used as the value of the <code>pageToken</code>
# parameter to retrieve the next page in the result set.
"etag": "A String", # Etag of this resource.
"tokenPagination": { # Stub token pagination template to suppress results.
},
"eventId": "A String", # Serialized EventId of the request which produced this response.
"kind": "youtube#commentThreadListResponse", # Identifies what kind of resource this is. Value: the fixed string
# <code>"youtube#commentThreadListResponse"</code>.
}
list_next(previous_request, previous_response)
Retrieves the next page of results.
Args:
previous_request: The request for the previous page. (required)
previous_response: The response from the request for the previous page. (required)
Returns:
A request object that you can call 'execute()' on to request the next
page. Returns None if there are no more items in the collection.
update(part, body=None, x__xgafv=None)
Updates an existing resource.
Args:
part: string, The <code><strong>part</strong></code> parameter specifies a
comma-separated list of <code>commentThread</code> resource properties that
the API response will include. You must at least include the
<code>snippet</code> part in the parameter value since that part contains
all of the properties that the API request can update. (required) (repeated)
body: object, The request body.
The object takes the form of:
{ # A <code><strong>comment thread</strong></code> represents information that
# applies to a top level comment and all its replies. It can also include the
# top level comment itself and some of the replies.
"id": "A String", # The ID that YouTube uses to uniquely identify the comment thread.
"snippet": { # Basic details about a comment thread. # The <code>snippet</code> object contains basic details about the comment
# thread and also the top level comment.
"channelId": "A String", # The YouTube channel the comments in the thread refer to or the channel
# with the video the comments refer to. If video_id isn't set the comments
# refer to the channel itself.
"totalReplyCount": 42, # The total number of replies (not including the top level comment).
"videoId": "A String", # The ID of the video the comments refer to, if any. No video_id implies a
# channel discussion comment.
"canReply": True or False, # Whether the current viewer of the thread can reply to it. This is viewer
# specific - other viewers may see a different value for this field.
"isPublic": True or False, # Whether the thread (and therefore all its comments) is visible to all
# YouTube users.
"topLevelComment": { # A <code><strong>comment</strong></code> represents a single YouTube comment. # The top level comment of this thread.
"etag": "A String", # Etag of this resource.
"id": "A String", # The ID that YouTube uses to uniquely identify the comment.
"snippet": { # Basic details about a comment, such as its author and text. # The <code>snippet</code> object contains basic details about the comment.
"canRate": True or False, # Whether the current viewer can rate this comment.
"moderationStatus": "A String", # The comment's moderation status. Will not be set if the comments were
# requested through the id filter.
"authorChannelId": { # The id of the author's YouTube channel, if any.
"value": "A String",
},
"authorDisplayName": "A String", # The name of the user who posted the comment.
"textDisplay": "A String", # The comment's text. The format is either plain text or HTML dependent on
# what has been requested. Even the plain text representation may differ
# from the text originally posted in that it may replace video links with
# video titles etc.
"likeCount": 42, # The total number of likes this comment has received.
"viewerRating": "A String", # The rating the viewer has given to this comment. For the time being this
# will never return RATE_TYPE_DISLIKE and instead return RATE_TYPE_NONE.
# This may change in the future.
"authorChannelUrl": "A String", # Link to the author's YouTube channel, if any.
"authorProfileImageUrl": "A String", # The URL for the avatar of the user who posted the comment.
"channelId": "A String", # The id of the corresponding YouTube channel. In case of a channel comment
# this is the channel the comment refers to. In case of a video comment
# it's the video's channel.
"updatedAt": "A String", # The date and time when was last updated . The value is
# specified in <a href="//www.w3.org/TR/NOTE-datetime">ISO 8601</a>
# format.
"publishedAt": "A String", # The date and time when the comment was orignally published. The value is
# specified in <a href="//www.w3.org/TR/NOTE-datetime">ISO 8601</a>
# format.
"parentId": "A String", # The unique id of the parent comment, only set for replies.
"videoId": "A String", # The ID of the video the comment refers to, if any.
"textOriginal": "A String", # The comment's original raw text as initially posted or last updated. The
# original text will only be returned if it is accessible to the viewer,
# which is only guaranteed if the viewer is the comment's author.
},
"kind": "youtube#comment", # Identifies what kind of resource this is. Value: the fixed string
# <code>"youtube#comment"</code>.
},
},
"replies": { # Comments written in (direct or indirect) reply to the top level comment. # The <code>replies</code> object contains a limited number of replies (if
# any) to the top level comment found in the snippet.
"comments": [ # A limited number of replies. Unless the number of replies returned equals
# total_reply_count in the snippet the returned replies are only a subset
# of the total number of replies.
{ # A <code><strong>comment</strong></code> represents a single YouTube comment.
"etag": "A String", # Etag of this resource.
"id": "A String", # The ID that YouTube uses to uniquely identify the comment.
"snippet": { # Basic details about a comment, such as its author and text. # The <code>snippet</code> object contains basic details about the comment.
"canRate": True or False, # Whether the current viewer can rate this comment.
"moderationStatus": "A String", # The comment's moderation status. Will not be set if the comments were
# requested through the id filter.
"authorChannelId": { # The id of the author's YouTube channel, if any.
"value": "A String",
},
"authorDisplayName": "A String", # The name of the user who posted the comment.
"textDisplay": "A String", # The comment's text. The format is either plain text or HTML dependent on
# what has been requested. Even the plain text representation may differ
# from the text originally posted in that it may replace video links with
# video titles etc.
"likeCount": 42, # The total number of likes this comment has received.
"viewerRating": "A String", # The rating the viewer has given to this comment. For the time being this
# will never return RATE_TYPE_DISLIKE and instead return RATE_TYPE_NONE.
# This may change in the future.
"authorChannelUrl": "A String", # Link to the author's YouTube channel, if any.
"authorProfileImageUrl": "A String", # The URL for the avatar of the user who posted the comment.
"channelId": "A String", # The id of the corresponding YouTube channel. In case of a channel comment
# this is the channel the comment refers to. In case of a video comment
# it's the video's channel.
"updatedAt": "A String", # The date and time when was last updated . The value is
# specified in <a href="//www.w3.org/TR/NOTE-datetime">ISO 8601</a>
# format.
"publishedAt": "A String", # The date and time when the comment was orignally published. The value is
# specified in <a href="//www.w3.org/TR/NOTE-datetime">ISO 8601</a>
# format.
"parentId": "A String", # The unique id of the parent comment, only set for replies.
"videoId": "A String", # The ID of the video the comment refers to, if any.
"textOriginal": "A String", # The comment's original raw text as initially posted or last updated. The
# original text will only be returned if it is accessible to the viewer,
# which is only guaranteed if the viewer is the comment's author.
},
"kind": "youtube#comment", # Identifies what kind of resource this is. Value: the fixed string
# <code>"youtube#comment"</code>.
},
],
},
"etag": "A String", # Etag of this resource.
"kind": "youtube#commentThread", # Identifies what kind of resource this is. Value: the fixed string
# <code>"youtube#commentThread"</code>.
}
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{ # A <code><strong>comment thread</strong></code> represents information that
# applies to a top level comment and all its replies. It can also include the
# top level comment itself and some of the replies.
"id": "A String", # The ID that YouTube uses to uniquely identify the comment thread.
"snippet": { # Basic details about a comment thread. # The <code>snippet</code> object contains basic details about the comment
# thread and also the top level comment.
"channelId": "A String", # The YouTube channel the comments in the thread refer to or the channel
# with the video the comments refer to. If video_id isn't set the comments
# refer to the channel itself.
"totalReplyCount": 42, # The total number of replies (not including the top level comment).
"videoId": "A String", # The ID of the video the comments refer to, if any. No video_id implies a
# channel discussion comment.
"canReply": True or False, # Whether the current viewer of the thread can reply to it. This is viewer
# specific - other viewers may see a different value for this field.
"isPublic": True or False, # Whether the thread (and therefore all its comments) is visible to all
# YouTube users.
"topLevelComment": { # A <code><strong>comment</strong></code> represents a single YouTube comment. # The top level comment of this thread.
"etag": "A String", # Etag of this resource.
"id": "A String", # The ID that YouTube uses to uniquely identify the comment.
"snippet": { # Basic details about a comment, such as its author and text. # The <code>snippet</code> object contains basic details about the comment.
"canRate": True or False, # Whether the current viewer can rate this comment.
"moderationStatus": "A String", # The comment's moderation status. Will not be set if the comments were
# requested through the id filter.
"authorChannelId": { # The id of the author's YouTube channel, if any.
"value": "A String",
},
"authorDisplayName": "A String", # The name of the user who posted the comment.
"textDisplay": "A String", # The comment's text. The format is either plain text or HTML dependent on
# what has been requested. Even the plain text representation may differ
# from the text originally posted in that it may replace video links with
# video titles etc.
"likeCount": 42, # The total number of likes this comment has received.
"viewerRating": "A String", # The rating the viewer has given to this comment. For the time being this
# will never return RATE_TYPE_DISLIKE and instead return RATE_TYPE_NONE.
# This may change in the future.
"authorChannelUrl": "A String", # Link to the author's YouTube channel, if any.
"authorProfileImageUrl": "A String", # The URL for the avatar of the user who posted the comment.
"channelId": "A String", # The id of the corresponding YouTube channel. In case of a channel comment
# this is the channel the comment refers to. In case of a video comment
# it's the video's channel.
"updatedAt": "A String", # The date and time when was last updated . The value is
# specified in <a href="//www.w3.org/TR/NOTE-datetime">ISO 8601</a>
# format.
"publishedAt": "A String", # The date and time when the comment was orignally published. The value is
# specified in <a href="//www.w3.org/TR/NOTE-datetime">ISO 8601</a>
# format.
"parentId": "A String", # The unique id of the parent comment, only set for replies.
"videoId": "A String", # The ID of the video the comment refers to, if any.
"textOriginal": "A String", # The comment's original raw text as initially posted or last updated. The
# original text will only be returned if it is accessible to the viewer,
# which is only guaranteed if the viewer is the comment's author.
},
"kind": "youtube#comment", # Identifies what kind of resource this is. Value: the fixed string
# <code>"youtube#comment"</code>.
},
},
"replies": { # Comments written in (direct or indirect) reply to the top level comment. # The <code>replies</code> object contains a limited number of replies (if
# any) to the top level comment found in the snippet.
"comments": [ # A limited number of replies. Unless the number of replies returned equals
# total_reply_count in the snippet the returned replies are only a subset
# of the total number of replies.
{ # A <code><strong>comment</strong></code> represents a single YouTube comment.
"etag": "A String", # Etag of this resource.
"id": "A String", # The ID that YouTube uses to uniquely identify the comment.
"snippet": { # Basic details about a comment, such as its author and text. # The <code>snippet</code> object contains basic details about the comment.
"canRate": True or False, # Whether the current viewer can rate this comment.
"moderationStatus": "A String", # The comment's moderation status. Will not be set if the comments were
# requested through the id filter.
"authorChannelId": { # The id of the author's YouTube channel, if any.
"value": "A String",
},
"authorDisplayName": "A String", # The name of the user who posted the comment.
"textDisplay": "A String", # The comment's text. The format is either plain text or HTML dependent on
# what has been requested. Even the plain text representation may differ
# from the text originally posted in that it may replace video links with
# video titles etc.
"likeCount": 42, # The total number of likes this comment has received.
"viewerRating": "A String", # The rating the viewer has given to this comment. For the time being this
# will never return RATE_TYPE_DISLIKE and instead return RATE_TYPE_NONE.
# This may change in the future.
"authorChannelUrl": "A String", # Link to the author's YouTube channel, if any.
"authorProfileImageUrl": "A String", # The URL for the avatar of the user who posted the comment.
"channelId": "A String", # The id of the corresponding YouTube channel. In case of a channel comment
# this is the channel the comment refers to. In case of a video comment
# it's the video's channel.
"updatedAt": "A String", # The date and time when was last updated . The value is
# specified in <a href="//www.w3.org/TR/NOTE-datetime">ISO 8601</a>
# format.
"publishedAt": "A String", # The date and time when the comment was orignally published. The value is
# specified in <a href="//www.w3.org/TR/NOTE-datetime">ISO 8601</a>
# format.
"parentId": "A String", # The unique id of the parent comment, only set for replies.
"videoId": "A String", # The ID of the video the comment refers to, if any.
"textOriginal": "A String", # The comment's original raw text as initially posted or last updated. The
# original text will only be returned if it is accessible to the viewer,
# which is only guaranteed if the viewer is the comment's author.
},
"kind": "youtube#comment", # Identifies what kind of resource this is. Value: the fixed string
# <code>"youtube#comment"</code>.
},
],
},
"etag": "A String", # Etag of this resource.
"kind": "youtube#commentThread", # Identifies what kind of resource this is. Value: the fixed string
# <code>"youtube#commentThread"</code>.
}