- Recurso: Formulario
- Información
- FormSettings
- QuizSettings
- Elemento
- QuestionItem
- Pregunta
- ChoiceQuestion
- ChoiceType
- Opción
- GoToAction
- Imagen
- MediaProperties
- Alineación
- TextQuestion
- ScaleQuestion
- DateQuestion
- TimeQuestion
- FileUploadQuestion
- FileType
- RowQuestion
- Calificaciones
- CorrectAnswers
- CorrectAnswer
- QuestionGroupItem
- Cuadrícula
- PageBreakItem
- TextItem
- ImageItem
- VideoItem
- Video
- Métodos
Recurso: Formulario
Un documento de Formularios de Google Se crea un formulario en Drive, y se borra o se cambia sus protecciones de acceso mediante la API de Drive.
Representación JSON |
---|
{ "formId": string, "info": { object ( |
Campos | |
---|---|
formId |
Solo salida. El ID del formulario. |
info |
Obligatorio. Es el título y la descripción del formulario. |
settings |
La configuración del formulario. Se debe actualizar con |
items[] |
Obligatorio. Una lista de los elementos del formulario, que puede incluir encabezados de sección, preguntas, contenido multimedia incorporado, etcétera. |
revisionId |
Solo salida. El ID de revisión del formulario. Se usa en El formato del ID de revisión puede cambiar con el tiempo, por lo que debe tratarse de manera opaca. Solo se garantiza que un ID de revisión que se muestra es válido durante 24 horas después de mostrarse y no se puede compartir entre los usuarios. Si el ID de revisión no cambia entre llamadas, entonces el formulario no ha cambiado. Por el contrario, un ID modificado (para el mismo formulario y usuario) generalmente significa que se actualizó el formulario. Sin embargo, un ID modificado también puede deberse a factores internos, como cambios en el formato del ID. |
responderUri |
Solo salida. El URI del formulario que se compartirá con las personas que responden. Se abrirá una página en la que el usuario puede enviar respuestas, pero no editar las preguntas. |
linkedSheetId |
Solo salida. El ID de la hoja de cálculo de Google vinculada que acumula respuestas de este formulario (si existe). |
Información
Es la información general de un formulario.
Representación JSON |
---|
{ "title": string, "documentTitle": string, "description": string } |
Campos | |
---|---|
title |
Obligatorio. El título del formulario que es visible para las personas que responden. |
documentTitle |
Solo salida. El título del documento que se puede ver en Drive. Si el campo |
description |
Es la descripción del formulario. |
FormSettings
La configuración de un formulario.
Representación JSON |
---|
{
"quizSettings": {
object ( |
Campos | |
---|---|
quizSettings |
La configuración relacionada con los formularios de cuestionarios y las calificaciones. |
QuizSettings
La configuración relacionada con los formularios de cuestionarios y las calificaciones. Se deben actualizar con UpdateSettingsRequest.
Representación JSON |
---|
{ "isQuiz": boolean } |
Campos | |
---|---|
isQuiz |
Si este formulario es un cuestionario o no Si es verdadero, las respuestas se califican en función de la pregunta |
Elemento
Es un elemento único del formulario. kind
define qué tipo de elemento es.
Representación JSON |
---|
{ "itemId": string, "title": string, "description": string, // Union field |
Campos | |
---|---|
itemId |
Es el ID del artículo. Se puede proporcionar durante la creación, pero el ID no debe estar en uso en el formulario anteriormente. Si no se proporciona, se asigna uno nuevo. |
title |
Es el título del artículo. |
description |
Es la descripción del artículo. |
Campo de unión kind . Obligatorio. Este es el tipo de elemento. kind puede ser solo uno de los siguientes: |
|
questionItem |
Plantea una pregunta al usuario. |
questionGroupItem |
Plantea una o más preguntas al usuario con un solo mensaje principal. |
pageBreakItem |
Inicia una página nueva con un título. |
textItem |
Muestra un título y una descripción en la página. |
imageItem |
Muestra una imagen en la página. |
videoItem |
Muestra un video en la página. |
QuestionItem
Un elemento de formulario que contiene una sola pregunta.
Representación JSON |
---|
{ "question": { object ( |
Campos | |
---|---|
question |
Obligatorio. La pregunta que se muestra |
image |
Es la imagen que se muestra en la pregunta. |
Pregunta
¿Tienes alguna pregunta? El tipo específico de pregunta se conoce por su kind
.
Representación JSON |
---|
{ "questionId": string, "required": boolean, "grading": { object ( |
Campos | |
---|---|
questionId |
Solo lectura. El ID de la pregunta. Se puede proporcionar durante la creación, pero el ID no debe estar en uso en el formulario anteriormente. Si no se proporciona, se asigna uno nuevo. |
required |
Indica si se debe responder la pregunta para que el encuestado envíe su respuesta. |
grading |
Configuración de calificación para la pregunta |
Campo de unión kind . Obligatorio. Es el tipo de pregunta que se ofrece al encuestado. Las direcciones (kind ) solo pueden ser una de las siguientes opciones: |
|
choiceQuestion |
Los encuestados pueden elegir entre un conjunto de opciones predefinidas. |
textQuestion |
Los encuestados pueden ingresar una respuesta de texto libre. |
scaleQuestion |
Los encuestados pueden elegir un número de un rango. |
dateQuestion |
Las personas que responden pueden ingresar una fecha. |
timeQuestion |
Los encuestados pueden ingresar una hora. |
fileUploadQuestion |
Las personas que responden pueden subir uno o más archivos. |
rowQuestion |
Una fila de |
ChoiceQuestion
Una pregunta desplegable, de radio o con casillas de verificación
Representación JSON |
---|
{ "type": enum ( |
Campos | |
---|---|
type |
Obligatorio. Es el tipo de pregunta de opción. |
options[] |
Obligatorio. Lista de opciones que el encuestado debe elegir. |
shuffle |
Indica si las opciones deben mostrarse en orden aleatorio para las diferentes instancias del cuestionario. Esto se utiliza a menudo para evitar que los encuestados que estén haciendo trampa en la pantalla de otro encuestado hagan trampa, o para abordar el sesgo en una encuesta que podría presentarse colocando siempre las mismas opciones al principio o al final. |
ChoiceType
Es el tipo de elección.
Enumeradores | |
---|---|
CHOICE_TYPE_UNSPECIFIED |
Valor predeterminado. No se utiliza. |
RADIO |
Botones de selección: Se muestran todas las opciones al usuario, quien solo puede elegir una de ellas. |
CHECKBOX |
Casillas de verificación: Se muestran todas las opciones al usuario, quien puede elegir cualquier cantidad. |
DROP_DOWN |
Menú desplegable: Las opciones solo se muestran al usuario on demand; de lo contrario, solo se muestra la opción actual. Solo puedes elegir una opción. |
Opción
Una opción para una pregunta de Opción.
Representación JSON |
---|
{ "value": string, "image": { object ( |
Campos | |
---|---|
value |
Obligatorio. Es la elección tal como se presenta al usuario. |
image |
Muestra la imagen como opción. |
isOther |
Indica si la opción es "Otro". Actualmente, solo se aplica a los tipos de opción |
Campo de unión go_to_section . A qué sección ir si está seleccionada esta opción Actualmente, solo se aplica a los tipos de opción RADIO y SELECT , pero no se permite en QuestionGroupItem . go_to_section puede ser una de las siguientes opciones: |
|
goToAction |
Tipo de navegación de la sección. |
goToSectionId |
Es el ID de artículo del encabezado de la sección al que se dirigirá. |
GoToAction
Constantes para la navegación de secciones.
Enumeradores | |
---|---|
GO_TO_ACTION_UNSPECIFIED |
Valor predeterminado. No se utiliza. |
NEXT_SECTION |
Ve a la siguiente sección. |
RESTART_FORM |
Regresa al comienzo del formulario. |
SUBMIT_FORM |
Envía el formulario de inmediato. |
Imagen
Son datos que representan una imagen.
Representación JSON |
---|
{ "contentUri": string, "altText": string, "properties": { object ( |
Campos | |
---|---|
contentUri |
Solo salida. Es un URI desde el que puedes descargar la imagen. Solo es válido por un tiempo limitado. |
altText |
Es una descripción de la imagen que se muestra cuando los lectores de pantalla colocan el cursor sobre ella y la leen. |
properties |
Propiedades de una imagen. |
Campo de unión image_source . Es el tipo de fuente de la imagen. Cuando se crean imágenes nuevas, se debe configurar exactamente un campo de fuente de imagen. Las direcciones (image_source ) solo pueden ser una de las siguientes opciones: |
|
sourceUri |
Solo entrada. El URI de origen es el URI que se usa para insertar la imagen. El URI de origen puede estar vacío cuando se recupera. |
MediaProperties
Propiedades del contenido multimedia.
Representación JSON |
---|
{
"alignment": enum ( |
Campos | |
---|---|
alignment |
Es la posición del contenido multimedia. |
width |
Es el ancho del contenido multimedia en píxeles. Cuando se muestra el contenido multimedia, se ajusta a lo más pequeño de este valor o al ancho del formulario mostrado. Se conserva la relación de aspecto original del contenido multimedia. Si no se especifica un ancho cuando se agregan elementos multimedia al formulario, se establece el ancho de la fuente de contenido multimedia. El ancho debe ser un valor entre 0 y 740, ambos incluidos. Solo se puede establecer el ancho en 0 o sin especificar cuando se actualiza la fuente multimedia. |
Alineación
Alineación en la página
Enumeradores | |
---|---|
ALIGNMENT_UNSPECIFIED |
Valor predeterminado. No se utiliza. |
LEFT |
Alinear a la izquierda. |
RIGHT |
Alinear a la derecha |
CENTER |
Center. |
TextQuestion
Una pregunta de texto
Representación JSON |
---|
{ "paragraph": boolean } |
Campos | |
---|---|
paragraph |
Si la pregunta es de párrafo o no. De lo contrario, se trata de una pregunta de texto breve. |
ScaleQuestion
Una pregunta de escala. El usuario tiene un rango de valores numéricos para elegir.
Representación JSON |
---|
{ "low": integer, "high": integer, "lowLabel": string, "highLabel": string } |
Campos | |
---|---|
low |
Obligatorio. El valor más bajo posible para la escala. |
high |
Obligatorio. El valor más alto posible para la escala. |
lowLabel |
Etiqueta de visualización que describe el punto más bajo de la escala. |
highLabel |
Etiqueta de visualización que describe el punto más alto de la escala. |
DateQuestion
Una pregunta sobre fechas. De forma predeterminada, las preguntas de fecha se establecen en solo el mes y el día.
Representación JSON |
---|
{ "includeTime": boolean, "includeYear": boolean } |
Campos | |
---|---|
includeTime |
Indica si se debe incluir el tiempo como parte de la pregunta. |
includeYear |
Indica si se debe incluir el año como parte de la pregunta. |
TimeQuestion
Una pregunta de hora.
Representación JSON |
---|
{ "duration": boolean } |
Campos | |
---|---|
duration |
|
FileUploadQuestion
Una pregunta de carga de archivos. Por el momento, la API no admite la creación de preguntas de carga de archivos.
Representación JSON |
---|
{
"folderId": string,
"types": [
enum ( |
Campos | |
---|---|
folderId |
Obligatorio. El ID de la carpeta de Drive en la que se almacenan los archivos que se subieron. |
types[] |
Tipos de archivo que acepta esta pregunta. |
maxFiles |
Cantidad máxima de archivos que se pueden subir para esta pregunta en una sola respuesta. |
maxFileSize |
Cantidad máxima de bytes permitidos para cualquier archivo que se suba a esta pregunta. |
FileType
Tipos de archivo que se pueden subir a una pregunta de carga de archivos.
Enumeradores | |
---|---|
FILE_TYPE_UNSPECIFIED |
Valor predeterminado. No se utiliza. |
ANY |
No hay restricciones de tipo. |
DOCUMENT |
Un archivo de Documentos de Google |
PRESENTATION |
Un archivo de Presentaciones de Google |
SPREADSHEET |
Una hoja de cálculo de Google |
DRAWING |
Un dibujo. |
PDF |
Un PDF |
IMAGE |
Una imagen. |
VIDEO |
Un video |
AUDIO |
Es un archivo de audio. |
RowQuestion
La configuración para una pregunta que forma parte de un grupo de preguntas.
Representación JSON |
---|
{ "title": string } |
Campos | |
---|---|
title |
Obligatorio. Es el título de la sola fila en el |
Calificaciones
Cómo calificar para una sola pregunta
Representación JSON |
---|
{ "pointValue": integer, "correctAnswers": { object ( |
Campos | |
---|---|
pointValue |
Obligatorio. Es la cantidad máxima de puntos que un encuestado puede obtener automáticamente por una respuesta correcta. Este valor no debe ser negativo. |
correctAnswers |
Obligatorio. Es la clave de respuesta de la pregunta. Las respuestas se califican automáticamente en función de este campo. |
whenRight |
Los comentarios que se muestran para las respuestas correctas Estos comentarios solo se pueden establecer para preguntas de opción múltiple que tengan respuestas correctas. |
whenWrong |
Los comentarios que se muestran para las respuestas incorrectas. Estos comentarios solo se pueden establecer para preguntas de opción múltiple que tengan respuestas correctas. |
generalFeedback |
Los comentarios que se muestran para todas las respuestas. En general, se usa para preguntas de respuesta corta cuando el propietario de un cuestionario desea dar rápidamente a los encuestados una idea de si respondió correctamente la pregunta antes de tener la oportunidad de calificar oficialmente la respuesta. No se pueden establecer comentarios generales para las preguntas de opción múltiple con calificación automática. |
CorrectAnswers
Es la clave de respuesta de una pregunta.
Representación JSON |
---|
{
"answers": [
{
object ( |
Campos | |
---|---|
answers[] |
Lista de respuestas correctas Una respuesta a un cuestionario se puede calificar automáticamente en función de esas respuestas. En el caso de las preguntas con un solo valor, una respuesta se marca como correcta si coincide con algún valor de la lista (en otras palabras, es posible tener varias respuestas correctas). En el caso de las preguntas con valores múltiples ( |
CorrectAnswer
Una sola respuesta correcta para una pregunta. En el caso de las preguntas con varios valores (CHECKBOX
), es posible que se necesiten varios CorrectAnswer
para representar una sola opción de respuesta correcta.
Representación JSON |
---|
{ "value": string } |
Campos | |
---|---|
value |
Obligatorio. Es el valor de respuesta correcto. Consulta la documentación de |
QuestionGroupItem
Define una pregunta que comprende varias preguntas agrupadas.
Representación JSON |
---|
{ "questions": [ { object ( |
Campos | |
---|---|
questions[] |
Obligatorio. Una lista de preguntas que pertenecen a este grupo de preguntas. Una pregunta debe pertenecer a un solo grupo. Los |
image |
La imagen que se muestra dentro del grupo de preguntas arriba de las preguntas específicas. |
Campo de unión kind . Obligatorio. Es el tipo de grupo de preguntas, que determina qué tipos de preguntas están permitidas y cómo se muestran. Las direcciones (kind ) solo pueden ser una de las siguientes opciones: |
|
grid |
El grupo de preguntas es una cuadrícula con filas de preguntas de opción múltiple que comparten las mismas opciones. Cuando se establece |
Cuadrícula
Una cuadrícula de opciones (radio o casillas de verificación) en la que cada fila constituye una pregunta separada. Cada fila tiene las mismas opciones, que se muestran como las columnas.
Representación JSON |
---|
{
"columns": {
object ( |
Campos | |
---|---|
columns |
Obligatorio. Las opciones compartidas por cada pregunta en la cuadrícula. En otras palabras, los valores de las columnas. Solo se permiten las opciones |
shuffleQuestions |
Si es |
PageBreakItem
Un salto de página. El título y la descripción de este elemento se muestran en la parte superior de la nueva página.
TextItem
Es un elemento de texto.
ImageItem
Es un elemento que contiene una imagen.
Representación JSON |
---|
{
"image": {
object ( |
Campos | |
---|---|
image |
Obligatorio. Corresponde a la imagen que se muestra en el artículo. |
VideoItem
Es un elemento que contiene un video.
Representación JSON |
---|
{
"video": {
object ( |
Campos | |
---|---|
video |
Obligatorio. Es el video que se muestra en el elemento. |
caption |
El texto que se muestra debajo del video. |
Video
Son datos que representan un video.
Representación JSON |
---|
{
"youtubeUri": string,
"properties": {
object ( |
Campos | |
---|---|
youtubeUri |
Obligatorio. Un URI de YouTube. |
properties |
Propiedades de un video. |
Métodos |
|
---|---|
|
Cambia el formulario con un lote de actualizaciones. |
|
Crea un formulario nuevo con el título que aparece en el mensaje del formulario proporcionado en la solicitud. |
|
Obtén un formulario. |