google-api-client 0.37.0 → 0.38.0

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

@@ -368,7 +368,6 @@ module Google
         #   * ageRanges
         #   * biographies
         #   * birthdays
-        #   * braggingRights
         #   * coverPhotos
         #   * emailAddresses
         #   * events
@@ -385,12 +384,9 @@ module Google
         #   * phoneNumbers
         #   * photos
         #   * relations
-        #   * relationshipInterests
-        #   * relationshipStatuses
         #   * residences
         #   * sipAddresses
         #   * skills
-        #   * taglines
         #   * urls
         #   * userDefined
         # @param [String] fields
@@ -440,7 +436,6 @@ module Google
         #   * ageRanges
         #   * biographies
         #   * birthdays
-        #   * braggingRights
         #   * coverPhotos
         #   * emailAddresses
         #   * events
@@ -457,12 +452,9 @@ module Google
         #   * phoneNumbers
         #   * photos
         #   * relations
-        #   * relationshipInterests
-        #   * relationshipStatuses
         #   * residences
         #   * sipAddresses
         #   * skills
-        #   * taglines
         #   * urls
         #   * userDefined
         # @param [String] request_mask_include_field
@@ -511,7 +503,6 @@ module Google
         #   * ageRanges
         #   * biographies
         #   * birthdays
-        #   * braggingRights
         #   * coverPhotos
         #   * emailAddresses
         #   * events
@@ -528,12 +519,9 @@ module Google
         #   * phoneNumbers
         #   * photos
         #   * relations
-        #   * relationshipInterests
-        #   * relationshipStatuses
         #   * residences
         #   * sipAddresses
         #   * skills
-        #   * taglines
         #   * urls
         #   * userDefined
         # @param [String] request_mask_include_field
@@ -693,7 +681,10 @@ module Google
         #   are
         #   between 1 and 2000, inclusive. Defaults to 100 if not set or set to 0.
         # @param [String] page_token
-        #   Optional. The token of the page to be returned.
+        #   Optional. A page token, received from a previous `ListConnections` call.
+        #   Provide this to retrieve the subsequent page.
+        #   When paginating, all other parameters provided to `ListConnections`
+        #   must match the call that provided the page token.
         # @param [String] person_fields
         #   Required. A field mask to restrict which fields on each person are returned.
         #   Multiple
@@ -702,7 +693,6 @@ module Google
         #   * ageRanges
         #   * biographies
         #   * birthdays
-        #   * braggingRights
         #   * coverPhotos
         #   * emailAddresses
         #   * events
@@ -719,12 +709,9 @@ module Google
         #   * phoneNumbers
         #   * photos
         #   * relations
-        #   * relationshipInterests
-        #   * relationshipStatuses
         #   * residences
         #   * sipAddresses
         #   * skills
-        #   * taglines
         #   * urls
         #   * userDefined
         # @param [String] request_mask_include_field
@@ -733,19 +720,20 @@ module Google
         #   path should start with `person.`: for example, `person.names` or
         #   `person.photos`.
         # @param [Boolean] request_sync_token
-        #   Optional. Whether the response should include a sync token, which can be used
-        #   to get
-        #   all changes since the last request. For subsequent sync requests use the
-        #   `sync_token` param instead. Initial sync requests that specify
+        #   Optional. Whether the response should include `next_sync_token`, which can be
+        #   used to
+        #   get all changes since the last request. For subsequent sync requests use
+        #   the `sync_token` param instead. Initial sync requests that specify
         #   `request_sync_token` have an additional rate limit.
         # @param [String] sort_order
         #   Optional. The order in which the connections should be sorted. Defaults to
         #   `LAST_MODIFIED_ASCENDING`.
         # @param [String] sync_token
-        #   Optional. A sync token returned by a previous call to `people.connections.list`
-        #   .
-        #   Only resources changed since the sync token was created will be returned.
+        #   Optional. A sync token, received from a previous `ListConnections` call.
+        #   Provide this to retrieve only the resources changed since the last request.
         #   Sync requests that specify `sync_token` have an additional rate limit.
+        #   When syncing, all other parameters provided to `ListConnections`
+        #   must match the call that provided the sync token.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user

data/generated/google/apis/people_v1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://developers.google.com/people/
     module PeopleV1
       VERSION = 'V1'
-      REVISION = '20200212'
+      REVISION = '20200407'
 
       # See, edit, download, and permanently delete your contacts
       AUTH_CONTACTS = 'https://www.googleapis.com/auth/contacts'

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

@@ -96,7 +96,7 @@ module Google
         include Google::Apis::Core::Hashable
       
         # Required. JSON Web Token signed using a CPI private key. Payload
-        # must be the JSON encoding of the [Device].
+        # must be the JSON encoding of the [Device]. The user_id field must be set.
         # Corresponds to the JSON property `encodedDevice`
         # NOTE: Values are automatically base64 encoded/decoded in the client library.
         # @return [String]
@@ -291,7 +291,7 @@ module Google
         # @return [String]
         attr_accessor :update_time
       
-        # Output only. The identifier of a device user.
+        # The identifier of a device user.
         # Corresponds to the JSON property `userId`
         # @return [String]
         attr_accessor :user_id
@@ -946,6 +946,7 @@ module Google
       
         # Required. The device to sign.
         # The device fields name, fcc_id and serial_number must be set.
+        # The user_id field must be set.
         # Corresponds to the JSON property `device`
         # @return [Google::Apis::ProdTtSasportalV1alpha1::SasPortalDevice]
         attr_accessor :device
@@ -1049,7 +1050,7 @@ module Google
       
         # Required. The JSON Web Token signed using a CPI private key. Payload
         # must be the JSON encoding
-        # of the device.
+        # of the device. The user_id field must be set.
         # Corresponds to the JSON property `encodedDevice`
         # NOTE: Values are automatically base64 encoded/decoded in the client library.
         # @return [String]

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

@@ -686,6 +686,76 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Creates a new node.
+        # @param [String] parent
+        #   Required. The parent resource name where the node is to be created.
+        # @param [Google::Apis::ProdTtSasportalV1alpha1::SasPortalNode] sas_portal_node_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::ProdTtSasportalV1alpha1::SasPortalNode] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ProdTtSasportalV1alpha1::SasPortalNode]
+        #
+        # @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 create_customer_node_node(parent, sas_portal_node_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1alpha1/{+parent}/nodes', options)
+          command.request_representation = Google::Apis::ProdTtSasportalV1alpha1::SasPortalNode::Representation
+          command.request_object = sas_portal_node_object
+          command.response_representation = Google::Apis::ProdTtSasportalV1alpha1::SasPortalNode::Representation
+          command.response_class = Google::Apis::ProdTtSasportalV1alpha1::SasPortalNode
+          command.params['parent'] = parent unless parent.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Lists nodes.
+        # @param [String] parent
+        #   Required. The parent resource name, for example, "nodes/1".
+        # @param [Fixnum] page_size
+        #   The maximum number of nodes to return in the response.
+        # @param [String] page_token
+        #   A pagination token returned from a previous call to ListNodes method
+        #   that indicates where this listing should continue from.
+        # @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::ProdTtSasportalV1alpha1::SasPortalListNodesResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ProdTtSasportalV1alpha1::SasPortalListNodesResponse]
+        #
+        # @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 list_customer_node_nodes(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1alpha1/{+parent}/nodes', options)
+          command.response_representation = Google::Apis::ProdTtSasportalV1alpha1::SasPortalListNodesResponse::Representation
+          command.response_class = Google::Apis::ProdTtSasportalV1alpha1::SasPortalListNodesResponse
+          command.params['parent'] = parent unless parent.nil?
+          command.query['pageSize'] = page_size unless page_size.nil?
+          command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Generates a secret to be used with the ValidateInstaller method
         # @param [Google::Apis::ProdTtSasportalV1alpha1::SasPortalGenerateSecretRequest] sas_portal_generate_secret_request_object
         # @param [String] fields
@@ -1283,6 +1353,218 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Creates a device under a node or customer. Returned devices are unordered.
+        # @param [String] parent
+        #   Required. The name of the parent resource.
+        # @param [Google::Apis::ProdTtSasportalV1alpha1::SasPortalBulkCreateDeviceRequest] sas_portal_bulk_create_device_request_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::ProdTtSasportalV1alpha1::SasPortalBulkCreateDeviceResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ProdTtSasportalV1alpha1::SasPortalBulkCreateDeviceResponse]
+        #
+        # @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 bulk_node_node_device(parent, sas_portal_bulk_create_device_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1alpha1/{+parent}/devices:bulk', options)
+          command.request_representation = Google::Apis::ProdTtSasportalV1alpha1::SasPortalBulkCreateDeviceRequest::Representation
+          command.request_object = sas_portal_bulk_create_device_request_object
+          command.response_representation = Google::Apis::ProdTtSasportalV1alpha1::SasPortalBulkCreateDeviceResponse::Representation
+          command.response_class = Google::Apis::ProdTtSasportalV1alpha1::SasPortalBulkCreateDeviceResponse
+          command.params['parent'] = parent unless parent.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Creates a device under a node or customer.
+        # @param [String] parent
+        #   Required. The name of the parent resource.
+        # @param [Google::Apis::ProdTtSasportalV1alpha1::SasPortalDevice] sas_portal_device_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::ProdTtSasportalV1alpha1::SasPortalDevice] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ProdTtSasportalV1alpha1::SasPortalDevice]
+        #
+        # @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 create_node_node_device(parent, sas_portal_device_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1alpha1/{+parent}/devices', options)
+          command.request_representation = Google::Apis::ProdTtSasportalV1alpha1::SasPortalDevice::Representation
+          command.request_object = sas_portal_device_object
+          command.response_representation = Google::Apis::ProdTtSasportalV1alpha1::SasPortalDevice::Representation
+          command.response_class = Google::Apis::ProdTtSasportalV1alpha1::SasPortalDevice
+          command.params['parent'] = parent unless parent.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Creates a signed device under a
+        # node or customer.
+        # @param [String] parent
+        #   Required. The name of the parent resource.
+        # @param [Google::Apis::ProdTtSasportalV1alpha1::SasPortalCreateSignedDeviceRequest] sas_portal_create_signed_device_request_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::ProdTtSasportalV1alpha1::SasPortalDevice] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ProdTtSasportalV1alpha1::SasPortalDevice]
+        #
+        # @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 create_node_node_device_signed(parent, sas_portal_create_signed_device_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1alpha1/{+parent}/devices:createSigned', options)
+          command.request_representation = Google::Apis::ProdTtSasportalV1alpha1::SasPortalCreateSignedDeviceRequest::Representation
+          command.request_object = sas_portal_create_signed_device_request_object
+          command.response_representation = Google::Apis::ProdTtSasportalV1alpha1::SasPortalDevice::Representation
+          command.response_class = Google::Apis::ProdTtSasportalV1alpha1::SasPortalDevice
+          command.params['parent'] = parent unless parent.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Lists devices under a node or customer.
+        # @param [String] parent
+        #   Required. The name of the parent resource.
+        # @param [String] filter
+        #   The filter expression. The filter should have one of the following
+        #   formats: "sn=123454" or "display_name=MyDevice". sn
+        #   corresponds to serial_number of the device. The filter is case insensitive.
+        # @param [Fixnum] page_size
+        #   The maximum number of devices to return in the response.
+        # @param [String] page_token
+        #   A pagination token returned from a previous call to ListDevices
+        #   that indicates where this listing should continue from.
+        # @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::ProdTtSasportalV1alpha1::SasPortalListDevicesResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ProdTtSasportalV1alpha1::SasPortalListDevicesResponse]
+        #
+        # @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 list_node_node_devices(parent, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1alpha1/{+parent}/devices', options)
+          command.response_representation = Google::Apis::ProdTtSasportalV1alpha1::SasPortalListDevicesResponse::Representation
+          command.response_class = Google::Apis::ProdTtSasportalV1alpha1::SasPortalListDevicesResponse
+          command.params['parent'] = parent unless parent.nil?
+          command.query['filter'] = filter unless filter.nil?
+          command.query['pageSize'] = page_size unless page_size.nil?
+          command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Creates a new node.
+        # @param [String] parent
+        #   Required. The parent resource name where the node is to be created.
+        # @param [Google::Apis::ProdTtSasportalV1alpha1::SasPortalNode] sas_portal_node_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::ProdTtSasportalV1alpha1::SasPortalNode] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ProdTtSasportalV1alpha1::SasPortalNode]
+        #
+        # @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 create_node_node_node(parent, sas_portal_node_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1alpha1/{+parent}/nodes', options)
+          command.request_representation = Google::Apis::ProdTtSasportalV1alpha1::SasPortalNode::Representation
+          command.request_object = sas_portal_node_object
+          command.response_representation = Google::Apis::ProdTtSasportalV1alpha1::SasPortalNode::Representation
+          command.response_class = Google::Apis::ProdTtSasportalV1alpha1::SasPortalNode
+          command.params['parent'] = parent unless parent.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Lists nodes.
+        # @param [String] parent
+        #   Required. The parent resource name, for example, "nodes/1".
+        # @param [Fixnum] page_size
+        #   The maximum number of nodes to return in the response.
+        # @param [String] page_token
+        #   A pagination token returned from a previous call to ListNodes method
+        #   that indicates where this listing should continue from.
+        # @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::ProdTtSasportalV1alpha1::SasPortalListNodesResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ProdTtSasportalV1alpha1::SasPortalListNodesResponse]
+        #
+        # @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 list_node_node_nodes(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1alpha1/{+parent}/nodes', options)
+          command.response_representation = Google::Apis::ProdTtSasportalV1alpha1::SasPortalListNodesResponse::Representation
+          command.response_class = Google::Apis::ProdTtSasportalV1alpha1::SasPortalListNodesResponse
+          command.params['parent'] = parent unless parent.nil?
+          command.query['pageSize'] = page_size unless page_size.nil?
+          command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Gets the access control policy for a resource.
         # Returns an empty policy if the resource exists and does not have a policy
         # set.

data/generated/google/apis/prod_tt_sasportal_v1alpha1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://developers.google.com/spectrum-access-system/
     module ProdTtSasportalV1alpha1
       VERSION = 'V1alpha1'
-      REVISION = '20200212'
+      REVISION = '20200405'
 
       # View your email address
       AUTH_USERINFO_EMAIL = 'https://www.googleapis.com/auth/userinfo.email'

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

@@ -26,7 +26,8 @@ module Google
       class AcknowledgeRequest
         include Google::Apis::Core::Hashable
       
-        # The acknowledgment ID for the messages being acknowledged that was returned
+        # Required. The acknowledgment ID for the messages being acknowledged that was
+        # returned
         # by the Pub/Sub system in the `Pull` response. Must not be empty.
         # Corresponds to the JSON property `ackIds`
         # @return [Array<String>]
@@ -135,7 +136,7 @@ module Google
         # @return [Hash<String,String>]
         attr_accessor :labels
       
-        # The subscription whose backlog the snapshot retains.
+        # Required. The subscription whose backlog the snapshot retains.
         # Specifically, the created snapshot is guaranteed to retain:
         # (a) The existing backlog on the subscription. More precisely, this is
         # defined as the messages in the subscription's backlog that are
@@ -469,7 +470,8 @@ module Google
       class ModifyAckDeadlineRequest
         include Google::Apis::Core::Hashable
       
-        # The new ack deadline with respect to the time this request was sent to
+        # Required. The new ack deadline with respect to the time this request was sent
+        # to
         # the Pub/Sub system. For example, if the value is 10, the new
         # ack deadline will expire 10 seconds after the `ModifyAckDeadline` call
         # was made. Specifying zero might immediately make the message available for
@@ -481,7 +483,7 @@ module Google
         # @return [Fixnum]
         attr_accessor :ack_deadline_seconds
       
-        # List of acknowledgment IDs.
+        # Required. List of acknowledgment IDs.
         # Corresponds to the JSON property `ackIds`
         # @return [Array<String>]
         attr_accessor :ack_ids
@@ -670,7 +672,7 @@ module Google
       class PublishRequest
         include Google::Apis::Core::Hashable
       
-        # The messages to publish.
+        # Required. The messages to publish.
         # Corresponds to the JSON property `messages`
         # @return [Array<Google::Apis::PubsubV1::Message>]
         attr_accessor :messages
@@ -762,17 +764,21 @@ module Google
       class PullRequest
         include Google::Apis::Core::Hashable
       
-        # The maximum number of messages to return for this request. Must be a
+        # Required. The maximum number of messages to return for this request. Must be a
         # positive integer. The Pub/Sub system may return fewer than the number
         # specified.
         # Corresponds to the JSON property `maxMessages`
         # @return [Fixnum]
         attr_accessor :max_messages
       
-        # If this field set to true, the system will respond immediately even if
+        # Optional. If this field set to true, the system will respond immediately even
+        # if
         # it there are no messages available to return in the `Pull` response.
         # Otherwise, the system may wait (for a bounded amount of time) until at
-        # least one message is available, rather than returning no messages.
+        # least one message is available, rather than returning no messages. Warning:
+        # setting this field to `true` is discouraged because it adversely impacts
+        # the performance of `Pull` operations. We recommend that users do not set
+        # this field.
         # Corresponds to the JSON property `returnImmediately`
         # @return [Boolean]
         attr_accessor :return_immediately
@@ -1141,7 +1147,7 @@ module Google
         # @return [String]
         attr_accessor :message_retention_duration
       
-        # The name of the subscription. It must have the format
+        # Required. The name of the subscription. It must have the format
         # `"projects/`project`/subscriptions/`subscription`"`. ``subscription`` must
         # start with a letter, and contain only letters (`[A-Za-z]`), numbers
         # (`[0-9]`), dashes (`-`), underscores (`_`), periods (`.`), tildes (`~`),
@@ -1168,7 +1174,8 @@ module Google
         attr_accessor :retain_acked_messages
         alias_method :retain_acked_messages?, :retain_acked_messages
       
-        # The name of the topic from which this subscription is receiving messages.
+        # Required. The name of the topic from which this subscription is receiving
+        # messages.
         # Format is `projects/`project`/topics/`topic``.
         # The value of this field will be `_deleted-topic_` if the topic has been
         # deleted.
@@ -1260,7 +1267,7 @@ module Google
         # @return [Google::Apis::PubsubV1::MessageStoragePolicy]
         attr_accessor :message_storage_policy
       
-        # The name of the topic. It must have the format
+        # Required. The name of the topic. It must have the format
         # `"projects/`project`/topics/`topic`"`. ``topic`` must start with a letter,
         # and contain only letters (`[A-Za-z]`), numbers (`[0-9]`), dashes (`-`),
         # underscores (`_`), periods (`.`), tildes (`~`), plus (`+`) or percent
@@ -1297,7 +1304,7 @@ module Google
         # @return [Google::Apis::PubsubV1::Snapshot]
         attr_accessor :snapshot
       
-        # Indicates which fields in the provided snapshot to update.
+        # Required. Indicates which fields in the provided snapshot to update.
         # Must be specified and non-empty.
         # Corresponds to the JSON property `updateMask`
         # @return [String]
@@ -1323,7 +1330,7 @@ module Google
         # @return [Google::Apis::PubsubV1::Subscription]
         attr_accessor :subscription
       
-        # Indicates which fields in the provided subscription to update.
+        # Required. Indicates which fields in the provided subscription to update.
         # Must be specified and non-empty.
         # Corresponds to the JSON property `updateMask`
         # @return [String]
@@ -1349,11 +1356,12 @@ module Google
         # @return [Google::Apis::PubsubV1::Topic]
         attr_accessor :topic
       
-        # Indicates which fields in the provided topic to update. Must be specified
+        # Required. Indicates which fields in the provided topic to update. Must be
+        # specified
         # and non-empty. Note that if `update_mask` contains
-        # "message_storage_policy" then the new value will be determined based on the
-        # policy configured at the project or organization level. The
-        # `message_storage_policy` must not be set in the `topic` provided above.
+        # "message_storage_policy" but the `message_storage_policy` is not set in
+        # the `topic` provided above, then the updated value is determined by the
+        # policy configured at the project or organization level.
         # Corresponds to the JSON property `updateMask`
         # @return [String]
         attr_accessor :update_mask