SHOEISHA iD

パスワードを忘れた場合はこちら

※旧SEメンバーシップ会員の方は、同じ登録情報（メールアドレス＆パスワード）でログインいただけます

  • 新規
    会員登録
  • 新規会員登録

ニュース

記事

デブサミ・デブスト

講座

書籍

新着記事一覧を見る

連載記事

人気記事の執筆者

大西 武

しめじ（smeghead）

柳井 政和

渡部 拓也

Innerstudio 鍋島 理人
イベント
イベント

CodeZine編集部では、現場で活躍するデベロッパーをスターにするためのカンファレンス「Developers Summit」や、エンジニアの生きざまをブーストするためのイベント「Developers Boost」など、さまざまなカンファレンスを企画・運営しています。

講演資料・動画まとめページ

Developers CAREER Boost 2024 講演資料まとめ

Developers X Summit 2024 講演資料まとめ

Developers Summit 2024 KANSAI 講演関連資料まとめ

Developers Summit 2024 Summer 講演資料まとめ

Developers Boost 2024 講演資料まとめ

Developers Summit 2024 講演資料まとめ

CodeZine BOOKS（コードジン・ブックス）は、CodeZineの連載からカットアップした、開発現場の課題解決に役立つ書籍シリーズです。

書籍に関する記事を見る

'); googletag.cmd.push(function() { googletag.pubads().addEventListener('slotRenderEnded', function(e) { var ad_id = e.slot.getSlotElementId(); if (ad_id == 'div-gpt-ad-1659428980688-0') { var ad = $('#'+ad_id).find('iframe'); if ($(ad).width() == 728) { var ww = $(window).width(); ww = ww*0.90; var style = document.createElement("style"); document.head.appendChild( style ); var sheet = style.sheet; sheet.insertRule( "#div-gpt-ad-1659428980688-0 iframe {-moz-transform: scale("+ww/728+","+ww/728+");-moz-transform-origin: 0 0;-webkit-transform: scale("+ww/728+","+ww/728+");-webkit-transform-origin: 0 0;-o-transform: scale("+ww/728+","+ww/728+");-o-transform-origin: 0 0;-ms-transform: scale("+ww/728+","+ww/728+");-ms-transform-origin: 0 0;}", 0 ); sheet.insertRule( "#div-gpt-ad-1659428980688-0 div{ height:"+(90*ww/728)+"px;width:"+728+"px;}", 0 ); } else { if ($(window).width() < 340) { var ww = $(window).width(); ww = ww*0.875; var style = document.createElement("style"); document.head.appendChild( style ); var sheet = style.sheet; sheet.insertRule( "#div-gpt-ad-1659428980688-0 iframe {-moz-transform: scale("+ww/320+","+ww/320+");-moz-transform-origin: 0 0;-webkit-transform: scale("+ww/320+","+ww/320+");-webkit-transform-origin: 0 0;-o-transform: scale("+ww/320+","+ww/320+");-o-transform-origin: 0 0;-ms-transform: scale("+ww/320+","+ww/320+");-ms-transform-origin: 0 0;}", 0 ); sheet.insertRule( "#div-gpt-ad-1659428980688-0 div{ height:"+(180*ww/320)+"px;width:"+320+"px;}", 0 ); } } } }); }); } else { document.write('
'); document.write('
'); }
オール・ザット・Googleテクノロジーズ

これだけ押さえておけばあらゆるAPIを呼び出せる！ Google APIを使用するための基本

オール・ザット・Googleテクノロジーズ 第1回


  • X ポスト
  • このエントリーをはてなブックマークに追加

　本連載では、Googleが提供するプラットフォームやサービスに関する情報を定期的に紹介していきます。今回は「Google APIs」と呼ばれる、各種リソースへアクセスするAPIの基礎となる部分を紹介します。Googleは様々なAPIを提供していますが、今回説明する「基本」を学んでおけば、あらゆるAPIを簡単に使うことができるようになります。

  • X ポスト
  • このエントリーをはてなブックマークに追加

対象読者

  • GoogleのサービスやAPIに興味のある方、悩んだことがある方
  • Google Cloud Platformに興味のある方
  • GoogleではないAPIの経験がある方（推奨）

必要な環境

  • Googleアカウント
  • Webブラウザ
  • サンプルコードを実行する場合は、Javaの開発環境

Google APIの基礎知識

　Googleが提供する大抵のプラットフォームやサービスは、それらのリソースへアクセスするためのAPI（以下、Google API）を提供しています。まずは、Google APIを理解するための基礎となる事項を押さえておきましょう。

APIとの通信方式とDiscovery Document

　Google APIと通信する方式には次の2つがあります。

  • OAuth1でアクセス許可を得て、ATOM書式で通信する
  • OAuth2でアクセス許可を得て、JSON書式でhttpsを使って通信する

　前者は古いAPIの通信方式で、徐々に後者に置き換えられています。新たに公開されるAPIは全て後者になっています。今回紹介するAPIも後者であるとします。

　後者のAPIはDiscovery based APIと呼ばれます。Discovery based APIの仕様はDiscovery Documentと呼ばれるJSON文書で定義されており、この仕様に準拠しているAPIの大部分は、Google APIs Discovery Serviceという「APIを探すAPI」を使って探すことができます。

　また、JSON文書であるDiscovery Documentは、プログラムで処理することができます。これを利用して、Discovery Documentで定義されているAPIを使用するWebアプリケーションを、自動的に生成することもできます。

　この仕組みを利用したツールにGoogle API Explorerがあります。Google API Explorerは、Google APIs Discovery Serviceを使ってAPIを取得し、一覧表示してくれますが、それだけにとどまりません。一覧にあるAPIを簡単に実行してみることが可能です。

Google API Explorer
Google API Explorer

　API Explorerは、多くのAPIのリファレンスにも埋め込まれています。そうしたリファレンスの画面では、説明されているAPIを実行してみることができます。

Discovery basedなAPIを自分でも使う

　Discovery basedなAPIは、Googleが提供しているものを利用するだけではなく、自分でも利用できます。Google Cloud PlatformのCloud Endpointsという機能を使えば、API Explorerのようなシンプルなクライアントはもちろん、WebアプリケーションとAndroidとiOS向けのクライアントライブラリを自動生成することもできます。

 

APIの種類

　Googleの様々なプラットフォームやサービスがAPIを提供していますが、どの持ち主のリソースを操作するか、という観点から次の3タイプに分類できます。

Webサービス向けのAPI
　最も一般的なAPIで、GmailやGoogle Drive、Google Calendarなどの「個人が使用するWebサービス」のリソースに対するアクセスが提供されます。
　例えば、アクセス権限を取得したユーザに対するGmailのスレッドを取得したり、スレッドにラベルをつけたり、Calendarに予定を作ったりというように、特定のユーザが所有するリソースを操作できます。

プラットフォーム向けのAPI
　Google Cloud Platformなどで使用するリソースに対するアクセスを提供するもので、Developer Console（後述）のプロジェクトが所有するリソースに対するアクセスが提供されます。
　例えば、プロジェクトで使用しているストレージ領域にファイルを書き込んだり、Compute Engineなどのリソースの状態を操作したりできます。

Google Apps向けのAPI
　企業向けのプロダクトプラットフォームであるGoogle Appsのリソースに対するアクセスが提供されます。
GmailやGoogle Calendarなどの組織内のユーザが所有するリソースはもちろん、組織内のユーザやグループ、組織情報などの組織が所有リソースも操作できます。

APIで提供される操作の共通性

　Google APIで提供される各リソースに対する操作は、RESTに似たメソッドで提供されています。次の画面は、Calendar APIのリファレンスです。左側の"API Reference"から"Events"を選択すると、listやgetといったメソッドが並んでいることが確認できます。

Calendars.events
Calendars.events

　また、こうしたメソッドには、Google APIの間でかなり共通性があります。例えば、次の表のとおりです。listやgetといったメソッドは、Calendar API以外にも提供されています。

Google APIで共通するメソッド
メソッド 機能
list 一覧を取得する
get IDを指定して、一件取得する
insert 新規作成する
update 上書きする
patch 部分的に上書きする
delete 指定したIDに対応するものを削除する

　各リソースに対する操作は「リソース名.メソッド名」という表現で定義されています。

　また、これらの操作を複数まとめて一括実行する操作が可能な場合もあります。これはbatchリクエストと呼ばれ、複数の操作を連続して実行する場合に使うと効果的です。Google APIのbatchリクエストにはOData batch processingという通信方式が採用されています。

会員登録無料すると、続きをお読みいただけます

新規会員登録無料のご案内

  • ・全ての過去記事が閲覧できます
  • ・会員限定メルマガを受信できます

メールバックナンバー

次のページ
Google APIを使用するアプリケーション作成の準備

NEXT

この記事は参考になりましたか？

  • X ポスト
  • このエントリーをはてなブックマークに追加
オール・ザット・Googleテクノロジーズ連載記事一覧
この記事の著者

小川 信一（オガワシンイチ）

株式会社トップゲート CTO ＆ Google API Expert。日本で唯一、Google API Expertのダブルアカウント保持者である。Google App Engineの専門書を2冊出版。日本最大のApp EngineコミュニティーでGoogle App Engineの普及活動を行い、...

※プロフィールは、執筆時点、または直近の記事の寄稿時点での内容です

この著者の最近の執筆記事

この記事は参考になりましたか？

この記事をシェア

  • X ポスト
  • このエントリーをはてなブックマークに追加
CodeZine（コードジン）
https://codezine.jp/article/detail/7977 2014/08/29 15:29
" ); }

おすすめ

アクセスランキング

  1. 1
    デスクトップアプリを開発しよう！ 「Rust」と「Tauri 2.0」の基本情報と環境整備の仕方を解説
  2. 2
    「CUDA」　～マンガでプログラミング用語解説
  3. 3
    2024年の提示年収が高いプログラミング言語は？ paiza調査によるランキングが発表
  4. 4
    健全なソフトウェア設計の第一歩！ 既存のPHPソースコードからクラス図を自動生成しよう
  5. 5
    約9割の企業がIT人材不足を実感、「プロリア プログラミング」による調査によって明らかに NEW
  1. 6
    開発チームに必要なのは生産性だけじゃない！ 健全性も計測し、良い開発者体験を生むために
  2. 7
    VSCodeをUML図やフローチャート作成に使ってみよう
  3. 8
    売上か？ 面白い技術か？ エンジニア組織が直面するジレンマに、エンジニア経営者 漆原氏が切り込む
  4. 9
    計測と改善をひたすら繰り返したら、年間コストを1億円削減した──不確実性の高いプロジェクトに挑む NEW
  5. 10
    生成AI活用普及協会、「生成AIリテラシー診断」の結果を発表。生成AIリテラシ偏差値49以下が約85％に NEW

アクセスランキング

  1. 1
    デスクトップアプリを開発しよう！ 「Rust」と「Tauri 2.0」の基本情報と環境整備の仕方を解説
  2. 2
    「CUDA」　～マンガでプログラミング用語解説
  3. 3
    2024年の提示年収が高いプログラミング言語は？ paiza調査によるランキングが発表
  4. 4
    健全なソフトウェア設計の第一歩！ 既存のPHPソースコードからクラス図を自動生成しよう
  5. 5
    約9割の企業がIT人材不足を実感、「プロリア プログラミング」による調査によって明らかに NEW
  6. 6
    開発チームに必要なのは生産性だけじゃない！ 健全性も計測し、良い開発者体験を生むために
  7. 7
    VSCodeをUML図やフローチャート作成に使ってみよう
  8. 8
    売上か？ 面白い技術か？ エンジニア組織が直面するジレンマに、エンジニア経営者 漆原氏が切り込む
  9. 9
    計測と改善をひたすら繰り返したら、年間コストを1億円削減した──不確実性の高いプロジェクトに挑む NEW
  10. 10
    生成AI活用普及協会、「生成AIリテラシー診断」の結果を発表。生成AIリテラシ偏差値49以下が約85％に NEW
  1. 1
    ITエンジニア本大賞2025、投票締切直前！ みんなで選んだ歴代の大賞本を振り返って一挙紹介
  2. 2
    VSCodeをドキュメント作成に活用――テキストエディタ、Markdownエディタの設定と拡張機能を解説
  3. 3
    Python 3.13の新機能、対話型インタプリタの機能強化や高速化などを解説
  4. 4
    「CUDA」　～マンガでプログラミング用語解説
  5. 5
    今後生成AIとどう向き合うべきなのか？ 現場のエンジニアと研究者が最新研究事例から語り合う
  6. 6
    デスクトップアプリを開発しよう！ 「Rust」と「Tauri 2.0」の基本情報と環境整備の仕方を解説
  7. 7
    2024年12月に開催される注目のITエンジニア向けカンファレンス5選
  8. 8
    日本在住の英語を話すソフトウェア開発者、年収の中央値は950万円に
  9. 9
    Vue.js3.4～3.5の新機能をまとめて紹介！ 新しいAPIやSSRの改善
  10. 10
    PHPパッケージ管理ツール「Composer」の処理の仕組みを見てみよう！

イベント

CodeZine編集部では、現場で活躍するデベロッパーをスターにするためのカンファレンス「Developers Summit」や、エンジニアの生きざまをブーストするためのイベント「Developers Boost」など、さまざまなカンファレンスを企画・運営しています。

新規会員登録無料のご案内

メールバックナンバー

アクセスランキング

  1. 1
    デスクトップアプリを開発しよう！ 「Rust」と「Tauri 2.0」の基本情報と環境整備の仕方を解説
  2. 2
    「CUDA」　～マンガでプログラミング用語解説
  3. 3
    2024年の提示年収が高いプログラミング言語は？ paiza調査によるランキングが発表
  4. 4
    健全なソフトウェア設計の第一歩！ 既存のPHPソースコードからクラス図を自動生成しよう
  5. 5
    約9割の企業がIT人材不足を実感、「プロリア プログラミング」による調査によって明らかに NEW
  1. 6
    開発チームに必要なのは生産性だけじゃない！ 健全性も計測し、良い開発者体験を生むために
  2. 7
    VSCodeをUML図やフローチャート作成に使ってみよう
  3. 8
    売上か？ 面白い技術か？ エンジニア組織が直面するジレンマに、エンジニア経営者 漆原氏が切り込む
  4. 9
    計測と改善をひたすら繰り返したら、年間コストを1億円削減した──不確実性の高いプロジェクトに挑む NEW
  5. 10
    生成AI活用普及協会、「生成AIリテラシー診断」の結果を発表。生成AIリテラシ偏差値49以下が約85％に NEW

アクセスランキング

  1. 1
    デスクトップアプリを開発しよう！ 「Rust」と「Tauri 2.0」の基本情報と環境整備の仕方を解説
  2. 2
    「CUDA」　～マンガでプログラミング用語解説
  3. 3
    2024年の提示年収が高いプログラミング言語は？ paiza調査によるランキングが発表
  4. 4
    健全なソフトウェア設計の第一歩！ 既存のPHPソースコードからクラス図を自動生成しよう
  5. 5
    約9割の企業がIT人材不足を実感、「プロリア プログラミング」による調査によって明らかに NEW
  6. 6
    開発チームに必要なのは生産性だけじゃない！ 健全性も計測し、良い開発者体験を生むために
  7. 7
    VSCodeをUML図やフローチャート作成に使ってみよう
  8. 8
    売上か？ 面白い技術か？ エンジニア組織が直面するジレンマに、エンジニア経営者 漆原氏が切り込む
  9. 9
    計測と改善をひたすら繰り返したら、年間コストを1億円削減した──不確実性の高いプロジェクトに挑む NEW
  10. 10
    生成AI活用普及協会、「生成AIリテラシー診断」の結果を発表。生成AIリテラシ偏差値49以下が約85％に NEW
  1. 1
    ITエンジニア本大賞2025、投票締切直前！ みんなで選んだ歴代の大賞本を振り返って一挙紹介
  2. 2
    VSCodeをドキュメント作成に活用――テキストエディタ、Markdownエディタの設定と拡張機能を解説
  3. 3
    Python 3.13の新機能、対話型インタプリタの機能強化や高速化などを解説
  4. 4
    「CUDA」　～マンガでプログラミング用語解説
  5. 5
    今後生成AIとどう向き合うべきなのか？ 現場のエンジニアと研究者が最新研究事例から語り合う
  6. 6
    デスクトップアプリを開発しよう！ 「Rust」と「Tauri 2.0」の基本情報と環境整備の仕方を解説
  7. 7
    2024年12月に開催される注目のITエンジニア向けカンファレンス5選
  8. 8
    日本在住の英語を話すソフトウェア開発者、年収の中央値は950万円に
  9. 9
    Vue.js3.4～3.5の新機能をまとめて紹介！ 新しいAPIやSSRの改善
  10. 10
    PHPパッケージ管理ツール「Composer」の処理の仕組みを見てみよう！