帖子

博文资源包含博文的 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
    }
  ],
  "customMetaData": 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 标记了此帖子的标签列表。
customMetaData string 博文的 JSON 元数据。
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
添加帖子。
删除
按 ID 删除帖子。
getByPath
按路径检索博文。
patch
更新帖子。此方法支持补丁语义
update
更新帖子。
publish
发布博文草稿。
revert
将已发布或计划发布的帖子还原为草稿状态,这会从可公开查看的内容中移除帖子。