All URIs are relative to https://api.flat.io/v2
Method | HTTP request | Description |
---|---|---|
activate_class | POST /classes/{class}/activate | Activate the class |
add_class_user | PUT /classes/{class}/users/{user} | Add a user to the class |
archive_assignment | POST /classes/{class}/assignments/{assignment}/archive | Archive the assignment |
archive_class | POST /classes/{class}/archive | Archive the class |
copy_assignment | POST /classes/{class}/assignments/{assignment}/copy | Copy an assignment |
create_class | POST /classes | Create a new class |
create_class_assignment | POST /classes/{class}/assignments | Assignment creation |
create_submission | PUT /classes/{class}/assignments/{assignment}/submissions | Create or edit a submission |
create_test_student_account | POST /classes/{class}/testStudent | Create a test student account |
delete_class_user | DELETE /classes/{class}/users/{user} | Remove a user from the class |
delete_submission | DELETE /classes/{class}/assignments/{assignment}/submissions/{submission} | Reset a submission |
delete_submission_comment | DELETE /classes/{class}/assignments/{assignment}/submissions/{submission}/comments/{comment} | Delete a feedback comment to a submission |
edit_submission | PUT /classes/{class}/assignments/{assignment}/submissions/{submission} | Edit a submission |
enroll_class | POST /classes/enroll/{enrollmentCode} | Join a class |
export_submissions_reviews_as_csv | GET /classes/{class}/assignments/{assignment}/submissions/csv | CSV Grades exports |
export_submissions_reviews_as_excel | GET /classes/{class}/assignments/{assignment}/submissions/excel | Excel Grades exports |
get_class | GET /classes/{class} | Get the details of a single class |
get_score_submissions | GET /scores/{score}/submissions | List submissions related to the score |
get_submission | GET /classes/{class}/assignments/{assignment}/submissions/{submission} | Get a student submission |
get_submission_comments | GET /classes/{class}/assignments/{assignment}/submissions/{submission}/comments | List the feedback comments of a submission |
get_submission_history | GET /classes/{class}/assignments/{assignment}/submissions/{submission}/history | Get the history of the submission |
get_submissions | GET /classes/{class}/assignments/{assignment}/submissions | List the students' submissions |
list_assignments | GET /classes/{class}/assignments | Assignments listing |
list_class_student_submissions | GET /classes/{class}/students/{user}/submissions | List the submissions for a student |
list_classes | GET /classes | List the classes available for the current user |
post_submission_comment | POST /classes/{class}/assignments/{assignment}/submissions/{submission}/comments | Add a feedback comment to a submission |
unarchive_assignment | DELETE /classes/{class}/assignments/{assignment}/archive | Unarchive the assignment. |
unarchive_class | DELETE /classes/{class}/archive | Unarchive the class |
update_class | PUT /classes/{class} | Update the class |
update_submission_comment | PUT /classes/{class}/assignments/{assignment}/submissions/{submission}/comments/{comment} | Update a feedback comment to a submission |
activate_class(_class)
Activate the class
Mark the class as active
. This is mainly used for classes synchronized from Clever that are initially with an inactive
state and hidden in the UI.
require 'time'
require 'flat_api'
# setup authorization
FlatApi.configure do |config|
# Configure OAuth2 access token for authorization: OAuth2
config.access_token = 'YOUR ACCESS TOKEN'
end
api_instance = FlatApi::ClassApi.new
_class = '_class_example' # String | Unique identifier of the class
begin
# Activate the class
result = api_instance.activate_class(_class)
p result
rescue FlatApi::ApiError => e
puts "Error when calling ClassApi->activate_class: #{e}"
end
This returns an Array which contains the response data, status code and headers.
<Array(, Integer, Hash)> activate_class_with_http_info(_class)
begin
# Activate the class
data, status_code, headers = api_instance.activate_class_with_http_info(_class)
p status_code # => 2xx
p headers # => { ... }
p data # => <ClassDetails>
rescue FlatApi::ApiError => e
puts "Error when calling ClassApi->activate_class_with_http_info: #{e}"
end
Name | Type | Description | Notes |
---|---|---|---|
_class | String | Unique identifier of the class |
- Content-Type: Not defined
- Accept: application/json
add_class_user(_class, user)
Add a user to the class
This method can be used by a teacher of the class to enroll another Flat user into the class. Only users that are part of your Organization can be enrolled in a class of this same Organization. When enrolling a user in the class, Flat will automatically add this user to the corresponding Class group, based on this role in the Organization.
require 'time'
require 'flat_api'
# setup authorization
FlatApi.configure do |config|
# Configure OAuth2 access token for authorization: OAuth2
config.access_token = 'YOUR ACCESS TOKEN'
end
api_instance = FlatApi::ClassApi.new
_class = '_class_example' # String | Unique identifier of the class
user = 'user_example' # String | Unique identifier of the user
begin
# Add a user to the class
api_instance.add_class_user(_class, user)
rescue FlatApi::ApiError => e
puts "Error when calling ClassApi->add_class_user: #{e}"
end
This returns an Array which contains the response data (nil
in this case), status code and headers.
<Array(nil, Integer, Hash)> add_class_user_with_http_info(_class, user)
begin
# Add a user to the class
data, status_code, headers = api_instance.add_class_user_with_http_info(_class, user)
p status_code # => 2xx
p headers # => { ... }
p data # => nil
rescue FlatApi::ApiError => e
puts "Error when calling ClassApi->add_class_user_with_http_info: #{e}"
end
Name | Type | Description | Notes |
---|---|---|---|
_class | String | Unique identifier of the class | |
user | String | Unique identifier of the user |
nil (empty response body)
- Content-Type: Not defined
- Accept: application/json
archive_assignment(_class, assignment)
Archive the assignment
Archive the assignment
require 'time'
require 'flat_api'
# setup authorization
FlatApi.configure do |config|
# Configure OAuth2 access token for authorization: OAuth2
config.access_token = 'YOUR ACCESS TOKEN'
end
api_instance = FlatApi::ClassApi.new
_class = '_class_example' # String | Unique identifier of the class
assignment = 'assignment_example' # String | Unique identifier of the assignment
begin
# Archive the assignment
result = api_instance.archive_assignment(_class, assignment)
p result
rescue FlatApi::ApiError => e
puts "Error when calling ClassApi->archive_assignment: #{e}"
end
This returns an Array which contains the response data, status code and headers.
<Array(, Integer, Hash)> archive_assignment_with_http_info(_class, assignment)
begin
# Archive the assignment
data, status_code, headers = api_instance.archive_assignment_with_http_info(_class, assignment)
p status_code # => 2xx
p headers # => { ... }
p data # => <Assignment>
rescue FlatApi::ApiError => e
puts "Error when calling ClassApi->archive_assignment_with_http_info: #{e}"
end
Name | Type | Description | Notes |
---|---|---|---|
_class | String | Unique identifier of the class | |
assignment | String | Unique identifier of the assignment |
- Content-Type: Not defined
- Accept: application/json
archive_class(_class)
Archive the class
Mark the class as archived
. When this course is synchronized with another app, like Google Classroom, this state will be automatically be updated.
require 'time'
require 'flat_api'
# setup authorization
FlatApi.configure do |config|
# Configure OAuth2 access token for authorization: OAuth2
config.access_token = 'YOUR ACCESS TOKEN'
end
api_instance = FlatApi::ClassApi.new
_class = '_class_example' # String | Unique identifier of the class
begin
# Archive the class
result = api_instance.archive_class(_class)
p result
rescue FlatApi::ApiError => e
puts "Error when calling ClassApi->archive_class: #{e}"
end
This returns an Array which contains the response data, status code and headers.
<Array(, Integer, Hash)> archive_class_with_http_info(_class)
begin
# Archive the class
data, status_code, headers = api_instance.archive_class_with_http_info(_class)
p status_code # => 2xx
p headers # => { ... }
p data # => <ClassDetails>
rescue FlatApi::ApiError => e
puts "Error when calling ClassApi->archive_class_with_http_info: #{e}"
end
Name | Type | Description | Notes |
---|---|---|---|
_class | String | Unique identifier of the class |
- Content-Type: Not defined
- Accept: application/json
copy_assignment(_class, assignment, body)
Copy an assignment
Copy an assignment to a specified class or the resource library For class assignments: - If the original assignment has a due date in the past, this new assignment will be created without a due date. - If the class is synchronized with an external app (e.g. Google Classroom), the copied assignment will also be posted on the external app.
require 'time'
require 'flat_api'
# setup authorization
FlatApi.configure do |config|
# Configure OAuth2 access token for authorization: OAuth2
config.access_token = 'YOUR ACCESS TOKEN'
end
api_instance = FlatApi::ClassApi.new
_class = '_class_example' # String | Unique identifier of the class
assignment = 'assignment_example' # String | Unique identifier of the assignment
body = FlatApi::AssignmentCopyToClass.new({classroom: 'classroom_example'}) # AssignmentCopy |
begin
# Copy an assignment
result = api_instance.copy_assignment(_class, assignment, body)
p result
rescue FlatApi::ApiError => e
puts "Error when calling ClassApi->copy_assignment: #{e}"
end
This returns an Array which contains the response data, status code and headers.
<Array(, Integer, Hash)> copy_assignment_with_http_info(_class, assignment, body)
begin
# Copy an assignment
data, status_code, headers = api_instance.copy_assignment_with_http_info(_class, assignment, body)
p status_code # => 2xx
p headers # => { ... }
p data # => <AssignmentCopyResponse>
rescue FlatApi::ApiError => e
puts "Error when calling ClassApi->copy_assignment_with_http_info: #{e}"
end
Name | Type | Description | Notes |
---|---|---|---|
_class | String | Unique identifier of the class | |
assignment | String | Unique identifier of the assignment | |
body | AssignmentCopy |
- Content-Type: application/json
- Accept: application/json
create_class(body)
Create a new class
Classrooms on Flat allow you to create activities with assignments and post content to a specific group. When creating a class, Flat automatically creates two groups: one for the teachers of the course, one for the students. The creator of this class is automatically added to the teachers group. If the classsroom is synchronized with another application like Google Classroom, some of the meta information will automatically be updated. You can add users to this class using PUT /classes/{class}/users/{user}
, they will automatically added to the group based on their role on Flat. Users can also enroll themselves to this class using POST /classes/enroll/{enrollmentCode}
and the enrollmentCode
returned in the ClassDetails
response.
require 'time'
require 'flat_api'
# setup authorization
FlatApi.configure do |config|
# Configure OAuth2 access token for authorization: OAuth2
config.access_token = 'YOUR ACCESS TOKEN'
end
api_instance = FlatApi::ClassApi.new
body = FlatApi::ClassCreation.new({name: 'name_example'}) # ClassCreation |
begin
# Create a new class
result = api_instance.create_class(body)
p result
rescue FlatApi::ApiError => e
puts "Error when calling ClassApi->create_class: #{e}"
end
This returns an Array which contains the response data, status code and headers.
<Array(, Integer, Hash)> create_class_with_http_info(body)
begin
# Create a new class
data, status_code, headers = api_instance.create_class_with_http_info(body)
p status_code # => 2xx
p headers # => { ... }
p data # => <ClassDetails>
rescue FlatApi::ApiError => e
puts "Error when calling ClassApi->create_class_with_http_info: #{e}"
end
Name | Type | Description | Notes |
---|---|---|---|
body | ClassCreation |
- Content-Type: application/json
- Accept: application/json
create_class_assignment(_class, body)
Assignment creation
Use this method as a teacher to create and post a new assignment to a class. If the class is synchronized with Google Classroom, the assignment will be automatically posted to your Classroom course.
require 'time'
require 'flat_api'
# setup authorization
FlatApi.configure do |config|
# Configure OAuth2 access token for authorization: OAuth2
config.access_token = 'YOUR ACCESS TOKEN'
end
api_instance = FlatApi::ClassApi.new
_class = '_class_example' # String | Unique identifier of the class
body = FlatApi::ClassAssignmentUpdate.new # ClassAssignmentUpdate |
begin
# Assignment creation
result = api_instance.create_class_assignment(_class, body)
p result
rescue FlatApi::ApiError => e
puts "Error when calling ClassApi->create_class_assignment: #{e}"
end
This returns an Array which contains the response data, status code and headers.
<Array(, Integer, Hash)> create_class_assignment_with_http_info(_class, body)
begin
# Assignment creation
data, status_code, headers = api_instance.create_class_assignment_with_http_info(_class, body)
p status_code # => 2xx
p headers # => { ... }
p data # => <Assignment>
rescue FlatApi::ApiError => e
puts "Error when calling ClassApi->create_class_assignment_with_http_info: #{e}"
end
Name | Type | Description | Notes |
---|---|---|---|
_class | String | Unique identifier of the class | |
body | ClassAssignmentUpdate |
- Content-Type: application/json
- Accept: application/json
create_submission(_class, assignment, body)
Create or edit a submission
Use this method as a student to create, update and submit a submission related to an assignment. Students can only set attachments
and submit
. Teachers can use PUT /classes/{class}/assignments/{assignment}/submissions/{submission}
to update a submission by id.
require 'time'
require 'flat_api'
# setup authorization
FlatApi.configure do |config|
# Configure OAuth2 access token for authorization: OAuth2
config.access_token = 'YOUR ACCESS TOKEN'
end
api_instance = FlatApi::ClassApi.new
_class = '_class_example' # String | Unique identifier of the class
assignment = 'assignment_example' # String | Unique identifier of the assignment
body = FlatApi::AssignmentSubmissionUpdate.new # AssignmentSubmissionUpdate |
begin
# Create or edit a submission
result = api_instance.create_submission(_class, assignment, body)
p result
rescue FlatApi::ApiError => e
puts "Error when calling ClassApi->create_submission: #{e}"
end
This returns an Array which contains the response data, status code and headers.
<Array(, Integer, Hash)> create_submission_with_http_info(_class, assignment, body)
begin
# Create or edit a submission
data, status_code, headers = api_instance.create_submission_with_http_info(_class, assignment, body)
p status_code # => 2xx
p headers # => { ... }
p data # => <AssignmentSubmission>
rescue FlatApi::ApiError => e
puts "Error when calling ClassApi->create_submission_with_http_info: #{e}"
end
Name | Type | Description | Notes |
---|---|---|---|
_class | String | Unique identifier of the class | |
assignment | String | Unique identifier of the assignment | |
body | AssignmentSubmissionUpdate |
- Content-Type: application/json
- Accept: application/json
create_test_student_account(_class, opts)
Create a test student account
Test students account can be created by teachers an admin and be used to experiment the assignments. - They are automatically added to the class. - They can be reset using this API endpoint (a new account will be created and the previous one scheduled for deletion). - These accounts don't use a user license.
require 'time'
require 'flat_api'
# setup authorization
FlatApi.configure do |config|
# Configure OAuth2 access token for authorization: OAuth2
config.access_token = 'YOUR ACCESS TOKEN'
end
api_instance = FlatApi::ClassApi.new
_class = '_class_example' # String | Unique identifier of the class
opts = {
reset: true # Boolean | If true, the testing account will be re-created.
}
begin
# Create a test student account
result = api_instance.create_test_student_account(_class, opts)
p result
rescue FlatApi::ApiError => e
puts "Error when calling ClassApi->create_test_student_account: #{e}"
end
This returns an Array which contains the response data, status code and headers.
<Array(, Integer, Hash)> create_test_student_account_with_http_info(_class, opts)
begin
# Create a test student account
data, status_code, headers = api_instance.create_test_student_account_with_http_info(_class, opts)
p status_code # => 2xx
p headers # => { ... }
p data # => <UserDetails>
rescue FlatApi::ApiError => e
puts "Error when calling ClassApi->create_test_student_account_with_http_info: #{e}"
end
Name | Type | Description | Notes |
---|---|---|---|
_class | String | Unique identifier of the class | |
reset | Boolean | If true, the testing account will be re-created. | [optional] |
- Content-Type: Not defined
- Accept: application/json
delete_class_user(_class, user)
Remove a user from the class
This method can be used by a teacher to remove a user from the class, or by a student to leave the classroom. Warning: Removing a user from the class will remove the associated resources, including the submissions and feedback related to these submissions.
require 'time'
require 'flat_api'
# setup authorization
FlatApi.configure do |config|
# Configure OAuth2 access token for authorization: OAuth2
config.access_token = 'YOUR ACCESS TOKEN'
end
api_instance = FlatApi::ClassApi.new
_class = '_class_example' # String | Unique identifier of the class
user = 'user_example' # String | Unique identifier of the user
begin
# Remove a user from the class
api_instance.delete_class_user(_class, user)
rescue FlatApi::ApiError => e
puts "Error when calling ClassApi->delete_class_user: #{e}"
end
This returns an Array which contains the response data (nil
in this case), status code and headers.
<Array(nil, Integer, Hash)> delete_class_user_with_http_info(_class, user)
begin
# Remove a user from the class
data, status_code, headers = api_instance.delete_class_user_with_http_info(_class, user)
p status_code # => 2xx
p headers # => { ... }
p data # => nil
rescue FlatApi::ApiError => e
puts "Error when calling ClassApi->delete_class_user_with_http_info: #{e}"
end
Name | Type | Description | Notes |
---|---|---|---|
_class | String | Unique identifier of the class | |
user | String | Unique identifier of the user |
nil (empty response body)
- Content-Type: Not defined
- Accept: application/json
delete_submission(_class, assignment, submission)
Reset a submission
Use this method as a teacher to reset a submission and allow student to start over the assignment
require 'time'
require 'flat_api'
# setup authorization
FlatApi.configure do |config|
# Configure OAuth2 access token for authorization: OAuth2
config.access_token = 'YOUR ACCESS TOKEN'
end
api_instance = FlatApi::ClassApi.new
_class = '_class_example' # String | Unique identifier of the class
assignment = 'assignment_example' # String | Unique identifier of the assignment
submission = 'submission_example' # String | Unique identifier of the submission
begin
# Reset a submission
result = api_instance.delete_submission(_class, assignment, submission)
p result
rescue FlatApi::ApiError => e
puts "Error when calling ClassApi->delete_submission: #{e}"
end
This returns an Array which contains the response data, status code and headers.
<Array(, Integer, Hash)> delete_submission_with_http_info(_class, assignment, submission)
begin
# Reset a submission
data, status_code, headers = api_instance.delete_submission_with_http_info(_class, assignment, submission)
p status_code # => 2xx
p headers # => { ... }
p data # => <AssignmentSubmission>
rescue FlatApi::ApiError => e
puts "Error when calling ClassApi->delete_submission_with_http_info: #{e}"
end
Name | Type | Description | Notes |
---|---|---|---|
_class | String | Unique identifier of the class | |
assignment | String | Unique identifier of the assignment | |
submission | String | Unique identifier of the submission |
- Content-Type: Not defined
- Accept: application/json
delete_submission_comment(_class, assignment, submission, comment)
Delete a feedback comment to a submission
require 'time'
require 'flat_api'
# setup authorization
FlatApi.configure do |config|
# Configure OAuth2 access token for authorization: OAuth2
config.access_token = 'YOUR ACCESS TOKEN'
end
api_instance = FlatApi::ClassApi.new
_class = '_class_example' # String | Unique identifier of the class
assignment = 'assignment_example' # String | Unique identifier of the assignment
submission = 'submission_example' # String | Unique identifier of the submission
comment = 'comment_example' # String | Unique identifier of the comment
begin
# Delete a feedback comment to a submission
api_instance.delete_submission_comment(_class, assignment, submission, comment)
rescue FlatApi::ApiError => e
puts "Error when calling ClassApi->delete_submission_comment: #{e}"
end
This returns an Array which contains the response data (nil
in this case), status code and headers.
<Array(nil, Integer, Hash)> delete_submission_comment_with_http_info(_class, assignment, submission, comment)
begin
# Delete a feedback comment to a submission
data, status_code, headers = api_instance.delete_submission_comment_with_http_info(_class, assignment, submission, comment)
p status_code # => 2xx
p headers # => { ... }
p data # => nil
rescue FlatApi::ApiError => e
puts "Error when calling ClassApi->delete_submission_comment_with_http_info: #{e}"
end
Name | Type | Description | Notes |
---|---|---|---|
_class | String | Unique identifier of the class | |
assignment | String | Unique identifier of the assignment | |
submission | String | Unique identifier of the submission | |
comment | String | Unique identifier of the comment |
nil (empty response body)
- Content-Type: Not defined
- Accept: application/json
edit_submission(_class, assignment, submission, body)
Edit a submission
Use this method as a teacher to update the different submission and give feedback. Teachers can only set return
, draftGrade
and grade
require 'time'
require 'flat_api'
# setup authorization
FlatApi.configure do |config|
# Configure OAuth2 access token for authorization: OAuth2
config.access_token = 'YOUR ACCESS TOKEN'
end
api_instance = FlatApi::ClassApi.new
_class = '_class_example' # String | Unique identifier of the class
assignment = 'assignment_example' # String | Unique identifier of the assignment
submission = 'submission_example' # String | Unique identifier of the submission
body = FlatApi::AssignmentSubmissionUpdate.new # AssignmentSubmissionUpdate |
begin
# Edit a submission
result = api_instance.edit_submission(_class, assignment, submission, body)
p result
rescue FlatApi::ApiError => e
puts "Error when calling ClassApi->edit_submission: #{e}"
end
This returns an Array which contains the response data, status code and headers.
<Array(, Integer, Hash)> edit_submission_with_http_info(_class, assignment, submission, body)
begin
# Edit a submission
data, status_code, headers = api_instance.edit_submission_with_http_info(_class, assignment, submission, body)
p status_code # => 2xx
p headers # => { ... }
p data # => <AssignmentSubmission>
rescue FlatApi::ApiError => e
puts "Error when calling ClassApi->edit_submission_with_http_info: #{e}"
end
Name | Type | Description | Notes |
---|---|---|---|
_class | String | Unique identifier of the class | |
assignment | String | Unique identifier of the assignment | |
submission | String | Unique identifier of the submission | |
body | AssignmentSubmissionUpdate |
- Content-Type: application/json
- Accept: application/json
enroll_class(enrollment_code)
Join a class
Use this method to join a class using an enrollment code given one of the teacher of this class. This code is also available in the ClassDetails
returned to the teachers when creating the class or listing / fetching a specific class. Flat will automatically add the user to the corresponding class group based on this role in the organization.
require 'time'
require 'flat_api'
# setup authorization
FlatApi.configure do |config|
# Configure OAuth2 access token for authorization: OAuth2
config.access_token = 'YOUR ACCESS TOKEN'
end
api_instance = FlatApi::ClassApi.new
enrollment_code = 'enrollment_code_example' # String | The enrollment code, available to the teacher in `ClassDetails`
begin
# Join a class
result = api_instance.enroll_class(enrollment_code)
p result
rescue FlatApi::ApiError => e
puts "Error when calling ClassApi->enroll_class: #{e}"
end
This returns an Array which contains the response data, status code and headers.
<Array(, Integer, Hash)> enroll_class_with_http_info(enrollment_code)
begin
# Join a class
data, status_code, headers = api_instance.enroll_class_with_http_info(enrollment_code)
p status_code # => 2xx
p headers # => { ... }
p data # => <ClassDetails>
rescue FlatApi::ApiError => e
puts "Error when calling ClassApi->enroll_class_with_http_info: #{e}"
end
Name | Type | Description | Notes |
---|---|---|---|
enrollment_code | String | The enrollment code, available to the teacher in `ClassDetails` |
- Content-Type: Not defined
- Accept: application/json
File export_submissions_reviews_as_csv(_class, assignment)
CSV Grades exports
Export list of submissions grades to a CSV file
require 'time'
require 'flat_api'
# setup authorization
FlatApi.configure do |config|
# Configure OAuth2 access token for authorization: OAuth2
config.access_token = 'YOUR ACCESS TOKEN'
end
api_instance = FlatApi::ClassApi.new
_class = '_class_example' # String | Unique identifier of the class
assignment = 'assignment_example' # String | Unique identifier of the assignment
begin
# CSV Grades exports
result = api_instance.export_submissions_reviews_as_csv(_class, assignment)
p result
rescue FlatApi::ApiError => e
puts "Error when calling ClassApi->export_submissions_reviews_as_csv: #{e}"
end
This returns an Array which contains the response data, status code and headers.
<Array(File, Integer, Hash)> export_submissions_reviews_as_csv_with_http_info(_class, assignment)
begin
# CSV Grades exports
data, status_code, headers = api_instance.export_submissions_reviews_as_csv_with_http_info(_class, assignment)
p status_code # => 2xx
p headers # => { ... }
p data # => File
rescue FlatApi::ApiError => e
puts "Error when calling ClassApi->export_submissions_reviews_as_csv_with_http_info: #{e}"
end
Name | Type | Description | Notes |
---|---|---|---|
_class | String | Unique identifier of the class | |
assignment | String | Unique identifier of the assignment |
File
- Content-Type: Not defined
- Accept: text/csv
File export_submissions_reviews_as_excel(_class, assignment)
Excel Grades exports
Export list of submissions grades to an Excel file
require 'time'
require 'flat_api'
# setup authorization
FlatApi.configure do |config|
# Configure OAuth2 access token for authorization: OAuth2
config.access_token = 'YOUR ACCESS TOKEN'
end
api_instance = FlatApi::ClassApi.new
_class = '_class_example' # String | Unique identifier of the class
assignment = 'assignment_example' # String | Unique identifier of the assignment
begin
# Excel Grades exports
result = api_instance.export_submissions_reviews_as_excel(_class, assignment)
p result
rescue FlatApi::ApiError => e
puts "Error when calling ClassApi->export_submissions_reviews_as_excel: #{e}"
end
This returns an Array which contains the response data, status code and headers.
<Array(File, Integer, Hash)> export_submissions_reviews_as_excel_with_http_info(_class, assignment)
begin
# Excel Grades exports
data, status_code, headers = api_instance.export_submissions_reviews_as_excel_with_http_info(_class, assignment)
p status_code # => 2xx
p headers # => { ... }
p data # => File
rescue FlatApi::ApiError => e
puts "Error when calling ClassApi->export_submissions_reviews_as_excel_with_http_info: #{e}"
end
Name | Type | Description | Notes |
---|---|---|---|
_class | String | Unique identifier of the class | |
assignment | String | Unique identifier of the assignment |
File
- Content-Type: Not defined
- Accept: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
get_class(_class)
Get the details of a single class
require 'time'
require 'flat_api'
# setup authorization
FlatApi.configure do |config|
# Configure OAuth2 access token for authorization: OAuth2
config.access_token = 'YOUR ACCESS TOKEN'
end
api_instance = FlatApi::ClassApi.new
_class = '_class_example' # String | Unique identifier of the class
begin
# Get the details of a single class
result = api_instance.get_class(_class)
p result
rescue FlatApi::ApiError => e
puts "Error when calling ClassApi->get_class: #{e}"
end
This returns an Array which contains the response data, status code and headers.
<Array(, Integer, Hash)> get_class_with_http_info(_class)
begin
# Get the details of a single class
data, status_code, headers = api_instance.get_class_with_http_info(_class)
p status_code # => 2xx
p headers # => { ... }
p data # => <ClassDetails>
rescue FlatApi::ApiError => e
puts "Error when calling ClassApi->get_class_with_http_info: #{e}"
end
Name | Type | Description | Notes |
---|---|---|---|
_class | String | Unique identifier of the class |
- Content-Type: Not defined
- Accept: application/json
<Array> get_score_submissions(score)
List submissions related to the score
This API call will list the different assignments submissions where the score is attached. This method can be used by anyone that are part of the organization and have at least read access to the document.
require 'time'
require 'flat_api'
# setup authorization
FlatApi.configure do |config|
# Configure OAuth2 access token for authorization: OAuth2
config.access_token = 'YOUR ACCESS TOKEN'
end
api_instance = FlatApi::ClassApi.new
score = 'score_example' # String | Unique identifier of the score document. This can be a Flat Score unique identifier (i.e. `ScoreDetails.id`) or, if the score is also a Google Drive file, the Drive file unique identifier prefixed with `drive-` (e.g. `drive-0B000000000`).
begin
# List submissions related to the score
result = api_instance.get_score_submissions(score)
p result
rescue FlatApi::ApiError => e
puts "Error when calling ClassApi->get_score_submissions: #{e}"
end
This returns an Array which contains the response data, status code and headers.
<Array(<Array>, Integer, Hash)> get_score_submissions_with_http_info(score)
begin
# List submissions related to the score
data, status_code, headers = api_instance.get_score_submissions_with_http_info(score)
p status_code # => 2xx
p headers # => { ... }
p data # => <Array<AssignmentSubmission>>
rescue FlatApi::ApiError => e
puts "Error when calling ClassApi->get_score_submissions_with_http_info: #{e}"
end
Name | Type | Description | Notes |
---|---|---|---|
score | String | Unique identifier of the score document. This can be a Flat Score unique identifier (i.e. `ScoreDetails.id`) or, if the score is also a Google Drive file, the Drive file unique identifier prefixed with `drive-` (e.g. `drive-0B000000000`). |
- Content-Type: Not defined
- Accept: application/json
get_submission(_class, assignment, submission)
Get a student submission
require 'time'
require 'flat_api'
# setup authorization
FlatApi.configure do |config|
# Configure OAuth2 access token for authorization: OAuth2
config.access_token = 'YOUR ACCESS TOKEN'
end
api_instance = FlatApi::ClassApi.new
_class = '_class_example' # String | Unique identifier of the class
assignment = 'assignment_example' # String | Unique identifier of the assignment
submission = 'submission_example' # String | Unique identifier of the submission
begin
# Get a student submission
result = api_instance.get_submission(_class, assignment, submission)
p result
rescue FlatApi::ApiError => e
puts "Error when calling ClassApi->get_submission: #{e}"
end
This returns an Array which contains the response data, status code and headers.
<Array(, Integer, Hash)> get_submission_with_http_info(_class, assignment, submission)
begin
# Get a student submission
data, status_code, headers = api_instance.get_submission_with_http_info(_class, assignment, submission)
p status_code # => 2xx
p headers # => { ... }
p data # => <AssignmentSubmission>
rescue FlatApi::ApiError => e
puts "Error when calling ClassApi->get_submission_with_http_info: #{e}"
end
Name | Type | Description | Notes |
---|---|---|---|
_class | String | Unique identifier of the class | |
assignment | String | Unique identifier of the assignment | |
submission | String | Unique identifier of the submission |
- Content-Type: Not defined
- Accept: application/json
<Array> get_submission_comments(_class, assignment, submission)
List the feedback comments of a submission
require 'time'
require 'flat_api'
# setup authorization
FlatApi.configure do |config|
# Configure OAuth2 access token for authorization: OAuth2
config.access_token = 'YOUR ACCESS TOKEN'
end
api_instance = FlatApi::ClassApi.new
_class = '_class_example' # String | Unique identifier of the class
assignment = 'assignment_example' # String | Unique identifier of the assignment
submission = 'submission_example' # String | Unique identifier of the submission
begin
# List the feedback comments of a submission
result = api_instance.get_submission_comments(_class, assignment, submission)
p result
rescue FlatApi::ApiError => e
puts "Error when calling ClassApi->get_submission_comments: #{e}"
end
This returns an Array which contains the response data, status code and headers.
<Array(<Array>, Integer, Hash)> get_submission_comments_with_http_info(_class, assignment, submission)
begin
# List the feedback comments of a submission
data, status_code, headers = api_instance.get_submission_comments_with_http_info(_class, assignment, submission)
p status_code # => 2xx
p headers # => { ... }
p data # => <Array<AssignmentSubmissionComment>>
rescue FlatApi::ApiError => e
puts "Error when calling ClassApi->get_submission_comments_with_http_info: #{e}"
end
Name | Type | Description | Notes |
---|---|---|---|
_class | String | Unique identifier of the class | |
assignment | String | Unique identifier of the assignment | |
submission | String | Unique identifier of the submission |
Array<AssignmentSubmissionComment>
- Content-Type: Not defined
- Accept: application/json
<Array> get_submission_history(_class, assignment, submission)
Get the history of the submission
For teachers only. Returns a detailed history of the submission. This currently includes state and grade histories.
require 'time'
require 'flat_api'
# setup authorization
FlatApi.configure do |config|
# Configure OAuth2 access token for authorization: OAuth2
config.access_token = 'YOUR ACCESS TOKEN'
end
api_instance = FlatApi::ClassApi.new
_class = '_class_example' # String | Unique identifier of the class
assignment = 'assignment_example' # String | Unique identifier of the assignment
submission = 'submission_example' # String | Unique identifier of the submission
begin
# Get the history of the submission
result = api_instance.get_submission_history(_class, assignment, submission)
p result
rescue FlatApi::ApiError => e
puts "Error when calling ClassApi->get_submission_history: #{e}"
end
This returns an Array which contains the response data, status code and headers.
<Array(<Array>, Integer, Hash)> get_submission_history_with_http_info(_class, assignment, submission)
begin
# Get the history of the submission
data, status_code, headers = api_instance.get_submission_history_with_http_info(_class, assignment, submission)
p status_code # => 2xx
p headers # => { ... }
p data # => <Array<AssignmentSubmissionHistory>>
rescue FlatApi::ApiError => e
puts "Error when calling ClassApi->get_submission_history_with_http_info: #{e}"
end
Name | Type | Description | Notes |
---|---|---|---|
_class | String | Unique identifier of the class | |
assignment | String | Unique identifier of the assignment | |
submission | String | Unique identifier of the submission |
Array<AssignmentSubmissionHistory>
- Content-Type: Not defined
- Accept: application/json
<Array> get_submissions(_class, assignment)
List the students' submissions
require 'time'
require 'flat_api'
# setup authorization
FlatApi.configure do |config|
# Configure OAuth2 access token for authorization: OAuth2
config.access_token = 'YOUR ACCESS TOKEN'
end
api_instance = FlatApi::ClassApi.new
_class = '_class_example' # String | Unique identifier of the class
assignment = 'assignment_example' # String | Unique identifier of the assignment
begin
# List the students' submissions
result = api_instance.get_submissions(_class, assignment)
p result
rescue FlatApi::ApiError => e
puts "Error when calling ClassApi->get_submissions: #{e}"
end
This returns an Array which contains the response data, status code and headers.
<Array(<Array>, Integer, Hash)> get_submissions_with_http_info(_class, assignment)
begin
# List the students' submissions
data, status_code, headers = api_instance.get_submissions_with_http_info(_class, assignment)
p status_code # => 2xx
p headers # => { ... }
p data # => <Array<AssignmentSubmission>>
rescue FlatApi::ApiError => e
puts "Error when calling ClassApi->get_submissions_with_http_info: #{e}"
end
Name | Type | Description | Notes |
---|---|---|---|
_class | String | Unique identifier of the class | |
assignment | String | Unique identifier of the assignment |
- Content-Type: Not defined
- Accept: application/json
<Array> list_assignments(_class)
Assignments listing
require 'time'
require 'flat_api'
# setup authorization
FlatApi.configure do |config|
# Configure OAuth2 access token for authorization: OAuth2
config.access_token = 'YOUR ACCESS TOKEN'
end
api_instance = FlatApi::ClassApi.new
_class = '_class_example' # String | Unique identifier of the class
begin
# Assignments listing
result = api_instance.list_assignments(_class)
p result
rescue FlatApi::ApiError => e
puts "Error when calling ClassApi->list_assignments: #{e}"
end
This returns an Array which contains the response data, status code and headers.
<Array(<Array>, Integer, Hash)> list_assignments_with_http_info(_class)
begin
# Assignments listing
data, status_code, headers = api_instance.list_assignments_with_http_info(_class)
p status_code # => 2xx
p headers # => { ... }
p data # => <Array<ClassAssignment>>
rescue FlatApi::ApiError => e
puts "Error when calling ClassApi->list_assignments_with_http_info: #{e}"
end
Name | Type | Description | Notes |
---|---|---|---|
_class | String | Unique identifier of the class |
- Content-Type: Not defined
- Accept: application/json
<Array> list_class_student_submissions(_class, user)
List the submissions for a student
Use this method as a teacher to list all the assignment submissions sent by a student of the class
require 'time'
require 'flat_api'
# setup authorization
FlatApi.configure do |config|
# Configure OAuth2 access token for authorization: OAuth2
config.access_token = 'YOUR ACCESS TOKEN'
end
api_instance = FlatApi::ClassApi.new
_class = '_class_example' # String | Unique identifier of the class
user = 'user_example' # String | Unique identifier of the user
begin
# List the submissions for a student
result = api_instance.list_class_student_submissions(_class, user)
p result
rescue FlatApi::ApiError => e
puts "Error when calling ClassApi->list_class_student_submissions: #{e}"
end
This returns an Array which contains the response data, status code and headers.
<Array(<Array>, Integer, Hash)> list_class_student_submissions_with_http_info(_class, user)
begin
# List the submissions for a student
data, status_code, headers = api_instance.list_class_student_submissions_with_http_info(_class, user)
p status_code # => 2xx
p headers # => { ... }
p data # => <Array<AssignmentSubmission>>
rescue FlatApi::ApiError => e
puts "Error when calling ClassApi->list_class_student_submissions_with_http_info: #{e}"
end
Name | Type | Description | Notes |
---|---|---|---|
_class | String | Unique identifier of the class | |
user | String | Unique identifier of the user |
- Content-Type: Not defined
- Accept: application/json
<Array> list_classes(opts)
List the classes available for the current user
require 'time'
require 'flat_api'
# setup authorization
FlatApi.configure do |config|
# Configure OAuth2 access token for authorization: OAuth2
config.access_token = 'YOUR ACCESS TOKEN'
end
api_instance = FlatApi::ClassApi.new
opts = {
state: 'active' # String | Filter the classes by state
}
begin
# List the classes available for the current user
result = api_instance.list_classes(opts)
p result
rescue FlatApi::ApiError => e
puts "Error when calling ClassApi->list_classes: #{e}"
end
This returns an Array which contains the response data, status code and headers.
<Array(<Array>, Integer, Hash)> list_classes_with_http_info(opts)
begin
# List the classes available for the current user
data, status_code, headers = api_instance.list_classes_with_http_info(opts)
p status_code # => 2xx
p headers # => { ... }
p data # => <Array<ClassDetails>>
rescue FlatApi::ApiError => e
puts "Error when calling ClassApi->list_classes_with_http_info: #{e}"
end
Name | Type | Description | Notes |
---|---|---|---|
state | String | Filter the classes by state | [optional][default to 'active'] |
- Content-Type: Not defined
- Accept: application/json
post_submission_comment(_class, assignment, submission, assignment_submission_comment_creation)
Add a feedback comment to a submission
require 'time'
require 'flat_api'
# setup authorization
FlatApi.configure do |config|
# Configure OAuth2 access token for authorization: OAuth2
config.access_token = 'YOUR ACCESS TOKEN'
end
api_instance = FlatApi::ClassApi.new
_class = '_class_example' # String | Unique identifier of the class
assignment = 'assignment_example' # String | Unique identifier of the assignment
submission = 'submission_example' # String | Unique identifier of the submission
assignment_submission_comment_creation = FlatApi::AssignmentSubmissionCommentCreation.new({comment: 'comment_example'}) # AssignmentSubmissionCommentCreation |
begin
# Add a feedback comment to a submission
result = api_instance.post_submission_comment(_class, assignment, submission, assignment_submission_comment_creation)
p result
rescue FlatApi::ApiError => e
puts "Error when calling ClassApi->post_submission_comment: #{e}"
end
This returns an Array which contains the response data, status code and headers.
<Array(, Integer, Hash)> post_submission_comment_with_http_info(_class, assignment, submission, assignment_submission_comment_creation)
begin
# Add a feedback comment to a submission
data, status_code, headers = api_instance.post_submission_comment_with_http_info(_class, assignment, submission, assignment_submission_comment_creation)
p status_code # => 2xx
p headers # => { ... }
p data # => <AssignmentSubmissionComment>
rescue FlatApi::ApiError => e
puts "Error when calling ClassApi->post_submission_comment_with_http_info: #{e}"
end
Name | Type | Description | Notes |
---|---|---|---|
_class | String | Unique identifier of the class | |
assignment | String | Unique identifier of the assignment | |
submission | String | Unique identifier of the submission | |
assignment_submission_comment_creation | AssignmentSubmissionCommentCreation |
- Content-Type: application/json
- Accept: application/json
unarchive_assignment(_class, assignment)
Unarchive the assignment.
Mark the assignment as active
.
require 'time'
require 'flat_api'
# setup authorization
FlatApi.configure do |config|
# Configure OAuth2 access token for authorization: OAuth2
config.access_token = 'YOUR ACCESS TOKEN'
end
api_instance = FlatApi::ClassApi.new
_class = '_class_example' # String | Unique identifier of the class
assignment = 'assignment_example' # String | Unique identifier of the assignment
begin
# Unarchive the assignment.
result = api_instance.unarchive_assignment(_class, assignment)
p result
rescue FlatApi::ApiError => e
puts "Error when calling ClassApi->unarchive_assignment: #{e}"
end
This returns an Array which contains the response data, status code and headers.
<Array(, Integer, Hash)> unarchive_assignment_with_http_info(_class, assignment)
begin
# Unarchive the assignment.
data, status_code, headers = api_instance.unarchive_assignment_with_http_info(_class, assignment)
p status_code # => 2xx
p headers # => { ... }
p data # => <Assignment>
rescue FlatApi::ApiError => e
puts "Error when calling ClassApi->unarchive_assignment_with_http_info: #{e}"
end
Name | Type | Description | Notes |
---|---|---|---|
_class | String | Unique identifier of the class | |
assignment | String | Unique identifier of the assignment |
- Content-Type: Not defined
- Accept: application/json
unarchive_class(_class)
Unarchive the class
Mark the class as active
. When this course is synchronized with another app, like Google Classroom, this state will be automatically be updated.
require 'time'
require 'flat_api'
# setup authorization
FlatApi.configure do |config|
# Configure OAuth2 access token for authorization: OAuth2
config.access_token = 'YOUR ACCESS TOKEN'
end
api_instance = FlatApi::ClassApi.new
_class = '_class_example' # String | Unique identifier of the class
begin
# Unarchive the class
result = api_instance.unarchive_class(_class)
p result
rescue FlatApi::ApiError => e
puts "Error when calling ClassApi->unarchive_class: #{e}"
end
This returns an Array which contains the response data, status code and headers.
<Array(, Integer, Hash)> unarchive_class_with_http_info(_class)
begin
# Unarchive the class
data, status_code, headers = api_instance.unarchive_class_with_http_info(_class)
p status_code # => 2xx
p headers # => { ... }
p data # => <ClassDetails>
rescue FlatApi::ApiError => e
puts "Error when calling ClassApi->unarchive_class_with_http_info: #{e}"
end
Name | Type | Description | Notes |
---|---|---|---|
_class | String | Unique identifier of the class |
- Content-Type: Not defined
- Accept: application/json
update_class(_class, body)
Update the class
Update the meta information of the class
require 'time'
require 'flat_api'
# setup authorization
FlatApi.configure do |config|
# Configure OAuth2 access token for authorization: OAuth2
config.access_token = 'YOUR ACCESS TOKEN'
end
api_instance = FlatApi::ClassApi.new
_class = '_class_example' # String | Unique identifier of the class
body = FlatApi::ClassUpdate.new # ClassUpdate | Details of the Class
begin
# Update the class
result = api_instance.update_class(_class, body)
p result
rescue FlatApi::ApiError => e
puts "Error when calling ClassApi->update_class: #{e}"
end
This returns an Array which contains the response data, status code and headers.
<Array(, Integer, Hash)> update_class_with_http_info(_class, body)
begin
# Update the class
data, status_code, headers = api_instance.update_class_with_http_info(_class, body)
p status_code # => 2xx
p headers # => { ... }
p data # => <ClassDetails>
rescue FlatApi::ApiError => e
puts "Error when calling ClassApi->update_class_with_http_info: #{e}"
end
Name | Type | Description | Notes |
---|---|---|---|
_class | String | Unique identifier of the class | |
body | ClassUpdate | Details of the Class |
- Content-Type: application/json
- Accept: application/json
update_submission_comment(_class, assignment, submission, comment, assignment_submission_comment_creation)
Update a feedback comment to a submission
require 'time'
require 'flat_api'
# setup authorization
FlatApi.configure do |config|
# Configure OAuth2 access token for authorization: OAuth2
config.access_token = 'YOUR ACCESS TOKEN'
end
api_instance = FlatApi::ClassApi.new
_class = '_class_example' # String | Unique identifier of the class
assignment = 'assignment_example' # String | Unique identifier of the assignment
submission = 'submission_example' # String | Unique identifier of the submission
comment = 'comment_example' # String | Unique identifier of the comment
assignment_submission_comment_creation = FlatApi::AssignmentSubmissionCommentCreation.new({comment: 'comment_example'}) # AssignmentSubmissionCommentCreation |
begin
# Update a feedback comment to a submission
result = api_instance.update_submission_comment(_class, assignment, submission, comment, assignment_submission_comment_creation)
p result
rescue FlatApi::ApiError => e
puts "Error when calling ClassApi->update_submission_comment: #{e}"
end
This returns an Array which contains the response data, status code and headers.
<Array(, Integer, Hash)> update_submission_comment_with_http_info(_class, assignment, submission, comment, assignment_submission_comment_creation)
begin
# Update a feedback comment to a submission
data, status_code, headers = api_instance.update_submission_comment_with_http_info(_class, assignment, submission, comment, assignment_submission_comment_creation)
p status_code # => 2xx
p headers # => { ... }
p data # => <AssignmentSubmissionComment>
rescue FlatApi::ApiError => e
puts "Error when calling ClassApi->update_submission_comment_with_http_info: #{e}"
end
Name | Type | Description | Notes |
---|---|---|---|
_class | String | Unique identifier of the class | |
assignment | String | Unique identifier of the assignment | |
submission | String | Unique identifier of the submission | |
comment | String | Unique identifier of the comment | |
assignment_submission_comment_creation | AssignmentSubmissionCommentCreation |
- Content-Type: application/json
- Accept: application/json