google-cloud-talent 0.1.0 → 0.2.0

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

@@ -25,11 +25,8 @@ module Google
         #     An expression specifies a histogram request against matching resources
         #     (for example, jobs, profiles) for searches.
         #
-        #     See
-        #     {Google::Cloud::Talent::V4beta1::SearchJobsRequest#histogram_queries SearchJobsRequest#histogram_queries}
-        #     and
-        #     {Google::Cloud::Talent::V4beta1::SearchProfilesRequest#histogram_queries SearchProfilesRequest#histogram_queries}
-        #     for details about syntax.
+        #     See {Google::Cloud::Talent::V4beta1::SearchJobsRequest#histogram_queries SearchJobsRequest#histogram_queries} and
+        #     {Google::Cloud::Talent::V4beta1::SearchProfilesRequest#histogram_queries SearchProfilesRequest#histogram_queries} for details about syntax.
         class HistogramQuery; end
 
         # Output only.

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

@@ -18,9 +18,8 @@ module Google
     module Talent
       module V4beta1
         # A Job resource represents a job posting (also referred to as a "job listing"
-        # or "job requisition"). A job belongs to a
-        # {Google::Cloud::Talent::V4beta1::Company Company}, which is the hiring entity
-        # responsible for the job.
+        # or "job requisition"). A job belongs to a {Google::Cloud::Talent::V4beta1::Company Company}, which is the hiring
+        # entity responsible for the job.
         # @!attribute [rw] name
         #   @return [String]
         #     Required during job update.
@@ -28,18 +27,27 @@ module Google
         #     The resource name for the job. This is generated by the service when a
         #     job is created.
         #
-        #     The format is "projects/{project_id}/jobs/{job_id}",
-        #     for example, "projects/api-test-project/jobs/1234".
+        #     The format is
+        #     "projects/{project_id}/tenants/{tenant_id}/jobs/{job_id}", for
+        #     example, "projects/api-test-project/tenants/foo/jobs/1234".
+        #
+        #     Tenant id is optional and the default tenant is used if unspecified, for
+        #     example, "projects/api-test-project/jobs/1234".
         #
         #     Use of this field in job queries and API calls is preferred over the use of
-        #     {Google::Cloud::Talent::V4beta1::Job#requisition_id requisition_id} since this
-        #     value is unique.
-        # @!attribute [rw] company_name
+        #     {Google::Cloud::Talent::V4beta1::Job#requisition_id requisition_id} since this value is unique.
+        # @!attribute [rw] company
         #   @return [String]
         #     Required.
         #
-        #     The resource name of the company listing the job, such as
-        #     "projects/api-test-project/companies/foo".
+        #     The resource name of the company listing the job.
+        #
+        #     The format is
+        #     "projects/{project_id}/tenants/{tenant_id}/companies/{company_id}", for
+        #     example, "projects/api-test-project/tenants/foo/companies/bar".
+        #
+        #     Tenant id is optional and the default tenant is used if unspecified, for
+        #     example, "projects/api-test-project/companies/bar".
         # @!attribute [rw] requisition_id
         #   @return [String]
         #     Required.
@@ -47,10 +55,8 @@ module Google
         #     The requisition ID, also referred to as the posting ID, is assigned by the
         #     client to identify a job. This field is intended to be used by clients
         #     for client identification and tracking of postings. A job isn't allowed
-        #     to be created if there is another job with the same
-        #     {Google::Cloud::Talent::V4beta1::Job#name company},
-        #     {Google::Cloud::Talent::V4beta1::Job#language_code language_code} and
-        #     {Google::Cloud::Talent::V4beta1::Job#requisition_id requisition_id}.
+        #     to be created if there is another job with the same {Google::Cloud::Talent::V4beta1::Job#name company},
+        #     {Google::Cloud::Talent::V4beta1::Job#language_code language_code} and {Google::Cloud::Talent::V4beta1::Job#requisition_id requisition_id}.
         #
         #     The maximum number of allowed characters is 255.
         # @!attribute [rw] title
@@ -66,10 +72,9 @@ module Google
         #
         #     The description of the job, which typically includes a multi-paragraph
         #     description of the company and related information. Separate fields are
-        #     provided on the job object for
-        #     {Google::Cloud::Talent::V4beta1::Job#responsibilities responsibilities},
-        #     {Google::Cloud::Talent::V4beta1::Job#qualifications qualifications}, and other
-        #     job characteristics. Use of these separate job fields is recommended.
+        #     provided on the job object for {Google::Cloud::Talent::V4beta1::Job#responsibilities responsibilities},
+        #     {Google::Cloud::Talent::V4beta1::Job#qualifications qualifications}, and other job characteristics. Use of
+        #     these separate job fields is recommended.
         #
         #     This field accepts and sanitizes HTML input, and also accepts
         #     bold, italic, ordered list, and unordered list markup tags.
@@ -86,22 +91,17 @@ module Google
         #
         #     At most 50 locations are allowed for best search performance. If a job has
         #     more locations, it is suggested to split it into multiple jobs with unique
-        #     {Google::Cloud::Talent::V4beta1::Job#requisition_id requisition_id}s (e.g.
-        #     'ReqA' becomes 'ReqA-1', 'ReqA-2', etc.) as multiple jobs with the same
-        #     {Google::Cloud::Talent::V4beta1::Job#name company}[], {Language_code} and
-        #     {Google::Cloud::Talent::V4beta1::Job#requisition_id requisition_id} are not
-        #     allowed. If the original
-        #     {Google::Cloud::Talent::V4beta1::Job#requisition_id requisition_id} must be
-        #     preserved, a custom field should be used for storage. It is also suggested
-        #     to group the locations that close to each other in the same job for better
-        #     search experience.
+        #     {Google::Cloud::Talent::V4beta1::Job#requisition_id requisition_id}s (e.g. 'ReqA' becomes 'ReqA-1', 'ReqA-2', and so on.) as
+        #     multiple jobs with the same {Google::Cloud::Talent::V4beta1::Job#name company}[], {Language_code} and
+        #     {Google::Cloud::Talent::V4beta1::Job#requisition_id requisition_id} are not allowed. If the original {Google::Cloud::Talent::V4beta1::Job#requisition_id requisition_id} must
+        #     be preserved, a custom field should be used for storage. It is also
+        #     suggested to group the locations that close to each other in the same job
+        #     for better search experience.
         #
         #     The maximum number of allowed characters is 500.
         # @!attribute [rw] application_info
         #   @return [Google::Cloud::Talent::V4beta1::Job::ApplicationInfo]
-        #     Required. At least one field within
-        #     {Google::Cloud::Talent::V4beta1::Job::ApplicationInfo ApplicationInfo} must be
-        #     specified.
+        #     Optional.
         #
         #     Job application information.
         # @!attribute [rw] job_benefits
@@ -113,7 +113,8 @@ module Google
         #   @return [Google::Cloud::Talent::V4beta1::CompensationInfo]
         #     Optional.
         #
-        #     Job compensation information.
+        #     Job compensation information (a.k.a. "pay rate") i.e., the compensation
+        #     that will paid to the employee.
         # @!attribute [rw] custom_attributes
         #   @return [Hash{String => Google::Cloud::Talent::V4beta1::CustomAttribute}]
         #     Optional.
@@ -170,11 +171,9 @@ module Google
         #     [Tags for Identifying Languages](https://tools.ietf.org/html/bcp47){:
         #     class="external" target="_blank" }.
         #
-        #     If this field is unspecified and
-        #     {Google::Cloud::Talent::V4beta1::Job#description Job#description} is present,
-        #     detected language code based on
-        #     {Google::Cloud::Talent::V4beta1::Job#description Job#description} is assigned,
-        #     otherwise defaults to 'en_US'.
+        #     If this field is unspecified and {Google::Cloud::Talent::V4beta1::Job#description Job#description} is present, detected
+        #     language code based on {Google::Cloud::Talent::V4beta1::Job#description Job#description} is assigned, otherwise
+        #     defaults to 'en_US'.
         # @!attribute [rw] job_level
         #   @return [Google::Cloud::Talent::V4beta1::JobLevel]
         #     Optional.
@@ -197,8 +196,7 @@ module Google
         #
         #     A description of the qualifications required to perform the
         #     job. The use of this field is recommended
-        #     as an alternative to using the more general
-        #     {Google::Cloud::Talent::V4beta1::Job#description description} field.
+        #     as an alternative to using the more general {Google::Cloud::Talent::V4beta1::Job#description description} field.
         #
         #     This field accepts and sanitizes HTML input, and also accepts
         #     bold, italic, ordered list, and unordered list markup tags.
@@ -209,8 +207,8 @@ module Google
         #     Optional.
         #
         #     A description of job responsibilities. The use of this field is
-        #     recommended as an alternative to using the more general
-        #     {Google::Cloud::Talent::V4beta1::Job#description description} field.
+        #     recommended as an alternative to using the more general {Google::Cloud::Talent::V4beta1::Job#description description}
+        #     field.
         #
         #     This field accepts and sanitizes HTML input, and also accepts
         #     bold, italic, ordered list, and unordered list markup tags.
@@ -220,25 +218,20 @@ module Google
         #   @return [Google::Cloud::Talent::V4beta1::PostingRegion]
         #     Optional.
         #
-        #     The job {Google::Cloud::Talent::V4beta1::PostingRegion PostingRegion} (for
-        #     example, state, country) throughout which the job is available. If this
-        #     field is set, a
-        #     {Google::Cloud::Talent::V4beta1::LocationFilter LocationFilter} in a search
-        #     query within the job region finds this job posting if an exact location
-        #     match isn't specified. If this field is set to
-        #     {Google::Cloud::Talent::V4beta1::PostingRegion::NATION PostingRegion::NATION} or
-        #     {Google::Cloud::Talent::V4beta1::PostingRegion::ADMINISTRATIVE_AREA PostingRegion::ADMINISTRATIVE_AREA},
-        #     setting job {Google::Cloud::Talent::V4beta1::Job#addresses Job#addresses} to
-        #     the same location level as this field is strongly recommended.
+        #     The job {Google::Cloud::Talent::V4beta1::PostingRegion PostingRegion} (for example, state, country) throughout
+        #     which the job is available. If this field is set, a {Google::Cloud::Talent::V4beta1::LocationFilter LocationFilter}
+        #     in a search query within the job region finds this job posting if an
+        #     exact location match isn't specified. If this field is set to
+        #     {Google::Cloud::Talent::V4beta1::PostingRegion::NATION PostingRegion::NATION} or {Google::Cloud::Talent::V4beta1::PostingRegion::ADMINISTRATIVE_AREA PostingRegion::ADMINISTRATIVE_AREA},
+        #     setting job {Google::Cloud::Talent::V4beta1::Job#addresses Job#addresses} to the same location level as this field
+        #     is strongly recommended.
         # @!attribute [rw] visibility
         #   @return [Google::Cloud::Talent::V4beta1::Visibility]
         #     Optional.
         #
         #     The visibility of the job.
         #
-        #     Defaults to
-        #     {Google::Cloud::Talent::V4beta1::Visibility::ACCOUNT_ONLY Visibility::ACCOUNT_ONLY}
-        #     if not specified.
+        #     Defaults to {Google::Cloud::Talent::V4beta1::Visibility::ACCOUNT_ONLY Visibility::ACCOUNT_ONLY} if not specified.
         # @!attribute [rw] job_start_time
         #   @return [Google::Protobuf::Timestamp]
         #     Optional.
@@ -270,9 +263,7 @@ module Google
         #     updated with the {UpdateJob} API. An expired job can be updated and
         #     opened again by using a future expiration timestamp. Updating an expired
         #     job fails if there is another existing open job with same
-        #     {Google::Cloud::Talent::V4beta1::Job#name company}[],
-        #     {Google::Cloud::Talent::V4beta1::Job#language_code language_code} and
-        #     {Google::Cloud::Talent::V4beta1::Job#requisition_id requisition_id}.
+        #     {Google::Cloud::Talent::V4beta1::Job#name company}[], {Language_code} and {Google::Cloud::Talent::V4beta1::Job#requisition_id requisition_id}.
         #
         #     The expired jobs are retained in our system for 90 days. However, the
         #     overall expired job count cannot exceed 3 times the maximum of open jobs
@@ -291,11 +282,10 @@ module Google
         #     unspecified expiration date, the job expires after 2017/01/31 13:00AM UTC.
         #
         #     If this value isn't provided on job update, it depends on the field masks
-        #     set by
-        #     {Google::Cloud::Talent::V4beta1::UpdateJobRequest#update_mask UpdateJobRequest#update_mask}.
-        #     If the field masks include {Expiry_time}, or the masks are empty meaning
-        #     that every field is updated, the job posting expires after 30 days from the
-        #     job's last update time. Otherwise the expiration date isn't updated.
+        #     set by {Google::Cloud::Talent::V4beta1::UpdateJobRequest#update_mask UpdateJobRequest#update_mask}. If the field masks include
+        #     {Expiry_time}, or the masks are empty meaning that every field is
+        #     updated, the job posting expires after 30 days from the job's last
+        #     update time. Otherwise the expiration date isn't updated.
         # @!attribute [rw] posting_create_time
         #   @return [Google::Protobuf::Timestamp]
         #     Output only. The timestamp when this job posting was created.
@@ -317,11 +307,7 @@ module Google
           # Application related details of a job posting.
           # @!attribute [rw] emails
           #   @return [Array<String>]
-          #     Optional but at least one of
-          #     {Google::Cloud::Talent::V4beta1::Job::ApplicationInfo#uris uris},
-          #     {Google::Cloud::Talent::V4beta1::Job::ApplicationInfo#emails emails} or
-          #     {Google::Cloud::Talent::V4beta1::Job::ApplicationInfo#instruction instruction}
-          #     must be specified.
+          #     Optional.
           #
           #     Use this field to specify email address(es) to which resumes or
           #     applications can be sent.
@@ -329,11 +315,7 @@ module Google
           #     The maximum number of allowed characters for each entry is 255.
           # @!attribute [rw] instruction
           #   @return [String]
-          #     Optional but at least one of
-          #     {Google::Cloud::Talent::V4beta1::Job::ApplicationInfo#uris uris},
-          #     {Google::Cloud::Talent::V4beta1::Job::ApplicationInfo#emails emails} or
-          #     {Google::Cloud::Talent::V4beta1::Job::ApplicationInfo#instruction instruction}
-          #     must be specified.
+          #     Optional.
           #
           #     Use this field to provide instructions, such as "Mail your application
           #     to ...", that a candidate can follow to apply for the job.
@@ -344,11 +326,7 @@ module Google
           #     The maximum number of allowed characters is 3,000.
           # @!attribute [rw] uris
           #   @return [Array<String>]
-          #     Optional but at least one of
-          #     {Google::Cloud::Talent::V4beta1::Job::ApplicationInfo#uris uris},
-          #     {Google::Cloud::Talent::V4beta1::Job::ApplicationInfo#emails emails} or
-          #     {Google::Cloud::Talent::V4beta1::Job::ApplicationInfo#instruction instruction}
-          #     must be specified.
+          #     Optional.
           #
           #     Use this URI field to direct an applicant to a website, for example to
           #     link to an online application form.
@@ -361,18 +339,13 @@ module Google
           # Derived details about the job posting.
           # @!attribute [rw] locations
           #   @return [Array<Google::Cloud::Talent::V4beta1::Location>]
-          #     Structured locations of the job, resolved from
-          #     {Google::Cloud::Talent::V4beta1::Job#addresses Job#addresses}.
+          #     Structured locations of the job, resolved from {Google::Cloud::Talent::V4beta1::Job#addresses Job#addresses}.
           #
-          #     {Google::Cloud::Talent::V4beta1::Job::DerivedInfo#locations locations} are
-          #     exactly matched to
-          #     {Google::Cloud::Talent::V4beta1::Job#addresses Job#addresses} in the same
+          #     {Google::Cloud::Talent::V4beta1::Job::DerivedInfo#locations locations} are exactly matched to {Google::Cloud::Talent::V4beta1::Job#addresses Job#addresses} in the same
           #     order.
           # @!attribute [rw] job_categories
           #   @return [Array<Google::Cloud::Talent::V4beta1::JobCategory>]
-          #     Job categories derived from
-          #     {Google::Cloud::Talent::V4beta1::Job#title Job#title} and
-          #     {Google::Cloud::Talent::V4beta1::Job#description Job#description}.
+          #     Job categories derived from {Google::Cloud::Talent::V4beta1::Job#title Job#title} and {Google::Cloud::Talent::V4beta1::Job#description Job#description}.
           class DerivedInfo; end
 
           # Input only.
@@ -399,8 +372,7 @@ module Google
           #     HTML tags in these fields may be stripped if sanitiazation isn't
           #     disabled.
           #
-          #     Defaults to
-          #     {Google::Cloud::Talent::V4beta1::HtmlSanitization::SIMPLE_FORMATTING_ONLY HtmlSanitization::SIMPLE_FORMATTING_ONLY}.
+          #     Defaults to {Google::Cloud::Talent::V4beta1::HtmlSanitization::SIMPLE_FORMATTING_ONLY HtmlSanitization::SIMPLE_FORMATTING_ONLY}.
           class ProcessingOptions; end
         end
       end

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

@@ -24,10 +24,13 @@ module Google
         #   @return [String]
         #     Required.
         #
-        #     The resource name of the project under which the job is created.
+        #     The resource name of the tenant under which the job is created.
         #
-        #     The format is "projects/{project_id}", for example,
-        #     "projects/api-test-project".
+        #     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".
         # @!attribute [rw] job
         #   @return [Google::Cloud::Talent::V4beta1::Job]
         #     Required.
@@ -44,8 +47,12 @@ module Google
         #
         #     The resource name of the job to retrieve.
         #
-        #     The format is "projects/{project_id}/jobs/{job_id}",
-        #     for example, "projects/api-test-project/jobs/1234".
+        #     The format is
+        #     "projects/{project_id}/tenants/{tenant_id}/jobs/{job_id}", for
+        #     example, "projects/api-test-project/tenants/foo/jobs/1234".
+        #
+        #     Tenant id is optional and the default tenant is used if unspecified, for
+        #     example, "projects/api-test-project/jobs/1234".
         class GetJobRequest; end
 
         # Input only.
@@ -61,10 +68,8 @@ module Google
         #     Optional but strongly recommended to be provided for the best service
         #     experience.
         #
-        #     If {Google::Cloud::Talent::V4beta1::UpdateJobRequest#update_mask update_mask}
-        #     is provided, only the specified fields in
-        #     {Google::Cloud::Talent::V4beta1::UpdateJobRequest#job job} are updated.
-        #     Otherwise all the fields are updated.
+        #     If {Google::Cloud::Talent::V4beta1::UpdateJobRequest#update_mask update_mask} is provided, only the specified fields in
+        #     {Google::Cloud::Talent::V4beta1::UpdateJobRequest#job job} are updated. Otherwise all the fields are updated.
         #
         #     A field mask to restrict the fields that are updated. Only
         #     top level fields of {Google::Cloud::Talent::V4beta1::Job Job} are supported.
@@ -79,8 +84,12 @@ module Google
         #
         #     The resource name of the job to be deleted.
         #
-        #     The format is "projects/{project_id}/jobs/{job_id}",
-        #     for example, "projects/api-test-project/jobs/1234".
+        #     The format is
+        #     "projects/{project_id}/tenants/{tenant_id}/jobs/{job_id}", for
+        #     example, "projects/api-test-project/tenants/foo/jobs/1234".
+        #
+        #     Tenant id is optional and the default tenant is used if unspecified, for
+        #     example, "projects/api-test-project/jobs/1234".
         class DeleteJobRequest; end
 
         # Input only.
@@ -90,10 +99,13 @@ module Google
         #   @return [String]
         #     Required.
         #
-        #     The resource name of the project under which the job is created.
+        #     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".
         #
-        #     The format is "projects/{project_id}", for example,
-        #     "projects/api-test-project".
+        #     Tenant id is optional and the default tenant is used if unspecified, for
+        #     example, "projects/api-test-project".
         # @!attribute [rw] filter
         #   @return [String]
         #     Required.
@@ -118,10 +130,13 @@ module Google
         #   @return [String]
         #     Required.
         #
-        #     The resource name of the project under which the job is created.
+        #     The resource name of the tenant under which the job is created.
         #
-        #     The format is "projects/{project_id}", for example,
-        #     "projects/api-test-project".
+        #     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".
         # @!attribute [rw] filter
         #   @return [String]
         #     Required.
@@ -139,11 +154,11 @@ module Google
         #
         #     Sample Query:
         #
-        #     * companyName = "projects/api-test-project/companies/123"
-        #     * companyName = "projects/api-test-project/companies/123" AND requisitionId
-        #       = "req-1"
-        #     * companyName = "projects/api-test-project/companies/123" AND status =
-        #       "EXPIRED"
+        #     * companyName = "projects/api-test-project/tenants/foo/companies/bar"
+        #     * companyName = "projects/api-test-project/tenants/foo/companies/bar" AND
+        #       requisitionId = "req-1"
+        #     * companyName = "projects/api-test-project/tenants/foo/companies/bar" AND
+        #       status = "EXPIRED"
         # @!attribute [rw] page_token
         #   @return [String]
         #     Optional.
@@ -155,11 +170,8 @@ module Google
         #
         #     The maximum number of jobs to be returned per page of results.
         #
-        #     If {Google::Cloud::Talent::V4beta1::ListJobsRequest#job_view job_view} is set
-        #     to
-        #     {Google::Cloud::Talent::V4beta1::JobView::JOB_VIEW_ID_ONLY JobView::JOB_VIEW_ID_ONLY},
-        #     the maximum allowed page size is 1000. Otherwise, the maximum allowed page
-        #     size is 100.
+        #     If {Google::Cloud::Talent::V4beta1::ListJobsRequest#job_view job_view} is set to {Google::Cloud::Talent::V4beta1::JobView::JOB_VIEW_ID_ONLY JobView::JOB_VIEW_ID_ONLY}, the maximum allowed
+        #     page size is 1000. Otherwise, the maximum allowed page size is 100.
         #
         #     Default is 100 if empty or a number < 1 is specified.
         # @!attribute [rw] job_view
@@ -167,9 +179,8 @@ module Google
         #     Optional.
         #
         #     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.
+        #     search response. Defaults to {Google::Cloud::Talent::V4beta1::JobView::JOB_VIEW_FULL JobView::JOB_VIEW_FULL} if no value is
+        #     specified.
         class ListJobsRequest; end
 
         # Output only.
@@ -197,18 +208,20 @@ module Google
         #   @return [String]
         #     Required.
         #
-        #     The resource name of the project to search within.
+        #     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".
         #
-        #     The format is "projects/{project_id}", for example,
-        #     "projects/api-test-project".
+        #     Tenant id is optional and the default tenant is used if unspecified, for
+        #     example, "projects/api-test-project".
         # @!attribute [rw] search_mode
         #   @return [Google::Cloud::Talent::V4beta1::SearchJobsRequest::SearchMode]
         #     Optional.
         #
         #     Mode of a search.
         #
-        #     Defaults to
-        #     {Google::Cloud::Talent::V4beta1::SearchJobsRequest::SearchMode::JOB_SEARCH SearchMode::JOB_SEARCH}.
+        #     Defaults to {Google::Cloud::Talent::V4beta1::SearchJobsRequest::SearchMode::JOB_SEARCH SearchMode::JOB_SEARCH}.
         # @!attribute [rw] request_metadata
         #   @return [Google::Cloud::Talent::V4beta1::RequestMetadata]
         #     Required.
@@ -280,23 +293,19 @@ module Google
         #     Job histogram facets:
         #
         #     * company_id: histogram by {Job#distributor_company_id}.
-        #     * company_display_name: histogram by
-        #       {Google::Cloud::Talent::V4beta1::Job#company_display_name Job#company_display_name}.
-        #     * employment_type: histogram by
-        #       {Google::Cloud::Talent::V4beta1::Job#employment_types Job#employment_types},
-        #       for example, "FULL_TIME", "PART_TIME".
-        #     * company_size: histogram by
-        #       {Google::Cloud::Talent::V4beta1::CompanySize CompanySize}, for example,
-        #       "SMALL", "MEDIUM", "BIG".
+        #     * company_display_name: histogram by {Google::Cloud::Talent::V4beta1::Job#company_display_name Job#company_display_name}.
+        #     * employment_type: histogram by {Google::Cloud::Talent::V4beta1::Job#employment_types Job#employment_types}, for example,
+        #       "FULL_TIME", "PART_TIME".
+        #     * company_size: histogram by {Google::Cloud::Talent::V4beta1::CompanySize CompanySize}, for example, "SMALL",
+        #       "MEDIUM", "BIG".
         #     * publish_time_in_month: histogram by the {Job#publish_time} in months.
         #       Must specify list of numeric buckets in spec.
         #     * publish_time_in_year: histogram by the {Job#publish_time} in years.
         #       Must specify list of numeric buckets in spec.
         #     * degree_type: histogram by the {Job#degree_type}, for example,
         #       "Bachelors", "Masters".
-        #     * job_level: histogram by the
-        #       {Google::Cloud::Talent::V4beta1::Job#job_level Job#job_level}, for example,
-        #       "Entry Level".
+        #     * job_level: histogram by the {Google::Cloud::Talent::V4beta1::Job#job_level Job#job_level}, for example, "Entry
+        #       Level".
         #     * country: histogram by the country code of jobs, for example, "US", "FR".
         #     * admin1: histogram by the admin1 code of jobs, which is a global
         #       placeholder referring to the state, province, or the particular term a
@@ -310,14 +319,11 @@ module Google
         #       and longitude), for example, 37.4038522,-122.0987765. Since the coordinates
         #       of a city center can change, customers may need to refresh them
         #       periodically.
-        #     * locale: histogram by the
-        #       {Google::Cloud::Talent::V4beta1::Job#language_code Job#language_code}, for
-        #       example, "en-US", "fr-FR".
-        #     * language: histogram by the language subtag of the
-        #       {Google::Cloud::Talent::V4beta1::Job#language_code Job#language_code}, for
-        #       example, "en", "fr".
-        #     * category: histogram by the
-        #       {Google::Cloud::Talent::V4beta1::JobCategory JobCategory}, for example,
+        #     * locale: histogram by the {Google::Cloud::Talent::V4beta1::Job#language_code Job#language_code}, for example, "en-US",
+        #       "fr-FR".
+        #     * language: histogram by the language subtag of the {Google::Cloud::Talent::V4beta1::Job#language_code Job#language_code},
+        #       for example, "en", "fr".
+        #     * category: histogram by the {Google::Cloud::Talent::V4beta1::JobCategory JobCategory}, for example,
         #       "COMPUTER_AND_IT", "HEALTHCARE".
         #     * base_compensation_unit: histogram by the {CompensationUnit} of base
         #       salary, for example, "WEEKLY", "MONTHLY".
@@ -327,12 +333,10 @@ module Google
         #       Must specify list of numeric buckets to group results by.
         #     * annualized_total_compensation: histogram by the total annualized salary.
         #       Must specify list of numeric buckets to group results by.
-        #     * string_custom_attribute: histogram by string
-        #       {Google::Cloud::Talent::V4beta1::Job#custom_attributes Job#custom_attributes}.
+        #     * string_custom_attribute: histogram by string {Google::Cloud::Talent::V4beta1::Job#custom_attributes Job#custom_attributes}.
         #       Values can be accessed via square bracket notations like
         #       string_custom_attribute["key1"].
-        #     * numeric_custom_attribute: histogram by numeric
-        #       {Google::Cloud::Talent::V4beta1::Job#custom_attributes Job#custom_attributes}.
+        #     * numeric_custom_attribute: histogram by numeric {Google::Cloud::Talent::V4beta1::Job#custom_attributes Job#custom_attributes}.
         #       Values can be accessed via square bracket notations like
         #       numeric_custom_attribute["key1"]. Must specify list of numeric buckets to
         #       group results by.
@@ -356,9 +360,7 @@ module Google
         #
         #     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.
+        #     results. This field is only considered if {Google::Cloud::Talent::V4beta1::SearchJobsRequest#page_token page_token} is unset.
         #
         #     For example, 0 means to  return results starting from the first matching
         #     job, and 10 means to return from the 11th job. This can be used for
@@ -376,9 +378,8 @@ module Google
         #     Optional.
         #
         #     The token specifying the current offset within
-        #     search results. See
-        #     {Google::Cloud::Talent::V4beta1::SearchJobsResponse#next_page_token SearchJobsResponse#next_page_token}
-        #     for an explanation of how to obtain the next set of query results.
+        #     search results. See {Google::Cloud::Talent::V4beta1::SearchJobsResponse#next_page_token SearchJobsResponse#next_page_token} for
+        #     an explanation of how to obtain the next set of query results.
         # @!attribute [rw] order_by
         #   @return [String]
         #     Optional.
@@ -391,31 +392,28 @@ module Google
         #     * "relevance desc": By relevance descending, as determined by the API
         #       algorithms. Relevance thresholding of query results is only available
         #       with this ordering.
-        #     * "posting`_`publish`_`time desc": By
-        #       {Google::Cloud::Talent::V4beta1::Job#posting_publish_time Job#posting_publish_time}
+        #     * "posting`_`publish`_`time desc": By {Google::Cloud::Talent::V4beta1::Job#posting_publish_time Job#posting_publish_time}
         #       descending.
-        #     * "posting`_`update`_`time desc": By
-        #       {Google::Cloud::Talent::V4beta1::Job#posting_update_time Job#posting_update_time}
+        #     * "posting`_`update`_`time desc": By {Google::Cloud::Talent::V4beta1::Job#posting_update_time Job#posting_update_time}
         #       descending.
         #     * "title": By {Google::Cloud::Talent::V4beta1::Job#title Job#title} ascending.
-        #     * "title desc": By {Google::Cloud::Talent::V4beta1::Job#title Job#title}
-        #       descending.
+        #     * "title desc": By {Google::Cloud::Talent::V4beta1::Job#title Job#title} descending.
         #     * "annualized`_`base`_`compensation": By job's
-        #       {Google::Cloud::Talent::V4beta1::CompensationInfo#annualized_base_compensation_range CompensationInfo#annualized_base_compensation_range}
-        #       ascending. Jobs whose annualized base compensation is unspecified are put
-        #       at the end of search results.
+        #       {Google::Cloud::Talent::V4beta1::CompensationInfo#annualized_base_compensation_range CompensationInfo#annualized_base_compensation_range} ascending. Jobs
+        #       whose annualized base compensation is unspecified are put at the end of
+        #       search results.
         #     * "annualized`_`base`_`compensation desc": By job's
-        #       {Google::Cloud::Talent::V4beta1::CompensationInfo#annualized_base_compensation_range CompensationInfo#annualized_base_compensation_range}
-        #       descending. Jobs whose annualized base compensation is unspecified are put
-        #       at the end of search results.
+        #       {Google::Cloud::Talent::V4beta1::CompensationInfo#annualized_base_compensation_range CompensationInfo#annualized_base_compensation_range} descending. Jobs
+        #       whose annualized base compensation is unspecified are put at the end of
+        #       search results.
         #     * "annualized`_`total`_`compensation": By job's
-        #       {Google::Cloud::Talent::V4beta1::CompensationInfo#annualized_total_compensation_range CompensationInfo#annualized_total_compensation_range}
-        #       ascending. Jobs whose annualized base compensation is unspecified are put
-        #       at the end of search results.
+        #       {Google::Cloud::Talent::V4beta1::CompensationInfo#annualized_total_compensation_range CompensationInfo#annualized_total_compensation_range} ascending. Jobs
+        #       whose annualized base compensation is unspecified are put at the end of
+        #       search results.
         #     * "annualized`_`total`_`compensation desc": By job's
-        #       {Google::Cloud::Talent::V4beta1::CompensationInfo#annualized_total_compensation_range CompensationInfo#annualized_total_compensation_range}
-        #       descending. Jobs whose annualized base compensation is unspecified are put
-        #       at the end of search results.
+        #       {Google::Cloud::Talent::V4beta1::CompensationInfo#annualized_total_compensation_range CompensationInfo#annualized_total_compensation_range} descending. Jobs
+        #       whose annualized base compensation is unspecified are put at the end of
+        #       search results.
         #     * "custom`_`ranking desc": By the relevance score adjusted to the
         #       {SearchJobsRequest#custom_ranking_info#ranking_expression} with weight
         #       factor assigned by
@@ -445,9 +443,8 @@ module Google
         #     displayed to the job seeker higher up in the results, with the other jobs
         #     being displayed lower down in the results.
         #
-        #     Defaults to
-        #     {Google::Cloud::Talent::V4beta1::SearchJobsRequest::DiversificationLevel::SIMPLE DiversificationLevel::SIMPLE}
-        #     if no value is specified.
+        #     Defaults to {Google::Cloud::Talent::V4beta1::SearchJobsRequest::DiversificationLevel::SIMPLE DiversificationLevel::SIMPLE} if no value
+        #     is specified.
         # @!attribute [rw] custom_ranking_info
         #   @return [Google::Cloud::Talent::V4beta1::SearchJobsRequest::CustomRankingInfo]
         #     Optional.
@@ -459,16 +456,13 @@ module Google
         #     Optional.
         #
         #     Controls whether to disable exact keyword match on {Job#job_title},
-        #     {Google::Cloud::Talent::V4beta1::Job#description Job#description},
-        #     {Google::Cloud::Talent::V4beta1::Job#company_display_name Job#company_display_name},
-        #     [Job.locations][0],
-        #     {Google::Cloud::Talent::V4beta1::Job#qualifications Job#qualifications}. When
-        #     disable keyword match is turned off, a keyword match returns jobs that do
-        #     not match given category filters when there are matching keywords. For
-        #     example, for the query "program manager," a result is returned even if the
-        #     job posting has the title "software developer," which doesn't fall into
-        #     "program manager" ontology, but does have "program manager" appearing in
-        #     its description.
+        #     {Google::Cloud::Talent::V4beta1::Job#description Job#description}, {Google::Cloud::Talent::V4beta1::Job#company_display_name Job#company_display_name}, [Job.locations][0],
+        #     {Google::Cloud::Talent::V4beta1::Job#qualifications Job#qualifications}. When disable keyword match is turned off, a
+        #     keyword match returns jobs that do not match given category filters when
+        #     there are matching keywords. For example, for the query "program manager,"
+        #     a result is returned even if the job posting has the title "software
+        #     developer," which doesn't fall into "program manager" ontology, but does
+        #     have "program manager" appearing in its description.
         #
         #     For queries like "cloud" that don't contain title or
         #     location specific ontology, jobs with "cloud" keyword matches are returned
@@ -483,15 +477,14 @@ module Google
         class SearchJobsRequest
           # Input only.
           #
-          # Custom ranking information for
-          # {Google::Cloud::Talent::V4beta1::SearchJobsRequest SearchJobsRequest}.
+          # Custom ranking information for {Google::Cloud::Talent::V4beta1::SearchJobsRequest SearchJobsRequest}.
           # @!attribute [rw] importance_level
           #   @return [Google::Cloud::Talent::V4beta1::SearchJobsRequest::CustomRankingInfo::ImportanceLevel]
           #     Required.
           #
           #     Controls over how important the score of
-          #     {Google::Cloud::Talent::V4beta1::SearchJobsRequest::CustomRankingInfo#ranking_expression CustomRankingInfo#ranking_expression}
-          #     gets applied to job's final ranking position.
+          #     {Google::Cloud::Talent::V4beta1::SearchJobsRequest::CustomRankingInfo#ranking_expression CustomRankingInfo#ranking_expression} gets applied to job's final
+          #     ranking position.
           #
           #     An error is thrown if not specified.
           # @!attribute [rw] ranking_expression
@@ -505,10 +498,8 @@ module Google
           #     The syntax for this expression is a subset of Google SQL syntax.
           #
           #     Supported operators are: +, -, *, /, where the left and right side of
-          #     the operator is either a numeric
-          #     {Google::Cloud::Talent::V4beta1::Job#custom_attributes Job#custom_attributes}
-          #     key, integer/double value or an expression that can be evaluated to a
-          #     number.
+          #     the operator is either a numeric {Google::Cloud::Talent::V4beta1::Job#custom_attributes Job#custom_attributes} key,
+          #     integer/double value or an expression that can be evaluated to a number.
           #
           #     Parenthesis are supported to adjust calculation precedence. The
           #     expression must be < 100 characters in length.
@@ -516,8 +507,7 @@ module Google
           #     Sample ranking expression
           #     (year + 25) * 0.25 - (freshness / 0.5)
           class CustomRankingInfo
-            # The importance level for
-            # {Google::Cloud::Talent::V4beta1::SearchJobsRequest::CustomRankingInfo#ranking_expression CustomRankingInfo#ranking_expression}.
+            # The importance level for {Google::Cloud::Talent::V4beta1::SearchJobsRequest::CustomRankingInfo#ranking_expression CustomRankingInfo#ranking_expression}.
             module ImportanceLevel
               # Default value if the importance level isn't specified.
               IMPORTANCE_LEVEL_UNSPECIFIED = 0
@@ -599,8 +589,7 @@ module Google
         # Response for SearchJob method.
         # @!attribute [rw] matching_jobs
         #   @return [Array<Google::Cloud::Talent::V4beta1::SearchJobsResponse::MatchingJob>]
-        #     The Job entities that match the specified
-        #     {Google::Cloud::Talent::V4beta1::SearchJobsRequest SearchJobsRequest}.
+        #     The Job entities that match the specified {Google::Cloud::Talent::V4beta1::SearchJobsRequest SearchJobsRequest}.
         # @!attribute [rw] histogram_query_results
         #   @return [Array<Google::Cloud::Talent::V4beta1::HistogramQueryResult>]
         #     The histogram results that match with specified
@@ -644,12 +633,10 @@ module Google
         class SearchJobsResponse
           # Output only.
           #
-          # Job entry with metadata inside
-          # {Google::Cloud::Talent::V4beta1::SearchJobsResponse SearchJobsResponse}.
+          # Job entry with metadata inside {Google::Cloud::Talent::V4beta1::SearchJobsResponse SearchJobsResponse}.
           # @!attribute [rw] job
           #   @return [Google::Cloud::Talent::V4beta1::Job]
-          #     Job resource that matches the specified
-          #     {Google::Cloud::Talent::V4beta1::SearchJobsRequest SearchJobsRequest}.
+          #     Job resource that matches the specified {Google::Cloud::Talent::V4beta1::SearchJobsRequest SearchJobsRequest}.
           # @!attribute [rw] job_summary
           #   @return [String]
           #     A summary of the job with core information that's displayed on the search
@@ -661,12 +648,10 @@ module Google
           #     query keywords are enclosed in HTML bold tags.
           # @!attribute [rw] search_text_snippet
           #   @return [String]
-          #     Contains snippets of text from the
-          #     {Google::Cloud::Talent::V4beta1::Job#description Job#description} and
-          #     similar fields that most closely match a search query's keywords, if
-          #     available. All HTML tags in the original fields are stripped when
-          #     returned in this field, and matching query keywords are enclosed in HTML
-          #     bold tags.
+          #     Contains snippets of text from the {Google::Cloud::Talent::V4beta1::Job#description Job#description} and similar
+          #     fields that most closely match a search query's keywords, if available.
+          #     All HTML tags in the original fields are stripped when returned in this
+          #     field, and matching query keywords are enclosed in HTML bold tags.
           # @!attribute [rw] commute_info
           #   @return [Google::Cloud::Talent::V4beta1::SearchJobsResponse::CommuteInfo]
           #     Commute information which is generated based on specified
@@ -689,38 +674,25 @@ module Google
         end
 
         # An enum that specifies the job attributes that are returned in the
-        # {MatchingJob::Job} in
-        # {Google::Cloud::Talent::V4beta1::SearchJobsResponse SearchJobsResponse} or
-        # {Google::Cloud::Talent::V4beta1::Job Job} objects in
+        # {MatchingJob::Job} in {Google::Cloud::Talent::V4beta1::SearchJobsResponse SearchJobsResponse} or {Google::Cloud::Talent::V4beta1::Job Job} objects in
         # {Google::Cloud::Talent::V4beta1::ListJobsResponse ListJobsResponse}.
         module JobView
           # Default value.
           JOB_VIEW_UNSPECIFIED = 0
 
           # A ID only view of job, with following attributes:
-          # {Google::Cloud::Talent::V4beta1::Job#name Job#name},
-          # {Google::Cloud::Talent::V4beta1::Job#requisition_id Job#requisition_id},
-          # {Google::Cloud::Talent::V4beta1::Job#language_code Job#language_code}.
+          # {Google::Cloud::Talent::V4beta1::Job#name Job#name}, {Google::Cloud::Talent::V4beta1::Job#requisition_id Job#requisition_id}, {Google::Cloud::Talent::V4beta1::Job#language_code Job#language_code}.
           JOB_VIEW_ID_ONLY = 1
 
           # A minimal view of the job, with the following attributes:
-          # {Google::Cloud::Talent::V4beta1::Job#name Job#name},
-          # {Google::Cloud::Talent::V4beta1::Job#requisition_id Job#requisition_id},
-          # {Job#job_title},
-          # {Google::Cloud::Talent::V4beta1::Job#company_name Job#company_name},
-          # {Google::Cloud::Talent::V4beta1::Job::DerivedInfo#locations Job::DerivedInfo#locations},
-          # {Google::Cloud::Talent::V4beta1::Job#language_code Job#language_code}.
+          # {Google::Cloud::Talent::V4beta1::Job#name Job#name}, {Google::Cloud::Talent::V4beta1::Job#requisition_id Job#requisition_id}, {Job#job_title},
+          # {Google::Cloud::Talent::V4beta1::Job#company Job#company}, {Google::Cloud::Talent::V4beta1::Job::DerivedInfo#locations Job::DerivedInfo#locations}, {Google::Cloud::Talent::V4beta1::Job#language_code Job#language_code}.
           JOB_VIEW_MINIMAL = 2
 
           # A small view of the job, with the following attributes in the search
-          # results: {Google::Cloud::Talent::V4beta1::Job#name Job#name},
-          # {Google::Cloud::Talent::V4beta1::Job#requisition_id Job#requisition_id},
-          # {Job#job_title},
-          # {Google::Cloud::Talent::V4beta1::Job#company_name Job#company_name},
-          # {Google::Cloud::Talent::V4beta1::Job::DerivedInfo#locations Job::DerivedInfo#locations},
-          # {Google::Cloud::Talent::V4beta1::Job#visibility Job#visibility},
-          # {Google::Cloud::Talent::V4beta1::Job#language_code Job#language_code},
-          # {Google::Cloud::Talent::V4beta1::Job#description Job#description}.
+          # results: {Google::Cloud::Talent::V4beta1::Job#name Job#name}, {Google::Cloud::Talent::V4beta1::Job#requisition_id Job#requisition_id}, {Job#job_title},
+          # {Google::Cloud::Talent::V4beta1::Job#company Job#company}, {Google::Cloud::Talent::V4beta1::Job::DerivedInfo#locations Job::DerivedInfo#locations}, {Google::Cloud::Talent::V4beta1::Job#visibility Job#visibility},
+          # {Google::Cloud::Talent::V4beta1::Job#language_code Job#language_code}, {Google::Cloud::Talent::V4beta1::Job#description Job#description}.
           JOB_VIEW_SMALL = 3
 
           # All available attributes are included in the search results.