PostUserInfos:list

需要授权

检索帖子和帖子用户信息对列表,可能是过滤后的。帖子用户信息包含特定于该帖子的每个用户信息,例如访问权限等。立即尝试

请求

HTTP 请求

GET https://www.googleapis.com/blogger/v3/users/userId/blogs/blogId/posts

参数

参数名称 价值 说明
必需参数
blogId string 要从中提取帖子的博客的 ID。
userId string 要提取每位用户的信息的用户 ID。可以是“self”(不含引号)一词,也可以是用户的个人资料标识符。
可选参数
endDate datetime 要提取的最新发布日期,即采用 RFC 3339 格式的日期时间。
fetchBodies boolean 是否包含博文的正文内容。默认值为 false。 (默认值:false
labels string 要搜索的标签的列表(以英文逗号分隔)。
maxResults unsigned integer 要获取的帖子数量上限。
orderBy string 对搜索结果应用的排序顺序。默认值为 published

可接受的值包括:
  • published”:按照帖子发布日期排序
  • updated”:按帖子上次更新日期排序
pageToken string 用于对大型结果集进行分页的延续令牌。如需获取下一页结果,请将此参数设置为上一个响应中的“nextPageToken”的值。
startDate datetime 要提取的最早发布日期,即采用 RFC 3339 格式的日期时间。
status string

可接受的值:
  • draft”:博文草稿
  • live”:已发布的博文
  • scheduled”:计划在将来发布的帖子。
view string

可接受的值:
  • ADMIN”:管理员级别详细信息
  • AUTHOR”:作者级别详细信息
  • READER”:读者级别详细信息

授权

此请求需要获得以下至少一个范围的授权(详细了解身份验证和授权)。

范围
https://www.googleapis.com/auth/blogger
https://www.googleapis.com/auth/blogger.readonly

请求正文

使用此方法时请勿提供请求正文。

响应

如果成功,此方法将返回采用以下结构的响应正文:

{
  "kind": "blogger#postUserInfosList",
  "nextPageToken": string,
  "items": [
    postUserInfos Resource
  ]
}
属性名称 价值 说明 备注
kind string 此实体的种类。始终为 blogger#postList
nextPageToken string 用于提取下一页的分页令牌(如果存在)。
items[] list 此博客包含该帖子的用户信息的帖子列表。

试试看!

请使用下面的 API Explorer 针对实际数据调用此方法并查看响应。