- Risorsa: Modulo
- Informazioni
- FormSettings
- QuizSettings
- Articolo
- QuestionItem
- Domanda
- ChoiceQuestion
- ChoiceType
- Opzione
- GoToAction
- Immagine
- MediaProperties
- Allineamento
- TextQuestion
- ScaleQuestion
- DateQuestion
- TimeQuestion
- FileUploadQuestion
- FileType
- RowQuestion
- Valutazione
- CorrectAnswers
- CorrectAnswer
- QuestionGroupItem
- Griglia
- PageBreakItem
- TextItem
- ImageItem
- VideoItem
- Video
- Metodi
Risorsa: modulo
Un documento di Moduli Google. Viene creato un modulo su Drive e l'eliminazione o la modifica delle protezioni di accesso avviene tramite l'API Drive.
Rappresentazione JSON |
---|
{ "formId": string, "info": { object ( |
Campi | |
---|---|
formId |
Solo output. L'ID modulo. |
info |
Obbligatorio. Il titolo e la descrizione del modulo. |
settings |
Le impostazioni del modulo. Deve essere aggiornato con |
items[] |
Obbligatorio. Un elenco degli elementi del modulo, che possono includere intestazioni di sezioni, domande, contenuti multimediali incorporati e così via. |
revisionId |
Solo output. L'ID revisione del modulo. Utilizzato in 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. |
responderUri |
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. |
linkedSheetId |
Solo output. L'ID del foglio Google collegato che sta accumulando risposte da questo modulo (se presente). |
Informazioni
Le informazioni generali di un modulo.
Rappresentazione JSON |
---|
{ "title": string, "documentTitle": string, "description": string } |
Campi | |
---|---|
title |
Obbligatorio. Il titolo del modulo visibile a chi risponde. |
documentTitle |
Solo output. Il titolo del documento visibile su Drive. Se |
description |
La descrizione del modulo. |
FormSettings
Le impostazioni di un modulo.
Rappresentazione JSON |
---|
{
"quizSettings": {
object ( |
Campi | |
---|---|
quizSettings |
Impostazioni relative ai moduli dei quiz e alla valutazione. |
QuizSettings
Impostazioni relative ai moduli dei quiz e alla valutazione. Questi valori devono essere aggiornati con UpdateSettingsRequest.
Rappresentazione JSON |
---|
{ "isQuiz": boolean } |
Campi | |
---|---|
isQuiz |
Se questo modulo è un quiz o meno. Se il valore è true, le risposte vengono valutate in base alla domanda |
Elemento
Un singolo elemento del modulo. kind
definisce il tipo di elemento.
Rappresentazione JSON |
---|
{ "itemId": string, "title": string, "description": string, // Union field |
Campi | |
---|---|
itemId |
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. |
title |
Il titolo dell'articolo. |
description |
La descrizione dell'articolo. |
Campo unione kind . Obbligatorio. Il tipo di elemento. kind può essere solo uno dei seguenti: |
|
questionItem |
Pone una domanda all'utente. |
questionGroupItem |
Pone una o più domande all'utente con un unico prompt principale. |
pageBreakItem |
Crea una nuova pagina con un titolo. |
textItem |
Visualizza un titolo e una descrizione nella pagina. |
imageItem |
Consente di visualizzare un'immagine nella pagina. |
videoItem |
Visualizza un video nella pagina. |
QuestionItem
Un elemento del modulo contenente una singola domanda.
Rappresentazione JSON |
---|
{ "question": { object ( |
Campi | |
---|---|
question |
Obbligatorio. La domanda visualizzata. |
image |
L'immagine visualizzata all'interno della domanda. |
Domanda
Qualsiasi domanda. Il tipo specifico di domanda è noto dal relativo kind
.
Rappresentazione JSON |
---|
{ "questionId": string, "required": boolean, "grading": { object ( |
Campi | |
---|---|
questionId |
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. |
required |
Indica se è necessario rispondere alla domanda per consentire all'intervistato di inviare la sua risposta. |
grading |
Configurazione della valutazione per la domanda. |
Campo unione kind . Obbligatorio. Il tipo di domanda offerto a un intervistato. kind può essere solo uno dei seguenti: |
|
choiceQuestion |
Chi risponde può scegliere tra una serie di opzioni predefinite. |
textQuestion |
L'intervistato può inserire una risposta di testo libero. |
scaleQuestion |
Un intervistato può scegliere un numero da un intervallo. |
dateQuestion |
Chi risponde può inserire una data. |
timeQuestion |
Chi risponde può inserire un orario. |
fileUploadQuestion |
Un intervistato può caricare uno o più file. |
rowQuestion |
Una riga di |
ChoiceQuestion
Una domanda radio/casella di controllo/elenco a discesa.
Rappresentazione JSON |
---|
{ "type": enum ( |
Campi | |
---|---|
type |
Obbligatorio. Il tipo di domanda di scelta. |
options[] |
Obbligatorio. Elenco di opzioni tra cui l'intervistato deve scegliere. |
shuffle |
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. |
ChoiceType
Il tipo di scelta.
Enum | |
---|---|
CHOICE_TYPE_UNSPECIFIED |
Valore predefinito. Non utilizzato. |
RADIO |
Pulsanti di opzione: tutte le scelte vengono mostrate all'utente, che può selezionarne solo una. |
CHECKBOX |
Caselle di controllo: vengono mostrate tutte le scelte all'utente, che può selezionarne un numero qualsiasi. |
DROP_DOWN |
Menu a discesa: le opzioni vengono mostrate all'utente soltanto on demand, altrimenti viene mostrata solo la scelta corrente. È possibile scegliere una sola opzione. |
Opzione
Un'opzione per una domanda Choice.
Rappresentazione JSON |
---|
{ "value": string, "image": { object ( |
Campi | |
---|---|
value |
Obbligatorio. La scelta presentata all'utente. |
image |
Visualizza immagine come opzione. |
isOther |
Se l'opzione è "Altro". Al momento si applica solo ai tipi di scelta |
Campo unione go_to_section . A quale sezione andare se questa opzione è selezionata? Al momento si applica solo al tipo di scelta RADIO e SELECT , ma non è consentito in un QuestionGroupItem . go_to_section può essere solo uno dei seguenti: |
|
goToAction |
Tipo di navigazione della sezione. |
goToSectionId |
ID elemento dell'intestazione della sezione a cui andare. |
GoToAction
Costanti per la navigazione nelle sezioni.
Enum | |
---|---|
GO_TO_ACTION_UNSPECIFIED |
Valore predefinito. Non utilizzato. |
NEXT_SECTION |
Vai alla sezione successiva. |
RESTART_FORM |
Torna all'inizio del modulo. |
SUBMIT_FORM |
Invia il modulo immediatamente. |
Immagine
Dati che rappresentano un'immagine.
Rappresentazione JSON |
---|
{ "contentUri": string, "altText": string, "properties": { object ( |
Campi | |
---|---|
contentUri |
Solo output. Un URI da cui puoi scaricare l'immagine; questo è valido solo per un periodo di tempo limitato. |
altText |
Una descrizione dell'immagine che viene mostrata al passaggio del mouse e letta dagli screen reader. |
properties |
Proprietà di un'immagine. |
Campo unione image_source . Il tipo di origine dell'immagine. Quando crei nuove immagini, devi impostare esattamente un campo di origine dell'immagine. image_source può essere solo uno dei seguenti: |
|
sourceUri |
Solo input. L'URI di origine è quello utilizzato per inserire l'immagine. L'URI di origine può essere vuoto quando viene recuperato. |
MediaProperties
Proprietà dei contenuti multimediali.
Rappresentazione JSON |
---|
{
"alignment": enum ( |
Campi | |
---|---|
alignment |
Posizione dei contenuti multimediali. |
width |
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. |
Allineamento
Allineamento sulla pagina.
Enum | |
---|---|
ALIGNMENT_UNSPECIFIED |
Valore predefinito. Non utilizzato. |
LEFT |
Allinea a sinistra. |
RIGHT |
Allinea a destra. |
CENTER |
Al centro. |
TextQuestion
Una domanda di testo.
Rappresentazione JSON |
---|
{ "paragraph": boolean } |
Campi | |
---|---|
paragraph |
Se la domanda è una domanda di tipo paragrafo o meno. In caso contrario, si tratta di una breve domanda di testo. |
ScaleQuestion
Una domanda su una scala. L'utente ha a disposizione una serie di valori numerici tra cui scegliere.
Rappresentazione JSON |
---|
{ "low": integer, "high": integer, "lowLabel": string, "highLabel": string } |
Campi | |
---|---|
low |
Obbligatorio. Il valore più basso possibile per la scala. |
high |
Obbligatorio. Il valore più alto possibile per la scala. |
lowLabel |
L'etichetta da visualizzare che descrive il punto più basso della bilancia. |
highLabel |
L'etichetta da visualizzare che descrive il punto più alto della bilancia. |
DateQuestion
Una domanda sulla data. Per impostazione predefinita, le domande sulla data sono impostate solo su mese + giorno.
Rappresentazione JSON |
---|
{ "includeTime": boolean, "includeYear": boolean } |
Campi | |
---|---|
includeTime |
Indica se includere il tempo nella domanda. |
includeYear |
Se includere l'anno nella domanda. |
TimeQuestion
Una domanda sull'orario.
Rappresentazione JSON |
---|
{ "duration": boolean } |
Campi | |
---|---|
duration |
|
FileUploadQuestion
Una domanda per il caricamento di un file. L'API attualmente non supporta la creazione di domande per il caricamento di file.
Rappresentazione JSON |
---|
{
"folderId": string,
"types": [
enum ( |
Campi | |
---|---|
folderId |
Obbligatorio. L'ID della cartella Drive in cui sono archiviati i file caricati. |
types[] |
Tipi di file accettati da questa domanda. |
maxFiles |
Numero massimo di file che possono essere caricati per questa domanda in una singola risposta. |
maxFileSize |
Numero massimo di byte consentiti per ogni singolo file caricato in questa domanda. |
FileType
Tipi di file che possono essere caricati in una domanda di caricamento file.
Enum | |
---|---|
FILE_TYPE_UNSPECIFIED |
Valore predefinito. Non utilizzato. |
ANY |
Nessuna limitazione sul tipo. |
DOCUMENT |
Un documento di Documenti Google. |
PRESENTATION |
Una presentazione Google. |
SPREADSHEET |
Un foglio di lavoro di Fogli Google. |
DRAWING |
Un disegno. |
PDF |
Un PDF. |
IMAGE |
Un'immagine. |
VIDEO |
Un video. |
AUDIO |
Un file audio. |
RowQuestion
Configurazione di una domanda che fa parte di un gruppo di domande.
Rappresentazione JSON |
---|
{ "title": string } |
Campi | |
---|---|
title |
Obbligatorio. Il titolo della singola riga in |
Valutazione
Valutazione per una singola domanda
Rappresentazione JSON |
---|
{ "pointValue": integer, "correctAnswers": { object ( |
Campi | |
---|---|
pointValue |
Obbligatorio. Il numero massimo di punti che un intervistato può ottenere automaticamente per una risposta corretta. Questo non deve essere negativo. |
correctAnswers |
Obbligatorio. La chiave di risposta della domanda. Le risposte vengono valutate automaticamente in base a questo campo. |
whenRight |
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. |
whenWrong |
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. |
generalFeedback |
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. |
CorrectAnswers
La chiave di risposta di una domanda.
Rappresentazione JSON |
---|
{
"answers": [
{
object ( |
Campi | |
---|---|
answers[] |
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 ( |
CorrectAnswer
Un'unica risposta corretta a una domanda. Per le domande a più valori (CHECKBOX
), potrebbero essere necessari diversi CorrectAnswer
per rappresentare un'unica opzione di risposta corretta.
Rappresentazione JSON |
---|
{ "value": string } |
Campi | |
---|---|
value |
Obbligatorio. Il valore della risposta corretto. Per informazioni dettagliate su come vengono formattati i vari tipi di valori, consulta la documentazione relativa a |
QuestionGroupItem
Definisce una domanda che comprende più domande raggruppate insieme.
Rappresentazione JSON |
---|
{ "questions": [ { object ( |
Campi | |
---|---|
questions[] |
Obbligatorio. Un elenco di domande che appartengono a questo gruppo di domande. Una domanda deve appartenere a un solo gruppo. Il |
image |
L'immagine visualizzata all'interno del gruppo di domande sopra le domande specifiche. |
Campo unione kind . Obbligatorio. Il tipo di gruppo di domande, che determina quali tipi di domande sono consentiti e come vengono visualizzati. kind può essere solo uno dei seguenti: |
|
grid |
Il gruppo di domande è una griglia con righe di domande a scelta multipla che condividono le stesse opzioni. Quando il criterio |
Griglia
Una griglia di opzioni (radio o caselle di controllo) in cui ogni riga rappresenta una domanda separata. Ogni riga presenta le stesse scelte, mostrate come colonne.
Rappresentazione JSON |
---|
{
"columns": {
object ( |
Campi | |
---|---|
columns |
Obbligatorio. Le scelte condivise da ogni domanda nella griglia. In altre parole, i valori delle colonne. Sono consentite solo le opzioni |
shuffleQuestions |
Se |
PageBreakItem
Un'interruzione di pagina. Il titolo e la descrizione di questo elemento vengono visualizzati nella parte superiore della nuova pagina.
TextItem
Un elemento di testo.
ImageItem
Un elemento contenente un'immagine.
Rappresentazione JSON |
---|
{
"image": {
object ( |
Campi | |
---|---|
image |
Obbligatorio. L'immagine visualizzata nell'articolo. |
VideoItem
Un elemento contenente un video.
Rappresentazione JSON |
---|
{
"video": {
object ( |
Campi | |
---|---|
video |
Obbligatorio. Il video visualizzato nell'elemento. |
caption |
Il testo visualizzato sotto il video. |
Video
Dati che rappresentano un video.
Rappresentazione JSON |
---|
{
"youtubeUri": string,
"properties": {
object ( |
Campi | |
---|---|
youtubeUri |
Obbligatorio. Un URI di YouTube. |
properties |
Proprietà di un video. |
Metodi |
|
---|---|
|
Cambia il modulo con un gruppo di aggiornamenti. |
|
Crea un nuovo modulo utilizzando il titolo indicato nel messaggio del modulo fornito nella richiesta. |
|
Ottieni un modulo. |