openapi-directory/api/googleapis.com/blogger.json

Building & bundling https://github.com/APIs-guru/openapi-directory for easy use from JS

{"openapi":"3.0.0","info":{"contact":{"name":"Google","url":"https://google.com"},"description":"API for access to the data within Blogger.","title":"Blogger","version":"v3","x-apiClientRegistration":{"url":"https://console.developers.google.com"},"x-apisguru-categories":["social"],"x-logo":{"url":"https://www.gstatic.com/images/icons/material/product/2x/blogger_64dp.png"},"x-origin":[{"converter":{"url":"https://github.com/lucybot/api-spec-converter","version":"2.7.18"},"format":"google","url":"https://www.googleapis.com/discovery/v1/apis/blogger/v3/rest","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":"blogUserInfos"},{"name":"blogs"},{"name":"comments"},{"name":"pageViews"},{"name":"pages"},{"name":"postUserInfos"},{"name":"posts"},{"name":"users"}],"paths":{"/blogs/byurl":{"get":{"description":"Retrieve a Blog by URL.","operationId":"blogger.blogs.getByUrl","parameters":[{"description":"The URL of the blog to retrieve.","in":"query","name":"url","required":true,"schema":{"type":"string"}},{"description":"Access level with which to view the blog. Note that some fields require elevated access.","in":"query","name":"view","schema":{"type":"string","enum":["ADMIN","AUTHOR","READER"]}}],"responses":{"200":{"description":"Successful response","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Blog"}}}}},"security":[{"Oauth2":["https://www.googleapis.com/auth/blogger"]},{"Oauth2":["https://www.googleapis.com/auth/blogger.readonly"]}],"tags":["blogs"]},"parameters":[{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/userIp"}]},"/blogs/{blogId}":{"get":{"description":"Gets one blog by ID.","operationId":"blogger.blogs.get","parameters":[{"description":"The ID of the blog to get.","in":"path","name":"blogId","required":true,"schema":{"type":"string"}},{"description":"Maximum number of posts to pull back with the blog.","in":"query","name":"maxPosts","schema":{"type":"integer"}},{"description":"Access level with which to view the blog. Note that some fields require elevated access.","in":"query","name":"view","schema":{"type":"string","enum":["ADMIN","AUTHOR","READER"]}}],"responses":{"200":{"description":"Successful response","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Blog"}}}}},"security":[{"Oauth2":["https://www.googleapis.com/auth/blogger"]},{"Oauth2":["https://www.googleapis.com/auth/blogger.readonly"]}],"tags":["blogs"]},"parameters":[{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/userIp"}]},"/blogs/{blogId}/comments":{"get":{"description":"Retrieves the comments for a blog, across all posts, possibly filtered.","operationId":"blogger.comments.listByBlog","parameters":[{"description":"ID of the blog to fetch comments from.","in":"path","name":"blogId","required":true,"schema":{"type":"string"}},{"description":"Latest date of comment to fetch, a date-time with RFC 3339 formatting.","in":"query","name":"endDate","schema":{"type":"string"}},{"description":"Whether the body content of the comments is included.","in":"query","name":"fetchBodies","schema":{"type":"boolean"}},{"description":"Maximum number of comments to include in the result.","in":"query","name":"maxResults","schema":{"type":"integer"}},{"description":"Continuation token if request is paged.","in":"query","name":"pageToken","schema":{"type":"string"}},{"description":"Earliest date of comment to fetch, a date-time with RFC 3339 formatting.","in":"query","name":"startDate","schema":{"type":"string"}},{"in":"query","name":"status","explode":true,"schema":{"type":"array","items":{"enum":["emptied","live","pending","spam"],"type":"string"}}}],"responses":{"200":{"description":"Successful response","content":{"*/*":{"schema":{"$ref":"#/components/schemas/CommentList"}}}}},"security":[{"Oauth2":["https://www.googleapis.com/auth/blogger"]},{"Oauth2":["https://www.googleapis.com/auth/blogger.readonly"]}],"tags":["comments"]},"parameters":[{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/userIp"}]},"/blogs/{blogId}/pages":{"get":{"description":"Retrieves the pages for a blog, optionally including non-LIVE statuses.","operationId":"blogger.pages.list","parameters":[{"description":"ID of the blog to fetch Pages from.","in":"path","name":"blogId","required":true,"schema":{"type":"string"}},{"description":"Whether to retrieve the Page bodies.","in":"query","name":"fetchBodies","schema":{"type":"boolean"}},{"description":"Maximum number of Pages to fetch.","in":"query","name":"maxResults","schema":{"type":"integer"}},{"description":"Continuation token if the request is paged.","in":"query","name":"pageToken","schema":{"type":"string"}},{"in":"query","name":"status","explode":true,"schema":{"type":"array","items":{"enum":["draft","live"],"type":"string"}}},{"description":"Access level with which to view the returned result. Note that some fields require elevated access.","in":"query","name":"view","schema":{"type":"string","enum":["ADMIN","AUTHOR","READER"]}}],"responses":{"200":{"description":"Successful response","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PageList"}}}}},"security":[{"Oauth2":["https://www.googleapis.com/auth/blogger"]},{"Oauth2":["https://www.googleapis.com/auth/blogger.readonly"]}],"tags":["pages"]},"parameters":[{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/userIp"}],"post":{"description":"Add a page.","operationId":"blogger.pages.insert","parameters":[{"description":"ID of the blog to add the page to.","in":"path","name":"blogId","required":true,"schema":{"type":"string"}},{"description":"Whether to create the page as a draft (default: false).","in":"query","name":"isDraft","schema":{"type":"boolean"}}],"requestBody":{"$ref":"#/components/requestBodies/Page"},"responses":{"200":{"description":"Successful response","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Page"}}}}},"security":[{"Oauth2":["https://www.googleapis.com/auth/blogger"]}],"tags":["pages"]}},"/blogs/{blogId}/pages/{pageId}":{"delete":{"description":"Delete a page by ID.","operationId":"blogger.pages.delete","parameters":[{"description":"The ID of the Blog.","in":"path","name":"blogId","required":true,"schema":{"type":"string"}},{"description":"The ID of the Page.","in":"path","name":"pageId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/blogger"]}],"tags":["pages"]},"get":{"description":"Gets one blog page by ID.","operationId":"blogger.pages.get","parameters":[{"description":"ID of the blog containing the page.","in":"path","name":"blogId","required":true,"schema":{"type":"string"}},{"description":"The ID of the page to get.","in":"path","name":"pageId","required":true,"schema":{"type":"string"}},{"in":"query","name":"view","schema":{"type":"string","enum":["ADMIN","AUTHOR","READER"]}}],"responses":{"200":{"description":"Successful response","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Page"}}}}},"security":[{"Oauth2":["https://www.googleapis.com/auth/blogger"]},{"Oauth2":["https://www.googleapis.com/auth/blogger.readonly"]}],"tags":["pages"]},"parameters":[{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/userIp"}],"patch":{"description":"Update a page. This method supports patch semantics.","operationId":"blogger.pages.patch","parameters":[{"description":"The ID of the Blog.","in":"path","name":"blogId","required":true,"schema":{"type":"string"}},{"description":"The ID of the Page.","in":"path","name":"pageId","required":true,"schema":{"type":"string"}},{"description":"Whether a publish action should be performed when the page is updated (default: false).","in":"query","name":"publish","schema":{"type":"boolean"}},{"description":"Whether a revert action should be performed when the page is updated (default: false).","in":"query","name":"revert","schema":{"type":"boolean"}}],"requestBody":{"$ref":"#/components/requestBodies/Page"},"responses":{"200":{"description":"Successful response","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Page"}}}}},"security":[{"Oauth2":["https://www.googleapis.com/auth/blogger"]}],"tags":["pages"]},"put":{"description":"Update a page.","operationId":"blogger.pages.update","parameters":[{"description":"The ID of the Blog.","in":"path","name":"blogId","required":true,"schema":{"type":"string"}},{"description":"The ID of the Page.","in":"path","name":"pageId","required":true,"schema":{"type":"string"}},{"description":"Whether a publish action should be performed when the page is updated (default: false).","in":"query","name":"publish","schema":{"type":"boolean"}},{"description":"Whether a revert action should be performed when the page is updated (default: false).","in":"query","name":"revert","schema":{"type":"boolean"}}],"requestBody":{"$ref":"#/components/requestBodies/Page"},"responses":{"200":{"description":"Successful response","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Page"}}}}},"security":[{"Oauth2":["https://www.googleapis.com/auth/blogger"]}],"tags":["pages"]}},"/blogs/{blogId}/pages/{pageId}/publish":{"parameters":[{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/userIp"}],"post":{"description":"Publishes a draft page.","operationId":"blogger.pages.publish","parameters":[{"description":"The ID of the blog.","in":"path","name":"blogId","required":true,"schema":{"type":"string"}},{"description":"The ID of the page.","in":"path","name":"pageId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Page"}}}}},"security":[{"Oauth2":["https://www.googleapis.com/auth/blogger"]}],"tags":["pages"]}},"/blogs/{blogId}/pages/{pageId}/revert":{"parameters":[{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/userIp"}],"post":{"description":"Revert a published or scheduled page to draft state.","operationId":"blogger.pages.revert","parameters":[{"description":"The ID of the blog.","in":"path","name":"blogId","required":true,"schema":{"type":"string"}},{"description":"The ID of the page.","in":"path","name":"pageId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Page"}}}}},"security":[{"Oauth2":["https://www.googleapis.com/auth/blogger"]}],"tags":["pages"]}},"/blogs/{blogId}/pageviews":{"get":{"description":"Retrieve pageview stats for a Blog.","operationId":"blogger.pageViews.get","parameters":[{"description":"The ID of the blog to get.","in":"path","name":"blogId","required":true,"schema":{"type":"string"}},{"in":"query","name":"range","explode":true,"schema":{"type":"array","items":{"enum":["30DAYS","7DAYS","all"],"type":"string"}}}],"responses":{"200":{"description":"Successful response","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Pageviews"}}}}},"security":[{"Oauth2":["https://www.googleapis.com/auth/blogger"]}],"tags":["pageViews"]},"parameters":[{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/userIp"}]},"/blogs/{blogId}/posts":{"get":{"description":"Retrieves a list of posts, possibly filtered.","operationId":"blogger.posts.list","parameters":[{"description":"ID of the blog to fetch posts from.","in":"path","name":"blogId","required":true,"schema":{"type":"string"}},{"description":"Latest post date to fetch, a date-time with RFC 3339 formatting.","in":"query","name":"endDate","schema":{"type":"string"}},{"description":"Whether the body content of posts is included (default: true). This should be set to false when the post bodies are not required, to help minimize traffic.","in":"query","name":"fetchBodies","schema":{"type":"boolean","default":true}},{"description":"Whether image URL metadata for each post is included.","in":"query","name":"fetchImages","schema":{"type":"boolean"}},{"description":"Comma-separated list of labels to search for.","in":"query","name":"labels","schema":{"type":"string"}},{"description":"Maximum number of posts to fetch.","in":"query","name":"maxResults","schema":{"type":"integer"}},{"description":"Sort search results","in":"query","name":"orderBy","schema":{"type":"string","enum":["published","updated"],"default":"published"}},{"description":"Continuation token if the request is paged.","in":"query","name":"pageToken","schema":{"type":"string"}},{"description":"Earliest post date to fetch, a date-time with RFC 3339 formatting.","in":"query","name":"startDate","schema":{"type":"string"}},{"description":"Statuses to include in the results.","in":"query","name":"status","explode":true,"schema":{"type":"array","items":{"enum":["draft","live","scheduled"],"type":"string"}}},{"description":"Access level with which to view the returned result. Note that some fields require escalated access.","in":"query","name":"view","schema":{"type":"string","enum":["ADMIN","AUTHOR","READER"]}}],"responses":{"200":{"description":"Successful response","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PostList"}}}}},"security":[{"Oauth2":["https://www.googleapis.com/auth/blogger"]},{"Oauth2":["https://www.googleapis.com/auth/blogger.readonly"]}],"tags":["posts"]},"parameters":[{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/userIp"}],"post":{"description":"Add a post.","operationId":"blogger.posts.insert","parameters":[{"description":"ID of the blog to add the post to.","in":"path","name":"blogId","required":true,"schema":{"type":"string"}},{"description":"Whether the body content of the post is included with the result (default: true).","in":"query","name":"fetchBody","schema":{"type":"boolean","default":true}},{"description":"Whether image URL metadata for each post is included in the returned result (default: false).","in":"query","name":"fetchImages","schema":{"type":"boolean"}},{"description":"Whether to create the post as a draft (default: false).","in":"query","name":"isDraft","schema":{"type":"boolean"}}],"requestBody":{"$ref":"#/components/requestBodies/Post"},"responses":{"200":{"description":"Successful response","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Post"}}}}},"security":[{"Oauth2":["https://www.googleapis.com/auth/blogger"]}],"tags":["posts"]}},"/blogs/{blogId}/posts/bypath":{"get":{"description":"Retrieve a Post by Path.","operationId":"blogger.posts.getByPath","parameters":[{"description":"ID of the blog to fetch the post from.","in":"path","name":"blogId","required":true,"schema":{"type":"string"}},{"description":"Maximum number of comments to pull back on a post.","in":"query","name":"maxComments","schema":{"type":"integer"}},{"description":"Path of the Post to retrieve.","in":"query","name":"path","required":true,"schema":{"type":"string"}},{"description":"Access level with which to view the returned result. Note that some fields require elevated access.","in":"query","name":"view","schema":{"type":"string","enum":["ADMIN","AUTHOR","READER"]}}],"responses":{"200":{"description":"Successful response","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Post"}}}}},"security":[{"Oauth2":["https://www.googleapis.com/auth/blogger"]},{"Oauth2":["https://www.googleapis.com/auth/blogger.readonly"]}],"tags":["posts"]},"parameters":[{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/userIp"}]},"/blogs/{blogId}/posts/search":{"get":{"description":"Search for a post.","operationId":"blogger.posts.search","parameters":[{"description":"ID of the blog to fetch the post from.","in":"path","name":"blogId","required":true,"schema":{"type":"string"}},{"description":"Whether the body content of posts is included (default: true). This should be set to false when the post bodies are not required, to help minimize traffic.","in":"query","name":"fetchBodies","schema":{"type":"boolean","default":true}},{"description":"Sort search results","in":"query","name":"orderBy","schema":{"type":"string","enum":["published","updated"],"default":"published"}},{"description":"Query terms to search this blog for matching posts.","in":"query","name":"q","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PostList"}}}}},"security":[{"Oauth2":["https://www.googleapis.com/auth/blogger"]},{"Oauth2":["https://www.googleapis.com/auth/blogger.readonly"]}],"tags":["posts"]},"parameters":[{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/userIp"}]},"/blogs/{blogId}/posts/{postId}":{"delete":{"description":"Delete a post by ID.","operationId":"blogger.posts.delete","parameters":[{"description":"The ID of the Blog.","in":"path","name":"blogId","required":true,"schema":{"type":"string"}},{"description":"The ID of the Post.","in":"path","name":"postId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/blogger"]}],"tags":["posts"]},"get":{"description":"Get a post by ID.","operationId":"blogger.posts.get","parameters":[{"description":"ID of the blog to fetch the post from.","in":"path","name":"blogId","required":true,"schema":{"type":"string"}},{"description":"Whether the body content of the post is included (default: true). This should be set to false when the post bodies are not required, to help minimize traffic.","in":"query","name":"fetchBody","schema":{"type":"boolean","default":true}},{"description":"Whether image URL metadata for each post is included (default: false).","in":"query","name":"fetchImages","schema":{"type":"boolean"}},{"description":"Maximum number of comments to pull back on a post.","in":"query","name":"maxComments","schema":{"type":"integer"}},{"description":"The ID of the post","in":"path","name":"postId","required":true,"schema":{"type":"string"}},{"description":"Access level with which to view the returned result. Note that some fields require elevated access.","in":"query","name":"view","schema":{"type":"string","enum":["ADMIN","AUTHOR","READER"]}}],"responses":{"200":{"description":"Successful response","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Post"}}}}},"security":[{"Oauth2":["https://www.googleapis.com/auth/blogger"]},{"Oauth2":["https://www.googleapis.com/auth/blogger.readonly"]}],"tags":["posts"]},"parameters":[{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/userIp"}],"patch":{"description":"Update a post. This method supports patch semantics.","operationId":"blogger.posts.patch","parameters":[{"description":"The ID of the Blog.","in":"path","name":"blogId","required":true,"schema":{"type":"string"}},{"description":"Whether the body content of the post is included with the result (default: true).","in":"query","name":"fetchBody","schema":{"type":"boolean","default":true}},{"description":"Whether image URL metadata for each post is included in the returned result (default: false).","in":"query","name":"fetchImages","schema":{"type":"boolean"}},{"description":"Maximum number of comments to retrieve with the returned post.","in":"query","name":"maxComments","schema":{"type":"integer"}},{"description":"The ID of the Post.","in":"path","name":"postId","required":true,"schema":{"type":"string"}},{"description":"Whether a publish action should be performed when the post is updated (default: false).","in":"query","name":"publish","schema":{"type":"boolean"}},{"description":"Whether a revert action should be performed when the post is updated (default: false).","in":"query","name":"revert","schema":{"type":"boolean"}}],"requestBody":{"$ref":"#/components/requestBodies/Post"},"responses":{"200":{"description":"Successful response","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Post"}}}}},"security":[{"Oauth2":["https://www.googleapis.com/auth/blogger"]}],"tags":["posts"]},"put":{"description":"Update a post.","operationId":"blogger.posts.update","parameters":[{"description":"The ID of the Blog.","in":"path","name":"blogId","required":true,"schema":{"type":"string"}},{"description":"Whether the body content of the post is included with the result (default: true).","in":"query","name":"fetchBody","schema":{"type":"boolean","default":true}},{"description":"Whether image URL metadata for each post is included in the returned result (default: false).","in":"query","name":"fetchImages","schema":{"type":"boolean"}},{"description":"Maximum number of comments to retrieve with the returned post.","in":"query","name":"maxComments","schema":{"type":"integer"}},{"description":"The ID of the Post.","in":"path","name":"postId","required":true,"schema":{"type":"string"}},{"description":"Whether a publish action should be performed when the post is updated (default: false).","in":"query","name":"publish","schema":{"type":"boolean"}},{"description":"Whether a revert action should be performed when the post is updated (default: false).","in":"query","name":"revert","schema":{"type":"boolean"}}],"requestBody":{"$ref":"#/components/requestBodies/Post"},"responses":{"200":{"description":"Successful response","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Post"}}}}},"security":[{"Oauth2":["https://www.googleapis.com/auth/blogger"]}],"tags":["posts"]}},"/blogs/{blogId}/posts/{postId}/comments":{"get":{"description":"Retrieves the comments for a post, possibly filtered.","operationId":"blogger.comments.list","parameters":[{"description":"ID of the blog to fetch comments from.","in":"path","name":"blogId","required":true,"schema":{"type":"string"}},{"description":"Latest date of comment to fetch, a date-time with RFC 3339 formatting.","in":"query","name":"endDate","schema":{"type":"string"}},{"description":"Whether the body content of the comments is included.","in":"query","name":"fetchBodies","schema":{"type":"boolean"}},{"description":"Maximum number of comments to include in the result.","in":"query","name":"maxResults","schema":{"type":"integer"}},{"description":"Continuation token if request is paged.","in":"query","name":"pageToken","schema":{"type":"string"}},{"description":"ID of the post to fetch posts from.","in":"path","name":"postId","required":true,"schema":{"type":"string"}},{"description":"Earliest date of comment to fetch, a date-time with RFC 3339 formatting.","in":"query","name":"startDate","schema":{"type":"string"}},{"in":"query","name":"status","explode":true,"schema":{"type":"array","items":{"enum":["emptied","live","pending","spam"],"type":"string"}}},{"description":"Access level with which to view the returned result. Note that some fields require elevated access.","in":"query","name":"view","schema":{"type":"string","enum":["ADMIN","AUTHOR","READER"]}}],"responses":{"200":{"description":"Successful response","content":{"*/*":{"schema":{"$ref":"#/components/schemas/CommentList"}}}}},"security":[{"Oauth2":["https://www.googleapis.com/auth/blogger"]},{"Oauth2":["https://www.googleapis.com/auth/blogger.readonly"]}],"tags":["comments"]},"parameters":[{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/userIp"}]},"/blogs/{blogId}/posts/{postId}/comments/{commentId}":{"delete":{"description":"Delete a comment by ID.","operationId":"blogger.comments.delete","parameters":[{"description":"The ID of the Blog.","in":"path","name":"blogId","required":true,"schema":{"type":"string"}},{"description":"The ID of the comment to delete.","in":"path","name":"commentId","required":true,"schema":{"type":"string"}},{"description":"The ID of the Post.","in":"path","name":"postId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/blogger"]}],"tags":["comments"]},"get":{"description":"Gets one comment by ID.","operationId":"blogger.comments.get","parameters":[{"description":"ID of the blog to containing the comment.","in":"path","name":"blogId","required":true,"schema":{"type":"string"}},{"description":"The ID of the comment to get.","in":"path","name":"commentId","required":true,"schema":{"type":"string"}},{"description":"ID of the post to fetch posts from.","in":"path","name":"postId","required":true,"schema":{"type":"string"}},{"description":"Access level for the requested comment (default: READER). Note that some comments will require elevated permissions, for example comments where the parent posts which is in a draft state, or comments that are pending moderation.","in":"query","name":"view","schema":{"type":"string","enum":["ADMIN","AUTHOR","READER"]}}],"responses":{"200":{"description":"Successful response","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Comment"}}}}},"security":[{"Oauth2":["https://www.googleapis.com/auth/blogger"]},{"Oauth2":["https://www.googleapis.com/auth/blogger.readonly"]}],"tags":["comments"]},"parameters":[{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/userIp"}]},"/blogs/{blogId}/posts/{postId}/comments/{commentId}/approve":{"parameters":[{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/userIp"}],"post":{"description":"Marks a comment as not spam.","operationId":"blogger.comments.approve","parameters":[{"description":"The ID of the Blog.","in":"path","name":"blogId","required":true,"schema":{"type":"string"}},{"description":"The ID of the comment to mark as not spam.","in":"path","name":"commentId","required":true,"schema":{"type":"string"}},{"description":"The ID of the Post.","in":"path","name":"postId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Comment"}}}}},"security":[{"Oauth2":["https://www.googleapis.com/auth/blogger"]}],"tags":["comments"]}},"/blogs/{blogId}/posts/{postId}/comments/{commentId}/removecontent":{"parameters":[{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/userIp"}],"post":{"description":"Removes the content of a comment.","operationId":"blogger.comments.removeContent","parameters":[{"description":"The ID of the Blog.","in":"path","name":"blogId","required":true,"schema":{"type":"string"}},{"description":"The ID of the comment to delete content from.","in":"path","name":"commentId","required":true,"schema":{"type":"string"}},{"description":"The ID of the Post.","in":"path","name":"postId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Comment"}}}}},"security":[{"Oauth2":["https://www.googleapis.com/auth/blogger"]}],"tags":["comments"]}},"/blogs/{blogId}/posts/{postId}/comments/{commentId}/spam":{"parameters":[{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/userIp"}],"post":{"description":"Marks a comment as spam.","operationId":"blogger.comments.markAsSpam","parameters":[{"description":"The ID of the Blog.","in":"path","name":"blogId","required":true,"schema":{"type":"string"}},{"description":"The ID of the comment to mark as spam.","in":"path","name":"commentId","required":true,"schema":{"type":"string"}},{"description":"The ID of the Post.","in":"path","name":"postId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Comment"}}}}},"security":[{"Oauth2":["https://www.googleapis.com/auth/blogger"]}],"tags":["comments"]}},"/blogs/{blogId}/posts/{postId}/publish":{"parameters":[{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/userIp"}],"post":{"description":"Publishes a draft post, optionally at the specific time of the given publishDate parameter.","operationId":"blogger.posts.publish","parameters":[{"description":"The ID of the Blog.","in":"path","name":"blogId","required":true,"schema":{"type":"string"}},{"description":"The ID of the Post.","in":"path","name":"postId","required":true,"schema":{"type":"string"}},{"description":"Optional date and time to schedule the publishing of the Blog. If no publishDate parameter is given, the post is either published at the a previously saved schedule date (if present), or the current time. If a future date is given, the post will be scheduled to be published.","in":"query","name":"publishDate","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Post"}}}}},"security":[{"Oauth2":["https://www.googleapis.com/auth/blogger"]}],"tags":["posts"]}},"/blogs/{blogId}/posts/{postId}/revert":{"parameters":[{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/userIp"}],"post":{"description":"Revert a published or scheduled post to draft state.","operationId":"blogger.posts.revert","parameters":[{"description":"The ID of the Blog.","in":"path","name":"blogId","required":true,"schema":{"type":"string"}},{"description":"The ID of the Post.","in":"path","name":"postId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Post"}}}}},"security":[{"Oauth2":["https://www.googleapis.com/auth/blogger"]}],"tags":["posts"]}},"/users/{userId}":{"get":{"description":"Gets one user by ID.","operationId":"blogger.users.get","parameters":[{"description":"The ID of the user to get.","in":"path","name":"userId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"*/*":{"schema":{"$ref":"#/components/schemas/User"}}}}},"security":[{"Oauth2":["https://www.googleapis.com/auth/blogger"]},{"Oauth2":["https://www.googleapis.com/auth/blogger.readonly"]}],"tags":["users"]},"parameters":[{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/userIp"}]},"/users/{userId}/blogs":{"get":{"description":"Retrieves a list of blogs, possibly filtered.","operationId":"blogger.blogs.listByUser","parameters":[{"description":"Whether the response is a list of blogs with per-user information instead of just blogs.","in":"query","name":"fetchUserInfo","schema":{"type":"boolean"}},{"description":"User access types for blogs to include in the results, e.g. AUTHOR will return blogs where the user has author level access. If no roles are specified, defaults to ADMIN and AUTHOR roles.","in":"query","name":"role","explode":true,"schema":{"type":"array","items":{"enum":["ADMIN","AUTHOR","READER"],"type":"string"}}},{"description":"Blog statuses to include in the result (default: Live blogs only). Note that ADMIN access is required to view deleted blogs.","in":"query","name":"status","explode":true,"schema":{"type":"array","items":{"enum":["DELETED","LIVE"],"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.","in":"path","name":"userId","required":true,"schema":{"type":"string"}},{"description":"Access level with which to view the blogs. Note that some fields require elevated access.","in":"query","name":"view","schema":{"type":"string","enum":["ADMIN","AUTHOR","READER"]}}],"responses":{"200":{"description":"Successful response","content":{"*/*":{"schema":{"$ref":"#/components/schemas/BlogList"}}}}},"security":[{"Oauth2":["https://www.googleapis.com/auth/blogger"]},{"Oauth2":["https://www.googleapis.com/auth/blogger.readonly"]}],"tags":["blogs"]},"parameters":[{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/userIp"}]},"/users/{userId}/blogs/{blogId}":{"get":{"description":"Gets one blog and user info pair by blogId and userId.","operationId":"blogger.blogUserInfos.get","parameters":[{"description":"The ID of the blog to get.","in":"path","name":"blogId","required":true,"schema":{"type":"string"}},{"description":"Maximum number of posts to pull back with the blog.","in":"query","name":"maxPosts","schema":{"type":"integer"}},{"description":"ID of the user whose blogs are to be fetched. Either the word 'self' (sans quote marks) or the user's profile identifier.","in":"path","name":"userId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"*/*":{"schema":{"$ref":"#/components/schemas/BlogUserInfo"}}}}},"security":[{"Oauth2":["https://www.googleapis.com/auth/blogger"]},{"Oauth2":["https://www.googleapis.com/auth/blogger.readonly"]}],"tags":["blogUserInfos"]},"parameters":[{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/userIp"}]},"/users/{userId}/blogs/{blogId}/posts":{"get":{"description":"Retrieves a list of post and post user info pairs, possibly filtered. The post user info contains per-user information about the post, such as access rights, specific to the user.","operationId":"blogger.postUserInfos.list","parameters":[{"description":"ID of the blog to fetch posts from.","in":"path","name":"blogId","required":true,"schema":{"type":"string"}},{"description":"Latest post date to fetch, a date-time with RFC 3339 formatting.","in":"query","name":"endDate","schema":{"type":"string"}},{"description":"Whether the body content of posts is included. Default is false.","in":"query","name":"fetchBodies","schema":{"type":"boolean","default":false}},{"description":"Comma-separated list of labels to search for.","in":"query","name":"labels","schema":{"type":"string"}},{"description":"Maximum number of posts to fetch.","in":"query","name":"maxResults","schema":{"type":"integer"}},{"description":"Sort order applied to search results. Default is published.","in":"query","name":"orderBy","schema":{"type":"string","enum":["published","updated"],"default":"published"}},{"description":"Continuation token if the request is paged.","in":"query","name":"pageToken","schema":{"type":"string"}},{"description":"Earliest post date to fetch, a date-time with RFC 3339 formatting.","in":"query","name":"startDate","schema":{"type":"string"}},{"in":"query","name":"status","explode":true,"schema":{"type":"array","items":{"enum":["draft","live","scheduled"],"type":"string"}}},{"description":"ID of the user for the per-user information to be fetched. Either the word 'self' (sans quote marks) or the user's profile identifier.","in":"path","name":"userId","required":true,"schema":{"type":"string"}},{"description":"Access level with which to view the returned result. Note that some fields require elevated access.","in":"query","name":"view","schema":{"type":"string","enum":["ADMIN","AUTHOR","READER"]}}],"responses":{"200":{"description":"Successful response","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PostUserInfosList"}}}}},"security":[{"Oauth2":["https://www.googleapis.com/auth/blogger"]},{"Oauth2":["https://www.googleapis.com/auth/blogger.readonly"]}],"tags":["postUserInfos"]},"parameters":[{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/userIp"}]},"/users/{userId}/blogs/{blogId}/posts/{postId}":{"get":{"description":"Gets one post and user info pair, by post ID and user ID. The post user info contains per-user information about the post, such as access rights, specific to the user.","operationId":"blogger.postUserInfos.get","parameters":[{"description":"The ID of the blog.","in":"path","name":"blogId","required":true,"schema":{"type":"string"}},{"description":"Maximum number of comments to pull back on a post.","in":"query","name":"maxComments","schema":{"type":"integer"}},{"description":"The ID of the post to get.","in":"path","name":"postId","required":true,"schema":{"type":"string"}},{"description":"ID of the user for the per-user information to be fetched. Either the word 'self' (sans quote marks) or the user's profile identifier.","in":"path","name":"userId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PostUserInfo"}}}}},"security":[{"Oauth2":["https://www.googleapis.com/auth/blogger"]},{"Oauth2":["https://www.googleapis.com/auth/blogger.readonly"]}],"tags":["postUserInfos"]},"parameters":[{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/userIp"}]}},"servers":[{"url":"https://www.googleapis.com/blogger/v3"}],"components":{"parameters":{"alt":{"description":"Data format for the response.","in":"query","name":"alt","schema":{"type":"string","enum":["json"],"default":"json"}},"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","default":true}},"quotaUser":{"description":"An opaque string that represents a user for quota purposes. Must not exceed 40 characters.","in":"query","name":"quotaUser","schema":{"type":"string"}},"userIp":{"description":"Deprecated. Please use quotaUser instead.","in":"query","name":"userIp","schema":{"type":"string"}}},"requestBodies":{"Post":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Post"}}}},"Page":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page"}}}}},"securitySchemes":{"Oauth2":{"description":"Oauth 2.0 authentication","type":"oauth2","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"}}}}},"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":{"default":"blogger#blog","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.","format":"date-time","type":"string"},"selfLink":{"description":"The API REST URL to fetch this resource from.","type":"string"},"status":{"description":"The status of the blog.","type":"string"},"updated":{"description":"RFC 3339 date-time when this blog was last updated.","format":"date-time","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":{"default":"blogger#blogList","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":{"default":"blogger#blogPerUserInfo","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).","type":"string"},"userId":{"description":"ID of the User","type":"string"}},"type":"object"},"BlogUserInfo":{"properties":{"blog":{"$ref":"#/components/schemas/Blog"},"blog_user_info":{"$ref":"#/components/schemas/BlogPerUserInfo"},"kind":{"default":"blogger#blogUserInfo","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 Comment creator.","type":"string"},"image":{"description":"The comment creator's avatar.","properties":{"url":{"description":"The comment creator's avatar URL.","type":"string"}},"type":"object"},"url":{"description":"The URL of the Comment 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":{"default":"blogger#comment","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.","format":"date-time","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)","type":"string"},"updated":{"description":"RFC 3339 date-time when this comment was last updated.","format":"date-time","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":{"default":"blogger#commentList","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 Page creator.","type":"string"},"image":{"description":"The page author's avatar.","properties":{"url":{"description":"The page author's avatar URL.","type":"string"}},"type":"object"},"url":{"description":"The URL of the Page 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 conte