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 检索帖子和帖子用户信息对列表，可能是过滤后的。帖子用户信息包含特定于该帖子的每个用户信息，例如访问权限等。