chore: regens API reference docs (#889)
diff --git a/docs/dyn/blogger_v2.blogs.html b/docs/dyn/blogger_v2.blogs.html
index 7843c69..533f70f 100644
--- a/docs/dyn/blogger_v2.blogs.html
+++ b/docs/dyn/blogger_v2.blogs.html
@@ -72,25 +72,33 @@
</style>
-<h1><a href="blogger_v2.html">Blogger API</a> . <a href="blogger_v2.blogs.html">blogs</a></h1>
+<h1><a href="blogger_v2.html">Blogger API v3</a> . <a href="blogger_v2.blogs.html">blogs</a></h1>
<h2>Instance Methods</h2>
<p class="toc_element">
- <code><a href="#get">get(blogId)</a></code></p>
-<p class="firstline">Gets one blog by id.</p>
+ <code><a href="#get">get(blogId, x__xgafv=None)</a></code></p>
+<p class="firstline">Gets a blog by id.</p>
+<p class="toc_element">
+ <code><a href="#list">list(userId, x__xgafv=None)</a></code></p>
+<p class="firstline">Lists blogs by user id, possibly filtered.</p>
<h3>Method Details</h3>
<div class="method">
- <code class="details" id="get">get(blogId)</code>
- <pre>Gets one blog by id.
+ <code class="details" id="get">get(blogId, x__xgafv=None)</code>
+ <pre>Gets a blog by id.
Args:
- blogId: string, The ID of the blog to get. (required)
+ blogId: string, A parameter (required)
+ x__xgafv: string, V1 error format.
+ Allowed values
+ 1 - v1 error format
+ 2 - v2 error format
Returns:
An object of the form:
{
- "kind": "blogger#blog", # The kind of this entry. Always blogger#blog
- "description": "A String", # The description of this blog. This is displayed underneath the title.
+ "status": "A String", # The status of the blog.
+ "updated": "A String", # RFC 3339 date-time when this blog was last updated.
+ "name": "A String", # The name of this blog. This is displayed as the title.
"locale": { # The locale this Blog is set to.
"country": "A String", # The country this blog's locale is set to.
"variant": "A String", # The language variant this blog is authored in.
@@ -98,9 +106,84 @@
},
"posts": { # The container of posts in this blog.
"totalItems": 42, # The count of posts in this blog.
+ "items": [ # The List of Posts for this Blog.
+ {
+ "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.
+ },
+ "url": "A String", # The URL where this Post is displayed.
+ "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",
+ ],
+ "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.
+ {
+ "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.
+ "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.
+ },
+ "displayName": "A String", # The display name.
+ "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.
+ },
+ "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.
+ },
+ "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.
+ "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.
+ },
+ "published": "A String", # RFC 3339 date-time when this Post was published.
+ "images": [ # Display image for the Post.
+ {
+ "url": "A String",
+ },
+ ],
+ "title": "A String", # The title of the Post.
+ "id": "A String", # The identifier of this Post.
+ "selfLink": "A String", # The API REST URL to fetch this resource from.
+ },
+ ],
"selfLink": "A String", # The URL of the container for posts in this blog.
},
- "updated": "A String", # RFC 3339 date-time when this blog was last updated.
+ "customMetaData": "A String", # The JSON custom meta-data for the Blog.
+ "kind": "A String", # The kind of this entry. Always blogger#blog.
"id": "A String", # The identifier for this resource.
"url": "A String", # The URL where this blog is published.
"published": "A String", # RFC 3339 date-time when this blog was published.
@@ -109,7 +192,240 @@
"selfLink": "A String", # The URL of the container for pages in this blog.
},
"selfLink": "A String", # The API REST URL to fetch this resource from.
- "name": "A String", # The name of this blog. This is displayed as the title.
+ "description": "A String", # The description of this blog. This is displayed underneath the title.
+ }</pre>
+</div>
+
+<div class="method">
+ <code class="details" id="list">list(userId, x__xgafv=None)</code>
+ <pre>Lists blogs by user id, possibly filtered.
+
+Args:
+ userId: string, A parameter (required)
+ x__xgafv: string, V1 error format.
+ Allowed values
+ 1 - v1 error format
+ 2 - v2 error format
+
+Returns:
+ An object of the form:
+
+ {
+ "items": [ # The list of Blogs this user has Authorship or Admin rights over.
+ {
+ "status": "A String", # The status of the blog.
+ "updated": "A String", # RFC 3339 date-time when this blog was last updated.
+ "name": "A String", # The name of this blog. This is displayed as the title.
+ "locale": { # The locale this Blog is set to.
+ "country": "A String", # The country this blog's locale is set to.
+ "variant": "A String", # The language variant this blog is authored in.
+ "language": "A String", # The language this blog is authored in.
+ },
+ "posts": { # The container of posts in this blog.
+ "totalItems": 42, # The count of posts in this blog.
+ "items": [ # The List of Posts for this Blog.
+ {
+ "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.
+ },
+ "url": "A String", # The URL where this Post is displayed.
+ "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",
+ ],
+ "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.
+ {
+ "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.
+ "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.
+ },
+ "displayName": "A String", # The display name.
+ "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.
+ },
+ "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.
+ },
+ "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.
+ "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.
+ },
+ "published": "A String", # RFC 3339 date-time when this Post was published.
+ "images": [ # Display image for the Post.
+ {
+ "url": "A String",
+ },
+ ],
+ "title": "A String", # The title of the Post.
+ "id": "A String", # The identifier of this Post.
+ "selfLink": "A String", # The API REST URL to fetch this resource from.
+ },
+ ],
+ "selfLink": "A String", # The URL of the container for posts in this blog.
+ },
+ "customMetaData": "A String", # The JSON custom meta-data for the Blog.
+ "kind": "A String", # The kind of this entry. Always blogger#blog.
+ "id": "A String", # The identifier for this resource.
+ "url": "A String", # The URL where this blog is published.
+ "published": "A String", # RFC 3339 date-time when this blog was published.
+ "pages": { # The container of pages in this blog.
+ "totalItems": 42, # The count of pages in this blog.
+ "selfLink": "A String", # The URL of the container for pages in this blog.
+ },
+ "selfLink": "A String", # The API REST URL to fetch this resource from.
+ "description": "A String", # The description of this blog. This is displayed underneath the title.
+ },
+ ],
+ "kind": "A String", # The kind of this entity. Always blogger#blogList.
+ "blogUserInfos": [ # Admin level list of blog per-user information.
+ {
+ "blog": { # The Blog resource.
+ "status": "A String", # The status of the blog.
+ "updated": "A String", # RFC 3339 date-time when this blog was last updated.
+ "name": "A String", # The name of this blog. This is displayed as the title.
+ "locale": { # The locale this Blog is set to.
+ "country": "A String", # The country this blog's locale is set to.
+ "variant": "A String", # The language variant this blog is authored in.
+ "language": "A String", # The language this blog is authored in.
+ },
+ "posts": { # The container of posts in this blog.
+ "totalItems": 42, # The count of posts in this blog.
+ "items": [ # The List of Posts for this Blog.
+ {
+ "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.
+ },
+ "url": "A String", # The URL where this Post is displayed.
+ "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",
+ ],
+ "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.
+ {
+ "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.
+ "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.
+ },
+ "displayName": "A String", # The display name.
+ "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.
+ },
+ "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.
+ },
+ "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.
+ "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.
+ },
+ "published": "A String", # RFC 3339 date-time when this Post was published.
+ "images": [ # Display image for the Post.
+ {
+ "url": "A String",
+ },
+ ],
+ "title": "A String", # The title of the Post.
+ "id": "A String", # The identifier of this Post.
+ "selfLink": "A String", # The API REST URL to fetch this resource from.
+ },
+ ],
+ "selfLink": "A String", # The URL of the container for posts in this blog.
+ },
+ "customMetaData": "A String", # The JSON custom meta-data for the Blog.
+ "kind": "A String", # The kind of this entry. Always blogger#blog.
+ "id": "A String", # The identifier for this resource.
+ "url": "A String", # The URL where this blog is published.
+ "published": "A String", # RFC 3339 date-time when this blog was published.
+ "pages": { # The container of pages in this blog.
+ "totalItems": 42, # The count of pages in this blog.
+ "selfLink": "A String", # The URL of the container for pages in this blog.
+ },
+ "selfLink": "A String", # The API REST URL to fetch this resource from.
+ "description": "A String", # The description of this blog. This is displayed underneath the title.
+ },
+ "kind": "A String", # The kind of this entity. Always blogger#blogUserInfo.
+ "blog_user_info": { # Information about a User for the Blog.
+ "hasAdminAccess": True or False, # True if the user has Admin level access to the blog.
+ "kind": "A String", # The kind of this entity. Always blogger#blogPerUserInfo.
+ "userId": "A String", # ID of the User.
+ "role": "A String", # Access permissions that the user has for the blog (ADMIN, AUTHOR, or
+ # READER).
+ "photosAlbumKey": "A String", # The Photo Album Key for the user when adding photos to the blog.
+ "blogId": "A String", # ID of the Blog resource.
+ },
+ },
+ ],
}</pre>
</div>