帖子

帖子资源包含博文的 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
搜索与指定查询字词匹配的博文。
插入
添加帖子。
delete
按 ID 删除帖子。
getByPath
按路径检索帖子。
补丁程序
更新帖子。此方法支持补丁语义
update
更新帖子。
publish
发布博文草稿。
revert
将已发布或定时发布的帖子还原为草稿状态,从而将帖子从公开发布的内容中移除。