REST Resource: forms

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

string

Solo output. L'ID modulo.

object (Info)

Obbligatorio. Il titolo e la descrizione del modulo.

object (FormSettings)

Le impostazioni del modulo. Deve essere aggiornato con UpdateSettingsRequest. viene ignorato durante forms.create e UpdateFormInfoRequest.

object (Item)

Obbligatorio. Un elenco degli elementi del modulo, che possono includere intestazioni di sezioni, domande, contenuti multimediali incorporati e così via.

string

Solo output. L'ID revisione del modulo. Utilizzato in WriteControl nelle richieste di aggiornamento per identificare la revisione su cui si basano le modifiche.

Il formato dell'ID revisione può cambiare nel tempo, pertanto deve essere trattato in modo opaco. Un ID revisione restituito è garantito di essere valido solo per 24 ore dalla restituzione e non può essere condiviso tra gli utenti. Se l'ID revisione è rimasto invariato tra una chiamata e l'altra, il modulo non è cambiato. Al contrario, un ID modificato (per lo stesso modulo e per lo stesso utente) di solito indica che il modulo è stato aggiornato. Tuttavia, un ID modificato può anche essere dovuto a fattori interni come le modifiche al formato dell'ID.

string

Solo output. L'URI del modulo da condividere con chi risponde. Si apre una pagina che consente all'utente di inviare le risposte ma non di modificare le domande.

string

Solo output. L'ID del foglio Google collegato che sta accumulando risposte da questo modulo (se presente).

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

string

Obbligatorio. Il titolo del modulo visibile a chi risponde.

string

Solo output. Il titolo del documento visibile su Drive. Se Info.title è vuoto, documentTitle potrebbe essere visualizzato al suo posto nell'interfaccia utente di Moduli Google ed essere visibile a chi risponde. documentTitle può essere impostato al momento della creazione, ma non può essere modificato da una richiesta batchUpdate. Se devi aggiornare documentTitle in modo programmatico, utilizza l'API Google Drive.

string

La descrizione del modulo.

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

object (QuizSettings)

Impostazioni relative ai moduli dei quiz e alla valutazione.

{
  "isQuiz": boolean
}

boolean

Se questo modulo è un quiz o meno. Se il valore è true, le risposte vengono valutate in base alla domanda Grading. Quando viene impostato su false, tutte le domande Grading vengono eliminate.

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

L'ID elemento.

Al momento della creazione, può essere fornito, ma l'ID non deve essere già utilizzato nel modulo. Se non viene fornito, viene assegnato un nuovo ID.

string

Il titolo dell'articolo.

string

La descrizione dell'articolo.

object (QuestionItem)

Pone una domanda all'utente.

object (QuestionGroupItem)

Pone una o più domande all'utente con un unico prompt principale.

object (PageBreakItem)

Crea una nuova pagina con un titolo.

object (TextItem)

Visualizza un titolo e una descrizione nella pagina.

object (ImageItem)

Consente di visualizzare un'immagine nella pagina.

object (VideoItem)

Visualizza un video nella pagina.

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

object (Question)

Obbligatorio. La domanda visualizzata.

object (Image)

L'immagine visualizzata all'interno della domanda.

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

Sola lettura. L'ID domanda.

Al momento della creazione, può essere fornito, ma l'ID non deve essere già utilizzato nel modulo. Se non viene fornito, viene assegnato un nuovo ID.

boolean

Indica se è necessario rispondere alla domanda per consentire all'intervistato di inviare la sua risposta.

object (Grading)

Configurazione della valutazione per la domanda.

object (ChoiceQuestion)

Chi risponde può scegliere tra una serie di opzioni predefinite.

object (TextQuestion)

L'intervistato può inserire una risposta di testo libero.

object (ScaleQuestion)

Un intervistato può scegliere un numero da un intervallo.

object (DateQuestion)

Chi risponde può inserire una data.

object (TimeQuestion)

Chi risponde può inserire un orario.

object (FileUploadQuestion)

Un intervistato può caricare uno o più file.

object (RowQuestion)

Una riga di QuestionGroupItem.

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

enum (ChoiceType)

Obbligatorio. Il tipo di domanda di scelta.

object (Option)

Obbligatorio. Elenco di opzioni tra cui l'intervistato deve scegliere.

boolean

Indica se le opzioni devono essere visualizzate in ordine casuale per diverse istanze del quiz. Questo approccio viene spesso utilizzato per evitare di barare da parte degli intervistati che potrebbero guardare lo schermo di un altro intervistato o per risolvere i bias in un sondaggio che potrebbe essere introdotto mettendo sempre le stesse opzioni all'inizio o all'ultima.

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

Obbligatorio. La scelta presentata all'utente.

object (Image)

Visualizza immagine come opzione.

boolean

Se l'opzione è "Altro". Al momento si applica solo ai tipi di scelta RADIO e CHECKBOX, ma non è consentito in un QuestionGroupItem.

enum (GoToAction)

Tipo di navigazione della sezione.

string

ID elemento dell'intestazione della sezione a cui andare.

{
  "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 output. Un URI da cui puoi scaricare l'immagine; questo è valido solo per un periodo di tempo limitato.

string

Una descrizione dell'immagine che viene mostrata al passaggio del mouse e letta dagli screen reader.

object (MediaProperties)

Proprietà di un'immagine.

string

Solo input. L'URI di origine è quello utilizzato per inserire l'immagine. L'URI di origine può essere vuoto quando viene recuperato.

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

enum (Alignment)

Posizione dei contenuti multimediali.

integer

La larghezza dell'elemento multimediale in pixel. Quando vengono visualizzati, i contenuti multimediali vengono ridimensionati in base al valore inferiore o alla larghezza del modulo visualizzato. Le proporzioni originali dei contenuti multimediali vengono mantenute. Se non viene specificata una larghezza quando il contenuto multimediale viene aggiunto al modulo, viene impostata sulla larghezza dell'origine multimediale. La larghezza deve essere compresa tra 0 e 740 inclusi. È possibile impostare la larghezza su 0 o su un valore non specificato solo durante l'aggiornamento dell'origine multimediale.

{
  "paragraph": boolean
}

boolean

Se la domanda è una domanda di tipo paragrafo o meno. In caso contrario, si tratta di una breve domanda di testo.

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

integer

Obbligatorio. Il valore più basso possibile per la scala.

integer

Obbligatorio. Il valore più alto possibile per la scala.

string

L'etichetta da visualizzare che descrive il punto più basso della bilancia.

string

L'etichetta da visualizzare che descrive il punto più alto della bilancia.

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

boolean

Indica se includere il tempo nella domanda.

boolean

Se includere l'anno nella domanda.

{
  "duration": boolean
}

boolean

true se la domanda riguarda un tempo trascorso. Altrimenti, si tratta di un'ora del giorno.

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

string

Obbligatorio. L'ID della cartella Drive in cui sono archiviati i file caricati.

enum (FileType)

Tipi di file accettati da questa domanda.

integer

Numero massimo di file che possono essere caricati per questa domanda in una singola risposta.

string (int64 format)

Numero massimo di byte consentiti per ogni singolo file caricato in questa domanda.

{
  "title": string
}

string

Obbligatorio. Il titolo della singola riga in QuestionGroupItem.

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

integer

Obbligatorio. Il numero massimo di punti che un intervistato può ottenere automaticamente per una risposta corretta. Questo non deve essere negativo.

object (CorrectAnswers)

Obbligatorio. La chiave di risposta della domanda. Le risposte vengono valutate automaticamente in base a questo campo.

object (Feedback)

Il feedback visualizzato per le risposte corrette. Questo feedback può essere impostato solo per le domande a scelta multipla per cui sono state fornite risposte corrette.

object (Feedback)

Il feedback visualizzato per le risposte errate. Questo feedback può essere impostato solo per le domande a scelta multipla per cui sono state fornite risposte corrette.

object (Feedback)

Il feedback visualizzato per tutte le risposte. In genere viene utilizzato per le domande a risposta breve quando il proprietario di un quiz vuole dare rapidamente agli intervistati un'idea di se hanno risposto correttamente alla domanda prima di avere la possibilità di assegnare un voto ufficiale. Impossibile impostare il feedback generale per le domande a scelta multipla con valutazione automatica.

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

object (CorrectAnswer)

Un elenco di risposte corrette. La risposta a un quiz può essere valutata automaticamente in base a queste risposte. Per le domande a un singolo valore, una risposta viene contrassegnata come corretta se corrisponde a qualsiasi valore in questo elenco (in altre parole, sono possibili più risposte corrette). Per le domande a più valori (CHECKBOX), una risposta viene contrassegnata come corretta se contiene esattamente i valori in questo elenco.

{
  "value": string
}

string

Obbligatorio. Il valore della risposta corretto. Per informazioni dettagliate su come vengono formattati i vari tipi di valori, consulta la documentazione relativa a 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)

Obbligatorio. Un elenco di domande che appartengono a questo gruppo di domande. Una domanda deve appartenere a un solo gruppo. Il kind del gruppo può influire sui tipi di domande consentiti.

object (Image)

L'immagine visualizzata all'interno del gruppo di domande sopra le domande specifiche.

object (Grid)

Il gruppo di domande è una griglia con righe di domande a scelta multipla che condividono le stesse opzioni. Quando il criterio grid è impostato, tutte le domande del gruppo devono essere di tipo row.

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

object (ChoiceQuestion)

Obbligatorio. Le scelte condivise da ogni domanda nella griglia. In altre parole, i valori delle colonne. Sono consentite solo le opzioni CHECK_BOX e RADIO.

boolean

Se true, le domande vengono ordinate in modo casuale. In altre parole, le righe vengono visualizzate in un ordine diverso per ogni intervistato.

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

object (Image)

Obbligatorio. L'immagine visualizzata nell'articolo.

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

object (Video)

Obbligatorio. Il video visualizzato nell'elemento.

string

Il testo visualizzato sotto il video.

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

string

Obbligatorio. Un URI di YouTube.

object (MediaProperties)

Proprietà di un video.