API 參考資料

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

資源類型

  1. 網誌
  2. 留言
  3. 頁面
  4. 貼文
  5. 使用者
  6. blogUserInfo
  7. 網頁瀏覽
  8. PostUserInfos

網誌

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

方法 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 移除留言內容。

頁面

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

方法 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 更新頁面。這個方法支援修補語意。
更新 PUT  /blogs/blogId/pages/pageId 更新頁面。

貼文

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

方法 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 更新訊息。這個方法支援修補語意
更新 PUT  /blogs/blogId/posts/postId 更新訊息。
publish POST  /blogs/blogId/posts/postId/publish 發布草稿文章。
revert POST  /blogs/blogId/posts/postId/revert 將已發布或已排定發布的文章還原為草稿狀態,這項操作會將貼文從公開顯示的內容中移除。

使用者

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

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

BlogUserInfos

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

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

PageViews

如要進一步瞭解 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 擷取貼文清單並發布可能經過篩選的使用者資訊組合。貼文使用者資訊包含貼文個別使用者的資訊,例如存取權。