bind_quiz_question_banks
Attach question banks to a quiz so it draws items from them, setting order, randomization, and question limits per bank. Re-binding updates only provided fields, preserving existing settings.
Instructions
Attach question banks to a quiz, so it draws its items from them.
Pass `quiz_id` and `question_banks`, a list of items each needing
`question_bank_id`. Optional per item: `order` (omit and the bank is
appended after the current last), `randomize_questions`, and
`limit_question_count` (0 = use every question in the bank).
RE-BINDING AN ALREADY-ATTACHED BANK IS A PARTIAL UPDATE, NOT A RESET. Only the
fields you supply are written; anything you omit KEEPS ITS CURRENT VALUE, and an
omitted `order` is NOT recalculated. So binding a bank that is already attached,
with no other fields, changes nothing at all - it will not move the bank to the
end and will not clear its settings.
Within one call the FIRST occurrence of a bank wins; a later duplicate is
reported as `duplicate_in_batch`. An unknown `quiz_id` fails the whole call; an
unknown bank fails only its own row.
Requires the `quizzes:write` OAuth scope.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| quiz_id | Yes | ||
| question_banks | Yes |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ids | Yes | ||
| note | Yes | ||
| total | Yes | ||
| failed | Yes | ||
| succeeded | Yes |