google-api-client 0.42.2 → 0.45.0

data/generated/google/apis/jobs_v3/service.rb

@@ -48,52 +48,39 @@ module Google
           @batch_path = 'batch'
         end
         
-        # Completes the specified prefix with keyword suggestions.
-        # Intended for use by a job search auto-complete search box.
+        # Completes the specified prefix with keyword suggestions. Intended for use by a
+        # job search auto-complete search box.
         # @param [String] name
-        #   Required. Resource name of project the completion is performed within.
-        #   The format is "projects/`project_id`", for example,
-        #   "projects/api-test-project".
+        #   Required. Resource name of project the completion is performed within. The
+        #   format is "projects/`project_id`", for example, "projects/api-test-project".
         # @param [String] company_name
-        #   Optional. If provided, restricts completion to specified company.
-        #   The format is "projects/`project_id`/companies/`company_id`", for example,
-        #   "projects/api-test-project/companies/foo".
+        #   Optional. If provided, restricts completion to specified company. The format
+        #   is "projects/`project_id`/companies/`company_id`", for example, "projects/api-
+        #   test-project/companies/foo".
         # @param [String] language_code
-        #   Deprecated. Use language_codes instead.
-        #   Optional.
-        #   The language of the query. This is
-        #   the BCP-47 language code, such as "en-US" or "sr-Latn".
-        #   For more information, see
-        #   [Tags for Identifying Languages](https://tools.ietf.org/html/bcp47).
-        #   For CompletionType.JOB_TITLE type, only open jobs with the same
-        #   language_code are returned.
-        #   For CompletionType.COMPANY_NAME type,
-        #   only companies having open jobs with the same language_code are
-        #   returned.
-        #   For CompletionType.COMBINED type, only open jobs with the same
-        #   language_code or companies having open jobs with the same
-        #   language_code are returned.
-        #   The maximum number of allowed characters is 255.
+        #   Deprecated. Use language_codes instead. Optional. The language of the query.
+        #   This is the BCP-47 language code, such as "en-US" or "sr-Latn". For more
+        #   information, see [Tags for Identifying Languages](https://tools.ietf.org/html/
+        #   bcp47). For CompletionType.JOB_TITLE type, only open jobs with the same
+        #   language_code are returned. For CompletionType.COMPANY_NAME type, only
+        #   companies having open jobs with the same language_code are returned. For
+        #   CompletionType.COMBINED type, only open jobs with the same language_code or
+        #   companies having open jobs with the same language_code are returned. The
+        #   maximum number of allowed characters is 255.
         # @param [Array<String>, String] language_codes
-        #   Optional. The list of languages of the query. This is
-        #   the BCP-47 language code, such as "en-US" or "sr-Latn".
-        #   For more information, see
-        #   [Tags for Identifying Languages](https://tools.ietf.org/html/bcp47).
-        #   For CompletionType.JOB_TITLE type, only open jobs with the same
-        #   language_codes are returned.
-        #   For CompletionType.COMPANY_NAME type,
-        #   only companies having open jobs with the same language_codes are
-        #   returned.
-        #   For CompletionType.COMBINED type, only open jobs with the same
-        #   language_codes or companies having open jobs with the same
-        #   language_codes are returned.
-        #   The maximum number of allowed characters is 255.
+        #   Optional. The list of languages of the query. This is the BCP-47 language code,
+        #   such as "en-US" or "sr-Latn". For more information, see [Tags for Identifying
+        #   Languages](https://tools.ietf.org/html/bcp47). For CompletionType.JOB_TITLE
+        #   type, only open jobs with the same language_codes are returned. For
+        #   CompletionType.COMPANY_NAME type, only companies having open jobs with the
+        #   same language_codes are returned. For CompletionType.COMBINED type, only open
+        #   jobs with the same language_codes or companies having open jobs with the same
+        #   language_codes are returned. The maximum number of allowed characters is 255.
         # @param [Fixnum] page_size
-        #   Required. Completion result count.
-        #   The maximum allowed page size is 10.
+        #   Required. Completion result count. The maximum allowed page size is 10.
         # @param [String] query
-        #   Required. The query used to generate suggestions.
-        #   The maximum number of allowed characters is 255.
+        #   Required. The query used to generate suggestions. The maximum number of
+        #   allowed characters is 255.
         # @param [String] scope
         #   Optional. The scope of the completion. The defaults is CompletionScope.PUBLIC.
         # @param [String] type
@@ -132,12 +119,10 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Report events issued when end user interacts with customer's application
-        # that uses Cloud Talent Solution. You may inspect the created events in
-        # [self service
-        # tools](https://console.cloud.google.com/talent-solution/overview).
-        # [Learn
-        # more](https://cloud.google.com/talent-solution/docs/management-tools)
+        # Report events issued when end user interacts with customer's application that
+        # uses Cloud Talent Solution. You may inspect the created events in [self
+        # service tools](https://console.cloud.google.com/talent-solution/overview). [
+        # Learn more](https://cloud.google.com/talent-solution/docs/management-tools)
         # about self service tools.
         # @param [String] parent
         #   Parent project name.
@@ -173,9 +158,8 @@ module Google
         
         # Creates a new company entity.
         # @param [String] parent
-        #   Required. Resource name of the project under which the company is created.
-        #   The format is "projects/`project_id`", for example,
-        #   "projects/api-test-project".
+        #   Required. Resource name of the project under which the company is created. The
+        #   format is "projects/`project_id`", for example, "projects/api-test-project".
         # @param [Google::Apis::JobsV3::CreateCompanyRequest] create_company_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -206,12 +190,12 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes specified company.
-        # Prerequisite: The company has no jobs associated with it.
+        # Deletes specified company. Prerequisite: The company has no jobs associated
+        # with it.
         # @param [String] name
-        #   Required. The resource name of the company to be deleted.
-        #   The format is "projects/`project_id`/companies/`company_id`", for example,
-        #   "projects/api-test-project/companies/foo".
+        #   Required. The resource name of the company to be deleted. The format is "
+        #   projects/`project_id`/companies/`company_id`", for example, "projects/api-test-
+        #   project/companies/foo".
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -241,9 +225,9 @@ module Google
         
         # Retrieves specified company.
         # @param [String] name
-        #   Required. The resource name of the company to be retrieved.
-        #   The format is "projects/`project_id`/companies/`company_id`", for example,
-        #   "projects/api-test-project/companies/foo".
+        #   Required. The resource name of the company to be retrieved. The format is "
+        #   projects/`project_id`/companies/`company_id`", for example, "projects/api-test-
+        #   project/companies/foo".
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -273,18 +257,16 @@ module Google
         
         # Lists all companies associated with the service account.
         # @param [String] parent
-        #   Required. Resource name of the project under which the company is created.
-        #   The format is "projects/`project_id`", for example,
-        #   "projects/api-test-project".
+        #   Required. Resource name of the project under which the company is created. The
+        #   format is "projects/`project_id`", for example, "projects/api-test-project".
         # @param [Fixnum] page_size
-        #   Optional. The maximum number of companies to be returned, at most 100.
-        #   Default is 100 if a non-positive number is provided.
+        #   Optional. The maximum number of companies to be returned, at most 100. Default
+        #   is 100 if a non-positive number is provided.
         # @param [String] page_token
         #   Optional. The starting indicator from which to return results.
         # @param [Boolean] require_open_jobs
-        #   Optional. Set to true if the companies requested must have open jobs.
-        #   Defaults to false.
-        #   If true, at most page_size of companies are fetched, among which
+        #   Optional. Set to true if the companies requested must have open jobs. Defaults
+        #   to false. If true, at most page_size of companies are fetched, among which
         #   only those with open jobs are returned.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -316,15 +298,14 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Updates specified company. Company names can't be updated. To update a
-        # company name, delete the company and all jobs associated with it, and only
-        # then re-create them.
+        # Updates specified company. Company names can't be updated. To update a company
+        # name, delete the company and all jobs associated with it, and only then re-
+        # create them.
         # @param [String] name
-        #   Required during company update.
-        #   The resource name for a company. This is generated by the service when a
-        #   company is created.
-        #   The format is "projects/`project_id`/companies/`company_id`", for example,
-        #   "projects/api-test-project/companies/foo".
+        #   Required during company update. The resource name for a company. This is
+        #   generated by the service when a company is created. The format is "projects/`
+        #   project_id`/companies/`company_id`", for example, "projects/api-test-project/
+        #   companies/foo".
         # @param [Google::Apis::JobsV3::UpdateCompanyRequest] update_company_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -357,9 +338,8 @@ module Google
         
         # Deletes a list of Jobs by filter.
         # @param [String] parent
-        #   Required. The resource name of the project under which the job is created.
-        #   The format is "projects/`project_id`", for example,
-        #   "projects/api-test-project".
+        #   Required. The resource name of the project under which the job is created. The
+        #   format is "projects/`project_id`", for example, "projects/api-test-project".
         # @param [Google::Apis::JobsV3::BatchDeleteJobsRequest] batch_delete_jobs_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -390,13 +370,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates a new job.
-        # Typically, the job becomes searchable within 10 seconds, but it may take
-        # up to 5 minutes.
+        # Creates a new job. Typically, the job becomes searchable within 10 seconds,
+        # but it may take up to 5 minutes.
         # @param [String] parent
-        #   Required. The resource name of the project under which the job is created.
-        #   The format is "projects/`project_id`", for example,
-        #   "projects/api-test-project".
+        #   Required. The resource name of the project under which the job is created. The
+        #   format is "projects/`project_id`", for example, "projects/api-test-project".
         # @param [Google::Apis::JobsV3::CreateJobRequest] create_job_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -427,13 +405,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes the specified job.
-        # Typically, the job becomes unsearchable within 10 seconds, but it may take
-        # up to 5 minutes.
+        # Deletes the specified job. Typically, the job becomes unsearchable within 10
+        # seconds, but it may take up to 5 minutes.
         # @param [String] name
-        #   Required. 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".
+        #   Required. 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".
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -461,12 +437,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Retrieves the specified job, whose status is OPEN or recently EXPIRED
-        # within the last 90 days.
+        # Retrieves the specified job, whose status is OPEN or recently EXPIRED within
+        # the last 90 days.
         # @param [String] name
-        #   Required. 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".
+        #   Required. 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".
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -496,28 +471,22 @@ module Google
         
         # Lists jobs by filter.
         # @param [String] parent
-        #   Required. The resource name of the project under which the job is created.
-        #   The format is "projects/`project_id`", for example,
-        #   "projects/api-test-project".
+        #   Required. The resource name of the project under which the job is created. The
+        #   format is "projects/`project_id`", for example, "projects/api-test-project".
         # @param [String] filter
-        #   Required. The filter string specifies the jobs to be enumerated.
-        #   Supported operator: =, AND
-        #   The fields eligible for filtering are:
-        #   * `companyName` (Required)
-        #   * `requisitionId` (Optional)
-        #   Sample Query:
-        #   * companyName = "projects/api-test-project/companies/123"
-        #   * companyName = "projects/api-test-project/companies/123" AND requisitionId
-        #   = "req-1"
+        #   Required. The filter string specifies the jobs to be enumerated. Supported
+        #   operator: =, AND The fields eligible for filtering are: * `companyName` (
+        #   Required) * `requisitionId` (Optional) Sample Query: * companyName = "projects/
+        #   api-test-project/companies/123" * companyName = "projects/api-test-project/
+        #   companies/123" AND requisitionId = "req-1"
         # @param [String] job_view
-        #   Optional. The desired job attributes returned for jobs in the
-        #   search response. Defaults to JobView.JOB_VIEW_FULL if no value is
-        #   specified.
+        #   Optional. The desired job attributes returned for jobs in the search response.
+        #   Defaults to JobView.JOB_VIEW_FULL if no value is specified.
         # @param [Fixnum] page_size
-        #   Optional. The maximum number of jobs to be returned per page of results.
-        #   If job_view is set to 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.
+        #   Optional. The maximum number of jobs to be returned per page of results. If
+        #   job_view is set to 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.
         # @param [String] page_token
         #   Optional. The starting point of a query result.
         # @param [String] fields
@@ -551,16 +520,13 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Updates specified job.
-        # Typically, updated contents become visible in search results within 10
-        # seconds, but it may take up to 5 minutes.
+        # Updates specified job. Typically, updated contents become visible in search
+        # results within 10 seconds, but it may take up to 5 minutes.
         # @param [String] name
-        #   Required during job update.
-        #   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".
-        #   Use of this field in job queries and API calls is preferred over the use of
+        #   Required during job update. 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". Use of
+        #   this field in job queries and API calls is preferred over the use of
         #   requisition_id since this value is unique.
         # @param [Google::Apis::JobsV3::UpdateJobRequest] update_job_request_object
         # @param [String] fields
@@ -592,14 +558,12 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Searches for jobs using the provided SearchJobsRequest.
-        # This call constrains the visibility of jobs
-        # present in the database, and only returns jobs that the caller has
-        # permission to search against.
+        # Searches for jobs using the provided SearchJobsRequest. This call constrains
+        # the visibility of jobs present in the database, and only returns jobs that the
+        # caller has permission to search against.
         # @param [String] parent
-        #   Required. The resource name of the project to search within.
-        #   The format is "projects/`project_id`", for example,
-        #   "projects/api-test-project".
+        #   Required. The resource name of the project to search within. The format is "
+        #   projects/`project_id`", for example, "projects/api-test-project".
         # @param [Google::Apis::JobsV3::SearchJobsRequest] search_jobs_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -630,18 +594,16 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Searches for jobs using the provided SearchJobsRequest.
-        # This API call is intended for the use case of targeting passive job
-        # seekers (for example, job seekers who have signed up to receive email
-        # alerts about potential job opportunities), and has different algorithmic
-        # adjustments that are targeted to passive job seekers.
-        # This call constrains the visibility of jobs
-        # present in the database, and only returns jobs the caller has
-        # permission to search against.
+        # Searches for jobs using the provided SearchJobsRequest. This API call is
+        # intended for the use case of targeting passive job seekers (for example, job
+        # seekers who have signed up to receive email alerts about potential job
+        # opportunities), and has different algorithmic adjustments that are targeted to
+        # passive job seekers. This call constrains the visibility of jobs present in
+        # the database, and only returns jobs the caller has permission to search
+        # against.
         # @param [String] parent
-        #   Required. The resource name of the project to search within.
-        #   The format is "projects/`project_id`", for example,
-        #   "projects/api-test-project".
+        #   Required. The resource name of the project to search within. The format is "
+        #   projects/`project_id`", for example, "projects/api-test-project".
         # @param [Google::Apis::JobsV3::SearchJobsRequest] search_jobs_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.

data/generated/google/apis/jobs_v3p1beta1.rb

@@ -26,7 +26,7 @@ module Google
     # @see https://cloud.google.com/talent-solution/job-search/docs/
     module JobsV3p1beta1
       VERSION = 'V3p1beta1'
-      REVISION = '20200604'
+      REVISION = '20200828'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

data/generated/google/apis/jobs_v3p1beta1/classes.rb

@@ -26,34 +26,26 @@ module Google
       class ApplicationInfo
         include Google::Apis::Core::Hashable
       
-        # Optional but at least one of uris,
-        # emails or instruction must be
-        # specified.
-        # Use this field to specify email address(es) to which resumes or
-        # applications can be sent.
-        # The maximum number of allowed characters for each entry is 255.
+        # Optional but at least one of uris, emails or instruction must be specified.
+        # Use this field to specify email address(es) to which resumes or applications
+        # can be sent. The maximum number of allowed characters for each entry is 255.
         # Corresponds to the JSON property `emails`
         # @return [Array<String>]
         attr_accessor :emails
       
-        # Optional but at least one of uris,
-        # emails or instruction must be
-        # specified.
-        # Use this field to provide instructions, such as "Mail your application
-        # to ...", that a candidate can follow to apply for the job.
-        # This field accepts and sanitizes HTML input, and also accepts
-        # bold, italic, ordered list, and unordered list markup tags.
-        # The maximum number of allowed characters is 3,000.
+        # Optional but at least one of uris, emails or instruction must be specified.
+        # Use this field to provide instructions, such as "Mail your application to ...",
+        # that a candidate can follow to apply for the job. This field accepts and
+        # sanitizes HTML input, and also accepts bold, italic, ordered list, and
+        # unordered list markup tags. The maximum number of allowed characters is 3,000.
         # Corresponds to the JSON property `instruction`
         # @return [String]
         attr_accessor :instruction
       
-        # Optional but at least one of uris,
-        # emails or instruction must be
-        # specified.
-        # Use this URI field to direct an applicant to a website, for example to
-        # link to an online application form.
-        # The maximum number of allowed characters for each entry is 2,000.
+        # Optional but at least one of uris, emails or instruction must be specified.
+        # Use this URI field to direct an applicant to a website, for example to link to
+        # an online application form. The maximum number of allowed characters for each
+        # entry is 2,000.
         # Corresponds to the JSON property `uris`
         # @return [Array<String>]
         attr_accessor :uris
@@ -70,18 +62,14 @@ module Google
         end
       end
       
-      # Input only.
-      # Batch delete jobs request.
+      # Input only. Batch delete jobs request.
       class BatchDeleteJobsRequest
         include Google::Apis::Core::Hashable
       
-        # Required. The filter string specifies the jobs to be deleted.
-        # Supported operator: =, AND
-        # The fields eligible for filtering are:
-        # * `companyName` (Required)
-        # * `requisitionId` (Required)
-        # Sample Query: companyName = "projects/api-test-project/companies/123" AND
-        # requisitionId = "req-1"
+        # Required. The filter string specifies the jobs to be deleted. Supported
+        # operator: =, AND The fields eligible for filtering are: * `companyName` (
+        # Required) * `requisitionId` (Required) Sample Query: companyName = "projects/
+        # api-test-project/companies/123" AND requisitionId = "req-1"
         # Corresponds to the JSON property `filter`
         # @return [String]
         attr_accessor :filter
@@ -148,9 +136,9 @@ module Google
       
       # An event issued when an end user interacts with the application that
       # implements Cloud Talent Solution. Providing this information improves the
-      # quality of search and recommendation for the API clients, enabling the
-      # service to perform optimally. The number of events sent must be consistent
-      # with other calls, such as job searches, issued to the service by the client.
+      # quality of search and recommendation for the API clients, enabling the service
+      # to perform optimally. The number of events sent must be consistent with other
+      # calls, such as job searches, issued to the service by the client.
       class ClientEvent
         include Google::Apis::Core::Hashable
       
@@ -160,19 +148,16 @@ module Google
         attr_accessor :create_time
       
         # Required. A unique identifier, generated by the client application. This `
-        # event_id`
-        # is used to establish the relationship between different events
-        # (see parent_event_id).
+        # event_id` is used to establish the relationship between different events (see
+        # parent_event_id).
         # Corresponds to the JSON property `eventId`
         # @return [String]
         attr_accessor :event_id
       
         # Optional. Extra information about this event. Used for storing information
-        # with no
-        # matching field in event payload, for example, user application specific
-        # context or details.
-        # At most 20 keys are supported. The maximum total size of all keys and
-        # values is 2 KB.
+        # with no matching field in event payload, for example, user application
+        # specific context or details. At most 20 keys are supported. The maximum total
+        # size of all keys and values is 2 KB.
         # Corresponds to the JSON property `extraInfo`
         # @return [Hash<String,String>]
         attr_accessor :extra_info
@@ -184,13 +169,10 @@ module Google
         attr_accessor :job_event
       
         # Optional. The event_id of an event that resulted in the current event. For
-        # example, a
-        # Job view event usually follows a parent
-        # impression event: A job seeker first does a
-        # search where a list of jobs appears
-        # (impression). The job seeker then selects a
-        # result and views the description of a particular job (Job
-        # view).
+        # example, a Job view event usually follows a parent impression event: A job
+        # seeker first does a search where a list of jobs appears (impression). The job
+        # seeker then selects a result and views the description of a particular job (
+        # Job view).
         # Corresponds to the JSON property `parentEventId`
         # @return [String]
         attr_accessor :parent_event_id
@@ -216,21 +198,18 @@ module Google
         end
       end
       
-      # Input only.
-      # Parameters needed for commute search.
+      # Input only. Parameters needed for commute search.
       class CommuteFilter
         include Google::Apis::Core::Hashable
       
         # Optional. If true, jobs without "precise" addresses (street level addresses or
-        # GPS
-        # coordinates) might also be returned. For city and coarser level addresses,
-        # text matching is used. If this field is set to false or is not specified,
-        # only jobs that include precise addresses are returned by Commute
-        # Search.
-        # Note: If `allow_imprecise_addresses` is set to true, Commute Search is not
-        # able to calculate accurate commute times to jobs with city level and
-        # coarser address information. Jobs with imprecise addresses will return a
-        # `travel_duration` time of 0 regardless of distance from the job seeker.
+        # GPS coordinates) might also be returned. For city and coarser level addresses,
+        # text matching is used. If this field is set to false or is not specified, only
+        # jobs that include precise addresses are returned by Commute Search. Note: If `
+        # allow_imprecise_addresses` is set to true, Commute Search is not able to
+        # calculate accurate commute times to jobs with city level and coarser address
+        # information. Jobs with imprecise addresses will return a `travel_duration`
+        # time of 0 regardless of distance from the job seeker.
         # Corresponds to the JSON property `allowImpreciseAddresses`
         # @return [Boolean]
         attr_accessor :allow_imprecise_addresses
@@ -241,8 +220,8 @@ module Google
         # @return [String]
         attr_accessor :commute_method
       
-        # Represents a time of day. The date and time zone are either not significant
-        # or are specified elsewhere. An API may choose to allow leap seconds. Related
+        # Represents a time of day. The date and time zone are either not significant or
+        # are specified elsewhere. An API may choose to allow leap seconds. Related
         # types are google.type.Date and `google.protobuf.Timestamp`.
         # Corresponds to the JSON property `departureTime`
         # @return [Google::Apis::JobsV3p1beta1::TimeOfDay]
@@ -255,16 +234,14 @@ module Google
       
         # An object representing a latitude/longitude pair. This is expressed as a pair
         # of doubles representing degrees latitude and degrees longitude. Unless
-        # specified otherwise, this must conform to the
-        # <a href="http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf">WGS84
-        # standard</a>. Values must be within normalized ranges.
+        # specified otherwise, this must conform to the WGS84 standard. Values must be
+        # within normalized ranges.
         # Corresponds to the JSON property `startCoordinates`
         # @return [Google::Apis::JobsV3p1beta1::LatLng]
         attr_accessor :start_coordinates
       
         # Required. The maximum travel time in seconds. The maximum allowed value is `
-        # 3600s`
-        # (one hour). Format is `123s`.
+        # 3600s` (one hour). Format is `123s`.
         # Corresponds to the JSON property `travelDuration`
         # @return [String]
         attr_accessor :travel_duration
@@ -284,21 +261,19 @@ module Google
         end
       end
       
-      # Output only.
-      # Commute details related to this job.
+      # Output only. Commute details related to this job.
       class CommuteInfo
         include Google::Apis::Core::Hashable
       
-        # Output only.
-        # A resource that represents a location with full geographic information.
+        # Output only. A resource that represents a location with full geographic
+        # information.
         # Corresponds to the JSON property `jobLocation`
         # @return [Google::Apis::JobsV3p1beta1::Location]
         attr_accessor :job_location
       
-        # The number of seconds required to travel to the job location from the
-        # query location. A duration of 0 seconds indicates that the job is not
-        # reachable within the requested duration, but was returned as part of an
-        # expanded query.
+        # The number of seconds required to travel to the job location from the query
+        # location. A duration of 0 seconds indicates that the job is not reachable
+        # within the requested duration, but was returned as part of an expanded query.
         # Corresponds to the JSON property `travelDuration`
         # @return [String]
         attr_accessor :travel_duration
@@ -321,8 +296,7 @@ module Google
         include Google::Apis::Core::Hashable
       
         # Optional. The URI to employer's career site or careers page on the employer's
-        # web
-        # site, for example, "https://careers.google.com".
+        # web site, for example, "https://careers.google.com".
         # Corresponds to the JSON property `careerSiteUri`
         # @return [String]
         attr_accessor :career_site_uri
@@ -337,32 +311,29 @@ module Google
         # @return [String]
         attr_accessor :display_name
       
-        # Optional. Equal Employment Opportunity legal disclaimer text to be
-        # associated with all jobs, and typically to be displayed in all
-        # roles.
-        # The maximum number of allowed characters is 500.
+        # Optional. Equal Employment Opportunity legal disclaimer text to be associated
+        # with all jobs, and typically to be displayed in all roles. The maximum number
+        # of allowed characters is 500.
         # Corresponds to the JSON property `eeoText`
         # @return [String]
         attr_accessor :eeo_text
       
         # Required. Client side company identifier, used to uniquely identify the
-        # company.
-        # The maximum number of allowed characters is 255.
+        # company. The maximum number of allowed characters is 255.
         # Corresponds to the JSON property `externalId`
         # @return [String]
         attr_accessor :external_id
       
         # Optional. The street address of the company's main headquarters, which may be
-        # different from the job location. The service attempts
-        # to geolocate the provided address, and populates a more specific
-        # location wherever possible in DerivedInfo.headquarters_location.
+        # different from the job location. The service attempts to geolocate the
+        # provided address, and populates a more specific location wherever possible in
+        # DerivedInfo.headquarters_location.
         # Corresponds to the JSON property `headquartersAddress`
         # @return [String]
         attr_accessor :headquarters_address
       
         # Optional. Set to true if it is the hiring agency that post jobs for other
-        # employers.
-        # Defaults to false if not provided.
+        # employers. Defaults to false if not provided.
         # Corresponds to the JSON property `hiringAgency`
         # @return [Boolean]
         attr_accessor :hiring_agency
@@ -374,20 +345,19 @@ module Google
         attr_accessor :image_uri
       
         # Optional. A list of keys of filterable Job.custom_attributes, whose
-        # corresponding `string_values` are used in keyword search. Jobs with
-        # `string_values` under these specified field keys are returned if any
-        # of the values matches the search keyword. Custom field values with
-        # parenthesis, brackets and special symbols won't be properly searchable,
-        # and those keyword queries need to be surrounded by quotes.
+        # corresponding `string_values` are used in keyword search. Jobs with `
+        # string_values` under these specified field keys are returned if any of the
+        # values matches the search keyword. Custom field values with parenthesis,
+        # brackets and special symbols won't be properly searchable, and those keyword
+        # queries need to be surrounded by quotes.
         # Corresponds to the JSON property `keywordSearchableJobCustomAttributes`
         # @return [Array<String>]
         attr_accessor :keyword_searchable_job_custom_attributes
       
-        # Required during company update.
-        # The resource name for a company. This is generated by the service when a
-        # company is created.
-        # The format is "projects/`project_id`/companies/`company_id`", for example,
-        # "projects/api-test-project/companies/foo".
+        # Required during company update. The resource name for a company. This is
+        # generated by the service when a company is created. The format is "projects/`
+        # project_id`/companies/`company_id`", for example, "projects/api-test-project/
+        # companies/foo".
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -406,8 +376,8 @@ module Google
         alias_method :suspended?, :suspended
       
         # Optional. The URI representing the company's primary web site or home page,
-        # for example, "https://www.google.com".
-        # The maximum number of allowed characters is 255.
+        # for example, "https://www.google.com". The maximum number of allowed
+        # characters is 255.
         # Corresponds to the JSON property `websiteUri`
         # @return [String]
         attr_accessor :website_uri
@@ -438,8 +408,8 @@ module Google
       class CompanyDerivedInfo
         include Google::Apis::Core::Hashable
       
-        # Output only.
-        # A resource that represents a location with full geographic information.
+        # Output only. A resource that represents a location with full geographic
+        # information.
         # Corresponds to the JSON property `headquartersLocation`
         # @return [Google::Apis::JobsV3p1beta1::Location]
         attr_accessor :headquarters_location
@@ -454,13 +424,11 @@ module Google
         end
       end
       
-      # A compensation entry that represents one component of compensation, such
-      # as base pay, bonus, or other compensation type.
-      # Annualization: One compensation entry can be annualized if
-      # - it contains valid amount or range.
-      # - and its expected_units_per_year is set or can be derived.
-      # Its annualized range is determined as (amount or range) times
-      # expected_units_per_year.
+      # A compensation entry that represents one component of compensation, such as
+      # base pay, bonus, or other compensation type. Annualization: One compensation
+      # entry can be annualized if - it contains valid amount or range. - and its
+      # expected_units_per_year is set or can be derived. Its annualized range is
+      # determined as (amount or range) times expected_units_per_year.
       class CompensationEntry
         include Google::Apis::Core::Hashable
       
@@ -469,21 +437,16 @@ module Google
         # @return [Google::Apis::JobsV3p1beta1::Money]
         attr_accessor :amount
       
-        # Optional. Compensation description.  For example, could
-        # indicate equity terms or provide additional context to an estimated
-        # bonus.
+        # Optional. Compensation description. For example, could indicate equity terms
+        # or provide additional context to an estimated bonus.
         # Corresponds to the JSON property `description`
         # @return [String]
         attr_accessor :description
       
-        # Optional. Expected number of units paid each year. If not specified, when
-        # Job.employment_types is FULLTIME, a default value is inferred
-        # based on unit. Default values:
-        # - HOURLY: 2080
-        # - DAILY: 260
-        # - WEEKLY: 52
-        # - MONTHLY: 12
-        # - ANNUAL: 1
+        # Optional. Expected number of units paid each year. If not specified, when Job.
+        # employment_types is FULLTIME, a default value is inferred based on unit.
+        # Default values: - HOURLY: 2080 - DAILY: 260 - WEEKLY: 52 - MONTHLY: 12 -
+        # ANNUAL: 1
         # Corresponds to the JSON property `expectedUnitsPerYear`
         # @return [Float]
         attr_accessor :expected_units_per_year
@@ -493,14 +456,14 @@ module Google
         # @return [Google::Apis::JobsV3p1beta1::CompensationRange]
         attr_accessor :range
       
-        # Optional. Compensation type.
-        # Default is CompensationUnit.COMPENSATION_TYPE_UNSPECIFIED.
+        # Optional. Compensation type. Default is CompensationUnit.
+        # COMPENSATION_TYPE_UNSPECIFIED.
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type
       
-        # Optional. Frequency of the specified amount.
-        # Default is CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED.
+        # Optional. Frequency of the specified amount. Default is CompensationUnit.
+        # COMPENSATION_UNIT_UNSPECIFIED.
         # Corresponds to the JSON property `unit`
         # @return [String]
         attr_accessor :unit
@@ -520,8 +483,7 @@ module Google
         end
       end
       
-      # Input only.
-      # Filter on job compensation type and amount.
+      # Input only. Filter on job compensation type and amount.
       class CompensationFilter
         include Google::Apis::Core::Hashable
       
@@ -542,8 +504,8 @@ module Google
         # @return [String]
         attr_accessor :type
       
-        # Required. Specify desired `base compensation entry's`
-        # CompensationInfo.CompensationUnit.
+        # Required. Specify desired `base compensation entry's` CompensationInfo.
+        # CompensationUnit.
         # Corresponds to the JSON property `units`
         # @return [Array<String>]
         attr_accessor :units
@@ -561,21 +523,19 @@ module Google
         end
       end
       
-      # Input only.
-      # Compensation based histogram request.
+      # Input only. Compensation based histogram request.
       class CompensationHistogramRequest
         include Google::Apis::Core::Hashable
       
-        # Input only.
-        # Use this field to specify bucketing option for the histogram search response.
+        # Input only. Use this field to specify bucketing option for the histogram
+        # search response.
         # Corresponds to the JSON property `bucketingOption`
         # @return [Google::Apis::JobsV3p1beta1::NumericBucketingOption]
         attr_accessor :bucketing_option
       
         # Required. Type of the request, representing which field the histogramming
-        # should be
-        # performed over. A single request can only specify one histogram of each
-        # `CompensationHistogramRequestType`.
+        # should be performed over. A single request can only specify one histogram of
+        # each `CompensationHistogramRequestType`.
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type
@@ -591,19 +551,16 @@ module Google
         end
       end
       
-      # Output only.
-      # Compensation based histogram result.
+      # Output only. Compensation based histogram result.
       class CompensationHistogramResult
         include Google::Apis::Core::Hashable
       
-        # Output only.
-        # Custom numeric bucketing result.
+        # Output only. Custom numeric bucketing result.
         # Corresponds to the JSON property `result`
         # @return [Google::Apis::JobsV3p1beta1::NumericBucketingResult]
         attr_accessor :result
       
-        # Type of the request, corresponding to
-        # CompensationHistogramRequest.type.
+        # Type of the request, corresponding to CompensationHistogramRequest.type.
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type
@@ -633,10 +590,9 @@ module Google
         # @return [Google::Apis::JobsV3p1beta1::CompensationRange]
         attr_accessor :annualized_total_compensation_range
       
-        # Optional. Job compensation information.
-        # At most one entry can be of type
-        # CompensationInfo.CompensationType.BASE, which is
-        # referred as ** base compensation entry ** for the job.
+        # Optional. Job compensation information. At most one entry can be of type
+        # CompensationInfo.CompensationType.BASE, which is referred as ** base
+        # compensation entry ** for the job.
         # Corresponds to the JSON property `entries`
         # @return [Array<Google::Apis::JobsV3p1beta1::CompensationEntry>]
         attr_accessor :entries
@@ -678,8 +634,7 @@ module Google
         end
       end
       
-      # Output only.
-      # Response of auto-complete query.
+      # Output only. Response of auto-complete query.
       class CompleteQueryResponse
         include Google::Apis::Core::Hashable
       
@@ -688,8 +643,8 @@ module Google
         # @return [Array<Google::Apis::JobsV3p1beta1::CompletionResult>]
         attr_accessor :completion_results
       
-        # Output only.
-        # Additional information returned to client, such as debugging information.
+        # Output only. Additional information returned to client, such as debugging
+        # information.
         # Corresponds to the JSON property `metadata`
         # @return [Google::Apis::JobsV3p1beta1::ResponseMetadata]
         attr_accessor :metadata
@@ -705,8 +660,7 @@ module Google
         end
       end
       
-      # Output only.
-      # Resource that represents completion results.
+      # Output only. Resource that represents completion results.
       class CompletionResult
         include Google::Apis::Core::Hashable
       
@@ -743,9 +697,9 @@ module Google
       
         # An event issued when an end user interacts with the application that
         # implements Cloud Talent Solution. Providing this information improves the
-        # quality of search and recommendation for the API clients, enabling the
-        # service to perform optimally. The number of events sent must be consistent
-        # with other calls, such as job searches, issued to the service by the client.
+        # quality of search and recommendation for the API clients, enabling the service
+        # to perform optimally. The number of events sent must be consistent with other
+        # calls, such as job searches, issued to the service by the client.
         # Corresponds to the JSON property `clientEvent`
         # @return [Google::Apis::JobsV3p1beta1::ClientEvent]
         attr_accessor :client_event
@@ -760,8 +714,7 @@ module Google
         end
       end
       
-      # Input only.
-      # The Request of the CreateCompany method.
+      # Input only. The Request of the CreateCompany method.
       class CreateCompanyRequest
         include Google::Apis::Core::Hashable
       
@@ -782,14 +735,13 @@ module Google
         end
       end
       
-      # Input only.
-      # Create job request.
+      # Input only. Create job request.
       class CreateJobRequest
         include Google::Apis::Core::Hashable
       
         # A Job resource represents a job posting (also referred to as a "job listing"
-        # or "job requisition"). A job belongs to a Company, which is the hiring
-        # entity responsible for the job.
+        # or "job requisition"). A job belongs to a Company, which is the hiring entity
+        # responsible for the job.
         # Corresponds to the JSON property `job`
         # @return [Google::Apis::JobsV3p1beta1::Job]
         attr_accessor :job
@@ -809,33 +761,27 @@ module Google
         include Google::Apis::Core::Hashable
       
         # Optional. If the `filterable` flag is true, the custom field values may be
-        # used for
-        # custom attribute filters JobQuery.custom_attribute_filter.
-        # If false, these values may not be used for custom attribute filters.
-        # Default is false.
+        # used for custom attribute filters JobQuery.custom_attribute_filter. If false,
+        # these values may not be used for custom attribute filters. Default is false.
         # Corresponds to the JSON property `filterable`
         # @return [Boolean]
         attr_accessor :filterable
         alias_method :filterable?, :filterable
       
-        # Optional but exactly one of string_values or long_values must
-        # be specified.
-        # This field is used to perform number range search.
-        # (`EQ`, `GT`, `GE`, `LE`, `LT`) over filterable `long_value`.
-        # Currently at most 1 long_values is supported.
+        # Optional but exactly one of string_values or long_values must be specified.
+        # This field is used to perform number range search. (`EQ`, `GT`, `GE`, `LE`, `
+        # LT`) over filterable `long_value`. Currently at most 1 long_values is
+        # supported.
         # Corresponds to the JSON property `longValues`
         # @return [Array<Fixnum>]
         attr_accessor :long_values
       
-        # Optional but exactly one of string_values or long_values must
-        # be specified.
-        # This field is used to perform a string match (`CASE_SENSITIVE_MATCH` or
-        # `CASE_INSENSITIVE_MATCH`) search.
-        # For filterable `string_value`s, a maximum total number of 200 values
-        # is allowed, with each `string_value` has a byte size of no more than
-        # 500B. For unfilterable `string_values`, the maximum total byte size of
-        # unfilterable `string_values` is 50KB.
-        # Empty string is not allowed.
+        # Optional but exactly one of string_values or long_values must be specified.
+        # This field is used to perform a string match (`CASE_SENSITIVE_MATCH` or `
+        # CASE_INSENSITIVE_MATCH`) search. For filterable `string_value`s, a maximum
+        # total number of 200 values is allowed, with each `string_value` has a byte
+        # size of no more than 500B. For unfilterable `string_values`, the maximum total
+        # byte size of unfilterable `string_values` is 50KB. Empty string is not allowed.
         # Corresponds to the JSON property `stringValues`
         # @return [Array<String>]
         attr_accessor :string_values
@@ -853,28 +799,27 @@ module Google
       end
       
       # Custom attributes histogram request. An error is thrown if neither
-      # string_value_histogram or long_value_histogram_bucketing_option has
-      # been defined.
+      # string_value_histogram or long_value_histogram_bucketing_option has been
+      # defined.
       class CustomAttributeHistogramRequest
         include Google::Apis::Core::Hashable
       
         # Required. Specifies the custom field key to perform a histogram on. If
-        # specified
-        # without `long_value_histogram_bucketing_option`, histogram on string values
-        # of the given `key` is triggered, otherwise histogram is performed on long
-        # values.
+        # specified without `long_value_histogram_bucketing_option`, histogram on string
+        # values of the given `key` is triggered, otherwise histogram is performed on
+        # long values.
         # Corresponds to the JSON property `key`
         # @return [String]
         attr_accessor :key
       
-        # Input only.
-        # Use this field to specify bucketing option for the histogram search response.
+        # Input only. Use this field to specify bucketing option for the histogram
+        # search response.
         # Corresponds to the JSON property `longValueHistogramBucketingOption`
         # @return [Google::Apis::JobsV3p1beta1::NumericBucketingOption]
         attr_accessor :long_value_histogram_bucketing_option
       
-        # Optional. If set to true, the response includes the histogram value for
-        # each key as a string.
+        # Optional. If set to true, the response includes the histogram value for each
+        # key as a string.
         # Corresponds to the JSON property `stringValueHistogram`
         # @return [Boolean]
         attr_accessor :string_value_histogram
@@ -892,8 +837,7 @@ module Google
         end
       end
       
-      # Output only.
-      # Custom attribute histogram result.
+      # Output only. Custom attribute histogram result.
       class CustomAttributeHistogramResult
         include Google::Apis::Core::Hashable
       
@@ -902,14 +846,13 @@ module Google
         # @return [String]
         attr_accessor :key
       
-        # Output only.
-        # Custom numeric bucketing result.
+        # Output only. Custom numeric bucketing result.
         # Corresponds to the JSON property `longValueHistogramResult`
         # @return [Google::Apis::JobsV3p1beta1::NumericBucketingResult]
         attr_accessor :long_value_histogram_result
       
-        # Stores a map from the values of string custom field associated
-        # with `key` to the number of jobs with that value in this histogram result.
+        # Stores a map from the values of string custom field associated with `key` to
+        # the number of jobs with that value in this histogram result.
         # Corresponds to the JSON property `stringValueHistogramResult`
         # @return [Hash<String,Fixnum>]
         attr_accessor :string_value_histogram_result
@@ -926,36 +869,30 @@ module Google
         end
       end
       
-      # Input only.
-      # Custom ranking information for SearchJobsRequest.
+      # Input only. Custom ranking information for SearchJobsRequest.
       class CustomRankingInfo
         include Google::Apis::Core::Hashable
       
-        # Required. Controls over how important the score of
-        # CustomRankingInfo.ranking_expression gets applied to job's final
-        # ranking position.
-        # An error is thrown if not specified.
+        # Required. Controls over how important the score of CustomRankingInfo.
+        # ranking_expression gets applied to job's final ranking position. An error is
+        # thrown if not specified.
         # Corresponds to the JSON property `importanceLevel`
         # @return [String]
         attr_accessor :importance_level
       
         # Required. Controls over how job documents get ranked on top of existing
-        # relevance
-        # score (determined by API algorithm). A combination of the ranking
+        # relevance score (determined by API algorithm). A combination of the ranking
         # expression and relevance score is used to determine job's final ranking
-        # position.
-        # 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 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.
-        # The expression is considered invalid for a job if the expression
+        # position. 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 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. The expression is considered invalid for a job if the expression
         # references custom attributes that are not populated on the job or if the
-        # expression results in a divide by zero. If an expression is invalid for a
-        # job, that job is demoted to the end of the results.
-        # Sample ranking expression
-        # (year + 25) * 0.25 - (freshness / 0.5)
+        # expression results in a divide by zero. If an expression is invalid for a job,
+        # that job is demoted to the end of the results. Sample ranking expression (year
+        # + 25) * 0.25 - (freshness / 0.5)
         # Corresponds to the JSON property `rankingExpression`
         # @return [String]
         attr_accessor :ranking_expression
@@ -971,9 +908,9 @@ module Google
         end
       end
       
-      # Device information collected from the job seeker, candidate, or
-      # other entity conducting the job search. Providing this information improves
-      # the quality of the search results across devices.
+      # Device information collected from the job seeker, candidate, or other entity
+      # conducting the job search. Providing this information improves the quality of
+      # the search results across devices.
       class DeviceInfo
         include Google::Apis::Core::Hashable
       
@@ -999,13 +936,11 @@ module Google
         end
       end
       
-      # A generic empty message that you can re-use to avoid defining duplicated
-      # empty messages in your APIs. A typical example is to use it as the request
-      # or the response type of an API method. For instance:
-      # service Foo `
-      # rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
-      # `
-      # The JSON representation for `Empty` is empty JSON object ````.
+      # A generic empty message that you can re-use to avoid defining duplicated empty
+      # messages in your APIs. A typical example is to use it as the request or the
+      # response type of an API method. For instance: service Foo ` rpc Bar(google.
+      # protobuf.Empty) returns (google.protobuf.Empty); ` The JSON representation for
+      # `Empty` is empty JSON object ````.
       class Empty
         include Google::Apis::Core::Hashable
       
@@ -1018,26 +953,24 @@ module Google
         end
       end
       
-      # Input only.
-      # Histogram facets to be specified in SearchJobsRequest.
+      # Input only. Histogram facets to be specified in SearchJobsRequest.
       class HistogramFacets
         include Google::Apis::Core::Hashable
       
-        # Optional. Specifies compensation field-based histogram requests.
-        # Duplicate values of CompensationHistogramRequest.type are not allowed.
+        # Optional. Specifies compensation field-based histogram requests. Duplicate
+        # values of CompensationHistogramRequest.type are not allowed.
         # Corresponds to the JSON property `compensationHistogramFacets`
         # @return [Array<Google::Apis::JobsV3p1beta1::CompensationHistogramRequest>]
         attr_accessor :compensation_histogram_facets
       
-        # Optional. Specifies the custom attributes histogram requests.
-        # Duplicate values of CustomAttributeHistogramRequest.key are not
-        # allowed.
+        # Optional. Specifies the custom attributes histogram requests. Duplicate values
+        # of CustomAttributeHistogramRequest.key are not allowed.
         # Corresponds to the JSON property `customAttributeHistogramFacets`
         # @return [Array<Google::Apis::JobsV3p1beta1::CustomAttributeHistogramRequest>]
         attr_accessor :custom_attribute_histogram_facets
       
-        # Optional. Specifies the simple type of histogram facets, for example,
-        # `COMPANY_SIZE`, `EMPLOYMENT_TYPE` etc.
+        # Optional. Specifies the simple type of histogram facets, for example, `
+        # COMPANY_SIZE`, `EMPLOYMENT_TYPE` etc.
         # Corresponds to the JSON property `simpleHistogramFacets`
         # @return [Array<String>]
         attr_accessor :simple_histogram_facets
@@ -1054,89 +987,64 @@ module Google
         end
       end
       
-      # Input Only.
-      # The histogram request.
+      # Input Only. The histogram request.
       class HistogramQuery
         include Google::Apis::Core::Hashable
       
-        # An expression specifies a histogram request against matching resources
-        # (for example, jobs) for searches.
-        # Expression syntax is a aggregation function call with histogram facets and
-        # other options.
-        # Available aggregation function calls are:
-        # * `count(string_histogram_facet)`: Count the number of matching entity, for
-        # each distinct attribute value.
-        # * `count(numeric_histogram_facet, list of buckets)`: Count the number of
-        # matching entity within each bucket.
-        # Data types:
-        # * Histogram facet: facet names with format a-zA-Z+.
-        # * String: string like "any string with backslash escape for quote(\")."
-        # * Number: whole number and floating point number like 10, -1 and -0.01.
-        # * List: list of elements with comma(,) separator surrounded by square
-        # brackets. For example, [1, 2, 3] and ["one", "two", "three"].
-        # Built-in constants:
-        # * MIN (minimum number similar to java Double.MIN_VALUE)
-        # * MAX (maximum number similar to java Double.MAX_VALUE)
-        # Built-in functions:
-        # * bucket(start, end[, label]): bucket built-in function creates a bucket
-        # with range of start, end). Note that the end is exclusive. For example,
-        # bucket(1, MAX, "positive number") or bucket(1, 10).
-        # Job histogram facets:
-        # * company_id: histogram by [Job.distributor_company_id.
-        # * company_display_name: histogram by Job.company_display_name.
-        # * employment_type: histogram by Job.employment_types. For example,
-        # "FULL_TIME", "PART_TIME".
-        # * company_size: histogram by 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 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
-        # country uses to define the geographic structure below the country level.
-        # For example, "CA", "IL".
-        # * city: histogram by a combination of the "city name, admin1 code". For
-        # example,  "Mountain View, CA", "New York, NY".
-        # * admin1_country: histogram by a combination of the "admin1 code, country".
-        # For example, "CA, US", "IL, US".
-        # * city_coordinate: histogram by the city center's GPS coordinates (latitude
-        # 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 Job.language_code. For example, "en-US",
-        # "fr-FR".
-        # * language: histogram by the language subtag of the Job.language_code.
-        # For example, "en", "fr".
-        # * category: histogram by the JobCategory. For example,
-        # "COMPUTER_AND_IT", "HEALTHCARE".
-        # * base_compensation_unit: histogram by the CompensationUnit of base
-        # salary. For example, "WEEKLY", "MONTHLY".
-        # * base_compensation: histogram by the base salary. Must specify list of
-        # numeric buckets to group results by.
-        # * annualized_base_compensation: histogram by the base annualized salary.
-        # 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 Job.custom_attributes.
-        # Values can be accessed via square bracket notations like
-        # string_custom_attribute["key1"].
-        # * numeric_custom_attribute: histogram by numeric 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.
-        # Example expressions:
-        # * count(admin1)
-        # * count(base_compensation, [bucket(1000, 10000), bucket(10000, 100000),
-        # bucket(100000, MAX)])
-        # * count(string_custom_attribute["some-string-custom-attribute"])
-        # * count(numeric_custom_attribute["some-numeric-custom-attribute"],
-        # [bucket(MIN, 0, "negative"), bucket(0, MAX, "non-negative"])
+        # An expression specifies a histogram request against matching resources (for
+        # example, jobs) for searches. Expression syntax is a aggregation function call
+        # with histogram facets and other options. Available aggregation function calls
+        # are: * `count(string_histogram_facet)`: Count the number of matching entity,
+        # for each distinct attribute value. * `count(numeric_histogram_facet, list of
+        # buckets)`: Count the number of matching entity within each bucket. Data types:
+        # * Histogram facet: facet names with format a-zA-Z+. * String: string like "any
+        # string with backslash escape for quote(\")." * Number: whole number and
+        # floating point number like 10, -1 and -0.01. * List: list of elements with
+        # comma(,) separator surrounded by square brackets. For example, [1, 2, 3] and ["
+        # one", "two", "three"]. Built-in constants: * MIN (minimum number similar to
+        # java Double.MIN_VALUE) * MAX (maximum number similar to java Double.MAX_VALUE)
+        # Built-in functions: * bucket(start, end[, label]): bucket built-in function
+        # creates a bucket with range of start, end). Note that the end is exclusive.
+        # For example, bucket(1, MAX, "positive number") or bucket(1, 10). Job histogram
+        # facets: * company_id: histogram by [Job.distributor_company_id. *
+        # company_display_name: histogram by Job.company_display_name. * employment_type:
+        # histogram by Job.employment_types. For example, "FULL_TIME", "PART_TIME". *
+        # company_size: histogram by 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 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 country
+        # uses to define the geographic structure below the country level. For example, "
+        # CA", "IL". * city: histogram by a combination of the "city name, admin1 code".
+        # For example, "Mountain View, CA", "New York, NY". * admin1_country: histogram
+        # by a combination of the "admin1 code, country". For example, "CA, US", "IL, US"
+        # . * city_coordinate: histogram by the city center's GPS coordinates (latitude
+        # 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 Job.language_code. For example, "en-US", "fr-FR". *
+        # language: histogram by the language subtag of the Job.language_code. For
+        # example, "en", "fr". * category: histogram by the JobCategory. For example, "
+        # COMPUTER_AND_IT", "HEALTHCARE". * base_compensation_unit: histogram by the
+        # CompensationUnit of base salary. For example, "WEEKLY", "MONTHLY". *
+        # base_compensation: histogram by the base salary. Must specify list of numeric
+        # buckets to group results by. * annualized_base_compensation: histogram by the
+        # base annualized salary. 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 Job.custom_attributes. Values can
+        # be accessed via square bracket notations like string_custom_attribute["key1"].
+        # * numeric_custom_attribute: histogram by numeric 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. Example
+        # expressions: * count(admin1) * count(base_compensation, [bucket(1000, 10000),
+        # bucket(10000, 100000), bucket(100000, MAX)]) * count(string_custom_attribute["
+        # some-string-custom-attribute"]) * count(numeric_custom_attribute["some-numeric-
+        # custom-attribute"], [bucket(MIN, 0, "negative"), bucket(0, MAX, "non-negative"]
+        # )
         # Corresponds to the JSON property `histogramQuery`
         # @return [String]
         attr_accessor :histogram_query
@@ -1151,19 +1059,16 @@ module Google
         end
       end
       
-      # Output only.
-      # Histogram result that matches HistogramSpec specified in searches.
+      # Output only. Histogram result that matches HistogramSpec specified in searches.
       class HistogramQueryResult
         include Google::Apis::Core::Hashable
       
         # A map from the values of the facet associated with distinct values to the
-        # number of matching entries with corresponding value.
-        # The key format is:
-        # * (for string histogram) string values stored in the field.
-        # * (for named numeric bucket) name specified in `bucket()` function, like
-        # for `bucket(0, MAX, "non-negative")`, the key will be `non-negative`.
-        # * (for anonymous numeric bucket) range formatted as `<low>-<high>`, for
-        # example, `0-1000`, `MIN-0`, and `0-MAX`.
+        # number of matching entries with corresponding value. The key format is: * (for
+        # string histogram) string values stored in the field. * (for named numeric
+        # bucket) name specified in `bucket()` function, like for `bucket(0, MAX, "non-
+        # negative")`, the key will be `non-negative`. * (for anonymous numeric bucket)
+        # range formatted as `-`, for example, `0-1000`, `MIN-0`, and `0-MAX`.
         # Corresponds to the JSON property `histogram`
         # @return [Hash<String,Fixnum>]
         attr_accessor :histogram
@@ -1184,11 +1089,9 @@ module Google
         end
       end
       
-      # Output only.
-      # Result of a histogram call. The response contains the histogram map for the
-      # search type specified by HistogramResult.field.
-      # The response is a map of each filter value to the corresponding count of
-      # jobs for that filter.
+      # Output only. Result of a histogram call. The response contains the histogram
+      # map for the search type specified by HistogramResult.field. The response is a
+      # map of each filter value to the corresponding count of jobs for that filter.
       class HistogramResult
         include Google::Apis::Core::Hashable
       
@@ -1197,9 +1100,8 @@ module Google
         # @return [String]
         attr_accessor :search_type
       
-        # A map from the values of field to the number of jobs with that value
-        # in this search result.
-        # Key: search type (filter names, such as the companyName).
+        # A map from the values of field to the number of jobs with that value in this
+        # search result. Key: search type (filter names, such as the companyName).
         # Values: the count of jobs that match the filter for this search.
         # Corresponds to the JSON property `values`
         # @return [Hash<String,Fixnum>]
@@ -1216,8 +1118,7 @@ module Google
         end
       end
       
-      # Output only.
-      # Histogram results that match HistogramFacets specified in
+      # Output only. Histogram results that match HistogramFacets specified in
       # SearchJobsRequest.
       class HistogramResults
         include Google::Apis::Core::Hashable
@@ -1228,14 +1129,14 @@ module Google
         # @return [Array<Google::Apis::JobsV3p1beta1::CompensationHistogramResult>]
         attr_accessor :compensation_histogram_results
       
-        # Specifies histogram results for custom attributes that match
-        # HistogramFacets.custom_attribute_histogram_facets.
+        # Specifies histogram results for custom attributes that match HistogramFacets.
+        # custom_attribute_histogram_facets.
         # Corresponds to the JSON property `customAttributeHistogramResults`
         # @return [Array<Google::Apis::JobsV3p1beta1::CustomAttributeHistogramResult>]
         attr_accessor :custom_attribute_histogram_results
       
-        # Specifies histogram results that matches
-        # HistogramFacets.simple_histogram_facets.
+        # Specifies histogram results that matches HistogramFacets.
+        # simple_histogram_facets.
         # Corresponds to the JSON property `simpleHistogramResults`
         # @return [Array<Google::Apis::JobsV3p1beta1::HistogramResult>]
         attr_accessor :simple_histogram_results
@@ -1253,24 +1154,22 @@ module Google
       end
       
       # A Job resource represents a job posting (also referred to as a "job listing"
-      # or "job requisition"). A job belongs to a Company, which is the hiring
-      # entity responsible for the job.
+      # or "job requisition"). A job belongs to a Company, which is the hiring entity
+      # responsible for the job.
       class Job
         include Google::Apis::Core::Hashable
       
-        # Optional but strongly recommended for the best service experience.
-        # Location(s) where the employer is looking to hire for this job posting.
-        # Specifying the full street address(es) of the hiring location enables
-        # better API results, especially job searches by commute time.
-        # 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
-        # requisition_ids (e.g. 'ReqA' becomes 'ReqA-1', 'ReqA-2', etc.) as
-        # multiple jobs with the same company_name, language_code and
-        # requisition_id are not allowed. If the original 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.
+        # Optional but strongly recommended for the best service experience. Location(s)
+        # where the employer is looking to hire for this job posting. Specifying the
+        # full street address(es) of the hiring location enables better API results,
+        # especially job searches by commute time. 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 requisition_ids (e.g. 'ReqA' becomes 'ReqA-1'
+        # , 'ReqA-2', etc.) as multiple jobs with the same company_name, language_code
+        # and requisition_id are not allowed. If the original 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.
         # Corresponds to the JSON property `addresses`
         # @return [Array<String>]
         attr_accessor :addresses
@@ -1285,8 +1184,8 @@ module Google
         # @return [String]
         attr_accessor :company_display_name
       
-        # Required. The resource name of the company listing the job, such as
-        # "projects/api-test-project/companies/foo".
+        # Required. The resource name of the company listing the job, such as "projects/
+        # api-test-project/companies/foo".
         # Corresponds to the JSON property `companyName`
         # @return [String]
         attr_accessor :company_name
@@ -1297,16 +1196,13 @@ module Google
         attr_accessor :compensation_info
       
         # Optional. A map of fields to hold both filterable and non-filterable custom
-        # job
-        # attributes that are not covered by the provided structured fields.
-        # The keys of the map are strings up to 64 bytes and must match the
-        # pattern: a-zA-Z*. For example, key0LikeThis or
-        # KEY_1_LIKE_THIS.
-        # At most 100 filterable and at most 100 unfilterable keys are supported.
-        # For filterable `string_values`, across all keys at most 200 values are
-        # allowed, with each string no more than 255 characters. For unfilterable
-        # `string_values`, the maximum total size of `string_values` across all keys
-        # is 50KB.
+        # job attributes that are not covered by the provided structured fields. The
+        # keys of the map are strings up to 64 bytes and must match the pattern: a-zA-Z*.
+        # For example, key0LikeThis or KEY_1_LIKE_THIS. At most 100 filterable and at
+        # most 100 unfilterable keys are supported. For filterable `string_values`,
+        # across all keys at most 200 values are allowed, with each string no more than
+        # 255 characters. For unfilterable `string_values`, the maximum total size of `
+        # string_values` across all keys is 50KB.
         # Corresponds to the JSON property `customAttributes`
         # @return [Hash<String,Google::Apis::JobsV3p1beta1::CustomAttribute>]
         attr_accessor :custom_attributes
@@ -1318,41 +1214,35 @@ module Google
         attr_accessor :degree_types
       
         # Optional. The department or functional area within the company with the open
-        # position.
-        # The maximum number of allowed characters is 255.
+        # position. The maximum number of allowed characters is 255.
         # Corresponds to the JSON property `department`
         # @return [String]
         attr_accessor :department
       
-        # Output only.
-        # Derived details about the job posting.
+        # Output only. Derived details about the job posting.
         # Corresponds to the JSON property `derivedInfo`
         # @return [Google::Apis::JobsV3p1beta1::JobDerivedInfo]
         attr_accessor :derived_info
       
         # Required. 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 responsibilities,
-        # 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.
-        # The maximum number of allowed characters is 100,000.
+        # paragraph description of the company and related information. Separate fields
+        # are provided on the job object for responsibilities, 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. The maximum number of allowed characters
+        # is 100,000.
         # Corresponds to the JSON property `description`
         # @return [String]
         attr_accessor :description
       
-        # Optional. The employment type(s) of a job, for example,
-        # full time or
-        # part time.
+        # Optional. The employment type(s) of a job, for example, full time or part time.
         # Corresponds to the JSON property `employmentTypes`
         # @return [Array<String>]
         attr_accessor :employment_types
       
         # Optional. A description of bonus, commission, and other compensation
-        # incentives associated with the job not including salary or pay.
-        # The maximum number of allowed characters is 10,000.
+        # incentives associated with the job not including salary or pay. The maximum
+        # number of allowed characters is 10,000.
         # Corresponds to the JSON property `incentives`
         # @return [String]
         attr_accessor :incentives
@@ -1363,8 +1253,7 @@ module Google
         attr_accessor :job_benefits
       
         # Optional. The end timestamp of the job. Typically this field is used for
-        # contracting
-        # engagements. Invalid timestamps are ignored.
+        # contracting engagements. Invalid timestamps are ignored.
         # Corresponds to the JSON property `jobEndTime`
         # @return [String]
         attr_accessor :job_end_time
@@ -1375,31 +1264,26 @@ module Google
         attr_accessor :job_level
       
         # Optional. The start timestamp of the job in UTC time zone. Typically this
-        # field
-        # is used for contracting engagements. Invalid timestamps are ignored.
+        # field is used for contracting engagements. Invalid timestamps are ignored.
         # Corresponds to the JSON property `jobStartTime`
         # @return [String]
         attr_accessor :job_start_time
       
-        # Optional. The language of the posting. This field is distinct from
-        # any requirements for fluency that are associated with the job.
-        # Language codes must be in BCP-47 format, such as "en-US" or "sr-Latn".
-        # For more information, see
-        # [Tags for Identifying Languages](https://tools.ietf.org/html/bcp47)`:
-        # class="external" target="_blank" `.
-        # If this field is unspecified and Job.description is present, detected
-        # language code based on Job.description is assigned, otherwise
-        # defaults to 'en_US'.
+        # Optional. The language of the posting. This field is distinct from any
+        # requirements for fluency that are associated with the job. Language codes must
+        # be in BCP-47 format, such as "en-US" or "sr-Latn". For more information, see [
+        # Tags for Identifying Languages](https://tools.ietf.org/html/bcp47)`: class="
+        # external" target="_blank" `. If this field is unspecified and Job.description
+        # is present, detected language code based on Job.description is assigned,
+        # otherwise defaults to 'en_US'.
         # Corresponds to the JSON property `languageCode`
         # @return [String]
         attr_accessor :language_code
       
-        # Required during job update.
-        # 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".
-        # Use of this field in job queries and API calls is preferred over the use of
+        # Required during job update. 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". Use of
+        # this field in job queries and API calls is preferred over the use of
         # requisition_id since this value is unique.
         # Corresponds to the JSON property `name`
         # @return [String]
@@ -1410,52 +1294,45 @@ module Google
         # @return [String]
         attr_accessor :posting_create_time
       
-        # Optional but strongly recommended for the best service
-        # experience.
-        # The expiration timestamp of the job. After this timestamp, the
-        # job is marked as expired, and it no longer appears in search results. The
-        # expired job can't be deleted or listed by the DeleteJob and
-        # ListJobs APIs, but it can be retrieved with the GetJob API or
-        # 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 company_name,
-        # language_code and 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
-        # count over the past week, otherwise jobs with earlier expire time are
-        # cleaned first. Expired jobs are no longer accessible after they are cleaned
-        # out.
-        # Invalid timestamps are ignored, and treated as expire time not provided.
-        # Timestamp before the instant request is made is considered valid, the job
-        # will be treated as expired immediately.
-        # If this value is not provided at the time of job creation or is invalid,
-        # the job posting expires after 30 days from the job's creation time. For
-        # example, if the job was created on 2017/01/01 13:00AM UTC with an
-        # unspecified expiration date, the job expires after 2017/01/31 13:00AM UTC.
-        # If this value is not provided on job update, it depends on the field masks
-        # set by 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
+        # Optional but strongly recommended for the best service experience. The
+        # expiration timestamp of the job. After this timestamp, the job is marked as
+        # expired, and it no longer appears in search results. The expired job can't be
+        # deleted or listed by the DeleteJob and ListJobs APIs, but it can be retrieved
+        # with the GetJob API or 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 company_name,
+        # language_code and 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 count over the past week, otherwise jobs with earlier
+        # expire time are cleaned first. Expired jobs are no longer accessible after
+        # they are cleaned out. Invalid timestamps are ignored, and treated as expire
+        # time not provided. Timestamp before the instant request is made is considered
+        # valid, the job will be treated as expired immediately. If this value is not
+        # provided at the time of job creation or is invalid, the job posting expires
+        # after 30 days from the job's creation time. For example, if the job was
+        # created on 2017/01/01 13:00AM UTC with an unspecified expiration date, the job
+        # expires after 2017/01/31 13:00AM UTC. If this value is not provided on job
+        # update, it depends on the field masks set by 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.
         # Corresponds to the JSON property `postingExpireTime`
         # @return [String]
         attr_accessor :posting_expire_time
       
         # Optional. The timestamp this job posting was most recently published. The
-        # default
-        # value is the time the request arrives at the server. Invalid timestamps are
-        # ignored.
+        # default value is the time the request arrives at the server. Invalid
+        # timestamps are ignored.
         # Corresponds to the JSON property `postingPublishTime`
         # @return [String]
         attr_accessor :posting_publish_time
       
         # Optional. The job PostingRegion (for example, state, country) throughout which
-        # the job is available. If this field is set, a
-        # 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 PostingRegion.NATION or
-        # PostingRegion.ADMINISTRATIVE_AREA, setting job Job.addresses
-        # to the same location level as this field is strongly recommended.
+        # the job is available. If this field is set, a 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 PostingRegion.NATION or PostingRegion.
+        # ADMINISTRATIVE_AREA, setting job Job.addresses to the same location level as
+        # this field is strongly recommended.
         # Corresponds to the JSON property `postingRegion`
         # @return [String]
         attr_accessor :posting_region
@@ -1465,61 +1342,55 @@ module Google
         # @return [String]
         attr_accessor :posting_update_time
       
-        # Input only.
-        # Options for job processing.
+        # Input only. Options for job processing.
         # Corresponds to the JSON property `processingOptions`
         # @return [Google::Apis::JobsV3p1beta1::ProcessingOptions]
         attr_accessor :processing_options
       
-        # Optional. A promotion value of the job, as determined by the client.
-        # The value determines the sort order of the jobs returned when searching for
-        # jobs using the featured jobs search call, with higher promotional values
-        # being returned first and ties being resolved by relevance sort. Only the
-        # jobs with a promotionValue >0 are returned in a FEATURED_JOB_SEARCH.
-        # Default value is 0, and negative values are treated as 0.
+        # Optional. A promotion value of the job, as determined by the client. The value
+        # determines the sort order of the jobs returned when searching for jobs using
+        # the featured jobs search call, with higher promotional values being returned
+        # first and ties being resolved by relevance sort. Only the jobs with a
+        # promotionValue >0 are returned in a FEATURED_JOB_SEARCH. Default value is 0,
+        # and negative values are treated as 0.
         # Corresponds to the JSON property `promotionValue`
         # @return [Fixnum]
         attr_accessor :promotion_value
       
-        # Optional. 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 description field.
-        # This field accepts and sanitizes HTML input, and also accepts
-        # bold, italic, ordered list, and unordered list markup tags.
-        # The maximum number of allowed characters is 10,000.
+        # Optional. 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
+        # description field. This field accepts and sanitizes HTML input, and also
+        # accepts bold, italic, ordered list, and unordered list markup tags. The
+        # maximum number of allowed characters is 10,000.
         # Corresponds to the JSON property `qualifications`
         # @return [String]
         attr_accessor :qualifications
       
         # Required. The requisition ID, also referred to as the posting ID, 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 is not allowed
-        # to be created if there is another job with the same [company_name],
-        # language_code and requisition_id.
-        # The maximum number of allowed characters is 255.
+        # the client to identify a job. This field is intended to be used by clients for
+        # client identification and tracking of postings. A job is not allowed to be
+        # created if there is another job with the same [company_name], language_code
+        # and requisition_id. The maximum number of allowed characters is 255.
         # Corresponds to the JSON property `requisitionId`
         # @return [String]
         attr_accessor :requisition_id
       
         # Optional. A description of job responsibilities. The use of this field is
-        # recommended as an alternative to using the more general description
-        # field.
-        # This field accepts and sanitizes HTML input, and also accepts
-        # bold, italic, ordered list, and unordered list markup tags.
-        # The maximum number of allowed characters is 10,000.
+        # recommended as an alternative to using the more general description field.
+        # This field accepts and sanitizes HTML input, and also accepts bold, italic,
+        # ordered list, and unordered list markup tags. The maximum number of allowed
+        # characters is 10,000.
         # Corresponds to the JSON property `responsibilities`
         # @return [String]
         attr_accessor :responsibilities
       
-        # Required. The title of the job, such as "Software Engineer"
-        # The maximum number of allowed characters is 500.
+        # Required. The title of the job, such as "Software Engineer" The maximum number
+        # of allowed characters is 500.
         # Corresponds to the JSON property `title`
         # @return [String]
         attr_accessor :title
       
-        # Deprecated. The job is only visible to the owner.
-        # The visibility of the job.
+        # Deprecated. The job is only visible to the owner. The visibility of the job.
         # Defaults to Visibility.ACCOUNT_ONLY if not specified.
         # Corresponds to the JSON property `visibility`
         # @return [String]
@@ -1564,8 +1435,7 @@ module Google
         end
       end
       
-      # Output only.
-      # Derived details about the job posting.
+      # Output only. Derived details about the job posting.
       class JobDerivedInfo
         include Google::Apis::Core::Hashable
       
@@ -1574,9 +1444,8 @@ module Google
         # @return [Array<String>]
         attr_accessor :job_categories
       
-        # Structured locations of the job, resolved from Job.addresses.
-        # locations are exactly matched to Job.addresses in the same
-        # order.
+        # Structured locations of the job, resolved from Job.addresses. locations are
+        # exactly matched to Job.addresses in the same order.
         # Corresponds to the JSON property `locations`
         # @return [Array<Google::Apis::JobsV3p1beta1::Location>]
         attr_accessor :locations
@@ -1597,11 +1466,10 @@ module Google
       class JobEvent
         include Google::Apis::Core::Hashable
       
-        # Required. The job name(s) associated with this event.
-        # For example, if this is an impression event,
-        # this field contains the identifiers of all jobs shown to the job seeker.
-        # If this was a view event, this field contains the
-        # identifier of the viewed job.
+        # Required. The job name(s) associated with this event. For example, if this is
+        # an impression event, this field contains the identifiers of all jobs shown to
+        # the job seeker. If this was a view event, this field contains the identifier
+        # of the viewed job.
         # Corresponds to the JSON property `jobs`
         # @return [Array<String>]
         attr_accessor :jobs
@@ -1622,124 +1490,103 @@ module Google
         end
       end
       
-      # Input only.
-      # The query required to perform a search query.
+      # Input only. The query required to perform a search query.
       class JobQuery
         include Google::Apis::Core::Hashable
       
-        # Input only.
-        # Parameters needed for commute search.
+        # Input only. Parameters needed for commute search.
         # Corresponds to the JSON property `commuteFilter`
         # @return [Google::Apis::JobsV3p1beta1::CommuteFilter]
         attr_accessor :commute_filter
       
-        # Optional. This filter specifies the exact company display
-        # name of the jobs to search against.
-        # If a value isn't specified, jobs within the search results are
-        # associated with any company.
-        # If multiple values are specified, jobs within the search results may be
-        # associated with any of the specified companies.
-        # At most 20 company display name filters are allowed.
+        # Optional. This filter specifies the exact company display name of the jobs to
+        # search against. If a value isn't specified, jobs within the search results are
+        # associated with any company. If multiple values are specified, jobs within the
+        # search results may be associated with any of the specified companies. At most
+        # 20 company display name filters are allowed.
         # Corresponds to the JSON property `companyDisplayNames`
         # @return [Array<String>]
         attr_accessor :company_display_names
       
-        # Optional. This filter specifies the company entities to search against.
-        # If a value isn't specified, jobs are searched for against all
-        # companies.
-        # If multiple values are specified, jobs are searched against the
-        # companies specified.
-        # The format is "projects/`project_id`/companies/`company_id`", for example,
-        # "projects/api-test-project/companies/foo".
-        # At most 20 company filters are allowed.
+        # Optional. This filter specifies the company entities to search against. If a
+        # value isn't specified, jobs are searched for against all companies. If
+        # multiple values are specified, jobs are searched against the companies
+        # specified. The format is "projects/`project_id`/companies/`company_id`", for
+        # example, "projects/api-test-project/companies/foo". At most 20 company filters
+        # are allowed.
         # Corresponds to the JSON property `companyNames`
         # @return [Array<String>]
         attr_accessor :company_names
       
-        # Input only.
-        # Filter on job compensation type and amount.
+        # Input only. Filter on job compensation type and amount.
         # Corresponds to the JSON property `compensationFilter`
         # @return [Google::Apis::JobsV3p1beta1::CompensationFilter]
         attr_accessor :compensation_filter
       
-        # Optional. This filter specifies a structured syntax to match against the
-        # Job.custom_attributes marked as `filterable`.
-        # The syntax for this expression is a subset of SQL syntax.
-        # Supported operators are: `=`, `!=`, `<`, `<=`, `>`, and `>=` where the
-        # left of the operator is a custom field key and the right of the operator
-        # is a number or a quoted string. You must escape backslash (\\) and
-        # quote (\") characters.
-        # Supported functions are `LOWER([field_name])` to
+        # Optional. This filter specifies a structured syntax to match against the Job.
+        # custom_attributes marked as `filterable`. The syntax for this expression is a
+        # subset of SQL syntax. Supported operators are: `=`, `!=`, `<`, `<=`, `>`, and `
+        # >=` where the left of the operator is a custom field key and the right of the
+        # operator is a number or a quoted string. You must escape backslash (\\) and
+        # quote (\") characters. Supported functions are `LOWER([field_name])` to
         # perform a case insensitive match and `EMPTY([field_name])` to filter on the
-        # existence of a key.
-        # Boolean expressions (AND/OR/NOT) are supported up to 3 levels of
-        # nesting (for example, "((A AND B AND C) OR NOT D) AND E"), a maximum of 100
-        # comparisons or functions are allowed in the expression. The expression
-        # must be < 6000 bytes in length.
-        # Sample Query:
-        # `(LOWER(driving_license)="class \"a\"" OR EMPTY(driving_license)) AND
-        # driving_years > 10`
+        # existence of a key. Boolean expressions (AND/OR/NOT) are supported up to 3
+        # levels of nesting (for example, "((A AND B AND C) OR NOT D) AND E"), a maximum
+        # of 100 comparisons or functions are allowed in the expression. The expression
+        # must be < 6000 bytes in length. Sample Query: `(LOWER(driving_license)="class \
+        # "a\"" OR EMPTY(driving_license)) AND driving_years > 10`
         # Corresponds to the JSON property `customAttributeFilter`
         # @return [String]
         attr_accessor :custom_attribute_filter
       
-        # Optional. This flag controls the spell-check feature. If false, the
-        # service attempts to correct a misspelled query,
-        # for example, "enginee" is corrected to "engineer".
-        # Defaults to false: a spell check is performed.
+        # Optional. This flag controls the spell-check feature. If false, the service
+        # attempts to correct a misspelled query, for example, "enginee" is corrected to
+        # "engineer". Defaults to false: a spell check is performed.
         # Corresponds to the JSON property `disableSpellCheck`
         # @return [Boolean]
         attr_accessor :disable_spell_check
         alias_method :disable_spell_check?, :disable_spell_check
       
         # Optional. The employment type filter specifies the employment type of jobs to
-        # search against, such as EmploymentType.FULL_TIME.
-        # If a value is not specified, jobs in the search results includes any
-        # employment type.
-        # If multiple values are specified, jobs in the search results include
-        # any of the specified employment types.
+        # search against, such as EmploymentType.FULL_TIME. If a value is not specified,
+        # jobs in the search results includes any employment type. If multiple values
+        # are specified, jobs in the search results include any of the specified
+        # employment types.
         # Corresponds to the JSON property `employmentTypes`
         # @return [Array<String>]
         attr_accessor :employment_types
       
         # Optional. This filter specifies a list of job names to be excluded during
-        # search.
-        # At most 400 excluded job names are allowed.
+        # search. At most 400 excluded job names are allowed.
         # Corresponds to the JSON property `excludedJobs`
         # @return [Array<String>]
         attr_accessor :excluded_jobs
       
         # Optional. The category filter specifies the categories of jobs to search
-        # against.
-        # See Category for more information.
-        # If a value is not specified, jobs from any category are searched against.
-        # If multiple values are specified, jobs from any of the specified
-        # categories are searched against.
+        # against. See Category for more information. If a value is not specified, jobs
+        # from any category are searched against. If multiple values are specified, jobs
+        # from any of the specified categories are searched against.
         # Corresponds to the JSON property `jobCategories`
         # @return [Array<String>]
         attr_accessor :job_categories
       
-        # Optional. This filter specifies the locale of jobs to search against,
-        # for example, "en-US".
-        # If a value isn't specified, the search results can contain jobs in any
-        # locale.
-        # Language codes should be in BCP-47 format, such as "en-US" or "sr-Latn".
-        # For more information, see
-        # [Tags for Identifying Languages](https://tools.ietf.org/html/bcp47).
-        # At most 10 language code filters are allowed.
+        # Optional. This filter specifies the locale of jobs to search against, for
+        # example, "en-US". If a value isn't specified, the search results can contain
+        # jobs in any locale. Language codes should be in BCP-47 format, such as "en-US"
+        # or "sr-Latn". For more information, see [Tags for Identifying Languages](https:
+        # //tools.ietf.org/html/bcp47). At most 10 language code filters are allowed.
         # Corresponds to the JSON property `languageCodes`
         # @return [Array<String>]
         attr_accessor :language_codes
       
         # Optional. The location filter specifies geo-regions containing the jobs to
-        # search against. See LocationFilter for more information.
-        # If a location value isn't specified, jobs fitting the other search
-        # criteria are retrieved regardless of where they're located.
-        # If multiple values are specified, jobs are retrieved from any of the
-        # specified locations. If different values are specified for the
-        # LocationFilter.distance_in_miles parameter, the maximum provided
-        # distance is used for all locations.
-        # At most 5 location filters are allowed.
+        # search against. See LocationFilter for more information. If a location value
+        # isn't specified, jobs fitting the other search criteria are retrieved
+        # regardless of where they're located. If multiple values are specified, jobs
+        # are retrieved from any of the specified locations. If different values are
+        # specified for the LocationFilter.distance_in_miles parameter, the maximum
+        # provided distance is used for all locations. At most 5 location filters are
+        # allowed.
         # Corresponds to the JSON property `locationFilters`
         # @return [Array<Google::Apis::JobsV3p1beta1::LocationFilter>]
         attr_accessor :location_filters
@@ -1750,20 +1597,16 @@ module Google
         attr_accessor :publish_time_range
       
         # Optional. The query string that matches against the job title, description,
-        # and
-        # location fields.
-        # The maximum number of allowed characters is 255.
+        # and location fields. The maximum number of allowed characters is 255.
         # Corresponds to the JSON property `query`
         # @return [String]
         attr_accessor :query
       
-        # The language code of query. For example, "en-US". This field helps to
-        # better interpret the query.
-        # If a value isn't specified, the query language code is automatically
-        # detected, which may not be accurate.
-        # Language code should be in BCP-47 format, such as "en-US" or "sr-Latn".
-        # For more information, see
-        # [Tags for Identifying Languages](https://tools.ietf.org/html/bcp47).
+        # The language code of query. For example, "en-US". This field helps to better
+        # interpret the query. If a value isn't specified, the query language code is
+        # automatically detected, which may not be accurate. Language code should be in
+        # BCP-47 format, such as "en-US" or "sr-Latn". For more information, see [Tags
+        # for Identifying Languages](https://tools.ietf.org/html/bcp47).
         # Corresponds to the JSON property `queryLanguageCode`
         # @return [String]
         attr_accessor :query_language_code
@@ -1793,9 +1636,8 @@ module Google
       
       # An object representing a latitude/longitude pair. This is expressed as a pair
       # of doubles representing degrees latitude and degrees longitude. Unless
-      # specified otherwise, this must conform to the
-      # <a href="http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf">WGS84
-      # standard</a>. Values must be within normalized ranges.
+      # specified otherwise, this must conform to the WGS84 standard. Values must be
+      # within normalized ranges.
       class LatLng
         include Google::Apis::Core::Hashable
       
@@ -1820,8 +1662,7 @@ module Google
         end
       end
       
-      # Output only.
-      # The List companies response object.
+      # Output only. The List companies response object.
       class ListCompaniesResponse
         include Google::Apis::Core::Hashable
       
@@ -1830,8 +1671,8 @@ module Google
         # @return [Array<Google::Apis::JobsV3p1beta1::Company>]
         attr_accessor :companies
       
-        # Output only.
-        # Additional information returned to client, such as debugging information.
+        # Output only. Additional information returned to client, such as debugging
+        # information.
         # Corresponds to the JSON property `metadata`
         # @return [Google::Apis::JobsV3p1beta1::ResponseMetadata]
         attr_accessor :metadata
@@ -1853,20 +1694,18 @@ module Google
         end
       end
       
-      # Output only.
-      # List jobs response.
+      # Output only. List jobs response.
       class ListJobsResponse
         include Google::Apis::Core::Hashable
       
-        # The Jobs for a given company.
-        # The maximum number of items returned is based on the limit field
-        # provided in the request.
+        # The Jobs for a given company. The maximum number of items returned is based on
+        # the limit field provided in the request.
         # Corresponds to the JSON property `jobs`
         # @return [Array<Google::Apis::JobsV3p1beta1::Job>]
         attr_accessor :jobs
       
-        # Output only.
-        # Additional information returned to client, such as debugging information.
+        # Output only. Additional information returned to client, such as debugging
+        # information.
         # Corresponds to the JSON property `metadata`
         # @return [Google::Apis::JobsV3p1beta1::ResponseMetadata]
         attr_accessor :metadata
@@ -1888,16 +1727,15 @@ module Google
         end
       end
       
-      # Output only.
-      # A resource that represents a location with full geographic information.
+      # Output only. A resource that represents a location with full geographic
+      # information.
       class Location
         include Google::Apis::Core::Hashable
       
         # An object representing a latitude/longitude pair. This is expressed as a pair
         # of doubles representing degrees latitude and degrees longitude. Unless
-        # specified otherwise, this must conform to the
-        # <a href="http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf">WGS84
-        # standard</a>. Values must be within normalized ranges.
+        # specified otherwise, this must conform to the WGS84 standard. Values must be
+        # within normalized ranges.
         # Corresponds to the JSON property `latLng`
         # @return [Google::Apis::JobsV3p1beta1::LatLng]
         attr_accessor :lat_lng
@@ -1912,27 +1750,22 @@ module Google
       
         # Represents a postal address, e.g. for postal delivery or payments addresses.
         # Given a postal address, a postal service can deliver items to a premise, P.O.
-        # Box or similar.
-        # It is not intended to model geographical locations (roads, towns,
-        # mountains).
-        # In typical usage an address would be created via user input or from importing
-        # existing data, depending on the type of process.
-        # Advice on address input / editing:
-        # - Use an i18n-ready address widget such as
-        # https://github.com/google/libaddressinput)
-        # - Users should not be presented with UI elements for input or editing of
-        # fields outside countries where that field is used.
-        # For more guidance on how to use this schema, please see:
-        # https://support.google.com/business/answer/6397478
+        # Box or similar. It is not intended to model geographical locations (roads,
+        # towns, mountains). In typical usage an address would be created via user input
+        # or from importing existing data, depending on the type of process. Advice on
+        # address input / editing: - Use an i18n-ready address widget such as https://
+        # github.com/google/libaddressinput) - Users should not be presented with UI
+        # elements for input or editing of fields outside countries where that field is
+        # used. For more guidance on how to use this schema, please see: https://support.
+        # google.com/business/answer/6397478
         # Corresponds to the JSON property `postalAddress`
         # @return [Google::Apis::JobsV3p1beta1::PostalAddress]
         attr_accessor :postal_address
       
-        # Radius in miles of the job location. This value is derived from the
-        # location bounding box in which a circle with the specified radius
-        # centered from LatLng covers the area associated with the job location.
-        # For example, currently, "Mountain View, CA, USA" has a radius of
-        # 6.17 miles.
+        # Radius in miles of the job location. This value is derived from the location
+        # bounding box in which a circle with the specified radius centered from LatLng
+        # covers the area associated with the job location. For example, currently, "
+        # Mountain View, CA, USA" has a radius of 6.17 miles.
         # Corresponds to the JSON property `radiusInMiles`
         # @return [Float]
         attr_accessor :radius_in_miles
@@ -1950,8 +1783,7 @@ module Google
         end
       end
       
-      # Input only.
-      # Geographic region of the search.
+      # Input only. Geographic region of the search.
       class LocationFilter
         include Google::Apis::Core::Hashable
       
@@ -1961,49 +1793,43 @@ module Google
         attr_accessor :address
       
         # Optional. The distance_in_miles is applied when the location being searched
-        # for is
-        # identified as a city or smaller. When the location being searched for is a
-        # state or larger, this field is ignored.
+        # for is identified as a city or smaller. When the location being searched for
+        # is a state or larger, this field is ignored.
         # Corresponds to the JSON property `distanceInMiles`
         # @return [Float]
         attr_accessor :distance_in_miles
       
         # An object representing a latitude/longitude pair. This is expressed as a pair
         # of doubles representing degrees latitude and degrees longitude. Unless
-        # specified otherwise, this must conform to the
-        # <a href="http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf">WGS84
-        # standard</a>. Values must be within normalized ranges.
+        # specified otherwise, this must conform to the WGS84 standard. Values must be
+        # within normalized ranges.
         # Corresponds to the JSON property `latLng`
         # @return [Google::Apis::JobsV3p1beta1::LatLng]
         attr_accessor :lat_lng
       
         # Optional. CLDR region code of the country/region of the address. This is used
         # to address ambiguity of the user-input location, for example, "Liverpool"
-        # against "Liverpool, NY, US" or "Liverpool, UK".
-        # Set this field if all the jobs to search against are from a same region,
-        # or jobs are world-wide, but the job seeker is from a specific region.
-        # See http://cldr.unicode.org/ and
-        # http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html
-        # for details. Example: "CH" for Switzerland.
+        # against "Liverpool, NY, US" or "Liverpool, UK". Set this field if all the jobs
+        # to search against are from a same region, or jobs are world-wide, but the job
+        # seeker is from a specific region. See http://cldr.unicode.org/ and http://www.
+        # unicode.org/cldr/charts/30/supplemental/territory_information.html for details.
+        # Example: "CH" for Switzerland.
         # Corresponds to the JSON property `regionCode`
         # @return [String]
         attr_accessor :region_code
       
-        # Optional. Allows the client to return jobs without a
-        # set location, specifically, telecommuting jobs (telecommuting is considered
-        # by the service as a special location.
-        # Job.posting_region indicates if a job permits telecommuting.
-        # If this field is set to TelecommutePreference.TELECOMMUTE_ALLOWED,
-        # telecommuting jobs are searched, and address and lat_lng are
-        # ignored. If not set or set to
-        # TelecommutePreference.TELECOMMUTE_EXCLUDED, telecommute job are not
-        # searched.
-        # This filter can be used by itself to search exclusively for telecommuting
-        # jobs, or it can be combined with another location
-        # filter to search for a combination of job locations,
-        # such as "Mountain View" or "telecommuting" jobs. However, when used in
-        # combination with other location filters, telecommuting jobs can be
-        # treated as less relevant than other jobs in the search response.
+        # Optional. Allows the client to return jobs without a set location,
+        # specifically, telecommuting jobs (telecommuting is considered by the service
+        # as a special location. Job.posting_region indicates if a job permits
+        # telecommuting. If this field is set to TelecommutePreference.
+        # TELECOMMUTE_ALLOWED, telecommuting jobs are searched, and address and lat_lng
+        # are ignored. If not set or set to TelecommutePreference.TELECOMMUTE_EXCLUDED,
+        # telecommute job are not searched. This filter can be used by itself to search
+        # exclusively for telecommuting jobs, or it can be combined with another
+        # location filter to search for a combination of job locations, such as "
+        # Mountain View" or "telecommuting" jobs. However, when used in combination with
+        # other location filters, telecommuting jobs can be treated as less relevant
+        # than other jobs in the search response.
         # Corresponds to the JSON property `telecommutePreference`
         # @return [String]
         attr_accessor :telecommute_preference
@@ -2022,20 +1848,18 @@ module Google
         end
       end
       
-      # Output only.
-      # Job entry with metadata inside SearchJobsResponse.
+      # Output only. Job entry with metadata inside SearchJobsResponse.
       class MatchingJob
         include Google::Apis::Core::Hashable
       
-        # Output only.
-        # Commute details related to this job.
+        # Output only. Commute details related to this job.
         # Corresponds to the JSON property `commuteInfo`
         # @return [Google::Apis::JobsV3p1beta1::CommuteInfo]
         attr_accessor :commute_info
       
         # A Job resource represents a job posting (also referred to as a "job listing"
-        # or "job requisition"). A job belongs to a Company, which is the hiring
-        # entity responsible for the job.
+        # or "job requisition"). A job belongs to a Company, which is the hiring entity
+        # responsible for the job.
         # Corresponds to the JSON property `job`
         # @return [Google::Apis::JobsV3p1beta1::Job]
         attr_accessor :job
@@ -2046,17 +1870,17 @@ module Google
         # @return [String]
         attr_accessor :job_summary
       
-        # Contains snippets of text from the Job.job_title field most
-        # closely matching a search query's keywords, if available. The matching
-        # query keywords are enclosed in HTML bold tags.
+        # Contains snippets of text from the Job.job_title field most closely matching a
+        # search query's keywords, if available. The matching query keywords are
+        # enclosed in HTML bold tags.
         # Corresponds to the JSON property `jobTitleSnippet`
         # @return [String]
         attr_accessor :job_title_snippet
       
-        # Contains snippets of text from the 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 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.
         # Corresponds to the JSON property `searchTextSnippet`
         # @return [String]
         attr_accessor :search_text_snippet
@@ -2075,20 +1899,18 @@ module Google
         end
       end
       
-      # Message representing input to a Mendel server for debug forcing.
-      # See go/mendel-debug-forcing for more details.
-      # Next ID: 2
+      # Message representing input to a Mendel server for debug forcing. See go/mendel-
+      # debug-forcing for more details. Next ID: 2
       class MendelDebugInput
         include Google::Apis::Core::Hashable
       
-        # When a request spans multiple servers, a MendelDebugInput may travel with
-        # the request and take effect in all the servers. This field is a map of
-        # namespaces to NamespacedMendelDebugInput protos. In a single server, up to
-        # two NamespacedMendelDebugInput protos are applied:
-        # 1. NamespacedMendelDebugInput with the global namespace (key == "").
-        # 2. NamespacedMendelDebugInput with the server's namespace.
-        # When both NamespacedMendelDebugInput protos are present, they are merged.
-        # See go/mendel-debug-forcing for more details.
+        # When a request spans multiple servers, a MendelDebugInput may travel with the
+        # request and take effect in all the servers. This field is a map of namespaces
+        # to NamespacedMendelDebugInput protos. In a single server, up to two
+        # NamespacedMendelDebugInput protos are applied: 1. NamespacedMendelDebugInput
+        # with the global namespace (key == ""). 2. NamespacedMendelDebugInput with the
+        # server's namespace. When both NamespacedMendelDebugInput protos are present,
+        # they are merged. See go/mendel-debug-forcing for more details.
         # Corresponds to the JSON property `namespacedDebugInput`
         # @return [Hash<String,Google::Apis::JobsV3p1beta1::NamespacedDebugInput>]
         attr_accessor :namespaced_debug_input
@@ -2112,18 +1934,17 @@ module Google
         # @return [String]
         attr_accessor :currency_code
       
-        # Number of nano (10^-9) units of the amount.
-        # The value must be between -999,999,999 and +999,999,999 inclusive.
-        # If `units` is positive, `nanos` must be positive or zero.
-        # If `units` is zero, `nanos` can be positive, zero, or negative.
-        # If `units` is negative, `nanos` must be negative or zero.
-        # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
+        # Number of nano (10^-9) units of the amount. The value must be between -999,999,
+        # 999 and +999,999,999 inclusive. If `units` is positive, `nanos` must be
+        # positive or zero. If `units` is zero, `nanos` can be positive, zero, or
+        # negative. If `units` is negative, `nanos` must be negative or zero. For
+        # example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
         # Corresponds to the JSON property `nanos`
         # @return [Fixnum]
         attr_accessor :nanos
       
-        # The whole units of the amount.
-        # For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
+        # The whole units of the amount. For example if `currencyCode` is `"USD"`, then
+        # 1 unit is one US dollar.
         # Corresponds to the JSON property `units`
         # @return [Fixnum]
         attr_accessor :units
@@ -2144,89 +1965,85 @@ module Google
       class NamespacedDebugInput
         include Google::Apis::Core::Hashable
       
-        # Set of experiment names to be absolutely forced.
-        # These experiments will be forced without evaluating the conditions.
+        # Set of experiment names to be absolutely forced. These experiments will be
+        # forced without evaluating the conditions.
         # Corresponds to the JSON property `absolutelyForcedExpNames`
         # @return [Array<String>]
         attr_accessor :absolutely_forced_exp_names
       
-        # Set of experiment tags to be absolutely forced.
-        # The experiments with these tags will be forced without evaluating the
-        # conditions.
+        # Set of experiment tags to be absolutely forced. The experiments with these
+        # tags will be forced without evaluating the conditions.
         # Corresponds to the JSON property `absolutelyForcedExpTags`
         # @return [Array<String>]
         attr_accessor :absolutely_forced_exp_tags
       
-        # Set of experiment ids to be absolutely forced.
-        # These ids will be forced without evaluating the conditions.
+        # Set of experiment ids to be absolutely forced. These ids will be forced
+        # without evaluating the conditions.
         # Corresponds to the JSON property `absolutelyForcedExps`
         # @return [Array<Fixnum>]
         attr_accessor :absolutely_forced_exps
       
-        # Set of experiment names to be conditionally forced.
-        # These experiments will be forced only if their conditions and their
-        # parent domain's conditions are true.
+        # Set of experiment names to be conditionally forced. These experiments will be
+        # forced only if their conditions and their parent domain's conditions are true.
         # Corresponds to the JSON property `conditionallyForcedExpNames`
         # @return [Array<String>]
         attr_accessor :conditionally_forced_exp_names
       
-        # Set of experiment tags to be conditionally forced.
-        # The experiments with these tags will be forced only if their conditions
-        # and their parent domain's conditions are true.
+        # Set of experiment tags to be conditionally forced. The experiments with these
+        # tags will be forced only if their conditions and their parent domain's
+        # conditions are true.
         # Corresponds to the JSON property `conditionallyForcedExpTags`
         # @return [Array<String>]
         attr_accessor :conditionally_forced_exp_tags
       
-        # Set of experiment ids to be conditionally forced.
-        # These ids will be forced only if their conditions and their parent
-        # domain's conditions are true.
+        # Set of experiment ids to be conditionally forced. These ids will be forced
+        # only if their conditions and their parent domain's conditions are true.
         # Corresponds to the JSON property `conditionallyForcedExps`
         # @return [Array<Fixnum>]
         attr_accessor :conditionally_forced_exps
       
-        # If true, disable automatic enrollment selection (at all diversion
-        # points). Automatic enrollment selection means experiment selection
-        # process based on the experiment's automatic enrollment condition. This
-        # does not disable selection of forced experiments.
+        # If true, disable automatic enrollment selection (at all diversion points).
+        # Automatic enrollment selection means experiment selection process based on the
+        # experiment's automatic enrollment condition. This does not disable selection
+        # of forced experiments.
         # Corresponds to the JSON property `disableAutomaticEnrollmentSelection`
         # @return [Boolean]
         attr_accessor :disable_automatic_enrollment_selection
         alias_method :disable_automatic_enrollment_selection?, :disable_automatic_enrollment_selection
       
-        # Set of experiment names to be disabled.
-        # If an experiment is disabled, it is never selected nor forced.
-        # If an aggregate experiment is disabled, its partitions are disabled
-        # together. If an experiment with an enrollment is disabled, the enrollment
-        # is disabled together. If a name corresponds to a domain, the domain
-        # itself and all descendant experiments and domains are disabled together.
+        # Set of experiment names to be disabled. If an experiment is disabled, it is
+        # never selected nor forced. If an aggregate experiment is disabled, its
+        # partitions are disabled together. If an experiment with an enrollment is
+        # disabled, the enrollment is disabled together. If a name corresponds to a
+        # domain, the domain itself and all descendant experiments and domains are
+        # disabled together.
         # Corresponds to the JSON property `disableExpNames`
         # @return [Array<String>]
         attr_accessor :disable_exp_names
       
-        # Set of experiment tags to be disabled. All experiments that are tagged
-        # with one or more of these tags are disabled.
-        # If an experiment is disabled, it is never selected nor forced.
-        # If an aggregate experiment is disabled, its partitions are disabled
-        # together. If an experiment with an enrollment is disabled, the enrollment
-        # is disabled together.
+        # Set of experiment tags to be disabled. All experiments that are tagged with
+        # one or more of these tags are disabled. If an experiment is disabled, it is
+        # never selected nor forced. If an aggregate experiment is disabled, its
+        # partitions are disabled together. If an experiment with an enrollment is
+        # disabled, the enrollment is disabled together.
         # Corresponds to the JSON property `disableExpTags`
         # @return [Array<String>]
         attr_accessor :disable_exp_tags
       
-        # Set of experiment ids to be disabled.
-        # If an experiment is disabled, it is never selected nor forced.
-        # If an aggregate experiment is disabled, its partitions are disabled
-        # together. If an experiment with an enrollment is disabled, the enrollment
-        # is disabled together. If an ID corresponds to a domain, the domain itself
-        # and all descendant experiments and domains are disabled together.
+        # Set of experiment ids to be disabled. If an experiment is disabled, it is
+        # never selected nor forced. If an aggregate experiment is disabled, its
+        # partitions are disabled together. If an experiment with an enrollment is
+        # disabled, the enrollment is disabled together. If an ID corresponds to a
+        # domain, the domain itself and all descendant experiments and domains are
+        # disabled together.
         # Corresponds to the JSON property `disableExps`
         # @return [Array<Fixnum>]
         attr_accessor :disable_exps
       
-        # If true, disable manual enrollment selection (at all diversion points).
-        # Manual enrollment selection means experiment selection process based on
-        # the request's manual enrollment states (a.k.a. opt-in experiments).
-        # This does not disable selection of forced experiments.
+        # If true, disable manual enrollment selection (at all diversion points). Manual
+        # enrollment selection means experiment selection process based on the request's
+        # manual enrollment states (a.k.a. opt-in experiments). This does not disable
+        # selection of forced experiments.
         # Corresponds to the JSON property `disableManualEnrollmentSelection`
         # @return [Boolean]
         attr_accessor :disable_manual_enrollment_selection
@@ -2234,24 +2051,23 @@ module Google
       
         # If true, disable organic experiment selection (at all diversion points).
         # Organic selection means experiment selection process based on traffic
-        # allocation and diversion condition evaluation.
-        # This does not disable selection of forced experiments.
-        # This is useful in cases when it is not known whether experiment selection
-        # behavior is responsible for a error or breakage. Disabling organic
-        # selection may help to isolate the cause of a given problem.
+        # allocation and diversion condition evaluation. This does not disable selection
+        # of forced experiments. This is useful in cases when it is not known whether
+        # experiment selection behavior is responsible for a error or breakage.
+        # Disabling organic selection may help to isolate the cause of a given problem.
         # Corresponds to the JSON property `disableOrganicSelection`
         # @return [Boolean]
         attr_accessor :disable_organic_selection
         alias_method :disable_organic_selection?, :disable_organic_selection
       
-        # Flags to force in a particular experiment state.
-        # Map from flag name to flag value.
+        # Flags to force in a particular experiment state. Map from flag name to flag
+        # value.
         # Corresponds to the JSON property `forcedFlags`
         # @return [Hash<String,String>]
         attr_accessor :forced_flags
       
-        # Rollouts to force in a particular experiment state.
-        # Map from rollout name to rollout value.
+        # Rollouts to force in a particular experiment state. Map from rollout name to
+        # rollout value.
         # Corresponds to the JSON property `forcedRollouts`
         # @return [Hash<String,Boolean>]
         attr_accessor :forced_rollouts
@@ -2279,21 +2095,21 @@ module Google
         end
       end
       
-      # Input only.
-      # Use this field to specify bucketing option for the histogram search response.
+      # Input only. Use this field to specify bucketing option for the histogram
+      # search response.
       class NumericBucketingOption
         include Google::Apis::Core::Hashable
       
         # Required. Two adjacent values form a histogram bucket. Values should be in
         # ascending order. For example, if [5, 10, 15] are provided, four buckets are
-        # created: (-inf, 5), 5, 10), [10, 15), [15, inf). At most 20
-        # [buckets_bound is supported.
+        # created: (-inf, 5), 5, 10), [10, 15), [15, inf). At most 20 [buckets_bound is
+        # supported.
         # Corresponds to the JSON property `bucketBounds`
         # @return [Array<Float>]
         attr_accessor :bucket_bounds
       
-        # Optional. If set to true, the histogram result includes minimum/maximum
-        # value of the numeric field.
+        # Optional. If set to true, the histogram result includes minimum/maximum value
+        # of the numeric field.
         # Corresponds to the JSON property `requiresMinMax`
         # @return [Boolean]
         attr_accessor :requires_min_max
@@ -2310,25 +2126,24 @@ module Google
         end
       end
       
-      # Output only.
-      # Custom numeric bucketing result.
+      # Output only. Custom numeric bucketing result.
       class NumericBucketingResult
         include Google::Apis::Core::Hashable
       
-        # Count within each bucket. Its size is the length of
-        # NumericBucketingOption.bucket_bounds plus 1.
+        # Count within each bucket. Its size is the length of NumericBucketingOption.
+        # bucket_bounds plus 1.
         # Corresponds to the JSON property `counts`
         # @return [Array<Google::Apis::JobsV3p1beta1::BucketizedCount>]
         attr_accessor :counts
       
-        # Stores the maximum value of the numeric field. Is populated only if
-        # [NumericBucketingOption.requires_min_max] is set to true.
+        # Stores the maximum value of the numeric field. Is populated only if [
+        # NumericBucketingOption.requires_min_max] is set to true.
         # Corresponds to the JSON property `maxValue`
         # @return [Float]
         attr_accessor :max_value
       
-        # Stores the minimum value of the numeric field. Will be populated only if
-        # [NumericBucketingOption.requires_min_max] is set to true.
+        # Stores the minimum value of the numeric field. Will be populated only if [
+        # NumericBucketingOption.requires_min_max] is set to true.
         # Corresponds to the JSON property `minValue`
         # @return [Float]
         attr_accessor :min_value
@@ -2350,47 +2165,45 @@ module Google
       class Operation
         include Google::Apis::Core::Hashable
       
-        # If the value is `false`, it means the operation is still in progress.
-        # If `true`, the operation is completed, and either `error` or `response` is
-        # available.
+        # If the value is `false`, it means the operation is still in progress. If `true`
+        # , the operation is completed, and either `error` or `response` is available.
         # Corresponds to the JSON property `done`
         # @return [Boolean]
         attr_accessor :done
         alias_method :done?, :done
       
-        # The `Status` type defines a logical error model that is suitable for
-        # different programming environments, including REST APIs and RPC APIs. It is
-        # used by [gRPC](https://github.com/grpc). Each `Status` message contains
-        # three pieces of data: error code, error message, and error details.
-        # You can find out more about this error model and how to work with it in the
-        # [API Design Guide](https://cloud.google.com/apis/design/errors).
+        # The `Status` type defines a logical error model that is suitable for different
+        # programming environments, including REST APIs and RPC APIs. It is used by [
+        # gRPC](https://github.com/grpc). Each `Status` message contains three pieces of
+        # data: error code, error message, and error details. You can find out more
+        # about this error model and how to work with it in the [API Design Guide](https:
+        # //cloud.google.com/apis/design/errors).
         # Corresponds to the JSON property `error`
         # @return [Google::Apis::JobsV3p1beta1::Status]
         attr_accessor :error
       
-        # Service-specific metadata associated with the operation.  It typically
-        # contains progress information and common metadata such as create time.
-        # Some services might not provide such metadata.  Any method that returns a
-        # long-running operation should document the metadata type, if any.
+        # Service-specific metadata associated with the operation. It typically contains
+        # progress information and common metadata such as create time. Some services
+        # might not provide such metadata. Any method that returns a long-running
+        # operation should document the metadata type, if any.
         # Corresponds to the JSON property `metadata`
         # @return [Hash<String,Object>]
         attr_accessor :metadata
       
         # The server-assigned name, which is only unique within the same service that
-        # originally returns it. If you use the default HTTP mapping, the
-        # `name` should be a resource name ending with `operations/`unique_id``.
+        # originally returns it. If you use the default HTTP mapping, the `name` should
+        # be a resource name ending with `operations/`unique_id``.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # The normal response of the operation in case of success.  If the original
-        # method returns no data on success, such as `Delete`, the response is
-        # `google.protobuf.Empty`.  If the original method is standard
-        # `Get`/`Create`/`Update`, the response should be the resource.  For other
-        # methods, the response should have the type `XxxResponse`, where `Xxx`
-        # is the original method name.  For example, if the original method name
-        # is `TakeSnapshot()`, the inferred response type is
-        # `TakeSnapshotResponse`.
+        # The normal response of the operation in case of success. If the original
+        # method returns no data on success, such as `Delete`, the response is `google.
+        # protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`,
+        # the response should be the resource. For other methods, the response should
+        # have the type `XxxResponse`, where `Xxx` is the original method name. For
+        # example, if the original method name is `TakeSnapshot()`, the inferred
+        # response type is `TakeSnapshotResponse`.
         # Corresponds to the JSON property `response`
         # @return [Hash<String,Object>]
         attr_accessor :response
@@ -2411,73 +2224,63 @@ module Google
       
       # Represents a postal address, e.g. for postal delivery or payments addresses.
       # Given a postal address, a postal service can deliver items to a premise, P.O.
-      # Box or similar.
-      # It is not intended to model geographical locations (roads, towns,
-      # mountains).
-      # In typical usage an address would be created via user input or from importing
-      # existing data, depending on the type of process.
-      # Advice on address input / editing:
-      # - Use an i18n-ready address widget such as
-      # https://github.com/google/libaddressinput)
-      # - Users should not be presented with UI elements for input or editing of
-      # fields outside countries where that field is used.
-      # For more guidance on how to use this schema, please see:
-      # https://support.google.com/business/answer/6397478
+      # Box or similar. It is not intended to model geographical locations (roads,
+      # towns, mountains). In typical usage an address would be created via user input
+      # or from importing existing data, depending on the type of process. Advice on
+      # address input / editing: - Use an i18n-ready address widget such as https://
+      # github.com/google/libaddressinput) - Users should not be presented with UI
+      # elements for input or editing of fields outside countries where that field is
+      # used. For more guidance on how to use this schema, please see: https://support.
+      # google.com/business/answer/6397478
       class PostalAddress
         include Google::Apis::Core::Hashable
       
-        # Unstructured address lines describing the lower levels of an address.
-        # Because values in address_lines do not have type information and may
-        # sometimes contain multiple values in a single field (e.g.
-        # "Austin, TX"), it is important that the line order is clear. The order of
-        # address lines should be "envelope order" for the country/region of the
-        # address. In places where this can vary (e.g. Japan), address_language is
-        # used to make it explicit (e.g. "ja" for large-to-small ordering and
-        # "ja-Latn" or "en" for small-to-large). This way, the most specific line of
-        # an address can be selected based on the language.
-        # The minimum permitted structural representation of an address consists
-        # of a region_code with all remaining information placed in the
-        # address_lines. It would be possible to format such an address very
-        # approximately without geocoding, but no semantic reasoning could be
-        # made about any of the address components until it was at least
-        # partially resolved.
-        # Creating an address only containing a region_code and address_lines, and
-        # then geocoding is the recommended way to handle completely unstructured
-        # addresses (as opposed to guessing which parts of the address should be
-        # localities or administrative areas).
+        # Unstructured address lines describing the lower levels of an address. Because
+        # values in address_lines do not have type information and may sometimes contain
+        # multiple values in a single field (e.g. "Austin, TX"), it is important that
+        # the line order is clear. The order of address lines should be "envelope order"
+        # for the country/region of the address. In places where this can vary (e.g.
+        # Japan), address_language is used to make it explicit (e.g. "ja" for large-to-
+        # small ordering and "ja-Latn" or "en" for small-to-large). This way, the most
+        # specific line of an address can be selected based on the language. The minimum
+        # permitted structural representation of an address consists of a region_code
+        # with all remaining information placed in the address_lines. It would be
+        # possible to format such an address very approximately without geocoding, but
+        # no semantic reasoning could be made about any of the address components until
+        # it was at least partially resolved. Creating an address only containing a
+        # region_code and address_lines, and then geocoding is the recommended way to
+        # handle completely unstructured addresses (as opposed to guessing which parts
+        # of the address should be localities or administrative areas).
         # Corresponds to the JSON property `addressLines`
         # @return [Array<String>]
         attr_accessor :address_lines
       
         # Optional. Highest administrative subdivision which is used for postal
-        # addresses of a country or region.
-        # For example, this can be a state, a province, an oblast, or a prefecture.
-        # Specifically, for Spain this is the province and not the autonomous
-        # community (e.g. "Barcelona" and not "Catalonia").
-        # Many countries don't use an administrative area in postal addresses. E.g.
-        # in Switzerland this should be left unpopulated.
+        # addresses of a country or region. For example, this can be a state, a province,
+        # an oblast, or a prefecture. Specifically, for Spain this is the province and
+        # not the autonomous community (e.g. "Barcelona" and not "Catalonia"). Many
+        # countries don't use an administrative area in postal addresses. E.g. in
+        # Switzerland this should be left unpopulated.
         # Corresponds to the JSON property `administrativeArea`
         # @return [String]
         attr_accessor :administrative_area
       
-        # Optional. BCP-47 language code of the contents of this address (if
-        # known). This is often the UI language of the input form or is expected
-        # to match one of the languages used in the address' country/region, or their
-        # transliterated equivalents.
-        # This can affect formatting in certain countries, but is not critical
-        # to the correctness of the data and will never affect any validation or
-        # other non-formatting related operations.
-        # If this value is not known, it should be omitted (rather than specifying a
-        # possibly incorrect default).
+        # Optional. BCP-47 language code of the contents of this address (if known).
+        # This is often the UI language of the input form or is expected to match one of
+        # the languages used in the address' country/region, or their transliterated
+        # equivalents. This can affect formatting in certain countries, but is not
+        # critical to the correctness of the data and will never affect any validation
+        # or other non-formatting related operations. If this value is not known, it
+        # should be omitted (rather than specifying a possibly incorrect default).
         # Examples: "zh-Hant", "ja", "ja-Latn", "en".
         # Corresponds to the JSON property `languageCode`
         # @return [String]
         attr_accessor :language_code
       
-        # Optional. Generally refers to the city/town portion of the address.
-        # Examples: US city, IT comune, UK post town.
-        # In regions of the world where localities are not well defined or do not fit
-        # into this structure well, leave locality empty and use address_lines.
+        # Optional. Generally refers to the city/town portion of the address. Examples:
+        # US city, IT comune, UK post town. In regions of the world where localities are
+        # not well defined or do not fit into this structure well, leave locality empty
+        # and use address_lines.
         # Corresponds to the JSON property `locality`
         # @return [String]
         attr_accessor :locality
@@ -2487,48 +2290,47 @@ module Google
         # @return [String]
         attr_accessor :organization
       
-        # Optional. Postal code of the address. Not all countries use or require
-        # postal codes to be present, but where they are used, they may trigger
-        # additional validation with other parts of the address (e.g. state/zip
-        # validation in the U.S.A.).
+        # Optional. Postal code of the address. Not all countries use or require postal
+        # codes to be present, but where they are used, they may trigger additional
+        # validation with other parts of the address (e.g. state/zip validation in the U.
+        # S.A.).
         # Corresponds to the JSON property `postalCode`
         # @return [String]
         attr_accessor :postal_code
       
-        # Optional. The recipient at the address.
-        # This field may, under certain circumstances, contain multiline information.
-        # For example, it might contain "care of" information.
+        # Optional. The recipient at the address. This field may, under certain
+        # circumstances, contain multiline information. For example, it might contain "
+        # care of" information.
         # Corresponds to the JSON property `recipients`
         # @return [Array<String>]
         attr_accessor :recipients
       
-        # Required. CLDR region code of the country/region of the address. This
-        # is never inferred and it is up to the user to ensure the value is
-        # correct. See http://cldr.unicode.org/ and
-        # http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html
-        # for details. Example: "CH" for Switzerland.
+        # Required. CLDR region code of the country/region of the address. This is never
+        # inferred and it is up to the user to ensure the value is correct. See http://
+        # cldr.unicode.org/ and http://www.unicode.org/cldr/charts/30/supplemental/
+        # territory_information.html for details. Example: "CH" for Switzerland.
         # Corresponds to the JSON property `regionCode`
         # @return [String]
         attr_accessor :region_code
       
         # The schema revision of the `PostalAddress`. This must be set to 0, which is
-        # the latest revision.
-        # All new revisions **must** be backward compatible with old revisions.
+        # the latest revision. All new revisions **must** be backward compatible with
+        # old revisions.
         # Corresponds to the JSON property `revision`
         # @return [Fixnum]
         attr_accessor :revision
       
-        # Optional. Additional, country-specific, sorting code. This is not used
-        # in most regions. Where it is used, the value is either a string like
-        # "CEDEX", optionally followed by a number (e.g. "CEDEX 7"), or just a number
-        # alone, representing the "sector code" (Jamaica), "delivery area indicator"
-        # (Malawi) or "post office indicator" (e.g. Côte d'Ivoire).
+        # Optional. Additional, country-specific, sorting code. This is not used in most
+        # regions. Where it is used, the value is either a string like "CEDEX",
+        # optionally followed by a number (e.g. "CEDEX 7"), or just a number alone,
+        # representing the "sector code" (Jamaica), "delivery area indicator" (Malawi)
+        # or "post office indicator" (e.g. Côte d'Ivoire).
         # Corresponds to the JSON property `sortingCode`
         # @return [String]
         attr_accessor :sorting_code
       
-        # Optional. Sublocality of the address.
-        # For example, this can be neighborhoods, boroughs, districts.
+        # Optional. Sublocality of the address. For example, this can be neighborhoods,
+        # boroughs, districts.
         # Corresponds to the JSON property `sublocality`
         # @return [String]
         attr_accessor :sublocality
@@ -2553,27 +2355,21 @@ module Google
         end
       end
       
-      # Input only.
-      # Options for job processing.
+      # Input only. Options for job processing.
       class ProcessingOptions
         include Google::Apis::Core::Hashable
       
-        # Optional. If set to `true`, the service does not attempt to resolve a
-        # more precise address for the job.
+        # Optional. If set to `true`, the service does not attempt to resolve a more
+        # precise address for the job.
         # Corresponds to the JSON property `disableStreetAddressResolution`
         # @return [Boolean]
         attr_accessor :disable_street_address_resolution
         alias_method :disable_street_address_resolution?, :disable_street_address_resolution
       
-        # Optional. Option for job HTML content sanitization. Applied fields are:
-        # * description
-        # * applicationInfo.instruction
-        # * incentives
-        # * qualifications
-        # * responsibilities
-        # HTML tags in these fields may be stripped if sanitiazation is not
-        # disabled.
-        # Defaults to HtmlSanitization.SIMPLE_FORMATTING_ONLY.
+        # Optional. Option for job HTML content sanitization. Applied fields are: *
+        # description * applicationInfo.instruction * incentives * qualifications *
+        # responsibilities HTML tags in these fields may be stripped if sanitiazation is
+        # not disabled. Defaults to HtmlSanitization.SIMPLE_FORMATTING_ONLY.
         # Corresponds to the JSON property `htmlSanitization`
         # @return [String]
         attr_accessor :html_sanitization
@@ -2589,58 +2385,50 @@ module Google
         end
       end
       
-      # Input only.
-      # Meta information related to the job searcher or entity
-      # conducting the job search. This information is used to improve the
-      # performance of the service.
+      # Input only. Meta information related to the job searcher or entity conducting
+      # the job search. This information is used to improve the performance of the
+      # service.
       class RequestMetadata
         include Google::Apis::Core::Hashable
       
-        # Device information collected from the job seeker, candidate, or
-        # other entity conducting the job search. Providing this information improves
-        # the quality of the search results across devices.
+        # Device information collected from the job seeker, candidate, or other entity
+        # conducting the job search. Providing this information improves the quality of
+        # the search results across devices.
         # Corresponds to the JSON property `deviceInfo`
         # @return [Google::Apis::JobsV3p1beta1::DeviceInfo]
         attr_accessor :device_info
       
         # Required. The client-defined scope or source of the service call, which
-        # typically
-        # is the domain on
-        # which the service has been implemented and is currently being run.
-        # For example, if the service is being run by client <em>Foo, Inc.</em>, on
-        # job board www.foo.com and career site www.bar.com, then this field is
-        # set to "foo.com" for use on the job board, and "bar.com" for use on the
-        # career site.
-        # If this field isn't available for some reason, send "UNKNOWN".
-        # Any improvements to the model for a particular tenant site rely on this
-        # field being set correctly to a domain.
-        # The maximum number of allowed characters is 255.
+        # typically is the domain on which the service has been implemented and is
+        # currently being run. For example, if the service is being run by client *Foo,
+        # Inc.*, on job board www.foo.com and career site www.bar.com, then this field
+        # is set to "foo.com" for use on the job board, and "bar.com" for use on the
+        # career site. If this field isn't available for some reason, send "UNKNOWN".
+        # Any improvements to the model for a particular tenant site rely on this field
+        # being set correctly to a domain. The maximum number of allowed characters is
+        # 255.
         # Corresponds to the JSON property `domain`
         # @return [String]
         attr_accessor :domain
       
         # Required. A unique session identification string. A session is defined as the
-        # duration of an end user's interaction with the service over a certain
-        # period.
-        # Obfuscate this field for privacy concerns before
-        # providing it to the service.
-        # If this field is not available for some reason, send "UNKNOWN". Note
-        # that any improvements to the model for a particular tenant
-        # site, rely on this field being set correctly to some unique session_id.
-        # The maximum number of allowed characters is 255.
+        # duration of an end user's interaction with the service over a certain period.
+        # Obfuscate this field for privacy concerns before providing it to the service.
+        # If this field is not available for some reason, send "UNKNOWN". Note that any
+        # improvements to the model for a particular tenant site, rely on this field
+        # being set correctly to some unique session_id. The maximum number of allowed
+        # characters is 255.
         # Corresponds to the JSON property `sessionId`
         # @return [String]
         attr_accessor :session_id
       
-        # Required. A unique user identification string, as determined by the client.
-        # To have the strongest positive impact on search quality
-        # make sure the client-level is unique.
-        # Obfuscate this field for privacy concerns before
-        # providing it to the service.
-        # If this field is not available for some reason, send "UNKNOWN". Note
-        # that any improvements to the model for a particular tenant
-        # site, rely on this field being set correctly to a unique user_id.
-        # The maximum number of allowed characters is 255.
+        # Required. A unique user identification string, as determined by the client. To
+        # have the strongest positive impact on search quality make sure the client-
+        # level is unique. Obfuscate this field for privacy concerns before providing it
+        # to the service. If this field is not available for some reason, send "UNKNOWN".
+        # Note that any improvements to the model for a particular tenant site, rely on
+        # this field being set correctly to a unique user_id. The maximum number of
+        # allowed characters is 255.
         # Corresponds to the JSON property `userId`
         # @return [String]
         attr_accessor :user_id
@@ -2658,13 +2446,12 @@ module Google
         end
       end
       
-      # Output only.
-      # Additional information returned to client, such as debugging information.
+      # Output only. Additional information returned to client, such as debugging
+      # information.
       class ResponseMetadata
         include Google::Apis::Core::Hashable
       
-        # A unique id associated with this call.
-        # This id is logged for tracking purposes.
+        # A unique id associated with this call. This id is logged for tracking purposes.
         # Corresponds to the JSON property `requestId`
         # @return [String]
         attr_accessor :request_id
@@ -2679,63 +2466,52 @@ module Google
         end
       end
       
-      # Input only.
-      # The Request body of the `SearchJobs` call.
+      # Input only. The Request body of the `SearchJobs` call.
       class SearchJobsRequest
         include Google::Apis::Core::Hashable
       
-        # Input only.
-        # Custom ranking information for SearchJobsRequest.
+        # Input only. Custom ranking information for SearchJobsRequest.
         # Corresponds to the JSON property `customRankingInfo`
         # @return [Google::Apis::JobsV3p1beta1::CustomRankingInfo]
         attr_accessor :custom_ranking_info
       
         # Optional. Controls whether to disable exact keyword match on Job.job_title,
-        # Job.description, Job.company_display_name, Job.locations,
-        # 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, the query "program manager," a
-        # result is returned even if the job posting has the title "software
-        # developer," which does not fall into "program manager" ontology, but does
-        # have "program manager" appearing in its description.
-        # For queries like "cloud" that does not contain title or
-        # location specific ontology, jobs with "cloud" keyword matches are returned
-        # regardless of this flag's value.
-        # Please use Company.keyword_searchable_custom_fields or
-        # Company.keyword_searchable_custom_attributes if company specific
-        # globally matched custom field/attribute string values is needed. Enabling
-        # keyword match improves recall of subsequent search requests.
-        # Defaults to false.
+        # Job.description, Job.company_display_name, Job.locations, 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,
+        # the query "program manager," a result is returned even if the job posting has
+        # the title "software developer," which does not fall into "program manager"
+        # ontology, but does have "program manager" appearing in its description. For
+        # queries like "cloud" that does not contain title or location specific ontology,
+        # jobs with "cloud" keyword matches are returned regardless of this flag's
+        # value. Please use Company.keyword_searchable_custom_fields or Company.
+        # keyword_searchable_custom_attributes if company specific globally matched
+        # custom field/attribute string values is needed. Enabling keyword match
+        # improves recall of subsequent search requests. Defaults to false.
         # Corresponds to the JSON property `disableKeywordMatch`
         # @return [Boolean]
         attr_accessor :disable_keyword_match
         alias_method :disable_keyword_match?, :disable_keyword_match
       
         # Optional. 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
-        # being displayed lower down in the results.
-        # Defaults to DiversificationLevel.SIMPLE if no value
-        # is specified.
+        # 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 being displayed lower down in
+        # the results. Defaults to DiversificationLevel.SIMPLE if no value is specified.
         # Corresponds to the JSON property `diversificationLevel`
         # @return [String]
         attr_accessor :diversification_level
       
         # Optional. 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.
+        # results. Broadened queries append results to the end of the matching results
+        # list. Defaults to false.
         # Corresponds to the JSON property `enableBroadening`
         # @return [Boolean]
         attr_accessor :enable_broadening
         alias_method :enable_broadening?, :enable_broadening
       
-        # Input only.
-        # Histogram facets to be specified in SearchJobsRequest.
+        # Input only. Histogram facets to be specified in SearchJobsRequest.
         # Corresponds to the JSON property `histogramFacets`
         # @return [Google::Apis::JobsV3p1beta1::HistogramFacets]
         attr_accessor :histogram_facets
@@ -2745,78 +2521,61 @@ module Google
         # @return [Array<Google::Apis::JobsV3p1beta1::HistogramQuery>]
         attr_accessor :histogram_queries
       
-        # Input only.
-        # The query required to perform a search query.
+        # Input only. The query required to perform a search query.
         # Corresponds to the JSON property `jobQuery`
         # @return [Google::Apis::JobsV3p1beta1::JobQuery]
         attr_accessor :job_query
       
-        # Optional. The desired job attributes returned for jobs in the
-        # search response. Defaults to JobView.SMALL if no value is specified.
+        # Optional. The desired job attributes returned for jobs in the search response.
+        # Defaults to JobView.SMALL if no value is specified.
         # Corresponds to the JSON property `jobView`
         # @return [String]
         attr_accessor :job_view
       
         # Optional. 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 page_token is unset.
-        # The maximum allowed value is 5000. Otherwise an error is thrown.
-        # 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
-        # pagination, (for example, pageSize = 10 and offset = 10 means to return
-        # from the second page).
+        # result location, amongst the jobs deemed by the API as relevant) in search
+        # results. This field is only considered if page_token is unset. The maximum
+        # allowed value is 5000. Otherwise an error is thrown. 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 pagination, (for example, pageSize =
+        # 10 and offset = 10 means to return from the second page).
         # Corresponds to the JSON property `offset`
         # @return [Fixnum]
         attr_accessor :offset
       
-        # Optional. The criteria determining how search results are sorted. Default is
-        # "relevance desc".
-        # Supported options are:
-        # * `"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 Job.posting_publish_time
-        # descending.
-        # * `"posting_update_time desc"`: By Job.posting_update_time
-        # descending.
-        # * `"title"`: By Job.title ascending.
-        # * `"title desc"`: By Job.title descending.
-        # * `"annualized_base_compensation"`: By job's
-        # 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
-        # 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
-        # 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
-        # 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
-        # SearchJobsRequest.custom_ranking_info.importance_level in descending
-        # order.
-        # * Location sorting: Use the special syntax to order jobs by distance:<br>
-        # "`distance_from('Hawaii')`": Order by distance from Hawaii.<br>
-        # "`distance_from(19.89, 155.5)`": Order by distance from a coordinate.<br>
-        # "`distance_from('Hawaii'), distance_from('Puerto Rico')`": Order by
-        # multiple locations. See details below.<br>
-        # "`distance_from('Hawaii'), distance_from(19.89, 155.5)`": Order by
-        # multiple locations. See details below.<br>
-        # The string can have a maximum of 256 characters. When multiple distance
-        # centers are provided, a job that is close to any of the distance centers
-        # would have a high rank. When a job has multiple locations, the job location
-        # closest to one of the distance centers will be used. Jobs that don't have
-        # locations will be ranked at the bottom. Distance is calculated with a
-        # precision of 11.3 meters (37.4 feet). Diversification strategy is still
-        # applied unless explicitly disabled in
+        # Optional. The criteria determining how search results are sorted. Default is "
+        # relevance desc". Supported options are: * `"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 Job.posting_publish_time descending. * `"posting_update_time desc"`:
+        # By Job.posting_update_time descending. * `"title"`: By Job.title ascending. *
+        # `"title desc"`: By Job.title descending. * `"annualized_base_compensation"`:
+        # By job's 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 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 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 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 SearchJobsRequest.custom_ranking_info.importance_level in
+        # descending order. * Location sorting: Use the special syntax to order jobs by
+        # distance: "`distance_from('Hawaii')`": Order by distance from Hawaii. "`
+        # distance_from(19.89, 155.5)`": Order by distance from a coordinate. "`
+        # distance_from('Hawaii'), distance_from('Puerto Rico')`": Order by multiple
+        # locations. See details below. "`distance_from('Hawaii'), distance_from(19.89,
+        # 155.5)`": Order by multiple locations. See details below. The string can have
+        # a maximum of 256 characters. When multiple distance centers are provided, a
+        # job that is close to any of the distance centers would have a high rank. When
+        # a job has multiple locations, the job location closest to one of the distance
+        # centers will be used. Jobs that don't have locations will be ranked at the
+        # bottom. Distance is calculated with a precision of 11.3 meters (37.4 feet).
+        # Diversification strategy is still applied unless explicitly disabled in
         # diversification_level.
         # Corresponds to the JSON property `orderBy`
         # @return [String]
@@ -2829,35 +2588,27 @@ module Google
         # @return [Fixnum]
         attr_accessor :page_size
       
-        # Optional. The token specifying the current offset within
-        # search results. See SearchJobsResponse.next_page_token for
-        # an explanation of how to obtain the next set of query results.
+        # Optional. The token specifying the current offset within search results. See
+        # SearchJobsResponse.next_page_token for an explanation of how to obtain the
+        # next set of query results.
         # Corresponds to the JSON property `pageToken`
         # @return [String]
         attr_accessor :page_token
       
-        # Input only.
-        # Meta information related to the job searcher or entity
-        # conducting the job search. This information is used to improve the
-        # performance of the service.
+        # Input only. Meta information related to the job searcher or entity conducting
+        # the job search. This information is used to improve the performance of the
+        # service.
         # Corresponds to the JSON property `requestMetadata`
         # @return [Google::Apis::JobsV3p1beta1::RequestMetadata]
         attr_accessor :request_metadata
       
-        # Optional. 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.
-        # Enabling this flag may adversely impact performance.
-        # Defaults to false.
+        # This field is deprecated.
         # Corresponds to the JSON property `requirePreciseResultSize`
         # @return [Boolean]
         attr_accessor :require_precise_result_size
         alias_method :require_precise_result_size?, :require_precise_result_size
       
-        # Optional. Mode of a search.
-        # Defaults to SearchMode.JOB_SEARCH.
+        # Optional. Mode of a search. Defaults to SearchMode.JOB_SEARCH.
         # Corresponds to the JSON property `searchMode`
         # @return [String]
         attr_accessor :search_mode
@@ -2886,45 +2637,43 @@ module Google
         end
       end
       
-      # Output only.
-      # Response for SearchJob method.
+      # Output only. Response for SearchJob method.
       class SearchJobsResponse
         include Google::Apis::Core::Hashable
       
         # If query broadening is enabled, we may append additional results from the
         # broadened query. This number indicates how many of the jobs returned in the
-        # jobs field are from the broadened query. These results are always at the
-        # end of the jobs list. In particular, a value of 0, or if the field isn't
-        # set, all the jobs in the jobs list are from the original
-        # (without broadening) query. If this field is non-zero, subsequent requests
-        # with offset after this result set should contain all broadened results.
+        # jobs field are from the broadened query. These results are always at the end
+        # of the jobs list. In particular, a value of 0, or if the field isn't set, all
+        # the jobs in the jobs list are from the original (without broadening) query. If
+        # this field is non-zero, subsequent requests with offset after this result set
+        # should contain all broadened results.
         # Corresponds to the JSON property `broadenedQueryJobsCount`
         # @return [Fixnum]
         attr_accessor :broadened_query_jobs_count
       
-        # An estimation of the number of jobs that match the specified query.
-        # This number is not guaranteed to be accurate. For accurate results,
-        # see enable_precise_result_size.
+        # An estimation of the number of jobs that match the specified query. This
+        # number is not guaranteed to be accurate. For accurate results, see
+        # SearchJobsResponse.total_size.
         # Corresponds to the JSON property `estimatedTotalSize`
         # @return [Fixnum]
         attr_accessor :estimated_total_size
       
-        # The histogram results that match with specified
-        # SearchJobsRequest.histogram_queries.
+        # The histogram results that match with specified SearchJobsRequest.
+        # histogram_queries.
         # Corresponds to the JSON property `histogramQueryResults`
         # @return [Array<Google::Apis::JobsV3p1beta1::HistogramQueryResult>]
         attr_accessor :histogram_query_results
       
-        # Output only.
-        # Histogram results that match HistogramFacets specified in
+        # Output only. Histogram results that match HistogramFacets specified in
         # SearchJobsRequest.
         # Corresponds to the JSON property `histogramResults`
         # @return [Google::Apis::JobsV3p1beta1::HistogramResults]
         attr_accessor :histogram_results
       
-        # The location filters that the service applied to the specified query. If
-        # any filters are lat-lng based, the JobLocation.location_type is
-        # JobLocation.LocationType#LOCATION_TYPE_UNSPECIFIED.
+        # The location filters that the service applied to the specified query. If any
+        # filters are lat-lng based, the JobLocation.location_type is JobLocation.
+        # LocationType#LOCATION_TYPE_UNSPECIFIED.
         # Corresponds to the JSON property `locationFilters`
         # @return [Array<Google::Apis::JobsV3p1beta1::Location>]
         attr_accessor :location_filters
@@ -2934,8 +2683,8 @@ module Google
         # @return [Array<Google::Apis::JobsV3p1beta1::MatchingJob>]
         attr_accessor :matching_jobs
       
-        # Output only.
-        # Additional information returned to client, such as debugging information.
+        # Output only. Additional information returned to client, such as debugging
+        # information.
         # Corresponds to the JSON property `metadata`
         # @return [Google::Apis::JobsV3p1beta1::ResponseMetadata]
         attr_accessor :metadata
@@ -2946,15 +2695,12 @@ module Google
         # @return [String]
         attr_accessor :next_page_token
       
-        # Output only.
-        # Spell check result.
+        # Output only. Spell check result.
         # Corresponds to the JSON property `spellCorrection`
         # @return [Google::Apis::JobsV3p1beta1::SpellingCorrection]
         attr_accessor :spell_correction
       
-        # The precise result count, which is available only if the client set
-        # enable_precise_result_size to `true`, or if the response
-        # is the last page of results. Otherwise, the value is `-1`.
+        # The precise result count with limit 100,000.
         # Corresponds to the JSON property `totalSize`
         # @return [Fixnum]
         attr_accessor :total_size
@@ -2978,8 +2724,7 @@ module Google
         end
       end
       
-      # Output only.
-      # Spell check result.
+      # Output only. Spell check result.
       class SpellingCorrection
         include Google::Apis::Core::Hashable
       
@@ -3005,12 +2750,12 @@ module Google
         end
       end
       
-      # The `Status` type defines a logical error model that is suitable for
-      # different programming environments, including REST APIs and RPC APIs. It is
-      # used by [gRPC](https://github.com/grpc). Each `Status` message contains
-      # three pieces of data: error code, error message, and error details.
-      # You can find out more about this error model and how to work with it in the
-      # [API Design Guide](https://cloud.google.com/apis/design/errors).
+      # The `Status` type defines a logical error model that is suitable for different
+      # programming environments, including REST APIs and RPC APIs. It is used by [
+      # gRPC](https://github.com/grpc). Each `Status` message contains three pieces of
+      # data: error code, error message, and error details. You can find out more
+      # about this error model and how to work with it in the [API Design Guide](https:
+      # //cloud.google.com/apis/design/errors).
       class Status
         include Google::Apis::Core::Hashable
       
@@ -3019,15 +2764,15 @@ module Google
         # @return [Fixnum]
         attr_accessor :code
       
-        # A list of messages that carry the error details.  There is a common set of
+        # A list of messages that carry the error details. There is a common set of
         # message types for APIs to use.
         # Corresponds to the JSON property `details`
         # @return [Array<Hash<String,Object>>]
         attr_accessor :details
       
-        # A developer-facing error message, which should be in English. Any
-        # user-facing error message should be localized and sent in the
-        # google.rpc.Status.details field, or localized by the client.
+        # A developer-facing error message, which should be in English. Any user-facing
+        # error message should be localized and sent in the google.rpc.Status.details
+        # field, or localized by the client.
         # Corresponds to the JSON property `message`
         # @return [String]
         attr_accessor :message
@@ -3044,14 +2789,14 @@ module Google
         end
       end
       
-      # Represents a time of day. The date and time zone are either not significant
-      # or are specified elsewhere. An API may choose to allow leap seconds. Related
+      # Represents a time of day. The date and time zone are either not significant or
+      # are specified elsewhere. An API may choose to allow leap seconds. Related
       # types are google.type.Date and `google.protobuf.Timestamp`.
       class TimeOfDay
         include Google::Apis::Core::Hashable
       
-        # Hours of day in 24 hour format. Should be from 0 to 23. An API may choose
-        # to allow the value "24:00:00" for scenarios like business closing time.
+        # Hours of day in 24 hour format. Should be from 0 to 23. An API may choose to
+        # allow the value "24:00:00" for scenarios like business closing time.
         # Corresponds to the JSON property `hours`
         # @return [Fixnum]
         attr_accessor :hours
@@ -3110,8 +2855,7 @@ module Google
         end
       end
       
-      # Input only.
-      # Request for updating a specified company.
+      # Input only. Request for updating a specified company.
       class UpdateCompanyRequest
         include Google::Apis::Core::Hashable
       
@@ -3122,12 +2866,10 @@ module Google
         # @return [Google::Apis::JobsV3p1beta1::Company]
         attr_accessor :company
       
-        # Optional but strongly recommended for the best service
-        # experience.
-        # If update_mask is provided, only the specified fields in
-        # company are updated. Otherwise all the fields are updated.
-        # A field mask to specify the company fields to be updated. Only
-        # top level fields of Company are supported.
+        # Optional but strongly recommended for the best service experience. If
+        # update_mask is provided, only the specified fields in company are updated.
+        # Otherwise all the fields are updated. A field mask to specify the company
+        # fields to be updated. Only top level fields of Company are supported.
         # Corresponds to the JSON property `updateMask`
         # @return [String]
         attr_accessor :update_mask
@@ -3143,24 +2885,21 @@ module Google
         end
       end
       
-      # Input only.
-      # Update job request.
+      # Input only. Update job request.
       class UpdateJobRequest
         include Google::Apis::Core::Hashable
       
         # A Job resource represents a job posting (also referred to as a "job listing"
-        # or "job requisition"). A job belongs to a Company, which is the hiring
-        # entity responsible for the job.
+        # or "job requisition"). A job belongs to a Company, which is the hiring entity
+        # responsible for the job.
         # Corresponds to the JSON property `job`
         # @return [Google::Apis::JobsV3p1beta1::Job]
         attr_accessor :job
       
         # Optional but strongly recommended to be provided for the best service
-        # experience.
-        # If update_mask is provided, only the specified fields in
-        # job are updated. Otherwise all the fields are updated.
-        # A field mask to restrict the fields that are updated. Only
-        # top level fields of Job are supported.
+        # experience. If update_mask is provided, only the specified fields in job are
+        # updated. Otherwise all the fields are updated. A field mask to restrict the
+        # fields that are updated. Only top level fields of Job are supported.
         # Corresponds to the JSON property `updateMask`
         # @return [String]
         attr_accessor :update_mask