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"
  }
}

搜尋貼文

如要搜尋網誌中的文章，您可以使用 q 搜尋查詢參數將 GET 要求傳送至文章搜尋 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 狀態碼。

按路徑擷取貼文

您可以使用 path 參數將 GET 要求傳送至各個文章路徑 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"
 }
}

更新含有修補程式語意的貼文

您可以傳送含有 JSON 文章 JSON 主體的 PATCH 要求至貼文資源 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 作業的查詢參數，請參閱系統參數。