このページでは、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 には、スクリプトで Google フォームの作成、アクセス、変更を可能にする既存の フォーム サービスが用意されています。ただし、Apps Script から直接 Forms API を使用する場合は、次のように OAuth アクセスを設定します。
スコープが設定され、認証済みの OAuth アクセス トークンを取得します。
ScriptApp.getOAuthToken();API への REST 呼び出しで指定する options 引数に OAuth トークンを含めます。
UrlFetchApp.fetch(Url, options);
実際にこの方法を使用する例については、Apps Script プロジェクトを設定するをご覧ください。設定ガイドでは、API の呼び出しに必要な基本的なプラグインの詳細について説明しています。ただし、エンドユーザーが API に直感的にアクセスできるようにするには、サンプル ウェブアプリを試して変更することもできます。
ウェブアプリの使用例
デモ用に、すべての Forms API メソッドを直接呼び出す完全なサンプル ウェブアプリが GitHub で公開されています。
ウェブアプリの実行
プロジェクトを設定してウェブアプリとしてデプロイしたら、基本的な操作を試すことができます。
[フォームを作成] ボタンをクリックして、新しいフォームを作成します。
新しいフォームが [フォーム ID:] フィールドに表示され、[フォームで開く] をクリックして開くことができます。
新しいフォームを別のウィンドウで開き、いくつかの質問を手動で追加して、[Get Form by Id] をクリックします。右側の JSON 出力に新しい質問が表示されます。
アプリで利用可能な他のメソッドを試し、各オペレーションの右側の出力を確認してください。
フォームのウォッチの操作
フォームのウォッチ用のボタンも確認してください。これらは、Forms API のウォッチ機能を使用して、ウォッチの作成、一覧表示、削除、更新などの基本的なオペレーションを実行します。これらのトピックを使用するには、Cloud Pub/Sub トピックを含むプロジェクトを設定する必要があります。
Forms API ウォッチと Cloud Pub/Sub の詳細については、プッシュ通知を設定して受信するをご覧ください。
次のステップ
サンプルアプリをニーズに合わせてカスタマイズしてみてください。いくつか例を挙げましょう。
- Google スプレッドシートに問題バンクを作成し、Apps Script の SpreadsheetApp サービスを使用してスプレッドシートから問題を取得し、新しいフォームに入力します。
- または、質問バンクを SQL データベースに配置し、Apps Script の JDBC サービスを使用して、データベースの質問をフォームに入力することもできます。
- クイズを生成し、スコアを Google スプレッドシートの成績簿に保存する。
- Cloud Pub/Sub でプロジェクトを設定し、watches 機能を使用してリアルタイムの生徒のリーダーボードを生成して、クイズの結果を表示します。