L'API Google Forms è un'interfaccia RESTful che consente di creare e modificare i moduli e quiz, recuperare le risposte ai moduli e i voti dei quiz, configurare le chiavi di risposta ai quiz con feedback automatico e ricevere notifiche push. Gli utilizzi più comuni di questa API includono le seguenti attività:
- Creare un modulo o un quiz
- Aggiornare un modulo o un quiz
- Recuperare le risposte da un modulo o un quiz
- Leggi contenuti e metadati dei moduli
- Configurazione e ricezione di notifiche push
Di seguito è riportato un elenco dei termini comuni utilizzati nell'API Forms:
- Form
Un documento di Moduli Google, creato e archiviato su Drive. Ogni modulo rappresentato da una risorsa
Form
e ha un valoreformId
univoco, contenente lettere, numeri, trattini o trattini bassi. Puoi trovare l'ID modulo in un URL di Moduli Google:https://docs.google.com/forms/d/FORM_ID/edit
- Quiz
Un tipo specifico di documento di Moduli Google che consente di valutare il formulare risposte rispetto a una chiave di risposta. Un quiz può essere creato esclusivamente utilizzando
batchUpdate()
per aggiornare l'impostazioneisQuiz
su un modulo esistente atrue
.- Elemento
Un singolo elemento in un modulo, rappresentato dal Risorsa Elemento.
Item
è un un elemento ripetuto che può contenere una sezione, un gruppo di domande, una domanda un testo, un'immagine o un video.- Domanda
Una singola domanda sul modulo, rappresentata dal
Question
.- Gruppo di domande
Un gruppo di domande che condividono tutte lo stesso insieme di possibili risposte (ad ad esempio, una griglia di valutazioni da 1 a 5). Rappresentato dal
QuestionGroupItem
risorsa.- Sezione
Una sezione è un modo per suddividere un modulo in più pagine e aggiungere logica condizionale (ad esempio mostrando solo alcune domande in base a come risposte degli utenti). Le sezioni corrispondono
PageBreakItem
risorsa.- Risposta
La risposta dell'utente finale a una domanda, rappresentata dal
Answer
risorsa. Include informazioni sui voti (se presenti), metadati e i contenuti della risposta.- Risposta
L'invio di un modulo da parte dell'utente finale, rappresentato dal
FormResponse
.- Guarda
Un attivatore che monitora le modifiche allo schema dei moduli (ad esempio le modifiche) alle domande) o invii di risposte a un modulo e invia una notifica push quando quando si verifica una modifica. Rappresentato dal
Watch
.
Struttura del modulo
Durante la gestione di moduli e quiz, sa come specificare i diversi campi
può essere complicato, dato che molti degli oggetti modulo possono essere nidificati
in vari modi. Per vedere come la rappresentazione visiva di un modulo
mappa i campi, ti consigliamo di usare l'interfaccia utente per creare alcuni esempi
formati che la tua applicazione potrebbe generare. Quindi recupera il file JSON corrispondente
utilizzando il metodo forms.get()
per permetterti di fare un confronto. Ad esempio:
questo quiz di esempio corrisponde al seguente JSON:
{
"formId": "FORM_ID",
"info": {
"title": "Famous Black Women",
"description": "Please complete this quiz based off of this week's readings for class.",
"documentTitle": "API Example Quiz"
},
"settings": {
"quizSettings": {
"isQuiz": true
}
},
"revisionId": "00000021",
"responderUri": "https://docs.google.com/forms/d/e/1FAIpQLSd0iBLPh4suZoGW938EU1WIxzObQv_jXto0nT2U8HH2KsI5dg/viewform",
"items": [
{
"itemId": "5d9f9786",
"imageItem": {
"image": {
"contentUri": "DIRECT_URL",
"properties": {
"alignment": "LEFT"
}
}
}
},
{
"itemId": "72b30353",
"title": "Which African American woman authored \"I Know Why the Caged Bird Sings\"?",
"questionItem": {
"question": {
"questionId": "25405d4e",
"required": true,
"grading": {
"pointValue": 2,
"correctAnswers": {
"answers": [
{
"value": "Maya Angelou"
}
]
}
},
"choiceQuestion": {
"type": "RADIO",
"options": [
{
"value": "Maya Angelou"
},
{
"value": "bell hooks"
},
{
"value": "Alice Walker"
},
{
"value": "Roxane Gay"
}
]
}
}
}
},
{
"itemId": "0a4859c8",
"title": "Who was the first Dominican-American woman elected to state office?",
"questionItem": {
"question": {
"questionId": "37fff47a",
"grading": {
"pointValue": 2,
"correctAnswers": {
"answers": [
{
"value": "Grace Diaz"
}
]
}
},
"choiceQuestion": {
"type": "RADIO",
"options": [
{
"value": "Rosa Clemente"
},
{
"value": "Grace Diaz"
},
{
"value": "Juana Matias"
},
{
"value": "Sabrina Matos"
}
]
}
}
}
}
]
}
Passaggi successivi
- Per saperne di più sullo sviluppo con le API Google Workspace, inclusa la gestione l'autenticazione e l'autorizzazione, consulta Inizia come sviluppatore Workspace.
- Per informazioni su come configurare ed eseguire una semplice app dell'API Forms, leggi l'articolo Panoramica delle guide rapide.