REST Resource: forms.responses

Ressource: FormResponse

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. Horodatage de la première envoi de la réponse.

Code temporel au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres fractionnaires. Exemples: "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

lastSubmittedTime

string (Timestamp format)

Uniquement en sortie. Horodatage de la dernière date d'envoi de la réponse. Ne suit pas les modifications apportées aux notes.

Code temporel au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres fractionnaires. Exemples: "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

respondentEmail

string

Uniquement en sortie. L'adresse e-mail du répondant (si elle est recueillie)

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 les corrections manuelles saisies 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 également Question.question_id.

grade

object (Grade)

Uniquement en sortie. Note de 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 à plusieurs valeurs, 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.

Format utilisé 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 numéro sélectionné.
  • DateQuestion
    • Sans date ni année: MM-JJ, par exemple "05-19"
    • Année au format AAAA-MM-JJ, par exemple "1986-05-19"
    • 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 avec l'heure ou la durée au format HH:MM (par exemple, "14:51")
  • RowQuestion dans QuestionGroupItem: la réponse pour chaque ligne d'un élément QuestionGroupItem est représentée sous la forme d'un Answer distinct. Chacun contiendra une chaîne pour les choix de type RADIO ou plusieurs chaînes pour les choix de type 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é à une question de type "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'une personne à 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 était correcte ou non. Un score de zéro point ne suffit pas pour déduire l’inexactitude d’une question, car une réponse correcte peut valoir zéro point.

feedback

object (Feedback)

Uniquement en sortie. Commentaires supplémentaires donnés pour une réponse.

Méthodes

get

Obtenez une réponse du formulaire.

list

Lister les réponses d'un formulaire