Update docs for 1.4.2 release
diff --git a/docs/dyn/youtube_v3.commentThreads.html b/docs/dyn/youtube_v3.commentThreads.html
index 67016d1..4ef131a 100644
--- a/docs/dyn/youtube_v3.commentThreads.html
+++ b/docs/dyn/youtube_v3.commentThreads.html
@@ -75,8 +75,8 @@
<h1><a href="youtube_v3.html">YouTube Data API</a> . <a href="youtube_v3.commentThreads.html">commentThreads</a></h1>
<h2>Instance Methods</h2>
<p class="toc_element">
- <code><a href="#insert">insert(part=None, body, shareOnGooglePlus=None)</a></code></p>
-<p class="firstline">Creates a new comment thread and top level comment.</p>
+ <code><a href="#insert">insert(part, body)</a></code></p>
+<p class="firstline">Creates a new top-level comment. To add a reply to an existing comment, use the comments.insert method instead.</p>
<p class="toc_element">
<code><a href="#list">list(part, channelId=None, id=None, pageToken=None, allThreadsRelatedToChannelId=None, moderationStatus=None, videoId=None, maxResults=None, searchTerms=None, textFormat=None, order=None)</a></code></p>
<p class="firstline">Returns a list of comment threads that match the API request parameters.</p>
@@ -84,17 +84,15 @@
<code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
<p class="firstline">Retrieves the next page of results.</p>
<p class="toc_element">
- <code><a href="#update">update(part=None, body)</a></code></p>
-<p class="firstline">Modifies an existing comment.</p>
+ <code><a href="#update">update(part, body)</a></code></p>
+<p class="firstline">Modifies the top-level comment in a comment thread.</p>
<h3>Method Details</h3>
<div class="method">
- <code class="details" id="insert">insert(part=None, body, shareOnGooglePlus=None)</code>
- <pre>Creates a new comment thread and top level comment.
+ <code class="details" id="insert">insert(part, body)</code>
+ <pre>Creates a new top-level comment. To add a reply to an existing comment, use the comments.insert method instead.
Args:
- part: string, The part parameter serves two purposes in this operation. It identifies the properties that the write operation will set as well as the properties that the API response will include.
-
-The part names that you can include in the parameter value are id and snippet. However only snippet contains properties that can be set. (required)
+ 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. (required)
body: object, The request body. (required)
The object takes the form of:
@@ -165,7 +163,6 @@
},
}
- shareOnGooglePlus: boolean, The shareOnGooglePlus determines whether this thread should also be posted on Google+.
Returns:
An object of the form:
@@ -243,30 +240,30 @@
<pre>Returns a list of comment threads that match the API request parameters.
Args:
- part: string, The part parameter specifies the commentThread resource parts that the API response will include. Supported values are id, snippet and replies. (required)
- channelId: string, The channelId parameter instructs the API to return the comment threads for all the channel comments (not including comments left on videos).
+ part: string, The part parameter specifies a comma-separated list of one or more commentThread resource properties that the API response will include. (required)
+ channelId: string, The channelId parameter instructs the API to return comment threads containing comments about the specified channel. (The response will not include comments left on videos that the channel uploaded.)
id: string, The id parameter specifies a comma-separated list of comment thread IDs for the resources that should be retrieved.
pageToken: string, The pageToken parameter identifies a specific page in the result set that should be returned. In an API response, the nextPageToken property identifies the next page of the result that can be retrieved.
Note: This parameter is not supported for use in conjunction with the id parameter.
- allThreadsRelatedToChannelId: string, The allThreadsRelatedToChannelId parameter instructs the API to return the comment threads of all videos of the channel and the channel comments as well.
+ allThreadsRelatedToChannelId: string, The allThreadsRelatedToChannelId parameter instructs the API to return all comment threads associated with the specified channel. The response can include comments about the channel or about the channel's videos.
moderationStatus: string, Set this parameter to limit the returned comment threads to a particular moderation state.
Note: This parameter is not supported for use in conjunction with the id parameter.
Allowed values
- heldForReview - Returns only comment threads awaiting review by a moderator.
- likelySpam - Returns only comment threads classified as likely being spam.
- published - Returns only published comment threads.
- videoId: string, The videoId parameter instructs the API to return the comment threads for the video specified by the video id.
+ heldForReview - Retrieve comment threads that are awaiting review by a moderator. A comment thread can be included in the response if the top-level comment or at least one of the replies to that comment are awaiting review.
+ likelySpam - Retrieve comment threads classified as likely to be spam. A comment thread can be included in the response if the top-level comment or at least one of the replies to that comment is considered likely to be spam.
+ published - Retrieve threads of published comments. This is the default value. A comment thread can be included in the response if its top-level comment has been published.
+ videoId: string, The videoId parameter instructs the API to return comment threads associated with the specified video ID.
maxResults: integer, The maxResults parameter specifies the maximum number of items that should be returned in the result set.
Note: This parameter is not supported for use in conjunction with the id parameter.
- searchTerms: string, The searchTerms parameter instructs the API to limit the returned comments to those which contain the specified search terms.
+ searchTerms: string, The searchTerms parameter instructs the API to limit the API response to only contain comments that contain the specified search terms.
Note: This parameter is not supported for use in conjunction with the id parameter.
textFormat: string, Set this parameter's value to html or plainText to instruct the API to return the comments left by users in html formatted or in plain text.
Allowed values
- html - Returns the comments in HTML format.
+ html - Returns the comments in HTML format. This is the default value.
plainText - Returns the comments in plain text format.
order: string, The order parameter specifies the order in which the API response should list comment threads. Valid values are:
- time - Comment threads are ordered by time. This is the default behavior.
@@ -376,13 +373,11 @@
</div>
<div class="method">
- <code class="details" id="update">update(part=None, body)</code>
- <pre>Modifies an existing comment.
+ <code class="details" id="update">update(part, body)</code>
+ <pre>Modifies the top-level comment in a comment thread.
Args:
- part: string, The part parameter serves two purposes in this operation. It identifies the properties that the write operation will set as well as the properties that the API response will include.
-
-The part names that you can include in the parameter value are id, snippet and replies. However only snippet contains properties that can be updated. (required)
+ part: string, The part parameter specifies a comma-separated list of commentThread resource properties that the API response will include. You must at least include the snippet part in the parameter value since that part contains all of the properties that the API request can update. (required)
body: object, The request body. (required)
The object takes the form of: