概要

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 に更新します。

採点
質問の点数、解答集、フィードバックは、次の場合に適用されます。 isQuiztrue です。で表される Grading リソース。
フィードバック
クイズの質問に回答する際にエンドユーザーに与えられる回答。 Feedback で表されます。 リソースです。
項目

「.」で表される、フォーム内の単一の要素。 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"
              }
            ]
          }
        }
      }
    }
  ]
}

次のステップ