Blogger API
The Blogger API provides access to posts, comments and pages of a Blogger blog
COMMUNITYBEARER0 INSTALLS
OpenAPI Specificationv3.0
{
"openapi": "3.0.0",
"servers": [
{
"url": "https://blogger.googleapis.com/"
}
],
"info": {
"contact": {
"name": "Google",
"url": "https://google.com",
"x-twitter": "youtube"
},
"description": "The Blogger API provides access to posts, comments and pages of a Blogger blog.",
"license": {
"name": "Creative Commons Attribution 3.0",
"url": "http://creativecommons.org/licenses/by/3.0/"
},
"termsOfService": "https://developers.google.com/terms/",
"title": "Blogger API",
"version": "v3",
"x-apiClientRegistration": {
"url": "https://console.developers.google.com"
},
"x-apisguru-categories": [
"analytics",
"media"
],
"x-logo": {
"url": "https://api.apis.guru/v2/cache/logo/https_www.google.com_images_branding_googlelogo_2x_googlelogo_color_272x92dp.png"
},
"x-origin": [
{
"format": "google",
"url": "https://blogger.googleapis.com/$discovery/rest?version=v3",
"version": "v1"
}
],
"x-preferred": true,
"x-providerName": "googleapis.com",
"x-serviceName": "blogger"
},
"externalDocs": {
"url": "https://developers.google.com/blogger/docs/3.0/getting_started"
},
"tags": [
{
"name": "blogs"
},
{
"name": "blogUserInfos"
},
{
"name": "comments"
},
{
"name": "pages"
},
{
"name": "pageViews"
},
{
"name": "posts"
},
{
"name": "postUserInfos"
},
{
"name": "users"
}
],
"paths": {
"/v3/blogs/byurl": {
"get": {
"description": "Gets a blog by url.",
"operationId": "blogger.blogs.getByUrl",
"parameters": [
{
"in": "query",
"name": "url",
"required": true,
"schema": {
"type": "string"
}
},
{
"in": "query",
"name": "view",
"schema": {
"enum": [
"VIEW_TYPE_UNSPECIFIED",
"READER",
"AUTHOR",
"ADMIN"
],
"type": "string"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Blog"
}
}
},
"description": "Successful response"
}
},
"security": [
{
"Oauth2": [
"https://www.googleapis.com/auth/blogger"
],
"Oauth2c": [
"https://www.googleapis.com/auth/blogger"
]
},
{
"Oauth2": [
"https://www.googleapis.com/auth/blogger.readonly"
],
"Oauth2c": [
"https://www.googleapis.com/auth/blogger.readonly"
]
}
],
"tags": [
"blogs"
]
},
"parameters": [
{
"$ref": "#/components/parameters/_.xgafv"
},
{
"$ref": "#/components/parameters/access_token"
},
{
"$ref": "#/components/parameters/alt"
},
{
"$ref": "#/components/parameters/callback"
},
{
"$ref": "#/components/parameters/fields"
},
{
"$ref": "#/components/parameters/key"
},
{
"$ref": "#/components/parameters/oauth_token"
},
{
"$ref": "#/components/parameters/prettyPrint"
},
{
"$ref": "#/components/parameters/quotaUser"
},
{
"$ref": "#/components/parameters/upload_protocol"
},
{
"$ref": "#/components/parameters/uploadType"
}
]
},
"/v3/blogs/{blogId}": {
"get": {
"description": "Gets a blog by id.",
"operationId": "blogger.blogs.get",
"parameters": [
{
"in": "path",
"name": "blogId",
"required": true,
"schema": {
"type": "string"
}
},
{
"in": "query",
"name": "maxPosts",
"schema": {
"type": "integer"
}
},
{
"in": "query",
"name": "view",
"schema": {
"enum": [
"VIEW_TYPE_UNSPECIFIED",
"READER",
"AUTHOR",
"ADMIN"
],
"type": "string"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Blog"
}
}
},
"description": "Successful response"
}
},
"security": [
{
"Oauth2": [
"https://www.googleapis.com/auth/blogger"
],
"Oauth2c": [
"https://www.googleapis.com/auth/blogger"
]
},
{
"Oauth2": [
"https://www.googleapis.com/auth/blogger.readonly"
],
"Oauth2c": [
"https://www.googleapis.com/auth/blogger.readonly"
]
}
],
"tags": [
"blogs"
]
},
"parameters": [
{
"$ref": "#/components/parameters/_.xgafv"
},
{
"$ref": "#/components/parameters/access_token"
},
{
"$ref": "#/components/parameters/alt"
},
{
"$ref": "#/components/parameters/callback"
},
{
"$ref": "#/components/parameters/fields"
},
{
"$ref": "#/components/parameters/key"
},
{
"$ref": "#/components/parameters/oauth_token"
},
{
"$ref": "#/components/parameters/prettyPrint"
},
{
"$ref": "#/components/parameters/quotaUser"
},
{
"$ref": "#/components/parameters/upload_protocol"
},
{
"$ref": "#/components/parameters/uploadType"
}
]
},
"/v3/blogs/{blogId}/comments": {
"get": {
"description": "Lists comments by blog.",
"operationId": "blogger.comments.listByBlog",
"parameters": [
{
"in": "path",
"name": "blogId",
"required": true,
"schema": {
"type": "string"
}
},
{
"in": "query",
"name": "endDate",
"schema": {
"type": "string"
}
},
{
"in": "query",
"name": "fetchBodies",
"schema": {
"type": "boolean"
}
},
{
"in": "query",
"name": "maxResults",
"schema": {
"type": "integer"
}
},
{
"in": "query",
"name": "pageToken",
"schema": {
"type": "string"
}
},
{
"in": "query",
"name": "startDate",
"schema": {
"type": "string"
}
},
{
"explode": true,
"in": "query",
"name": "status",
"schema": {
"items": {
"enum": [
"LIVE",
"EMPTIED",
"PENDING",
"SPAM"
],
"type": "string"
},
"type": "array"
},
"style": "form"
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/CommentList"
}
}
},
"description": "Successful response"
}
},
"security": [
{
"Oauth2": [
"https://www.googleapis.com/auth/blogger"
],
"Oauth2c": [
"https://www.googleapis.com/auth/blogger"
]
},
{
"Oauth2": [
"https://www.googleapis.com/auth/blogger.readonly"
],
"Oauth2c": [
"https://www.googleapis.com/auth/blogger.readonly"
]
}
],
"tags": [
"comments"
]
},
"parameters": [
{
"$ref": "#/components/parameters/_.xgafv"
},
{
"$ref": "#/components/parameters/access_token"
},
{
"$ref": "#/components/parameters/alt"
},
{
"$ref": "#/components/parameters/callback"
},
{
"$ref": "#/components/parameters/fields"
},
{
"$ref": "#/components/parameters/key"
},
{
"$ref": "#/components/parameters/oauth_token"
},
{
"$ref": "#/components/parameters/prettyPrint"
},
{
"$ref": "#/components/parameters/quotaUser"
},
{
"$ref": "#/components/parameters/upload_protocol"
},
{
"$ref": "#/components/parameters/uploadType"
}
]
},
"/v3/blogs/{blogId}/pages": {
"get": {
"description": "Lists pages.",
"operationId": "blogger.pages.list",
"parameters": [
{
"in": "path",
"name": "blogId",
"required": true,
"schema": {
"type": "string"
}
},
{
"in": "query",
"name": "fetchBodies",
"schema": {
"type": "boolean"
}
},
{
"in": "query",
"name": "maxResults",
"schema": {
"type": "integer"
}
},
{
"in": "query",
"name": "pageToken",
"schema": {
"type": "string"
}
},
{
"explode": true,
"in": "query",
"name": "status",
"schema": {
"items": {
"enum": [
"LIVE",
"DRAFT",
"SOFT_TRASHED"
],
"type": "string"
},
"type": "array"
},
"style": "form"
},
{
"in": "query",
"name": "view",
"schema": {
"enum": [
"VIEW_TYPE_UNSPECIFIED",
"READER",
"AUTHOR",
"ADMIN"
],
"type": "string"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PageList"
}
}
},
"description": "Successful response"
}
},
"security": [
{
"Oauth2": [
"https://www.googleapis.com/auth/blogger"
],
"Oauth2c": [
"https://www.googleapis.com/auth/blogger"
]
},
{
"Oauth2": [
"https://www.googleapis.com/auth/blogger.readonly"
],
"Oauth2c": [
"https://www.googleapis.com/auth/blogger.readonly"
]
}
],
"tags": [
"pages"
]
},
"parameters": [
{
"$ref": "#/components/parameters/_.xgafv"
},
{
"$ref": "#/components/parameters/access_token"
},
{
"$ref": "#/components/parameters/alt"
},
{
"$ref": "#/components/parameters/callback"
},
{
"$ref": "#/components/parameters/fields"
},
{
"$ref": "#/components/parameters/key"
},
{
"$ref": "#/components/parameters/oauth_token"
},
{
"$ref": "#/components/parameters/prettyPrint"
},
{
"$ref": "#/components/parameters/quotaUser"
},
{
"$ref": "#/components/parameters/upload_protocol"
},
{
"$ref": "#/components/parameters/uploadType"
}
],
"post": {
"description": "Inserts a page.",
"operationId": "blogger.pages.insert",
"parameters": [
{
"in": "path",
"name": "blogId",
"required": true,
"schema": {
"type": "string"
}
},
{
"in": "query",
"name": "isDraft",
"schema": {
"type": "boolean"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Page"
}
}
}
},
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Page"
}
}
},
"description": "Successful response"
}
},
"security": [
{
"Oauth2": [
"https://www.googleapis.com/auth/blogger"
],
"Oauth2c": [
"https://www.googleapis.com/auth/blogger"
]
}
],
"tags": [
"pages"
]
}
},
"/v3/blogs/{blogId}/pages/{pageId}": {
"delete": {
"description": "Deletes a page by blog id and page id.",
"operationId": "blogger.pages.delete",
"parameters": [
{
"in": "path",
"name": "blogId",
"required": true,
"schema": {
"type": "string"
}
},
{
"in": "path",
"name": "pageId",
"required": true,
"schema": {
"type": "string"
}
},
{
"description": "Move to Trash if possible",
"in": "query",
"name": "useTrash",
"schema": {
"type": "boolean"
}
}
],
"responses": {
"200": {
"description": "Successful response"
}
},
"security": [
{
"Oauth2": [
"https://www.googleapis.com/auth/blogger"
],
"Oauth2c": [
"https://www.googleapis.com/auth/blogger"
]
}
],
"tags": [
"pages"
]
},
"get": {
"description": "Gets a page by blog id and page id.",
"operationId": "blogger.pages.get",
"parameters": [
{
"in": "path",
"name": "blogId",
"required": true,
"schema": {
"type": "string"
}
},
{
"in": "path",
"name": "pageId",
"required": true,
"schema": {
"type": "string"
}
},
{
"in": "query",
"name": "view",
"schema": {
"enum": [
"VIEW_TYPE_UNSPECIFIED",
"READER",
"AUTHOR",
"ADMIN"
],
"type": "string"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Page"
}
}
},
"description": "Successful response"
}
},
"security": [
{
"Oauth2": [
"https://www.googleapis.com/auth/blogger"
],
"Oauth2c": [
"https://www.googleapis.com/auth/blogger"
]
},
{
"Oauth2": [
"https://www.googleapis.com/auth/blogger.readonly"
],
"Oauth2c": [
"https://www.googleapis.com/auth/blogger.readonly"
]
}
],
"tags": [
"pages"
]
},
"parameters": [
{
"$ref": "#/components/parameters/_.xgafv"
},
{
"$ref": "#/components/parameters/access_token"
},
{
"$ref": "#/components/parameters/alt"
},
{
"$ref": "#/components/parameters/callback"
},
{
"$ref": "#/components/parameters/fields"
},
{
"$ref": "#/components/parameters/key"
},
{
"$ref": "#/components/parameters/oauth_token"
},
{
"$ref": "#/components/parameters/prettyPrint"
},
{
"$ref": "#/components/parameters/quotaUser"
},
{
"$ref": "#/components/parameters/upload_protocol"
},
{
"$ref": "#/components/parameters/uploadType"
}
],
"patch": {
"description": "Patches a page.",
"operationId": "blogger.pages.patch",
"parameters": [
{
"in": "path",
"name": "blogId",
"required": true,
"schema": {
"type": "string"
}
},
{
"in": "path",
"name": "pageId",
"required": true,
"schema": {
"type": "string"
}
},
{
"in": "query",
"name": "publish",
"schema": {
"type": "boolean"
}
},
{
"in": "query",
"name": "revert",
"schema": {
"type": "boolean"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Page"
}
}
}
},
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Page"
}
}
},
"description": "Successful response"
}
},
"security": [
{
"Oauth2": [
"https://www.googleapis.com/auth/blogger"
],
"Oauth2c": [
"https://www.googleapis.com/auth/blogger"
]
}
],
"tags": [
"pages"
]
},
"put": {
"description": "Updates a page by blog id and page id.",
"operationId": "blogger.pages.update",
"parameters": [
{
"in": "path",
"name": "blogId",
"required": true,
"schema": {
"type": "string"
}
},
{
"in": "path",
"name": "pageId",
"required": true,
"schema": {
"type": "string"
}
},
{
"in": "query",
"name": "publish",
"schema": {
"type": "boolean"
}
},
{
"in": "query",
"name": "revert",
"schema": {
"type": "boolean"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Page"
}
}
}
},
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Page"
}
}
},
"description": "Successful response"
}
},
"security": [
{
"Oauth2": [
"https://www.googleapis.com/auth/blogger"
],
"Oauth2c": [
"https://www.googleapis.com/auth/blogger"
]
}
],
"tags": [
"pages"
]
}
},
"/v3/blogs/{blogId}/pages/{pageId}/publish": {
"parameters": [
{
"$ref": "#/components/parameters/_.xgafv"
},
{
"$ref": "#/components/parameters/access_token"
},
{
"$ref": "#/components/parameters/alt"
},
{
"$ref": "#/components/parameters/callback"
},
{
"$ref": "#/components/parameters/fields"
},
{
"$ref": "#/components/parameters/key"
},
{
"$ref": "#/components/parameters/oauth_token"
},
{
"$ref": "#/components/parameters/prettyPrint"
},
{
"$ref": "#/components/parameters/quotaUser"
},
{
"$ref": "#/components/parameters/upload_protocol"
},
{
"$ref": "#/components/parameters/uploadType"
}
],
"post": {
"description": "Publishes a page.",
"operationId": "blogger.pages.publish",
"parameters": [
{
"in": "path",
"name": "blogId",
"required": true,
"schema": {
"type": "string"
}
},
{
"in": "path",
"name": "pageId",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Page"
}
}
},
"description": "Successful response"
}
},
"security": [
{
"Oauth2": [
"https://www.googleapis.com/auth/blogger"
],
"Oauth2c": [
"https://www.googleapis.com/auth/blogger"
]
}
],
"tags": [
"pages"
]
}
},
"/v3/blogs/{blogId}/pages/{pageId}/revert": {
"parameters": [
{
"$ref": "#/components/parameters/_.xgafv"
},
{
"$ref": "#/components/parameters/access_token"
},
{
"$ref": "#/components/parameters/alt"
},
{
"$ref": "#/components/parameters/callback"
},
{
"$ref": "#/components/parameters/fields"
},
{
"$ref": "#/components/parameters/key"
},
{
"$ref": "#/components/parameters/oauth_token"
},
{
"$ref": "#/components/parameters/prettyPrint"
},
{
"$ref": "#/components/parameters/quotaUser"
},
{
"$ref": "#/components/parameters/upload_protocol"
},
{
"$ref": "#/components/parameters/uploadType"
}
],
"post": {
"description": "Reverts a published or scheduled page to draft state.",
"operationId": "blogger.pages.revert",
"parameters": [
{
"in": "path",
"name": "blogId",
"required": true,
"schema": {
"type": "string"
}
},
{
"in": "path",
"name": "pageId",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Page"
}
}
},
"description": "Successful response"
}
},
"security": [
{
"Oauth2": [
"https://www.googleapis.com/auth/blogger"
],
"Oauth2c": [
"https://www.googleapis.com/auth/blogger"
]
}
],
"tags": [
"pages"
]
}
},
"/v3/blogs/{blogId}/pageviews": {
"get": {
"description": "Gets page views by blog id.",
"operationId": "blogger.pageViews.get",
"parameters": [
{
"in": "path",
"name": "blogId",
"required": true,
"schema": {
"type": "string"
}
},
{
"explode": true,
"in": "query",
"name": "range",
"schema": {
"items": {
"enum": [
"all",
"30DAYS",
"7DAYS"
],
"type": "string"
},
"type": "array"
},
"style": "form"
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Pageviews"
}
}
},
"description": "Successful response"
}
},
"security": [
{
"Oauth2": [
"https://www.googleapis.com/auth/blogger"
],
"Oauth2c": [
"https://www.googleapis.com/auth/blogger"
]
}
],
"tags": [
"pageViews"
]
},
"parameters": [
{
"$ref": "#/components/parameters/_.xgafv"
},
{
"$ref": "#/components/parameters/access_token"
},
{
"$ref": "#/components/parameters/alt"
},
{
"$ref": "#/components/parameters/callback"
},
{
"$ref": "#/components/parameters/fields"
},
{
"$ref": "#/components/parameters/key"
},
{
"$ref": "#/components/parameters/oauth_token"
},
{
"$ref": "#/components/parameters/prettyPrint"
},
{
"$ref": "#/components/parameters/quotaUser"
},
{
"$ref": "#/components/parameters/upload_protocol"
},
{
"$ref": "#/components/parameters/uploadType"
}
]
},
"/v3/blogs/{blogId}/posts": {
"get": {
"description": "Lists posts.",
"operationId": "blogger.posts.list",
"parameters": [
{
"in": "path",
"name": "blogId",
"required": true,
"schema": {
"type": "string"
}
},
{
"in": "query",
"name": "endDate",
"schema": {
"type": "string"
}
},
{
"in": "query",
"name": "fetchBodies",
"schema": {
"type": "boolean"
}
},
{
"in": "query",
"name": "fetchImages",
"schema": {
"type": "boolean"
}
},
{
"in": "query",
"name": "labels",
"schema": {
"type": "string"
}
},
{
"in": "query",
"name": "maxResults",
"schema": {
"type": "integer"
}
},
{
"in": "query",
"name": "orderBy",
"schema": {
"enum": [
"ORDER_BY_UNSPECIFIED",
"PUBLISHED",
"UPDATED"
],
"type": "string"
}
},
{
"in": "query",
"name": "pageToken",
"schema": {
"type": "string"
}
},
{
"description": "Sort direction applied to post list.",
"in": "query",
"name": "sortOption",
"schema": {
"enum": [
"SORT_OPTION_UNSPECIFIED",
"DESCENDING",
"ASCENDING"
],
"type": "string"
}
},
{
"in": "query",
"name": "startDate",
"schema": {
"type": "string"
}
},
{
"explode": true,
"in": "query",
"name": "status",
"schema": {
"items": {
"enum": [
"LIVE",
"DRAFT",
"SCHEDULED",
"SOFT_TRASHED"
],
"type": "string"
},
"type": "array"
},
"style": "form"
},
{
"in": "query",
"name": "view",
"schema": {
"enum": [
"VIEW_TYPE_UNSPECIFIED",
"READER",
"AUTHOR",
"ADMIN"
],
"type": "string"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PostList"
}
}
},
"description": "Successful response"
}
},
"security": [
{
"Oauth2": [
"https://www.googleapis.com/auth/blogger"
],
"Oauth2c": [
"https://www.googleapis.com/auth/blogger"
]
},
{
"Oauth2": [
"https://www.googleapis.com/auth/blogger.readonly"
],
"Oauth2c": [
"https://www.googleapis.com/auth/blogger.readonly"
]
}
],
"tags": [
"posts"
]
},
"parameters": [
{
"$ref": "#/components/parameters/_.xgafv"
},
{
"$ref": "#/components/parameters/access_token"
},
{
"$ref": "#/components/parameters/alt"
},
{
"$ref": "#/components/parameters/callback"
},
{
"$ref": "#/components/parameters/fields"
},
{
"$ref": "#/components/parameters/key"
},
{
"$ref": "#/components/parameters/oauth_token"
},
{
"$ref": "#/components/parameters/prettyPrint"
},
{
"$ref": "#/components/parameters/quotaUser"
},
{
"$ref": "#/components/parameters/upload_protocol"
},
{
"$ref": "#/components/parameters/uploadType"
}
],
"post": {
"description": "Inserts a post.",
"operationId": "blogger.posts.insert",
"parameters": [
{
"in": "path",
"name": "blogId",
"required": true,
"schema": {
"type": "string"
}
},
{
"in": "query",
"name": "fetchBody",
"schema": {
"type": "boolean"
}
},
{
"in": "query",
"name": "fetchImages",
"schema": {
"type": "boolean"
}
},
{
"in": "query",
"name": "isDraft",
"schema": {
"type": "boolean"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Post"
}
}
}
},
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Post"
}
}
},
"description": "Successful response"
}
},
"security": [
{
"Oauth2": [
"https://www.googleapis.com/auth/blogger"
],
"Oauth2c": [
"https://www.googleapis.com/auth/blogger"
]
}
],
"tags": [
"posts"
]
}
},
"/v3/blogs/{blogId}/posts/bypath": {
"get": {
"description": "Gets a post by path.",
"operationId": "blogger.posts.getByPath",
"parameters": [
{
"in": "path",
"name": "blogId",
"required": true,
"schema": {
"type": "string"
}
},
{
"in": "query",
"name": "path",
"required": true,
"schema": {
"type": "string"
}
},
{
"in": "query",
"name": "maxComments",
"schema": {
"type": "integer"
}
},
{
"in": "query",
"name": "view",
"schema": {
"enum": [
"VIEW_TYPE_UNSPECIFIED",
"READER",
"AUTHOR",
"ADMIN"
],
"type": "string"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Post"
}
}
},
"description": "Successful response"
}
},
"security": [
{
"Oauth2": [
"https://www.googleapis.com/auth/blogger"
],
"Oauth2c": [
"https://www.googleapis.com/auth/blogger"
]
},
{
"Oauth2": [
"https://www.googleapis.com/auth/blogger.readonly"
],
"Oauth2c": [
"https://www.googleapis.com/auth/blogger.readonly"
]
}
],
"tags": [
"posts"
]
},
"parameters": [
{
"$ref": "#/components/parameters/_.xgafv"
},
{
"$ref": "#/components/parameters/access_token"
},
{
"$ref": "#/components/parameters/alt"
},
{
"$ref": "#/components/parameters/callback"
},
{
"$ref": "#/components/parameters/fields"
},
{
"$ref": "#/components/parameters/key"
},
{
"$ref": "#/components/parameters/oauth_token"
},
{
"$ref": "#/components/parameters/prettyPrint"
},
{
"$ref": "#/components/parameters/quotaUser"
},
{
"$ref": "#/components/parameters/upload_protocol"
},
{
"$ref": "#/components/parameters/uploadType"
}
]
},
"/v3/blogs/{blogId}/posts/search": {
"get": {
"description": "Searches for posts matching given query terms in the specified blog.",
"operationId": "blogger.posts.search",
"parameters": [
{
"in": "path",
"name": "blogId",
"required": true,
"schema": {
"type": "string"
}
},
{
"in": "query",
"name": "q",
"required": true,
"schema": {
"type": "string"
}
},
{
"in": "query",
"name": "fetchBodies",
"schema": {
"type": "boolean"
}
},
{
"in": "query",
"name": "orderBy",
"schema": {
"enum": [
"ORDER_BY_UNSPECIFIED",
"PUBLISHED",
"UPDATED"
],
"type": "string"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PostList"
}
}
},
"description": "Successful response"
}
},
"security": [
{
"Oauth2": [
"https://www.googleapis.com/auth/blogger"
],
"Oauth2c": [
"https://www.googleapis.com/auth/blogger"
]
},
{
"Oauth2": [
"https://www.googleapis.com/auth/blogger.readonly"
],
"Oauth2c": [
"https://www.googleapis.com/auth/blogger.readonly"
]
}
],
"tags": [
"posts"
]
},
"parameters": [
{
"$ref": "#/components/parameters/_.xgafv"
},
{
"$ref": "#/components/parameters/access_token"
},
{
"$ref": "#/components/parameters/alt"
},
{
"$ref": "#/components/parameters/callback"
},
{
"$ref": "#/components/parameters/fields"
},
{
"$ref": "#/components/parameters/key"
},
{
"$ref": "#/components/parameters/oauth_token"
},
{
"$ref": "#/components/parameters/prettyPrint"
},
{
"$ref": "#/components/parameters/quotaUser"
},
{
"$ref": "#/components/parameters/upload_protocol"
},
{
"$ref": "#/components/parameters/uploadType"
}
]
},
"/v3/blogs/{blogId}/posts/{postId}": {
"delete": {
"description": "Deletes a post by blog id and post id.",
"operationId": "blogger.posts.delete",
"parameters": [
{
"in": "path",
"name": "blogId",
"required": true,
"schema": {
"type": "string"
}
},
{
"in": "path",
"name": "postId",
"required": true,
"schema": {
"type": "string"
}
},
{
"description": "Move to Trash if possible",
"in": "query",
"name": "useTrash",
"schema": {
"type": "boolean"
}
}
],
"responses": {
"200": {
"description": "Successful response"
}
},
"security": [
{
"Oauth2": [
"https://www.googleapis.com/auth/blogger"
],
"Oauth2c": [
"https://www.googleapis.com/auth/blogger"
]
}
],
"tags": [
"posts"
]
},
"get": {
"description": "Gets a post by blog id and post id",
"operationId": "blogger.posts.get",
"parameters": [
{
"in": "path",
"name": "blogId",
"required": true,
"schema": {
"type": "string"
}
},
{
"in": "path",
"name": "postId",
"required": true,
"schema": {
"type": "string"
}
},
{
"in": "query",
"name": "fetchBody",
"schema": {
"type": "boolean"
}
},
{
"in": "query",
"name": "fetchImages",
"schema": {
"type": "boolean"
}
},
{
"in": "query",
"name": "maxComments",
"schema": {
"type": "integer"
}
},
{
"in": "query",
"name": "view",
"schema": {
"enum": [
"VIEW_TYPE_UNSPECIFIED",
"READER",
"AUTHOR",
"ADMIN"
],
"type": "string"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Post"
}
}
},
"description": "Successful response"
}
},
"security": [
{
"Oauth2": [
"https://www.googleapis.com/auth/blogger"
],
"Oauth2c": [
"https://www.googleapis.com/auth/blogger"
]
},
{
"Oauth2": [
"https://www.googleapis.com/auth/blogger.readonly"
],
"Oauth2c": [
"https://www.googleapis.com/auth/blogger.readonly"
]
}
],
"tags": [
"posts"
]
},
"parameters": [
{
"$ref": "#/components/parameters/_.xgafv"
},
{
"$ref": "#/components/parameters/access_token"
},
{
"$ref": "#/components/parameters/alt"
},
{
"$ref": "#/components/parameters/callback"
},
{
"$ref": "#/components/parameters/fields"
},
{
"$ref": "#/components/parameters/key"
},
{
"$ref": "#/components/parameters/oauth_token"
},
{
"$ref": "#/components/parameters/prettyPrint"
},
{
"$ref": "#/components/parameters/quotaUser"
},
{
"$ref": "#/components/parameters/upload_protocol"
},
{
"$ref": "#/components/parameters/uploadType"
}
],
"patch": {
"description": "Patches a post.",
"operationId": "blogger.posts.patch",
"parameters": [
{
"in": "path",
"name": "blogId",
"required": true,
"schema": {
"type": "string"
}
},
{
"in": "path",
"name": "postId",
"required": true,
"schema": {
"type": "string"
}
},
{
"in": "query",
"name": "fetchBody",
"schema": {
"type": "boolean"
}
},
{
"in": "query",
"name": "fetchImages",
"schema": {
"type": "boolean"
}
},
{
"in": "query",
"name": "maxComments",
"schema": {
"type": "integer"
}
},
{
"in": "query",
"name": "publish",
"schema": {
"type": "boolean"
}
},
{
"in": "query",
"name": "revert",
"schema": {
"type": "boolean"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Post"
}
}
}
},
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Post"
}
}
},
"description": "Successful response"
}
},
"security": [
{
"Oauth2": [
"https://www.googleapis.com/auth/blogger"
],
"Oauth2c": [
"https://www.googleapis.com/auth/blogger"
]
}
],
"tags": [
"posts"
]
},
"put": {
"description": "Updates a post by blog id and post id.",
"operationId": "blogger.posts.update",
"parameters": [
{
"in": "path",
"name": "blogId",
"required": true,
"schema": {
"type": "string"
}
},
{
"in": "path",
"name": "postId",
"required": true,
"schema": {
"type": "string"
}
},
{
"in": "query",
"name": "fetchBody",
"schema": {
"type": "boolean"
}
},
{
"in": "query",
"name": "fetchImages",
"schema": {
"type": "boolean"
}
},
{
"in": "query",
"name": "maxComments",
"schema": {
"type": "integer"
}
},
{
"in": "query",
"name": "publish",
"schema": {
"type": "boolean"
}
},
{
"in": "query",
"name": "revert",
"schema": {
"type": "boolean"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Post"
}
}
}
},
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Post"
}
}
},
"description": "Successful response"
}
},
"security": [
{
"Oauth2": [
"https://www.googleapis.com/auth/blogger"
],
"Oauth2c": [
"https://www.googleapis.com/auth/blogger"
]
}
],
"tags": [
"posts"
]
}
},
"/v3/blogs/{blogId}/posts/{postId}/comments": {
"get": {
"description": "Lists comments.",
"operationId": "blogger.comments.list",
"parameters": [
{
"in": "path",
"name": "blogId",
"required": true,
"schema": {
"type": "string"
}
},
{
"in": "path",
"name": "postId",
"required": true,
"schema": {
"type": "string"
}
},
{
"in": "query",
"name": "endDate",
"schema": {
"type": "string"
}
},
{
"in": "query",
"name": "fetchBodies",
"schema": {
"type": "boolean"
}
},
{
"in": "query",
"name": "maxResults",
"schema": {
"type": "integer"
}
},
{
"in": "query",
"name": "pageToken",
"schema": {
"type": "string"
}
},
{
"in": "query",
"name": "startDate",
"schema": {
"type": "string"
}
},
{
"in": "query",
"name": "status",
"schema": {
"enum": [
"LIVE",
"EMPTIED",
"PENDING",
"SPAM"
],
"type": "string"
}
},
{
"in": "query",
"name": "view",
"schema": {
"enum": [
"VIEW_TYPE_UNSPECIFIED",
"READER",
"AUTHOR",
"ADMIN"
],
"type": "string"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/CommentList"
}
}
},
"description": "Successful response"
}
},
"security": [
{
"Oauth2": [
"https://www.googleapis.com/auth/blogger"
],
"Oauth2c": [
"https://www.googleapis.com/auth/blogger"
]
},
{
"Oauth2": [
"https://www.googleapis.com/auth/blogger.readonly"
],
"Oauth2c": [
"https://www.googleapis.com/auth/blogger.readonly"
]
}
],
"tags": [
"comments"
]
},
"parameters": [
{
"$ref": "#/components/parameters/_.xgafv"
},
{
"$ref": "#/components/parameters/access_token"
},
{
"$ref": "#/components/parameters/alt"
},
{
"$ref": "#/components/parameters/callback"
},
{
"$ref": "#/components/parameters/fields"
},
{
"$ref": "#/components/parameters/key"
},
{
"$ref": "#/components/parameters/oauth_token"
},
{
"$ref": "#/components/parameters/prettyPrint"
},
{
"$ref": "#/components/parameters/quotaUser"
},
{
"$ref": "#/components/parameters/upload_protocol"
},
{
"$ref": "#/components/parameters/uploadType"
}
]
},
"/v3/blogs/{blogId}/posts/{postId}/comments/{commentId}": {
"delete": {
"description": "Deletes a comment by blog id, post id and comment id.",
"operationId": "blogger.comments.delete",
"parameters": [
{
"in": "path",
"name": "blogId",
"required": true,
"schema": {
"type": "string"
}
},
{
"in": "path",
"name": "postId",
"required": true,
"schema": {
"type": "string"
}
},
{
"in": "path",
"name": "commentId",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "Successful response"
}
},
"security": [
{
"Oauth2": [
"https://www.googleapis.com/auth/blogger"
],
"Oauth2c": [
"https://www.googleapis.com/auth/blogger"
]
}
],
"tags": [
"comments"
]
},
"get": {
"description": "Gets a comment by id.",
"operationId": "blogger.comments.get",
"parameters": [
{
"in": "path",
"name": "blogId",
"required": true,
"schema": {
"type": "string"
}
},
{
"in": "path",
"name": "postId",
"required": true,
"schema": {
"type": "string"
}
},
{
"in": "path",
"name": "commentId",
"required": true,
"schema": {
"type": "string"
}
},
{
"in": "query",
"name": "view",
"schema": {
"enum": [
"VIEW_TYPE_UNSPECIFIED",
"READER",
"AUTHOR",
"ADMIN"
],
"type": "string"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Comment"
}
}
},
"description": "Successful response"
}
},
"security": [
{
"Oauth2": [
"https://www.googleapis.com/auth/blogger"
],
"Oauth2c": [
"https://www.googleapis.com/auth/blogger"
]
},
{
"Oauth2": [
"https://www.googleapis.com/auth/blogger.readonly"
],
"Oauth2c": [
"https://www.googleapis.com/auth/blogger.readonly"
]
}
],
"tags": [
"comments"
]
},
"parameters": [
{
"$ref": "#/components/parameters/_.xgafv"
},
{
"$ref": "#/components/parameters/access_token"
},
{
"$ref": "#/components/parameters/alt"
},
{
"$ref": "#/components/parameters/callback"
},
{
"$ref": "#/components/parameters/fields"
},
{
"$ref": "#/components/parameters/key"
},
{
"$ref": "#/components/parameters/oauth_token"
},
{
"$ref": "#/components/parameters/prettyPrint"
},
{
"$ref": "#/components/parameters/quotaUser"
},
{
"$ref": "#/components/parameters/upload_protocol"
},
{
"$ref": "#/components/parameters/uploadType"
}
]
},
"/v3/blogs/{blogId}/posts/{postId}/comments/{commentId}/approve": {
"parameters": [
{
"$ref": "#/components/parameters/_.xgafv"
},
{
"$ref": "#/components/parameters/access_token"
},
{
"$ref": "#/components/parameters/alt"
},
{
"$ref": "#/components/parameters/callback"
},
{
"$ref": "#/components/parameters/fields"
},
{
"$ref": "#/components/parameters/key"
},
{
"$ref": "#/components/parameters/oauth_token"
},
{
"$ref": "#/components/parameters/prettyPrint"
},
{
"$ref": "#/components/parameters/quotaUser"
},
{
"$ref": "#/components/parameters/upload_protocol"
},
{
"$ref": "#/components/parameters/uploadType"
}
],
"post": {
"description": "Marks a comment as not spam by blog id, post id and comment id.",
"operationId": "blogger.comments.approve",
"parameters": [
{
"in": "path",
"name": "blogId",
"required": true,
"schema": {
"type": "string"
}
},
{
"in": "path",
"name": "postId",
"required": true,
"schema": {
"type": "string"
}
},
{
"in": "path",
"name": "commentId",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Comment"
}
}
},
"description": "Successful response"
}
},
"security": [
{
"Oauth2": [
"https://www.googleapis.com/auth/blogger"
],
"Oauth2c": [
"https://www.googleapis.com/auth/blogger"
]
}
],
"tags": [
"comments"
]
}
},
"/v3/blogs/{blogId}/posts/{postId}/comments/{commentId}/removecontent": {
"parameters": [
{
"$ref": "#/components/parameters/_.xgafv"
},
{
"$ref": "#/components/parameters/access_token"
},
{
"$ref": "#/components/parameters/alt"
},
{
"$ref": "#/components/parameters/callback"
},
{
"$ref": "#/components/parameters/fields"
},
{
"$ref": "#/components/parameters/key"
},
{
"$ref": "#/components/parameters/oauth_token"
},
{
"$ref": "#/components/parameters/prettyPrint"
},
{
"$ref": "#/components/parameters/quotaUser"
},
{
"$ref": "#/components/parameters/upload_protocol"
},
{
"$ref": "#/components/parameters/uploadType"
}
],
"post": {
"description": "Removes the content of a comment by blog id, post id and comment id.",
"operationId": "blogger.comments.removeContent",
"parameters": [
{
"in": "path",
"name": "blogId",
"required": true,
"schema": {
"type": "string"
}
},
{
"in": "path",
"name": "postId",
"required": true,
"schema": {
"type": "string"
}
},
{
"in": "path",
"name": "commentId",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Comment"
}
}
},
"description": "Successful response"
}
},
"security": [
{
"Oauth2": [
"https://www.googleapis.com/auth/blogger"
],
"Oauth2c": [
"https://www.googleapis.com/auth/blogger"
]
}
],
"tags": [
"comments"
]
}
},
"/v3/blogs/{blogId}/posts/{postId}/comments/{commentId}/spam": {
"parameters": [
{
"$ref": "#/components/parameters/_.xgafv"
},
{
"$ref": "#/components/parameters/access_token"
},
{
"$ref": "#/components/parameters/alt"
},
{
"$ref": "#/components/parameters/callback"
},
{
"$ref": "#/components/parameters/fields"
},
{
"$ref": "#/components/parameters/key"
},
{
"$ref": "#/components/parameters/oauth_token"
},
{
"$ref": "#/components/parameters/prettyPrint"
},
{
"$ref": "#/components/parameters/quotaUser"
},
{
"$ref": "#/components/parameters/upload_protocol"
},
{
"$ref": "#/components/parameters/uploadType"
}
],
"post": {
"description": "Marks a comment as spam by blog id, post id and comment id.",
"operationId": "blogger.comments.markAsSpam",
"parameters": [
{
"in": "path",
"name": "blogId",
"required": true,
"schema": {
"type": "string"
}
},
{
"in": "path",
"name": "postId",
"required": true,
"schema": {
"type": "string"
}
},
{
"in": "path",
"name": "commentId",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Comment"
}
}
},
"description": "Successful response"
}
},
"security": [
{
"Oauth2": [
"https://www.googleapis.com/auth/blogger"
],
"Oauth2c": [
"https://www.googleapis.com/auth/blogger"
]
}
],
"tags": [
"comments"
]
}
},
"/v3/blogs/{blogId}/posts/{postId}/publish": {
"parameters": [
{
"$ref": "#/components/parameters/_.xgafv"
},
{
"$ref": "#/components/parameters/access_token"
},
{
"$ref": "#/components/parameters/alt"
},
{
"$ref": "#/components/parameters/callback"
},
{
"$ref": "#/components/parameters/fields"
},
{
"$ref": "#/components/parameters/key"
},
{
"$ref": "#/components/parameters/oauth_token"
},
{
"$ref": "#/components/parameters/prettyPrint"
},
{
"$ref": "#/components/parameters/quotaUser"
},
{
"$ref": "#/components/parameters/upload_protocol"
},
{
"$ref": "#/components/parameters/uploadType"
}
],
"post": {
"description": "Publishes a post.",
"operationId": "blogger.posts.publish",
"parameters": [
{
"in": "path",
"name": "blogId",
"required": true,
"schema": {
"type": "string"
}
},
{
"in": "path",
"name": "postId",
"required": true,
"schema": {
"type": "string"
}
},
{
"in": "query",
"name": "publishDate",
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Post"
}
}
},
"description": "Successful response"
}
},
"security": [
{
"Oauth2": [
"https://www.googleapis.com/auth/blogger"
],
"Oauth2c": [
"https://www.googleapis.com/auth/blogger"
]
}
],
"tags": [
"posts"
]
}
},
"/v3/blogs/{blogId}/posts/{postId}/revert": {
"parameters": [
{
"$ref": "#/components/parameters/_.xgafv"
},
{
"$ref": "#/components/parameters/access_token"
},
{
"$ref": "#/components/parameters/alt"
},
{
"$ref": "#/components/parameters/callback"
},
{
"$ref": "#/components/parameters/fields"
},
{
"$ref": "#/components/parameters/key"
},
{
"$ref": "#/components/parameters/oauth_token"
},
{
"$ref": "#/components/parameters/prettyPrint"
},
{
"$ref": "#/components/parameters/quotaUser"
},
{
"$ref": "#/components/parameters/upload_protocol"
},
{
"$ref": "#/components/parameters/uploadType"
}
],
"post": {
"description": "Reverts a published or scheduled post to draft state.",
"operationId": "blogger.posts.revert",
"parameters": [
{
"in": "path",
"name": "blogId",
"required": true,
"schema": {
"type": "string"
}
},
{
"in": "path",
"name": "postId",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Post"
}
}
},
"description": "Successful response"
}
},
"security": [
{
"Oauth2": [
"https://www.googleapis.com/auth/blogger"
],
"Oauth2c": [
"https://www.googleapis.com/auth/blogger"
]
}
],
"tags": [
"posts"
]
}
},
"/v3/users/{userId}": {
"get": {
"description": "Gets one user by user_id.",
"operationId": "blogger.users.get",
"parameters": [
{
"in": "path",
"name": "userId",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/User"
}
}
},
"description": "Successful response"
}
},
"security": [
{
"Oauth2": [
"https://www.googleapis.com/auth/blogger"
],
"Oauth2c": [
"https://www.googleapis.com/auth/blogger"
]
},
{
"Oauth2": [
"https://www.googleapis.com/auth/blogger.readonly"
],
"Oauth2c": [
"https://www.googleapis.com/auth/blogger.readonly"
]
}
],
"tags": [
"users"
]
},
"parameters": [
{
"$ref": "#/components/parameters/_.xgafv"
},
{
"$ref": "#/components/parameters/access_token"
},
{
"$ref": "#/components/parameters/alt"
},
{
"$ref": "#/components/parameters/callback"
},
{
"$ref": "#/components/parameters/fields"
},
{
"$ref": "#/components/parameters/key"
},
{
"$ref": "#/components/parameters/oauth_token"
},
{
"$ref": "#/components/parameters/prettyPrint"
},
{
"$ref": "#/components/parameters/quotaUser"
},
{
"$ref": "#/components/parameters/upload_protocol"
},
{
"$ref": "#/components/parameters/uploadType"
}
]
},
"/v3/users/{userId}/blogs": {
"get": {
"description": "Lists blogs by user.",
"operationId": "blogger.blogs.listByUser",
"parameters": [
{
"in": "path",
"name": "userId",
"required": true,
"schema": {
"type": "string"
}
},
{
"in": "query",
"name": "fetchUserInfo",
"schema": {
"type": "boolean"
}
},
{
"explode": true,
"in": "query",
"name": "role",
"schema": {
"items": {
"enum": [
"VIEW_TYPE_UNSPECIFIED",
"READER",
"AUTHOR",
"ADMIN"
],
"type": "string"
},
"type": "array"
},
"style": "form"
},
{
"description": "Default value of status is LIVE.",
"explode": true,
"in": "query",
"name": "status",
"schema": {
"items": {
"enum": [
"LIVE",
"DELETED"
],
"type": "string"
},
"type": "array"
},
"style": "form"
},
{
"in": "query",
"name": "view",
"schema": {
"enum": [
"VIEW_TYPE_UNSPECIFIED",
"READER",
"AUTHOR",
"ADMIN"
],
"type": "string"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/BlogList"
}
}
},
"description": "Successful response"
}
},
"security": [
{
"Oauth2": [
"https://www.googleapis.com/auth/blogger"
],
"Oauth2c": [
"https://www.googleapis.com/auth/blogger"
]
},
{
"Oauth2": [
"https://www.googleapis.com/auth/blogger.readonly"
],
"Oauth2c": [
"https://www.googleapis.com/auth/blogger.readonly"
]
}
],
"tags": [
"blogs"
]
},
"parameters": [
{
"$ref": "#/components/parameters/_.xgafv"
},
{
"$ref": "#/components/parameters/access_token"
},
{
"$ref": "#/components/parameters/alt"
},
{
"$ref": "#/components/parameters/callback"
},
{
"$ref": "#/components/parameters/fields"
},
{
"$ref": "#/components/parameters/key"
},
{
"$ref": "#/components/parameters/oauth_token"
},
{
"$ref": "#/components/parameters/prettyPrint"
},
{
"$ref": "#/components/parameters/quotaUser"
},
{
"$ref": "#/components/parameters/upload_protocol"
},
{
"$ref": "#/components/parameters/uploadType"
}
]
},
"/v3/users/{userId}/blogs/{blogId}": {
"get": {
"description": "Gets one blog and user info pair by blog id and user id.",
"operationId": "blogger.blogUserInfos.get",
"parameters": [
{
"in": "path",
"name": "userId",
"required": true,
"schema": {
"type": "string"
}
},
{
"in": "path",
"name": "blogId",
"required": true,
"schema": {
"type": "string"
}
},
{
"in": "query",
"name": "maxPosts",
"schema": {
"type": "integer"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/BlogUserInfo"
}
}
},
"description": "Successful response"
}
},
"security": [
{
"Oauth2": [
"https://www.googleapis.com/auth/blogger"
],
"Oauth2c": [
"https://www.googleapis.com/auth/blogger"
]
},
{
"Oauth2": [
"https://www.googleapis.com/auth/blogger.readonly"
],
"Oauth2c": [
"https://www.googleapis.com/auth/blogger.readonly"
]
}
],
"tags": [
"blogUserInfos"
]
},
"parameters": [
{
"$ref": "#/components/parameters/_.xgafv"
},
{
"$ref": "#/components/parameters/access_token"
},
{
"$ref": "#/components/parameters/alt"
},
{
"$ref": "#/components/parameters/callback"
},
{
"$ref": "#/components/parameters/fields"
},
{
"$ref": "#/components/parameters/key"
},
{
"$ref": "#/components/parameters/oauth_token"
},
{
"$ref": "#/components/parameters/prettyPrint"
},
{
"$ref": "#/components/parameters/quotaUser"
},
{
"$ref": "#/components/parameters/upload_protocol"
},
{
"$ref": "#/components/parameters/uploadType"
}
]
},
"/v3/users/{userId}/blogs/{blogId}/posts": {
"get": {
"description": "Lists post and user info pairs.",
"operationId": "blogger.postUserInfos.list",
"parameters": [
{
"in": "path",
"name": "userId",
"required": true,
"schema": {
"type": "string"
}
},
{
"in": "path",
"name": "blogId",
"required": true,
"schema": {
"type": "string"
}
},
{
"in": "query",
"name": "endDate",
"schema": {
"type": "string"
}
},
{
"in": "query",
"name": "fetchBodies",
"schema": {
"type": "boolean"
}
},
{
"in": "query",
"name": "labels",
"schema": {
"type": "string"
}
},
{
"in": "query",
"name": "maxResults",
"schema": {
"type": "integer"
}
},
{
"in": "query",
"name": "orderBy",
"schema": {
"enum": [
"ORDER_BY_UNSPECIFIED",
"PUBLISHED",
"UPDATED"
],
"type": "string"
}
},
{
"in": "query",
"name": "pageToken",
"schema": {
"type": "string"
}
},
{
"in": "query",
"name": "startDate",
"schema": {
"type": "string"
}
},
{
"explode": true,
"in": "query",
"name": "status",
"schema": {
"items": {
"enum": [
"LIVE",
"DRAFT",
"SCHEDULED",
"SOFT_TRASHED"
],
"type": "string"
},
"type": "array"
},
"style": "form"
},
{
"in": "query",
"name": "view",
"schema": {
"enum": [
"VIEW_TYPE_UNSPECIFIED",
"READER",
"AUTHOR",
"ADMIN"
],
"type": "string"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PostUserInfosList"
}
}
},
"description": "Successful response"
}
},
"security": [
{
"Oauth2": [
"https://www.googleapis.com/auth/blogger"
],
"Oauth2c": [
"https://www.googleapis.com/auth/blogger"
]
},
{
"Oauth2": [
"https://www.googleapis.com/auth/blogger.readonly"
],
"Oauth2c": [
"https://www.googleapis.com/auth/blogger.readonly"
]
}
],
"tags": [
"postUserInfos"
]
},
"parameters": [
{
"$ref": "#/components/parameters/_.xgafv"
},
{
"$ref": "#/components/parameters/access_token"
},
{
"$ref": "#/components/parameters/alt"
},
{
"$ref": "#/components/parameters/callback"
},
{
"$ref": "#/components/parameters/fields"
},
{
"$ref": "#/components/parameters/key"
},
{
"$ref": "#/components/parameters/oauth_token"
},
{
"$ref": "#/components/parameters/prettyPrint"
},
{
"$ref": "#/components/parameters/quotaUser"
},
{
"$ref": "#/components/parameters/upload_protocol"
},
{
"$ref": "#/components/parameters/uploadType"
}
]
},
"/v3/users/{userId}/blogs/{blogId}/posts/{postId}": {
"get": {
"description": "Gets one post and user info pair, by post_id and user_id.",
"operationId": "blogger.postUserInfos.get",
"parameters": [
{
"in": "path",
"name": "userId",
"required": true,
"schema": {
"type": "string"
}
},
{
"in": "path",
"name": "blogId",
"required": true,
"schema": {
"type": "string"
}
},
{
"in": "path",
"name": "postId",
"required": true,
"schema": {
"type": "string"
}
},
{
"in": "query",
"name": "maxComments",
"schema": {
"type": "integer"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PostUserInfo"
}
}
},
"description": "Successful response"
}
},
"security": [
{
"Oauth2": [
"https://www.googleapis.com/auth/blogger"
],
"Oauth2c": [
"https://www.googleapis.com/auth/blogger"
]
},
{
"Oauth2": [
"https://www.googleapis.com/auth/blogger.readonly"
],
"Oauth2c": [
"https://www.googleapis.com/auth/blogger.readonly"
]
}
],
"tags": [
"postUserInfos"
]
},
"parameters": [
{
"$ref": "#/components/parameters/_.xgafv"
},
{
"$ref": "#/components/parameters/access_token"
},
{
"$ref": "#/components/parameters/alt"
},
{
"$ref": "#/components/parameters/callback"
},
{
"$ref": "#/components/parameters/fields"
},
{
"$ref": "#/components/parameters/key"
},
{
"$ref": "#/components/parameters/oauth_token"
},
{
"$ref": "#/components/parameters/prettyPrint"
},
{
"$ref": "#/components/parameters/quotaUser"
},
{
"$ref": "#/components/parameters/upload_protocol"
},
{
"$ref": "#/components/parameters/uploadType"
}
]
}
},
"components": {
"parameters": {
"_.xgafv": {
"description": "V1 error format.",
"in": "query",
"name": "$.xgafv",
"schema": {
"enum": [
"1",
"2"
],
"type": "string"
}
},
"access_token": {
"description": "OAuth access token.",
"in": "query",
"name": "access_token",
"schema": {
"type": "string"
}
},
"alt": {
"description": "Data format for response.",
"in": "query",
"name": "alt",
"schema": {
"enum": [
"json",
"media",
"proto"
],
"type": "string"
}
},
"callback": {
"description": "JSONP",
"in": "query",
"name": "callback",
"schema": {
"type": "string"
}
},
"fields": {
"description": "Selector specifying which fields to include in a partial response.",
"in": "query",
"name": "fields",
"schema": {
"type": "string"
}
},
"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.",
"in": "query",
"name": "key",
"schema": {
"type": "string"
}
},
"oauth_token": {
"description": "OAuth 2.0 token for the current user.",
"in": "query",
"name": "oauth_token",
"schema": {
"type": "string"
}
},
"prettyPrint": {
"description": "Returns response with indentations and line breaks.",
"in": "query",
"name": "prettyPrint",
"schema": {
"type": "boolean"
}
},
"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.",
"in": "query",
"name": "quotaUser",
"schema": {
"type": "string"
}
},
"uploadType": {
"description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").",
"in": "query",
"name": "uploadType",
"schema": {
"type": "string"
}
},
"upload_protocol": {
"description": "Upload protocol for media (e.g. \"raw\", \"multipart\").",
"in": "query",
"name": "upload_protocol",
"schema": {
"type": "string"
}
}
},
"schemas": {
"Blog": {
"properties": {
"customMetaData": {
"description": "The JSON custom meta-data for the Blog.",
"type": "string"
},
"description": {
"description": "The description of this blog. This is displayed underneath the title.",
"type": "string"
},
"id": {
"description": "The identifier for this resource.",
"type": "string"
},
"kind": {
"description": "The kind of this entry. Always blogger#blog.",
"type": "string"
},
"locale": {
"description": "The locale this Blog is set to.",
"properties": {
"country": {
"description": "The country this blog's locale is set to.",
"type": "string"
},
"language": {
"description": "The language this blog is authored in.",
"type": "string"
},
"variant": {
"description": "The language variant this blog is authored in.",
"type": "string"
}
},
"type": "object"
},
"name": {
"description": "The name of this blog. This is displayed as the title.",
"type": "string"
},
"pages": {
"description": "The container of pages in this blog.",
"properties": {
"selfLink": {
"description": "The URL of the container for pages in this blog.",
"type": "string"
},
"totalItems": {
"description": "The count of pages in this blog.",
"format": "int32",
"type": "integer"
}
},
"type": "object"
},
"posts": {
"description": "The container of posts in this blog.",
"properties": {
"items": {
"description": "The List of Posts for this Blog.",
"items": {
"$ref": "#/components/schemas/Post"
},
"type": "array"
},
"selfLink": {
"description": "The URL of the container for posts in this blog.",
"type": "string"
},
"totalItems": {
"description": "The count of posts in this blog.",
"format": "int32",
"type": "integer"
}
},
"type": "object"
},
"published": {
"description": "RFC 3339 date-time when this blog was published.",
"type": "string"
},
"selfLink": {
"description": "The API REST URL to fetch this resource from.",
"type": "string"
},
"status": {
"description": "The status of the blog.",
"enum": [
"LIVE",
"DELETED"
],
"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"
}
},
"type": "object"
},
"BlogList": {
"properties": {
"blogUserInfos": {
"description": "Admin level list of blog per-user information.",
"items": {
"$ref": "#/components/schemas/BlogUserInfo"
},
"type": "array"
},
"items": {
"description": "The list of Blogs this user has Authorship or Admin rights over.",
"items": {
"$ref": "#/components/schemas/Blog"
},
"type": "array"
},
"kind": {
"description": "The kind of this entity. Always blogger#blogList.",
"type": "string"
}
},
"type": "object"
},
"BlogPerUserInfo": {
"properties": {
"blogId": {
"description": "ID of the Blog resource.",
"type": "string"
},
"hasAdminAccess": {
"description": "True if the user has Admin level access to the blog.",
"type": "boolean"
},
"kind": {
"description": "The kind of this entity. Always blogger#blogPerUserInfo.",
"type": "string"
},
"photosAlbumKey": {
"description": "The Photo Album Key for the user when adding photos to the blog.",
"type": "string"
},
"role": {
"description": "Access permissions that the user has for the blog (ADMIN, AUTHOR, or READER).",
"enum": [
"VIEW_TYPE_UNSPECIFIED",
"READER",
"AUTHOR",
"ADMIN"
],
"type": "string"
},
"userId": {
"description": "ID of the User.",
"type": "string"
}
},
"type": "object"
},
"BlogUserInfo": {
"properties": {
"blog": {
"$ref": "#/components/schemas/Blog",
"description": "The Blog resource."
},
"blog_user_info": {
"$ref": "#/components/schemas/BlogPerUserInfo",
"description": "Information about a User for the Blog."
},
"kind": {
"description": "The kind of this entity. Always blogger#blogUserInfo.",
"type": "string"
}
},
"type": "object"
},
"Comment": {
"properties": {
"author": {
"description": "The author of this Comment.",
"properties": {
"displayName": {
"description": "The display name.",
"type": "string"
},
"id": {
"description": "The identifier of the creator.",
"type": "string"
},
"image": {
"description": "The creator's avatar.",
"properties": {
"url": {
"description": "The creator's avatar URL.",
"type": "string"
}
},
"type": "object"
},
"url": {
"description": "The URL of the creator's Profile page.",
"type": "string"
}
},
"type": "object"
},
"blog": {
"description": "Data about the blog containing this comment.",
"properties": {
"id": {
"description": "The identifier of the blog containing this comment.",
"type": "string"
}
},
"type": "object"
},
"content": {
"description": "The actual content of the comment. May include HTML markup.",
"type": "string"
},
"id": {
"description": "The identifier for this resource.",
"type": "string"
},
"inReplyTo": {
"description": "Data about the comment this is in reply to.",
"properties": {
"id": {
"description": "The identified of the parent of this comment.",
"type": "string"
}
},
"type": "object"
},
"kind": {
"description": "The kind of this entry. Always blogger#comment.",
"type": "string"
},
"post": {
"description": "Data about the post containing this comment.",
"properties": {
"id": {
"description": "The identifier of the post containing this comment.",
"type": "string"
}
},
"type": "object"
},
"published": {
"description": "RFC 3339 date-time when this comment was published.",
"type": "string"
},
"selfLink": {
"description": "The API REST URL to fetch this resource from.",
"type": "string"
},
"status": {
"description": "The status of the comment (only populated for admin users).",
"enum": [
"LIVE",
"EMPTIED",
"PENDING",
"SPAM"
],
"type": "string"
},
"updated": {
"description": "RFC 3339 date-time when this comment was last updated.",
"type": "string"
}
},
"type": "object"
},
"CommentList": {
"properties": {
"etag": {
"description": "Etag of the response.",
"type": "string"
},
"items": {
"description": "The List of Comments for a Post.",
"items": {
"$ref": "#/components/schemas/Comment"
},
"type": "array"
},
"kind": {
"description": "The kind of this entry. Always blogger#commentList.",
"type": "string"
},
"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"
}
},
"type": "object"
},
"Page": {
"properties": {
"author": {
"description": "The author of this Page.",
"properties": {
"displayName": {
"description": "The display name.",
"type": "string"
},
"id": {
"description": "The identifier of the creator.",
"type": "string"
},
"image": {
"description": "The creator's avatar.",
"properties": {
"url": {
"description": "The creator's avatar URL.",
"type": "string"
}
},
"type": "object"
},
"url": {
"description": "The URL of the creator's Profile page.",
"type": "string"
}
},
"type": "object"
},
"blog": {
"description": "Data about the blog containing this Page.",
"properties": {
"id": {
"description": "The identifier of the blog containing this page.",
"type": "string"
}
},
"type": "object"
},
"content": {
"description": "The body content of this Page, in HTML.",
"type": "string"
},
"etag": {
"description": "Etag of the resource.",
"type": "string"
},
"id": {
"description": "The identifier for this resource.",
"type": "string"
},
"kind": {
"description": "The kind of this entity. Always blogger#page.",
"type": "string"
},
"published": {
"description": "RFC 3339 date-time when this Page was published.",
"type": "string"
},
"selfLink": {
"description": "The API REST URL to fetch this resource from.",
"type": "string"
},
"status": {
"description": "The status of the page for admin resources (either LIVE or DRAFT).",
"enum": [
"LIVE",
"DRAFT",
"SOFT_TRASHED"
],
"type": "string"
},
"title": {
"description": "The title of this entity. This is the name displayed in the Admin user interface.",
"type": "string"
},
"trashed": {
"description": "RFC 3339 date-time when this Page was trashed.",
"type": "string"
},
"updated": {
"description": "RFC 3339 date-time when this Page was last updated.",
"type": "string"
},
"url": {
"description": "The URL that this Page is displayed at.",
"type": "string"
}
},
"type": "object"
},
"PageList": {
"properties": {
"etag": {
"description": "Etag of the response.",
"type": "string"
},
"items": {
"description": "The list of Pages for a Blog.",
"items": {
"$ref": "#/components/schemas/Page"
},
"type": "array"
},
"kind": {
"description": "The kind of this entity. Always blogger#pageList.",
"type": "string"
},
"nextPageToken": {
"description": "Pagination token to fetch the next page, if one exists.",
"type": "string"
}
},
"type": "object"
},
"Pageviews": {
"properties": {
"blogId": {
"description": "Blog Id.",
"type": "string"
},
"counts": {
"description": "The container of posts in this blog.",
"items": {
"properties": {
"count": {
"description": "Count of page views for the given time range.",
"format": "int64",
"type": "string"
},
"timeRange": {
"description": "Time range the given count applies to.",
"enum": [
"ALL_TIME",
"THIRTY_DAYS",
"SEVEN_DAYS"
],
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"kind": {
"description": "The kind of this entry. Always blogger#page_views.",
"type": "string"
}
},
"type": "object"
},
"Post": {
"properties": {
"author": {
"description": "The author of this Post.",
"properties": {
"displayName": {
"description": "The display name.",
"type": "string"
},
"id": {
"description": "The identifier of the creator.",
"type": "string"
},
"image": {
"description": "The creator's avatar.",
"properties": {
"url": {
"description": "The creator's avatar URL.",
"type": "string"
}
},
"type": "object"
},
"url": {
"description": "The URL of the creator's Profile page.",
"type": "string"
}
},
"type": "object"
},
"blog": {
"description": "Data about the blog containing this Post.",
"properties": {
"id": {
"description": "The identifier of the Blog that contains this Post.",
"type": "string"
}
},
"type": "object"
},
"content": {
"description": "The content of the Post. May contain HTML markup.",
"type": "string"
},
"customMetaData": {
"description": "The JSON meta-data for the Post.",
"type": "string"
},
"etag": {
"description": "Etag of the resource.",
"type": "string"
},
"id": {
"description": "The identifier of this Post.",
"type": "string"
},
"images": {
"description": "Display image for the Post.",
"items": {
"properties": {
"url": {
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"kind": {
"description": "The kind of this entity. Always blogger#post.",
"type": "string"
},
"labels": {
"description": "The list of labels this Post was tagged with.",
"items": {
"type": "string"
},
"type": "array"
},
"location": {
"description": "The location for geotagged posts.",
"properties": {
"lat": {
"description": "Location's latitude.",
"format": "double",
"type": "number"
},
"lng": {
"description": "Location's longitude.",
"format": "double",
"type": "number"
},
"name": {
"description": "Location name.",
"type": "string"
},
"span": {
"description": "Location's viewport span. Can be used when rendering a map preview.",
"type": "string"
}
},
"type": "object"
},
"published": {
"description": "RFC 3339 date-time when this Post was published.",
"type": "string"
},
"readerComments": {
"description": "Comment control and display setting for readers of this post.",
"enum": [
"ALLOW",
"DONT_ALLOW_SHOW_EXISTING",
"DONT_ALLOW_HIDE_EXISTING"
],
"type": "string"
},
"replies": {
"description": "The container of comments on this Post.",
"properties": {
"items": {
"description": "The List of Comments for this Post.",
"items": {
"$ref": "#/components/schemas/Comment"
},
"type": "array"
},
"selfLink": {
"description": "The URL of the comments on this post.",
"type": "string"
},
"totalItems": {
"description": "The count of comments on this post.",
"format": "int64",
"type": "string"
}
},
"type": "object"
},
"selfLink": {
"description": "The API REST URL to fetch this resource from.",
"type": "string"
},
"status": {
"description": "Status of the post. Only set for admin-level requests.",
"enum": [
"LIVE",
"DRAFT",
"SCHEDULED",
"SOFT_TRASHED"
],
"type": "string"
},
"title": {
"description": "The title of the Post.",
"type": "string"
},
"titleLink": {
"description": "The title link URL, similar to atom's related link.",
"type": "string"
},
"trashed": {
"description": "RFC 3339 date-time when this Post was last trashed.",
"type": "string"
},
"updated": {
"description": "RFC 3339 date-time when this Post was last updated.",
"type": "string"
},
"url": {
"description": "The URL where this Post is displayed.",
"type": "string"
}
},
"type": "object"
},
"PostList": {
"properties": {
"etag": {
"description": "Etag of the response.",
"type": "string"
},
"items": {
"description": "The list of Posts for this Blog.",
"items": {
"$ref": "#/components/schemas/Post"
},
"type": "array"
},
"kind": {
"description": "The kind of this entity. Always blogger#postList.",
"type": "string"
},
"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"
}
},
"type": "object"
},
"PostPerUserInfo": {
"properties": {
"blogId": {
"description": "ID of the Blog that the post resource belongs to.",
"type": "string"
},
"hasEditAccess": {
"description": "True if the user has Author level access to the post.",
"type": "boolean"
},
"kind": {
"description": "The kind of this entity. Always blogger#postPerUserInfo.",
"type": "string"
},
"postId": {
"description": "ID of the Post resource.",
"type": "string"
},
"userId": {
"description": "ID of the User.",
"type": "string"
}
},
"type": "object"
},
"PostUserInfo": {
"properties": {
"kind": {
"description": "The kind of this entity. Always blogger#postUserInfo.",
"type": "string"
},
"post": {
"$ref": "#/components/schemas/Post",
"description": "The Post resource."
},
"post_user_info": {
"$ref": "#/components/schemas/PostPerUserInfo",
"description": "Information about a User for the Post."
}
},
"type": "object"
},
"PostUserInfosList": {
"properties": {
"items": {
"description": "The list of Posts with User information for the post, for this Blog.",
"items": {
"$ref": "#/components/schemas/PostUserInfo"
},
"type": "array"
},
"kind": {
"description": "The kind of this entity. Always blogger#postList.",
"type": "string"
},
"nextPageToken": {
"description": "Pagination token to fetch the next page, if one exists.",
"type": "string"
}
},
"type": "object"
},
"User": {
"properties": {
"about": {
"description": "Profile summary information.",
"type": "string"
},
"blogs": {
"description": "The container of blogs for this user.",
"properties": {
"selfLink": {
"description": "The URL of the Blogs for this user.",
"type": "string"
}
},
"type": "object"
},
"created": {
"description": "The timestamp of when this profile was created, in seconds since epoch.",
"type": "string"
},
"displayName": {
"description": "The display name.",
"type": "string"
},
"id": {
"description": "The identifier for this User.",
"type": "string"
},
"kind": {
"description": "The kind of this entity. Always blogger#user.",
"type": "string"
},
"locale": {
"description": "This user's locale",
"properties": {
"country": {
"description": "The country this blog's locale is set to.",
"type": "string"
},
"language": {
"description": "The language this blog is authored in.",
"type": "string"
},
"variant": {
"description": "The language variant this blog is authored in.",
"type": "string"
}
},
"type": "object"
},
"selfLink": {
"description": "The API REST URL to fetch this resource from.",
"type": "string"
},
"url": {
"description": "The user's profile page.",
"type": "string"
}
},
"type": "object"
}
},
"securitySchemes": {
"Oauth2": {
"description": "Oauth 2.0 implicit authentication",
"flows": {
"implicit": {
"authorizationUrl": "https://accounts.google.com/o/oauth2/auth",
"scopes": {
"https://www.googleapis.com/auth/blogger": "Manage your Blogger account",
"https://www.googleapis.com/auth/blogger.readonly": "View your Blogger account"
}
}
},
"type": "oauth2"
},
"Oauth2c": {
"description": "Oauth 2.0 authorizationCode authentication",
"flows": {
"authorizationCode": {
"authorizationUrl": "https://accounts.google.com/o/oauth2/auth",
"scopes": {
"https://www.googleapis.com/auth/blogger": "Manage your Blogger account",
"https://www.googleapis.com/auth/blogger.readonly": "View your Blogger account"
},
"tokenUrl": "https://accounts.google.com/o/oauth2/token"
}
},
"type": "oauth2"
}
}
}
}