Website : rimsha.abasa.com
backdoor
Home
Console
Upload
information
Create File
Create Folder
About
Tools
:
/
var
/
canvas
/
public
/
doc
/
api
/
Filename :
quiz_statistics.html
back
Copy
<!DOCTYPE html> <html> <head> <meta name="Content-Type" content="text/html;charset=UTF-8"> <meta charset="UTF-8"> <title>Quiz Statistics - Canvas LMS REST API Documentation</title> <link rel="stylesheet" href="css/common.css" type="text/css" media="screen" charset="utf-8" /> <link href="css/prettify.css" rel="stylesheet" type="text/css" media="screen" /> <script src="js/jquery.min.js" type="text/javascript"></script> <script src="js/prettify.js" type="text/javascript"></script> <script type="text/javascript"> $(function() { // set up pretty-printing in static docs generated from .md files $('pre.code.bash').addClass('prettyprint language-bash'); $('pre.code.html').addClass('prettyprint language-html'); $('pre.code.xml').addClass('prettyprint language-xml'); $('pre.code.json').addClass('prettyprint language-js'); $('pre.code.javascript').addClass('prettyprint language-js'); prettyPrint(); }); </script> </head> <body> <div id="header"> <h1> <a href="index.html">Canvas LMS - REST API and Extensions Documentation</a> </h1> </div> <div id="sidebar"> <nav> <div class="expand-all-toggle"> <input id="toggle-input" type="checkbox" onClick="toggle(this)"> <label for="toggle-input" class="toggle-label">Expand all</label> </div> <div class="ac-container"> <input name="header" class="ac-input" id="sidebar-basics" type="checkbox" > <label class="ac-label" for="sidebar-basics">Basics</label> <div class="ac-text"> <div class="ac-sub"> <a class="" href="file.graphql.html">GraphQL</a><a class="" href="file.changelog.html">API Change Log</a><a class="" href="file.object_ids.html">SIS IDs</a><a class="" href="file.pagination.html">Pagination</a><a class="" href="file.throttling.html">Throttling</a><a class="" href="file.compound_documents.html">Compound Documents</a><a class="" href="file.file_uploads.html">File Uploads</a><a class="" href="file.endpoint_attributes.html">API Endpoint Attributes</a><a class="" href="file.masquerading.html">Masquerading</a> </div> </div> </div> <div class="ac-container"> <input name="header" class="ac-input" id="sidebar-oauth2" type="checkbox" > <label class="ac-label" for="sidebar-oauth2">OAuth2</label> <div class="ac-text"> <div class="ac-sub"> <a class="" href="file.oauth.html">OAuth2 Overview</a><a class="" href="file.oauth_endpoints.html">OAuth2 Endpoints</a><a class="" href="file.developer_keys.html">Developer Keys</a> </div> </div> </div> <div class="ac-container"> <input name="header" class="ac-input" id="sidebar-resources" type="checkbox" checked > <label class="ac-label" for="sidebar-resources">Resources</label> <div class="ac-text"> <div class="ac-sub"> <a href="all_resources.html" class="">All Resources Reference</a> <a class="" href="access_tokens.html">Access Tokens</a> <a class="" href="account_calendars.html">Account Calendars</a> <a class="" href="account_notifications.html">Account Notifications</a> <a class="" href="account_reports.html">Account Reports</a> <a class="" href="accounts.html">Accounts</a> <a class="" href="accounts_(lti).html">Accounts (LTI)</a> <a class="" href="admins.html">Admins</a> <a class="" href="announcement_external_feeds.html">Announcement External Feeds</a> <a class="" href="announcements.html">Announcements</a> <a class="" href="api_token_scopes.html">API Token Scopes</a> <a class="" href="appointment_groups.html">Appointment Groups</a> <a class="" href="assignment_extensions.html">Assignment Extensions</a> <a class="" href="assignment_groups.html">Assignment Groups</a> <a class="" href="assignments.html">Assignments</a> <a class="" href="authentication_providers.html">Authentication Providers</a> <a class="" href="authentications_log.html">Authentications Log</a> <a class="" href="blackout_dates.html">Blackout Dates</a> <a class="" href="blueprint_courses.html">Blueprint Courses</a> <a class="" href="bookmarks.html">Bookmarks</a> <a class="" href="brand_configs.html">Brand Configs</a> <a class="" href="calendar_events.html">Calendar Events</a> <a class="" href="collaborations.html">Collaborations</a> <a class="" href="comm_messages.html">CommMessages</a> <a class="" href="communication_channels.html">Communication Channels</a> <a class="" href="conferences.html">Conferences</a> <a class="" href="content_exports.html">Content Exports</a> <a class="" href="content_migrations.html">Content Migrations</a> <a class="" href="content_security_policy_settings.html">Content Security Policy Settings</a> <a class="" href="content_shares.html">Content Shares</a> <a class="" href="conversations.html">Conversations</a> <a class="" href="course_audit_log.html">Course Audit log</a> <a class="" href="course_pace.html">Course Pace</a> <a class="" href="course_quiz_extensions.html">Course Quiz Extensions</a> <a class="" href="courses.html">Courses</a> <a class="" href="custom_gradebook_columns.html">Custom Gradebook Columns</a> <a class="" href="discussion_topics.html">Discussion Topics</a> <a class="" href="enrollment_terms.html">Enrollment Terms</a> <a class="" href="enrollments.html">Enrollments</a> <a class="" href="e_portfolios.html">ePortfolios</a> <a class="" href="e_pub_exports.html">ePub Exports</a> <a class="" href="error_reports.html">Error Reports</a> <a class="" href="external_tools.html">External Tools</a> <a class="" href="favorites.html">Favorites</a> <a class="" href="feature_flags.html">Feature Flags</a> <a class="" href="files.html">Files</a> <a class="" href="grade_change_log.html">Grade Change Log</a> <a class="" href="gradebook_history.html">Gradebook History</a> <a class="" href="grading_period_sets.html">Grading Period Sets</a> <a class="" href="grading_periods.html">Grading Periods</a> <a class="" href="grading_standards.html">Grading Standards</a> <a class="" href="group_categories.html">Group Categories</a> <a class="" href="groups.html">Groups</a> <a class="" href="history.html">History</a> <a class="" href="inst_access_tokens.html">InstAccess tokens</a> <a class="" href="jw_ts.html">JWTs</a> <a class="" href="late_policy.html">Late Policy</a> <a class="" href="learning_object_dates.html">Learning Object Dates</a> <a class="" href="line_items.html">Line Items</a> <a class="" href="live_assessments.html">LiveAssessments</a> <a class="" href="logins.html">Logins</a> <a class="" href="lti_resource_links.html">LTI Resource Links</a> <a class="" href="media_objects.html">Media Objects</a> <a class="" href="moderated_grading.html">Moderated Grading</a> <a class="" href="modules.html">Modules</a> <a class="" href="names_and_role.html">Names and Role</a> <a class="" href="notification_preferences.html">Notification Preferences</a> <a class="" href="originality_reports.html">Originality Reports</a> <a class="" href="outcome_groups.html">Outcome Groups</a> <a class="" href="outcome_imports.html">Outcome Imports</a> <a class="" href="outcome_results.html">Outcome Results</a> <a class="" href="outcomes.html">Outcomes</a> <a class="" href="pages.html">Pages</a> <a class="" href="peer_reviews.html">Peer Reviews</a> <a class="" href="planner.html">Planner</a> <a class="" href="poll_sessions.html">Poll Sessions</a> <a class="" href="poll_choices.html">PollChoices</a> <a class="" href="polls.html">Polls</a> <a class="" href="poll_submissions.html">PollSubmissions</a> <a class="" href="proficiency_ratings.html">Proficiency Ratings</a> <a class="" href="progress.html">Progress</a> <a class="" href="public_jwk.html">Public JWK</a> <a class="" href="quiz_assignment_overrides.html">Quiz Assignment Overrides</a> <a class="" href="quiz_extensions.html">Quiz Extensions</a> <a class="" href="quiz_ip_filters.html">Quiz IP Filters</a> <a class="" href="quiz_question_groups.html">Quiz Question Groups</a> <a class="" href="quiz_questions.html">Quiz Questions</a> <a class="" href="quiz_reports.html">Quiz Reports</a> <a class="current" href="quiz_statistics.html">Quiz Statistics</a> <a class="" href="quiz_submission_events.html">Quiz Submission Events</a> <a class="" href="quiz_submission_files.html">Quiz Submission Files</a> <a class="" href="quiz_submission_questions.html">Quiz Submission Questions</a> <a class="" href="quiz_submission_user_list.html">Quiz Submission User List</a> <a class="" href="quiz_submissions.html">Quiz Submissions</a> <a class="" href="quizzes.html">Quizzes</a> <a class="" href="result.html">Result</a> <a class="" href="roles.html">Roles</a> <a class="" href="rubrics.html">Rubrics</a> <a class="" href="score.html">Score</a> <a class="" href="search.html">Search</a> <a class="" href="sections.html">Sections</a> <a class="" href="services.html">Services</a> <a class="" href="shared_brand_configs.html">Shared Brand Configs</a> <a class="" href="sis_import_errors.html">SIS Import Errors</a> <a class="" href="sis_imports.html">SIS Imports</a> <a class="" href="sis_integration.html">SIS Integration</a> <a class="" href="smart_search.html">Smart Search</a> <a class="" href="submission_comments.html">Submission Comments</a> <a class="" href="submissions.html">Submissions</a> <a class="" href="tabs.html">Tabs</a> <a class="" href="temporary_enrollment_pairings.html">Temporary Enrollment Pairings</a> <a class="" href="user_observees.html">User Observees</a> <a class="" href="users.html">Users</a> <a class="" href="what_if_grades.html">What If Grades</a> </div> </div> </div> <div class="ac-container"> <input name="header" class="ac-input" id="sidebar-outcomes" type="checkbox" > <label class="ac-label" for="sidebar-outcomes">Outcomes</label> <div class="ac-text"> <div class="ac-sub"> <a href="file.outcomes_csv.html" class="">Outcomes CSV Format</a> </div> </div> </div> <div class="ac-container"> <input name="header" class="ac-input" id="sidebar-groupCategories" type="checkbox" > <label class="ac-label" for="sidebar-groupCategories">Group Categories</label> <div class="ac-text"> <div class="ac-sub"> <a href="file.group_category_csv.html" class="">Group Categories CSV Format</a> </div> </div> </div> <div class="ac-container"> <input name="header" class="ac-input" id="sidebar-sis" type="checkbox" > <label class="ac-label" for="sidebar-sis">SIS</label> <div class="ac-text"> <div class="ac-sub"> <a href="file.sis_csv.html" class="">SIS CSV Format</a> </div> </div> </div> <div class="ac-container"> <input name="header" class="ac-input" id="sidebar-externalTools" type="checkbox" > <label class="ac-label" for="sidebar-externalTools">External Tools</label> <div class="ac-text"> <div class="ac-sub"> <input name="header" class="ac-input" id="sidebar-externalTools-lti" type="checkbox" > <label class="ac-label level1-label" for="sidebar-externalTools-lti">LTI</label> <div class="ac-sub-text"> <a class="" href="file.tools_intro.html">Introduction</a><a class="" href="file.registration.html">Registration</a><a class="" href="file.lti_dev_key_config.html">Configuring</a><a class="" href="file.tools_variable_substitutions.html">Variable Substitutions</a><a class="" href="file.content_item.html">Deep Linking</a><a class="" href="file.assignment_tools.html">Grading</a><a class="" href="file.provisioning.html">Provisioning</a><a class="" href="file.lti_window_post_message.html">PostMessage</a> <div class="ac-sub"> <input name="header" class="ac-input" id="sidebar-externalTools-lti-placements" type="checkbox" > <label class="ac-label level2-label" for="sidebar-externalTools-lti-placements">Placements</label> <div class="ac-sub-text-nested"> <a class="" href="file.placements_overview.html">Placements Overview</a><a class="" href="file.navigation_tools.html">Navigation</a><a class="" href="file.homework_submission_placement.html">Homework Submission</a><a class="" href="file.editor_button_placement.html">Editor Button</a><a class="" href="file.migration_selection_placement.html">Migration Selection</a><a class="" href="file.link_selection_placement.html">Link Selection (Modules)</a><a class="" href="file.assignment_selection_placement.html">Assignment Selection</a><a class="" href="file.collaborations_placement.html">Collaborations</a> </div> </div> </div> </div> <a href="file.xapi.html" class="">xAPI</a> <a href="file.canvas_roles.html" class="">Canvas Roles</a> </div> <div class="ac-text"> <div class="ac-sub"> <input name="header" class="ac-input" id="sidebar-externalTools-plagiarism" type="checkbox" > <label class="ac-label level1-label" for="sidebar-externalTools-plagiarism">Plagiarism Detection Platform</label> <div class="ac-sub-text"> <a href="file.plagiarism_platform.html" class="">Overview</a> <a class="" href="plagiarism_detection_platform_assignments.html">Plagiarism Detection Platform Assignments</a> <a class="" href="plagiarism_detection_platform_users.html">Plagiarism Detection Platform Users</a> <a class="" href="plagiarism_detection_submissions.html">Plagiarism Detection Submissions</a> <a class="" href="webhooks_subscriptions_for_plagiarism_platform.html">Webhooks Subscriptions for Plagiarism Platform</a> <a href="file.jwt_access_tokens.html" class="">JWT Access Tokens</a> </div> </div> </div> </div> <div class="ac-container"> <input name="header" class="ac-input" id="sidebar-dataServices" type="checkbox" > <label class="ac-label" for="sidebar-dataServices">Data Services</label> <div class="ac-text"> <div class="ac-sub"> <input name="header" class="ac-input" id="sidebar-dataServices-liveEvents" type="checkbox" > <label class="ac-label level1-label" for="sidebar-dataServices-liveEvents">Live Events</label> <div class="ac-sub-text"> <div class="ac-sub"> <input name="header" class="ac-input" id="sidebar-dataServices-liveEvents-overview" type="checkbox" > <label class="ac-label level2-label" for="sidebar-dataServices-liveEvents-overview">Overview</label> <div class="ac-sub-text-nested"> <a class="" href="file.data_service_introduction.html">Introduction</a><a class="" href="file.data_service_setup.html">Setup</a><a class="" href="file.data_service_caliper_structure.html">Caliper</a><a class="" href="file.data_service_canvas_event_metadata.html">Metadata</a> </div> </div> <span class="sub-label">Event Format</span> </div> <div class="ac-sub-text"> <div class="ac-sub"> <input name="header" class="ac-input" id="sidebar-dataServices-liveEvents-eventFormat-canvas" type="checkbox" > <label class="ac-label level2-label" for="sidebar-dataServices-liveEvents-eventFormat-canvas">Canvas</label> <div class="ac-sub-text-nested"> <a class="" href="file.data_service_canvas_account.html">Account</a><a class="" href="file.data_service_canvas_asset.html">Asset</a><a class="" href="file.data_service_canvas_assignment.html">Assignment</a><a class="" href="file.data_service_canvas_attachment.html">Attachment</a><a class="" href="file.data_service_canvas_content.html">Content</a><a class="" href="file.data_service_canvas_conversation.html">Conversation</a><a class="" href="file.data_service_canvas_course.html">Course</a><a class="" href="file.data_service_canvas_discussion.html">Discussion</a><a class="" href="file.data_service_canvas_enrollment.html">Enrollment</a><a class="" href="file.data_service_canvas_grade.html">Grade</a><a class="" href="file.data_service_canvas_group.html">Group</a><a class="" href="file.data_service_canvas_learning.html">Learning</a><a class="" href="file.data_service_canvas_logged.html">Logged</a><a class="" href="file.data_service_canvas_module.html">Module</a><a class="" href="file.data_service_canvas_outcome.html">Outcome</a><a class="" href="file.data_service_canvas_plagiarism.html">Plagiarism</a><a class="" href="file.data_service_canvas_quiz.html">Quiz</a><a class="" href="file.data_service_canvas_rubric.html">Rubric</a><a class="" href="file.data_service_canvas_sis.html">Sis</a><a class="" href="file.data_service_canvas_submission.html">Submission</a><a class="" href="file.data_service_canvas_syllabus.html">Syllabus</a><a class="" href="file.data_service_canvas_user.html">User</a><a class="" href="file.data_service_canvas_wiki.html">Wiki</a> </div> </div> </div> <div class="ac-sub-text"> <div class="ac-sub"> <input name="header" class="ac-input" id="sidebar-dataServices-liveEvents-eventFormat-caliper" type="checkbox" > <label class="ac-label level2-label" for="sidebar-dataServices-liveEvents-eventFormat-caliper">Caliper IMS 1.1</label> <div class="ac-sub-text-nested"> <a class="" href="file.data_service_caliper_assessment.html">Assessment</a><a class="" href="file.data_service_caliper_basic.html">Basic</a><a class="" href="file.data_service_caliper_forum.html">Forum</a><a class="" href="file.data_service_caliper_grading.html">Grading</a><a class="" href="file.data_service_caliper_navigation_events.html">Navigation Events</a><a class="" href="file.data_service_caliper_session.html">Session</a> </div> </div> </div> </div> </div> </div> <div class="sidebar-trailing-background"></div> <script> function toggle(source) { let expandText = document.querySelector('label[for="toggle-input"]') let isChecked = document.querySelector('input[id="toggle-input"]').checked let checkboxes = document.querySelectorAll('input[name="header"]'); checkboxes.forEach(checkbox => { if (checkbox !== source) { checkbox.checked = source.checked } }); expandText.innerHTML = isChecked ? 'Collapse all' : 'Expand all' } </script> </nav> </div> <div id="content"><div class="service"> <h1>Quiz Statistics API</h1> <table id='quicklinks'> </table> <p>API for accessing quiz submission statistics. The statistics provided by this interface are an aggregate of what is known as Student and Item Analysis for a quiz.</p> <p>These statistics are extracted (and composed) from <em>graded</em> (manually or, when viable, automatically) submissions for a quiz and provide an insight into how the participant students had responded to each question, as well as insights into the reception of each question answer individually.</p> <p>Some of these statistics are exclusive to Multiple Choice and True/False types of questions, others to other question types. See Quiz Statistics for a reference of these statistics.</p> <div class='object_definition'> <h3><a name="QuizStatistics">A QuizStatistics object looks like:</a></h3> <pre class="example code prettyprint"><code class="language-js">{ // The ID of the quiz statistics report. "id": 1, // The ID of the Quiz the statistics report is for. // NOTE: AVAILABLE ONLY IN NON-JSON-API REQUESTS. "quiz_id": 2, // Whether there are any students that have made mutliple submissions for this // quiz. "multiple_attempts_exist": true, // In the presence of multiple attempts, this field describes whether the // statistics describe all the submission attempts and not only the latest ones. "includes_all_versions": true, // The time at which the statistics were generated, which is usually after the // occurrence of a quiz event, like a student submitting it. "generated_at": "2013-01-23T23:59:00-07:00", // The API HTTP/HTTPS URL to this quiz statistics. "url": "http://canvas.example.edu/api/v1/courses/1/quizzes/2/statistics", // The HTTP/HTTPS URL to the page where the statistics can be seen visually. "html_url": "http://canvas.example.edu/courses/1/quizzes/2/statistics", // Question-specific statistics for each question and its answers. "question_statistics": null, // Question-specific statistics for each question and its answers. "submission_statistics": null, // JSON-API construct that contains links to media related to this quiz // statistics object. // NOTE: AVAILABLE ONLY IN JSON-API REQUESTS. "links": null }</code></pre> </div> <div class='object_definition'> <h3><a name="QuizStatisticsLinks">A QuizStatisticsLinks object looks like:</a></h3> <pre class="example code prettyprint"><code class="language-js">// Links to media related to QuizStatistics. { // HTTP/HTTPS API URL to the quiz this statistics describe. "quiz": "http://canvas.example.edu/api/v1/courses/1/quizzes/2" }</code></pre> </div> <div class='object_definition'> <h3><a name="QuizStatisticsQuestionStatistics">A QuizStatisticsQuestionStatistics object looks like:</a></h3> <pre class="example code prettyprint"><code class="language-js">// Statistics for submissions made to a specific quiz question. { // Number of students who have provided an answer to this question. Blank or // empty responses are not counted. "responses": 3, // Statistics related to each individual pre-defined answer. "answers": null }</code></pre> </div> <div class='object_definition'> <h3><a name="QuizStatisticsAnswerStatistics">A QuizStatisticsAnswerStatistics object looks like:</a></h3> <pre class="example code prettyprint"><code class="language-js">// Statistics for a specific pre-defined answer in a Multiple-Choice or // True/False quiz question. { // ID of the answer. "id": 3866, // The text attached to the answer. "text": "Blue.", // An integer to determine correctness of the answer. Incorrect answers should // be 0, correct answers should 100 "weight": 100, // Number of students who have chosen this answer. "responses": 2 }</code></pre> </div> <div class='object_definition'> <h3><a name="QuizStatisticsAnswerPointBiserial">A QuizStatisticsAnswerPointBiserial object looks like:</a></h3> <pre class="example code prettyprint"><code class="language-js">// A point-biserial construct for a single pre-defined answer in a // Multiple-Choice or True/False question. { // ID of the answer the point biserial is for. "answer_id": 3866, // The point biserial value for this answer. Value ranges between -1 and 1. "point_biserial": -0.802955068546966, // Convenience attribute that denotes whether this is the correct answer as // opposed to being a distractor. This is mutually exclusive with the // `distractor` value "correct": true, // Convenience attribute that denotes whether this is a distractor answer and // not the correct one. This is mutually exclusive with the `correct` value "distractor": false }</code></pre> </div> <div class='object_definition'> <h3><a name="QuizStatisticsSubmissionStatistics">A QuizStatisticsSubmissionStatistics object looks like:</a></h3> <pre class="example code prettyprint"><code class="language-js">// Generic statistics for all submissions for a quiz. { // The number of students who have taken the quiz. "unique_count": 3, // The mean of the student submission scores. "score_average": 4.33333333333333, // The highest submission score. "score_high": 6, // The lowest submission score. "score_low": 3, // Standard deviation of the submission scores. "score_stdev": 1.24721912892465, // A percentile distribution of the student scores, each key is the percentile // (ranges between 0 and 100%) while the value is the number of students who // received that score. "scores": {"50":1,"34":5,"100":1}, // The mean of the number of questions answered correctly by each student. "correct_count_average": 3.66666666666667, // The mean of the number of questions answered incorrectly by each student. "incorrect_count_average": 5, // The average time spent by students while taking the quiz. "duration_average": 42.333333333 }</code></pre> </div> <div id="Services" class="method_details_list"> <div class="method_details first"> <h2 class='api_method_name' name='method.quizzes/quiz_statistics.index' data-subtopic='Quiz Statistics'> <a name='method.quizzes/quiz_statistics.index' href='#method.quizzes/quiz_statistics.index'> Fetching the latest quiz statistics </a> <span class='defined-in'><a href="https://github.com/instructure/canvas-lms/blob/master/app/controllers/quizzes/quiz_statistics_controller.rb">Quizzes::QuizStatisticsController#index</a></span> </h2> <h3 class='endpoint'> GET /api/v1/courses/:course_id/quizzes/:quiz_id/statistics </h3> <div> <strong>Scope: </strong> <code class="scope">url:GET|/api/v1/courses/:course_id/quizzes/:quiz_id/statistics</code> </div> <p>This endpoint provides statistics for all quiz versions, or for a specific quiz version, in which case the output is guaranteed to represent the <em>latest</em> and most current version of the quiz.</p> <p><strong>200 OK</strong> response code is returned if the request was successful.</p> <h4>Request Parameters:</h4> <table class="request-params"> <thead> <tr> <th class="param-name">Parameter</th> <th class="param-req"></th> <th class="param-type">Type</th> <th class="param-desc">Description</th> </tr> </thead> <tbody> <tr class="request-param "> <td>all_versions</td> <td> </td> <td>boolean</td> <td class="param-desc"> <p>Whether the statistics report should include all submissions attempts.</p> </td> </tr> </tbody> </table> <div class="examples example_response"> <h4>Example Response:</h4> <h4><div class='inline'></div></h4> <pre class="example code prettyprint"><code class="language-js">{ "quiz_statistics": [ QuizStatistics ] }</code></pre> </div> </div> </div> </div> <div class="appendix"> <h2>Appendixes</h2> <div class="appendix_entry"> <h3 id="Question+Specific+Statistics-appendix">Appendix: Question Specific Statistics</h3> <p>Based on the question type it represents, the <code>question_statistics</code> document may include extra metrics. You can find these metrics below.</p> <p><a class="bookmark" id="multiple-choice-question-stats"></a></p> <h4 id="multiple-choice">Multiple Choice</h4> <pre class="code javascript"><code class="javascript">{ // Number of students who have picked any choice. "responses": 4, "answers": [ { // Unique ID of this answer. "id": "3866", // The readable answer text. "text": "Red", // Number of students who picked this answer. "responses": 3, // Whether this answer is a correct one. "correct": true }, // An incorrect choice: { "id": "2040", "text": "Green", "correct": false, "responses": 1 }, // The "No Answer" - students who didn't make any choice: { "id": "none", "text": "No Answer", "responses": 2, "correct": false } ], // Number of students who have answered this question. "answered_student_count": 0, // Number of students who rank in the top bracket (the top 27%) // among the submitters which have also answered this question. "top_student_count": 0, // Number of students who rank in the middle bracket (the middle 46%) // among the submitters which have also answered this question. "middle_student_count": 0, // Number of students who rank in the bottom bracket (the bottom 27%) // among the submitters which have also answered this question "bottom_student_count": 0, // Number of students who have answered this question correctly. "correct_student_count": 0, // Number of students who have answered this question incorrectly. "incorrect_student_count": 0, // Ratio of students who have answered this question correctly. "correct_student_ratio": 0, // Ratio of students who have answered this question incorrectly. "incorrect_student_ratio": 0, // Number of students who rank in the top bracket (the top 27%) among // the submitters which have also provided a correct answer to this question. "correct_top_student_count": 0, // Number of students who rank in the middle bracket (the middle 46%) among // the submitters which have also provided a correct answer to this question. "correct_middle_student_count": 0, // Number of students who rank in the bottom bracket (the bottom 27%) among // the submitters which have also provided a correct answer to this question. "correct_bottom_student_count": 0, // Variance of *all* the scores. "variance": 0, // Standard deviation of *all* the scores. "stdev": 0, // Denotes the ratio of students who have answered this question correctly, // which should give an indication of how difficult the question is. "difficulty_index": 0, // The reliability, or internal consistency, coefficient of all the scores // as measured by the Cronbach's alpha algorithm. Value ranges between 0 and // 1. // // Note: This metric becomes available only in quizzes with more than fifteen // submissions. "alpha": null, // A point biserial correlation coefficient for each of the question's // answers. This metric helps measure the efficiency of an individual // question: the calculation looks at the difference between high-scorers // who chose this answer and low-scorers who also chose this answer. // // See the reference above for a description of each field. "point_biserials": [ { "answer_id": 3866, "point_biserial": null, "correct": true, "distractor": false }, { "answer_id": 2040, "point_biserial": null, "correct": false, "distractor": true }, { "answer_id": 7387, "point_biserial": null, "correct": false, "distractor": true }, { "answer_id": 4082, "point_biserial": null, "correct": false, "distractor": true } ] } </code></pre> <p><a class="bookmark" id="fimb-question-stats"></a></p> <h4 id="fill-in-multiple-blanks">Fill in Multiple Blanks</h4> <pre class="code javascript"><code class="javascript">{ // Number of students who have filled at least one blank. "responses": 2, // Number of students who have filled every blank. "answered": 2, // Number of students who filled all blanks correctly. "correct": 1, // Number of students who filled one or more blanks correctly. "partially_correct": 0, // Number of students who didn't fill any blank correctly. "incorrect": 1, // Each entry in the answer set represents a blank and responses to // its pre-defined answers: "answer_sets": [ { "id": "70dda5dfb8053dc6d1c492574bce9bfd", // md5sum of the blank "text": "color", // the blank_id "answers": [ // Students who filled in this blank with this correct answer: { "id": "9711", "text": "Red", "responses": 3, "correct": true }, // Students who filled in this blank with this other correct answer: { "id": "2700", "text": "Blue", "responses": 0, "correct": true }, // Students who filled in this blank with something else: { "id": "other", "text": "Other", "responses": 1, "correct": false }, // Students who left this blank empty: { "id": "none", "text": "No Answer", "responses": 1, "correct": false } ] } ] } </code></pre> <h4 id="multiple-answers">Multiple Answers</h4> <pre class="code javascript"><code class="javascript">{ // Number of students who have picked any choice. "responses": 3, // Number of students who have picked all the right choices. "correct": 1, // Number of students who have picked at least one of the right choices, // but may have also picked a wrong one. "partially_correct": 2, "answers": [ { // Unique ID of this answer choice. "id": "5514", // Displayable choice text. "text": "A", // Number of students who picked this choice. "responses": 3, // Whether this choice is part of the answer. "correct": true }, // Here's the second part of the correct answer: { "id": "4261", "text": "B", "responses": 1, "correct": true }, // And here's a distractor: { "id": "3322", "text": "C", "responses": 2, "correct": false }, // "Missing" answers: // // This is an auto-generated answer to account for all students who // left this question unanswered. { "id": "none", "text": "No Answer", "responses": 0, "correct": false } ] } </code></pre> <h4 id="multiple-dropdowns">Multiple Dropdowns</h4> <p>Multiple Dropdown question statistics look just like the statistics for <a href="#fimb-question-stats">Fill In Multiple Blanks</a>.</p> <p><a class="bookmark" id="essay-question-stats"></a></p> <h4 id="essay">Essay</h4> <pre class="code javascript"><code class="javascript">{ // The number of students whose responses were graded by the teacher so // far. "graded": 5, // The number of students who got graded with a full score. "full_credit": 4, // Number of students who wrote any kind of answer. "resposes": 5, // A set of maps of scores and the number of students who received // each score. "point_distribution": [ { "score": 0, "count": 1 }, { "score": 1, "count": 1 }, { "score": 3, "count": 3 } ] } </code></pre> <h4 id="matching">Matching</h4> <pre class="code javascript"><code class="javascript">{ // Number of students who have matched at least one answer. "responses": 2, // Number of students who have matched all answers. "answered": 2, // Number of students who have matched all answers correctly with their // right-hand sides. "correct": 1, // Number of students who have matched one or more answers correctly // with their right-hand sides. "partially_correct": 0, // Number of students who have not matched any answer with their correct // right-hand side. "incorrect": 1, // Each entry in the answer set represents the left-hand side of the match // along with all the possible matches on the right-side "answer_sets": [ { // id of the answer "id": "1", // the left-hand side of the match "text": "What does the color red look like?", // the available matches "answers": [ // Students who chose this match for this answer set: { // match_id "id": "9711", // right-hand side of the match "text": "Red", "responses": 3, "correct": true }, // Students who chose an incorrect match: { "id": "2700", "text": "Blue", "responses": 0, "correct": false }, // Students who did not make any match: { "id": "none", "text": "No Answer", "responses": 1, "correct": false } ] } ] } </code></pre> <h4 id="file-upload">File Upload</h4> <p>File Upload question statistics look just like the statistics for <a href="#essay-question-stats">Essays</a>.</p> <h4 id="formula">Formula</h4> <p>Formula question statistics look just like the statistics for <a href="#essay-question-stats">Essays</a>.</p> <h4 id="numerical">Numerical</h4> <pre class="code javascript"><code class="javascript">{ // Number of students who have provided any kind of answer. "responses": 2, // Number of students who have provided a correct answer. "correct": 1, // Number of students who have provided a correct answer and received full // credit or higher. "full_credit": 2, // Number of students who have provided an answer which was not correct. "incorrect": 1, "answers": [ { // Unique ID of this answer. "id": "9711", // This metric contains a formatted version of the correct answer // ready for display. "text": "15.00", // Number of students who provided this answer. "responses": 3, // Whether this answer is a correct one. "correct": true, // Lower and upper boundaries of the answer range. This is consistent // regardless of the answer type (e.g., exact vs range). // // In the case of exact answers, the range will be the exact value // minus plus the defined margin. "value": [ 13.5, 16.5 ], // Margin of error tolerance. This is always zero for range answers. "margin": 1.5 }, // "Other" answers: // // This is an auto-generated answer that will be present if any student // provides a number for an answer that is incorrect (doesn't map to // any of the pre-defined answers.) { "id": "other", "text": "Other", "responses": 0, "correct": false }, // "Missing" answers: // // This is an auto-generated answer to account for all students who // left this question unanswered. { "id": "none", "text": "No Answer", "responses": 0, "correct": false } ] } </code></pre> <h3 id="short-answer-aka-fill-in-the-blank">Short Answer (aka Fill in The Blank)</h3> <pre class="code javascript"><code class="javascript">{ // Number of students who have written anything. "responses": 2, // Number of students who have written a correct answer. "correct": 2, "answers": [ { // Unique ID of this answer. "id": "4684", // The readable answer text. "text": "Something", // Number of students who picked this answer. "responses": 3, // Whether this answer is a correct one. "correct": true }, // Another correct answer: { "id": "1797", "text": "Very cool.", "responses": 0, "correct": true }, // "Other" answers: // // This is an auto-generated answer that will be present if any student // does write an answer, but is incorrect. { "id": "other", "text": "Other", "responses": 0, "correct": false }, // "Missing" answers: // // This is an auto-generated answer to account for all students who // left this question unanswered. { "id": "none", "text": "No Answer", "responses": 0, "correct": false } ] } </code></pre> <h4 id="true-false">True/False</h4> <p>True/False question statistics look just like the statistics for <a href="#multiple-choice-question-stats">Multiple-Choice</a>.</p> </div> </div></div> <script type="text/javascript"> $('h2.api_method_name').each(function(i, el) { var subtopic = $(el).data('subtopic'); var $a = $(el).find('a'); if ($.trim($a[0].innerHTML) == '') return; var $row = $('table#quicklinks tr').filter(function() { return $(this).data('subtopic') == subtopic; }); if ($row.length == 0) { $row = $('<tr/>').appendTo($('table#quicklinks')); $row.data('subtopic', subtopic); $('<th/>').append(subtopic).appendTo($row); $('<td/>').appendTo($row); } var link = $('<a/>').attr('href', '#'+$(el).attr('name')).append($.trim($a[0].innerHTML)); $row.find('td').append(link); }); </script> <div id="footer"> © Instructure, Inc. Generated on Tue Aug 27 19:27:04 2024<br> This documentation is generated directly from the Canvas LMS source code, available <a href="https://github.com/instructure/canvas-lms">on Github</a>. </div> </body> </html>