貼文

文章資源包含網誌文章的 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
擷取訊息清單。
取得
依貼文 ID 擷取貼文。
search
搜尋符合指定查詢字詞的貼文。
插入
新增訊息。
刪除
依 ID 刪除貼文。
getByPath
依路徑擷取貼文。
修補程式
更新貼文。這個方法支援修補語意。
更新
更新貼文。
publish
發布草稿訊息。
revert
將已發布或已排定發布的文章還原為草稿狀態，這項操作會將貼文從公開顯示的內容中移除。