Merge pull request #89 from aspose-pdf-cloud/develop

update to 25.4

Author: boiledgas

README.md

@@ -29,7 +29,8 @@ XLS, XLSX, PPTX, DOC, DOCX, MobiXML, JPEG, EMF, PNG, BMP, GIF, TIFF, Text
 ## Read PDF Formats
 MHT, PCL, PS, XSLFO, MD
 
-## Enhancements in Version 25.3
+## Enhancements in Version 25.4
+- Add method for adding Stamp per page in batch.
 - A new version of Aspose.PDF Cloud was prepared using the latest version of Aspose.PDF for .NET.
 
 ## Installation
@@ -45,15 +46,15 @@ gem build aspose_pdf_cloud.gemspec
 Then either install the gem locally:
 
 ```shell
-gem install ./aspose_pdf_cloud-25.3.0.gem
+gem install ./aspose_pdf_cloud-25.4.0.gem
 ```
-(for development, run `gem install --dev ./aspose_pdf_cloud-25.3.0.gem` to install the development dependencies)
+(for development, run `gem install --dev ./aspose_pdf_cloud-25.4.0.gem` to install the development dependencies)
 
 or publish the gem to a gem hosting service, e.g. [RubyGems](https://rubygems.org/).
 
 Finally add this to the Gemfile:
 
-    gem 'aspose_pdf_cloud', '~> 25.3.0'
+    gem 'aspose_pdf_cloud', '~> 25.4.0'
 
 ### Install from Git
 

docs/ImageStampPageSpecified.md

@@ -0,0 +1,26 @@
+# AsposePdfCloud::ImageStampPageSpecified
+Represents Pdf stamps.
+
+## Properties
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**links** | [**Array<Link>**](Link.md) | Link to the document. | [optional] 
+**background** | **BOOLEAN** | Sets or gets a bool value that indicates the content is stamped as background. If the value is true, the stamp content is layed at the bottom. By defalt, the value is false, the stamp content is layed at the top. | [optional] 
+**horizontal_alignment** | [**HorizontalAlignment**](HorizontalAlignment.md) | Gets or sets Horizontal alignment of stamp on the page.  | [optional] 
+**opacity** | **Float** | Gets or sets a value to indicate the stamp opacity. The value is from 0.0 to 1.0. By default the value is 1.0. | [optional] 
+**rotate** | [**Rotation**](Rotation.md) | Sets or gets the rotation of stamp content according Rotation values. Note. This property is for set angles which are multiples of 90 degrees (0, 90, 180, 270 degrees). To set arbitrary angle use RotateAngle property.  If angle set by ArbitraryAngle is not multiple of 90 then Rotate property returns Rotation.None. | [optional] 
+**rotate_angle** | **Float** | Gets or sets rotate angle of stamp in degrees. This property allows to set arbitrary rotate angle.  | [optional] 
+**x_indent** | **Float** | Horizontal stamp coordinate, starting from the left. | [optional] 
+**y_indent** | **Float** | Vertical stamp coordinate, starting from the bottom. | [optional] 
+**zoom** | **Float** | Zooming factor of the stamp. Allows to scale stamp. | [optional] 
+**file_name** | **String** | Gets or sets the file name. | [optional] 
+**width** | **Float** | Gets or sets image width. Setting this property allos to scal image horizontally. | [optional] 
+**height** | **Float** | Gets or sets image height. Setting this image allows to scale image vertically. | [optional] 
+**vertical_alignment** | [**VerticalAlignment**](VerticalAlignment.md) | Gets or sets vertical alignment of stamp on page. | [optional] 
+**bottom_margin** | **Float** | Gets or sets bottom margin of stamp. | [optional] 
+**left_margin** | **Float** | Gets or sets left margin of stamp. | [optional] 
+**top_margin** | **Float** | Gets or sets top margin of stamp. | [optional] 
+**right_margin** | **Float** | Gets or sets right margin of stamp. | [optional] 
+**page_number** | **Integer** | Page number. | 
+
+

docs/PdfApi.md

@@ -209,11 +209,13 @@ Method | HTTP request | Description
 [**post_document_image_footer**](PdfApi.md#post_document_image_footer) | **POST** /pdf/\{name}/footer/image | Add document image footer.
 [**post_document_image_header**](PdfApi.md#post_document_image_header) | **POST** /pdf/\{name}/header/image | Add document image header.
 [**post_document_image_stamps**](PdfApi.md#post_document_image_stamps) | **POST** /pdf/\{name}/stamps/image | Add document pages image stamps.
+[**post_document_image_stamps_page_specified**](PdfApi.md#post_document_image_stamps_page_specified) | **POST** /pdf/\{name}/stamps/image/pagespecified | Add document image stamps to specified pages.
 [**post_document_page_number_stamps**](PdfApi.md#post_document_page_number_stamps) | **POST** /pdf/\{name}/stamps/pagenumber | Add document page number stamps.
 [**post_document_text_footer**](PdfApi.md#post_document_text_footer) | **POST** /pdf/\{name}/footer/text | Add document text footer.
 [**post_document_text_header**](PdfApi.md#post_document_text_header) | **POST** /pdf/\{name}/header/text | Add document text header.
 [**post_document_text_replace**](PdfApi.md#post_document_text_replace) | **POST** /pdf/\{name}/text/replace | Document's replace text method.
 [**post_document_text_stamps**](PdfApi.md#post_document_text_stamps) | **POST** /pdf/\{name}/stamps/text | Add document pages text stamps.
+[**post_document_text_stamps_page_specified**](PdfApi.md#post_document_text_stamps_page_specified) | **POST** /pdf/\{name}/stamps/text/pagespecified | Add document text stamps to specified pages.
 [**post_encrypt_document_in_storage**](PdfApi.md#post_encrypt_document_in_storage) | **POST** /pdf/\{name}/encrypt | Encrypt document in storage.
 [**post_flatten_document**](PdfApi.md#post_flatten_document) | **POST** /pdf/\{name}/flatten | Flatten the document.
 [**post_html_to_pdf**](PdfApi.md#post_html_to_pdf) | **POST** /pdf/create/html | Convert HTML file (zip archive in request content) to PDF format and return resulting file in response. 
@@ -5572,6 +5574,32 @@ Name | Type | Description  | Notes
 
 
 
+# **post_document_image_stamps_page_specified**
+> AsposeResponse post_document_image_stamps_page_specified(name, stamps, opts)
+
+Add document image stamps to specified pages.
+
+### Parameters
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **name** | **String**| The document name. | 
+ **stamps** | [**Array<ImageStampPageSpecified>**](ImageStampPageSpecified.md)| The array of stamps. | 
+ **storage** | **String**| The document storage. | [optional] 
+ **folder** | **String**| The document folder. | [optional] 
+ **password** | **String**| Base64 encoded password. | [optional] 
+
+### Return type
+
+[**AsposeResponse**](AsposeResponse.md)
+
+### HTTP request headers
+
+ - **Content-Type**: application/json
+ - **Accept**: application/json
+
+
+
 # **post_document_page_number_stamps**
 > AsposeResponse post_document_page_number_stamps(name, stamp, opts)
 
@@ -5705,6 +5733,32 @@ Name | Type | Description  | Notes
 
 
 
+# **post_document_text_stamps_page_specified**
+> AsposeResponse post_document_text_stamps_page_specified(name, stamps, opts)
+
+Add document text stamps to specified pages.
+
+### Parameters
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **name** | **String**| The document name. | 
+ **stamps** | [**Array<TextStampPageSpecified>**](TextStampPageSpecified.md)| The array of stamps. | 
+ **storage** | **String**| The document storage. | [optional] 
+ **folder** | **String**| The document folder. | [optional] 
+ **password** | **String**| Base64 encoded password. | [optional] 
+
+### Return type
+
+[**AsposeResponse**](AsposeResponse.md)
+
+### HTTP request headers
+
+ - **Content-Type**: application/json
+ - **Accept**: application/json
+
+
+
 # **post_encrypt_document_in_storage**
 > AsposeResponse post_encrypt_document_in_storage(name, user_password, owner_password, crypto_algorithm, opts)
 

docs/TextStampPageSpecified.md

@@ -0,0 +1,26 @@
+# AsposePdfCloud::TextStampPageSpecified
+Represents Pdf stamps.
+
+## Properties
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**links** | [**Array<Link>**](Link.md) | Link to the document. | [optional] 
+**background** | **BOOLEAN** | Sets or gets a bool value that indicates the content is stamped as background. If the value is true, the stamp content is layed at the bottom. By defalt, the value is false, the stamp content is layed at the top. | [optional] 
+**horizontal_alignment** | [**HorizontalAlignment**](HorizontalAlignment.md) | Gets or sets Horizontal alignment of stamp on the page.  | [optional] 
+**opacity** | **Float** | Gets or sets a value to indicate the stamp opacity. The value is from 0.0 to 1.0. By default the value is 1.0. | [optional] 
+**rotate** | [**Rotation**](Rotation.md) | Sets or gets the rotation of stamp content according Rotation values. Note. This property is for set angles which are multiples of 90 degrees (0, 90, 180, 270 degrees). To set arbitrary angle use RotateAngle property.  If angle set by ArbitraryAngle is not multiple of 90 then Rotate property returns Rotation.None. | [optional] 
+**rotate_angle** | **Float** | Gets or sets rotate angle of stamp in degrees. This property allows to set arbitrary rotate angle.  | [optional] 
+**x_indent** | **Float** | Horizontal stamp coordinate, starting from the left. | [optional] 
+**y_indent** | **Float** | Vertical stamp coordinate, starting from the bottom. | [optional] 
+**zoom** | **Float** | Zooming factor of the stamp. Allows to scale stamp. | [optional] 
+**text_alignment** | [**HorizontalAlignment**](HorizontalAlignment.md) | Alignment of the text inside the stamp. | [optional] 
+**value** | **String** | Gets or sets string value which is used as stamp on the page. | [optional] 
+**text_state** | [**TextState**](TextState.md) | Gets text properties of the stamp. See TextState for details. | [optional] 
+**vertical_alignment** | [**VerticalAlignment**](VerticalAlignment.md) | Gets or sets vertical alignment of stamp on page. | [optional] 
+**bottom_margin** | **Float** | Gets or sets bottom margin of stamp. | [optional] 
+**left_margin** | **Float** | Gets or sets left margin of stamp. | [optional] 
+**top_margin** | **Float** | Gets or sets top margin of stamp. | [optional] 
+**right_margin** | **Float** | Gets or sets right margin of stamp. | [optional] 
+**page_number** | **Integer** | Page number. | 
+
+

lib/aspose_pdf_cloud.rb

@@ -300,6 +300,7 @@
 require_relative 'aspose_pdf_cloud/models/file_attachment_annotation'
 require_relative 'aspose_pdf_cloud/models/free_text_annotation'
 require_relative 'aspose_pdf_cloud/models/highlight_annotation'
+require_relative 'aspose_pdf_cloud/models/image_stamp_page_specified'
 require_relative 'aspose_pdf_cloud/models/ink_annotation'
 require_relative 'aspose_pdf_cloud/models/line_annotation'
 require_relative 'aspose_pdf_cloud/models/list_box_field'
@@ -311,6 +312,7 @@
 require_relative 'aspose_pdf_cloud/models/stamp_annotation'
 require_relative 'aspose_pdf_cloud/models/strike_out_annotation'
 require_relative 'aspose_pdf_cloud/models/text_annotation'
+require_relative 'aspose_pdf_cloud/models/text_stamp_page_specified'
 require_relative 'aspose_pdf_cloud/models/underline_annotation'
 require_relative 'aspose_pdf_cloud/models/circle_annotation'
 require_relative 'aspose_pdf_cloud/models/poly_line_annotation'

lib/aspose_pdf_cloud/api/pdf_api.rb

@@ -16083,6 +16083,86 @@ def post_document_image_stamps_with_http_info(name, stamps, opts = {})
       return data, status_code, headers
     end
 
+    # Add document image stamps to specified pages.
+    # 
+    # @param name The document name.
+    # @param stamps The array of stamps.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :storage The document storage.
+    # @option opts [String] :folder The document folder.
+    # @option opts [String] :password Base64 encoded password.
+    # @return [AsposeResponse]
+    def post_document_image_stamps_page_specified(name, stamps, opts = {})
+      @api_client.request_token_if_needed
+      data, _status_code, _headers = post_document_image_stamps_page_specified_with_http_info(name, stamps, opts)
+      rescue ApiError => error
+        if error.code == 401
+          @api_client.request_token_if_needed
+          data, _status_code, _headers = post_document_image_stamps_page_specified_with_http_info(name, stamps, opts)
+        else
+          raise
+        end
+      return data
+    end
+
+    # Add document image stamps to specified pages.
+    # 
+    # @param name The document name.
+    # @param stamps The array of stamps.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :storage The document storage.
+    # @option opts [String] :folder The document folder.
+    # @option opts [String] :password Base64 encoded password.
+    # @return [Array<(AsposeResponse, Fixnum, Hash)>] AsposeResponse data, response status code and response headers
+    def post_document_image_stamps_page_specified_with_http_info(name, stamps, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "Calling API: PdfApi.post_document_image_stamps_page_specified ..."
+      end
+      # verify the required parameter 'name' is set
+      if @api_client.config.client_side_validation && name.nil?
+        fail ArgumentError, "Missing the required parameter 'name' when calling PdfApi.post_document_image_stamps_page_specified"
+      end
+      # verify the required parameter 'stamps' is set
+      if @api_client.config.client_side_validation && stamps.nil?
+        fail ArgumentError, "Missing the required parameter 'stamps' when calling PdfApi.post_document_image_stamps_page_specified"
+      end
+      # resource path
+      local_var_path = "/pdf/{name}/stamps/image/pagespecified".sub('{' + 'name' + '}', name.to_s)
+
+      # query parameters
+      query_params = {}
+      query_params[:'storage'] = opts[:'storage'] if !opts[:'storage'].nil?
+      query_params[:'folder'] = opts[:'folder'] if !opts[:'folder'].nil?
+      query_params[:'password'] = opts[:'password'] if !opts[:'password'].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 = {}
+      # Fix header in file
+      post_body = nil
+
+      # http body (model)
+      post_body = @api_client.object_to_http_body(stamps)
+      auth_names = ['JWT']
+      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 => 'AsposeResponse')
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: PdfApi#post_document_image_stamps_page_specified\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # Add document page number stamps.
     # 
     # @param name The document name.
@@ -16492,6 +16572,86 @@ def post_document_text_stamps_with_http_info(name, stamps, opts = {})
       return data, status_code, headers
     end
 
+    # Add document text stamps to specified pages.
+    # 
+    # @param name The document name.
+    # @param stamps The array of stamps.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :storage The document storage.
+    # @option opts [String] :folder The document folder.
+    # @option opts [String] :password Base64 encoded password.
+    # @return [AsposeResponse]
+    def post_document_text_stamps_page_specified(name, stamps, opts = {})
+      @api_client.request_token_if_needed
+      data, _status_code, _headers = post_document_text_stamps_page_specified_with_http_info(name, stamps, opts)
+      rescue ApiError => error
+        if error.code == 401
+          @api_client.request_token_if_needed
+          data, _status_code, _headers = post_document_text_stamps_page_specified_with_http_info(name, stamps, opts)
+        else
+          raise
+        end
+      return data
+    end
+
+    # Add document text stamps to specified pages.
+    # 
+    # @param name The document name.
+    # @param stamps The array of stamps.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :storage The document storage.
+    # @option opts [String] :folder The document folder.
+    # @option opts [String] :password Base64 encoded password.
+    # @return [Array<(AsposeResponse, Fixnum, Hash)>] AsposeResponse data, response status code and response headers
+    def post_document_text_stamps_page_specified_with_http_info(name, stamps, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "Calling API: PdfApi.post_document_text_stamps_page_specified ..."
+      end
+      # verify the required parameter 'name' is set
+      if @api_client.config.client_side_validation && name.nil?
+        fail ArgumentError, "Missing the required parameter 'name' when calling PdfApi.post_document_text_stamps_page_specified"
+      end
+      # verify the required parameter 'stamps' is set
+      if @api_client.config.client_side_validation && stamps.nil?
+        fail ArgumentError, "Missing the required parameter 'stamps' when calling PdfApi.post_document_text_stamps_page_specified"
+      end
+      # resource path
+      local_var_path = "/pdf/{name}/stamps/text/pagespecified".sub('{' + 'name' + '}', name.to_s)
+
+      # query parameters
+      query_params = {}
+      query_params[:'storage'] = opts[:'storage'] if !opts[:'storage'].nil?
+      query_params[:'folder'] = opts[:'folder'] if !opts[:'folder'].nil?
+      query_params[:'password'] = opts[:'password'] if !opts[:'password'].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 = {}
+      # Fix header in file
+      post_body = nil
+
+      # http body (model)
+      post_body = @api_client.object_to_http_body(stamps)
+      auth_names = ['JWT']
+      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 => 'AsposeResponse')
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: PdfApi#post_document_text_stamps_page_specified\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # Encrypt document in storage.
     # 
     # @param name Document name.