rustici_software_cloud_v2 2.0.0 → 2.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 76a614b52e38306b7ef49b804c9d53209e8ad854f4e74a11cd2092be1638180b
-  data.tar.gz: cda1d65a0e1ee135dd3905169a2fdbdd1a92155e271efbe24e9555cb9edde962
+  metadata.gz: 247b1a7a7ea4ee91459e4651907dc34c8e01c1922b908de16df785bd6e013eba
+  data.tar.gz: 7140c78703919b71ab730564ee20aa982abeb3ab270325dcb2eeb9e680119149
 SHA512:
-  metadata.gz: aeca3f98049127435943a6d120e86d1aa9a97b09d0ff826c62806000f5f53e2ab580359b3ce682aca846e2555642bfbf0e3e0bf4623bbb182054a0a2c35b63a2
-  data.tar.gz: 2aa262cd225e5bf1ec2d36b132839cdfaf7e6435b061403cc2dc5252df8ffea7bad38fcfbca5dc2db24afa59ea7f51b74502fd29dd2d5da167effb14c719d361
+  metadata.gz: ac4f6a667976b270b3b230de312167e8e8fd0731a494e1dfbb1c17a99c826e2f80bbb81c894880088c23a36a8b2eff038927831eee52dc5d45f86ad143ea317b
+  data.tar.gz: c41e7e7b66dffcdc05ab1169e531fbd88f3f8ba3b2095a6648598de86ae114e5bec6c8418d193f519d86b767e86e14bc2ea878067fb15dca3050ceb8b0588129

data/README.md

@@ -7,7 +7,7 @@ REST API used for SCORM Cloud integrations.
 This SDK is automatically generated by the [Swagger Codegen](https://github.com/swagger-api/swagger-codegen) project:
 
 - API version: 2.0
-- Package version: 2.0.0
+- Package version: 2.1.0
 - Build package: io.swagger.codegen.languages.RubyClientCodegen
 
 ## Installation
@@ -22,13 +22,13 @@ gem build rustici_software_cloud_v2.gemspec
 ```
 
 ```shell
-gem install ./rustici_software_cloud_v2-2.0.0.gem
+gem install ./rustici_software_cloud_v2-2.1.0.gem
 ```
-For development, run `gem install --dev ./rustici_software_cloud_v2-2.0.0.gem` to install the development dependencies
+For development, run `gem install --dev ./rustici_software_cloud_v2-2.1.0.gem` to install the development dependencies
 
 Finally add this to the Gemfile:
 
-    gem 'rustici_software_cloud_v2', '~> 2.0.0'
+    gem 'rustici_software_cloud_v2', '~> 2.1.0'
 
 ## Tips and Tricks
 Working with headers will require calling the `WithHttpInfo` version of the function. This allows for grabbing the header directly from the response object:
@@ -39,7 +39,7 @@ response = dispatch_api.update_dispatches_with_http_info(RusticiSoftwareCloudV2:
 puts response[2]["X-Total-Count"]
 ```
 
-## Release 2.0.X:
+## Changelog:
 Check the [changelog](https://cloud.scorm.com/docs/v2/reference/changelog/) for details of what has changed.
 
 ## Sample Code

data/lib/rustici_software_cloud_v2/api/about_api.rb

@@ -6,7 +6,7 @@
 OpenAPI spec version: 2.0
 
 Generated by: https://github.com/swagger-api/swagger-codegen.git
-Swagger Codegen version: 2.4.12
+Swagger Codegen version: 2.4.27
 
 =end
 

data/lib/rustici_software_cloud_v2/api/application_management_api.rb

@@ -6,7 +6,7 @@
 OpenAPI spec version: 2.0
 
 Generated by: https://github.com/swagger-api/swagger-codegen.git
-Swagger Codegen version: 2.4.12
+Swagger Codegen version: 2.4.27
 
 =end
 

data/lib/rustici_software_cloud_v2/api/authentication_api.rb

@@ -6,7 +6,7 @@
 OpenAPI spec version: 2.0
 
 Generated by: https://github.com/swagger-api/swagger-codegen.git
-Swagger Codegen version: 2.4.12
+Swagger Codegen version: 2.4.27
 
 =end
 

data/lib/rustici_software_cloud_v2/api/content_connectors_api.rb

@@ -0,0 +1,236 @@
+=begin
+#SCORM Cloud Rest API
+
+#REST API used for SCORM Cloud integrations.
+
+OpenAPI spec version: 2.0
+
+Generated by: https://github.com/swagger-api/swagger-codegen.git
+Swagger Codegen version: 2.4.27
+
+=end
+
+require 'uri'
+
+module RusticiSoftwareCloudV2
+  class ContentConnectorsApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # A call to this method will create a new content connector and return a newly created Id for it. 
+    # @param connector 
+    # @param [Hash] opts the optional parameters
+    # @return [StringResultSchema]
+    def create_connector(connector, opts = {})
+      data, _status_code, _headers = create_connector_with_http_info(connector, opts)
+      data
+    end
+
+    # A call to this method will create a new content connector and return a newly created Id for it. 
+    # @param connector 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(StringResultSchema, Fixnum, Hash)>] StringResultSchema data, response status code and response headers
+    def create_connector_with_http_info(connector, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ContentConnectorsApi.create_connector ...'
+      end
+      # verify the required parameter 'connector' is set
+      if connector.nil?
+        fail ArgumentError, "Missing the required parameter 'connector' when calling ContentConnectorsApi.create_connector"
+      end
+      # resource path
+      local_var_path = '/contentConnectors'
+
+      # query parameters
+      query_params = {}
+
+      # header parameters
+      header_params = {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+      # HTTP header 'Content-Type'
+      header_params['Content-Type'] = @api_client.select_header_content_type(['application/json'])
+
+      # form parameters
+      form_params = {}
+
+      # http body (model)
+      post_body = @api_client.object_to_http_body(connector)
+      auth_names = ['APP_NORMAL', 'OAUTH']
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => 'StringResultSchema')
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: ContentConnectorsApi#create_connector\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+    # Delete a connector 
+    # Delete the specified connector. 
+    # @param connector_id the connector id
+    # @param [Hash] opts the optional parameters
+    # @return [nil]
+    def delete_connector(connector_id, opts = {})
+      delete_connector_with_http_info(connector_id, opts)
+      nil
+    end
+
+    # Delete a connector 
+    # Delete the specified connector. 
+    # @param connector_id the connector id
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(nil, Fixnum, Hash)>] nil, response status code and response headers
+    def delete_connector_with_http_info(connector_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ContentConnectorsApi.delete_connector ...'
+      end
+      # verify the required parameter 'connector_id' is set
+      if connector_id.nil?
+        fail ArgumentError, "Missing the required parameter 'connector_id' when calling ContentConnectorsApi.delete_connector"
+      end
+      # resource path
+      local_var_path = '/contentConnectors/{connectorId}'.sub('{' + 'connectorId' + '}', connector_id.to_s)
+
+      # query parameters
+      query_params = {}
+
+      # header parameters
+      header_params = {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+      # HTTP header 'Content-Type'
+      header_params['Content-Type'] = @api_client.select_header_content_type(['application/json'])
+
+      # form parameters
+      form_params = {}
+
+      # http body (model)
+      post_body = nil
+      auth_names = ['APP_NORMAL', 'OAUTH']
+      data, status_code, headers = @api_client.call_api(:DELETE, local_var_path,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: ContentConnectorsApi#delete_connector\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+    # Get a list of all Content Connectors for the application 
+    # Get list of all Content Connectors in this application. 
+    # @param [Hash] opts the optional parameters
+    # @option opts [BOOLEAN] :include_additional_instance_information 
+    # @return [ConnectorListSchema]
+    def get_connectors_list(opts = {})
+      data, _status_code, _headers = get_connectors_list_with_http_info(opts)
+      data
+    end
+
+    # Get a list of all Content Connectors for the application 
+    # Get list of all Content Connectors in this application. 
+    # @param [Hash] opts the optional parameters
+    # @option opts [BOOLEAN] :include_additional_instance_information 
+    # @return [Array<(ConnectorListSchema, Fixnum, Hash)>] ConnectorListSchema data, response status code and response headers
+    def get_connectors_list_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ContentConnectorsApi.get_connectors_list ...'
+      end
+      # resource path
+      local_var_path = '/contentConnectors'
+
+      # query parameters
+      query_params = {}
+      query_params[:'includeAdditionalInstanceInformation'] = opts[:'include_additional_instance_information'] if !opts[:'include_additional_instance_information'].nil?
+
+      # header parameters
+      header_params = {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+      # HTTP header 'Content-Type'
+      header_params['Content-Type'] = @api_client.select_header_content_type(['application/json'])
+
+      # form parameters
+      form_params = {}
+
+      # http body (model)
+      post_body = nil
+      auth_names = ['APP_NORMAL', 'OAUTH']
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => 'ConnectorListSchema')
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: ContentConnectorsApi#get_connectors_list\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+    # Update the configuration or enabled flag associated with `connectorId`. 
+    # @param connector_id the connector id
+    # @param connector 
+    # @param [Hash] opts the optional parameters
+    # @return [nil]
+    def update_connector(connector_id, connector, opts = {})
+      update_connector_with_http_info(connector_id, connector, opts)
+      nil
+    end
+
+    # Update the configuration or enabled flag associated with &#x60;connectorId&#x60;. 
+    # @param connector_id the connector id
+    # @param connector 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(nil, Fixnum, Hash)>] nil, response status code and response headers
+    def update_connector_with_http_info(connector_id, connector, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ContentConnectorsApi.update_connector ...'
+      end
+      # verify the required parameter 'connector_id' is set
+      if connector_id.nil?
+        fail ArgumentError, "Missing the required parameter 'connector_id' when calling ContentConnectorsApi.update_connector"
+      end
+      # verify the required parameter 'connector' is set
+      if connector.nil?
+        fail ArgumentError, "Missing the required parameter 'connector' when calling ContentConnectorsApi.update_connector"
+      end
+      # resource path
+      local_var_path = '/contentConnectors/{connectorId}'.sub('{' + 'connectorId' + '}', connector_id.to_s)
+
+      # query parameters
+      query_params = {}
+
+      # header parameters
+      header_params = {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+      # HTTP header 'Content-Type'
+      header_params['Content-Type'] = @api_client.select_header_content_type(['application/json'])
+
+      # form parameters
+      form_params = {}
+
+      # http body (model)
+      post_body = @api_client.object_to_http_body(connector)
+      auth_names = ['APP_NORMAL', 'OAUTH']
+      data, status_code, headers = @api_client.call_api(:PUT, local_var_path,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: ContentConnectorsApi#update_connector\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end

data/lib/rustici_software_cloud_v2/api/course_api.rb

@@ -6,7 +6,7 @@
 OpenAPI spec version: 2.0
 
 Generated by: https://github.com/swagger-api/swagger-codegen.git
-Swagger Codegen version: 2.4.12
+Swagger Codegen version: 2.4.27
 
 =end
 
@@ -213,7 +213,7 @@ module RusticiSoftwareCloudV2
       return data, status_code, headers
     end
     # Create a Course from a fetched or referenced external media file 
-    # Creates a course from one of two methods, fetchRequest or mediaFileReferenceRequest.  In either case, an import job ID will be returned, which can be used with GetImportJobStatus to view the status of the import.  Courses represent the learning material a learner will progress through.  - A fetchRequest performs the same actions as CreateFetchAndImportCourseJob.  A course will be created from a package fetched from the provided url.  The package will be downloaded from the url and stored in SCORM Cloud. - A mediaFileReferenceRequest will not store the file in SCORM Cloud.  Instead it will reference the media file at the time the learner needs to view the file from the provided url.  >**Note:** >The import job ID used for calls to GetImportJobStatus are only valid for one week after the course import finishes.  >**Info:** >Unless working with media files, it is typical to use one of the other two import methods. >- CreateUploadAndImportCourseJob would be used if the course is in your local file system. >- CreateFetchAndImportCourseJob would be better suited for situations where the course is uploaded remotely but is accessible via a public url. 
+    # Creates a course from one of the following methods: fetchRequest, mediaFileReferenceRequest, or connectorReferenceRequest. In all cases, an import job ID will be returned, which can be used with GetImportJobStatus to view the status of the import.  Courses represent the learning material a learner will progress through.  - A fetchRequest performs the same actions as CreateFetchAndImportCourseJob.  A course will be created from a package fetched from the provided url.  The package will be downloaded from the url and stored in SCORM Cloud. - A mediaFileReferenceRequest will not store the file in SCORM Cloud.  Instead it will reference the media file at the time the learner needs to view the file from the provided url. - A connectorReferenceRequest is used to import content from an external content connector, for example an LTI 1.3 tool.  >**Note:** >The import job ID used for calls to GetImportJobStatus are only valid for one week after the course import finishes.  >**Info:** >Unless working with media files, it is typical to use one of the other two import methods. >- CreateUploadAndImportCourseJob would be used if the course is in your local file system. >- CreateFetchAndImportCourseJob would be better suited for situations where the course is uploaded remotely but is accessible via a public url. 
     # @param course_id A unique identifier your application will use to identify the course after import. Your application is responsible both for generating this unique ID and for keeping track of the ID for later use.
     # @param import_request 
     # @param [Hash] opts the optional parameters
@@ -226,7 +226,7 @@ module RusticiSoftwareCloudV2
     end
 
     # Create a Course from a fetched or referenced external media file 
-    # Creates a course from one of two methods, fetchRequest or mediaFileReferenceRequest.  In either case, an import job ID will be returned, which can be used with GetImportJobStatus to view the status of the import.  Courses represent the learning material a learner will progress through.  - A fetchRequest performs the same actions as CreateFetchAndImportCourseJob.  A course will be created from a package fetched from the provided url.  The package will be downloaded from the url and stored in SCORM Cloud. - A mediaFileReferenceRequest will not store the file in SCORM Cloud.  Instead it will reference the media file at the time the learner needs to view the file from the provided url.  >**Note:** >The import job ID used for calls to GetImportJobStatus are only valid for one week after the course import finishes.  >**Info:** >Unless working with media files, it is typical to use one of the other two import methods. >- CreateUploadAndImportCourseJob would be used if the course is in your local file system. >- CreateFetchAndImportCourseJob would be better suited for situations where the course is uploaded remotely but is accessible via a public url. 
+    # Creates a course from one of the following methods: fetchRequest, mediaFileReferenceRequest, or connectorReferenceRequest. In all cases, an import job ID will be returned, which can be used with GetImportJobStatus to view the status of the import.  Courses represent the learning material a learner will progress through.  - A fetchRequest performs the same actions as CreateFetchAndImportCourseJob.  A course will be created from a package fetched from the provided url.  The package will be downloaded from the url and stored in SCORM Cloud. - A mediaFileReferenceRequest will not store the file in SCORM Cloud.  Instead it will reference the media file at the time the learner needs to view the file from the provided url. - A connectorReferenceRequest is used to import content from an external content connector, for example an LTI 1.3 tool.  >**Note:** >The import job ID used for calls to GetImportJobStatus are only valid for one week after the course import finishes.  >**Info:** >Unless working with media files, it is typical to use one of the other two import methods. >- CreateUploadAndImportCourseJob would be used if the course is in your local file system. >- CreateFetchAndImportCourseJob would be better suited for situations where the course is uploaded remotely but is accessible via a public url. 
     # @param course_id A unique identifier your application will use to identify the course after import. Your application is responsible both for generating this unique ID and for keeping track of the ID for later use.
     # @param import_request 
     # @param [Hash] opts the optional parameters
@@ -1516,6 +1516,60 @@ module RusticiSoftwareCloudV2
       end
       return data, status_code, headers
     end
+    # Download a zip package for a Course 
+    # Downloads a zip package for the course.  The course zip package contains all of the files (assets) needed for a learner to take the course.  The returned zip will contain all of the files orginally uploaded with the course, as well as any modifications made through updating/ adding new assets.  >**Info:** >If looking to retrieve a specific file from a course, use `GetCourseAsset` instead. 
+    # @param course_id 
+    # @param [Hash] opts the optional parameters
+    # @return [File]
+    def get_course_zip(course_id, opts = {})
+      data, _status_code, _headers = get_course_zip_with_http_info(course_id, opts)
+      data
+    end
+
+    # Download a zip package for a Course 
+    # Downloads a zip package for the course.  The course zip package contains all of the files (assets) needed for a learner to take the course.  The returned zip will contain all of the files orginally uploaded with the course, as well as any modifications made through updating/ adding new assets.  >**Info:** >If looking to retrieve a specific file from a course, use `GetCourseAsset` instead. 
+    # @param course_id 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(File, Fixnum, Hash)>] File data, response status code and response headers
+    def get_course_zip_with_http_info(course_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: CourseApi.get_course_zip ...'
+      end
+      # verify the required parameter 'course_id' is set
+      if course_id.nil?
+        fail ArgumentError, "Missing the required parameter 'course_id' when calling CourseApi.get_course_zip"
+      end
+      # resource path
+      local_var_path = '/courses/{courseId}/zip'.sub('{' + 'courseId' + '}', course_id.to_s)
+
+      # query parameters
+      query_params = {}
+
+      # header parameters
+      header_params = {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+      # HTTP header 'Content-Type'
+      header_params['Content-Type'] = @api_client.select_header_content_type(['application/json'])
+
+      # form parameters
+      form_params = {}
+
+      # http body (model)
+      post_body = nil
+      auth_names = ['APP_NORMAL', 'OAUTH']
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => 'File')
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: CourseApi#get_course_zip\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
     # Get a list of Courses 
     # Returns a list of courses.  Can be filtered using the request parameters to provide a subset of results.  >**Note:** >This request is paginated and will only provide a limited amount of resources at a time.  If there are more results to be collected, a `more` token provided with the response which can be passed to get the next page of results.  When passing this token, no other filter parameters can be sent as part of the request.  The resources will continue to respect the filters passed in by the original request. 
     # @param [Hash] opts the optional parameters
@@ -1648,6 +1702,66 @@ module RusticiSoftwareCloudV2
       end
       return data, status_code, headers
     end
+    # Download a zip package for a Course Version 
+    # Downloads a zip package for the course version.  The course zip package contains all of the files (assets) needed for a learner to take the course.  The returned zip will contain all of the files orginally uploaded with the course, as well as any modifications made through updating/ adding new assets.  >**Info:** >If looking to retrieve a specific file from a course version, use `GetCourseVersionAsset` instead. 
+    # @param course_id 
+    # @param version_id 
+    # @param [Hash] opts the optional parameters
+    # @return [File]
+    def get_versioned_course_zip(course_id, version_id, opts = {})
+      data, _status_code, _headers = get_versioned_course_zip_with_http_info(course_id, version_id, opts)
+      data
+    end
+
+    # Download a zip package for a Course Version 
+    # Downloads a zip package for the course version.  The course zip package contains all of the files (assets) needed for a learner to take the course.  The returned zip will contain all of the files orginally uploaded with the course, as well as any modifications made through updating/ adding new assets.  &gt;**Info:** &gt;If looking to retrieve a specific file from a course version, use &#x60;GetCourseVersionAsset&#x60; instead. 
+    # @param course_id 
+    # @param version_id 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(File, Fixnum, Hash)>] File data, response status code and response headers
+    def get_versioned_course_zip_with_http_info(course_id, version_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: CourseApi.get_versioned_course_zip ...'
+      end
+      # verify the required parameter 'course_id' is set
+      if course_id.nil?
+        fail ArgumentError, "Missing the required parameter 'course_id' when calling CourseApi.get_versioned_course_zip"
+      end
+      # verify the required parameter 'version_id' is set
+      if version_id.nil?
+        fail ArgumentError, "Missing the required parameter 'version_id' when calling CourseApi.get_versioned_course_zip"
+      end
+      # resource path
+      local_var_path = '/courses/{courseId}/versions/{versionId}/zip'.sub('{' + 'courseId' + '}', course_id.to_s).sub('{' + 'versionId' + '}', version_id.to_s)
+
+      # query parameters
+      query_params = {}
+
+      # header parameters
+      header_params = {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+      # HTTP header 'Content-Type'
+      header_params['Content-Type'] = @api_client.select_header_content_type(['application/json'])
+
+      # form parameters
+      form_params = {}
+
+      # http body (model)
+      post_body = nil
+      auth_names = ['APP_NORMAL', 'OAUTH']
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => 'File')
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: CourseApi#get_versioned_course_zip\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
     # Import an asset file for a Course 
     # Creates or updates an asset file fetched from the provided url into the course.  The file will be downloaded from the url and stored in SCORM Cloud.  This is a useful way to modify the course structure without needing to reimport the whole course after you've made changes.  >**Info:** >If the course structure is being heavily modified, consider creating a new version instead.  This can be done by calling one of the course import jobs while passing true for `mayCreateNewVersion`. 
     # @param course_id