はじめに
Google Books API を利用する際の API キーを作成する手順についてまとめます。
目次
1. API キーの作成
2. Books API の有効化
3. API 制限の追加
Google Books API を Postman でテスト
公式ドキュメントの確認
Google Books API の使用方法については、公式ドキュメントを参照します。
API キーは必要
Google Books API を Postman でテストしてみると、リクエストに API キーを利用していなくても取得できますが、ドキュメントには以下の記載があり API キーは必要とのことなので、ドキュメントに従って API キーを設定します。
API キー: OAuth 2.0 トークンを提供しないリクエストでは、API キーを送信する必要があります。キーによりプロジェクトが識別され、API アクセス、割り当て、レポートが提供されます。
• リクエストに承認が必要でない場合（一般公開データについてのリクエストなど）、アプリケーションは API キーまたは OAuth 2.0 トークンのいずれか、または両方を提供する必要があります。
記載を見つけられませんでしたが、API キーを送信しない場合は使用の制限があるのかもしれません。
また、API キーの他に OAuth 2.0 トークンについて以下の記載があります。
・リクエストに認証が必要な場合（個人の個人データのリクエストなど）、アプリケーションはリクエストに OAuth 2.0 トークンを渡す必要があります。
今回は検索のみリクエストする（認証が必要な場合ではない）想定であるため、API キーのみを設定することにします。
1. API キーの作成
ドキュメント に従って、API キーを作成します。
API コンソールで 「認証情報」ページを開きます。
「認証情報を作成」 > 「API キー」をクリックして、コンソールで API キーを作成します。
API キーが作成されました。
2. Books API の有効化
API キーの制限を追加するため、Books API を有効化します。
続いて、API コンソールで 「有効な API とサービス」を開き、「API とサービスを有効にする」をクリックします。
「Books API」を検索して、選択します。
「有効にする」を押します。
ステータスが有効になっていることを確認します。
3. API 制限の追加
「認証情報」ページの API キーで作成された「API キー 4」を選択します。
開かれた編集ページで「キーを制限」をクリックして、「Select APIs」から Books API を選択します。
Google Books API を Postman でテスト
Postman を利用して、Google Books API のリクエストをテストしてみます。
リクエスト
https://www.googleapis.com/books/v1/volumes?q=ノラネコぐんだん&startIndex=0&maxResults=1&key=yourAPIKey
クエリ パラメータは以下の内容にしました。
| パラメータ名 | 値 | 説明 |
|---|---|---|
| q | ノラネコぐんだん | 検索ワード |
| startIndex | 0 | 開始インデックス |
| maxResults | 2 | 最大取得件数 |
| key | yourAPIKey | 作成した API キー |
作成した API キーをクエリ パラメータに追加します。API キーは URL に埋め込んでも安全であるとのことで、エンコーディングの必要はありません。
レスポンス
「ノラネコぐんだん」のワードで検索された、最初の 2 件の書籍データが取得されます。
{
"kind": "books#volumes",
"totalItems": 324,
"items": [
{
"kind": "books#volume",
"id": "mN2sNAEACAAJ",
"etag": "GIAlHu98DEQ",
"selfLink": "https://www.googleapis.com/books/v1/volumes/mN2sNAEACAAJ",
"volumeInfo": {
"title": "ノラネコぐんだんパンこうじょう",
"authors": [
"工藤ノリコ"
],
"publisher": "Hakusensha/Tsai Fong Books",
"publishedDate": "2012-11",
"description": "ノラネコぐんだんは、おいしそうなパンが気になり、ワンワンちゃんのパンこうじょうにしのびこみました。食いしん坊のノラネコぐんだんが見よう見まねでパンづくりに挑戦、大騒動を巻き起こします。",
"industryIdentifiers": [
{
"type": "ISBN_10",
"identifier": "459276157X"
},
{
"type": "ISBN_13",
"identifier": "9784592761570"
}
],
"readingModes": {
"text": false,
"image": false
},
"pageCount": 1,
"printType": "BOOK",
"maturityRating": "NOT_MATURE",
"allowAnonLogging": false,
"contentVersion": "preview-1.0.0",
"imageLinks": {
"smallThumbnail": "http://books.google.com/books/content?id=mN2sNAEACAAJ&printsec=frontcover&img=1&zoom=5&source=gbs_api",
"thumbnail": "http://books.google.com/books/content?id=mN2sNAEACAAJ&printsec=frontcover&img=1&zoom=1&source=gbs_api"
},
"language": "ja",
"previewLink": "http://books.google.co.jp/books?id=mN2sNAEACAAJ&dq=%E3%83%8E%E3%83%A9%E3%83%8D%E3%82%B3%E3%81%90%E3%82%93%E3%81%A0%E3%82%93&hl=&cd=1&source=gbs_api",
"infoLink": "http://books.google.co.jp/books?id=mN2sNAEACAAJ&dq=%E3%83%8E%E3%83%A9%E3%83%8D%E3%82%B3%E3%81%90%E3%82%93%E3%81%A0%E3%82%93&hl=&source=gbs_api",
"canonicalVolumeLink": "https://books.google.com/books/about/%E3%83%8E%E3%83%A9%E3%83%8D%E3%82%B3%E3%81%90%E3%82%93%E3%81%A0%E3%82%93%E3%83%91%E3%83%B3%E3%81%93%E3%81%86%E3%81%98.html?hl=&id=mN2sNAEACAAJ"
},
"saleInfo": {
"country": "JP",
"saleability": "NOT_FOR_SALE",
"isEbook": false
},
"accessInfo": {
"country": "JP",
"viewability": "NO_PAGES",
"embeddable": false,
"publicDomain": false,
"textToSpeechPermission": "ALLOWED",
"epub": {
"isAvailable": false
},
"pdf": {
"isAvailable": false
},
"webReaderLink": "http://play.google.com/books/reader?id=mN2sNAEACAAJ&hl=&source=gbs_api",
"accessViewStatus": "NONE",
"quoteSharingAllowed": false
},
"searchInfo": {
"textSnippet": "ノラネコぐんだんは、おいしそうなパンが気になり、ワンワンちゃんのパンこうじょうにしのびこみました。食いしん坊のノラネコぐんだんが見よう見まねでパンづくりに挑戦、 ..."
}
},
{
"kind": "books#volume",
"id": "A_L8xAEACAAJ",
"etag": "kMe1bk8iK1E",
"selfLink": "https://www.googleapis.com/books/v1/volumes/A_L8xAEACAAJ",
"volumeInfo": {
"title": "ノラネコぐんだんコミック",
"authors": [
"工藤ノリコ"
],
"publishedDate": "2019",
"industryIdentifiers": [
{
"type": "ISBN_10",
"identifier": "4592762495"
},
{
"type": "ISBN_13",
"identifier": "9784592762492"
}
],
"readingModes": {
"text": false,
"image": false
},
"pageCount": 143,
"printType": "BOOK",
"maturityRating": "NOT_MATURE",
"allowAnonLogging": false,
"contentVersion": "preview-1.0.0",
"panelizationSummary": {
"containsEpubBubbles": false,
"containsImageBubbles": false
},
"language": "ja",
"previewLink": "http://books.google.co.jp/books?id=A_L8xAEACAAJ&dq=%E3%83%8E%E3%83%A9%E3%83%8D%E3%82%B3%E3%81%90%E3%82%93%E3%81%A0%E3%82%93&hl=&cd=2&source=gbs_api",
"infoLink": "http://books.google.co.jp/books?id=A_L8xAEACAAJ&dq=%E3%83%8E%E3%83%A9%E3%83%8D%E3%82%B3%E3%81%90%E3%82%93%E3%81%A0%E3%82%93&hl=&source=gbs_api",
"canonicalVolumeLink": "https://books.google.com/books/about/%E3%83%8E%E3%83%A9%E3%83%8D%E3%82%B3%E3%81%90%E3%82%93%E3%81%A0%E3%82%93%E3%82%B3%E3%83%9F%E3%83%83%E3%82%AF.html?hl=&id=A_L8xAEACAAJ"
},
"saleInfo": {
"country": "JP",
"saleability": "NOT_FOR_SALE",
"isEbook": false
},
"accessInfo": {
"country": "JP",
"viewability": "NO_PAGES",
"embeddable": false,
"publicDomain": false,
"textToSpeechPermission": "ALLOWED",
"epub": {
"isAvailable": false
},
"pdf": {
"isAvailable": false
},
"webReaderLink": "http://play.google.com/books/reader?id=A_L8xAEACAAJ&hl=&source=gbs_api",
"accessViewStatus": "NONE",
"quoteSharingAllowed": false
}
}
]
}
API キー: OAuth 2.0 トークンを提供しないリクエストでは、API キーを送信する必要があります。キーによりプロジェクトが識別され、API アクセス、割り当て、レポートが提供されます。
とある通り、API コンソールではリクエストの件数などが確認できるようになっています。
おわりに
Google Books API を利用する際の API キーを作成する手順についてまとめました。
ありがとうございました。