REST Resource: forms

{
  "formId": string,
  "info": {
    object (Info)
  },
  "settings": {
    object (FormSettings)
  },
  "items": [
    {
      object (Item)
    }
  ],
  "revisionId": string,
  "responderUri": string,
  "linkedSheetId": string
}

string

출력 전용. 양식 ID입니다.

object (Info)

필수 항목입니다. 양식의 제목 및 설명입니다.

object (FormSettings)

양식의 설정 UpdateSettingsRequest로 업데이트해야 합니다. forms.create 및 UpdateFormInfoRequest 중에는 무시됩니다.

object (Item)

필수 항목입니다. 양식 항목 목록으로, 섹션 헤더, 질문, 삽입된 미디어 등이 포함될 수 있습니다.

string

출력 전용. 양식의 버전 ID입니다. 업데이트 요청의 WriteControl에서 사용하여 변경의 기반이 되는 버전을 식별합니다.

버전 ID의 형식은 시간이 지남에 따라 변경될 수 있으므로 불투명하게 처리되어야 합니다. 반환된 버전 ID는 반환 후 24시간 동안만 유효하며 사용자 간에 공유할 수 없습니다. 호출 간에 버전 ID가 변경되지 않은 경우 양식은 변경되지 않은 것입니다. 반대로 동일한 양식 및 사용자에 대해 변경된 ID는 일반적으로 양식이 업데이트되었음을 의미하지만 ID 형식 변경과 같은 내부 요인으로 인해 변경된 ID도 발생할 수 있습니다.

string

출력 전용. 응답자와 공유할 양식 URI입니다. 그러면 사용자가 응답을 제출할 수 있지만 질문을 수정할 수는 없는 페이지가 열립니다.

string

출력 전용. 이 양식의 응답이 누적되고 있는 연결된 Google 시트의 ID입니다 (시트가 있는 경우).

{
  "title": string,
  "documentTitle": string,
  "description": string
}

string

필수 항목입니다. 응답자에게 표시되는 양식 제목입니다.

string

출력 전용. 드라이브에 표시되는 문서의 제목입니다. Info.title가 비어 있으면 Google Forms UI에서 documentTitle가 대신 표시되고 응답자에게 표시될 수 있습니다. documentTitle는 생성 시 설정할 수 있지만 batchUpdate 요청을 통해 수정할 수 없습니다. documentTitle를 프로그래매틱 방식으로 업데이트해야 하는 경우 Google Drive API를 사용하세요.

string

양식에 대한 설명입니다.

{
  "quizSettings": {
    object (QuizSettings)
  }
}

object (QuizSettings)

퀴즈 양식 및 채점과 관련된 설정입니다.

{
  "isQuiz": boolean
}

boolean

이 양식이 퀴즈인지 여부입니다. 참인 경우 질문 Grading에 따라 응답이 채점됩니다. false로 설정하면 모든 질문 Grading가 삭제됩니다.

{
  "itemId": string,
  "title": string,
  "description": string,

  // Union field kind can be only one of the following:
  "questionItem": {
    object (QuestionItem)
  },
  "questionGroupItem": {
    object (QuestionGroupItem)
  },
  "pageBreakItem": {
    object (PageBreakItem)
  },
  "textItem": {
    object (TextItem)
  },
  "imageItem": {
    object (ImageItem)
  },
  "videoItem": {
    object (VideoItem)
  }
  // End of list of possible types for union field kind.
}

string

상품 ID입니다.

생성 시 입력할 수 있지만, 양식에 이미 사용된 ID는 사용할 수 없습니다. 제공하지 않으면 새 ID가 할당됩니다.

string

상품 제목입니다.

string

항목 설명입니다.

object (QuestionItem)

사용자에게 질문을 합니다.

object (QuestionGroupItem)

하나의 주요 프롬프트로 사용자에게 하나 이상의 질문을 던집니다.

object (PageBreakItem)

제목이 있는 새 페이지를 시작합니다.

object (TextItem)

페이지에 제목과 설명을 표시합니다.

object (ImageItem)

페이지에 이미지를 표시합니다.

object (VideoItem)

페이지에 동영상을 표시합니다.

{
  "question": {
    object (Question)
  },
  "image": {
    object (Image)
  }
}

object (Question)

필수 항목입니다. 표시된 질문입니다.

object (Image)

질문 내에 표시되는 이미지입니다.

{
  "questionId": string,
  "required": boolean,
  "grading": {
    object (Grading)
  },

  // Union field kind can be only one of the following:
  "choiceQuestion": {
    object (ChoiceQuestion)
  },
  "textQuestion": {
    object (TextQuestion)
  },
  "scaleQuestion": {
    object (ScaleQuestion)
  },
  "dateQuestion": {
    object (DateQuestion)
  },
  "timeQuestion": {
    object (TimeQuestion)
  },
  "fileUploadQuestion": {
    object (FileUploadQuestion)
  },
  "rowQuestion": {
    object (RowQuestion)
  }
  // End of list of possible types for union field kind.
}

string

읽기 전용입니다. 질문 ID입니다.

생성 시 입력할 수 있지만, 양식에 이미 사용된 ID는 사용할 수 없습니다. 제공하지 않으면 새 ID가 할당됩니다.

boolean

응답자가 응답을 제출하기 위해 질문에 답해야 하는지 여부입니다.

object (Grading)

질문에 대한 채점 설정입니다.

object (ChoiceQuestion)

응답자는 사전 정의된 옵션 세트 중에서 선택할 수 있습니다.

object (TextQuestion)

응답자는 자유 텍스트 응답을 입력할 수 있습니다.

object (ScaleQuestion)

응답자는 범위에서 숫자를 선택할 수 있습니다.

object (DateQuestion)

응답자가 날짜를 입력할 수 있습니다.

object (TimeQuestion)

응답자는 시간을 입력할 수 있습니다.

object (FileUploadQuestion)

응답자는 하나 이상의 파일을 업로드할 수 있습니다.

object (RowQuestion)

QuestionGroupItem의 행입니다.

{
  "type": enum (ChoiceType),
  "options": [
    {
      object (Option)
    }
  ],
  "shuffle": boolean
}

enum (ChoiceType)

필수 항목입니다. 선택 질문의 유형입니다.

object (Option)

필수 항목입니다. 응답자가 선택해야 하는 옵션 목록입니다.

boolean

퀴즈의 여러 인스턴스에 대해 옵션을 임의의 순서로 표시할지 여부입니다. 이는 다른 응답자의 화면을 보고 있는 응답자의 속임수를 방지하거나 항상 동일한 옵션을 먼저 또는 마지막에 배치함으로써 도입될 수 있는 설문조사의 편향을 해결하는 데 사용됩니다.

{
  "value": string,
  "image": {
    object (Image)
  },
  "isOther": boolean,

  // Union field go_to_section can be only one of the following:
  "goToAction": enum (GoToAction),
  "goToSectionId": string
  // End of list of possible types for union field go_to_section.
}

string

필수 항목입니다. 사용자에게 표시되는 선택 사항입니다.

object (Image)

옵션으로 이미지를 표시합니다.

boolean

옵션이 '기타'인지 여부입니다. 현재 RADIO 및 CHECKBOX 선택 유형에만 적용되지만 QuestionGroupItem에서는 허용되지 않습니다.

enum (GoToAction)

섹션 탐색 유형입니다.

string

이동할 섹션 헤더의 항목 ID입니다.

{
  "contentUri": string,
  "altText": string,
  "properties": {
    object (MediaProperties)
  },

  // Union field image_source can be only one of the following:
  "sourceUri": string
  // End of list of possible types for union field image_source.
}

string

출력 전용. 이미지를 다운로드할 수 있는 URI입니다. 제한된 시간 동안만 유효합니다.

string

마우스를 가져가면 표시되고 스크린 리더가 읽는 이미지에 관한 설명입니다.

object (MediaProperties)

이미지의 속성입니다.

string

입력 전용. 소스 URI는 이미지를 삽입하는 데 사용되는 URI입니다. 소스 URI는 가져올 때 비어 있을 수 있습니다.

{
  "alignment": enum (Alignment),
  "width": integer
}

enum (Alignment)

미디어의 위치입니다.

integer

미디어의 너비(픽셀)입니다. 미디어가 표시되면 이 값 또는 표시된 양식의 너비 중 더 작은 값으로 조정됩니다. 미디어의 원래 가로세로 비율은 유지됩니다. 양식에 미디어를 추가할 때 너비를 지정하지 않으면 미디어 소스의 너비로 설정됩니다. 너비는 0 이상, 740 이하여야 합니다. 너비를 0으로 설정하거나 지정하지 않으면 미디어 소스를 업데이트할 때만 허용됩니다.

{
  "paragraph": boolean
}

boolean

질문이 서술형 질문인지 여부를 나타냅니다. 그렇지 않은 경우 질문은 짧은 텍스트 질문입니다.

{
  "low": integer,
  "high": integer,
  "lowLabel": string,
  "highLabel": string
}

integer

필수 항목입니다. 배율의 가능한 가장 낮은 값입니다.

integer

필수 항목입니다. 배율에 사용할 수 있는 가장 높은 값입니다.

string

체중계의 가장 낮은 지점을 설명하는 표시할 라벨입니다.

string

척도에서 가장 높은 지점을 설명하는 표시할 라벨입니다.

{
  "includeTime": boolean,
  "includeYear": boolean
}

boolean

질문에 시간을 포함할지 여부입니다.

boolean

질문에 연도를 포함할지 여부입니다.

{
  "duration": boolean
}

boolean

질문이 경과된 시간에 관한 경우 true 그 외의 경우에는 하루 중 특정 시간입니다.

{
  "folderId": string,
  "types": [
    enum (FileType)
  ],
  "maxFiles": integer,
  "maxFileSize": string
}

string

필수 항목입니다. 업로드된 파일이 저장된 Drive 폴더의 ID입니다.

enum (FileType)

이 질문에서 허용되는 파일 형식입니다.

integer

단일 응답에서 이 질문에 대해 업로드할 수 있는 최대 파일 수입니다.

string (int64 format)

이 질문에 업로드된 모든 파일에 허용되는 최대 바이트 수입니다.

{
  "title": string
}

string

필수 항목입니다. QuestionGroupItem에 있는 단일 행의 제목입니다.

{
  "pointValue": integer,
  "correctAnswers": {
    object (CorrectAnswers)
  },
  "whenRight": {
    object (Feedback)
  },
  "whenWrong": {
    object (Feedback)
  },
  "generalFeedback": {
    object (Feedback)
  }
}

integer

필수 항목입니다. 응답자가 정답에 대해 자동으로 받을 수 있는 최대 포인트입니다. 음수는 입력할 수 없습니다.

object (CorrectAnswers)

필수 항목입니다. 질문의 답안입니다. 응답은 이 입력란을 바탕으로 자동 채점됩니다.

object (Feedback)

정답을 위해 표시되는 의견입니다. 이 피드백은 정답이 있는 객관식 질문에만 설정할 수 있습니다.

object (Feedback)

오답인 경우 표시되는 의견입니다. 이 피드백은 정답이 있는 객관식 질문에만 설정할 수 있습니다.

object (Feedback)

모든 답변에 대해 표시되는 의견입니다. 퀴즈 소유자가 답변을 공식적으로 채점하기 전에 응답자가 질문에 올바르게 답변했는지 여부를 빠르게 알 수 있도록 하려는 경우 단답형 질문에 일반적으로 사용됩니다. 자동으로 채점되는 객관식 질문에는 일반 의견을 설정할 수 없습니다.

{
  "answers": [
    {
      object (CorrectAnswer)
    }
  ]
}

object (CorrectAnswer)

정답 목록입니다. 이 답변에 따라 퀴즈 응답이 자동으로 채점될 수 있습니다. 단일 값 질문의 경우 답변이 이 목록의 값과 일치하면 정답으로 표시됩니다 (즉, 여러 개의 정답이 있을 수 있음). 다중 값 (CHECKBOX) 질문의 경우 응답에 이 목록의 값이 정확하게 포함되어 있으면 정답으로 표시됩니다.

{
  "value": string
}

string

필수 항목입니다. 정답 값입니다. 다양한 값 유형의 형식이 지정되는 방식에 관한 자세한 내용은 TextAnswer.value 문서를 참고하세요.

{
  "questions": [
    {
      object (Question)
    }
  ],
  "image": {
    object (Image)
  },

  // Union field kind can be only one of the following:
  "grid": {
    object (Grid)
  }
  // End of list of possible types for union field kind.
}

object (Question)

필수 항목입니다. 이 질문 그룹에 속하는 질문 목록입니다. 질문은 하나의 그룹에만 속해야 합니다. 그룹의 kind에 따라 허용되는 질문 유형이 달라질 수 있습니다.

object (Image)

특정 질문 위의 질문 그룹 내에 표시되는 이미지입니다.

object (Grid)

질문 그룹은 동일한 옵션을 공유하는 객관식 질문 행이 나열된 그리드입니다. grid가 설정되면 그룹의 모든 질문은 row 종류여야 합니다.

{
  "columns": {
    object (ChoiceQuestion)
  },
  "shuffleQuestions": boolean
}

object (ChoiceQuestion)

필수 항목입니다. 그리드의 각 질문에서 공유한 선택 항목입니다. 즉, 열의 값입니다. CHECK_BOX 및 RADIO 옵션만 허용됩니다.

boolean

true인 경우 질문이 무작위로 정렬됩니다. 즉, 응답자마다 행이 다른 순서로 표시됩니다.

{
  "image": {
    object (Image)
  }
}

object (Image)

필수 항목입니다. 상품에 표시된 이미지입니다.

{
  "video": {
    object (Video)
  },
  "caption": string
}

object (Video)

필수 항목입니다. 항목에 표시된 동영상입니다.

string

동영상 아래에 표시되는 텍스트입니다.

{
  "youtubeUri": string,
  "properties": {
    object (MediaProperties)
  }
}

string

필수 항목입니다. YouTube URI입니다.

object (MediaProperties)

동영상의 속성입니다.