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 对实际数据调用此方法,然后查看响应。