勉強会の流れ Google API の概要デモ curl で実際に体験 Copyright 2010 SRA OSS, Inc. Japan All rights reserved. 2

Size: px

Start display at page:

はるまさおうじ
5 years ago
Views:

1 Google API 勉強会 SRA OSS, Inc. 日本支社山本博之 2010 年 12 月 13 日

4 Google API の概要データの形式は Atom (XML) ベースデータの通信は HTTP / HTTPS Google の各種サービスに対してAPIを提供 : Google カレンダー Google ドキュメント Google マップ Picasa Web アルバム YouTube... Copyright 2010 SRA OSS, Inc. Japan All rights reserved. 4

5 Google Data API どのサービスの API も Google Data API に基づくデータの問い合わせ追加更新などを XML で表現し HTTP で送信する XML で送られてきたレスポンスを受け取り解析する基本的にはこれだけ Java, JavaScript,.NET, PHP, Python, Objective-C については Google がライブラリを提供 Copyright 2010 SRA OSS, Inc. Japan All rights reserved. 5

7 ClientLogin による認証ユーザ ID とパスワードを送信 ( サービスによっては CAPTCHA 要求 ) トークン文字列が返ってくる (Auth=...) 以降このトークンを使ってデータを要求 ClientLogin のメリット : 毎回認証する必要がないので性能が向上するセキュリティのリスクが軽減される Copyright 2010 SRA OSS, Inc. Japan All rights reserved. 7

9 curl で ClientLogin 認証 curl \ -d =hogehoge@gmail.com \ -d Passwd=password \ -d source=sraoss-sylpheed-2.0 \ -d service=cl Google カレンダーを指定結果 : SID=DQAAAHYBADCv2pSv7nflac... LSID=EUBBBIaBADCl-kNxvRVmc... Auth=EUBBIacAAADK-kNxvRVmc... これを使う Copyright 2010 SRA OSS, Inc. Japan All rights reserved. 9

11 Google カレンダーのデータを取得 e/basic ( デフォルトのカレンダー ) カレンダー ID>/private/basic ( カレンダー ID を指定 ) カレンダー ID>/private-<magic>/basic ( 認証なしで取得可能 ) カレンダー ID>/private-<magic>/basic.ics (icalendar 形式 ) マイカレンダー対象カレンダー設定限定公開 URL Copyright 2010 SRA OSS, Inc. Japan All rights reserved. 11

12 デフォルトのカレンダーを取得する curl --header \ "Authorization: GoogleLogin auth=< トークン >" \ Moved Temporarily が返ってくるので URL を転送先に変えて再度実行 curl --header \ "Authorization: GoogleLogin auth=< トークン >" \ gsessionid=cpwkjb-7x6neabc2qjzna Copyright 2010 SRA OSS, Inc. Japan All rights reserved. 12

13 取得したカレンダーのデータ ( 抜粋 ) <?xml version='1.0' encoding='utf-8'?> <feed xmlns=' xmlns:opensearch=' xmlns:gcal=' <id> <updated> t13:24:58.000z</updated> <title type='text'>hiroyuki Yamamoto</title> <subtitle type='text'>hiroyuki Yamamoto</subtitle> <author><name>hiroyuki Yamamoto</name>< >hiroyuki.yamamoto@gmail.com</ ></author> <generator version='1.0' uri=' Calendar</generator> <entry> <id> <published> t13:24:57.000z</published> <updated> t13:24:57.000z</updated> <category scheme=' term=' <title type='html'> 予定タイトル </title> <summary type='html'> 期間 : 2010/12/04 (土) 11:00~12:00</summary> <content type='html'> 期間 : 2010/12/04 ( 土 ) 11:00~12:00</content> <author><name>hiroyuki Yamamoto</name>< >hiroyuki.yamamoto@gmail.com</ ></author> </entry> </feed> Copyright 2010 SRA OSS, Inc. Japan All rights reserved. 13

16 カレンダーに予定を追加 1. 以下の内容の XML ファイルを UTF-8 で作成する <entry xmlns=' xmlns:gd=' <category scheme=' term=' /> <title type='text'> 予定の名前 </title> <content type='text'> 予定の詳細 </content> <gd:transparency value=' </gd:transparency> <gd:eventstatus value=' </gd:eventstatus> <gd:where valuestring=' 予定の場所 '></gd:where> <gd:when starttime=' t09:00:00.000z' endtime=' t11:00:00.000z'></gd:when> </entry> 入力が面倒な方は以下から取ってください : Copyright 2010 SRA OSS, Inc. Japan All rights reserved. 16

17 各要素の意味 <entry> <title type='text'> 予定の名前 </title> <content type='text'> 予定の詳細 </content> <gd:transparency 予定ありとして見えるかどうか /> <gd:visibility 公開するかどうか (public/private) /> <gd:where valuestring=' 予定の場所 ' /> <gd:who ='...' valuestring=' 参加者 ' /> <gd:when starttime=' 開始時刻 ' endtime=' 終了時刻 ' /> ( <gd:recurrence> 繰り返し予定 </gd:recurrence> ) </entry> Copyright 2010 SRA OSS, Inc. Japan All rights reserved. 17

18 カレンダーに予定を追加 2. POST メソッドで HTTP リクエストを投げる curl --request POST \ --header "Expect:" \ --header "Content-Type: application/atom+xml" \ --header \ "Authorization: GoogleLogin auth=< トークン >" \ --data-binary "@path/to/study-entry.xml" \ ull Copyright 2010 SRA OSS, Inc. Japan All rights reserved. 18

20 JSON-C 形式その他 Atom XML 形式の代わりに JSON-C という形式が使える XML に比べて人間が読みやすい URL に alt=jsonc クエリパラメータを追加する { "data": { "title": "Tennis with Beth", "details": "Meet for a quick lesson.", "transparency": "opaque", "status": "confirmed", "location": "Rolling Lawn Courts", "when": [ { "start": " T15:00:00.000Z", "end": " T17:00:00.000Z" } ] } } Copyright 2010 SRA OSS, Inc. Japan All rights reserved. 20

21 その他バッチ処理一回のリクエストで複数の処理をまとめて高速に行えるクエリ追加更新削除 XML のみで利用可能 (JSON-C では使えない ) <feed> </feed> <entry> </entry> <entry> </entry> <batch:id>insert01</batch:id> <batch:operation type='insert' />... <batch:id>update01</batch:id> <batch operation type='update' />... Copyright 2010 SRA OSS, Inc. Japan All rights reserved. 21

22 参考 URL Google カレンダーの API とツール Data API Developer's Guide pers_guide.html Protocol Guide, Atom Reference Google Data API Using curl to interact with Google Data services Copyright 2010 SRA OSS, Inc. Japan All rights reserved. 22

intra-mart Accel Platform

intra-mart Accel Platform 目次目次 Copyright 2014 NTT DATA INTRAMART CORPORATION クイック検索検索 1 Top 目次改訂情報はじめに本書の目的対象読者本書の構成概要 OAuthとはで提供している認証フロー認可コードによる認可インプリシットグラントアクセストークンの更新で提供しているエンドポイントアクセストークンの有効期限と更新方法アクセストークンの有効期限の設定方法 2 改訂情報

勉強会の流れ Google API の概要 デモ curl で実際に体験 Copyright 2010 SRA OSS, Inc. Japan All rights reserved. 2

勉強会の流れ Google API の概要デモ curl で実際に体験 Copyright 2010 SRA OSS, Inc. Japan All rights reserved. 2