docspace-api-sdk 4.0.0

data/lib/docspace-api-sdk/api/People/search-api.rb

@@ -0,0 +1,1150 @@
+# (c) Copyright Ascensio System SIA 2026
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+require 'cgi'
+
+module DocspaceApiSdk
+  module People
+    class SearchApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # Search accounts for a file
+    # Searches the portal users and groups that can be given access to the file with the ID given in the route, and  reports for each of them whether it already has access to that file.  The caller has to be allowed to manage the access of that file, and the ID has to belong to an existing file,  so the operation answers 403 for a file the caller cannot share and 404 for an ID that matches nothing.  The search is read-only and needs `filterValue`: while it is empty the operation returns an empty list and a  total of 0 instead of every account, so it cannot be used to enumerate the portal.  `filterValue` is matched case-insensitively against the first name, the last name and the email; without  `filterSeparator` it is split on spaces and every term has to match, and with a separator it is split on that  separator and any term may match.  Matching groups are streamed first and users after them, both paged together by `count` and `startIndex`,  while the number of matches is reported in the total count of the response.  Pass `excludeShared` to keep only the accounts that have no access yet, `includeShared` to keep only those  that already have it, and neither to get both kinds with the `shared` field telling them apart.
+    # See also: https://api.onlyoffice.com/docspace/api-backend/usage-api/get-accounts-entries-with-files-shared/
+    # @param id [Integer, String] The ID of the room, folder or file whose access the search is run against, taken from the route. It is an  integer for an entry stored in DocSpace and a provider-specific string for an entry in a connected  third-party storage.
+    # @param [Hash] opts the optional parameters
+    # @option opts [EmployeeStatus] :employee_status Keeps only the users in the given account state: `Active` for a working account, `Terminated` for a disabled  one and `Pending` for one that has not accepted its invitation yet. Omit it to search every state.
+    # @option opts [EmployeeActivationStatus] :activation_status Keeps only the users whose activation is in the given state: `NotActivated` for an account that has never  been activated, `Activated` for one that completed the activation, `Pending` for one whose invitation is  still open, and `AutoGenerated` for an account created by the portal itself. Omit it to search every state.
+    # @option opts [Boolean] :exclude_shared Keeps only the accounts that do not have access to the entry yet, which is the set to offer when adding new  members. It takes precedence over `includeShared`, and every returned entry has `shared` set to false.
+    # @option opts [Boolean] :include_shared Keeps only the accounts that already have access to the entry, which is the set to offer when changing or  revoking access. Every returned entry has `shared` set to true, and the flag is ignored when  `excludeShared` is also set.
+    # @option opts [Boolean] :invited_by_me Keeps only the users invited by the caller when true, and only the users invited by somebody else when false.  Omit it to search regardless of who sent the invitation.
+    # @option opts [String] :inviter_id Keeps only the users invited by the account with this ID. Omit it to search regardless of who sent the  invitation.
+    # @option opts [AccountSearchArea] :area The part of the portal to search in: `All`, the default, searches members and guests together, `People`  leaves the guests out, and `Guests` returns guests only - and for a caller who is not a DocSpace  administrator, only the guests that caller is related to.
+    # @option opts [Array<EmployeeType>] :employee_types Keeps only the users of the listed types, combined as alternatives. An empty list, which is the default,  searches every type.
+    # @option opts [Integer] :count The size of the page, counting groups and users together. It defaults to 100, which is also the largest value  the operation accepts.
+    # @option opts [Integer] :start_index The number of matches to skip before the page starts, counted over the groups and users together. It defaults  to 0, and the total number of matches is reported in the total count of the response.
+    # @option opts [String] :filter_separator The character that splits `filterValue` into several terms, of which any one may match. Omit it to split the  value on spaces instead, in which case every term has to match.
+    # @option opts [String] :filter_value The text to search for, matched case-insensitively against the first name, the last name and the email. It is  required in practice: while it is empty the search returns nothing at all rather than every account.
+    # @return [AccountEntryArrayWrapper]
+    def get_accounts_entries_with_files_shared(id, opts = {})
+      data, _status_code, _headers = get_accounts_entries_with_files_shared_with_http_info(id, opts)
+      data
+    end
+
+    # Search accounts for a file
+    # Searches the portal users and groups that can be given access to the file with the ID given in the route, and  reports for each of them whether it already has access to that file.  The caller has to be allowed to manage the access of that file, and the ID has to belong to an existing file,  so the operation answers 403 for a file the caller cannot share and 404 for an ID that matches nothing.  The search is read-only and needs `filterValue`: while it is empty the operation returns an empty list and a  total of 0 instead of every account, so it cannot be used to enumerate the portal.  `filterValue` is matched case-insensitively against the first name, the last name and the email; without  `filterSeparator` it is split on spaces and every term has to match, and with a separator it is split on that  separator and any term may match.  Matching groups are streamed first and users after them, both paged together by `count` and `startIndex`,  while the number of matches is reported in the total count of the response.  Pass `excludeShared` to keep only the accounts that have no access yet, `includeShared` to keep only those  that already have it, and neither to get both kinds with the `shared` field telling them apart.
+    # See also: https://api.onlyoffice.com/docspace/api-backend/usage-api/get-accounts-entries-with-files-shared/
+    # @param id [Integer, String] The ID of the room, folder or file whose access the search is run against, taken from the route. It is an  integer for an entry stored in DocSpace and a provider-specific string for an entry in a connected  third-party storage.
+    # @param [Hash] opts the optional parameters
+    # @option opts [EmployeeStatus] :employee_status Keeps only the users in the given account state: `Active` for a working account, `Terminated` for a disabled  one and `Pending` for one that has not accepted its invitation yet. Omit it to search every state.
+    # @option opts [EmployeeActivationStatus] :activation_status Keeps only the users whose activation is in the given state: `NotActivated` for an account that has never  been activated, `Activated` for one that completed the activation, `Pending` for one whose invitation is  still open, and `AutoGenerated` for an account created by the portal itself. Omit it to search every state.
+    # @option opts [Boolean] :exclude_shared Keeps only the accounts that do not have access to the entry yet, which is the set to offer when adding new  members. It takes precedence over `includeShared`, and every returned entry has `shared` set to false.
+    # @option opts [Boolean] :include_shared Keeps only the accounts that already have access to the entry, which is the set to offer when changing or  revoking access. Every returned entry has `shared` set to true, and the flag is ignored when  `excludeShared` is also set.
+    # @option opts [Boolean] :invited_by_me Keeps only the users invited by the caller when true, and only the users invited by somebody else when false.  Omit it to search regardless of who sent the invitation.
+    # @option opts [String] :inviter_id Keeps only the users invited by the account with this ID. Omit it to search regardless of who sent the  invitation.
+    # @option opts [AccountSearchArea] :area The part of the portal to search in: `All`, the default, searches members and guests together, `People`  leaves the guests out, and `Guests` returns guests only - and for a caller who is not a DocSpace  administrator, only the guests that caller is related to.
+    # @option opts [Array<EmployeeType>] :employee_types Keeps only the users of the listed types, combined as alternatives. An empty list, which is the default,  searches every type.
+    # @option opts [Integer] :count The size of the page, counting groups and users together. It defaults to 100, which is also the largest value  the operation accepts.
+    # @option opts [Integer] :start_index The number of matches to skip before the page starts, counted over the groups and users together. It defaults  to 0, and the total number of matches is reported in the total count of the response.
+    # @option opts [String] :filter_separator The character that splits `filterValue` into several terms, of which any one may match. Omit it to split the  value on spaces instead, in which case every term has to match.
+    # @option opts [String] :filter_value The text to search for, matched case-insensitively against the first name, the last name and the email. It is  required in practice: while it is empty the search returns nothing at all rather than every account.
+    # @return [Array<(AccountEntryArrayWrapper, Integer, Hash)>] AccountEntryArrayWrapper data, response status code and response headers
+    def get_accounts_entries_with_files_shared_with_http_info(id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: People::SearchApi.get_accounts_entries_with_files_shared ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling People::SearchApi.get_accounts_entries_with_files_shared"
+      end
+      if @api_client.config.client_side_validation && !opts[:'count'].nil? && opts[:'count'] > 100
+        fail ArgumentError, 'invalid value for "opts[:"count"]" when calling People::SearchApi.get_accounts_entries_with_files_shared, must be smaller than or equal to 100.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'count'].nil? && opts[:'count'] < 1
+        fail ArgumentError, 'invalid value for "opts[:"count"]" when calling People::SearchApi.get_accounts_entries_with_files_shared, must be greater than or equal to 1.'
+      end
+
+      # resource path
+      local_var_path = '/api/2.0/accounts/file/{id}/search'.sub('{' + 'id' + '}', CGI.escape(id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'employeeStatus'] = opts[:'employee_status'] if !opts[:'employee_status'].nil?
+      query_params[:'activationStatus'] = opts[:'activation_status'] if !opts[:'activation_status'].nil?
+      query_params[:'excludeShared'] = opts[:'exclude_shared'] if !opts[:'exclude_shared'].nil?
+      query_params[:'includeShared'] = opts[:'include_shared'] if !opts[:'include_shared'].nil?
+      query_params[:'invitedByMe'] = opts[:'invited_by_me'] if !opts[:'invited_by_me'].nil?
+      query_params[:'inviterId'] = opts[:'inviter_id'] if !opts[:'inviter_id'].nil?
+      query_params[:'area'] = opts[:'area'] if !opts[:'area'].nil?
+      query_params[:'employeeTypes'] = @api_client.build_collection_param(opts[:'employee_types'], :multi) if !opts[:'employee_types'].nil?
+      query_params[:'count'] = opts[:'count'] if !opts[:'count'].nil?
+      query_params[:'startIndex'] = opts[:'start_index'] if !opts[:'start_index'].nil?
+      query_params[:'filterSeparator'] = opts[:'filter_separator'] if !opts[:'filter_separator'].nil?
+      query_params[:'filterValue'] = opts[:'filter_value'] if !opts[:'filter_value'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'AccountEntryArrayWrapper'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['Basic', 'OAuth2', 'ApiKeyBearer', 'asc_auth_key', 'Bearer', 'OpenId']
+
+      new_options = opts.merge(
+        :operation => :"People::SearchApi.get_accounts_entries_with_files_shared",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: People::SearchApi#get_accounts_entries_with_files_shared\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Search accounts for a folder
+    # Searches the portal users and groups that can be given access to the folder with the ID given in the route,  and reports for each of them whether it already has access to that folder.  The caller has to be allowed to manage the access of that folder, and the ID has to belong to an existing  folder, so the operation answers 403 for a folder the caller cannot share and 404 for an ID that matches  nothing.  The search is read-only and needs `filterValue`: while it is empty the operation returns an empty list and a  total of 0 instead of every account, so it cannot be used to enumerate the portal.  `filterValue` is matched case-insensitively against the first name, the last name and the email; without  `filterSeparator` it is split on spaces and every term has to match, and with a separator it is split on that  separator and any term may match.  Matching groups are streamed first and users after them, both paged together by `count` and `startIndex`,  while the number of matches is reported in the total count of the response.  Pass `excludeShared` to keep only the accounts that have no access yet, `includeShared` to keep only those  that already have it, and neither to get both kinds with the `shared` field telling them apart.
+    # See also: https://api.onlyoffice.com/docspace/api-backend/usage-api/get-accounts-entries-with-folders-shared/
+    # @param id [Integer, String] The ID of the room, folder or file whose access the search is run against, taken from the route. It is an  integer for an entry stored in DocSpace and a provider-specific string for an entry in a connected  third-party storage.
+    # @param [Hash] opts the optional parameters
+    # @option opts [EmployeeStatus] :employee_status Keeps only the users in the given account state: `Active` for a working account, `Terminated` for a disabled  one and `Pending` for one that has not accepted its invitation yet. Omit it to search every state.
+    # @option opts [EmployeeActivationStatus] :activation_status Keeps only the users whose activation is in the given state: `NotActivated` for an account that has never  been activated, `Activated` for one that completed the activation, `Pending` for one whose invitation is  still open, and `AutoGenerated` for an account created by the portal itself. Omit it to search every state.
+    # @option opts [Boolean] :exclude_shared Keeps only the accounts that do not have access to the entry yet, which is the set to offer when adding new  members. It takes precedence over `includeShared`, and every returned entry has `shared` set to false.
+    # @option opts [Boolean] :include_shared Keeps only the accounts that already have access to the entry, which is the set to offer when changing or  revoking access. Every returned entry has `shared` set to true, and the flag is ignored when  `excludeShared` is also set.
+    # @option opts [Boolean] :invited_by_me Keeps only the users invited by the caller when true, and only the users invited by somebody else when false.  Omit it to search regardless of who sent the invitation.
+    # @option opts [String] :inviter_id Keeps only the users invited by the account with this ID. Omit it to search regardless of who sent the  invitation.
+    # @option opts [AccountSearchArea] :area The part of the portal to search in: `All`, the default, searches members and guests together, `People`  leaves the guests out, and `Guests` returns guests only - and for a caller who is not a DocSpace  administrator, only the guests that caller is related to.
+    # @option opts [Array<EmployeeType>] :employee_types Keeps only the users of the listed types, combined as alternatives. An empty list, which is the default,  searches every type.
+    # @option opts [Integer] :count The size of the page, counting groups and users together. It defaults to 100, which is also the largest value  the operation accepts.
+    # @option opts [Integer] :start_index The number of matches to skip before the page starts, counted over the groups and users together. It defaults  to 0, and the total number of matches is reported in the total count of the response.
+    # @option opts [String] :filter_separator The character that splits `filterValue` into several terms, of which any one may match. Omit it to split the  value on spaces instead, in which case every term has to match.
+    # @option opts [String] :filter_value The text to search for, matched case-insensitively against the first name, the last name and the email. It is  required in practice: while it is empty the search returns nothing at all rather than every account.
+    # @return [AccountEntryArrayWrapper]
+    def get_accounts_entries_with_folders_shared(id, opts = {})
+      data, _status_code, _headers = get_accounts_entries_with_folders_shared_with_http_info(id, opts)
+      data
+    end
+
+    # Search accounts for a folder
+    # Searches the portal users and groups that can be given access to the folder with the ID given in the route,  and reports for each of them whether it already has access to that folder.  The caller has to be allowed to manage the access of that folder, and the ID has to belong to an existing  folder, so the operation answers 403 for a folder the caller cannot share and 404 for an ID that matches  nothing.  The search is read-only and needs `filterValue`: while it is empty the operation returns an empty list and a  total of 0 instead of every account, so it cannot be used to enumerate the portal.  `filterValue` is matched case-insensitively against the first name, the last name and the email; without  `filterSeparator` it is split on spaces and every term has to match, and with a separator it is split on that  separator and any term may match.  Matching groups are streamed first and users after them, both paged together by `count` and `startIndex`,  while the number of matches is reported in the total count of the response.  Pass `excludeShared` to keep only the accounts that have no access yet, `includeShared` to keep only those  that already have it, and neither to get both kinds with the `shared` field telling them apart.
+    # See also: https://api.onlyoffice.com/docspace/api-backend/usage-api/get-accounts-entries-with-folders-shared/
+    # @param id [Integer, String] The ID of the room, folder or file whose access the search is run against, taken from the route. It is an  integer for an entry stored in DocSpace and a provider-specific string for an entry in a connected  third-party storage.
+    # @param [Hash] opts the optional parameters
+    # @option opts [EmployeeStatus] :employee_status Keeps only the users in the given account state: `Active` for a working account, `Terminated` for a disabled  one and `Pending` for one that has not accepted its invitation yet. Omit it to search every state.
+    # @option opts [EmployeeActivationStatus] :activation_status Keeps only the users whose activation is in the given state: `NotActivated` for an account that has never  been activated, `Activated` for one that completed the activation, `Pending` for one whose invitation is  still open, and `AutoGenerated` for an account created by the portal itself. Omit it to search every state.
+    # @option opts [Boolean] :exclude_shared Keeps only the accounts that do not have access to the entry yet, which is the set to offer when adding new  members. It takes precedence over `includeShared`, and every returned entry has `shared` set to false.
+    # @option opts [Boolean] :include_shared Keeps only the accounts that already have access to the entry, which is the set to offer when changing or  revoking access. Every returned entry has `shared` set to true, and the flag is ignored when  `excludeShared` is also set.
+    # @option opts [Boolean] :invited_by_me Keeps only the users invited by the caller when true, and only the users invited by somebody else when false.  Omit it to search regardless of who sent the invitation.
+    # @option opts [String] :inviter_id Keeps only the users invited by the account with this ID. Omit it to search regardless of who sent the  invitation.
+    # @option opts [AccountSearchArea] :area The part of the portal to search in: `All`, the default, searches members and guests together, `People`  leaves the guests out, and `Guests` returns guests only - and for a caller who is not a DocSpace  administrator, only the guests that caller is related to.
+    # @option opts [Array<EmployeeType>] :employee_types Keeps only the users of the listed types, combined as alternatives. An empty list, which is the default,  searches every type.
+    # @option opts [Integer] :count The size of the page, counting groups and users together. It defaults to 100, which is also the largest value  the operation accepts.
+    # @option opts [Integer] :start_index The number of matches to skip before the page starts, counted over the groups and users together. It defaults  to 0, and the total number of matches is reported in the total count of the response.
+    # @option opts [String] :filter_separator The character that splits `filterValue` into several terms, of which any one may match. Omit it to split the  value on spaces instead, in which case every term has to match.
+    # @option opts [String] :filter_value The text to search for, matched case-insensitively against the first name, the last name and the email. It is  required in practice: while it is empty the search returns nothing at all rather than every account.
+    # @return [Array<(AccountEntryArrayWrapper, Integer, Hash)>] AccountEntryArrayWrapper data, response status code and response headers
+    def get_accounts_entries_with_folders_shared_with_http_info(id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: People::SearchApi.get_accounts_entries_with_folders_shared ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling People::SearchApi.get_accounts_entries_with_folders_shared"
+      end
+      if @api_client.config.client_side_validation && !opts[:'count'].nil? && opts[:'count'] > 100
+        fail ArgumentError, 'invalid value for "opts[:"count"]" when calling People::SearchApi.get_accounts_entries_with_folders_shared, must be smaller than or equal to 100.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'count'].nil? && opts[:'count'] < 1
+        fail ArgumentError, 'invalid value for "opts[:"count"]" when calling People::SearchApi.get_accounts_entries_with_folders_shared, must be greater than or equal to 1.'
+      end
+
+      # resource path
+      local_var_path = '/api/2.0/accounts/folder/{id}/search'.sub('{' + 'id' + '}', CGI.escape(id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'employeeStatus'] = opts[:'employee_status'] if !opts[:'employee_status'].nil?
+      query_params[:'activationStatus'] = opts[:'activation_status'] if !opts[:'activation_status'].nil?
+      query_params[:'excludeShared'] = opts[:'exclude_shared'] if !opts[:'exclude_shared'].nil?
+      query_params[:'includeShared'] = opts[:'include_shared'] if !opts[:'include_shared'].nil?
+      query_params[:'invitedByMe'] = opts[:'invited_by_me'] if !opts[:'invited_by_me'].nil?
+      query_params[:'inviterId'] = opts[:'inviter_id'] if !opts[:'inviter_id'].nil?
+      query_params[:'area'] = opts[:'area'] if !opts[:'area'].nil?
+      query_params[:'employeeTypes'] = @api_client.build_collection_param(opts[:'employee_types'], :multi) if !opts[:'employee_types'].nil?
+      query_params[:'count'] = opts[:'count'] if !opts[:'count'].nil?
+      query_params[:'startIndex'] = opts[:'start_index'] if !opts[:'start_index'].nil?
+      query_params[:'filterSeparator'] = opts[:'filter_separator'] if !opts[:'filter_separator'].nil?
+      query_params[:'filterValue'] = opts[:'filter_value'] if !opts[:'filter_value'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'AccountEntryArrayWrapper'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['Basic', 'OAuth2', 'ApiKeyBearer', 'asc_auth_key', 'Bearer', 'OpenId']
+
+      new_options = opts.merge(
+        :operation => :"People::SearchApi.get_accounts_entries_with_folders_shared",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: People::SearchApi#get_accounts_entries_with_folders_shared\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Search accounts for a room
+    # Searches the portal users and groups that can be given access to the room with the ID given in the route, and  reports for each of them whether it already has access to that room.  The caller has to be allowed to manage the access of that room, and the ID has to belong to an existing room,  so the operation answers 403 for a room the caller cannot share and 404 for an ID that matches nothing.  The search is read-only and needs `filterValue`: while it is empty the operation returns an empty list and a  total of 0 instead of every account, so it cannot be used to enumerate the portal.  `filterValue` is matched case-insensitively against the first name, the last name and the email; without  `filterSeparator` it is split on spaces and every term has to match, and with a separator it is split on that  separator and any term may match.  Matching groups are streamed first and users after them, both paged together by `count` and `startIndex`,  while the number of matches is reported in the total count of the response.  Pass `excludeShared` to keep only the accounts that have no access yet, `includeShared` to keep only those  that already have it, and neither to get both kinds with the `shared` field telling them apart.
+    # See also: https://api.onlyoffice.com/docspace/api-backend/usage-api/get-accounts-entries-with-rooms-shared/
+    # @param id [Integer, String] The ID of the room, folder or file whose access the search is run against, taken from the route. It is an  integer for an entry stored in DocSpace and a provider-specific string for an entry in a connected  third-party storage.
+    # @param [Hash] opts the optional parameters
+    # @option opts [EmployeeStatus] :employee_status Keeps only the users in the given account state: `Active` for a working account, `Terminated` for a disabled  one and `Pending` for one that has not accepted its invitation yet. Omit it to search every state.
+    # @option opts [EmployeeActivationStatus] :activation_status Keeps only the users whose activation is in the given state: `NotActivated` for an account that has never  been activated, `Activated` for one that completed the activation, `Pending` for one whose invitation is  still open, and `AutoGenerated` for an account created by the portal itself. Omit it to search every state.
+    # @option opts [Boolean] :exclude_shared Keeps only the accounts that do not have access to the entry yet, which is the set to offer when adding new  members. It takes precedence over `includeShared`, and every returned entry has `shared` set to false.
+    # @option opts [Boolean] :include_shared Keeps only the accounts that already have access to the entry, which is the set to offer when changing or  revoking access. Every returned entry has `shared` set to true, and the flag is ignored when  `excludeShared` is also set.
+    # @option opts [Boolean] :invited_by_me Keeps only the users invited by the caller when true, and only the users invited by somebody else when false.  Omit it to search regardless of who sent the invitation.
+    # @option opts [String] :inviter_id Keeps only the users invited by the account with this ID. Omit it to search regardless of who sent the  invitation.
+    # @option opts [AccountSearchArea] :area The part of the portal to search in: `All`, the default, searches members and guests together, `People`  leaves the guests out, and `Guests` returns guests only - and for a caller who is not a DocSpace  administrator, only the guests that caller is related to.
+    # @option opts [Array<EmployeeType>] :employee_types Keeps only the users of the listed types, combined as alternatives. An empty list, which is the default,  searches every type.
+    # @option opts [Integer] :count The size of the page, counting groups and users together. It defaults to 100, which is also the largest value  the operation accepts.
+    # @option opts [Integer] :start_index The number of matches to skip before the page starts, counted over the groups and users together. It defaults  to 0, and the total number of matches is reported in the total count of the response.
+    # @option opts [String] :filter_separator The character that splits `filterValue` into several terms, of which any one may match. Omit it to split the  value on spaces instead, in which case every term has to match.
+    # @option opts [String] :filter_value The text to search for, matched case-insensitively against the first name, the last name and the email. It is  required in practice: while it is empty the search returns nothing at all rather than every account.
+    # @return [AccountEntryArrayWrapper]
+    def get_accounts_entries_with_rooms_shared(id, opts = {})
+      data, _status_code, _headers = get_accounts_entries_with_rooms_shared_with_http_info(id, opts)
+      data
+    end
+
+    # Search accounts for a room
+    # Searches the portal users and groups that can be given access to the room with the ID given in the route, and  reports for each of them whether it already has access to that room.  The caller has to be allowed to manage the access of that room, and the ID has to belong to an existing room,  so the operation answers 403 for a room the caller cannot share and 404 for an ID that matches nothing.  The search is read-only and needs `filterValue`: while it is empty the operation returns an empty list and a  total of 0 instead of every account, so it cannot be used to enumerate the portal.  `filterValue` is matched case-insensitively against the first name, the last name and the email; without  `filterSeparator` it is split on spaces and every term has to match, and with a separator it is split on that  separator and any term may match.  Matching groups are streamed first and users after them, both paged together by `count` and `startIndex`,  while the number of matches is reported in the total count of the response.  Pass `excludeShared` to keep only the accounts that have no access yet, `includeShared` to keep only those  that already have it, and neither to get both kinds with the `shared` field telling them apart.
+    # See also: https://api.onlyoffice.com/docspace/api-backend/usage-api/get-accounts-entries-with-rooms-shared/
+    # @param id [Integer, String] The ID of the room, folder or file whose access the search is run against, taken from the route. It is an  integer for an entry stored in DocSpace and a provider-specific string for an entry in a connected  third-party storage.
+    # @param [Hash] opts the optional parameters
+    # @option opts [EmployeeStatus] :employee_status Keeps only the users in the given account state: `Active` for a working account, `Terminated` for a disabled  one and `Pending` for one that has not accepted its invitation yet. Omit it to search every state.
+    # @option opts [EmployeeActivationStatus] :activation_status Keeps only the users whose activation is in the given state: `NotActivated` for an account that has never  been activated, `Activated` for one that completed the activation, `Pending` for one whose invitation is  still open, and `AutoGenerated` for an account created by the portal itself. Omit it to search every state.
+    # @option opts [Boolean] :exclude_shared Keeps only the accounts that do not have access to the entry yet, which is the set to offer when adding new  members. It takes precedence over `includeShared`, and every returned entry has `shared` set to false.
+    # @option opts [Boolean] :include_shared Keeps only the accounts that already have access to the entry, which is the set to offer when changing or  revoking access. Every returned entry has `shared` set to true, and the flag is ignored when  `excludeShared` is also set.
+    # @option opts [Boolean] :invited_by_me Keeps only the users invited by the caller when true, and only the users invited by somebody else when false.  Omit it to search regardless of who sent the invitation.
+    # @option opts [String] :inviter_id Keeps only the users invited by the account with this ID. Omit it to search regardless of who sent the  invitation.
+    # @option opts [AccountSearchArea] :area The part of the portal to search in: `All`, the default, searches members and guests together, `People`  leaves the guests out, and `Guests` returns guests only - and for a caller who is not a DocSpace  administrator, only the guests that caller is related to.
+    # @option opts [Array<EmployeeType>] :employee_types Keeps only the users of the listed types, combined as alternatives. An empty list, which is the default,  searches every type.
+    # @option opts [Integer] :count The size of the page, counting groups and users together. It defaults to 100, which is also the largest value  the operation accepts.
+    # @option opts [Integer] :start_index The number of matches to skip before the page starts, counted over the groups and users together. It defaults  to 0, and the total number of matches is reported in the total count of the response.
+    # @option opts [String] :filter_separator The character that splits `filterValue` into several terms, of which any one may match. Omit it to split the  value on spaces instead, in which case every term has to match.
+    # @option opts [String] :filter_value The text to search for, matched case-insensitively against the first name, the last name and the email. It is  required in practice: while it is empty the search returns nothing at all rather than every account.
+    # @return [Array<(AccountEntryArrayWrapper, Integer, Hash)>] AccountEntryArrayWrapper data, response status code and response headers
+    def get_accounts_entries_with_rooms_shared_with_http_info(id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: People::SearchApi.get_accounts_entries_with_rooms_shared ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling People::SearchApi.get_accounts_entries_with_rooms_shared"
+      end
+      if @api_client.config.client_side_validation && !opts[:'count'].nil? && opts[:'count'] > 100
+        fail ArgumentError, 'invalid value for "opts[:"count"]" when calling People::SearchApi.get_accounts_entries_with_rooms_shared, must be smaller than or equal to 100.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'count'].nil? && opts[:'count'] < 1
+        fail ArgumentError, 'invalid value for "opts[:"count"]" when calling People::SearchApi.get_accounts_entries_with_rooms_shared, must be greater than or equal to 1.'
+      end
+
+      # resource path
+      local_var_path = '/api/2.0/accounts/room/{id}/search'.sub('{' + 'id' + '}', CGI.escape(id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'employeeStatus'] = opts[:'employee_status'] if !opts[:'employee_status'].nil?
+      query_params[:'activationStatus'] = opts[:'activation_status'] if !opts[:'activation_status'].nil?
+      query_params[:'excludeShared'] = opts[:'exclude_shared'] if !opts[:'exclude_shared'].nil?
+      query_params[:'includeShared'] = opts[:'include_shared'] if !opts[:'include_shared'].nil?
+      query_params[:'invitedByMe'] = opts[:'invited_by_me'] if !opts[:'invited_by_me'].nil?
+      query_params[:'inviterId'] = opts[:'inviter_id'] if !opts[:'inviter_id'].nil?
+      query_params[:'area'] = opts[:'area'] if !opts[:'area'].nil?
+      query_params[:'employeeTypes'] = @api_client.build_collection_param(opts[:'employee_types'], :multi) if !opts[:'employee_types'].nil?
+      query_params[:'count'] = opts[:'count'] if !opts[:'count'].nil?
+      query_params[:'startIndex'] = opts[:'start_index'] if !opts[:'start_index'].nil?
+      query_params[:'filterSeparator'] = opts[:'filter_separator'] if !opts[:'filter_separator'].nil?
+      query_params[:'filterValue'] = opts[:'filter_value'] if !opts[:'filter_value'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'AccountEntryArrayWrapper'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['Basic', 'OAuth2', 'ApiKeyBearer', 'asc_auth_key', 'Bearer', 'OpenId']
+
+      new_options = opts.merge(
+        :operation => :"People::SearchApi.get_accounts_entries_with_rooms_shared",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: People::SearchApi#get_accounts_entries_with_rooms_shared\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Search users
+    # Searches the active accounts of the portal by a term taken from the path, and is the same search as  `GET api/2.0/people/search`, which takes the term in the query string instead.  Only a DocSpace administrator may call it; every other account, including a room admin, gets 403.  Only accounts with the `Active` status are searched, so a pending invitation and a disabled account are never  found - use `GET api/2.0/people/filter` to search across states.  The call is read-only and is not paged: every match is streamed, without a total.  `filterBy` set to `group` turns `text` into a group ID and keeps only the members of that group, so `text`  then has to be a valid identifier.  The answer holds full profiles.
+    # See also: https://api.onlyoffice.com/docspace/api-backend/usage-api/get-search/
+    # @param query [String] The term to look for, taken from the route. Only accounts with the `Active` status are searched.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :filter_by The only recognised value is `group`, which turns `filterValue` into a group ID and keeps only the members of  that group. Any other value, and omitting the field, applies no group filter.
+    # @option opts [String] :filter_value The group ID to keep the members of, used only when `filterBy` is `group`. It has to be a valid identifier -  a group name is not accepted.
+    # @return [EmployeeFullArrayWrapper]
+    def get_search(query, opts = {})
+      data, _status_code, _headers = get_search_with_http_info(query, opts)
+      data
+    end
+
+    # Search users
+    # Searches the active accounts of the portal by a term taken from the path, and is the same search as  `GET api/2.0/people/search`, which takes the term in the query string instead.  Only a DocSpace administrator may call it; every other account, including a room admin, gets 403.  Only accounts with the `Active` status are searched, so a pending invitation and a disabled account are never  found - use `GET api/2.0/people/filter` to search across states.  The call is read-only and is not paged: every match is streamed, without a total.  `filterBy` set to `group` turns `text` into a group ID and keeps only the members of that group, so `text`  then has to be a valid identifier.  The answer holds full profiles.
+    # See also: https://api.onlyoffice.com/docspace/api-backend/usage-api/get-search/
+    # @param query [String] The term to look for, taken from the route. Only accounts with the `Active` status are searched.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :filter_by The only recognised value is `group`, which turns `filterValue` into a group ID and keeps only the members of  that group. Any other value, and omitting the field, applies no group filter.
+    # @option opts [String] :filter_value The group ID to keep the members of, used only when `filterBy` is `group`. It has to be a valid identifier -  a group name is not accepted.
+    # @return [Array<(EmployeeFullArrayWrapper, Integer, Hash)>] EmployeeFullArrayWrapper data, response status code and response headers
+    def get_search_with_http_info(query, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: People::SearchApi.get_search ...'
+      end
+      # verify the required parameter 'query' is set
+      if @api_client.config.client_side_validation && query.nil?
+        fail ArgumentError, "Missing the required parameter 'query' when calling People::SearchApi.get_search"
+      end
+      # resource path
+      local_var_path = '/api/2.0/people/@search/{query}'.sub('{' + 'query' + '}', CGI.escape(query.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'filterBy'] = opts[:'filter_by'] if !opts[:'filter_by'].nil?
+      query_params[:'filterValue'] = opts[:'filter_value'] if !opts[:'filter_value'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'EmployeeFullArrayWrapper'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['Basic', 'OAuth2', 'ApiKeyBearer', 'asc_auth_key', 'Bearer', 'OpenId']
+
+      new_options = opts.merge(
+        :operation => :"People::SearchApi.get_search",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: People::SearchApi#get_search\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Filter users in brief
+    # Returns a page of portal accounts selected by the full set of account filters, with the short profile of each  of them - the identifying fields, the avatar and the display name, without the contacts, the groups or the  quota.  The caller has to be a room admin, a DocSpace admin or a People module admin; a member or a guest gets 403.  The call is read-only, paged by `count` and `startIndex`, ordered by `sortBy` and `sortOrder`, and reports  the number of matches in the total count of the response.  It accepts exactly the same filters as `GET api/2.0/people/filter` and differs only in how much of each  profile comes back, so prefer this one for pickers, mentions and any list that shows names, and switch to the  other only when the full profile is needed.  Filters combine as conditions that all have to hold, and the same interactions apply: `withoutGroup` makes  `groupId` irrelevant, `employeeType` wins over `employeeTypes`, and `area` cancels the type filters that  contradict it.
+    # See also: https://api.onlyoffice.com/docspace/api-backend/usage-api/get-simple-by-filter/
+    # @param [Hash] opts the optional parameters
+    # @option opts [EmployeeStatus] :employee_status Keeps only the accounts in the given state: `Active` for working accounts, `Terminated` for disabled ones  and `Pending` for open invitations. Omit it to search every state.
+    # @option opts [String] :group_id Keeps only the members of this group, or excludes them when `excludeGroup` is true. It is ignored when  `withoutGroup` is set.
+    # @option opts [EmployeeActivationStatus] :activation_status Keeps only the accounts whose activation is in the given state: `NotActivated`, `Activated`, `Pending` or  `AutoGenerated`. Omit it to search every state.
+    # @option opts [EmployeeType] :employee_type Keeps only the accounts of this single type: `DocSpaceAdmin`, `RoomAdmin`, `User` or `Guest`. When it is  sent it wins over `employeeTypes`, and a type that contradicts `area` is dropped.
+    # @option opts [Array<Integer>] :employee_types Keeps the accounts of any of the listed types, combined as alternatives. It is ignored when `employeeType`  is also sent.
+    # @option opts [Boolean] :is_administrator Set it to true to keep only the DocSpace administrators and the module administrators. Setting it to false  is the same as omitting it and does not exclude administrators.
+    # @option opts [Payments] :payments Keeps only the accounts that take a paid seat when `Paid`, or only the guests and members that do not when  `Free`. Omit it to search both.
+    # @option opts [AccountLoginType] :account_login_type Keeps only the accounts that sign in this way: `SSO`, `LDAP`, or `Standart` for an ordinary portal  password. Omit it to search all of them.
+    # @option opts [QuotaFilter] :quota_filter Keeps only the accounts whose storage quota is the portal default when `Default`, or set individually when  `Custom`. `All`, which is the same as omitting the field, searches both.
+    # @option opts [Boolean] :without_group Set it to true to keep only the accounts that belong to no group at all, which makes `groupId` and  `excludeGroup` irrelevant.
+    # @option opts [Boolean] :exclude_group Inverts `groupId`: with true the members of that group are left out instead of being the only ones kept. It  has no effect without `groupId`.
+    # @option opts [Boolean] :invited_by_me Keeps only the accounts invited by the caller when true, and only those invited by somebody else when  false. Omit it to search regardless of who sent the invitation.
+    # @option opts [String] :inviter_id Keeps only the accounts invited by the account with this ID. Omit it to search regardless of who sent the  invitation.
+    # @option opts [AccountSearchArea] :area The part of the portal to search in: `All`, the default, searches members and guests together, `People`  leaves the guests out, and `Guests` returns guests only. It also cancels the type filters that contradict  it.
+    # @option opts [Integer] :count The size of the page. It defaults to 100, which is also the largest value the operation accepts.
+    # @option opts [Integer] :start_index The number of matches to skip before the page starts. It defaults to 0, and the total number of matches is  reported in the total count of the response.
+    # @option opts [String] :sort_by What to order the accounts by, compared without regard to case: `FirstName`, `LastName`, `DisplayName`,  `Type`, `Email`, `Department`, `UsedSpace`, `CreatedBy` or `RegistrationDate`.
+    # @option opts [SortOrder] :sort_order The direction of the ordering: `Ascending`, which is the default, or `Descending`.
+    # @option opts [String] :filter_separator The character that splits `filterValue` into several terms, of which any one may match. Omit it to split  the value on spaces instead, in which case every term has to match.
+    # @option opts [String] :filter_value The text to match against the first name, the last name and the email, case-insensitively. Omit it to apply  no text filter at all.
+    # @return [EmployeeArrayWrapper]
+    def get_simple_by_filter(opts = {})
+      data, _status_code, _headers = get_simple_by_filter_with_http_info(opts)
+      data
+    end
+
+    # Filter users in brief
+    # Returns a page of portal accounts selected by the full set of account filters, with the short profile of each  of them - the identifying fields, the avatar and the display name, without the contacts, the groups or the  quota.  The caller has to be a room admin, a DocSpace admin or a People module admin; a member or a guest gets 403.  The call is read-only, paged by `count` and `startIndex`, ordered by `sortBy` and `sortOrder`, and reports  the number of matches in the total count of the response.  It accepts exactly the same filters as `GET api/2.0/people/filter` and differs only in how much of each  profile comes back, so prefer this one for pickers, mentions and any list that shows names, and switch to the  other only when the full profile is needed.  Filters combine as conditions that all have to hold, and the same interactions apply: `withoutGroup` makes  `groupId` irrelevant, `employeeType` wins over `employeeTypes`, and `area` cancels the type filters that  contradict it.
+    # See also: https://api.onlyoffice.com/docspace/api-backend/usage-api/get-simple-by-filter/
+    # @param [Hash] opts the optional parameters
+    # @option opts [EmployeeStatus] :employee_status Keeps only the accounts in the given state: `Active` for working accounts, `Terminated` for disabled ones  and `Pending` for open invitations. Omit it to search every state.
+    # @option opts [String] :group_id Keeps only the members of this group, or excludes them when `excludeGroup` is true. It is ignored when  `withoutGroup` is set.
+    # @option opts [EmployeeActivationStatus] :activation_status Keeps only the accounts whose activation is in the given state: `NotActivated`, `Activated`, `Pending` or  `AutoGenerated`. Omit it to search every state.
+    # @option opts [EmployeeType] :employee_type Keeps only the accounts of this single type: `DocSpaceAdmin`, `RoomAdmin`, `User` or `Guest`. When it is  sent it wins over `employeeTypes`, and a type that contradicts `area` is dropped.
+    # @option opts [Array<Integer>] :employee_types Keeps the accounts of any of the listed types, combined as alternatives. It is ignored when `employeeType`  is also sent.
+    # @option opts [Boolean] :is_administrator Set it to true to keep only the DocSpace administrators and the module administrators. Setting it to false  is the same as omitting it and does not exclude administrators.
+    # @option opts [Payments] :payments Keeps only the accounts that take a paid seat when `Paid`, or only the guests and members that do not when  `Free`. Omit it to search both.
+    # @option opts [AccountLoginType] :account_login_type Keeps only the accounts that sign in this way: `SSO`, `LDAP`, or `Standart` for an ordinary portal  password. Omit it to search all of them.
+    # @option opts [QuotaFilter] :quota_filter Keeps only the accounts whose storage quota is the portal default when `Default`, or set individually when  `Custom`. `All`, which is the same as omitting the field, searches both.
+    # @option opts [Boolean] :without_group Set it to true to keep only the accounts that belong to no group at all, which makes `groupId` and  `excludeGroup` irrelevant.
+    # @option opts [Boolean] :exclude_group Inverts `groupId`: with true the members of that group are left out instead of being the only ones kept. It  has no effect without `groupId`.
+    # @option opts [Boolean] :invited_by_me Keeps only the accounts invited by the caller when true, and only those invited by somebody else when  false. Omit it to search regardless of who sent the invitation.
+    # @option opts [String] :inviter_id Keeps only the accounts invited by the account with this ID. Omit it to search regardless of who sent the  invitation.
+    # @option opts [AccountSearchArea] :area The part of the portal to search in: `All`, the default, searches members and guests together, `People`  leaves the guests out, and `Guests` returns guests only. It also cancels the type filters that contradict  it.
+    # @option opts [Integer] :count The size of the page. It defaults to 100, which is also the largest value the operation accepts.
+    # @option opts [Integer] :start_index The number of matches to skip before the page starts. It defaults to 0, and the total number of matches is  reported in the total count of the response.
+    # @option opts [String] :sort_by What to order the accounts by, compared without regard to case: `FirstName`, `LastName`, `DisplayName`,  `Type`, `Email`, `Department`, `UsedSpace`, `CreatedBy` or `RegistrationDate`.
+    # @option opts [SortOrder] :sort_order The direction of the ordering: `Ascending`, which is the default, or `Descending`.
+    # @option opts [String] :filter_separator The character that splits `filterValue` into several terms, of which any one may match. Omit it to split  the value on spaces instead, in which case every term has to match.
+    # @option opts [String] :filter_value The text to match against the first name, the last name and the email, case-insensitively. Omit it to apply  no text filter at all.
+    # @return [Array<(EmployeeArrayWrapper, Integer, Hash)>] EmployeeArrayWrapper data, response status code and response headers
+    def get_simple_by_filter_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: People::SearchApi.get_simple_by_filter ...'
+      end
+      allowable_values = [0, 1, 2, 3, 4]
+      if @api_client.config.client_side_validation && opts[:'employee_types'] && !opts[:'employee_types'].all? { |item| allowable_values.include?(item) }
+        fail ArgumentError, "invalid value for \"employee_types\", must include one of #{allowable_values}"
+      end
+      if @api_client.config.client_side_validation && !opts[:'count'].nil? && opts[:'count'] > 100
+        fail ArgumentError, 'invalid value for "opts[:"count"]" when calling People::SearchApi.get_simple_by_filter, must be smaller than or equal to 100.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'count'].nil? && opts[:'count'] < 1
+        fail ArgumentError, 'invalid value for "opts[:"count"]" when calling People::SearchApi.get_simple_by_filter, must be greater than or equal to 1.'
+      end
+
+      # resource path
+      local_var_path = '/api/2.0/people/simple/filter'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'employeeStatus'] = opts[:'employee_status'] if !opts[:'employee_status'].nil?
+      query_params[:'groupId'] = opts[:'group_id'] if !opts[:'group_id'].nil?
+      query_params[:'activationStatus'] = opts[:'activation_status'] if !opts[:'activation_status'].nil?
+      query_params[:'employeeType'] = opts[:'employee_type'] if !opts[:'employee_type'].nil?
+      query_params[:'employeeTypes'] = @api_client.build_collection_param(opts[:'employee_types'], :multi) if !opts[:'employee_types'].nil?
+      query_params[:'isAdministrator'] = opts[:'is_administrator'] if !opts[:'is_administrator'].nil?
+      query_params[:'payments'] = opts[:'payments'] if !opts[:'payments'].nil?
+      query_params[:'accountLoginType'] = opts[:'account_login_type'] if !opts[:'account_login_type'].nil?
+      query_params[:'quotaFilter'] = opts[:'quota_filter'] if !opts[:'quota_filter'].nil?
+      query_params[:'withoutGroup'] = opts[:'without_group'] if !opts[:'without_group'].nil?
+      query_params[:'excludeGroup'] = opts[:'exclude_group'] if !opts[:'exclude_group'].nil?
+      query_params[:'invitedByMe'] = opts[:'invited_by_me'] if !opts[:'invited_by_me'].nil?
+      query_params[:'inviterId'] = opts[:'inviter_id'] if !opts[:'inviter_id'].nil?
+      query_params[:'area'] = opts[:'area'] if !opts[:'area'].nil?
+      query_params[:'count'] = opts[:'count'] if !opts[:'count'].nil?
+      query_params[:'startIndex'] = opts[:'start_index'] if !opts[:'start_index'].nil?
+      query_params[:'sortBy'] = opts[:'sort_by'] if !opts[:'sort_by'].nil?
+      query_params[:'sortOrder'] = opts[:'sort_order'] if !opts[:'sort_order'].nil?
+      query_params[:'filterSeparator'] = opts[:'filter_separator'] if !opts[:'filter_separator'].nil?
+      query_params[:'filterValue'] = opts[:'filter_value'] if !opts[:'filter_value'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'EmployeeArrayWrapper'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['Basic', 'OAuth2', 'ApiKeyBearer', 'asc_auth_key', 'Bearer', 'OpenId']
+
+      new_options = opts.merge(
+        :operation => :"People::SearchApi.get_simple_by_filter",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: People::SearchApi#get_simple_by_filter\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Search users for a file
+    # Returns the accounts that are relevant to the file with the ID given in the route, and reports for each of  them whether it already has access to that file.  The caller only needs read access to the file, not the right to manage its access, but a guest may not call  it at all; an ID that matches no file answers 404.  The call is read-only, works without a filter - leaving `filterValue` empty returns every matching account  rather than nothing - and is paged by `count` and `startIndex`, with the number of matches in the total count  of the response.  Pass `excludeShared` to keep only the accounts that have no access yet, `includeShared` to keep only those  that already have it, and neither to get both kinds with the `shared` field telling them apart.  A DocSpace administrator additionally sees the guests that are not related to the caller.  To search users and groups together, or to build an access dialog that needs the right to manage sharing, use  `GET api/2.0/accounts/file/{id}/search` instead.
+    # See also: https://api.onlyoffice.com/docspace/api-backend/usage-api/get-users-with-files-shared/
+    # @param id [Integer, String] The ID of the room, folder or file the search is run against, taken from the route. It is an integer for an  entry stored in DocSpace and a provider-specific string for an entry in a connected third-party storage.
+    # @param [Hash] opts the optional parameters
+    # @option opts [EmployeeStatus] :employee_status Keeps only the accounts in the given state: `Active` for working accounts, `Terminated` for disabled ones  and `Pending` for open invitations. Omit it to search every state.
+    # @option opts [EmployeeActivationStatus] :activation_status Keeps only the accounts whose activation is in the given state: `NotActivated`, `Activated`, `Pending` or  `AutoGenerated`. Omit it to search every state.
+    # @option opts [Boolean] :exclude_shared Keeps only the accounts that do not have access to the entry yet, which is the set to offer when granting  access. It takes precedence over `includeShared`, and every returned entry has `shared` set to false.
+    # @option opts [Boolean] :include_shared Keeps only the accounts that already have access to the entry, which is the set to offer when changing or  revoking access. Every returned entry has `shared` set to true, and the flag is ignored when `excludeShared`  is also set.
+    # @option opts [Boolean] :invited_by_me Keeps only the accounts invited by the caller when true, and only those invited by somebody else when  false. Omit it to search regardless of who sent the invitation.
+    # @option opts [String] :inviter_id Keeps only the accounts invited by the account with this ID. Omit it to search regardless of who sent the  invitation.
+    # @option opts [AccountSearchArea] :area The part of the portal to search in: `All`, the default, searches members and guests together, `People`  leaves the guests out, and `Guests` returns guests only - and for a caller who is not a DocSpace  administrator, only the guests that caller is related to.
+    # @option opts [Array<EmployeeType>] :employee_types Keeps only the accounts of the listed types, combined as alternatives. An empty list, which is the default,  searches every type.
+    # @option opts [Integer] :count The size of the page. It defaults to 100, which is also the largest value the operation accepts.
+    # @option opts [Integer] :start_index The number of matches to skip before the page starts. It defaults to 0, and the total number of matches is  reported in the total count of the response.
+    # @option opts [String] :filter_separator The character that splits `filterValue` into several terms, of which any one may match. Omit it to split the  value on spaces instead, in which case every term has to match.
+    # @option opts [String] :filter_value The text to match against the first name, the last name and the email, case-insensitively. Omit it to get  every account the caller may offer access to.
+    # @return [EmployeeFullArrayWrapper]
+    def get_users_with_files_shared(id, opts = {})
+      data, _status_code, _headers = get_users_with_files_shared_with_http_info(id, opts)
+      data
+    end
+
+    # Search users for a file
+    # Returns the accounts that are relevant to the file with the ID given in the route, and reports for each of  them whether it already has access to that file.  The caller only needs read access to the file, not the right to manage its access, but a guest may not call  it at all; an ID that matches no file answers 404.  The call is read-only, works without a filter - leaving `filterValue` empty returns every matching account  rather than nothing - and is paged by `count` and `startIndex`, with the number of matches in the total count  of the response.  Pass `excludeShared` to keep only the accounts that have no access yet, `includeShared` to keep only those  that already have it, and neither to get both kinds with the `shared` field telling them apart.  A DocSpace administrator additionally sees the guests that are not related to the caller.  To search users and groups together, or to build an access dialog that needs the right to manage sharing, use  `GET api/2.0/accounts/file/{id}/search` instead.
+    # See also: https://api.onlyoffice.com/docspace/api-backend/usage-api/get-users-with-files-shared/
+    # @param id [Integer, String] The ID of the room, folder or file the search is run against, taken from the route. It is an integer for an  entry stored in DocSpace and a provider-specific string for an entry in a connected third-party storage.
+    # @param [Hash] opts the optional parameters
+    # @option opts [EmployeeStatus] :employee_status Keeps only the accounts in the given state: `Active` for working accounts, `Terminated` for disabled ones  and `Pending` for open invitations. Omit it to search every state.
+    # @option opts [EmployeeActivationStatus] :activation_status Keeps only the accounts whose activation is in the given state: `NotActivated`, `Activated`, `Pending` or  `AutoGenerated`. Omit it to search every state.
+    # @option opts [Boolean] :exclude_shared Keeps only the accounts that do not have access to the entry yet, which is the set to offer when granting  access. It takes precedence over `includeShared`, and every returned entry has `shared` set to false.
+    # @option opts [Boolean] :include_shared Keeps only the accounts that already have access to the entry, which is the set to offer when changing or  revoking access. Every returned entry has `shared` set to true, and the flag is ignored when `excludeShared`  is also set.
+    # @option opts [Boolean] :invited_by_me Keeps only the accounts invited by the caller when true, and only those invited by somebody else when  false. Omit it to search regardless of who sent the invitation.
+    # @option opts [String] :inviter_id Keeps only the accounts invited by the account with this ID. Omit it to search regardless of who sent the  invitation.
+    # @option opts [AccountSearchArea] :area The part of the portal to search in: `All`, the default, searches members and guests together, `People`  leaves the guests out, and `Guests` returns guests only - and for a caller who is not a DocSpace  administrator, only the guests that caller is related to.
+    # @option opts [Array<EmployeeType>] :employee_types Keeps only the accounts of the listed types, combined as alternatives. An empty list, which is the default,  searches every type.
+    # @option opts [Integer] :count The size of the page. It defaults to 100, which is also the largest value the operation accepts.
+    # @option opts [Integer] :start_index The number of matches to skip before the page starts. It defaults to 0, and the total number of matches is  reported in the total count of the response.
+    # @option opts [String] :filter_separator The character that splits `filterValue` into several terms, of which any one may match. Omit it to split the  value on spaces instead, in which case every term has to match.
+    # @option opts [String] :filter_value The text to match against the first name, the last name and the email, case-insensitively. Omit it to get  every account the caller may offer access to.
+    # @return [Array<(EmployeeFullArrayWrapper, Integer, Hash)>] EmployeeFullArrayWrapper data, response status code and response headers
+    def get_users_with_files_shared_with_http_info(id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: People::SearchApi.get_users_with_files_shared ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling People::SearchApi.get_users_with_files_shared"
+      end
+      if @api_client.config.client_side_validation && !opts[:'count'].nil? && opts[:'count'] > 100
+        fail ArgumentError, 'invalid value for "opts[:"count"]" when calling People::SearchApi.get_users_with_files_shared, must be smaller than or equal to 100.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'count'].nil? && opts[:'count'] < 1
+        fail ArgumentError, 'invalid value for "opts[:"count"]" when calling People::SearchApi.get_users_with_files_shared, must be greater than or equal to 1.'
+      end
+
+      # resource path
+      local_var_path = '/api/2.0/people/file/{id}'.sub('{' + 'id' + '}', CGI.escape(id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'employeeStatus'] = opts[:'employee_status'] if !opts[:'employee_status'].nil?
+      query_params[:'activationStatus'] = opts[:'activation_status'] if !opts[:'activation_status'].nil?
+      query_params[:'excludeShared'] = opts[:'exclude_shared'] if !opts[:'exclude_shared'].nil?
+      query_params[:'includeShared'] = opts[:'include_shared'] if !opts[:'include_shared'].nil?
+      query_params[:'invitedByMe'] = opts[:'invited_by_me'] if !opts[:'invited_by_me'].nil?
+      query_params[:'inviterId'] = opts[:'inviter_id'] if !opts[:'inviter_id'].nil?
+      query_params[:'area'] = opts[:'area'] if !opts[:'area'].nil?
+      query_params[:'employeeTypes'] = @api_client.build_collection_param(opts[:'employee_types'], :multi) if !opts[:'employee_types'].nil?
+      query_params[:'count'] = opts[:'count'] if !opts[:'count'].nil?
+      query_params[:'startIndex'] = opts[:'start_index'] if !opts[:'start_index'].nil?
+      query_params[:'filterSeparator'] = opts[:'filter_separator'] if !opts[:'filter_separator'].nil?
+      query_params[:'filterValue'] = opts[:'filter_value'] if !opts[:'filter_value'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'EmployeeFullArrayWrapper'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['Basic', 'OAuth2', 'ApiKeyBearer', 'asc_auth_key', 'Bearer', 'OpenId']
+
+      new_options = opts.merge(
+        :operation => :"People::SearchApi.get_users_with_files_shared",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: People::SearchApi#get_users_with_files_shared\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Search users for a folder
+    # Returns the accounts that are relevant to the folder with the ID given in the route, and reports for each of  them whether it already has access to that folder.  The caller only needs read access to the folder, not the right to manage its access, but a guest may not call  it at all; an ID that matches no folder answers 404.  The call is read-only, works without a filter - leaving `filterValue` empty returns every matching account  rather than nothing - and is paged by `count` and `startIndex`, with the number of matches in the total count  of the response.  Pass `excludeShared` to keep only the accounts that have no access yet, `includeShared` to keep only those  that already have it, and neither to get both kinds with the `shared` field telling them apart.  A DocSpace administrator additionally sees the guests that are not related to the caller.  To search users and groups together, or to build an access dialog that needs the right to manage sharing, use  `GET api/2.0/accounts/folder/{id}/search` instead.
+    # See also: https://api.onlyoffice.com/docspace/api-backend/usage-api/get-users-with-folders-shared/
+    # @param id [Integer, String] The ID of the room, folder or file the search is run against, taken from the route. It is an integer for an  entry stored in DocSpace and a provider-specific string for an entry in a connected third-party storage.
+    # @param [Hash] opts the optional parameters
+    # @option opts [EmployeeStatus] :employee_status Keeps only the accounts in the given state: `Active` for working accounts, `Terminated` for disabled ones  and `Pending` for open invitations. Omit it to search every state.
+    # @option opts [EmployeeActivationStatus] :activation_status Keeps only the accounts whose activation is in the given state: `NotActivated`, `Activated`, `Pending` or  `AutoGenerated`. Omit it to search every state.
+    # @option opts [Boolean] :exclude_shared Keeps only the accounts that do not have access to the entry yet, which is the set to offer when granting  access. It takes precedence over `includeShared`, and every returned entry has `shared` set to false.
+    # @option opts [Boolean] :include_shared Keeps only the accounts that already have access to the entry, which is the set to offer when changing or  revoking access. Every returned entry has `shared` set to true, and the flag is ignored when `excludeShared`  is also set.
+    # @option opts [Boolean] :invited_by_me Keeps only the accounts invited by the caller when true, and only those invited by somebody else when  false. Omit it to search regardless of who sent the invitation.
+    # @option opts [String] :inviter_id Keeps only the accounts invited by the account with this ID. Omit it to search regardless of who sent the  invitation.
+    # @option opts [AccountSearchArea] :area The part of the portal to search in: `All`, the default, searches members and guests together, `People`  leaves the guests out, and `Guests` returns guests only - and for a caller who is not a DocSpace  administrator, only the guests that caller is related to.
+    # @option opts [Array<EmployeeType>] :employee_types Keeps only the accounts of the listed types, combined as alternatives. An empty list, which is the default,  searches every type.
+    # @option opts [Integer] :count The size of the page. It defaults to 100, which is also the largest value the operation accepts.
+    # @option opts [Integer] :start_index The number of matches to skip before the page starts. It defaults to 0, and the total number of matches is  reported in the total count of the response.
+    # @option opts [String] :filter_separator The character that splits `filterValue` into several terms, of which any one may match. Omit it to split the  value on spaces instead, in which case every term has to match.
+    # @option opts [String] :filter_value The text to match against the first name, the last name and the email, case-insensitively. Omit it to get  every account the caller may offer access to.
+    # @return [EmployeeFullArrayWrapper]
+    def get_users_with_folders_shared(id, opts = {})
+      data, _status_code, _headers = get_users_with_folders_shared_with_http_info(id, opts)
+      data
+    end
+
+    # Search users for a folder
+    # Returns the accounts that are relevant to the folder with the ID given in the route, and reports for each of  them whether it already has access to that folder.  The caller only needs read access to the folder, not the right to manage its access, but a guest may not call  it at all; an ID that matches no folder answers 404.  The call is read-only, works without a filter - leaving `filterValue` empty returns every matching account  rather than nothing - and is paged by `count` and `startIndex`, with the number of matches in the total count  of the response.  Pass `excludeShared` to keep only the accounts that have no access yet, `includeShared` to keep only those  that already have it, and neither to get both kinds with the `shared` field telling them apart.  A DocSpace administrator additionally sees the guests that are not related to the caller.  To search users and groups together, or to build an access dialog that needs the right to manage sharing, use  `GET api/2.0/accounts/folder/{id}/search` instead.
+    # See also: https://api.onlyoffice.com/docspace/api-backend/usage-api/get-users-with-folders-shared/
+    # @param id [Integer, String] The ID of the room, folder or file the search is run against, taken from the route. It is an integer for an  entry stored in DocSpace and a provider-specific string for an entry in a connected third-party storage.
+    # @param [Hash] opts the optional parameters
+    # @option opts [EmployeeStatus] :employee_status Keeps only the accounts in the given state: `Active` for working accounts, `Terminated` for disabled ones  and `Pending` for open invitations. Omit it to search every state.
+    # @option opts [EmployeeActivationStatus] :activation_status Keeps only the accounts whose activation is in the given state: `NotActivated`, `Activated`, `Pending` or  `AutoGenerated`. Omit it to search every state.
+    # @option opts [Boolean] :exclude_shared Keeps only the accounts that do not have access to the entry yet, which is the set to offer when granting  access. It takes precedence over `includeShared`, and every returned entry has `shared` set to false.
+    # @option opts [Boolean] :include_shared Keeps only the accounts that already have access to the entry, which is the set to offer when changing or  revoking access. Every returned entry has `shared` set to true, and the flag is ignored when `excludeShared`  is also set.
+    # @option opts [Boolean] :invited_by_me Keeps only the accounts invited by the caller when true, and only those invited by somebody else when  false. Omit it to search regardless of who sent the invitation.
+    # @option opts [String] :inviter_id Keeps only the accounts invited by the account with this ID. Omit it to search regardless of who sent the  invitation.
+    # @option opts [AccountSearchArea] :area The part of the portal to search in: `All`, the default, searches members and guests together, `People`  leaves the guests out, and `Guests` returns guests only - and for a caller who is not a DocSpace  administrator, only the guests that caller is related to.
+    # @option opts [Array<EmployeeType>] :employee_types Keeps only the accounts of the listed types, combined as alternatives. An empty list, which is the default,  searches every type.
+    # @option opts [Integer] :count The size of the page. It defaults to 100, which is also the largest value the operation accepts.
+    # @option opts [Integer] :start_index The number of matches to skip before the page starts. It defaults to 0, and the total number of matches is  reported in the total count of the response.
+    # @option opts [String] :filter_separator The character that splits `filterValue` into several terms, of which any one may match. Omit it to split the  value on spaces instead, in which case every term has to match.
+    # @option opts [String] :filter_value The text to match against the first name, the last name and the email, case-insensitively. Omit it to get  every account the caller may offer access to.
+    # @return [Array<(EmployeeFullArrayWrapper, Integer, Hash)>] EmployeeFullArrayWrapper data, response status code and response headers
+    def get_users_with_folders_shared_with_http_info(id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: People::SearchApi.get_users_with_folders_shared ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling People::SearchApi.get_users_with_folders_shared"
+      end
+      if @api_client.config.client_side_validation && !opts[:'count'].nil? && opts[:'count'] > 100
+        fail ArgumentError, 'invalid value for "opts[:"count"]" when calling People::SearchApi.get_users_with_folders_shared, must be smaller than or equal to 100.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'count'].nil? && opts[:'count'] < 1
+        fail ArgumentError, 'invalid value for "opts[:"count"]" when calling People::SearchApi.get_users_with_folders_shared, must be greater than or equal to 1.'
+      end
+
+      # resource path
+      local_var_path = '/api/2.0/people/folder/{id}'.sub('{' + 'id' + '}', CGI.escape(id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'employeeStatus'] = opts[:'employee_status'] if !opts[:'employee_status'].nil?
+      query_params[:'activationStatus'] = opts[:'activation_status'] if !opts[:'activation_status'].nil?
+      query_params[:'excludeShared'] = opts[:'exclude_shared'] if !opts[:'exclude_shared'].nil?
+      query_params[:'includeShared'] = opts[:'include_shared'] if !opts[:'include_shared'].nil?
+      query_params[:'invitedByMe'] = opts[:'invited_by_me'] if !opts[:'invited_by_me'].nil?
+      query_params[:'inviterId'] = opts[:'inviter_id'] if !opts[:'inviter_id'].nil?
+      query_params[:'area'] = opts[:'area'] if !opts[:'area'].nil?
+      query_params[:'employeeTypes'] = @api_client.build_collection_param(opts[:'employee_types'], :multi) if !opts[:'employee_types'].nil?
+      query_params[:'count'] = opts[:'count'] if !opts[:'count'].nil?
+      query_params[:'startIndex'] = opts[:'start_index'] if !opts[:'start_index'].nil?
+      query_params[:'filterSeparator'] = opts[:'filter_separator'] if !opts[:'filter_separator'].nil?
+      query_params[:'filterValue'] = opts[:'filter_value'] if !opts[:'filter_value'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'EmployeeFullArrayWrapper'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['Basic', 'OAuth2', 'ApiKeyBearer', 'asc_auth_key', 'Bearer', 'OpenId']
+
+      new_options = opts.merge(
+        :operation => :"People::SearchApi.get_users_with_folders_shared",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: People::SearchApi#get_users_with_folders_shared\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Search users for a room
+    # Returns the accounts that are relevant to the room with the ID given in the route, and reports for each of  them whether it already has access to that room.  The caller only needs read access to the room, not the right to manage its access, but a guest may not call  it at all; an ID that matches no room answers 404.  The call is read-only, works without a filter - leaving `filterValue` empty returns every matching account  rather than nothing - and is paged by `count` and `startIndex`, with the number of matches in the total count  of the response.  Pass `excludeShared` to keep only the accounts that have no access yet, `includeShared` to keep only those  that already have it, and neither to get both kinds with the `shared` field telling them apart.  A DocSpace administrator additionally sees the guests that are not related to the caller.  To search users and groups together, or to build an access dialog that needs the right to manage sharing, use  `GET api/2.0/accounts/room/{id}/search` instead.
+    # See also: https://api.onlyoffice.com/docspace/api-backend/usage-api/get-users-with-room-shared/
+    # @param id [Integer, String] The ID of the room, folder or file the search is run against, taken from the route. It is an integer for an  entry stored in DocSpace and a provider-specific string for an entry in a connected third-party storage.
+    # @param [Hash] opts the optional parameters
+    # @option opts [EmployeeStatus] :employee_status Keeps only the accounts in the given state: `Active` for working accounts, `Terminated` for disabled ones  and `Pending` for open invitations. Omit it to search every state.
+    # @option opts [EmployeeActivationStatus] :activation_status Keeps only the accounts whose activation is in the given state: `NotActivated`, `Activated`, `Pending` or  `AutoGenerated`. Omit it to search every state.
+    # @option opts [Boolean] :exclude_shared Keeps only the accounts that do not have access to the entry yet, which is the set to offer when granting  access. It takes precedence over `includeShared`, and every returned entry has `shared` set to false.
+    # @option opts [Boolean] :include_shared Keeps only the accounts that already have access to the entry, which is the set to offer when changing or  revoking access. Every returned entry has `shared` set to true, and the flag is ignored when `excludeShared`  is also set.
+    # @option opts [Boolean] :invited_by_me Keeps only the accounts invited by the caller when true, and only those invited by somebody else when  false. Omit it to search regardless of who sent the invitation.
+    # @option opts [String] :inviter_id Keeps only the accounts invited by the account with this ID. Omit it to search regardless of who sent the  invitation.
+    # @option opts [AccountSearchArea] :area The part of the portal to search in: `All`, the default, searches members and guests together, `People`  leaves the guests out, and `Guests` returns guests only - and for a caller who is not a DocSpace  administrator, only the guests that caller is related to.
+    # @option opts [Array<EmployeeType>] :employee_types Keeps only the accounts of the listed types, combined as alternatives. An empty list, which is the default,  searches every type.
+    # @option opts [Integer] :count The size of the page. It defaults to 100, which is also the largest value the operation accepts.
+    # @option opts [Integer] :start_index The number of matches to skip before the page starts. It defaults to 0, and the total number of matches is  reported in the total count of the response.
+    # @option opts [String] :filter_separator The character that splits `filterValue` into several terms, of which any one may match. Omit it to split the  value on spaces instead, in which case every term has to match.
+    # @option opts [String] :filter_value The text to match against the first name, the last name and the email, case-insensitively. Omit it to get  every account the caller may offer access to.
+    # @return [EmployeeFullArrayWrapper]
+    def get_users_with_room_shared(id, opts = {})
+      data, _status_code, _headers = get_users_with_room_shared_with_http_info(id, opts)
+      data
+    end
+
+    # Search users for a room
+    # Returns the accounts that are relevant to the room with the ID given in the route, and reports for each of  them whether it already has access to that room.  The caller only needs read access to the room, not the right to manage its access, but a guest may not call  it at all; an ID that matches no room answers 404.  The call is read-only, works without a filter - leaving `filterValue` empty returns every matching account  rather than nothing - and is paged by `count` and `startIndex`, with the number of matches in the total count  of the response.  Pass `excludeShared` to keep only the accounts that have no access yet, `includeShared` to keep only those  that already have it, and neither to get both kinds with the `shared` field telling them apart.  A DocSpace administrator additionally sees the guests that are not related to the caller.  To search users and groups together, or to build an access dialog that needs the right to manage sharing, use  `GET api/2.0/accounts/room/{id}/search` instead.
+    # See also: https://api.onlyoffice.com/docspace/api-backend/usage-api/get-users-with-room-shared/
+    # @param id [Integer, String] The ID of the room, folder or file the search is run against, taken from the route. It is an integer for an  entry stored in DocSpace and a provider-specific string for an entry in a connected third-party storage.
+    # @param [Hash] opts the optional parameters
+    # @option opts [EmployeeStatus] :employee_status Keeps only the accounts in the given state: `Active` for working accounts, `Terminated` for disabled ones  and `Pending` for open invitations. Omit it to search every state.
+    # @option opts [EmployeeActivationStatus] :activation_status Keeps only the accounts whose activation is in the given state: `NotActivated`, `Activated`, `Pending` or  `AutoGenerated`. Omit it to search every state.
+    # @option opts [Boolean] :exclude_shared Keeps only the accounts that do not have access to the entry yet, which is the set to offer when granting  access. It takes precedence over `includeShared`, and every returned entry has `shared` set to false.
+    # @option opts [Boolean] :include_shared Keeps only the accounts that already have access to the entry, which is the set to offer when changing or  revoking access. Every returned entry has `shared` set to true, and the flag is ignored when `excludeShared`  is also set.
+    # @option opts [Boolean] :invited_by_me Keeps only the accounts invited by the caller when true, and only those invited by somebody else when  false. Omit it to search regardless of who sent the invitation.
+    # @option opts [String] :inviter_id Keeps only the accounts invited by the account with this ID. Omit it to search regardless of who sent the  invitation.
+    # @option opts [AccountSearchArea] :area The part of the portal to search in: `All`, the default, searches members and guests together, `People`  leaves the guests out, and `Guests` returns guests only - and for a caller who is not a DocSpace  administrator, only the guests that caller is related to.
+    # @option opts [Array<EmployeeType>] :employee_types Keeps only the accounts of the listed types, combined as alternatives. An empty list, which is the default,  searches every type.
+    # @option opts [Integer] :count The size of the page. It defaults to 100, which is also the largest value the operation accepts.
+    # @option opts [Integer] :start_index The number of matches to skip before the page starts. It defaults to 0, and the total number of matches is  reported in the total count of the response.
+    # @option opts [String] :filter_separator The character that splits `filterValue` into several terms, of which any one may match. Omit it to split the  value on spaces instead, in which case every term has to match.
+    # @option opts [String] :filter_value The text to match against the first name, the last name and the email, case-insensitively. Omit it to get  every account the caller may offer access to.
+    # @return [Array<(EmployeeFullArrayWrapper, Integer, Hash)>] EmployeeFullArrayWrapper data, response status code and response headers
+    def get_users_with_room_shared_with_http_info(id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: People::SearchApi.get_users_with_room_shared ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling People::SearchApi.get_users_with_room_shared"
+      end
+      if @api_client.config.client_side_validation && !opts[:'count'].nil? && opts[:'count'] > 100
+        fail ArgumentError, 'invalid value for "opts[:"count"]" when calling People::SearchApi.get_users_with_room_shared, must be smaller than or equal to 100.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'count'].nil? && opts[:'count'] < 1
+        fail ArgumentError, 'invalid value for "opts[:"count"]" when calling People::SearchApi.get_users_with_room_shared, must be greater than or equal to 1.'
+      end
+
+      # resource path
+      local_var_path = '/api/2.0/people/room/{id}'.sub('{' + 'id' + '}', CGI.escape(id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'employeeStatus'] = opts[:'employee_status'] if !opts[:'employee_status'].nil?
+      query_params[:'activationStatus'] = opts[:'activation_status'] if !opts[:'activation_status'].nil?
+      query_params[:'excludeShared'] = opts[:'exclude_shared'] if !opts[:'exclude_shared'].nil?
+      query_params[:'includeShared'] = opts[:'include_shared'] if !opts[:'include_shared'].nil?
+      query_params[:'invitedByMe'] = opts[:'invited_by_me'] if !opts[:'invited_by_me'].nil?
+      query_params[:'inviterId'] = opts[:'inviter_id'] if !opts[:'inviter_id'].nil?
+      query_params[:'area'] = opts[:'area'] if !opts[:'area'].nil?
+      query_params[:'employeeTypes'] = @api_client.build_collection_param(opts[:'employee_types'], :multi) if !opts[:'employee_types'].nil?
+      query_params[:'count'] = opts[:'count'] if !opts[:'count'].nil?
+      query_params[:'startIndex'] = opts[:'start_index'] if !opts[:'start_index'].nil?
+      query_params[:'filterSeparator'] = opts[:'filter_separator'] if !opts[:'filter_separator'].nil?
+      query_params[:'filterValue'] = opts[:'filter_value'] if !opts[:'filter_value'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'EmployeeFullArrayWrapper'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['Basic', 'OAuth2', 'ApiKeyBearer', 'asc_auth_key', 'Bearer', 'OpenId']
+
+      new_options = opts.merge(
+        :operation => :"People::SearchApi.get_users_with_room_shared",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: People::SearchApi#get_users_with_room_shared\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Filter users in detail
+    # Returns a page of portal accounts selected by the full set of account filters, with the complete profile of  each of them.  The caller has to be a room admin, a DocSpace admin or a People module admin; a member or a guest gets 403,  and a DocSpace admin additionally sees the accounts an ordinary admin does not.  The call is read-only, paged by `count` and `startIndex`, ordered by `sortBy` and `sortOrder`, and reports  the number of matches in the total count of the response.  Filters combine as conditions that all have to hold, with three interactions worth knowing: `withoutGroup`  makes `groupId` irrelevant, `employeeType` wins over `employeeTypes` when both are sent, and `area` set to  `Guests` or `People` cancels the type filters that contradict it.  `GET api/2.0/people/simple/filter` accepts exactly the same filters and returns the short profile instead, so  use that one for pickers and lists and this one when the full profile is really needed.  It is available on an unpaid portal.
+    # See also: https://api.onlyoffice.com/docspace/api-backend/usage-api/search-users-by-extended-filter/
+    # @param [Hash] opts the optional parameters
+    # @option opts [EmployeeStatus] :employee_status Keeps only the accounts in the given state: `Active` for working accounts, `Terminated` for disabled ones  and `Pending` for open invitations. Omit it to search every state.
+    # @option opts [String] :group_id Keeps only the members of this group, or excludes them when `excludeGroup` is true. It is ignored when  `withoutGroup` is set.
+    # @option opts [EmployeeActivationStatus] :activation_status Keeps only the accounts whose activation is in the given state: `NotActivated`, `Activated`, `Pending` or  `AutoGenerated`. Omit it to search every state.
+    # @option opts [EmployeeType] :employee_type Keeps only the accounts of this single type: `DocSpaceAdmin`, `RoomAdmin`, `User` or `Guest`. When it is  sent it wins over `employeeTypes`, and a type that contradicts `area` is dropped.
+    # @option opts [Array<Integer>] :employee_types Keeps the accounts of any of the listed types, combined as alternatives. It is ignored when `employeeType`  is also sent.
+    # @option opts [Boolean] :is_administrator Set it to true to keep only the DocSpace administrators and the module administrators. Setting it to false  is the same as omitting it and does not exclude administrators.
+    # @option opts [Payments] :payments Keeps only the accounts that take a paid seat when `Paid`, or only the guests and members that do not when  `Free`. Omit it to search both.
+    # @option opts [AccountLoginType] :account_login_type Keeps only the accounts that sign in this way: `SSO`, `LDAP`, or `Standart` for an ordinary portal  password. Omit it to search all of them.
+    # @option opts [QuotaFilter] :quota_filter Keeps only the accounts whose storage quota is the portal default when `Default`, or set individually when  `Custom`. `All`, which is the same as omitting the field, searches both.
+    # @option opts [Boolean] :without_group Set it to true to keep only the accounts that belong to no group at all, which makes `groupId` and  `excludeGroup` irrelevant.
+    # @option opts [Boolean] :exclude_group Inverts `groupId`: with true the members of that group are left out instead of being the only ones kept. It  has no effect without `groupId`.
+    # @option opts [Boolean] :invited_by_me Keeps only the accounts invited by the caller when true, and only those invited by somebody else when  false. Omit it to search regardless of who sent the invitation.
+    # @option opts [String] :inviter_id Keeps only the accounts invited by the account with this ID. Omit it to search regardless of who sent the  invitation.
+    # @option opts [AccountSearchArea] :area The part of the portal to search in: `All`, the default, searches members and guests together, `People`  leaves the guests out, and `Guests` returns guests only. It also cancels the type filters that contradict  it.
+    # @option opts [Integer] :count The size of the page. It defaults to 100, which is also the largest value the operation accepts.
+    # @option opts [Integer] :start_index The number of matches to skip before the page starts. It defaults to 0, and the total number of matches is  reported in the total count of the response.
+    # @option opts [String] :sort_by What to order the accounts by, compared without regard to case: `FirstName`, `LastName`, `DisplayName`,  `Type`, `Email`, `Department`, `UsedSpace`, `CreatedBy` or `RegistrationDate`.
+    # @option opts [SortOrder] :sort_order The direction of the ordering: `Ascending`, which is the default, or `Descending`.
+    # @option opts [String] :filter_separator The character that splits `filterValue` into several terms, of which any one may match. Omit it to split  the value on spaces instead, in which case every term has to match.
+    # @option opts [String] :filter_value The text to match against the first name, the last name and the email, case-insensitively. Omit it to apply  no text filter at all.
+    # @return [EmployeeFullArrayWrapper]
+    def search_users_by_extended_filter(opts = {})
+      data, _status_code, _headers = search_users_by_extended_filter_with_http_info(opts)
+      data
+    end
+
+    # Filter users in detail
+    # Returns a page of portal accounts selected by the full set of account filters, with the complete profile of  each of them.  The caller has to be a room admin, a DocSpace admin or a People module admin; a member or a guest gets 403,  and a DocSpace admin additionally sees the accounts an ordinary admin does not.  The call is read-only, paged by `count` and `startIndex`, ordered by `sortBy` and `sortOrder`, and reports  the number of matches in the total count of the response.  Filters combine as conditions that all have to hold, with three interactions worth knowing: `withoutGroup`  makes `groupId` irrelevant, `employeeType` wins over `employeeTypes` when both are sent, and `area` set to  `Guests` or `People` cancels the type filters that contradict it.  `GET api/2.0/people/simple/filter` accepts exactly the same filters and returns the short profile instead, so  use that one for pickers and lists and this one when the full profile is really needed.  It is available on an unpaid portal.
+    # See also: https://api.onlyoffice.com/docspace/api-backend/usage-api/search-users-by-extended-filter/
+    # @param [Hash] opts the optional parameters
+    # @option opts [EmployeeStatus] :employee_status Keeps only the accounts in the given state: `Active` for working accounts, `Terminated` for disabled ones  and `Pending` for open invitations. Omit it to search every state.
+    # @option opts [String] :group_id Keeps only the members of this group, or excludes them when `excludeGroup` is true. It is ignored when  `withoutGroup` is set.
+    # @option opts [EmployeeActivationStatus] :activation_status Keeps only the accounts whose activation is in the given state: `NotActivated`, `Activated`, `Pending` or  `AutoGenerated`. Omit it to search every state.
+    # @option opts [EmployeeType] :employee_type Keeps only the accounts of this single type: `DocSpaceAdmin`, `RoomAdmin`, `User` or `Guest`. When it is  sent it wins over `employeeTypes`, and a type that contradicts `area` is dropped.
+    # @option opts [Array<Integer>] :employee_types Keeps the accounts of any of the listed types, combined as alternatives. It is ignored when `employeeType`  is also sent.
+    # @option opts [Boolean] :is_administrator Set it to true to keep only the DocSpace administrators and the module administrators. Setting it to false  is the same as omitting it and does not exclude administrators.
+    # @option opts [Payments] :payments Keeps only the accounts that take a paid seat when `Paid`, or only the guests and members that do not when  `Free`. Omit it to search both.
+    # @option opts [AccountLoginType] :account_login_type Keeps only the accounts that sign in this way: `SSO`, `LDAP`, or `Standart` for an ordinary portal  password. Omit it to search all of them.
+    # @option opts [QuotaFilter] :quota_filter Keeps only the accounts whose storage quota is the portal default when `Default`, or set individually when  `Custom`. `All`, which is the same as omitting the field, searches both.
+    # @option opts [Boolean] :without_group Set it to true to keep only the accounts that belong to no group at all, which makes `groupId` and  `excludeGroup` irrelevant.
+    # @option opts [Boolean] :exclude_group Inverts `groupId`: with true the members of that group are left out instead of being the only ones kept. It  has no effect without `groupId`.
+    # @option opts [Boolean] :invited_by_me Keeps only the accounts invited by the caller when true, and only those invited by somebody else when  false. Omit it to search regardless of who sent the invitation.
+    # @option opts [String] :inviter_id Keeps only the accounts invited by the account with this ID. Omit it to search regardless of who sent the  invitation.
+    # @option opts [AccountSearchArea] :area The part of the portal to search in: `All`, the default, searches members and guests together, `People`  leaves the guests out, and `Guests` returns guests only. It also cancels the type filters that contradict  it.
+    # @option opts [Integer] :count The size of the page. It defaults to 100, which is also the largest value the operation accepts.
+    # @option opts [Integer] :start_index The number of matches to skip before the page starts. It defaults to 0, and the total number of matches is  reported in the total count of the response.
+    # @option opts [String] :sort_by What to order the accounts by, compared without regard to case: `FirstName`, `LastName`, `DisplayName`,  `Type`, `Email`, `Department`, `UsedSpace`, `CreatedBy` or `RegistrationDate`.
+    # @option opts [SortOrder] :sort_order The direction of the ordering: `Ascending`, which is the default, or `Descending`.
+    # @option opts [String] :filter_separator The character that splits `filterValue` into several terms, of which any one may match. Omit it to split  the value on spaces instead, in which case every term has to match.
+    # @option opts [String] :filter_value The text to match against the first name, the last name and the email, case-insensitively. Omit it to apply  no text filter at all.
+    # @return [Array<(EmployeeFullArrayWrapper, Integer, Hash)>] EmployeeFullArrayWrapper data, response status code and response headers
+    def search_users_by_extended_filter_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: People::SearchApi.search_users_by_extended_filter ...'
+      end
+      allowable_values = [0, 1, 2, 3, 4]
+      if @api_client.config.client_side_validation && opts[:'employee_types'] && !opts[:'employee_types'].all? { |item| allowable_values.include?(item) }
+        fail ArgumentError, "invalid value for \"employee_types\", must include one of #{allowable_values}"
+      end
+      if @api_client.config.client_side_validation && !opts[:'count'].nil? && opts[:'count'] > 100
+        fail ArgumentError, 'invalid value for "opts[:"count"]" when calling People::SearchApi.search_users_by_extended_filter, must be smaller than or equal to 100.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'count'].nil? && opts[:'count'] < 1
+        fail ArgumentError, 'invalid value for "opts[:"count"]" when calling People::SearchApi.search_users_by_extended_filter, must be greater than or equal to 1.'
+      end
+
+      # resource path
+      local_var_path = '/api/2.0/people/filter'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'employeeStatus'] = opts[:'employee_status'] if !opts[:'employee_status'].nil?
+      query_params[:'groupId'] = opts[:'group_id'] if !opts[:'group_id'].nil?
+      query_params[:'activationStatus'] = opts[:'activation_status'] if !opts[:'activation_status'].nil?
+      query_params[:'employeeType'] = opts[:'employee_type'] if !opts[:'employee_type'].nil?
+      query_params[:'employeeTypes'] = @api_client.build_collection_param(opts[:'employee_types'], :multi) if !opts[:'employee_types'].nil?
+      query_params[:'isAdministrator'] = opts[:'is_administrator'] if !opts[:'is_administrator'].nil?
+      query_params[:'payments'] = opts[:'payments'] if !opts[:'payments'].nil?
+      query_params[:'accountLoginType'] = opts[:'account_login_type'] if !opts[:'account_login_type'].nil?
+      query_params[:'quotaFilter'] = opts[:'quota_filter'] if !opts[:'quota_filter'].nil?
+      query_params[:'withoutGroup'] = opts[:'without_group'] if !opts[:'without_group'].nil?
+      query_params[:'excludeGroup'] = opts[:'exclude_group'] if !opts[:'exclude_group'].nil?
+      query_params[:'invitedByMe'] = opts[:'invited_by_me'] if !opts[:'invited_by_me'].nil?
+      query_params[:'inviterId'] = opts[:'inviter_id'] if !opts[:'inviter_id'].nil?
+      query_params[:'area'] = opts[:'area'] if !opts[:'area'].nil?
+      query_params[:'count'] = opts[:'count'] if !opts[:'count'].nil?
+      query_params[:'startIndex'] = opts[:'start_index'] if !opts[:'start_index'].nil?
+      query_params[:'sortBy'] = opts[:'sort_by'] if !opts[:'sort_by'].nil?
+      query_params[:'sortOrder'] = opts[:'sort_order'] if !opts[:'sort_order'].nil?
+      query_params[:'filterSeparator'] = opts[:'filter_separator'] if !opts[:'filter_separator'].nil?
+      query_params[:'filterValue'] = opts[:'filter_value'] if !opts[:'filter_value'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'EmployeeFullArrayWrapper'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['Basic', 'OAuth2', 'ApiKeyBearer', 'asc_auth_key', 'Bearer', 'OpenId']
+
+      new_options = opts.merge(
+        :operation => :"People::SearchApi.search_users_by_extended_filter",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: People::SearchApi#search_users_by_extended_filter\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Search users by query
+    # Searches the active accounts of the portal by a term passed in the query string, and is the same search as  `GET api/2.0/people/@search/{query}`, which takes the term in the path instead.  Only a DocSpace administrator may call it; every other account, including a room admin, gets 403.  Only accounts with the `Active` status are searched, so a pending invitation and a disabled account are never  found - use `GET api/2.0/people/filter` to search across states.  The call is read-only and is not paged: every match is streamed, without a total.  It takes the search term and nothing else - the group filter of  `GET api/2.0/people/@search/{query}` is not reachable here, because the handler forwards only `query` - so  use that operation when the result has to be narrowed to one group.  The answer holds full profiles, because the handler passes the request on to the operation that builds the  complete profile.
+    # See also: https://api.onlyoffice.com/docspace/api-backend/usage-api/search-users-by-query/
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :query The term to look for. Only accounts with the `Active` status are searched, and this is the only parameter the  operation reads.
+    # @return [EmployeeFullArrayWrapper]
+    def search_users_by_query(opts = {})
+      data, _status_code, _headers = search_users_by_query_with_http_info(opts)
+      data
+    end
+
+    # Search users by query
+    # Searches the active accounts of the portal by a term passed in the query string, and is the same search as  `GET api/2.0/people/@search/{query}`, which takes the term in the path instead.  Only a DocSpace administrator may call it; every other account, including a room admin, gets 403.  Only accounts with the `Active` status are searched, so a pending invitation and a disabled account are never  found - use `GET api/2.0/people/filter` to search across states.  The call is read-only and is not paged: every match is streamed, without a total.  It takes the search term and nothing else - the group filter of  `GET api/2.0/people/@search/{query}` is not reachable here, because the handler forwards only `query` - so  use that operation when the result has to be narrowed to one group.  The answer holds full profiles, because the handler passes the request on to the operation that builds the  complete profile.
+    # See also: https://api.onlyoffice.com/docspace/api-backend/usage-api/search-users-by-query/
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :query The term to look for. Only accounts with the `Active` status are searched, and this is the only parameter the  operation reads.
+    # @return [Array<(EmployeeFullArrayWrapper, Integer, Hash)>] EmployeeFullArrayWrapper data, response status code and response headers
+    def search_users_by_query_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: People::SearchApi.search_users_by_query ...'
+      end
+      # resource path
+      local_var_path = '/api/2.0/people/search'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'query'] = opts[:'query'] if !opts[:'query'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'EmployeeFullArrayWrapper'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['Basic', 'OAuth2', 'ApiKeyBearer', 'asc_auth_key', 'Bearer', 'OpenId']
+
+      new_options = opts.merge(
+        :operation => :"People::SearchApi.search_users_by_query",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: People::SearchApi#search_users_by_query\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Search users by status filter
+    # Searches the accounts that are in one particular state - the status is taken from the route - and whose name,  user name, email or contacts contain the search term.  Only a DocSpace administrator may call it; every other account, including a room admin, gets 403.  The call is read-only and is not paged: it matches in memory over every account of that status and streams  all of them, so it is meant for administrative lookups rather than for a user-facing list - use  `GET api/2.0/people/filter` when a page and a total are needed.  The term is matched as a case-insensitive substring and is required; `filterBy` set to `group` turns `text`  into a group ID and keeps only the members of that group, so `text` then has to be a valid identifier.  The answer holds full profiles, in no particular order.
+    # See also: https://api.onlyoffice.com/docspace/api-backend/usage-api/search-users-by-status/
+    # @param status [EmployeeStatus] The account state to search in, taken from the route: `Active` for working accounts, `Terminated` for  disabled ones, `Pending` for open invitations, or `All` for every state.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :query The term to look for, matched as a case-insensitive substring of the first name, the last name, the user  name, the email and the contacts. It is required in practice, because the search cannot run without it.
+    # @option opts [String] :filter_by The only recognised value is `group`, which turns `filterValue` into a group ID and keeps only the members of  that group. Any other value, and omitting the field, applies no group filter.
+    # @option opts [String] :filter_value The group ID to keep the members of, used only when `filterBy` is `group`. It has to be a valid identifier -  a group name is not accepted.
+    # @return [EmployeeFullArrayWrapper]
+    def search_users_by_status(status, opts = {})
+      data, _status_code, _headers = search_users_by_status_with_http_info(status, opts)
+      data
+    end
+
+    # Search users by status filter
+    # Searches the accounts that are in one particular state - the status is taken from the route - and whose name,  user name, email or contacts contain the search term.  Only a DocSpace administrator may call it; every other account, including a room admin, gets 403.  The call is read-only and is not paged: it matches in memory over every account of that status and streams  all of them, so it is meant for administrative lookups rather than for a user-facing list - use  `GET api/2.0/people/filter` when a page and a total are needed.  The term is matched as a case-insensitive substring and is required; `filterBy` set to `group` turns `text`  into a group ID and keeps only the members of that group, so `text` then has to be a valid identifier.  The answer holds full profiles, in no particular order.
+    # See also: https://api.onlyoffice.com/docspace/api-backend/usage-api/search-users-by-status/
+    # @param status [EmployeeStatus] The account state to search in, taken from the route: `Active` for working accounts, `Terminated` for  disabled ones, `Pending` for open invitations, or `All` for every state.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :query The term to look for, matched as a case-insensitive substring of the first name, the last name, the user  name, the email and the contacts. It is required in practice, because the search cannot run without it.
+    # @option opts [String] :filter_by The only recognised value is `group`, which turns `filterValue` into a group ID and keeps only the members of  that group. Any other value, and omitting the field, applies no group filter.
+    # @option opts [String] :filter_value The group ID to keep the members of, used only when `filterBy` is `group`. It has to be a valid identifier -  a group name is not accepted.
+    # @return [Array<(EmployeeFullArrayWrapper, Integer, Hash)>] EmployeeFullArrayWrapper data, response status code and response headers
+    def search_users_by_status_with_http_info(status, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: People::SearchApi.search_users_by_status ...'
+      end
+      # verify the required parameter 'status' is set
+      if @api_client.config.client_side_validation && status.nil?
+        fail ArgumentError, "Missing the required parameter 'status' when calling People::SearchApi.search_users_by_status"
+      end
+      # resource path
+      local_var_path = '/api/2.0/people/status/{status}/search'.sub('{' + 'status' + '}', CGI.escape(status.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'query'] = opts[:'query'] if !opts[:'query'].nil?
+      query_params[:'filterBy'] = opts[:'filter_by'] if !opts[:'filter_by'].nil?
+      query_params[:'filterValue'] = opts[:'filter_value'] if !opts[:'filter_value'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'EmployeeFullArrayWrapper'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['Basic', 'OAuth2', 'ApiKeyBearer', 'asc_auth_key', 'Bearer', 'OpenId']
+
+      new_options = opts.merge(
+        :operation => :"People::SearchApi.search_users_by_status",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: People::SearchApi#search_users_by_status\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+    end
+  end
+end