REST Resource: forms.responses

Ressource: FormResponse

Une réponse à un formulaire.

Représentation JSON
{
  "formId": string,
  "responseId": string,
  "createTime": string,
  "lastSubmittedTime": string,
  "respondentEmail": string,
  "answers": {
    string: {
      object (Answer)
    },
    ...
  },
  "totalScore": number
}
Champs
formId

string

Uniquement en sortie. ID du formulaire.

responseId

string

Uniquement en sortie. ID de la réponse.

createTime

string (Timestamp format)

Uniquement en sortie. Code temporel de la première fois que la réponse a été envoyée.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

lastSubmittedTime

string (Timestamp format)

Uniquement en sortie. Horodatage de l'heure la plus récente d'envoi de la réponse. Le suivi des modifications apportées aux notes n'est pas effectué.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

respondentEmail

string

Uniquement en sortie. Adresse e-mail (si elle a été collectée) du répondant.

answers

map (key: string, value: object (Answer))

Uniquement en sortie. Réponses réelles aux questions, associées par questionId.

Objet contenant une liste de paires "key": value. Exemple : { "name": "wrench", "mass": "1.3kg", "count": "3" }.

totalScore

number

Uniquement en sortie. Nombre total de points reçus par le répondant pour son travail. Défini uniquement si le formulaire était un questionnaire et que la réponse a été notée. Cela inclut les points attribués automatiquement via la notation automatique ajustée par toute correction manuelle effectuée par le propriétaire du formulaire.

Réponse

Réponse envoyée à une question.

Représentation JSON
{
  "questionId": string,
  "grade": {
    object (Grade)
  },

  // Union field value can be only one of the following:
  "textAnswers": {
    object (TextAnswers)
  },
  "fileUploadAnswers": {
    object (FileUploadAnswers)
  }
  // End of list of possible types for union field value.
}
Champs
questionId

string

Uniquement en sortie. ID de la question. Voir aussi Question.question_id.

grade

object (Grade)

Uniquement en sortie. Note associée à la réponse, si le formulaire était un questionnaire.

Champ d'union value. Réponse de l'utilisateur. value ne peut être qu'un des éléments suivants :
textAnswers

object (TextAnswers)

Uniquement en sortie. Réponses spécifiques sous forme de texte.

fileUploadAnswers

object (FileUploadAnswers)

Uniquement en sortie. Réponses à une question sur l'importation de fichiers.

TextAnswers

Réponses à une question sous forme de texte.

Représentation JSON
{
  "answers": [
    {
      object (TextAnswer)
    }
  ]
}
Champs
answers[]

object (TextAnswer)

Uniquement en sortie. Réponses à une question. Pour les valeurs ChoiceQuestion multiples, chaque réponse est une valeur distincte.

TextAnswer

Réponse à une question représentée sous forme de texte.

Représentation JSON
{
  "value": string
}
Champs
value

string

Uniquement en sortie. Valeur de la réponse.

Mise en forme utilisée pour différents types de questions:

  • ChoiceQuestion
    • RADIO ou DROP_DOWN: chaîne unique correspondant à l'option sélectionnée.
    • CHECKBOX: plusieurs chaînes correspondant à chaque option sélectionnée.
  • TextQuestion: texte saisi par l'utilisateur
  • ScaleQuestion: chaîne contenant le nombre sélectionné.
  • DateQuestion
    • Sans période ni année: MM-JJ (par exemple, "05-19"
    • Avec l'année: AAAA-MM-JJ, par exemple "19-05-1986"
    • Avec l'heure: MM-JJ HH:MM, par exemple "05-19 14:51"
    • Avec l'année et l'heure: AAAA-MM-JJ HH:MM, par exemple "1986-05-19 14:51"
  • TimeQuestion: chaîne comportant l'heure ou la durée au format HH:MM, par exemple "14:51"
  • RowQuestion dans QuestionGroupItem: la réponse pour chaque ligne d'une QuestionGroupItem est représentée sous la forme d'un Answer distinct. Chacune contiendra une chaîne pour les choix de type RADIO ou plusieurs chaînes pour les choix CHECKBOX.

FileUploadAnswers

Tous les fichiers envoyés pour une question FileUpload.

Représentation JSON
{
  "answers": [
    {
      object (FileUploadAnswer)
    }
  ]
}
Champs
answers[]

object (FileUploadAnswer)

Uniquement en sortie. Tous les fichiers envoyés pour une question FileUpload.

FileUploadAnswer

Informations sur un seul fichier envoyé en réponse à une question "Importer un fichier".

Représentation JSON
{
  "fileId": string,
  "fileName": string,
  "mimeType": string
}
Champs
fileId

string

Uniquement en sortie. ID du fichier Google Drive.

fileName

string

Uniquement en sortie. Nom du fichier, tel qu'il est stocké dans Google Drive lors de l'importation.

mimeType

string

Uniquement en sortie. Type MIME du fichier, tel qu'il est stocké dans Google Drive lors de l'importation.

Note

Note associée à la réponse d'un participant à une question.

Représentation JSON
{
  "score": number,
  "correct": boolean,
  "feedback": {
    object (Feedback)
  }
}
Champs
score

number

Uniquement en sortie. Score numérique attribué à la réponse.

correct

boolean

Uniquement en sortie. Indique si la réponse à la question est correcte ou non. Un score de zéro ne suffit pas pour déduire l'inexactitude, car une question ayant une réponse correcte peut valoir zéro point.

feedback

object (Feedback)

Uniquement en sortie. Commentaire supplémentaire donné pour une réponse.

Méthodes

get

Obtenez une réponse à partir du formulaire.

list

Lister les réponses à un formulaire