google-cloud-talent 0.1.0 → 0.2.0

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

@@ -32,9 +32,8 @@ module Google
         #
         #     The token that specifies the current offset (that is, starting result).
         #
-        #     Please set the value to
-        #     {Google::Cloud::Talent::V4beta1::ListProfilesResponse#next_page_token ListProfilesResponse#next_page_token}
-        #     to continue the list.
+        #     Please set the value to {Google::Cloud::Talent::V4beta1::ListProfilesResponse#next_page_token ListProfilesResponse#next_page_token} to
+        #     continue the list.
         # @!attribute [rw] page_size
         #   @return [Integer]
         #     Optional.
@@ -42,7 +41,7 @@ module Google
         #     The maximum number of profiles to be returned, at most 100.
         #
         #     Default is 100 unless a positive number smaller than 100 is specified.
-        # @!attribute [rw] field_mask
+        # @!attribute [rw] read_mask
         #   @return [Google::Protobuf::FieldMask]
         #     Optional.
         #
@@ -128,9 +127,9 @@ module Google
         #     * publications
         #     * patents
         #     * certifications
-        #     * jobApplications
         #     * recruitingNotes
         #     * customAttributes
+        #     * groupId
         class UpdateProfileRequest; end
 
         # Delete profile request.
@@ -165,8 +164,7 @@ module Google
         #   @return [Google::Cloud::Talent::V4beta1::ProfileQuery]
         #     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.
         # @!attribute [rw] page_size
         #   @return [Integer]
         #     Optional.
@@ -182,18 +180,16 @@ module Google
         #     The pageToken, similar to offset enables users of the API to paginate
         #     through the search results. To retrieve the first page of results, set the
         #     pageToken to empty. The search response includes a
-        #     {Google::Cloud::Talent::V4beta1::SearchProfilesResponse#next_page_token nextPageToken}
-        #     field that can be used to populate the pageToken field for the next page of
-        #     results. Using pageToken instead of offset increases the performance of the
-        #     API, especially compared to larger offset values.
+        #     {Google::Cloud::Talent::V4beta1::SearchProfilesResponse#next_page_token nextPageToken} field that can be
+        #     used to populate the pageToken field for the next page of results. Using
+        #     pageToken instead of offset increases the performance of the API,
+        #     especially compared to larger offset values.
         # @!attribute [rw] offset
         #   @return [Integer]
         #     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.
         #
@@ -243,8 +239,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.
@@ -292,34 +287,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"].
@@ -359,14 +344,12 @@ module Google
         #     {Google::Cloud::Talent::V4beta1::SearchProfilesRequest#histogram_queries SearchProfilesRequest#histogram_queries}.
         # @!attribute [rw] summarized_profiles
         #   @return [Array<Google::Cloud::Talent::V4beta1::SummarizedProfile>]
-        #     The profile entities that match the specified
-        #     {Google::Cloud::Talent::V4beta1::SearchProfilesRequest SearchProfilesRequest}.
+        #     The profile entities that match the specified {Google::Cloud::Talent::V4beta1::SearchProfilesRequest SearchProfilesRequest}.
         class SearchProfilesResponse; end
 
         # Output only.
         #
-        # Profile entry with metadata inside
-        # {Google::Cloud::Talent::V4beta1::SearchProfilesResponse SearchProfilesResponse}.
+        # Profile entry with metadata inside {Google::Cloud::Talent::V4beta1::SearchProfilesResponse SearchProfilesResponse}.
         # @!attribute [rw] profiles
         #   @return [Array<Google::Cloud::Talent::V4beta1::Profile>]
         #     A list of profiles that are linked by {Profile#cluster_id}.

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

@@ -44,9 +44,7 @@ module Google
         #     Indicates whether data owned by this tenant may be used to provide product
         #     improvements across other tenants.
         #
-        #     Defaults behavior is
-        #     {Google::Cloud::Talent::V4beta1::Tenant::DataUsageType::ISOLATED DataUsageType::ISOLATED}
-        #     if it's unset.
+        #     Defaults behavior is {Google::Cloud::Talent::V4beta1::Tenant::DataUsageType::ISOLATED DataUsageType::ISOLATED} if it's unset.
         class Tenant
           # Enum that represents how user data owned by the tenant is used.
           module DataUsageType

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

@@ -55,15 +55,11 @@ module Google
         #     Optional but strongly recommended for the best service
         #     experience.
         #
-        #     If
-        #     {Google::Cloud::Talent::V4beta1::UpdateTenantRequest#update_mask update_mask}
-        #     is provided, only the specified fields in
-        #     {Google::Cloud::Talent::V4beta1::UpdateTenantRequest#tenant tenant} are
-        #     updated. Otherwise all the fields are updated.
+        #     If {Google::Cloud::Talent::V4beta1::UpdateTenantRequest#update_mask update_mask} is provided, only the specified fields in
+        #     {Google::Cloud::Talent::V4beta1::UpdateTenantRequest#tenant tenant} are updated. Otherwise all the fields are updated.
         #
         #     A field mask to specify the tenant fields to be updated. Only
-        #     top level fields of {Google::Cloud::Talent::V4beta1::Tenant Tenant} are
-        #     supported.
+        #     top level fields of {Google::Cloud::Talent::V4beta1::Tenant Tenant} are supported.
         class UpdateTenantRequest; end
 
         # Request to delete a tenant.

data/lib/google/cloud/talent/v4beta1/doc/google/protobuf/field_mask.rb

@@ -83,57 +83,49 @@ module Google
     # describe the updated values, the API ignores the values of all
     # fields not covered by the mask.
     #
-    # If a repeated field is specified for an update operation, the existing
-    # repeated values in the target resource will be overwritten by the new values.
-    # Note that a repeated field is only allowed in the last position of a `paths`
-    # string.
+    # If a repeated field is specified for an update operation, new values will
+    # be appended to the existing repeated field in the target resource. Note that
+    # a repeated field is only allowed in the last position of a `paths` string.
     #
     # If a sub-message is specified in the last position of the field mask for an
-    # update operation, then the existing sub-message in the target resource is
-    # overwritten. Given the target message:
+    # update operation, then new value will be merged into the existing sub-message
+    # in the target resource.
+    #
+    # For example, given the target message:
     #
     #     f {
     #       b {
-    #         d : 1
-    #         x : 2
+    #         d: 1
+    #         x: 2
     #       }
-    #       c : 1
+    #       c: [1]
     #     }
     #
     # And an update message:
     #
     #     f {
     #       b {
-    #         d : 10
+    #         d: 10
     #       }
+    #       c: [2]
     #     }
     #
     # then if the field mask is:
     #
-    #  paths: "f.b"
+    #  paths: ["f.b", "f.c"]
     #
     # then the result will be:
     #
     #     f {
     #       b {
-    #         d : 10
+    #         d: 10
+    #         x: 2
     #       }
-    #       c : 1
+    #       c: [1, 2]
     #     }
     #
-    # However, if the update mask was:
-    #
-    #  paths: "f.b.d"
-    #
-    # then the result would be:
-    #
-    #     f {
-    #       b {
-    #         d : 10
-    #         x : 2
-    #       }
-    #       c : 1
-    #     }
+    # An implementation may provide options to override this default behavior for
+    # repeated and message fields.
     #
     # In order to reset a field's value to the default, the field must
     # be in the mask and set to the default value in the provided resource.

data/lib/google/cloud/talent/v4beta1/doc/google/protobuf/timestamp.rb

@@ -15,17 +15,19 @@
 
 module Google
   module Protobuf
-    # A Timestamp represents a point in time independent of any time zone
-    # or calendar, represented as seconds and fractions of seconds at
-    # nanosecond resolution in UTC Epoch time. It is encoded using the
-    # Proleptic Gregorian Calendar which extends the Gregorian calendar
-    # backwards to year one. It is encoded assuming all minutes are 60
-    # seconds long, i.e. leap seconds are "smeared" so that no leap second
-    # table is needed for interpretation. Range is from
-    # 0001-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z.
-    # By restricting to that range, we ensure that we can convert to
-    # and from  RFC 3339 date strings.
-    # See [https://www.ietf.org/rfc/rfc3339.txt](https://www.ietf.org/rfc/rfc3339.txt).
+    # A Timestamp represents a point in time independent of any time zone or local
+    # calendar, encoded as a count of seconds and fractions of seconds at
+    # nanosecond resolution. The count is relative to an epoch at UTC midnight on
+    # January 1, 1970, in the proleptic Gregorian calendar which extends the
+    # Gregorian calendar backwards to year one.
+    #
+    # All minutes are 60 seconds long. Leap seconds are "smeared" so that no leap
+    # second table is needed for interpretation, using a [24-hour linear
+    # smear](https://developers.google.com/time/smear).
+    #
+    # The range is from 0001-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z. By
+    # restricting to that range, we ensure that we can convert to and from [RFC
+    # 3339](https://www.ietf.org/rfc/rfc3339.txt) date strings.
     #
     # = Examples
     #
@@ -86,12 +88,12 @@ module Google
     # 01:30 UTC on January 15, 2017.
     #
     # In JavaScript, one can convert a Date object to this format using the
-    # standard [toISOString()](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toISOString]
+    # standard [toISOString()](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toISOString)
     # method. In Python, a standard `datetime.datetime` object can be converted
     # to this format using [`strftime`](https://docs.python.org/2/library/time.html#time.strftime)
     # with the time format spec '%Y-%m-%dT%H:%M:%S.%fZ'. Likewise, in Java, one
     # can use the Joda Time's [`ISODateTimeFormat.dateTime()`](
-    # http://www.joda.org/joda-time/apidocs/org/joda/time/format/ISODateTimeFormat.html#dateTime--
+    # http://www.joda.org/joda-time/apidocs/org/joda/time/format/ISODateTimeFormat.html#dateTime%2D%2D
     # ) to obtain a formatter capable of generating timestamps in this format.
     # @!attribute [rw] seconds
     #   @return [Integer]

data/lib/google/cloud/talent/v4beta1/doc/google/type/date.rb

@@ -15,25 +15,29 @@
 
 module Google
   module Type
-    # Represents a whole calendar date, e.g. date of birth. The time of day and
-    # time zone are either specified elsewhere or are not significant. The date
-    # is relative to the Proleptic Gregorian Calendar. The day may be 0 to
-    # represent a year and month where the day is not significant, e.g. credit card
-    # expiration date. The year may be 0 to represent a month and day independent
-    # of year, e.g. anniversary date. Related types are
-    # {Google::Type::TimeOfDay} and
-    # `google.protobuf.Timestamp`.
+    # Represents a whole or partial calendar date, e.g. a birthday. The time of day
+    # and time zone are either specified elsewhere or are not significant. The date
+    # is relative to the Proleptic Gregorian Calendar. This can represent:
+    #
+    # * A full date, with non-zero year, month and day values
+    # * A month and day value, with a zero year, e.g. an anniversary
+    # * A year on its own, with zero month and day values
+    # * A year and month value, with a zero day, e.g. a credit card expiration date
+    #
+    # Related types are {Google::Type::TimeOfDay} and `google.protobuf.Timestamp`.
     # @!attribute [rw] year
     #   @return [Integer]
     #     Year of date. Must be from 1 to 9999, or 0 if specifying a date without
     #     a year.
     # @!attribute [rw] month
     #   @return [Integer]
-    #     Month of year. Must be from 1 to 12.
+    #     Month of year. Must be from 1 to 12, or 0 if specifying a year without a
+    #     month and day.
     # @!attribute [rw] day
     #   @return [Integer]
     #     Day of month. Must be from 1 to 31 and valid for the year and month, or 0
-    #     if specifying a year/month where the day is not significant.
+    #     if specifying a year by itself or a year and month where the day is not
+    #     significant.
     class Date; end
   end
 end

data/lib/google/cloud/talent/v4beta1/doc/google/type/latlng.rb

@@ -20,40 +20,6 @@ module Google
     # specified otherwise, this must conform to the
     # <a href="http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf">WGS84
     # standard</a>. Values must be within normalized ranges.
-    #
-    # Example of normalization code in Python:
-    #
-    #     def NormalizeLongitude(longitude):
-    #       """Wraps decimal degrees longitude to [-180.0, 180.0]."""
-    #       q, r = divmod(longitude, 360.0)
-    #       if r > 180.0 or (r == 180.0 and q <= -1.0):
-    #         return r - 360.0
-    #       return r
-    #
-    #     def NormalizeLatLng(latitude, longitude):
-    #       """Wraps decimal degrees latitude and longitude to
-    #       [-90.0, 90.0] and [-180.0, 180.0], respectively."""
-    #       r = latitude % 360.0
-    #       if r <= 90.0:
-    #         return r, NormalizeLongitude(longitude)
-    #       elif r >= 270.0:
-    #         return r - 360, NormalizeLongitude(longitude)
-    #       else:
-    #         return 180 - r, NormalizeLongitude(longitude + 180.0)
-    #
-    #     assert 180.0 == NormalizeLongitude(180.0)
-    #     assert -180.0 == NormalizeLongitude(-180.0)
-    #     assert -179.0 == NormalizeLongitude(181.0)
-    #     assert (0.0, 0.0) == NormalizeLatLng(360.0, 0.0)
-    #     assert (0.0, 0.0) == NormalizeLatLng(-360.0, 0.0)
-    #     assert (85.0, 180.0) == NormalizeLatLng(95.0, 0.0)
-    #     assert (-85.0, -170.0) == NormalizeLatLng(-95.0, 10.0)
-    #     assert (90.0, 10.0) == NormalizeLatLng(90.0, 10.0)
-    #     assert (-90.0, -10.0) == NormalizeLatLng(-90.0, -10.0)
-    #     assert (0.0, -170.0) == NormalizeLatLng(-180.0, 10.0)
-    #     assert (0.0, -170.0) == NormalizeLatLng(180.0, 10.0)
-    #     assert (-90.0, 10.0) == NormalizeLatLng(270.0, 10.0)
-    #     assert (90.0, 10.0) == NormalizeLatLng(-270.0, 10.0)
     # @!attribute [rw] latitude
     #   @return [Float]
     #     The latitude in degrees. It must be in the range [-90.0, +90.0].

data/lib/google/cloud/talent/v4beta1/doc/google/type/timeofday.rb

@@ -16,9 +16,8 @@
 module Google
   module Type
     # Represents a time of day. The date and time zone are either not significant
-    # or are specified elsewhere. An API may chose to allow leap seconds. Related
-    # types are {Google::Type::Date} and
-    # `google.protobuf.Timestamp`.
+    # or are specified elsewhere. An API may choose to allow leap seconds. Related
+    # types are {Google::Type::Date} and `google.protobuf.Timestamp`.
     # @!attribute [rw] hours
     #   @return [Integer]
     #     Hours of day in 24 hour format. Should be from 0 to 23. An API may choose

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

@@ -11,7 +11,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     optional :request_id, :string, 1
     optional :event_id, :string, 2
     optional :create_time, :message, 4, "google.protobuf.Timestamp"
-    map :extra_info, :string, :string, 7
+    optional :event_notes, :string, 9
     oneof :event do
       optional :job_event, :message, 5, "google.cloud.talent.v4beta1.JobEvent"
       optional :profile_event, :message, 6, "google.cloud.talent.v4beta1.ProfileEvent"
@@ -43,20 +43,13 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
   add_message "google.cloud.talent.v4beta1.ProfileEvent" do
     optional :type, :enum, 1, "google.cloud.talent.v4beta1.ProfileEvent.ProfileEventType"
     repeated :profiles, :string, 2
-    optional :job_id, :string, 3
+    repeated :jobs, :string, 6
   end
   add_enum "google.cloud.talent.v4beta1.ProfileEvent.ProfileEventType" do
     value :PROFILE_EVENT_TYPE_UNSPECIFIED, 0
     value :IMPRESSION, 1
     value :VIEW, 2
     value :BOOKMARK, 3
-    value :COMMENT_ADDED, 4
-    value :EMAIL_SENT, 5
-    value :RESUME_VIEWED, 6
-    value :ADD_TO_JOB, 7
-    value :POSITIVE_REACTION_TO_PROFILE, 8
-    value :NEGATIVE_REACTION_TO_PROFILE, 9
-    value :SCREEN, 10
   end
 end
 

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

@@ -59,18 +59,20 @@ module Google
           ].freeze
 
 
-          PROJECT_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
-            "projects/{project}"
+          TENANT_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
+            "projects/{project}/tenants/{tenant}"
           )
 
-          private_constant :PROJECT_PATH_TEMPLATE
+          private_constant :TENANT_PATH_TEMPLATE
 
-          # Returns a fully-qualified project resource name string.
+          # Returns a fully-qualified tenant resource name string.
           # @param project [String]
+          # @param tenant [String]
           # @return [String]
-          def self.project_path project
-            PROJECT_PATH_TEMPLATE.render(
-              :"project" => project
+          def self.tenant_path project, tenant
+            TENANT_PATH_TEMPLATE.render(
+              :"project" => project,
+              :"tenant" => tenant
             )
           end
 
@@ -179,7 +181,10 @@ module Google
             @create_client_event = Google::Gax.create_api_call(
               @event_service_stub.method(:create_client_event),
               defaults["create_client_event"],
-              exception_transformer: exception_transformer
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'parent' => request.parent}
+              end
             )
           end
 
@@ -190,11 +195,19 @@ module Google
           # [self service
           # tools](https://console.cloud.google.com/talent-solution/overview).
           # [Learn
-          # more](https://cloud.google.com/talent-solution/job-search/docs/management-tools)
+          # more](https://cloud.google.com/talent-solution/docs/management-tools)
           # about self service tools.
           #
           # @param parent [String]
-          #   Parent project name.
+          #   Required.
+          #
+          #   Resource name of the tenant under which the event is created.
+          #
+          #   The format is "projects/{project_id}/tenants/{tenant_id}", for example,
+          #   "projects/api-test-project/tenant/foo".
+          #
+          #   Tenant id is optional and a default tenant is created if unspecified, for
+          #   example, "projects/api-test-project".
           # @param client_event [Google::Cloud::Talent::V4beta1::ClientEvent | Hash]
           #   Required.
           #
@@ -213,12 +226,12 @@ module Google
           # @example
           #   require "google/cloud/talent"
           #
-          #   event_service_client = Google::Cloud::Talent::Event.new(version: :v4beta1)
-          #   formatted_parent = Google::Cloud::Talent::V4beta1::EventServiceClient.project_path("[PROJECT]")
+          #   event_client = Google::Cloud::Talent::Event.new(version: :v4beta1)
+          #   formatted_parent = Google::Cloud::Talent::V4beta1::EventServiceClient.tenant_path("[PROJECT]", "[TENANT]")
           #
           #   # TODO: Initialize `client_event`:
           #   client_event = {}
-          #   response = event_service_client.create_client_event(formatted_parent, client_event)
+          #   response = event_client.create_client_event(formatted_parent, client_event)
 
           def create_client_event \
               parent,