API 参考文档

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

资源类型

  1. 博客
  2. 评论
  3. 页面
  4. 帖子
  5. 用户
  6. 博客用户信息
  7. 网页浏览量
  8. PostUserInfos

博客

如需详细了解博客资源,请参阅资源表示形式页面。

方法 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 根据 User-ID 检索用户。

博客用户信息

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

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

网页浏览量

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

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

PostUserInfo

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

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