blob: 47d2987d3b71d43596406afa33ccd6ce54b4f361 [file] [log] [blame] [edit]
{
"batchPath": "batch",
"schemas": {
"BlogList": {
"id": "BlogList",
"type": "object",
"properties": {
"items": {
"description": "The list of Blogs this user has Authorship or Admin rights over.",
"type": "array",
"items": {
"$ref": "Blog"
}
},
"blogUserInfos": {
"description": "Admin level list of blog per-user information.",
"items": {
"$ref": "BlogUserInfo"
},
"type": "array"
},
"kind": {
"type": "string",
"description": "The kind of this entity. Always blogger#blogList."
}
}
},
"PageList": {
"type": "object",
"id": "PageList",
"properties": {
"etag": {
"description": "Etag of the response.",
"type": "string"
},
"nextPageToken": {
"description": "Pagination token to fetch the next page, if one exists.",
"type": "string"
},
"items": {
"type": "array",
"description": "The list of Pages for a Blog.",
"items": {
"$ref": "Page"
}
},
"kind": {
"description": "The kind of this entity. Always blogger#pageList.",
"type": "string"
}
}
},
"Page": {
"properties": {
"url": {
"type": "string",
"description": "The URL that this Page is displayed at."
},
"id": {
"description": "The identifier for this resource.",
"type": "string"
},
"status": {
"type": "string",
"enumDescriptions": [
"",
""
],
"enum": [
"LIVE",
"DRAFT"
],
"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."
},
"blog": {
"properties": {
"id": {
"description": "The identifier of the blog containing this page.",
"type": "string"
}
},
"type": "object",
"description": "Data about the blog containing this Page."
},
"etag": {
"type": "string",
"description": "Etag of the resource."
},
"selfLink": {
"description": "The API REST URL to fetch this resource from.",
"type": "string"
},
"author": {
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "The URL of the creator's Profile page."
},
"image": {
"properties": {
"url": {
"description": "The creator's avatar URL.",
"type": "string"
}
},
"description": "The creator's avatar.",
"type": "object"
},
"id": {
"description": "The identifier of the creator.",
"type": "string"
},
"displayName": {
"description": "The display name.",
"type": "string"
}
},
"description": "The author of this Page."
},
"updated": {
"type": "string",
"description": "RFC 3339 date-time when this Page was last updated."
},
"content": {
"type": "string",
"description": "The body content of this Page, in HTML."
},
"kind": {
"type": "string",
"description": "The kind of this entity. Always blogger#page."
},
"published": {
"type": "string",
"description": "RFC 3339 date-time when this Page was published."
}
},
"id": "Page",
"type": "object"
},
"CommentList": {
"id": "CommentList",
"properties": {
"nextPageToken": {
"description": "Pagination token to fetch the next page, if one exists.",
"type": "string"
},
"prevPageToken": {
"description": "Pagination token to fetch the previous page, if one exists.",
"type": "string"
},
"etag": {
"description": "Etag of the response.",
"type": "string"
},
"kind": {
"type": "string",
"description": "The kind of this entry. Always blogger#commentList."
},
"items": {
"description": "The List of Comments for a Post.",
"type": "array",
"items": {
"$ref": "Comment"
}
}
},
"type": "object"
},
"BlogPerUserInfo": {
"type": "object",
"id": "BlogPerUserInfo",
"properties": {
"userId": {
"description": "ID of the User.",
"type": "string"
},
"blogId": {
"type": "string",
"description": "ID of the Blog resource."
},
"kind": {
"description": "The kind of this entity. Always blogger#blogPerUserInfo.",
"type": "string"
},
"role": {
"type": "string",
"description": "Access permissions that the user has for the blog (ADMIN, AUTHOR, or READER).",
"enum": [
"VIEW_TYPE_UNSPECIFIED",
"READER",
"AUTHOR",
"ADMIN"
],
"enumDescriptions": [
"",
"",
"",
""
]
},
"hasAdminAccess": {
"description": "True if the user has Admin level access to the blog.",
"type": "boolean"
},
"photosAlbumKey": {
"description": "The Photo Album Key for the user when adding photos to the blog.",
"type": "string"
}
}
},
"Blog": {
"id": "Blog",
"type": "object",
"properties": {
"id": {
"description": "The identifier for this resource.",
"type": "string"
},
"locale": {
"properties": {
"country": {
"description": "The country this blog's locale is set to.",
"type": "string"
},
"language": {
"type": "string",
"description": "The language this blog is authored in."
},
"variant": {
"type": "string",
"description": "The language variant this blog is authored in."
}
},
"description": "The locale this Blog is set to.",
"type": "object"
},
"customMetaData": {
"description": "The JSON custom meta-data for the Blog.",
"type": "string"
},
"updated": {
"description": "RFC 3339 date-time when this blog was last updated.",
"type": "string"
},
"url": {
"description": "The URL where this blog is published.",
"type": "string"
},
"pages": {
"properties": {
"selfLink": {
"type": "string",
"description": "The URL of the container for pages in this blog."
},
"totalItems": {
"description": "The count of pages in this blog.",
"format": "int32",
"type": "integer"
}
},
"description": "The container of pages in this blog.",
"type": "object"
},
"status": {
"enumDescriptions": [
"",
""
],
"description": "The status of the blog.",
"enum": [
"LIVE",
"DELETED"
],
"type": "string"
},
"kind": {
"description": "The kind of this entry. Always blogger#blog.",
"type": "string"
},
"published": {
"type": "string",
"description": "RFC 3339 date-time when this blog was published."
},
"selfLink": {
"description": "The API REST URL to fetch this resource from.",
"type": "string"
},
"description": {
"description": "The description of this blog. This is displayed underneath the title.",
"type": "string"
},
"name": {
"type": "string",
"description": "The name of this blog. This is displayed as the title."
},
"posts": {
"type": "object",
"description": "The container of posts in this blog.",
"properties": {
"items": {
"items": {
"$ref": "Post"
},
"type": "array",
"description": "The List of Posts for this Blog."
},
"selfLink": {
"description": "The URL of the container for posts in this blog.",
"type": "string"
},
"totalItems": {
"type": "integer",
"format": "int32",
"description": "The count of posts in this blog."
}
}
}
}
},
"PostList": {
"id": "PostList",
"type": "object",
"properties": {
"etag": {
"type": "string",
"description": "Etag of the response."
},
"nextPageToken": {
"description": "Pagination token to fetch the next page, if one exists.",
"type": "string"
},
"prevPageToken": {
"type": "string",
"description": "Pagination token to fetch the previous page, if one exists."
},
"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."
}
}
},
"Comment": {
"properties": {
"selfLink": {
"type": "string",
"description": "The API REST URL to fetch this resource from."
},
"inReplyTo": {
"properties": {
"id": {
"description": "The identified of the parent of this comment.",
"type": "string"
}
},
"description": "Data about the comment this is in reply to.",
"type": "object"
},
"status": {
"type": "string",
"description": "The status of the comment (only populated for admin users).",
"enum": [
"LIVE",
"EMPTIED",
"PENDING",
"SPAM"
],
"enumDescriptions": [
"",
"",
"",
""
]
},
"content": {
"description": "The actual content of the comment. May include HTML markup.",
"type": "string"
},
"updated": {
"description": "RFC 3339 date-time when this comment was last updated.",
"type": "string"
},
"blog": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "The identifier of the blog containing this comment."
}
},
"description": "Data about the blog containing this comment."
},
"published": {
"description": "RFC 3339 date-time when this comment was published.",
"type": "string"
},
"kind": {
"description": "The kind of this entry. Always blogger#comment.",
"type": "string"
},
"author": {
"type": "object",
"description": "The author of this Comment.",
"properties": {
"url": {
"type": "string",
"description": "The URL of the creator's Profile page."
},
"image": {
"description": "The creator's avatar.",
"type": "object",
"properties": {
"url": {
"description": "The creator's avatar URL.",
"type": "string"
}
}
},
"id": {
"description": "The identifier of the creator.",
"type": "string"
},
"displayName": {
"type": "string",
"description": "The display name."
}
}
},
"id": {
"description": "The identifier for this resource.",
"type": "string"
},
"post": {
"properties": {
"id": {
"description": "The identifier of the post containing this comment.",
"type": "string"
}
},
"type": "object",
"description": "Data about the post containing this comment."
}
},
"type": "object",
"id": "Comment"
},
"User": {
"properties": {
"kind": {
"description": "The kind of this entity. Always blogger#user.",
"type": "string"
},
"locale": {
"properties": {
"language": {
"description": "The language this blog is authored in.",
"type": "string"
},
"variant": {
"type": "string",
"description": "The language variant this blog is authored in."
},
"country": {
"type": "string",
"description": "The country this blog's locale is set to."
}
},
"type": "object",
"description": "This user's locale"
},
"url": {
"type": "string",
"description": "The user's profile page."
},
"id": {
"description": "The identifier for this User.",
"type": "string"
},
"blogs": {
"properties": {
"selfLink": {
"type": "string",
"description": "The URL of the Blogs for this user."
}
},
"type": "object",
"description": "The container of blogs for this user."
},
"created": {
"description": "The timestamp of when this profile was created, in seconds since epoch.",
"type": "string"
},
"selfLink": {
"description": "The API REST URL to fetch this resource from.",
"type": "string"
},
"displayName": {
"description": "The display name.",
"type": "string"
},
"about": {
"type": "string",
"description": "Profile summary information."
}
},
"id": "User",
"type": "object"
},
"Post": {
"type": "object",
"id": "Post",
"properties": {
"titleLink": {
"description": "The title link URL, similar to atom's related link.",
"type": "string"
},
"location": {
"properties": {
"name": {
"description": "Location name.",
"type": "string"
},
"lat": {
"description": "Location's latitude.",
"format": "double",
"type": "number"
},
"lng": {
"type": "number",
"description": "Location's longitude.",
"format": "double"
},
"span": {
"description": "Location's viewport span. Can be used when rendering a map preview.",
"type": "string"
}
},
"description": "The location for geotagged posts.",
"type": "object"
},
"title": {
"description": "The title of the Post.",
"type": "string"
},
"customMetaData": {
"description": "The JSON meta-data for the Post.",
"type": "string"
},
"readerComments": {
"enum": [
"ALLOW",
"DONT_ALLOW_SHOW_EXISTING",
"DONT_ALLOW_HIDE_EXISTING"
],
"enumDescriptions": [
"",
"",
""
],
"type": "string",
"description": "Comment control and display setting for readers of this post."
},
"updated": {
"description": "RFC 3339 date-time when this Post was last updated.",
"type": "string"
},
"status": {
"type": "string",
"description": "Status of the post. Only set for admin-level requests.",
"enum": [
"LIVE",
"DRAFT",
"SCHEDULED"
],
"enumDescriptions": [
"",
"",
""
]
},
"url": {
"type": "string",
"description": "The URL where this Post is displayed."
},
"author": {
"description": "The author of this Post.",
"properties": {
"image": {
"properties": {
"url": {
"type": "string",
"description": "The creator's avatar URL."
}
},
"type": "object",
"description": "The creator's avatar."
},
"id": {
"description": "The identifier of the creator.",
"type": "string"
},
"displayName": {
"type": "string",
"description": "The display name."
},
"url": {
"description": "The URL of the creator's Profile page.",
"type": "string"
}
},
"type": "object"
},
"labels": {
"description": "The list of labels this Post was tagged with.",
"items": {
"type": "string"
},
"type": "array"
},
"kind": {
"type": "string",
"description": "The kind of this entity. Always blogger#post."
},
"selfLink": {
"type": "string",
"description": "The API REST URL to fetch this resource from."
},
"replies": {
"description": "The container of comments on this Post.",
"properties": {
"selfLink": {
"type": "string",
"description": "The URL of the comments on this post."
},
"items": {
"description": "The List of Comments for this Post.",
"items": {
"$ref": "Comment"
},
"type": "array"
},
"totalItems": {
"description": "The count of comments on this post.",
"type": "string",
"format": "int64"
}
},
"type": "object"
},
"id": {
"description": "The identifier of this Post.",
"type": "string"
},
"images": {
"description": "Display image for the Post.",
"items": {
"type": "object",
"properties": {
"url": {
"type": "string"
}
}
},
"type": "array"
},
"etag": {
"description": "Etag of the resource.",
"type": "string"
},
"content": {
"description": "The content of the Post. May contain HTML markup.",
"type": "string"
},
"published": {
"description": "RFC 3339 date-time when this Post was published.",
"type": "string"
},
"blog": {
"type": "object",
"properties": {
"id": {
"description": "The identifier of the Blog that contains this Post.",
"type": "string"
}
},
"description": "Data about the blog containing this Post."
}
}
},
"BlogUserInfo": {
"id": "BlogUserInfo",
"type": "object",
"properties": {
"kind": {
"type": "string",
"description": "The kind of this entity. Always blogger#blogUserInfo."
},
"blog_user_info": {
"description": "Information about a User for the Blog.",
"$ref": "BlogPerUserInfo"
},
"blog": {
"description": "The Blog resource.",
"$ref": "Blog"
}
}
}
},
"id": "blogger:v2",
"protocol": "rest",
"kind": "discovery#restDescription",
"ownerDomain": "google.com",
"basePath": "",
"auth": {
"oauth2": {
"scopes": {
"https://www.googleapis.com/auth/blogger": {
"description": "Manage your Blogger account"
}
}
}
},
"resources": {
"users": {
"methods": {
"get": {
"description": "Gets a user by user id.",
"path": "v2/users/{userId}",
"parameters": {
"userId": {
"location": "path",
"required": true,
"type": "string"
}
},
"httpMethod": "GET",
"response": {
"$ref": "User"
},
"scopes": [
"https://www.googleapis.com/auth/blogger"
],
"parameterOrder": [
"userId"
],
"flatPath": "v2/users/{userId}",
"id": "blogger.users.get"
}
}
},
"comments": {
"methods": {
"list": {
"flatPath": "v2/blogs/{blogId}/posts/{postId}/comments",
"parameterOrder": [
"blogId",
"postId"
],
"parameters": {
"blogId": {
"location": "path",
"required": true,
"type": "string"
},
"fetchBodies": {
"location": "query",
"type": "boolean"
},
"postId": {
"location": "path",
"type": "string",
"required": true
},
"startDate": {
"location": "query",
"type": "string"
},
"pageToken": {
"type": "string",
"location": "query"
},
"maxResults": {
"format": "uint32",
"type": "integer",
"location": "query"
}
},
"id": "blogger.comments.list",
"path": "v2/blogs/{blogId}/posts/{postId}/comments",
"response": {
"$ref": "CommentList"
},
"scopes": [
"https://www.googleapis.com/auth/blogger"
],
"description": "Lists comments.",
"httpMethod": "GET"
},
"get": {
"flatPath": "v2/blogs/{blogId}/posts/{postId}/comments/{commentId}",
"httpMethod": "GET",
"parameterOrder": [
"blogId",
"postId",
"commentId"
],
"response": {
"$ref": "Comment"
},
"description": "Gets a comment by blog id, post id and comment id.",
"scopes": [
"https://www.googleapis.com/auth/blogger"
],
"parameters": {
"commentId": {
"location": "path",
"type": "string",
"required": true
},
"blogId": {
"location": "path",
"required": true,
"type": "string"
},
"postId": {
"location": "path",
"required": true,
"type": "string"
}
},
"path": "v2/blogs/{blogId}/posts/{postId}/comments/{commentId}",
"id": "blogger.comments.get"
}
}
},
"blogs": {
"methods": {
"get": {
"path": "v2/blogs/{blogId}",
"scopes": [
"https://www.googleapis.com/auth/blogger"
],
"response": {
"$ref": "Blog"
},
"description": "Gets a blog by id.",
"parameterOrder": [
"blogId"
],
"httpMethod": "GET",
"id": "blogger.blogs.get",
"flatPath": "v2/blogs/{blogId}",
"parameters": {
"blogId": {
"type": "string",
"required": true,
"location": "path"
}
}
},
"list": {
"flatPath": "v2/users/{userId}/blogs",
"scopes": [
"https://www.googleapis.com/auth/blogger"
],
"parameterOrder": [
"userId"
],
"description": "Lists blogs by user id, possibly filtered.",
"response": {
"$ref": "BlogList"
},
"path": "v2/users/{userId}/blogs",
"httpMethod": "GET",
"parameters": {
"userId": {
"required": true,
"location": "path",
"type": "string"
}
},
"id": "blogger.blogs.list"
}
}
},
"pages": {
"methods": {
"list": {
"id": "blogger.pages.list",
"response": {
"$ref": "PageList"
},
"description": "Lists pages.",
"path": "v2/blogs/{blogId}/pages",
"parameters": {
"fetchBodies": {
"location": "query",
"type": "boolean"
},
"blogId": {
"required": true,
"location": "path",
"type": "string"
}
},
"scopes": [
"https://www.googleapis.com/auth/blogger"
],
"httpMethod": "GET",
"flatPath": "v2/blogs/{blogId}/pages",
"parameterOrder": [
"blogId"
]
},
"get": {
"id": "blogger.pages.get",
"response": {
"$ref": "Page"
},
"scopes": [
"https://www.googleapis.com/auth/blogger"
],
"description": "Gets a page by blog id and page id.",
"parameters": {
"blogId": {
"type": "string",
"location": "path",
"required": true
},
"pageId": {
"location": "path",
"required": true,
"type": "string"
}
},
"flatPath": "v2/blogs/{blogId}/pages/{pageId}",
"httpMethod": "GET",
"parameterOrder": [
"blogId",
"pageId"
],
"path": "v2/blogs/{blogId}/pages/{pageId}"
}
}
},
"posts": {
"methods": {
"list": {
"response": {
"$ref": "PostList"
},
"parameters": {
"fetchBodies": {
"type": "boolean",
"location": "query"
},
"startDate": {
"type": "string",
"location": "query"
},
"blogId": {
"type": "string",
"required": true,
"location": "path"
},
"maxResults": {
"type": "integer",
"location": "query",
"format": "uint32"
},
"pageToken": {
"type": "string",
"location": "query"
}
},
"scopes": [
"https://www.googleapis.com/auth/blogger"
],
"httpMethod": "GET",
"id": "blogger.posts.list",
"description": "Lists posts.",
"flatPath": "v2/blogs/{blogId}/posts",
"path": "v2/blogs/{blogId}/posts",
"parameterOrder": [
"blogId"
]
},
"get": {
"parameters": {
"blogId": {
"type": "string",
"location": "path",
"required": true
},
"postId": {
"location": "path",
"type": "string",
"required": true
}
},
"flatPath": "v2/blogs/{blogId}/posts/{postId}",
"response": {
"$ref": "Post"
},
"scopes": [
"https://www.googleapis.com/auth/blogger"
],
"id": "blogger.posts.get",
"description": "Gets a post by blog id and post id",
"path": "v2/blogs/{blogId}/posts/{postId}",
"httpMethod": "GET",
"parameterOrder": [
"blogId",
"postId"
]
}
}
}
},
"rootUrl": "https://blogger.googleapis.com/",
"servicePath": "",
"documentationLink": "https://developers.google.com/blogger/docs/3.0/getting_started",
"description": "The Blogger API provides access to posts, comments and pages of a Blogger blog.",
"baseUrl": "https://blogger.googleapis.com/",
"revision": "20200801",
"discoveryVersion": "v1",
"mtlsRootUrl": "https://blogger.mtls.googleapis.com/",
"ownerName": "Google",
"icons": {
"x32": "http://www.google.com/images/icons/product/search-32.gif",
"x16": "http://www.google.com/images/icons/product/search-16.gif"
},
"version": "v2",
"title": "Blogger API v3",
"fullyEncodeReservedExpansion": true,
"parameters": {
"uploadType": {
"description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").",
"location": "query",
"type": "string"
},
"callback": {
"type": "string",
"description": "JSONP",
"location": "query"
},
"alt": {
"enumDescriptions": [
"Responses with Content-Type of application/json",
"Media download with context-dependent Content-Type",
"Responses with Content-Type of application/x-protobuf"
],
"enum": [
"json",
"media",
"proto"
],
"location": "query",
"default": "json",
"type": "string",
"description": "Data format for response."
},
"fields": {
"type": "string",
"description": "Selector specifying which fields to include in a partial response.",
"location": "query"
},
"prettyPrint": {
"default": "true",
"type": "boolean",
"location": "query",
"description": "Returns response with indentations and line breaks."
},
"access_token": {
"description": "OAuth access token.",
"location": "query",
"type": "string"
},
"upload_protocol": {
"description": "Upload protocol for media (e.g. \"raw\", \"multipart\").",
"location": "query",
"type": "string"
},
"oauth_token": {
"description": "OAuth 2.0 token for the current user.",
"location": "query",
"type": "string"
},
"$.xgafv": {
"description": "V1 error format.",
"type": "string",
"enum": [
"1",
"2"
],
"enumDescriptions": [
"v1 error format",
"v2 error format"
],
"location": "query"
},
"quotaUser": {
"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.",
"type": "string",
"location": "query"
},
"key": {
"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.",
"type": "string",
"location": "query"
}
},
"name": "blogger",
"canonicalName": "Blogger"
}