Blogger API: API の使用

コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

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 の承認プロセス、つまり「フロー」の詳細は、開発するアプリケーションの種類によって多少異なりますが、次の一般的なプロセスは、すべての種類のアプリケーションに当てはまります。

  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 キーを作成したら、アプリケーションですべてのリクエスト URL の末尾にクエリ パラメータ key=yourAPIKey を追加できます。

API キーは URL に埋め込んでも安全です。エンコーディングの必要はありません。

ブログの活用

ブログの取得

特定のブログの情報を取得するには、ブログの 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 でブログを取得する

URL を使用してブログを取得するには、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": ""
      }
    }
  ]
}

投稿の操作

ブログから投稿を取得する

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",
  "prevPageToken": "CgkIChDBwrK3mCYQ0b2SAQ",
  "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",
  "prevPageToken": "CgkIChDBq5v24yYQzJTEAQ",
  "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 本文を含む POST リクエストを投稿コレクション 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 パラメータを使用して投稿のバイパス 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 本文を含む PUT リクエストを投稿のリソース 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 本文を含む 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"
 }
}

コメントの操作

投稿のコメントを取得する

投稿のコメントのリストを取得するには、コメント コレクション 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
    }
  ]
}

特定のコメントを取得する

投稿から特定のコメントを取得するには、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"
    }
  }
}

ユーザーに関する作業

ユーザーを取得する

ユーザーの情報を取得するには、ユーザーのリソース 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 のすべてのオペレーションに適用されるクエリ パラメータは、システム パラメータに記載されています。