API 参考文档

此 API 参考资料按资源类型编排整理。每种资源类型都有一种或多种数据表示形式以及一个或多个方法。

资源类型

1. 博客
2. 备注
3. 页面
4. 帖子
5. 用户
6. BlogUserInfos
7. 网页浏览
8. PostUserInfos

博客

如需详细了解 Blogs 资源，请参阅资源表示形式页面。

方法	HTTP 请求	说明
除非另有说明，否则将使用相对于 https://www.googleapis.com/blogger/v3 的 URI
get	GET  /blogs/blogId	根据博客 ID 检索博客。
getByUrl	GET  /blogs/byurl	根据网址检索博客。
listByUser	GET  /users/userId/blogs	检索博客列表。

备注

如需详细了解“评论”资源，请参阅资源表示形式页面。

方法	HTTP 请求	说明
除非另有说明，否则将使用相对于 https://www.googleapis.com/blogger/v3 的 URI
list	GET  /blogs/blogId/posts/postId/comments	检索帖子的评论列表。
get	GET  /blogs/blogId/posts/postId/comments/commentId	根据评论的 commentId 检索一条评论资源。
批准	POST  /blogs/blogId/posts/postId/comments/commentId/approve	将评论标记为非垃圾评论。
delete	DELETE  /blogs/blogId/posts/postId/comments/commentId	按 ID 删除评论。
listByBlog	GET  /blogs/blogId/comments	检索博客的所有帖子评论，可能是过滤后的。
markAsSpam	POST  /blogs/blogId/posts/postId/comments/commentId/spam	将评论标记为垃圾评论。这会将评论的状态设置为 spam，并在默认的评论呈现中将其隐藏。
removeContent	POST  /blogs/blogId/posts/postId/comments/commentId/removecontent	移除评论的内容。

页面

如需详细了解 Pages 资源，请参阅资源表示形式页面。

方法	HTTP 请求	说明
除非另有说明，否则将使用相对于 https://www.googleapis.com/blogger/v3 的 URI
list	GET  /blogs/blogId/pages	检索某个博客的页面列表。
get	GET  /blogs/blogId/pages/pageId	根据页面 ID 检索一个页面资源。
delete	DELETE  /blogs/blogId/pages/pageId	按 ID 删除页面。
插入	POST  /blogs/blogId/pages	添加页面。
补丁	PATCH  /blogs/blogId/pages/pageId	更新页面。此方法支持补丁语义。
update	PUT  /blogs/blogId/pages/pageId	更新页面。

帖子

如需详细了解“帖子”资源，请参阅资源表示形式页面。

方法	HTTP 请求	说明
除非另有说明，否则将使用相对于 https://www.googleapis.com/blogger/v3 的 URI
list	GET  /blogs/blogId/posts	检索博文列表。
get	GET  /blogs/blogId/posts/postId	根据帖子 ID 检索一个帖子。
搜索	GET  /blogs/blogId/posts/search	搜索与给定查询字词匹配的帖子。
插入	POST  /blogs/blogId/posts	添加帖子。
delete	DELETE  /blogs/blogId/posts/postId	按 ID 删除帖子。
getByPath	GET  /blogs/blogId/posts/bypath	按路径检索博文。
补丁	PATCH  /blogs/blogId/posts/postId	更新帖子。此方法支持补丁语义。
update	PUT  /blogs/blogId/posts/postId	更新帖子。
publish	POST  /blogs/blogId/posts/postId/publish	发布博文草稿。
revert	POST  /blogs/blogId/posts/postId/revert	将已发布或计划发布的博文还原为草稿状态，这会从可公开查看的内容中移除相应博文。

用户

如需详细了解用户资源，请参阅资源表示形式页面。

方法	HTTP 请求	说明
除非另有说明，否则将使用相对于 https://www.googleapis.com/blogger/v3 的 URI
get	GET  /users/userId	根据用户 ID 检索用户。

BlogUserInfos

如需详细了解 BlogUserInfos 资源，请参阅资源表示形式页面。

方法	HTTP 请求	说明
除非另有说明，否则将使用相对于 https://www.googleapis.com/blogger/v3 的 URI
get	GET  /users/userId/blogs/blogId	通过 blogId 和 userId 获取一个博客和用户信息对。

PageViews

如需详细了解 PageViews 资源，请参阅资源表示形式页面。

方法	HTTP 请求	说明
除非另有说明，否则将使用相对于 https://www.googleapis.com/blogger/v3 的 URI
get	GET  /blogs/blogId/pageviews	检索博客的网页浏览统计信息。

PostUserInfos

如需详细了解 PostUserInfos 资源，请参阅资源表示形式页面。

方法	HTTP 请求	说明
除非另有说明，否则将使用相对于 https://www.googleapis.com/blogger/v3 的 URI
get	GET  /users/userId/blogs/blogId/posts/postId	通过 postId 和 userId 获取一个帖子和用户信息对。
list	GET  /users/userId/blogs/blogId/posts	检索帖子和帖子用户信息对列表，可能是过滤后的。帖子用户信息包含特定于该帖子的每个用户信息，例如访问权限等。