Blogger API を使用すると、REST API を使って Blogger のコンテンツをアプリケーションに統合できます。始める前に、承認を設定する必要があります。
はじめに
このドキュメントは、Blogger API とやり取りできるアプリケーションを作成するデベロッパーを対象としています。Blogger は、ユーザーが自分の考えを継続的に公開できるウェブサイトを作成するためのツールです。
Blogger の概念に詳しくない方は、コーディングを始める前にスタートガイドをご覧ください。
リクエストの承認とアプリケーションの識別
アプリケーションから Blogger API に送信するすべてのリクエストでは、そのアプリケーションを Google に対して識別する必要があります。アプリケーションを識別する方法には、OAuth 2.0 トークンを使用する(リクエストの承認も行う)方法と、アプリケーションの API キーを使用する方法があります(この 2 つは併用できます)。これらのオプションのどちらを使用するかを決定する方法は次のとおりです。
- リクエストに認証が必要な場合(個人の個人データのリクエストなど)、アプリケーションはリクエストに OAuth 2.0 トークンを渡す必要があります。アプリケーションから API キーが提供される場合もありますが、必須ではありません。
- リクエストに承認が必要でない場合(一般公開データについてのリクエストなど)、アプリケーションは API キーまたは OAuth 2.0 トークンのいずれか、または両方を提供する必要があります。
認証プロトコルについて
リクエストを承認するために、アプリケーションは OAuth 2.0 を使用する必要があります。これ以外の認証プロトコルには対応していません。アプリケーションで「Google でログイン」を使用している場合、承認手続きの一部が自動化されます。
OAuth 2.0 を使用したリクエストの承認
非公開のユーザーデータに対する Blogger API へのリクエストは、認証済みユーザーによって承認される必要があります。
このプロセスは、OAuth クライアント ID によって促進されます。
OAuth クライアント ID を取得するまたは、認証情報ページでキーを作成することもできます。
OAuth 2.0 の承認プロセス(「フロー」)の詳細は開発するアプリケーションの種類によって若干異なりますが、次の一般的なプロセスはすべての種類のアプリケーションに当てはまります。
- アプリケーションでユーザーデータにアクセスする必要がある場合は、特定のアクセスのスコープを Google にリクエストします。
- データをリクエストするアプリケーションの承認を求める Google の同意画面がユーザーに表示されます。
- ユーザーが承認すると、有効期間の短いアクセス トークンがアプリケーションに付与されます。
- アプリケーションは、リクエストにそのアクセス トークンを付与してユーザーデータをリクエストします。
- 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 キーを作成したら、アプリケーションですべてのリクエスト URL の末尾にクエリ パラメータ key=yourAPIKey を追加できます。
API キーは URL に埋め込んでも安全です。エンコーディングの必要はありません。
ブログに関する操作
ブログの取得
特定のブログの情報を取得するには、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 でブログを取得する
ブログの URL を使用してブログを取得するには、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": ""
}
}
]
}
投稿の操作
ブログからの投稿の取得
特定のブログから投稿のリストを取得するには、投稿コレクション 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
}
]
}
特定の投稿を取得する
ブログから特定の投稿を取得するには、posts リソース 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"
}
},
...
]
}
投稿の追加
ブログの投稿を追加するには、投稿の 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 パラメータを指定して投稿別のパス 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"
}
}
パッチのセマンティクスを使用した投稿の更新
パッチのセマンティクスを使用して投稿を更新するには、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"
}
}
}
ページの操作
ブログのページを取得する
ブログのページのリストを取得するには、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 のすべてのオペレーションに適用されるクエリ パラメータについては、システム パラメータをご覧ください。