google-api-client 0.42.2 → 0.45.0

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

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

data/generated/google/apis/kgsearch_v1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://developers.google.com/knowledge-graph/
     module KgsearchV1
       VERSION = 'V1'
-      REVISION = '20200210'
+      REVISION = '20200809'
     end
   end
 end

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

@@ -22,13 +22,13 @@ module Google
   module Apis
     module KgsearchV1
       
-      # Response message includes the context and a list of matching results
-      # which contain the detail of associated entities.
+      # Response message includes the context and a list of matching results which
+      # contain the detail of associated entities.
       class SearchResponse
         include Google::Apis::Core::Hashable
       
-        # The local context applicable for the response. See more details at
-        # http://www.w3.org/TR/json-ld/#context-definitions.
+        # The local context applicable for the response. See more details at http://www.
+        # w3.org/TR/json-ld/#context-definitions.
         # Corresponds to the JSON property `@context`
         # @return [Object]
         attr_accessor :_context

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

@@ -47,18 +47,18 @@ module Google
           @batch_path = 'batch'
         end
         
-        # Searches Knowledge Graph for entities that match the constraints.
-        # A list of matched entities will be returned in response, which will be in
-        # JSON-LD format and compatible with http://schema.org
+        # Searches Knowledge Graph for entities that match the constraints. A list of
+        # matched entities will be returned in response, which will be in JSON-LD format
+        # and compatible with http://schema.org
         # @param [Array<String>, String] ids
-        #   The list of entity id to be used for search instead of query string.
-        #   To specify multiple ids in the HTTP request, repeat the parameter in the
-        #   URL as in ...?ids=A&ids=B
+        #   The list of entity id to be used for search instead of query string. To
+        #   specify multiple ids in the HTTP request, repeat the parameter in the URL as
+        #   in ...?ids=A&ids=B
         # @param [Boolean] indent
         #   Enables indenting of json results.
         # @param [Array<String>, String] languages
-        #   The list of language codes (defined in ISO 693) to run the query with,
-        #   e.g. 'en'.
+        #   The list of language codes (defined in ISO 693) to run the query with, e.g. '
+        #   en'.
         # @param [Fixnum] limit
         #   Limits the number of entities to be returned.
         # @param [Boolean] prefix
@@ -66,9 +66,9 @@ module Google
         # @param [String] query
         #   The literal query string for search.
         # @param [Array<String>, String] types
-        #   Restricts returned entities with these types, e.g. Person
-        #   (as defined in http://schema.org/Person). If multiple types are specified,
-        #   returned entities will contain one or more of these types.
+        #   Restricts returned entities with these types, e.g. Person (as defined in http:/
+        #   /schema.org/Person). If multiple types are specified, returned entities will
+        #   contain one or more of these types.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user

data/generated/google/apis/language_v1.rb

@@ -27,7 +27,7 @@ module Google
     # @see https://cloud.google.com/natural-language/
     module LanguageV1
       VERSION = 'V1'
-      REVISION = '20200406'
+      REVISION = '20200801'
 
       # Apply machine learning models to reveal the structure and meaning of text
       AUTH_CLOUD_LANGUAGE = 'https://www.googleapis.com/auth/cloud-language'

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

@@ -26,8 +26,8 @@ module Google
       class AnalyzeEntitiesRequest
         include Google::Apis::Core::Hashable
       
-        # ################################################################ #
-        # Represents the input to API methods.
+        # ################################################################ # Represents
+        # the input to API methods.
         # Corresponds to the JSON property `document`
         # @return [Google::Apis::LanguageV1::Document]
         attr_accessor :document
@@ -57,9 +57,9 @@ module Google
         # @return [Array<Google::Apis::LanguageV1::Entity>]
         attr_accessor :entities
       
-        # The language of the text, which will be the same as the language specified
-        # in the request or, if not specified, the automatically-detected language.
-        # See Document.language field for more details.
+        # The language of the text, which will be the same as the language specified in
+        # the request or, if not specified, the automatically-detected language. See
+        # Document.language field for more details.
         # Corresponds to the JSON property `language`
         # @return [String]
         attr_accessor :language
@@ -79,8 +79,8 @@ module Google
       class AnalyzeEntitySentimentRequest
         include Google::Apis::Core::Hashable
       
-        # ################################################################ #
-        # Represents the input to API methods.
+        # ################################################################ # Represents
+        # the input to API methods.
         # Corresponds to the JSON property `document`
         # @return [Google::Apis::LanguageV1::Document]
         attr_accessor :document
@@ -110,9 +110,9 @@ module Google
         # @return [Array<Google::Apis::LanguageV1::Entity>]
         attr_accessor :entities
       
-        # The language of the text, which will be the same as the language specified
-        # in the request or, if not specified, the automatically-detected language.
-        # See Document.language field for more details.
+        # The language of the text, which will be the same as the language specified in
+        # the request or, if not specified, the automatically-detected language. See
+        # Document.language field for more details.
         # Corresponds to the JSON property `language`
         # @return [String]
         attr_accessor :language
@@ -132,8 +132,8 @@ module Google
       class AnalyzeSentimentRequest
         include Google::Apis::Core::Hashable
       
-        # ################################################################ #
-        # Represents the input to API methods.
+        # ################################################################ # Represents
+        # the input to API methods.
         # Corresponds to the JSON property `document`
         # @return [Google::Apis::LanguageV1::Document]
         attr_accessor :document
@@ -158,15 +158,14 @@ module Google
       class AnalyzeSentimentResponse
         include Google::Apis::Core::Hashable
       
-        # Represents the feeling associated with the entire text or entities in
-        # the text.
+        # Represents the feeling associated with the entire text or entities in the text.
         # Corresponds to the JSON property `documentSentiment`
         # @return [Google::Apis::LanguageV1::Sentiment]
         attr_accessor :document_sentiment
       
-        # The language of the text, which will be the same as the language specified
-        # in the request or, if not specified, the automatically-detected language.
-        # See Document.language field for more details.
+        # The language of the text, which will be the same as the language specified in
+        # the request or, if not specified, the automatically-detected language. See
+        # Document.language field for more details.
         # Corresponds to the JSON property `language`
         # @return [String]
         attr_accessor :language
@@ -192,8 +191,8 @@ module Google
       class AnalyzeSyntaxRequest
         include Google::Apis::Core::Hashable
       
-        # ################################################################ #
-        # Represents the input to API methods.
+        # ################################################################ # Represents
+        # the input to API methods.
         # Corresponds to the JSON property `document`
         # @return [Google::Apis::LanguageV1::Document]
         attr_accessor :document
@@ -218,9 +217,9 @@ module Google
       class AnalyzeSyntaxResponse
         include Google::Apis::Core::Hashable
       
-        # The language of the text, which will be the same as the language specified
-        # in the request or, if not specified, the automatically-detected language.
-        # See Document.language field for more details.
+        # The language of the text, which will be the same as the language specified in
+        # the request or, if not specified, the automatically-detected language. See
+        # Document.language field for more details.
         # Corresponds to the JSON property `language`
         # @return [String]
         attr_accessor :language
@@ -252,8 +251,8 @@ module Google
       class AnnotateTextRequest
         include Google::Apis::Core::Hashable
       
-        # ################################################################ #
-        # Represents the input to API methods.
+        # ################################################################ # Represents
+        # the input to API methods.
         # Corresponds to the JSON property `document`
         # @return [Google::Apis::LanguageV1::Document]
         attr_accessor :document
@@ -263,8 +262,8 @@ module Google
         # @return [String]
         attr_accessor :encoding_type
       
-        # All available features for sentiment, syntax, and semantic analysis.
-        # Setting each one to true will enable that specific analysis for the input.
+        # All available features for sentiment, syntax, and semantic analysis. Setting
+        # each one to true will enable that specific analysis for the input.
         # Corresponds to the JSON property `features`
         # @return [Google::Apis::LanguageV1::Features]
         attr_accessor :features
@@ -290,22 +289,20 @@ module Google
         # @return [Array<Google::Apis::LanguageV1::ClassificationCategory>]
         attr_accessor :categories
       
-        # Represents the feeling associated with the entire text or entities in
-        # the text.
+        # Represents the feeling associated with the entire text or entities in the text.
         # Corresponds to the JSON property `documentSentiment`
         # @return [Google::Apis::LanguageV1::Sentiment]
         attr_accessor :document_sentiment
       
         # Entities, along with their semantic information, in the input document.
-        # Populated if the user enables
-        # AnnotateTextRequest.Features.extract_entities.
+        # Populated if the user enables AnnotateTextRequest.Features.extract_entities.
         # Corresponds to the JSON property `entities`
         # @return [Array<Google::Apis::LanguageV1::Entity>]
         attr_accessor :entities
       
-        # The language of the text, which will be the same as the language specified
-        # in the request or, if not specified, the automatically-detected language.
-        # See Document.language field for more details.
+        # The language of the text, which will be the same as the language specified in
+        # the request or, if not specified, the automatically-detected language. See
+        # Document.language field for more details.
         # Corresponds to the JSON property `language`
         # @return [String]
         attr_accessor :language
@@ -317,8 +314,7 @@ module Google
         attr_accessor :sentences
       
         # Tokens, along with their syntactic information, in the input document.
-        # Populated if the user enables
-        # AnnotateTextRequest.Features.extract_syntax.
+        # Populated if the user enables AnnotateTextRequest.Features.extract_syntax.
         # Corresponds to the JSON property `tokens`
         # @return [Array<Google::Apis::LanguageV1::Token>]
         attr_accessor :tokens
@@ -342,8 +338,8 @@ module Google
       class ClassificationCategory
         include Google::Apis::Core::Hashable
       
-        # The classifier's confidence of the category. Number represents how certain
-        # the classifier is that this category represents the given text.
+        # The classifier's confidence of the category. Number represents how certain the
+        # classifier is that this category represents the given text.
         # Corresponds to the JSON property `confidence`
         # @return [Float]
         attr_accessor :confidence
@@ -369,8 +365,8 @@ module Google
       class ClassifyTextRequest
         include Google::Apis::Core::Hashable
       
-        # ################################################################ #
-        # Represents the input to API methods.
+        # ################################################################ # Represents
+        # the input to API methods.
         # Corresponds to the JSON property `document`
         # @return [Google::Apis::LanguageV1::Document]
         attr_accessor :document
@@ -405,16 +401,14 @@ module Google
       end
       
       # Represents dependency parse tree information for a token. (For more
-      # information on dependency labels, see
-      # http://www.aclweb.org/anthology/P13-2017
+      # information on dependency labels, see http://www.aclweb.org/anthology/P13-2017
       class DependencyEdge
         include Google::Apis::Core::Hashable
       
-        # Represents the head of this token in the dependency tree.
-        # This is the index of the token which has an arc going to this token.
-        # The index is the position of the token in the array of tokens returned
-        # by the API method. If this token is a root token, then the
-        # `head_token_index` is its own index.
+        # Represents the head of this token in the dependency tree. This is the index of
+        # the token which has an arc going to this token. The index is the position of
+        # the token in the array of tokens returned by the API method. If this token is
+        # a root token, then the `head_token_index` is its own index.
         # Corresponds to the JSON property `headTokenIndex`
         # @return [Fixnum]
         attr_accessor :head_token_index
@@ -435,39 +429,37 @@ module Google
         end
       end
       
-      # ################################################################ #
-      # Represents the input to API methods.
+      # ################################################################ # Represents
+      # the input to API methods.
       class Document
         include Google::Apis::Core::Hashable
       
-        # The content of the input in string format.
-        # Cloud audit logging exempt since it is based on user data.
+        # The content of the input in string format. Cloud audit logging exempt since it
+        # is based on user data.
         # Corresponds to the JSON property `content`
         # @return [String]
         attr_accessor :content
       
-        # The Google Cloud Storage URI where the file content is located.
-        # This URI must be of the form: gs://bucket_name/object_name. For more
-        # details, see https://cloud.google.com/storage/docs/reference-uris.
-        # NOTE: Cloud Storage object versioning is not supported.
+        # The Google Cloud Storage URI where the file content is located. This URI must
+        # be of the form: gs://bucket_name/object_name. For more details, see https://
+        # cloud.google.com/storage/docs/reference-uris. NOTE: Cloud Storage object
+        # versioning is not supported.
         # Corresponds to the JSON property `gcsContentUri`
         # @return [String]
         attr_accessor :gcs_content_uri
       
-        # The language of the document (if not specified, the language is
-        # automatically detected). Both ISO and BCP-47 language codes are
-        # accepted.<br>
-        # [Language
-        # Support](https://cloud.google.com/natural-language/docs/languages) lists
-        # currently supported languages for each API method. If the language (either
-        # specified by the caller or automatically detected) is not supported by the
-        # called API method, an `INVALID_ARGUMENT` error is returned.
+        # The language of the document (if not specified, the language is automatically
+        # detected). Both ISO and BCP-47 language codes are accepted. [Language Support](
+        # https://cloud.google.com/natural-language/docs/languages) lists currently
+        # supported languages for each API method. If the language (either specified by
+        # the caller or automatically detected) is not supported by the called API
+        # method, an `INVALID_ARGUMENT` error is returned.
         # Corresponds to the JSON property `language`
         # @return [String]
         attr_accessor :language
       
-        # Required. If the type is not set or is `TYPE_UNSPECIFIED`,
-        # returns an `INVALID_ARGUMENT` error.
+        # Required. If the type is not set or is `TYPE_UNSPECIFIED`, returns an `
+        # INVALID_ARGUMENT` error.
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type
@@ -485,22 +477,22 @@ module Google
         end
       end
       
-      # Represents a phrase in the text that is a known entity, such as
-      # a person, an organization, or location. The API associates information, such
-      # as salience and mentions, with entities.
+      # Represents a phrase in the text that is a known entity, such as a person, an
+      # organization, or location. The API associates information, such as salience
+      # and mentions, with entities.
       class Entity
         include Google::Apis::Core::Hashable
       
-        # The mentions of this entity in the input document. The API currently
-        # supports proper noun mentions.
+        # The mentions of this entity in the input document. The API currently supports
+        # proper noun mentions.
         # Corresponds to the JSON property `mentions`
         # @return [Array<Google::Apis::LanguageV1::EntityMention>]
         attr_accessor :mentions
       
-        # Metadata associated with the entity.
-        # For most entity types, the metadata is a Wikipedia URL (`wikipedia_url`)
-        # and Knowledge Graph MID (`mid`), if they are available. For the metadata
-        # associated with other entity types, see the Type table below.
+        # Metadata associated with the entity. For most entity types, the metadata is a
+        # Wikipedia URL (`wikipedia_url`) and Knowledge Graph MID (`mid`), if they are
+        # available. For the metadata associated with other entity types, see the Type
+        # table below.
         # Corresponds to the JSON property `metadata`
         # @return [Hash<String,String>]
         attr_accessor :metadata
@@ -510,17 +502,15 @@ module Google
         # @return [String]
         attr_accessor :name
       
-        # The salience score associated with the entity in the [0, 1.0] range.
-        # The salience score for an entity provides information about the
-        # importance or centrality of that entity to the entire document text.
-        # Scores closer to 0 are less salient, while scores closer to 1.0 are highly
-        # salient.
+        # The salience score associated with the entity in the [0, 1.0] range. The
+        # salience score for an entity provides information about the importance or
+        # centrality of that entity to the entire document text. Scores closer to 0 are
+        # less salient, while scores closer to 1.0 are highly salient.
         # Corresponds to the JSON property `salience`
         # @return [Float]
         attr_accessor :salience
       
-        # Represents the feeling associated with the entire text or entities in
-        # the text.
+        # Represents the feeling associated with the entire text or entities in the text.
         # Corresponds to the JSON property `sentiment`
         # @return [Google::Apis::LanguageV1::Sentiment]
         attr_accessor :sentiment
@@ -550,8 +540,7 @@ module Google
       class EntityMention
         include Google::Apis::Core::Hashable
       
-        # Represents the feeling associated with the entire text or entities in
-        # the text.
+        # Represents the feeling associated with the entire text or entities in the text.
         # Corresponds to the JSON property `sentiment`
         # @return [Google::Apis::LanguageV1::Sentiment]
         attr_accessor :sentiment
@@ -578,8 +567,8 @@ module Google
         end
       end
       
-      # All available features for sentiment, syntax, and semantic analysis.
-      # Setting each one to true will enable that specific analysis for the input.
+      # All available features for sentiment, syntax, and semantic analysis. Setting
+      # each one to true will enable that specific analysis for the input.
       class Features
         include Google::Apis::Core::Hashable
       
@@ -627,9 +616,8 @@ module Google
         end
       end
       
-      # Represents part of speech information for a token. Parts of speech
-      # are as defined in
-      # http://www.lrec-conf.org/proceedings/lrec2012/pdf/274_Paper.pdf
+      # Represents part of speech information for a token. Parts of speech are as
+      # defined in http://www.lrec-conf.org/proceedings/lrec2012/pdf/274_Paper.pdf
       class PartOfSpeech
         include Google::Apis::Core::Hashable
       
@@ -718,8 +706,7 @@ module Google
       class Sentence
         include Google::Apis::Core::Hashable
       
-        # Represents the feeling associated with the entire text or entities in
-        # the text.
+        # Represents the feeling associated with the entire text or entities in the text.
         # Corresponds to the JSON property `sentiment`
         # @return [Google::Apis::LanguageV1::Sentiment]
         attr_accessor :sentiment
@@ -740,20 +727,17 @@ module Google
         end
       end
       
-      # Represents the feeling associated with the entire text or entities in
-      # the text.
+      # Represents the feeling associated with the entire text or entities in the text.
       class Sentiment
         include Google::Apis::Core::Hashable
       
-        # A non-negative number in the [0, +inf) range, which represents
-        # the absolute magnitude of sentiment regardless of score (positive or
-        # negative).
+        # A non-negative number in the [0, +inf) range, which represents the absolute
+        # magnitude of sentiment regardless of score (positive or negative).
         # Corresponds to the JSON property `magnitude`
         # @return [Float]
         attr_accessor :magnitude
       
-        # Sentiment score between -1.0 (negative sentiment) and 1.0
-        # (positive sentiment).
+        # Sentiment score between -1.0 (negative sentiment) and 1.0 (positive sentiment).
         # Corresponds to the JSON property `score`
         # @return [Float]
         attr_accessor :score
@@ -769,12 +753,12 @@ module Google
         end
       end
       
-      # The `Status` type defines a logical error model that is suitable for
-      # different programming environments, including REST APIs and RPC APIs. It is
-      # used by [gRPC](https://github.com/grpc). Each `Status` message contains
-      # three pieces of data: error code, error message, and error details.
-      # You can find out more about this error model and how to work with it in the
-      # [API Design Guide](https://cloud.google.com/apis/design/errors).
+      # The `Status` type defines a logical error model that is suitable for different
+      # programming environments, including REST APIs and RPC APIs. It is used by [
+      # gRPC](https://github.com/grpc). Each `Status` message contains three pieces of
+      # data: error code, error message, and error details. You can find out more
+      # about this error model and how to work with it in the [API Design Guide](https:
+      # //cloud.google.com/apis/design/errors).
       class Status
         include Google::Apis::Core::Hashable
       
@@ -783,15 +767,15 @@ module Google
         # @return [Fixnum]
         attr_accessor :code
       
-        # A list of messages that carry the error details.  There is a common set of
+        # A list of messages that carry the error details. There is a common set of
         # message types for APIs to use.
         # Corresponds to the JSON property `details`
         # @return [Array<Hash<String,Object>>]
         attr_accessor :details
       
-        # A developer-facing error message, which should be in English. Any
-        # user-facing error message should be localized and sent in the
-        # google.rpc.Status.details field, or localized by the client.
+        # A developer-facing error message, which should be in English. Any user-facing
+        # error message should be localized and sent in the google.rpc.Status.details
+        # field, or localized by the client.
         # Corresponds to the JSON property `message`
         # @return [String]
         attr_accessor :message
@@ -839,8 +823,7 @@ module Google
         include Google::Apis::Core::Hashable
       
         # Represents dependency parse tree information for a token. (For more
-        # information on dependency labels, see
-        # http://www.aclweb.org/anthology/P13-2017
+        # information on dependency labels, see http://www.aclweb.org/anthology/P13-2017
         # Corresponds to the JSON property `dependencyEdge`
         # @return [Google::Apis::LanguageV1::DependencyEdge]
         attr_accessor :dependency_edge
@@ -850,9 +833,8 @@ module Google
         # @return [String]
         attr_accessor :lemma
       
-        # Represents part of speech information for a token. Parts of speech
-        # are as defined in
-        # http://www.lrec-conf.org/proceedings/lrec2012/pdf/274_Paper.pdf
+        # Represents part of speech information for a token. Parts of speech are as
+        # defined in http://www.lrec-conf.org/proceedings/lrec2012/pdf/274_Paper.pdf
         # Corresponds to the JSON property `partOfSpeech`
         # @return [Google::Apis::LanguageV1::PartOfSpeech]
         attr_accessor :part_of_speech