flat_api 0.1.2 → 0.2.0

data/docs/ScoreCreation.md

@@ -3,11 +3,12 @@
 ## Properties
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**title** | **String** | The title of the new score.  If this title is not specified, the API will try to (in this order):   - Use the name of the file for files from a specified `source` (e.g. Google Drive)   - Use the title contained in the file (e.g. [`movement-title`](https://usermanuals.musicxml.com/MusicXML/Content/EL-MusicXML-movement-title.htm) or [`credit-words`](https://usermanuals.musicxml.com/MusicXML/Content/EL-MusicXML-credit-words.htm) for [MusicXML](http://www.musicxml.com/) files).   - Set a default title (e.g. \"New Music Score\")  If the title is already used, the API will append the creation date after the title. If the title is too long, the API may trim this one.  | [optional] 
+**title** | **String** | The title of the new score. If the title is too long, the API may trim this one.  If this title is not specified, the API will try to (in this order):   - Use the name of the file for files from a specified `source` (e.g. Google Drive)   - Use the title contained in the file (e.g. [`movement-title`](https://usermanuals.musicxml.com/MusicXML/Content/EL-MusicXML-movement-title.htm) or [`credit-words`](https://usermanuals.musicxml.com/MusicXML/Content/EL-MusicXML-credit-words.htm) for [MusicXML](http://www.musicxml.com/) files).   - Set a default title (e.g. \"New Music Score\")  | [optional] 
 **privacy** | [**ScorePrivacy**](ScorePrivacy.md) |  | 
 **data** | [**ScoreData**](ScoreData.md) |  | [optional] 
 **data_encoding** | [**ScoreDataEncoding**](ScoreDataEncoding.md) |  | [optional] 
 **source** | [**ScoreSource**](ScoreSource.md) |  | [optional] 
+**collection** | **String** | Unique identifier of a collection where the score will be created. If no collection identifier is provided, the score will be stored in the `root` directory.  | [optional] 
 **google_drive_folder** | **String** | If the user uses Google Drive and this properties is specified, the file will be created in this directory. The currently user creating the file must be granted to write in this directory.  | [optional] 
 
 

data/docs/ScoreDetails.md

@@ -20,8 +20,8 @@ Name | Type | Description | Notes
 **duration_time** | **Integer** | In seconds, an approximative duration of the score | [optional] 
 **number_measures** | **Integer** | The number of measures in the score | [optional] 
 **main_tempo_qpm** | **Integer** | The main tempo of the score (in QPM) | [optional] 
-**rights** | [**ScoreRights**](ScoreRights.md) |  | [optional] 
-**collaborators** | [**Array<ScoreCollaborator>**](ScoreCollaborator.md) | The list of the collaborators of the score | [optional] 
+**rights** | [**ResourceRights**](ResourceRights.md) |  | [optional] 
+**collaborators** | [**Array<ResourceCollaborator>**](ResourceCollaborator.md) | The list of the collaborators of the score | [optional] 
 **creation_date** | **DateTime** | The date when the score was created | [optional] 
 **modification_date** | **DateTime** | The date of the last revision of the score | [optional] 
 **publication_date** | **DateTime** | The date when the score was published on Flat | [optional] 

data/docs/ScoreFork.md

@@ -3,5 +3,6 @@
 ## Properties
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
+**collection** | **String** | Unique identifier of a collection where the score will be copied. If no collection identifier is provided, the score will be stored in the `root` directory.  | [optional] 
 
 

data/docs/ScoreModification.md

@@ -3,8 +3,9 @@
 ## Properties
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
+**title** | **String** | The title of the score | [optional] 
 **privacy** | [**ScorePrivacy**](ScorePrivacy.md) |  | [optional] 
-**sharing_key** | **String** | When using the `privacy` mode `privateLink`, this property can be used to set a custom sharing key, otherwise a new key will be generated. | [optional] 
+**sharing_key** | [**ResourceSharingKey**](ResourceSharingKey.md) |  | [optional] 
 **description** | **String** | Description of the creation | [optional] 
 **tags** | **Array<String>** | Tags describing the score | [optional] 
 **creation_type** | [**ScoreCreationType**](ScoreCreationType.md) |  | [optional] 

data/docs/UserApi.md

@@ -120,7 +120,7 @@ Name | Type | Description  | Notes
 
 List user's scores
 
-Get the list of scores owned by the User 
+Get the list of public scores owned by a User.  **DEPRECATED**: Please note that the current behavior will be deprecrated on **2019-01-01**. This method will no longer list private and shared scores, but only public scores of a Flat account. If you want to access to private scores, please use the [Collections API](#tag/Collection) instead. 
 
 ### Example
 ```ruby

data/flat_api.gemspec

@@ -5,7 +5,7 @@
 
 #The Flat API allows you to easily extend the abilities of the [Flat Platform](https://flat.io), with a wide range of use cases including the following:  * Creating and importing new music scores using MusicXML or MIDI files * Browsing, updating, copying, exporting the user's scores (for example in MP3, WAV or MIDI) * Managing educational resources with Flat for Education: creating & updating the organization accounts, the classes, rosters and assignments.  The Flat API is built on HTTP. Our API is RESTful It has predictable resource URLs. It returns HTTP response codes to indicate errors. It also accepts and returns JSON in the HTTP body. The [schema](/swagger.yaml) of this API follows the [OpenAPI Initiative (OAI) specification](https://www.openapis.org/), you can use and work with [compatible Swagger tools](http://swagger.io/open-source-integrations/). This API features Cross-Origin Resource Sharing (CORS) implemented in compliance with [W3C spec](https://www.w3.org/TR/cors/).  You can use your favorite HTTP/REST library for your programming language to use Flat's API. This specification and reference is [available on Github](https://github.com/FlatIO/api-reference).  Getting Started and learn more:  * [API Overview and interoduction](https://flat.io/developers/docs/api/) * [Authentication (Personal Access Tokens or OAuth2)](https://flat.io/developers/docs/api/authentication.html) * [SDKs](https://flat.io/developers/docs/api/sdks.html) * [Rate Limits](https://flat.io/developers/docs/api/rate-limits.html) * [Changelog](https://flat.io/developers/docs/api/changelog.html) 
 
-OpenAPI spec version: 2.5.2
+OpenAPI spec version: 2.6.0
 Contact: developers@flat.io
 Generated by: https://github.com/swagger-api/swagger-codegen.git
 Swagger Codegen version: 2.4.0-SNAPSHOT

data/lib/flat_api.rb

@@ -3,7 +3,7 @@
 
 #The Flat API allows you to easily extend the abilities of the [Flat Platform](https://flat.io), with a wide range of use cases including the following:  * Creating and importing new music scores using MusicXML or MIDI files * Browsing, updating, copying, exporting the user's scores (for example in MP3, WAV or MIDI) * Managing educational resources with Flat for Education: creating & updating the organization accounts, the classes, rosters and assignments.  The Flat API is built on HTTP. Our API is RESTful It has predictable resource URLs. It returns HTTP response codes to indicate errors. It also accepts and returns JSON in the HTTP body. The [schema](/swagger.yaml) of this API follows the [OpenAPI Initiative (OAI) specification](https://www.openapis.org/), you can use and work with [compatible Swagger tools](http://swagger.io/open-source-integrations/). This API features Cross-Origin Resource Sharing (CORS) implemented in compliance with [W3C spec](https://www.w3.org/TR/cors/).  You can use your favorite HTTP/REST library for your programming language to use Flat's API. This specification and reference is [available on Github](https://github.com/FlatIO/api-reference).  Getting Started and learn more:  * [API Overview and interoduction](https://flat.io/developers/docs/api/) * [Authentication (Personal Access Tokens or OAuth2)](https://flat.io/developers/docs/api/authentication.html) * [SDKs](https://flat.io/developers/docs/api/sdks.html) * [Rate Limits](https://flat.io/developers/docs/api/rate-limits.html) * [Changelog](https://flat.io/developers/docs/api/changelog.html) 
 
-OpenAPI spec version: 2.5.2
+OpenAPI spec version: 2.6.0
 Contact: developers@flat.io
 Generated by: https://github.com/swagger-api/swagger-codegen.git
 Swagger Codegen version: 2.4.0-SNAPSHOT
@@ -33,6 +33,13 @@ require 'flat_api/models/class_details_lti'
 require 'flat_api/models/class_roles'
 require 'flat_api/models/class_state'
 require 'flat_api/models/class_update'
+require 'flat_api/models/collection'
+require 'flat_api/models/collection_capabilities'
+require 'flat_api/models/collection_creation'
+require 'flat_api/models/collection_modification'
+require 'flat_api/models/collection_privacy'
+require 'flat_api/models/collection_title'
+require 'flat_api/models/collection_type'
 require 'flat_api/models/flat_error_response'
 require 'flat_api/models/flat_locales'
 require 'flat_api/models/google_classroom_coursework'
@@ -50,8 +57,9 @@ require 'flat_api/models/media_score_sharing_mode'
 require 'flat_api/models/organization_invitation'
 require 'flat_api/models/organization_invitation_creation'
 require 'flat_api/models/organization_roles'
-require 'flat_api/models/score_collaborator'
-require 'flat_api/models/score_collaborator_creation'
+require 'flat_api/models/resource_collaborator_creation'
+require 'flat_api/models/resource_rights'
+require 'flat_api/models/resource_sharing_key'
 require 'flat_api/models/score_comment'
 require 'flat_api/models/score_comment_context'
 require 'flat_api/models/score_comment_creation'
@@ -69,7 +77,6 @@ require 'flat_api/models/score_privacy'
 require 'flat_api/models/score_revision'
 require 'flat_api/models/score_revision_creation'
 require 'flat_api/models/score_revision_statistics'
-require 'flat_api/models/score_rights'
 require 'flat_api/models/score_source'
 require 'flat_api/models/score_summary'
 require 'flat_api/models/score_track'
@@ -84,6 +91,7 @@ require 'flat_api/models/user_basics'
 require 'flat_api/models/user_creation'
 require 'flat_api/models/user_details_admin_license'
 require 'flat_api/models/user_instruments'
+require 'flat_api/models/resource_collaborator'
 require 'flat_api/models/score_details'
 require 'flat_api/models/user_public_summary'
 require 'flat_api/models/user_details_admin'
@@ -93,6 +101,7 @@ require 'flat_api/models/user_details'
 # APIs
 require 'flat_api/api/account_api'
 require 'flat_api/api/class_api'
+require 'flat_api/api/collection_api'
 require 'flat_api/api/group_api'
 require 'flat_api/api/organization_api'
 require 'flat_api/api/score_api'

data/lib/flat_api/api/account_api.rb

@@ -3,7 +3,7 @@
 
 #The Flat API allows you to easily extend the abilities of the [Flat Platform](https://flat.io), with a wide range of use cases including the following:  * Creating and importing new music scores using MusicXML or MIDI files * Browsing, updating, copying, exporting the user's scores (for example in MP3, WAV or MIDI) * Managing educational resources with Flat for Education: creating & updating the organization accounts, the classes, rosters and assignments.  The Flat API is built on HTTP. Our API is RESTful It has predictable resource URLs. It returns HTTP response codes to indicate errors. It also accepts and returns JSON in the HTTP body. The [schema](/swagger.yaml) of this API follows the [OpenAPI Initiative (OAI) specification](https://www.openapis.org/), you can use and work with [compatible Swagger tools](http://swagger.io/open-source-integrations/). This API features Cross-Origin Resource Sharing (CORS) implemented in compliance with [W3C spec](https://www.w3.org/TR/cors/).  You can use your favorite HTTP/REST library for your programming language to use Flat's API. This specification and reference is [available on Github](https://github.com/FlatIO/api-reference).  Getting Started and learn more:  * [API Overview and interoduction](https://flat.io/developers/docs/api/) * [Authentication (Personal Access Tokens or OAuth2)](https://flat.io/developers/docs/api/authentication.html) * [SDKs](https://flat.io/developers/docs/api/sdks.html) * [Rate Limits](https://flat.io/developers/docs/api/rate-limits.html) * [Changelog](https://flat.io/developers/docs/api/changelog.html) 
 
-OpenAPI spec version: 2.5.2
+OpenAPI spec version: 2.6.0
 Contact: developers@flat.io
 Generated by: https://github.com/swagger-api/swagger-codegen.git
 Swagger Codegen version: 2.4.0-SNAPSHOT

data/lib/flat_api/api/class_api.rb

@@ -3,7 +3,7 @@
 
 #The Flat API allows you to easily extend the abilities of the [Flat Platform](https://flat.io), with a wide range of use cases including the following:  * Creating and importing new music scores using MusicXML or MIDI files * Browsing, updating, copying, exporting the user's scores (for example in MP3, WAV or MIDI) * Managing educational resources with Flat for Education: creating & updating the organization accounts, the classes, rosters and assignments.  The Flat API is built on HTTP. Our API is RESTful It has predictable resource URLs. It returns HTTP response codes to indicate errors. It also accepts and returns JSON in the HTTP body. The [schema](/swagger.yaml) of this API follows the [OpenAPI Initiative (OAI) specification](https://www.openapis.org/), you can use and work with [compatible Swagger tools](http://swagger.io/open-source-integrations/). This API features Cross-Origin Resource Sharing (CORS) implemented in compliance with [W3C spec](https://www.w3.org/TR/cors/).  You can use your favorite HTTP/REST library for your programming language to use Flat's API. This specification and reference is [available on Github](https://github.com/FlatIO/api-reference).  Getting Started and learn more:  * [API Overview and interoduction](https://flat.io/developers/docs/api/) * [Authentication (Personal Access Tokens or OAuth2)](https://flat.io/developers/docs/api/authentication.html) * [SDKs](https://flat.io/developers/docs/api/sdks.html) * [Rate Limits](https://flat.io/developers/docs/api/rate-limits.html) * [Changelog](https://flat.io/developers/docs/api/changelog.html) 
 
-OpenAPI spec version: 2.5.2
+OpenAPI spec version: 2.6.0
 Contact: developers@flat.io
 Generated by: https://github.com/swagger-api/swagger-codegen.git
 Swagger Codegen version: 2.4.0-SNAPSHOT

data/lib/flat_api/api/collection_api.rb

@@ -0,0 +1,596 @@
+=begin
+#Flat API
+
+#The Flat API allows you to easily extend the abilities of the [Flat Platform](https://flat.io), with a wide range of use cases including the following:  * Creating and importing new music scores using MusicXML or MIDI files * Browsing, updating, copying, exporting the user's scores (for example in MP3, WAV or MIDI) * Managing educational resources with Flat for Education: creating & updating the organization accounts, the classes, rosters and assignments.  The Flat API is built on HTTP. Our API is RESTful It has predictable resource URLs. It returns HTTP response codes to indicate errors. It also accepts and returns JSON in the HTTP body. The [schema](/swagger.yaml) of this API follows the [OpenAPI Initiative (OAI) specification](https://www.openapis.org/), you can use and work with [compatible Swagger tools](http://swagger.io/open-source-integrations/). This API features Cross-Origin Resource Sharing (CORS) implemented in compliance with [W3C spec](https://www.w3.org/TR/cors/).  You can use your favorite HTTP/REST library for your programming language to use Flat's API. This specification and reference is [available on Github](https://github.com/FlatIO/api-reference).  Getting Started and learn more:  * [API Overview and interoduction](https://flat.io/developers/docs/api/) * [Authentication (Personal Access Tokens or OAuth2)](https://flat.io/developers/docs/api/authentication.html) * [SDKs](https://flat.io/developers/docs/api/sdks.html) * [Rate Limits](https://flat.io/developers/docs/api/rate-limits.html) * [Changelog](https://flat.io/developers/docs/api/changelog.html) 
+
+OpenAPI spec version: 2.6.0
+Contact: developers@flat.io
+Generated by: https://github.com/swagger-api/swagger-codegen.git
+Swagger Codegen version: 2.4.0-SNAPSHOT
+
+=end
+
+require "uri"
+
+module FlatApi
+  class CollectionApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+
+    # Add a score to the collection
+    # This operation will add a score to a collection. The default behavior will make the score available across multiple collections. You must have the capability `canAddScores` on the provided `collection` to perform the action. 
+    # @param collection Unique identifier of the collection. The following aliases are supported: - `root`: The root collection of the account - `sharedWithMe`: Automatically contains new resources that have been shared individually - `trash`: Automatically contains resources that have been deleted 
+    # @param score 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`). 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :sharing_key This sharing key must be specified to access to a score or collection with a `privacy` mode set to `privateLink` and the current user is not a collaborator of the document. 
+    # @return [ScoreDetails]
+    def add_score_to_collection(collection, score, opts = {})
+      data, _status_code, _headers = add_score_to_collection_with_http_info(collection, score, opts)
+      return data
+    end
+
+    # Add a score to the collection
+    # This operation will add a score to a collection. The default behavior will make the score available across multiple collections. You must have the capability `canAddScores` on the provided `collection` to perform the action. 
+    # @param collection Unique identifier of the collection. The following aliases are supported: - `root`: The root collection of the account - `sharedWithMe`: Automatically contains new resources that have been shared individually - `trash`: Automatically contains resources that have been deleted 
+    # @param score 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`). 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :sharing_key This sharing key must be specified to access to a score or collection with a `privacy` mode set to `privateLink` and the current user is not a collaborator of the document. 
+    # @return [Array<(ScoreDetails, Fixnum, Hash)>] ScoreDetails data, response status code and response headers
+    def add_score_to_collection_with_http_info(collection, score, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "Calling API: CollectionApi.add_score_to_collection ..."
+      end
+      # verify the required parameter 'collection' is set
+      if @api_client.config.client_side_validation && collection.nil?
+        fail ArgumentError, "Missing the required parameter 'collection' when calling CollectionApi.add_score_to_collection"
+      end
+      # verify the required parameter 'score' is set
+      if @api_client.config.client_side_validation && score.nil?
+        fail ArgumentError, "Missing the required parameter 'score' when calling CollectionApi.add_score_to_collection"
+      end
+      # resource path
+      local_var_path = "/collections/{collection}/scores/{score}".sub('{' + 'collection' + '}', collection.to_s).sub('{' + 'score' + '}', score.to_s)
+
+      # query parameters
+      query_params = {}
+      query_params[:'sharingKey'] = opts[:'sharing_key'] if !opts[:'sharing_key'].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 = ['OAuth2']
+      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,
+        :return_type => 'ScoreDetails')
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: CollectionApi#add_score_to_collection\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Create a new collection
+    # This method will create a new collection and add it to your `root` collection. 
+    # @param body 
+    # @param [Hash] opts the optional parameters
+    # @return [Collection]
+    def create_collection(body, opts = {})
+      data, _status_code, _headers = create_collection_with_http_info(body, opts)
+      return data
+    end
+
+    # Create a new collection
+    # This method will create a new collection and add it to your &#x60;root&#x60; collection. 
+    # @param body 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(Collection, Fixnum, Hash)>] Collection data, response status code and response headers
+    def create_collection_with_http_info(body, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "Calling API: CollectionApi.create_collection ..."
+      end
+      # verify the required parameter 'body' is set
+      if @api_client.config.client_side_validation && body.nil?
+        fail ArgumentError, "Missing the required parameter 'body' when calling CollectionApi.create_collection"
+      end
+      # resource path
+      local_var_path = "/collections"
+
+      # 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(body)
+      auth_names = ['OAuth2']
+      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 => 'Collection')
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: CollectionApi#create_collection\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Delete the collection
+    # This method will schedule the deletion of the collection. Until deleted, the collection will be available in the `trash`. 
+    # @param collection Unique identifier of the collection. The following aliases are supported: - &#x60;root&#x60;: The root collection of the account - &#x60;sharedWithMe&#x60;: Automatically contains new resources that have been shared individually - &#x60;trash&#x60;: Automatically contains resources that have been deleted 
+    # @param [Hash] opts the optional parameters
+    # @return [nil]
+    def delete_collection(collection, opts = {})
+      delete_collection_with_http_info(collection, opts)
+      return nil
+    end
+
+    # Delete the collection
+    # This method will schedule the deletion of the collection. Until deleted, the collection will be available in the &#x60;trash&#x60;. 
+    # @param collection Unique identifier of the collection. The following aliases are supported: - &#x60;root&#x60;: The root collection of the account - &#x60;sharedWithMe&#x60;: Automatically contains new resources that have been shared individually - &#x60;trash&#x60;: Automatically contains resources that have been deleted 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(nil, Fixnum, Hash)>] nil, response status code and response headers
+    def delete_collection_with_http_info(collection, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "Calling API: CollectionApi.delete_collection ..."
+      end
+      # verify the required parameter 'collection' is set
+      if @api_client.config.client_side_validation && collection.nil?
+        fail ArgumentError, "Missing the required parameter 'collection' when calling CollectionApi.delete_collection"
+      end
+      # resource path
+      local_var_path = "/collections/{collection}".sub('{' + 'collection' + '}', collection.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 = ['OAuth2']
+      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: CollectionApi#delete_collection\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Delete a score from the collection
+    # This method will delete a score from the collection. Unlike [`DELETE /scores/{score}`](#operation/deleteScore), this score will not remove the score from your account, but only from the collection. This can be used to *move* a score from one collection to another, or simply remove a score from one collection when this one is contained in multiple collections. 
+    # @param collection Unique identifier of the collection. The following aliases are supported: - &#x60;root&#x60;: The root collection of the account - &#x60;sharedWithMe&#x60;: Automatically contains new resources that have been shared individually - &#x60;trash&#x60;: Automatically contains resources that have been deleted 
+    # @param score Unique identifier of the score document. This can be a Flat Score unique identifier (i.e. &#x60;ScoreDetails.id&#x60;) or, if the score is also a Google Drive file, the Drive file unique identifier prefixed with &#x60;drive-&#x60; (e.g. &#x60;drive-0B000000000&#x60;). 
+    # @param [Hash] opts the optional parameters
+    # @return [nil]
+    def delete_score_from_collection(collection, score, opts = {})
+      delete_score_from_collection_with_http_info(collection, score, opts)
+      return nil
+    end
+
+    # Delete a score from the collection
+    # This method will delete a score from the collection. Unlike [&#x60;DELETE /scores/{score}&#x60;](#operation/deleteScore), this score will not remove the score from your account, but only from the collection. This can be used to *move* a score from one collection to another, or simply remove a score from one collection when this one is contained in multiple collections. 
+    # @param collection Unique identifier of the collection. The following aliases are supported: - &#x60;root&#x60;: The root collection of the account - &#x60;sharedWithMe&#x60;: Automatically contains new resources that have been shared individually - &#x60;trash&#x60;: Automatically contains resources that have been deleted 
+    # @param score Unique identifier of the score document. This can be a Flat Score unique identifier (i.e. &#x60;ScoreDetails.id&#x60;) or, if the score is also a Google Drive file, the Drive file unique identifier prefixed with &#x60;drive-&#x60; (e.g. &#x60;drive-0B000000000&#x60;). 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(nil, Fixnum, Hash)>] nil, response status code and response headers
+    def delete_score_from_collection_with_http_info(collection, score, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "Calling API: CollectionApi.delete_score_from_collection ..."
+      end
+      # verify the required parameter 'collection' is set
+      if @api_client.config.client_side_validation && collection.nil?
+        fail ArgumentError, "Missing the required parameter 'collection' when calling CollectionApi.delete_score_from_collection"
+      end
+      # verify the required parameter 'score' is set
+      if @api_client.config.client_side_validation && score.nil?
+        fail ArgumentError, "Missing the required parameter 'score' when calling CollectionApi.delete_score_from_collection"
+      end
+      # resource path
+      local_var_path = "/collections/{collection}/scores/{score}".sub('{' + 'collection' + '}', collection.to_s).sub('{' + 'score' + '}', score.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 = ['OAuth2']
+      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: CollectionApi#delete_score_from_collection\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Update a collection's metadata
+    # 
+    # @param collection Unique identifier of the collection. The following aliases are supported: - &#x60;root&#x60;: The root collection of the account - &#x60;sharedWithMe&#x60;: Automatically contains new resources that have been shared individually - &#x60;trash&#x60;: Automatically contains resources that have been deleted 
+    # @param [Hash] opts the optional parameters
+    # @option opts [CollectionModification] :body 
+    # @return [Collection]
+    def edit_collection(collection, opts = {})
+      data, _status_code, _headers = edit_collection_with_http_info(collection, opts)
+      return data
+    end
+
+    # Update a collection&#39;s metadata
+    # 
+    # @param collection Unique identifier of the collection. The following aliases are supported: - &#x60;root&#x60;: The root collection of the account - &#x60;sharedWithMe&#x60;: Automatically contains new resources that have been shared individually - &#x60;trash&#x60;: Automatically contains resources that have been deleted 
+    # @param [Hash] opts the optional parameters
+    # @option opts [CollectionModification] :body 
+    # @return [Array<(Collection, Fixnum, Hash)>] Collection data, response status code and response headers
+    def edit_collection_with_http_info(collection, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "Calling API: CollectionApi.edit_collection ..."
+      end
+      # verify the required parameter 'collection' is set
+      if @api_client.config.client_side_validation && collection.nil?
+        fail ArgumentError, "Missing the required parameter 'collection' when calling CollectionApi.edit_collection"
+      end
+      # resource path
+      local_var_path = "/collections/{collection}".sub('{' + 'collection' + '}', collection.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(opts[:'body'])
+      auth_names = ['OAuth2']
+      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,
+        :return_type => 'Collection')
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: CollectionApi#edit_collection\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Get collection details
+    # 
+    # @param collection Unique identifier of the collection. The following aliases are supported: - &#x60;root&#x60;: The root collection of the account - &#x60;sharedWithMe&#x60;: Automatically contains new resources that have been shared individually - &#x60;trash&#x60;: Automatically contains resources that have been deleted 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :sharing_key This sharing key must be specified to access to a score or collection with a &#x60;privacy&#x60; mode set to &#x60;privateLink&#x60; and the current user is not a collaborator of the document. 
+    # @return [Collection]
+    def get_collection(collection, opts = {})
+      data, _status_code, _headers = get_collection_with_http_info(collection, opts)
+      return data
+    end
+
+    # Get collection details
+    # 
+    # @param collection Unique identifier of the collection. The following aliases are supported: - &#x60;root&#x60;: The root collection of the account - &#x60;sharedWithMe&#x60;: Automatically contains new resources that have been shared individually - &#x60;trash&#x60;: Automatically contains resources that have been deleted 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :sharing_key This sharing key must be specified to access to a score or collection with a &#x60;privacy&#x60; mode set to &#x60;privateLink&#x60; and the current user is not a collaborator of the document. 
+    # @return [Array<(Collection, Fixnum, Hash)>] Collection data, response status code and response headers
+    def get_collection_with_http_info(collection, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "Calling API: CollectionApi.get_collection ..."
+      end
+      # verify the required parameter 'collection' is set
+      if @api_client.config.client_side_validation && collection.nil?
+        fail ArgumentError, "Missing the required parameter 'collection' when calling CollectionApi.get_collection"
+      end
+      # resource path
+      local_var_path = "/collections/{collection}".sub('{' + 'collection' + '}', collection.to_s)
+
+      # query parameters
+      query_params = {}
+      query_params[:'sharingKey'] = opts[:'sharing_key'] if !opts[:'sharing_key'].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 = ['OAuth2']
+      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 => 'Collection')
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: CollectionApi#get_collection\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # List the scores contained in a collection
+    # Use this method to list the scores contained in a collection. If no sort option is provided, the scores are sorted by `modificationDate` `desc`. 
+    # @param collection Unique identifier of the collection. The following aliases are supported: - &#x60;root&#x60;: The root collection of the account - &#x60;sharedWithMe&#x60;: Automatically contains new resources that have been shared individually - &#x60;trash&#x60;: Automatically contains resources that have been deleted 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :sharing_key This sharing key must be specified to access to a score or collection with a &#x60;privacy&#x60; mode set to &#x60;privateLink&#x60; and the current user is not a collaborator of the document. 
+    # @option opts [String] :sort Sort
+    # @option opts [String] :direction Sort direction
+    # @option opts [Integer] :limit This is the maximum number of objects that may be returned (default to 25)
+    # @option opts [String] :_next An opaque string cursor to fetch the next page of data. The paginated API URLs are returned in the &#x60;Link&#x60; header when requesting the API. These URLs will contain a &#x60;next&#x60; and &#x60;previous&#x60; cursor based on the available data. 
+    # @option opts [String] :previous An opaque string cursor to fetch the previous page of data. The paginated API URLs are returned in the &#x60;Link&#x60; header when requesting the API. These URLs will contain a &#x60;next&#x60; and &#x60;previous&#x60; cursor based on the available data. 
+    # @return [Array<ScoreDetails>]
+    def list_collection_scores(collection, opts = {})
+      data, _status_code, _headers = list_collection_scores_with_http_info(collection, opts)
+      return data
+    end
+
+    # List the scores contained in a collection
+    # Use this method to list the scores contained in a collection. If no sort option is provided, the scores are sorted by &#x60;modificationDate&#x60; &#x60;desc&#x60;. 
+    # @param collection Unique identifier of the collection. The following aliases are supported: - &#x60;root&#x60;: The root collection of the account - &#x60;sharedWithMe&#x60;: Automatically contains new resources that have been shared individually - &#x60;trash&#x60;: Automatically contains resources that have been deleted 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :sharing_key This sharing key must be specified to access to a score or collection with a &#x60;privacy&#x60; mode set to &#x60;privateLink&#x60; and the current user is not a collaborator of the document. 
+    # @option opts [String] :sort Sort
+    # @option opts [String] :direction Sort direction
+    # @option opts [Integer] :limit This is the maximum number of objects that may be returned
+    # @option opts [String] :_next An opaque string cursor to fetch the next page of data. The paginated API URLs are returned in the &#x60;Link&#x60; header when requesting the API. These URLs will contain a &#x60;next&#x60; and &#x60;previous&#x60; cursor based on the available data. 
+    # @option opts [String] :previous An opaque string cursor to fetch the previous page of data. The paginated API URLs are returned in the &#x60;Link&#x60; header when requesting the API. These URLs will contain a &#x60;next&#x60; and &#x60;previous&#x60; cursor based on the available data. 
+    # @return [Array<(Array<ScoreDetails>, Fixnum, Hash)>] Array<ScoreDetails> data, response status code and response headers
+    def list_collection_scores_with_http_info(collection, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "Calling API: CollectionApi.list_collection_scores ..."
+      end
+      # verify the required parameter 'collection' is set
+      if @api_client.config.client_side_validation && collection.nil?
+        fail ArgumentError, "Missing the required parameter 'collection' when calling CollectionApi.list_collection_scores"
+      end
+      if @api_client.config.client_side_validation && opts[:'sort'] && !['creationDate', 'modificationDate', 'title'].include?(opts[:'sort'])
+        fail ArgumentError, 'invalid value for "sort", must be one of creationDate, modificationDate, title'
+      end
+      if @api_client.config.client_side_validation && opts[:'direction'] && !['asc', 'desc'].include?(opts[:'direction'])
+        fail ArgumentError, 'invalid value for "direction", must be one of asc, desc'
+      end
+      if @api_client.config.client_side_validation && !opts[:'limit'].nil? && opts[:'limit'] > 100
+        fail ArgumentError, 'invalid value for "opts[:"limit"]" when calling CollectionApi.list_collection_scores, must be smaller than or equal to 100.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'limit'].nil? && opts[:'limit'] < 1
+        fail ArgumentError, 'invalid value for "opts[:"limit"]" when calling CollectionApi.list_collection_scores, must be greater than or equal to 1.'
+      end
+
+      # resource path
+      local_var_path = "/collections/{collection}/scores".sub('{' + 'collection' + '}', collection.to_s)
+
+      # query parameters
+      query_params = {}
+      query_params[:'sharingKey'] = opts[:'sharing_key'] if !opts[:'sharing_key'].nil?
+      query_params[:'sort'] = opts[:'sort'] if !opts[:'sort'].nil?
+      query_params[:'direction'] = opts[:'direction'] if !opts[:'direction'].nil?
+      query_params[:'limit'] = opts[:'limit'] if !opts[:'limit'].nil?
+      query_params[:'next'] = opts[:'_next'] if !opts[:'_next'].nil?
+      query_params[:'previous'] = opts[:'previous'] if !opts[:'previous'].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 = ['OAuth2']
+      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 => 'Array<ScoreDetails>')
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: CollectionApi#list_collection_scores\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # List the collections
+    # Use this method to list the user's collections contained in `parent` (by default in the `root` collection). If no sort option is provided, the collections are sorted by `creationDate` `desc`.  Note that this method will not include the `parent` collection in the listing. For example, if you need the details of the `root` collection, you can use `GET /v2/collections/root`. 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :parent List the collection contained in this &#x60;parent&#x60; collection.  This option doesn&#39;t provide a complete multi-level collection support. When sharing a collection with someone, this one will have as &#x60;parent&#x60; &#x60;sharedWithMe&#x60;.  (default to root)
+    # @option opts [String] :sort Sort
+    # @option opts [String] :direction Sort direction
+    # @option opts [Integer] :limit This is the maximum number of objects that may be returned (default to 25)
+    # @option opts [String] :_next An opaque string cursor to fetch the next page of data. The paginated API URLs are returned in the &#x60;Link&#x60; header when requesting the API. These URLs will contain a &#x60;next&#x60; and &#x60;previous&#x60; cursor based on the available data. 
+    # @option opts [String] :previous An opaque string cursor to fetch the previous page of data. The paginated API URLs are returned in the &#x60;Link&#x60; header when requesting the API. These URLs will contain a &#x60;next&#x60; and &#x60;previous&#x60; cursor based on the available data. 
+    # @return [Array<Collection>]
+    def list_collections(opts = {})
+      data, _status_code, _headers = list_collections_with_http_info(opts)
+      return data
+    end
+
+    # List the collections
+    # Use this method to list the user&#39;s collections contained in &#x60;parent&#x60; (by default in the &#x60;root&#x60; collection). If no sort option is provided, the collections are sorted by &#x60;creationDate&#x60; &#x60;desc&#x60;.  Note that this method will not include the &#x60;parent&#x60; collection in the listing. For example, if you need the details of the &#x60;root&#x60; collection, you can use &#x60;GET /v2/collections/root&#x60;. 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :parent List the collection contained in this &#x60;parent&#x60; collection.  This option doesn&#39;t provide a complete multi-level collection support. When sharing a collection with someone, this one will have as &#x60;parent&#x60; &#x60;sharedWithMe&#x60;. 
+    # @option opts [String] :sort Sort
+    # @option opts [String] :direction Sort direction
+    # @option opts [Integer] :limit This is the maximum number of objects that may be returned
+    # @option opts [String] :_next An opaque string cursor to fetch the next page of data. The paginated API URLs are returned in the &#x60;Link&#x60; header when requesting the API. These URLs will contain a &#x60;next&#x60; and &#x60;previous&#x60; cursor based on the available data. 
+    # @option opts [String] :previous An opaque string cursor to fetch the previous page of data. The paginated API URLs are returned in the &#x60;Link&#x60; header when requesting the API. These URLs will contain a &#x60;next&#x60; and &#x60;previous&#x60; cursor based on the available data. 
+    # @return [Array<(Array<Collection>, Fixnum, Hash)>] Array<Collection> data, response status code and response headers
+    def list_collections_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "Calling API: CollectionApi.list_collections ..."
+      end
+      if @api_client.config.client_side_validation && opts[:'parent'] && !['root', 'sharedWithMe', 'trash'].include?(opts[:'parent'])
+        fail ArgumentError, 'invalid value for "parent", must be one of root, sharedWithMe, trash'
+      end
+      if @api_client.config.client_side_validation && opts[:'sort'] && !['creationDate', 'title'].include?(opts[:'sort'])
+        fail ArgumentError, 'invalid value for "sort", must be one of creationDate, title'
+      end
+      if @api_client.config.client_side_validation && opts[:'direction'] && !['asc', 'desc'].include?(opts[:'direction'])
+        fail ArgumentError, 'invalid value for "direction", must be one of asc, desc'
+      end
+      if @api_client.config.client_side_validation && !opts[:'limit'].nil? && opts[:'limit'] > 100
+        fail ArgumentError, 'invalid value for "opts[:"limit"]" when calling CollectionApi.list_collections, must be smaller than or equal to 100.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'limit'].nil? && opts[:'limit'] < 1
+        fail ArgumentError, 'invalid value for "opts[:"limit"]" when calling CollectionApi.list_collections, must be greater than or equal to 1.'
+      end
+
+      # resource path
+      local_var_path = "/collections"
+
+      # query parameters
+      query_params = {}
+      query_params[:'parent'] = opts[:'parent'] if !opts[:'parent'].nil?
+      query_params[:'sort'] = opts[:'sort'] if !opts[:'sort'].nil?
+      query_params[:'direction'] = opts[:'direction'] if !opts[:'direction'].nil?
+      query_params[:'limit'] = opts[:'limit'] if !opts[:'limit'].nil?
+      query_params[:'next'] = opts[:'_next'] if !opts[:'_next'].nil?
+      query_params[:'previous'] = opts[:'previous'] if !opts[:'previous'].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 = ['OAuth2']
+      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 => 'Array<Collection>')
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: CollectionApi#list_collections\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Untrash a collection
+    # This method will restore the collection by removing it from the `trash` and add it back to the `root` collection. 
+    # @param collection Unique identifier of the collection. The following aliases are supported: - &#x60;root&#x60;: The root collection of the account - &#x60;sharedWithMe&#x60;: Automatically contains new resources that have been shared individually - &#x60;trash&#x60;: Automatically contains resources that have been deleted 
+    # @param [Hash] opts the optional parameters
+    # @return [nil]
+    def untrash_collection(collection, opts = {})
+      untrash_collection_with_http_info(collection, opts)
+      return nil
+    end
+
+    # Untrash a collection
+    # This method will restore the collection by removing it from the &#x60;trash&#x60; and add it back to the &#x60;root&#x60; collection. 
+    # @param collection Unique identifier of the collection. The following aliases are supported: - &#x60;root&#x60;: The root collection of the account - &#x60;sharedWithMe&#x60;: Automatically contains new resources that have been shared individually - &#x60;trash&#x60;: Automatically contains resources that have been deleted 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(nil, Fixnum, Hash)>] nil, response status code and response headers
+    def untrash_collection_with_http_info(collection, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "Calling API: CollectionApi.untrash_collection ..."
+      end
+      # verify the required parameter 'collection' is set
+      if @api_client.config.client_side_validation && collection.nil?
+        fail ArgumentError, "Missing the required parameter 'collection' when calling CollectionApi.untrash_collection"
+      end
+      # resource path
+      local_var_path = "/collections/{collection}/untrash".sub('{' + 'collection' + '}', collection.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 = ['OAuth2']
+      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)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: CollectionApi#untrash_collection\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end