Googleカレンダー APIを実装するために必要な事前知識を習得したい

Ruby on Railsで作成したアプリケーション（スケジュール管理アプリ）にGoogleカレンダーAPIを導入し、
アプリケーションのスケジュールとGoogleカレンダーを同期したいです。

上記を実装するためGoogleカレンダーのチュートリアルを読んだのですが、現状全く理解ができませんでした。よって実装するために必要となる知識を効果的に学習したいのですが、これから学習することが本当に解決につながるかの明確な自信が持てません。下記の勉強法に加えてこれはやっておけ等ございましたら、ご教示いただけますと幸いです。よろしくお願いいたします。

現状の知識レベル
・Ruby on Rails チュートリアルは学習済み
・外部AIPはStripeで実装経験あり
※Qiitaをほぼ丸パクリですが

参照したチュートリアル
https://developers.google.com/calendar/quickstart/ruby?hl=ja

実行予定の学習
書籍 Web API The Good Parts
https://www.amazon.co.jp/exec/obidos/asin/4873116864/?tag=maftracking205475-22&linkCode=ure&creative=6339

ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー
内容不足により追加した点

実施したこと
・上記のチュートリアルは実施済み。putsメソッドでターミナル上にグーグルカレンダーの今後の予定を表示することができた。

理解できていない点
・APIが何かをできていない（コチラに関しては上記の書籍で概ね理解できるのではと考えている）
・チュートリアル内サンプルコードが何を実行しているか把握できていない。そもそもどこを参考にコードを読めばよいかわからない
↓例　(チュートリアルのサンプルコード：６行目の"urn:ietf:wg:oauth:2.0:oob")

rb
1require "google/apis/calendar_v3"
2require "googleauth"
3require "googleauth/stores/file_token_store"
4require "date"
5require "fileutils"
6
7OOB_URI = "urn:ietf:wg:oauth:2.0:oob".freeze
8APPLICATION_NAME = "Google Calendar API Ruby Quickstart".freeze
9CREDENTIALS_PATH = "credentials.json".freeze
10# The file token.yaml stores the user's access and refresh tokens, and is
11# created automatically when the authorization flow completes for the first
12# time.
13TOKEN_PATH = "token.yaml".freeze
14SCOPE = Google::Apis::CalendarV3::AUTH_CALENDAR_READONLY
15
16

nskydiving

2020/03/23 02:33

>現状全く理解ができませんでした。このチュートリアルは実際に動かしてみたのでしょうか？まずは何が理解できなかったのかを整理すべきかと思います。何が分かっていないのかも分からない状態では、回答者もアドバイスのしようがないと思いますので。

koki0502

2020/03/23 12:00

仰る通りでした。ご指摘いただきましてありがとうございます。今回だけではなく、今後の参考にさせていただきます。ありがとうございます！

行動規範の内容に同意します

回答1件

ベストアンサー

・APIが何かをできていない（コチラに関しては上記の書籍で概ね理解できるのではと考えている）

「Web API」で Google 検索すると、いくつか API の解説サイトが見つかります。

また、「Web API The Good Parts」は良書だとは思いますが、この書籍は API の設計、開発、運用についての解説書ですので、期待している内容とはちょっと違うかもしれません。

・チュートリアル内サンプルコードが何を実行しているか把握できていない。そもそもどこを参考にコードを読めばよいかわからない
↓例　(チュートリアルのサンプルコード：６行目の"urn:ietf:wg:oauth:2.0:oob")

「urn:ietf:wg:oauth:2.0:oob」で Google 検索すると、すぐに以下のサイトが見つかります。

OAuth 2.0 Flow: Installed apps | YouTube Data API | Google Developers
https://developers.google.com/youtube/v3/guides/auth/installed-apps?hl=ja

urn:ietf:wg:oauth:2.0:oob
この値は、Google の承認サーバーが承認コードをブラウザのタイトルバーに返すことを指定します。このオプションは、クライアントの設定を大幅に変更しないとクライアントで HTTP ポートをリスンできない場合に便利です。Windows アプリケーションはこれに該当します。

この値を使用する場合、ブラウザが承認サーバーからレスポンスを読み込んだことをアプリケーションで認識できる必要があります。その後、アプリケーションがブラウザのページタイトルから承認コードを抽出します。ページタイトルからトークンを解析する手順については、ステップ 4 を参照してください。

承認コードを含むページがユーザーに表示されないようにする場合は、アプリケーションがブラウザウィンドウを閉じるようにする必要もあります。ブラウザウィンドウを閉じるメカニズムはプラットフォームによって異なります。

基本的な情報は、Google Calendar API の「ガイド」や「リファレンス」を読めば良いと思いますが、見つからない場合は Google で検索した方が早く情報に辿り着けることが多いと思います。

投稿2020/03/25 08:32

nskydiving

総合スコア6500