Google Forms API は、フォームの作成と変更を可能にする RESTful インターフェースです フォームの回答とテストの成績の取得、テストの解答キーの設定 プッシュ通知を受信できます。最も一般的な用途 この API には、次のタスクが含まれます。
- フォームやテストを作成する
- フォームやテストを更新する
- フォームやクイズから回答を取得する
- フォームのコンテンツとメタデータを読み取る
- プッシュ通知を設定して受信する
次に、Forms API で使用される一般的な用語を示します。
- フォーム
Google フォームで作成され、ドライブに保存されたドキュメント。各フォームは
Form
リソースで表されます。 かつ、文字、数字、ハイフン、formId
使用します。フォーム ID は Google フォームの URL で確認できます。https://docs.google.com/forms/d/FORM_ID/edit
- クイズ
特定の Google フォーム形式のドキュメントで、特定の課題の採点に利用できます。 解答集と照合します。クイズを作成するには、
batchUpdate()
メソッドを使用して、既存のフォームのisQuiz
設定をtrue
に更新します。- 項目
「.」で表される、フォーム内の単一の要素。 Item リソース。
Item
は 繰り返し要素には、セクション、質問グループ、質問、 テキスト、画像、動画などです- 質問
フォーム上の単一の質問。
Question
リソース。- 質問グループ
すべての質問に対して同じ回答が考えられるグループ。 (例: 1 ~ 5 の評価のグリッド)です。で表される
QuestionGroupItem
リソースです。- セクション
セクションは、フォームを複数のページに分割し、 条件付きロジック(たとえば、リクエストに基づいて特定の質問のみを表示する、 あります。セクションは、
PageBreakItem
リソースです。- 回答
質問に対するエンドユーザーの回答。
Answer
リソースです。成績情報(存在する場合)、メタデータ、 引き出されます。- レスポンス
エンドユーザーによるフォームの送信。
FormResponse
リソース。- スマートウォッチ
フォーム スキーマの変更(編集など)に対する変更を追跡するトリガー フォームの回答の送信に自動対応し、 発生します。で表される
Watch
リソース。
フォームの構造
フォームやテストを管理する際の各種フィールドの指定方法を理解していること
多くのフォーム オブジェクトを内部にネストできることを考えると、複雑になる場合がある
相互に通信できます。フォームの視覚的な表現がどのように
マッピングされるため、UI を使用していくつかの例を
定義できます。次に、対応する JSON を取得します。
forms.get()
メソッドを使用
比較することができます。たとえば
この例のクイズは、次の JSON に対応しています。
{
"formId": "FORM_ID",
"info": {
"title": "Famous Black Women",
"description": "Please complete this quiz based off of this week's readings for class.",
"documentTitle": "API Example Quiz"
},
"settings": {
"quizSettings": {
"isQuiz": true
}
},
"revisionId": "00000021",
"responderUri": "https://docs.google.com/forms/d/e/1FAIpQLSd0iBLPh4suZoGW938EU1WIxzObQv_jXto0nT2U8HH2KsI5dg/viewform",
"items": [
{
"itemId": "5d9f9786",
"imageItem": {
"image": {
"contentUri": "DIRECT_URL",
"properties": {
"alignment": "LEFT"
}
}
}
},
{
"itemId": "72b30353",
"title": "Which African American woman authored \"I Know Why the Caged Bird Sings\"?",
"questionItem": {
"question": {
"questionId": "25405d4e",
"required": true,
"grading": {
"pointValue": 2,
"correctAnswers": {
"answers": [
{
"value": "Maya Angelou"
}
]
}
},
"choiceQuestion": {
"type": "RADIO",
"options": [
{
"value": "Maya Angelou"
},
{
"value": "bell hooks"
},
{
"value": "Alice Walker"
},
{
"value": "Roxane Gay"
}
]
}
}
}
},
{
"itemId": "0a4859c8",
"title": "Who was the first Dominican-American woman elected to state office?",
"questionItem": {
"question": {
"questionId": "37fff47a",
"grading": {
"pointValue": 2,
"correctAnswers": {
"answers": [
{
"value": "Grace Diaz"
}
]
}
},
"choiceQuestion": {
"type": "RADIO",
"options": [
{
"value": "Rosa Clemente"
},
{
"value": "Grace Diaz"
},
{
"value": "Juana Matias"
},
{
"value": "Sabrina Matos"
}
]
}
}
}
}
]
}
次のステップ
- Google Workspace API を使用した開発(処理方法、 については、コースのリソースをご覧ください。 Workspace デベロッパーの方はこちらをご覧ください。
- シンプルな Forms API アプリを構成して実行する方法については、 クイックスタートの概要