Class: PlatformSdk::CanvasApiWrapper::Client
- Inherits:
-
Object
- Object
- PlatformSdk::CanvasApiWrapper::Client
- Defined in:
- lib/platform_sdk/canvas_api/client.rb
Overview
DataPipeline::Client
Constant Summary collapse
- PAGE_SIZE =
10
Instance Attribute Summary collapse
-
#connection ⇒ Object
readonly
Returns the value of attribute connection.
-
#host ⇒ Object
readonly
Returns the value of attribute host.
-
#token ⇒ Object
readonly
Returns the value of attribute token.
Instance Method Summary collapse
- #assignment(course_id:, assignment_id:) ⇒ Object
- #assignments(course_id:, module_id:) ⇒ Object
- #course_modules(course_id:) ⇒ Object
- #course_students(course_id:) ⇒ Object
- #course_test_student(course_id:) ⇒ Object
- #course_users(course_id:) ⇒ Object
- #delete_module_item(course_id:, module_id:, module_item_id:) ⇒ Object
-
#initialize(domain:, token:) ⇒ Client
constructor
A new instance of Client.
- #module_item(course_id:, module_id:, module_item_id:) ⇒ Object
- #module_items(course_id:, module_id:) ⇒ Object
- #post_complete_quiz_submission(course_id:, quiz_id:, submission_id:, attempt:, validation_token:) ⇒ Hash
- #post_create_quiz_submission(course_id:, quiz_id:, user_id:) ⇒ Object
- #post_discussion_topic_entry(course_id:, topic_id:, user_id:, message:) ⇒ Object
-
#post_mark_module_item_read(course_id:, module_id:, module_item_id:, user_id:) ⇒ Object
Nil.
- #post_module_item(course_id:, module_id:, body:) ⇒ Object
-
#put_mark_module_item_done(course_id:, module_id:, module_item_id:, user_id:) ⇒ Object
Nil.
- #put_module_prerequesites(course_id:, module_id:, prerequisite_ids:) ⇒ Object
- #put_publish_module_item(course_id:, module_id:, module_item_id:) ⇒ Object
-
#put_recompute_module_prerequisites(course_id:, module_id:, original_name:) ⇒ Object
renames a module to recompute module prerequisites.
- #put_relock_module(course_id:, module_id:) ⇒ Object
- #quiz(course_id:, quiz_id:) ⇒ Object
- #quiz_submissions(course_id:, quiz_id:, user_id:) ⇒ Array
- #retrieve_discussion_topic(course_id:, topic_id:) ⇒ Object
- #submissions(course_id:, assignment_id:) ⇒ Object
- #update_submission_excused(course_id:, assignment_id:, user_id:) ⇒ Object
- #update_submission_excused_with_comment(course_id:, assignment_id:, user_id:, comment:) ⇒ Object
- #user_module_item(course_id:, module_id:, module_item_id:, user_id:) ⇒ Object
- #user_module_item_content_details(course_id:, module_id:, module_item_id:, user_id:) ⇒ Object
- #user_module_items(course_id:, module_id:, user_id:) ⇒ Object
Constructor Details
#initialize(domain:, token:) ⇒ Client
Returns a new instance of Client.
15 16 17 18 19 |
# File 'lib/platform_sdk/canvas_api/client.rb', line 15 def initialize(domain:, token:) @host = "https://#{domain}" @token = token @connection = Faraday.new(url: host, headers: { 'Authorization' => "Bearer #{token}" }) end |
Instance Attribute Details
#connection ⇒ Object (readonly)
Returns the value of attribute connection.
9 10 11 |
# File 'lib/platform_sdk/canvas_api/client.rb', line 9 def connection @connection end |
#host ⇒ Object (readonly)
Returns the value of attribute host.
9 10 11 |
# File 'lib/platform_sdk/canvas_api/client.rb', line 9 def host @host end |
#token ⇒ Object (readonly)
Returns the value of attribute token.
9 10 11 |
# File 'lib/platform_sdk/canvas_api/client.rb', line 9 def token @token end |
Instance Method Details
#assignment(course_id:, assignment_id:) ⇒ Object
96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 |
# File 'lib/platform_sdk/canvas_api/client.rb', line 96 def assignment(course_id:, assignment_id:) uri = "api/v1/courses/#{course_id}/assignments/#{assignment_id}" response = @connection.get(uri) handle_rate_limiting response if success?(response.status) MultiJson.load response.body, symbolize_keys: true else result = MultiJson.load response.body, symbolize_keys: true = String.new result[:errors].each do |error| << "#{error[:message]} " end raise "Error getting quiz submissions#{}" end end |
#assignments(course_id:, module_id:) ⇒ Object
79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 |
# File 'lib/platform_sdk/canvas_api/client.rb', line 79 def assignments(course_id:, module_id:) response = @connection.get("/api/v1/courses/#{course_id}/modules/#{module_id}/items?per_page=#{PAGE_SIZE}") handle_rate_limiting response if success?(response.status) assignments = paginated_items headers: response.headers, initial_response: response.body assignments.select { |item| item[:type] == 'Assignment' } else result = MultiJson.load response.body, symbolize_keys: true = String.new result[:errors].each do |error| << "#{error[:message]} " end raise "Error getting assignments: #{}" end end |
#course_modules(course_id:) ⇒ Object
23 24 25 26 27 28 29 30 31 32 33 34 35 36 |
# File 'lib/platform_sdk/canvas_api/client.rb', line 23 def course_modules(course_id:) response = @connection.get("/api/v1/courses/#{course_id}/modules") handle_rate_limiting response if success?(response.status) paginated_items headers: response.headers, initial_response: response.body else result = MultiJson.load response.body, symbolize_keys: true = String.new result[:errors].each do |error| << "#{error[:message]} " end raise "Error getting course modules: #{}" end end |
#course_students(course_id:) ⇒ Object
226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 |
# File 'lib/platform_sdk/canvas_api/client.rb', line 226 def course_students(course_id:) uri = "/api/v1/courses/#{course_id}/users?per_page=#{PAGE_SIZE}" params = { 'enrollment_type[]' => 'student' } response = @connection.get(uri, params) handle_rate_limiting response if success?(response.status) paginated_items headers: response.headers, initial_response: response.body else result = MultiJson.load response.body, symbolize_keys: true = String.new result[:errors].each do |error| << "#{error[:message]} " end raise "Error getting course students: #{}" end end |
#course_test_student(course_id:) ⇒ Object
244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 |
# File 'lib/platform_sdk/canvas_api/client.rb', line 244 def course_test_student(course_id:) uri = "/api/v1/courses/#{course_id}/users" params = { 'enrollment_type[]' => 'student_view' } response = @connection.get(uri, params) handle_rate_limiting response if success?(response.status) MultiJson.load response.body, symbolize_keys: true else result = MultiJson.load response.body, symbolize_keys: true = String.new result[:errors].each do |error| << "#{error[:message]} " end raise "Error getting test students: #{}" end end |
#course_users(course_id:) ⇒ Object
262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 |
# File 'lib/platform_sdk/canvas_api/client.rb', line 262 def course_users(course_id:) uri = "/api/v1/courses/#{course_id}/users?per_page=#{PAGE_SIZE}" response = @connection.get(uri) handle_rate_limiting response if success?(response.status) paginated_items headers: response.headers, initial_response: response.body else result = MultiJson.load response.body, symbolize_keys: true = String.new result[:errors].each do |error| << "#{error[:message]} " end raise "Error getting course users: #{}" end end |
#delete_module_item(course_id:, module_id:, module_item_id:) ⇒ Object
509 510 511 512 513 514 515 516 517 518 519 520 521 522 523 524 525 |
# File 'lib/platform_sdk/canvas_api/client.rb', line 509 def delete_module_item(course_id:, module_id:, module_item_id:) uri = "/api/v1/courses/#{course_id}/modules/#{module_id}/items/#{module_item_id}" response = @connection.delete(uri) do |req| req.headers['Content-Type'] = 'application/x-www-form-urlencoded' end handle_rate_limiting response result = MultiJson.load response.body, symbolize_keys: true if success?(response.status) result else = String.new result[:errors]&.each do |error| << "#{error[:message]} " end raise "Error destroying module item: #{}" end end |
#module_item(course_id:, module_id:, module_item_id:) ⇒ Object
115 116 117 118 119 120 121 122 123 124 125 126 127 128 |
# File 'lib/platform_sdk/canvas_api/client.rb', line 115 def module_item(course_id:, module_id:, module_item_id:) response = @connection.get("/api/v1/courses/#{course_id}/modules/#{module_id}/items/#{module_item_id}") handle_rate_limiting response if success?(response.status) MultiJson.load response.body, symbolize_keys: true else result = MultiJson.load response.body, symbolize_keys: true = String.new result[:errors].each do |error| << "#{error[:message]} " end raise "Error getting module item: #{}" end end |
#module_items(course_id:, module_id:) ⇒ Object
41 42 43 44 45 46 47 48 49 50 51 52 53 54 |
# File 'lib/platform_sdk/canvas_api/client.rb', line 41 def module_items(course_id:, module_id:) response = @connection.get("/api/v1/courses/#{course_id}/modules/#{module_id}/items?per_page=#{PAGE_SIZE}") handle_rate_limiting response if success?(response.status) paginated_items headers: response.headers, initial_response: response.body else result = MultiJson.load response.body, symbolize_keys: true = String.new result[:errors].each do |error| << "#{error[:message]} " end raise "Error getting module items: #{}" end end |
#post_complete_quiz_submission(course_id:, quiz_id:, submission_id:, attempt:, validation_token:) ⇒ Hash
336 337 338 339 340 341 342 343 344 345 346 347 348 |
# File 'lib/platform_sdk/canvas_api/client.rb', line 336 def post_complete_quiz_submission(course_id:, quiz_id:, submission_id:, attempt:, validation_token:) uri = "api/v1/courses/#{course_id}/quizzes/#{quiz_id}/submissions/#{submission_id}/complete" response = @connection.post(uri) do |req| req.headers['Content-Type'] = 'application/json' req.body = { attempt:, validation_token: }.to_json end handle_rate_limiting response if success?(response.status) MultiJson.load response.body, symbolize_keys: true else handle_post_response_errors(response, 'Error completing quiz submission') end end |
#post_create_quiz_submission(course_id:, quiz_id:, user_id:) ⇒ Object
319 320 321 322 323 324 325 326 327 328 |
# File 'lib/platform_sdk/canvas_api/client.rb', line 319 def post_create_quiz_submission(course_id:, quiz_id:, user_id:) uri = "api/v1/courses/#{course_id}/quizzes/#{quiz_id}/submissions?as_user_id=#{user_id}" response = @connection.post(uri) handle_rate_limiting response if success?(response.status) MultiJson.load response.body, symbolize_keys: true else handle_post_response_errors(response, 'Error creating quiz submission') end end |
#post_discussion_topic_entry(course_id:, topic_id:, user_id:, message:) ⇒ Object
382 383 384 385 386 387 388 389 390 391 392 393 394 395 396 397 398 399 |
# File 'lib/platform_sdk/canvas_api/client.rb', line 382 def post_discussion_topic_entry(course_id:, topic_id:, user_id:, message:) uri = "api/v1/courses/#{course_id}/discussion_topics/#{topic_id}/entries?as_user_id=#{user_id}" response = @connection.post(uri) do |req| req.headers['Content-Type'] = 'application/json' req.body = { 'message': .to_s }.to_json end handle_rate_limiting response if success?(response.status) MultiJson.load response.body, symbolize_keys: true else result = MultiJson.load response.body, symbolize_keys: true = String.new result[:errors]&.each do |error| << "#{error[:message]} " end raise "Error posting a reply: #{}" end end |
#post_mark_module_item_read(course_id:, module_id:, module_item_id:, user_id:) ⇒ Object
Returns nil.
355 356 357 358 359 360 361 362 363 364 |
# File 'lib/platform_sdk/canvas_api/client.rb', line 355 def post_mark_module_item_read(course_id:, module_id:, module_item_id:, user_id:) uri = "api/v1/courses/#{course_id}/modules/#{module_id}/items/#{module_item_id}/mark_read?as_user_id=#{user_id}" response = @connection.post(uri) handle_rate_limiting response if success?(response.status) MultiJson.load response.body, symbolize_keys: true else handle_post_response_errors(response, 'Error marking module items read') end end |
#post_module_item(course_id:, module_id:, body:) ⇒ Object
468 469 470 471 472 473 474 475 476 477 478 479 480 481 482 483 484 485 |
# File 'lib/platform_sdk/canvas_api/client.rb', line 468 def post_module_item(course_id:, module_id:, body:) uri = "/api/v1/courses/#{course_id}/modules/#{module_id}/items" response = @connection.post(uri) do |req| req.headers['Content-Type'] = 'application/x-www-form-urlencoded' req.body = body end handle_rate_limiting response result = MultiJson.load response.body, symbolize_keys: true if success?(response.status) result else = String.new result[:errors]&.each do |error| << "#{error[:message]} " end raise "Error creating module item: #{}" end end |
#put_mark_module_item_done(course_id:, module_id:, module_item_id:, user_id:) ⇒ Object
Returns nil.
371 372 373 374 375 376 377 378 379 380 |
# File 'lib/platform_sdk/canvas_api/client.rb', line 371 def put_mark_module_item_done(course_id:, module_id:, module_item_id:, user_id:) uri = "api/v1/courses/#{course_id}/modules/#{module_id}/items/#{module_item_id}/done?as_user_id=#{user_id}" response = @connection.put(uri) handle_rate_limiting response if success?(response.status) MultiJson.load response.body, symbolize_keys: true else handle_post_response_errors(response, 'Error marking module item done') end end |
#put_module_prerequesites(course_id:, module_id:, prerequisite_ids:) ⇒ Object
Note:
prerequisite_ids should be a valid module_id, sending and empty array removes all prerequisites.
420 421 422 423 424 425 426 427 428 429 430 431 432 433 434 435 436 437 |
# File 'lib/platform_sdk/canvas_api/client.rb', line 420 def put_module_prerequesites(course_id:, module_id:, prerequisite_ids:) uri = "/api/v1/courses/#{course_id}/modules/#{module_id}" response = @connection.put(uri) do |req| req.headers['Content-Type'] = 'application/x-www-form-urlencoded' req.body = { 'module[prerequisite_module_ids]' => prerequisite_ids } end handle_rate_limiting response result = MultiJson.load response.body, symbolize_keys: true if success?(response.status) result else = String.new result[:errors]&.each do |error| << "#{error[:message]} " end raise "Error updating module prerequisite: #{}" end end |
#put_publish_module_item(course_id:, module_id:, module_item_id:) ⇒ Object
490 491 492 493 494 495 496 497 498 499 500 501 502 503 504 505 506 507 |
# File 'lib/platform_sdk/canvas_api/client.rb', line 490 def put_publish_module_item(course_id:, module_id:, module_item_id:) uri = "/api/v1/courses/#{course_id}/modules/#{module_id}/items/#{module_item_id}" response = @connection.put(uri) do |req| req.headers['Content-Type'] = 'application/x-www-form-urlencoded' req.body = { 'module_item[published]' => true } end handle_rate_limiting response result = MultiJson.load response.body, symbolize_keys: true if success?(response.status) result else = String.new result[:errors]&.each do |error| << "#{error[:message]} " end raise "Error publishing module item: #{}" end end |
#put_recompute_module_prerequisites(course_id:, module_id:, original_name:) ⇒ Object
renames a module to recompute module prerequisites.
440 441 442 443 444 445 446 447 448 449 450 451 452 453 454 455 456 457 |
# File 'lib/platform_sdk/canvas_api/client.rb', line 440 def put_recompute_module_prerequisites(course_id:, module_id:, original_name:) uri = "/api/v1/courses/#{course_id}/modules/#{module_id}" response = @connection.put(uri) do |req| req.headers['Content-Type'] = 'application/x-www-form-urlencoded' req.body = { 'module[name]' => original_name } end handle_rate_limiting response result = MultiJson.load response.body, symbolize_keys: true if success?(response.status) result else = String.new result[:errors]&.each do |error| << "#{error[:message]} " end raise "Error updating refreshing module prerequisite: #{}" end end |
#put_relock_module(course_id:, module_id:) ⇒ Object
403 404 405 406 407 408 409 410 411 412 413 414 |
# File 'lib/platform_sdk/canvas_api/client.rb', line 403 def put_relock_module(course_id:, module_id:) uri = "api/v1/courses/#{course_id}/modules/#{module_id}/relock" response = @connection.put(uri) result = MultiJson.load response.body, symbolize_keys: true handle_rate_limiting response if success?(response.status) result else = parse_response_errors(result:, message: 'Error re-locking module') raise CanvasClientError, end end |
#quiz(course_id:, quiz_id:) ⇒ Object
280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 |
# File 'lib/platform_sdk/canvas_api/client.rb', line 280 def quiz(course_id:, quiz_id:) uri = "/api/v1/courses/#{course_id}/quizzes/#{quiz_id}" response = @connection.get(uri) handle_rate_limiting response if success?(response.status) MultiJson.load response.body, symbolize_keys: true else result = MultiJson.load response.body, symbolize_keys: true = String.new result[:errors].each do |error| << "#{error[:message]} " end raise "Error getting quiz: #{}" end end |
#quiz_submissions(course_id:, quiz_id:, user_id:) ⇒ Array
300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 |
# File 'lib/platform_sdk/canvas_api/client.rb', line 300 def quiz_submissions(course_id:, quiz_id:, user_id:) uri = "api/v1/courses/#{course_id}/quizzes/#{quiz_id}/submissions?user=#{user_id}&per_page=#{PAGE_SIZE}" response = @connection.get(uri) handle_rate_limiting response if success?(response.status) paginated_items headers: response.headers, initial_response: response.body else result = MultiJson.load response.body, symbolize_keys: true = String.new result[:errors].each do |error| << "#{error[:message]} " end raise "Error getting quiz submissions#{}" end end |
#retrieve_discussion_topic(course_id:, topic_id:) ⇒ Object
527 528 529 530 531 532 533 534 535 536 537 538 539 540 541 542 543 |
# File 'lib/platform_sdk/canvas_api/client.rb', line 527 def retrieve_discussion_topic(course_id:, topic_id:) uri = "/api/v1/courses/#{course_id}/discussion_topics/#{topic_id}" response = @connection.get(uri) do |req| req.headers['Content-Type'] = 'application/json' end handle_rate_limiting response result = MultiJson.load response.body, symbolize_keys: true if success?(response.status) result else = String.new result[:errors]&.each do |error| << "#{error[:message]} " end raise "Error retrieving discussion topic: #{}" end end |
#submissions(course_id:, assignment_id:) ⇒ Object
162 163 164 165 166 167 168 169 170 171 172 173 174 175 |
# File 'lib/platform_sdk/canvas_api/client.rb', line 162 def submissions(course_id:, assignment_id:) response = @connection.get("/api/v1/courses/#{course_id}/assignments/#{assignment_id}/submissions/") handle_rate_limiting response if success?(response.status) paginated_items headers: response.headers, initial_response: response.body else result = MultiJson.load response.body, symbolize_keys: true = String.new result[:errors].each do |error| << "#{error[:message]} " end raise "Error getting submissions: #{}" end end |
#update_submission_excused(course_id:, assignment_id:, user_id:) ⇒ Object
177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 |
# File 'lib/platform_sdk/canvas_api/client.rb', line 177 def update_submission_excused(course_id:, assignment_id:, user_id:) uri = "/api/v1/courses/#{course_id}/assignments/#{assignment_id}/submissions/#{user_id}" response = @connection.put(uri) do |req| req.headers["Content-Type"] = "application/json" req.body = { submission: { excuse: true } }.to_json end handle_rate_limiting response if success?(response.status) MultiJson.load response.body, symbolize_keys: true else result = MultiJson.load response.body, symbolize_keys: true = String.new result[:errors].each do |error| << "#{error[:message]} " end raise "Error update submissions to excused: #{}" end end |
#update_submission_excused_with_comment(course_id:, assignment_id:, user_id:, comment:) ⇒ Object
200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 |
# File 'lib/platform_sdk/canvas_api/client.rb', line 200 def update_submission_excused_with_comment(course_id:, assignment_id:, user_id:, comment:) uri = "/api/v1/courses/#{course_id}/assignments/#{assignment_id}/submissions/#{user_id}" response = @connection.put(uri) do |req| req.headers['Content-Type'] = 'application/json' req.body = { 'comment': { 'text_comment': comment }, 'submission': { 'excuse': true } }.to_json end if success?(response.status) MultiJson.load response.body, symbolize_keys: true else result = MultiJson.load response.body, symbolize_keys: true = String.new result[:errors].each do |error| << "#{error[:message]} " end raise "Error update submissions to excused: #{}" end end |
#user_module_item(course_id:, module_id:, module_item_id:, user_id:) ⇒ Object
130 131 132 133 134 135 136 137 138 139 140 141 142 143 |
# File 'lib/platform_sdk/canvas_api/client.rb', line 130 def user_module_item(course_id:, module_id:, module_item_id:, user_id:) response = @connection.get("/api/v1/courses/#{course_id}/modules/#{module_id}/items/#{module_item_id}?as_user_id=#{user_id}") handle_rate_limiting response if success?(response.status) MultiJson.load response.body, symbolize_keys: true else result = MultiJson.load response.body, symbolize_keys: true = String.new result[:errors].each do |error| << "#{error[:message]} " end raise "Error getting module item: #{}" end end |
#user_module_item_content_details(course_id:, module_id:, module_item_id:, user_id:) ⇒ Object
145 146 147 148 149 150 151 152 153 154 155 156 157 158 |
# File 'lib/platform_sdk/canvas_api/client.rb', line 145 def user_module_item_content_details(course_id:, module_id:, module_item_id:, user_id:) response = @connection.get("api/v1/courses/#{course_id}/modules/#{module_id}/items/#{module_item_id}?include[]=content_details&student_id=#{user_id}") handle_rate_limiting response if success?(response.status) MultiJson.load response.body, symbolize_keys: true else result = MultiJson.load response.body, symbolize_keys: true = String.new result[:errors].each do |error| << "#{error[:message]} " end raise "Error getting module item: #{}" end end |
#user_module_items(course_id:, module_id:, user_id:) ⇒ Object
60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 |
# File 'lib/platform_sdk/canvas_api/client.rb', line 60 def user_module_items(course_id:, module_id:, user_id:) uri = "/api/v1/courses/#{course_id}/modules/#{module_id}/items?as_user_id=#{user_id}&per_page=#{PAGE_SIZE}" response = @connection.get(uri) handle_rate_limiting response if success?(response.status) paginated_items headers: response.headers, initial_response: response.body else result = MultiJson.load response.body, symbolize_keys: true = String.new result[:errors].each do |error| << "#{error[:message]} " end raise "Error getting module items: #{}" end end |