帖子

帖子资源包含博文的 HTML 内容以及帖子元数据。

有关此类资源的方法列表，请参阅本页面的结尾部分。

资源表示法

{
  "kind": "blogger#post",
  "id": string,
  "blog": {
    "id": string
  },
  "published": datetime,
  "updated": datetime,
  "url": string,
  "selfLink": string,
  "title": string,
  "titleLink": string,
  "content": string,
  "images": [
    {
      "url": string
    }
  ],
  "author": {
    "id": string,
    "displayName": string,
    "url": string,
    "image": {
      "url": string
    }
  },
  "replies": {
    "totalItems": long,
    "selfLink": string,
    "items": [
      comments Resource
    ]
  },
  "labels": [
    string
  ],
  "location": {
    "name": string,
    "lat": double,
    "lng": double,
    "span": string
  },
  "status": string
}
属性名称 值 说明 备注
kind string 此实体的种类。始终为 blogger#post。
id string 此帖子的 ID。
blog object 包含此帖子的博客的相关数据。
blog.id string 包含此帖子的博客的 ID。
published datetime RFC 3339 date-time 此博文发布的时间。
updated datetime RFC 3339 date-time 此帖子上次更新的时间。
url string 显示此帖子的网址。
title string 帖子的标题。
content string 帖子的内容。可以包含 HTML 标记。
author object 此帖子的作者。
author.id string 帖子创建者的 ID。
author.displayName string 帖子创作者的显示名称。
author.url string 帖子创作者的个人资料页面的网址。
author.image object 帖子创作者的头像。
author.image.url string 帖子创作者的头像网址。
replies object 此帖子的评论容器。
replies.totalItems long 此帖子的评论总数。
labels[] list 此帖子添加的标签列表。
replies.items[] list 此帖子的评论列表。
location object 位置信息（如果此帖子添加了地理位置标记）。
location.name string 营业地点名称。
location.lat double 相应位置的纬度。
location.lng double 相应位置的经度。
location.span string 营业地点的视口跨度。可用于渲染地图预览。
images[] list 显示帖子的图片。
images[].url string
status string 帖子的状态。仅针对管理员级请求设置

方法

您可以使用 list 方法检索博客的帖子列表，并使用 get 方法检索单个帖子。 

list
检索帖子列表。
get
根据帖子 ID 检索一条帖子。
search
搜索与给定查询字词匹配的帖子。
insert
添加帖子。
delete
根据 ID 删除帖子。
getByPath
按路径检索帖子。
patch
更新帖子。此方法支持修补语义。
update
更新帖子。
publish
发布草稿博文。
revert
将已发布或已安排发布的帖子还原为草稿状态，这会将帖子从公开可见的内容中移除。