google-cloud-talent 0.1.0 → 0.2.0

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

@@ -5,7 +5,6 @@
 require 'google/protobuf'
 
 require 'google/api/annotations_pb'
-require 'google/cloud/talent/v4beta1/batch_pb'
 require 'google/cloud/talent/v4beta1/common_pb'
 require 'google/cloud/talent/v4beta1/filters_pb'
 require 'google/cloud/talent/v4beta1/histogram_pb'

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

@@ -57,26 +57,22 @@ module Google
             rpc :ListJobs, ListJobsRequest, ListJobsResponse
             # Deletes a list of [Job][google.cloud.talent.v4beta1.Job]s by filter.
             rpc :BatchDeleteJobs, BatchDeleteJobsRequest, Google::Protobuf::Empty
-            # Searches for jobs using the provided
-            # [SearchJobsRequest][google.cloud.talent.v4beta1.SearchJobsRequest].
+            # Searches for jobs using the provided [SearchJobsRequest][google.cloud.talent.v4beta1.SearchJobsRequest].
             #
-            # This call constrains the
-            # [visibility][google.cloud.talent.v4beta1.Job.visibility] of jobs present in
-            # the database, and only returns jobs that the caller has permission to
-            # search against.
+            # This call constrains the [visibility][google.cloud.talent.v4beta1.Job.visibility] of jobs
+            # present in the database, and only returns jobs that the caller has
+            # permission to search against.
             rpc :SearchJobs, SearchJobsRequest, SearchJobsResponse
-            # Searches for jobs using the provided
-            # [SearchJobsRequest][google.cloud.talent.v4beta1.SearchJobsRequest].
+            # Searches for jobs using the provided [SearchJobsRequest][google.cloud.talent.v4beta1.SearchJobsRequest].
             #
             # This API call is intended for the use case of targeting passive job
             # seekers (for example, job seekers who have signed up to receive email
             # alerts about potential job opportunities), and has different algorithmic
             # adjustments that are targeted to passive job seekers.
             #
-            # This call constrains the
-            # [visibility][google.cloud.talent.v4beta1.Job.visibility] of jobs present in
-            # the database, and only returns jobs the caller has permission to search
-            # against.
+            # This call constrains the [visibility][google.cloud.talent.v4beta1.Job.visibility] of jobs
+            # present in the database, and only returns jobs the caller has
+            # permission to search against.
             rpc :SearchJobsForAlert, SearchJobsRequest, SearchJobsResponse
           end
 

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

@@ -7,6 +7,8 @@ require 'google/protobuf'
 require 'google/api/annotations_pb'
 require 'google/cloud/talent/v4beta1/common_pb'
 require 'google/cloud/talent/v4beta1/job_pb'
+require 'google/protobuf/duration_pb'
+require 'google/protobuf/field_mask_pb'
 require 'google/protobuf/timestamp_pb'
 require 'google/protobuf/wrappers_pb'
 require 'google/type/date_pb'
@@ -35,8 +37,8 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     repeated :publications, :message, 21, "google.cloud.talent.v4beta1.Publication"
     repeated :patents, :message, 22, "google.cloud.talent.v4beta1.Patent"
     repeated :certifications, :message, 23, "google.cloud.talent.v4beta1.Certification"
-    repeated :job_applications, :message, 24, "google.cloud.talent.v4beta1.JobApplication"
-    repeated :recruiting_notes, :message, 25, "google.cloud.talent.v4beta1.RecruitingNote"
+    repeated :applications, :string, 47
+    repeated :assignments, :string, 48
     map :custom_attributes, :string, :message, 26, "google.cloud.talent.v4beta1.CustomAttribute"
     optional :processed, :bool, 27
     optional :keyword_snippet, :string, 28
@@ -57,7 +59,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
   end
   add_message "google.cloud.talent.v4beta1.Address" do
     optional :usage, :enum, 1, "google.cloud.talent.v4beta1.ContactInfoUsage"
-    optional :is_current, :message, 4, "google.protobuf.BoolValue"
+    optional :current, :message, 4, "google.protobuf.BoolValue"
     oneof :address do
       optional :unstructured_address, :string, 2
       optional :structured_address, :message, 3, "google.type.PostalAddress"
@@ -101,7 +103,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     optional :address, :message, 5, "google.cloud.talent.v4beta1.Address"
     optional :job_title, :string, 6
     optional :job_description, :string, 7
-    optional :is_supervised_position, :message, 8, "google.protobuf.BoolValue"
+    optional :is_supervisor, :message, 8, "google.protobuf.BoolValue"
     optional :is_self_employed, :message, 9, "google.protobuf.BoolValue"
     optional :is_current, :message, 10, "google.protobuf.BoolValue"
     optional :job_title_snippet, :string, 11
@@ -128,21 +130,6 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     optional :degree_name, :string, 2
     repeated :fields_of_study, :string, 3
   end
-  add_message "google.cloud.talent.v4beta1.Skill" do
-    optional :display_name, :string, 1
-    optional :last_used_date, :message, 2, "google.type.Date"
-    optional :level, :enum, 3, "google.cloud.talent.v4beta1.Skill.SkillProficiencyLevel"
-    optional :context, :string, 4
-    optional :skill_name_snippet, :string, 5
-  end
-  add_enum "google.cloud.talent.v4beta1.Skill.SkillProficiencyLevel" do
-    value :SKILL_PROFICIENCY_LEVEL_UNSPECIFIED, 0
-    value :FUNDAMENTAL_AWARENESS, 1
-    value :NOVICE, 2
-    value :INTERMEDIATE, 3
-    value :ADVANCED, 4
-    value :EXPERT, 5
-  end
   add_message "google.cloud.talent.v4beta1.Activity" do
     optional :display_name, :string, 1
     optional :description, :string, 2
@@ -177,45 +164,6 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     optional :patent_description, :string, 8
     repeated :skills_used, :message, 9, "google.cloud.talent.v4beta1.Skill"
   end
-  add_message "google.cloud.talent.v4beta1.JobApplication" do
-    optional :job, :message, 1, "google.cloud.talent.v4beta1.Job"
-    optional :application_id, :string, 2
-    optional :application_date, :message, 3, "google.type.Date"
-    optional :last_stage, :string, 4
-    optional :state, :enum, 5, "google.cloud.talent.v4beta1.JobApplication.ApplicationStatus"
-    optional :average_interview_score, :double, 6
-    optional :interview_score_scale_id, :string, 7
-    optional :number_of_interviews, :int32, 8
-    optional :is_employee_referred, :message, 9, "google.protobuf.BoolValue"
-    optional :update_time, :message, 10, "google.protobuf.Timestamp"
-    optional :outcome_reason, :string, 11
-    optional :outcome_positiveness, :double, 12
-    optional :is_match, :message, 13, "google.protobuf.BoolValue"
-    optional :job_title_snippet, :string, 14
-  end
-  add_enum "google.cloud.talent.v4beta1.JobApplication.ApplicationStatus" do
-    value :APPLICATION_STATUS_UNSPECIFIED, 0
-    value :OFFER_EXTENDED, 1
-    value :REJECTED_BY_CANDIDATE, 2
-    value :ACTIVE, 3
-    value :REJECTED_BY_EMPLOYER, 4
-    value :HIRED_PENDING_DATE, 5
-    value :HIRED_STARTED, 6
-    value :PROSPECTED, 7
-  end
-  add_message "google.cloud.talent.v4beta1.Certification" do
-    optional :display_name, :string, 1
-    optional :acquire_date, :message, 2, "google.type.Date"
-    optional :expire_date, :message, 3, "google.type.Date"
-    optional :authority, :string, 4
-    optional :description, :string, 5
-  end
-  add_message "google.cloud.talent.v4beta1.RecruitingNote" do
-    optional :note, :string, 1
-    optional :commenter, :string, 2
-    optional :create_date, :message, 3, "google.type.Date"
-    optional :type, :string, 4
-  end
 end
 
 module Google
@@ -234,15 +182,9 @@ module Google
         EmploymentRecord = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.talent.v4beta1.EmploymentRecord").msgclass
         EducationRecord = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.talent.v4beta1.EducationRecord").msgclass
         Degree = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.talent.v4beta1.Degree").msgclass
-        Skill = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.talent.v4beta1.Skill").msgclass
-        Skill::SkillProficiencyLevel = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.talent.v4beta1.Skill.SkillProficiencyLevel").enummodule
         Activity = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.talent.v4beta1.Activity").msgclass
         Publication = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.talent.v4beta1.Publication").msgclass
         Patent = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.talent.v4beta1.Patent").msgclass
-        JobApplication = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.talent.v4beta1.JobApplication").msgclass
-        JobApplication::ApplicationStatus = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.talent.v4beta1.JobApplication.ApplicationStatus").enummodule
-        Certification = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.talent.v4beta1.Certification").msgclass
-        RecruitingNote = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.talent.v4beta1.RecruitingNote").msgclass
       end
     end
   end

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

@@ -73,28 +73,17 @@ module Google
           ].freeze
 
 
-          TENANT_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
-            "projects/{project}/tenants/{tenant}"
-          )
-
-          private_constant :TENANT_PATH_TEMPLATE
-
           PROFILE_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
             "projects/{project}/tenants/{tenant}/profiles/{profile}"
           )
 
           private_constant :PROFILE_PATH_TEMPLATE
 
-          # Returns a fully-qualified tenant resource name string.
-          # @param project [String]
-          # @param tenant [String]
-          # @return [String]
-          def self.tenant_path project, tenant
-            TENANT_PATH_TEMPLATE.render(
-              :"project" => project,
-              :"tenant" => tenant
-            )
-          end
+          TENANT_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
+            "projects/{project}/tenants/{tenant}"
+          )
+
+          private_constant :TENANT_PATH_TEMPLATE
 
           # Returns a fully-qualified profile resource name string.
           # @param project [String]
@@ -109,6 +98,17 @@ module Google
             )
           end
 
+          # Returns a fully-qualified tenant resource name string.
+          # @param project [String]
+          # @param tenant [String]
+          # @return [String]
+          def self.tenant_path project, tenant
+            TENANT_PATH_TEMPLATE.render(
+              :"project" => project,
+              :"tenant" => tenant
+            )
+          end
+
           # @param credentials [Google::Auth::Credentials, String, Hash, GRPC::Core::Channel, GRPC::Core::ChannelCredentials, Proc]
           #   Provides the means for authenticating requests made by the client. This parameter can
           #   be many types.
@@ -215,32 +215,50 @@ module Google
             @list_profiles = Google::Gax.create_api_call(
               @profile_service_stub.method(:list_profiles),
               defaults["list_profiles"],
-              exception_transformer: exception_transformer
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'parent' => request.parent}
+              end
             )
             @create_profile = Google::Gax.create_api_call(
               @profile_service_stub.method(:create_profile),
               defaults["create_profile"],
-              exception_transformer: exception_transformer
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'parent' => request.parent}
+              end
             )
             @get_profile = Google::Gax.create_api_call(
               @profile_service_stub.method(:get_profile),
               defaults["get_profile"],
-              exception_transformer: exception_transformer
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'name' => request.name}
+              end
             )
             @update_profile = Google::Gax.create_api_call(
               @profile_service_stub.method(:update_profile),
               defaults["update_profile"],
-              exception_transformer: exception_transformer
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'profile.name' => request.profile.name}
+              end
             )
             @delete_profile = Google::Gax.create_api_call(
               @profile_service_stub.method(:delete_profile),
               defaults["delete_profile"],
-              exception_transformer: exception_transformer
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'name' => request.name}
+              end
             )
             @search_profiles = Google::Gax.create_api_call(
               @profile_service_stub.method(:search_profiles),
               defaults["search_profiles"],
-              exception_transformer: exception_transformer
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'parent' => request.parent}
+              end
             )
           end
 
@@ -261,7 +279,7 @@ module Google
           #   parameter does not affect the return value. If page streaming is
           #   performed per-page, this determines the maximum number of
           #   resources in a page.
-          # @param field_mask [Google::Protobuf::FieldMask | Hash]
+          # @param read_mask [Google::Protobuf::FieldMask | Hash]
           #   Optional.
           #
           #   A field mask to specify the profile fields to be listed in response.
@@ -287,16 +305,16 @@ module Google
           # @example
           #   require "google/cloud/talent"
           #
-          #   profile_service_client = Google::Cloud::Talent::ProfileService.new(version: :v4beta1)
+          #   profile_client = Google::Cloud::Talent::ProfileService.new(version: :v4beta1)
           #   formatted_parent = Google::Cloud::Talent::V4beta1::ProfileServiceClient.tenant_path("[PROJECT]", "[TENANT]")
           #
           #   # Iterate over all results.
-          #   profile_service_client.list_profiles(formatted_parent).each do |element|
+          #   profile_client.list_profiles(formatted_parent).each do |element|
           #     # Process element.
           #   end
           #
           #   # Or iterate over results one page at a time.
-          #   profile_service_client.list_profiles(formatted_parent).each_page do |page|
+          #   profile_client.list_profiles(formatted_parent).each_page do |page|
           #     # Process each page at a time.
           #     page.each do |element|
           #       # Process element.
@@ -306,13 +324,13 @@ module Google
           def list_profiles \
               parent,
               page_size: nil,
-              field_mask: nil,
+              read_mask: nil,
               options: nil,
               &block
             req = {
               parent: parent,
               page_size: page_size,
-              field_mask: field_mask
+              read_mask: read_mask
             }.delete_if { |_, v| v.nil? }
             req = Google::Gax::to_proto(req, Google::Cloud::Talent::V4beta1::ListProfilesRequest)
             @list_profiles.call(req, options, &block)
@@ -344,12 +362,12 @@ module Google
           # @example
           #   require "google/cloud/talent"
           #
-          #   profile_service_client = Google::Cloud::Talent::ProfileService.new(version: :v4beta1)
+          #   profile_client = Google::Cloud::Talent::ProfileService.new(version: :v4beta1)
           #   formatted_parent = Google::Cloud::Talent::V4beta1::ProfileServiceClient.tenant_path("[PROJECT]", "[TENANT]")
           #
           #   # TODO: Initialize `profile`:
           #   profile = {}
-          #   response = profile_service_client.create_profile(formatted_parent, profile)
+          #   response = profile_client.create_profile(formatted_parent, profile)
 
           def create_profile \
               parent,
@@ -385,9 +403,9 @@ module Google
           # @example
           #   require "google/cloud/talent"
           #
-          #   profile_service_client = Google::Cloud::Talent::ProfileService.new(version: :v4beta1)
+          #   profile_client = Google::Cloud::Talent::ProfileService.new(version: :v4beta1)
           #   formatted_name = Google::Cloud::Talent::V4beta1::ProfileServiceClient.profile_path("[PROJECT]", "[TENANT]", "[PROFILE]")
-          #   response = profile_service_client.get_profile(formatted_name)
+          #   response = profile_client.get_profile(formatted_name)
 
           def get_profile \
               name,
@@ -437,9 +455,9 @@ module Google
           #   * publications
           #   * patents
           #   * certifications
-          #   * jobApplications
           #   * recruitingNotes
           #   * customAttributes
+          #   * groupId
           #   A hash of the same form as `Google::Protobuf::FieldMask`
           #   can also be provided.
           # @param options [Google::Gax::CallOptions]
@@ -453,11 +471,11 @@ module Google
           # @example
           #   require "google/cloud/talent"
           #
-          #   profile_service_client = Google::Cloud::Talent::ProfileService.new(version: :v4beta1)
+          #   profile_client = Google::Cloud::Talent::ProfileService.new(version: :v4beta1)
           #
           #   # TODO: Initialize `profile`:
           #   profile = {}
-          #   response = profile_service_client.update_profile(profile)
+          #   response = profile_client.update_profile(profile)
 
           def update_profile \
               profile,
@@ -473,6 +491,8 @@ module Google
           end
 
           # Deletes the specified profile.
+          # Prerequisite: The profile has no associated applications or assignments
+          # associated.
           #
           # @param name [String]
           #   Required.
@@ -492,9 +512,9 @@ module Google
           # @example
           #   require "google/cloud/talent"
           #
-          #   profile_service_client = Google::Cloud::Talent::ProfileService.new(version: :v4beta1)
+          #   profile_client = Google::Cloud::Talent::ProfileService.new(version: :v4beta1)
           #   formatted_name = Google::Cloud::Talent::V4beta1::ProfileServiceClient.profile_path("[PROJECT]", "[TENANT]", "[PROFILE]")
-          #   profile_service_client.delete_profile(formatted_name)
+          #   profile_client.delete_profile(formatted_name)
 
           def delete_profile \
               name,
@@ -513,9 +533,7 @@ module Google
           # For example, search by raw queries "software engineer in Mountain View" or
           # search by structured filters (location filter, education filter, etc.).
           #
-          # See
-          # {Google::Cloud::Talent::V4beta1::SearchProfilesRequest SearchProfilesRequest}
-          # for more information.
+          # See {Google::Cloud::Talent::V4beta1::SearchProfilesRequest SearchProfilesRequest} for more information.
           #
           # @param parent [String]
           #   Required.
@@ -535,8 +553,7 @@ module Google
           # @param profile_query [Google::Cloud::Talent::V4beta1::ProfileQuery | Hash]
           #   Optional.
           #
-          #   Search query to execute. See
-          #   {Google::Cloud::Talent::V4beta1::ProfileQuery ProfileQuery} for more details.
+          #   Search query to execute. See {Google::Cloud::Talent::V4beta1::ProfileQuery ProfileQuery} for more details.
           #   A hash of the same form as `Google::Cloud::Talent::V4beta1::ProfileQuery`
           #   can also be provided.
           # @param page_size [Integer]
@@ -549,9 +566,7 @@ module Google
           #   Optional.
           #
           #   An integer that specifies the current offset (that is, starting result) in
-          #   search results. This field is only considered if
-          #   {Google::Cloud::Talent::V4beta1::SearchProfilesRequest#page_token page_token}
-          #   is unset.
+          #   search results. This field is only considered if {Google::Cloud::Talent::V4beta1::SearchProfilesRequest#page_token page_token} is unset.
           #
           #   The maximum allowed value is 5000. Otherwise an error is thrown.
           #
@@ -597,8 +612,7 @@ module Google
           #   Optional.
           #
           #   A list of expressions specifies histogram requests against matching
-          #   profiles for
-          #   {Google::Cloud::Talent::V4beta1::SearchProfilesRequest SearchProfilesRequest}.
+          #   profiles for {Google::Cloud::Talent::V4beta1::SearchProfilesRequest SearchProfilesRequest}.
           #
           #   The expression syntax looks like a function definition with optional
           #   parameters.
@@ -646,34 +660,24 @@ module Google
           #   * institution: The school name. For example, "MIT",
           #     "University of California, Berkeley"
           #   * degree: Highest education degree in ISCED code. Each value in degree
-          #     covers specific level of education, without any expansion to upper nor
+          #     covers a specific level of education, without any expansion to upper nor
           #     lower levels of education degree.
           #   * experience_in_months: experience in months. 0 means 0 month to 1 month
           #     (exclusive).
           #   * application_date: The application date specifies application start dates.
-          #     See
-          #     {Google::Cloud::Talent::V4beta1::ApplicationDateFilter ApplicationDateFilter}
-          #     for more details.
-          #   * application_outcome_reason: The application outcome reason specifies the
-          #     outcome reasons of job application.
-          #     See
-          #     {Google::Cloud::Talent::V4beta1::ApplicationOutcomeReasonFilter ApplicationOutcomeReasonFilter}
-          #     for more details.
+          #     See {Google::Cloud::Talent::V4beta1::ApplicationDateFilter ApplicationDateFilter} for more details.
+          #   * application_outcome_notes: The application outcome reason specifies the
+          #     reasons behind the outcome of the job application.
+          #     See {Google::Cloud::Talent::V4beta1::ApplicationOutcomeNotesFilter ApplicationOutcomeNotesFilter} for more details.
           #   * application_last_stage: The application last stage specifies the last
           #     stage of job application.
-          #     See
-          #     {Google::Cloud::Talent::V4beta1::ApplicationLastStageFilter ApplicationLastStageFilter}
-          #     for more details.
+          #     See {ApplicationLastStageFilter} for more details.
           #   * application_job_title: The application job title specifies the job
           #     applied for in the application.
-          #     See
-          #     {Google::Cloud::Talent::V4beta1::ApplicationJobFilter ApplicationJobFilter}
-          #     for more details.
+          #     See {Google::Cloud::Talent::V4beta1::ApplicationJobFilter ApplicationJobFilter} for more details.
           #   * application_status: The application status specifies the status of job
           #     application.
-          #     See
-          #     {Google::Cloud::Talent::V4beta1::ApplicationStatusFilter ApplicationStatusFilter}
-          #     for more details.
+          #     See {ApplicationStatusFilter} for more details.
           #   * hirable_status: Hirable status specifies the profile's hirable status.
           #   * string_custom_attribute: String custom attributes. Values can be accessed
           #     via square bracket notation like string_custom_attribute["key1"].
@@ -705,19 +709,19 @@ module Google
           # @example
           #   require "google/cloud/talent"
           #
-          #   profile_service_client = Google::Cloud::Talent::ProfileService.new(version: :v4beta1)
+          #   profile_client = Google::Cloud::Talent::ProfileService.new(version: :v4beta1)
           #   formatted_parent = Google::Cloud::Talent::V4beta1::ProfileServiceClient.tenant_path("[PROJECT]", "[TENANT]")
           #
           #   # TODO: Initialize `request_metadata`:
           #   request_metadata = {}
           #
           #   # Iterate over all results.
-          #   profile_service_client.search_profiles(formatted_parent, request_metadata).each do |element|
+          #   profile_client.search_profiles(formatted_parent, request_metadata).each do |element|
           #     # Process element.
           #   end
           #
           #   # Or iterate over results one page at a time.
-          #   profile_service_client.search_profiles(formatted_parent, request_metadata).each_page do |page|
+          #   profile_client.search_profiles(formatted_parent, request_metadata).each_page do |page|
           #     # Process each page at a time.
           #     page.each do |element|
           #       # Process element.