google-api-client 0.23.0 → 0.23.1

data/generated/google/apis/indexing_v3/representations.rb

@@ -0,0 +1,72 @@
+# Copyright 2015 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+require 'date'
+require 'google/apis/core/base_service'
+require 'google/apis/core/json_representation'
+require 'google/apis/core/hashable'
+require 'google/apis/errors'
+
+module Google
+  module Apis
+    module IndexingV3
+      
+      class PublishUrlNotificationResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class UrlNotification
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class UrlNotificationMetadata
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class PublishUrlNotificationResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :url_notification_metadata, as: 'urlNotificationMetadata', class: Google::Apis::IndexingV3::UrlNotificationMetadata, decorator: Google::Apis::IndexingV3::UrlNotificationMetadata::Representation
+      
+        end
+      end
+      
+      class UrlNotification
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :notify_time, as: 'notifyTime'
+          property :type, as: 'type'
+          property :url, as: 'url'
+        end
+      end
+      
+      class UrlNotificationMetadata
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :latest_remove, as: 'latestRemove', class: Google::Apis::IndexingV3::UrlNotification, decorator: Google::Apis::IndexingV3::UrlNotification::Representation
+      
+          property :latest_update, as: 'latestUpdate', class: Google::Apis::IndexingV3::UrlNotification, decorator: Google::Apis::IndexingV3::UrlNotification::Representation
+      
+          property :url, as: 'url'
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,122 @@
+# Copyright 2015 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+require 'google/apis/core/base_service'
+require 'google/apis/core/json_representation'
+require 'google/apis/core/hashable'
+require 'google/apis/errors'
+
+module Google
+  module Apis
+    module IndexingV3
+      # Indexing API
+      #
+      # The Indexing API allows developers to share the life cycle of a Web Document
+      #  with Google.
+      #
+      # @example
+      #    require 'google/apis/indexing_v3'
+      #
+      #    Indexing = Google::Apis::IndexingV3 # Alias the module
+      #    service = Indexing::IndexingService.new
+      #
+      # @see https://developers.google.com/search/apis/indexing-api/
+      class IndexingService < Google::Apis::Core::BaseService
+        # @return [String]
+        #  API key. Your API key identifies your project and provides you with API access,
+        #  quota, and reports. Required unless you provide an OAuth 2.0 token.
+        attr_accessor :key
+
+        # @return [String]
+        #  Available to use for quota purposes for server-side applications. Can be any
+        #  arbitrary string assigned to a user, but should not exceed 40 characters.
+        attr_accessor :quota_user
+
+        def initialize
+          super('https://indexing.googleapis.com/', '')
+          @batch_path = 'batch'
+        end
+        
+        # Gets metadata about a Web Document. This method can _only_ be used to query
+        # URLs that were previously seen in successful Indexing API notifications.
+        # Includes the latest `UrlNotification` received via this API.
+        # @param [String] url
+        #   URL that is being queried.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::IndexingV3::UrlNotificationMetadata] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::IndexingV3::UrlNotificationMetadata]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def get_url_notification_metadata(url: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:get, 'v3/urlNotifications/metadata', options)
+          command.response_representation = Google::Apis::IndexingV3::UrlNotificationMetadata::Representation
+          command.response_class = Google::Apis::IndexingV3::UrlNotificationMetadata
+          command.query['url'] = url unless url.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Notifies that a URL has been updated or deleted.
+        # @param [Google::Apis::IndexingV3::UrlNotification] url_notification_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::IndexingV3::PublishUrlNotificationResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::IndexingV3::PublishUrlNotificationResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def publish_url_notification(url_notification_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:post, 'v3/urlNotifications:publish', options)
+          command.request_representation = Google::Apis::IndexingV3::UrlNotification::Representation
+          command.request_object = url_notification_object
+          command.response_representation = Google::Apis::IndexingV3::PublishUrlNotificationResponse::Representation
+          command.response_class = Google::Apis::IndexingV3::PublishUrlNotificationResponse
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+
+        protected
+
+        def apply_command_defaults(command)
+          command.query['key'] = key unless key.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+        end
+      end
+    end
+  end
+end

data/generated/google/apis/jobs_v2.rb

@@ -26,7 +26,7 @@ module Google
     # @see https://cloud.google.com/job-discovery/docs
     module JobsV2
       VERSION = 'V2'
-      REVISION = '20180514'
+      REVISION = '20180627'
 
       # 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_v2/classes.rb

@@ -251,6 +251,7 @@ module Google
         # and "Google", which the client wishes to use as the company displayed on
         # the job. Best practice is to create a distinct company identifier for each
         # distinct brand displayed.
+        # The maximum number of allowed characters is 255.
         # Corresponds to the JSON property `distributorCompanyId`
         # @return [String]
         attr_accessor :distributor_company_id
@@ -295,7 +296,9 @@ module Google
         # 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.
+        # of the values matches the search keyword. Custom field values with
+        # parenthesis, brackets and special symbols might not be properly searchable,
+        # and those keyword queries need to be surrounded by quotes.
         # Corresponds to the JSON property `keywordSearchableCustomAttributes`
         # @return [Array<String>]
         attr_accessor :keyword_searchable_custom_attributes
@@ -304,7 +307,9 @@ module Google
         # Optional.
         # A list of filterable custom fields that should be used in keyword
         # search. The jobs of this company are returned if any of these custom
-        # fields matches the search keyword.
+        # fields matches the search keyword. Custom field values with parenthesis,
+        # brackets and special symbols might not be properly searchable, and those
+        # keyword queries need to be surrounded by quotes.
         # Corresponds to the JSON property `keywordSearchableCustomFields`
         # @return [Array<Fixnum>]
         attr_accessor :keyword_searchable_custom_fields
@@ -512,7 +517,7 @@ module Google
         attr_accessor :type
       
         # Required.
-        # Specify desired ** base compensation entry's **
+        # Specify desired `base compensation entry's`
         # CompensationInfo.CompensationUnit.
         # Corresponds to the JSON property `units`
         # @return [Array<String>]
@@ -811,10 +816,10 @@ module Google
         include Google::Apis::Core::Hashable
       
         # Required.
-        # Specifies the custom field key to perform a histogram on. If
-        # specified without `long_value_buckets` or `long_value_min_max`, a
-        # histogram on string values of the given `key` is triggered,
-        # otherwise histogram is performed on long values.
+        # 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.
         # Corresponds to the JSON property `key`
         # @return [String]
         attr_accessor :key
@@ -1003,7 +1008,7 @@ module Google
       end
       
       # Input only.
-      # Device information collected from the job searcher, candidate, or
+      # Device information collected from the job seeker, candidate, or
       # other entity conducting the job search. Providing this information improves
       # the quality of the search results across devices.
       class DeviceInfo
@@ -1016,7 +1021,7 @@ module Google
         attr_accessor :device_type
       
         # Optional.
-        # A device-specific ID. It must be a unique identifier, which distinguishes
+        # 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]
@@ -1065,7 +1070,7 @@ module Google
         attr_accessor :compensation_range
       
         # Required.
-        # Specify desired ** base compensation entry's **
+        # Specify desired `base compensation entry's`
         # ExtendedCompensationInfo.CompensationUnit.
         # Corresponds to the JSON property `compensationUnits`
         # @return [Array<String>]
@@ -1429,19 +1434,19 @@ module Google
       
         # Optional.
         # Specifies compensation field-based histogram requests.
-        # Duplicate CompensationHistogramRequest.types are not allowed.
+        # Duplicate values of CompensationHistogramRequest.type are not allowed.
         # Corresponds to the JSON property `compensationHistogramFacets`
         # @return [Array<Google::Apis::JobsV2::CompensationHistogramRequest>]
         attr_accessor :compensation_histogram_facets
       
         # Optional.
         # Specifies the custom attributes histogram requests.
-        # Duplicate CustomAttributeHistogramRequest.keys are not allowed.
+        # Duplicate values of CustomAttributeHistogramRequest.key are not allowed.
         # Corresponds to the JSON property `customAttributeHistogramFacets`
         # @return [Array<Google::Apis::JobsV2::CustomAttributeHistogramRequest>]
         attr_accessor :custom_attribute_histogram_facets
       
-        # Optional. Specifies the simple type of histogram facets, e.g,
+        # Optional. Specifies the simple type of histogram facets, for example,
         # `COMPANY_SIZE`, `EMPLOYMENT_TYPE` etc. This field is equivalent to
         # GetHistogramRequest.
         # Corresponds to the JSON property `simpleHistogramFacets`
@@ -1645,7 +1650,7 @@ module Google
       
         # Optional but one of company_name or distributor_company_id must be
         # provided.
-        # A unique company identifier that used by job distributors to identify an
+        # A unique company identifier used by job distributors to identify an
         # employer's company entity. company_name takes precedence over
         # this field, and is the recommended field to use to identify companies.
         # The maximum number of allowed characters is 255.
@@ -1679,15 +1684,15 @@ module Google
         # @return [Google::Apis::JobsV2::Date]
         attr_accessor :end_date
       
-        # Optional but strongly recommended to be provided for the best service
+        # Optional but strongly recommended for the best service
         # experience.
         # The expiration timestamp of the job. After this timestamp, the
         # job is marked as expired, and it no longer appears in search results. The
         # expired job can't be deleted or listed by the DeleteJob and
         # ListJobs APIs, but it can be retrieved with the GetJob API or
         # updated with the UpdateJob API. An expired job can be updated and
-        # opened again by using a future expiration timestamp. It can also remain
-        # expired. Updating an expired job to be open fails if there is another
+        # opened again by using a future expiration timestamp. Updating an expired job
+        # fails if there is another
         # existing open job with same requisition_id, company_name and
         # language_code.
         # The expired jobs are retained in our system for 90 days. However, the
@@ -1702,7 +1707,8 @@ module Google
         # A valid date range is between 1970-01-01T00:00:00.0Z and
         # 2100-12-31T23:59:59.999Z. Invalid dates are ignored and treated as expire
         # time not provided.
-        # If this value is not provided on job creation or invalid, the job posting
+        # If this value is not provided at the time of job creation or is invalid, the
+        # job posting
         # expires after 30 days from the job's creation time. For example, if the
         # job was created on 2017/01/01 13:00AM UTC with an unspecified expiration
         # date, the job expires after 2017/01/31 13:00AM UTC.
@@ -1778,7 +1784,8 @@ module Google
         # any requirements for fluency that are associated with the job.
         # Language codes must be in BCP-47 format, such as "en-US" or "sr-Latn".
         # For more information, see
-        # [Tags for Identifying Languages](https://tools.ietf.org/html/bcp47).
+        # [Tags for Identifying Languages](https://tools.ietf.org/html/bcp47)`: class="
+        # external" target="_blank" `.
         # The default value is `en-US`.
         # Corresponds to the JSON property `languageCode`
         # @return [String]
@@ -1790,12 +1797,10 @@ module Google
         # @return [String]
         attr_accessor :level
       
-        # Optional but strongly recommended to be provided for the best service
-        # experience.
-        # Location(s) where the job is hiring.
-        # Providing the full street address(es) of the hiring
-        # location is recommended to enable better API results, including
-        # job searches by commute time.
+        # Optional but strongly recommended for the best service experience.
+        # Location(s) where the emploeyer is looking to hire for this job posting.
+        # Specifying the full street address(es) of the hiring location enables
+        # better API results, especially job searches by commute time.
         # At most 50 locations are allowed for best search performance. If a job has
         # more locations, it is suggested to split it into multiple jobs with unique
         # requisition_ids (e.g. 'ReqA' becomes 'ReqA-1', 'ReqA-2', etc.) as
@@ -1873,7 +1878,7 @@ module Google
         # for client identification and tracking of listings. A job is not allowed
         # to be created if there is another job with the same requisition_id,
         # company_name and language_code.
-        # The maximum number of allowed characters is 225.
+        # The maximum number of allowed characters is 255.
         # Corresponds to the JSON property `requisitionId`
         # @return [String]
         attr_accessor :requisition_id
@@ -2086,9 +2091,9 @@ module Google
         # Optional.
         # This filter specifies the locale of jobs to search against,
         # for example, "en-US".
-        # If a value is not specified, the search results can contain jobs in any
+        # If a value is not specified, the search results may contain jobs in any
         # locale.
-        # Language codes should be in BCP-47 format, such as "en-US" or "sr-Latn".
+        # Language codes should be in BCP-47 format, for example, "en-US" or "sr-Latn".
         # For more information, see
         # [Tags for Identifying Languages](https://tools.ietf.org/html/bcp47).
         # At most 10 language code filters are allowed.
@@ -2114,7 +2119,7 @@ module Google
         # Jobs published within a range specified by this filter are searched
         # against, for example, DateRange.PAST_MONTH. If a value is not
         # specified, all open jobs are searched against regardless of the
-        # date on which they were published.
+        # date they were published.
         # Corresponds to the JSON property `publishDateRange`
         # @return [String]
         attr_accessor :publish_date_range
@@ -2122,15 +2127,15 @@ module Google
         # Optional.
         # The query filter contains the keywords that match against the job
         # title, description, and location fields.
-        # The maximum query size is 255 bytes.
+        # The maximum query size is 255 bytes/characters.
         # Corresponds to the JSON property `query`
         # @return [String]
         attr_accessor :query
       
-        # Optional.
+        # Deprecated. Do not use this field.
         # This flag controls whether the job search should be restricted to jobs
         # owned by the current user.
-        # Defaults to false that all jobs accessible to the
+        # Defaults to false where all jobs accessible to the
         # user are searched against.
         # Corresponds to the JSON property `tenantJobOnly`
         # @return [Boolean]
@@ -2247,8 +2252,8 @@ module Google
       
         # Optional.
         # This filter specifies the exact company display
-        # name of jobs to search against.
-        # If a value is not specified, jobs within the search results can be
+        # name of the jobs to search against.
+        # If a value isn't specified, jobs within the search results are
         # associated with any company.
         # If multiple values are specified, jobs within the search results may be
         # associated with any of the specified companies.
@@ -2258,12 +2263,11 @@ module Google
         attr_accessor :company_display_names
       
         # Optional.
-        # The company names filter specifies the company entities to search
-        # against.
-        # If a value is not specified, jobs are searched for against all
+        # 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
-        # specified companies.
+        # companies specified.
         # At most 20 company filters are allowed.
         # Corresponds to the JSON property `companyNames`
         # @return [Array<String>]
@@ -2277,7 +2281,7 @@ module Google
       
         # Optional.
         # This filter specifies a structured syntax to match against the
-        # Job.custom_attributes that are marked as `filterable`.
+        # Job.custom_attributes marked as `filterable`.
         # The syntax for this expression is a subset of Google SQL syntax.
         # Supported operators are: =, !=, <, <=, >, >= where the left of the operator
         # is a custom field key and the right of the operator is a number or string
@@ -2286,8 +2290,8 @@ module Google
         # perform case insensitive match and EMPTY(<field_name>) to filter on the
         # existence of a key.
         # Boolean expressions (AND/OR/NOT) are supported up to 3 levels of
-        # nesting (for example, "((A AND B AND C) OR NOT D) AND E"), and there can
-        # be a maximum of 50 comparisons/functions in the expression. The expression
+        # nesting (for example, "((A AND B AND C) OR NOT D) AND E"), a maximum of 50
+        # comparisons/functions are allowed in the expression. The expression
         # must be < 2000 characters in length.
         # Sample Query:
         # (key1 = "TEST" OR LOWER(key1)="test" OR NOT EMPTY(key1)) AND key2 > 100
@@ -2308,7 +2312,7 @@ module Google
         # 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 will include any
+        # If a value is not specified, jobs in the search results include any
         # employment type.
         # If multiple values are specified, jobs in the search results include
         # any of the specified employment types.
@@ -2319,7 +2323,7 @@ module Google
         # Optional.
         # This filter specifies the locale of jobs to search against,
         # for example, "en-US".
-        # If a value is not specified, the search results can contain jobs in any
+        # If a value isn't specified, the search results can contain jobs in any
         # locale.
         # Language codes should be in BCP-47 format, such as "en-US" or "sr-Latn".
         # For more information, see
@@ -2332,7 +2336,7 @@ module Google
         # Optional.
         # The location filter specifies geo-regions containing the jobs to
         # search against. See LocationFilter for more information.
-        # If a location value is not specified, jobs that fit the other search
+        # If a location value isn't specified, jobs fitting the other search
         # criteria are retrieved regardless of where they're located.
         # If multiple values are specified, jobs are retrieved from any of the
         # specified locations, and, if different values are specified
@@ -2345,9 +2349,9 @@ module Google
       
         # Optional.
         # Jobs published within a range specified by this filter are searched
-        # against, for example, DateRange.PAST_MONTH. If a value is not
-        # specified, all open jobs are searched against regardless of the
-        # date on which they were published.
+        # against, for example, DateRange.PAST_MONTH. If a value isn't
+        # specified, all open jobs are searched against regardless of their
+        # published date.
         # Corresponds to the JSON property `publishDateRange`
         # @return [String]
         attr_accessor :publish_date_range
@@ -2360,16 +2364,6 @@ module Google
         # @return [String]
         attr_accessor :query
       
-        # Optional.
-        # This flag controls whether the job search should be restricted to jobs
-        # owned by the current user.
-        # Defaults to false: all jobs accessible to the
-        # user are searched against.
-        # Corresponds to the JSON property `tenantJobOnly`
-        # @return [Boolean]
-        attr_accessor :tenant_job_only
-        alias_method :tenant_job_only?, :tenant_job_only
-      
         def initialize(**args)
            update!(**args)
         end
@@ -2388,7 +2382,6 @@ module Google
           @location_filters = args[:location_filters] if args.key?(:location_filters)
           @publish_date_range = args[:publish_date_range] if args.key?(:publish_date_range)
           @query = args[:query] if args.key?(:query)
-          @tenant_job_only = args[:tenant_job_only] if args.key?(:tenant_job_only)
         end
       end
       
@@ -2542,8 +2535,9 @@ module Google
         include Google::Apis::Core::Hashable
       
         # Optional.
-        # The distance from the address in miles to search.
-        # The default distance is 20 miles and maximum distance is 5,000 miles.
+        # 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`
         # @return [Float]
         attr_accessor :distance_in_miles
@@ -2633,8 +2627,8 @@ module Google
         # @return [String]
         attr_accessor :job_summary
       
-        # Contains snippets of text from the Job.job_title field that most
-        # closely match a search query's keywords, if available. The matching query
+        # Contains snippets of text from the Job.job_title field most
+        # closely matching a search query's keywords, if available. The matching query
         # keywords are enclosed in HTML bold tags.
         # Corresponds to the JSON property `jobTitleSnippet`
         # @return [String]
@@ -2919,7 +2913,7 @@ module Google
         include Google::Apis::Core::Hashable
       
         # Input only.
-        # Device information collected from the job searcher, candidate, or
+        # Device information collected from the job seeker, candidate, or
         # other entity conducting the job search. Providing this information improves
         # the quality of the search results across devices.
         # Corresponds to the JSON property `deviceInfo`
@@ -2934,7 +2928,9 @@ module Google
         # job board www.foo.com and career site www.bar.com, then this field is
         # set to "foo.com" for use on the job board, and "bar.com" for use on the
         # career site.
-        # If this field is not available for some reason, please send "UNKNOWN".
+        # If this field is not available for some reason, send "UNKNOWN". Note that
+        # any improvements to the service model for a particular tenant site rely on
+        # this field being set correctly to some domain.
         # Corresponds to the JSON property `domain`
         # @return [String]
         attr_accessor :domain
@@ -2944,7 +2940,9 @@ module Google
         # duration of an end user's interaction with the service over a period.
         # Obfuscate this field for privacy concerns before
         # providing it to the API.
-        # If this field is not available for some reason, please send "UNKNOWN".
+        # If this field is not available for some reason, please send "UNKNOWN". Note
+        # that any improvements to the service model for a particular tenant site,
+        # rely on this field being set correctly to some unique session_id.
         # Corresponds to the JSON property `sessionId`
         # @return [String]
         attr_accessor :session_id
@@ -2955,7 +2953,9 @@ module Google
         # in order to have the strongest positive impact on search quality.
         # Obfuscate this field for privacy concerns before
         # providing it to the service.
-        # If this field is not available for some reason, please send "UNKNOWN".
+        # If this field is not available for some reason, please send "UNKNOWN". Note
+        # that any improvements to the service model for a particular tenant site,
+        # rely on this field being set correctly to some unique user_id.
         # Corresponds to the JSON property `userId`
         # @return [String]
         attr_accessor :user_id
@@ -3015,7 +3015,7 @@ module Google
       class SearchJobsRequest
         include Google::Apis::Core::Hashable
       
-        # Deprecated. Any value provided in this field will be ignored.
+        # Deprecated. Any value provided in this field is ignored.
         # Optional.
         # Controls whether to disable relevance thresholding. Relevance
         # thresholding removes jobs that have low relevance in search results,
@@ -3066,7 +3066,7 @@ module Google
         attr_accessor :histogram_facets
       
         # Optional.
-        # The number of job attributes that is returned for jobs in the
+        # The number of 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]
@@ -3079,7 +3079,8 @@ module Google
         attr_accessor :mode
       
         # Optional.
-        # An integer that specifies the current offset (i.e. starting result) in
+        # 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
         # job, and 10 means to return from the 11th job. This can be used for
@@ -3091,7 +3092,7 @@ module Google
       
         # Deprecated. Use sort_by instead.
         # Optional.
-        # The criteria that determine how search results are sorted.
+        # The criteria determining how search results are sorted.
         # Defaults to SortBy.RELEVANCE_DESC if no value is specified.
         # Corresponds to the JSON property `orderBy`
         # @return [String]
@@ -3106,7 +3107,7 @@ module Google
         attr_accessor :page_size
       
         # Optional.
-        # The token that specifies the current offset within
+        # 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`
@@ -3128,7 +3129,7 @@ module Google
         attr_accessor :request_metadata
       
         # Optional.
-        # The criteria that determine how search results are sorted.
+        # The criteria determining how search results are sorted.
         # Defaults to SortBy.RELEVANCE_DESC if no value is specified.
         # Corresponds to the JSON property `sortBy`
         # @return [String]