google-api-client 0.28.4 → 0.29.2

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

@@ -29,14 +29,13 @@ module Google
       class AwsAccessKey
         include Google::Apis::Core::Hashable
       
-        # AWS access key ID.
-        # Required.
+        # Required. AWS access key ID.
         # Corresponds to the JSON property `accessKeyId`
         # @return [String]
         attr_accessor :access_key_id
       
-        # AWS secret access key. This field is not returned in RPC responses.
-        # Required.
+        # Required. AWS secret access key. This field is not returned in RPC
+        # responses.
         # Corresponds to the JSON property `secretAccessKey`
         # @return [String]
         attr_accessor :secret_access_key
@@ -65,11 +64,10 @@ module Google
         # @return [Google::Apis::StoragetransferV1::AwsAccessKey]
         attr_accessor :aws_access_key
       
-        # S3 Bucket name (see
+        # Required. S3 Bucket name (see
         # [Creating a
         # bucket](http://docs.aws.amazon.com/AmazonS3/latest/dev/create-bucket-get-
         # location-example.html)).
-        # Required.
         # Corresponds to the JSON property `bucketName`
         # @return [String]
         attr_accessor :bucket_name
@@ -155,9 +153,8 @@ module Google
         # @return [Array<String>]
         attr_accessor :error_details
       
-        # A URL that refers to the target (a data source, a data sink,
+        # Required. A URL that refers to the target (a data source, a data sink,
         # or an object) with which the error is associated.
-        # Required.
         # Corresponds to the JSON property `url`
         # @return [String]
         attr_accessor :url
@@ -183,8 +180,7 @@ module Google
         # @return [String]
         attr_accessor :error_code
       
-        # Count of this type of error.
-        # Required.
+        # Required. Count of this type of error.
         # Corresponds to the JSON property `errorCount`
         # @return [Fixnum]
         attr_accessor :error_count
@@ -214,10 +210,9 @@ module Google
       class GcsData
         include Google::Apis::Core::Hashable
       
-        # Google Cloud Storage bucket name (see
+        # Required. Google Cloud Storage bucket name (see
         # [Bucket Name
         # Requirements](https://cloud.google.com/storage/docs/naming#requirements)).
-        # Required.
         # Corresponds to the JSON property `bucketName`
         # @return [String]
         attr_accessor :bucket_name
@@ -236,7 +231,7 @@ module Google
       class GoogleServiceAccount
         include Google::Apis::Core::Hashable
       
-        # Required.
+        # Email address of the service account.
         # Corresponds to the JSON property `accountEmail`
         # @return [String]
         attr_accessor :account_email
@@ -285,10 +280,9 @@ module Google
       class HttpData
         include Google::Apis::Core::Hashable
       
-        # The URL that points to the file that stores the object list entries.
-        # This file must allow public access.  Currently, only URLs with HTTP and
-        # HTTPS schemes are supported.
-        # Required.
+        # Required. The URL that points to the file that stores the object list
+        # entries. This file must allow public access.  Currently, only URLs with
+        # HTTP and HTTPS schemes are supported.
         # Corresponds to the JSON property `listUrl`
         # @return [String]
         attr_accessor :list_url
@@ -353,7 +347,8 @@ module Google
         end
       end
       
-      # Conditions that determine which objects will be transferred.
+      # Conditions that determine which objects will be transferred. Applies only
+      # to S3 and GCS objects.
       class ObjectConditions
         include Google::Apis::Core::Hashable
       
@@ -394,19 +389,24 @@ module Google
         # @return [Array<String>]
         attr_accessor :include_prefixes
       
-        # `maxTimeElapsedSinceLastModification` is the complement to
-        # `minTimeElapsedSinceLastModification`.
+        # If specified, only objects with a `lastModificationTime` on or after
+        # `NOW` - `maxTimeElapsedSinceLastModification` and objects that don't have
+        # a `lastModificationTime` are transferred.
+        # Note that `NOW` refers to the creation time of the transfer job, and
+        # `lastModificationTime` refers to the time of the last change to the
+        # object's content or metadata. Specifically, this would be the `updated`
+        # property of GCS objects and the `LastModified` field of S3 objects.
         # Corresponds to the JSON property `maxTimeElapsedSinceLastModification`
         # @return [String]
         attr_accessor :max_time_elapsed_since_last_modification
       
-        # If unspecified, `minTimeElapsedSinceLastModification` takes a zero value
-        # and `maxTimeElapsedSinceLastModification` takes the maximum possible
-        # value of Duration. Objects that satisfy the object conditions
-        # must either have a `lastModificationTime` greater or equal to
-        # `NOW` - `maxTimeElapsedSinceLastModification` and less than
-        # `NOW` - `minTimeElapsedSinceLastModification`, or not have a
-        # `lastModificationTime`.
+        # If specified, only objects with a `lastModificationTime` before
+        # `NOW` - `minTimeElapsedSinceLastModification` and objects that don't have a
+        # `lastModificationTime` are transferred.
+        # Note that `NOW` refers to the creation time of the transfer job, and
+        # `lastModificationTime` refers to the time of the last change to the
+        # object's content or metadata. Specifically, this would be the `updated`
+        # property of GCS objects and the `LastModified` field of S3 objects.
         # Corresponds to the JSON property `minTimeElapsedSinceLastModification`
         # @return [String]
         attr_accessor :min_time_elapsed_since_last_modification
@@ -437,14 +437,14 @@ module Google
         attr_accessor :done
         alias_method :done?, :done
       
-        # The `Status` type defines a logical error model that is suitable for different
-        # programming environments, including REST APIs and RPC APIs. It is used by
-        # [gRPC](https://github.com/grpc). The error model is designed to be:
+        # 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). The error model is designed to be:
         # - Simple to use and understand for most users
         # - Flexible enough to meet unexpected needs
         # # Overview
-        # The `Status` message contains three pieces of data: error code, error message,
-        # and error details. The error code should be an enum value of
+        # The `Status` message contains three pieces of data: error code, error
+        # message, and error details. The error code should be an enum value of
         # google.rpc.Code, but it may accept additional error codes if needed.  The
         # error message should be a developer-facing English message that helps
         # developers *understand* and *resolve* the error. If a localized user-facing
@@ -591,14 +591,14 @@ 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). The error model is designed to be:
+      # 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). The error model is designed to be:
       # - Simple to use and understand for most users
       # - Flexible enough to meet unexpected needs
       # # Overview
-      # The `Status` message contains three pieces of data: error code, error message,
-      # and error details. The error code should be an enum value of
+      # The `Status` message contains three pieces of data: error code, error
+      # message, and error details. The error code should be an enum value of
       # google.rpc.Code, but it may accept additional error codes if needed.  The
       # error message should be a developer-facing English message that helps
       # developers *understand* and *resolve* the error. If a localized user-facing
@@ -826,12 +826,12 @@ module Google
       class TransferJob
         include Google::Apis::Core::Hashable
       
-        # This field cannot be changed by user requests.
+        # Output only. The time that the transfer job was created.
         # Corresponds to the JSON property `creationTime`
         # @return [String]
         attr_accessor :creation_time
       
-        # This field cannot be changed by user requests.
+        # Output only. The time that the transfer job was deleted.
         # Corresponds to the JSON property `deletionTime`
         # @return [String]
         attr_accessor :deletion_time
@@ -842,7 +842,7 @@ module Google
         # @return [String]
         attr_accessor :description
       
-        # This field cannot be changed by user requests.
+        # Output only. The time that the transfer job was last modified.
         # Corresponds to the JSON property `lastModificationTime`
         # @return [String]
         attr_accessor :last_modification_time
@@ -923,7 +923,6 @@ module Google
         attr_accessor :name
       
         # The ID of the Google Cloud Platform Project that owns the operation.
-        # Required.
         # Corresponds to the JSON property `projectId`
         # @return [String]
         attr_accessor :project_id
@@ -1064,7 +1063,8 @@ module Google
         # @return [Google::Apis::StoragetransferV1::HttpData]
         attr_accessor :http_data_source
       
-        # Conditions that determine which objects will be transferred.
+        # Conditions that determine which objects will be transferred. Applies only
+        # to S3 and GCS objects.
         # Corresponds to the JSON property `objectConditions`
         # @return [Google::Apis::StoragetransferV1::ObjectConditions]
         attr_accessor :object_conditions
@@ -1094,8 +1094,8 @@ module Google
       class UpdateTransferJobRequest
         include Google::Apis::Core::Hashable
       
-        # The ID of the Google Cloud Platform Console project that owns the job.
-        # Required.
+        # Required. The ID of the Google Cloud Platform Console project that owns the
+        # job.
         # Corresponds to the JSON property `projectId`
         # @return [String]
         attr_accessor :project_id

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

@@ -31,7 +31,7 @@ module Google
       #    Storagetransfer = Google::Apis::StoragetransferV1 # Alias the module
       #    service = Storagetransfer::StoragetransferService.new
       #
-      # @see https://cloud.google.com/storage/transfer
+      # @see https://cloud.google.com/storage-transfer/docs
       class StoragetransferService < Google::Apis::Core::BaseService
         # @return [String]
         #  API key. Your API key identifies your project and provides you with API access,
@@ -57,9 +57,8 @@ module Google
         # account is created and owned by Storage Transfer Service and can
         # only be used by Storage Transfer Service.
         # @param [String] project_id
-        #   The ID of the Google Cloud Platform Console project that the Google service
-        #   account is associated with.
-        #   Required.
+        #   Required. The ID of the Google Cloud Platform Console project that the
+        #   Google service account is associated with.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -78,7 +77,7 @@ module Google
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
         def get_google_service_account(project_id, fields: nil, quota_user: nil, options: nil, &block)
-          command =  make_simple_command(:get, 'v1/googleServiceAccounts/{projectId}', options)
+          command = make_simple_command(:get, 'v1/googleServiceAccounts/{projectId}', options)
           command.response_representation = Google::Apis::StoragetransferV1::GoogleServiceAccount::Representation
           command.response_class = Google::Apis::StoragetransferV1::GoogleServiceAccount
           command.params['projectId'] = project_id unless project_id.nil?
@@ -107,7 +106,7 @@ module Google
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
         def create_transfer_job(transfer_job_object = nil, fields: nil, quota_user: nil, options: nil, &block)
-          command =  make_simple_command(:post, 'v1/transferJobs', options)
+          command = make_simple_command(:post, 'v1/transferJobs', options)
           command.request_representation = Google::Apis::StoragetransferV1::TransferJob::Representation
           command.request_object = transfer_job_object
           command.response_representation = Google::Apis::StoragetransferV1::TransferJob::Representation
@@ -119,11 +118,10 @@ module Google
         
         # Gets a transfer job.
         # @param [String] job_name
-        #   The job to get.
-        #   Required.
+        #   Required. The job to get.
         # @param [String] project_id
-        #   The ID of the Google Cloud Platform Console project that owns the job.
-        #   Required.
+        #   Required. The ID of the Google Cloud Platform Console project that owns the
+        #   job.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -142,7 +140,7 @@ module Google
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
         def get_transfer_job(job_name, project_id: nil, fields: nil, quota_user: nil, options: nil, &block)
-          command =  make_simple_command(:get, 'v1/{+jobName}', options)
+          command = make_simple_command(:get, 'v1/{+jobName}', options)
           command.response_representation = Google::Apis::StoragetransferV1::TransferJob::Representation
           command.response_class = Google::Apis::StoragetransferV1::TransferJob
           command.params['jobName'] = job_name unless job_name.nil?
@@ -154,14 +152,14 @@ module Google
         
         # Lists transfer jobs.
         # @param [String] filter
-        #   A list of query parameters specified as JSON text in the form of
+        #   Required. A list of query parameters specified as JSON text in the form of:
         #   `"project_id":"my_project_id",
         #   "job_names":["jobid1","jobid2",...],
         #   "job_statuses":["status1","status2",...]`.
         #   Since `job_names` and `job_statuses` support multiple values, their values
-        #   must be specified with array notation. `project_id` is required. `job_names`
-        #   and `job_statuses` are optional.  The valid values for `job_statuses` are
-        #   case-insensitive: `ENABLED`, `DISABLED`, and `DELETED`.
+        #   must be specified with array notation. `project_id` is required.
+        #   `job_names` and `job_statuses` are optional.  The valid values for
+        #   `job_statuses` are case-insensitive: `ENABLED`, `DISABLED`, and `DELETED`.
         # @param [Fixnum] page_size
         #   The list page size. The max allowed value is 256.
         # @param [String] page_token
@@ -184,7 +182,7 @@ module Google
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
         def list_transfer_jobs(filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
-          command =  make_simple_command(:get, 'v1/transferJobs', options)
+          command = make_simple_command(:get, 'v1/transferJobs', options)
           command.response_representation = Google::Apis::StoragetransferV1::ListTransferJobsResponse::Representation
           command.response_class = Google::Apis::StoragetransferV1::ListTransferJobsResponse
           command.query['filter'] = filter unless filter.nil?
@@ -199,8 +197,7 @@ module Google
         # transfer operations that are running already. Updating the scheduling
         # of a job is not allowed.
         # @param [String] job_name
-        #   The name of job to update.
-        #   Required.
+        #   Required. The name of job to update.
         # @param [Google::Apis::StoragetransferV1::UpdateTransferJobRequest] update_transfer_job_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -220,7 +217,7 @@ module Google
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
         def patch_transfer_job(job_name, update_transfer_job_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
-          command =  make_simple_command(:patch, 'v1/{+jobName}', options)
+          command = make_simple_command(:patch, 'v1/{+jobName}', options)
           command.request_representation = Google::Apis::StoragetransferV1::UpdateTransferJobRequest::Representation
           command.request_object = update_transfer_job_request_object
           command.response_representation = Google::Apis::StoragetransferV1::TransferJob::Representation
@@ -253,7 +250,7 @@ module Google
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
         def cancel_transfer_operation(name, fields: nil, quota_user: nil, options: nil, &block)
-          command =  make_simple_command(:post, 'v1/{+name}:cancel', options)
+          command = make_simple_command(:post, 'v1/{+name}:cancel', options)
           command.response_representation = Google::Apis::StoragetransferV1::Empty::Representation
           command.response_class = Google::Apis::StoragetransferV1::Empty
           command.params['name'] = name unless name.nil?
@@ -283,7 +280,7 @@ module Google
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
         def delete_transfer_operation(name, fields: nil, quota_user: nil, options: nil, &block)
-          command =  make_simple_command(:delete, 'v1/{+name}', options)
+          command = make_simple_command(:delete, 'v1/{+name}', options)
           command.response_representation = Google::Apis::StoragetransferV1::Empty::Representation
           command.response_class = Google::Apis::StoragetransferV1::Empty
           command.params['name'] = name unless name.nil?
@@ -315,7 +312,7 @@ module Google
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
         def get_transfer_operation(name, fields: nil, quota_user: nil, options: nil, &block)
-          command =  make_simple_command(:get, 'v1/{+name}', options)
+          command = make_simple_command(:get, 'v1/{+name}', options)
           command.response_representation = Google::Apis::StoragetransferV1::Operation::Representation
           command.response_class = Google::Apis::StoragetransferV1::Operation
           command.params['name'] = name unless name.nil?
@@ -334,14 +331,18 @@ module Google
         # collection id, however overriding users must ensure the name binding
         # is the parent resource, without the operations collection id.
         # @param [String] name
-        #   The value `transferOperations`.
+        #   Required. The value `transferOperations`.
         # @param [String] filter
-        #   A list of query parameters specified as JSON text in the form of `\"project_id\
-        #   " : \"my_project_id\", \"job_names\" : [\"jobid1\", \"jobid2\",...], \"
-        #   operation_names\" : [\"opid1\", \"opid2\",...], \"transfer_statuses\":[\"
-        #   status1\", \"status2\",...]`. Since `job_names`, `operation_names`, and `
-        #   transfer_statuses` support multiple values, they must be specified with array
-        #   notation. `job_names`, `operation_names`, and `transfer_statuses` are optional.
+        #   Required. A list of query parameters specified as JSON text in the form of: `"
+        #   project_id":"my_project_id",
+        #   "job_names":["jobid1","jobid2",...],
+        #   "operation_names":["opid1","opid2",...],
+        #   "transfer_statuses":["status1","status2",...]`.
+        #   Since `job_names`, `operation_names`, and `transfer_statuses` support multiple
+        #   values, they must be specified with array notation. `project_id` is required. `
+        #   job_names`, `operation_names`, and `transfer_statuses` are optional. The valid
+        #   values for `transfer_statuses` are case-insensitive: `IN_PROGRESS`, `PAUSED`, `
+        #   SUCCESS`, `FAILED`, and `ABORTED`.
         # @param [Fixnum] page_size
         #   The list page size. The max allowed value is 256.
         # @param [String] page_token
@@ -364,7 +365,7 @@ module Google
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
         def list_transfer_operations(name, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
-          command =  make_simple_command(:get, 'v1/{+name}', options)
+          command = make_simple_command(:get, 'v1/{+name}', options)
           command.response_representation = Google::Apis::StoragetransferV1::ListOperationsResponse::Representation
           command.response_class = Google::Apis::StoragetransferV1::ListOperationsResponse
           command.params['name'] = name unless name.nil?
@@ -378,8 +379,7 @@ module Google
         
         # Pauses a transfer operation.
         # @param [String] name
-        #   The name of the transfer operation.
-        #   Required.
+        #   Required. The name of the transfer operation.
         # @param [Google::Apis::StoragetransferV1::PauseTransferOperationRequest] pause_transfer_operation_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -399,7 +399,7 @@ module Google
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
         def pause_transfer_operation(name, pause_transfer_operation_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
-          command =  make_simple_command(:post, 'v1/{+name}:pause', options)
+          command = make_simple_command(:post, 'v1/{+name}:pause', options)
           command.request_representation = Google::Apis::StoragetransferV1::PauseTransferOperationRequest::Representation
           command.request_object = pause_transfer_operation_request_object
           command.response_representation = Google::Apis::StoragetransferV1::Empty::Representation
@@ -412,8 +412,7 @@ module Google
         
         # Resumes a transfer operation that is paused.
         # @param [String] name
-        #   The name of the transfer operation.
-        #   Required.
+        #   Required. The name of the transfer operation.
         # @param [Google::Apis::StoragetransferV1::ResumeTransferOperationRequest] resume_transfer_operation_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -433,7 +432,7 @@ module Google
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
         def resume_transfer_operation(name, resume_transfer_operation_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
-          command =  make_simple_command(:post, 'v1/{+name}:resume', options)
+          command = make_simple_command(:post, 'v1/{+name}:resume', options)
           command.request_representation = Google::Apis::StoragetransferV1::ResumeTransferOperationRequest::Representation
           command.request_object = resume_transfer_operation_request_object
           command.response_representation = Google::Apis::StoragetransferV1::Empty::Representation

data/generated/google/apis/storagetransfer_v1.rb

@@ -23,10 +23,10 @@ module Google
     # Transfers data from external data sources to a Google Cloud Storage bucket or
     # between Google Cloud Storage buckets.
     #
-    # @see https://cloud.google.com/storage/transfer
+    # @see https://cloud.google.com/storage-transfer/docs
     module StoragetransferV1
       VERSION = 'V1'
-      REVISION = '20190204'
+      REVISION = '20190513'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

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

@@ -26,8 +26,8 @@ module Google
       class BatchDeletePhotosRequest
         include Google::Apis::Core::Hashable
       
-        # Required. IDs of the Photos. For HTTP
-        # GET requests, the URL query parameter should be
+        # Required. IDs of the Photos. HTTP
+        # GET requests require the following syntax for the URL query parameter:
         # `photoIds=<id1>&photoIds=<id2>&...`.
         # Corresponds to the JSON property `photoIds`
         # @return [Array<String>]
@@ -235,9 +235,9 @@ module Google
         # @return [String]
         attr_accessor :next_page_token
       
-        # List of photos. The maximum number of items returned is based on the
+        # List of photos. The
         # pageSize field
-        # in the request.
+        # in the request determines the number of items returned.
         # Corresponds to the JSON property `photos`
         # @return [Array<Google::Apis::StreetviewpublishV1::Photo>]
         attr_accessor :photos
@@ -266,14 +266,14 @@ module Google
         attr_accessor :done
         alias_method :done?, :done
       
-        # The `Status` type defines a logical error model that is suitable for different
-        # programming environments, including REST APIs and RPC APIs. It is used by
-        # [gRPC](https://github.com/grpc). The error model is designed to be:
+        # 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). The error model is designed to be:
         # - Simple to use and understand for most users
         # - Flexible enough to meet unexpected needs
         # # Overview
-        # The `Status` message contains three pieces of data: error code, error message,
-        # and error details. The error code should be an enum value of
+        # The `Status` message contains three pieces of data: error code, error
+        # message, and error details. The error code should be an enum value of
         # google.rpc.Code, but it may accept additional error codes if needed.  The
         # error message should be a developer-facing English message that helps
         # developers *understand* and *resolve* the error. If a localized user-facing
@@ -319,7 +319,7 @@ module Google
       
         # The server-assigned name, which is only unique within the same service that
         # originally returns it. If you use the default HTTP mapping, the
-        # `name` should have the format of `operations/some/unique/name`.
+        # `name` should be a resource name ending with `operations/`unique_id``.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -376,8 +376,8 @@ module Google
         # @return [String]
         attr_accessor :download_url
       
-        # Output only. Status in Google Maps, whether this photo was published, or
-        # rejected for a possibly specified reason.
+        # Output only. Status in Google Maps, whether this photo was published or
+        # rejected.
         # Corresponds to the JSON property `mapsPublishStatus`
         # @return [String]
         attr_accessor :maps_publish_status
@@ -476,14 +476,14 @@ module Google
         # @return [Google::Apis::StreetviewpublishV1::Photo]
         attr_accessor :photo
       
-        # 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). The error model is designed to be:
+        # 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). The error model is designed to be:
         # - Simple to use and understand for most users
         # - Flexible enough to meet unexpected needs
         # # Overview
-        # The `Status` message contains three pieces of data: error code, error message,
-        # and error details. The error code should be an enum value of
+        # The `Status` message contains three pieces of data: error code, error
+        # message, and error details. The error code should be an enum value of
         # google.rpc.Code, but it may accept additional error codes if needed.  The
         # error message should be a developer-facing English message that helps
         # developers *understand* and *resolve* the error. If a localized user-facing
@@ -636,14 +636,14 @@ 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). The error model is designed to be:
+      # 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). The error model is designed to be:
       # - Simple to use and understand for most users
       # - Flexible enough to meet unexpected needs
       # # Overview
-      # The `Status` message contains three pieces of data: error code, error message,
-      # and error details. The error code should be an enum value of
+      # The `Status` message contains three pieces of data: error code, error
+      # message, and error details. The error code should be an enum value of
       # google.rpc.Code, but it may accept additional error codes if needed.  The
       # error message should be a developer-facing English message that helps
       # developers *understand* and *resolve* the error. If a localized user-facing
@@ -721,7 +721,7 @@ module Google
       
         # Mask that identifies fields on the photo metadata to update.
         # If not present, the old Photo
-        # metadata will be entirely replaced with the
+        # metadata is entirely replaced with the
         # new Photo metadata in this request.
         # The update fails if invalid fields are specified. Multiple fields can be
         # specified in a comma-delimited list.
@@ -734,13 +734,13 @@ module Google
         # * `pose.altitude`
         # * `connections`
         # * `places`
-        # <aside class="note"><b>Note:</b> Repeated fields in
+        # <aside class="note"><b>Note:</b> When
         # updateMask
-        # mean the entire set of repeated values will be replaced with the new
-        # contents. For example, if
+        # contains repeated fields, the entire set of repeated values get replaced
+        # with the new contents. For example, if
         # updateMask
         # contains `connections` and `UpdatePhotoRequest.photo.connections` is empty,
-        # all connections will be removed.</aside>
+        # all connections are removed.</aside>
         # Corresponds to the JSON property `updateMask`
         # @return [String]
         attr_accessor :update_mask