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

按博客网址检索博客

您可以使用 HTTP 请求向以下 URI 发送 HTTP GET 请求，并使用 url 参数检索博客网址：

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 搜索查询查询参数向博文搜索 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"
    }
  },
  ...
  ]
}

添加帖子

您可以通过向帖子集合 URI 发送 POST 请求（其中包含帖子 JSON 正文）来为博客添加帖子：

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 参数的博文路径 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"
  }
}

更新帖子

您可以通过向博文资源 URI 发送 PUT 请求（其中包含博文 JSON 正文）来更新博文：

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

使用补丁语义更新帖子

您可以使用 post JSON 正文向 post 资源 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 */

注意：用户必须通过身份验证才能列出自己的信息，因此您必须在 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 操作的查询参数。