Blogger API：使用 API

借助 Blogger API，您可以使用 REST API 将 Blogger 内容与应用集成。在开始之前，您需要设置授权。

简介

本文面向的是想要编写能够与 Blogger API 交互的应用的开发者。Blogger 是一款用于创建网站的工具，可让用户持续发布自己的想法。

如果您不熟悉 Blogger 的概念，则应在开始编码之前阅读使用入门。

为请求授权并识别您的应用

您的应用向 Blogger API 发送的每个请求都需要向 Google 标识您的应用。您可以通过两种方式来标识应用：使用 OAuth 2.0 令牌（也用于向请求授权）和/或使用应用的 API 密钥。下文介绍了如何确定使用哪种方式：

  • 如果请求需要授权（例如请求个人隐私数据），则应用必须在请求中提供 OAuth 2.0 令牌。应用也可以提供 API 密钥，但这并非强制要求。
  • 如果请求不需要授权（例如对公开数据的请求），则应用必须提供 API 密钥或 OAuth 2.0 令牌，或者同时提供两者（选择对您而言最方便的方式即可）。

关于授权协议

您的应用必须使用 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 发出的公开数据请求必须附带标识符，该标识符可以是 API 密钥或访问令牌。

获取密钥

或者在“凭据”页面中创建一个。

在您获得 API 密钥后，您的应用便可在所有请求网址后附加查询参数 key=yourAPIKey。

API 密钥可以安全地嵌入网址中，而无需进行任何编码。

使用博客

检索博客

您可以通过向特定博客的 URI 发送 HTTP GET 请求来检索该博客的信息。博客的 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 参数向以下 URI 发送 HTTP GET 请求：

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

检索用户的博客

您可以通过向博客集合 URI 发送 HTTP GET 请求来检索用户的博客列表：

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

使用帖子

检索博客中的帖子

您可以向博文集合 URI 发送 GET 请求，以检索指定博客中的博文列表。帖子集合的 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
    }
  ]
}

检索特定帖子

您可以通过向博文资源 URI 发送 GET 请求来检索博客中的特定博文。帖子资源的 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 search 查询参数向博文搜索 URI 发送 GET 请求，以搜索博客中的博文：

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"
    }
  },
  ...
  ]
}

添加帖子

您可以使用博文 JSON 正文向博文集合 URI 发送 POST 请求，从而为博客添加博文：

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

删除帖子

您可以向博文资源 URI 发送 DELETE 请求，从而删除博客的博文：

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 参数向博文 bypath URI 发送 GET 请求，从而从博客中检索博文。“按路径排列的博文”请求的 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"
  }
}

更新帖子

您可以通过使用博文 JSON 正文向博文资源 URI 发送 PUT 请求来更新博客的博文：

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 正文向博文资源 URI 发送 PATCH 请求，从而使用补丁语义更新博文：

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

处理评论

检索帖子的评论

您可以通过向评论集合 URI 发送 GET 请求来检索帖子的评论列表。评论集合的 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
    }
  ]
}

检索特定评论

您可以向评论资源 URI 发送 GET 请求，以检索帖子中的特定评论。评论资源的 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"
    }
  }
}

使用页面

检索博客的页面

您可以通过向页面集合 URI 发送 GET 请求来检索博客的页面列表。页面集合的 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"
        }
      }
    }
  ]
}

检索特定网页

您可以向页面资源 URI 发送 GET 请求，以从博客中检索特定页面。页面资源的 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"
    }
  }
}

与用户合作

检索用户

您可以通过向用户资源 URI 发送 HTTP GET 请求来检索用户的信息：

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

请求

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

注意：用户必须经过身份验证才能列出自己的信息，因此您必须提供 Authorization HTTP 标头和 GET 请求。

响应

如果请求成功，服务器将返回 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 操作的查询参数。