このページでは、Google Forms API 用の Apps Script ウェブアプリの例の概要を説明します。
前提条件
- Google Cloud プロジェクトで Forms API を有効にします。
- サンプル ウェブアプリの GitHub README ファイルの説明に沿って、新しい Apps Script プロジェクトを設定します。
概要
Forms API を使用すると、認証されたクライアントは REST を使用して API に直接アクセスできます。
Apps Script では、有効な OAuth アクセス トークンの取得と REST 呼び出しの両方を簡単に行えるため、Apps Script を Forms API と直接統合するのは簡単です。Apps Script にはすでに Forms Service が用意されており、スクリプトで Google フォームの作成、アクセス、変更を行うことができます。ただし、Apps Script から直接 Forms API を使用する場合は、次のように OAuth アクセスを設定します。
スコープが設定された認証済みの OAuth アクセス トークンを取得します。
ScriptApp.getOAuthToken();
API への REST 呼び出しで提供される options 引数に OAuth トークンを含めます。
UrlFetchApp.fetch(Url, options);
実際の例については、Apps Script プロジェクトを設定するをご覧ください。設定ガイドでは、API を呼び出すために必要な基本的な仕組みを詳しく説明しています。ただし、エンドユーザーが API に直感的にアクセスできるように、サンプル ウェブアプリを試して変更することもできます。
ウェブアプリの使用例
Forms API のすべてのメソッドを直接呼び出すウェブアプリの完全なサンプルが、デモ用に GitHub で入手できます。
ウェブアプリの実行
プロジェクトを設定してウェブアプリとしてデプロイしたら、いくつかの基本的なオペレーションを試すことができます。
[Create Form] ボタンをクリックして新しいフォームを作成します。
新しいフォームが [フォーム ID] フィールドに表示されます。[フォームで開く] をクリックすると開きます。
新しいフォームを別のウィンドウで開いた後、いくつかの質問を手動で追加し、[Get Form by Id] をクリックすると、右側の JSON 出力に新しい質問が表示されます。
アプリで使用可能な他のメソッドを試し、各オペレーションの右側にある出力を確認してください。
フォームのスマートウォッチの操作
フォーム watch のボタンにも注目してください。これらは、Forms API の watch 機能を使用し、watch の作成、一覧表示、削除、更新を行うための基本的なオペレーションを実行します。使用するには、Cloud Pub/Sub トピックを含むプロジェクトを設定する必要があります。
Forms API のスマートウォッチと Cloud Pub/Sub の詳細については、プッシュ通知の設定と受信をご覧ください。
次のステップ
サンプルアプリをニーズに合わせてカスタマイズしてみてください。いくつか例を示します。
- Google スプレッドシートで質問バンクを作成し、Apps Script の SpreadsheetApp サービスを使用して、スプレッドシートから質問を取得して新しいフォームに自動入力します。
- また、SQL データベースに質問群を保存することもできます。SQL データベースでは、Apps Script の JDBC サービスを使用して、データベースの質問をフォームに入力できます。
- テストを生成し、Google スプレッドシートの採点簿にスコアを保存します。
- Cloud Pub/Sub でプロジェクトを設定し、ウォッチ機能を使用して、クイズの結果を表示するリアルタイムの生徒リーダーボードを生成します。