google-cloud-talent 0.3.0 → 0.4.0

data/lib/google/cloud/talent/v4beta1/common_pb.rb

@@ -254,6 +254,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
   end
   add_enum "google.cloud.talent.v4beta1.SkillProficiencyLevel" do
     value :SKILL_PROFICIENCY_LEVEL_UNSPECIFIED, 0
+    value :UNSKILLED, 6
     value :FUNDAMENTAL_AWARENESS, 1
     value :NOVICE, 2
     value :INTERMEDIATE, 3

data/lib/google/cloud/talent/v4beta1/company_pb.rb

@@ -4,8 +4,8 @@
 
 require 'google/protobuf'
 
-require 'google/cloud/talent/v4beta1/common_pb'
 require 'google/api/annotations_pb'
+require 'google/cloud/talent/v4beta1/common_pb'
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_message "google.cloud.talent.v4beta1.Company" do
     optional :name, :string, 1

data/lib/google/cloud/talent/v4beta1/company_service_client.rb

@@ -27,6 +27,7 @@ require "google/gax"
 
 require "google/cloud/talent/v4beta1/company_service_pb"
 require "google/cloud/talent/v4beta1/credentials"
+require "google/cloud/talent/version"
 
 module Google
   module Cloud
@@ -130,6 +131,10 @@ module Google
           #   The default timeout, in seconds, for calls made through this client.
           # @param metadata [Hash]
           #   Default metadata to be sent with each request. This can be overridden on a per call basis.
+          # @param service_address [String]
+          #   Override for the service hostname, or `nil` to leave as the default.
+          # @param service_port [Integer]
+          #   Override for the service port, or `nil` to leave as the default.
           # @param exception_transformer [Proc]
           #   An optional proc that intercepts any exceptions raised during an API call to inject
           #   custom error handling.
@@ -139,6 +144,8 @@ module Google
               client_config: {},
               timeout: DEFAULT_TIMEOUT,
               metadata: nil,
+              service_address: nil,
+              service_port: nil,
               exception_transformer: nil,
               lib_name: nil,
               lib_version: ""
@@ -166,7 +173,7 @@ module Google
               updater_proc = credentials.updater_proc
             end
 
-            package_version = Gem.loaded_specs['google-cloud-talent'].version.version
+            package_version = Google::Cloud::Talent::VERSION
 
             google_api_client = "gl-ruby/#{RUBY_VERSION}"
             google_api_client << " #{lib_name}/#{lib_version}" if lib_name
@@ -193,8 +200,8 @@ module Google
             end
 
             # Allow overriding the service path/port in subclasses.
-            service_path = self.class::SERVICE_ADDRESS
-            port = self.class::DEFAULT_SERVICE_PORT
+            service_path = service_address || self.class::SERVICE_ADDRESS
+            port = service_port || self.class::DEFAULT_SERVICE_PORT
             interceptors = self.class::GRPC_INTERCEPTORS
             @company_service_stub = Google::Gax::Grpc.create_stub(
               service_path,
@@ -254,9 +261,7 @@ module Google
           # Creates a new company entity.
           #
           # @param parent [String]
-          #   Required.
-          #
-          #   Resource name of the tenant under which the company is created.
+          #   Required. Resource name of the tenant under which the company is created.
           #
           #   The format is "projects/{project_id}/tenants/{tenant_id}", for example,
           #   "projects/api-test-project/tenant/foo".
@@ -264,9 +269,7 @@ module Google
           #   Tenant id is optional and a default tenant is created if unspecified, for
           #   example, "projects/api-test-project".
           # @param company [Google::Cloud::Talent::V4beta1::Company | Hash]
-          #   Required.
-          #
-          #   The company to be created.
+          #   Required. The company to be created.
           #   A hash of the same form as `Google::Cloud::Talent::V4beta1::Company`
           #   can also be provided.
           # @param options [Google::Gax::CallOptions]
@@ -303,9 +306,7 @@ module Google
           # Retrieves specified company.
           #
           # @param name [String]
-          #   Required.
-          #
-          #   The resource name of the company to be retrieved.
+          #   Required. The resource name of the company to be retrieved.
           #
           #   The format is
           #   "projects/{project_id}/tenants/{tenant_id}/companies/{company_id}", for
@@ -342,20 +343,23 @@ module Google
           # Updates specified company.
           #
           # @param company [Google::Cloud::Talent::V4beta1::Company | Hash]
-          #   Required.
-          #
-          #   The company resource to replace the current resource in the system.
+          #   Required. The company resource to replace the current resource in the
+          #   system.
           #   A hash of the same form as `Google::Cloud::Talent::V4beta1::Company`
           #   can also be provided.
           # @param update_mask [Google::Protobuf::FieldMask | Hash]
           #   Optional but strongly recommended for the best service
           #   experience.
           #
-          #   If {Google::Cloud::Talent::V4beta1::UpdateCompanyRequest#update_mask update_mask} is provided, only the specified fields in
-          #   {Google::Cloud::Talent::V4beta1::UpdateCompanyRequest#company company} are updated. Otherwise all the fields are updated.
+          #   If
+          #   {Google::Cloud::Talent::V4beta1::UpdateCompanyRequest#update_mask update_mask}
+          #   is provided, only the specified fields in
+          #   {Google::Cloud::Talent::V4beta1::UpdateCompanyRequest#company company} are
+          #   updated. Otherwise all the fields are updated.
           #
           #   A field mask to specify the company fields to be updated. Only
-          #   top level fields of {Google::Cloud::Talent::V4beta1::Company Company} are supported.
+          #   top level fields of {Google::Cloud::Talent::V4beta1::Company Company} are
+          #   supported.
           #   A hash of the same form as `Google::Protobuf::FieldMask`
           #   can also be provided.
           # @param options [Google::Gax::CallOptions]
@@ -392,9 +396,7 @@ module Google
           # Prerequisite: The company has no jobs associated with it.
           #
           # @param name [String]
-          #   Required.
-          #
-          #   The resource name of the company to be deleted.
+          #   Required. The resource name of the company to be deleted.
           #
           #   The format is
           #   "projects/{project_id}/tenants/{tenant_id}/companies/{company_id}", for
@@ -431,9 +433,7 @@ module Google
           # Lists all companies associated with the project.
           #
           # @param parent [String]
-          #   Required.
-          #
-          #   Resource name of the tenant under which the company is created.
+          #   Required. Resource name of the tenant under which the company is created.
           #
           #   The format is "projects/{project_id}/tenants/{tenant_id}", for example,
           #   "projects/api-test-project/tenant/foo".
@@ -447,14 +447,13 @@ module Google
           #   performed per-page, this determines the maximum number of
           #   resources in a page.
           # @param require_open_jobs [true, false]
-          #   Optional.
-          #
-          #   Set to true if the companies requested must have open jobs.
+          #   Optional. Set to true if the companies requested must have open jobs.
           #
           #   Defaults to false.
           #
-          #   If true, at most {Google::Cloud::Talent::V4beta1::ListCompaniesRequest#page_size page_size} of companies are fetched, among which
-          #   only those with open jobs are returned.
+          #   If true, at most
+          #   {Google::Cloud::Talent::V4beta1::ListCompaniesRequest#page_size page_size} of
+          #   companies are fetched, among which only those with open jobs are returned.
           # @param options [Google::Gax::CallOptions]
           #   Overrides the default settings for this call, e.g, timeout,
           #   retries, etc.

data/lib/google/cloud/talent/v4beta1/company_service_pb.rb

@@ -5,6 +5,7 @@
 require 'google/protobuf'
 
 require 'google/api/annotations_pb'
+require 'google/api/client_pb'
 require 'google/cloud/talent/v4beta1/common_pb'
 require 'google/cloud/talent/v4beta1/company_pb'
 require 'google/protobuf/empty_pb'

data/lib/google/cloud/talent/v4beta1/completion_client.rb

@@ -27,6 +27,7 @@ require "google/gax"
 
 require "google/cloud/talent/v4beta1/completion_service_pb"
 require "google/cloud/talent/v4beta1/credentials"
+require "google/cloud/talent/version"
 
 module Google
   module Cloud
@@ -121,6 +122,10 @@ module Google
           #   The default timeout, in seconds, for calls made through this client.
           # @param metadata [Hash]
           #   Default metadata to be sent with each request. This can be overridden on a per call basis.
+          # @param service_address [String]
+          #   Override for the service hostname, or `nil` to leave as the default.
+          # @param service_port [Integer]
+          #   Override for the service port, or `nil` to leave as the default.
           # @param exception_transformer [Proc]
           #   An optional proc that intercepts any exceptions raised during an API call to inject
           #   custom error handling.
@@ -130,6 +135,8 @@ module Google
               client_config: {},
               timeout: DEFAULT_TIMEOUT,
               metadata: nil,
+              service_address: nil,
+              service_port: nil,
               exception_transformer: nil,
               lib_name: nil,
               lib_version: ""
@@ -157,7 +164,7 @@ module Google
               updater_proc = credentials.updater_proc
             end
 
-            package_version = Gem.loaded_specs['google-cloud-talent'].version.version
+            package_version = Google::Cloud::Talent::VERSION
 
             google_api_client = "gl-ruby/#{RUBY_VERSION}"
             google_api_client << " #{lib_name}/#{lib_version}" if lib_name
@@ -183,8 +190,8 @@ module Google
             end
 
             # Allow overriding the service path/port in subclasses.
-            service_path = self.class::SERVICE_ADDRESS
-            port = self.class::DEFAULT_SERVICE_PORT
+            service_path = service_address || self.class::SERVICE_ADDRESS
+            port = service_port || self.class::DEFAULT_SERVICE_PORT
             interceptors = self.class::GRPC_INTERCEPTORS
             @completion_stub = Google::Gax::Grpc.create_stub(
               service_path,
@@ -213,9 +220,7 @@ module Google
           # Intended for use by a job search auto-complete search box.
           #
           # @param parent [String]
-          #   Required.
-          #
-          #   Resource name of tenant the completion is performed within.
+          #   Required. Resource name of tenant the completion is performed within.
           #
           #   The format is "projects/{project_id}/tenants/{tenant_id}", for example,
           #   "projects/api-test-project/tenant/foo".
@@ -223,41 +228,42 @@ module Google
           #   Tenant id is optional and the default tenant is used if unspecified, for
           #   example, "projects/api-test-project".
           # @param query [String]
-          #   Required.
-          #
-          #   The query used to generate suggestions.
+          #   Required. The query used to generate suggestions.
           #
           #   The maximum number of allowed characters is 255.
           # @param page_size [Integer]
-          #   Required.
-          #
-          #   Completion result count.
+          #   Required. Completion result count.
           #
           #   The maximum allowed page size is 10.
           # @param language_codes [Array<String>]
-          #   Optional.
-          #
-          #   The list of languages of the query. This is
+          #   Optional. The list of languages of the query. This is
           #   the BCP-47 language code, such as "en-US" or "sr-Latn".
           #   For more information, see
           #   [Tags for Identifying Languages](https://tools.ietf.org/html/bcp47).
           #
-          #   For {Google::Cloud::Talent::V4beta1::CompleteQueryRequest::CompletionType::JOB_TITLE CompletionType::JOB_TITLE} type, only open jobs with the same
-          #   {Google::Cloud::Talent::V4beta1::CompleteQueryRequest#language_codes language_codes} are returned.
+          #   For
+          #   {Google::Cloud::Talent::V4beta1::CompleteQueryRequest::CompletionType::JOB_TITLE CompletionType::JOB_TITLE}
+          #   type, only open jobs with the same
+          #   {Google::Cloud::Talent::V4beta1::CompleteQueryRequest#language_codes language_codes}
+          #   are returned.
           #
-          #   For {Google::Cloud::Talent::V4beta1::CompleteQueryRequest::CompletionType::COMPANY_NAME CompletionType::COMPANY_NAME} type,
-          #   only companies having open jobs with the same {Google::Cloud::Talent::V4beta1::CompleteQueryRequest#language_codes language_codes} are
-          #   returned.
+          #   For
+          #   {Google::Cloud::Talent::V4beta1::CompleteQueryRequest::CompletionType::COMPANY_NAME CompletionType::COMPANY_NAME}
+          #   type, only companies having open jobs with the same
+          #   {Google::Cloud::Talent::V4beta1::CompleteQueryRequest#language_codes language_codes}
+          #   are returned.
           #
-          #   For {Google::Cloud::Talent::V4beta1::CompleteQueryRequest::CompletionType::COMBINED CompletionType::COMBINED} type, only open jobs with the same
-          #   {Google::Cloud::Talent::V4beta1::CompleteQueryRequest#language_codes language_codes} or companies having open jobs with the same
-          #   {Google::Cloud::Talent::V4beta1::CompleteQueryRequest#language_codes language_codes} are returned.
+          #   For
+          #   {Google::Cloud::Talent::V4beta1::CompleteQueryRequest::CompletionType::COMBINED CompletionType::COMBINED}
+          #   type, only open jobs with the same
+          #   {Google::Cloud::Talent::V4beta1::CompleteQueryRequest#language_codes language_codes}
+          #   or companies having open jobs with the same
+          #   {Google::Cloud::Talent::V4beta1::CompleteQueryRequest#language_codes language_codes}
+          #   are returned.
           #
           #   The maximum number of allowed characters is 255.
           # @param company [String]
-          #   Optional.
-          #
-          #   If provided, restricts completion to specified company.
+          #   Optional. If provided, restricts completion to specified company.
           #
           #   The format is
           #   "projects/{project_id}/tenants/{tenant_id}/companies/{company_id}", for
@@ -266,13 +272,11 @@ module Google
           #   Tenant id is optional and the default tenant is used if unspecified, for
           #   example, "projects/api-test-project/companies/bar".
           # @param scope [Google::Cloud::Talent::V4beta1::CompleteQueryRequest::CompletionScope]
-          #   Optional.
-          #
-          #   The scope of the completion. The defaults is {Google::Cloud::Talent::V4beta1::CompleteQueryRequest::CompletionScope::PUBLIC CompletionScope::PUBLIC}.
+          #   Optional. The scope of the completion. The defaults is
+          #   {Google::Cloud::Talent::V4beta1::CompleteQueryRequest::CompletionScope::PUBLIC CompletionScope::PUBLIC}.
           # @param type [Google::Cloud::Talent::V4beta1::CompleteQueryRequest::CompletionType]
-          #   Optional.
-          #
-          #   The completion topic. The default is {Google::Cloud::Talent::V4beta1::CompleteQueryRequest::CompletionType::COMBINED CompletionType::COMBINED}.
+          #   Optional. The completion topic. The default is
+          #   {Google::Cloud::Talent::V4beta1::CompleteQueryRequest::CompletionType::COMBINED CompletionType::COMBINED}.
           # @param options [Google::Gax::CallOptions]
           #   Overrides the default settings for this call, e.g, timeout,
           #   retries, etc.

data/lib/google/cloud/talent/v4beta1/completion_service_pb.rb

@@ -5,6 +5,7 @@
 require 'google/protobuf'
 
 require 'google/api/annotations_pb'
+require 'google/api/client_pb'
 require 'google/cloud/talent/v4beta1/common_pb'
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_message "google.cloud.talent.v4beta1.CompleteQueryRequest" do

data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/application.rb

@@ -30,9 +30,7 @@ module Google
         #     "projects/api-test-project/tenants/foo/profiles/bar/applications/baz".
         # @!attribute [rw] external_id
         #   @return [String]
-        #     Required.
-        #
-        #     Client side application identifier, used to uniquely identify the
+        #     Required. Client side application identifier, used to uniquely identify the
         #     application.
         #
         #     The maximum number of allowed characters is 255.
@@ -63,57 +61,40 @@ module Google
         #     for example, "projects/api-test-project/tenants/foo/companies/bar".
         # @!attribute [rw] application_date
         #   @return [Google::Type::Date]
-        #     Optional.
-        #
-        #     The application date.
+        #     Optional. The application date.
         # @!attribute [rw] stage
         #   @return [Google::Cloud::Talent::V4beta1::Application::ApplicationStage]
-        #     Required.
-        #
-        #     What is the most recent stage of the application (that is, new, screen,
-        #     send cv, hired, finished work)?  This field is intentionally not
+        #     Required. What is the most recent stage of the application (that is, new,
+        #     screen, send cv, hired, finished work)?  This field is intentionally not
         #     comprehensive of every possible status, but instead, represents statuses
         #     that would be used to indicate to the ML models good / bad matches.
         # @!attribute [rw] state
         #   @return [Google::Cloud::Talent::V4beta1::Application::ApplicationState]
-        #     Optional.
-        #
-        #     The application state.
+        #     Optional. The application state.
         # @!attribute [rw] interviews
         #   @return [Array<Google::Cloud::Talent::V4beta1::Interview>]
-        #     Optional.
-        #
-        #     All interviews (screen, onsite, and so on) conducted as part of this
-        #     application (includes details such as user conducting the interview,
+        #     Optional. All interviews (screen, onsite, and so on) conducted as part of
+        #     this application (includes details such as user conducting the interview,
         #     timestamp, feedback, and so on).
         # @!attribute [rw] referral
         #   @return [Google::Protobuf::BoolValue]
-        #     Optional.
-        #
-        #     If the candidate is referred by a employee.
+        #     Optional. If the candidate is referred by a employee.
         # @!attribute [rw] create_time
         #   @return [Google::Protobuf::Timestamp]
-        #     Required.
-        #
-        #     Reflects the time that the application was created.
+        #     Required. Reflects the time that the application was created.
         # @!attribute [rw] update_time
         #   @return [Google::Protobuf::Timestamp]
-        #     Optional.
-        #
-        #     The last update timestamp.
+        #     Optional. The last update timestamp.
         # @!attribute [rw] outcome_notes
         #   @return [String]
-        #     Optional.
-        #
-        #     Free text reason behind the recruitement outcome (for example, reason for
-        #     withdraw / reject, reason for an unsuccessful finish, and so on).
+        #     Optional. Free text reason behind the recruitement outcome (for example,
+        #     reason for withdraw / reject, reason for an unsuccessful finish, and so
+        #     on).
         #
         #     Number of characters allowed is 100.
         # @!attribute [rw] outcome
         #   @return [Google::Cloud::Talent::V4beta1::Outcome]
-        #     Optional.
-        #
-        #     Outcome positiveness shows how positive the outcome is.
+        #     Optional. Outcome positiveness shows how positive the outcome is.
         # @!attribute [rw] is_match
         #   @return [Google::Protobuf::BoolValue]
         #     Output only. Indicates whether this job application is a match to

data/lib/google/cloud/talent/v4beta1/doc/google/cloud/talent/v4beta1/application_service.rb

@@ -20,26 +20,21 @@ module Google
         # The Request of the CreateApplication method.
         # @!attribute [rw] parent
         #   @return [String]
-        #     Required.
-        #
-        #     Resource name of the profile under which the application is created.
+        #     Required. Resource name of the profile under which the application is
+        #     created.
         #
         #     The format is
         #     "projects/{project_id}/tenants/{tenant_id}/profiles/{profile_id}", for
         #     example, "projects/test-project/tenants/test-tenant/profiles/test-profile".
         # @!attribute [rw] application
         #   @return [Google::Cloud::Talent::V4beta1::Application]
-        #     Required.
-        #
-        #     The application to be created.
+        #     Required. The application to be created.
         class CreateApplicationRequest; end
 
         # Request for getting a application by name.
         # @!attribute [rw] name
         #   @return [String]
-        #     Required.
-        #
-        #     The resource name of the application to be retrieved.
+        #     Required. The resource name of the application to be retrieved.
         #
         #     The format is
         #     "projects/{project_id}/tenants/{tenant_id}/profiles/{profile_id}/applications/{application_id}",
@@ -50,27 +45,28 @@ module Google
         # Request for updating a specified application.
         # @!attribute [rw] application
         #   @return [Google::Cloud::Talent::V4beta1::Application]
-        #     Required.
-        #
-        #     The application resource to replace the current resource in the system.
+        #     Required. The application resource to replace the current resource in the
+        #     system.
         # @!attribute [rw] update_mask
         #   @return [Google::Protobuf::FieldMask]
         #     Optional but strongly recommended for the best service
         #     experience.
         #
-        #     If {Google::Cloud::Talent::V4beta1::UpdateApplicationRequest#update_mask update_mask} is provided, only the specified fields in
-        #     {Google::Cloud::Talent::V4beta1::UpdateApplicationRequest#application application} are updated. Otherwise all the fields are updated.
+        #     If
+        #     {Google::Cloud::Talent::V4beta1::UpdateApplicationRequest#update_mask update_mask}
+        #     is provided, only the specified fields in
+        #     {Google::Cloud::Talent::V4beta1::UpdateApplicationRequest#application application}
+        #     are updated. Otherwise all the fields are updated.
         #
         #     A field mask to specify the application fields to be updated. Only
-        #     top level fields of {Google::Cloud::Talent::V4beta1::Application Application} are supported.
+        #     top level fields of {Google::Cloud::Talent::V4beta1::Application Application}
+        #     are supported.
         class UpdateApplicationRequest; end
 
         # Request to delete a application.
         # @!attribute [rw] name
         #   @return [String]
-        #     Required.
-        #
-        #     The resource name of the application to be deleted.
+        #     Required. The resource name of the application to be deleted.
         #
         #     The format is
         #     "projects/{project_id}/tenants/{tenant_id}/profiles/{profile_id}/applications/{application_id}",
@@ -81,23 +77,18 @@ module Google
         # List applications for which the client has ACL visibility.
         # @!attribute [rw] parent
         #   @return [String]
-        #     Required.
-        #
-        #     Resource name of the profile under which the application is created.
+        #     Required. Resource name of the profile under which the application is
+        #     created.
         #
         #     The format is
         #     "projects/{project_id}/tenants/{tenant_id}/profiles/{profile_id}", for
         #     example, "projects/test-project/tenants/test-tenant/profiles/test-profile".
         # @!attribute [rw] page_token
         #   @return [String]
-        #     Optional.
-        #
-        #     The starting indicator from which to return results.
+        #     Optional. The starting indicator from which to return results.
         # @!attribute [rw] page_size
         #   @return [Integer]
-        #     Optional.
-        #
-        #     The maximum number of applications to be returned, at most 100.
+        #     Optional. The maximum number of applications to be returned, at most 100.
         #     Default is 100 if a non-positive number is provided.
         class ListApplicationsRequest; end