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
로 업데이트합니다.- 항목
양식의 단일 요소는 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"
}
]
}
}
}
}
]
}
다음 단계
- Google Workspace API를 사용한 개발에 대해 알아보고 자세히 알아보려면 Workspace 개발자로 시작하기
- 간단한 Forms API 앱을 구성하고 실행하는 방법을 알아보려면 빠른 시작 개요