def create_question_group(self, quiz_groups, **kwargs):
"""
Create a new question group for the given quiz id
:calls: `POST /api/v1/courses/:course_id/quizzes/:quiz_id/groups \
<https://canvas.instructure.com/doc/api/quiz_question_groups.html#method.quizzes/quiz_groups.create>`_
:param quiz_groups: The name, pick count, question points,
and/or assessment question bank id.
All of these parameters are optional, but at least one must exist
(even if empty) to receive a response.
The request expects a list, but will only create 1 question group per request.
:type quiz_groups: list[dict]
:returns: `QuizGroup` object
:rtype: :class:`canvasapi.quiz_group.QuizGroup`
"""
if not isinstance(quiz_groups, list) or not quiz_groups:
raise ValueError("Param `quiz_groups` must be a non-empty list.")
if not isinstance(quiz_groups[0], dict):
raise ValueError("Param `quiz_groups must contain a dictionary")
param_list = [
"name",
"pick_count",
"question_points",
"assessment_question_bank_id",
]
if not any(param in quiz_groups[0] for param in param_list):
raise RequiredFieldMissing(
"quiz_groups must contain at least 1 parameter.")
kwargs["quiz_groups"] = quiz_groups
response = self._requester.request(
"POST",
"courses/{}/quizzes/{}/groups".format(self.course_id, self.id),
_kwargs=combine_kwargs(**kwargs),
)
response_json = response.json()
response_json["quiz_groups"][0].update({"course_id": self.id})
return QuizGroup(self._requester, response_json.get("quiz_groups")[0])
def get_quiz_group(self, id, **kwargs):
"""
Get details of the quiz group with the given id
:calls: `GET /api/v1/courses/:course_id/quizzes/:quiz_id/groups/:id \
<https://canvas.instructure.com/doc/api/quiz_question_groups.html#method.quizzes/quiz_groups.show>`_
:param id: The ID of the question group.
:type id: int
:returns: `QuizGroup` object
:rtype: :class:`canvasapi.quiz_group.QuizGroup`
"""
response = self._requester.request(
'GET',
'courses/{}/quizzes/{}/groups/{}'.format(self.course_id, self.id, id),
_kwargs=combine_kwargs(**kwargs)
)
response_json = response.json()
response_json.update({'course_id': self.id})
return QuizGroup(self._requester, response_json)
