訊息

文章資源包含網誌文章的 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
}
資源名稱 說明 Notes
kind string 這個實體的種類。一律為 blogger#post
id string 這則訊息的 ID。
blog object 含有這篇文章的網誌相關資料。
blog.id string 包含此文章的網誌編號。
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
擷取文章清單。
取得
根據訊息 ID 擷取一則訊息。
search
搜尋與指定查詢字詞相符的貼文。
插入
新增貼文。
刪除
依 ID 刪除訊息。
getByPath
按照路徑擷取訊息。
修補
更新訊息。這個方法支援修補語意
更新
更新訊息。
發布
發布訊息草稿。
返回
將已發布的訊息或已排定的貼文還原為草稿狀態,讓訊息從公開可見的內容中移除。