개요

Google Forms API는 양식을 만들고 수정할 수 있는 RESTful 인터페이스입니다. 퀴즈, 양식 응답 및 퀴즈 성적 검색, 퀴즈 답안 설정 자동 피드백 및 푸시 알림 기능을 제공할 수 있습니다 가장 일반적인 용도 이 API에는 다음 작업이 포함됩니다.

  • 양식 또는 퀴즈 만들기
  • 양식 또는 퀴즈 업데이트
  • 양식 또는 퀴즈에서 응답 가져오기
  • 양식 콘텐츠 및 메타데이터 읽기
  • 푸시 알림 설정 및 수신

다음은 Forms API에서 사용되는 일반적인 용어 목록입니다.

양식

Drive에 생성되어 저장된 Google Forms 문서. 각 양식은 Form 리소스로 표현 문자, 숫자, 하이픈 또는formId 밑줄로 표시됩니다. Google Forms URL에서 양식 ID를 확인할 수 있습니다.

https://docs.google.com/forms/d/FORM_ID/edit

퀴즈

과제 점수를 평가할 수 있는 특정 유형의 Google Forms 형식 응답을 생성할 수 있습니다. 퀴즈는 batchUpdate() 메서드를 사용하여 기존 양식의 isQuiz 설정을 true로 업데이트합니다.

평가
질문에 대한 점수, 답안, 의견 현재 isQuiz이(가) true입니다. 표시 대상: Grading 리소스
의견
퀴즈에서 질문에 답할 때 최종 사용자에게 제공되는 응답 Feedback로 표현 리소스도 제공합니다
항목

양식의 단일 요소는 Item 리소스 유형을 지원합니다. Item: 섹션, 질문 그룹, 질문, 광고를 게재할 수 있습니다

질문

양식의 단일 질문은 Question 리소스

질문 그룹

가능한 답변이 모두 동일한 질문 그룹입니다( 1부터 5까지의 평점 그리드)을 표시합니다. 표시 대상: QuestionGroupItem 리소스도 제공합니다

Section

섹션은 양식을 여러 페이지로 나누고 조건부 논리 (예: 사용자 답변). 섹션은 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"
              }
            ]
          }
        }
      }
    }
  ]
}

다음 단계