Create Quiz Submission

Submits quiz answers and returns their evaluation results.

Specify quizSubmission and quizSubmission.quizId. The answers map can be empty when no questions require answers. Otherwise, provide answers keyed by the quiz questions' targets. The submitter is derived from the caller's authentication context. The API does not accept or return a submitter field.

If the quiz defines an attempt limit, creation fails with FAILED_PRECONDITION when the submitter's existing attempts reach that limit. Attempts are counted by groupId when supplied, otherwise by quizId. No attempt limit is enforced by this operation when the quiz has no configured limit.

Invalid quiz configuration or an unrecognized answer target also causes FAILED_PRECONDITION, reported as "Quiz is not configured" rather than "Quiz submissions exceed attempts limit". Do not infer exhausted attempts from the status alone. For a configuration or target error, refresh the quiz definition and verify the submitted target keys before retrying.

Use evaluationStatus for the evaluation result. A COMPLETED evaluation result doesn't by itself resolve the associated program step. To record program progress, see the Resolved Steps API. Caller-supplied extendedFields are stored with the quiz submission and returned by Create, Get, and Delete Quiz Submission, subject to Data Extensions schema and access permissions.