貼文

文章資源包含網誌文章的 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
:搜尋與指定查詢字詞相符的貼文。
插入
新增貼文。
刪除
依 ID 刪除貼文。
getByPath
依路徑擷取貼文。
patch
更新貼文。這個方法支援patch 語意
update
更新貼文。
發布
發布草稿文章。
revert
將已發布或排定的貼文還原為草稿狀態,即可從公開可見的內容中移除貼文。