需要授权
检索帖子和帖子用户信息对的列表,该列表可能经过了过滤。帖子用户信息包含与帖子相关的每位用户的信息,例如特定于用户的访问权限。立即试用。
请求
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 。
可接受的值:
|
pageToken |
string |
用于对大型结果集进行分页的接续令牌。如需获取下一页结果,请将此参数设置为上一个响应中的“nextPageToken”值。 |
startDate |
datetime |
要提取的最早发布日期,采用 RFC 3339 格式的日期时间。 |
status |
string |
可接受的值包括:
|
view |
string |
可接受的值包括:
|
授权
此请求需要获得以下至少一个范围的授权(详细了解身份验证和授权)。
范围 |
---|
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 对实际数据调用此方法,然后查看响应。