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