API 參考資料

本 API 參考資料是依照資源類型編排。各個資源類型都具有一或多種資料表示法,以及一或多種方法。

資源類型

  1. 網誌
  2. 留言
  3. 頁面
  4. 訊息
  5. 使用者
  6. blogUserInfos
  7. PageViews
  8. PostUserInfos

網誌

如需網誌資源詳細資料,請參閱資源表示法網頁。

方法 HTTP 要求 說明
除非另有註明,否則相對於 https://www.googleapis.com/blogger/v3 的 URI
get GET  /blogs/blogId 依 ID 擷取網誌。
getByUrl GET  /blogs/byurl 透過網址擷取網誌。
listByUser GET  /users/userId/blogs 擷取網誌清單。

評論

如需註解資源的詳細資料,請參閱資源表示法

方法 HTTP 要求 說明
除非另有註明,否則相對於 https://www.googleapis.com/blogger/v3 的 URI
清單 GET  /blogs/blogId/posts/postId/comments 擷取貼文留言清單。
get GET  /blogs/blogId/posts/postId/comments/commentId 依據其 commentId 擷取單一評論資源。
核准 POST  /blogs/blogId/posts/postId/comments/commentId/approve 將留言標示為非垃圾內容。
刪除 DELETE  /blogs/blogId/posts/postId/comments/commentId 按 ID 刪除留言。
listByblog GET  /blogs/blogId/comments 擷取所有留言 (可能經過篩選的網誌) 留言。
markAsSpam POST  /blogs/blogId/posts/postId/comments/commentId/spam 將留言標示為垃圾內容。這會將註解的狀態設為 spam,並將該註解以預設註解轉譯方式隱藏。
removeContent (移除內容) POST  /blogs/blogId/posts/postId/comments/commentId/removecontent 移除留言內容。

網頁

如需「頁面資源」的詳細資料,請參閱資源表示法網頁。

方法 HTTP 要求 說明
除非另有註明,否則相對於 https://www.googleapis.com/blogger/v3 的 URI
清單 GET  /blogs/blogId/pages 擷取網誌網頁清單。
get GET  /blogs/blogId/pages/pageId 依網頁 ID 擷取單一網頁資源。
刪除 DELETE  /blogs/blogId/pages/pageId 根據 ID 刪除網頁。
insert POST  /blogs/blogId/pages 新增頁面。
patch PATCH  /blogs/blogId/pages/pageId 請更新專頁。這個方法支援修補語意。
update PUT  /blogs/blogId/pages/pageId 更新網頁。

訊息

如需貼文資源的詳細資料,請參閱資源表示法網頁。

方法 HTTP 要求 說明
除非另有註明,否則相對於 https://www.googleapis.com/blogger/v3 的 URI
清單 GET  /blogs/blogId/posts 擷取文章清單。
get GET  /blogs/blogId/posts/postId 根據文章 ID 擷取一則訊息。
搜尋 GET  /blogs/blogId/posts/search 搜尋與指定查詢字詞相符的貼文。
insert POST  /blogs/blogId/posts 新增訊息。
刪除 DELETE  /blogs/blogId/posts/postId 依 ID 刪除訊息。
getByPath GET  /blogs/blogId/posts/bypath 根據路徑擷取貼文。
patch PATCH  /blogs/blogId/posts/postId 更新訊息。這個方法支援修補語意
update PUT  /blogs/blogId/posts/postId 更新訊息內容。
發布 POST  /blogs/blogId/posts/postId/publish 發布草稿。
返回 POST  /blogs/blogId/posts/postId/revert 將已發布的貼文或已排定的貼文還原為草稿狀態,這會將訊息從公開顯示的內容中移除。

使用者

如要進一步瞭解使用者資源,請參閱資源表示法網頁。

方法 HTTP 要求 說明
除非另有註明,否則相對於 https://www.googleapis.com/blogger/v3 的 URI
get GET  /users/userId 根據使用者 ID 擷取使用者。

網誌使用者資訊

如需 BlogUserInfos 資源的詳細資料,請參閱資源表示法網頁。

方法 HTTP 要求 說明
除非另有註明,否則相對於 https://www.googleapis.com/blogger/v3 的 URI
get GET  /users/userId/blogs/blogId 依據 blogIduserId 取得一個網誌和使用者資訊組合。

網頁瀏覽次數

如需 PageViews 資源的詳細資料,請參閱資源表示法網頁。

方法 HTTP 要求 說明
除非另有註明,否則相對於 https://www.googleapis.com/blogger/v3 的 URI
get GET  /blogs/blogId/pageviews 擷取網誌的瀏覽量統計資料。

PostUserInfos

如需 PostUserInfos 資源的詳細資料,請參閱資源表示法網頁。

方法 HTTP 要求 說明
除非另有註明,否則相對於 https://www.googleapis.com/blogger/v3 的 URI
get GET  /users/userId/blogs/blogId/posts/postId 取得 postIduserId 的 1 則訊息和使用者資訊配對。
清單 GET  /users/userId/blogs/blogId/posts 擷取訊息及訊息使用者資訊組合清單 (可能經過篩選)。訊息的使用者資訊包含每位使用者的訊息資訊,例如使用者的存取權限。