google-api-client 0.30.6 → 0.30.7

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

@@ -80,8 +80,7 @@ module Google
         
         # Deletes the specified company.
         # @param [String] name
-        #   Required.
-        #   The resource name of the company to be deleted,
+        #   Required. The resource name of the company to be deleted,
         #   such as, "companies/0000aaaa-1111-bbbb-2222-cccc3333dddd".
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -112,8 +111,7 @@ module Google
         
         # Retrieves the specified company.
         # @param [String] name
-        #   Required.
-        #   Resource name of the company to retrieve,
+        #   Required. Resource name of the company to retrieve,
         #   such as "companies/0000aaaa-1111-bbbb-2222-cccc3333dddd".
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -144,18 +142,15 @@ module Google
         
         # Lists all companies associated with a Cloud Talent Solution account.
         # @param [Boolean] must_have_open_jobs
-        #   Optional.
-        #   Set to true if the companies request must have open jobs.
+        #   Optional. Set to true if the companies request 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 [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 [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -246,12 +241,11 @@ module Google
         # Deprecated. Use ListJobs instead.
         # Lists all jobs associated with a company.
         # @param [String] company_name
-        #   Required.
-        #   The resource name of the company that owns the jobs to be listed,
+        #   Required. The resource name of the company that owns the jobs to be listed,
         #   such as, "companies/0000aaaa-1111-bbbb-2222-cccc3333dddd".
         # @param [Boolean] ids_only
-        #   Optional.
-        #   If set to `true`, only job ID, job requisition ID and language code will be
+        #   Optional. If set to `true`, only job ID, job requisition ID and language code
+        #   will be
         #   returned.
         #   A typical use is to synchronize job repositories.
         #   Defaults to false.
@@ -262,19 +256,17 @@ module Google
         #   Set to true if the total number of open jobs is to be returned.
         #   Defaults to false.
         # @param [String] job_requisition_id
-        #   Optional.
-        #   The requisition ID, also known as posting ID, assigned by the company
+        #   Optional. The requisition ID, also known as posting ID, assigned by the
+        #   company
         #   to the job.
         #   The maximum number of allowable characters is 225.
         # @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 ids_only is set to true, 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
@@ -373,8 +365,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, such as "jobs/11111111".
+        #   Required. The resource name of the job to be deleted, such as "jobs/11111111".
         # @param [Boolean] disable_fast_process
         #   Deprecated. This field is not working anymore.
         #   Optional.
@@ -445,8 +436,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, such as "jobs/11111111".
+        #   Required. The resource name of the job to retrieve, such as "jobs/11111111".
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -516,8 +506,7 @@ module Google
         
         # Lists jobs by filter.
         # @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)
@@ -526,20 +515,17 @@ module Google
         #   * companyName = "companies/123"
         #   * companyName = "companies/123" AND requisitionId = "req-1"
         # @param [Boolean] ids_only
-        #   Optional.
-        #   If set to `true`, only Job.name, Job.requisition_id and
+        #   Optional. If set to `true`, only Job.name, Job.requisition_id and
         #   Job.language_code will be returned.
         #   A typical use case is to synchronize job repositories.
         #   Defaults to false.
         # @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 ids_only is set to true, 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
@@ -681,11 +667,9 @@ module Google
         # Completes the specified prefix with job keyword suggestions.
         # Intended for use by a job search auto-complete search box.
         # @param [String] company_name
-        #   Optional.
-        #   If provided, restricts completion to the specified company.
+        #   Optional. If provided, restricts completion to the specified company.
         # @param [String] language_code
-        #   Required.
-        #   The language of the query. This is
+        #   Required. 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).
@@ -698,18 +682,14 @@ module Google
         #   language_code or companies having open jobs with same
         #   language_code are returned.
         # @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.
         # @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

data/generated/google/apis/jobs_v3.rb

@@ -26,7 +26,7 @@ module Google
     # @see https://cloud.google.com/talent-solution/job-search/docs/
     module JobsV3
       VERSION = 'V3'
-      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_v3/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::JobsV3::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::JobsV3::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::JobsV3::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::JobsV3::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::JobsV3::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::JobsV3::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::JobsV3::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::JobsV3::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::JobsV3::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.
@@ -953,14 +930,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]
@@ -1001,23 +976,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::JobsV3::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::JobsV3::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>]
@@ -1136,8 +1108,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]
@@ -1148,8 +1119,8 @@ module Google
         # @return [Google::Apis::JobsV3::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
@@ -1163,14 +1134,13 @@ module Google
         # @return [Hash<String,Google::Apis::JobsV3::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`
@@ -1183,8 +1153,8 @@ module Google
         # @return [Google::Apis::JobsV3::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
@@ -1196,50 +1166,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
@@ -1299,16 +1264,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.
@@ -1330,8 +1294,7 @@ module Google
         # @return [Google::Apis::JobsV3::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
@@ -1341,8 +1304,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
@@ -1352,8 +1314,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],
@@ -1363,8 +1325,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
@@ -1374,15 +1335,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]
@@ -1460,8 +1419,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
@@ -1470,8 +1428,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
@@ -1498,8 +1455,7 @@ module Google
         # @return [Google::Apis::JobsV3::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.
@@ -1510,8 +1466,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
@@ -1529,8 +1484,7 @@ module Google
         # @return [Google::Apis::JobsV3::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
@@ -1543,7 +1497,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`
@@ -1551,8 +1505,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.
@@ -1561,8 +1514,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.
@@ -1572,8 +1524,8 @@ module Google
         # @return [Array<String>]
         attr_accessor :employment_types
       
-        # 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
@@ -1582,8 +1534,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.
@@ -1595,8 +1546,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.
@@ -1614,8 +1564,8 @@ module Google
         # @return [Google::Apis::JobsV3::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`
@@ -1771,7 +1721,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:
@@ -1807,14 +1757,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`
@@ -1830,8 +1779,7 @@ module Google
         # @return [Google::Apis::JobsV3::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,
@@ -1843,8 +1791,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.
@@ -1972,8 +1919,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.
@@ -1981,8 +1927,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]
@@ -2044,7 +1989,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:
@@ -2184,16 +2129,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
@@ -2231,8 +2174,8 @@ module Google
         # @return [Google::Apis::JobsV3::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
@@ -2247,8 +2190,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
@@ -2261,8 +2203,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
@@ -2314,8 +2255,7 @@ module Google
       class SearchJobsRequest
         include Google::Apis::Core::Hashable
       
-        # 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
@@ -2336,8 +2276,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
@@ -2349,8 +2289,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.
@@ -2371,15 +2311,14 @@ module Google
         # @return [Google::Apis::JobsV3::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
@@ -2390,8 +2329,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
@@ -2423,16 +2361,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`
@@ -2447,8 +2383,7 @@ module Google
         # @return [Google::Apis::JobsV3::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
@@ -2460,8 +2395,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]