google-cloud-talent 0.5.0 → 0.6.0

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

@@ -23,25 +23,43 @@ module Google
         #     Required. The resource name of the tenant under which the profile is
         #     created.
         #
-        #     The format is "projects/{project_id}/tenants/{tenant_id}", for example,
-        #     "projects/api-test-project/tenants/foo".
+        #     The format is "projects/{project_id}/tenants/{tenant_id}". For example,
+        #     "projects/foo/tenants/bar".
+        # @!attribute [rw] filter
+        #   @return [String]
+        #     The filter string specifies the profiles to be enumerated.
+        #
+        #     Supported operator: =, AND
+        #
+        #     The field(s) eligible for filtering are:
+        #
+        #     * `externalId`
+        #     * `groupId`
+        #
+        #     externalId and groupId cannot be specified at the same time. If both
+        #     externalId and groupId are provided, the API will return a bad request
+        #     error.
+        #
+        #     Sample Query:
+        #
+        #     * externalId = "externalId-1"
+        #     * groupId = "groupId-1"
         # @!attribute [rw] page_token
         #   @return [String]
-        #     Optional. The token that specifies the current offset (that is, starting
-        #     result).
+        #     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.
         # @!attribute [rw] page_size
         #   @return [Integer]
-        #     Optional. The maximum number of profiles to be returned, at most 100.
+        #     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] read_mask
         #   @return [Google::Protobuf::FieldMask]
-        #     Optional. A field mask to specify the profile fields to be listed in
-        #     response. All fields are listed if it is unset.
+        #     A field mask to specify the profile fields to be listed in response.
+        #     All fields are listed if it is unset.
         #
         #     Valid values are:
         #
@@ -63,8 +81,8 @@ module Google
         #   @return [String]
         #     Required. The name of the tenant this profile belongs to.
         #
-        #     The format is "projects/{project_id}/tenants/{tenant_id}", for example,
-        #     "projects/api-test-project/tenants/foo".
+        #     The format is "projects/{project_id}/tenants/{tenant_id}". For example,
+        #     "projects/foo/tenants/bar".
         # @!attribute [rw] profile
         #   @return [Google::Cloud::Talent::V4beta1::Profile]
         #     Required. The profile to be created.
@@ -76,8 +94,8 @@ module Google
         #     Required. Resource name of the profile to get.
         #
         #     The format is
-        #     "projects/{project_id}/tenants/{tenant_id}/profiles/{profile_id}",
-        #     for example, "projects/api-test-project/tenants/foo/profiles/bar".
+        #     "projects/{project_id}/tenants/{tenant_id}/profiles/{profile_id}". For
+        #     example, "projects/foo/tenants/bar/profiles/baz".
         class GetProfileRequest; end
 
         # Update profile request
@@ -86,17 +104,21 @@ module Google
         #     Required. Profile to be updated.
         # @!attribute [rw] update_mask
         #   @return [Google::Protobuf::FieldMask]
-        #     Optional. A field mask to specify the profile fields to update.
+        #     A field mask to specify the profile fields to update.
         #
         #     A full update is performed if it is unset.
         #
         #     Valid values are:
+        #
         #     * external_id
         #     * source
+        #     * source_types
         #     * uri
         #     * is_hirable
         #     * create_time
         #     * update_time
+        #     * candidate_update_time
+        #     * resume_update_time
         #     * resume
         #     * person_names
         #     * addresses
@@ -142,8 +164,8 @@ module Google
         #     Required. Resource name of the profile to be deleted.
         #
         #     The format is
-        #     "projects/{project_id}/tenants/{tenant_id}/profiles/{profile_id}",
-        #     for example, "projects/api-test-project/tenants/foo/profiles/bar".
+        #     "projects/{project_id}/tenants/{tenant_id}/profiles/{profile_id}". For
+        #     example, "projects/foo/tenants/bar/profiles/baz".
         class DeleteProfileRequest; end
 
         # The request body of the `SearchProfiles` call.
@@ -151,8 +173,8 @@ module Google
         #   @return [String]
         #     Required. The resource name of the tenant to search within.
         #
-        #     The format is "projects/{project_id}/tenants/{tenant_id}", for example,
-        #     "projects/api-test-project/tenants/foo".
+        #     The format is "projects/{project_id}/tenants/{tenant_id}". For example,
+        #     "projects/foo/tenants/bar".
         # @!attribute [rw] request_metadata
         #   @return [Google::Cloud::Talent::V4beta1::RequestMetadata]
         #     Required. The meta information collected about the profile search user.
@@ -160,27 +182,27 @@ module Google
         #     provided by users, and must be precise and consistent.
         # @!attribute [rw] profile_query
         #   @return [Google::Cloud::Talent::V4beta1::ProfileQuery]
-        #     Optional. Search query to execute. See
+        #     Search query to execute. See
         #     {Google::Cloud::Talent::V4beta1::ProfileQuery ProfileQuery} for more details.
         # @!attribute [rw] page_size
         #   @return [Integer]
-        #     Optional. A limit on the number of profiles returned in the search results.
+        #     A limit on the number of profiles returned in the search results.
         #     A value above the default value 10 can increase search response time.
         #
         #     The maximum value allowed is 100. Otherwise an error is thrown.
         # @!attribute [rw] page_token
         #   @return [String]
-        #     Optional. 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
+        #     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.
         # @!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
+        #     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.
         #
@@ -191,13 +213,13 @@ module Google
         #     pageSize = 10 and offset = 10 means to search from the second page.
         # @!attribute [rw] disable_spell_check
         #   @return [true, false]
-        #     Optional. This flag controls the spell-check feature. If `false`, the
+        #     This flag controls the spell-check feature. If `false`, the
         #     service attempts to correct a misspelled query.
         #
         #     For example, "enginee" is corrected to "engineer".
         # @!attribute [rw] order_by
         #   @return [String]
-        #     Optional. The criteria that determines how search results are sorted.
+        #     The criteria that determines how search results are sorted.
         #     Defaults is "relevance desc" if no value is specified.
         #
         #     Supported options are:
@@ -228,17 +250,16 @@ module Google
         #       in ascending order.
         # @!attribute [rw] case_sensitive_sort
         #   @return [true, false]
-        #     Optional. When sort by field is based on alphabetical order, sort values
-        #     case sensitively (based on ASCII) when the value is set to true. Default
-        #     value is case in-sensitive sort (false).
+        #     When sort by field is based on alphabetical order, sort values case
+        #     sensitively (based on ASCII) when the value is set to true. Default value
+        #     is case in-sensitive sort (false).
         # @!attribute [rw] histogram_queries
         #   @return [Array<Google::Cloud::Talent::V4beta1::HistogramQuery>]
-        #     Optional. A list of expressions specifies histogram requests against
-        #     matching profiles for
+        #     A list of expressions specifies histogram requests against matching
+        #     profiles for
         #     {Google::Cloud::Talent::V4beta1::SearchProfilesRequest SearchProfilesRequest}.
         #
-        #     The expression syntax looks like a function definition with optional
-        #     parameters.
+        #     The expression syntax looks like a function definition with parameters.
         #
         #     Function syntax: function_name(histogram_facet[, list of buckets])
         #
@@ -317,7 +338,7 @@ module Google
         #       [bucket(MIN, 0, "negative"), bucket(0, MAX, "non-negative")])
         # @!attribute [rw] result_set_id
         #   @return [String]
-        #     Optional. An id that uniquely identifies the result set of a
+        #     An id that uniquely identifies the result set of a
         #     {Google::Cloud::Talent::V4beta1::ProfileService::SearchProfiles SearchProfiles}
         #     call. The id should be retrieved from the
         #     {Google::Cloud::Talent::V4beta1::SearchProfilesResponse SearchProfilesResponse}
@@ -349,7 +370,7 @@ module Google
         #     to page through the results.
         # @!attribute [rw] strict_keywords_search
         #   @return [true, false]
-        #     Optional. This flag is used to indicate whether the service will attempt to
+        #     This flag is used to indicate whether the service will attempt to
         #     understand synonyms and terms related to the search query or treat the
         #     query "as is" when it generates a set of results. By default this flag is
         #     set to false, thus allowing expanded results to also be returned. For
@@ -396,8 +417,6 @@ module Google
         #     call for consistent results.
         class SearchProfilesResponse; end
 
-        # Output only.
-        #
         # Profile entry with metadata inside
         # {Google::Cloud::Talent::V4beta1::SearchProfilesResponse SearchProfilesResponse}.
         # @!attribute [rw] profiles

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

@@ -29,7 +29,7 @@ module Google
         #     tenant is created.
         #
         #     The format is "projects/{project_id}/tenants/{tenant_id}", for example,
-        #     "projects/api-test-project/tenants/foo".
+        #     "projects/foo/tenants/bar".
         # @!attribute [rw] external_id
         #   @return [String]
         #     Required. Client side tenant identifier, used to uniquely identify the
@@ -38,15 +38,15 @@ module Google
         #     The maximum number of allowed characters is 255.
         # @!attribute [rw] usage_type
         #   @return [Google::Cloud::Talent::V4beta1::Tenant::DataUsageType]
-        #     Optional. Indicates whether data owned by this tenant may be used to
-        #     provide product improvements across other tenants.
+        #     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.
         # @!attribute [rw] keyword_searchable_profile_custom_attributes
         #   @return [Array<String>]
-        #     Optional. A list of keys of filterable
+        #     A list of keys of filterable
         #     {Google::Cloud::Talent::V4beta1::Profile#custom_attributes Profile#custom_attributes},
         #     whose corresponding `string_values` are used in keyword searches. Profiles
         #     with `string_values` under these specified field keys are returned if any

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

@@ -23,7 +23,7 @@ module Google
         #     Required. Resource name of the project under which the tenant is created.
         #
         #     The format is "projects/{project_id}", for example,
-        #     "projects/api-test-project".
+        #     "projects/foo".
         # @!attribute [rw] tenant
         #   @return [Google::Cloud::Talent::V4beta1::Tenant]
         #     Required. The tenant to be created.
@@ -35,7 +35,7 @@ module Google
         #     Required. The resource name of the tenant to be retrieved.
         #
         #     The format is "projects/{project_id}/tenants/{tenant_id}", for example,
-        #     "projects/api-test-project/tenants/foo".
+        #     "projects/foo/tenants/bar".
         class GetTenantRequest; end
 
         # Request for updating a specified tenant.
@@ -45,8 +45,7 @@ module Google
         #     system.
         # @!attribute [rw] update_mask
         #   @return [Google::Protobuf::FieldMask]
-        #     Optional but strongly recommended for the best service
-        #     experience.
+        #     Strongly recommended for the best service experience.
         #
         #     If
         #     {Google::Cloud::Talent::V4beta1::UpdateTenantRequest#update_mask update_mask}
@@ -65,7 +64,7 @@ module Google
         #     Required. The resource name of the tenant to be deleted.
         #
         #     The format is "projects/{project_id}/tenants/{tenant_id}", for example,
-        #     "projects/api-test-project/tenants/foo".
+        #     "projects/foo/tenants/bar".
         class DeleteTenantRequest; end
 
         # List tenants for which the client has ACL visibility.
@@ -74,18 +73,16 @@ module Google
         #     Required. Resource name of the project under which the tenant is created.
         #
         #     The format is "projects/{project_id}", for example,
-        #     "projects/api-test-project".
+        #     "projects/foo".
         # @!attribute [rw] page_token
         #   @return [String]
-        #     Optional. The starting indicator from which to return results.
+        #     The starting indicator from which to return results.
         # @!attribute [rw] page_size
         #   @return [Integer]
-        #     Optional. The maximum number of tenants to be returned, at most 100.
+        #     The maximum number of tenants to be returned, at most 100.
         #     Default is 100 if a non-positive number is provided.
         class ListTenantsRequest; end
 
-        # Output only.
-        #
         # The List tenants response object.
         # @!attribute [rw] tenants
         #   @return [Array<Google::Cloud::Talent::V4beta1::Tenant>]

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

@@ -88,11 +88,13 @@ 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()`](
+    # 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%2D%2D
     # ) to obtain a formatter capable of generating timestamps in this format.
     # @!attribute [rw] seconds

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

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

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

@@ -224,10 +224,8 @@ module Google
           #   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".
+          #   "projects/foo/tenant/bar". If tenant id is unspecified, a default tenant
+          #   is created, for example, "projects/foo".
           # @param client_event [Google::Cloud::Talent::V4beta1::ClientEvent | Hash]
           #   Required. Events issued when end user interacts with customer's application
           #   that uses Cloud Talent Solution.

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

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

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

@@ -5,6 +5,7 @@
 require 'google/protobuf'
 
 require 'google/api/annotations_pb'
+require 'google/api/field_behavior_pb'
 require 'google/cloud/talent/v4beta1/common_pb'
 require 'google/protobuf/duration_pb'
 require 'google/protobuf/timestamp_pb'
@@ -43,6 +44,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     repeated :application_job_filters, :message, 13, "google.cloud.talent.v4beta1.ApplicationJobFilter"
     optional :custom_attribute_filter, :string, 15
     optional :candidate_availability_filter, :message, 16, "google.cloud.talent.v4beta1.CandidateAvailabilityFilter"
+    repeated :availability_filters, :message, 18, "google.cloud.talent.v4beta1.AvailabilityFilter"
     repeated :person_name_filters, :message, 17, "google.cloud.talent.v4beta1.PersonNameFilter"
   end
   add_message "google.cloud.talent.v4beta1.LocationFilter" do
@@ -141,6 +143,11 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
   add_message "google.cloud.talent.v4beta1.CandidateAvailabilityFilter" do
     optional :negated, :bool, 1
   end
+  add_message "google.cloud.talent.v4beta1.AvailabilityFilter" do
+    optional :signal_type, :enum, 1, "google.cloud.talent.v4beta1.AvailabilitySignalType"
+    optional :range, :message, 2, "google.cloud.talent.v4beta1.TimestampRange"
+    optional :required, :bool, 3
+  end
   add_message "google.cloud.talent.v4beta1.PersonNameFilter" do
     optional :person_name, :string, 1
   end
@@ -170,6 +177,7 @@ module Google
         TimeFilter = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.talent.v4beta1.TimeFilter").msgclass
         TimeFilter::TimeField = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.talent.v4beta1.TimeFilter.TimeField").enummodule
         CandidateAvailabilityFilter = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.talent.v4beta1.CandidateAvailabilityFilter").msgclass
+        AvailabilityFilter = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.talent.v4beta1.AvailabilityFilter").msgclass
         PersonNameFilter = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.talent.v4beta1.PersonNameFilter").msgclass
       end
     end

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

@@ -5,6 +5,7 @@
 require 'google/protobuf'
 
 require 'google/api/annotations_pb'
+require 'google/api/field_behavior_pb'
 require 'google/cloud/talent/v4beta1/common_pb'
 require 'google/protobuf/timestamp_pb'
 require 'google/type/postal_address_pb'

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

@@ -400,11 +400,9 @@ module Google
           # @param parent [String]
           #   Required. The resource name of the tenant under which the job 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".
+          #   The format is "projects/{project_id}/tenants/{tenant_id}". For example,
+          #   "projects/foo/tenant/bar". If tenant id is unspecified a default tenant
+          #   is created. For example, "projects/foo".
           # @param job [Google::Cloud::Talent::V4beta1::Job | Hash]
           #   Required. The Job to be created.
           #   A hash of the same form as `Google::Cloud::Talent::V4beta1::Job`
@@ -447,11 +445,11 @@ module Google
           #   Required. The resource name of the job to retrieve.
           #
           #   The format is
-          #   "projects/{project_id}/tenants/{tenant_id}/jobs/{job_id}", for
-          #   example, "projects/api-test-project/tenants/foo/jobs/1234".
+          #   "projects/{project_id}/tenants/{tenant_id}/jobs/{job_id}". For
+          #   example, "projects/foo/tenants/bar/jobs/baz".
           #
-          #   Tenant id is optional and the default tenant is used if unspecified, for
-          #   example, "projects/api-test-project/jobs/1234".
+          #   If tenant id is unspecified, the default tenant is used. For
+          #   example, "projects/foo/jobs/bar".
           # @param options [Google::Gax::CallOptions]
           #   Overrides the default settings for this call, e.g, timeout,
           #   retries, etc.
@@ -488,8 +486,7 @@ module Google
           #   A hash of the same form as `Google::Cloud::Talent::V4beta1::Job`
           #   can also be provided.
           # @param update_mask [Google::Protobuf::FieldMask | Hash]
-          #   Optional but strongly recommended to be provided for the best service
-          #   experience.
+          #   Strongly recommended for the best service experience.
           #
           #   If {Google::Cloud::Talent::V4beta1::UpdateJobRequest#update_mask update_mask}
           #   is provided, only the specified fields in
@@ -539,11 +536,11 @@ module Google
           #   Required. The resource name of the job to be deleted.
           #
           #   The format is
-          #   "projects/{project_id}/tenants/{tenant_id}/jobs/{job_id}", for
-          #   example, "projects/api-test-project/tenants/foo/jobs/1234".
+          #   "projects/{project_id}/tenants/{tenant_id}/jobs/{job_id}". For
+          #   example, "projects/foo/tenants/bar/jobs/baz".
           #
-          #   Tenant id is optional and the default tenant is used if unspecified, for
-          #   example, "projects/api-test-project/jobs/1234".
+          #   If tenant id is unspecified, the default tenant is used. For
+          #   example, "projects/foo/jobs/bar".
           # @param options [Google::Gax::CallOptions]
           #   Overrides the default settings for this call, e.g, timeout,
           #   retries, etc.
@@ -575,11 +572,9 @@ module Google
           # @param parent [String]
           #   Required. The resource name of the tenant under which the job is created.
           #
-          #   The format is "projects/{project_id}/tenants/{tenant_id}", for example,
-          #   "projects/api-test-project/tenant/foo".
-          #
-          #   Tenant id is optional and the default tenant is used if unspecified, for
-          #   example, "projects/api-test-project".
+          #   The format is "projects/{project_id}/tenants/{tenant_id}". For example,
+          #   "projects/foo/tenant/bar". If tenant id is unspecified, a default tenant
+          #   is created. For example, "projects/foo".
           # @param filter [String]
           #   Required. The filter string specifies the jobs to be enumerated.
           #
@@ -588,16 +583,16 @@ module Google
           #   The fields eligible for filtering are:
           #
           #   * `companyName` (Required)
-          #   * `requisitionId` (Optional)
-          #   * `status` (Optional) Available values: OPEN, EXPIRED, ALL. Defaults to
+          #   * `requisitionId`
+          #   * `status` Available values: OPEN, EXPIRED, ALL. Defaults to
           #     OPEN if no value is specified.
           #
           #   Sample Query:
           #
-          #   * companyName = "projects/api-test-project/tenants/foo/companies/bar"
-          #   * companyName = "projects/api-test-project/tenants/foo/companies/bar" AND
+          #   * companyName = "projects/foo/tenants/bar/companies/baz"
+          #   * companyName = "projects/foo/tenants/bar/companies/baz" AND
           #     requisitionId = "req-1"
-          #   * companyName = "projects/api-test-project/tenants/foo/companies/bar" AND
+          #   * companyName = "projects/foo/tenants/bar/companies/baz" AND
           #     status = "EXPIRED"
           # @param page_size [Integer]
           #   The maximum number of resources contained in the underlying API
@@ -606,7 +601,7 @@ module Google
           #   performed per-page, this determines the maximum number of
           #   resources in a page.
           # @param job_view [Google::Cloud::Talent::V4beta1::JobView]
-          #   Optional. The desired job attributes returned for jobs in the
+          #   The desired job attributes returned for jobs in the
           #   search response. Defaults to
           #   {Google::Cloud::Talent::V4beta1::JobView::JOB_VIEW_FULL JobView::JOB_VIEW_FULL}
           #   if no value is specified.
@@ -666,11 +661,9 @@ module Google
           # @param parent [String]
           #   Required. The resource name of the tenant under which the job is created.
           #
-          #   The format is "projects/{project_id}/tenants/{tenant_id}", for example,
-          #   "projects/api-test-project/tenant/foo".
-          #
-          #   Tenant id is optional and the default tenant is used if unspecified, for
-          #   example, "projects/api-test-project".
+          #   The format is "projects/{project_id}/tenants/{tenant_id}". For example,
+          #   "projects/foo/tenant/bar". If tenant id is unspecified, a default tenant
+          #   is created. For example, "projects/foo".
           # @param filter [String]
           #   Required. The filter string specifies the jobs to be deleted.
           #
@@ -681,7 +674,7 @@ module Google
           #   * `companyName` (Required)
           #   * `requisitionId` (Required)
           #
-          #   Sample Query: companyName = "projects/api-test-project/companies/123" AND
+          #   Sample Query: companyName = "projects/foo/companies/bar" AND
           #   requisitionId = "req-1"
           # @param options [Google::Gax::CallOptions]
           #   Overrides the default settings for this call, e.g, timeout,
@@ -725,11 +718,9 @@ module Google
           # @param parent [String]
           #   Required. The resource name of the tenant to search within.
           #
-          #   The format is "projects/{project_id}/tenants/{tenant_id}", for example,
-          #   "projects/api-test-project/tenant/foo".
-          #
-          #   Tenant id is optional and the default tenant is used if unspecified, for
-          #   example, "projects/api-test-project".
+          #   The format is "projects/{project_id}/tenants/{tenant_id}". For example,
+          #   "projects/foo/tenant/bar". If tenant id is unspecified, a default tenant
+          #   is created. For example, "projects/foo".
           # @param request_metadata [Google::Cloud::Talent::V4beta1::RequestMetadata | Hash]
           #   Required. The meta information collected about the job searcher, used to
           #   improve the search quality of the service. The identifiers (such as
@@ -737,24 +728,23 @@ module Google
           #   A hash of the same form as `Google::Cloud::Talent::V4beta1::RequestMetadata`
           #   can also be provided.
           # @param search_mode [Google::Cloud::Talent::V4beta1::SearchJobsRequest::SearchMode]
-          #   Optional. Mode of a search.
+          #   Mode of a search.
           #
           #   Defaults to
           #   {Google::Cloud::Talent::V4beta1::SearchJobsRequest::SearchMode::JOB_SEARCH SearchMode::JOB_SEARCH}.
           # @param job_query [Google::Cloud::Talent::V4beta1::JobQuery | Hash]
-          #   Optional. Query used to search against jobs, such as keyword, location
-          #   filters, etc.
+          #   Query used to search against jobs, such as keyword, location filters, etc.
           #   A hash of the same form as `Google::Cloud::Talent::V4beta1::JobQuery`
           #   can also be provided.
           # @param enable_broadening [true, false]
-          #   Optional. Controls whether to broaden the search when it produces sparse
-          #   results. Broadened queries append results to the end of the matching
-          #   results list.
+          #   Controls whether to broaden the search when it produces sparse results.
+          #   Broadened queries append results to the end of the matching results
+          #   list.
           #
           #   Defaults to false.
           # @param require_precise_result_size [true, false]
-          #   Optional. Controls if the search job request requires the return of a
-          #   precise count of the first 300 results. Setting this to `true` ensures
+          #   Controls if the search job request requires the return of a precise
+          #   count of the first 300 results. Setting this to `true` ensures
           #   consistency in the number of results per page. Best practice is to set this
           #   value to true if a client allows users to jump directly to a
           #   non-sequential search results page.
@@ -763,8 +753,7 @@ module Google
           #
           #   Defaults to false.
           # @param histogram_queries [Array<Google::Cloud::Talent::V4beta1::HistogramQuery | Hash>]
-          #   Optional. An expression specifies a histogram request against matching
-          #   jobs.
+          #   An expression specifies a histogram request against matching jobs.
           #
           #   Expression syntax is an aggregation function call with histogram facets and
           #   other options.
@@ -874,13 +863,13 @@ module Google
           #   A hash of the same form as `Google::Cloud::Talent::V4beta1::HistogramQuery`
           #   can also be provided.
           # @param job_view [Google::Cloud::Talent::V4beta1::JobView]
-          #   Optional. The desired job attributes returned for jobs in the search
-          #   response. Defaults to
+          #   The desired job attributes returned for jobs in the search response.
+          #   Defaults to
           #   {Google::Cloud::Talent::V4beta1::JobView::JOB_VIEW_SMALL JobView::JOB_VIEW_SMALL}
           #   if no value is specified.
           # @param offset [Integer]
-          #   Optional. An integer that specifies the current offset (that is, starting
-          #   result location, amongst the jobs deemed by the API as relevant) in search
+          #   An integer that specifies the current offset (that is, starting result
+          #   location, amongst the jobs deemed by the API as relevant) in search
           #   results. This field is only considered if
           #   {Google::Cloud::Talent::V4beta1::SearchJobsRequest#page_token page_token} is
           #   unset.
@@ -896,8 +885,7 @@ module Google
           #   performed per-page, this determines the maximum number of
           #   resources in a page.
           # @param order_by [String]
-          #   Optional. The criteria determining how search results are sorted. Default
-          #   is
+          #   The criteria determining how search results are sorted. Default is
           #   `"relevance desc"`.
           #
           #   Supported options are:
@@ -952,8 +940,8 @@ module Google
           #     still applied unless explicitly disabled in
           #     {Google::Cloud::Talent::V4beta1::SearchJobsRequest#diversification_level diversification_level}.
           # @param diversification_level [Google::Cloud::Talent::V4beta1::SearchJobsRequest::DiversificationLevel]
-          #   Optional. Controls whether highly similar jobs are returned next to each
-          #   other in the search results. Jobs are identified as highly similar based on
+          #   Controls whether highly similar jobs are returned next to each other in
+          #   the search results. Jobs are identified as highly similar based on
           #   their titles, job categories, and locations. Highly similar results are
           #   clustered so that only one representative job of the cluster is
           #   displayed to the job seeker higher up in the results, with the other jobs
@@ -963,12 +951,12 @@ module Google
           #   {Google::Cloud::Talent::V4beta1::SearchJobsRequest::DiversificationLevel::SIMPLE DiversificationLevel::SIMPLE}
           #   if no value is specified.
           # @param custom_ranking_info [Google::Cloud::Talent::V4beta1::SearchJobsRequest::CustomRankingInfo | Hash]
-          #   Optional. Controls over how job documents get ranked on top of existing
-          #   relevance score (determined by API algorithm).
+          #   Controls over how job documents get ranked on top of existing relevance
+          #   score (determined by API algorithm).
           #   A hash of the same form as `Google::Cloud::Talent::V4beta1::SearchJobsRequest::CustomRankingInfo`
           #   can also be provided.
           # @param disable_keyword_match [true, false]
-          #   Optional. Controls whether to disable exact keyword match on
+          #   Controls whether to disable exact keyword match on
           #   {Google::Cloud::Talent::V4beta1::Job#title Job#title},
           #   {Google::Cloud::Talent::V4beta1::Job#description Job#description},
           #   {Google::Cloud::Talent::V4beta1::Job#company_display_name Job#company_display_name},
@@ -1079,11 +1067,9 @@ module Google
           # @param parent [String]
           #   Required. The resource name of the tenant to search within.
           #
-          #   The format is "projects/{project_id}/tenants/{tenant_id}", for example,
-          #   "projects/api-test-project/tenant/foo".
-          #
-          #   Tenant id is optional and the default tenant is used if unspecified, for
-          #   example, "projects/api-test-project".
+          #   The format is "projects/{project_id}/tenants/{tenant_id}". For example,
+          #   "projects/foo/tenant/bar". If tenant id is unspecified, a default tenant
+          #   is created. For example, "projects/foo".
           # @param request_metadata [Google::Cloud::Talent::V4beta1::RequestMetadata | Hash]
           #   Required. The meta information collected about the job searcher, used to
           #   improve the search quality of the service. The identifiers (such as
@@ -1091,24 +1077,23 @@ module Google
           #   A hash of the same form as `Google::Cloud::Talent::V4beta1::RequestMetadata`
           #   can also be provided.
           # @param search_mode [Google::Cloud::Talent::V4beta1::SearchJobsRequest::SearchMode]
-          #   Optional. Mode of a search.
+          #   Mode of a search.
           #
           #   Defaults to
           #   {Google::Cloud::Talent::V4beta1::SearchJobsRequest::SearchMode::JOB_SEARCH SearchMode::JOB_SEARCH}.
           # @param job_query [Google::Cloud::Talent::V4beta1::JobQuery | Hash]
-          #   Optional. Query used to search against jobs, such as keyword, location
-          #   filters, etc.
+          #   Query used to search against jobs, such as keyword, location filters, etc.
           #   A hash of the same form as `Google::Cloud::Talent::V4beta1::JobQuery`
           #   can also be provided.
           # @param enable_broadening [true, false]
-          #   Optional. Controls whether to broaden the search when it produces sparse
-          #   results. Broadened queries append results to the end of the matching
-          #   results list.
+          #   Controls whether to broaden the search when it produces sparse results.
+          #   Broadened queries append results to the end of the matching results
+          #   list.
           #
           #   Defaults to false.
           # @param require_precise_result_size [true, false]
-          #   Optional. Controls if the search job request requires the return of a
-          #   precise count of the first 300 results. Setting this to `true` ensures
+          #   Controls if the search job request requires the return of a precise
+          #   count of the first 300 results. Setting this to `true` ensures
           #   consistency in the number of results per page. Best practice is to set this
           #   value to true if a client allows users to jump directly to a
           #   non-sequential search results page.
@@ -1117,8 +1102,7 @@ module Google
           #
           #   Defaults to false.
           # @param histogram_queries [Array<Google::Cloud::Talent::V4beta1::HistogramQuery | Hash>]
-          #   Optional. An expression specifies a histogram request against matching
-          #   jobs.
+          #   An expression specifies a histogram request against matching jobs.
           #
           #   Expression syntax is an aggregation function call with histogram facets and
           #   other options.
@@ -1228,13 +1212,13 @@ module Google
           #   A hash of the same form as `Google::Cloud::Talent::V4beta1::HistogramQuery`
           #   can also be provided.
           # @param job_view [Google::Cloud::Talent::V4beta1::JobView]
-          #   Optional. The desired job attributes returned for jobs in the search
-          #   response. Defaults to
+          #   The desired job attributes returned for jobs in the search response.
+          #   Defaults to
           #   {Google::Cloud::Talent::V4beta1::JobView::JOB_VIEW_SMALL JobView::JOB_VIEW_SMALL}
           #   if no value is specified.
           # @param offset [Integer]
-          #   Optional. An integer that specifies the current offset (that is, starting
-          #   result location, amongst the jobs deemed by the API as relevant) in search
+          #   An integer that specifies the current offset (that is, starting result
+          #   location, amongst the jobs deemed by the API as relevant) in search
           #   results. This field is only considered if
           #   {Google::Cloud::Talent::V4beta1::SearchJobsRequest#page_token page_token} is
           #   unset.
@@ -1250,8 +1234,7 @@ module Google
           #   performed per-page, this determines the maximum number of
           #   resources in a page.
           # @param order_by [String]
-          #   Optional. The criteria determining how search results are sorted. Default
-          #   is
+          #   The criteria determining how search results are sorted. Default is
           #   `"relevance desc"`.
           #
           #   Supported options are:
@@ -1306,8 +1289,8 @@ module Google
           #     still applied unless explicitly disabled in
           #     {Google::Cloud::Talent::V4beta1::SearchJobsRequest#diversification_level diversification_level}.
           # @param diversification_level [Google::Cloud::Talent::V4beta1::SearchJobsRequest::DiversificationLevel]
-          #   Optional. Controls whether highly similar jobs are returned next to each
-          #   other in the search results. Jobs are identified as highly similar based on
+          #   Controls whether highly similar jobs are returned next to each other in
+          #   the search results. Jobs are identified as highly similar based on
           #   their titles, job categories, and locations. Highly similar results are
           #   clustered so that only one representative job of the cluster is
           #   displayed to the job seeker higher up in the results, with the other jobs
@@ -1317,12 +1300,12 @@ module Google
           #   {Google::Cloud::Talent::V4beta1::SearchJobsRequest::DiversificationLevel::SIMPLE DiversificationLevel::SIMPLE}
           #   if no value is specified.
           # @param custom_ranking_info [Google::Cloud::Talent::V4beta1::SearchJobsRequest::CustomRankingInfo | Hash]
-          #   Optional. Controls over how job documents get ranked on top of existing
-          #   relevance score (determined by API algorithm).
+          #   Controls over how job documents get ranked on top of existing relevance
+          #   score (determined by API algorithm).
           #   A hash of the same form as `Google::Cloud::Talent::V4beta1::SearchJobsRequest::CustomRankingInfo`
           #   can also be provided.
           # @param disable_keyword_match [true, false]
-          #   Optional. Controls whether to disable exact keyword match on
+          #   Controls whether to disable exact keyword match on
           #   {Google::Cloud::Talent::V4beta1::Job#title Job#title},
           #   {Google::Cloud::Talent::V4beta1::Job#description Job#description},
           #   {Google::Cloud::Talent::V4beta1::Job#company_display_name Job#company_display_name},
@@ -1422,11 +1405,9 @@ module Google
           # @param parent [String]
           #   Required. The resource name of the tenant under which the job 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".
+          #   The format is "projects/{project_id}/tenants/{tenant_id}". For example,
+          #   "projects/foo/tenant/bar". If tenant id is unspecified, a default tenant
+          #   is created. For example, "projects/foo".
           # @param jobs [Array<Google::Cloud::Talent::V4beta1::Job | Hash>]
           #   Required. The jobs to be created.
           #   A hash of the same form as `Google::Cloud::Talent::V4beta1::Job`
@@ -1497,18 +1478,16 @@ module Google
           # @param parent [String]
           #   Required. The resource name of the tenant under which the job is created.
           #
-          #   The format is "projects/{project_id}/tenants/{tenant_id}", for example,
-          #   "projects/api-test-project/tenant/foo".
-          #
-          #   Tenant id is optional and the default tenant is used if unspecified, for
-          #   example, "projects/api-test-project".
+          #   The format is "projects/{project_id}/tenants/{tenant_id}". For example,
+          #   "projects/foo/tenant/bar". If tenant id is unspecified, a default tenant
+          #   is created. For example, "projects/foo".
           # @param jobs [Array<Google::Cloud::Talent::V4beta1::Job | Hash>]
-          #   Required. The jobs to be updated.
+          #   The jobs to be updated.
           #   A hash of the same form as `Google::Cloud::Talent::V4beta1::Job`
           #   can also be provided.
           # @param update_mask [Google::Protobuf::FieldMask | Hash]
-          #   Optional but strongly recommended to be provided for the best service
-          #   experience, also increase latency when checking status of batch operation.
+          #   Strongly recommended for the best service experience. Be aware that it will
+          #   also increase latency when checking the status of a batch operation.
           #
           #   If
           #   {Google::Cloud::Talent::V4beta1::BatchUpdateJobsRequest#update_mask update_mask}