docs: docs update (#911)
Thank you for opening a Pull Request! Before submitting your PR, there are a few things you can do to make sure it goes smoothly:
- [ ] Make sure to open an issue as a [bug/issue](https://github.com/googleapis/google-api-python-client/issues/new/choose) before writing your code! That way we can discuss the change, evaluate designs, and agree on the general idea
- [ ] Ensure the tests and linter pass
- [ ] Code coverage does not decrease (if any source code was changed)
- [ ] Appropriate docs were updated (if necessary)
Fixes #<issue_number_goes_here> 🦕
diff --git a/docs/dyn/blogger_v3.postUserInfos.html b/docs/dyn/blogger_v3.postUserInfos.html
index 6b7da7d..632050a 100644
--- a/docs/dyn/blogger_v3.postUserInfos.html
+++ b/docs/dyn/blogger_v3.postUserInfos.html
@@ -78,7 +78,7 @@
<code><a href="#get">get(userId, blogId, postId, maxComments=None, x__xgafv=None)</a></code></p>
<p class="firstline">Gets one post and user info pair, by post_id and user_id.</p>
<p class="toc_element">
- <code><a href="#list">list(userId, blogId, orderBy=None, startDate=None, endDate=None, labels=None, x__xgafv=None, pageToken=None, status=None, maxResults=None, fetchBodies=None, view=None)</a></code></p>
+ <code><a href="#list">list(userId, blogId, startDate=None, labels=None, endDate=None, orderBy=None, status=None, pageToken=None, maxResults=None, view=None, fetchBodies=None, x__xgafv=None)</a></code></p>
<p class="firstline">Lists post and user info pairs.</p>
<p class="toc_element">
<code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
@@ -102,200 +102,200 @@
An object of the form:
{
- "kind": "A String", # The kind of this entity. Always blogger#postUserInfo.
- "post": { # The Post resource.
- "status": "A String", # Status of the post. Only set for admin-level requests.
- "blog": { # Data about the blog containing this Post.
- "id": "A String", # The identifier of the Blog that contains this Post.
- },
- "updated": "A String", # RFC 3339 date-time when this Post was last updated.
- "titleLink": "A String", # The title link URL, similar to atom's related link.
- "author": { # The author of this Post.
- "url": "A String", # The URL of the creator's Profile page.
- "image": { # The creator's avatar.
- "url": "A String", # The creator's avatar URL.
- },
- "displayName": "A String", # The display name.
- "id": "A String", # The identifier of the creator.
- },
- "title": "A String", # The title of the Post.
- "replies": { # The container of comments on this Post.
- "totalItems": "A String", # The count of comments on this post.
- "items": [ # The List of Comments for this Post.
+ "post": { # The Post resource.
+ "customMetaData": "A String", # The JSON meta-data for the Post.
+ "replies": { # The container of comments on this Post.
+ "items": [ # The List of Comments for this Post.
{
- "status": "A String", # The status of the comment (only populated for admin users).
- "inReplyTo": { # Data about the comment this is in reply to.
- "id": "A String", # The identified of the parent of this comment.
+ "kind": "A String", # The kind of this entry. Always blogger#comment.
+ "selfLink": "A String", # The API REST URL to fetch this resource from.
+ "id": "A String", # The identifier for this resource.
+ "published": "A String", # RFC 3339 date-time when this comment was published.
+ "blog": { # Data about the blog containing this comment.
+ "id": "A String", # The identifier of the blog containing this comment.
},
- "kind": "A String", # The kind of this entry. Always blogger#comment.
- "author": { # The author of this Comment.
- "url": "A String", # The URL of the creator's Profile page.
- "image": { # The creator's avatar.
- "url": "A String", # The creator's avatar URL.
+ "content": "A String", # The actual content of the comment. May include HTML markup.
+ "inReplyTo": { # Data about the comment this is in reply to.
+ "id": "A String", # The identified of the parent of this comment.
+ },
+ "updated": "A String", # RFC 3339 date-time when this comment was last updated.
+ "status": "A String", # The status of the comment (only populated for admin users).
+ "author": { # The author of this Comment.
+ "image": { # The creator's avatar.
+ "url": "A String", # The creator's avatar URL.
},
- "displayName": "A String", # The display name.
- "id": "A String", # The identifier of the creator.
+ "displayName": "A String", # The display name.
+ "url": "A String", # The URL of the creator's Profile page.
+ "id": "A String", # The identifier of the creator.
},
- "updated": "A String", # RFC 3339 date-time when this comment was last updated.
- "blog": { # Data about the blog containing this comment.
- "id": "A String", # The identifier of the blog containing this comment.
+ "post": { # Data about the post containing this comment.
+ "id": "A String", # The identifier of the post containing this comment.
},
- "published": "A String", # RFC 3339 date-time when this comment was published.
- "post": { # Data about the post containing this comment.
- "id": "A String", # The identifier of the post containing this comment.
- },
- "content": "A String", # The actual content of the comment. May include HTML markup.
- "id": "A String", # The identifier for this resource.
- "selfLink": "A String", # The API REST URL to fetch this resource from.
},
],
- "selfLink": "A String", # The URL of the comments on this post.
+ "selfLink": "A String", # The URL of the comments on this post.
+ "totalItems": "A String", # The count of comments on this post.
},
- "readerComments": "A String", # Comment control and display setting for readers of this post.
- "labels": [ # The list of labels this Post was tagged with.
- "A String",
+ "selfLink": "A String", # The API REST URL to fetch this resource from.
+ "labels": [ # The list of labels this Post was tagged with.
+ "A String",
],
- "customMetaData": "A String", # The JSON meta-data for the Post.
- "kind": "A String", # The kind of this entity. Always blogger#post.
- "content": "A String", # The content of the Post. May contain HTML markup.
- "url": "A String", # The URL where this Post is displayed.
- "etag": "A String", # Etag of the resource.
- "location": { # The location for geotagged posts.
- "lat": 3.14, # Location's latitude.
- "lng": 3.14, # Location's longitude.
- "span": "A String", # Location's viewport span. Can be used when rendering a map preview.
- "name": "A String", # Location name.
+ "author": { # The author of this Post.
+ "id": "A String", # The identifier of the creator.
+ "image": { # The creator's avatar.
+ "url": "A String", # The creator's avatar URL.
+ },
+ "displayName": "A String", # The display name.
+ "url": "A String", # The URL of the creator's Profile page.
},
- "published": "A String", # RFC 3339 date-time when this Post was published.
- "images": [ # Display image for the Post.
+ "images": [ # Display image for the Post.
{
- "url": "A String",
+ "url": "A String",
},
],
- "id": "A String", # The identifier of this Post.
- "selfLink": "A String", # The API REST URL to fetch this resource from.
+ "published": "A String", # RFC 3339 date-time when this Post was published.
+ "title": "A String", # The title of the Post.
+ "titleLink": "A String", # The title link URL, similar to atom's related link.
+ "blog": { # Data about the blog containing this Post.
+ "id": "A String", # The identifier of the Blog that contains this Post.
+ },
+ "updated": "A String", # RFC 3339 date-time when this Post was last updated.
+ "url": "A String", # The URL where this Post is displayed.
+ "content": "A String", # The content of the Post. May contain HTML markup.
+ "id": "A String", # The identifier of this Post.
+ "location": { # The location for geotagged posts.
+ "name": "A String", # Location name.
+ "span": "A String", # Location's viewport span. Can be used when rendering a map preview.
+ "lat": 3.14, # Location's latitude.
+ "lng": 3.14, # Location's longitude.
+ },
+ "status": "A String", # Status of the post. Only set for admin-level requests.
+ "readerComments": "A String", # Comment control and display setting for readers of this post.
+ "etag": "A String", # Etag of the resource.
+ "kind": "A String", # The kind of this entity. Always blogger#post.
},
- "post_user_info": { # Information about a User for the Post.
- "kind": "A String", # The kind of this entity. Always blogger#postPerUserInfo.
- "postId": "A String", # ID of the Post resource.
- "userId": "A String", # ID of the User.
- "blogId": "A String", # ID of the Blog that the post resource belongs to.
- "hasEditAccess": True or False, # True if the user has Author level access to the post.
+ "post_user_info": { # Information about a User for the Post.
+ "postId": "A String", # ID of the Post resource.
+ "hasEditAccess": True or False, # True if the user has Author level access to the post.
+ "userId": "A String", # ID of the User.
+ "kind": "A String", # The kind of this entity. Always blogger#postPerUserInfo.
+ "blogId": "A String", # ID of the Blog that the post resource belongs to.
},
+ "kind": "A String", # The kind of this entity. Always blogger#postUserInfo.
}</pre>
</div>
<div class="method">
- <code class="details" id="list">list(userId, blogId, orderBy=None, startDate=None, endDate=None, labels=None, x__xgafv=None, pageToken=None, status=None, maxResults=None, fetchBodies=None, view=None)</code>
+ <code class="details" id="list">list(userId, blogId, startDate=None, labels=None, endDate=None, orderBy=None, status=None, pageToken=None, maxResults=None, view=None, fetchBodies=None, x__xgafv=None)</code>
<pre>Lists post and user info pairs.
Args:
userId: string, A parameter (required)
blogId: string, A parameter (required)
- orderBy: string, A parameter
startDate: string, A parameter
- endDate: string, A parameter
labels: string, A parameter
+ endDate: string, A parameter
+ orderBy: string, A parameter
+ status: string, A parameter (repeated)
+ pageToken: string, A parameter
+ maxResults: integer, A parameter
+ view: string, A parameter
+ fetchBodies: boolean, A parameter
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
- pageToken: string, A parameter
- status: string, A parameter (repeated)
- maxResults: integer, A parameter
- fetchBodies: boolean, A parameter
- view: string, A parameter
Returns:
An object of the form:
{
- "nextPageToken": "A String", # Pagination token to fetch the next page, if one exists.
- "items": [ # The list of Posts with User information for the post, for this Blog.
+ "kind": "A String", # The kind of this entity. Always blogger#postList.
+ "items": [ # The list of Posts with User information for the post, for this Blog.
{
- "kind": "A String", # The kind of this entity. Always blogger#postUserInfo.
- "post": { # The Post resource.
- "status": "A String", # Status of the post. Only set for admin-level requests.
- "blog": { # Data about the blog containing this Post.
- "id": "A String", # The identifier of the Blog that contains this Post.
- },
- "updated": "A String", # RFC 3339 date-time when this Post was last updated.
- "titleLink": "A String", # The title link URL, similar to atom's related link.
- "author": { # The author of this Post.
- "url": "A String", # The URL of the creator's Profile page.
- "image": { # The creator's avatar.
- "url": "A String", # The creator's avatar URL.
- },
- "displayName": "A String", # The display name.
- "id": "A String", # The identifier of the creator.
- },
- "title": "A String", # The title of the Post.
- "replies": { # The container of comments on this Post.
- "totalItems": "A String", # The count of comments on this post.
- "items": [ # The List of Comments for this Post.
+ "post": { # The Post resource.
+ "customMetaData": "A String", # The JSON meta-data for the Post.
+ "replies": { # The container of comments on this Post.
+ "items": [ # The List of Comments for this Post.
{
- "status": "A String", # The status of the comment (only populated for admin users).
- "inReplyTo": { # Data about the comment this is in reply to.
- "id": "A String", # The identified of the parent of this comment.
+ "kind": "A String", # The kind of this entry. Always blogger#comment.
+ "selfLink": "A String", # The API REST URL to fetch this resource from.
+ "id": "A String", # The identifier for this resource.
+ "published": "A String", # RFC 3339 date-time when this comment was published.
+ "blog": { # Data about the blog containing this comment.
+ "id": "A String", # The identifier of the blog containing this comment.
},
- "kind": "A String", # The kind of this entry. Always blogger#comment.
- "author": { # The author of this Comment.
- "url": "A String", # The URL of the creator's Profile page.
- "image": { # The creator's avatar.
- "url": "A String", # The creator's avatar URL.
+ "content": "A String", # The actual content of the comment. May include HTML markup.
+ "inReplyTo": { # Data about the comment this is in reply to.
+ "id": "A String", # The identified of the parent of this comment.
+ },
+ "updated": "A String", # RFC 3339 date-time when this comment was last updated.
+ "status": "A String", # The status of the comment (only populated for admin users).
+ "author": { # The author of this Comment.
+ "image": { # The creator's avatar.
+ "url": "A String", # The creator's avatar URL.
},
- "displayName": "A String", # The display name.
- "id": "A String", # The identifier of the creator.
+ "displayName": "A String", # The display name.
+ "url": "A String", # The URL of the creator's Profile page.
+ "id": "A String", # The identifier of the creator.
},
- "updated": "A String", # RFC 3339 date-time when this comment was last updated.
- "blog": { # Data about the blog containing this comment.
- "id": "A String", # The identifier of the blog containing this comment.
+ "post": { # Data about the post containing this comment.
+ "id": "A String", # The identifier of the post containing this comment.
},
- "published": "A String", # RFC 3339 date-time when this comment was published.
- "post": { # Data about the post containing this comment.
- "id": "A String", # The identifier of the post containing this comment.
- },
- "content": "A String", # The actual content of the comment. May include HTML markup.
- "id": "A String", # The identifier for this resource.
- "selfLink": "A String", # The API REST URL to fetch this resource from.
},
],
- "selfLink": "A String", # The URL of the comments on this post.
+ "selfLink": "A String", # The URL of the comments on this post.
+ "totalItems": "A String", # The count of comments on this post.
},
- "readerComments": "A String", # Comment control and display setting for readers of this post.
- "labels": [ # The list of labels this Post was tagged with.
- "A String",
+ "selfLink": "A String", # The API REST URL to fetch this resource from.
+ "labels": [ # The list of labels this Post was tagged with.
+ "A String",
],
- "customMetaData": "A String", # The JSON meta-data for the Post.
- "kind": "A String", # The kind of this entity. Always blogger#post.
- "content": "A String", # The content of the Post. May contain HTML markup.
- "url": "A String", # The URL where this Post is displayed.
- "etag": "A String", # Etag of the resource.
- "location": { # The location for geotagged posts.
- "lat": 3.14, # Location's latitude.
- "lng": 3.14, # Location's longitude.
- "span": "A String", # Location's viewport span. Can be used when rendering a map preview.
- "name": "A String", # Location name.
+ "author": { # The author of this Post.
+ "id": "A String", # The identifier of the creator.
+ "image": { # The creator's avatar.
+ "url": "A String", # The creator's avatar URL.
+ },
+ "displayName": "A String", # The display name.
+ "url": "A String", # The URL of the creator's Profile page.
},
- "published": "A String", # RFC 3339 date-time when this Post was published.
- "images": [ # Display image for the Post.
+ "images": [ # Display image for the Post.
{
- "url": "A String",
+ "url": "A String",
},
],
- "id": "A String", # The identifier of this Post.
- "selfLink": "A String", # The API REST URL to fetch this resource from.
+ "published": "A String", # RFC 3339 date-time when this Post was published.
+ "title": "A String", # The title of the Post.
+ "titleLink": "A String", # The title link URL, similar to atom's related link.
+ "blog": { # Data about the blog containing this Post.
+ "id": "A String", # The identifier of the Blog that contains this Post.
+ },
+ "updated": "A String", # RFC 3339 date-time when this Post was last updated.
+ "url": "A String", # The URL where this Post is displayed.
+ "content": "A String", # The content of the Post. May contain HTML markup.
+ "id": "A String", # The identifier of this Post.
+ "location": { # The location for geotagged posts.
+ "name": "A String", # Location name.
+ "span": "A String", # Location's viewport span. Can be used when rendering a map preview.
+ "lat": 3.14, # Location's latitude.
+ "lng": 3.14, # Location's longitude.
+ },
+ "status": "A String", # Status of the post. Only set for admin-level requests.
+ "readerComments": "A String", # Comment control and display setting for readers of this post.
+ "etag": "A String", # Etag of the resource.
+ "kind": "A String", # The kind of this entity. Always blogger#post.
},
- "post_user_info": { # Information about a User for the Post.
- "kind": "A String", # The kind of this entity. Always blogger#postPerUserInfo.
- "postId": "A String", # ID of the Post resource.
- "userId": "A String", # ID of the User.
- "blogId": "A String", # ID of the Blog that the post resource belongs to.
- "hasEditAccess": True or False, # True if the user has Author level access to the post.
+ "post_user_info": { # Information about a User for the Post.
+ "postId": "A String", # ID of the Post resource.
+ "hasEditAccess": True or False, # True if the user has Author level access to the post.
+ "userId": "A String", # ID of the User.
+ "kind": "A String", # The kind of this entity. Always blogger#postPerUserInfo.
+ "blogId": "A String", # ID of the Blog that the post resource belongs to.
},
+ "kind": "A String", # The kind of this entity. Always blogger#postUserInfo.
},
],
- "kind": "A String", # The kind of this entity. Always blogger#postList.
+ "nextPageToken": "A String", # Pagination token to fetch the next page, if one exists.
}</pre>
</div>
@@ -308,7 +308,7 @@
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
+ 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.
</pre>
</div>