REST Resource: forms

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

string

Solo salida. El ID del formulario.

object (Info)

Obligatorio. Corresponde al título y a la descripción del formulario.

object (FormSettings)

La configuración del formulario Se debe actualizar con UpdateSettingsRequest; se ignora durante forms.create y UpdateFormInfoRequest.

object (Item)

Obligatorio. Una lista de los elementos del formulario, que puede incluir encabezados de sección, preguntas, contenido multimedia incorporado, etcétera

string

Solo salida. El ID de revisión del formulario. Se usa en el WriteControl en las solicitudes de actualización para identificar la revisión en la que se basan los cambios.

El formato del ID de revisión puede cambiar con el tiempo, por lo que debe tratarse de manera opaca. El ID de revisión que se muestra solo puede ser válido por 24 horas después de que se muestra y no puede compartirse entre usuarios. Si el ID de revisión no se modifica entre llamadas, el formulario no se modifica. Por el contrario, un ID modificado (para el mismo formulario y usuario) suele significar que el formulario se actualizó; sin embargo, un ID modificado también puede deberse a factores internos, como cambios de formato de ID.

string

Solo salida. El URI del formulario para compartir con las personas que respondan. Se abrirá una página que le permite al usuario enviar respuestas, pero no editar las preguntas.

string

Solo salida. Es el ID de la Hoja de cálculo de Google vinculada que acumula respuestas desde este Formulario (si la Hoja existe).

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

string

Obligatorio. Es el título del formulario visible para las personas que responden.

string

Solo salida. Es el título del documento que se puede ver en Drive. Si Info.title está vacío, es posible que documentTitle aparezca en su lugar, en la IU de Formularios de Google, y los encuestados puedan verlo. documentTitle se puede establecer en la creación, pero no se puede modificar con una solicitud TFRecord. Usa la API de Google Drive si necesitas actualizar documentTitle de manera programática.

string

Es la descripción del formulario.

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

object (QuizSettings)

Configuración relacionada con los formularios y las calificaciones de los cuestionarios.

{
  "isQuiz": boolean
}

boolean

Si el formulario es un cuestionario o no. Cuando es verdadero, las respuestas se califican según la pregunta Grading. Si la estableces como falsa, se borrarán todas las preguntas 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

Es el ID de artículo.

En el momento de la creación, se puede proporcionar, pero no se debe usar el ID en el formulario. Si no se proporciona, se asigna un ID nuevo.

string

Es el título del artículo.

string

Es la descripción del artículo.

object (QuestionItem)

Le hace una pregunta al usuario.

object (QuestionGroupItem)

Le hace una o más preguntas al usuario con un solo mensaje importante.

object (PageBreakItem)

Inicia una página nueva con un título.

object (TextItem)

Muestra un título y una descripción en la página.

object (ImageItem)

Muestra una imagen en la página.

object (VideoItem)

Muestra un video en la página.

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

object (Question)

Obligatorio. Es la pregunta que se muestra.

object (Image)

Es la imagen que se muestra en la pregunta.

{
  "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

Solo lectura. Es el ID de la pregunta.

En el momento de la creación, se puede proporcionar, pero no se debe usar el ID en el formulario. Si no se proporciona, se asigna un ID nuevo.

boolean

Si la pregunta debe responderse para que el encuestado envíe su respuesta

object (Grading)

Configuración de la calificación para la pregunta

object (ChoiceQuestion)

Las personas pueden elegir entre un conjunto predefinido de opciones.

object (TextQuestion)

Las personas pueden ingresar una respuesta de texto libre.

object (ScaleQuestion)

Las personas pueden elegir un número de un rango.

object (DateQuestion)

El encuestado puede ingresar una fecha.

object (TimeQuestion)

Las personas pueden ingresar una hora.

object (FileUploadQuestion)

Las personas que responden pueden subir uno o más archivos.

object (RowQuestion)

Es una fila de QuestionGroupItem.

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

enum (ChoiceType)

Obligatorio. Es el tipo de pregunta de opción.

object (Option)

Obligatorio. Lista de opciones que deben elegir los encuestados.

boolean

Si las opciones se deben mostrar en orden aleatorio para diferentes instancias del cuestionario Por lo general, se usa para evitar que los encuestados hagan trampa en la pantalla de otro encuestado o para abordar el sesgo en una encuesta que se introduzca siempre al principio o al final en las mismas opciones.

{
  "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

Obligatorio. La opción que se le presenta al usuario.

object (Image)

Mostrar imagen como una opción.

boolean

Si la opción es “other” Actualmente, solo se aplica a los tipos de opciones RADIO y CHECKBOX, pero no se permite en un QuestionGroupItem.

enum (GoToAction)

Tipo de navegación de secciones.

string

ID de artículo del encabezado de la sección a la que se va.

{
  "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

Solo salida. Un URI desde el que puedes descargar la imagen; es válido solo por un tiempo limitado.

string

Es una descripción de la imagen que los lectores de pantalla muestran cuando se desplazan sobre ella.

object (MediaProperties)

Propiedades de una imagen

string

Solo entrada. El URI de origen es el que se usa para insertar la imagen. El URI de origen puede estar vacío cuando se recupera.

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

enum (Alignment)

Posición del contenido multimedia.

integer

Es el ancho del contenido multimedia en píxeles. Cuando se muestran los elementos multimedia, estos se ajustan al tamaño más pequeño o al ancho del formulario que se muestra. Se conserva la relación de aspecto original del contenido multimedia. Si no se especifica un ancho cuando se agrega el contenido multimedia al formulario, se establece como el ancho de la fuente multimedia. El ancho debe ser entre 0 y 740, inclusive. Solo se permite establecer el ancho en 0 o sin especificar cuando se actualiza la fuente multimedia.

{
  "paragraph": boolean
}

boolean

Si la pregunta es de párrafo o no De lo contrario, es una pregunta de texto breve.

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

integer

Obligatorio. El valor más bajo posible para la escala.

integer

Obligatorio. El valor más alto posible para la escala.

string

Etiqueta que muestra el punto más bajo de la escala.

string

La etiqueta que se muestra que describe el punto más alto de la escala.

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

boolean

Indica si se debe incluir el tiempo como parte de la pregunta.

boolean

Indica si se debe incluir el año como parte de la pregunta.

{
  "duration": boolean
}

boolean

true si la pregunta trata sobre un tiempo transcurrido. De lo contrario, se trata de una hora del día.

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

string

Obligatorio. El ID de la carpeta de Drive en la que se almacenan los archivos subidos

enum (FileType)

Tipos de archivos que acepta esta pregunta.

integer

Cantidad máxima de archivos que se pueden subir para esta pregunta en una sola respuesta.

string (int64 format)

Cantidad máxima de bytes permitidos para cualquier archivo que se suba a esta pregunta.

{
  "title": string
}

string

Obligatorio. El título de la fila única en el QuestionGroupItem.

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

integer

Obligatorio. Es la cantidad máxima de puntos que un encuestado puede obtener automáticamente para obtener una respuesta correcta. No debe ser un valor negativo.

object (CorrectAnswers)

Obligatorio. La clave de respuesta para la pregunta Las respuestas se califican automáticamente en función de este campo.

object (Feedback)

Los comentarios se muestran para las respuestas correctas. Estos comentarios solo se pueden configurar para preguntas de opción múltiple que tengan respuestas correctas.

object (Feedback)

Los comentarios se muestran en las respuestas incorrectas. Estos comentarios solo se pueden configurar para preguntas de opción múltiple que tengan respuestas correctas.

object (Feedback)

Se muestran los comentarios de todas las respuestas. Por lo general, se usa para preguntas de respuesta corta cuando el propietario del cuestionario desea darles rápidamente a los encuestados una idea de si respondieron correctamente la pregunta antes de haber tenido la oportunidad de calificarla oficialmente. No se pueden establecer comentarios generales para las preguntas de opción múltiple con calificación automática.

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

object (CorrectAnswer)

Una lista de respuestas correctas. Las respuestas a un cuestionario se pueden calificar automáticamente en función de ellas. En el caso de las preguntas de un solo valor, una respuesta se marca como correcta si coincide con cualquier valor de esta lista (es decir, se pueden aplicar varias respuestas correctas). En el caso de las preguntas con valores múltiples (CHECKBOX), una respuesta se marca como correcta si contiene exactamente los valores de esta lista.

{
  "value": string
}

string

Obligatorio. El valor de respuesta correcto. Consulta la documentación de TextAnswer.value para obtener detalles sobre cómo se les da formato a varios tipos de valores.

{
  "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)

Obligatorio. Es una lista de preguntas que pertenecen a este grupo de preguntas. Cada pregunta debe pertenecer a un solo grupo. Los kind del grupo pueden afectar los tipos de preguntas que se permiten.

object (Image)

La imagen que se muestra dentro del grupo de preguntas, arriba de las preguntas específicas

object (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 grid, todas las preguntas del grupo deben ser del tipo row.

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

object (ChoiceQuestion)

Obligatorio. Son las opciones que comparte cada pregunta de la cuadrícula. En otras palabras, los valores de las columnas. Solo se permiten opciones CHECK_BOX y RADIO.

boolean

Si es true, las preguntas se ordenan de forma aleatoria. En otras palabras, las filas aparecen en un orden diferente para cada encuestado.

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

object (Image)

Obligatorio. Es la imagen que se muestra en el artículo.

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

object (Video)

Obligatorio. Corresponde al video que se muestra en el elemento.

string

Es el texto que se muestra debajo del video.

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

string

Obligatorio. Un URI de YouTube.

object (MediaProperties)

Propiedades de un video