lib/groupdocs/document.rb in groupdocs-1.0.0 vs lib/groupdocs/document.rb in groupdocs-1.1.0

@@ -14,10 +14,11 @@
       inherited:  2,
       public:     3,
     }
 
     include Api::Helpers::AccessMode
+    include Api::Helpers::AccessRights
     include Api::Helpers::Status
 
     #
     # Returns an array of views for all documents.
     #
@@ -531,9 +532,137 @@
       json = api.execute!
 
       json[:changes].map do |change|
         Document::Change.new(change)
       end
+    end
+
+    #
+    # Returns document annotations collaborators.
+    #
+    # @param [Hash] access Access credentials
+    # @option access [String] :client_id
+    # @option access [String] :private_key
+    # @return [Array<GroupDocs::User>]
+    #
+    def collaborators!(access = {})
+      json = Api::Request.new do |request|
+        request[:access] = access
+        request[:method] = :GET
+        request[:path] = "/ant/{{client_id}}/files/#{file.guid}/collaborators"
+      end.execute!
+
+      json[:collaborators].map do |collaborator|
+        User.new(collaborator)
+      end
+    end
+
+    #
+    # Sets document annotations collaborators to given emails.
+    #
+    # @param [Array<String>] emails List of collaborators' email addresses
+    # @param [Integer] version Annotation version
+    # @param [Hash] access Access credentials
+    # @option access [String] :client_id
+    # @option access [String] :private_key
+    # @return [Array<GroupDocs::User>]
+    #
+    def set_collaborators!(emails, version = 1, access = {})
+      json = Api::Request.new do |request|
+        request[:access] = access
+        request[:method] = :PUT
+        request[:path] = "/ant/{{client_id}}/files/#{file.guid}/version/#{version}/collaborators"
+        request[:request_body] = emails
+      end.execute!
+
+      json[:collaborators].map do |collaborator|
+        User.new(collaborator)
+      end
+    end
+
+    #
+    # Adds document annotations collaborator.
+    #
+    # @param [GroupDocs::User] collaborator
+    # @param [Hash] access Access credentials
+    # @option access [String] :client_id
+    # @option access [String] :private_key
+    #
+    def add_collaborator!(collaborator, access = {})
+      collaborator.is_a?(GroupDocs::User) or raise ArgumentError,
+        "Collaborator should be GroupDocs::User object, received: #{collaborator.inspect}"
+
+      Api::Request.new do |request|
+        request[:access] = access
+        request[:method] = :POST
+        request[:path] = "/ant/{{client_id}}/files/#{file.guid}/collaborators"
+        request[:request_body] = collaborator.to_hash
+      end.execute!
+    end
+
+    #
+    # Sets reviewers for document.
+    #
+    # @example Change reviewer rights
+    #   reviewers = document.collaborators!
+    #   reviewers.each do |reviewer|
+    #     reviewer.access_rights = %w(view)
+    #   end
+    #   document.set_reviewers! reviewers
+    #
+    # @param [Array<GroupDocs::User>] reviewers
+    # @param [Hash] access Access credentials
+    # @option access [String] :client_id
+    # @option access [String] :private_key
+    # @return [Array<Symbol>]
+    #
+    def set_reviewers!(reviewers, access = {})
+      Api::Request.new do |request|
+        request[:access] = access
+        request[:method] = :PUT
+        request[:path] = "/ant/{{client_id}}/files/#{file.guid}/reviewerRights"
+        request[:request_body] = reviewers.map(&:to_hash)
+      end.execute!
+    end
+
+    #
+    # Returns an array of access rights for shared link.
+    #
+    # @param [Hash] access Access credentials
+    # @option access [String] :client_id
+    # @option access [String] :private_key
+    # @return [Array<Symbol>]
+    #
+    def shared_link_access_rights!(access = {})
+      json = Api::Request.new do |request|
+        request[:access] = access
+        request[:method] = :GET
+        request[:path] = "/ant/{{client_id}}/files/#{file.guid}/sharedLinkAccessRights"
+      end.execute!
+
+      if json[:accessRights]
+        convert_byte_to_access_rights json[:accessRights]
+      else
+        []
+      end
+    end
+
+    #
+    # Sets access rights for shared link.
+    #
+    # @param [Array<Symbol>] rights
+    # @param [Hash] access Access credentials
+    # @option access [String] :client_id
+    # @option access [String] :private_key
+    # @return [Array<Symbol>]
+    #
+    def set_shared_link_access_rights!(rights, access = {})
+      json = Api::Request.new do |request|
+        request[:access] = access
+        request[:method] = :PUT
+        request[:path] = "/ant/{{client_id}}/files/#{file.guid}/sharedLinkAccessRights"
+        request[:request_body] = convert_access_rights_to_byte(rights)
+      end.execute!
     end
 
     #
     # Pass all unknown methods to file.
     #