google-api-client 0.30.6 → 0.30.7

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

@@ -51,13 +51,11 @@ module Google
         # 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.
+        #   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.
+        #   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
@@ -77,8 +75,7 @@ module Google
         #   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
+        #   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).
@@ -92,19 +89,15 @@ module Google
         #   language_codes are returned.
         #   The maximum number of allowed characters is 255.
         # @param [Fixnum] page_size
-        #   Required.
-        #   Completion result count.
+        #   Required. Completion result count.
         #   The maximum allowed page size is 10.
         # @param [String] query
-        #   Required.
-        #   The query used to generate suggestions.
+        #   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.
+        #   Optional. The scope of the completion. The defaults is CompletionScope.PUBLIC.
         # @param [String] type
-        #   Optional.
-        #   The completion topic. The default is CompletionType.COMBINED.
+        #   Optional. The completion topic. The default is CompletionType.COMBINED.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -180,8 +173,7 @@ module Google
         
         # Creates a new company entity.
         # @param [String] parent
-        #   Required.
-        #   Resource name of the project under which the company is created.
+        #   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
@@ -217,8 +209,7 @@ module Google
         # 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.
+        #   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
@@ -250,8 +241,7 @@ module Google
         
         # Retrieves specified company.
         # @param [String] name
-        #   Required.
-        #   The resource name of the company to be retrieved.
+        #   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
@@ -283,20 +273,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.
+        #   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.
+        #   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.
+        #   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.
+        #   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.
@@ -371,8 +357,7 @@ 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.
+        #   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
@@ -409,8 +394,7 @@ module Google
         # 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.
+        #   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
@@ -447,8 +431,7 @@ module Google
         # 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.
+        #   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
@@ -481,8 +464,7 @@ module Google
         # 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.
+        #   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
@@ -514,13 +496,11 @@ module Google
         
         # Lists jobs by filter.
         # @param [String] parent
-        #   Required.
-        #   The resource name of the project under which the job is created.
+        #   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.
+        #   Required. The filter string specifies the jobs to be enumerated.
         #   Supported operator: =, AND
         #   The fields eligible for filtering are:
         #   * `companyName` (Required)
@@ -530,19 +510,16 @@ module Google
         #   * 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
+        #   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.
+        #   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.
+        #   Optional. The starting point of a query result.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -620,8 +597,7 @@ module Google
         # 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.
+        #   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
@@ -663,8 +639,7 @@ module Google
         # 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.
+        #   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

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 = '20190629'
+      REVISION = '20190712'
 
       # 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

@@ -75,8 +75,7 @@ module Google
       class BatchDeleteJobsRequest
         include Google::Apis::Core::Hashable
       
-        # Required.
-        # The filter string specifies the jobs to be deleted.
+        # Required. The filter string specifies the jobs to be deleted.
         # Supported operator: =, AND
         # The fields eligible for filtering are:
         # * `companyName` (Required)
@@ -155,22 +154,21 @@ module Google
       class ClientEvent
         include Google::Apis::Core::Hashable
       
-        # Required.
-        # The timestamp of the event.
+        # Required. The timestamp of the event.
         # Corresponds to the JSON property `createTime`
         # @return [String]
         attr_accessor :create_time
       
-        # Required.
-        # A unique identifier, generated by the client application. This `event_id`
+        # 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).
         # Corresponds to the JSON property `eventId`
         # @return [String]
         attr_accessor :event_id
       
-        # Optional.
-        # Extra information about this event. Used for storing information with no
+        # 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
@@ -185,8 +183,8 @@ module Google
         # @return [Google::Apis::JobsV3p1beta1::JobEvent]
         attr_accessor :job_event
       
-        # Optional.
-        # The event_id of an event that resulted in the current event. For example, a
+        # 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
@@ -197,8 +195,7 @@ module Google
         # @return [String]
         attr_accessor :parent_event_id
       
-        # Required.
-        # A unique ID generated in the API responses. It can be found in
+        # Required. A unique ID generated in the API responses. It can be found in
         # ResponseMetadata.request_id.
         # Corresponds to the JSON property `requestId`
         # @return [String]
@@ -224,8 +221,8 @@ module Google
       class CommuteFilter
         include Google::Apis::Core::Hashable
       
-        # Optional.
-        # If true, jobs without "precise" addresses (street level addresses or GPS
+        # 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
@@ -239,8 +236,7 @@ module Google
         attr_accessor :allow_imprecise_addresses
         alias_method :allow_imprecise_addresses?, :allow_imprecise_addresses
       
-        # Required.
-        # The method of transportation for which to calculate the commute time.
+        # Required. The method of transportation for which to calculate the commute time.
         # Corresponds to the JSON property `commuteMethod`
         # @return [String]
         attr_accessor :commute_method
@@ -252,8 +248,7 @@ module Google
         # @return [Google::Apis::JobsV3p1beta1::TimeOfDay]
         attr_accessor :departure_time
       
-        # Optional.
-        # Specifies the traffic density to use when calculating commute time.
+        # Optional. Specifies the traffic density to use when calculating commute time.
         # Corresponds to the JSON property `roadTraffic`
         # @return [String]
         attr_accessor :road_traffic
@@ -267,8 +262,8 @@ module Google
         # @return [Google::Apis::JobsV3p1beta1::LatLng]
         attr_accessor :start_coordinates
       
-        # Required.
-        # The maximum travel time in seconds. The maximum allowed value is `3600s`
+        # Required. The maximum travel time in seconds. The maximum allowed value is `
+        # 3600s`
         # (one hour). Format is `123s`.
         # Corresponds to the JSON property `travelDuration`
         # @return [String]
@@ -325,8 +320,8 @@ module Google
       class Company
         include Google::Apis::Core::Hashable
       
-        # Optional.
-        # The URI to employer's career site or careers page on the employer's web
+        # Optional. The URI to employer's career site or careers page on the employer's
+        # web
         # site, for example, "https://careers.google.com".
         # Corresponds to the JSON property `careerSiteUri`
         # @return [String]
@@ -337,14 +332,12 @@ module Google
         # @return [Google::Apis::JobsV3p1beta1::CompanyDerivedInfo]
         attr_accessor :derived_info
       
-        # Required.
-        # The display name of the company, for example, "Google, LLC".
+        # Required. The display name of the company, for example, "Google LLC".
         # Corresponds to the JSON property `displayName`
         # @return [String]
         attr_accessor :display_name
       
-        # Optional.
-        # Equal Employment Opportunity legal disclaimer text to be
+        # 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.
@@ -352,16 +345,14 @@ module Google
         # @return [String]
         attr_accessor :eeo_text
       
-        # Required.
-        # Client side company identifier, used to uniquely identify the
+        # Required. Client side company identifier, used to uniquely identify the
         # 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
+        # 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.
@@ -369,8 +360,7 @@ module Google
         # @return [String]
         attr_accessor :headquarters_address
       
-        # Optional.
-        # Set to true if it is the hiring agency that post jobs for other
+        # Optional. Set to true if it is the hiring agency that post jobs for other
         # employers.
         # Defaults to false if not provided.
         # Corresponds to the JSON property `hiringAgency`
@@ -378,14 +368,12 @@ module Google
         attr_accessor :hiring_agency
         alias_method :hiring_agency?, :hiring_agency
       
-        # Optional.
-        # A URI that hosts the employer's company logo.
+        # Optional. A URI that hosts the employer's company logo.
         # Corresponds to the JSON property `imageUri`
         # @return [String]
         attr_accessor :image_uri
       
-        # Optional.
-        # A list of keys of filterable Job.custom_attributes, whose
+        # 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
@@ -404,8 +392,7 @@ module Google
         # @return [String]
         attr_accessor :name
       
-        # Optional.
-        # The employer's company size.
+        # Optional. The employer's company size.
         # Corresponds to the JSON property `size`
         # @return [String]
         attr_accessor :size
@@ -418,8 +405,7 @@ module Google
         attr_accessor :suspended
         alias_method :suspended?, :suspended
       
-        # Optional.
-        # The URI representing the company's primary web site or home page,
+        # 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.
         # Corresponds to the JSON property `websiteUri`
@@ -483,16 +469,14 @@ module Google
         # @return [Google::Apis::JobsV3p1beta1::Money]
         attr_accessor :amount
       
-        # Optional.
-        # Compensation description.  For example, could
+        # 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
+        # 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
@@ -509,15 +493,13 @@ module Google
         # @return [Google::Apis::JobsV3p1beta1::CompensationRange]
         attr_accessor :range
       
-        # Optional.
-        # Compensation type.
+        # 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.
+        # Optional. Frequency of the specified amount.
         # Default is CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED.
         # Corresponds to the JSON property `unit`
         # @return [String]
@@ -543,8 +525,7 @@ module Google
       class CompensationFilter
         include Google::Apis::Core::Hashable
       
-        # Optional.
-        # If set to true, jobs with unspecified compensation range fields are
+        # Optional. If set to true, jobs with unspecified compensation range fields are
         # included.
         # Corresponds to the JSON property `includeJobsWithUnspecifiedCompensationRange`
         # @return [Boolean]
@@ -556,14 +537,12 @@ module Google
         # @return [Google::Apis::JobsV3p1beta1::CompensationRange]
         attr_accessor :range
       
-        # Required.
-        # Type of filter.
+        # Required. Type of filter.
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type
       
-        # Required.
-        # Specify desired `base compensation entry's`
+        # Required. Specify desired `base compensation entry's`
         # CompensationInfo.CompensationUnit.
         # Corresponds to the JSON property `units`
         # @return [Array<String>]
@@ -593,8 +572,8 @@ module Google
         # @return [Google::Apis::JobsV3p1beta1::NumericBucketingOption]
         attr_accessor :bucketing_option
       
-        # Required.
-        # Type of the request, representing which field the histogramming should be
+        # 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`.
         # Corresponds to the JSON property `type`
@@ -654,8 +633,7 @@ module Google
         # @return [Google::Apis::JobsV3p1beta1::CompensationRange]
         attr_accessor :annualized_total_compensation_range
       
-        # Optional.
-        # Job compensation information.
+        # 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.
@@ -830,8 +808,7 @@ module Google
       class CustomAttribute
         include Google::Apis::Core::Hashable
       
-        # Optional.
-        # If the `filterable` flag is true, custom field values are searchable.
+        # Optional. If the `filterable` flag is true, custom field values are searchable.
         # If false, values are not searchable.
         # Default is false.
         # Corresponds to the JSON property `filterable`
@@ -879,8 +856,8 @@ module Google
       class CustomAttributeHistogramRequest
         include Google::Apis::Core::Hashable
       
-        # Required.
-        # Specifies the custom field key to perform a histogram on. If specified
+        # 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.
@@ -952,8 +929,7 @@ module Google
       class CustomRankingInfo
         include Google::Apis::Core::Hashable
       
-        # Required.
-        # Controls over how important the score of
+        # 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.
@@ -961,8 +937,8 @@ module Google
         # @return [String]
         attr_accessor :importance_level
       
-        # Required.
-        # Controls over how job documents get ranked on top of existing relevance
+        # Required. Controls over how job documents get ranked on top of existing
+        # relevance
         # score (determined by API algorithm). The product of 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.
@@ -994,14 +970,12 @@ module Google
       class DeviceInfo
         include Google::Apis::Core::Hashable
       
-        # Optional.
-        # Type of the device.
+        # Optional. Type of the device.
         # Corresponds to the JSON property `deviceType`
         # @return [String]
         attr_accessor :device_type
       
-        # Optional.
-        # A device-specific ID. The ID must be a unique identifier that
+        # Optional. A device-specific ID. The ID must be a unique identifier that
         # distinguishes the device from other devices.
         # Corresponds to the JSON property `id`
         # @return [String]
@@ -1042,23 +1016,20 @@ module Google
       class HistogramFacets
         include Google::Apis::Core::Hashable
       
-        # Optional.
-        # Specifies compensation field-based histogram requests.
+        # 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.
+        # 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,
+        # Optional. Specifies the simple type of histogram facets, for example,
         # `COMPANY_SIZE`, `EMPLOYMENT_TYPE` etc.
         # Corresponds to the JSON property `simpleHistogramFacets`
         # @return [Array<String>]
@@ -1307,8 +1278,7 @@ module Google
         # @return [String]
         attr_accessor :company_display_name
       
-        # Required.
-        # The resource name of the company listing the job, such as
+        # 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]
@@ -1319,8 +1289,8 @@ module Google
         # @return [Google::Apis::JobsV3p1beta1::CompensationInfo]
         attr_accessor :compensation_info
       
-        # Optional.
-        # A map of fields to hold both filterable and non-filterable custom job
+        # 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
@@ -1334,14 +1304,13 @@ module Google
         # @return [Hash<String,Google::Apis::JobsV3p1beta1::CustomAttribute>]
         attr_accessor :custom_attributes
       
-        # Optional.
-        # The desired education degrees for the job, such as Bachelors, Masters.
+        # Optional. The desired education degrees for the job, such as Bachelors,
+        # Masters.
         # Corresponds to the JSON property `degreeTypes`
         # @return [Array<String>]
         attr_accessor :degree_types
       
-        # Optional.
-        # The department or functional area within the company with the open
+        # Optional. The department or functional area within the company with the open
         # position.
         # The maximum number of allowed characters is 255.
         # Corresponds to the JSON property `department`
@@ -1354,8 +1323,8 @@ module Google
         # @return [Google::Apis::JobsV3p1beta1::JobDerivedInfo]
         attr_accessor :derived_info
       
-        # Required.
-        # The description of the job, which typically includes a multi-paragraph
+        # 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
@@ -1367,50 +1336,45 @@ module Google
         # @return [String]
         attr_accessor :description
       
-        # Optional.
-        # The employment type(s) of a job, for example,
+        # 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
+        # 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.
         # Corresponds to the JSON property `incentives`
         # @return [String]
         attr_accessor :incentives
       
-        # Optional.
-        # The benefits included with the job.
+        # Optional. The benefits included with the job.
         # Corresponds to the JSON property `jobBenefits`
         # @return [Array<String>]
         attr_accessor :job_benefits
       
-        # Optional.
-        # The end timestamp of the job. Typically this field is used for contracting
+        # Optional. The end timestamp of the job. Typically this field is used for
+        # contracting
         # engagements. Invalid timestamps are ignored.
         # Corresponds to the JSON property `jobEndTime`
         # @return [String]
         attr_accessor :job_end_time
       
-        # Optional.
-        # The experience level associated with the job, such as "Entry Level".
+        # Optional. The experience level associated with the job, such as "Entry Level".
         # Corresponds to the JSON property `jobLevel`
         # @return [String]
         attr_accessor :job_level
       
-        # Optional.
-        # The start timestamp of the job in UTC time zone. Typically this field
+        # Optional. The start timestamp of the job in UTC time zone. Typically this
+        # 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
+        # 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
@@ -1470,16 +1434,15 @@ module Google
         # @return [String]
         attr_accessor :posting_expire_time
       
-        # Optional.
-        # The timestamp this job posting was most recently published. The default
+        # 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.
         # Corresponds to the JSON property `postingPublishTime`
         # @return [String]
         attr_accessor :posting_publish_time
       
-        # Optional.
-        # The job PostingRegion (for example, state, country) throughout which
+        # 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.
@@ -1501,8 +1464,7 @@ module Google
         # @return [Google::Apis::JobsV3p1beta1::ProcessingOptions]
         attr_accessor :processing_options
       
-        # Optional.
-        # A promotion value of the job, as determined by the client.
+        # 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
@@ -1512,8 +1474,7 @@ module Google
         # @return [Fixnum]
         attr_accessor :promotion_value
       
-        # Optional.
-        # A description of the qualifications required to perform the
+        # 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
@@ -1523,8 +1484,8 @@ module Google
         # @return [String]
         attr_accessor :qualifications
       
-        # Required.
-        # The requisition ID, also referred to as the posting ID, assigned by the
+        # 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],
@@ -1534,8 +1495,7 @@ module Google
         # @return [String]
         attr_accessor :requisition_id
       
-        # Optional.
-        # A description of job responsibilities. The use of this field is
+        # 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
@@ -1545,15 +1505,13 @@ module Google
         # @return [String]
         attr_accessor :responsibilities
       
-        # Required.
-        # The title of the job, such as "Software Engineer"
+        # 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
       
-        # Optional.
-        # The visibility of the job.
+        # Optional. The visibility of the job.
         # Defaults to Visibility.ACCOUNT_ONLY if not specified.
         # Corresponds to the JSON property `visibility`
         # @return [String]
@@ -1631,8 +1589,7 @@ module Google
       class JobEvent
         include Google::Apis::Core::Hashable
       
-        # Required.
-        # The job name(s) associated with this event.
+        # 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
@@ -1641,8 +1598,7 @@ module Google
         # @return [Array<String>]
         attr_accessor :jobs
       
-        # Required.
-        # The type of the event (see JobEventType).
+        # Required. The type of the event (see JobEventType).
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type
@@ -1669,8 +1625,7 @@ module Google
         # @return [Google::Apis::JobsV3p1beta1::CommuteFilter]
         attr_accessor :commute_filter
       
-        # Optional.
-        # This filter specifies the exact company display
+        # 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.
@@ -1681,8 +1636,7 @@ module Google
         # @return [Array<String>]
         attr_accessor :company_display_names
       
-        # Optional.
-        # This filter specifies the company entities to search against.
+        # 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
@@ -1700,8 +1654,7 @@ module Google
         # @return [Google::Apis::JobsV3p1beta1::CompensationFilter]
         attr_accessor :compensation_filter
       
-        # Optional.
-        # This filter specifies a structured syntax to match against the
+        # 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
@@ -1714,7 +1667,7 @@ module Google
         # 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 < 3000 bytes in length.
+        # must be < 6000 bytes in length.
         # Sample Query:
         # `(LOWER(driving_license)="class \"a\"" OR EMPTY(driving_license)) AND
         # driving_years > 10`
@@ -1722,8 +1675,7 @@ module Google
         # @return [String]
         attr_accessor :custom_attribute_filter
       
-        # Optional.
-        # This flag controls the spell-check feature. If false, the
+        # 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.
@@ -1732,8 +1684,7 @@ module Google
         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
+        # 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.
@@ -1743,15 +1694,15 @@ module Google
         # @return [Array<String>]
         attr_accessor :employment_types
       
-        # Optional.
-        # This filter specifies a list of job names to be excluded during search.
+        # Optional. This filter specifies a list of job names to be excluded during
+        # 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.
+        # 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
@@ -1760,8 +1711,7 @@ module Google
         # @return [Array<String>]
         attr_accessor :job_categories
       
-        # Optional.
-        # This filter specifies the locale of jobs to search against,
+        # 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.
@@ -1773,8 +1723,7 @@ module Google
         # @return [Array<String>]
         attr_accessor :language_codes
       
-        # Optional.
-        # The location filter specifies geo-regions containing the jobs to
+        # 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.
@@ -1792,8 +1741,8 @@ module Google
         # @return [Google::Apis::JobsV3p1beta1::TimestampRange]
         attr_accessor :publish_time_range
       
-        # Optional.
-        # The query string that matches against the job title, description, and
+        # Optional. The query string that matches against the job title, description,
+        # and
         # location fields.
         # The maximum number of allowed characters is 255.
         # Corresponds to the JSON property `query`
@@ -1950,7 +1899,7 @@ module Google
         # existing data, depending on the type of process.
         # Advice on address input / editing:
         # - Use an i18n-ready address widget such as
-        # https://github.com/googlei18n/libaddressinput)
+        # 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:
@@ -1986,14 +1935,13 @@ module Google
       class LocationFilter
         include Google::Apis::Core::Hashable
       
-        # Optional.
-        # The address name, such as "Mountain View" or "Bay Area".
+        # Optional. The address name, such as "Mountain View" or "Bay Area".
         # Corresponds to the JSON property `address`
         # @return [String]
         attr_accessor :address
       
-        # Optional.
-        # The distance_in_miles is applied when the location being searched for is
+        # 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.
         # Corresponds to the JSON property `distanceInMiles`
@@ -2009,8 +1957,7 @@ module Google
         # @return [Google::Apis::JobsV3p1beta1::LatLng]
         attr_accessor :lat_lng
       
-        # Optional.
-        # CLDR region code of the country/region of the address. This is used
+        # 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,
@@ -2022,8 +1969,7 @@ module Google
         # @return [String]
         attr_accessor :region_code
       
-        # Optional.
-        # Allows the client to return jobs without a
+        # 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.
@@ -2151,8 +2097,7 @@ module Google
       class NumericBucketingOption
         include Google::Apis::Core::Hashable
       
-        # Required.
-        # Two adjacent values form a histogram bucket. Values should be in
+        # 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.
@@ -2160,8 +2105,7 @@ module Google
         # @return [Array<Float>]
         attr_accessor :bucket_bounds
       
-        # Optional.
-        # If set to true, the histogram result includes minimum/maximum
+        # Optional. If set to true, the histogram result includes minimum/maximum
         # value of the numeric field.
         # Corresponds to the JSON property `requiresMinMax`
         # @return [Boolean]
@@ -2287,7 +2231,7 @@ module Google
       # existing data, depending on the type of process.
       # Advice on address input / editing:
       # - Use an i18n-ready address widget such as
-      # https://github.com/googlei18n/libaddressinput)
+      # 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:
@@ -2427,16 +2371,14 @@ module Google
       class ProcessingOptions
         include Google::Apis::Core::Hashable
       
-        # Optional.
-        # If set to `true`, the service does not attempt to resolve a
+        # 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:
+        # Optional. Option for job HTML content sanitization. Applied fields are:
         # * description
         # * applicationInfo.instruction
         # * incentives
@@ -2474,8 +2416,8 @@ module Google
         # @return [Google::Apis::JobsV3p1beta1::DeviceInfo]
         attr_accessor :device_info
       
-        # Required.
-        # The client-defined scope or source of the service call, which typically
+        # 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
@@ -2490,8 +2432,7 @@ module Google
         # @return [String]
         attr_accessor :domain
       
-        # Required.
-        # A unique session identification string. A session is defined as the
+        # 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
@@ -2504,8 +2445,7 @@ module Google
         # @return [String]
         attr_accessor :session_id
       
-        # Required.
-        # A unique user identification string, as determined by the client.
+        # 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
@@ -2563,8 +2503,7 @@ module Google
         # @return [Google::Apis::JobsV3p1beta1::CustomRankingInfo]
         attr_accessor :custom_ranking_info
       
-        # Optional.
-        # Controls whether to disable exact keyword match on Job.job_title,
+        # 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
@@ -2585,8 +2524,8 @@ module Google
         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
+        # 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
@@ -2598,8 +2537,8 @@ module Google
         # @return [String]
         attr_accessor :diversification_level
       
-        # Optional.
-        # Controls whether to broaden the search when it produces sparse results.
+        # 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.
@@ -2614,8 +2553,7 @@ module Google
         # @return [Google::Apis::JobsV3p1beta1::HistogramFacets]
         attr_accessor :histogram_facets
       
-        # Optional.
-        # Expression based histogram requests for jobs matching JobQuery.
+        # Optional. Expression based histogram requests for jobs matching JobQuery.
         # Corresponds to the JSON property `histogramQueries`
         # @return [Array<Google::Apis::JobsV3p1beta1::HistogramQuery>]
         attr_accessor :histogram_queries
@@ -2626,15 +2564,14 @@ module Google
         # @return [Google::Apis::JobsV3p1beta1::JobQuery]
         attr_accessor :job_query
       
-        # Optional.
-        # The desired job attributes returned for jobs in the
+        # 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
+        # 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.
         # For example, 0 means to  return results starting from the first matching
@@ -2645,8 +2582,7 @@ module Google
         # @return [Fixnum]
         attr_accessor :offset
       
-        # Optional.
-        # The criteria determining how search results are sorted. Default is
+        # 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
@@ -2698,16 +2634,14 @@ module Google
         # @return [String]
         attr_accessor :order_by
       
-        # Optional.
-        # A limit on the number of jobs returned in the search results.
+        # Optional. A limit on the number of jobs returned in the search results.
         # Increasing this value above the default value of 10 can increase search
         # response time. The value can be between 1 and 100.
         # Corresponds to the JSON property `pageSize`
         # @return [Fixnum]
         attr_accessor :page_size
       
-        # Optional.
-        # The token specifying the current offset within
+        # 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`
@@ -2722,8 +2656,7 @@ module Google
         # @return [Google::Apis::JobsV3p1beta1::RequestMetadata]
         attr_accessor :request_metadata
       
-        # Optional.
-        # Controls if the search job request requires the return of a precise
+        # 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
@@ -2735,8 +2668,7 @@ module Google
         attr_accessor :require_precise_result_size
         alias_method :require_precise_result_size?, :require_precise_result_size
       
-        # Optional.
-        # Mode of a search.
+        # Optional. Mode of a search.
         # Defaults to SearchMode.JOB_SEARCH.
         # Corresponds to the JSON property `searchMode`
         # @return [String]