{ "kind": "discovery#restDescription", "etag": "\"DGgqtFnjgu83tuwvvVNNUhOiHWk/HqXrvEeuZV7fVbX7lTgVYLdSy_g\"", "discoveryVersion": "v1", "id": "blogger:v3", "name": "blogger", "version": "v3", "title": "Blogger API", "description": "API for access to the data within Blogger.", "ownerDomain": "google.com", "ownerName": "Google", "icons": { "x16": "http://www.google.com/images/icons/product/blogger-16.png", "x32": "http://www.google.com/images/icons/product/blogger-32.png" }, "documentationLink": "https://developers.google.com/blogger/docs/3.0/getting_started", "labels": [ "limited_availability" ], "protocol": "rest", "baseUrl": "https://www.googleapis.com/blogger/v3/", "basePath": "/blogger/v3/", "rootUrl": "https://www.googleapis.com/", "servicePath": "blogger/v3/", "batchPath": "batch", "parameters": { "alt": { "type": "string", "description": "Data format for the response.", "default": "json", "enum": [ "json" ], "enumDescriptions": [ "Responses with Content-Type of application/json" ], "location": "query" }, "fields": { "type": "string", "description": "Selector specifying which fields to include in a partial response.", "location": "query" }, "key": { "type": "string", "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.", "location": "query" }, "oauth_token": { "type": "string", "description": "OAuth 2.0 token for the current user.", "location": "query" }, "prettyPrint": { "type": "boolean", "description": "Returns response with indentations and line breaks.", "default": "true", "location": "query" }, "quotaUser": { "type": "string", "description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. Overrides userIp if both are provided.", "location": "query" }, "userIp": { "type": "string", "description": "IP address of the site where the request originates. Use this if you want to enforce per-user limits.", "location": "query" } }, "auth": { "oauth2": { "scopes": { "https://www.googleapis.com/auth/blogger": { "description": "Manage your Blogger account" }, "https://www.googleapis.com/auth/blogger.readonly": { "description": "View your Blogger account" } } } }, "schemas": { "Blog": { "id": "Blog", "type": "object", "properties": { "customMetaData": { "type": "string", "description": "The JSON custom meta-data for the Blog" }, "description": { "type": "string", "description": "The description of this blog. This is displayed underneath the title." }, "id": { "type": "string", "description": "The identifier for this resource." }, "kind": { "type": "string", "description": "The kind of this entry. Always blogger#blog", "default": "blogger#blog" }, "locale": { "type": "object", "description": "The locale this Blog is set to.", "properties": { "country": { "type": "string", "description": "The country this blog's locale is set to." }, "language": { "type": "string", "description": "The language this blog is authored in." }, "variant": { "type": "string", "description": "The language variant this blog is authored in." } } }, "name": { "type": "string", "description": "The name of this blog. This is displayed as the title." }, "pages": { "type": "object", "description": "The container of pages in this blog.", "properties": { "selfLink": { "type": "string", "description": "The URL of the container for pages in this blog." }, "totalItems": { "type": "integer", "description": "The count of pages in this blog.", "format": "int32" } } }, "posts": { "type": "object", "description": "The container of posts in this blog.", "properties": { "items": { "type": "array", "description": "The List of Posts for this Blog.", "items": { "$ref": "Post" } }, "selfLink": { "type": "string", "description": "The URL of the container for posts in this blog." }, "totalItems": { "type": "integer", "description": "The count of posts in this blog.", "format": "int32" } } }, "published": { "type": "string", "description": "RFC 3339 date-time when this blog was published.", "format": "date-time" }, "selfLink": { "type": "string", "description": "The API REST URL to fetch this resource from." }, "updated": { "type": "string", "description": "RFC 3339 date-time when this blog was last updated.", "format": "date-time" }, "url": { "type": "string", "description": "The URL where this blog is published." } } }, "BlogList": { "id": "BlogList", "type": "object", "properties": { "blogUserInfos": { "type": "array", "description": "Admin level list of blog per-user information", "items": { "$ref": "BlogUserInfo" } }, "items": { "type": "array", "description": "The list of Blogs this user has Authorship or Admin rights over.", "items": { "$ref": "Blog" } }, "kind": { "type": "string", "description": "The kind of this entity. Always blogger#blogList", "default": "blogger#blogList" } } }, "BlogPerUserInfo": { "id": "BlogPerUserInfo", "type": "object", "properties": { "blogId": { "type": "string", "description": "ID of the Blog resource" }, "hasAdminAccess": { "type": "boolean", "description": "True if the user has Admin level access to the blog." }, "kind": { "type": "string", "description": "The kind of this entity. Always blogger#blogPerUserInfo", "default": "blogger#blogPerUserInfo" }, "photosAlbumKey": { "type": "string", "description": "The Photo Album Key for the user when adding photos to the blog" }, "userId": { "type": "string", "description": "ID of the User" } } }, "BlogUserInfo": { "id": "BlogUserInfo", "type": "object", "properties": { "blog": { "$ref": "Blog", "description": "The Blog resource." }, "blog_user_info": { "$ref": "BlogPerUserInfo", "description": "Information about a User for the Blog." }, "kind": { "type": "string", "description": "The kind of this entity. Always blogger#blogUserInfo", "default": "blogger#blogUserInfo" } } }, "Comment": { "id": "Comment", "type": "object", "properties": { "author": { "type": "object", "description": "The author of this Comment.", "properties": { "displayName": { "type": "string", "description": "The display name." }, "id": { "type": "string", "description": "The identifier of the Comment creator." }, "image": { "type": "object", "description": "The comment creator's avatar.", "properties": { "url": { "type": "string", "description": "The comment creator's avatar URL." } } }, "url": { "type": "string", "description": "The URL of the Comment creator's Profile page." } } }, "blog": { "type": "object", "description": "Data about the blog containing this comment.", "properties": { "id": { "type": "string", "description": "The identifier of the blog containing this comment." } } }, "content": { "type": "string", "description": "The actual content of the comment. May include HTML markup." }, "id": { "type": "string", "description": "The identifier for this resource." }, "inReplyTo": { "type": "object", "description": "Data about the comment this is in reply to.", "properties": { "id": { "type": "string", "description": "The identified of the parent of this comment." } } }, "kind": { "type": "string", "description": "The kind of this entry. Always blogger#comment", "default": "blogger#comment" }, "post": { "type": "object", "description": "Data about the post containing this comment.", "properties": { "id": { "type": "string", "description": "The identifier of the post containing this comment." } } }, "published": { "type": "string", "description": "RFC 3339 date-time when this comment was published.", "format": "date-time" }, "selfLink": { "type": "string", "description": "The API REST URL to fetch this resource from." }, "status": { "type": "string", "description": "The status of the comment (only populated for admin users)" }, "updated": { "type": "string", "description": "RFC 3339 date-time when this comment was last updated.", "format": "date-time" } } }, "CommentList": { "id": "CommentList", "type": "object", "properties": { "items": { "type": "array", "description": "The List of Comments for a Post.", "items": { "$ref": "Comment" } }, "kind": { "type": "string", "description": "The kind of this entry. Always blogger#commentList", "default": "blogger#commentList" }, "nextPageToken": { "type": "string", "description": "Pagination token to fetch the next page, if one exists." }, "prevPageToken": { "type": "string", "description": "Pagination token to fetch the previous page, if one exists." } } }, "Page": { "id": "Page", "type": "object", "properties": { "author": { "type": "object", "description": "The author of this Page.", "properties": { "displayName": { "type": "string", "description": "The display name." }, "id": { "type": "string", "description": "The identifier of the Page creator." }, "image": { "type": "object", "description": "The page author's avatar.", "properties": { "url": { "type": "string", "description": "The page author's avatar URL." } } }, "url": { "type": "string", "description": "The URL of the Page creator's Profile page." } } }, "blog": { "type": "object", "description": "Data about the blog containing this Page.", "properties": { "id": { "type": "string", "description": "The identifier of the blog containing this page." } } }, "content": { "type": "string", "description": "The body content of this Page, in HTML." }, "id": { "type": "string", "description": "The identifier for this resource." }, "kind": { "type": "string", "description": "The kind of this entity. Always blogger#page", "default": "blogger#page" }, "published": { "type": "string", "description": "RFC 3339 date-time when this Page was published.", "format": "date-time" }, "selfLink": { "type": "string", "description": "The API REST URL to fetch this resource from." }, "status": { "type": "string", "description": "The status of the page for admin resources (either LIVE or DRAFT)." }, "title": { "type": "string", "description": "The title of this entity. This is the name displayed in the Admin user interface." }, "updated": { "type": "string", "description": "RFC 3339 date-time when this Page was last updated.", "format": "date-time" }, "url": { "type": "string", "description": "The URL that this Page is displayed at." } } }, "PageList": { "id": "PageList", "type": "object", "properties": { "items": { "type": "array", "description": "The list of Pages for a Blog.", "items": { "$ref": "Page" } }, "kind": { "type": "string", "description": "The kind of this entity. Always blogger#pageList", "default": "blogger#pageList" } } }, "Pageviews": { "id": "Pageviews", "type": "object", "properties": { "blogId": { "type": "string", "description": "Blog Id", "format": "int64" }, "counts": { "type": "array", "description": "The container of posts in this blog.", "items": { "type": "object", "properties": { "count": { "type": "string", "description": "Count of page views for the given time range", "format": "int64" }, "timeRange": { "type": "string", "description": "Time range the given count applies to" } } } }, "kind": { "type": "string", "description": "The kind of this entry. Always blogger#page_views", "default": "blogger#page_views" } } }, "Post": { "id": "Post", "type": "object", "properties": { "author": { "type": "object", "description": "The author of this Post.", "properties": { "displayName": { "type": "string", "description": "The display name." }, "id": { "type": "string", "description": "The identifier of the Post creator." }, "image": { "type": "object", "description": "The Post author's avatar.", "properties": { "url": { "type": "string", "description": "The Post author's avatar URL." } } }, "url": { "type": "string", "description": "The URL of the Post creator's Profile page." } } }, "blog": { "type": "object", "description": "Data about the blog containing this Post.", "properties": { "id": { "type": "string", "description": "The identifier of the Blog that contains this Post." } } }, "content": { "type": "string", "description": "The content of the Post. May contain HTML markup." }, "customMetaData": { "type": "string", "description": "The JSON meta-data for the Post." }, "id": { "type": "string", "description": "The identifier of this Post." }, "images": { "type": "array", "description": "Display image for the Post.", "items": { "type": "object", "properties": { "url": { "type": "string" } } } }, "kind": { "type": "string", "description": "The kind of this entity. Always blogger#post", "default": "blogger#post" }, "labels": { "type": "array", "description": "The list of labels this Post was tagged with.", "items": { "type": "string" } }, "location": { "type": "object", "description": "The location for geotagged posts.", "properties": { "lat": { "type": "number", "description": "Location's latitude.", "format": "double" }, "lng": { "type": "number", "description": "Location's longitude.", "format": "double" }, "name": { "type": "string", "description": "Location name." }, "span": { "type": "string", "description": "Location's viewport span. Can be used when rendering a map preview." } } }, "published": { "type": "string", "description": "RFC 3339 date-time when this Post was published.", "format": "date-time" }, "replies": { "type": "object", "description": "The container of comments on this Post.", "properties": { "items": { "type": "array", "description": "The List of Comments for this Post.", "items": { "$ref": "Comment" } }, "selfLink": { "type": "string", "description": "The URL of the comments on this post." }, "totalItems": { "type": "string", "description": "The count of comments on this post.", "format": "int64" } } }, "selfLink": { "type": "string", "description": "The API REST URL to fetch this resource from." }, "status": { "type": "string", "description": "Status of the post. Only set for admin-level requests" }, "title": { "type": "string", "description": "The title of the Post." }, "titleLink": { "type": "string", "description": "The title link URL, similar to atom's related link." }, "updated": { "type": "string", "description": "RFC 3339 date-time when this Post was last updated.", "format": "date-time" }, "url": { "type": "string", "description": "The URL where this Post is displayed." } } }, "PostList": { "id": "PostList", "type": "object", "properties": { "items": { "type": "array", "description": "The list of Posts for this Blog.", "items": { "$ref": "Post" } }, "kind": { "type": "string", "description": "The kind of this entity. Always blogger#postList", "default": "blogger#postList" }, "nextPageToken": { "type": "string", "description": "Pagination token to fetch the next page, if one exists." } } }, "PostPerUserInfo": { "id": "PostPerUserInfo", "type": "object", "properties": { "blogId": { "type": "string", "description": "ID of the Blog that the post resource belongs to." }, "hasEditAccess": { "type": "boolean", "description": "True if the user has Author level access to the post." }, "kind": { "type": "string", "description": "The kind of this entity. Always blogger#postPerUserInfo", "default": "blogger#postPerUserInfo" }, "postId": { "type": "string", "description": "ID of the Post resource." }, "userId": { "type": "string", "description": "ID of the User." } } }, "PostUserInfo": { "id": "PostUserInfo", "type": "object", "properties": { "kind": { "type": "string", "description": "The kind of this entity. Always blogger#postUserInfo", "default": "blogger#postUserInfo" }, "post": { "$ref": "Post", "description": "The Post resource." }, "post_user_info": { "$ref": "PostPerUserInfo", "description": "Information about a User for the Post." } } }, "PostUserInfosList": { "id": "PostUserInfosList", "type": "object", "properties": { "items": { "type": "array", "description": "The list of Posts with User information for the post, for this Blog.", "items": { "$ref": "PostUserInfo" } }, "kind": { "type": "string", "description": "The kind of this entity. Always blogger#postList", "default": "blogger#postUserInfosList" }, "nextPageToken": { "type": "string", "description": "Pagination token to fetch the next page, if one exists." } } }, "User": { "id": "User", "type": "object", "properties": { "about": { "type": "string", "description": "Profile summary information." }, "blogs": { "type": "object", "description": "The container of blogs for this user.", "properties": { "selfLink": { "type": "string", "description": "The URL of the Blogs for this user." } } }, "created": { "type": "string", "description": "The timestamp of when this profile was created, in seconds since epoch.", "format": "date-time" }, "displayName": { "type": "string", "description": "The display name." }, "id": { "type": "string", "description": "The identifier for this User." }, "kind": { "type": "string", "description": "The kind of this entity. Always blogger#user", "default": "blogger#user" }, "locale": { "type": "object", "description": "This user's locale", "properties": { "country": { "type": "string", "description": "The user's country setting." }, "language": { "type": "string", "description": "The user's language setting." }, "variant": { "type": "string", "description": "The user's language variant setting." } } }, "selfLink": { "type": "string", "description": "The API REST URL to fetch this resource from." }, "url": { "type": "string", "description": "The user's profile page." } } } }, "resources": { "blogUserInfos": { "methods": { "get": { "id": "blogger.blogUserInfos.get", "path": "users/{userId}/blogs/{blogId}", "httpMethod": "GET", "description": "Gets one blog and user info pair by blogId and userId.", "parameters": { "blogId": { "type": "string", "description": "The ID of the blog to get.", "required": true, "location": "path" }, "maxPosts": { "type": "integer", "description": "Maximum number of posts to pull back with the blog.", "format": "uint32", "location": "query" }, "userId": { "type": "string", "description": "ID of the user whose blogs are to be fetched. Either the word 'self' (sans quote marks) or the user's profile identifier.", "required": true, "location": "path" } }, "parameterOrder": [ "userId", "blogId" ], "response": { "$ref": "BlogUserInfo" }, "scopes": [ "https://www.googleapis.com/auth/blogger", "https://www.googleapis.com/auth/blogger.readonly" ] } } }, "blogs": { "methods": { "get": { "id": "blogger.blogs.get", "path": "blogs/{blogId}", "httpMethod": "GET", "description": "Gets one blog by id.", "parameters": { "blogId": { "type": "string", "description": "The ID of the blog to get.", "required": true, "location": "path" }, "maxPosts": { "type": "integer", "description": "Maximum number of posts to pull back with the blog.", "format": "uint32", "location": "query" } }, "parameterOrder": [ "blogId" ], "response": { "$ref": "Blog" }, "scopes": [ "https://www.googleapis.com/auth/blogger", "https://www.googleapis.com/auth/blogger.readonly" ] }, "getByUrl": { "id": "blogger.blogs.getByUrl", "path": "blogs/byurl", "httpMethod": "GET", "description": "Retrieve a Blog by URL.", "parameters": { "url": { "type": "string", "description": "The URL of the blog to retrieve.", "required": true, "location": "query" } }, "parameterOrder": [ "url" ], "response": { "$ref": "Blog" }, "scopes": [ "https://www.googleapis.com/auth/blogger", "https://www.googleapis.com/auth/blogger.readonly" ] }, "listByUser": { "id": "blogger.blogs.listByUser", "path": "users/{userId}/blogs", "httpMethod": "GET", "description": "Retrieves a list of blogs, possibly filtered.", "parameters": { "fetchUserInfo": { "type": "boolean", "description": "Whether the response is a list of blogs with per-user information instead of just blogs.", "location": "query" }, "userId": { "type": "string", "description": "ID of the user whose blogs are to be fetched. Either the word 'self' (sans quote marks) or the user's profile identifier.", "required": true, "location": "path" }, "view": { "type": "string", "enum": [ "ADMIN", "AUTHOR", "READER" ], "enumDescriptions": [ "Admin level detail", "Author level detail", "Admin level detail" ], "location": "query" } }, "parameterOrder": [ "userId" ], "response": { "$ref": "BlogList" }, "scopes": [ "https://www.googleapis.com/auth/blogger", "https://www.googleapis.com/auth/blogger.readonly" ] } } }, "comments": { "methods": { "approve": { "id": "blogger.comments.approve", "path": "blogs/{blogId}/posts/{postId}/comments/{commentId}/approve", "httpMethod": "POST", "description": "Marks a comment as not spam.", "parameters": { "blogId": { "type": "string", "description": "The Id of the Blog.", "required": true, "location": "path" }, "commentId": { "type": "string", "description": "The ID of the comment to mark as not spam.", "required": true, "location": "path" }, "postId": { "type": "string", "description": "The ID of the Post.", "required": true, "location": "path" } }, "parameterOrder": [ "blogId", "postId", "commentId" ], "response": { "$ref": "Comment" }, "scopes": [ "https://www.googleapis.com/auth/blogger" ] }, "delete": { "id": "blogger.comments.delete", "path": "blogs/{blogId}/posts/{postId}/comments/{commentId}", "httpMethod": "DELETE", "description": "Delete a comment by id.", "parameters": { "blogId": { "type": "string", "description": "The Id of the Blog.", "required": true, "location": "path" }, "commentId": { "type": "string", "description": "The ID of the comment to delete.", "required": true, "location": "path" }, "postId": { "type": "string", "description": "The ID of the Post.", "required": true, "location": "path" } }, "parameterOrder": [ "blogId", "postId", "commentId" ], "scopes": [ "https://www.googleapis.com/auth/blogger" ] }, "get": { "id": "blogger.comments.get", "path": "blogs/{blogId}/posts/{postId}/comments/{commentId}", "httpMethod": "GET", "description": "Gets one comment by id.", "parameters": { "blogId": { "type": "string", "description": "ID of the blog to containing the comment.", "required": true, "location": "path" }, "commentId": { "type": "string", "description": "The ID of the comment to get.", "required": true, "location": "path" }, "postId": { "type": "string", "description": "ID of the post to fetch posts from.", "required": true, "location": "path" } }, "parameterOrder": [ "blogId", "postId", "commentId" ], "response": { "$ref": "Comment" }, "scopes": [ "https://www.googleapis.com/auth/blogger", "https://www.googleapis.com/auth/blogger.readonly" ] }, "list": { "id": "blogger.comments.list", "path": "blogs/{blogId}/posts/{postId}/comments", "httpMethod": "GET", "description": "Retrieves the comments for a post, possibly filtered.", "parameters": { "blogId": { "type": "string", "description": "ID of the blog to fetch comments from.", "required": true, "location": "path" }, "endDate": { "type": "string", "description": "Latest date of comment to fetch, a date-time with RFC 3339 formatting.", "format": "date-time", "location": "query" }, "fetchBodies": { "type": "boolean", "description": "Whether the body content of the comments is included.", "location": "query" }, "maxResults": { "type": "integer", "description": "Maximum number of comments to include in the result.", "format": "uint32", "location": "query" }, "pageToken": { "type": "string", "description": "Continuation token if request is paged.", "location": "query" }, "postId": { "type": "string", "description": "ID of the post to fetch posts from.", "required": true, "location": "path" }, "startDate": { "type": "string", "description": "Earliest date of comment to fetch, a date-time with RFC 3339 formatting.", "format": "date-time", "location": "query" }, "statuses": { "type": "string", "enum": [ "emptied", "live", "pending", "spam" ], "enumDescriptions": [ "Comments that have had their content removed", "Comments that are publicly visible", "Comments that are awaiting administrator approval", "Comments marked as spam by the administrator" ], "repeated": true, "location": "query" }, "view": { "type": "string", "enum": [ "ADMIN", "AUTHOR", "READER" ], "enumDescriptions": [ "Admin level detail", "Author level detail", "Admin level detail" ], "location": "query" } }, "parameterOrder": [ "blogId", "postId" ], "response": { "$ref": "CommentList" }, "scopes": [ "https://www.googleapis.com/auth/blogger", "https://www.googleapis.com/auth/blogger.readonly" ] }, "listByBlog": { "id": "blogger.comments.listByBlog", "path": "blogs/{blogId}/comments", "httpMethod": "GET", "description": "Retrieves the comments for a blog, across all posts, possibly filtered.", "parameters": { "blogId": { "type": "string", "description": "ID of the blog to fetch comments from.", "required": true, "location": "path" }, "endDate": { "type": "string", "description": "Latest date of comment to fetch, a date-time with RFC 3339 formatting.", "format": "date-time", "location": "query" }, "fetchBodies": { "type": "boolean", "description": "Whether the body content of the comments is included.", "location": "query" }, "maxResults": { "type": "integer", "description": "Maximum number of comments to include in the result.", "format": "uint32", "location": "query" }, "pageToken": { "type": "string", "description": "Continuation token if request is paged.", "location": "query" }, "startDate": { "type": "string", "description": "Earliest date of comment to fetch, a date-time with RFC 3339 formatting.", "format": "date-time", "location": "query" } }, "parameterOrder": [ "blogId" ], "response": { "$ref": "CommentList" }, "scopes": [ "https://www.googleapis.com/auth/blogger", "https://www.googleapis.com/auth/blogger.readonly" ] }, "markAsSpam": { "id": "blogger.comments.markAsSpam", "path": "blogs/{blogId}/posts/{postId}/comments/{commentId}/spam", "httpMethod": "POST", "description": "Marks a comment as spam.", "parameters": { "blogId": { "type": "string", "description": "The Id of the Blog.", "required": true, "location": "path" }, "commentId": { "type": "string", "description": "The ID of the comment to mark as spam.", "required": true, "location": "path" }, "postId": { "type": "string", "description": "The ID of the Post.", "required": true, "location": "path" } }, "parameterOrder": [ "blogId", "postId", "commentId" ], "response": { "$ref": "Comment" }, "scopes": [ "https://www.googleapis.com/auth/blogger" ] }, "removeContent": { "id": "blogger.comments.removeContent", "path": "blogs/{blogId}/posts/{postId}/comments/{commentId}/removecontent", "httpMethod": "POST", "description": "Removes the content of a comment.", "parameters": { "blogId": { "type": "string", "description": "The Id of the Blog.", "required": true, "location": "path" }, "commentId": { "type": "string", "description": "The ID of the comment to delete content from.", "required": true, "location": "path" }, "postId": { "type": "string", "description": "The ID of the Post.", "required": true, "location": "path" } }, "parameterOrder": [ "blogId", "postId", "commentId" ], "response": { "$ref": "Comment" }, "scopes": [ "https://www.googleapis.com/auth/blogger" ] } } }, "pageViews": { "methods": { "get": { "id": "blogger.pageViews.get", "path": "blogs/{blogId}/pageviews", "httpMethod": "GET", "description": "Retrieve pageview stats for a Blog.", "parameters": { "blogId": { "type": "string", "description": "The ID of the blog to get.", "required": true, "location": "path" }, "range": { "type": "string", "enum": [ "30DAYS", "7DAYS", "all" ], "enumDescriptions": [ "Page view counts from the last thirty days.", "Page view counts from the last seven days.", "Total page view counts from all time." ], "repeated": true, "location": "query" } }, "parameterOrder": [ "blogId" ], "response": { "$ref": "Pageviews" }, "scopes": [ "https://www.googleapis.com/auth/blogger" ] } } }, "pages": { "methods": { "delete": { "id": "blogger.pages.delete", "path": "blogs/{blogId}/pages/{pageId}", "httpMethod": "DELETE", "description": "Delete a page by id.", "parameters": { "blogId": { "type": "string", "description": "The Id of the Blog.", "required": true, "location": "path" }, "pageId": { "type": "string", "description": "The ID of the Page.", "required": true, "location": "path" } }, "parameterOrder": [ "blogId", "pageId" ], "scopes": [ "https://www.googleapis.com/auth/blogger" ] }, "get": { "id": "blogger.pages.get", "path": "blogs/{blogId}/pages/{pageId}", "httpMethod": "GET", "description": "Gets one blog page by id.", "parameters": { "blogId": { "type": "string", "description": "ID of the blog containing the page.", "required": true, "location": "path" }, "pageId": { "type": "string", "description": "The ID of the page to get.", "required": true, "location": "path" }, "view": { "type": "string", "enum": [ "ADMIN", "AUTHOR", "READER" ], "enumDescriptions": [ "Admin level detail", "Author level detail", "Admin level detail" ], "location": "query" } }, "parameterOrder": [ "blogId", "pageId" ], "response": { "$ref": "Page" }, "scopes": [ "https://www.googleapis.com/auth/blogger", "https://www.googleapis.com/auth/blogger.readonly" ] }, "insert": { "id": "blogger.pages.insert", "path": "blogs/{blogId}/pages", "httpMethod": "POST", "description": "Add a page.", "parameters": { "blogId": { "type": "string", "description": "ID of the blog to add the page to.", "required": true, "location": "path" } }, "parameterOrder": [ "blogId" ], "request": { "$ref": "Page" }, "response": { "$ref": "Page" }, "scopes": [ "https://www.googleapis.com/auth/blogger" ] }, "list": { "id": "blogger.pages.list", "path": "blogs/{blogId}/pages", "httpMethod": "GET", "description": "Retrieves the pages for a blog, optionally including non-LIVE statuses.", "parameters": { "blogId": { "type": "string", "description": "ID of the blog to fetch pages from.", "required": true, "location": "path" }, "fetchBodies": { "type": "boolean", "description": "Whether to retrieve the Page bodies.", "location": "query" }, "statuses": { "type": "string", "enum": [ "draft", "imported", "live" ], "enumDescriptions": [ "Draft (unpublished) Pages", "Pages that have had their content removed", "Pages that are publicly visible" ], "repeated": true, "location": "query" }, "view": { "type": "string", "enum": [ "ADMIN", "AUTHOR", "READER" ], "enumDescriptions": [ "Admin level detail", "Author level detail", "Admin level detail" ], "location": "query" } }, "parameterOrder": [ "blogId" ], "response": { "$ref": "PageList" }, "scopes": [ "https://www.googleapis.com/auth/blogger", "https://www.googleapis.com/auth/blogger.readonly" ] }, "patch": { "id": "blogger.pages.patch", "path": "blogs/{blogId}/pages/{pageId}", "httpMethod": "PATCH", "description": "Update a page. This method supports patch semantics.", "parameters": { "blogId": { "type": "string", "description": "The ID of the Blog.", "required": true, "location": "path" }, "pageId": { "type": "string", "description": "The ID of the Page.", "required": true, "location": "path" } }, "parameterOrder": [ "blogId", "pageId" ], "request": { "$ref": "Page" }, "response": { "$ref": "Page" }, "scopes": [ "https://www.googleapis.com/auth/blogger" ] }, "update": { "id": "blogger.pages.update", "path": "blogs/{blogId}/pages/{pageId}", "httpMethod": "PUT", "description": "Update a page.", "parameters": { "blogId": { "type": "string", "description": "The ID of the Blog.", "required": true, "location": "path" }, "pageId": { "type": "string", "description": "The ID of the Page.", "required": true, "location": "path" } }, "parameterOrder": [ "blogId", "pageId" ], "request": { "$ref": "Page" }, "response": { "$ref": "Page" }, "scopes": [ "https://www.googleapis.com/auth/blogger" ] } } }, "postUserInfos": { "methods": { "get": { "id": "blogger.postUserInfos.get", "path": "users/{userId}/blogs/{blogId}/posts/{postId}", "httpMethod": "GET", "description": "Gets one post and user info pair by postId and userId.", "parameters": { "blogId": { "type": "string", "description": "The ID of the blog.", "required": true, "location": "path" }, "maxComments": { "type": "integer", "description": "Maximum number of comments to pull back on a post.", "format": "uint32", "location": "query" }, "postId": { "type": "string", "description": "The ID of the post to get.", "required": true, "location": "path" }, "userId": { "type": "string", "description": "ID of the user for the per-user information to be fetched. Either the word 'self' (sans quote marks) or the user's profile identifier.", "required": true, "location": "path" } }, "parameterOrder": [ "userId", "blogId", "postId" ], "response": { "$ref": "PostUserInfo" }, "scopes": [ "https://www.googleapis.com/auth/blogger", "https://www.googleapis.com/auth/blogger.readonly" ] }, "list": { "id": "blogger.postUserInfos.list", "path": "users/{userId}/blogs/{blogId}/posts", "httpMethod": "GET", "description": "Retrieves a list of post and user info pairs, possibly filtered.", "parameters": { "blogId": { "type": "string", "description": "ID of the blog to fetch posts from.", "required": true, "location": "path" }, "endDate": { "type": "string", "description": "Latest post date to fetch, a date-time with RFC 3339 formatting.", "format": "date-time", "location": "query" }, "fetchBodies": { "type": "boolean", "description": "Whether the body content of posts is included.", "location": "query" }, "labels": { "type": "string", "description": "Comma-separated list of labels to search for.", "location": "query" }, "maxResults": { "type": "integer", "description": "Maximum number of posts to fetch.", "format": "uint32", "location": "query" }, "orderBy": { "type": "string", "description": "Sort search results", "default": "PUBLISHED", "enum": [ "published", "updated" ], "enumDescriptions": [ "Order by the date the post was published", "Order by the date the post was last updated" ], "location": "query" }, "pageToken": { "type": "string", "description": "Continuation token if the request is paged.", "location": "query" }, "startDate": { "type": "string", "description": "Earliest post date to fetch, a date-time with RFC 3339 formatting.", "format": "date-time", "location": "query" }, "statuses": { "type": "string", "enum": [ "draft", "live", "scheduled" ], "enumDescriptions": [ "Draft posts", "Published posts", "Posts that are scheduled to publish in future." ], "repeated": true, "location": "query" }, "userId": { "type": "string", "description": "ID of the user for the per-user information to be fetched. Either the word 'self' (sans quote marks) or the user's profile identifier.", "required": true, "location": "path" }, "view": { "type": "string", "enum": [ "ADMIN", "AUTHOR", "READER" ], "enumDescriptions": [ "Admin level detail", "Author level detail", "Reader level detail" ], "location": "query" } }, "parameterOrder": [ "userId", "blogId" ], "response": { "$ref": "PostUserInfosList" }, "scopes": [ "https://www.googleapis.com/auth/blogger", "https://www.googleapis.com/auth/blogger.readonly" ] } } }, "posts": { "methods": { "delete": { "id": "blogger.posts.delete", "path": "blogs/{blogId}/posts/{postId}", "httpMethod": "DELETE", "description": "Delete a post by id.", "parameters": { "blogId": { "type": "string", "description": "The Id of the Blog.", "required": true, "location": "path" }, "postId": { "type": "string", "description": "The ID of the Post.", "required": true, "location": "path" } }, "parameterOrder": [ "blogId", "postId" ], "scopes": [ "https://www.googleapis.com/auth/blogger" ] }, "get": { "id": "blogger.posts.get", "path": "blogs/{blogId}/posts/{postId}", "httpMethod": "GET", "description": "Get a post by id.", "parameters": { "blogId": { "type": "string", "description": "ID of the blog to fetch the post from.", "required": true, "location": "path" }, "maxComments": { "type": "integer", "description": "Maximum number of comments to pull back on a post.", "format": "uint32", "location": "query" }, "postId": { "type": "string", "description": "The ID of the post", "required": true, "location": "path" }, "view": { "type": "string", "enum": [ "ADMIN", "AUTHOR", "READER" ], "enumDescriptions": [ "Admin level detail", "Author level detail", "Admin level detail" ], "location": "query" } }, "parameterOrder": [ "blogId", "postId" ], "response": { "$ref": "Post" }, "scopes": [ "https://www.googleapis.com/auth/blogger", "https://www.googleapis.com/auth/blogger.readonly" ] }, "getByPath": { "id": "blogger.posts.getByPath", "path": "blogs/{blogId}/posts/bypath", "httpMethod": "GET", "description": "Retrieve a Post by Path.", "parameters": { "blogId": { "type": "string", "description": "ID of the blog to fetch the post from.", "required": true, "location": "path" }, "maxComments": { "type": "integer", "description": "Maximum number of comments to pull back on a post.", "format": "uint32", "location": "query" }, "path": { "type": "string", "description": "Path of the Post to retrieve.", "required": true, "location": "query" }, "view": { "type": "string", "enum": [ "ADMIN", "AUTHOR", "READER" ], "enumDescriptions": [ "Admin level detail", "Author level detail", "Admin level detail" ], "location": "query" } }, "parameterOrder": [ "blogId", "path" ], "response": { "$ref": "Post" }, "scopes": [ "https://www.googleapis.com/auth/blogger", "https://www.googleapis.com/auth/blogger.readonly" ] }, "insert": { "id": "blogger.posts.insert", "path": "blogs/{blogId}/posts", "httpMethod": "POST", "description": "Add a post.", "parameters": { "blogId": { "type": "string", "description": "ID of the blog to add the post to.", "required": true, "location": "path" }, "isDraft": { "type": "boolean", "description": "Whether to create the post as a draft", "location": "query" } }, "parameterOrder": [ "blogId" ], "request": { "$ref": "Post" }, "response": { "$ref": "Post" }, "scopes": [ "https://www.googleapis.com/auth/blogger" ] }, "list": { "id": "blogger.posts.list", "path": "blogs/{blogId}/posts", "httpMethod": "GET", "description": "Retrieves a list of posts, possibly filtered.", "parameters": { "blogId": { "type": "string", "description": "ID of the blog to fetch posts from.", "required": true, "location": "path" }, "endDate": { "type": "string", "description": "Latest post date to fetch, a date-time with RFC 3339 formatting.", "format": "date-time", "location": "query" }, "fetchBodies": { "type": "boolean", "description": "Whether the body content of posts is included (default: true). This should be set to false when the post bodies are not required, to help minimize traffic.", "default": "true", "location": "query" }, "fetchImages": { "type": "boolean", "description": "Whether image URL metadata for each post is included.", "location": "query" }, "labels": { "type": "string", "description": "Comma-separated list of labels to search for.", "location": "query" }, "maxResults": { "type": "integer", "description": "Maximum number of posts to fetch.", "format": "uint32", "location": "query" }, "orderBy": { "type": "string", "description": "Sort search results", "default": "PUBLISHED", "enum": [ "published", "updated" ], "enumDescriptions": [ "Order by the date the post was published", "Order by the date the post was last updated" ], "location": "query" }, "pageToken": { "type": "string", "description": "Continuation token if the request is paged.", "location": "query" }, "startDate": { "type": "string", "description": "Earliest post date to fetch, a date-time with RFC 3339 formatting.", "format": "date-time", "location": "query" }, "statuses": { "type": "string", "enum": [ "draft", "live", "scheduled" ], "enumDescriptions": [ "Draft posts", "Published posts", "Posts that are scheduled to publish in future." ], "repeated": true, "location": "query" }, "view": { "type": "string", "enum": [ "ADMIN", "AUTHOR", "READER" ], "enumDescriptions": [ "Admin level detail", "Author level detail", "Reader level detail" ], "location": "query" } }, "parameterOrder": [ "blogId" ], "response": { "$ref": "PostList" }, "scopes": [ "https://www.googleapis.com/auth/blogger", "https://www.googleapis.com/auth/blogger.readonly" ] }, "patch": { "id": "blogger.posts.patch", "path": "blogs/{blogId}/posts/{postId}", "httpMethod": "PATCH", "description": "Update a post. This method supports patch semantics.", "parameters": { "blogId": { "type": "string", "description": "The ID of the Blog.", "required": true, "location": "path" }, "postId": { "type": "string", "description": "The ID of the Post.", "required": true, "location": "path" } }, "parameterOrder": [ "blogId", "postId" ], "request": { "$ref": "Post" }, "response": { "$ref": "Post" }, "scopes": [ "https://www.googleapis.com/auth/blogger" ] }, "publish": { "id": "blogger.posts.publish", "path": "blogs/{blogId}/posts/{postId}/publish", "httpMethod": "POST", "description": "Publish a draft post.", "parameters": { "blogId": { "type": "string", "description": "The ID of the Blog.", "required": true, "location": "path" }, "postId": { "type": "string", "description": "The ID of the Post.", "required": true, "location": "path" }, "publishDate": { "type": "string", "description": "The date and time to schedule the publishing of the Blog.", "format": "date-time", "location": "query" } }, "parameterOrder": [ "blogId", "postId" ], "response": { "$ref": "Post" }, "scopes": [ "https://www.googleapis.com/auth/blogger" ] }, "revert": { "id": "blogger.posts.revert", "path": "blogs/{blogId}/posts/{postId}/revert", "httpMethod": "POST", "description": "Revert a published or scheduled post to draft state.", "parameters": { "blogId": { "type": "string", "description": "The ID of the Blog.", "required": true, "location": "path" }, "postId": { "type": "string", "description": "The ID of the Post.", "required": true, "location": "path" } }, "parameterOrder": [ "blogId", "postId" ], "response": { "$ref": "Post" }, "scopes": [ "https://www.googleapis.com/auth/blogger" ] }, "search": { "id": "blogger.posts.search", "path": "blogs/{blogId}/posts/search", "httpMethod": "GET", "description": "Search for a post.", "parameters": { "blogId": { "type": "string", "description": "ID of the blog to fetch the post from.", "required": true, "location": "path" }, "fetchBodies": { "type": "boolean", "description": "Whether the body content of posts is included (default: true). This should be set to false when the post bodies are not required, to help minimize traffic.", "default": "true", "location": "query" }, "orderBy": { "type": "string", "description": "Sort search results", "default": "PUBLISHED", "enum": [ "published", "updated" ], "enumDescriptions": [ "Order by the date the post was published", "Order by the date the post was last updated" ], "location": "query" }, "q": { "type": "string", "description": "Query terms to search this blog for matching posts.", "required": true, "location": "query" } }, "parameterOrder": [ "blogId", "q" ], "response": { "$ref": "PostList" }, "scopes": [ "https://www.googleapis.com/auth/blogger", "https://www.googleapis.com/auth/blogger.readonly" ] }, "update": { "id": "blogger.posts.update", "path": "blogs/{blogId}/posts/{postId}", "httpMethod": "PUT", "description": "Update a post.", "parameters": { "blogId": { "type": "string", "description": "The ID of the Blog.", "required": true, "location": "path" }, "postId": { "type": "string", "description": "The ID of the Post.", "required": true, "location": "path" } }, "parameterOrder": [ "blogId", "postId" ], "request": { "$ref": "Post" }, "response": { "$ref": "Post" }, "scopes": [ "https://www.googleapis.com/auth/blogger" ] } } }, "users": { "methods": { "get": { "id": "blogger.users.get", "path": "users/{userId}", "httpMethod": "GET", "description": "Gets one user by id.", "parameters": { "userId": { "type": "string", "description": "The ID of the user to get.", "required": true, "location": "path" } }, "parameterOrder": [ "userId" ], "response": { "$ref": "User" }, "scopes": [ "https://www.googleapis.com/auth/blogger", "https://www.googleapis.com/auth/blogger.readonly" ] } } } } }