このページは Cloud Translation API によって翻訳されました。

Blogger JSON API: API の使用

重要: JSON API v2.0 のサポートは、2024 年 9 月 30 日をもって終了します。機能を引き続き利用するには、v2.0 JSON API に依存するアプリケーションを更新してくださいインストールされています。最新バージョンについては、左側のナビゲーションバーのリンクを使用してください。

このドキュメントでは、RESTful 呼び出しスタイルを使用して Blogger JSON API の一般的な機能を使用する方法について説明します。

はじめに
1. リクエストの承認とアプリケーションの識別
ブログを使用する
1. ブログの取得
2. ユーザーのブログを取得する
投稿の操作
1. ブログの投稿を取得する
2. 特定の投稿を取得する
コメントの操作
1. 投稿のコメントを取得する
2. 特定のコメントの取得
ページの操作
1. ブログのページを取得する
2. 特定のページの取得
ユーザーの操作
1. ユーザーの取得
標準のクエリパラメータ

はじめに

このドキュメントは、Blogger JSON API とやり取りできるアプリケーションを作成するデベロッパーを対象としています。Blogger は、ユーザーが自分の考えを発表し、あります。

Blogger のコンセプトに慣れていない場合は、コーディングを開始する前にスタートガイドをお読みください。

リクエストの承認とアプリケーションの識別

アプリケーションから Blogger JSON API に送信するすべてのリクエストでは、Google に対してアプリケーションを指定する必要があります。アプリケーションを識別する方法には、OAuth 2.0 トークンを使用する（リクエストの承認も行う）方法と、アプリケーションの API キーを使用する方法があります（この 2 つは併用できます）。これらのオプションのどちらを使用するかを決定する方法は次のとおりです。

リクエストに承認が必要である場合（個人の限定公開データについてのリクエストなど）、アプリケーションはリクエストとともに OAuth 2.0 トークンを提供する必要があります。アプリケーションが API キーも提供することがありますが、これは必須ではありません。
リクエスト（一般公開のリクエストなど）で承認が不要な場合、データを使用する場合）、アプリケーションは API キーまたは OAuth 2.0 いずれかを選択できます。

認証プロトコルについて

リクエストを承認するために、アプリケーションは OAuth 2.0 を使用する必要があります。これ以外の認証プロトコルには対応していません。

注: 現在、Blogger JSON API では、データアクセスリクエスト（ハイブリッド）または権限のドメイン全体の委任（2LO）と同時にログインすることはできません。

OAuth 2.0 を使ったリクエストの承認

非公開のユーザーデータに対する Blogger JSON API へのリクエストは、認証済みユーザーによって承認される必要があります。

承認プロセス（「フロー」）の詳細は使用する場合は、作成するアプリケーションの種類によって多少異なります。次の一般的なプロセスは、すべての種類のアプリケーションに適用されます。

アプリケーションを作成したら、そのアプリケーションを Google に登録します。Google すると、クライアント ID やクライアント ID など、後で必要になるシークレット。
Google API の [Services] ペインで Blogger JSON API を有効にするできます。（コンソールに表示されない場合は、この手順をスキップします）。
アプリケーションがユーザーデータにアクセスする必要がある場合は、アクセスの特定の範囲を指定します。
Google が OAuth ダイアログをユーザーに表示して、ユーザーに確認します。アプリケーションによる一部のデータのリクエストを承認します。
ユーザーが承認すると、有効期間の短いアクセストークンがアプリケーションに付与されます。
アプリケーションは、リクエストにそのアクセストークンを付与してユーザーデータをリクエストします。
Google がそのリクエストとトークンが有効であると判断すると、リクエストされたデータが返されます。

一部のフローでは、更新の使用など、追加の手順が 新しいアクセストークンを取得してください。さまざまな種類のアプリケーションのフローについて詳しくは、Google の OAuth 2.0 ドキュメントをご覧ください。

Blogger JSON API の OAuth 2.0 のスコープ情報は次のとおりです。

https://www.googleapis.com/auth/blogger

OAuth 2.0 を使用してアクセスをリクエストする場合、アプリケーションを登録したときに Google から提供された情報（クライアント ID やクライアントシークレットなど）に加えて、スコープ情報が必要になります。

ヒント: Google API クライアントライブラリで一部の承認プロセスを処理することもできます。これらのライブラリはさまざまなプログラミング言語で用意されています。詳細については、ライブラリとサンプルのページをご覧ください。

API キーの取得と使用

一般公開データに対する Blogger JSON API へのリクエストには、識別子（API キーまたは認証トークン）が含まれている必要があります。

API キーを取得するには、API コンソールにアクセスします。本サービス内 [api_name]; を有効にします利用規約が表示されたら、内容を読んで同意しますできます。

次に、[API アクセス] ペインに移動します。API キーは、このペインの下部のセクション「Simple API Access」というタイトルを付けます。

API キーを取得すると、アプリケーションはクエリパラメータを追加できます。 key=yourAPIKey - すべてのリクエストできます。

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

ブログの使用

ブログの取得

特定の Blogs リソースの情報を取得するには、ブログの URI に HTTP GET リクエストを送信します。Blogs リソースの URI の形式は次のとおりです。

https://www.googleapis.com/blogger/v2/blogs/blogId

リクエスト

以下に例を示します。

GET https://www.googleapis.com/blogger/v2/blogs/2399953&key=YOUR-API-KEY

公開ブログを取得するためにユーザーを認証する必要がないため、この GET リクエストで Authorization HTTP ヘッダーを指定する必要はありません。ただし、このヘッダーを指定しない場合、API キーを指定する必要があります。

Blogger には非公開のブログもあります。その場合、あります。

レスポンス

リクエストが成功すると、サーバーは HTTP 200 OK ステータスコードとブログデータを返します。

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/v2/blogs/2399953",
  "posts": {
    "totalItems": 494,
    "selfLink": "https://www.googleapis.com/blogger/v2/blogs/2399953/posts"
  },
  "pages": {
    "totalItems": 2,
    "selfLink": "https://www.googleapis.com/blogger/v2/blogs/2399953/pages"
  },
  "locale": {
    "language": "en",
    "country": "",
    "variant": ""
  }
}

ユーザーのブログを取得する

HTTP GET リクエストを送信して、ユーザーのブログのリストを取得できます。 Blogs コレクション URI に変更します。

https://www.googleapis.com/blogger/v2/users/userId/blogs

リクエスト

次に、GET リクエストの例を示します。ユーザーのブログ:

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

注: ユーザーは自分のブログを一覧表示するために認証されている必要があるため、GET リクエストに Authorization HTTP ヘッダーを指定する必要があります。

レスポンス

リクエストが成功すると、サーバーは HTTP 200 OK ステータスコードと、ユーザーの ID リストの完全な表現ブログ:

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/v2/blogs/4967929378133675647",
      "posts": {
        "totalItems": 13,
        "selfLink": "https://www.googleapis.com/blogger/v2/blogs/4967929378133675647/posts"
      },
      "pages": {
        "totalItems": 1,
        "selfLink": "https://www.googleapis.com/blogger/v2/blogs/4967929378133675647/pages"
      },
      "locale": {
        "language": "en",
        "country": "",
        "variant": ""
      }
    }
  ]
}

投稿の操作

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

特定のブログの投稿のリストを取得するには、Posts コレクション URI に GET リクエストを送信します。投稿コレクションの URI の形式は次のとおりです。

https://www.googleapis.com/blogger/v2/blogs/blogId/posts

リクエスト

以下に例を示します。

GET https://www.googleapis.com/blogger/v2/blogs/2399953/posts&key=YOUR-API-KEY

公開ブログから投稿を取得する際にユーザー認証は不要なため、 Authorization HTTP ヘッダーを指定する必要はありません。 GET リクエスト。このヘッダーを指定しない場合は、API キーを指定する必要があります。

Blogger には限定公開のブログもあり、認証が必要です。

レスポンス

リクエストが成功すると、サーバーは HTTP 200 OK ステータスコードと投稿のリスト:

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/v2/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/v2/blogs/2399953/posts/7706273476706534553/comments"
      }
    },
    {
      "kind": "blogger#post",
      "id": "6069922188027612413",
      elided for readability
    }
  ]
}

特定の投稿の取得

特定の投稿をブログから取得するには、 Posts リソース URI への GET リクエスト。投稿の URI リソースの形式は次のとおりです。

https://www.googleapis.com/blogger/v2/blogs/blogId/posts/postId

リクエスト

以下に例を示します。

GET https://www.googleapis.com/blogger/v2/blogs/2399953/posts/7706273476706534553&key=YOUR-API-KEY

Blogger には限定公開のブログもあり、認証が必要です。

レスポンス

リクエストが成功すると、サーバーは HTTP 200 OK ステータスコードと Post の内容を返します。

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/v2/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/v2/blogs/2399953/posts/7706273476706534553/comments"
  }
}

コメントの操作

投稿のコメントの取得

投稿のコメントのリストを取得するには、Comments Collection URI に GET リクエストを送信します。関数の URI コメントコレクションの形式は次のとおりです。

https://www.googleapis.com/blogger/v2/blogs/blogId/posts/postId/comments

リクエスト

以下に例を示します。

GET https://www.googleapis.com/blogger/v2/blogs/2399953/posts/6069922188027612413/comments&key=YOUR-API-KEY

公開ブログからコメントを取得する際にユーザー認証が不要なため、 Authorization HTTP ヘッダーを指定する必要はありません。 GET リクエスト。このヘッダーを指定しない場合は、API キーを指定する必要があります。

Blogger には限定公開のブログもあり、認証が必要です。

レスポンス

リクエストが成功すると、サーバーは HTTP 200 OK ステータスコードとコメントのリスト:

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/v2/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
    }
  ]
}

特定のコメントの取得

投稿から特定のコメントを取得するには、Comments リソース URI に GET リクエストを送信します。コメントリソースの URI の形式は次のとおりです。

https://www.googleapis.com/blogger/v2/blogs/blogId/posts/postId/comments/commentId

リクエスト

以下に例を示します。

GET https://www.googleapis.com/blogger/v2/blogs/2399953/posts/6069922188027612413/comments/9200761938824362519&key=YOUR-API-KEY

Blogger には限定公開のブログもあり、認証が必要です。

レスポンス

リクエストが成功すると、サーバーは HTTP 200 OK ステータスコードとコメントデータ:

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/v2/blogs/2399953/posts/6069922188027612413/comments/9200761938824362519",
  "content": "elided",
  "author": {
    "id": "530579030283",
    "displayName": "elided",
    "url": "elided",
    "image": {
      "url": "elided"
    }
  }
}

ページの操作

ブログのページを取得する

ブログのページのリストを取得するには、 Pages コレクション URI に GET リクエストを追加します。ページコレクションの URI の形式は次のとおりです。

https://www.googleapis.com/blogger/v2/blogs/blogId/pages

リクエスト

以下に例を示します。

GET https://www.googleapis.com/blogger/v2/blogs/4967929378133675647/pages&key=YOUR-API-KEY

公開ブログからページを取得するためにユーザーを認証する必要がないため、この GET リクエストで Authorization HTTP ヘッダーを指定する必要はありません。ただし、このヘッダーを指定しない場合、API キーを指定する必要があります。

Blogger には非公開のブログもあります。その場合、あります。

レスポンス

リクエストが成功すると、サーバーは HTTP 200 OK ステータスコードとページのリストで応答します。

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/v2/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"
        }
      }
    }
  ]
}

特定のページを取得する

ブログから特定のページを取得するには、 Pages リソース URI への GET リクエスト。ページの URI リソースの形式は次のとおりです。

https://www.googleapis.com/blogger/v2/blogs/blogId/pages/pageId

リクエスト

以下に例を示します。

GET https://www.googleapis.com/blogger/v2/blogs/4967929378133675647/pages/273541696466681878&key=YOUR-API-KEY

Blogger には非公開のブログもあります。その場合、あります。

レスポンス

リクエストが成功すると、サーバーは HTTP 200 OK ステータスコードとページデータを返します。

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

ユーザーとの連携

ユーザーの取得

ユーザーの情報を取得するには、Users リソース URI に HTTP GET リクエストを送信します。

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

リクエスト

ユーザーのブログを一覧表示する GET リクエストの例を次に示します。

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

注: ユーザーは、Google アカウント、独自の情報を一覧表示するため、Authorization HTTP リクエスト / ヘッダーを GET リクエストに置き換えます。

レスポンス

リクエストが成功すると、サーバーは HTTP 200 OK ステータスコードと、ユーザーのリストへのリンクブログ:

200 OK

{
  "kind": "blogger#user",
  "id": "901569848744",
  "selfLink": "https://www.googleapis.com/blogger/v2/users/901569848744",
  "blogs": {
    "selfLink": "https://www.googleapis.com/blogger/v2/users/901569848744/blogs"
  }
}

標準のクエリパラメータ

以下のクエリパラメータは、Blogger API のすべてのメソッドとリソースで使用できます。

Blogger API のすべてのオペレーションに適用されるクエリパラメータについては、システムパラメータ。

Blogger JSON API: API の使用

目次

はじめに

リクエストの承認とアプリケーションの識別

認証プロトコルについて

OAuth 2.0 を使ったリクエストの承認

API キーの取得と使用

ブログの使用

ブログの取得

リクエスト

レスポンス

ユーザーのブログを取得する

リクエスト

レスポンス

投稿の操作

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

リクエスト

レスポンス

特定の投稿の取得

リクエスト

レスポンス

コメントの操作

投稿のコメントの取得

リクエスト

レスポンス

特定のコメントの取得

リクエスト

レスポンス

ページの操作

ブログのページを取得する

リクエスト

レスポンス

特定のページを取得する

リクエスト

レスポンス

ユーザーとの連携

ユーザーの取得

リクエスト

レスポンス

標準のクエリ パラメータ

標準のクエリパラメータ