Blogger API:使用 API

Blogger API 可讓您透過 REST API 將 Blogger 內容整合至您的應用程式。開始之前,您必須先設定授權。

引言

這份文件的適用對象為想編寫可與 Blogger API 互動的應用程式的開發人員。Blogger 則可用來建立網站,讓使用者能夠持續發布自己的想法。

如果您還不熟悉 Blogger 概念,請先參閱入門指南,再開始撰寫程式碼。

授權要求並識別您的應用程式

每次將您的應用程式傳送至 Blogger API 的要求,都必須向 Google 指明您的應用程式。找出應用程式的方法有兩種:使用 OAuth 2.0 權杖 (同時授權要求) 和/或使用應用程式的 API 金鑰。下列內容說明如何決定使用的方法:

  • 如果要求需要授權 (例如要求個人私人資料),應用程式就必須提供 OAuth 2.0 權杖和要求。應用程式也可能提供 API 金鑰,但並非必要。
  • 如果要求不需要經過授權 (例如要求公開資料),則應用程式必須為此要求提供 OAuth 2.0 憑證及/或 API 金鑰,視何種方式對您來說比較方便而定。

關於授權通訊協定

您的應用程式必須使用 OAuth 2.0 對要求進行授權,系統不支援其他授權通訊協定。如果您的應用程式採用使用 Google 帳戶登入功能,系統會為您處理部分授權事項。

使用 OAuth 2.0 對要求進行授權

向 Blogger API 提交非公開使用者資料的要求必須由經過驗證的使用者授權。

使用 OAuth 用戶端 ID 可簡化這項程序。

取得 OAuth 用戶端 ID

您也可以在「憑證」頁面建立這類憑證。

OAuth 2.0 授權程序 (或「流程」) 的細節會根據您編寫的應用程式類型而有所不同。下列一般程序適用於所有應用程式類型:

  1. 當應用程式需要存取使用者資料時,會向 Google 要求特定的存取範圍
  2. Google 會向使用者顯示同意畫面,請對方授權您的應用程式要求部分資料。
  3. 如果使用者同意,Google 即會授予短期存取憑證給您的應用程式。
  4. 您的應用程式向使用者要求資料,並且在要求中附上存取憑證。
  5. 如果 Google 判定您的要求與憑證有效,便會傳回您要求的資料。

部分流程包含額外步驟,例如使用「更新憑證」來取得新的存取憑證。如要進一步瞭解各類應用程式的流程,請參閱 Google 的 OAuth 2.0 說明文件

以下是 Blogger API 的 OAuth 2.0 範圍資訊:

https://www.googleapis.com/auth/blogger

如要透過 OAuth 2.0 要求存取權,您的應用程式需要範圍資訊,以及 Google 在您註冊應用程式時提供的資訊 (例如用戶端 ID 和用戶端密碼)。

提示:Google API 用戶端程式庫可以為您處理部分授權程序,且適用於多種程式設計語言;詳情請參閱程式庫和範例頁面

取得及使用 API 金鑰

向 Blogger API 公開資料的要求必須隨附 ID,可以是 API 金鑰存取權杖

取得金鑰

您也可以在「憑證」頁面建立這類憑證。

取得 API 金鑰後,您的應用程式可將查詢參數 key=yourAPIKey 附加至所有要求網址。

API 金鑰可以安全地嵌入網址中,不需任何編碼。

使用網誌

擷取網誌

你可以傳送 HTTP GET 要求至網誌的 URI,藉此擷取特定網誌的資訊。網誌的 URI 格式如下:

https://www.googleapis.com/blogger/v3/blogs/blogId

要求

GET https://www.googleapis.com/blogger/v3/blogs/2399953?key=YOUR-API-KEY

使用者不需要通過驗證,即可擷取公開網誌。應用程式不需要為公開網誌要求加入 Authorization HTTP 標頭,但必須提供 API 金鑰。

Blogger 也設有私人網誌,必須進行驗證。

回應

如果要求成功,伺服器會回應 HTTP 200 OK 狀態碼和網誌資料:

{
  "kind": "blogger#blog",
  "id": "2399953",
  "name": "Blogger Buzz",
  "description": "The Official Buzz from Blogger at Google",
  "published": "2007-04-23T22:17:29.261Z",
  "updated": "2011-08-02T06:01:15.941Z",
  "url": "http://buzz.blogger.com/",
  "selfLink": "https://www.googleapis.com/blogger/v3/blogs/2399953",
  "posts": {
    "totalItems": 494,
    "selfLink": "https://www.googleapis.com/blogger/v3/blogs/2399953/posts"
  },
  "pages": {
    "totalItems": 2,
    "selfLink": "https://www.googleapis.com/blogger/v3/blogs/2399953/pages"
  },
  "locale": {
    "language": "en",
    "country": "",
    "variant": ""
  }
}

透過網址擷取網誌

您可以利用 url 參數將 HTTP GET 要求傳送至下列 URI,藉此擷取該網址的網址:

https://www.googleapis.com/blogger/v3/blogs/byurl?url=blog-url

要求

https://www.googleapis.com/blogger/v3/blogs/byurl?url=http://code.blogger.com/

回應

如果要求成功,伺服器會回應 HTTP 200 OK 狀態碼,以及已識別網誌的完整表示法:

{
 "kind": "blogger#blog",
 "id": "3213900",
 "name": "Blogger Developers Network",
 "description": "The official Blogger Developers Network weblog.",
 "published": "2007-02-09T10:13:10-08:00",
 "updated": "2012-04-15T19:38:01-07:00",
 "url": "http://code.blogger.com/",
 "selfLink": "https://www.googleapis.com/blogger/v3/blogs/3213900",
 "posts": {
  "totalItems": 55,
  "selfLink": "https://www.googleapis.com/blogger/v3/blogs/3213900/posts"
 },
 "pages": {
  "totalItems": 1,
  "selfLink": "https://www.googleapis.com/blogger/v3/blogs/3213900/pages"
 },
 "locale": {
  "language": "en",
  "country": "US",
  "variant": ""
 }
}

擷取使用者的網誌

您可以傳送 HTTP GET 要求至網誌集合 URI,藉此擷取使用者的網誌清單:

https://www.googleapis.com/blogger/v3/users/userId/blogs

要求

GET https://www.googleapis.com/blogger/v3/users/self/blogs
Authorization: /* OAuth 2.0 token here */

注意:使用者必須通過驗證,才能列出自己的網誌,因此您必須使用 GET 要求提供 Authorization HTTP 標頭。

回應

如果要求成功,伺服器會以 HTTP 200 OK 狀態碼回應,以及使用者網誌清單的完整表示法:

{
  "kind": "blogger#blogList",
  "items": [
    {
      "kind": "blogger#blog",
      "id": "4967929378133675647",
      "name": "Brett's Test Blawg",
      "description": "",
      "published": "2010-10-06T23:33:31.662Z",
      "updated": "2011-08-08T06:50:02.005Z",
      "url": "http://brettmorgan-test-blawg.blogspot.com/",
      "selfLink": "https://www.googleapis.com/blogger/v3/blogs/4967929378133675647",
      "posts": {
        "totalItems": 13,
        "selfLink": "https://www.googleapis.com/blogger/v3/blogs/4967929378133675647/posts"
      },
      "pages": {
        "totalItems": 1,
        "selfLink": "https://www.googleapis.com/blogger/v3/blogs/4967929378133675647/pages"
      },
      "locale": {
        "language": "en",
        "country": "",
        "variant": ""
      }
    }
  ]
}

處理貼文

從網誌擷取文章

只要將 GET 要求傳送至文章集合 URI,即可從特定網誌擷取文章清單。貼文集合的 URI 格式如下:

https://www.googleapis.com/blogger/v3/blogs/blogId/posts

要求

範例如下:

GET https://www.googleapis.com/blogger/v3/blogs/2399953/posts?key=YOUR-API-KEY

使用者不需要通過驗證,即可擷取公開網誌。應用程式不需要為公開網誌要求加入 Authorization HTTP 標頭,但必須提供 API 金鑰。

Blogger 也設有私人網誌,必須進行驗證。

回應

如果要求成功,伺服器會回應 HTTP 200 OK 狀態碼和貼文清單:

{
  "kind": "blogger#postList",
  "nextPageToken": "CgkIChiAkceVjiYQ0b2SAQ",
  "items": [
    {
      "kind": "blogger#post",
      "id": "7706273476706534553",
      "blog": {
        "id": "2399953"
      },
      "published": "2011-08-01T19:58:00.000Z",
      "updated": "2011-08-01T19:58:51.947Z",
      "url": "http://buzz.blogger.com/2011/08/latest-updates-august-1st.html",
      "selfLink": "https://www.googleapis.com/blogger/v3/blogs/2399953/posts/7706273476706534553",
      "title": "Latest updates, August 1st",
      "content": "elided for readability",
      "author": {
        "id": "401465483996",
        "displayName": "Brett Wiltshire",
        "url": "http://www.blogger.com/profile/01430672582309320414",
        "image": {
          "url": "http://4.bp.blogspot.com/_YA50adQ-7vQ/S1gfR_6ufpI/AAAAAAAAAAk/1ErJGgRWZDg/S45/brett.png"
         }
      },
      "replies": {
        "totalItems": "0",
        "selfLink": "https://www.googleapis.com/blogger/v3/blogs/2399953/posts/7706273476706534553/comments"
      }
    },
    {
      "kind": "blogger#post",
      "id": "6069922188027612413",
      elided for readability
    }
  ]
}

擷取特定貼文

GET 要求傳送至文章資源 URI,即可從網誌擷取特定文章。貼文資源的 URI 格式如下:

https://www.googleapis.com/blogger/v3/blogs/blogId/posts/postId

要求

GET https://www.googleapis.com/blogger/v3/blogs/2399953/posts/7706273476706534553?key=YOUR-API-KEY

使用者不需要通過驗證,即可擷取公開網誌。應用程式不需要為公開網誌要求加入 Authorization HTTP 標頭,但必須提供 API 金鑰。

Blogger 也設有私人網誌,必須進行驗證。

回應

如果要求成功,伺服器會回應 HTTP 200 OK 狀態碼和貼文內容:

{
  "kind": "blogger#post",
  "id": "7706273476706534553",
  "blog": {
    "id": "2399953"
  },
  "published": "2011-08-01T19:58:00.000Z",
  "updated": "2011-08-01T19:58:51.947Z",
  "url": "http://buzz.blogger.com/2011/08/latest-updates-august-1st.html",
  "selfLink": "https://www.googleapis.com/blogger/v3/blogs/2399953/posts/7706273476706534553",
  "title": "Latest updates, August 1st",
  "content": "elided for readability",
  "author": {
    "id": "401465483996",
    "displayName": "Brett Wiltshire",
    "url": "http://www.blogger.com/profile/01430672582309320414",
    "image": {
      "url": "http://4.bp.blogspot.com/_YA50adQ-7vQ/S1gfR_6ufpI/AAAAAAAAAAk/1ErJGgRWZDg/S45/brett.png"
    }
  },
  "replies": {
    "totalItems": "0",
    "selfLink": "https://www.googleapis.com/blogger/v3/blogs/2399953/posts/7706273476706534553/comments"
  }
}

搜尋訊息

如要搜尋網誌中的文章,請將 GET 要求傳送至 q 搜尋查詢參數至貼文搜尋 URI:

https://www.googleapis.com/blogger/v3/blogs/blogId/posts/search?q=query terms

要求

GET https://www.googleapis.com/blogger/v3/blogs/3213900/posts/search?q=documentation&key=YOUR-API-KEY

使用者不需要通過驗證,即可擷取公開網誌。應用程式不需要為公開網誌要求加入 Authorization HTTP 標頭,但必須提供 API 金鑰。

Blogger 也設有私人網誌,必須進行驗證。

回應

如果要求成功,伺服器會回應 HTTP 200 OK 狀態碼和貼文內容:

{
  "kind": "blogger#postList",
  "nextPageToken": "CgkIChiAj86CpB8QzJTEAQ",
  "items": [
  {
    "kind": "blogger#post",
    "id": "1387873546480002228",
    "blog": {
      "id": "3213900"
    },
    "published": "2012-03-23T01:58:00-07:00",
    "updated": "2012-03-23T01:58:12-07:00",
    "url": "http://code.blogger.com/2012/03/blogger-documentation-has-moved-to.html",
    "selfLink": "https://www.googleapis.com/blogger/v3/blogs/3213900/posts/1387873546480002228",
    "title": "Blogger Documentation has moved to developers.google.com",
    "content": "content elided for readability",
    "author": {
      "id": "16258312240222542576",
      "displayName": "Brett Morgan",
      "url": "http://www.blogger.com/profile/16258312240222542576",
      "image": {
        "url": "https://resources.blogblog.com/img/b16-rounded.gif"
      }
    },
    "replies": {
      "totalItems": "0",
      "selfLink": "https://www.googleapis.com/blogger/v3/blogs/3213900/posts/1387873546480002228/comments"
    }
  },
  ...
  ]
}

新增貼文

你可以將 POST 要求傳送至含有貼文 JSON 主體的貼文集合 URI,藉此新增網誌貼文:

https://www.googleapis.com/blogger/v3/blogs/blogId/posts/

要求

POST https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/
Authorization: /* OAuth 2.0 token here */
Content-Type: application/json

{
  "kind": "blogger#post",
  "blog": {
    "id": "8070105920543249955"
  },
  "title": "A new post",
  "content": "With <b>exciting</b> content..."
}

你必須通過驗證才能建立貼文。

回應

如果要求成功,伺服器會回應 HTTP 200 OK 狀態碼和貼文內容:

{
 "kind": "blogger#post",
 "id": "6819100329896798058",
 "blog": {
  "id": "8070105920543249955"
 },
 "published": "2012-05-20T20:08:00-07:00",
 "updated": "2012-05-20T20:08:35-07:00",
 "url": "http://brettmorgan-test2.blogspot.com/2012/05/new-post.html",
 "selfLink": "https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/6819100329896798058",
 "title": "A new post",
 "content": "With <b>exciting</b> content...",
 "author": {
  "id": "16258312240222542576",
  "displayName": "Brett Morgan",
  "url": "http://www.blogger.com/profile/16258312240222542576",
  "image": {
   "url": "https://resources.blogblog.com/img/b16-rounded.gif"
  }
 },
 "replies": {
  "totalItems": "0",
  "selfLink": "https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/6819100329896798058/comments"
 }
}

刪除訊息

DELETE 要求傳送至文章資源 URI,即可刪除網誌的文章:

https://www.googleapis.com/blogger/v3/blogs/blogId/posts/postId

要求

範例如下:

DELETE https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/6819100329896798058
Authorization: /* OAuth 2.0 token here */

你必須通過驗證才能刪除貼文。

回應

如果要求成功,伺服器會以 HTTP 200 OK 狀態碼回應。

按照路徑擷取貼文

GET 要求傳送至含有 path 參數的貼文 by URI 文章,即可從網誌中擷取文章。按照路徑要求所發布貼文的 URI 格式如下:

https://www.googleapis.com/blogger/v3/blogs/blogId/posts/bypath?path=post-path

要求

https://www.googleapis.com/blogger/v3/blogs/2399953/posts/bypath?path=/2011/08/latest-updates-august-1st.html&key=YOUR-API-KEY

使用者不需要通過驗證,即可擷取公開網誌。應用程式不需要為公開網誌要求加入 Authorization HTTP 標頭,但必須提供 API 金鑰。

Blogger 也設有私人網誌,必須進行驗證。

回應

如果要求成功,伺服器會回應 HTTP 200 OK 狀態碼和貼文內容:

{
  "kind": "blogger#post",
  "id": "7706273476706534553",
  "blog": {
    "id": "2399953"
  },
  "published": "2011-08-01T19:58:00.000Z",
  "updated": "2011-08-01T19:58:51.947Z",
  "url": "http://buzz.blogger.com/2011/08/latest-updates-august-1st.html",
  "selfLink": "https://www.googleapis.com/blogger/v3/blogs/2399953/posts/7706273476706534553",
  "title": "Latest updates, August 1st",
  "content": "elided for readability",
  "author": {
    "id": "401465483996",
    "displayName": "Brett Wiltshire",
    "url": "http://www.blogger.com/profile/01430672582309320414",
    "image": {
      "url": "http://4.bp.blogspot.com/_YA50adQ-7vQ/S1gfR_6ufpI/AAAAAAAAAAk/1ErJGgRWZDg/S45/brett.png"
    }
  },
  "replies": {
    "totalItems": "0",
    "selfLink": "https://www.googleapis.com/blogger/v3/blogs/2399953/posts/7706273476706534553/comments"
  }
}

更新貼文

只要將 PUT 要求傳送至含有貼文 JSON 內文的貼文資源 URI,即可更新網誌的文章:

https://www.googleapis.com/blogger/v3/blogs/blogId/posts/postId

要求

PUT https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/3445355871727114160
Authorization: /* OAuth 2.0 token here */
Content-Type: application/json

{
 "kind": "blogger#post",
 "id": "3445355871727114160",
 "blog": {
  "id": "8070105920543249955"
 },
 "url": "http://brettmorgan-test2.blogspot.com/2012/05/new-post_20.html",
 "selfLink": "https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/3445355871727114160",
 "title": "An updated post",
 "content": "With really <b>exciting</b> content..."
}

你必須通過驗證才能更新貼文。

回應

如果要求成功,伺服器會回應 HTTP 200 OK 狀態碼和貼文內容:

{
 "kind": "blogger#post",
 "id": "6819100329896798058",
 "blog": {
  "id": "8070105920543249955"
 },
 "published": "2012-05-20T20:08:00-07:00",
 "updated": "2012-05-20T20:08:35-07:00",
 "url": "http://brettmorgan-test2.blogspot.com/2012/05/new-post.html",
 "selfLink": "https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/6819100329896798058",
 "title": "An updated post",
 "content": "With really <b>exciting</b> content...",
 "author": {
  "id": "16258312240222542576",
  "displayName": "Brett Morgan",
  "url": "http://www.blogger.com/profile/16258312240222542576",
  "image": {
   "url": "https://resources.blogblog.com/img/b16-rounded.gif"
  }
 },
 "replies": {
  "totalItems": "0",
  "selfLink": "https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/6819100329896798058/comments"
 }
}

使用修補語意更新貼文

只要將 PATCH 要求傳送至含有貼文 JSON 內文的貼文資源 URI,即可更新含有修補程式語意的貼文:

https://www.googleapis.com/blogger/v3/blogs/blogId/posts/postId

要求

範例如下:

PATCH https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/3445355871727114160
Authorization: /* OAuth 2.0 token here */
Content-Type: application/json

{
 "content": "With absolutely <b>fabulous</b> content..."
}

你必須通過驗證才能更新貼文。

回應

如果要求成功,伺服器會回應 HTTP 200 OK 狀態碼和貼文內容:

{
 "kind": "blogger#post",
 "id": "6819100329896798058",
 "blog": {
  "id": "8070105920543249955"
 },
 "published": "2012-05-20T20:08:00-07:00",
 "updated": "2012-05-20T20:08:35-07:00",
 "url": "http://brettmorgan-test2.blogspot.com/2012/05/new-post.html",
 "selfLink": "https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/6819100329896798058",
 "title": "An updated post",
 "content": "With absolutely <b>fabulous</b> content...",
 "author": {
  "id": "16258312240222542576",
  "displayName": "Brett Morgan",
  "url": "http://www.blogger.com/profile/16258312240222542576",
  "image": {
   "url": "https://resources.blogblog.com/img/b16-rounded.gif"
  }
 },
 "replies": {
  "totalItems": "0",
  "selfLink": "https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/6819100329896798058/comments"
 }
}

處理註解

擷取貼文的留言

GET 要求傳送至留言集合 URI,即可擷取貼文的留言清單。留言集合的 URI 格式如下:

https://www.googleapis.com/blogger/v3/blogs/blogId/posts/postId/comments

要求

GET https://www.googleapis.com/blogger/v3/blogs/2399953/posts/6069922188027612413/comments?key=YOUR-API-KEY

"使用者不需要通過驗證,即可擷取公開網誌。應用程式不需要為公開網誌要求加入 Authorization HTTP 標頭,但必須提供 API 金鑰。

Blogger 也設有私人網誌,必須進行驗證。

回應

如果要求成功,伺服器會回應 HTTP 200 OK 狀態碼和註解清單:

{
  "kind": "blogger#commentList",
  "nextPageToken": "CgkIFBDwjvDXlyYQ0b2SARj9mZe9n8KsnlQ",
  "prevPageToken": "CgkIFBisvMGRlyYQ0b2SARj9mZe9n8KsnlQ",
  "items": [
    {
       "kind": "blogger#comment",
       "id": "9200761938824362519",
       "post": {
         "id": "6069922188027612413"
       },
       "blog": {
         "id": "2399953"
       },
       "published": "2011-07-28T19:19:57.740Z",
       "updated": "2011-07-28T21:29:42.015Z",
       "selfLink": "https://www.googleapis.com/blogger/v3/blogs/2399953/posts/6069922188027612413/comments/9200761938824362519",
       "content": "elided",
       "author": {
         "id": "530579030283",
         "displayName": "elided",
         "url": "elided",
         "image": {
           "url": "elided"
         }
       }
    },
    {
      "kind": "blogger#comment",
      "id": "400101178920857170",
      elided for readability
    }
  ]
}

擷取特定留言

只要將 GET 要求傳送至留言資源 URI,即可從貼文中擷取特定留言。留言資源的 URI 格式如下:

https://www.googleapis.com/blogger/v3/blogs/blogId/posts/postId/comments/commentId

要求

GET https://www.googleapis.com/blogger/v3/blogs/2399953/posts/6069922188027612413/comments/9200761938824362519?key=YOUR-API-KEY

"使用者不需要通過驗證,即可擷取公開網誌。應用程式不需要為公開網誌要求加入 Authorization HTTP 標頭,但必須提供 API 金鑰。

Blogger 也設有私人網誌,必須進行驗證。

回應

如果要求成功,伺服器會回應 HTTP 200 OK 狀態碼和註解資料:

{
  "kind": "blogger#comment",
  "id": "9200761938824362519",
  "post": {
    "id": "6069922188027612413"
  },
  "blog": {
    "id": "2399953"
  },
  "published": "2011-07-28T19:19:57.740Z",
  "updated": "2011-07-28T21:29:42.015Z",
  "selfLink": "https://www.googleapis.com/blogger/v3/blogs/2399953/posts/6069922188027612413/comments/9200761938824362519",
  "content": "elided",
  "author": {
    "id": "530579030283",
    "displayName": "elided",
    "url": "elided",
    "image": {
      "url": "elided"
    }
  }
}

使用頁面

擷取網誌頁面

您可以傳送 GET 要求至網頁集合 URI,藉此擷取網誌的網頁清單。網頁集合的 URI 格式如下:

https://www.googleapis.com/blogger/v3/blogs/blogId/pages

要求

GET https://www.googleapis.com/blogger/v3/blogs/4967929378133675647/pages?key=YOUR-API-KEY

"使用者不需要通過驗證,即可擷取公開網誌。應用程式不需要為公開網誌要求加入 Authorization HTTP 標頭,但必須提供 API 金鑰。

Blogger 也設有私人網誌,必須進行驗證。

回應

如果要求成功,伺服器會以 HTTP 200 OK 狀態碼和網頁清單進行回應:

{
  "kind": "blogger#pageList",
  "items": [
    {
      "kind": "blogger#page",
      "id": "273541696466681878",
      "blog": {
        "id": "4967929378133675647"
      },
      "published": "2011-07-14T16:16:00.000Z",
      "updated": "2011-07-14T16:16:23.602Z",
      "url": "http://brettmorgan-test-blawg.blogspot.com/p/static-content.html",
      "selfLink": "https://www.googleapis.com/blogger/v3/blogs/4967929378133675647/pages/273541696466681878",
      "title": "Static Content",
      "content": "elided for readability",
      "author": {
        "id": "901569848744",
        "displayName": "brett",
        "url": "http://www.blogger.com/profile/16258312240222542576",
        "image": {
          "url": "https://resources.blogblog.com/img/b16-rounded.gif"
        }
      }
    }
  ]
}

擷取特定網頁

只要將 GET 要求傳送至網頁資源 URI,即可從網誌擷取特定網頁。頁面資源的 URI 格式如下:

https://www.googleapis.com/blogger/v3/blogs/blogId/pages/pageId

要求

GET https://www.googleapis.com/blogger/v3/blogs/4967929378133675647/pages/273541696466681878?key=YOUR-API-KEY

"使用者不需要通過驗證,即可擷取公開網誌。應用程式不需要為公開網誌要求加入 Authorization HTTP 標頭,但必須提供 API 金鑰。

Blogger 也設有私人網誌,必須進行驗證。

回應

如果要求成功,伺服器會以 HTTP 200 OK 狀態碼和網頁資料回應:

{
  "kind": "blogger#page",
  "id": "273541696466681878",
  "blog": {
    "id": "4967929378133675647"
  },
  "published": "2011-07-14T16:16:00.000Z",
  "updated": "2011-07-14T16:16:23.602Z",
  "url": "http://brettmorgan-test-blawg.blogspot.com/p/static-content.html",
  "selfLink": "https://www.googleapis.com/blogger/v3/blogs/4967929378133675647/pages/273541696466681878",
  "title": "Static Content",
  "content": "elided for readability",
  "author": {
    "id": "901569848744",
    "displayName": "brett",
    "url": "http://www.blogger.com/profile/16258312240222542576",
    "image": {
      "url": "https://resources.blogblog.com/img/b16-rounded.gif"
    }
  }
}

與使用者合作

擷取使用者

只要將 HTTP GET 要求傳送至使用者資源 URI,即可擷取使用者的資訊:

https://www.googleapis.com/blogger/v3/users/userId

要求

GET https://www.googleapis.com/blogger/v3/users/self
Authorization: /* OAuth 2.0 token here */

注意:使用者必須通過驗證才能列出自己的資訊,因此您必須使用 GET 要求提供 Authorization HTTP 標頭。

回應

如果要求成功,伺服器會回應 HTTP 200 OK 狀態碼,並提供使用者網誌清單的連結:

{
  "kind": "blogger#user",
  "id": "901569848744",
  "selfLink": "https://www.googleapis.com/blogger/v3/users/901569848744",
  "blogs": {
    "selfLink": "https://www.googleapis.com/blogger/v3/users/901569848744/blogs"
  }
}

標準查詢參數

下列查詢參數可搭配 Blogger API 中的所有方法和資源使用。

如要查看所有 Blogger API 作業適用的查詢參數,請參閱系統參數