{ "kind": "discovery#restDescription", "etag": "\"YWOzh2SDasdU84ArJnpYek-OMdg/Mm4a0u3lPNBqEzKCYhfhIpC2Mw4\"", "discoveryVersion": "v1", "id": "blogger:v2", "name": "blogger", "version": "v2", "revision": "20150422", "title": "Blogger API", "description": "API for access to the data within Blogger.", "ownerDomain": "google.com", "ownerName": "Google", "icons": { "x16": "https://www.google.com/images/icons/product/blogger-16.png", "x32": "https://www.google.com/images/icons/product/blogger-32.png" }, "documentationLink": "https://developers.google.com/blogger/docs/2.0/json/getting_started", "labels": [ "limited_availability" ], "protocol": "rest", "baseUrl": "https://www.googleapis.com/blogger/v2/", "basePath": "/blogger/v2/", "rootUrl": "https://www.googleapis.com/", "servicePath": "blogger/v2/", "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" } } } }, "schemas": { "Blog": { "id": "Blog", "type": "object", "properties": { "description": { "type": "string", "description": "The description of this blog. This is displayed underneath the title." }, "id": { "type": "string", "description": "The identifier for this resource.", "format": "int64" }, "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": { "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": { "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" } } }, "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.", "format": "int64" } } }, "content": { "type": "string", "description": "The actual content of the comment. May include HTML markup." }, "id": { "type": "string", "description": "The identifier for this resource.", "format": "int64" }, "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.", "format": "int64" } } }, "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.", "format": "int64" } } }, "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." }, "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.", "format": "int64" } } }, "content": { "type": "string", "description": "The body content of this Page, in HTML." }, "id": { "type": "string", "description": "The identifier for this resource.", "format": "int64" }, "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." }, "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" } } }, "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.", "format": "int64" } } }, "content": { "type": "string", "description": "The content of the Post. May contain HTML markup." }, "id": { "type": "string", "description": "The identifier of this Post.", "format": "int64" }, "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" } }, "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": { "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." }, "title": { "type": "string", "description": "The title of the Post." }, "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." }, "prevPageToken": { "type": "string", "description": "Pagination token to fetch the previous 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": { "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" } }, "parameterOrder": [ "blogId" ], "response": { "$ref": "Blog" }, "scopes": [ "https://www.googleapis.com/auth/blogger" ] } } }, "comments": { "methods": { "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" ] }, "list": { "id": "blogger.comments.list", "path": "blogs/{blogId}/posts/{postId}/comments", "httpMethod": "GET", "description": "Retrieves the comments for a blog, possibly filtered.", "parameters": { "blogId": { "type": "string", "description": "ID of the blog to fetch comments from.", "required": true, "location": "path" }, "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" } }, "parameterOrder": [ "blogId", "postId" ], "response": { "$ref": "CommentList" }, "scopes": [ "https://www.googleapis.com/auth/blogger" ] } } }, "pages": { "methods": { "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" } }, "parameterOrder": [ "blogId", "pageId" ], "response": { "$ref": "Page" }, "scopes": [ "https://www.googleapis.com/auth/blogger" ] }, "list": { "id": "blogger.pages.list", "path": "blogs/{blogId}/pages", "httpMethod": "GET", "description": "Retrieves pages for a blog, possibly filtered.", "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" } }, "parameterOrder": [ "blogId" ], "response": { "$ref": "PageList" }, "scopes": [ "https://www.googleapis.com/auth/blogger" ] } } }, "posts": { "methods": { "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" }, "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" ] }, "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" }, "fetchBodies": { "type": "boolean", "description": "Whether the body content of posts is included.", "location": "query" }, "maxResults": { "type": "integer", "description": "Maximum number of posts to fetch.", "format": "uint32", "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" } }, "parameterOrder": [ "blogId" ], "response": { "$ref": "PostList" }, "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" ] } }, "resources": { "blogs": { "methods": { "list": { "id": "blogger.users.blogs.list", "path": "users/{userId}/blogs", "httpMethod": "GET", "description": "Retrieves a list of blogs, possibly filtered.", "parameters": { "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" ], "response": { "$ref": "BlogList" }, "scopes": [ "https://www.googleapis.com/auth/blogger" ] } } } } } } }