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 操作的查询参数。