d2l_sdk 0.1.9 → 0.1.10

data/lib/d2l_sdk/course_content.rb

@@ -66,8 +66,52 @@ end
 #               1. +ContentObjectData+ JSON data block of type Topic
 #               2. File attachment data itself you want to store in OU content area
 # Returns (if successful) a JSON data block containing properties of the newly created object
-def add_child_to_module(org_unit_id, module_id) # POST
-  query_string = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/content/modules/#{module_id}/structure/"
+def add_child_to_module(org_unit_id, module_id, child ={}) # POST
+  path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/content/modules/#{module_id}/structure/"
+  payload = {}
+  if child.key?("module") # TODO: modules
+    payload = {
+      "Title" => "title_string", # String
+      "ShortTitle" => "title_short_string", # String
+      "Type" => 0,
+      "ModuleStartDate" => nil, # nil || string:UTCDateTime
+      "ModuleEndDate" => nil, # nil || string:UTCDateTime
+      "ModuleDueDate" => nil, # nil || string:UTCDateTime
+      "IsHidden" => false,
+      "IsLocked" => false,
+      "description" => {
+        "Text" => "blank",
+        "HTML" => ""
+      },
+      "Duration" => nil, #nil, number
+    }.merge!(child["module"])
+    _post(path, payload)
+  elsif child.key?("link") # TODO: link-type topics
+    payload = {
+      "Title" => "title_string", # String
+      "ShortTitle" => "title_short_string", # String
+      "Type" => 1,
+      "TopicType" => 3, #<number:TOPIC_T>
+      "Url" => "URL", # the URL you want to fetch when the user opens the link-type topic.
+      "StartDate" => nil, # nil || string:UTCDateTime
+      "EndDate" => nil, # nil || string:UTCDateTime
+      "DueDate" => nil, # nil || string:UTCDateTime
+      "IsHidden" => false,
+      "IsLocked" => false,
+      "OpenAsExternalResource" => nil, #or boolean
+      "description" => {
+        "Text" => "",
+        "HTML" => nil # -or- HTML formatted string
+      },
+      "MajorUpdate" => nil, # or bool
+      "MajorUpdateText" => "MajorUpdateText",
+      "ResetCompletionTracking" => nil, # or bool
+      "Duration" => nil, #nil, number
+    }.merge!(child["module"])
+    _post(path, payload)
+  elsif child.key?("file") # TODO: file-type topics
+    _course_content_upload(query_string, payload, file, "POST")
+  end
 end
 
 def check_content_module_validity(content_module)
@@ -206,6 +250,7 @@ end
 # Retrieve the overview for a course offering.
 def get_course_overview(org_unit_id) # GET
   query_string = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/overview"
+  ap query_string
   _get(query_string)
   # Returns: a Overview JSON data block containing
   # the course offering overview’s details.

data/lib/d2l_sdk/demographics.rb

@@ -61,6 +61,43 @@ def get_user_demographics(user_id, field_ids = '', bookmark = '')
   path += "bookmark=#{bookmark}" if bookmark != ''
 end
 
+def check_demographics_user_entry_data_validity(demographics_user_entry_data)
+    # A hash with one value, "EntryValues", which is an array of hashes that
+    # include the keys "Name" and "Values", where "Name" is a string and "Values"
+    # is an array of string.
+    schema = {
+        'type' => 'object',
+        'required' => %w(EntryValues),
+        'properties' => {
+            'EntryValues' => # DemographicsEntryData
+            {
+              'type' => 'array',
+              'items' => # Items = <composite:DemographicsEntry>
+              {
+                'type' => 'object',
+                'minItems' => 1,
+                'required' => %w(Name Values),
+                'properties' =>
+                {
+                  'Name' => { 'type' => 'string' },
+                  'Values' =>
+                  {
+                    'type' => 'array',
+                    'items' =>
+                    {
+                      'type' => 'string',
+                      'minItems' => 1
+                    }
+                  }
+                }
+              }
+            }
+        }
+    }
+    JSON::Validator.validate!(schema, demographics_user_entry_data, validate_schema: true)
+end
+
+
 # TODO: Update the demographics entries for a single user.
 # Return: a DemographicsUserEntryData JSON block containing the user’s updated entries.
 def update_user_demographics(user_id, demographics_entry_data)
@@ -92,19 +129,64 @@ def get_demographic_field(field_id)
   # returns fetch form of DemographicsField JSON block
 end
 
-# TODO: Create new demographic field
+# Additional function added to check that the demographics data (create form)
+# conforms to the JSON schema required by D2L's backend.
+def check_create_demographics_field(demographics_data)
+    schema = {
+        'type' => 'object',
+        'required' => %w(Name Description DataTypeId),
+        'properties' => {
+            'Name' => { 'type' => 'string' },
+            'Description' => { 'type' => 'string' },
+            'DataTypeId' => { 'type' => 'string' }
+        }
+    }
+    JSON::Validator.validate!(schema, demographics_data, validate_schema: true)
+end
+
+# REVIEW: Create new demographic field
 # Input: DemographicsField (Demographics.Demographicsfield)
 # RETURNS: fetch form of a DemographicsField JSON block
 def create_demographic_field(demographics_field)
   # POST /d2l/api/lp/(version)/demographics/fields/
+  path = "/d2l/api/lp/#{$lp_ver}/demographics/fields/"
+  payload = {
+    "Name" => "String",
+    "Description" => "String",
+    "DataTypeId" => "String:GUID"
+  }
+  check_create_demographics_field(payload)
+  _post(path, payload)
   # RETURNS: fetch form of a DemographicsField JSON block
 end
 
-# TODO: Update demographic field
+# Additional function added to check that the demographics data (update form)
+# conforms to the JSON schema required by D2L's backend.
+def check_update_demographics_field(demographics_data)
+    schema = {
+        'type' => 'object',
+        'required' => %w(Name Description),
+        'properties' => {
+            'Name' => { 'type' => 'string' },
+            'Description' => { 'type' => 'string' },
+        }
+    }
+    JSON::Validator.validate!(schema, demographics_data, validate_schema: true)
+end
+
+# REVIEW: Update a single demographic field.
 # Input: DemographicsField (Demographics.Demographicsfield)
 # RETURNS: fetch form of a DemographicsField JSON block
-def create_demographic_field(field_id, demographics_field)
+def update_demographics_field(field_id, demographics_field)
   # PUT /d2l/api/lp/(version)/demographics/fields/(fieldId)
+  path = "/d2l/api/lp/#{$lp_ver}/demographics/fields/#{field_id}"
+  payload = {
+    "Name" => "String",
+    "Description" => "String",
+    "DataTypeId" => "String:GUID"
+  }
+  check_update_demographics_field(payload)
+  _put(path, payload)
   # RETURNS: fetch form of a DemographicsField JSON block
 end
 

data/lib/d2l_sdk/discussions.rb

@@ -0,0 +1,199 @@
+require_relative 'requests'
+require 'json-schema'
+
+##################
+## ACTIONS: ######
+##################
+
+# REVIEW: Delete a particular discussion forum from an org unit.
+# => DELETE /d2l/api/le/(version)/(orgUnitId)/discussions/forums/(forumId)
+def dete_org_unit_discussion(org_unit_id, forum_id)
+    path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/discussions/forums/#{forum_id}"
+    _delete(path)
+end
+
+# REVIEW: Retrieve a list of all discussion forums for an org unit.
+# => GET /d2l/api/le/(version)/(orgUnitId)/discussions/forums/
+def get_org_unit_discussions(org_unit_id)
+    path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/discussions/forums/"
+    _get(path)
+end
+
+# REVIEW: Retrieve a particular discussion forum for an org unit.
+# => GET /d2l/api/le/(version)/(orgUnitId)/discussions/forums/(forumId)
+def get_org_unit_discussion(org_unit_id, forum_id)
+    path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/discussions/forums/#{forum_id}"
+    _get(path)
+end
+
+# TODO: Validate input of create_org_unit_discussion
+# Create a new forum for an org unit.
+# => POST /d2l/api/le/(version)/(orgUnitId)/discussions/forums/
+def create_org_unit_discussion(org_unit_id, forum_data)
+    path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/discussions/forums/"
+    payload =
+    {
+        'Name' => '', #: <string>,
+        'Description' => #: { <composite:RichText> },
+        {
+            "Text" => "",#<string:plaintext_version_of_text>,
+            "Html" => nil #<string:HTML_formatted_version_of_text>|null
+        },
+        'ShowDescriptionInTopics' => nil, #: <boolean>|null,  // Added with LE API v1.14
+        'StartDate' => nil, #: <string:UTCDateTime>|null,
+        'EndDate' => nil, #: <string:UTCDateTime>|null,
+        'PostStartDate' => nil, #: <string:UTCDateTime>|null,
+        'PostEndDate' => nil, # <string:UTCDateTime>|null,
+        'AllowAnonymous' => false, # <boolean>,
+        'IsLocked' => false,  #: <boolean>,
+        'IsHidden' => false,  #: <boolean>,
+        'RequiresApproval' => '', #: <boolean>,
+        'MustPostToParticipate' => nil, #: <boolean>|null,
+        'DisplayInCalendar' => nil, #: <boolean>|null,  // Added with LE API v1.11
+        'DisplayPostDatesInCalendar' => nil, #: <boolean>|null  // Added with LE API v1.11
+    }.merge!(forum_data)
+    # TODO: Validate payload
+    _post(path, payload)
+end
+
+# TODO: Update a forum for an org unit.
+# => PUT /d2l/api/le/(version)/(orgUnitId)/discussions/forums/(forumId)
+
+##################
+## TOPICS: #######
+##################
+
+# TODO: Delete a particular topic from the provided discussion forum in an org unit.
+# => DELETE /d2l/api/le/(version)/(orgUnitId)/discussions/forums/(forumId)/topics/(topicId)
+# TODO: Delete a group restriction for a discussion forum topic.
+# => DELETE /d2l/api/le/(version)/(orgUnitId)/discussions/forums/(forumId)/topics/(topicId)/groupRestrictions/
+# REVIEW: Retrieve topics from the provided discussion forum in an org unit.
+# => GET /d2l/api/le/(version)/(orgUnitId)/discussions/forums/(forumId)/topics/
+def get_forum_topics(org_unit_id, forum_id)
+    path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/discussions/forums/#{forum_id}/topics/"
+    _get(path)
+end
+
+# REVIEW: Retrieve a particular topic from the provided discussion forum in an org unit.
+# => GET /d2l/api/le/(version)/(orgUnitId)/discussions/forums/(forumId)/topics/(topicId)
+def get_forum_topic(org_unit_id, forum_id, topic_id)
+    path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/discussions/forums/#{forum_id}/topics/#{topic_id}"
+    _get(path)
+end
+
+# REVIEW: Retrieve the group restrictions for a discussion forum topic.
+# => GET /d2l/api/le/(version)/(orgUnitId)/discussions/forums/(forumId)/topics/(topicId)/groupRestrictions/
+def get_forum_topic_group_restrictions(org_unit_id, forum_id, topic_id)
+    path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/discussions/forums/#{forum_id}/topics/#{topic_id}/groupRestrictions/"
+    _get(path)
+end
+
+# TODO: Create a new topic for the provided discussion forum in an org unit.
+# => POST /d2l/api/le/(version)/(orgUnitId)/discussions/forums/(forumId)/topics/
+# TODO: Update an existing topic for the provided discussion forum in an org unit.
+# => PUT /d2l/api/le/(version)/(orgUnitId)/discussions/forums/(forumId)/topics/(topicId)
+# TODO: Add a group to the group restriction list for a discussion forum topic.
+# => PUT /d2l/api/le/(version)/(orgUnitId)/discussions/forums/(forumId)/topics/(topicId)/groupRestrictions/
+
+##################
+## POSTS: ########
+##################
+
+# TODO: Delete a particular post from a discussion forum topic.
+# => DELETE /d2l/api/le/(version)/(orgUnitId)/discussions/forums/(forumId)/topics/(topicId)/posts/(postId)
+# TODO: DELETE /d2l/api/le/(version)/(orgUnitId)/discussions/forums/(forumId)/topics/(topicId)/posts/(postId)/Rating/MyRating
+# => Delete the current user context’s rating for a particular post from a discussion forum topic.
+
+# REVIEW: Retrieve all posts in a discussion forum topic.
+# => GET /d2l/api/le/(version)/(orgUnitId)/discussions/forums/(forumId)/topics/(topicId)/posts/
+# RETURNS: JSON array of Post data blocks containing the properties for all the post
+def get_forum_topic_posts(org_unit_id, forum_id, topic_id, page_size = 0, page_number = 0,
+                          threads_only = nil, thread_id = 0, sort = '')
+    path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/discussions/forums/#{forum_id}/topics/#{topic_id}/posts/?"
+    path += "pageSize=#{page_size}&" unless page_size == 0
+    path += "pageNumber=#{page_number}&" unless page_number == 0
+    path += "threadsOnly=#{threads_only}&" unless threads_only.nil?
+    path += "threadId=#{thread_id}&" unless thread_id == 0
+    path += "sort=#{sort}" unless sort == ''
+    _get(path)
+    # RETURNS: JSON array of Post data blocks containing the properties for all the post
+end
+
+# REVIEW: Retrieve a particular post in a discussion forum topic.
+# => GET /d2l/api/le/(version)/(orgUnitId)/discussions/forums/(forumId)/topics/(topicId)/posts/(postId)
+def get_forum_topic_post(org_unit_id, forum_id, topic_id, post_id)
+    path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/discussions/forums/#{forum_id}/topics/#{topic_id}/posts/#{post_id}"
+    _get(path)
+    # RETURNS: Post data block
+end
+
+# REVIEW: Retrieve the approval status for a particular post in a discussion forum topic.
+# => GET /d2l/api/le/(version)/(orgUnitId)/discussions/forums/(forumId)/topics/(topicId)/posts/(postId)/Approval
+def get_forum_topic_post_approval_status(org_unit_id, forum_id, topic_id, post_id)
+    path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/discussions/forums/#{forum_id}/topics/#{topic_id}/posts/#{post_id}/Approval"
+    _get(path)
+    # RETURNS: ApprovalData JSON data block
+end
+
+# TODO: Retrieve the flagged status for a particular post in a discussion forum topic.
+# => GET /d2l/api/le/(version)/(orgUnitId)/discussions/forums/(forumId)/topics/(topicId)/posts/(postId)/Flag
+def get_forum_topic_post_flagged_status(org_unit_id, forum_id, topic_id, post_id)
+    path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/discussions/forums/#{forum_id}/topics/#{topic_id}/posts/#{post_id}/Flag"
+    _get(path)
+    # RETURNS: FlagData JSON data block
+end
+
+# REVIEW: Retrieve the rating data for a particular post in a discussion forum topic.
+# => GET /d2l/api/le/(version)/(orgUnitId)/discussions/forums/(forumId)/topics/(topicId)/posts/(postId)/Rating
+def get_forum_topic_post_rating_data(org_unit_id, forum_id, topic_id, post_id)
+    path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/discussions/forums/#{forum_id}/topics/#{topic_id}/posts/#{post_id}/Rating"
+    _get(path)
+    # RETURNS: RatingData JSON data block
+end
+
+# REVIEW: Retrieve the current user context’s rating data for a particular post in a discussion forum topic.
+# => GET /d2l/api/le/(version)/(orgUnitId)/discussions/forums/(forumId)/topics/(topicId)/posts/(postId)/Rating/MyRating
+def get_current_user_forum_topic_post_rating_data(org_unit_id, forum_id, topic_id, post_id)
+    path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/discussions/forums/#{forum_id}/topics/#{topic_id}/posts/#{post_id}/Rating/MyRating"
+    _get(path)
+    # RETURNS: UserRatingData JSON data block
+end
+
+# REVIEW: Retrieve the current read status for a particular post in a discussion forum topic.
+# => GET /d2l/api/le/(version)/(orgUnitId)/discussions/forums/(forumId)/topics/(topicId)/posts/(postId)/ReadStatus
+def get_forum_topic_post_read_status(org_unit_id, forum_id, topic_id, post_id)
+    path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/discussions/forums/#{forum_id}/topics/#{topic_id}/posts/#{post_id}/ReadStatus"
+    _get(path)
+    # RETURNS: ReadStatusData JSON data block
+end
+
+# REVIEW: Retrieve all the vote data for a particular post in a discussion forum topic.
+# => GET /d2l/api/le/(version)/(orgUnitId)/discussions/forums/(forumId)/topics/(topicId)/posts/(postId)/Votes
+def get_forum_topic_post_vote_data(org_unit_id, forum_id, topic_id, post_id)
+    path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/discussions/forums/#{forum_id}/topics/#{topic_id}/posts/#{post_id}/Votes"
+    _get(path)
+    # RETURNS: VotesData JSON data block
+end
+
+# REVIEW: Retrieve the current user’s vote data for a particular post in a discussion forum topic.
+# => GET /d2l/api/le/(version)/(orgUnitId)/discussions/forums/(forumId)/topics/(topicId)/posts/(postId)/Votes/MyVote
+def get_current_user_forum_topic_post_vote_data(org_unit_id, forum_id, topic_id, post_id)
+    path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/discussions/forums/#{forum_id}/topics/#{topic_id}/posts/#{post_id}/Votes/MyVote"
+    _get(path)
+    # RETURNS: UserVoteData JSON data block
+end
+
+# TODO: Create a new post in a discussion forum topic.
+# => POST /d2l/api/le/(version)/(orgUnitId)/discussions/forums/(forumId)/topics/(topicId)/posts/
+# TODO: Update a particular post in a discussion forum topic.
+# => PUT /d2l/api/le/(version)/(orgUnitId)/discussions/forums/(forumId)/topics/(topicId)/posts/(postId)
+# TODO: Update the approval status of a particular post in a discussion forum topic.
+# => PUT /d2l/api/le/(version)/(orgUnitId)/discussions/forums/(forumId)/topics/(topicId)/posts/(postId)/Approval
+# TODO: Update the flagged status of a particular post in a discussion forum topic.
+# => PUT /d2l/api/le/(version)/(orgUnitId)/discussions/forums/(forumId)/topics/(topicId)/posts/(postId)/Flag
+# TODO: Update the current user context’s rating for a particular post in a discussion forum topic.
+# => PUT /d2l/api/le/(version)/(orgUnitId)/discussions/forums/(forumId)/topics/(topicId)/posts/(postId)/Rating/MyRating
+# TODO: Update the read status of a particular post in a discussion forum topic.
+# => PUT /d2l/api/le/(version)/(orgUnitId)/discussions/forums/(forumId)/topics/(topicId)/posts/(postId)/ReadStatus
+# TODO: Update a discussion forum topic post’s vote data for the current user.
+# => PUT /d2l/api/le/(version)/(orgUnitId)/discussions/forums/(forumId)/topics/(topicId)/posts/(postId)/Votes/MyVote

data/lib/d2l_sdk/dropbox.rb

@@ -0,0 +1,120 @@
+require_relative 'requests'
+require 'json-schema'
+
+##################
+## ACTIONS: ######
+##################
+
+# REVIEW: Retrieve all dropbox folders for an org unit.
+# => GET /d2l/api/le/#{$le_ver}/#{org_unit_id}/dropbox/folders/
+def get_org_unit_dropbox_folders(org_unit_id, only_current_students_and_groups = nil)
+  path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/dropbox/folders/"
+  path += "?onlyCurrentStudentsAndGroups=#{only_current_students_and_groups}" if only_current_students_and_groups == true || only_current_students_and_groups == false
+  _get(path)
+end
+
+# REVIEW: Retrieve a specific dropbox folder.
+# => GET /d2l/api/le/#{$le_ver}/#{org_unit_id}/dropbox/folders/#{folder_id}
+def get_dropbox_folder(org_unit_id, folder_id)
+  path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/dropbox/folders/#{folder_id}"
+  _get(path)
+end
+
+# REVIEW: Retrieve a file attachment (identified by file ID) from a specific dropbox folder.
+# => GET /d2l/api/le/#{$le_ver}/#{org_unit_id}/dropbox/folders/#{folder_id}/attachments/#{file_id}
+def get_dropbox_file_attachment(org_unit_id, folder_id, file_id)
+  path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/dropbox/folders/#{folder_id}/attachments/#{file_id}"
+  _get(path)
+end
+
+# TODO: Create a new dropbox folder in an org unit.
+# => POST /d2l/api/le/#{$le_ver}/#{org_unit_id}/dropbox/folders/
+# TODO: Update a particular dropbox folder in an org unit.
+# => PUT /d2l/api/le/#{$le_ver}/#{org_unit_id}/dropbox/folders/#{folder_id}
+
+# REVIEW: Retrieve a list of org units for which the current user context has an
+#       assessment role on their dropbox folders (can see submissions and provide feedback).
+# => GET /d2l/api/le/#{$le_ver}/dropbox/orgUnits/feedback/
+def get_current_user_assessable_folders(type = nil)
+  path = "/d2l/api/le/#{$le_ver}/dropbox/orgUnits/feedback/"
+  path += "?type=#{type}" if type == 0 || type == 1
+  _get(path)
+end
+
+
+##################
+## SUBMISSIONS: ##
+##################
+
+# REVIEW: Retrieve all the submissions for a specific dropbox folder.
+# => GET /d2l/api/le/#{$le_ver}/#{org_unit_id}/dropbox/folders/#{folder_id}/submissions/
+def get_dropbox_folder_submissions(org_unit_id, folder_id, active_only = nil)
+  path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/dropbox/folders/#{folder_id}/submissions/"
+  path += "?activeOnly=#{active_only}" if active_only == true || active_only == false
+  _get(path)
+end
+
+# REVIEW: Retrieve one of the files included in a submission for a particular dropbox folder.
+# => GET /d2l/api/le/#{$le_ver}/#{org_unit_id}/dropbox/folders/#{folder_id}/submissions/#{submission_id}/files/#{file_id}
+def get_dropbox_submission_file(org_unit_id, folder_id, submission_id, file_id)
+  path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/dropbox/folders/#{folder_id}/submissions/#{submission_id}/files/#{file_id}"
+  _get(path)
+end
+
+# TODO: Post a new group submission to a particular dropbox folder.
+# => POST /d2l/api/le/#{$le_ver}/#{org_unit_id}/dropbox/folders/#{folder_id}/submissions/group/(groupId)
+# TODO: Post a new submission for the current user context to a particular dropbox folder.
+# => POST /d2l/api/le/#{$le_ver}/#{org_unit_id}/dropbox/folders/#{folder_id}/submissions/mysubmissions/
+# TODO: Mark a submitted file as read.
+# => POST /d2l/api/le/#{$le_ver}/#{org_unit_id}/dropbox/folders/#{folder_id}/submissions/#{submission_id}/files/#{file_id}/markAsRead
+
+##################
+## FEEDBACK: #####
+##################
+
+# TODO: Remove a particular file attachment from an entity’s feedback entry within a specified dropbox folder.
+# => DELETE /d2l/api/le/#{$le_ver}/#{org_unit_id}/dropbox/folders/#{folder_id}/feedback/#{entity_type}/(entityId)/attachments/#{file_id}
+
+# REVIEW: Retrieve the feedback entry from a dropbox folder for the provided entity.
+# => GET /d2l/api/le/#{$le_ver}/#{org_unit_id}/dropbox/folders/#{folder_id}/feedback/#{entity_type}/(entityId)
+def get_dropbox_folder_entity_feedback_entry(org_unit_id, folder_id, entity_id)
+  path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/dropbox/folders/#{folder_id}/feedback/#{entity_type}/(entityId)"
+  _get(path)
+end
+
+# REVIEW: Retrieve a feedback entry’s file attachment from a dropbox folder for the provided entity.
+# => GET /d2l/api/le/#{$le_ver}/#{org_unit_id}/dropbox/folders/#{folder_id}/feedback/#{entity_type}/(entityId)/attachments/#{file_id}
+def get_feedback_entry_file_attachment(org_unit_id, folder_id, entity_id, file_id)
+  path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/dropbox/folders/#{folder_id}/feedback/#{entity_type}/(entityId)/attachments/#{file_id}"
+  _get(path)
+end
+
+# TODO: Post feedback (without attachment) for a particular submission in a specific dropbox folder.
+# => POST /d2l/api/le/#{$le_ver}/#{org_unit_id}/dropbox/folders/#{folder_id}/feedback/#{entity_type}/(entityId)
+# TODO: Attach an uploaded file to a particular entity’s feedback entry in a specific dropbox folder.
+# => POST /d2l/api/le/#{$le_ver}/#{org_unit_id}/dropbox/folders/#{folder_id}/feedback/#{entity_type}/(entityId)/attach
+# TODO: Initiate a resumable file upload request for a particular entity’s feedback for a specific dropbox folder.
+# => POST /d2l/api/le/#{$le_ver}/#{org_unit_id}/dropbox/folders/#{folder_id}/feedback/#{entity_type}/(entityId)/upload
+
+##########################
+## FOLDER CATEGORIES: ####
+##########################
+
+# REVIEW: Retrieve all dropbox folder categories for the provided org unit.
+# => GET /d2l/api/le/#{$le_ver}/#{org_unit_id}/dropbox/categories/
+def get_dropbox_folder_categories(org_unit_id)
+  path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/dropbox/categories/"
+  _get(path)
+end
+
+# REVIEW: Retrieve the information for a specific dropbox folder category.
+# => GET /d2l/api/le/#{$le_ver}/#{org_unit_id}/dropbox/categories/#{category_id}
+def get_dropbox_folder_category_info(org_unit_id, category_id)
+  path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/dropbox/categories/#{category_id}"
+  _get(path)
+end
+
+# TODO: Create a new dropbox folder category for the provided org unit.
+# => POST /d2l/api/le/#{$le_ver}/#{org_unit_id}/dropbox/categories/
+# TODO: Update the information for a specific dropbox folder category.
+# => PUT /d2l/api/le/#{$le_ver}/#{org_unit_id}/dropbox/categories/#{category_id}