Autogenerated update (2020-08-05)

Update:
- alertcenter_v1beta1
- analyticsreporting_v4
- androidenterprise_v1
- androidmanagement_v1
- apigee_v1
- chromeuxreport_v1
- classroom_v1
- cloudasset_v1
- cloudasset_v1beta1
- cloudasset_v1p4beta1
- cloudasset_v1p5beta1
- dialogflow_v2
- dialogflow_v2beta1
- driveactivity_v2
- firebase_v1beta1
- firebasedynamiclinks_v1
- firebaseml_v1
- firebaseml_v1beta2
- gameservices_v1
- gameservices_v1beta
- gmail_v1
- osconfig_v1
- policytroubleshooter_v1
- policytroubleshooter_v1beta
- recommender_v1
- recommender_v1beta1
- runtimeconfig_v1
- searchconsole_v1
- storagetransfer_v1
- tagmanager_v1
- tagmanager_v2
- vision_v1
- vision_v1p1beta1
- vision_v1p2beta1

api_names_out.yaml

@@ -109613,6 +109613,17 @@
 "/osconfig:v1/AptSettings/type": type
 "/osconfig:v1/CancelPatchJobRequest": cancel_patch_job_request
 "/osconfig:v1/Empty": empty
+"/osconfig:v1/ExecResource": exec_resource
+"/osconfig:v1/ExecResource/enforce": enforce
+"/osconfig:v1/ExecResource/validate": validate
+"/osconfig:v1/ExecResourceExec": exec_resource_exec
+"/osconfig:v1/ExecResourceExec/allowedSuccessCodes": allowed_success_codes
+"/osconfig:v1/ExecResourceExec/allowedSuccessCodes/allowed_success_code": allowed_success_code
+"/osconfig:v1/ExecResourceExec/args": args
+"/osconfig:v1/ExecResourceExec/args/arg": arg
+"/osconfig:v1/ExecResourceExec/file": file
+"/osconfig:v1/ExecResourceExec/interpreter": interpreter
+"/osconfig:v1/ExecResourceExec/script": script
 "/osconfig:v1/ExecStep": exec_step
 "/osconfig:v1/ExecStep/linuxExecStepConfig": linux_exec_step_config
 "/osconfig:v1/ExecStep/windowsExecStepConfig": windows_exec_step_config
@@ -109630,6 +109641,30 @@
 "/osconfig:v1/ExecutePatchJobRequest/instanceFilter": instance_filter
 "/osconfig:v1/ExecutePatchJobRequest/patchConfig": patch_config
 "/osconfig:v1/ExecutePatchJobRequest/rollout": rollout
+"/osconfig:v1/ExtractArchiveResource": extract_archive_resource
+"/osconfig:v1/ExtractArchiveResource/creates": creates
+"/osconfig:v1/ExtractArchiveResource/destination": destination
+"/osconfig:v1/ExtractArchiveResource/overwrite": overwrite
+"/osconfig:v1/ExtractArchiveResource/source": source
+"/osconfig:v1/ExtractArchiveResource/type": type
+"/osconfig:v1/File": file
+"/osconfig:v1/File/allowInsecure": allow_insecure
+"/osconfig:v1/File/gcs": gcs
+"/osconfig:v1/File/localPath": local_path
+"/osconfig:v1/File/remote": remote
+"/osconfig:v1/FileGcs": file_gcs
+"/osconfig:v1/FileGcs/bucket": bucket
+"/osconfig:v1/FileGcs/generation": generation
+"/osconfig:v1/FileGcs/object": object
+"/osconfig:v1/FileRemote": file_remote
+"/osconfig:v1/FileRemote/sha256Checksum": sha256_checksum
+"/osconfig:v1/FileRemote/uri": uri
+"/osconfig:v1/FileResource": file_resource
+"/osconfig:v1/FileResource/content": content
+"/osconfig:v1/FileResource/file": file
+"/osconfig:v1/FileResource/path": path
+"/osconfig:v1/FileResource/permissions": permissions
+"/osconfig:v1/FileResource/state": state
 "/osconfig:v1/FixedOrPercent": fixed_or_percent
 "/osconfig:v1/FixedOrPercent/fixed": fixed
 "/osconfig:v1/FixedOrPercent/percent": percent
@@ -109655,6 +109690,35 @@
 "/osconfig:v1/MonthlySchedule/weekDayOfMonth": week_day_of_month
 "/osconfig:v1/OneTimeSchedule": one_time_schedule
 "/osconfig:v1/OneTimeSchedule/executeTime": execute_time
+"/osconfig:v1/PackageResource": package_resource
+"/osconfig:v1/PackageResource/apt": apt
+"/osconfig:v1/PackageResource/deb": deb
+"/osconfig:v1/PackageResource/desiredState": desired_state
+"/osconfig:v1/PackageResource/googet": googet
+"/osconfig:v1/PackageResource/msi": msi
+"/osconfig:v1/PackageResource/rpm": rpm
+"/osconfig:v1/PackageResource/yum": yum
+"/osconfig:v1/PackageResource/zypper": zypper
+"/osconfig:v1/PackageResourceAPT": package_resource_apt
+"/osconfig:v1/PackageResourceAPT/name": name
+"/osconfig:v1/PackageResourceDeb": package_resource_deb
+"/osconfig:v1/PackageResourceDeb/pullDeps": pull_deps
+"/osconfig:v1/PackageResourceDeb/source": source
+"/osconfig:v1/PackageResourceGooGet": package_resource_goo_get
+"/osconfig:v1/PackageResourceGooGet/name": name
+"/osconfig:v1/PackageResourceMSI": package_resource_msi
+"/osconfig:v1/PackageResourceMSI/allowedSuccessCodes": allowed_success_codes
+"/osconfig:v1/PackageResourceMSI/allowedSuccessCodes/allowed_success_code": allowed_success_code
+"/osconfig:v1/PackageResourceMSI/flags": flags
+"/osconfig:v1/PackageResourceMSI/flags/flag": flag
+"/osconfig:v1/PackageResourceMSI/source": source
+"/osconfig:v1/PackageResourceRPM": package_resource_rpm
+"/osconfig:v1/PackageResourceRPM/pullDeps": pull_deps
+"/osconfig:v1/PackageResourceRPM/source": source
+"/osconfig:v1/PackageResourceYUM": package_resource_yum
+"/osconfig:v1/PackageResourceYUM/name": name
+"/osconfig:v1/PackageResourceZypper": package_resource_zypper
+"/osconfig:v1/PackageResourceZypper/name": name
 "/osconfig:v1/PatchConfig": patch_config
 "/osconfig:v1/PatchConfig/apt": apt
 "/osconfig:v1/PatchConfig/goo": goo
@@ -109740,6 +109804,34 @@
 "/osconfig:v1/RecurringSchedule/timeOfDay": time_of_day
 "/osconfig:v1/RecurringSchedule/timeZone": time_zone
 "/osconfig:v1/RecurringSchedule/weekly": weekly
+"/osconfig:v1/RepositoryResource": repository_resource
+"/osconfig:v1/RepositoryResource/apt": apt
+"/osconfig:v1/RepositoryResource/goo": goo
+"/osconfig:v1/RepositoryResource/yum": yum
+"/osconfig:v1/RepositoryResource/zypper": zypper
+"/osconfig:v1/RepositoryResourceAptRepository": repository_resource_apt_repository
+"/osconfig:v1/RepositoryResourceAptRepository/archiveType": archive_type
+"/osconfig:v1/RepositoryResourceAptRepository/components": components
+"/osconfig:v1/RepositoryResourceAptRepository/components/component": component
+"/osconfig:v1/RepositoryResourceAptRepository/distribution": distribution
+"/osconfig:v1/RepositoryResourceAptRepository/gpgKey": gpg_key
+"/osconfig:v1/RepositoryResourceAptRepository/uri": uri
+"/osconfig:v1/RepositoryResourceGooRepository": repository_resource_goo_repository
+"/osconfig:v1/RepositoryResourceGooRepository/name": name
+"/osconfig:v1/RepositoryResourceGooRepository/url": url
+"/osconfig:v1/RepositoryResourceYumRepository": repository_resource_yum_repository
+"/osconfig:v1/RepositoryResourceYumRepository/baseUrl": base_url
+"/osconfig:v1/RepositoryResourceYumRepository/displayName": display_name
+"/osconfig:v1/RepositoryResourceYumRepository/gpgKeys": gpg_keys
+"/osconfig:v1/RepositoryResourceYumRepository/gpgKeys/gpg_key": gpg_key
+"/osconfig:v1/RepositoryResourceYumRepository/id": id
+"/osconfig:v1/RepositoryResourceZypperRepository": repository_resource_zypper_repository
+"/osconfig:v1/RepositoryResourceZypperRepository/baseUrl": base_url
+"/osconfig:v1/RepositoryResourceZypperRepository/displayName": display_name
+"/osconfig:v1/RepositoryResourceZypperRepository/gpgKeys": gpg_keys
+"/osconfig:v1/RepositoryResourceZypperRepository/gpgKeys/gpg_key": gpg_key
+"/osconfig:v1/RepositoryResourceZypperRepository/id": id
+"/osconfig:v1/ServiceResource": service_resource
 "/osconfig:v1/TimeOfDay": time_of_day
 "/osconfig:v1/TimeOfDay/hours": hours
 "/osconfig:v1/TimeOfDay/minutes": minutes

generated/google/apis/alertcenter_v1beta1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://developers.google.com/admin-sdk/alertcenter/
     module AlertcenterV1beta1
       VERSION = 'V1beta1'
-      REVISION = '20200404'
+      REVISION = '20200801'
 
       # See and delete your domain's G Suite alerts, and send alert feedback
       AUTH_APPS_ALERTS = 'https://www.googleapis.com/auth/apps.alerts'

generated/google/apis/alertcenter_v1beta1/classes.rb

@@ -81,16 +81,16 @@ module Google
         # @return [String]
         attr_accessor :query
       
-        # List of alert IDs superseded by this alert. It is used to indicate that
+        # List of alert IDs superseded by this alert. It is used to indicate that this
-        # this alert is essentially extension of superseded alerts and we found the
+        # alert is essentially extension of superseded alerts and we found the
         # relationship after creating these alerts.
         # Corresponds to the JSON property `supersededAlerts`
         # @return [Array<String>]
         attr_accessor :superseded_alerts
       
-        # Alert ID superseding this alert. It is used to indicate that superseding
+        # Alert ID superseding this alert. It is used to indicate that superseding alert
-        # alert is essentially extension of this alert and we found the relationship
+        # is essentially extension of this alert and we found the relationship after
-        # after creating both alerts.
+        # creating both alerts.
         # Corresponds to the JSON property `supersedingAlert`
         # @return [String]
         attr_accessor :superseding_alert
@@ -100,10 +100,8 @@ module Google
         # @return [String]
         attr_accessor :threshold
       
-        # The trigger sources for this rule.
+        # The trigger sources for this rule. * GMAIL_EVENTS * DEVICE_EVENTS *
-        # * GMAIL_EVENTS
+        # USER_EVENTS
-        # * DEVICE_EVENTS
-        # * USER_EVENTS
         # Corresponds to the JSON property `triggerSource`
         # @return [String]
         attr_accessor :trigger_source
@@ -158,8 +156,8 @@ module Google
         # @return [String]
         attr_accessor :customer_id
       
-        # Optional. The data associated with this alert, for example
+        # Optional. The data associated with this alert, for example google.apps.
-        # google.apps.alertcenter.type.DeviceCompromised.
+        # alertcenter.type.DeviceCompromised.
         # Corresponds to the JSON property `data`
         # @return [Hash<String,Object>]
         attr_accessor :data
@@ -170,22 +168,22 @@ module Google
         attr_accessor :deleted
         alias_method :deleted?, :deleted
       
-        # Optional. The time the event that caused this alert ceased being active.
+        # Optional. The time the event that caused this alert ceased being active. If
-        # If provided, the end time must not be earlier than the start time.
+        # provided, the end time must not be earlier than the start time. If not
-        # If not provided, it indicates an ongoing alert.
+        # provided, it indicates an ongoing alert.
         # Corresponds to the JSON property `endTime`
         # @return [String]
         attr_accessor :end_time
       
         # Optional. `etag` is used for optimistic concurrency control as a way to help
-        # prevent simultaneous updates of an alert from overwriting each other.
+        # prevent simultaneous updates of an alert from overwriting each other. It is
-        # It is strongly suggested that systems make use of the `etag` in the
+        # strongly suggested that systems make use of the `etag` in the read-modify-
-        # read-modify-write cycle to perform alert updates in order to avoid race
+        # write cycle to perform alert updates in order to avoid race conditions: An `
-        # conditions: An `etag` is returned in the response which contains alerts,
+        # etag` is returned in the response which contains alerts, and systems are
-        # and systems are expected to put that etag in the request to update alert to
+        # expected to put that etag in the request to update alert to ensure that their
-        # ensure that their change will be applied to the same version of the alert.
+        # change will be applied to the same version of the alert. If no `etag` is
-        # If no `etag` is provided in the call to update alert, then the existing
+        # provided in the call to update alert, then the existing alert is overwritten
-        # alert is overwritten blindly.
+        # blindly.
         # Corresponds to the JSON property `etag`
         # @return [String]
         attr_accessor :etag
@@ -195,36 +193,28 @@ module Google
         # @return [Google::Apis::AlertcenterV1beta1::AlertMetadata]
         attr_accessor :metadata
       
-        # Output only. An optional
+        # Output only. An optional [Security Investigation Tool](https://support.google.
-        # [Security Investigation Tool](https://support.google.com/a/answer/7575955)
+        # com/a/answer/7575955) query for this alert.
-        # query for this alert.
         # Corresponds to the JSON property `securityInvestigationToolLink`
         # @return [String]
         attr_accessor :security_investigation_tool_link
       
-        # Required. A unique identifier for the system that reported the alert.
+        # Required. A unique identifier for the system that reported the alert. This is
-        # This is output only after alert is created.
+        # output only after alert is created. Supported sources are any of the following:
-        # Supported sources are any of the following:
+        # * Google Operations * Mobile device management * Gmail phishing * Domain wide
-        # * Google Operations
+        # takeout * State sponsored attack * Google identity
-        # * Mobile device management
-        # * Gmail phishing
-        # * Domain wide takeout
-        # * State sponsored attack
-        # * Google identity
         # Corresponds to the JSON property `source`
         # @return [String]
         attr_accessor :source
       
-        # Required. The time the event that caused this alert was started or
+        # Required. The time the event that caused this alert was started or detected.
-        # detected.
         # Corresponds to the JSON property `startTime`
         # @return [String]
         attr_accessor :start_time
       
-        # Required. The type of the alert.
+        # Required. The type of the alert. This is output only after alert is created.
-        # This is output only after alert is created.
+        # For a list of available alert types see [G Suite Alert types](/admin-sdk/
-        # For a list of available alert types see
+        # alertcenter/reference/alert-types).
-        # [G Suite Alert types](/admin-sdk/alertcenter/reference/alert-types).
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type
@@ -324,36 +314,29 @@ module Google
         # @return [String]
         attr_accessor :customer_id
       
-        # Optional. `etag` is used for optimistic concurrency control as a way to
+        # Optional. `etag` is used for optimistic concurrency control as a way to help
-        # help prevent simultaneous updates of an alert metadata from overwriting
+        # prevent simultaneous updates of an alert metadata from overwriting each other.
-        # each other. It is strongly suggested that systems make use of the `etag` in
+        # It is strongly suggested that systems make use of the `etag` in the read-
-        # the read-modify-write cycle to perform metatdata updates in order to avoid
+        # modify-write cycle to perform metatdata updates in order to avoid race
-        # race conditions: An `etag` is returned in the response which contains alert
+        # conditions: An `etag` is returned in the response which contains alert
-        # metadata, and systems are expected to put that etag in the request to
+        # metadata, and systems are expected to put that etag in the request to update
-        # update alert metadata to ensure that their change will be applied to the
+        # alert metadata to ensure that their change will be applied to the same version
-        # same version of the alert metadata.
+        # of the alert metadata. If no `etag` is provided in the call to update alert
-        # If no `etag` is provided in the call to update alert metadata, then the
+        # metadata, then the existing alert metadata is overwritten blindly.
-        # existing alert metadata is overwritten blindly.
         # Corresponds to the JSON property `etag`
         # @return [String]
         attr_accessor :etag
       
         # The severity value of the alert. Alert Center will set this field at alert
-        # creation time, default's to an empty string when it could not be
+        # creation time, default's to an empty string when it could not be determined.
-        # determined.
+        # The supported values for update actions on this field are the following: *
-        # The supported values for update actions on this field are the following:
+        # HIGH * MEDIUM * LOW
-        # * HIGH
-        # * MEDIUM
-        # * LOW
         # Corresponds to the JSON property `severity`
         # @return [String]
         attr_accessor :severity
       
-        # The current status of the alert.
+        # The current status of the alert. The supported values are the following: *
-        # The supported values are the following:
+        # NOT_STARTED * IN_PROGRESS * CLOSED
-        # * NOT_STARTED
-        # * IN_PROGRESS
-        # * CLOSED
         # Corresponds to the JSON property `status`
         # @return [String]
         attr_accessor :status
@@ -402,8 +385,8 @@ module Google
       class Attachment
         include Google::Apis::Core::Hashable
       
-        # A representation of a CSV file attachment, as a list of column headers and
+        # A representation of a CSV file attachment, as a list of column headers and a
-        # a list of data rows.
+        # list of data rows.
         # Corresponds to the JSON property `csv`
         # @return [Google::Apis::AlertcenterV1beta1::Csv]
         attr_accessor :csv
@@ -438,8 +421,7 @@ module Google
         # @return [Array<Google::Apis::AlertcenterV1beta1::GmailMessageInfo>]
         attr_accessor :messages
       
-        # The source IP address of the malicious email, for example,
+        # The source IP address of the malicious email, for example, `127.0.0.1`.
-        # `127.0.0.1`.
         # Corresponds to the JSON property `sourceIp`
         # @return [String]
         attr_accessor :source_ip
@@ -559,21 +541,20 @@ module Google
         end
       end
       
-      # A reference to a Cloud Pubsub topic.
+      # A reference to a Cloud Pubsub topic. To register for notifications, the owner
-      # To register for notifications, the owner of the topic must grant
+      # of the topic must grant `alerts-api-push-notifications@system.gserviceaccount.
-      # `alerts-api-push-notifications@system.gserviceaccount.com` the
+      # com` the `projects.topics.publish` permission.
-      # `projects.topics.publish` permission.
       class CloudPubsubTopic
         include Google::Apis::Core::Hashable
       
-        # Optional. The format of the payload that would be sent.
+        # Optional. The format of the payload that would be sent. If not specified the
-        # If not specified the format will be JSON.
+        # format will be JSON.
         # Corresponds to the JSON property `payloadFormat`
         # @return [String]
         attr_accessor :payload_format
       
-        # The `name` field of a Cloud Pubsub [Topic]
+        # The `name` field of a Cloud Pubsub [Topic] (https://cloud.google.com/pubsub/
-        # (https://cloud.google.com/pubsub/docs/reference/rest/v1/projects.topics#Topic).
+        # docs/reference/rest/v1/projects.topics#Topic).
         # Corresponds to the JSON property `topicName`
         # @return [String]
         attr_accessor :topic_name
@@ -589,13 +570,13 @@ module Google
         end
       end
       
-      # A representation of a CSV file attachment, as a list of column headers and
+      # A representation of a CSV file attachment, as a list of column headers and a
-      # a list of data rows.
+      # list of data rows.
       class Csv
         include Google::Apis::Core::Hashable
       
-        # The list of data rows in a CSV file, as string arrays rather than as a
+        # The list of data rows in a CSV file, as string arrays rather than as a single
-        # single comma-separated string.
+        # comma-separated string.
         # Corresponds to the JSON property `dataRows`
         # @return [Array<Google::Apis::AlertcenterV1beta1::CsvRow>]
         attr_accessor :data_rows
@@ -620,8 +601,8 @@ module Google
       class CsvRow
         include Google::Apis::Core::Hashable
       
-        # The data entries in a CSV file row, as a string array rather than a
+        # The data entries in a CSV file row, as a string array rather than a single
-        # single comma-separated string.
+        # comma-separated string.
         # Corresponds to the JSON property `entries`
         # @return [Array<String>]
         attr_accessor :entries
@@ -665,8 +646,8 @@ module Google
       class DeviceCompromisedSecurityDetail
         include Google::Apis::Core::Hashable
       
-        # The device compromised state. Possible values are "`Compromised`" or
+        # The device compromised state. Possible values are "`Compromised`" or "`Not
-        # "`Not Compromised`".
+        # Compromised`".
         # Corresponds to the JSON property `deviceCompromisedState`
         # @return [String]
         attr_accessor :device_compromised_state
@@ -782,13 +763,11 @@ module Google
         end
       end
       
-      # A generic empty message that you can re-use to avoid defining duplicated
+      # A generic empty message that you can re-use to avoid defining duplicated empty
-      # empty messages in your APIs. A typical example is to use it as the request
+      # messages in your APIs. A typical example is to use it as the request or the
-      # or the response type of an API method. For instance:
+      # response type of an API method. For instance: service Foo ` rpc Bar(google.
-      # service Foo `
+      # protobuf.Empty) returns (google.protobuf.Empty); ` The JSON representation for
-      # rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
+      # `Empty` is empty JSON object ````.
-      # `
-      # The JSON representation for `Empty` is empty JSON object ````.
       class Empty
         include Google::Apis::Core::Hashable
       
@@ -904,8 +883,8 @@ module Google
       class ListAlertFeedbackResponse
         include Google::Apis::Core::Hashable
       
-        # The list of alert feedback.
+        # The list of alert feedback. Feedback entries for each alert are ordered by
-        # Feedback entries for each alert are ordered by creation time descending.
+        # creation time descending.
         # Corresponds to the JSON property `feedback`
         # @return [Array<Google::Apis::AlertcenterV1beta1::AlertFeedback>]
         attr_accessor :feedback
@@ -930,9 +909,9 @@ module Google
         attr_accessor :alerts
       
         # The token for the next page. If not empty, indicates that there may be more
-        # alerts that match the listing request; this value can be used in a
+        # alerts that match the listing request; this value can be used in a subsequent
-        # subsequent ListAlertsRequest to get alerts continuing from last result
+        # ListAlertsRequest to get alerts continuing from last result of the current
-        # of the current list call.
+        # list call.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
@@ -952,14 +931,14 @@ module Google
       class LoginDetails
         include Google::Apis::Core::Hashable
       
-        # Optional. The human-readable IP address (for example,
+        # Optional. The human-readable IP address (for example, `11.22.33.44`) that is
-        # `11.22.33.44`) that is associated with the warning event.
+        # associated with the warning event.
         # Corresponds to the JSON property `ipAddress`
         # @return [String]
         attr_accessor :ip_address
       
-        # Optional. The successful login time that is associated with the warning
+        # Optional. The successful login time that is associated with the warning event.
-        # event. This isn't present for blocked login attempts.
+        # This isn't present for blocked login attempts.
         # Corresponds to the JSON property `loginTime`
         # @return [String]
         attr_accessor :login_time
@@ -975,14 +954,10 @@ module Google
         end
       end
       
-      # Proto for all phishing alerts with common payload.
+      # Proto for all phishing alerts with common payload. Supported types are any of
-      # Supported types are any of the following:
+      # the following: * User reported phishing * User reported spam spike *
-      # * User reported phishing
+      # Suspicious message reported * Phishing reclassification * Malware
-      # * User reported spam spike
+      # reclassification * Gmail potential employee spoofing
-      # * Suspicious message reported
-      # * Phishing reclassification
-      # * Malware reclassification
-      # * Gmail potential employee spoofing
       class MailPhishing
         include Google::Apis::Core::Hashable
       
@@ -1082,16 +1057,14 @@ module Google
         end
       end
       
-      # Settings for callback notifications.
+      # Settings for callback notifications. For more details see [G Suite Alert
-      # For more details see [G Suite Alert
       # Notification](/admin-sdk/alertcenter/guides/notifications).
       class Notification
         include Google::Apis::Core::Hashable
       
-        # A reference to a Cloud Pubsub topic.
+        # A reference to a Cloud Pubsub topic. To register for notifications, the owner
-        # To register for notifications, the owner of the topic must grant
+        # of the topic must grant `alerts-api-push-notifications@system.gserviceaccount.
-        # `alerts-api-push-notifications@system.gserviceaccount.com` the
+        # com` the `projects.topics.publish` permission.
-        # `projects.topics.publish` permission.
         # Corresponds to the JSON property `cloudPubsubTopic`
         # @return [Google::Apis::AlertcenterV1beta1::CloudPubsubTopic]
         attr_accessor :cloud_pubsub_topic
@@ -1106,10 +1079,9 @@ module Google
         end
       end
       
-      # Alert for a spike in user reported phishing.
+      # Alert for a spike in user reported phishing. *Warning*: This type has been
-      # <aside class="warning"><b>Warning</b>: This type has been deprecated. Use
+      # deprecated. Use [MailPhishing](/admin-sdk/alertcenter/reference/rest/v1beta1/
-      # [MailPhishing](/admin-sdk/alertcenter/reference/rest/v1beta1/MailPhishing)
+      # MailPhishing) instead.
-      # instead.</aside>
       class PhishingSpike
         include Google::Apis::Core::Hashable
       
@@ -1170,8 +1142,7 @@ module Google
       class RequestInfo
         include Google::Apis::Core::Hashable
       
-        # List of app developers who triggered notifications for above
+        # List of app developers who triggered notifications for above application.
-        # application.
         # Corresponds to the JSON property `appDeveloperEmail`
         # @return [Array<String>]
         attr_accessor :app_developer_email
@@ -1181,8 +1152,8 @@ module Google
         # @return [String]
         attr_accessor :app_key
       
-        # Required. Number of requests sent for this application to set up default
+        # Required. Number of requests sent for this application to set up default SQL
-        # SQL instance.
+        # instance.
         # Corresponds to the JSON property `numberOfRequests`
         # @return [Fixnum]
         attr_accessor :number_of_requests
@@ -1264,13 +1235,11 @@ module Google
         # @return [Array<Google::Apis::AlertcenterV1beta1::MatchInfo>]
         attr_accessor :match_info
       
-        # Resource recipients.
+        # Resource recipients. For Drive, they are grantees that the Drive file was
-        # For Drive, they are grantees that the Drive file was shared with at the
+        # shared with at the time of rule triggering. Valid values include user emails,
-        # time of rule triggering. Valid values include user emails, group emails,
+        # group emails, domains, or 'anyone' if the file was publicly accessible. If the
-        # domains, or 'anyone' if the file was publicly accessible. If the file was
+        # file was private the recipients list will be empty. For Gmail, they are emails
-        # private the recipients list will be empty.
+        # of the users or groups that the Gmail message was sent to.
-        # For Gmail, they are emails of the users or groups that the Gmail message
-        # was sent to.
         # Corresponds to the JSON property `recipients`
         # @return [Array<String>]
         attr_accessor :recipients
@@ -1362,12 +1331,12 @@ module Google
         end
       end
       
-      # The `Status` type defines a logical error model that is suitable for
+      # The `Status` type defines a logical error model that is suitable for different
-      # different programming environments, including REST APIs and RPC APIs. It is
+      # programming environments, including REST APIs and RPC APIs. It is used by [
-      # used by [gRPC](https://github.com/grpc). Each `Status` message contains
+      # gRPC](https://github.com/grpc). Each `Status` message contains three pieces of
-      # three pieces of data: error code, error message, and error details.
+      # data: error code, error message, and error details. You can find out more
-      # You can find out more about this error model and how to work with it in the
+      # about this error model and how to work with it in the [API Design Guide](https:
-      # [API Design Guide](https://cloud.google.com/apis/design/errors).
+      # //cloud.google.com/apis/design/errors).
       class Status
         include Google::Apis::Core::Hashable
       
@@ -1376,15 +1345,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
+        # A developer-facing error message, which should be in English. Any user-facing
-        # user-facing error message should be localized and sent in the
+        # error message should be localized and sent in the google.rpc.Status.details
-        # google.rpc.Status.details field, or localized by the client.
+        # field, or localized by the client.
         # Corresponds to the JSON property `message`
         # @return [String]
         attr_accessor :message
@@ -1498,8 +1467,8 @@ module Google
         include Google::Apis::Core::Hashable
       
         # Optional. The unique identifier of the G Suite organization account of the
-        # customer the alert is associated with.
+        # customer the alert is associated with. Inferred from the caller identity if
-        # Inferred from the caller identity if not provided.
+        # not provided.
         # Corresponds to the JSON property `customerId`
         # @return [String]
         attr_accessor :customer_id

generated/google/apis/alertcenter_v1beta1/service.rb

@@ -108,16 +108,16 @@ module Google
         end
         
         # Marks the specified alert for deletion. An alert that has been marked for
-        # deletion is removed from Alert Center after 30 days.
+        # deletion is removed from Alert Center after 30 days. Marking an alert for
-        # Marking an alert for deletion has no effect on an alert which has
+        # deletion has no effect on an alert which has already been marked for deletion.
-        # already been marked for deletion. Attempting to mark a nonexistent alert
+        # Attempting to mark a nonexistent alert for deletion results in a `NOT_FOUND`
-        # for deletion results in a `NOT_FOUND` error.
+        # error.
         # @param [String] alert_id
         #   Required. The identifier of the alert to delete.
         # @param [String] customer_id
         #   Optional. The unique identifier of the G Suite organization account of the
-        #   customer the alert is associated with.
+        #   customer the alert is associated with. Inferred from the caller identity if
-        #   Inferred from the caller identity if not provided.
+        #   not provided.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -146,14 +146,14 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets the specified alert. Attempting to get a nonexistent alert returns
+        # Gets the specified alert. Attempting to get a nonexistent alert returns `
-        # `NOT_FOUND` error.
+        # NOT_FOUND` error.
         # @param [String] alert_id
         #   Required. The identifier of the alert to retrieve.
         # @param [String] customer_id
         #   Optional. The unique identifier of the G Suite organization account of the
-        #   customer the alert is associated with.
+        #   customer the alert is associated with. Inferred from the caller identity if
-        #   Inferred from the caller identity if not provided.
+        #   not provided.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -182,14 +182,14 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Returns the metadata of an alert. Attempting to get metadata for
+        # Returns the metadata of an alert. Attempting to get metadata for a non-
-        # a non-existent alert returns `NOT_FOUND` error.
+        # existent alert returns `NOT_FOUND` error.
         # @param [String] alert_id
         #   Required. The identifier of the alert this metadata belongs to.
         # @param [String] customer_id
         #   Optional. The unique identifier of the G Suite organization account of the
-        #   customer the alert metadata is associated with.
+        #   customer the alert metadata is associated with. Inferred from the caller
-        #   Inferred from the caller identity if not provided.
+        #   identity if not provided.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -221,29 +221,26 @@ module Google
         # Lists the alerts.
         # @param [String] customer_id
         #   Optional. The unique identifier of the G Suite organization account of the
-        #   customer the alerts are associated with.
+        #   customer the alerts are associated with. Inferred from the caller identity if
-        #   Inferred from the caller identity if not provided.
+        #   not provided.
         # @param [String] filter
-        #   Optional. A query string for filtering alert results.
+        #   Optional. A query string for filtering alert results. For more details, see [
-        #   For more details, see [Query
+        #   Query filters](/admin-sdk/alertcenter/guides/query-filters) and [Supported
-        #   filters](/admin-sdk/alertcenter/guides/query-filters) and [Supported
+        #   query filter fields](/admin-sdk/alertcenter/reference/filter-fields#alerts.
-        #   query filter
+        #   list).
-        #   fields](/admin-sdk/alertcenter/reference/filter-fields#alerts.list).
         # @param [String] order_by
-        #   Optional. The sort order of the list results.
+        #   Optional. The sort order of the list results. If not specified results may be
-        #   If not specified results may be returned in arbitrary order.
+        #   returned in arbitrary order. You can sort the results in descending order
-        #   You can sort the results in descending order based on the creation
+        #   based on the creation timestamp using `order_by="create_time desc"`. Currently,
-        #   timestamp using `order_by="create_time desc"`.
+        #   supported sorting are `create_time asc`, `create_time desc`, `update_time
-        #   Currently, supported sorting are `create_time asc`, `create_time desc`,
+        #   desc`
-        #   `update_time desc`
         # @param [Fixnum] page_size
         #   Optional. The requested page size. Server may return fewer items than
         #   requested. If unspecified, server picks an appropriate default.
         # @param [String] page_token
-        #   Optional. A token identifying a page of results the server should return.
+        #   Optional. A token identifying a page of results the server should return. If
-        #   If empty, a new iteration is started. To continue an iteration, pass in
+        #   empty, a new iteration is started. To continue an iteration, pass in the value
-        #   the value from the previous ListAlertsResponse's
+        #   from the previous ListAlertsResponse's next_page_token field.
-        #   next_page_token field.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -277,9 +274,9 @@ module Google
         
         # Restores, or "undeletes", an alert that was marked for deletion within the
         # past 30 days. Attempting to undelete an alert which was marked for deletion
-        # over 30 days ago (which has been removed from the Alert Center database) or
+        # over 30 days ago (which has been removed from the Alert Center database) or a
-        # a nonexistent alert returns a `NOT_FOUND` error. Attempting to
+        # nonexistent alert returns a `NOT_FOUND` error. Attempting to undelete an alert
-        # undelete an alert which has not been marked for deletion has no effect.
+        # which has not been marked for deletion has no effect.
         # @param [String] alert_id
         #   Required. The identifier of the alert to undelete.
         # @param [Google::Apis::AlertcenterV1beta1::UndeleteAlertRequest] undelete_alert_request_object
@@ -312,17 +309,16 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates new feedback for an alert. Attempting to create a feedback for
+        # Creates new feedback for an alert. Attempting to create a feedback for a non-
-        # a non-existent alert returns `NOT_FOUND` error. Attempting to create a
+        # existent alert returns `NOT_FOUND` error. Attempting to create a feedback for
-        # feedback for an alert that is marked for deletion returns
+        # an alert that is marked for deletion returns `FAILED_PRECONDITION' error.
-        # `FAILED_PRECONDITION' error.
         # @param [String] alert_id
         #   Required. The identifier of the alert this feedback belongs to.
         # @param [Google::Apis::AlertcenterV1beta1::AlertFeedback] alert_feedback_object
         # @param [String] customer_id
         #   Optional. The unique identifier of the G Suite organization account of the
-        #   customer the alert is associated with.
+        #   customer the alert is associated with. Inferred from the caller identity if
-        #   Inferred from the caller identity if not provided.
+        #   not provided.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -353,21 +349,20 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists all the feedback for an alert. Attempting to list feedbacks for
+        # Lists all the feedback for an alert. Attempting to list feedbacks for a non-
-        # a non-existent alert returns `NOT_FOUND` error.
+        # existent alert returns `NOT_FOUND` error.
         # @param [String] alert_id
-        #   Required. The alert identifier.
+        #   Required. The alert identifier. The "-" wildcard could be used to represent
-        #   The "-" wildcard could be used to represent all alerts.
+        #   all alerts.
         # @param [String] customer_id
         #   Optional. The unique identifier of the G Suite organization account of the
-        #   customer the alert feedback are associated with.
+        #   customer the alert feedback are associated with. Inferred from the caller
-        #   Inferred from the caller identity if not provided.
+        #   identity if not provided.
         # @param [String] filter
-        #   Optional. A query string for filtering alert feedback results.
+        #   Optional. A query string for filtering alert feedback results. For more
-        #   For more details, see [Query
+        #   details, see [Query filters](/admin-sdk/alertcenter/guides/query-filters) and [
-        #   filters](/admin-sdk/alertcenter/guides/query-filters) and [Supported
+        #   Supported query filter fields](/admin-sdk/alertcenter/reference/filter-fields#
-        #   query filter
+        #   alerts.feedback.list).
-        #   fields](/admin-sdk/alertcenter/reference/filter-fields#alerts.feedback.list).
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -400,8 +395,8 @@ module Google
         # Returns customer-level settings.
         # @param [String] customer_id
         #   Optional. The unique identifier of the G Suite organization account of the
-        #   customer the alert settings are associated with.
+        #   customer the alert settings are associated with. Inferred from the caller
-        #   Inferred from the caller identity if not provided.
+        #   identity if not provided.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -433,8 +428,8 @@ module Google
         # @param [Google::Apis::AlertcenterV1beta1::Settings] settings_object
         # @param [String] customer_id
         #   Optional. The unique identifier of the G Suite organization account of the
-        #   customer the alert settings are associated with.
+        #   customer the alert settings are associated with. Inferred from the caller
-        #   Inferred from the caller identity if not provided.
+        #   identity if not provided.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user

generated/google/apis/analyticsreporting_v4.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://developers.google.com/analytics/devguides/reporting/core/v4/
     module AnalyticsreportingV4
       VERSION = 'V4'
-      REVISION = '20200210'
+      REVISION = '20200803'
 
       # View and manage your Google Analytics data
       AUTH_ANALYTICS = 'https://www.googleapis.com/auth/analytics'

generated/google/apis/androidenterprise_v1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://developers.google.com/android/work/play/emm-api
     module AndroidenterpriseV1
       VERSION = 'V1'
-      REVISION = '20200704'
+      REVISION = '20200801'
 
       # Manage corporate Android devices
       AUTH_ANDROIDENTERPRISE = 'https://www.googleapis.com/auth/androidenterprise'

generated/google/apis/androidenterprise_v1/service.rb

@@ -47,11 +47,10 @@ module Google
           @batch_path = 'batch/androidenterprise/v1'
         end
         
-        # Uploads a report containing any changes in app states on the device since
+        # Uploads a report containing any changes in app states on the device since the
-        # the last report was generated. You can call this method up to 3 times every
+        # last report was generated. You can call this method up to 3 times every 24
-        # 24 hours for a given device.
+        # hours for a given device. If you exceed the quota, then the Google Play EMM
-        # If you exceed the quota, then the Google Play EMM API returns <code>HTTP
+        # API returns HTTP 429 Too Many Requests.
-        # 429 Too Many Requests</code>.
         # @param [String] enterprise_id
         #   The ID of the enterprise.
         # @param [String] user_id
@@ -121,13 +120,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Retrieves whether a device's access to Google services is enabled or
+        # Retrieves whether a device's access to Google services is enabled or disabled.
-        # disabled.
         # The device state takes effect only if enforcing EMM policies on Android
-        # devices is enabled in the Google Admin Console.
+        # devices is enabled in the Google Admin Console. Otherwise, the device state is
-        # Otherwise, the device state is ignored and all devices are allowed access
+        # ignored and all devices are allowed access to Google services. This is only
-        # to Google services.
+        # supported for Google-managed users.
-        # This is only supported for Google-managed users.
         # @param [String] enterprise_id
         #   The ID of the enterprise.
         # @param [String] user_id
@@ -196,12 +193,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Sets whether a device's access to Google services is enabled or disabled.
+        # Sets whether a device's access to Google services is enabled or disabled. The
-        # The device state takes effect only if enforcing EMM policies on Android
+        # device state takes effect only if enforcing EMM policies on Android devices is
-        # devices is enabled in the Google Admin Console.
+        # enabled in the Google Admin Console. Otherwise, the device state is ignored
-        # Otherwise, the device state is ignored and all devices are allowed access
+        # and all devices are allowed access to Google services. This is only supported
-        # to Google services.
+        # for Google-managed users.
-        # This is only supported for Google-managed users.
         # @param [String] enterprise_id
         #   The ID of the enterprise.
         # @param [String] user_id
@@ -249,10 +245,9 @@ module Google
         #   The ID of the device.
         # @param [Google::Apis::AndroidenterpriseV1::Device] device_object
         # @param [String] update_mask
-        #   Mask that identifies which fields to update. If not set, all modifiable
+        #   Mask that identifies which fields to update. If not set, all modifiable fields
-        #   fields will be modified.
+        #   will be modified. When set in a query parameter, this field should be
-        #   When set in a query parameter, this field should be specified as
+        #   specified as updateMask=<field1>,<field2>,...
-        #   <code>updateMask=&lt;field1&gt;,&lt;field2&gt;,...</code>
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -285,12 +280,12 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Acknowledges notifications that were received from
+        # Acknowledges notifications that were received from Enterprises.
-        # Enterprises.PullNotificationSet to prevent subsequent calls from returning
+        # PullNotificationSet to prevent subsequent calls from returning the same
-        # the same notifications.
+        # notifications.
         # @param [String] notification_set_id
-        #   The notification set ID as returned by Enterprises.PullNotificationSet.
+        #   The notification set ID as returned by Enterprises.PullNotificationSet. This
-        #   This must be provided.
+        #   must be provided.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -316,9 +311,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Completes the signup flow, by specifying the Completion token and
+        # Completes the signup flow, by specifying the Completion token and Enterprise
-        # Enterprise token.
+        # token. This request must not be called multiple times for a given Enterprise
-        # This request must not be called multiple times for a given Enterprise
         # Token.
         # @param [String] completion_token
         #   The Completion token initially returned by GenerateSignupUrl.
@@ -352,10 +346,10 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Returns a unique token to access an embeddable UI. To generate a
+        # Returns a unique token to access an embeddable UI. To generate a web UI, pass
-        # web UI, pass the generated token into the managed Google Play javascript
+        # the generated token into the managed Google Play javascript API. Each token
-        # API. Each token may only be used to start one UI session. See the
+        # may only be used to start one UI session. See the javascript API documentation
-        # javascript API documentation for further information.
+        # for further information.
         # @param [String] enterprise_id
         #   The ID of the enterprise.
         # @param [Google::Apis::AndroidenterpriseV1::AdministratorWebTokenSpec] administrator_web_token_spec_object
@@ -424,13 +418,12 @@ module Google
         # Generates a sign-up URL.
         # @param [String] callback_url
         #   The callback URL to which the Admin will be redirected after successfully
-        #   creating an enterprise. Before redirecting there the system will add a
+        #   creating an enterprise. Before redirecting there the system will add a single
-        #   single query parameter to this URL named "enterpriseToken" which will
+        #   query parameter to this URL named "enterpriseToken" which will contain an
-        #   contain an opaque token to be used for the CompleteSignup request.<br>
+        #   opaque token to be used for the CompleteSignup request. Beware that this means
-        #   Beware that this means that the URL will be parsed, the parameter added
+        #   that the URL will be parsed, the parameter added and then a new URL formatted,
-        #   and then a new URL formatted, i.e. there may be some minor formatting
+        #   i.e. there may be some minor formatting changes and, more importantly, the URL
-        #   changes and, more importantly, the URL must be well-formed so that it can
+        #   must be well-formed so that it can be parsed.
-        #   be parsed.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -488,21 +481,16 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Returns a service account and credentials. The service account
+        # Returns a service account and credentials. The service account can be bound to
-        # can be bound to the enterprise by calling setAccount. The service account
+        # the enterprise by calling setAccount. The service account is unique to this
-        # is unique to this enterprise and EMM, and will be deleted if the enterprise
+        # enterprise and EMM, and will be deleted if the enterprise is unbound. The
-        # is unbound. The credentials contain private key data and are not stored
+        # credentials contain private key data and are not stored server-side. This
-        # server-side.
+        # method can only be called after calling Enterprises.Enroll or Enterprises.
-        # <br> <br>
+        # CompleteSignup, and before Enterprises.SetAccount; at other times it will
-        # This method can only be called after calling
+        # return an error. Subsequent calls after the first will generate a new, unique
-        # Enterprises.Enroll or Enterprises.CompleteSignup, and before
+        # set of credentials, and invalidate the previously generated credentials. Once
-        # Enterprises.SetAccount; at other times it will return an error.
+        # the service account is bound to the enterprise, it can be managed using the
-        # <br> <br>
+        # serviceAccountKeys resource.
-        # Subsequent calls after the first will generate a new, unique set of
-        # credentials, and invalidate the previously generated credentials.
-        # <br> <br>
-        # Once the service account is bound to the enterprise, it can be managed
-        # using the serviceAccountKeys resource.
         # @param [String] enterprise_id
         #   The ID of the enterprise.
         # @param [String] key_type
@@ -535,9 +523,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Returns the store layout for the enterprise. If the store layout
+        # Returns the store layout for the enterprise. If the store layout has not been
-        # has not been set, returns "basic" as the store layout type and no
+        # set, returns "basic" as the store layout type and no homepage.
-        # homepage.
         # @param [String] enterprise_id
         #   The ID of the enterprise.
         # @param [String] fields
@@ -567,11 +554,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Looks up an enterprise by domain name.
+        # Looks up an enterprise by domain name. This is only supported for enterprises
-        # This is only supported for enterprises created via the Google-initiated
+        # created via the Google-initiated creation flow. Lookup of the id is not needed
-        # creation flow.  Lookup of the id is not needed for enterprises created via
+        # for enterprises created via the EMM-initiated flow since the EMM learns the
-        # the EMM-initiated flow since the EMM learns the enterprise ID in the
+        # enterprise ID in the callback specified in the Enterprises.generateSignupUrl
-        # callback specified in the Enterprises.generateSignupUrl call.
+        # call.
         # @param [String] domain
         #   Required. The exact primary domain name of the enterprise to look up.
         # @param [String] fields
@@ -601,38 +588,26 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Pulls and returns a notification set for the enterprises associated with
+        # Pulls and returns a notification set for the enterprises associated with the
-        # the service account authenticated for the request. The notification set may
+        # service account authenticated for the request. The notification set may be
-        # be empty if no notification are pending.
+        # empty if no notification are pending. A notification set returned needs to be
-        # <br>
+        # acknowledged within 20 seconds by calling Enterprises.
-        # A notification set returned needs to be acknowledged within 20 seconds
+        # AcknowledgeNotificationSet, unless the notification set is empty.
-        # by calling Enterprises.AcknowledgeNotificationSet, unless the
+        # Notifications that are not acknowledged within the 20 seconds will eventually
-        # notification set is empty.
+        # be included again in the response to another PullNotificationSet request, and
-        # <br>
+        # those that are never acknowledged will ultimately be deleted according to the
-        # Notifications that are not acknowledged within the 20 seconds will
+        # Google Cloud Platform Pub/Sub system policy. Multiple requests might be
-        # eventually be included again in the response to another PullNotificationSet
+        # performed concurrently to retrieve notifications, in which case the pending
-        # request, and those that are never acknowledged will ultimately be deleted
+        # notifications (if any) will be split among each caller, if any are pending. If
-        # according to the Google Cloud Platform Pub/Sub system policy.
+        # no notifications are present, an empty notification list is returned.
-        # <br>
+        # Subsequent requests may return more notifications once they become available.
-        # Multiple requests might be performed concurrently to retrieve
-        # notifications, in which case the pending notifications (if any) will be
-        # split among each caller, if any are pending.
-        # <br>
-        # If no notifications are present, an empty notification list is returned.
-        # Subsequent requests may return more notifications once they become
-        # available.
         # @param [String] request_mode
-        #   The request mode for pulling notifications.
+        #   The request mode for pulling notifications. Specifying waitForNotifications
-        #   <br>
+        #   will cause the request to block and wait until one or more notifications are
-        #   Specifying <code>waitForNotifications</code> will cause the request to
+        #   present, or return an empty notification list if no notifications are present
-        #   block and wait until one or more notifications are present, or return an
+        #   after some time. Speciying returnImmediately will cause the request to
-        #   empty notification list if no notifications are present after some time.
-        #   <br>
-        #   Speciying <code>returnImmediately</code> will cause the request to
         #   immediately return the pending notifications, or an empty list if no
-        #   notifications are present.
+        #   notifications are present. If omitted, defaults to waitForNotifications.
-        #   <br>
-        #   If omitted, defaults to <code>waitForNotifications</code>.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -660,8 +635,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Sends a test notification to validate the EMM integration with
+        # Sends a test notification to validate the EMM integration with the Google
-        # the Google Cloud Pub/Sub service for this enterprise.
+        # Cloud Pub/Sub service for this enterprise.
         # @param [String] enterprise_id
         #   The ID of the enterprise.
         # @param [String] fields
@@ -725,15 +700,13 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Sets the store layout for the enterprise. By default, storeLayoutType
+        # Sets the store layout for the enterprise. By default, storeLayoutType is set
-        # is set to "basic" and the basic store layout is enabled. The basic
+        # to "basic" and the basic store layout is enabled. The basic layout only
-        # layout only contains apps approved by the admin, and that have
+        # contains apps approved by the admin, and that have been added to the available
-        # been added to the available product set for a user (using the
+        # product set for a user (using the setAvailableProductSet call). Apps on the
-        # <a href="/android/work/play/emm-api/v1/users/setAvailableProductSet">
+        # page are sorted in order of their product ID value. If you create a custom
-        # setAvailableProductSet</a> call). Apps on the page are sorted in order of
+        # store layout (by setting storeLayoutType = "custom" and setting a homepage),
-        # their product ID value. If you create a custom store layout (by setting
+        # the basic store layout is disabled.
-        # storeLayoutType = "custom" and setting a homepage), the basic store
-        # layout is disabled.
         # @param [String] enterprise_id
         #   The ID of the enterprise.
         # @param [Google::Apis::AndroidenterpriseV1::StoreLayout] store_layout_object
@@ -907,9 +880,9 @@ module Google
         # @param [Google::Apis::AndroidenterpriseV1::Entitlement] entitlement_object
         # @param [Boolean] install
         #   Set to true to also install the product on all the user's devices where
-        #   possible. Failure to install on one or more devices will not prevent
+        #   possible. Failure to install on one or more devices will not prevent this
-        #   this operation from returning successfully, as long as the entitlement
+        #   operation from returning successfully, as long as the entitlement was
-        #   was successfully assigned to the user.
+        #   successfully assigned to the user.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -946,8 +919,8 @@ module Google
         # @param [String] enterprise_id
         #   The ID of the enterprise.
         # @param [String] group_license_id
-        #   The ID of the product the group license is for, e.g.
+        #   The ID of the product the group license is for, e.g. "app:com.google.android.
-        #   "app:com.google.android.gm".
+        #   gm".
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1006,13 +979,13 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Retrieves the IDs of the users who have been granted entitlements
+        # Retrieves the IDs of the users who have been granted entitlements under the
-        # under the license.
+        # license.
         # @param [String] enterprise_id
         #   The ID of the enterprise.
         # @param [String] group_license_id
-        #   The ID of the product the group license is for, e.g.
+        #   The ID of the product the group license is for, e.g. "app:com.google.android.
-        #   "app:com.google.android.gm".
+        #   gm".
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1041,9 +1014,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Requests to remove an app from a device. A call to <code>get</code> or
+        # Requests to remove an app from a device. A call to get or list will still show
-        # <code>list</code> will still show the app as installed on the device until
+        # the app as installed on the device until it is actually removed.
-        # it is actually removed.
         # @param [String] enterprise_id
         #   The ID of the enterprise.
         # @param [String] user_id
@@ -1051,8 +1023,8 @@ module Google
         # @param [String] device_id
         #   The Android ID of the device.
         # @param [String] install_id
-        #   The ID of the product represented by the install, e.g.
+        #   The ID of the product represented by the install, e.g. "app:com.google.android.
-        #   "app:com.google.android.gm".
+        #   gm".
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1089,8 +1061,8 @@ module Google
         # @param [String] device_id
         #   The Android ID of the device.
         # @param [String] install_id
-        #   The ID of the product represented by the install, e.g.
+        #   The ID of the product represented by the install, e.g. "app:com.google.android.
-        #   "app:com.google.android.gm".
+        #   gm".
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1157,9 +1129,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Requests to install the latest version of an app to a device. If the app
+        # Requests to install the latest version of an app to a device. If the app is
-        # is already installed, then it is updated to the latest version if
+        # already installed, then it is updated to the latest version if necessary.
-        # necessary.
         # @param [String] enterprise_id
         #   The ID of the enterprise.
         # @param [String] user_id
@@ -1167,8 +1138,8 @@ module Google
         # @param [String] device_id
         #   The Android ID of the device.
         # @param [String] install_id
-        #   The ID of the product represented by the install, e.g.
+        #   The ID of the product represented by the install, e.g. "app:com.google.android.
-        #   "app:com.google.android.gm".
+        #   gm".
         # @param [Google::Apis::AndroidenterpriseV1::Install] install_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1202,8 +1173,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Removes a per-device managed configuration for an app for the specified
+        # Removes a per-device managed configuration for an app for the specified device.
-        # device.
         # @param [String] enterprise_id
         #   The ID of the enterprise.
         # @param [String] user_id
@@ -1211,8 +1181,8 @@ module Google
         # @param [String] device_id
         #   The Android ID of the device.
         # @param [String] managed_configuration_for_device_id
-        #   The ID of the managed configuration (a product ID), e.g.
+        #   The ID of the managed configuration (a product ID), e.g. "app:com.google.
-        #   "app:com.google.android.gm".
+        #   android.gm".
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1249,8 +1219,8 @@ module Google
         # @param [String] device_id
         #   The Android ID of the device.
         # @param [String] managed_configuration_for_device_id
-        #   The ID of the managed configuration (a product ID), e.g.
+        #   The ID of the managed configuration (a product ID), e.g. "app:com.google.
-        #   "app:com.google.android.gm".
+        #   android.gm".
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1281,8 +1251,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists all the per-device managed configurations for the specified device.
+        # Lists all the per-device managed configurations for the specified device. Only
-        # Only the ID is set.
+        # the ID is set.
         # @param [String] enterprise_id
         #   The ID of the enterprise.
         # @param [String] user_id
@@ -1327,8 +1297,8 @@ module Google
         # @param [String] device_id
         #   The Android ID of the device.
         # @param [String] managed_configuration_for_device_id
-        #   The ID of the managed configuration (a product ID), e.g.
+        #   The ID of the managed configuration (a product ID), e.g. "app:com.google.
-        #   "app:com.google.android.gm".
+        #   android.gm".
         # @param [Google::Apis::AndroidenterpriseV1::ManagedConfiguration] managed_configuration_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1368,8 +1338,8 @@ module Google
         # @param [String] user_id
         #   The ID of the user.
         # @param [String] managed_configuration_for_user_id
-        #   The ID of the managed configuration (a product ID), e.g.
+        #   The ID of the managed configuration (a product ID), e.g. "app:com.google.
-        #   "app:com.google.android.gm".
+        #   android.gm".
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1404,8 +1374,8 @@ module Google
         # @param [String] user_id
         #   The ID of the user.
         # @param [String] managed_configuration_for_user_id
-        #   The ID of the managed configuration (a product ID), e.g.
+        #   The ID of the managed configuration (a product ID), e.g. "app:com.google.
-        #   "app:com.google.android.gm".
+        #   android.gm".
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1435,8 +1405,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists all the per-user managed configurations for the specified user. Only
+        # Lists all the per-user managed configurations for the specified user. Only the
-        # the ID is set.
+        # ID is set.
         # @param [String] enterprise_id
         #   The ID of the enterprise.
         # @param [String] user_id
@@ -1470,24 +1440,17 @@ module Google
         end
         
         # Adds or updates the managed configuration settings for an app for the
-        # specified user.
+        # specified user. If you support the Managed configurations iframe, you can
-        # If you support the <a
+        # apply managed configurations to a user by specifying an mcmId and its
-        # href="https://developers.google.com/android/work/play/emm-api/managed-
+        # associated configuration variables (if any) in the request. Alternatively, all
-        # configurations-iframe">Managed
+        # EMMs can apply managed configurations by passing a list of managed properties.
-        # configurations iframe</a>,
-        # you can apply managed configurations to a user by specifying an
-        # <code>mcmId</code>
-        # and its associated configuration variables (if any) in the request.
-        # Alternatively,
-        # all EMMs can apply managed configurations by passing a list of managed
-        # properties.
         # @param [String] enterprise_id
         #   The ID of the enterprise.
         # @param [String] user_id
         #   The ID of the user.
         # @param [String] managed_configuration_for_user_id
-        #   The ID of the managed configuration (a product ID), e.g.
+        #   The ID of the managed configuration (a product ID), e.g. "app:com.google.
-        #   "app:com.google.android.gm".
+        #   android.gm".
         # @param [Google::Apis::AndroidenterpriseV1::ManagedConfiguration] managed_configuration_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1524,8 +1487,7 @@ module Google
         # @param [String] enterprise_id
         #   The ID of the enterprise.
         # @param [String] product_id
-        #   The ID of the product for which the managed configurations settings applies
+        #   The ID of the product for which the managed configurations settings applies to.
-        #   to.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1588,13 +1550,10 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # <p>Approves the specified product and the relevant app permissions, if any.
+        # Approves the specified product and the relevant app permissions, if any. The
-        # The maximum number of products that you can approve per enterprise customer
+        # maximum number of products that you can approve per enterprise customer is 1,
-        # is 1,000.</p>
+        # 000. To learn how to use managed Google Play to design and create a store
-        # <p>To learn how to use managed Google Play to design and create a store
+        # layout to display approved products to your users, see Store Layout Design.
-        # layout to display approved products to your users,
-        # see <a href="/android/work/play/emm-api/store-layout">Store Layout
-        # Design</a>.</p>
         # @param [String] enterprise_id
         #   The ID of the enterprise.
         # @param [String] product_id
@@ -1628,23 +1587,21 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Generates a URL that can be rendered in an iframe to display the
+        # Generates a URL that can be rendered in an iframe to display the permissions (
-        # permissions (if any) of a product. An enterprise admin must view these
+        # if any) of a product. An enterprise admin must view these permissions and
-        # permissions and accept them on behalf of their organization in order to
+        # accept them on behalf of their organization in order to approve that product.
-        # approve that product. <br><br>
+        # Admins should accept the displayed permissions by interacting with a separate
-        # Admins should accept the displayed permissions by
+        # UI element in the EMM console, which in turn should trigger the use of this
-        # interacting with a separate UI element in the EMM console, which in turn
+        # URL as the approvalUrlInfo.approvalUrl property in a Products.approve call to
-        # should trigger the use of this URL as the
+        # approve the product. This URL can only be used to display permissions for up
-        # <code>approvalUrlInfo.approvalUrl</code> property in a
+        # to 1 day.
-        # <code>Products.approve</code> call to approve the product.
-        # This URL can only be used to display permissions for up to 1 day.
         # @param [String] enterprise_id
         #   The ID of the enterprise.
         # @param [String] product_id
         #   The ID of the product.
         # @param [String] language_code
-        #   The BCP 47 language code used for permission names and descriptions in
+        #   The BCP 47 language code used for permission names and descriptions in the
-        #   the returned iframe, for instance "en-US".
+        #   returned iframe, for instance "en-US".
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1710,14 +1667,12 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Retrieves the schema that defines the configurable properties for this
+        # Retrieves the schema that defines the configurable properties for this product.
-        # product. All products have a schema, but this schema may be empty if no
+        # All products have a schema, but this schema may be empty if no managed
-        # managed configurations have been defined. This schema can be used to
+        # configurations have been defined. This schema can be used to populate a UI
-        # populate a UI that allows an admin to configure the product.
+        # that allows an admin to configure the product. To apply a managed
-        # To apply a managed configuration based on the schema obtained using this
+        # configuration based on the schema obtained using this API, see Managed
-        # API, see
+        # Configurations through Play.
-        # <a href="/android/work/play/emm-api/managed-configurations">Managed
-        # Configurations through Play</a>.
         # @param [String] enterprise_id
         #   The ID of the enterprise.
         # @param [String] product_id
@@ -1786,29 +1741,26 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Finds approved products that match a query, or all approved products
+        # Finds approved products that match a query, or all approved products if there
-        # if there is no query.
+        # is no query.
         # @param [String] enterprise_id
         #   The ID of the enterprise.
         # @param [Boolean] approved
-        #   Specifies whether to search among all products (false) or among
+        #   Specifies whether to search among all products (false) or among only products
-        #   only products that have been approved (true). Only "true" is
+        #   that have been approved (true). Only "true" is supported, and should be
-        #   supported, and should be specified.
+        #   specified.
         # @param [String] language
-        #   The BCP47 tag for the user's preferred language (e.g. "en-US", "de").
+        #   The BCP47 tag for the user's preferred language (e.g. "en-US", "de"). Results
-        #   Results are returned in the language best matching the preferred
+        #   are returned in the language best matching the preferred language.
-        #   language.
         # @param [Fixnum] max_results
-        #   Defines how many results the list operation should return.
+        #   Defines how many results the list operation should return. The default number
-        #   The default number depends on the resource collection.
+        #   depends on the resource collection.
         # @param [String] query
-        #   The search query as typed in the Google Play store search box.
+        #   The search query as typed in the Google Play store search box. If omitted, all
-        #   If omitted, all approved apps will be returned (using the pagination
+        #   approved apps will be returned (using the pagination parameters), including
-        #   parameters), including apps that are not available in the store
+        #   apps that are not available in the store (e.g. unpublished apps).
-        #   (e.g. unpublished apps).
         # @param [String] token
-        #   Defines the token of the page to return, usually taken from
+        #   Defines the token of the page to return, usually taken from TokenPagination.
-        #   TokenPagination.
         #   This can only be used if token paging is enabled.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1875,8 +1827,8 @@ module Google
         
         # Removes and invalidates the specified credentials for the service account
         # associated with this enterprise. The calling service account must have been
-        # retrieved by calling Enterprises.GetServiceAccount and must have been set
+        # retrieved by calling Enterprises.GetServiceAccount and must have been set as
-        # as the enterprise service account by calling Enterprises.SetAccount.
+        # the enterprise service account by calling Enterprises.SetAccount.
         # @param [String] enterprise_id
         #   The ID of the enterprise.
         # @param [String] key_id
@@ -1909,10 +1861,9 @@ module Google
         
         # Generates new credentials for the service account associated with this
         # enterprise. The calling service account must have been retrieved by calling
-        # Enterprises.GetServiceAccount and must have been set as the enterprise
+        # Enterprises.GetServiceAccount and must have been set as the enterprise service
-        # service account by calling Enterprises.SetAccount. <br><br>
+        # account by calling Enterprises.SetAccount. Only the type of the key should be
-        # Only the type of the key should be populated in the resource to be
+        # populated in the resource to be inserted.
-        # inserted.
         # @param [String] enterprise_id
         #   The ID of the enterprise.
         # @param [Google::Apis::AndroidenterpriseV1::ServiceAccountKey] service_account_key_object
@@ -1946,10 +1897,10 @@ module Google
         end
         
         # Lists all active credentials for the service account associated with this
-        # enterprise. Only the ID and key type are returned. The calling service
+        # enterprise. Only the ID and key type are returned. The calling service account
-        # account must have been retrieved by calling Enterprises.GetServiceAccount
+        # must have been retrieved by calling Enterprises.GetServiceAccount and must
-        # and must have been set as the enterprise service account by calling
+        # have been set as the enterprise service account by calling Enterprises.
-        # Enterprises.SetAccount.
+        # SetAccount.
         # @param [String] enterprise_id
         #   The ID of the enterprise.
         # @param [String] fields
@@ -2352,10 +2303,9 @@ module Google
         end
         
         # Generates an authentication token which the device policy client can use to
-        # provision the given EMM-managed user account on a device.
+        # provision the given EMM-managed user account on a device. The generated token
-        # The generated token is single-use and expires after a few minutes.
+        # is single-use and expires after a few minutes. You can provision a maximum of
-        # You can provision a maximum of 10 devices per user.
+        # 10 devices per user. This call only works with EMM-managed accounts.
-        # This call only works with EMM-managed accounts.
         # @param [String] enterprise_id
         #   The ID of the enterprise.
         # @param [String] user_id
@@ -2454,13 +2404,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates a new EMM-managed user.
+        # Creates a new EMM-managed user. The Users resource passed in the body of the
-        # The <a href="/android/work/play/emm-api/v1/users.html">Users</a> resource
+        # request should include an accountIdentifier and an accountType. If a
-        # passed in the body of the request should include an
+        # corresponding user already exists with the same account identifier, the user
-        # <code>accountIdentifier</code> and an <code>accountType</code>.
+        # will be updated with the resource. In this case only the displayName field can
-        # <p>If a corresponding user already exists with the same account identifier,
+        # be changed.
-        # the user will be updated with the resource. In this case only the
-        # <code>displayName</code> field can be changed.
         # @param [String] enterprise_id
         #   The ID of the enterprise.
         # @param [Google::Apis::AndroidenterpriseV1::User] user_object
@@ -2493,10 +2441,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Looks up a user by primary email address.
+        # Looks up a user by primary email address. This is only supported for Google-
-        # This is only supported for Google-managed users.  Lookup of the id is not
+        # managed users. Lookup of the id is not needed for EMM-managed users because
-        # needed for EMM-managed users because the id is already returned in the
+        # the id is already returned in the result of the Users.insert call.
-        # result of the Users.insert call.
         # @param [String] enterprise_id
         #   The ID of the enterprise.
         # @param [String] email
@@ -2529,10 +2476,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Revokes access to all devices currently provisioned to the user. The user
+        # Revokes access to all devices currently provisioned to the user. The user will
-        # will no longer be able to use the managed Play store on any of their
+        # no longer be able to use the managed Play store on any of their managed
-        # managed devices.
+        # devices. This call only works with EMM-managed accounts.
-        # This call only works with EMM-managed accounts.
         # @param [String] enterprise_id
         #   The ID of the enterprise.
         # @param [String] user_id
@@ -2563,11 +2509,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Modifies the set of products that a user is entitled to access (referred to
+        # Modifies the set of products that a user is entitled to access (referred to as
-        # as <em>whitelisted</em> products). Only products that are
+        # *whitelisted* products). Only products that are approved or products that were
-        # <a href="/android/work/play/emm-api/v1/products/approve">approved</a>
+        # previously approved (products with revoked approval) can be whitelisted.
-        # or products that were previously approved (products with revoked approval)
-        # can be whitelisted.
         # @param [String] enterprise_id
         #   The ID of the enterprise.
         # @param [String] user_id
@@ -2603,13 +2547,10 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Updates the details of an EMM-managed user.
+        # Updates the details of an EMM-managed user. Can be used with EMM-managed users
-        # Can be used with EMM-managed users only (not Google managed users).
+        # only (not Google managed users). Pass the new details in the Users resource in
-        # Pass the new details in the
+        # the request body. Only the displayName field can be changed. Other fields must
-        # <a href="/android/work/play/emm-api/v1/users.html">Users</a>
+        # either be unset or have the currently active value.
-        # resource in the request body. Only the <code>displayName</code> field
-        # can be changed. Other fields must either be unset or have the
-        # currently active value.
         # @param [String] enterprise_id
         #   The ID of the enterprise.
         # @param [String] user_id

generated/google/apis/androidmanagement_v1.rb

@@ -26,7 +26,7 @@ module Google
     # @see https://developers.google.com/android/management
     module AndroidmanagementV1
       VERSION = 'V1'
-      REVISION = '20200612'
+      REVISION = '20200803'
 
       # Manage Android devices and apps for your customers
       AUTH_ANDROIDMANAGEMENT = 'https://www.googleapis.com/auth/androidmanagement'

generated/google/apis/apigee_v1.rb

@@ -21,17 +21,16 @@ module Google
     # Apigee API
     #
     # The Apigee API lets you programmatically manage Apigee hybrid with a set of
-    # RESTful operations, including:<ul>  <li>Create, edit, and delete API proxies</
+    # RESTful operations, including: - Create, edit, and delete API proxies - Manage
-    # li>  <li>Manage users</li>  <li>Deploy and undeploy proxy revisions</li>  <li>
+    # users - Deploy and undeploy proxy revisions - Configure environments For
-    # Configure environments</li></ul><p>For information on using the APIs described
+    # information on using the APIs described in this section, see Get started using
-    # in this section, see <a href="docs.apigee.com/hybrid/latest/api-get-started">
+    # the APIs. *Note:* This product is available as a free trial for a time period
-    # Get started using the APIs</a>.</p><p><strong>Note:</strong> This product is
+    # of 60 days.
-    # available as a free trial for a time period of 60 days.
     #
     # @see https://cloud.google.com/apigee-api-management/
     module ApigeeV1
       VERSION = 'V1'
-      REVISION = '20200720'
+      REVISION = '20200801'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

generated/google/apis/chromeuxreport_v1.rb

@@ -26,7 +26,7 @@ module Google
     # @see https://developers.google.com/web/tools/chrome-user-experience-report/api/reference
     module ChromeuxreportV1
       VERSION = 'V1'
-      REVISION = '20200720'
+      REVISION = '20200803'
     end
   end
 end

generated/google/apis/chromeuxreport_v1/classes.rb

@@ -22,25 +22,23 @@ module Google
   module Apis
     module ChromeuxreportV1
       
-      # A bin is a discrete portion of data spanning from start to end, or if no
+      # A bin is a discrete portion of data spanning from start to end, or if no end
-      # end is given, then from start to +inf.
+      # is given, then from start to +inf. A bin's start and end values are given in
-      # A bin's start and end values are given in the value type of the metric it
+      # the value type of the metric it represents. For example, "first contentful
-      # represents. For example, "first contentful paint" is measured in
+      # paint" is measured in milliseconds and exposed as ints, therefore its metric
-      # milliseconds and exposed as ints, therefore its metric bins will use int32s
+      # bins will use int32s for its start and end types. However, "cumulative layout
-      # for its start and end types. However, "cumulative layout shift" is measured
+      # shift" is measured in unitless decimals and is exposed as a decimal encoded as
-      # in unitless decimals and is exposed as a decimal encoded as a string,
+      # a string, therefore its metric bins will use strings for its value type.
-      # therefore its metric bins will use strings for its value type.
       class Bin
         include Google::Apis::Core::Hashable
       
-        # The proportion of users that experienced this bin's value for the given
+        # The proportion of users that experienced this bin's value for the given metric.
-        # metric.
         # Corresponds to the JSON property `density`
         # @return [Float]
         attr_accessor :density
       
-        # End is the end of the data bin. If end is not populated, then the bin has
+        # End is the end of the data bin. If end is not populated, then the bin has no
-        # no end and is valid from start to +inf.
+        # end and is valid from start to +inf.
         # Corresponds to the JSON property `end`
         # @return [Object]
         attr_accessor :end
@@ -66,34 +64,31 @@ module Google
       class Key
         include Google::Apis::Core::Hashable
       
-        # The effective connection type is the general connection class that all
+        # The effective connection type is the general connection class that all users
-        # users experienced for this record. This field uses the values ["offline",
+        # experienced for this record. This field uses the values ["offline", "slow-2G",
-        # "slow-2G", "2G", "3G", "4G"] as specified in:
+        # "2G", "3G", "4G"] as specified in: https://wicg.github.io/netinfo/#effective-
-        # https://wicg.github.io/netinfo/#effective-connection-types
+        # connection-types If the effective connection type is unspecified, then
-        # If the effective connection type is unspecified, then aggregated data
+        # aggregated data over all effective connection types will be returned.
-        # over all effective connection types will be returned.
         # Corresponds to the JSON property `effectiveConnectionType`
         # @return [String]
         attr_accessor :effective_connection_type
       
-        # The form factor is the device class that all users used to access the
+        # The form factor is the device class that all users used to access the site for
-        # site for this record.
+        # this record. If the form factor is unspecified, then aggregated data over all
-        # If the form factor is unspecified, then aggregated data over all form
+        # form factors will be returned.
-        # factors will be returned.
         # Corresponds to the JSON property `formFactor`
         # @return [String]
         attr_accessor :form_factor
       
-        # Origin specifies the origin that this record is for.
+        # Origin specifies the origin that this record is for. Note: When specifying an
-        # Note: When specifying an origin, data for loads under this origin over
+        # origin, data for loads under this origin over all pages are aggregated into
-        # all pages are aggregated into origin level user experience data.
+        # origin level user experience data.
         # Corresponds to the JSON property `origin`
         # @return [String]
         attr_accessor :origin
       
-        # Url specifies a specific url that this record is for.
+        # Url specifies a specific url that this record is for. Note: When specifying a "
-        # Note: When specifying a "url" only data for that specific url will be
+        # url" only data for that specific url will be aggregated.
-        # aggregated.
         # Corresponds to the JSON property `url`
         # @return [String]
         attr_accessor :url
@@ -112,8 +107,8 @@ module Google
       end
       
       # A `metric` is a set of user experience data for a single web performance
-      # metric, like "first contentful paint". It contains a summary histogram of
+      # metric, like "first contentful paint". It contains a summary histogram of real
-      # real world Chrome usage as a series of `bins`.
+      # world Chrome usage as a series of `bins`.
       class Metric
         include Google::Apis::Core::Hashable
       
@@ -124,8 +119,8 @@ module Google
         attr_accessor :histogram
       
         # Percentiles contains synthetic values of a metric at a given statistical
-        # percentile. These are used for estimating a metric's value as experienced
+        # percentile. These are used for estimating a metric's value as experienced by a
-        # by a percentage of users out of the total number of users.
+        # percentage of users out of the total number of users.
         # Corresponds to the JSON property `percentiles`
         # @return [Google::Apis::ChromeuxreportV1::Percentiles]
         attr_accessor :percentiles
@@ -142,8 +137,8 @@ module Google
       end
       
       # Percentiles contains synthetic values of a metric at a given statistical
-      # percentile. These are used for estimating a metric's value as experienced
+      # percentile. These are used for estimating a metric's value as experienced by a
-      # by a percentage of users out of the total number of users.
+      # percentage of users out of the total number of users.
       class Percentiles
         include Google::Apis::Core::Hashable
       
@@ -162,49 +157,44 @@ module Google
         end
       end
       
-      # Request payload sent by a physical web client.
+      # Request payload sent by a physical web client. This request includes all
-      # This request includes all necessary context to load a particular
+      # necessary context to load a particular user experience record.
-      # user experience record.
       class QueryRequest
         include Google::Apis::Core::Hashable
       
         # The effective connection type is a query dimension that specifies the
         # effective network class that the record's data should belong to. This field
         # uses the values ["offline", "slow-2G", "2G", "3G", "4G"] as specified in:
-        # https://wicg.github.io/netinfo/#effective-connection-types
+        # https://wicg.github.io/netinfo/#effective-connection-types Note: If no
-        # Note: If no effective connection type is specified, then a special record
+        # effective connection type is specified, then a special record with aggregated
-        # with aggregated data over all effective connection types will be returned.
+        # data over all effective connection types will be returned.
         # Corresponds to the JSON property `effectiveConnectionType`
         # @return [String]
         attr_accessor :effective_connection_type
       
-        # The form factor is a query dimension that specifies the device class that
+        # The form factor is a query dimension that specifies the device class that the
-        # the record's data should belong to.
+        # record's data should belong to. Note: If no form factor is specified, then a
-        # Note: If no form factor is specified, then a special record with
+        # special record with aggregated data over all form factors will be returned.
-        # aggregated data over all form factors will be returned.
         # Corresponds to the JSON property `formFactor`
         # @return [String]
         attr_accessor :form_factor
       
-        # The metrics that should be included in the response.
+        # The metrics that should be included in the response. If none are specified
-        # If none are specified then any metrics found will be returned.
+        # then any metrics found will be returned. Allowed values: ["
-        # Allowed values: ["first_contentful_paint",
+        # first_contentful_paint", "first_input_delay", "largest_contentful_paint", "
-        # "first_input_delay", "largest_contentful_paint",
+        # cumulative_layout_shift"]
-        # "cumulative_layout_shift"]
         # Corresponds to the JSON property `metrics`
         # @return [Array<String>]
         attr_accessor :metrics
       
-        # The url pattern "origin" refers to a url pattern that is the origin of
+        # The url pattern "origin" refers to a url pattern that is the origin of a
-        # a website.
+        # website. Examples: "https://example.com", "https://cloud.google.com"
-        # Examples: "https://example.com", "https://cloud.google.com"
         # Corresponds to the JSON property `origin`
         # @return [String]
         attr_accessor :origin
       
         # The url pattern "url" refers to a url pattern that is any arbitrary url.
-        # Examples: "https://example.com/",
+        # Examples: "https://example.com/", "https://cloud.google.com/why-google-cloud/"
-        # "https://cloud.google.com/why-google-cloud/"
         # Corresponds to the JSON property `url`
         # @return [String]
         attr_accessor :url
@@ -223,11 +213,11 @@ module Google
         end
       end
       
-      # Response payload sent back to a physical web client.
+      # Response payload sent back to a physical web client. This response contains
-      # This response contains the record found based on the identiers present in a
+      # the record found based on the identiers present in a `QueryRequest`. The
-      # `QueryRequest`.  The returned response will have a record, and sometimes
+      # returned response will have a record, and sometimes details on normalization
-      # details on normalization actions taken on the request that were necessary to
+      # actions taken on the request that were necessary to make the request
-      # make the request successful.
+      # successful.
       class QueryResponse
         include Google::Apis::Core::Hashable
       
@@ -266,11 +256,10 @@ module Google
         # @return [Google::Apis::ChromeuxreportV1::Key]
         attr_accessor :key
       
-        # Metrics is the map of user experience data available for the record defined
+        # Metrics is the map of user experience data available for the record defined in
-        # in the key field. Metrics are keyed on the metric name.
+        # the key field. Metrics are keyed on the metric name. Allowed key values: ["
-        # Allowed key values: ["first_contentful_paint",
+        # first_contentful_paint", "first_input_delay", "largest_contentful_paint", "
-        # "first_input_delay", "largest_contentful_paint",
+        # cumulative_layout_shift"]
-        # "cumulative_layout_shift"]
         # Corresponds to the JSON property `metrics`
         # @return [Hash<String,Google::Apis::ChromeuxreportV1::Metric>]
         attr_accessor :metrics
@@ -293,8 +282,8 @@ module Google
       class UrlNormalization
         include Google::Apis::Core::Hashable
       
-        # The URL after any normalization actions. This is a valid user experience
+        # The URL after any normalization actions. This is a valid user experience URL
-        # URL that could reasonably be looked up.
+        # that could reasonably be looked up.
         # Corresponds to the JSON property `normalizedUrl`
         # @return [String]
         attr_accessor :normalized_url

generated/google/apis/classroom_v1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://developers.google.com/classroom/
     module ClassroomV1
       VERSION = 'V1'
-      REVISION = '20200714'
+      REVISION = '20200801'
 
       # View and manage announcements in Google Classroom
       AUTH_CLASSROOM_ANNOUNCEMENTS = 'https://www.googleapis.com/auth/classroom.announcements'

generated/google/apis/cloudasset_v1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/asset-inventory/docs/quickstart
     module CloudassetV1
       VERSION = 'V1'
-      REVISION = '20200724'
+      REVISION = '20200731'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

generated/google/apis/cloudasset_v1/classes.rb

@@ -1626,7 +1626,9 @@ module Google
         include Google::Apis::Core::Hashable
       
         # The list of APIs usable within the Service Perimeter. Must be empty
-        # unless 'enable_restriction' is True.
+        # unless 'enable_restriction' is True. You can specify a list of individual
+        # services, as well as include the 'RESTRICTED-SERVICES' value, which
+        # automatically includes all of the services protected by the perimeter.
         # Corresponds to the JSON property `allowedServices`
         # @return [Array<String>]
         attr_accessor :allowed_services

generated/google/apis/cloudasset_v1beta1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/asset-inventory/docs/quickstart
     module CloudassetV1beta1
       VERSION = 'V1beta1'
-      REVISION = '20200613'
+      REVISION = '20200731'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

generated/google/apis/cloudasset_v1beta1/classes.rb

@@ -1370,7 +1370,9 @@ module Google
         include Google::Apis::Core::Hashable
       
         # The list of APIs usable within the Service Perimeter. Must be empty
-        # unless 'enable_restriction' is True.
+        # unless 'enable_restriction' is True. You can specify a list of individual
+        # services, as well as include the 'RESTRICTED-SERVICES' value, which
+        # automatically includes all of the services protected by the perimeter.
         # Corresponds to the JSON property `allowedServices`
         # @return [Array<String>]
         attr_accessor :allowed_services

generated/google/apis/cloudasset_v1p4beta1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/asset-inventory/docs/quickstart
     module CloudassetV1p4beta1
       VERSION = 'V1p4beta1'
-      REVISION = '20200724'
+      REVISION = '20200731'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

generated/google/apis/cloudasset_v1p5beta1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/asset-inventory/docs/quickstart
     module CloudassetV1p5beta1
       VERSION = 'V1p5beta1'
-      REVISION = '20200717'
+      REVISION = '20200731'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

generated/google/apis/cloudasset_v1p5beta1/classes.rb

@@ -1281,7 +1281,9 @@ module Google
         include Google::Apis::Core::Hashable
       
         # The list of APIs usable within the Service Perimeter. Must be empty
-        # unless 'enable_restriction' is True.
+        # unless 'enable_restriction' is True. You can specify a list of individual
+        # services, as well as include the 'RESTRICTED-SERVICES' value, which
+        # automatically includes all of the services protected by the perimeter.
         # Corresponds to the JSON property `allowedServices`
         # @return [Array<String>]
         attr_accessor :allowed_services

generated/google/apis/dialogflow_v2.rb

@@ -26,7 +26,7 @@ module Google
     # @see https://cloud.google.com/dialogflow/
     module DialogflowV2
       VERSION = 'V2'
-      REVISION = '20200719'
+      REVISION = '20200801'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

generated/google/apis/dialogflow_v2beta1.rb

@@ -26,7 +26,7 @@ module Google
     # @see https://cloud.google.com/dialogflow/
     module DialogflowV2beta1
       VERSION = 'V2beta1'
-      REVISION = '20200719'
+      REVISION = '20200801'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

generated/google/apis/driveactivity_v2.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://developers.google.com/drive/activity/
     module DriveactivityV2
       VERSION = 'V2'
-      REVISION = '20200428'
+      REVISION = '20200801'
 
       # View and add to the activity record of files in your Google Drive
       AUTH_DRIVE_ACTIVITY = 'https://www.googleapis.com/auth/drive.activity'

generated/google/apis/driveactivity_v2/classes.rb

@@ -313,16 +313,16 @@ module Google
       # How the individual activities are consolidated. A set of activities may be
       # consolidated into one combined activity if they are related in some way, such
       # as one actor performing the same action on multiple targets, or multiple
-      # actors performing the same action on a single target. The strategy defines
+      # actors performing the same action on a single target. The strategy defines the
-      # the rules for which activities are related.
+      # rules for which activities are related.
       class ConsolidationStrategy
         include Google::Apis::Core::Hashable
       
         # A strategy which consolidates activities using the grouping rules from the
-        # legacy V1 Activity API. Similar actions occurring within a window of time
+        # legacy V1 Activity API. Similar actions occurring within a window of time can
-        # can be grouped across multiple targets (such as moving a set of files at
+        # be grouped across multiple targets (such as moving a set of files at once) or
-        # once) or multiple actors (such as several users editing the same item).
+        # multiple actors (such as several users editing the same item). Grouping rules
-        # Grouping rules for this strategy are specific to each type of action.
+        # for this strategy are specific to each type of action.
         # Corresponds to the JSON property `legacy`
         # @return [Google::Apis::DriveactivityV2::Legacy]
         attr_accessor :legacy
@@ -473,9 +473,8 @@ module Google
       class Drive
         include Google::Apis::Core::Hashable
       
-        # The resource name of the shared drive. The format is
+        # The resource name of the shared drive. The format is "COLLECTION_ID/DRIVE_ID".
-        # "COLLECTION_ID/DRIVE_ID". Clients should not assume a specific collection
+        # Clients should not assume a specific collection ID for this resource name.
-        # ID for this resource name.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -502,12 +501,12 @@ module Google
         end
       end
       
-      # A single Drive activity comprising one or more Actions by one or more
+      # A single Drive activity comprising one or more Actions by one or more Actors
-      # Actors on one or more Targets. Some Action groupings occur spontaneously,
+      # on one or more Targets. Some Action groupings occur spontaneously, such as
-      # such as moving an item into a shared folder triggering a permission change.
+      # moving an item into a shared folder triggering a permission change. Other
-      # Other groupings of related Actions, such as multiple Actors editing one item
+      # groupings of related Actions, such as multiple Actors editing one item or
-      # or moving multiple files into a new folder, are controlled by the selection
+      # moving multiple files into a new folder, are controlled by the selection of a
-      # of a ConsolidationStrategy in the QueryDriveActivityRequest.
+      # ConsolidationStrategy in the QueryDriveActivityRequest.
       class DriveActivity
         include Google::Apis::Core::Hashable
       
@@ -527,8 +526,7 @@ module Google
         attr_accessor :primary_action_detail
       
         # All Google Drive objects this activity is about (e.g. file, folder, drive).
-        # This represents the state of the target immediately after the actions
+        # This represents the state of the target immediately after the actions occurred.
-        # occurred.
         # Corresponds to the JSON property `targets`
         # @return [Array<Google::Apis::DriveactivityV2::Target>]
         attr_accessor :targets
@@ -614,8 +612,8 @@ module Google
         # @return [Google::Apis::DriveactivityV2::Folder]
         attr_accessor :folder
       
-        # The MIME type of the Drive item.  See
+        # The MIME type of the Drive item. See https://developers.google.com/drive/v3/
-        # https://developers.google.com/drive/v3/web/mime-types.
+        # web/mime-types.
         # Corresponds to the JSON property `mimeType`
         # @return [String]
         attr_accessor :mime_type
@@ -705,9 +703,8 @@ module Google
       class DriveReference
         include Google::Apis::Core::Hashable
       
-        # The resource name of the shared drive. The format is
+        # The resource name of the shared drive. The format is "COLLECTION_ID/DRIVE_ID".
-        # "COLLECTION_ID/DRIVE_ID". Clients should not assume a specific collection
+        # Clients should not assume a specific collection ID for this resource name.
-        # ID for this resource name.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -759,22 +756,22 @@ module Google
         include Google::Apis::Core::Hashable
       
         # The comment in the discussion thread. This identifier is an opaque string
-        # compatible with the Drive API; see
+        # compatible with the Drive API; see https://developers.google.com/drive/v3/
-        # https://developers.google.com/drive/v3/reference/comments/get
+        # reference/comments/get
         # Corresponds to the JSON property `legacyCommentId`
         # @return [String]
         attr_accessor :legacy_comment_id
       
         # The discussion thread to which the comment was added. This identifier is an
-        # opaque string compatible with the Drive API and references the first
+        # opaque string compatible with the Drive API and references the first comment
-        # comment in a discussion; see
+        # in a discussion; see https://developers.google.com/drive/v3/reference/comments/
-        # https://developers.google.com/drive/v3/reference/comments/get
+        # get
         # Corresponds to the JSON property `legacyDiscussionId`
         # @return [String]
         attr_accessor :legacy_discussion_id
       
-        # The link to the discussion thread containing this comment, for example,
+        # The link to the discussion thread containing this comment, for example, "https:
-        # "https://docs.google.com/DOCUMENT_ID/edit?disco=THREAD_ID".
+        # //docs.google.com/DOCUMENT_ID/edit?disco=THREAD_ID".
         # Corresponds to the JSON property `linkToDiscussion`
         # @return [String]
         attr_accessor :link_to_discussion
@@ -871,9 +868,9 @@ module Google
         attr_accessor :is_current_user
         alias_method :is_current_user?, :is_current_user
       
-        # The identifier for this user that can be used with the People API to get
+        # The identifier for this user that can be used with the People API to get more
-        # more information. The format is "people/ACCOUNT_ID". See
+        # information. The format is "people/ACCOUNT_ID". See https://developers.google.
-        # https://developers.google.com/people/.
+        # com/people/.
         # Corresponds to the JSON property `personName`
         # @return [String]
         attr_accessor :person_name
@@ -890,10 +887,10 @@ module Google
       end
       
       # A strategy which consolidates activities using the grouping rules from the
-      # legacy V1 Activity API. Similar actions occurring within a window of time
+      # legacy V1 Activity API. Similar actions occurring within a window of time can
-      # can be grouped across multiple targets (such as moving a set of files at
+      # be grouped across multiple targets (such as moving a set of files at once) or
-      # once) or multiple actors (such as several users editing the same item).
+      # multiple actors (such as several users editing the same item). Grouping rules
-      # Grouping rules for this strategy are specific to each type of action.
+      # for this strategy are specific to each type of action.
       class Legacy
         include Google::Apis::Core::Hashable
       
@@ -1020,10 +1017,8 @@ module Google
         # @return [Google::Apis::DriveactivityV2::Group]
         attr_accessor :group
       
-        # Indicates the
+        # Indicates the Google Drive permissions role. The role determines a user's
-        # <a href="/drive/web/manage-sharing#roles">Google Drive permissions
+        # ability to read, write, and comment on items.
-        # role</a>. The role determines a user's ability to read, write, and
-        # comment on items.
         # Corresponds to the JSON property `role`
         # @return [String]
         attr_accessor :role
@@ -1096,8 +1091,8 @@ module Google
       class QueryDriveActivityRequest
         include Google::Apis::Core::Hashable
       
-        # Return activities for this Drive folder and all children and descendants.
+        # Return activities for this Drive folder and all children and descendants. The
-        # The format is "items/ITEM_ID".
+        # format is "items/ITEM_ID".
         # Corresponds to the JSON property `ancestorName`
         # @return [String]
         attr_accessor :ancestor_name
@@ -1105,50 +1100,42 @@ module Google
         # How the individual activities are consolidated. A set of activities may be
         # consolidated into one combined activity if they are related in some way, such
         # as one actor performing the same action on multiple targets, or multiple
-        # actors performing the same action on a single target. The strategy defines
+        # actors performing the same action on a single target. The strategy defines the
-        # the rules for which activities are related.
+        # rules for which activities are related.
         # Corresponds to the JSON property `consolidationStrategy`
         # @return [Google::Apis::DriveactivityV2::ConsolidationStrategy]
         attr_accessor :consolidation_strategy
       
         # The filtering for items returned from this query request. The format of the
-        # filter string is a sequence of expressions, joined by an optional "AND",
+        # filter string is a sequence of expressions, joined by an optional "AND", where
-        # where each expression is of the form "field operator value".
+        # each expression is of the form "field operator value". Supported fields: -
-        # Supported fields:
+        # time: Uses numerical operators on date values either in terms of milliseconds
-        # - <tt>time</tt>: Uses numerical operators on date values either in
+        # since Jan 1, 1970 or in RFC 3339 format. Examples: - time > 1452409200000 AND
-        # terms of milliseconds since Jan 1, 1970 or in RFC 3339 format.
+        # time <= 1492812924310 - time >= "2016-01-10T01:02:03-05:00" - detail.
-        # Examples:
+        # action_detail_case: Uses the "has" operator (:) and either a singular value or
-        # - <tt>time > 1452409200000 AND time <= 1492812924310</tt>
+        # a list of allowed action types enclosed in parentheses. Examples: - detail.
-        # - <tt>time >= "2016-01-10T01:02:03-05:00"</tt>
+        # action_detail_case: RENAME - detail.action_detail_case:(CREATE EDIT) - -detail.
-        # - <tt>detail.action_detail_case</tt>: Uses the "has" operator (:) and
+        # action_detail_case:MOVE
-        # either a singular value or a list of allowed action types enclosed in
-        # parentheses.
-        # Examples:
-        # - <tt>detail.action_detail_case: RENAME</tt>
-        # - <tt>detail.action_detail_case:(CREATE EDIT)</tt>
-        # - <tt>-detail.action_detail_case:MOVE</tt>
         # Corresponds to the JSON property `filter`
         # @return [String]
         attr_accessor :filter
       
-        # Return activities for this Drive item. The format is
+        # Return activities for this Drive item. The format is "items/ITEM_ID".
-        # "items/ITEM_ID".
         # Corresponds to the JSON property `itemName`
         # @return [String]
         attr_accessor :item_name
       
         # The miminum number of activities desired in the response; the server will
         # attempt to return at least this quanitity. The server may also return fewer
-        # activities if it has a partial response ready before the request times out.
+        # activities if it has a partial response ready before the request times out. If
-        # If not set, a default value is used.
+        # not set, a default value is used.
         # Corresponds to the JSON property `pageSize`
         # @return [Fixnum]
         attr_accessor :page_size
       
         # The token identifying which page of results to return. Set this to the
-        # next_page_token value returned from a previous query to obtain the
+        # next_page_token value returned from a previous query to obtain the following
-        # following page of results. If not set, the first page of results will be
+        # page of results. If not set, the first page of results will be returned.
-        # returned.
         # Corresponds to the JSON property `pageToken`
         # @return [String]
         attr_accessor :page_token
@@ -1177,8 +1164,8 @@ module Google
         # @return [Array<Google::Apis::DriveactivityV2::DriveActivity>]
         attr_accessor :activities
       
-        # Token to retrieve the next page of results, or
+        # Token to retrieve the next page of results, or empty if there are no more
-        # empty if there are no more results in the list.
+        # results in the list.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token

generated/google/apis/firebase_v1beta1.rb

@@ -26,7 +26,7 @@ module Google
     # @see https://firebase.google.com
     module FirebaseV1beta1
       VERSION = 'V1beta1'
-      REVISION = '20200727'
+      REVISION = '20200803'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

generated/google/apis/firebasedynamiclinks_v1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://firebase.google.com/docs/dynamic-links/
     module FirebasedynamiclinksV1
       VERSION = 'V1'
-      REVISION = '20200218'
+      REVISION = '20200803'
 
       # View and administer all your Firebase data and settings
       AUTH_FIREBASE = 'https://www.googleapis.com/auth/firebase'

generated/google/apis/firebasedynamiclinks_v1/classes.rb

@@ -26,10 +26,9 @@ module Google
       class AnalyticsInfo
         include Google::Apis::Core::Hashable
       
-        # Parameters for Google Play Campaign Measurements.
+        # Parameters for Google Play Campaign Measurements. [Learn more](https://
-        # [Learn
+        # developers.google.com/analytics/devguides/collection/android/v4/campaigns#
-        # more](https://developers.google.com/analytics/devguides/collection/android/v4/
+        # campaign-params)
-        # campaigns#campaign-params)
         # Corresponds to the JSON property `googlePlayAnalytics`
         # @return [Google::Apis::FirebasedynamiclinksV1::GooglePlayAnalytics]
         attr_accessor :google_play_analytics
@@ -64,8 +63,8 @@ module Google
         # @return [String]
         attr_accessor :android_link
       
-        # Minimum version code for the Android app. If the installed app’s version
+        # Minimum version code for the Android app. If the installed app’s version code
-        # code is lower, then the user is taken to the Play Store.
+        # is lower, then the user is taken to the Play Store.
         # Corresponds to the JSON property `androidMinPackageVersionCode`
         # @return [String]
         attr_accessor :android_min_package_version_code
@@ -97,19 +96,17 @@ module Google
         # @return [Google::Apis::FirebasedynamiclinksV1::DynamicLinkInfo]
         attr_accessor :dynamic_link_info
       
-        # Full long Dynamic Link URL with desired query parameters specified.
+        # Full long Dynamic Link URL with desired query parameters specified. For
-        # For example,
+        # example, "https://sample.app.goo.gl/?link=http://www.google.com&apn=com.sample"
-        # "https://sample.app.goo.gl/?link=http://www.google.com&apn=com.sample",
+        # , [Learn more](https://firebase.google.com/docs/reference/dynamic-links/link-
-        # [Learn
+        # shortener).
-        # more](https://firebase.google.com/docs/reference/dynamic-links/link-shortener).
         # Corresponds to the JSON property `longDynamicLink`
         # @return [String]
         attr_accessor :long_dynamic_link
       
         # Link name to associate with the link. It's used for marketer to identify
-        # manually-created links in the Firebase console
+        # manually-created links in the Firebase console (https://console.firebase.
-        # (https://console.firebase.google.com/).
+        # google.com/). Links must be named to be tracked.
-        # Links must be named to be tracked.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -178,11 +175,10 @@ module Google
         # @return [Google::Apis::FirebasedynamiclinksV1::DynamicLinkInfo]
         attr_accessor :dynamic_link_info
       
-        # Full long Dynamic Link URL with desired query parameters specified.
+        # Full long Dynamic Link URL with desired query parameters specified. For
-        # For example,
+        # example, "https://sample.app.goo.gl/?link=http://www.google.com&apn=com.sample"
-        # "https://sample.app.goo.gl/?link=http://www.google.com&apn=com.sample",
+        # , [Learn more](https://firebase.google.com/docs/reference/dynamic-links/link-
-        # [Learn
+        # shortener).
-        # more](https://firebase.google.com/docs/reference/dynamic-links/link-shortener).
         # Corresponds to the JSON property `longDynamicLink`
         # @return [String]
         attr_accessor :long_dynamic_link
@@ -274,16 +270,14 @@ module Google
         # @return [String]
         attr_accessor :language_code
       
-        # Device language code setting obtained by executing JavaScript code in
+        # Device language code setting obtained by executing JavaScript code in WebView.
-        # WebView.
         # Corresponds to the JSON property `languageCodeFromWebview`
         # @return [String]
         attr_accessor :language_code_from_webview
       
-        # Device language code raw setting.
+        # Device language code raw setting. iOS does returns language code in different
-        # iOS does returns language code in different format than iOS WebView.
+        # format than iOS WebView. For example WebView returns en_US, but iOS returns en-
-        # For example WebView returns en_US, but iOS returns en-US.
+        # US. Field below will return raw value returned by iOS.
-        # Field below will return raw value returned by iOS.
         # Corresponds to the JSON property `languageCodeRaw`
         # @return [String]
         attr_accessor :language_code_raw
@@ -369,19 +363,18 @@ module Google
         # @return [Google::Apis::FirebasedynamiclinksV1::DesktopInfo]
         attr_accessor :desktop_info
       
-        # E.g. https://maps.app.goo.gl, https://maps.page.link, https://g.co/maps
+        # E.g. https://maps.app.goo.gl, https://maps.page.link, https://g.co/maps More
-        # More examples can be found in description of getNormalizedUriPrefix in
+        # examples can be found in description of getNormalizedUriPrefix in j/c/g/
-        # j/c/g/firebase/dynamiclinks/uri/DdlDomain.java
+        # firebase/dynamiclinks/uri/DdlDomain.java Will fallback to dynamic_link_domain
-        # Will fallback to dynamic_link_domain is this field is missing
+        # is this field is missing
         # Corresponds to the JSON property `domainUriPrefix`
         # @return [String]
         attr_accessor :domain_uri_prefix
       
-        # Dynamic Links domain that the project owns, e.g. abcd.app.goo.gl
+        # Dynamic Links domain that the project owns, e.g. abcd.app.goo.gl [Learn more](
-        # [Learn
+        # https://firebase.google.com/docs/dynamic-links/android/receive) on how to set
-        # more](https://firebase.google.com/docs/dynamic-links/android/receive) on
+        # up Dynamic Link domain associated with your Firebase project. Required if
-        # how to set up Dynamic Link domain associated with your Firebase project.
+        # missing domain_uri_prefix.
-        # Required if missing domain_uri_prefix.
         # Corresponds to the JSON property `dynamicLinkDomain`
         # @return [String]
         attr_accessor :dynamic_link_domain
@@ -391,12 +384,10 @@ module Google
         # @return [Google::Apis::FirebasedynamiclinksV1::IosInfo]
         attr_accessor :ios_info
       
-        # The link your app will open, You can specify any URL your app can handle.
+        # The link your app will open, You can specify any URL your app can handle. This
-        # This link must be a well-formatted URL, be properly URL-encoded, and use
+        # link must be a well-formatted URL, be properly URL-encoded, and use the HTTP
-        # the HTTP or HTTPS scheme. See 'link' parameters in the
+        # or HTTPS scheme. See 'link' parameters in the [documentation](https://firebase.
-        # [documentation](https://firebase.google.com/docs/dynamic-links/create-manually)
+        # google.com/docs/dynamic-links/create-manually). Required.
-        # .
-        # Required.
         # Corresponds to the JSON property `link`
         # @return [String]
         attr_accessor :link
@@ -406,8 +397,8 @@ module Google
         # @return [Google::Apis::FirebasedynamiclinksV1::NavigationInfo]
         attr_accessor :navigation_info
       
-        # Parameters for social meta tag params.
+        # Parameters for social meta tag params. Used to set meta tag data for link
-        # Used to set meta tag data for link previews on social sites.
+        # previews on social sites.
         # Corresponds to the JSON property `socialMetaTagInfo`
         # @return [Google::Apis::FirebasedynamiclinksV1::SocialMetaTagInfo]
         attr_accessor :social_meta_tag_info
@@ -481,13 +472,13 @@ module Google
       end
       
       # Request for iSDK to execute strong match flow for post-install attribution.
-      # This is meant for iOS requests only. Requests from other platforms will
+      # This is meant for iOS requests only. Requests from other platforms will not be
-      # not be honored.
+      # honored.
       class GetIosPostInstallAttributionRequest
         include Google::Apis::Core::Hashable
       
-        # App installation epoch time (https://en.wikipedia.org/wiki/Unix_time).
+        # App installation epoch time (https://en.wikipedia.org/wiki/Unix_time). This is
-        # This is a client signal for a more accurate weak match.
+        # a client signal for a more accurate weak match.
         # Corresponds to the JSON property `appInstallationTime`
         # @return [Fixnum]
         attr_accessor :app_installation_time
@@ -502,15 +493,13 @@ module Google
         # @return [Google::Apis::FirebasedynamiclinksV1::DeviceInfo]
         attr_accessor :device
       
-        # iOS version, ie: 9.3.5.
+        # iOS version, ie: 9.3.5. Consider adding "build".
-        # Consider adding "build".
         # Corresponds to the JSON property `iosVersion`
         # @return [String]
         attr_accessor :ios_version
       
-        # App post install attribution retrieval information. Disambiguates
+        # App post install attribution retrieval information. Disambiguates mechanism (
-        # mechanism (iSDK or developer invoked) to retrieve payload from
+        # iSDK or developer invoked) to retrieve payload from clicked link.
-        # clicked link.
         # Corresponds to the JSON property `retrievalMethod`
         # @return [String]
         attr_accessor :retrieval_method
@@ -521,14 +510,14 @@ module Google
         attr_accessor :sdk_version
       
         # Possible unique matched link that server need to check before performing
-        # fingerprint match. If passed link is short server need to expand the link.
+        # fingerprint match. If passed link is short server need to expand the link. If
-        # If link is long server need to vslidate the link.
+        # link is long server need to vslidate the link.
         # Corresponds to the JSON property `uniqueMatchLinkToCheck`
         # @return [String]
         attr_accessor :unique_match_link_to_check
       
-        # Strong match page information. Disambiguates between default UI and
+        # Strong match page information. Disambiguates between default UI and custom
-        # custom page to present when strong match succeeds/fails to find cookie.
+        # page to present when strong match succeeds/fails to find cookie.
         # Corresponds to the JSON property `visualStyle`
         # @return [String]
         attr_accessor :visual_style
@@ -554,8 +543,8 @@ module Google
       class GetIosPostInstallAttributionResponse
         include Google::Apis::Core::Hashable
       
-        # The minimum version for app, specified by dev through ?imv= parameter.
+        # The minimum version for app, specified by dev through ?imv= parameter. Return
-        # Return to iSDK to allow app to evaluate if current version meets this.
+        # to iSDK to allow app to evaluate if current version meets this.
         # Corresponds to the JSON property `appMinimumVersion`
         # @return [String]
         attr_accessor :app_minimum_version
@@ -565,46 +554,44 @@ module Google
         # @return [String]
         attr_accessor :attribution_confidence
       
-        # The deep-link attributed post-install via one of several techniques
+        # The deep-link attributed post-install via one of several techniques (
-        # (fingerprint, copy unique).
+        # fingerprint, copy unique).
         # Corresponds to the JSON property `deepLink`
         # @return [String]
         attr_accessor :deep_link
       
         # User-agent specific custom-scheme URIs for iSDK to open. This will be set
-        # according to the user-agent tha the click was originally made in. There is
+        # according to the user-agent tha the click was originally made in. There is no
-        # no Safari-equivalent custom-scheme open URLs.
+        # Safari-equivalent custom-scheme open URLs. ie: googlechrome://www.example.com
-        # ie: googlechrome://www.example.com
+        # ie: firefox://open-url?url=http://www.example.com ie: opera-http://example.com
-        # ie: firefox://open-url?url=http://www.example.com
-        # ie: opera-http://example.com
         # Corresponds to the JSON property `externalBrowserDestinationLink`
         # @return [String]
         attr_accessor :external_browser_destination_link
       
-        # The link to navigate to update the app if min version is not met.
+        # The link to navigate to update the app if min version is not met. This is
-        # This is either (in order): 1) fallback link (from ?ifl= parameter, if
+        # either (in order): 1) fallback link (from ?ifl= parameter, if specified by
-        # specified by developer) or 2) AppStore URL (from ?isi= parameter, if
+        # developer) or 2) AppStore URL (from ?isi= parameter, if specified), or 3) the
-        # specified), or 3) the payload link (from required link= parameter).
+        # payload link (from required link= parameter).
         # Corresponds to the JSON property `fallbackLink`
         # @return [String]
         attr_accessor :fallback_link
       
-        # Invitation ID attributed post-install via one of several techniques
+        # Invitation ID attributed post-install via one of several techniques (
-        # (fingerprint, copy unique).
+        # fingerprint, copy unique).
         # Corresponds to the JSON property `invitationId`
         # @return [String]
         attr_accessor :invitation_id
       
-        # Instruction for iSDK to attemmpt to perform strong match. For instance,
+        # Instruction for iSDK to attemmpt to perform strong match. For instance, if
-        # if browser does not support/allow cookie or outside of support browsers,
+        # browser does not support/allow cookie or outside of support browsers, this
-        # this will be false.
+        # will be false.
         # Corresponds to the JSON property `isStrongMatchExecutable`
         # @return [Boolean]
         attr_accessor :is_strong_match_executable
         alias_method :is_strong_match_executable?, :is_strong_match_executable
       
-        # Describes why match failed, ie: "discarded due to low confidence".
+        # Describes why match failed, ie: "discarded due to low confidence". This
-        # This message will be publicly visible.
+        # message will be publicly visible.
         # Corresponds to the JSON property `matchMessage`
         # @return [String]
         attr_accessor :match_message
@@ -621,10 +608,10 @@ module Google
         attr_accessor :requested_link
       
         # The entire FDL, expanded from a short link. It is the same as the
-        # requested_link, if it is long. Parameters from this should not be
+        # requested_link, if it is long. Parameters from this should not be used
-        # used directly (ie: server can default utm_[campaign|medium|source]
+        # directly (ie: server can default utm_[campaign|medium|source] to a value when
-        # to a value when requested_link lack them, server determine the best
+        # requested_link lack them, server determine the best fallback_link when
-        # fallback_link when requested_link specifies >1 fallback links).
+        # requested_link specifies >1 fallback links).
         # Corresponds to the JSON property `resolvedLink`
         # @return [String]
         attr_accessor :resolved_link
@@ -689,14 +676,9 @@ module Google
         # @return [String]
         attr_accessor :bundle_id
       
-        # FDL link to be verified from an app universal link open.
+        # FDL link to be verified from an app universal link open. The FDL link can be
-        # The FDL link can be one of:
+        # one of: 1) short FDL. e.g. .page.link/, or 2) long FDL. e.g. .page.link/?`
-        # 1) short FDL.
+        # query params`, or 3) Invite FDL. e.g. .page.link/i/
-        # e.g. <app_code>.page.link/<ddl_id>, or
-        # 2) long FDL.
-        # e.g. <app_code>.page.link/?`query params`, or
-        # 3) Invite FDL.
-        # e.g. <app_code>.page.link/i/<invite_id_or_alias>
         # Corresponds to the JSON property `requestedLink`
         # @return [String]
         attr_accessor :requested_link
@@ -723,8 +705,8 @@ module Google
       class GetIosReopenAttributionResponse
         include Google::Apis::Core::Hashable
       
-        # The deep-link attributed the app universal link open. For both regular
+        # The deep-link attributed the app universal link open. For both regular FDL
-        # FDL links and invite FDL links.
+        # links and invite FDL links.
         # Corresponds to the JSON property `deepLink`
         # @return [String]
         attr_accessor :deep_link
@@ -734,8 +716,8 @@ module Google
         # @return [String]
         attr_accessor :invitation_id
       
-        # FDL input value of the "&imv=" parameter, minimum app version to be
+        # FDL input value of the "&imv=" parameter, minimum app version to be returned
-        # returned to Google Firebase SDK running on iOS-9.
+        # to Google Firebase SDK running on iOS-9.
         # Corresponds to the JSON property `iosMinAppVersion`
         # @return [String]
         attr_accessor :ios_min_app_version
@@ -789,17 +771,15 @@ module Google
         end
       end
       
-      # Parameters for Google Play Campaign Measurements.
+      # Parameters for Google Play Campaign Measurements. [Learn more](https://
-      # [Learn
+      # developers.google.com/analytics/devguides/collection/android/v4/campaigns#
-      # more](https://developers.google.com/analytics/devguides/collection/android/v4/
+      # campaign-params)
-      # campaigns#campaign-params)
       class GooglePlayAnalytics
         include Google::Apis::Core::Hashable
       
-        # [AdWords autotagging
+        # [AdWords autotagging parameter](https://support.google.com/analytics/answer/
-        # parameter](https://support.google.com/analytics/answer/1033981?hl=en); used
+        # 1033981?hl=en); used to measure Google AdWords ads. This value is generated
-        # to measure Google AdWords ads. This value is generated dynamically and
+        # dynamically and should never be modified.
-        # should never be modified.
         # Corresponds to the JSON property `gclid`
         # @return [String]
         attr_accessor :gclid
@@ -821,8 +801,7 @@ module Google
         # @return [String]
         attr_accessor :utm_medium
       
-        # Campaign source; used to identify a search engine, newsletter, or other
+        # Campaign source; used to identify a search engine, newsletter, or other source.
-        # source.
         # Corresponds to the JSON property `utmSource`
         # @return [String]
         attr_accessor :utm_source
@@ -856,8 +835,8 @@ module Google
         # @return [String]
         attr_accessor :at
       
-        # Campaign text that developers can optionally add to any link in order to
+        # Campaign text that developers can optionally add to any link in order to track
-        # track sales from a specific marketing campaign.
+        # sales from a specific marketing campaign.
         # Corresponds to the JSON property `ct`
         # @return [String]
         attr_accessor :ct
@@ -900,9 +879,8 @@ module Google
         # @return [String]
         attr_accessor :ios_bundle_id
       
-        # Custom (destination) scheme to use for iOS. By default, we’ll use the
+        # Custom (destination) scheme to use for iOS. By default, we’ll use the bundle
-        # bundle ID as the custom scheme. Developer can override this behavior using
+        # ID as the custom scheme. Developer can override this behavior using this param.
-        # this param.
         # Corresponds to the JSON property `iosCustomScheme`
         # @return [String]
         attr_accessor :ios_custom_scheme
@@ -968,8 +946,7 @@ module Google
         # @return [String]
         attr_accessor :link
       
-        # Link name defined by the creator.
+        # Link name defined by the creator. Required.
-        # Required.
         # Corresponds to the JSON property `linkName`
         # @return [String]
         attr_accessor :link_name
@@ -998,8 +975,8 @@ module Google
       class NavigationInfo
         include Google::Apis::Core::Hashable
       
-        # If this option is on, FDL click will be forced to redirect rather than
+        # If this option is on, FDL click will be forced to redirect rather than show an
-        # show an interstitial page.
+        # interstitial page.
         # Corresponds to the JSON property `enableForcedRedirect`
         # @return [Boolean]
         attr_accessor :enable_forced_redirect
@@ -1015,8 +992,8 @@ module Google
         end
       end
       
-      # Parameters for social meta tag params.
+      # Parameters for social meta tag params. Used to set meta tag data for link
-      # Used to set meta tag data for link previews on social sites.
+      # previews on social sites.
       class SocialMetaTagInfo
         include Google::Apis::Core::Hashable
       

generated/google/apis/firebasedynamiclinks_v1/service.rb

@@ -47,17 +47,15 @@ module Google
           @batch_path = 'batch'
         end
         
-        # Creates a managed short Dynamic Link given either a valid long Dynamic Link
+        # Creates a managed short Dynamic Link given either a valid long Dynamic Link or
-        # or details such as Dynamic Link domain, Android and iOS app information.
+        # details such as Dynamic Link domain, Android and iOS app information. The
-        # The created short Dynamic Link will not expire.
+        # created short Dynamic Link will not expire. This differs from
-        # This differs from CreateShortDynamicLink in the following ways:
+        # CreateShortDynamicLink in the following ways: - The request will also contain
-        # - The request will also contain a name for the link (non unique name
+        # a name for the link (non unique name for the front end). - The response must
-        # for the front end).
+        # be authenticated with an auth token (generated with the admin service account).
-        # - The response must be authenticated with an auth token (generated with
+        # - The link will appear in the FDL list of links in the console front end. The
-        # the admin service account).
+        # Dynamic Link domain in the request must be owned by requester's Firebase
-        # - The link will appear in the FDL list of links in the console front end.
+        # project.
-        # The Dynamic Link domain in the request must be owned by requester's
-        # Firebase project.
         # @param [Google::Apis::FirebasedynamiclinksV1::CreateManagedShortLinkRequest] create_managed_short_link_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -87,13 +85,12 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates a short Dynamic Link given either a valid long Dynamic Link or
+        # Creates a short Dynamic Link given either a valid long Dynamic Link or details
-        # details such as Dynamic Link domain, Android and iOS app information.
+        # such as Dynamic Link domain, Android and iOS app information. The created
-        # The created short Dynamic Link will not expire.
+        # short Dynamic Link will not expire. Repeated calls with the same long Dynamic
-        # Repeated calls with the same long Dynamic Link or Dynamic Link information
+        # Link or Dynamic Link information will produce the same short Dynamic Link. The
-        # will produce the same short Dynamic Link.
+        # Dynamic Link domain in the request must be owned by requester's Firebase
-        # The Dynamic Link domain in the request must be owned by requester's
+        # project.
-        # Firebase project.
         # @param [Google::Apis::FirebasedynamiclinksV1::CreateShortDynamicLinkRequest] create_short_dynamic_link_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -123,9 +120,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Fetches analytics stats of a short Dynamic Link for a given
+        # Fetches analytics stats of a short Dynamic Link for a given duration. Metrics
-        # duration. Metrics include number of clicks, redirects, installs,
+        # include number of clicks, redirects, installs, app first opens, and app
-        # app first opens, and app reopens.
+        # reopens.
         # @param [String] dynamic_link
         #   Dynamic Link URL. e.g. https://abcd.app.goo.gl/wxyz
         # @param [Fixnum] duration_days

generated/google/apis/firebaseml_v1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://firebase.google.com
     module FirebasemlV1
       VERSION = 'V1'
-      REVISION = '20200519'
+      REVISION = '20200803'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

generated/google/apis/firebaseml_v1/classes.rb

@@ -35,13 +35,11 @@ module Google
         end
       end
       
-      # A generic empty message that you can re-use to avoid defining duplicated
+      # A generic empty message that you can re-use to avoid defining duplicated empty
-      # empty messages in your APIs. A typical example is to use it as the request
+      # messages in your APIs. A typical example is to use it as the request or the
-      # or the response type of an API method. For instance:
+      # response type of an API method. For instance: service Foo ` rpc Bar(google.
-      # service Foo `
+      # protobuf.Empty) returns (google.protobuf.Empty); ` The JSON representation for
-      # rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
+      # `Empty` is empty JSON object ````.
-      # `
-      # The JSON representation for `Empty` is empty JSON object ````.
       class Empty
         include Google::Apis::Core::Hashable
       
@@ -79,8 +77,7 @@ module Google
         end
       end
       
-      # This is returned in the longrunning operations
+      # This is returned in the longrunning operations for create/update.
-      # for create/update.
       class ModelOperationMetadata
         include Google::Apis::Core::Hashable
       
@@ -89,8 +86,8 @@ module Google
         # @return [String]
         attr_accessor :basic_operation_status
       
-        # The name of the model we are creating/updating
+        # The name of the model we are creating/updating The name must have the form `
-        # The name must have the form `projects/`project_id`/models/`model_id``
+        # projects/`project_id`/models/`model_id``
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -111,47 +108,45 @@ module Google
       class Operation
         include Google::Apis::Core::Hashable
       
-        # If the value is `false`, it means the operation is still in progress.
+        # If the value is `false`, it means the operation is still in progress. If `true`
-        # If `true`, the operation is completed, and either `error` or `response` is
+        # , the operation is completed, and either `error` or `response` is available.
-        # available.
         # Corresponds to the JSON property `done`
         # @return [Boolean]
         attr_accessor :done
         alias_method :done?, :done
       
-        # The `Status` type defines a logical error model that is suitable for
+        # The `Status` type defines a logical error model that is suitable for different
-        # different programming environments, including REST APIs and RPC APIs. It is
+        # programming environments, including REST APIs and RPC APIs. It is used by [
-        # used by [gRPC](https://github.com/grpc). Each `Status` message contains
+        # gRPC](https://github.com/grpc). Each `Status` message contains three pieces of
-        # three pieces of data: error code, error message, and error details.
+        # data: error code, error message, and error details. You can find out more
-        # You can find out more about this error model and how to work with it in the
+        # about this error model and how to work with it in the [API Design Guide](https:
-        # [API Design Guide](https://cloud.google.com/apis/design/errors).
+        # //cloud.google.com/apis/design/errors).
         # Corresponds to the JSON property `error`
         # @return [Google::Apis::FirebasemlV1::Status]
         attr_accessor :error
       
-        # Service-specific metadata associated with the operation.  It typically
+        # Service-specific metadata associated with the operation. It typically contains
-        # contains progress information and common metadata such as create time.
+        # progress information and common metadata such as create time. Some services
-        # Some services might not provide such metadata.  Any method that returns a
+        # might not provide such metadata. Any method that returns a long-running
-        # long-running operation should document the metadata type, if any.
+        # operation should document the metadata type, if any.
         # Corresponds to the JSON property `metadata`
         # @return [Hash<String,Object>]
         attr_accessor :metadata
       
         # The server-assigned name, which is only unique within the same service that
-        # originally returns it. If you use the default HTTP mapping, the
+        # originally returns it. If you use the default HTTP mapping, the `name` should
-        # `name` should be a resource name ending with `operations/`unique_id``.
+        # be a resource name ending with `operations/`unique_id``.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # The normal response of the operation in case of success.  If the original
+        # The normal response of the operation in case of success. If the original
-        # method returns no data on success, such as `Delete`, the response is
+        # method returns no data on success, such as `Delete`, the response is `google.
-        # `google.protobuf.Empty`.  If the original method is standard
+        # protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`,
-        # `Get`/`Create`/`Update`, the response should be the resource.  For other
+        # the response should be the resource. For other methods, the response should
-        # methods, the response should have the type `XxxResponse`, where `Xxx`
+        # have the type `XxxResponse`, where `Xxx` is the original method name. For
-        # is the original method name.  For example, if the original method name
+        # example, if the original method name is `TakeSnapshot()`, the inferred
-        # is `TakeSnapshot()`, the inferred response type is
+        # response type is `TakeSnapshotResponse`.
-        # `TakeSnapshotResponse`.
         # Corresponds to the JSON property `response`
         # @return [Hash<String,Object>]
         attr_accessor :response
@@ -170,12 +165,12 @@ module Google
         end
       end
       
-      # The `Status` type defines a logical error model that is suitable for
+      # The `Status` type defines a logical error model that is suitable for different
-      # different programming environments, including REST APIs and RPC APIs. It is
+      # programming environments, including REST APIs and RPC APIs. It is used by [
-      # used by [gRPC](https://github.com/grpc). Each `Status` message contains
+      # gRPC](https://github.com/grpc). Each `Status` message contains three pieces of
-      # three pieces of data: error code, error message, and error details.
+      # data: error code, error message, and error details. You can find out more
-      # You can find out more about this error model and how to work with it in the
+      # about this error model and how to work with it in the [API Design Guide](https:
-      # [API Design Guide](https://cloud.google.com/apis/design/errors).
+      # //cloud.google.com/apis/design/errors).
       class Status
         include Google::Apis::Core::Hashable
       
@@ -184,15 +179,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
+        # A developer-facing error message, which should be in English. Any user-facing
-        # user-facing error message should be localized and sent in the
+        # error message should be localized and sent in the google.rpc.Status.details
-        # google.rpc.Status.details field, or localized by the client.
+        # field, or localized by the client.
         # Corresponds to the JSON property `message`
         # @return [String]
         attr_accessor :message

generated/google/apis/firebaseml_v1/service.rb

@@ -47,15 +47,13 @@ module Google
           @batch_path = 'batch'
         end
         
-        # Starts asynchronous cancellation on a long-running operation.  The server
+        # Starts asynchronous cancellation on a long-running operation. The server makes
-        # makes a best effort to cancel the operation, but success is not
+        # a best effort to cancel the operation, but success is not guaranteed. If the
-        # guaranteed.  If the server doesn't support this method, it returns
+        # server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.
-        # `google.rpc.Code.UNIMPLEMENTED`.  Clients can use
+        # Clients can use Operations.GetOperation or other methods to check whether the
-        # Operations.GetOperation or
+        # cancellation succeeded or whether the operation completed despite cancellation.
-        # other methods to check whether the cancellation succeeded or whether the
+        # On successful cancellation, the operation is not deleted; instead, it becomes
-        # operation completed despite cancellation. On successful cancellation,
+        # an operation with an Operation.error value with a google.rpc.Status.code of 1,
-        # the operation is not deleted; instead, it becomes an operation with
-        # an Operation.error value with a google.rpc.Status.code of 1,
         # corresponding to `Code.CANCELLED`.
         # @param [String] name
         #   The name of the operation resource to be cancelled.
@@ -89,10 +87,10 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes a long-running operation. This method indicates that the client is
+        # Deletes a long-running operation. This method indicates that the client is no
-        # no longer interested in the operation result. It does not cancel the
+        # longer interested in the operation result. It does not cancel the operation.
-        # operation. If the server doesn't support this method, it returns
+        # If the server doesn't support this method, it returns `google.rpc.Code.
-        # `google.rpc.Code.UNIMPLEMENTED`.
+        # UNIMPLEMENTED`.
         # @param [String] name
         #   The name of the operation resource to be deleted.
         # @param [String] fields
@@ -122,15 +120,14 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists operations that match the specified filter in the request. If the
+        # Lists operations that match the specified filter in the request. If the server
-        # server doesn't support this method, it returns `UNIMPLEMENTED`.
+        # doesn't support this method, it returns `UNIMPLEMENTED`. NOTE: the `name`
-        # NOTE: the `name` binding allows API services to override the binding
+        # binding allows API services to override the binding to use different resource
-        # to use different resource name schemes, such as `users/*/operations`. To
+        # name schemes, such as `users/*/operations`. To override the binding, API
-        # override the binding, API services can add a binding such as
+        # services can add a binding such as `"/v1/`name=users/*`/operations"` to their
-        # `"/v1/`name=users/*`/operations"` to their service configuration.
+        # service configuration. For backwards compatibility, the default name includes
-        # For backwards compatibility, the default name includes the operations
+        # the operations collection id, however overriding users must ensure the name
-        # collection id, however overriding users must ensure the name binding
+        # binding is the parent resource, without the operations collection id.
-        # is the parent resource, without the operations collection id.
         # @param [String] name
         #   The name of the operation's parent resource.
         # @param [String] filter

generated/google/apis/firebaseml_v1beta2.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://firebase.google.com
     module FirebasemlV1beta2
       VERSION = 'V1beta2'
-      REVISION = '20200722'
+      REVISION = '20200803'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

generated/google/apis/firebaseml_v1beta2/classes.rb

@@ -22,13 +22,11 @@ module Google
   module Apis
     module FirebasemlV1beta2
       
-      # A generic empty message that you can re-use to avoid defining duplicated
+      # A generic empty message that you can re-use to avoid defining duplicated empty
-      # empty messages in your APIs. A typical example is to use it as the request
+      # messages in your APIs. A typical example is to use it as the request or the
-      # or the response type of an API method. For instance:
+      # response type of an API method. For instance: service Foo ` rpc Bar(google.
-      # service Foo `
+      # protobuf.Empty) returns (google.protobuf.Empty); ` The JSON representation for
-      # rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
+      # `Empty` is empty JSON object ````.
-      # `
-      # The JSON representation for `Empty` is empty JSON object ````.
       class Empty
         include Google::Apis::Core::Hashable
       
@@ -50,8 +48,8 @@ module Google
         # @return [Array<Google::Apis::FirebasemlV1beta2::Model>]
         attr_accessor :models
       
-        # Token to retrieve the next page of results, or empty if there are no
+        # Token to retrieve the next page of results, or empty if there are no more
-        # more results in the list.
+        # results in the list.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
@@ -83,15 +81,13 @@ module Google
         attr_accessor :create_time
       
         # Required. The name of the model to create. The name can be up to 32 characters
-        # long
+        # long and can consist only of ASCII Latin letters A-Z and a-z, underscores(_)
-        # and can consist only of ASCII Latin letters A-Z and a-z, underscores(_)
         # and ASCII digits 0-9. It must start with a letter.
         # Corresponds to the JSON property `displayName`
         # @return [String]
         attr_accessor :display_name
       
-        # Output only. See RFC7232
+        # Output only. See RFC7232 https://tools.ietf.org/html/rfc7232#section-2.3
-        # https://tools.ietf.org/html/rfc7232#section-2.3
         # Corresponds to the JSON property `etag`
         # @return [String]
         attr_accessor :etag
@@ -102,15 +98,14 @@ module Google
         # @return [String]
         attr_accessor :model_hash
       
-        # The resource name of the Model.
+        # The resource name of the Model. Model names have the form `projects/`
-        # Model names have the form `projects/`project_id`/models/`model_id``
+        # project_id`/models/`model_id`` The name is ignored when creating a model.
-        # The name is ignored when creating a model.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # State common to all model types.
+        # State common to all model types. Includes publishing and validation
-        # Includes publishing and validation information.
+        # information.
         # Corresponds to the JSON property `state`
         # @return [Google::Apis::FirebasemlV1beta2::ModelState]
         attr_accessor :state
@@ -149,8 +144,7 @@ module Google
         end
       end
       
-      # This is returned in the longrunning operations
+      # This is returned in the longrunning operations for create/update.
-      # for create/update.
       class ModelOperationMetadata
         include Google::Apis::Core::Hashable
       
@@ -159,8 +153,8 @@ module Google
         # @return [String]
         attr_accessor :basic_operation_status
       
-        # The name of the model we are creating/updating
+        # The name of the model we are creating/updating The name must have the form `
-        # The name must have the form `projects/`project_id`/models/`model_id``
+        # projects/`project_id`/models/`model_id``
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -176,8 +170,8 @@ module Google
         end
       end
       
-      # State common to all model types.
+      # State common to all model types. Includes publishing and validation
-      # Includes publishing and validation information.
+      # information.
       class ModelState
         include Google::Apis::Core::Hashable
       
@@ -187,12 +181,12 @@ module Google
         attr_accessor :published
         alias_method :published?, :published
       
-        # The `Status` type defines a logical error model that is suitable for
+        # The `Status` type defines a logical error model that is suitable for different
-        # different programming environments, including REST APIs and RPC APIs. It is
+        # programming environments, including REST APIs and RPC APIs. It is used by [
-        # used by [gRPC](https://github.com/grpc). Each `Status` message contains
+        # gRPC](https://github.com/grpc). Each `Status` message contains three pieces of
-        # three pieces of data: error code, error message, and error details.
+        # data: error code, error message, and error details. You can find out more
-        # You can find out more about this error model and how to work with it in the
+        # about this error model and how to work with it in the [API Design Guide](https:
-        # [API Design Guide](https://cloud.google.com/apis/design/errors).
+        # //cloud.google.com/apis/design/errors).
         # Corresponds to the JSON property `validationError`
         # @return [Google::Apis::FirebasemlV1beta2::Status]
         attr_accessor :validation_error
@@ -213,47 +207,45 @@ module Google
       class Operation
         include Google::Apis::Core::Hashable
       
-        # If the value is `false`, it means the operation is still in progress.
+        # If the value is `false`, it means the operation is still in progress. If `true`
-        # If `true`, the operation is completed, and either `error` or `response` is
+        # , the operation is completed, and either `error` or `response` is available.
-        # available.
         # Corresponds to the JSON property `done`
         # @return [Boolean]
         attr_accessor :done
         alias_method :done?, :done
       
-        # The `Status` type defines a logical error model that is suitable for
+        # The `Status` type defines a logical error model that is suitable for different
-        # different programming environments, including REST APIs and RPC APIs. It is
+        # programming environments, including REST APIs and RPC APIs. It is used by [
-        # used by [gRPC](https://github.com/grpc). Each `Status` message contains
+        # gRPC](https://github.com/grpc). Each `Status` message contains three pieces of
-        # three pieces of data: error code, error message, and error details.
+        # data: error code, error message, and error details. You can find out more
-        # You can find out more about this error model and how to work with it in the
+        # about this error model and how to work with it in the [API Design Guide](https:
-        # [API Design Guide](https://cloud.google.com/apis/design/errors).
+        # //cloud.google.com/apis/design/errors).
         # Corresponds to the JSON property `error`
         # @return [Google::Apis::FirebasemlV1beta2::Status]
         attr_accessor :error
       
-        # Service-specific metadata associated with the operation.  It typically
+        # Service-specific metadata associated with the operation. It typically contains
-        # contains progress information and common metadata such as create time.
+        # progress information and common metadata such as create time. Some services
-        # Some services might not provide such metadata.  Any method that returns a
+        # might not provide such metadata. Any method that returns a long-running
-        # long-running operation should document the metadata type, if any.
+        # operation should document the metadata type, if any.
         # Corresponds to the JSON property `metadata`
         # @return [Hash<String,Object>]
         attr_accessor :metadata
       
         # The server-assigned name, which is only unique within the same service that
-        # originally returns it. If you use the default HTTP mapping, the
+        # originally returns it. If you use the default HTTP mapping, the `name` should
-        # `name` should be a resource name ending with `operations/`unique_id``.
+        # be a resource name ending with `operations/`unique_id``.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # The normal response of the operation in case of success.  If the original
+        # The normal response of the operation in case of success. If the original
-        # method returns no data on success, such as `Delete`, the response is
+        # method returns no data on success, such as `Delete`, the response is `google.
-        # `google.protobuf.Empty`.  If the original method is standard
+        # protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`,
-        # `Get`/`Create`/`Update`, the response should be the resource.  For other
+        # the response should be the resource. For other methods, the response should
-        # methods, the response should have the type `XxxResponse`, where `Xxx`
+        # have the type `XxxResponse`, where `Xxx` is the original method name. For
-        # is the original method name.  For example, if the original method name
+        # example, if the original method name is `TakeSnapshot()`, the inferred
-        # is `TakeSnapshot()`, the inferred response type is
+        # response type is `TakeSnapshotResponse`.
-        # `TakeSnapshotResponse`.
         # Corresponds to the JSON property `response`
         # @return [Hash<String,Object>]
         attr_accessor :response
@@ -272,12 +264,12 @@ module Google
         end
       end
       
-      # The `Status` type defines a logical error model that is suitable for
+      # The `Status` type defines a logical error model that is suitable for different
-      # different programming environments, including REST APIs and RPC APIs. It is
+      # programming environments, including REST APIs and RPC APIs. It is used by [
-      # used by [gRPC](https://github.com/grpc). Each `Status` message contains
+      # gRPC](https://github.com/grpc). Each `Status` message contains three pieces of
-      # three pieces of data: error code, error message, and error details.
+      # data: error code, error message, and error details. You can find out more
-      # You can find out more about this error model and how to work with it in the
+      # about this error model and how to work with it in the [API Design Guide](https:
-      # [API Design Guide](https://cloud.google.com/apis/design/errors).
+      # //cloud.google.com/apis/design/errors).
       class Status
         include Google::Apis::Core::Hashable
       
@@ -286,15 +278,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
+        # A developer-facing error message, which should be in English. Any user-facing
-        # user-facing error message should be localized and sent in the
+        # error message should be localized and sent in the google.rpc.Status.details
-        # google.rpc.Status.details field, or localized by the client.
+        # field, or localized by the client.
         # Corresponds to the JSON property `message`
         # @return [String]
         attr_accessor :message
@@ -315,18 +307,16 @@ module Google
       class TfLiteModel
         include Google::Apis::Core::Hashable
       
-        # The TfLite file containing the model. (Stored in Google Cloud).
+        # The TfLite file containing the model. (Stored in Google Cloud). The
-        # The gcs_tflite_uri should have form: gs://some-bucket/some-model.tflite
+        # gcs_tflite_uri should have form: gs://some-bucket/some-model.tflite Note: If
-        # Note: If you update the file in the original location, it is
+        # you update the file in the original location, it is necessary to call
-        # necessary to call UpdateModel for ML to pick up and validate the
+        # UpdateModel for ML to pick up and validate the updated file.
-        # updated file.
         # Corresponds to the JSON property `gcsTfliteUri`
         # @return [String]
         attr_accessor :gcs_tflite_uri
       
         # Output only. A boolean indicating that this model was uploaded from the
-        # console.
+        # console. Read only
-        # Read only
         # Corresponds to the JSON property `managedUpload`
         # @return [Boolean]
         attr_accessor :managed_upload

generated/google/apis/firebaseml_v1beta2/service.rb

@@ -47,11 +47,11 @@ module Google
           @batch_path = 'batch'
         end
         
-        # Creates a model in Firebase ML.
+        # Creates a model in Firebase ML. The longrunning operation will eventually
-        # The longrunning operation will eventually return a Model
+        # return a Model
         # @param [String] parent
-        #   Required. The parent project resource where the model is to be created.
+        #   Required. The parent project resource where the model is to be created. The
-        #   The parent must have the form `projects/`project_id``
+        #   parent must have the form `projects/`project_id``
         # @param [Google::Apis::FirebasemlV1beta2::Model] model_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -84,8 +84,8 @@ module Google
         
         # Deletes a model
         # @param [String] name
-        #   Required. The name of the model to delete.
+        #   Required. The name of the model to delete. The name must have the form `
-        #   The name must have the form `projects/`project_id`/models/`model_id``
+        #   projects/`project_id`/models/`model_id``
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -115,8 +115,8 @@ module Google
         
         # Gets a model resource.
         # @param [String] name
-        #   Required. The name of the model to get.
+        #   Required. The name of the model to get. The name must have the form `projects/`
-        #   The name must have the form `projects/`project_id`/models/`model_id``
+        #   project_id`/models/`model_id``
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -146,11 +146,11 @@ module Google
         
         # Lists the models
         # @param [String] parent
-        #   Required. The name of the parent to list models for.
+        #   Required. The name of the parent to list models for. The parent must have the
-        #   The parent must have the form `projects/`project_id`'
+        #   form `projects/`project_id`'
         # @param [String] filter
-        #   A filter for the list
+        #   A filter for the list e.g. 'tags: abc' to list models which are tagged with "
-        #   e.g. 'tags: abc' to list models which are tagged with "abc"
+        #   abc"
         # @param [Fixnum] page_size
         #   The maximum number of items to return
         # @param [String] page_token
@@ -187,9 +187,8 @@ module Google
         
         # Updates a model. The longrunning operation will eventually return a Model.
         # @param [String] name
-        #   The resource name of the Model.
+        #   The resource name of the Model. Model names have the form `projects/`
-        #   Model names have the form `projects/`project_id`/models/`model_id``
+        #   project_id`/models/`model_id`` The name is ignored when creating a model.
-        #   The name is ignored when creating a model.
         # @param [Google::Apis::FirebasemlV1beta2::Model] model_object
         # @param [String] update_mask
         #   The update mask
@@ -223,9 +222,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets the latest state of a long-running operation.  Clients can use this
+        # Gets the latest state of a long-running operation. Clients can use this method
-        # method to poll the operation result at intervals as recommended by the API
+        # to poll the operation result at intervals as recommended by the API service.
-        # service.
         # @param [String] name
         #   The name of the operation resource.
         # @param [String] fields

generated/google/apis/gameservices_v1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/solutions/gaming/
     module GameservicesV1
       VERSION = 'V1'
-      REVISION = '20200721'
+      REVISION = '20200730'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

generated/google/apis/gameservices_v1beta.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/solutions/gaming/
     module GameservicesV1beta
       VERSION = 'V1beta'
-      REVISION = '20200721'
+      REVISION = '20200730'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

generated/google/apis/gmail_v1.rb

@@ -20,13 +20,13 @@ module Google
   module Apis
     # Gmail API
     #
-    # The Gmail API lets you view and manage Gmail mailbox data like
+    # The Gmail API lets you view and manage Gmail mailbox data like threads,
-    # threads, messages, and labels.
+    # messages, and labels.
     #
     # @see https://developers.google.com/gmail/api/
     module GmailV1
       VERSION = 'V1'
-      REVISION = '20200720'
+      REVISION = '20200803'
 
       # Read, compose, send, and permanently delete all your email from Gmail
       AUTH_SCOPE = 'https://mail.google.com/'

generated/google/apis/gmail_v1/classes.rb

@@ -31,8 +31,8 @@ module Google
         # @return [String]
         attr_accessor :disposition
       
-        # Email address to which all incoming messages are forwarded.  This email
+        # Email address to which all incoming messages are forwarded. This email address
-        # address must be a verified member of the forwarding addresses.
+        # must be a verified member of the forwarding addresses.
         # Corresponds to the JSON property `emailAddress`
         # @return [String]
         attr_accessor :email_address
@@ -83,8 +83,7 @@ module Google
         # @return [Array<String>]
         attr_accessor :add_label_ids
       
-        # The IDs of the messages to modify. There is a limit of 1000 ids per
+        # The IDs of the messages to modify. There is a limit of 1000 ids per request.
-        # request.
         # Corresponds to the JSON property `ids`
         # @return [Array<String>]
         attr_accessor :ids
@@ -107,9 +106,8 @@ module Google
       end
       
       # Settings for a delegate. Delegates can read, send, and delete messages, as
-      # well as view and add contacts, for the delegator's account. See
+      # well as view and add contacts, for the delegator's account. See "Set up mail
-      # <a href="https://support.google.com/mail/answer/138350">"Set up
+      # delegation" for more information about delegates.
-      # mail delegation"</a> for more information about delegates.
       class Delegate
         include Google::Apis::Core::Hashable
       
@@ -118,8 +116,8 @@ module Google
         # @return [String]
         attr_accessor :delegate_email
       
-        # Indicates whether this address has been verified and can act as a delegate
+        # Indicates whether this address has been verified and can act as a delegate for
-        # for the account.  Read-only.
+        # the account. Read-only.
         # Corresponds to the JSON property `verificationStatus`
         # @return [String]
         attr_accessor :verification_status
@@ -244,18 +242,16 @@ module Google
         attr_accessor :has_attachment
         alias_method :has_attachment?, :has_attachment
       
-        # Only return messages not matching the specified query. Supports the same
+        # Only return messages not matching the specified query. Supports the same query
-        # query format as the Gmail search box. For example,
+        # format as the Gmail search box. For example, `"from:someuser@example.com
-        # `"from:someuser@example.com rfc822msgid:<somemsgid@example.com>
+        # rfc822msgid: is:unread"`.
-        # is:unread"`.
         # Corresponds to the JSON property `negatedQuery`
         # @return [String]
         attr_accessor :negated_query
       
-        # Only return messages matching the specified query. Supports the same
+        # Only return messages matching the specified query. Supports the same query
-        # query format as the Gmail search box. For example,
+        # format as the Gmail search box. For example, `"from:someuser@example.com
-        # `"from:someuser@example.com rfc822msgid:<somemsgid@example.com>
+        # rfc822msgid: is:unread"`.
-        # is:unread"`.
         # Corresponds to the JSON property `query`
         # @return [String]
         attr_accessor :query
@@ -271,16 +267,16 @@ module Google
         # @return [String]
         attr_accessor :size_comparison
       
-        # Case-insensitive phrase found in the message's subject. Trailing and
+        # Case-insensitive phrase found in the message's subject. Trailing and leading
-        # leading whitespace are be trimmed and adjacent spaces are collapsed.
+        # whitespace are be trimmed and adjacent spaces are collapsed.
         # Corresponds to the JSON property `subject`
         # @return [String]
         attr_accessor :subject
       
-        # The recipient's display name or email address. Includes recipients in the
+        # The recipient's display name or email address. Includes recipients in the "to",
-        # "to", "cc", and "bcc" header fields. You can use simply the local part of
+        # "cc", and "bcc" header fields. You can use simply the local part of the email
-        # the email address. For example, "example" and "example@" both match
+        # address. For example, "example" and "example@" both match "example@gmail.com".
-        # "example@gmail.com". This field is case-insensitive.
+        # This field is case-insensitive.
         # Corresponds to the JSON property `to`
         # @return [String]
         attr_accessor :to
@@ -312,8 +308,8 @@ module Google
         # @return [String]
         attr_accessor :forwarding_email
       
-        # Indicates whether this address has been verified and is usable for
+        # Indicates whether this address has been verified and is usable for forwarding.
-        # forwarding.  Read-only.
+        # Read-only.
         # Corresponds to the JSON property `verificationStatus`
         # @return [String]
         attr_accessor :verification_status
@@ -349,10 +345,9 @@ module Google
         # @return [Array<Google::Apis::GmailV1::HistoryLabelRemoved>]
         attr_accessor :labels_removed
       
-        # List of messages changed in this history record.  The fields for specific
+        # List of messages changed in this history record. The fields for specific
-        # change types, such as `messagesAdded` may duplicate messages in
+        # change types, such as `messagesAdded` may duplicate messages in this field. We
-        # this field.  We recommend using the specific change-type fields instead
+        # recommend using the specific change-type fields instead of this.
-        # of this.
         # Corresponds to the JSON property `messages`
         # @return [Array<Google::Apis::GmailV1::Message>]
         attr_accessor :messages
@@ -475,8 +470,8 @@ module Google
         include Google::Apis::Core::Hashable
       
         # If this value is true, Gmail will immediately expunge a message when it is
-        # marked as deleted in IMAP.  Otherwise, Gmail will wait for an update from
+        # marked as deleted in IMAP. Otherwise, Gmail will wait for an update from the
-        # the client before expunging messages marked as deleted.
+        # client before expunging messages marked as deleted.
         # Corresponds to the JSON property `autoExpunge`
         # @return [Boolean]
         attr_accessor :auto_expunge
@@ -488,15 +483,15 @@ module Google
         attr_accessor :enabled
         alias_method :enabled?, :enabled
       
-        # The action that will be executed on a message when it is marked as deleted
+        # The action that will be executed on a message when it is marked as deleted and
-        # and expunged from the last visible IMAP folder.
+        # expunged from the last visible IMAP folder.
         # Corresponds to the JSON property `expungeBehavior`
         # @return [String]
         attr_accessor :expunge_behavior
       
-        # An optional limit on the number of messages that an IMAP folder may
+        # An optional limit on the number of messages that an IMAP folder may contain.
-        # contain.  Legal values are 0, 1000, 2000, 5000 or 10000.  A value of zero
+        # Legal values are 0, 1000, 2000, 5000 or 10000. A value of zero is interpreted
-        # is interpreted to mean that there is no limit.
+        # to mean that there is no limit.
         # Corresponds to the JSON property `maxFolderSize`
         # @return [Fixnum]
         attr_accessor :max_folder_size
@@ -514,14 +509,13 @@ module Google
         end
       end
       
-      # Labels are used to categorize messages and threads within the
+      # Labels are used to categorize messages and threads within the user's mailbox.
-      # user's mailbox.
       class Label
         include Google::Apis::Core::Hashable
       
-        # The color to assign to the label. Color is only available for labels that
+        # The color to assign to the label. Color is only available for labels that have
-        # have their `type` set to `user`.
+        # their `type` set to `user`. @mutable gmail.users.labels.create gmail.users.
-        # @mutable gmail.users.labels.create gmail.users.labels.update
+        # labels.update
         # Corresponds to the JSON property `color`
         # @return [Google::Apis::GmailV1::LabelColor]
         attr_accessor :color
@@ -531,15 +525,14 @@ module Google
         # @return [String]
         attr_accessor :id
       
-        # The visibility of the label in the label list in the Gmail web interface.
+        # The visibility of the label in the label list in the Gmail web interface. @
-        # @mutable gmail.users.labels.create gmail.users.labels.update
+        # mutable gmail.users.labels.create gmail.users.labels.update
         # Corresponds to the JSON property `labelListVisibility`
         # @return [String]
         attr_accessor :label_list_visibility
       
-        # The visibility of messages with this label in the message list
+        # The visibility of messages with this label in the message list in the Gmail
-        # in the Gmail web interface.
+        # web interface. @mutable gmail.users.labels.create gmail.users.labels.update
-        # @mutable gmail.users.labels.create gmail.users.labels.update
         # Corresponds to the JSON property `messageListVisibility`
         # @return [String]
         attr_accessor :message_list_visibility
@@ -554,8 +547,8 @@ module Google
         # @return [Fixnum]
         attr_accessor :messages_unread
       
-        # The display name of the label.
+        # The display name of the label. @mutable gmail.users.labels.create gmail.users.
-        # @mutable gmail.users.labels.create gmail.users.labels.update
+        # labels.update
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -570,15 +563,14 @@ module Google
         # @return [Fixnum]
         attr_accessor :threads_unread
       
-        # The owner type for the label. User labels are created by the user and
+        # The owner type for the label. User labels are created by the user and can be
-        # can be modified and deleted by the user and can be applied to any
+        # modified and deleted by the user and can be applied to any message or thread.
-        # message or thread. System labels are internally created and cannot be
+        # System labels are internally created and cannot be added, modified, or deleted.
-        # added, modified, or deleted. System labels may be able to be applied to or
+        # System labels may be able to be applied to or removed from messages and
-        # removed from messages and threads under some circumstances but this is
+        # threads under some circumstances but this is not guaranteed. For example,
-        # not guaranteed. For example, users can apply and remove the
+        # users can apply and remove the `INBOX` and `UNREAD` labels from messages and
-        # `INBOX` and `UNREAD` labels from messages and
+        # threads, but cannot apply or remove the `DRAFTS` or `SENT` labels from
-        # threads, but cannot apply or remove the `DRAFTS` or
+        # messages or threads.
-        # `SENT` labels from messages or threads.
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type
@@ -606,46 +598,42 @@ module Google
       class LabelColor
         include Google::Apis::Core::Hashable
       
-        # The background color represented as hex string #RRGGBB (ex #000000).
+        # The background color represented as hex string #RRGGBB (ex #000000). This
-        # This field is required in order to set the color of a label.
+        # field is required in order to set the color of a label. Only the following
-        # Only the following predefined set of color values are allowed:
+        # predefined set of color values are allowed: # 000000, #434343, #666666, #
-        # <br/>
+        # 999999, #cccccc, #efefef, #f3f3f3, #ffffff, # fb4c2f, #ffad47, #fad165, #
-        # # 000000, #434343, #666666, #999999, #cccccc, #efefef, #f3f3f3, #ffffff,
+        # 16a766, #43d692, #4a86e8, #a479e2, #f691b3, # f6c5be, #ffe6c7, #fef1d1, #
-        # # fb4c2f, #ffad47, #fad165, #16a766, #43d692, #4a86e8, #a479e2, #f691b3,
+        # b9e4d0, #c6f3de, #c9daf8, #e4d7f5, #fcdee8, # efa093, #ffd6a2, #fce8b3, #
-        # # f6c5be, #ffe6c7, #fef1d1, #b9e4d0, #c6f3de, #c9daf8, #e4d7f5, #fcdee8,
+        # 89d3b2, #a0eac9, #a4c2f4, #d0bcf1, #fbc8d9, # e66550, #ffbc6b, #fcda83, #
-        # # efa093, #ffd6a2, #fce8b3, #89d3b2, #a0eac9, #a4c2f4, #d0bcf1, #fbc8d9,
+        # 44b984, #68dfa9, #6d9eeb, #b694e8, #f7a7c0, # cc3a21, #eaa041, #f2c960, #
-        # # e66550, #ffbc6b, #fcda83, #44b984, #68dfa9, #6d9eeb, #b694e8, #f7a7c0,
+        # 149e60, #3dc789, #3c78d8, #8e63ce, #e07798, # ac2b16, #cf8933, #d5ae49, #
-        # # cc3a21, #eaa041, #f2c960, #149e60, #3dc789, #3c78d8, #8e63ce, #e07798,
+        # 0b804b, #2a9c68, #285bac, #653e9b, #b65775, # 822111, #a46a21, #aa8831, #
-        # # ac2b16, #cf8933, #d5ae49, #0b804b, #2a9c68, #285bac, #653e9b, #b65775,
+        # 076239, #1a764d, #1c4587, #41236d, #83334c # 464646, #e7e7e7, #0d3472, #b6cff5,
-        # # 822111, #a46a21, #aa8831, #076239, #1a764d, #1c4587, #41236d, #83334c
+        # #0d3b44, #98d7e4, #3d188e, #e3d7ff, # 711a36, #fbd3e0, #8a1c0a, #f2b2a8, #
-        # # 464646, #e7e7e7, #0d3472, #b6cff5, #0d3b44, #98d7e4, #3d188e, #e3d7ff,
+        # 7a2e0b, #ffc8af, #7a4706, #ffdeb5, # 594c05, #fbe983, #684e07, #fdedc1, #
-        # # 711a36, #fbd3e0, #8a1c0a, #f2b2a8, #7a2e0b, #ffc8af, #7a4706, #ffdeb5,
+        # 0b4f30, #b3efd3, #04502e, #a2dcc1, # c2c2c2, #4986e7, #2da2bb, #b99aff, #
-        # # 594c05, #fbe983, #684e07, #fdedc1, #0b4f30, #b3efd3, #04502e, #a2dcc1,
+        # 994a64, #f691b2, #ff7537, #ffad46, # 662e37, #ebdbde, #cca6ac, #094228, #
-        # # c2c2c2, #4986e7, #2da2bb, #b99aff, #994a64, #f691b2, #ff7537, #ffad46,
+        # 42d692, #16a765 @mutable gmail.users.labels.create gmail.users.labels.update
-        # # 662e37, #ebdbde, #cca6ac, #094228, #42d692, #16a765
-        # @mutable gmail.users.labels.create gmail.users.labels.update
         # Corresponds to the JSON property `backgroundColor`
         # @return [String]
         attr_accessor :background_color
       
-        # The text color of the label, represented as hex string.
+        # The text color of the label, represented as hex string. This field is required
-        # This field is required in order to set the color of a label.
+        # in order to set the color of a label. Only the following predefined set of
-        # Only the following predefined set of color values are allowed:
+        # color values are allowed: # 000000, #434343, #666666, #999999, #cccccc, #
-        # <br/>
+        # efefef, #f3f3f3, #ffffff, # fb4c2f, #ffad47, #fad165, #16a766, #43d692, #
-        # # 000000, #434343, #666666, #999999, #cccccc, #efefef, #f3f3f3, #ffffff,
+        # 4a86e8, #a479e2, #f691b3, # f6c5be, #ffe6c7, #fef1d1, #b9e4d0, #c6f3de, #
-        # # fb4c2f, #ffad47, #fad165, #16a766, #43d692, #4a86e8, #a479e2, #f691b3,
+        # c9daf8, #e4d7f5, #fcdee8, # efa093, #ffd6a2, #fce8b3, #89d3b2, #a0eac9, #
-        # # f6c5be, #ffe6c7, #fef1d1, #b9e4d0, #c6f3de, #c9daf8, #e4d7f5, #fcdee8,
+        # a4c2f4, #d0bcf1, #fbc8d9, # e66550, #ffbc6b, #fcda83, #44b984, #68dfa9, #
-        # # efa093, #ffd6a2, #fce8b3, #89d3b2, #a0eac9, #a4c2f4, #d0bcf1, #fbc8d9,
+        # 6d9eeb, #b694e8, #f7a7c0, # cc3a21, #eaa041, #f2c960, #149e60, #3dc789, #
-        # # e66550, #ffbc6b, #fcda83, #44b984, #68dfa9, #6d9eeb, #b694e8, #f7a7c0,
+        # 3c78d8, #8e63ce, #e07798, # ac2b16, #cf8933, #d5ae49, #0b804b, #2a9c68, #
-        # # cc3a21, #eaa041, #f2c960, #149e60, #3dc789, #3c78d8, #8e63ce, #e07798,
+        # 285bac, #653e9b, #b65775, # 822111, #a46a21, #aa8831, #076239, #1a764d, #
-        # # ac2b16, #cf8933, #d5ae49, #0b804b, #2a9c68, #285bac, #653e9b, #b65775,
+        # 1c4587, #41236d, #83334c # 464646, #e7e7e7, #0d3472, #b6cff5, #0d3b44, #98d7e4,
-        # # 822111, #a46a21, #aa8831, #076239, #1a764d, #1c4587, #41236d, #83334c
+        # #3d188e, #e3d7ff, # 711a36, #fbd3e0, #8a1c0a, #f2b2a8, #7a2e0b, #ffc8af, #
-        # # 464646, #e7e7e7, #0d3472, #b6cff5, #0d3b44, #98d7e4, #3d188e, #e3d7ff,
+        # 7a4706, #ffdeb5, # 594c05, #fbe983, #684e07, #fdedc1, #0b4f30, #b3efd3, #
-        # # 711a36, #fbd3e0, #8a1c0a, #f2b2a8, #7a2e0b, #ffc8af, #7a4706, #ffdeb5,
+        # 04502e, #a2dcc1, # c2c2c2, #4986e7, #2da2bb, #b99aff, #994a64, #f691b2, #
-        # # 594c05, #fbe983, #684e07, #fdedc1, #0b4f30, #b3efd3, #04502e, #a2dcc1,
+        # ff7537, #ffad46, # 662e37, #ebdbde, #cca6ac, #094228, #42d692, #16a765 @
-        # # c2c2c2, #4986e7, #2da2bb, #b99aff, #994a64, #f691b2, #ff7537, #ffad46,
+        # mutable gmail.users.labels.create gmail.users.labels.update
-        # # 662e37, #ebdbde, #cca6ac, #094228, #42d692, #16a765
-        # @mutable gmail.users.labels.create gmail.users.labels.update
         # Corresponds to the JSON property `textColor`
         # @return [String]
         attr_accessor :text_color
@@ -661,28 +649,21 @@ module Google
         end
       end
       
-      # Language settings for an account. These settings correspond to
+      # Language settings for an account. These settings correspond to the "Language
-      # the <a href="https://support.google.com/mail/answer/17091">"Language
+      # settings" feature in the web interface.
-      # settings"</a> feature in the web interface.
       class LanguageSettings
         include Google::Apis::Core::Hashable
       
-        # The language to display Gmail in, formatted as an
+        # The language to display Gmail in, formatted as an RFC 3066 Language Tag (for
-        # <a href="https://www.w3.org/International/articles/language-tags/">RFC 3066
+        # example `en-GB`, `fr` or `ja` for British English, French, or Japanese
-        # Language Tag</a> (for example `en-GB`, `fr` or
+        # respectively). The set of languages supported by Gmail evolves over time, so
-        # `ja` for British English, French, or Japanese respectively).
+        # please refer to the "Language" dropdown in the Gmail settings for all
-        # The set of languages supported by Gmail evolves over time, so please refer
+        # available options, as described in the language settings help article. A table
-        # to the "Language" dropdown in the
+        # of sample values is also provided in the Managing Language Settings guide Not
-        # <a href="https://mail.google.com/mail/u/0/#settings/general">Gmail settings
+        # all Gmail clients can display the same set of languages. In the case that a
-        # </a> for all available options, as described in the
+        # user's display language is not available for use on a particular client, said
-        # <a href="https://support.google.com/mail/answer/17091">language settings
+        # client automatically chooses to display in the closest supported variant (or a
-        # help article</a>. A table of sample values is also provided in the
+        # reasonable default).
-        # <a href="/gmail/api/guides/language_settings#display_language">Managing
-        # Language Settings guide</a>
-        # Not all Gmail clients can display the same set of languages. In the case
-        # that a user's display language is not available for use on a particular
-        # client, said client automatically chooses to display in the closest
-        # supported variant (or a reasonable default).
         # Corresponds to the JSON property `displayLanguage`
         # @return [String]
         attr_accessor :display_language
@@ -720,11 +701,9 @@ module Google
       class ListDraftsResponse
         include Google::Apis::Core::Hashable
       
-        # List of drafts. Note that the `Message` property in each
+        # List of drafts. Note that the `Message` property in each `Draft` resource only
-        # `Draft` resource only contains an `id` and a
+        # contains an `id` and a `threadId`. The messages.get method can fetch
-        # `threadId`. The
+        # additional message details.
-        # <a href="/gmail/api/v1/reference/users/messages/get">messages.get</a>
-        # method can fetch additional message details.
         # Corresponds to the JSON property `drafts`
         # @return [Array<Google::Apis::GmailV1::Draft>]
         attr_accessor :drafts
@@ -793,9 +772,8 @@ module Google
       class ListHistoryResponse
         include Google::Apis::Core::Hashable
       
-        # List of history records.  Any `messages` contained in the
+        # List of history records. Any `messages` contained in the response will
-        # response will typically only have `id` and
+        # typically only have `id` and `threadId` fields populated.
-        # `threadId` fields populated.
         # Corresponds to the JSON property `history`
         # @return [Array<Google::Apis::GmailV1::History>]
         attr_accessor :history
@@ -826,11 +804,9 @@ module Google
       class ListLabelsResponse
         include Google::Apis::Core::Hashable
       
-        # List of labels. Note that each label resource only contains an
+        # List of labels. Note that each label resource only contains an `id`, `name`, `
-        # `id`, `name`, `messageListVisibility`,
+        # messageListVisibility`, `labelListVisibility`, and `type`. The labels.get
-        # `labelListVisibility`, and `type`. The
+        # method can fetch additional label details.
-        # <a href="/gmail/api/v1/reference/users/labels/get">labels.get</a> method
-        # can fetch additional label details.
         # Corresponds to the JSON property `labels`
         # @return [Array<Google::Apis::GmailV1::Label>]
         attr_accessor :labels
@@ -849,10 +825,8 @@ module Google
       class ListMessagesResponse
         include Google::Apis::Core::Hashable
       
-        # List of messages. Note that each message resource contains only an
+        # List of messages. Note that each message resource contains only an `id` and a `
-        # `id` and a `threadId`. Additional message details can
+        # threadId`. Additional message details can be fetched using the messages.get
-        # be fetched using the
-        # <a href="/gmail/api/v1/reference/users/messages/get">messages.get</a>
         # method.
         # Corresponds to the JSON property `messages`
         # @return [Array<Google::Apis::GmailV1::Message>]
@@ -932,10 +906,9 @@ module Google
         # @return [Fixnum]
         attr_accessor :result_size_estimate
       
-        # List of threads. Note that each thread resource does not contain a list of
+        # List of threads. Note that each thread resource does not contain a list of `
-        # `messages`. The list of `messages` for a given thread
+        # messages`. The list of `messages` for a given thread can be fetched using the
-        # can be fetched using the
+        # threads.get method.
-        # <a href="/gmail/api/v1/reference/users/threads/get">threads.get</a> method.
         # Corresponds to the JSON property `threads`
         # @return [Array<Google::Apis::GmailV1::Thread>]
         attr_accessor :threads
@@ -966,17 +939,17 @@ module Google
         # @return [String]
         attr_accessor :id
       
-        # The internal message creation timestamp (epoch ms), which determines
+        # The internal message creation timestamp (epoch ms), which determines ordering
-        # ordering in the inbox.  For normal SMTP-received email, this represents the
+        # in the inbox. For normal SMTP-received email, this represents the time the
-        # time the message was originally accepted by Google, which is more reliable
+        # message was originally accepted by Google, which is more reliable than the `
-        # than the `Date` header. However, for API-migrated mail, it can
+        # Date` header. However, for API-migrated mail, it can be configured by client
-        # be configured by client to be based on the `Date` header.
+        # to be based on the `Date` header.
         # Corresponds to the JSON property `internalDate`
         # @return [Fixnum]
         attr_accessor :internal_date
       
-        # List of IDs of labels applied to this message.
+        # List of IDs of labels applied to this message. @mutable gmail.users.messages.
-        # @mutable gmail.users.messages.insert gmail.users.messages.modify
+        # insert gmail.users.messages.modify
         # Corresponds to the JSON property `labelIds`
         # @return [Array<String>]
         attr_accessor :label_ids
@@ -986,12 +959,10 @@ module Google
         # @return [Google::Apis::GmailV1::MessagePart]
         attr_accessor :payload
       
-        # The entire email message in an RFC 2822 formatted and base64url
+        # The entire email message in an RFC 2822 formatted and base64url encoded string.
-        # encoded string. Returned in `messages.get` and
+        # Returned in `messages.get` and `drafts.get` responses when the `format=RAW`
-        # `drafts.get` responses when the `format=RAW`
+        # parameter is supplied. @mutable gmail.users.messages.insert gmail.users.
-        # parameter is supplied.
+        # messages.send @mutable gmail.users.drafts.create gmail.users.drafts.update
-        # @mutable gmail.users.messages.insert gmail.users.messages.send
-        # @mutable gmail.users.drafts.create gmail.users.drafts.update
         # Corresponds to the JSON property `raw`
         # NOTE: Values are automatically base64 encoded/decoded in the client library.
         # @return [String]
@@ -1007,17 +978,13 @@ module Google
         # @return [String]
         attr_accessor :snippet
       
-        # The ID of the thread the message belongs to. To add a message or draft to
+        # The ID of the thread the message belongs to. To add a message or draft to a
-        # a thread, the following criteria must be met:
+        # thread, the following criteria must be met: 1. The requested `threadId` must
-        # <ol><li>The requested `threadId` must be specified on the
+        # be specified on the `Message` or `Draft.Message` you supply with your request.
-        # `Message` or `Draft.Message` you supply with your
+        # 2. The `References` and `In-Reply-To` headers must be set in compliance with
-        # request.</li>
+        # the RFC 2822 standard. 3. The `Subject` headers must match. @mutable gmail.
-        # <li>The `References` and `In-Reply-To` headers must
+        # users.messages.insert gmail.users.messages.send @mutable gmail.users.drafts.
-        # be set in compliance with the
+        # create gmail.users.drafts.update
-        # <a href="https://tools.ietf.org/html/rfc2822">RFC 2822</a> standard.</li>
-        # <li>The `Subject` headers must match.
-        # @mutable gmail.users.messages.insert gmail.users.messages.send
-        # @mutable gmail.users.drafts.create gmail.users.drafts.update
         # Corresponds to the JSON property `threadId`
         # @return [String]
         attr_accessor :thread_id
@@ -1049,16 +1016,15 @@ module Google
         # @return [Google::Apis::GmailV1::MessagePartBody]
         attr_accessor :body
       
-        # The filename of the attachment. Only present if this message part
+        # The filename of the attachment. Only present if this message part represents
-        # represents an attachment.
+        # an attachment.
         # Corresponds to the JSON property `filename`
         # @return [String]
         attr_accessor :filename
       
         # List of headers on this message part. For the top-level message part,
-        # representing the entire message payload, it will contain the standard
+        # representing the entire message payload, it will contain the standard RFC 2822
-        # RFC 2822 email headers such as `To`, `From`, and
+        # email headers such as `To`, `From`, and `Subject`.
-        # `Subject`.
         # Corresponds to the JSON property `headers`
         # @return [Array<Google::Apis::GmailV1::MessagePartHeader>]
         attr_accessor :headers
@@ -1073,11 +1039,10 @@ module Google
         # @return [String]
         attr_accessor :part_id
       
-        # The child MIME message parts of this part. This only applies to container
+        # The child MIME message parts of this part. This only applies to container MIME
-        # MIME message parts, for example `multipart/*`. For non-
+        # message parts, for example `multipart/*`. For non- container MIME message part
-        # container MIME message part types, such as `text/plain`, this
+        # types, such as `text/plain`, this field is empty. For more information, see
-        # field is empty. For more information, see
+        # RFC 1521.
-        # <a href="http://www.ietf.org/rfc/rfc1521.txt">RFC 1521</a>.
         # Corresponds to the JSON property `parts`
         # @return [Array<Google::Apis::GmailV1::MessagePart>]
         attr_accessor :parts
@@ -1101,19 +1066,17 @@ module Google
       class MessagePartBody
         include Google::Apis::Core::Hashable
       
-        # When present, contains the ID of an external attachment that can be
+        # When present, contains the ID of an external attachment that can be retrieved
-        # retrieved in a separate `messages.attachments.get` request.
+        # in a separate `messages.attachments.get` request. When not present, the entire
-        # When not present, the entire content of the message part body is
+        # content of the message part body is contained in the data field.
-        # contained in the data field.
         # Corresponds to the JSON property `attachmentId`
         # @return [String]
         attr_accessor :attachment_id
       
-        # The body data of a MIME message part as a base64url encoded string.
+        # The body data of a MIME message part as a base64url encoded string. May be
-        # May be empty for MIME container
+        # empty for MIME container types that have no message body or when the body data
-        # types that have no message body or when the body data is sent as a
+        # is sent as a separate attachment. An attachment ID is present if the body data
-        # separate attachment. An attachment ID is present if the body data is
+        # is contained in a separate attachment.
-        # contained in a separate attachment.
         # Corresponds to the JSON property `data`
         # NOTE: Values are automatically base64 encoded/decoded in the client library.
         # @return [String]
@@ -1140,14 +1103,13 @@ module Google
       class MessagePartHeader
         include Google::Apis::Core::Hashable
       
-        # The name of the header before the `:` separator. For
+        # The name of the header before the `:` separator. For example, `To`.
-        # example, `To`.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # The value of the header after the `:` separator. For example,
+        # The value of the header after the `:` separator. For example, `someuser@
-        # `someuser@example.com`.
+        # example.com`.
         # Corresponds to the JSON property `value`
         # @return [String]
         attr_accessor :value
@@ -1277,53 +1239,48 @@ module Google
       end
       
       # Settings associated with a send-as alias, which can be either the primary
-      # login address associated with the account or a custom "from" address.
+      # login address associated with the account or a custom "from" address. Send-as
-      # Send-as aliases correspond to the
+      # aliases correspond to the "Send Mail As" feature in the web interface.
-      # <a href="https://support.google.com/mail/answer/22370">"Send Mail As"</a>
-      # feature in the web interface.
       class SendAs
         include Google::Apis::Core::Hashable
       
-        # A name that appears in the "From:" header for mail sent using this alias.
+        # A name that appears in the "From:" header for mail sent using this alias. For
-        # For custom "from" addresses, when this is empty, Gmail will populate the
+        # custom "from" addresses, when this is empty, Gmail will populate the "From:"
-        # "From:" header with the name that is used for the primary address
+        # header with the name that is used for the primary address associated with the
-        # associated with the account.
+        # account. If the admin has disabled the ability for users to update their name
-        # If the admin has disabled the ability for users to update their name
+        # format, requests to update this field for the primary login will silently fail.
-        # format, requests to update this field for the primary login will silently
-        # fail.
         # Corresponds to the JSON property `displayName`
         # @return [String]
         attr_accessor :display_name
       
-        # Whether this address is selected as the default "From:" address in
+        # Whether this address is selected as the default "From:" address in situations
-        # situations such as composing a new message or sending a vacation
+        # such as composing a new message or sending a vacation auto-reply. Every Gmail
-        # auto-reply.  Every Gmail account has exactly one default send-as address,
+        # account has exactly one default send-as address, so the only legal value that
-        # so the only legal value that clients may write to this field is
+        # clients may write to this field is `true`. Changing this from `false` to `true`
-        # `true`.  Changing this from `false` to
+        # for an address will result in this field becoming `false` for the other
-        # `true` for an address will result in this field becoming
+        # previous default address.
-        # `false` for the other previous default address.
         # Corresponds to the JSON property `isDefault`
         # @return [Boolean]
         attr_accessor :is_default
         alias_method :is_default?, :is_default
       
         # Whether this address is the primary address used to login to the account.
-        # Every Gmail account has exactly one primary address, and it cannot be
+        # Every Gmail account has exactly one primary address, and it cannot be deleted
-        # deleted from the collection of send-as aliases.  This field is read-only.
+        # from the collection of send-as aliases. This field is read-only.
         # Corresponds to the JSON property `isPrimary`
         # @return [Boolean]
         attr_accessor :is_primary
         alias_method :is_primary?, :is_primary
       
         # An optional email address that is included in a "Reply-To:" header for mail
-        # sent using this alias.  If this is empty, Gmail will not generate a
+        # sent using this alias. If this is empty, Gmail will not generate a "Reply-To:"
-        # "Reply-To:" header.
+        # header.
         # Corresponds to the JSON property `replyToAddress`
         # @return [String]
         attr_accessor :reply_to_address
       
-        # The email address that appears in the "From:" header for mail sent using
+        # The email address that appears in the "From:" header for mail sent using this
-        # this alias.  This is read-only for all operations except create.
+        # alias. This is read-only for all operations except create.
         # Corresponds to the JSON property `sendAsEmail`
         # @return [String]
         attr_accessor :send_as_email
@@ -1339,16 +1296,15 @@ module Google
         # @return [Google::Apis::GmailV1::SmtpMsa]
         attr_accessor :smtp_msa
       
-        # Whether Gmail should <a href="https://support.google.com/a/answer/1710338">
+        # Whether Gmail should treat this address as an alias for the user's primary
-        # treat this address as an alias</a> for the user's primary email address.
+        # email address. This setting only applies to custom "from" aliases.
-        # This setting only applies to custom "from" aliases.
         # Corresponds to the JSON property `treatAsAlias`
         # @return [Boolean]
         attr_accessor :treat_as_alias
         alias_method :treat_as_alias?, :treat_as_alias
       
-        # Indicates whether this address has been verified for use as a send-as
+        # Indicates whether this address has been verified for use as a send-as alias.
-        # alias.  Read-only.  This setting only applies to custom "from" aliases.
+        # Read-only. This setting only applies to custom "from" aliases.
         # Corresponds to the JSON property `verificationStatus`
         # @return [String]
         attr_accessor :verification_status
@@ -1401,18 +1357,18 @@ module Google
         # @return [String]
         attr_accessor :issuer_cn
       
-        # PEM formatted X509 concatenated certificate string (standard base64
+        # PEM formatted X509 concatenated certificate string (standard base64 encoding).
-        # encoding).  Format used for returning key, which includes public key
+        # Format used for returning key, which includes public key as well as
-        # as well as certificate chain (not private key).
+        # certificate chain (not private key).
         # Corresponds to the JSON property `pem`
         # @return [String]
         attr_accessor :pem
       
-        # PKCS#12 format containing a single private/public key pair and
+        # PKCS#12 format containing a single private/public key pair and certificate
-        # certificate chain.  This format is only accepted from client
+        # chain. This format is only accepted from client for creating a new SmimeInfo
-        # for creating a new SmimeInfo and is never returned, because the
+        # and is never returned, because the private key is not intended to be exported.
-        # private key is not intended to be exported.  PKCS#12 may be encrypted,
+        # PKCS#12 may be encrypted, in which case encryptedKeyPassword should be set
-        # in which case encryptedKeyPassword should be set appropriately.
+        # appropriately.
         # Corresponds to the JSON property `pkcs12`
         # NOTE: Values are automatically base64 encoded/decoded in the client library.
         # @return [String]
@@ -1438,32 +1394,32 @@ module Google
       class SmtpMsa
         include Google::Apis::Core::Hashable
       
-        # The hostname of the SMTP service.  Required.
+        # The hostname of the SMTP service. Required.
         # Corresponds to the JSON property `host`
         # @return [String]
         attr_accessor :host
       
-        # The password that will be used for authentication with the SMTP service.
+        # The password that will be used for authentication with the SMTP service. This
-        # This is a write-only field that can be specified in requests to create or
+        # is a write-only field that can be specified in requests to create or update
-        # update SendAs settings; it is never populated in responses.
+        # SendAs settings; it is never populated in responses.
         # Corresponds to the JSON property `password`
         # @return [String]
         attr_accessor :password
       
-        # The port of the SMTP service.  Required.
+        # The port of the SMTP service. Required.
         # Corresponds to the JSON property `port`
         # @return [Fixnum]
         attr_accessor :port
       
-        # The protocol that will be used to secure communication with the SMTP
+        # The protocol that will be used to secure communication with the SMTP service.
-        # service.  Required.
+        # Required.
         # Corresponds to the JSON property `securityMode`
         # @return [String]
         attr_accessor :security_mode
       
-        # The username that will be used for authentication with the SMTP service.
+        # The username that will be used for authentication with the SMTP service. This
-        # This is a write-only field that can be specified in requests to create or
+        # is a write-only field that can be specified in requests to create or update
-        # update SendAs settings; it is never populated in responses.
+        # SendAs settings; it is never populated in responses.
         # Corresponds to the JSON property `username`
         # @return [String]
         attr_accessor :username
@@ -1519,9 +1475,8 @@ module Google
         end
       end
       
-      # Vacation auto-reply settings for an account.  These settings correspond to
+      # Vacation auto-reply settings for an account. These settings correspond to the "
-      # the <a href="https://support.google.com/mail/answer/25922">"Vacation
+      # Vacation responder" feature in the web interface.
-      # responder"</a> feature in the web interface.
       class VacationSettings
         include Google::Apis::Core::Hashable
       
@@ -1531,57 +1486,52 @@ module Google
         attr_accessor :enable_auto_reply
         alias_method :enable_auto_reply?, :enable_auto_reply
       
-        # An optional end time for sending auto-replies (epoch ms).
+        # An optional end time for sending auto-replies (epoch ms). When this is
-        # When this is specified, Gmail will automatically reply only to messages
+        # specified, Gmail will automatically reply only to messages that it receives
-        # that it receives before the end time.  If both `startTime` and
+        # before the end time. If both `startTime` and `endTime` are specified, `
-        # `endTime` are specified, `startTime` must precede
+        # startTime` must precede `endTime`.
-        # `endTime`.
         # Corresponds to the JSON property `endTime`
         # @return [Fixnum]
         attr_accessor :end_time
       
-        # Response body in HTML format.  Gmail will sanitize the HTML before
+        # Response body in HTML format. Gmail will sanitize the HTML before storing it.
-        # storing it. If both `response_body_plain_text` and
+        # If both `response_body_plain_text` and `response_body_html` are specified, `
-        # `response_body_html` are specified,
+        # response_body_html` will be used.
-        # `response_body_html` will be used.
         # Corresponds to the JSON property `responseBodyHtml`
         # @return [String]
         attr_accessor :response_body_html
       
-        # Response body in plain text format. If both
+        # Response body in plain text format. If both `response_body_plain_text` and `
-        # `response_body_plain_text` and `response_body_html`
+        # response_body_html` are specified, `response_body_html` will be used.
-        # are specified, `response_body_html` will be used.
         # Corresponds to the JSON property `responseBodyPlainText`
         # @return [String]
         attr_accessor :response_body_plain_text
       
-        # Optional text to prepend to the subject line in vacation responses.  In
+        # Optional text to prepend to the subject line in vacation responses. In order
-        # order to enable auto-replies, either the response subject or the response
+        # to enable auto-replies, either the response subject or the response body must
-        # body must be nonempty.
+        # be nonempty.
         # Corresponds to the JSON property `responseSubject`
         # @return [String]
         attr_accessor :response_subject
       
-        # Flag that determines whether responses are sent to recipients who are not
+        # Flag that determines whether responses are sent to recipients who are not in
-        # in the user's list of contacts.
+        # the user's list of contacts.
         # Corresponds to the JSON property `restrictToContacts`
         # @return [Boolean]
         attr_accessor :restrict_to_contacts
         alias_method :restrict_to_contacts?, :restrict_to_contacts
       
-        # Flag that determines whether responses are sent to recipients who are
+        # Flag that determines whether responses are sent to recipients who are outside
-        # outside of the user's domain. This feature is only available for G Suite
+        # of the user's domain. This feature is only available for G Suite users.
-        # users.
         # Corresponds to the JSON property `restrictToDomain`
         # @return [Boolean]
         attr_accessor :restrict_to_domain
         alias_method :restrict_to_domain?, :restrict_to_domain
       
-        # An optional start time for sending auto-replies (epoch ms).
+        # An optional start time for sending auto-replies (epoch ms). When this is
-        # When this is specified, Gmail will automatically reply only to messages
+        # specified, Gmail will automatically reply only to messages that it receives
-        # that it receives after the start time.  If both `startTime` and
+        # after the start time. If both `startTime` and `endTime` are specified, `
-        # `endTime` are specified, `startTime` must precede
+        # startTime` must precede `endTime`.
-        # `endTime`.
         # Corresponds to the JSON property `startTime`
         # @return [Fixnum]
         attr_accessor :start_time
@@ -1612,21 +1562,19 @@ module Google
         # @return [String]
         attr_accessor :label_filter_action
       
-        # List of label_ids to restrict notifications about.  By default,
+        # List of label_ids to restrict notifications about. By default, if unspecified,
-        # if unspecified, all changes are pushed out.  If specified then
+        # all changes are pushed out. If specified then dictates which labels are
-        # dictates which labels are required for a push notification to
+        # required for a push notification to be generated.
-        # be generated.
         # Corresponds to the JSON property `labelIds`
         # @return [Array<String>]
         attr_accessor :label_ids
       
-        # A fully qualified Google Cloud Pub/Sub API topic name to publish the
+        # A fully qualified Google Cloud Pub/Sub API topic name to publish the events to.
-        # events to. This topic name **must** already exist in Cloud Pub/Sub and
+        # This topic name **must** already exist in Cloud Pub/Sub and you **must** have
-        # you **must** have already granted gmail "publish" permission on it.
+        # already granted gmail "publish" permission on it. For example, "projects/my-
-        # For example, "projects/my-project-identifier/topics/my-topic-name"
+        # project-identifier/topics/my-topic-name" (using the Cloud Pub/Sub "v1" topic
-        # (using the Cloud Pub/Sub "v1" topic naming format).
+        # naming format). Note that the "my-project-identifier" portion must exactly
-        # Note that the "my-project-identifier" portion must exactly match your
+        # match your Google developer project id (the one executing this watch request).
-        # Google developer project id (the one executing this watch request).
         # Corresponds to the JSON property `topicName`
         # @return [String]
         attr_accessor :topic_name
@@ -1647,9 +1595,8 @@ module Google
       class WatchResponse
         include Google::Apis::Core::Hashable
       
-        # When Gmail will stop sending notifications for mailbox updates
+        # When Gmail will stop sending notifications for mailbox updates (epoch millis).
-        # (epoch millis). Call `watch` again before this time to renew
+        # Call `watch` again before this time to renew the watch.
-        # the watch.
         # Corresponds to the JSON property `expiration`
         # @return [Fixnum]
         attr_accessor :expiration

generated/google/apis/osconfig_v1.rb

@@ -26,7 +26,7 @@ module Google
     # @see https://cloud.google.com/
     module OsconfigV1
       VERSION = 'V1'
-      REVISION = '20200714'
+      REVISION = '20200731'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

generated/google/apis/osconfig_v1/classes.rb

@@ -90,6 +90,74 @@ module Google
         end
       end
       
+      # A resource that contains custom validation and enforcement steps.
+      class ExecResource
+        include Google::Apis::Core::Hashable
+      
+        # A file or script to execute.
+        # Corresponds to the JSON property `enforce`
+        # @return [Google::Apis::OsconfigV1::ExecResourceExec]
+        attr_accessor :enforce
+      
+        # A file or script to execute.
+        # Corresponds to the JSON property `validate`
+        # @return [Google::Apis::OsconfigV1::ExecResourceExec]
+        attr_accessor :validate
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @enforce = args[:enforce] if args.key?(:enforce)
+          @validate = args[:validate] if args.key?(:validate)
+        end
+      end
+      
+      # A file or script to execute.
+      class ExecResourceExec
+        include Google::Apis::Core::Hashable
+      
+        # Exit codes that indicate success.
+        # Corresponds to the JSON property `allowedSuccessCodes`
+        # @return [Array<Fixnum>]
+        attr_accessor :allowed_success_codes
+      
+        # Arguments to use.
+        # Corresponds to the JSON property `args`
+        # @return [Array<String>]
+        attr_accessor :args
+      
+        # A remote or local file.
+        # Corresponds to the JSON property `file`
+        # @return [Google::Apis::OsconfigV1::File]
+        attr_accessor :file
+      
+        # The script interpreter to use.
+        # Corresponds to the JSON property `interpreter`
+        # @return [String]
+        attr_accessor :interpreter
+      
+        # An inline script.
+        # Corresponds to the JSON property `script`
+        # @return [String]
+        attr_accessor :script
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @allowed_success_codes = args[:allowed_success_codes] if args.key?(:allowed_success_codes)
+          @args = args[:args] if args.key?(:args)
+          @file = args[:file] if args.key?(:file)
+          @interpreter = args[:interpreter] if args.key?(:interpreter)
+          @script = args[:script] if args.key?(:script)
+        end
+      end
+      
       # A step that runs an executable for a PatchJob.
       class ExecStep
         include Google::Apis::Core::Hashable
@@ -221,6 +289,206 @@ module Google
         end
       end
       
+      # A resource that extracts an archive
+      class ExtractArchiveResource
+        include Google::Apis::Core::Hashable
+      
+        # Local file path that signals this resource is in the desired state.
+        # The absence of this file will indicate whether the archive needs to be
+        # extracted.
+        # Corresponds to the JSON property `creates`
+        # @return [String]
+        attr_accessor :creates
+      
+        # Directory to extract archive to.
+        # Corresponds to the JSON property `destination`
+        # @return [String]
+        attr_accessor :destination
+      
+        # Whether to overwrite existing files during extraction. If this is set to
+        # true, any existing files in the destination location will be overwritten by
+        # the extraction.
+        # Corresponds to the JSON property `overwrite`
+        # @return [Boolean]
+        attr_accessor :overwrite
+        alias_method :overwrite?, :overwrite
+      
+        # A remote or local file.
+        # Corresponds to the JSON property `source`
+        # @return [Google::Apis::OsconfigV1::File]
+        attr_accessor :source
+      
+        # The type of the archive to extract.
+        # Corresponds to the JSON property `type`
+        # @return [String]
+        attr_accessor :type
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @creates = args[:creates] if args.key?(:creates)
+          @destination = args[:destination] if args.key?(:destination)
+          @overwrite = args[:overwrite] if args.key?(:overwrite)
+          @source = args[:source] if args.key?(:source)
+          @type = args[:type] if args.key?(:type)
+        end
+      end
+      
+      # A remote or local file.
+      class File
+        include Google::Apis::Core::Hashable
+      
+        # Defaults to false. When false, files will be subject to validations
+        # based on the file type:
+        # Remote: A checksum must be specified.
+        # GCS:    An object generation number must be specified.
+        # Corresponds to the JSON property `allowInsecure`
+        # @return [Boolean]
+        attr_accessor :allow_insecure
+        alias_method :allow_insecure?, :allow_insecure
+      
+        # Specifies a file available as a GCS Object.
+        # Corresponds to the JSON property `gcs`
+        # @return [Google::Apis::OsconfigV1::FileGcs]
+        attr_accessor :gcs
+      
+        # A local path to use.
+        # Corresponds to the JSON property `localPath`
+        # @return [String]
+        attr_accessor :local_path
+      
+        # Specifies a file available via some URI.
+        # Corresponds to the JSON property `remote`
+        # @return [Google::Apis::OsconfigV1::FileRemote]
+        attr_accessor :remote
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @allow_insecure = args[:allow_insecure] if args.key?(:allow_insecure)
+          @gcs = args[:gcs] if args.key?(:gcs)
+          @local_path = args[:local_path] if args.key?(:local_path)
+          @remote = args[:remote] if args.key?(:remote)
+        end
+      end
+      
+      # Specifies a file available as a GCS Object.
+      class FileGcs
+        include Google::Apis::Core::Hashable
+      
+        # Bucket of the GCS object.
+        # Corresponds to the JSON property `bucket`
+        # @return [String]
+        attr_accessor :bucket
+      
+        # Generation number of the GCS object.
+        # Corresponds to the JSON property `generation`
+        # @return [Fixnum]
+        attr_accessor :generation
+      
+        # Name of the GCS object.
+        # Corresponds to the JSON property `object`
+        # @return [String]
+        attr_accessor :object
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @bucket = args[:bucket] if args.key?(:bucket)
+          @generation = args[:generation] if args.key?(:generation)
+          @object = args[:object] if args.key?(:object)
+        end
+      end
+      
+      # Specifies a file available via some URI.
+      class FileRemote
+        include Google::Apis::Core::Hashable
+      
+        # SHA256 checksum of the remote file.
+        # Corresponds to the JSON property `sha256Checksum`
+        # @return [String]
+        attr_accessor :sha256_checksum
+      
+        # URI from which to fetch the object. It should contain both the protocol
+        # and path following the format `protocol`://`location`.
+        # Corresponds to the JSON property `uri`
+        # @return [String]
+        attr_accessor :uri
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @sha256_checksum = args[:sha256_checksum] if args.key?(:sha256_checksum)
+          @uri = args[:uri] if args.key?(:uri)
+        end
+      end
+      
+      # A resource that manages the state of a file.
+      class FileResource
+        include Google::Apis::Core::Hashable
+      
+        # A a file with this content.
+        # Corresponds to the JSON property `content`
+        # @return [String]
+        attr_accessor :content
+      
+        # A remote or local file.
+        # Corresponds to the JSON property `file`
+        # @return [Google::Apis::OsconfigV1::File]
+        attr_accessor :file
+      
+        # The absolute path of the file.
+        # Corresponds to the JSON property `path`
+        # @return [String]
+        attr_accessor :path
+      
+        # Consists of three octal digits which represent, in
+        # order, the permissions of the owner, group, and other users for the
+        # file (similarly to the numeric mode used in the linux chmod utility).
+        # Each digit represents a three bit number with the 4 bit
+        # corresponding to the read permissions, the 2 bit corresponds to the
+        # write bit, and the one bit corresponds to the execute permission.
+        # Default behavior is 755.
+        # Below are some examples of permissions and their associated values:
+        # read, write, and execute: 7
+        # read and execute: 5
+        # read and write: 6
+        # read only: 4
+        # Corresponds to the JSON property `permissions`
+        # @return [String]
+        attr_accessor :permissions
+      
+        # Desired state of the file.
+        # Corresponds to the JSON property `state`
+        # @return [String]
+        attr_accessor :state
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @content = args[:content] if args.key?(:content)
+          @file = args[:file] if args.key?(:file)
+          @path = args[:path] if args.key?(:path)
+          @permissions = args[:permissions] if args.key?(:permissions)
+          @state = args[:state] if args.key?(:state)
+        end
+      end
+      
       # Message encapsulating a value that can be either absolute ("fixed") or
       # relative ("percent") to a value.
       class FixedOrPercent
@@ -418,6 +686,252 @@ module Google
         end
       end
       
+      # A resource that manages a system package.
+      class PackageResource
+        include Google::Apis::Core::Hashable
+      
+        # A package managed by APT.
+        # install: `apt-get update && apt-get -y install [name]`
+        # remove: `apt-get -y remove [name]`
+        # Corresponds to the JSON property `apt`
+        # @return [Google::Apis::OsconfigV1::PackageResourceApt]
+        attr_accessor :apt
+      
+        # A deb package file. dpkg packages only support INSTALLED state.
+        # Corresponds to the JSON property `deb`
+        # @return [Google::Apis::OsconfigV1::PackageResourceDeb]
+        attr_accessor :deb
+      
+        # The desired_state the agent should maintain for this package. The
+        # default is to ensure the package is installed.
+        # Corresponds to the JSON property `desiredState`
+        # @return [String]
+        attr_accessor :desired_state
+      
+        # A package managed by GooGet.
+        # install: `googet -noconfirm install package`
+        # remove: `googet -noconfirm remove package`
+        # Corresponds to the JSON property `googet`
+        # @return [Google::Apis::OsconfigV1::PackageResourceGooGet]
+        attr_accessor :googet
+      
+        # An MSI package. MSI packages only support INSTALLED state.
+        # Install msiexec /i /qn /norestart
+        # Corresponds to the JSON property `msi`
+        # @return [Google::Apis::OsconfigV1::PackageResourceMsi]
+        attr_accessor :msi
+      
+        # An RPM package file. RPM packages only support INSTALLED state.
+        # Corresponds to the JSON property `rpm`
+        # @return [Google::Apis::OsconfigV1::PackageResourceRpm]
+        attr_accessor :rpm
+      
+        # A package managed by YUM.
+        # install: `yum -y install package`
+        # remove: `yum -y remove package`
+        # Corresponds to the JSON property `yum`
+        # @return [Google::Apis::OsconfigV1::PackageResourceYum]
+        attr_accessor :yum
+      
+        # A package managed by Zypper.
+        # install: `zypper -y install package`
+        # remove: `zypper -y rm package`
+        # Corresponds to the JSON property `zypper`
+        # @return [Google::Apis::OsconfigV1::PackageResourceZypper]
+        attr_accessor :zypper
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @apt = args[:apt] if args.key?(:apt)
+          @deb = args[:deb] if args.key?(:deb)
+          @desired_state = args[:desired_state] if args.key?(:desired_state)
+          @googet = args[:googet] if args.key?(:googet)
+          @msi = args[:msi] if args.key?(:msi)
+          @rpm = args[:rpm] if args.key?(:rpm)
+          @yum = args[:yum] if args.key?(:yum)
+          @zypper = args[:zypper] if args.key?(:zypper)
+        end
+      end
+      
+      # A package managed by APT.
+      # install: `apt-get update && apt-get -y install [name]`
+      # remove: `apt-get -y remove [name]`
+      class PackageResourceApt
+        include Google::Apis::Core::Hashable
+      
+        # Package name.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @name = args[:name] if args.key?(:name)
+        end
+      end
+      
+      # A deb package file. dpkg packages only support INSTALLED state.
+      class PackageResourceDeb
+        include Google::Apis::Core::Hashable
+      
+        # Whether dependencies should also be installed.
+        # install when false: `dpkg -i package`
+        # install when true: `apt-get update && apt-get -y install package.deb`
+        # Corresponds to the JSON property `pullDeps`
+        # @return [Boolean]
+        attr_accessor :pull_deps
+        alias_method :pull_deps?, :pull_deps
+      
+        # A remote or local file.
+        # Corresponds to the JSON property `source`
+        # @return [Google::Apis::OsconfigV1::File]
+        attr_accessor :source
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @pull_deps = args[:pull_deps] if args.key?(:pull_deps)
+          @source = args[:source] if args.key?(:source)
+        end
+      end
+      
+      # A package managed by GooGet.
+      # install: `googet -noconfirm install package`
+      # remove: `googet -noconfirm remove package`
+      class PackageResourceGooGet
+        include Google::Apis::Core::Hashable
+      
+        # Package name.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @name = args[:name] if args.key?(:name)
+        end
+      end
+      
+      # An MSI package. MSI packages only support INSTALLED state.
+      # Install msiexec /i /qn /norestart
+      class PackageResourceMsi
+        include Google::Apis::Core::Hashable
+      
+        # Return codes that indicate that the software installed or updated
+        # successfully. Behaviour defaults to [0]
+        # Corresponds to the JSON property `allowedSuccessCodes`
+        # @return [Array<Fixnum>]
+        attr_accessor :allowed_success_codes
+      
+        # Flags to use during package install.
+        # Appended to the defalts of "/i /qn /norestart"
+        # Corresponds to the JSON property `flags`
+        # @return [Array<String>]
+        attr_accessor :flags
+      
+        # A remote or local file.
+        # Corresponds to the JSON property `source`
+        # @return [Google::Apis::OsconfigV1::File]
+        attr_accessor :source
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @allowed_success_codes = args[:allowed_success_codes] if args.key?(:allowed_success_codes)
+          @flags = args[:flags] if args.key?(:flags)
+          @source = args[:source] if args.key?(:source)
+        end
+      end
+      
+      # An RPM package file. RPM packages only support INSTALLED state.
+      class PackageResourceRpm
+        include Google::Apis::Core::Hashable
+      
+        # Whether dependencies should also be installed.
+        # install when false: `rpm --upgrade --replacepkgs package.rpm`
+        # install when true: `yum -y install package.rpm` or
+        # `zypper -y install package.rpm`
+        # Corresponds to the JSON property `pullDeps`
+        # @return [Boolean]
+        attr_accessor :pull_deps
+        alias_method :pull_deps?, :pull_deps
+      
+        # A remote or local file.
+        # Corresponds to the JSON property `source`
+        # @return [Google::Apis::OsconfigV1::File]
+        attr_accessor :source
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @pull_deps = args[:pull_deps] if args.key?(:pull_deps)
+          @source = args[:source] if args.key?(:source)
+        end
+      end
+      
+      # A package managed by YUM.
+      # install: `yum -y install package`
+      # remove: `yum -y remove package`
+      class PackageResourceYum
+        include Google::Apis::Core::Hashable
+      
+        # Package name.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @name = args[:name] if args.key?(:name)
+        end
+      end
+      
+      # A package managed by Zypper.
+      # install: `zypper -y install package`
+      # remove: `zypper -y rm package`
+      class PackageResourceZypper
+        include Google::Apis::Core::Hashable
+      
+        # Package name.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @name = args[:name] if args.key?(:name)
+        end
+      end
+      
       # Patch configuration specifications. Contains details on how to apply the
       # patch(es) to a VM instance.
       class PatchConfig
@@ -1047,6 +1561,213 @@ module Google
         end
       end
       
+      # A resource that manages a package repository.
+      class RepositoryResource
+        include Google::Apis::Core::Hashable
+      
+        # Represents a single apt package repository. These will be added to a repo
+        # file that will be managed at /etc/apt/sources.list.d/google_osconfig.list.
+        # Corresponds to the JSON property `apt`
+        # @return [Google::Apis::OsconfigV1::RepositoryResourceAptRepository]
+        attr_accessor :apt
+      
+        # Represents a Goo package repository. These will be added to a repo file
+        # that will be managed at C:/ProgramData/GooGet/repos/google_osconfig.repo.
+        # Corresponds to the JSON property `goo`
+        # @return [Google::Apis::OsconfigV1::RepositoryResourceGooRepository]
+        attr_accessor :goo
+      
+        # Represents a single yum package repository. These will be added to a repo
+        # file that will be managed at /etc/yum.repos.d/google_osconfig.repo.
+        # Corresponds to the JSON property `yum`
+        # @return [Google::Apis::OsconfigV1::RepositoryResourceYumRepository]
+        attr_accessor :yum
+      
+        # Represents a single zypper package repository. These will be added to a
+        # repo file that will be managed at /etc/zypp/repos.d/google_osconfig.repo.
+        # Corresponds to the JSON property `zypper`
+        # @return [Google::Apis::OsconfigV1::RepositoryResourceZypperRepository]
+        attr_accessor :zypper
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @apt = args[:apt] if args.key?(:apt)
+          @goo = args[:goo] if args.key?(:goo)
+          @yum = args[:yum] if args.key?(:yum)
+          @zypper = args[:zypper] if args.key?(:zypper)
+        end
+      end
+      
+      # Represents a single apt package repository. These will be added to a repo
+      # file that will be managed at /etc/apt/sources.list.d/google_osconfig.list.
+      class RepositoryResourceAptRepository
+        include Google::Apis::Core::Hashable
+      
+        # Type of archive files in this repository. The default behavior is DEB.
+        # Corresponds to the JSON property `archiveType`
+        # @return [String]
+        attr_accessor :archive_type
+      
+        # List of components for this repository. Must contain at least one item.
+        # Corresponds to the JSON property `components`
+        # @return [Array<String>]
+        attr_accessor :components
+      
+        # Distribution of this repository.
+        # Corresponds to the JSON property `distribution`
+        # @return [String]
+        attr_accessor :distribution
+      
+        # URI of the key file for this repository. The agent will maintain
+        # a keyring at /etc/apt/trusted.gpg.d/osconfig_agent_managed.gpg.
+        # Corresponds to the JSON property `gpgKey`
+        # @return [String]
+        attr_accessor :gpg_key
+      
+        # URI for this repository.
+        # Corresponds to the JSON property `uri`
+        # @return [String]
+        attr_accessor :uri
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @archive_type = args[:archive_type] if args.key?(:archive_type)
+          @components = args[:components] if args.key?(:components)
+          @distribution = args[:distribution] if args.key?(:distribution)
+          @gpg_key = args[:gpg_key] if args.key?(:gpg_key)
+          @uri = args[:uri] if args.key?(:uri)
+        end
+      end
+      
+      # Represents a Goo package repository. These will be added to a repo file
+      # that will be managed at C:/ProgramData/GooGet/repos/google_osconfig.repo.
+      class RepositoryResourceGooRepository
+        include Google::Apis::Core::Hashable
+      
+        # The name of the repository.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # The url of the repository.
+        # Corresponds to the JSON property `url`
+        # @return [String]
+        attr_accessor :url
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @name = args[:name] if args.key?(:name)
+          @url = args[:url] if args.key?(:url)
+        end
+      end
+      
+      # Represents a single yum package repository. These will be added to a repo
+      # file that will be managed at /etc/yum.repos.d/google_osconfig.repo.
+      class RepositoryResourceYumRepository
+        include Google::Apis::Core::Hashable
+      
+        # The location of the repository directory.
+        # Corresponds to the JSON property `baseUrl`
+        # @return [String]
+        attr_accessor :base_url
+      
+        # The display name of the repository.
+        # Corresponds to the JSON property `displayName`
+        # @return [String]
+        attr_accessor :display_name
+      
+        # URIs of GPG keys.
+        # Corresponds to the JSON property `gpgKeys`
+        # @return [Array<String>]
+        attr_accessor :gpg_keys
+      
+        # A one word, unique name for this repository. This will be
+        # the `repo id` in the yum config file and also the `display_name` if
+        # `display_name` is omitted. This id is also used as the unique identifier
+        # when checking for resource conflicts.
+        # Corresponds to the JSON property `id`
+        # @return [String]
+        attr_accessor :id
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @base_url = args[:base_url] if args.key?(:base_url)
+          @display_name = args[:display_name] if args.key?(:display_name)
+          @gpg_keys = args[:gpg_keys] if args.key?(:gpg_keys)
+          @id = args[:id] if args.key?(:id)
+        end
+      end
+      
+      # Represents a single zypper package repository. These will be added to a
+      # repo file that will be managed at /etc/zypp/repos.d/google_osconfig.repo.
+      class RepositoryResourceZypperRepository
+        include Google::Apis::Core::Hashable
+      
+        # The location of the repository directory.
+        # Corresponds to the JSON property `baseUrl`
+        # @return [String]
+        attr_accessor :base_url
+      
+        # The display name of the repository.
+        # Corresponds to the JSON property `displayName`
+        # @return [String]
+        attr_accessor :display_name
+      
+        # URIs of GPG keys.
+        # Corresponds to the JSON property `gpgKeys`
+        # @return [Array<String>]
+        attr_accessor :gpg_keys
+      
+        # A one word, unique name for this repository. This will be
+        # the `repo id` in the zypper config file and also the `display_name` if
+        # `display_name` is omitted. This id is also used as the unique identifier
+        # when checking for GuestPolicy conflicts.
+        # Corresponds to the JSON property `id`
+        # @return [String]
+        attr_accessor :id
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @base_url = args[:base_url] if args.key?(:base_url)
+          @display_name = args[:display_name] if args.key?(:display_name)
+          @gpg_keys = args[:gpg_keys] if args.key?(:gpg_keys)
+          @id = args[:id] if args.key?(:id)
+        end
+      end
+      
+      # A resource that manages a system service.
+      class ServiceResource
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
       # Represents a time of day. The date and time zone are either not significant
       # or are specified elsewhere. An API may choose to allow leap seconds. Related
       # types are google.type.Date and `google.protobuf.Timestamp`.

generated/google/apis/osconfig_v1/representations.rb

@@ -40,6 +40,18 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class ExecResource
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class ExecResourceExec
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class ExecStep
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -58,6 +70,36 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class ExtractArchiveResource
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class File
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class FileGcs
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class FileRemote
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class FileResource
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class FixedOrPercent
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -106,6 +148,54 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class PackageResource
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class PackageResourceApt
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class PackageResourceDeb
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class PackageResourceGooGet
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class PackageResourceMsi
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class PackageResourceRpm
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class PackageResourceYum
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class PackageResourceZypper
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class PatchConfig
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -160,6 +250,42 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class RepositoryResource
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class RepositoryResourceAptRepository
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class RepositoryResourceGooRepository
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class RepositoryResourceYumRepository
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class RepositoryResourceZypperRepository
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class ServiceResource
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class TimeOfDay
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -223,6 +349,28 @@ module Google
         end
       end
       
+      class ExecResource
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :enforce, as: 'enforce', class: Google::Apis::OsconfigV1::ExecResourceExec, decorator: Google::Apis::OsconfigV1::ExecResourceExec::Representation
+      
+          property :validate, as: 'validate', class: Google::Apis::OsconfigV1::ExecResourceExec, decorator: Google::Apis::OsconfigV1::ExecResourceExec::Representation
+      
+        end
+      end
+      
+      class ExecResourceExec
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :allowed_success_codes, as: 'allowedSuccessCodes'
+          collection :args, as: 'args'
+          property :file, as: 'file', class: Google::Apis::OsconfigV1::File, decorator: Google::Apis::OsconfigV1::File::Representation
+      
+          property :interpreter, as: 'interpreter'
+          property :script, as: 'script'
+        end
+      end
+      
       class ExecStep
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -260,6 +408,59 @@ module Google
         end
       end
       
+      class ExtractArchiveResource
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :creates, as: 'creates'
+          property :destination, as: 'destination'
+          property :overwrite, as: 'overwrite'
+          property :source, as: 'source', class: Google::Apis::OsconfigV1::File, decorator: Google::Apis::OsconfigV1::File::Representation
+      
+          property :type, as: 'type'
+        end
+      end
+      
+      class File
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :allow_insecure, as: 'allowInsecure'
+          property :gcs, as: 'gcs', class: Google::Apis::OsconfigV1::FileGcs, decorator: Google::Apis::OsconfigV1::FileGcs::Representation
+      
+          property :local_path, as: 'localPath'
+          property :remote, as: 'remote', class: Google::Apis::OsconfigV1::FileRemote, decorator: Google::Apis::OsconfigV1::FileRemote::Representation
+      
+        end
+      end
+      
+      class FileGcs
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :bucket, as: 'bucket'
+          property :generation, :numeric_string => true, as: 'generation'
+          property :object, as: 'object'
+        end
+      end
+      
+      class FileRemote
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :sha256_checksum, as: 'sha256Checksum'
+          property :uri, as: 'uri'
+        end
+      end
+      
+      class FileResource
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :content, as: 'content'
+          property :file, as: 'file', class: Google::Apis::OsconfigV1::File, decorator: Google::Apis::OsconfigV1::File::Representation
+      
+          property :path, as: 'path'
+          property :permissions, as: 'permissions'
+          property :state, as: 'state'
+        end
+      end
+      
       class FixedOrPercent
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -326,6 +527,83 @@ module Google
         end
       end
       
+      class PackageResource
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :apt, as: 'apt', class: Google::Apis::OsconfigV1::PackageResourceApt, decorator: Google::Apis::OsconfigV1::PackageResourceApt::Representation
+      
+          property :deb, as: 'deb', class: Google::Apis::OsconfigV1::PackageResourceDeb, decorator: Google::Apis::OsconfigV1::PackageResourceDeb::Representation
+      
+          property :desired_state, as: 'desiredState'
+          property :googet, as: 'googet', class: Google::Apis::OsconfigV1::PackageResourceGooGet, decorator: Google::Apis::OsconfigV1::PackageResourceGooGet::Representation
+      
+          property :msi, as: 'msi', class: Google::Apis::OsconfigV1::PackageResourceMsi, decorator: Google::Apis::OsconfigV1::PackageResourceMsi::Representation
+      
+          property :rpm, as: 'rpm', class: Google::Apis::OsconfigV1::PackageResourceRpm, decorator: Google::Apis::OsconfigV1::PackageResourceRpm::Representation
+      
+          property :yum, as: 'yum', class: Google::Apis::OsconfigV1::PackageResourceYum, decorator: Google::Apis::OsconfigV1::PackageResourceYum::Representation
+      
+          property :zypper, as: 'zypper', class: Google::Apis::OsconfigV1::PackageResourceZypper, decorator: Google::Apis::OsconfigV1::PackageResourceZypper::Representation
+      
+        end
+      end
+      
+      class PackageResourceApt
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :name, as: 'name'
+        end
+      end
+      
+      class PackageResourceDeb
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :pull_deps, as: 'pullDeps'
+          property :source, as: 'source', class: Google::Apis::OsconfigV1::File, decorator: Google::Apis::OsconfigV1::File::Representation
+      
+        end
+      end
+      
+      class PackageResourceGooGet
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :name, as: 'name'
+        end
+      end
+      
+      class PackageResourceMsi
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :allowed_success_codes, as: 'allowedSuccessCodes'
+          collection :flags, as: 'flags'
+          property :source, as: 'source', class: Google::Apis::OsconfigV1::File, decorator: Google::Apis::OsconfigV1::File::Representation
+      
+        end
+      end
+      
+      class PackageResourceRpm
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :pull_deps, as: 'pullDeps'
+          property :source, as: 'source', class: Google::Apis::OsconfigV1::File, decorator: Google::Apis::OsconfigV1::File::Representation
+      
+        end
+      end
+      
+      class PackageResourceYum
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :name, as: 'name'
+        end
+      end
+      
+      class PackageResourceZypper
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :name, as: 'name'
+        end
+      end
+      
       class PatchConfig
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -473,6 +751,65 @@ module Google
         end
       end
       
+      class RepositoryResource
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :apt, as: 'apt', class: Google::Apis::OsconfigV1::RepositoryResourceAptRepository, decorator: Google::Apis::OsconfigV1::RepositoryResourceAptRepository::Representation
+      
+          property :goo, as: 'goo', class: Google::Apis::OsconfigV1::RepositoryResourceGooRepository, decorator: Google::Apis::OsconfigV1::RepositoryResourceGooRepository::Representation
+      
+          property :yum, as: 'yum', class: Google::Apis::OsconfigV1::RepositoryResourceYumRepository, decorator: Google::Apis::OsconfigV1::RepositoryResourceYumRepository::Representation
+      
+          property :zypper, as: 'zypper', class: Google::Apis::OsconfigV1::RepositoryResourceZypperRepository, decorator: Google::Apis::OsconfigV1::RepositoryResourceZypperRepository::Representation
+      
+        end
+      end
+      
+      class RepositoryResourceAptRepository
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :archive_type, as: 'archiveType'
+          collection :components, as: 'components'
+          property :distribution, as: 'distribution'
+          property :gpg_key, as: 'gpgKey'
+          property :uri, as: 'uri'
+        end
+      end
+      
+      class RepositoryResourceGooRepository
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :name, as: 'name'
+          property :url, as: 'url'
+        end
+      end
+      
+      class RepositoryResourceYumRepository
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :base_url, as: 'baseUrl'
+          property :display_name, as: 'displayName'
+          collection :gpg_keys, as: 'gpgKeys'
+          property :id, as: 'id'
+        end
+      end
+      
+      class RepositoryResourceZypperRepository
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :base_url, as: 'baseUrl'
+          property :display_name, as: 'displayName'
+          collection :gpg_keys, as: 'gpgKeys'
+          property :id, as: 'id'
+        end
+      end
+      
+      class ServiceResource
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+        end
+      end
+      
       class TimeOfDay
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

generated/google/apis/policytroubleshooter_v1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/iam/
     module PolicytroubleshooterV1
       VERSION = 'V1'
-      REVISION = '20200606'
+      REVISION = '20200801'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

generated/google/apis/policytroubleshooter_v1/classes.rb

@@ -26,31 +26,28 @@ module Google
       class GoogleCloudPolicytroubleshooterV1AccessTuple
         include Google::Apis::Core::Hashable
       
-        # Required. The full resource name that identifies the resource. For example,
+        # Required. The full resource name that identifies the resource. For example, `//
-        # `//compute.googleapis.com/projects/my-project/zones/us-central1-a/instances/my-
+        # compute.googleapis.com/projects/my-project/zones/us-central1-a/instances/my-
-        # instance`.
+        # instance`. For examples of full resource names for Google Cloud services, see
-        # For examples of full resource names for Google Cloud services, see
         # https://cloud.google.com/iam/help/troubleshooter/full-resource-names.
         # Corresponds to the JSON property `fullResourceName`
         # @return [String]
         attr_accessor :full_resource_name
       
         # Required. The IAM permission to check for the specified member and resource.
-        # For a complete list of IAM permissions, see
+        # For a complete list of IAM permissions, see https://cloud.google.com/iam/help/
-        # https://cloud.google.com/iam/help/permissions/reference.
+        # permissions/reference. For a complete list of predefined IAM roles and the
-        # For a complete list of predefined IAM roles and the permissions in each
+        # permissions in each role, see https://cloud.google.com/iam/help/roles/
-        # role, see https://cloud.google.com/iam/help/roles/reference.
+        # reference.
         # Corresponds to the JSON property `permission`
         # @return [String]
         attr_accessor :permission
       
         # Required. The member, or principal, whose access you want to check, in the
-        # form of
+        # form of the email address that represents that member. For example, `alice@
-        # the email address that represents that member. For example,
+        # example.com` or `my-service-account@my-project.iam.gserviceaccount.com`. The
-        # `alice@example.com` or
+        # member must be a Google Account or a service account. Other types of members
-        # `my-service-account@my-project.iam.gserviceaccount.com`.
+        # are not supported.
-        # The member must be a Google Account or a service account. Other types of
-        # members are not supported.
         # Corresponds to the JSON property `principal`
         # @return [String]
         attr_accessor :principal
@@ -73,58 +70,45 @@ module Google
         include Google::Apis::Core::Hashable
       
         # Required. Indicates whether _this binding_ provides the specified permission
-        # to the
+        # to the specified member for the specified resource. This field does _not_
-        # specified member for the specified resource.
+        # indicate whether the member actually has the permission for the resource.
-        # This field does _not_ indicate whether the member actually has the
+        # There might be another binding that overrides this binding. To determine
-        # permission for the resource. There might be another binding that overrides
+        # whether the member actually has the permission, use the `access` field in the
-        # this binding. To determine whether the member actually has the permission,
-        # use the `access` field in the
         # TroubleshootIamPolicyResponse.
         # Corresponds to the JSON property `access`
         # @return [String]
         attr_accessor :access
       
-        # Represents a textual expression in the Common Expression Language (CEL)
+        # Represents a textual expression in the Common Expression Language (CEL) syntax.
-        # syntax. CEL is a C-like expression language. The syntax and semantics of CEL
+        # CEL is a C-like expression language. The syntax and semantics of CEL are
-        # are documented at https://github.com/google/cel-spec.
+        # documented at https://github.com/google/cel-spec. Example (Comparison): title:
-        # Example (Comparison):
+        # "Summary size limit" description: "Determines if a summary is less than 100
-        # title: "Summary size limit"
+        # chars" expression: "document.summary.size() < 100" Example (Equality): title: "
-        # description: "Determines if a summary is less than 100 chars"
+        # Requestor is owner" description: "Determines if requestor is the document
-        # expression: "document.summary.size() < 100"
+        # owner" expression: "document.owner == request.auth.claims.email" Example (
-        # Example (Equality):
+        # Logic): title: "Public documents" description: "Determine whether the document
-        # title: "Requestor is owner"
+        # should be publicly visible" expression: "document.type != 'private' &&
-        # description: "Determines if requestor is the document owner"
+        # document.type != 'internal'" Example (Data Manipulation): title: "Notification
-        # expression: "document.owner == request.auth.claims.email"
+        # string" description: "Create a notification string with a timestamp."
-        # Example (Logic):
+        # expression: "'New message received at ' + string(document.create_time)" The
-        # title: "Public documents"
+        # exact variables and functions that may be referenced within an expression are
-        # description: "Determine whether the document should be publicly visible"
+        # determined by the service that evaluates it. See the service documentation for
-        # expression: "document.type != 'private' && document.type != 'internal'"
+        # additional information.
-        # Example (Data Manipulation):
-        # title: "Notification string"
-        # description: "Create a notification string with a timestamp."
-        # expression: "'New message received at ' + string(document.create_time)"
-        # The exact variables and functions that may be referenced within an expression
-        # are determined by the service that evaluates it. See the service
-        # documentation for additional information.
         # Corresponds to the JSON property `condition`
         # @return [Google::Apis::PolicytroubleshooterV1::GoogleTypeExpr]
         attr_accessor :condition
       
-        # Indicates whether each member in the binding includes the member specified
+        # Indicates whether each member in the binding includes the member specified in
-        # in the request, either directly or indirectly. Each key identifies a member
+        # the request, either directly or indirectly. Each key identifies a member in
-        # in the binding, and each value indicates whether the member in the binding
+        # the binding, and each value indicates whether the member in the binding
-        # includes the member in the request.
+        # includes the member in the request. For example, suppose that a binding
-        # For example, suppose that a binding includes the following members:
+        # includes the following members: * `user:alice@example.com` * `group:product-
-        # * `user:alice@example.com`
+        # eng@example.com` You want to troubleshoot access for `user:bob@example.com`.
-        # * `group:product-eng@example.com`
+        # This user is a member of the group `group:product-eng@example.com`. For the
-        # You want to troubleshoot access for `user:bob@example.com`. This user is a
+        # first member in the binding, the key is `user:alice@example.com`, and the `
-        # member of the group `group:product-eng@example.com`.
+        # membership` field in the value is set to `MEMBERSHIP_NOT_INCLUDED`. For the
-        # For the first member in the binding, the key is `user:alice@example.com`,
+        # second member in the binding, the key is `group:product-eng@example.com`, and
-        # and the `membership` field in the value is set to
+        # the `membership` field in the value is set to `MEMBERSHIP_INCLUDED`.
-        # `MEMBERSHIP_NOT_INCLUDED`.
-        # For the second member in the binding, the key is
-        # `group:product-eng@example.com`, and the `membership` field in the value is
-        # set to `MEMBERSHIP_INCLUDED`.
         # Corresponds to the JSON property `memberships`
         # @return [Hash<String,Google::Apis::PolicytroubleshooterV1::GoogleCloudPolicytroubleshooterV1BindingExplanationAnnotatedMembership>]
         attr_accessor :memberships
@@ -135,8 +119,7 @@ module Google
         # @return [String]
         attr_accessor :relevance
       
-        # The role that this binding grants. For example,
+        # The role that this binding grants. For example, `roles/compute.serviceAgent`.
-        # `roles/compute.serviceAgent`.
         # For a complete list of predefined IAM roles, as well as the permissions in
         # each role, see https://cloud.google.com/iam/help/roles/reference.
         # Corresponds to the JSON property `role`
@@ -149,8 +132,8 @@ module Google
         # @return [String]
         attr_accessor :role_permission
       
-        # The relevance of the permission's existence, or nonexistence, in the role
+        # The relevance of the permission's existence, or nonexistence, in the role to
-        # to the overall determination for the entire policy.
+        # the overall determination for the entire policy.
         # Corresponds to the JSON property `rolePermissionRelevance`
         # @return [String]
         attr_accessor :role_permission_relevance
@@ -197,110 +180,70 @@ module Google
         end
       end
       
-      # Details about how a specific IAM Policy contributed
+      # Details about how a specific IAM Policy contributed to the access check.
-      # to the access check.
       class GoogleCloudPolicytroubleshooterV1ExplainedPolicy
         include Google::Apis::Core::Hashable
       
         # Indicates whether _this policy_ provides the specified permission to the
-        # specified member for the specified resource.
+        # specified member for the specified resource. This field does _not_ indicate
-        # This field does _not_ indicate whether the member actually has the
+        # whether the member actually has the permission for the resource. There might
-        # permission for the resource. There might be another policy that overrides
+        # be another policy that overrides this policy. To determine whether the member
-        # this policy. To determine whether the member actually has the permission,
+        # actually has the permission, use the `access` field in the
-        # use the `access` field in the
         # TroubleshootIamPolicyResponse.
         # Corresponds to the JSON property `access`
         # @return [String]
         attr_accessor :access
       
-        # Details about how each binding in the policy affects the member's ability,
+        # Details about how each binding in the policy affects the member's ability, or
-        # or inability, to use the permission for the resource.
+        # inability, to use the permission for the resource. If the sender of the
-        # If the sender of the request does not have access to the policy, this field
+        # request does not have access to the policy, this field is omitted.
-        # is omitted.
         # Corresponds to the JSON property `bindingExplanations`
         # @return [Array<Google::Apis::PolicytroubleshooterV1::GoogleCloudPolicytroubleshooterV1BindingExplanation>]
         attr_accessor :binding_explanations
       
-        # The full resource name that identifies the resource. For example,
+        # The full resource name that identifies the resource. For example, `//compute.
-        # `//compute.googleapis.com/projects/my-project/zones/us-central1-a/instances/my-
+        # googleapis.com/projects/my-project/zones/us-central1-a/instances/my-instance`.
-        # instance`.
+        # If the sender of the request does not have access to the policy, this field is
-        # If the sender of the request does not have access to the policy, this field
+        # omitted. For examples of full resource names for Google Cloud services, see
-        # is omitted.
-        # For examples of full resource names for Google Cloud services, see
         # https://cloud.google.com/iam/help/troubleshooter/full-resource-names.
         # Corresponds to the JSON property `fullResourceName`
         # @return [String]
         attr_accessor :full_resource_name
       
         # An Identity and Access Management (IAM) policy, which specifies access
-        # controls for Google Cloud resources.
+        # controls for Google Cloud resources. A `Policy` is a collection of `bindings`.
-        # A `Policy` is a collection of `bindings`. A `binding` binds one or more
+        # A `binding` binds one or more `members` to a single `role`. Members can be
-        # `members` to a single `role`. Members can be user accounts, service accounts,
+        # user accounts, service accounts, Google groups, and domains (such as G Suite).
-        # Google groups, and domains (such as G Suite). A `role` is a named list of
+        # A `role` is a named list of permissions; each `role` can be an IAM predefined
-        # permissions; each `role` can be an IAM predefined role or a user-created
+        # role or a user-created custom role. For some types of Google Cloud resources,
-        # custom role.
+        # a `binding` can also specify a `condition`, which is a logical expression that
-        # For some types of Google Cloud resources, a `binding` can also specify a
+        # allows access to a resource only if the expression evaluates to `true`. A
-        # `condition`, which is a logical expression that allows access to a resource
+        # condition can add constraints based on attributes of the request, the resource,
-        # only if the expression evaluates to `true`. A condition can add constraints
+        # or both. To learn which resources support conditions in their IAM policies,
-        # based on attributes of the request, the resource, or both. To learn which
+        # see the [IAM documentation](https://cloud.google.com/iam/help/conditions/
-        # resources support conditions in their IAM policies, see the
+        # resource-policies). **JSON example:** ` "bindings": [ ` "role": "roles/
-        # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-
+        # resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", "
-        # policies).
+        # group:admins@example.com", "domain:google.com", "serviceAccount:my-project-id@
-        # **JSON example:**
+        # appspot.gserviceaccount.com" ] `, ` "role": "roles/resourcemanager.
-        # `
+        # organizationViewer", "members": [ "user:eve@example.com" ], "condition": ` "
-        # "bindings": [
+        # title": "expirable access", "description": "Does not grant access after Sep
-        # `
+        # 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", `
-        # "role": "roles/resourcemanager.organizationAdmin",
+        # ` ], "etag": "BwWWja0YfJA=", "version": 3 ` **YAML example:** bindings: -
-        # "members": [
+        # members: - user:mike@example.com - group:admins@example.com - domain:google.
-        # "user:mike@example.com",
+        # com - serviceAccount:my-project-id@appspot.gserviceaccount.com role: roles/
-        # "group:admins@example.com",
+        # resourcemanager.organizationAdmin - members: - user:eve@example.com role:
-        # "domain:google.com",
+        # roles/resourcemanager.organizationViewer condition: title: expirable access
-        # "serviceAccount:my-project-id@appspot.gserviceaccount.com"
+        # description: Does not grant access after Sep 2020 expression: request.time <
-        # ]
+        # timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: 3 For a
-        # `,
+        # description of IAM and its features, see the [IAM documentation](https://cloud.
-        # `
+        # google.com/iam/docs/).
-        # "role": "roles/resourcemanager.organizationViewer",
-        # "members": [
-        # "user:eve@example.com"
-        # ],
-        # "condition": `
-        # "title": "expirable access",
-        # "description": "Does not grant access after Sep 2020",
-        # "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')
-        # ",
-        # `
-        # `
-        # ],
-        # "etag": "BwWWja0YfJA=",
-        # "version": 3
-        # `
-        # **YAML example:**
-        # bindings:
-        # - members:
-        # - user:mike@example.com
-        # - group:admins@example.com
-        # - domain:google.com
-        # - serviceAccount:my-project-id@appspot.gserviceaccount.com
-        # role: roles/resourcemanager.organizationAdmin
-        # - members:
-        # - user:eve@example.com
-        # role: roles/resourcemanager.organizationViewer
-        # condition:
-        # title: expirable access
-        # description: Does not grant access after Sep 2020
-        # expression: request.time < timestamp('2020-10-01T00:00:00.000Z')
-        # - etag: BwWWja0YfJA=
-        # - version: 3
-        # For a description of IAM and its features, see the
-        # [IAM documentation](https://cloud.google.com/iam/docs/).
         # Corresponds to the JSON property `policy`
         # @return [Google::Apis::PolicytroubleshooterV1::GoogleIamV1Policy]
         attr_accessor :policy
       
         # The relevance of this policy to the overall determination in the
-        # TroubleshootIamPolicyResponse.
+        # TroubleshootIamPolicyResponse. If the sender of the request does not have
-        # If the sender of the request does not have access to the policy, this field
+        # access to the policy, this field is omitted.
-        # is omitted.
         # Corresponds to the JSON property `relevance`
         # @return [String]
         attr_accessor :relevance
@@ -349,13 +292,12 @@ module Google
         attr_accessor :access
       
         # List of IAM policies that were evaluated to check the member's permissions,
-        # with annotations to indicate how each policy contributed to the final
+        # with annotations to indicate how each policy contributed to the final result.
-        # result.
         # The list of policies can include the policy for the resource itself. It can
         # also include policies that are inherited from higher levels of the resource
-        # hierarchy, including the organization, the folder, and the project.
+        # hierarchy, including the organization, the folder, and the project. To learn
-        # To learn more about the resource hierarchy, see
+        # more about the resource hierarchy, see https://cloud.google.com/iam/help/
-        # https://cloud.google.com/iam/help/resource-hierarchy.
+        # resource-hierarchy.
         # Corresponds to the JSON property `explainedPolicies`
         # @return [Array<Google::Apis::PolicytroubleshooterV1::GoogleCloudPolicytroubleshooterV1ExplainedPolicy>]
         attr_accessor :explained_policies
@@ -371,53 +313,21 @@ module Google
         end
       end
       
-      # Specifies the audit configuration for a service.
+      # Specifies the audit configuration for a service. The configuration determines
-      # The configuration determines which permission types are logged, and what
+      # which permission types are logged, and what identities, if any, are exempted
-      # identities, if any, are exempted from logging.
+      # from logging. An AuditConfig must have one or more AuditLogConfigs. If there
-      # An AuditConfig must have one or more AuditLogConfigs.
+      # are AuditConfigs for both `allServices` and a specific service, the union of
-      # If there are AuditConfigs for both `allServices` and a specific service,
+      # the two AuditConfigs is used for that service: the log_types specified in each
-      # the union of the two AuditConfigs is used for that service: the log_types
+      # AuditConfig are enabled, and the exempted_members in each AuditLogConfig are
-      # specified in each AuditConfig are enabled, and the exempted_members in each
+      # exempted. Example Policy with multiple AuditConfigs: ` "audit_configs": [ ` "
-      # AuditLogConfig are exempted.
+      # service": "allServices", "audit_log_configs": [ ` "log_type": "DATA_READ", "
-      # Example Policy with multiple AuditConfigs:
+      # exempted_members": [ "user:jose@example.com" ] `, ` "log_type": "DATA_WRITE" `,
-      # `
+      # ` "log_type": "ADMIN_READ" ` ] `, ` "service": "sampleservice.googleapis.com",
-      # "audit_configs": [
+      # "audit_log_configs": [ ` "log_type": "DATA_READ" `, ` "log_type": "DATA_WRITE"
-      # `
+      # , "exempted_members": [ "user:aliya@example.com" ] ` ] ` ] ` For sampleservice,
-      # "service": "allServices",
+      # this policy enables DATA_READ, DATA_WRITE and ADMIN_READ logging. It also
-      # "audit_log_configs": [
+      # exempts jose@example.com from DATA_READ logging, and aliya@example.com from
-      # `
+      # DATA_WRITE logging.
-      # "log_type": "DATA_READ",
-      # "exempted_members": [
-      # "user:jose@example.com"
-      # ]
-      # `,
-      # `
-      # "log_type": "DATA_WRITE"
-      # `,
-      # `
-      # "log_type": "ADMIN_READ"
-      # `
-      # ]
-      # `,
-      # `
-      # "service": "sampleservice.googleapis.com",
-      # "audit_log_configs": [
-      # `
-      # "log_type": "DATA_READ"
-      # `,
-      # `
-      # "log_type": "DATA_WRITE",
-      # "exempted_members": [
-      # "user:aliya@example.com"
-      # ]
-      # `
-      # ]
-      # `
-      # ]
-      # `
-      # For sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ
-      # logging. It also exempts jose@example.com from DATA_READ logging, and
-      # aliya@example.com from DATA_WRITE logging.
       class GoogleIamV1AuditConfig
         include Google::Apis::Core::Hashable
       
@@ -426,9 +336,9 @@ module Google
         # @return [Array<Google::Apis::PolicytroubleshooterV1::GoogleIamV1AuditLogConfig>]
         attr_accessor :audit_log_configs
       
-        # Specifies a service that will be enabled for audit logging.
+        # Specifies a service that will be enabled for audit logging. For example, `
-        # For example, `storage.googleapis.com`, `cloudsql.googleapis.com`.
+        # storage.googleapis.com`, `cloudsql.googleapis.com`. `allServices` is a special
-        # `allServices` is a special value that covers all services.
+        # value that covers all services.
         # Corresponds to the JSON property `service`
         # @return [String]
         attr_accessor :service
@@ -444,28 +354,15 @@ module Google
         end
       end
       
-      # Provides the configuration for logging a type of permissions.
+      # Provides the configuration for logging a type of permissions. Example: ` "
-      # Example:
+      # audit_log_configs": [ ` "log_type": "DATA_READ", "exempted_members": [ "user:
-      # `
+      # jose@example.com" ] `, ` "log_type": "DATA_WRITE" ` ] ` This enables '
-      # "audit_log_configs": [
+      # DATA_READ' and 'DATA_WRITE' logging, while exempting jose@example.com from
-      # `
+      # DATA_READ logging.
-      # "log_type": "DATA_READ",
-      # "exempted_members": [
-      # "user:jose@example.com"
-      # ]
-      # `,
-      # `
-      # "log_type": "DATA_WRITE"
-      # `
-      # ]
-      # `
-      # This enables 'DATA_READ' and 'DATA_WRITE' logging, while exempting
-      # jose@example.com from DATA_READ logging.
       class GoogleIamV1AuditLogConfig
         include Google::Apis::Core::Hashable
       
-        # Specifies the identities that do not cause logging for this type of
+        # Specifies the identities that do not cause logging for this type of permission.
-        # permission.
         # Follows the same format of Binding.members.
         # Corresponds to the JSON property `exemptedMembers`
         # @return [Array<String>]
@@ -491,69 +388,57 @@ module Google
       class GoogleIamV1Binding
         include Google::Apis::Core::Hashable
       
-        # Represents a textual expression in the Common Expression Language (CEL)
+        # Represents a textual expression in the Common Expression Language (CEL) syntax.
-        # syntax. CEL is a C-like expression language. The syntax and semantics of CEL
+        # CEL is a C-like expression language. The syntax and semantics of CEL are
-        # are documented at https://github.com/google/cel-spec.
+        # documented at https://github.com/google/cel-spec. Example (Comparison): title:
-        # Example (Comparison):
+        # "Summary size limit" description: "Determines if a summary is less than 100
-        # title: "Summary size limit"
+        # chars" expression: "document.summary.size() < 100" Example (Equality): title: "
-        # description: "Determines if a summary is less than 100 chars"
+        # Requestor is owner" description: "Determines if requestor is the document
-        # expression: "document.summary.size() < 100"
+        # owner" expression: "document.owner == request.auth.claims.email" Example (
-        # Example (Equality):
+        # Logic): title: "Public documents" description: "Determine whether the document
-        # title: "Requestor is owner"
+        # should be publicly visible" expression: "document.type != 'private' &&
-        # description: "Determines if requestor is the document owner"
+        # document.type != 'internal'" Example (Data Manipulation): title: "Notification
-        # expression: "document.owner == request.auth.claims.email"
+        # string" description: "Create a notification string with a timestamp."
-        # Example (Logic):
+        # expression: "'New message received at ' + string(document.create_time)" The
-        # title: "Public documents"
+        # exact variables and functions that may be referenced within an expression are
-        # description: "Determine whether the document should be publicly visible"
+        # determined by the service that evaluates it. See the service documentation for
-        # expression: "document.type != 'private' && document.type != 'internal'"
+        # additional information.
-        # Example (Data Manipulation):
-        # title: "Notification string"
-        # description: "Create a notification string with a timestamp."
-        # expression: "'New message received at ' + string(document.create_time)"
-        # The exact variables and functions that may be referenced within an expression
-        # are determined by the service that evaluates it. See the service
-        # documentation for additional information.
         # Corresponds to the JSON property `condition`
         # @return [Google::Apis::PolicytroubleshooterV1::GoogleTypeExpr]
         attr_accessor :condition
       
-        # Specifies the identities requesting access for a Cloud Platform resource.
+        # Specifies the identities requesting access for a Cloud Platform resource. `
-        # `members` can have the following values:
+        # members` can have the following values: * `allUsers`: A special identifier
-        # * `allUsers`: A special identifier that represents anyone who is
+        # that represents anyone who is on the internet; with or without a Google
-        # on the internet; with or without a Google account.
+        # account. * `allAuthenticatedUsers`: A special identifier that represents
-        # * `allAuthenticatedUsers`: A special identifier that represents anyone
+        # anyone who is authenticated with a Google account or a service account. * `
-        # who is authenticated with a Google account or a service account.
+        # user:`emailid``: An email address that represents a specific Google account.
-        # * `user:`emailid``: An email address that represents a specific Google
+        # For example, `alice@example.com` . * `serviceAccount:`emailid``: An email
-        # account. For example, `alice@example.com` .
+        # address that represents a service account. For example, `my-other-app@appspot.
-        # * `serviceAccount:`emailid``: An email address that represents a service
+        # gserviceaccount.com`. * `group:`emailid``: An email address that represents a
-        # account. For example, `my-other-app@appspot.gserviceaccount.com`.
+        # Google group. For example, `admins@example.com`. * `deleted:user:`emailid`?uid=
-        # * `group:`emailid``: An email address that represents a Google group.
+        # `uniqueid``: An email address (plus unique identifier) representing a user
-        # For example, `admins@example.com`.
+        # that has been recently deleted. For example, `alice@example.com?uid=
-        # * `deleted:user:`emailid`?uid=`uniqueid``: An email address (plus unique
+        # 123456789012345678901`. If the user is recovered, this value reverts to `user:`
-        # identifier) representing a user that has been recently deleted. For
+        # emailid`` and the recovered user retains the role in the binding. * `deleted:
-        # example, `alice@example.com?uid=123456789012345678901`. If the user is
+        # serviceAccount:`emailid`?uid=`uniqueid``: An email address (plus unique
-        # recovered, this value reverts to `user:`emailid`` and the recovered user
+        # identifier) representing a service account that has been recently deleted. For
-        # retains the role in the binding.
+        # example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`.
-        # * `deleted:serviceAccount:`emailid`?uid=`uniqueid``: An email address (plus
+        # If the service account is undeleted, this value reverts to `serviceAccount:`
-        # unique identifier) representing a service account that has been recently
+        # emailid`` and the undeleted service account retains the role in the binding. *
-        # deleted. For example,
+        # `deleted:group:`emailid`?uid=`uniqueid``: An email address (plus unique
-        # `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`.
+        # identifier) representing a Google group that has been recently deleted. For
-        # If the service account is undeleted, this value reverts to
+        # example, `admins@example.com?uid=123456789012345678901`. If the group is
-        # `serviceAccount:`emailid`` and the undeleted service account retains the
+        # recovered, this value reverts to `group:`emailid`` and the recovered group
-        # role in the binding.
+        # retains the role in the binding. * `domain:`domain``: The G Suite domain (
-        # * `deleted:group:`emailid`?uid=`uniqueid``: An email address (plus unique
+        # primary) that represents all the users of that domain. For example, `google.
-        # identifier) representing a Google group that has been recently
+        # com` or `example.com`.
-        # deleted. For example, `admins@example.com?uid=123456789012345678901`. If
-        # the group is recovered, this value reverts to `group:`emailid`` and the
-        # recovered group retains the role in the binding.
-        # * `domain:`domain``: The G Suite domain (primary) that represents all the
-        # users of that domain. For example, `google.com` or `example.com`.
         # Corresponds to the JSON property `members`
         # @return [Array<String>]
         attr_accessor :members
       
-        # Role that is assigned to `members`.
+        # Role that is assigned to `members`. For example, `roles/viewer`, `roles/editor`
-        # For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
+        # , or `roles/owner`.
         # Corresponds to the JSON property `role`
         # @return [String]
         attr_accessor :role
@@ -571,66 +456,32 @@ module Google
       end
       
       # An Identity and Access Management (IAM) policy, which specifies access
-      # controls for Google Cloud resources.
+      # controls for Google Cloud resources. A `Policy` is a collection of `bindings`.
-      # A `Policy` is a collection of `bindings`. A `binding` binds one or more
+      # A `binding` binds one or more `members` to a single `role`. Members can be
-      # `members` to a single `role`. Members can be user accounts, service accounts,
+      # user accounts, service accounts, Google groups, and domains (such as G Suite).
-      # Google groups, and domains (such as G Suite). A `role` is a named list of
+      # A `role` is a named list of permissions; each `role` can be an IAM predefined
-      # permissions; each `role` can be an IAM predefined role or a user-created
+      # role or a user-created custom role. For some types of Google Cloud resources,
-      # custom role.
+      # a `binding` can also specify a `condition`, which is a logical expression that
-      # For some types of Google Cloud resources, a `binding` can also specify a
+      # allows access to a resource only if the expression evaluates to `true`. A
-      # `condition`, which is a logical expression that allows access to a resource
+      # condition can add constraints based on attributes of the request, the resource,
-      # only if the expression evaluates to `true`. A condition can add constraints
+      # or both. To learn which resources support conditions in their IAM policies,
-      # based on attributes of the request, the resource, or both. To learn which
+      # see the [IAM documentation](https://cloud.google.com/iam/help/conditions/
-      # resources support conditions in their IAM policies, see the
+      # resource-policies). **JSON example:** ` "bindings": [ ` "role": "roles/
-      # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-
+      # resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", "
-      # policies).
+      # group:admins@example.com", "domain:google.com", "serviceAccount:my-project-id@
-      # **JSON example:**
+      # appspot.gserviceaccount.com" ] `, ` "role": "roles/resourcemanager.
-      # `
+      # organizationViewer", "members": [ "user:eve@example.com" ], "condition": ` "
-      # "bindings": [
+      # title": "expirable access", "description": "Does not grant access after Sep
-      # `
+      # 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", `
-      # "role": "roles/resourcemanager.organizationAdmin",
+      # ` ], "etag": "BwWWja0YfJA=", "version": 3 ` **YAML example:** bindings: -
-      # "members": [
+      # members: - user:mike@example.com - group:admins@example.com - domain:google.
-      # "user:mike@example.com",
+      # com - serviceAccount:my-project-id@appspot.gserviceaccount.com role: roles/
-      # "group:admins@example.com",
+      # resourcemanager.organizationAdmin - members: - user:eve@example.com role:
-      # "domain:google.com",
+      # roles/resourcemanager.organizationViewer condition: title: expirable access
-      # "serviceAccount:my-project-id@appspot.gserviceaccount.com"
+      # description: Does not grant access after Sep 2020 expression: request.time <
-      # ]
+      # timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: 3 For a
-      # `,
+      # description of IAM and its features, see the [IAM documentation](https://cloud.
-      # `
+      # google.com/iam/docs/).
-      # "role": "roles/resourcemanager.organizationViewer",
-      # "members": [
-      # "user:eve@example.com"
-      # ],
-      # "condition": `
-      # "title": "expirable access",
-      # "description": "Does not grant access after Sep 2020",
-      # "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')
-      # ",
-      # `
-      # `
-      # ],
-      # "etag": "BwWWja0YfJA=",
-      # "version": 3
-      # `
-      # **YAML example:**
-      # bindings:
-      # - members:
-      # - user:mike@example.com
-      # - group:admins@example.com
-      # - domain:google.com
-      # - serviceAccount:my-project-id@appspot.gserviceaccount.com
-      # role: roles/resourcemanager.organizationAdmin
-      # - members:
-      # - user:eve@example.com
-      # role: roles/resourcemanager.organizationViewer
-      # condition:
-      # title: expirable access
-      # description: Does not grant access after Sep 2020
-      # expression: request.time < timestamp('2020-10-01T00:00:00.000Z')
-      # - etag: BwWWja0YfJA=
-      # - version: 3
-      # For a description of IAM and its features, see the
-      # [IAM documentation](https://cloud.google.com/iam/docs/).
       class GoogleIamV1Policy
         include Google::Apis::Core::Hashable
       
@@ -639,48 +490,44 @@ module Google
         # @return [Array<Google::Apis::PolicytroubleshooterV1::GoogleIamV1AuditConfig>]
         attr_accessor :audit_configs
       
-        # Associates a list of `members` to a `role`. Optionally, may specify a
+        # Associates a list of `members` to a `role`. Optionally, may specify a `
-        # `condition` that determines how and when the `bindings` are applied. Each
+        # condition` that determines how and when the `bindings` are applied. Each of
-        # of the `bindings` must contain at least one member.
+        # the `bindings` must contain at least one member.
         # Corresponds to the JSON property `bindings`
         # @return [Array<Google::Apis::PolicytroubleshooterV1::GoogleIamV1Binding>]
         attr_accessor :bindings
       
-        # `etag` is used for optimistic concurrency control as a way to help
+        # `etag` is used for optimistic concurrency control as a way to help prevent
-        # prevent simultaneous updates of a policy from overwriting each other.
+        # simultaneous updates of a policy from overwriting each other. It is strongly
-        # It is strongly suggested that systems make use of the `etag` in the
+        # suggested that systems make use of the `etag` in the read-modify-write cycle
-        # read-modify-write cycle to perform policy updates in order to avoid race
+        # to perform policy updates in order to avoid race conditions: An `etag` is
-        # conditions: An `etag` is returned in the response to `getIamPolicy`, and
+        # returned in the response to `getIamPolicy`, and systems are expected to put
-        # systems are expected to put that etag in the request to `setIamPolicy` to
+        # that etag in the request to `setIamPolicy` to ensure that their change will be
-        # ensure that their change will be applied to the same version of the policy.
+        # applied to the same version of the policy. **Important:** If you use IAM
-        # **Important:** If you use IAM Conditions, you must include the `etag` field
+        # Conditions, you must include the `etag` field whenever you call `setIamPolicy`.
-        # whenever you call `setIamPolicy`. If you omit this field, then IAM allows
+        # If you omit this field, then IAM allows you to overwrite a version `3` policy
-        # you to overwrite a version `3` policy with a version `1` policy, and all of
+        # with a version `1` policy, and all of the conditions in the version `3` policy
-        # the conditions in the version `3` policy are lost.
+        # are lost.
         # Corresponds to the JSON property `etag`
         # NOTE: Values are automatically base64 encoded/decoded in the client library.
         # @return [String]
         attr_accessor :etag
       
-        # Specifies the format of the policy.
+        # Specifies the format of the policy. Valid values are `0`, `1`, and `3`.
-        # Valid values are `0`, `1`, and `3`. Requests that specify an invalid value
+        # Requests that specify an invalid value are rejected. Any operation that
-        # are rejected.
+        # affects conditional role bindings must specify version `3`. This requirement
-        # Any operation that affects conditional role bindings must specify version
+        # applies to the following operations: * Getting a policy that includes a
-        # `3`. This requirement applies to the following operations:
+        # conditional role binding * Adding a conditional role binding to a policy *
-        # * Getting a policy that includes a conditional role binding
+        # Changing a conditional role binding in a policy * Removing any role binding,
-        # * Adding a conditional role binding to a policy
+        # with or without a condition, from a policy that includes conditions **
-        # * Changing a conditional role binding in a policy
+        # Important:** If you use IAM Conditions, you must include the `etag` field
-        # * Removing any role binding, with or without a condition, from a policy
+        # whenever you call `setIamPolicy`. If you omit this field, then IAM allows you
-        # that includes conditions
+        # to overwrite a version `3` policy with a version `1` policy, and all of the
-        # **Important:** If you use IAM Conditions, you must include the `etag` field
+        # conditions in the version `3` policy are lost. If a policy does not include
-        # whenever you call `setIamPolicy`. If you omit this field, then IAM allows
+        # any conditions, operations on that policy may specify any valid version or
-        # you to overwrite a version `3` policy with a version `1` policy, and all of
+        # leave the field unset. To learn which resources support conditions in their
-        # the conditions in the version `3` policy are lost.
+        # IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/
-        # If a policy does not include any conditions, operations on that policy may
+        # conditions/resource-policies).
-        # specify any valid version or leave the field unset.
-        # To learn which resources support conditions in their IAM policies, see the
-        # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-
-        # policies).
         # Corresponds to the JSON property `version`
         # @return [Fixnum]
         attr_accessor :version
@@ -698,52 +545,43 @@ module Google
         end
       end
       
-      # Represents a textual expression in the Common Expression Language (CEL)
+      # Represents a textual expression in the Common Expression Language (CEL) syntax.
-      # syntax. CEL is a C-like expression language. The syntax and semantics of CEL
+      # CEL is a C-like expression language. The syntax and semantics of CEL are
-      # are documented at https://github.com/google/cel-spec.
+      # documented at https://github.com/google/cel-spec. Example (Comparison): title:
-      # Example (Comparison):
+      # "Summary size limit" description: "Determines if a summary is less than 100
-      # title: "Summary size limit"
+      # chars" expression: "document.summary.size() < 100" Example (Equality): title: "
-      # description: "Determines if a summary is less than 100 chars"
+      # Requestor is owner" description: "Determines if requestor is the document
-      # expression: "document.summary.size() < 100"
+      # owner" expression: "document.owner == request.auth.claims.email" Example (
-      # Example (Equality):
+      # Logic): title: "Public documents" description: "Determine whether the document
-      # title: "Requestor is owner"
+      # should be publicly visible" expression: "document.type != 'private' &&
-      # description: "Determines if requestor is the document owner"
+      # document.type != 'internal'" Example (Data Manipulation): title: "Notification
-      # expression: "document.owner == request.auth.claims.email"
+      # string" description: "Create a notification string with a timestamp."
-      # Example (Logic):
+      # expression: "'New message received at ' + string(document.create_time)" The
-      # title: "Public documents"
+      # exact variables and functions that may be referenced within an expression are
-      # description: "Determine whether the document should be publicly visible"
+      # determined by the service that evaluates it. See the service documentation for
-      # expression: "document.type != 'private' && document.type != 'internal'"
+      # additional information.
-      # Example (Data Manipulation):
-      # title: "Notification string"
-      # description: "Create a notification string with a timestamp."
-      # expression: "'New message received at ' + string(document.create_time)"
-      # The exact variables and functions that may be referenced within an expression
-      # are determined by the service that evaluates it. See the service
-      # documentation for additional information.
       class GoogleTypeExpr
         include Google::Apis::Core::Hashable
       
-        # Optional. Description of the expression. This is a longer text which
+        # Optional. Description of the expression. This is a longer text which describes
-        # describes the expression, e.g. when hovered over it in a UI.
+        # the expression, e.g. when hovered over it in a UI.
         # Corresponds to the JSON property `description`
         # @return [String]
         attr_accessor :description
       
-        # Textual representation of an expression in Common Expression Language
+        # Textual representation of an expression in Common Expression Language syntax.
-        # syntax.
         # Corresponds to the JSON property `expression`
         # @return [String]
         attr_accessor :expression
       
-        # Optional. String indicating the location of the expression for error
+        # Optional. String indicating the location of the expression for error reporting,
-        # reporting, e.g. a file name and a position in the file.
+        # e.g. a file name and a position in the file.
         # Corresponds to the JSON property `location`
         # @return [String]
         attr_accessor :location
       
-        # Optional. Title for the expression, i.e. a short string describing
+        # Optional. Title for the expression, i.e. a short string describing its purpose.
-        # its purpose. This can be used e.g. in UIs which allow to enter the
+        # This can be used e.g. in UIs which allow to enter the expression.
-        # expression.
         # Corresponds to the JSON property `title`
         # @return [String]
         attr_accessor :title

generated/google/apis/policytroubleshooter_v1/service.rb

@@ -47,8 +47,8 @@ module Google
           @batch_path = 'batch'
         end
         
-        # Checks whether a member has a specific permission for a specific resource,
+        # Checks whether a member has a specific permission for a specific resource, and
-        # and explains why the member does or does not have that permission.
+        # explains why the member does or does not have that permission.
         # @param [Google::Apis::PolicytroubleshooterV1::GoogleCloudPolicytroubleshooterV1TroubleshootIamPolicyRequest] google_cloud_policytroubleshooter_v1_troubleshoot_iam_policy_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.

generated/google/apis/policytroubleshooter_v1beta.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/iam/
     module PolicytroubleshooterV1beta
       VERSION = 'V1beta'
-      REVISION = '20200606'
+      REVISION = '20200801'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

generated/google/apis/policytroubleshooter_v1beta/classes.rb

@@ -26,31 +26,28 @@ module Google
       class GoogleCloudPolicytroubleshooterV1betaAccessTuple
         include Google::Apis::Core::Hashable
       
-        # Required. The full resource name that identifies the resource. For example,
+        # Required. The full resource name that identifies the resource. For example, `//
-        # `//compute.googleapis.com/projects/my-project/zones/us-central1-a/instances/my-
+        # compute.googleapis.com/projects/my-project/zones/us-central1-a/instances/my-
-        # instance`.
+        # instance`. For examples of full resource names for Google Cloud services, see
-        # For examples of full resource names for Google Cloud services, see
         # https://cloud.google.com/iam/help/troubleshooter/full-resource-names.
         # Corresponds to the JSON property `fullResourceName`
         # @return [String]
         attr_accessor :full_resource_name
       
         # Required. The IAM permission to check for the specified member and resource.
-        # For a complete list of IAM permissions, see
+        # For a complete list of IAM permissions, see https://cloud.google.com/iam/help/
-        # https://cloud.google.com/iam/help/permissions/reference.
+        # permissions/reference. For a complete list of predefined IAM roles and the
-        # For a complete list of predefined IAM roles and the permissions in each
+        # permissions in each role, see https://cloud.google.com/iam/help/roles/
-        # role, see https://cloud.google.com/iam/help/roles/reference.
+        # reference.
         # Corresponds to the JSON property `permission`
         # @return [String]
         attr_accessor :permission
       
         # Required. The member, or principal, whose access you want to check, in the
-        # form of
+        # form of the email address that represents that member. For example, `alice@
-        # the email address that represents that member. For example,
+        # example.com` or `my-service-account@my-project.iam.gserviceaccount.com`. The
-        # `alice@example.com` or
+        # member must be a Google Account or a service account. Other types of members
-        # `my-service-account@my-project.iam.gserviceaccount.com`.
+        # are not supported.
-        # The member must be a Google Account or a service account. Other types of
-        # members are not supported.
         # Corresponds to the JSON property `principal`
         # @return [String]
         attr_accessor :principal
@@ -73,57 +70,45 @@ module Google
         include Google::Apis::Core::Hashable
       
         # Indicates whether _this binding_ provides the specified permission to the
-        # specified member for the specified resource.
+        # specified member for the specified resource. This field does _not_ indicate
-        # This field does _not_ indicate whether the member actually has the
+        # whether the member actually has the permission for the resource. There might
-        # permission for the resource. There might be another binding that overrides
+        # be another binding that overrides this binding. To determine whether the
-        # this binding. To determine whether the member actually has the permission,
+        # member actually has the permission, use the `access` field in the
-        # use the `access` field in the
         # TroubleshootIamPolicyResponse.
         # Corresponds to the JSON property `access`
         # @return [String]
         attr_accessor :access
       
-        # Represents a textual expression in the Common Expression Language (CEL)
+        # Represents a textual expression in the Common Expression Language (CEL) syntax.
-        # syntax. CEL is a C-like expression language. The syntax and semantics of CEL
+        # CEL is a C-like expression language. The syntax and semantics of CEL are
-        # are documented at https://github.com/google/cel-spec.
+        # documented at https://github.com/google/cel-spec. Example (Comparison): title:
-        # Example (Comparison):
+        # "Summary size limit" description: "Determines if a summary is less than 100
-        # title: "Summary size limit"
+        # chars" expression: "document.summary.size() < 100" Example (Equality): title: "
-        # description: "Determines if a summary is less than 100 chars"
+        # Requestor is owner" description: "Determines if requestor is the document
-        # expression: "document.summary.size() < 100"
+        # owner" expression: "document.owner == request.auth.claims.email" Example (
-        # Example (Equality):
+        # Logic): title: "Public documents" description: "Determine whether the document
-        # title: "Requestor is owner"
+        # should be publicly visible" expression: "document.type != 'private' &&
-        # description: "Determines if requestor is the document owner"
+        # document.type != 'internal'" Example (Data Manipulation): title: "Notification
-        # expression: "document.owner == request.auth.claims.email"
+        # string" description: "Create a notification string with a timestamp."
-        # Example (Logic):
+        # expression: "'New message received at ' + string(document.create_time)" The
-        # title: "Public documents"
+        # exact variables and functions that may be referenced within an expression are
-        # description: "Determine whether the document should be publicly visible"
+        # determined by the service that evaluates it. See the service documentation for
-        # expression: "document.type != 'private' && document.type != 'internal'"
+        # additional information.
-        # Example (Data Manipulation):
-        # title: "Notification string"
-        # description: "Create a notification string with a timestamp."
-        # expression: "'New message received at ' + string(document.create_time)"
-        # The exact variables and functions that may be referenced within an expression
-        # are determined by the service that evaluates it. See the service
-        # documentation for additional information.
         # Corresponds to the JSON property `condition`
         # @return [Google::Apis::PolicytroubleshooterV1beta::GoogleTypeExpr]
         attr_accessor :condition
       
-        # Indicates whether each member in the binding includes the member specified
+        # Indicates whether each member in the binding includes the member specified in
-        # in the request, either directly or indirectly. Each key identifies a member
+        # the request, either directly or indirectly. Each key identifies a member in
-        # in the binding, and each value indicates whether the member in the binding
+        # the binding, and each value indicates whether the member in the binding
-        # includes the member in the request.
+        # includes the member in the request. For example, suppose that a binding
-        # For example, suppose that a binding includes the following members:
+        # includes the following members: * `user:alice@example.com` * `group:product-
-        # * `user:alice@example.com`
+        # eng@example.com` You want to troubleshoot access for `user:bob@example.com`.
-        # * `group:product-eng@example.com`
+        # This user is a member of the group `group:product-eng@example.com`. For the
-        # You want to troubleshoot access for `user:bob@example.com`. This user is a
+        # first member in the binding, the key is `user:alice@example.com`, and the `
-        # member of the group `group:product-eng@example.com`.
+        # membership` field in the value is set to `MEMBERSHIP_NOT_INCLUDED`. For the
-        # For the first member in the binding, the key is `user:alice@example.com`,
+        # second member in the binding, the key is `group:product-eng@example.com`, and
-        # and the `membership` field in the value is set to
+        # the `membership` field in the value is set to `MEMBERSHIP_INCLUDED`.
-        # `MEMBERSHIP_NOT_INCLUDED`.
-        # For the second member in the binding, the key is
-        # `group:product-eng@example.com`, and the `membership` field in the value is
-        # set to `MEMBERSHIP_INCLUDED`.
         # Corresponds to the JSON property `memberships`
         # @return [Hash<String,Google::Apis::PolicytroubleshooterV1beta::GoogleCloudPolicytroubleshooterV1betaBindingExplanationAnnotatedMembership>]
         attr_accessor :memberships
@@ -134,8 +119,7 @@ module Google
         # @return [String]
         attr_accessor :relevance
       
-        # The role that this binding grants. For example,
+        # The role that this binding grants. For example, `roles/compute.serviceAgent`.
-        # `roles/compute.serviceAgent`.
         # For a complete list of predefined IAM roles, as well as the permissions in
         # each role, see https://cloud.google.com/iam/help/roles/reference.
         # Corresponds to the JSON property `role`
@@ -148,8 +132,8 @@ module Google
         # @return [String]
         attr_accessor :role_permission
       
-        # The relevance of the permission's existence, or nonexistence, in the role
+        # The relevance of the permission's existence, or nonexistence, in the role to
-        # to the overall determination for the entire policy.
+        # the overall determination for the entire policy.
         # Corresponds to the JSON property `rolePermissionRelevance`
         # @return [String]
         attr_accessor :role_permission_relevance
@@ -196,110 +180,70 @@ module Google
         end
       end
       
-      # Details about how a specific IAM Policy contributed
+      # Details about how a specific IAM Policy contributed to the access check.
-      # to the access check.
       class GoogleCloudPolicytroubleshooterV1betaExplainedPolicy
         include Google::Apis::Core::Hashable
       
         # Indicates whether _this policy_ provides the specified permission to the
-        # specified member for the specified resource.
+        # specified member for the specified resource. This field does _not_ indicate
-        # This field does _not_ indicate whether the member actually has the
+        # whether the member actually has the permission for the resource. There might
-        # permission for the resource. There might be another policy that overrides
+        # be another policy that overrides this policy. To determine whether the member
-        # this policy. To determine whether the member actually has the permission,
+        # actually has the permission, use the `access` field in the
-        # use the `access` field in the
         # TroubleshootIamPolicyResponse.
         # Corresponds to the JSON property `access`
         # @return [String]
         attr_accessor :access
       
-        # Details about how each binding in the policy affects the member's ability,
+        # Details about how each binding in the policy affects the member's ability, or
-        # or inability, to use the permission for the resource.
+        # inability, to use the permission for the resource. If the sender of the
-        # If the sender of the request does not have access to the policy, this field
+        # request does not have access to the policy, this field is omitted.
-        # is omitted.
         # Corresponds to the JSON property `bindingExplanations`
         # @return [Array<Google::Apis::PolicytroubleshooterV1beta::GoogleCloudPolicytroubleshooterV1betaBindingExplanation>]
         attr_accessor :binding_explanations
       
-        # The full resource name that identifies the resource. For example,
+        # The full resource name that identifies the resource. For example, `//compute.
-        # `//compute.googleapis.com/projects/my-project/zones/us-central1-a/instances/my-
+        # googleapis.com/projects/my-project/zones/us-central1-a/instances/my-instance`.
-        # instance`.
+        # If the sender of the request does not have access to the policy, this field is
-        # If the sender of the request does not have access to the policy, this field
+        # omitted. For examples of full resource names for Google Cloud services, see
-        # is omitted.
-        # For examples of full resource names for Google Cloud services, see
         # https://cloud.google.com/iam/help/troubleshooter/full-resource-names.
         # Corresponds to the JSON property `fullResourceName`
         # @return [String]
         attr_accessor :full_resource_name
       
         # An Identity and Access Management (IAM) policy, which specifies access
-        # controls for Google Cloud resources.
+        # controls for Google Cloud resources. A `Policy` is a collection of `bindings`.
-        # A `Policy` is a collection of `bindings`. A `binding` binds one or more
+        # A `binding` binds one or more `members` to a single `role`. Members can be
-        # `members` to a single `role`. Members can be user accounts, service accounts,
+        # user accounts, service accounts, Google groups, and domains (such as G Suite).
-        # Google groups, and domains (such as G Suite). A `role` is a named list of
+        # A `role` is a named list of permissions; each `role` can be an IAM predefined
-        # permissions; each `role` can be an IAM predefined role or a user-created
+        # role or a user-created custom role. For some types of Google Cloud resources,
-        # custom role.
+        # a `binding` can also specify a `condition`, which is a logical expression that
-        # For some types of Google Cloud resources, a `binding` can also specify a
+        # allows access to a resource only if the expression evaluates to `true`. A
-        # `condition`, which is a logical expression that allows access to a resource
+        # condition can add constraints based on attributes of the request, the resource,
-        # only if the expression evaluates to `true`. A condition can add constraints
+        # or both. To learn which resources support conditions in their IAM policies,
-        # based on attributes of the request, the resource, or both. To learn which
+        # see the [IAM documentation](https://cloud.google.com/iam/help/conditions/
-        # resources support conditions in their IAM policies, see the
+        # resource-policies). **JSON example:** ` "bindings": [ ` "role": "roles/
-        # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-
+        # resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", "
-        # policies).
+        # group:admins@example.com", "domain:google.com", "serviceAccount:my-project-id@
-        # **JSON example:**
+        # appspot.gserviceaccount.com" ] `, ` "role": "roles/resourcemanager.
-        # `
+        # organizationViewer", "members": [ "user:eve@example.com" ], "condition": ` "
-        # "bindings": [
+        # title": "expirable access", "description": "Does not grant access after Sep
-        # `
+        # 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", `
-        # "role": "roles/resourcemanager.organizationAdmin",
+        # ` ], "etag": "BwWWja0YfJA=", "version": 3 ` **YAML example:** bindings: -
-        # "members": [
+        # members: - user:mike@example.com - group:admins@example.com - domain:google.
-        # "user:mike@example.com",
+        # com - serviceAccount:my-project-id@appspot.gserviceaccount.com role: roles/
-        # "group:admins@example.com",
+        # resourcemanager.organizationAdmin - members: - user:eve@example.com role:
-        # "domain:google.com",
+        # roles/resourcemanager.organizationViewer condition: title: expirable access
-        # "serviceAccount:my-project-id@appspot.gserviceaccount.com"
+        # description: Does not grant access after Sep 2020 expression: request.time <
-        # ]
+        # timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: 3 For a
-        # `,
+        # description of IAM and its features, see the [IAM documentation](https://cloud.
-        # `
+        # google.com/iam/docs/).
-        # "role": "roles/resourcemanager.organizationViewer",
-        # "members": [
-        # "user:eve@example.com"
-        # ],
-        # "condition": `
-        # "title": "expirable access",
-        # "description": "Does not grant access after Sep 2020",
-        # "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')
-        # ",
-        # `
-        # `
-        # ],
-        # "etag": "BwWWja0YfJA=",
-        # "version": 3
-        # `
-        # **YAML example:**
-        # bindings:
-        # - members:
-        # - user:mike@example.com
-        # - group:admins@example.com
-        # - domain:google.com
-        # - serviceAccount:my-project-id@appspot.gserviceaccount.com
-        # role: roles/resourcemanager.organizationAdmin
-        # - members:
-        # - user:eve@example.com
-        # role: roles/resourcemanager.organizationViewer
-        # condition:
-        # title: expirable access
-        # description: Does not grant access after Sep 2020
-        # expression: request.time < timestamp('2020-10-01T00:00:00.000Z')
-        # - etag: BwWWja0YfJA=
-        # - version: 3
-        # For a description of IAM and its features, see the
-        # [IAM documentation](https://cloud.google.com/iam/docs/).
         # Corresponds to the JSON property `policy`
         # @return [Google::Apis::PolicytroubleshooterV1beta::GoogleIamV1Policy]
         attr_accessor :policy
       
         # The relevance of this policy to the overall determination in the
-        # TroubleshootIamPolicyResponse.
+        # TroubleshootIamPolicyResponse. If the sender of the request does not have
-        # If the sender of the request does not have access to the policy, this field
+        # access to the policy, this field is omitted.
-        # is omitted.
         # Corresponds to the JSON property `relevance`
         # @return [String]
         attr_accessor :relevance
@@ -348,13 +292,12 @@ module Google
         attr_accessor :access
       
         # List of IAM policies that were evaluated to check the member's permissions,
-        # with annotations to indicate how each policy contributed to the final
+        # with annotations to indicate how each policy contributed to the final result.
-        # result.
         # The list of policies can include the policy for the resource itself. It can
         # also include policies that are inherited from higher levels of the resource
-        # hierarchy, including the organization, the folder, and the project.
+        # hierarchy, including the organization, the folder, and the project. To learn
-        # To learn more about the resource hierarchy, see
+        # more about the resource hierarchy, see https://cloud.google.com/iam/help/
-        # https://cloud.google.com/iam/help/resource-hierarchy.
+        # resource-hierarchy.
         # Corresponds to the JSON property `explainedPolicies`
         # @return [Array<Google::Apis::PolicytroubleshooterV1beta::GoogleCloudPolicytroubleshooterV1betaExplainedPolicy>]
         attr_accessor :explained_policies
@@ -370,53 +313,21 @@ module Google
         end
       end
       
-      # Specifies the audit configuration for a service.
+      # Specifies the audit configuration for a service. The configuration determines
-      # The configuration determines which permission types are logged, and what
+      # which permission types are logged, and what identities, if any, are exempted
-      # identities, if any, are exempted from logging.
+      # from logging. An AuditConfig must have one or more AuditLogConfigs. If there
-      # An AuditConfig must have one or more AuditLogConfigs.
+      # are AuditConfigs for both `allServices` and a specific service, the union of
-      # If there are AuditConfigs for both `allServices` and a specific service,
+      # the two AuditConfigs is used for that service: the log_types specified in each
-      # the union of the two AuditConfigs is used for that service: the log_types
+      # AuditConfig are enabled, and the exempted_members in each AuditLogConfig are
-      # specified in each AuditConfig are enabled, and the exempted_members in each
+      # exempted. Example Policy with multiple AuditConfigs: ` "audit_configs": [ ` "
-      # AuditLogConfig are exempted.
+      # service": "allServices", "audit_log_configs": [ ` "log_type": "DATA_READ", "
-      # Example Policy with multiple AuditConfigs:
+      # exempted_members": [ "user:jose@example.com" ] `, ` "log_type": "DATA_WRITE" `,
-      # `
+      # ` "log_type": "ADMIN_READ" ` ] `, ` "service": "sampleservice.googleapis.com",
-      # "audit_configs": [
+      # "audit_log_configs": [ ` "log_type": "DATA_READ" `, ` "log_type": "DATA_WRITE"
-      # `
+      # , "exempted_members": [ "user:aliya@example.com" ] ` ] ` ] ` For sampleservice,
-      # "service": "allServices",
+      # this policy enables DATA_READ, DATA_WRITE and ADMIN_READ logging. It also
-      # "audit_log_configs": [
+      # exempts jose@example.com from DATA_READ logging, and aliya@example.com from
-      # `
+      # DATA_WRITE logging.
-      # "log_type": "DATA_READ",
-      # "exempted_members": [
-      # "user:jose@example.com"
-      # ]
-      # `,
-      # `
-      # "log_type": "DATA_WRITE"
-      # `,
-      # `
-      # "log_type": "ADMIN_READ"
-      # `
-      # ]
-      # `,
-      # `
-      # "service": "sampleservice.googleapis.com",
-      # "audit_log_configs": [
-      # `
-      # "log_type": "DATA_READ"
-      # `,
-      # `
-      # "log_type": "DATA_WRITE",
-      # "exempted_members": [
-      # "user:aliya@example.com"
-      # ]
-      # `
-      # ]
-      # `
-      # ]
-      # `
-      # For sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ
-      # logging. It also exempts jose@example.com from DATA_READ logging, and
-      # aliya@example.com from DATA_WRITE logging.
       class GoogleIamV1AuditConfig
         include Google::Apis::Core::Hashable
       
@@ -425,9 +336,9 @@ module Google
         # @return [Array<Google::Apis::PolicytroubleshooterV1beta::GoogleIamV1AuditLogConfig>]
         attr_accessor :audit_log_configs
       
-        # Specifies a service that will be enabled for audit logging.
+        # Specifies a service that will be enabled for audit logging. For example, `
-        # For example, `storage.googleapis.com`, `cloudsql.googleapis.com`.
+        # storage.googleapis.com`, `cloudsql.googleapis.com`. `allServices` is a special
-        # `allServices` is a special value that covers all services.
+        # value that covers all services.
         # Corresponds to the JSON property `service`
         # @return [String]
         attr_accessor :service
@@ -443,28 +354,15 @@ module Google
         end
       end
       
-      # Provides the configuration for logging a type of permissions.
+      # Provides the configuration for logging a type of permissions. Example: ` "
-      # Example:
+      # audit_log_configs": [ ` "log_type": "DATA_READ", "exempted_members": [ "user:
-      # `
+      # jose@example.com" ] `, ` "log_type": "DATA_WRITE" ` ] ` This enables '
-      # "audit_log_configs": [
+      # DATA_READ' and 'DATA_WRITE' logging, while exempting jose@example.com from
-      # `
+      # DATA_READ logging.
-      # "log_type": "DATA_READ",
-      # "exempted_members": [
-      # "user:jose@example.com"
-      # ]
-      # `,
-      # `
-      # "log_type": "DATA_WRITE"
-      # `
-      # ]
-      # `
-      # This enables 'DATA_READ' and 'DATA_WRITE' logging, while exempting
-      # jose@example.com from DATA_READ logging.
       class GoogleIamV1AuditLogConfig
         include Google::Apis::Core::Hashable
       
-        # Specifies the identities that do not cause logging for this type of
+        # Specifies the identities that do not cause logging for this type of permission.
-        # permission.
         # Follows the same format of Binding.members.
         # Corresponds to the JSON property `exemptedMembers`
         # @return [Array<String>]
@@ -490,69 +388,57 @@ module Google
       class GoogleIamV1Binding
         include Google::Apis::Core::Hashable
       
-        # Represents a textual expression in the Common Expression Language (CEL)
+        # Represents a textual expression in the Common Expression Language (CEL) syntax.
-        # syntax. CEL is a C-like expression language. The syntax and semantics of CEL
+        # CEL is a C-like expression language. The syntax and semantics of CEL are
-        # are documented at https://github.com/google/cel-spec.
+        # documented at https://github.com/google/cel-spec. Example (Comparison): title:
-        # Example (Comparison):
+        # "Summary size limit" description: "Determines if a summary is less than 100
-        # title: "Summary size limit"
+        # chars" expression: "document.summary.size() < 100" Example (Equality): title: "
-        # description: "Determines if a summary is less than 100 chars"
+        # Requestor is owner" description: "Determines if requestor is the document
-        # expression: "document.summary.size() < 100"
+        # owner" expression: "document.owner == request.auth.claims.email" Example (
-        # Example (Equality):
+        # Logic): title: "Public documents" description: "Determine whether the document
-        # title: "Requestor is owner"
+        # should be publicly visible" expression: "document.type != 'private' &&
-        # description: "Determines if requestor is the document owner"
+        # document.type != 'internal'" Example (Data Manipulation): title: "Notification
-        # expression: "document.owner == request.auth.claims.email"
+        # string" description: "Create a notification string with a timestamp."
-        # Example (Logic):
+        # expression: "'New message received at ' + string(document.create_time)" The
-        # title: "Public documents"
+        # exact variables and functions that may be referenced within an expression are
-        # description: "Determine whether the document should be publicly visible"
+        # determined by the service that evaluates it. See the service documentation for
-        # expression: "document.type != 'private' && document.type != 'internal'"
+        # additional information.
-        # Example (Data Manipulation):
-        # title: "Notification string"
-        # description: "Create a notification string with a timestamp."
-        # expression: "'New message received at ' + string(document.create_time)"
-        # The exact variables and functions that may be referenced within an expression
-        # are determined by the service that evaluates it. See the service
-        # documentation for additional information.
         # Corresponds to the JSON property `condition`
         # @return [Google::Apis::PolicytroubleshooterV1beta::GoogleTypeExpr]
         attr_accessor :condition
       
-        # Specifies the identities requesting access for a Cloud Platform resource.
+        # Specifies the identities requesting access for a Cloud Platform resource. `
-        # `members` can have the following values:
+        # members` can have the following values: * `allUsers`: A special identifier
-        # * `allUsers`: A special identifier that represents anyone who is
+        # that represents anyone who is on the internet; with or without a Google
-        # on the internet; with or without a Google account.
+        # account. * `allAuthenticatedUsers`: A special identifier that represents
-        # * `allAuthenticatedUsers`: A special identifier that represents anyone
+        # anyone who is authenticated with a Google account or a service account. * `
-        # who is authenticated with a Google account or a service account.
+        # user:`emailid``: An email address that represents a specific Google account.
-        # * `user:`emailid``: An email address that represents a specific Google
+        # For example, `alice@example.com` . * `serviceAccount:`emailid``: An email
-        # account. For example, `alice@example.com` .
+        # address that represents a service account. For example, `my-other-app@appspot.
-        # * `serviceAccount:`emailid``: An email address that represents a service
+        # gserviceaccount.com`. * `group:`emailid``: An email address that represents a
-        # account. For example, `my-other-app@appspot.gserviceaccount.com`.
+        # Google group. For example, `admins@example.com`. * `deleted:user:`emailid`?uid=
-        # * `group:`emailid``: An email address that represents a Google group.
+        # `uniqueid``: An email address (plus unique identifier) representing a user
-        # For example, `admins@example.com`.
+        # that has been recently deleted. For example, `alice@example.com?uid=
-        # * `deleted:user:`emailid`?uid=`uniqueid``: An email address (plus unique
+        # 123456789012345678901`. If the user is recovered, this value reverts to `user:`
-        # identifier) representing a user that has been recently deleted. For
+        # emailid`` and the recovered user retains the role in the binding. * `deleted:
-        # example, `alice@example.com?uid=123456789012345678901`. If the user is
+        # serviceAccount:`emailid`?uid=`uniqueid``: An email address (plus unique
-        # recovered, this value reverts to `user:`emailid`` and the recovered user
+        # identifier) representing a service account that has been recently deleted. For
-        # retains the role in the binding.
+        # example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`.
-        # * `deleted:serviceAccount:`emailid`?uid=`uniqueid``: An email address (plus
+        # If the service account is undeleted, this value reverts to `serviceAccount:`
-        # unique identifier) representing a service account that has been recently
+        # emailid`` and the undeleted service account retains the role in the binding. *
-        # deleted. For example,
+        # `deleted:group:`emailid`?uid=`uniqueid``: An email address (plus unique
-        # `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`.
+        # identifier) representing a Google group that has been recently deleted. For
-        # If the service account is undeleted, this value reverts to
+        # example, `admins@example.com?uid=123456789012345678901`. If the group is
-        # `serviceAccount:`emailid`` and the undeleted service account retains the
+        # recovered, this value reverts to `group:`emailid`` and the recovered group
-        # role in the binding.
+        # retains the role in the binding. * `domain:`domain``: The G Suite domain (
-        # * `deleted:group:`emailid`?uid=`uniqueid``: An email address (plus unique
+        # primary) that represents all the users of that domain. For example, `google.
-        # identifier) representing a Google group that has been recently
+        # com` or `example.com`.
-        # deleted. For example, `admins@example.com?uid=123456789012345678901`. If
-        # the group is recovered, this value reverts to `group:`emailid`` and the
-        # recovered group retains the role in the binding.
-        # * `domain:`domain``: The G Suite domain (primary) that represents all the
-        # users of that domain. For example, `google.com` or `example.com`.
         # Corresponds to the JSON property `members`
         # @return [Array<String>]
         attr_accessor :members
       
-        # Role that is assigned to `members`.
+        # Role that is assigned to `members`. For example, `roles/viewer`, `roles/editor`
-        # For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
+        # , or `roles/owner`.
         # Corresponds to the JSON property `role`
         # @return [String]
         attr_accessor :role
@@ -570,66 +456,32 @@ module Google
       end
       
       # An Identity and Access Management (IAM) policy, which specifies access
-      # controls for Google Cloud resources.
+      # controls for Google Cloud resources. A `Policy` is a collection of `bindings`.
-      # A `Policy` is a collection of `bindings`. A `binding` binds one or more
+      # A `binding` binds one or more `members` to a single `role`. Members can be
-      # `members` to a single `role`. Members can be user accounts, service accounts,
+      # user accounts, service accounts, Google groups, and domains (such as G Suite).
-      # Google groups, and domains (such as G Suite). A `role` is a named list of
+      # A `role` is a named list of permissions; each `role` can be an IAM predefined
-      # permissions; each `role` can be an IAM predefined role or a user-created
+      # role or a user-created custom role. For some types of Google Cloud resources,
-      # custom role.
+      # a `binding` can also specify a `condition`, which is a logical expression that
-      # For some types of Google Cloud resources, a `binding` can also specify a
+      # allows access to a resource only if the expression evaluates to `true`. A
-      # `condition`, which is a logical expression that allows access to a resource
+      # condition can add constraints based on attributes of the request, the resource,
-      # only if the expression evaluates to `true`. A condition can add constraints
+      # or both. To learn which resources support conditions in their IAM policies,
-      # based on attributes of the request, the resource, or both. To learn which
+      # see the [IAM documentation](https://cloud.google.com/iam/help/conditions/
-      # resources support conditions in their IAM policies, see the
+      # resource-policies). **JSON example:** ` "bindings": [ ` "role": "roles/
-      # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-
+      # resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", "
-      # policies).
+      # group:admins@example.com", "domain:google.com", "serviceAccount:my-project-id@
-      # **JSON example:**
+      # appspot.gserviceaccount.com" ] `, ` "role": "roles/resourcemanager.
-      # `
+      # organizationViewer", "members": [ "user:eve@example.com" ], "condition": ` "
-      # "bindings": [
+      # title": "expirable access", "description": "Does not grant access after Sep
-      # `
+      # 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", `
-      # "role": "roles/resourcemanager.organizationAdmin",
+      # ` ], "etag": "BwWWja0YfJA=", "version": 3 ` **YAML example:** bindings: -
-      # "members": [
+      # members: - user:mike@example.com - group:admins@example.com - domain:google.
-      # "user:mike@example.com",
+      # com - serviceAccount:my-project-id@appspot.gserviceaccount.com role: roles/
-      # "group:admins@example.com",
+      # resourcemanager.organizationAdmin - members: - user:eve@example.com role:
-      # "domain:google.com",
+      # roles/resourcemanager.organizationViewer condition: title: expirable access
-      # "serviceAccount:my-project-id@appspot.gserviceaccount.com"
+      # description: Does not grant access after Sep 2020 expression: request.time <
-      # ]
+      # timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: 3 For a
-      # `,
+      # description of IAM and its features, see the [IAM documentation](https://cloud.
-      # `
+      # google.com/iam/docs/).
-      # "role": "roles/resourcemanager.organizationViewer",
-      # "members": [
-      # "user:eve@example.com"
-      # ],
-      # "condition": `
-      # "title": "expirable access",
-      # "description": "Does not grant access after Sep 2020",
-      # "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')
-      # ",
-      # `
-      # `
-      # ],
-      # "etag": "BwWWja0YfJA=",
-      # "version": 3
-      # `
-      # **YAML example:**
-      # bindings:
-      # - members:
-      # - user:mike@example.com
-      # - group:admins@example.com
-      # - domain:google.com
-      # - serviceAccount:my-project-id@appspot.gserviceaccount.com
-      # role: roles/resourcemanager.organizationAdmin
-      # - members:
-      # - user:eve@example.com
-      # role: roles/resourcemanager.organizationViewer
-      # condition:
-      # title: expirable access
-      # description: Does not grant access after Sep 2020
-      # expression: request.time < timestamp('2020-10-01T00:00:00.000Z')
-      # - etag: BwWWja0YfJA=
-      # - version: 3
-      # For a description of IAM and its features, see the
-      # [IAM documentation](https://cloud.google.com/iam/docs/).
       class GoogleIamV1Policy
         include Google::Apis::Core::Hashable
       
@@ -638,48 +490,44 @@ module Google
         # @return [Array<Google::Apis::PolicytroubleshooterV1beta::GoogleIamV1AuditConfig>]
         attr_accessor :audit_configs
       
-        # Associates a list of `members` to a `role`. Optionally, may specify a
+        # Associates a list of `members` to a `role`. Optionally, may specify a `
-        # `condition` that determines how and when the `bindings` are applied. Each
+        # condition` that determines how and when the `bindings` are applied. Each of
-        # of the `bindings` must contain at least one member.
+        # the `bindings` must contain at least one member.
         # Corresponds to the JSON property `bindings`
         # @return [Array<Google::Apis::PolicytroubleshooterV1beta::GoogleIamV1Binding>]
         attr_accessor :bindings
       
-        # `etag` is used for optimistic concurrency control as a way to help
+        # `etag` is used for optimistic concurrency control as a way to help prevent
-        # prevent simultaneous updates of a policy from overwriting each other.
+        # simultaneous updates of a policy from overwriting each other. It is strongly
-        # It is strongly suggested that systems make use of the `etag` in the
+        # suggested that systems make use of the `etag` in the read-modify-write cycle
-        # read-modify-write cycle to perform policy updates in order to avoid race
+        # to perform policy updates in order to avoid race conditions: An `etag` is
-        # conditions: An `etag` is returned in the response to `getIamPolicy`, and
+        # returned in the response to `getIamPolicy`, and systems are expected to put
-        # systems are expected to put that etag in the request to `setIamPolicy` to
+        # that etag in the request to `setIamPolicy` to ensure that their change will be
-        # ensure that their change will be applied to the same version of the policy.
+        # applied to the same version of the policy. **Important:** If you use IAM
-        # **Important:** If you use IAM Conditions, you must include the `etag` field
+        # Conditions, you must include the `etag` field whenever you call `setIamPolicy`.
-        # whenever you call `setIamPolicy`. If you omit this field, then IAM allows
+        # If you omit this field, then IAM allows you to overwrite a version `3` policy
-        # you to overwrite a version `3` policy with a version `1` policy, and all of
+        # with a version `1` policy, and all of the conditions in the version `3` policy
-        # the conditions in the version `3` policy are lost.
+        # are lost.
         # Corresponds to the JSON property `etag`
         # NOTE: Values are automatically base64 encoded/decoded in the client library.
         # @return [String]
         attr_accessor :etag
       
-        # Specifies the format of the policy.
+        # Specifies the format of the policy. Valid values are `0`, `1`, and `3`.
-        # Valid values are `0`, `1`, and `3`. Requests that specify an invalid value
+        # Requests that specify an invalid value are rejected. Any operation that
-        # are rejected.
+        # affects conditional role bindings must specify version `3`. This requirement
-        # Any operation that affects conditional role bindings must specify version
+        # applies to the following operations: * Getting a policy that includes a
-        # `3`. This requirement applies to the following operations:
+        # conditional role binding * Adding a conditional role binding to a policy *
-        # * Getting a policy that includes a conditional role binding
+        # Changing a conditional role binding in a policy * Removing any role binding,
-        # * Adding a conditional role binding to a policy
+        # with or without a condition, from a policy that includes conditions **
-        # * Changing a conditional role binding in a policy
+        # Important:** If you use IAM Conditions, you must include the `etag` field
-        # * Removing any role binding, with or without a condition, from a policy
+        # whenever you call `setIamPolicy`. If you omit this field, then IAM allows you
-        # that includes conditions
+        # to overwrite a version `3` policy with a version `1` policy, and all of the
-        # **Important:** If you use IAM Conditions, you must include the `etag` field
+        # conditions in the version `3` policy are lost. If a policy does not include
-        # whenever you call `setIamPolicy`. If you omit this field, then IAM allows
+        # any conditions, operations on that policy may specify any valid version or
-        # you to overwrite a version `3` policy with a version `1` policy, and all of
+        # leave the field unset. To learn which resources support conditions in their
-        # the conditions in the version `3` policy are lost.
+        # IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/
-        # If a policy does not include any conditions, operations on that policy may
+        # conditions/resource-policies).
-        # specify any valid version or leave the field unset.
-        # To learn which resources support conditions in their IAM policies, see the
-        # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-
-        # policies).
         # Corresponds to the JSON property `version`
         # @return [Fixnum]
         attr_accessor :version
@@ -697,52 +545,43 @@ module Google
         end
       end
       
-      # Represents a textual expression in the Common Expression Language (CEL)
+      # Represents a textual expression in the Common Expression Language (CEL) syntax.
-      # syntax. CEL is a C-like expression language. The syntax and semantics of CEL
+      # CEL is a C-like expression language. The syntax and semantics of CEL are
-      # are documented at https://github.com/google/cel-spec.
+      # documented at https://github.com/google/cel-spec. Example (Comparison): title:
-      # Example (Comparison):
+      # "Summary size limit" description: "Determines if a summary is less than 100
-      # title: "Summary size limit"
+      # chars" expression: "document.summary.size() < 100" Example (Equality): title: "
-      # description: "Determines if a summary is less than 100 chars"
+      # Requestor is owner" description: "Determines if requestor is the document
-      # expression: "document.summary.size() < 100"
+      # owner" expression: "document.owner == request.auth.claims.email" Example (
-      # Example (Equality):
+      # Logic): title: "Public documents" description: "Determine whether the document
-      # title: "Requestor is owner"
+      # should be publicly visible" expression: "document.type != 'private' &&
-      # description: "Determines if requestor is the document owner"
+      # document.type != 'internal'" Example (Data Manipulation): title: "Notification
-      # expression: "document.owner == request.auth.claims.email"
+      # string" description: "Create a notification string with a timestamp."
-      # Example (Logic):
+      # expression: "'New message received at ' + string(document.create_time)" The
-      # title: "Public documents"
+      # exact variables and functions that may be referenced within an expression are
-      # description: "Determine whether the document should be publicly visible"
+      # determined by the service that evaluates it. See the service documentation for
-      # expression: "document.type != 'private' && document.type != 'internal'"
+      # additional information.
-      # Example (Data Manipulation):
-      # title: "Notification string"
-      # description: "Create a notification string with a timestamp."
-      # expression: "'New message received at ' + string(document.create_time)"
-      # The exact variables and functions that may be referenced within an expression
-      # are determined by the service that evaluates it. See the service
-      # documentation for additional information.
       class GoogleTypeExpr
         include Google::Apis::Core::Hashable
       
-        # Optional. Description of the expression. This is a longer text which
+        # Optional. Description of the expression. This is a longer text which describes
-        # describes the expression, e.g. when hovered over it in a UI.
+        # the expression, e.g. when hovered over it in a UI.
         # Corresponds to the JSON property `description`
         # @return [String]
         attr_accessor :description
       
-        # Textual representation of an expression in Common Expression Language
+        # Textual representation of an expression in Common Expression Language syntax.
-        # syntax.
         # Corresponds to the JSON property `expression`
         # @return [String]
         attr_accessor :expression
       
-        # Optional. String indicating the location of the expression for error
+        # Optional. String indicating the location of the expression for error reporting,
-        # reporting, e.g. a file name and a position in the file.
+        # e.g. a file name and a position in the file.
         # Corresponds to the JSON property `location`
         # @return [String]
         attr_accessor :location
       
-        # Optional. Title for the expression, i.e. a short string describing
+        # Optional. Title for the expression, i.e. a short string describing its purpose.
-        # its purpose. This can be used e.g. in UIs which allow to enter the
+        # This can be used e.g. in UIs which allow to enter the expression.
-        # expression.
         # Corresponds to the JSON property `title`
         # @return [String]
         attr_accessor :title

generated/google/apis/policytroubleshooter_v1beta/service.rb

@@ -47,8 +47,8 @@ module Google
           @batch_path = 'batch'
         end
         
-        # Checks whether a member has a specific permission for a specific resource,
+        # Checks whether a member has a specific permission for a specific resource, and
-        # and explains why the member does or does not have that permission.
+        # explains why the member does or does not have that permission.
         # @param [Google::Apis::PolicytroubleshooterV1beta::GoogleCloudPolicytroubleshooterV1betaTroubleshootIamPolicyRequest] google_cloud_policytroubleshooter_v1beta_troubleshoot_iam_policy_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.

generated/google/apis/recommender_v1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/recommender/docs/
     module RecommenderV1
       VERSION = 'V1'
-      REVISION = '20200704'
+      REVISION = '20200801'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

generated/google/apis/recommender_v1/classes.rb

@@ -87,8 +87,8 @@ module Google
         # @return [String]
         attr_accessor :category
       
-        # A struct of custom fields to explain the insight.
+        # A struct of custom fields to explain the insight. Example: "
-        # Example: "grantedPermissionsCount": "1000"
+        # grantedPermissionsCount": "1000"
         # Corresponds to the JSON property `content`
         # @return [Hash<String,Object>]
         attr_accessor :content
@@ -99,8 +99,7 @@ module Google
         # @return [String]
         attr_accessor :description
       
-        # Fingerprint of the Insight. Provides optimistic locking when updating
+        # Fingerprint of the Insight. Provides optimistic locking when updating states.
-        # states.
         # Corresponds to the JSON property `etag`
         # @return [String]
         attr_accessor :etag
@@ -120,9 +119,9 @@ module Google
         # @return [String]
         attr_accessor :name
       
-        # Observation period that led to the insight. The source data used to
+        # Observation period that led to the insight. The source data used to generate
-        # generate the insight ends at last_refresh_time and begins at
+        # the insight ends at last_refresh_time and begins at (last_refresh_time -
-        # (last_refresh_time - observation_period).
+        # observation_period).
         # Corresponds to the JSON property `observationPeriod`
         # @return [String]
         attr_accessor :observation_period
@@ -161,9 +160,8 @@ module Google
       class GoogleCloudRecommenderV1InsightRecommendationReference
         include Google::Apis::Core::Hashable
       
-        # Recommendation resource name, e.g.
+        # Recommendation resource name, e.g. projects/[PROJECT_NUMBER]/locations/[
-        # projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]/
+        # LOCATION]/recommenders/[RECOMMENDER_ID]/recommendations/[RECOMMENDATION_ID]
-        # recommendations/[RECOMMENDATION_ID]
         # Corresponds to the JSON property `recommendation`
         # @return [String]
         attr_accessor :recommendation
@@ -264,9 +262,8 @@ module Google
         # @return [String]
         attr_accessor :etag
       
-        # Optional. State properties user wish to include with this state.  Full replace
+        # Optional. State properties user wish to include with this state. Full replace
-        # of the
+        # of the current state_metadata.
-        # current state_metadata.
         # Corresponds to the JSON property `stateMetadata`
         # @return [Hash<String,String>]
         attr_accessor :state_metadata
@@ -291,10 +288,9 @@ module Google
         # @return [String]
         attr_accessor :etag
       
-        # State properties to include with this state. Overwrites any existing
+        # State properties to include with this state. Overwrites any existing `
-        # `state_metadata`.
+        # state_metadata`. Keys must match the regex /^a-z0-9`0,62`$/. Values must match
-        # Keys must match the regex /^a-z0-9`0,62`$/.
+        # the regex /^[a-zA-Z0-9_./-]`0,255`$/.
-        # Values must match the regex /^[a-zA-Z0-9_./-]`0,255`$/.
         # Corresponds to the JSON property `stateMetadata`
         # @return [Hash<String,String>]
         attr_accessor :state_metadata
@@ -319,10 +315,9 @@ module Google
         # @return [String]
         attr_accessor :etag
       
-        # State properties to include with this state. Overwrites any existing
+        # State properties to include with this state. Overwrites any existing `
-        # `state_metadata`.
+        # state_metadata`. Keys must match the regex /^a-z0-9`0,62`$/. Values must match
-        # Keys must match the regex /^a-z0-9`0,62`$/.
+        # the regex /^[a-zA-Z0-9_./-]`0,255`$/.
-        # Values must match the regex /^[a-zA-Z0-9_./-]`0,255`$/.
         # Corresponds to the JSON property `stateMetadata`
         # @return [Hash<String,String>]
         attr_accessor :state_metadata
@@ -347,10 +342,9 @@ module Google
         # @return [String]
         attr_accessor :etag
       
-        # State properties to include with this state. Overwrites any existing
+        # State properties to include with this state. Overwrites any existing `
-        # `state_metadata`.
+        # state_metadata`. Keys must match the regex /^a-z0-9`0,62`$/. Values must match
-        # Keys must match the regex /^a-z0-9`0,62`$/.
+        # the regex /^[a-zA-Z0-9_./-]`0,255`$/.
-        # Values must match the regex /^[a-zA-Z0-9_./-]`0,255`$/.
         # Corresponds to the JSON property `stateMetadata`
         # @return [Hash<String,String>]
         attr_accessor :state_metadata
@@ -367,19 +361,17 @@ module Google
       end
       
       # Contains an operation for a resource loosely based on the JSON-PATCH format
-      # with support for:
+      # with support for: * Custom filters for describing partial array patch. *
-      # * Custom filters for describing partial array patch.
+      # Extended path values for describing nested arrays. * Custom fields for
-      # * Extended path values for describing nested arrays.
+      # describing the resource for which the operation is being described. * Allows
-      # * Custom fields for describing the resource for which the operation is being
+      # extension to custom operations not natively supported by RFC6902. See https://
-      # described.
+      # tools.ietf.org/html/rfc6902 for details on the original RFC.
-      # * Allows extension to custom operations not natively supported by RFC6902.
-      # See https://tools.ietf.org/html/rfc6902 for details on the original RFC.
       class GoogleCloudRecommenderV1Operation
         include Google::Apis::Core::Hashable
       
-        # Type of this operation. Contains one of 'and', 'remove', 'replace', 'move',
+        # Type of this operation. Contains one of 'and', 'remove', 'replace', 'move', '
-        # 'copy', 'test' and custom operations. This field is case-insensitive and
+        # copy', 'test' and custom operations. This field is case-insensitive and always
-        # always populated.
+        # populated.
         # Corresponds to the JSON property `action`
         # @return [String]
         attr_accessor :action
@@ -392,45 +384,34 @@ module Google
       
         # Set of filters to apply if `path` refers to array elements or nested array
         # elements in order to narrow down to a single unique element that is being
-        # tested/modified.
+        # tested/modified. This is intended to be an exact match per filter. To perform
-        # This is intended to be an exact match per filter. To perform advanced
+        # advanced matching, use path_value_matchers. * Example: ` "/versions/*/name" : "
-        # matching, use path_value_matchers.
+        # it-123" "/versions/*/targetSize/percent": 20 ` * Example: ` "/bindings/*/role":
-        # * Example: `
+        # "roles/admin" "/bindings/*/condition" : null ` * Example: ` "/bindings/*/role"
-        # "/versions/*/name" : "it-123"
+        # : "roles/admin" "/bindings/*/members/*" : ["x@google.com", "y@google.com"] `
-        # "/versions/*/targetSize/percent": 20
+        # When both path_filters and path_value_matchers are set, an implicit AND must
-        # `
+        # be performed.
-        # * Example: `
-        # "/bindings/*/role": "roles/admin"
-        # "/bindings/*/condition" : null
-        # `
-        # * Example: `
-        # "/bindings/*/role": "roles/admin"
-        # "/bindings/*/members/*" : ["x@google.com", "y@google.com"]
-        # `
-        # When both path_filters and path_value_matchers are set, an implicit AND
-        # must be performed.
         # Corresponds to the JSON property `pathFilters`
         # @return [Hash<String,Object>]
         attr_accessor :path_filters
       
-        # Similar to path_filters, this contains set of filters to apply if `path`
+        # Similar to path_filters, this contains set of filters to apply if `path` field
-        # field referes to array elements. This is meant to support value matching
+        # referes to array elements. This is meant to support value matching beyond
-        # beyond exact match. To perform exact match, use path_filters.
+        # exact match. To perform exact match, use path_filters. When both path_filters
-        # When both path_filters and path_value_matchers are set, an implicit AND
+        # and path_value_matchers are set, an implicit AND must be performed.
-        # must be performed.
         # Corresponds to the JSON property `pathValueMatchers`
         # @return [Hash<String,Google::Apis::RecommenderV1::GoogleCloudRecommenderV1ValueMatcher>]
         attr_accessor :path_value_matchers
       
-        # Contains the fully qualified resource name. This field is always populated.
+        # Contains the fully qualified resource name. This field is always populated. ex:
-        # ex: //cloudresourcemanager.googleapis.com/projects/foo.
+        # //cloudresourcemanager.googleapis.com/projects/foo.
         # Corresponds to the JSON property `resource`
         # @return [String]
         attr_accessor :resource
       
         # Type of GCP resource being modified/tested. This field is always populated.
-        # Example: cloudresourcemanager.googleapis.com/Project,
+        # Example: cloudresourcemanager.googleapis.com/Project, compute.googleapis.com/
-        # compute.googleapis.com/Instance
+        # Instance
         # Corresponds to the JSON property `resourceType`
         # @return [String]
         attr_accessor :resource_type
@@ -441,18 +422,17 @@ module Google
         # @return [String]
         attr_accessor :source_path
       
-        # Can be set with action 'copy' to copy resource configuration across
+        # Can be set with action 'copy' to copy resource configuration across different
-        # different resources of the same type. Example: A resource clone can be
+        # resources of the same type. Example: A resource clone can be done via action =
-        # done via action = 'copy', path = "/", from = "/",
+        # 'copy', path = "/", from = "/", source_resource = and resource_name = . This
-        # source_resource = <source> and resource_name = <target>.
+        # field is empty for all other values of `action`.
-        # This field is empty for all other values of `action`.
         # Corresponds to the JSON property `sourceResource`
         # @return [String]
         attr_accessor :source_resource
       
-        # Value for the `path` field. Will be set for actions:'add'/'replace'.
+        # Value for the `path` field. Will be set for actions:'add'/'replace'. Maybe set
-        # Maybe set for action: 'test'. Either this or `value_matcher` will be set
+        # for action: 'test'. Either this or `value_matcher` will be set for 'test'
-        # for 'test' operation. An exact match must be performed.
+        # operation. An exact match must be performed.
         # Corresponds to the JSON property `value`
         # @return [Object]
         attr_accessor :value
@@ -507,8 +487,7 @@ module Google
         include Google::Apis::Core::Hashable
       
         # Optional set of additional impact that this recommendation may have when
-        # trying to optimize for the primary category. These may be positive
+        # trying to optimize for the primary category. These may be positive or negative.
-        # or negative.
         # Corresponds to the JSON property `additionalImpact`
         # @return [Array<Google::Apis::RecommenderV1::GoogleCloudRecommenderV1Impact>]
         attr_accessor :additional_impact
@@ -529,14 +508,14 @@ module Google
         # @return [String]
         attr_accessor :description
       
-        # Fingerprint of the Recommendation. Provides optimistic locking when
+        # Fingerprint of the Recommendation. Provides optimistic locking when updating
-        # updating states.
+        # states.
         # Corresponds to the JSON property `etag`
         # @return [String]
         attr_accessor :etag
       
-        # Last time this recommendation was refreshed by the system that created it
+        # Last time this recommendation was refreshed by the system that created it in
-        # in the first place.
+        # the first place.
         # Corresponds to the JSON property `lastRefreshTime`
         # @return [String]
         attr_accessor :last_refresh_time
@@ -551,14 +530,13 @@ module Google
         # @return [Google::Apis::RecommenderV1::GoogleCloudRecommenderV1Impact]
         attr_accessor :primary_impact
       
-        # Contains an identifier for a subtype of recommendations produced for the
+        # Contains an identifier for a subtype of recommendations produced for the same
-        # same recommender. Subtype is a function of content and impact, meaning a
+        # recommender. Subtype is a function of content and impact, meaning a new
-        # new subtype might be added when significant changes to `content` or
+        # subtype might be added when significant changes to `content` or `
-        # `primary_impact.category` are introduced. See the Recommenders section
+        # primary_impact.category` are introduced. See the Recommenders section to see a
-        # to see a list of subtypes for a given Recommender.
+        # list of subtypes for a given Recommender. Examples: For recommender = "google.
-        # Examples:
+        # iam.policy.Recommender", recommender_subtype can be one of "REMOVE_ROLE"/"
-        # For recommender = "google.iam.policy.Recommender",
+        # REPLACE_ROLE"
-        # recommender_subtype can be one of "REMOVE_ROLE"/"REPLACE_ROLE"
         # Corresponds to the JSON property `recommenderSubtype`
         # @return [String]
         attr_accessor :recommender_subtype
@@ -591,9 +569,9 @@ module Google
       class GoogleCloudRecommenderV1RecommendationContent
         include Google::Apis::Core::Hashable
       
-        # Operations to one or more Google Cloud resources grouped in such a way
+        # Operations to one or more Google Cloud resources grouped in such a way that,
-        # that, all operations within one group are expected to be performed
+        # all operations within one group are expected to be performed atomically and in
-        # atomically and in an order.
+        # an order.
         # Corresponds to the JSON property `operationGroups`
         # @return [Array<Google::Apis::RecommenderV1::GoogleCloudRecommenderV1OperationGroup>]
         attr_accessor :operation_groups
@@ -612,9 +590,8 @@ module Google
       class GoogleCloudRecommenderV1RecommendationInsightReference
         include Google::Apis::Core::Hashable
       
-        # Insight resource name, e.g.
+        # Insight resource name, e.g. projects/[PROJECT_NUMBER]/locations/[LOCATION]/
-        # projects/[PROJECT_NUMBER]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]/
+        # insightTypes/[INSIGHT_TYPE_ID]/insights/[INSIGHT_ID]
-        # insights/[INSIGHT_ID]
         # Corresponds to the JSON property `insight`
         # @return [String]
         attr_accessor :insight
@@ -658,9 +635,9 @@ module Google
       class GoogleCloudRecommenderV1ValueMatcher
         include Google::Apis::Core::Hashable
       
-        # To be used for full regex matching. The regular expression is using the
+        # To be used for full regex matching. The regular expression is using the Google
-        # Google RE2 syntax (https://github.com/google/re2/wiki/Syntax), so to be
+        # RE2 syntax (https://github.com/google/re2/wiki/Syntax), so to be used with RE2:
-        # used with RE2::FullMatch
+        # :FullMatch
         # Corresponds to the JSON property `matchesPattern`
         # @return [String]
         attr_accessor :matches_pattern
@@ -684,18 +661,17 @@ module Google
         # @return [String]
         attr_accessor :currency_code
       
-        # Number of nano (10^-9) units of the amount.
+        # Number of nano (10^-9) units of the amount. The value must be between -999,999,
-        # The value must be between -999,999,999 and +999,999,999 inclusive.
+        # 999 and +999,999,999 inclusive. If `units` is positive, `nanos` must be
-        # If `units` is positive, `nanos` must be positive or zero.
+        # positive or zero. If `units` is zero, `nanos` can be positive, zero, or
-        # If `units` is zero, `nanos` can be positive, zero, or negative.
+        # negative. If `units` is negative, `nanos` must be negative or zero. For
-        # If `units` is negative, `nanos` must be negative or zero.
+        # example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
-        # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
         # Corresponds to the JSON property `nanos`
         # @return [Fixnum]
         attr_accessor :nanos
       
-        # The whole units of the amount.
+        # The whole units of the amount. For example if `currencyCode` is `"USD"`, then
-        # For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
+        # 1 unit is one US dollar.
         # Corresponds to the JSON property `units`
         # @return [Fixnum]
         attr_accessor :units

generated/google/apis/recommender_v1/service.rb

@@ -47,8 +47,8 @@ module Google
           @batch_path = 'batch'
         end
         
-        # Gets the requested insight. Requires the recommender.*.get IAM permission
+        # Gets the requested insight. Requires the recommender.*.get IAM permission for
-        # for the specified insight type.
+        # the specified insight type.
         # @param [String] name
         #   Required. Name of the insight.
         # @param [String] fields
@@ -81,27 +81,21 @@ module Google
         # Lists insights for a Cloud project. Requires the recommender.*.list IAM
         # permission for the specified insight type.
         # @param [String] parent
-        #   Required. The container resource on which to execute the request.
+        #   Required. The container resource on which to execute the request. Acceptable
-        #   Acceptable formats:
+        #   formats: 1. "projects/[PROJECT_NUMBER]/locations/[LOCATION]/insightTypes/[
-        #   1.
+        #   INSIGHT_TYPE_ID]", LOCATION here refers to GCP Locations: https://cloud.google.
-        #   "projects/[PROJECT_NUMBER]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]"
+        #   com/about/locations/
-        #   ,
-        #   LOCATION here refers to GCP Locations:
-        #   https://cloud.google.com/about/locations/
         # @param [String] filter
         #   Optional. Filter expression to restrict the insights returned. Supported
-        #   filter fields: state
+        #   filter fields: state Eg: `state:"DISMISSED" or state:"ACTIVE"
-        #   Eg: `state:"DISMISSED" or state:"ACTIVE"
         # @param [Fixnum] page_size
-        #   Optional. The maximum number of results to return from this request.  Non-
+        #   Optional. The maximum number of results to return from this request. Non-
-        #   positive
+        #   positive values are ignored. If not specified, the server will determine the
-        #   values are ignored. If not specified, the server will determine the number
+        #   number of results to return.
-        #   of results to return.
         # @param [String] page_token
         #   Optional. If present, retrieves the next batch of results from the preceding
-        #   call to
+        #   call to this method. `page_token` must be the value of `next_page_token` from
-        #   this method. `page_token` must be the value of `next_page_token` from the
+        #   the previous response. The values of other method parameters must be identical
-        #   previous response. The values of other method parameters must be identical
         #   to those in the previous call.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -133,11 +127,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Marks the Insight State as Accepted. Users can use this method to
+        # Marks the Insight State as Accepted. Users can use this method to indicate to
-        # indicate to the Recommender API that they have applied some action based
+        # the Recommender API that they have applied some action based on the insight.
-        # on the insight. This stops the insight content from being updated.
+        # This stops the insight content from being updated. MarkInsightAccepted can be
-        # MarkInsightAccepted can be applied to insights in ACTIVE state. Requires
+        # applied to insights in ACTIVE state. Requires the recommender.*.update IAM
-        # the recommender.*.update IAM permission for the specified insight.
+        # permission for the specified insight.
         # @param [String] name
         #   Required. Name of the insight.
         # @param [Google::Apis::RecommenderV1::GoogleCloudRecommenderV1MarkInsightAcceptedRequest] google_cloud_recommender_v1_mark_insight_accepted_request_object
@@ -170,8 +164,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets the requested recommendation. Requires the recommender.*.get
+        # Gets the requested recommendation. Requires the recommender.*.get IAM
-        # IAM permission for the specified recommender.
+        # permission for the specified recommender.
         # @param [String] name
         #   Required. Name of the recommendation.
         # @param [String] fields
@@ -201,29 +195,25 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists recommendations for a Cloud project. Requires the recommender.*.list
+        # Lists recommendations for a Cloud project. Requires the recommender.*.list IAM
-        # IAM permission for the specified recommender.
+        # permission for the specified recommender.
         # @param [String] parent
-        #   Required. The container resource on which to execute the request.
+        #   Required. The container resource on which to execute the request. Acceptable
-        #   Acceptable formats:
+        #   formats: 1. "projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[
-        #   1.
+        #   RECOMMENDER_ID]", LOCATION here refers to GCP Locations: https://cloud.google.
-        #   "projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]",
+        #   com/about/locations/
-        #   LOCATION here refers to GCP Locations:
-        #   https://cloud.google.com/about/locations/
         # @param [String] filter
-        #   Filter expression to restrict the recommendations returned. Supported
+        #   Filter expression to restrict the recommendations returned. Supported filter
-        #   filter fields: state_info.state
+        #   fields: state_info.state Eg: `state_info.state:"DISMISSED" or state_info.state:
-        #   Eg: `state_info.state:"DISMISSED" or state_info.state:"FAILED"
+        #   "FAILED"
         # @param [Fixnum] page_size
-        #   Optional. The maximum number of results to return from this request.  Non-
+        #   Optional. The maximum number of results to return from this request. Non-
-        #   positive
+        #   positive values are ignored. If not specified, the server will determine the
-        #   values are ignored. If not specified, the server will determine the number
+        #   number of results to return.
-        #   of results to return.
         # @param [String] page_token
         #   Optional. If present, retrieves the next batch of results from the preceding
-        #   call to
+        #   call to this method. `page_token` must be the value of `next_page_token` from
-        #   this method. `page_token` must be the value of `next_page_token` from the
+        #   the previous response. The values of other method parameters must be identical
-        #   previous response. The values of other method parameters must be identical
         #   to those in the previous call.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -260,9 +250,8 @@ module Google
         # recommendation themselves. This stops the recommendation content from being
         # updated. Associated insights are frozen and placed in the ACCEPTED state.
         # MarkRecommendationClaimed can be applied to recommendations in CLAIMED,
-        # SUCCEEDED, FAILED, or ACTIVE state.
+        # SUCCEEDED, FAILED, or ACTIVE state. Requires the recommender.*.update IAM
-        # Requires the recommender.*.update IAM permission for the specified
+        # permission for the specified recommender.
-        # recommender.
         # @param [String] name
         #   Required. Name of the recommendation.
         # @param [Google::Apis::RecommenderV1::GoogleCloudRecommenderV1MarkRecommendationClaimedRequest] google_cloud_recommender_v1_mark_recommendation_claimed_request_object
@@ -298,12 +287,10 @@ module Google
         # Marks the Recommendation State as Failed. Users can use this method to
         # indicate to the Recommender API that they have applied the recommendation
         # themselves, and the operation failed. This stops the recommendation content
-        # from being updated. Associated insights are frozen and placed in the
+        # from being updated. Associated insights are frozen and placed in the ACCEPTED
-        # ACCEPTED state.
+        # state. MarkRecommendationFailed can be applied to recommendations in ACTIVE,
-        # MarkRecommendationFailed can be applied to recommendations in ACTIVE,
+        # CLAIMED, SUCCEEDED, or FAILED state. Requires the recommender.*.update IAM
-        # CLAIMED, SUCCEEDED, or FAILED state.
+        # permission for the specified recommender.
-        # Requires the recommender.*.update IAM permission for the specified
-        # recommender.
         # @param [String] name
         #   Required. Name of the recommendation.
         # @param [Google::Apis::RecommenderV1::GoogleCloudRecommenderV1MarkRecommendationFailedRequest] google_cloud_recommender_v1_mark_recommendation_failed_request_object
@@ -339,12 +326,10 @@ module Google
         # Marks the Recommendation State as Succeeded. Users can use this method to
         # indicate to the Recommender API that they have applied the recommendation
         # themselves, and the operation was successful. This stops the recommendation
-        # content from being updated. Associated insights are frozen and placed in
+        # content from being updated. Associated insights are frozen and placed in the
-        # the ACCEPTED state.
+        # ACCEPTED state. MarkRecommendationSucceeded can be applied to recommendations
-        # MarkRecommendationSucceeded can be applied to recommendations in ACTIVE,
+        # in ACTIVE, CLAIMED, SUCCEEDED, or FAILED state. Requires the recommender.*.
-        # CLAIMED, SUCCEEDED, or FAILED state.
+        # update IAM permission for the specified recommender.
-        # Requires the recommender.*.update IAM permission for the specified
-        # recommender.
         # @param [String] name
         #   Required. Name of the recommendation.
         # @param [Google::Apis::RecommenderV1::GoogleCloudRecommenderV1MarkRecommendationSucceededRequest] google_cloud_recommender_v1_mark_recommendation_succeeded_request_object

generated/google/apis/recommender_v1beta1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/recommender/docs/
     module RecommenderV1beta1
       VERSION = 'V1beta1'
-      REVISION = '20200313'
+      REVISION = '20200801'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

generated/google/apis/recommender_v1beta1/classes.rb

@@ -87,8 +87,8 @@ module Google
         # @return [String]
         attr_accessor :category
       
-        # A struct of custom fields to explain the insight.
+        # A struct of custom fields to explain the insight. Example: "
-        # Example: "grantedPermissionsCount": "1000"
+        # grantedPermissionsCount": "1000"
         # Corresponds to the JSON property `content`
         # @return [Hash<String,Object>]
         attr_accessor :content
@@ -99,8 +99,7 @@ module Google
         # @return [String]
         attr_accessor :description
       
-        # Fingerprint of the Insight. Provides optimistic locking when updating
+        # Fingerprint of the Insight. Provides optimistic locking when updating states.
-        # states.
         # Corresponds to the JSON property `etag`
         # @return [String]
         attr_accessor :etag
@@ -120,9 +119,9 @@ module Google
         # @return [String]
         attr_accessor :name
       
-        # Observation period that led to the insight. The source data used to
+        # Observation period that led to the insight. The source data used to generate
-        # generate the insight ends at last_refresh_time and begins at
+        # the insight ends at last_refresh_time and begins at (last_refresh_time -
-        # (last_refresh_time - observation_period).
+        # observation_period).
         # Corresponds to the JSON property `observationPeriod`
         # @return [String]
         attr_accessor :observation_period
@@ -161,9 +160,8 @@ module Google
       class GoogleCloudRecommenderV1beta1InsightRecommendationReference
         include Google::Apis::Core::Hashable
       
-        # Recommendation resource name, e.g.
+        # Recommendation resource name, e.g. projects/[PROJECT_NUMBER]/locations/[
-        # projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]/
+        # LOCATION]/recommenders/[RECOMMENDER_ID]/recommendations/[RECOMMENDATION_ID]
-        # recommendations/[RECOMMENDATION_ID]
         # Corresponds to the JSON property `recommendation`
         # @return [String]
         attr_accessor :recommendation
@@ -264,9 +262,8 @@ module Google
         # @return [String]
         attr_accessor :etag
       
-        # Optional. State properties user wish to include with this state.  Full replace
+        # Optional. State properties user wish to include with this state. Full replace
-        # of the
+        # of the current state_metadata.
-        # current state_metadata.
         # Corresponds to the JSON property `stateMetadata`
         # @return [Hash<String,String>]
         attr_accessor :state_metadata
@@ -291,10 +288,9 @@ module Google
         # @return [String]
         attr_accessor :etag
       
-        # State properties to include with this state. Overwrites any existing
+        # State properties to include with this state. Overwrites any existing `
-        # `state_metadata`.
+        # state_metadata`. Keys must match the regex /^a-z0-9`0,62`$/. Values must match
-        # Keys must match the regex /^a-z0-9`0,62`$/.
+        # the regex /^[a-zA-Z0-9_./-]`0,255`$/.
-        # Values must match the regex /^[a-zA-Z0-9_./-]`0,255`$/.
         # Corresponds to the JSON property `stateMetadata`
         # @return [Hash<String,String>]
         attr_accessor :state_metadata
@@ -319,10 +315,9 @@ module Google
         # @return [String]
         attr_accessor :etag
       
-        # State properties to include with this state. Overwrites any existing
+        # State properties to include with this state. Overwrites any existing `
-        # `state_metadata`.
+        # state_metadata`. Keys must match the regex /^a-z0-9`0,62`$/. Values must match
-        # Keys must match the regex /^a-z0-9`0,62`$/.
+        # the regex /^[a-zA-Z0-9_./-]`0,255`$/.
-        # Values must match the regex /^[a-zA-Z0-9_./-]`0,255`$/.
         # Corresponds to the JSON property `stateMetadata`
         # @return [Hash<String,String>]
         attr_accessor :state_metadata
@@ -347,10 +342,9 @@ module Google
         # @return [String]
         attr_accessor :etag
       
-        # State properties to include with this state. Overwrites any existing
+        # State properties to include with this state. Overwrites any existing `
-        # `state_metadata`.
+        # state_metadata`. Keys must match the regex /^a-z0-9`0,62`$/. Values must match
-        # Keys must match the regex /^a-z0-9`0,62`$/.
+        # the regex /^[a-zA-Z0-9_./-]`0,255`$/.
-        # Values must match the regex /^[a-zA-Z0-9_./-]`0,255`$/.
         # Corresponds to the JSON property `stateMetadata`
         # @return [Hash<String,String>]
         attr_accessor :state_metadata
@@ -367,18 +361,16 @@ module Google
       end
       
       # Contains an operation for a resource loosely based on the JSON-PATCH format
-      # with support for:
+      # with support for: * Custom filters for describing partial array patch. *
-      # * Custom filters for describing partial array patch.
+      # Extended path values for describing nested arrays. * Custom fields for
-      # * Extended path values for describing nested arrays.
+      # describing the resource for which the operation is being described. * Allows
-      # * Custom fields for describing the resource for which the operation is being
+      # extension to custom operations not natively supported by RFC6902. See https://
-      # described.
+      # tools.ietf.org/html/rfc6902 for details on the original RFC.
-      # * Allows extension to custom operations not natively supported by RFC6902.
-      # See https://tools.ietf.org/html/rfc6902 for details on the original RFC.
       class GoogleCloudRecommenderV1beta1Operation
         include Google::Apis::Core::Hashable
       
-        # Type of this operation. Contains one of 'and', 'remove', 'replace', 'move',
+        # Type of this operation. Contains one of 'and', 'remove', 'replace', 'move', '
-        # 'copy', 'test' and 'custom' operations. This field is case-insensitive and
+        # copy', 'test' and 'custom' operations. This field is case-insensitive and
         # always populated.
         # Corresponds to the JSON property `action`
         # @return [String]
@@ -392,45 +384,34 @@ module Google
       
         # Set of filters to apply if `path` refers to array elements or nested array
         # elements in order to narrow down to a single unique element that is being
-        # tested/modified.
+        # tested/modified. This is intended to be an exact match per filter. To perform
-        # This is intended to be an exact match per filter. To perform advanced
+        # advanced matching, use path_value_matchers. * Example: ` "/versions/*/name" : "
-        # matching, use path_value_matchers.
+        # it-123" "/versions/*/targetSize/percent": 20 ` * Example: ` "/bindings/*/role":
-        # * Example: `
+        # "roles/admin" "/bindings/*/condition" : null ` * Example: ` "/bindings/*/role"
-        # "/versions/*/name" : "it-123"
+        # : "roles/admin" "/bindings/*/members/*" : ["x@google.com", "y@google.com"] `
-        # "/versions/*/targetSize/percent": 20
+        # When both path_filters and path_value_matchers are set, an implicit AND must
-        # `
+        # be performed.
-        # * Example: `
-        # "/bindings/*/role": "roles/admin"
-        # "/bindings/*/condition" : null
-        # `
-        # * Example: `
-        # "/bindings/*/role": "roles/admin"
-        # "/bindings/*/members/*" : ["x@google.com", "y@google.com"]
-        # `
-        # When both path_filters and path_value_matchers are set, an implicit AND
-        # must be performed.
         # Corresponds to the JSON property `pathFilters`
         # @return [Hash<String,Object>]
         attr_accessor :path_filters
       
-        # Similar to path_filters, this contains set of filters to apply if `path`
+        # Similar to path_filters, this contains set of filters to apply if `path` field
-        # field referes to array elements. This is meant to support value matching
+        # referes to array elements. This is meant to support value matching beyond
-        # beyond exact match. To perform exact match, use path_filters.
+        # exact match. To perform exact match, use path_filters. When both path_filters
-        # When both path_filters and path_value_matchers are set, an implicit AND
+        # and path_value_matchers are set, an implicit AND must be performed.
-        # must be performed.
         # Corresponds to the JSON property `pathValueMatchers`
         # @return [Hash<String,Google::Apis::RecommenderV1beta1::GoogleCloudRecommenderV1beta1ValueMatcher>]
         attr_accessor :path_value_matchers
       
-        # Contains the fully qualified resource name. This field is always populated.
+        # Contains the fully qualified resource name. This field is always populated. ex:
-        # ex: //cloudresourcemanager.googleapis.com/projects/foo.
+        # //cloudresourcemanager.googleapis.com/projects/foo.
         # Corresponds to the JSON property `resource`
         # @return [String]
         attr_accessor :resource
       
         # Type of GCP resource being modified/tested. This field is always populated.
-        # Example: cloudresourcemanager.googleapis.com/Project,
+        # Example: cloudresourcemanager.googleapis.com/Project, compute.googleapis.com/
-        # compute.googleapis.com/Instance
+        # Instance
         # Corresponds to the JSON property `resourceType`
         # @return [String]
         attr_accessor :resource_type
@@ -441,18 +422,17 @@ module Google
         # @return [String]
         attr_accessor :source_path
       
-        # Can be set with action 'copy' to copy resource configuration across
+        # Can be set with action 'copy' to copy resource configuration across different
-        # different resources of the same type. Example: A resource clone can be
+        # resources of the same type. Example: A resource clone can be done via action =
-        # done via action = 'copy', path = "/", from = "/",
+        # 'copy', path = "/", from = "/", source_resource = and resource_name = . This
-        # source_resource = <source> and resource_name = <target>.
+        # field is empty for all other values of `action`.
-        # This field is empty for all other values of `action`.
         # Corresponds to the JSON property `sourceResource`
         # @return [String]
         attr_accessor :source_resource
       
-        # Value for the `path` field. Will be set for actions:'add'/'replace'.
+        # Value for the `path` field. Will be set for actions:'add'/'replace'. Maybe set
-        # Maybe set for action: 'test'. Either this or `value_matcher` will be set
+        # for action: 'test'. Either this or `value_matcher` will be set for 'test'
-        # for 'test' operation. An exact match must be performed.
+        # operation. An exact match must be performed.
         # Corresponds to the JSON property `value`
         # @return [Object]
         attr_accessor :value
@@ -507,8 +487,7 @@ module Google
         include Google::Apis::Core::Hashable
       
         # Optional set of additional impact that this recommendation may have when
-        # trying to optimize for the primary category. These may be positive
+        # trying to optimize for the primary category. These may be positive or negative.
-        # or negative.
         # Corresponds to the JSON property `additionalImpact`
         # @return [Array<Google::Apis::RecommenderV1beta1::GoogleCloudRecommenderV1beta1Impact>]
         attr_accessor :additional_impact
@@ -529,14 +508,14 @@ module Google
         # @return [String]
         attr_accessor :description
       
-        # Fingerprint of the Recommendation. Provides optimistic locking when
+        # Fingerprint of the Recommendation. Provides optimistic locking when updating
-        # updating states.
+        # states.
         # Corresponds to the JSON property `etag`
         # @return [String]
         attr_accessor :etag
       
-        # Last time this recommendation was refreshed by the system that created it
+        # Last time this recommendation was refreshed by the system that created it in
-        # in the first place.
+        # the first place.
         # Corresponds to the JSON property `lastRefreshTime`
         # @return [String]
         attr_accessor :last_refresh_time
@@ -551,14 +530,13 @@ module Google
         # @return [Google::Apis::RecommenderV1beta1::GoogleCloudRecommenderV1beta1Impact]
         attr_accessor :primary_impact
       
-        # Contains an identifier for a subtype of recommendations produced for the
+        # Contains an identifier for a subtype of recommendations produced for the same
-        # same recommender. Subtype is a function of content and impact, meaning a
+        # recommender. Subtype is a function of content and impact, meaning a new
-        # new subtype might be added when significant changes to `content` or
+        # subtype might be added when significant changes to `content` or `
-        # `primary_impact.category` are introduced. See the Recommenders section
+        # primary_impact.category` are introduced. See the Recommenders section to see a
-        # to see a list of subtypes for a given Recommender.
+        # list of subtypes for a given Recommender. Examples: For recommender = "google.
-        # Examples:
+        # iam.policy.Recommender", recommender_subtype can be one of "REMOVE_ROLE"/"
-        # For recommender = "google.iam.policy.Recommender",
+        # REPLACE_ROLE"
-        # recommender_subtype can be one of "REMOVE_ROLE"/"REPLACE_ROLE"
         # Corresponds to the JSON property `recommenderSubtype`
         # @return [String]
         attr_accessor :recommender_subtype
@@ -591,9 +569,9 @@ module Google
       class GoogleCloudRecommenderV1beta1RecommendationContent
         include Google::Apis::Core::Hashable
       
-        # Operations to one or more Google Cloud resources grouped in such a way
+        # Operations to one or more Google Cloud resources grouped in such a way that,
-        # that, all operations within one group are expected to be performed
+        # all operations within one group are expected to be performed atomically and in
-        # atomically and in an order.
+        # an order.
         # Corresponds to the JSON property `operationGroups`
         # @return [Array<Google::Apis::RecommenderV1beta1::GoogleCloudRecommenderV1beta1OperationGroup>]
         attr_accessor :operation_groups
@@ -612,9 +590,8 @@ module Google
       class GoogleCloudRecommenderV1beta1RecommendationInsightReference
         include Google::Apis::Core::Hashable
       
-        # Insight resource name, e.g.
+        # Insight resource name, e.g. projects/[PROJECT_NUMBER]/locations/[LOCATION]/
-        # projects/[PROJECT_NUMBER]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]/
+        # insightTypes/[INSIGHT_TYPE_ID]/insights/[INSIGHT_ID]
-        # insights/[INSIGHT_ID]
         # Corresponds to the JSON property `insight`
         # @return [String]
         attr_accessor :insight
@@ -658,9 +635,9 @@ module Google
       class GoogleCloudRecommenderV1beta1ValueMatcher
         include Google::Apis::Core::Hashable
       
-        # To be used for full regex matching. The regular expression is using the
+        # To be used for full regex matching. The regular expression is using the Google
-        # Google RE2 syntax (https://github.com/google/re2/wiki/Syntax), so to be
+        # RE2 syntax (https://github.com/google/re2/wiki/Syntax), so to be used with RE2:
-        # used with RE2::FullMatch
+        # :FullMatch
         # Corresponds to the JSON property `matchesPattern`
         # @return [String]
         attr_accessor :matches_pattern
@@ -684,18 +661,17 @@ module Google
         # @return [String]
         attr_accessor :currency_code
       
-        # Number of nano (10^-9) units of the amount.
+        # Number of nano (10^-9) units of the amount. The value must be between -999,999,
-        # The value must be between -999,999,999 and +999,999,999 inclusive.
+        # 999 and +999,999,999 inclusive. If `units` is positive, `nanos` must be
-        # If `units` is positive, `nanos` must be positive or zero.
+        # positive or zero. If `units` is zero, `nanos` can be positive, zero, or
-        # If `units` is zero, `nanos` can be positive, zero, or negative.
+        # negative. If `units` is negative, `nanos` must be negative or zero. For
-        # If `units` is negative, `nanos` must be negative or zero.
+        # example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
-        # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
         # Corresponds to the JSON property `nanos`
         # @return [Fixnum]
         attr_accessor :nanos
       
-        # The whole units of the amount.
+        # The whole units of the amount. For example if `currencyCode` is `"USD"`, then
-        # For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
+        # 1 unit is one US dollar.
         # Corresponds to the JSON property `units`
         # @return [Fixnum]
         attr_accessor :units

generated/google/apis/recommender_v1beta1/service.rb

@@ -47,8 +47,8 @@ module Google
           @batch_path = 'batch'
         end
         
-        # Gets the requested insight. Requires the recommender.*.get IAM permission
+        # Gets the requested insight. Requires the recommender.*.get IAM permission for
-        # for the specified insight type.
+        # the specified insight type.
         # @param [String] name
         #   Required. Name of the insight.
         # @param [String] fields
@@ -81,27 +81,21 @@ module Google
         # Lists insights for a Cloud project. Requires the recommender.*.list IAM
         # permission for the specified insight type.
         # @param [String] parent
-        #   Required. The container resource on which to execute the request.
+        #   Required. The container resource on which to execute the request. Acceptable
-        #   Acceptable formats:
+        #   formats: 1. "projects/[PROJECT_NUMBER]/locations/[LOCATION]/insightTypes/[
-        #   1.
+        #   INSIGHT_TYPE_ID]", LOCATION here refers to GCP Locations: https://cloud.google.
-        #   "projects/[PROJECT_NUMBER]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]"
+        #   com/about/locations/
-        #   ,
-        #   LOCATION here refers to GCP Locations:
-        #   https://cloud.google.com/about/locations/
         # @param [String] filter
         #   Optional. Filter expression to restrict the insights returned. Supported
-        #   filter fields: state
+        #   filter fields: state Eg: `state:"DISMISSED" or state:"ACTIVE"
-        #   Eg: `state:"DISMISSED" or state:"ACTIVE"
         # @param [Fixnum] page_size
-        #   Optional. The maximum number of results to return from this request.  Non-
+        #   Optional. The maximum number of results to return from this request. Non-
-        #   positive
+        #   positive values are ignored. If not specified, the server will determine the
-        #   values are ignored. If not specified, the server will determine the number
+        #   number of results to return.
-        #   of results to return.
         # @param [String] page_token
         #   Optional. If present, retrieves the next batch of results from the preceding
-        #   call to
+        #   call to this method. `page_token` must be the value of `next_page_token` from
-        #   this method. `page_token` must be the value of `next_page_token` from the
+        #   the previous response. The values of other method parameters must be identical
-        #   previous response. The values of other method parameters must be identical
         #   to those in the previous call.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -133,11 +127,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Marks the Insight State as Accepted. Users can use this method to
+        # Marks the Insight State as Accepted. Users can use this method to indicate to
-        # indicate to the Recommender API that they have applied some action based
+        # the Recommender API that they have applied some action based on the insight.
-        # on the insight. This stops the insight content from being updated.
+        # This stops the insight content from being updated. MarkInsightAccepted can be
-        # MarkInsightAccepted can be applied to insights in ACTIVE state. Requires
+        # applied to insights in ACTIVE state. Requires the recommender.*.update IAM
-        # the recommender.*.update IAM permission for the specified insight.
+        # permission for the specified insight.
         # @param [String] name
         #   Required. Name of the insight.
         # @param [Google::Apis::RecommenderV1beta1::GoogleCloudRecommenderV1beta1MarkInsightAcceptedRequest] google_cloud_recommender_v1beta1_mark_insight_accepted_request_object
@@ -170,8 +164,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets the requested recommendation. Requires the recommender.*.get
+        # Gets the requested recommendation. Requires the recommender.*.get IAM
-        # IAM permission for the specified recommender.
+        # permission for the specified recommender.
         # @param [String] name
         #   Required. Name of the recommendation.
         # @param [String] fields
@@ -201,29 +195,25 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists recommendations for a Cloud project. Requires the recommender.*.list
+        # Lists recommendations for a Cloud project. Requires the recommender.*.list IAM
-        # IAM permission for the specified recommender.
+        # permission for the specified recommender.
         # @param [String] parent
-        #   Required. The container resource on which to execute the request.
+        #   Required. The container resource on which to execute the request. Acceptable
-        #   Acceptable formats:
+        #   formats: 1. "projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[
-        #   1.
+        #   RECOMMENDER_ID]", LOCATION here refers to GCP Locations: https://cloud.google.
-        #   "projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]",
+        #   com/about/locations/
-        #   LOCATION here refers to GCP Locations:
-        #   https://cloud.google.com/about/locations/
         # @param [String] filter
-        #   Filter expression to restrict the recommendations returned. Supported
+        #   Filter expression to restrict the recommendations returned. Supported filter
-        #   filter fields: state_info.state
+        #   fields: state_info.state Eg: `state_info.state:"DISMISSED" or state_info.state:
-        #   Eg: `state_info.state:"DISMISSED" or state_info.state:"FAILED"
+        #   "FAILED"
         # @param [Fixnum] page_size
-        #   Optional. The maximum number of results to return from this request.  Non-
+        #   Optional. The maximum number of results to return from this request. Non-
-        #   positive
+        #   positive values are ignored. If not specified, the server will determine the
-        #   values are ignored. If not specified, the server will determine the number
+        #   number of results to return.
-        #   of results to return.
         # @param [String] page_token
         #   Optional. If present, retrieves the next batch of results from the preceding
-        #   call to
+        #   call to this method. `page_token` must be the value of `next_page_token` from
-        #   this method. `page_token` must be the value of `next_page_token` from the
+        #   the previous response. The values of other method parameters must be identical
-        #   previous response. The values of other method parameters must be identical
         #   to those in the previous call.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -260,9 +250,8 @@ module Google
         # recommendation themselves. This stops the recommendation content from being
         # updated. Associated insights are frozen and placed in the ACCEPTED state.
         # MarkRecommendationClaimed can be applied to recommendations in CLAIMED or
-        # ACTIVE state.
+        # ACTIVE state. Requires the recommender.*.update IAM permission for the
-        # Requires the recommender.*.update IAM permission for the specified
+        # specified recommender.
-        # recommender.
         # @param [String] name
         #   Required. Name of the recommendation.
         # @param [Google::Apis::RecommenderV1beta1::GoogleCloudRecommenderV1beta1MarkRecommendationClaimedRequest] google_cloud_recommender_v1beta1_mark_recommendation_claimed_request_object
@@ -298,12 +287,10 @@ module Google
         # Marks the Recommendation State as Failed. Users can use this method to
         # indicate to the Recommender API that they have applied the recommendation
         # themselves, and the operation failed. This stops the recommendation content
-        # from being updated. Associated insights are frozen and placed in the
+        # from being updated. Associated insights are frozen and placed in the ACCEPTED
-        # ACCEPTED state.
+        # state. MarkRecommendationFailed can be applied to recommendations in ACTIVE,
-        # MarkRecommendationFailed can be applied to recommendations in ACTIVE,
+        # CLAIMED, SUCCEEDED, or FAILED state. Requires the recommender.*.update IAM
-        # CLAIMED, SUCCEEDED, or FAILED state.
+        # permission for the specified recommender.
-        # Requires the recommender.*.update IAM permission for the specified
-        # recommender.
         # @param [String] name
         #   Required. Name of the recommendation.
         # @param [Google::Apis::RecommenderV1beta1::GoogleCloudRecommenderV1beta1MarkRecommendationFailedRequest] google_cloud_recommender_v1beta1_mark_recommendation_failed_request_object
@@ -339,12 +326,10 @@ module Google
         # Marks the Recommendation State as Succeeded. Users can use this method to
         # indicate to the Recommender API that they have applied the recommendation
         # themselves, and the operation was successful. This stops the recommendation
-        # content from being updated. Associated insights are frozen and placed in
+        # content from being updated. Associated insights are frozen and placed in the
-        # the ACCEPTED state.
+        # ACCEPTED state. MarkRecommendationSucceeded can be applied to recommendations
-        # MarkRecommendationSucceeded can be applied to recommendations in ACTIVE,
+        # in ACTIVE, CLAIMED, SUCCEEDED, or FAILED state. Requires the recommender.*.
-        # CLAIMED, SUCCEEDED, or FAILED state.
+        # update IAM permission for the specified recommender.
-        # Requires the recommender.*.update IAM permission for the specified
-        # recommender.
         # @param [String] name
         #   Required. Name of the recommendation.
         # @param [Google::Apis::RecommenderV1beta1::GoogleCloudRecommenderV1beta1MarkRecommendationSucceededRequest] google_cloud_recommender_v1beta1_mark_recommendation_succeeded_request_object

generated/google/apis/runtimeconfig_v1.rb

@@ -28,7 +28,7 @@ module Google
     # @see https://cloud.google.com/deployment-manager/runtime-configurator/
     module RuntimeconfigV1
       VERSION = 'V1'
-      REVISION = '20200224'
+      REVISION = '20200803'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

generated/google/apis/runtimeconfig_v1/classes.rb

@@ -35,13 +35,11 @@ module Google
         end
       end
       
-      # A generic empty message that you can re-use to avoid defining duplicated
+      # A generic empty message that you can re-use to avoid defining duplicated empty
-      # empty messages in your APIs. A typical example is to use it as the request
+      # messages in your APIs. A typical example is to use it as the request or the
-      # or the response type of an API method. For instance:
+      # response type of an API method. For instance: service Foo ` rpc Bar(google.
-      # service Foo `
+      # protobuf.Empty) returns (google.protobuf.Empty); ` The JSON representation for
-      # rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
+      # `Empty` is empty JSON object ````.
-      # `
-      # The JSON representation for `Empty` is empty JSON object ````.
       class Empty
         include Google::Apis::Core::Hashable
       
@@ -84,47 +82,45 @@ module Google
       class Operation
         include Google::Apis::Core::Hashable
       
-        # If the value is `false`, it means the operation is still in progress.
+        # If the value is `false`, it means the operation is still in progress. If `true`
-        # If `true`, the operation is completed, and either `error` or `response` is
+        # , the operation is completed, and either `error` or `response` is available.
-        # available.
         # Corresponds to the JSON property `done`
         # @return [Boolean]
         attr_accessor :done
         alias_method :done?, :done
       
-        # The `Status` type defines a logical error model that is suitable for
+        # The `Status` type defines a logical error model that is suitable for different
-        # different programming environments, including REST APIs and RPC APIs. It is
+        # programming environments, including REST APIs and RPC APIs. It is used by [
-        # used by [gRPC](https://github.com/grpc). Each `Status` message contains
+        # gRPC](https://github.com/grpc). Each `Status` message contains three pieces of
-        # three pieces of data: error code, error message, and error details.
+        # data: error code, error message, and error details. You can find out more
-        # You can find out more about this error model and how to work with it in the
+        # about this error model and how to work with it in the [API Design Guide](https:
-        # [API Design Guide](https://cloud.google.com/apis/design/errors).
+        # //cloud.google.com/apis/design/errors).
         # Corresponds to the JSON property `error`
         # @return [Google::Apis::RuntimeconfigV1::Status]
         attr_accessor :error
       
-        # Service-specific metadata associated with the operation.  It typically
+        # Service-specific metadata associated with the operation. It typically contains
-        # contains progress information and common metadata such as create time.
+        # progress information and common metadata such as create time. Some services
-        # Some services might not provide such metadata.  Any method that returns a
+        # might not provide such metadata. Any method that returns a long-running
-        # long-running operation should document the metadata type, if any.
+        # operation should document the metadata type, if any.
         # Corresponds to the JSON property `metadata`
         # @return [Hash<String,Object>]
         attr_accessor :metadata
       
         # The server-assigned name, which is only unique within the same service that
-        # originally returns it. If you use the default HTTP mapping, the
+        # originally returns it. If you use the default HTTP mapping, the `name` should
-        # `name` should be a resource name ending with `operations/`unique_id``.
+        # be a resource name ending with `operations/`unique_id``.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # The normal response of the operation in case of success.  If the original
+        # The normal response of the operation in case of success. If the original
-        # method returns no data on success, such as `Delete`, the response is
+        # method returns no data on success, such as `Delete`, the response is `google.
-        # `google.protobuf.Empty`.  If the original method is standard
+        # protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`,
-        # `Get`/`Create`/`Update`, the response should be the resource.  For other
+        # the response should be the resource. For other methods, the response should
-        # methods, the response should have the type `XxxResponse`, where `Xxx`
+        # have the type `XxxResponse`, where `Xxx` is the original method name. For
-        # is the original method name.  For example, if the original method name
+        # example, if the original method name is `TakeSnapshot()`, the inferred
-        # is `TakeSnapshot()`, the inferred response type is
+        # response type is `TakeSnapshotResponse`.
-        # `TakeSnapshotResponse`.
         # Corresponds to the JSON property `response`
         # @return [Hash<String,Object>]
         attr_accessor :response
@@ -143,12 +139,12 @@ module Google
         end
       end
       
-      # The `Status` type defines a logical error model that is suitable for
+      # The `Status` type defines a logical error model that is suitable for different
-      # different programming environments, including REST APIs and RPC APIs. It is
+      # programming environments, including REST APIs and RPC APIs. It is used by [
-      # used by [gRPC](https://github.com/grpc). Each `Status` message contains
+      # gRPC](https://github.com/grpc). Each `Status` message contains three pieces of
-      # three pieces of data: error code, error message, and error details.
+      # data: error code, error message, and error details. You can find out more
-      # You can find out more about this error model and how to work with it in the
+      # about this error model and how to work with it in the [API Design Guide](https:
-      # [API Design Guide](https://cloud.google.com/apis/design/errors).
+      # //cloud.google.com/apis/design/errors).
       class Status
         include Google::Apis::Core::Hashable
       
@@ -157,15 +153,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
+        # A developer-facing error message, which should be in English. Any user-facing
-        # user-facing error message should be localized and sent in the
+        # error message should be localized and sent in the google.rpc.Status.details
-        # google.rpc.Status.details field, or localized by the client.
+        # field, or localized by the client.
         # Corresponds to the JSON property `message`
         # @return [String]
         attr_accessor :message

generated/google/apis/runtimeconfig_v1/service.rb

@@ -50,15 +50,13 @@ module Google
           @batch_path = 'batch'
         end
         
-        # Starts asynchronous cancellation on a long-running operation.  The server
+        # Starts asynchronous cancellation on a long-running operation. The server makes
-        # makes a best effort to cancel the operation, but success is not
+        # a best effort to cancel the operation, but success is not guaranteed. If the
-        # guaranteed.  If the server doesn't support this method, it returns
+        # server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.
-        # `google.rpc.Code.UNIMPLEMENTED`.  Clients can use
+        # Clients can use Operations.GetOperation or other methods to check whether the
-        # Operations.GetOperation or
+        # cancellation succeeded or whether the operation completed despite cancellation.
-        # other methods to check whether the cancellation succeeded or whether the
+        # On successful cancellation, the operation is not deleted; instead, it becomes
-        # operation completed despite cancellation. On successful cancellation,
+        # an operation with an Operation.error value with a google.rpc.Status.code of 1,
-        # the operation is not deleted; instead, it becomes an operation with
-        # an Operation.error value with a google.rpc.Status.code of 1,
         # corresponding to `Code.CANCELLED`.
         # @param [String] name
         #   The name of the operation resource to be cancelled.
@@ -92,10 +90,10 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes a long-running operation. This method indicates that the client is
+        # Deletes a long-running operation. This method indicates that the client is no
-        # no longer interested in the operation result. It does not cancel the
+        # longer interested in the operation result. It does not cancel the operation.
-        # operation. If the server doesn't support this method, it returns
+        # If the server doesn't support this method, it returns `google.rpc.Code.
-        # `google.rpc.Code.UNIMPLEMENTED`.
+        # UNIMPLEMENTED`.
         # @param [String] name
         #   The name of the operation resource to be deleted.
         # @param [String] fields
@@ -125,15 +123,14 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists operations that match the specified filter in the request. If the
+        # Lists operations that match the specified filter in the request. If the server
-        # server doesn't support this method, it returns `UNIMPLEMENTED`.
+        # doesn't support this method, it returns `UNIMPLEMENTED`. NOTE: the `name`
-        # NOTE: the `name` binding allows API services to override the binding
+        # binding allows API services to override the binding to use different resource
-        # to use different resource name schemes, such as `users/*/operations`. To
+        # name schemes, such as `users/*/operations`. To override the binding, API
-        # override the binding, API services can add a binding such as
+        # services can add a binding such as `"/v1/`name=users/*`/operations"` to their
-        # `"/v1/`name=users/*`/operations"` to their service configuration.
+        # service configuration. For backwards compatibility, the default name includes
-        # For backwards compatibility, the default name includes the operations
+        # the operations collection id, however overriding users must ensure the name
-        # collection id, however overriding users must ensure the name binding
+        # binding is the parent resource, without the operations collection id.
-        # is the parent resource, without the operations collection id.
         # @param [String] name
         #   The name of the operation's parent resource.
         # @param [String] filter

generated/google/apis/searchconsole_v1.rb

@@ -26,7 +26,7 @@ module Google
     # @see https://developers.google.com/webmaster-tools/search-console-api/
     module SearchconsoleV1
       VERSION = 'V1'
-      REVISION = '20200714'
+      REVISION = '20200803'
     end
   end
 end

generated/google/apis/searchconsole_v1/classes.rb

@@ -45,8 +45,8 @@ module Google
       class Image
         include Google::Apis::Core::Hashable
       
-        # Image data in format determined by the mime type. Currently, the format
+        # Image data in format determined by the mime type. Currently, the format will
-        # will always be "image/png", but this might change in the future.
+        # always be "image/png", but this might change in the future.
         # Corresponds to the JSON property `data`
         # NOTE: Values are automatically base64 encoded/decoded in the client library.
         # @return [String]

generated/google/apis/storagetransfer_v1.rb

@@ -26,7 +26,7 @@ module Google
     # @see https://cloud.google.com/storage-transfer/docs
     module StoragetransferV1
       VERSION = 'V1'
-      REVISION = '20200721'
+      REVISION = '20200730'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

generated/google/apis/storagetransfer_v1/classes.rb

@@ -459,11 +459,11 @@ module Google
       end
       
       # Conditions that determine which objects will be transferred. Applies only
-      # to S3 and Cloud Storage objects.
+      # to Cloud Data Sources such as S3, Azure, and Cloud Storage.
       # The "last modification time" refers to the time of the
       # last change to the object's content or metadata — specifically, this is
-      # the `updated` property of Cloud Storage objects and the `LastModified`
+      # the `updated` property of Cloud Storage objects, the `LastModified` field of
-      # field of S3 objects.
+      # S3 objects, and the `Last-Modified` header of Azure blobs.
       class ObjectConditions
         include Google::Apis::Core::Hashable
       
@@ -1081,8 +1081,7 @@ module Google
         end
       end
       
-      # TransferOptions uses three boolean parameters to define the actions
+      # TransferOptions define the actions to be performed on objects in a transfer.
-      # to be performed on objects in a transfer.
       class TransferOptions
         include Google::Apis::Core::Hashable
       
@@ -1196,17 +1195,16 @@ module Google
         attr_accessor :http_data_source
       
         # Conditions that determine which objects will be transferred. Applies only
-        # to S3 and Cloud Storage objects.
+        # to Cloud Data Sources such as S3, Azure, and Cloud Storage.
         # The "last modification time" refers to the time of the
         # last change to the object's content or metadata — specifically, this is
-        # the `updated` property of Cloud Storage objects and the `LastModified`
+        # the `updated` property of Cloud Storage objects, the `LastModified` field of
-        # field of S3 objects.
+        # S3 objects, and the `Last-Modified` header of Azure blobs.
         # Corresponds to the JSON property `objectConditions`
         # @return [Google::Apis::StoragetransferV1::ObjectConditions]
         attr_accessor :object_conditions
       
-        # TransferOptions uses three boolean parameters to define the actions
+        # TransferOptions define the actions to be performed on objects in a transfer.
-        # to be performed on objects in a transfer.
         # Corresponds to the JSON property `transferOptions`
         # @return [Google::Apis::StoragetransferV1::TransferOptions]
         attr_accessor :transfer_options

generated/google/apis/tagmanager_v1.rb

@@ -20,13 +20,12 @@ module Google
   module Apis
     # Tag Manager API
     #
-    # This API allows clients to access and modify container and tag
+    # This API allows clients to access and modify container and tag configuration.
-    # configuration.
     #
     # @see https://developers.google.com/tag-manager
     module TagmanagerV1
       VERSION = 'V1'
-      REVISION = '20200504'
+      REVISION = '20200803'
 
       # Delete your Google Tag Manager containers
       AUTH_TAGMANAGER_DELETE_CONTAINERS = 'https://www.googleapis.com/auth/tagmanager.delete.containers'

generated/google/apis/tagmanager_v1/classes.rb

@@ -31,22 +31,20 @@ module Google
         # @return [String]
         attr_accessor :account_id
       
-        # The fingerprint of the GTM Account as computed at storage time.
+        # The fingerprint of the GTM Account as computed at storage time. This value is
-        # This value is recomputed whenever the account is modified.
+        # recomputed whenever the account is modified.
         # Corresponds to the JSON property `fingerprint`
         # @return [String]
         attr_accessor :fingerprint
       
-        # Account display name.
+        # Account display name. @mutable tagmanager.accounts.create @mutable tagmanager.
-        # @mutable tagmanager.accounts.create
+        # accounts.update
-        # @mutable tagmanager.accounts.update
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # Whether the account shares data anonymously with Google and others.
+        # Whether the account shares data anonymously with Google and others. @mutable
-        # @mutable tagmanager.accounts.create
+        # tagmanager.accounts.create @mutable tagmanager.accounts.update
-        # @mutable tagmanager.accounts.update
         # Corresponds to the JSON property `shareData`
         # @return [Boolean]
         attr_accessor :share_data
@@ -69,10 +67,9 @@ module Google
       class AccountAccess
         include Google::Apis::Core::Hashable
       
-        # List of Account permissions.
+        # List of Account permissions. Valid account permissions are read and manage. @
-        # Valid account permissions are <code>read</code> and <code>manage</code>.
+        # mutable tagmanager.accounts.permissions.create @mutable tagmanager.accounts.
-        # @mutable tagmanager.accounts.permissions.create
+        # permissions.update
-        # @mutable tagmanager.accounts.permissions.update
         # Corresponds to the JSON property `permission`
         # @return [Array<String>]
         attr_accessor :permission
@@ -92,29 +89,21 @@ module Google
         include Google::Apis::Core::Hashable
       
         # A list of named parameters (key/value), depending on the condition's type.
-        # Notes:<ul>
+        # Notes: - For binary operators, include parameters named arg0 and arg1 for
-        # <li>For binary operators, include parameters named <code>arg0</code> and
+        # specifying the left and right operands, respectively. - At this time, the left
-        # <code>arg1</code> for specifying the left and right operands,
+        # operand (arg0) must be a reference to a variable. - For case-insensitive Regex
-        # respectively.</li>
+        # matching, include a boolean parameter named ignore_case that is set to true.
-        # <li>At this time, the left operand (<code>arg0</code>) must be a reference
-        # to a variable.</li>
-        # <li>For case-insensitive Regex matching, include a boolean parameter named
-        # <code>ignore_case</code> that is set to <code>true</code>.
         # If not specified or set to any other value, the matching will be case
-        # sensitive.</li>
+        # sensitive. - To negate an operator, include a boolean parameter named negate
-        # <li>To negate an operator, include a boolean parameter named
+        # boolean parameter that is set to true. @mutable tagmanager.accounts.containers.
-        # <code>negate</code> boolean parameter that is set to <code>true</code>.
+        # triggers.create @mutable tagmanager.accounts.containers.triggers.update
-        # </li>
-        # </ul>
-        # @mutable tagmanager.accounts.containers.triggers.create
-        # @mutable tagmanager.accounts.containers.triggers.update
         # Corresponds to the JSON property `parameter`
         # @return [Array<Google::Apis::TagmanagerV1::Parameter>]
         attr_accessor :parameter
       
-        # The type of operator for this condition.
+        # The type of operator for this condition. @mutable tagmanager.accounts.
-        # @mutable tagmanager.accounts.containers.triggers.create
+        # containers.triggers.create @mutable tagmanager.accounts.containers.triggers.
-        # @mutable tagmanager.accounts.containers.triggers.update
+        # update
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type
@@ -144,42 +133,38 @@ module Google
         # @return [String]
         attr_accessor :container_id
       
-        # Optional list of domain names associated with the Container.
+        # Optional list of domain names associated with the Container. @mutable
-        # @mutable tagmanager.accounts.containers.create
+        # tagmanager.accounts.containers.create @mutable tagmanager.accounts.containers.
-        # @mutable tagmanager.accounts.containers.update
+        # update
         # Corresponds to the JSON property `domainName`
         # @return [Array<String>]
         attr_accessor :domain_name
       
-        # List of enabled built-in variables. Valid values include: <code>pageUrl,
+        # List of enabled built-in variables. Valid values include: pageUrl,
-        # pageHostname, pagePath, referrer, event, clickElement, clickClasses,
+        # pageHostname, pagePath, referrer, event, clickElement, clickClasses, clickId,
-        # clickId, clickTarget, clickUrl, clickText, formElement, formClasses,
+        # clickTarget, clickUrl, clickText, formElement, formClasses, formId, formTarget,
-        # formId, formTarget, formUrl, formText, errorMessage, errorUrl, errorLine,
+        # formUrl, formText, errorMessage, errorUrl, errorLine, newHistoryFragment,
-        # newHistoryFragment, oldHistoryFragment, newHistoryState, oldHistoryState,
+        # oldHistoryFragment, newHistoryState, oldHistoryState, historySource,
-        # historySource, containerVersion, debugMode, randomNumber,
+        # containerVersion, debugMode, randomNumber, containerId. @mutable tagmanager.
-        # containerId</code>.
+        # accounts.containers.create @mutable tagmanager.accounts.containers.update
-        # @mutable tagmanager.accounts.containers.create
-        # @mutable tagmanager.accounts.containers.update
         # Corresponds to the JSON property `enabledBuiltInVariable`
         # @return [Array<String>]
         attr_accessor :enabled_built_in_variable
       
-        # The fingerprint of the GTM Container as computed at storage time.  This
+        # The fingerprint of the GTM Container as computed at storage time. This value
-        # value is recomputed whenever the account is modified.
+        # is recomputed whenever the account is modified.
         # Corresponds to the JSON property `fingerprint`
         # @return [String]
         attr_accessor :fingerprint
       
-        # Container display name.
+        # Container display name. @mutable tagmanager.accounts.containers.create @
-        # @mutable tagmanager.accounts.containers.create
+        # mutable tagmanager.accounts.containers.update
-        # @mutable tagmanager.accounts.containers.update
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # Container Notes.
+        # Container Notes. @mutable tagmanager.accounts.containers.create @mutable
-        # @mutable tagmanager.accounts.containers.create
+        # tagmanager.accounts.containers.update
-        # @mutable tagmanager.accounts.containers.update
         # Corresponds to the JSON property `notes`
         # @return [String]
         attr_accessor :notes
@@ -189,24 +174,21 @@ module Google
         # @return [String]
         attr_accessor :public_id
       
-        # Container Country ID.
+        # Container Country ID. @mutable tagmanager.accounts.containers.create @mutable
-        # @mutable tagmanager.accounts.containers.create
+        # tagmanager.accounts.containers.update
-        # @mutable tagmanager.accounts.containers.update
         # Corresponds to the JSON property `timeZoneCountryId`
         # @return [String]
         attr_accessor :time_zone_country_id
       
-        # Container Time Zone ID.
+        # Container Time Zone ID. @mutable tagmanager.accounts.containers.create @
-        # @mutable tagmanager.accounts.containers.create
+        # mutable tagmanager.accounts.containers.update
-        # @mutable tagmanager.accounts.containers.update
         # Corresponds to the JSON property `timeZoneId`
         # @return [String]
         attr_accessor :time_zone_id
       
-        # List of Usage Contexts for the Container. Valid values include: <code>web,
+        # List of Usage Contexts for the Container. Valid values include: web, android,
-        # android, ios</code>.
+        # ios. @mutable tagmanager.accounts.containers.create @mutable tagmanager.
-        # @mutable tagmanager.accounts.containers.create
+        # accounts.containers.update
-        # @mutable tagmanager.accounts.containers.update
         # Corresponds to the JSON property `usageContext`
         # @return [Array<String>]
         attr_accessor :usage_context
@@ -235,17 +217,15 @@ module Google
       class ContainerAccess
         include Google::Apis::Core::Hashable
       
-        # GTM Container ID.
+        # GTM Container ID. @mutable tagmanager.accounts.permissions.create @mutable
-        # @mutable tagmanager.accounts.permissions.create
+        # tagmanager.accounts.permissions.update
-        # @mutable tagmanager.accounts.permissions.update
         # Corresponds to the JSON property `containerId`
         # @return [String]
         attr_accessor :container_id
       
-        # List of Container permissions.
+        # List of Container permissions. Valid container permissions are: read, edit,
-        # Valid container permissions are: <code>read, edit, delete, publish</code>.
+        # delete, publish. @mutable tagmanager.accounts.permissions.create @mutable
-        # @mutable tagmanager.accounts.permissions.create
+        # tagmanager.accounts.permissions.update
-        # @mutable tagmanager.accounts.permissions.update
         # Corresponds to the JSON property `permission`
         # @return [Array<String>]
         attr_accessor :permission
@@ -291,9 +271,8 @@ module Google
         attr_accessor :deleted
         alias_method :deleted?, :deleted
       
-        # The fingerprint of the GTM Container Version as computed at
+        # The fingerprint of the GTM Container Version as computed at storage time. This
-        # storage time. This value is recomputed whenever the container version is
+        # value is recomputed whenever the container version is modified.
-        # modified.
         # Corresponds to the JSON property `fingerprint`
         # @return [String]
         attr_accessor :fingerprint
@@ -308,15 +287,14 @@ module Google
         # @return [Array<Google::Apis::TagmanagerV1::Macro>]
         attr_accessor :macro
       
-        # Container version display name.
+        # Container version display name. @mutable tagmanager.accounts.containers.
-        # @mutable tagmanager.accounts.containers.versions.update
+        # versions.update
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # User notes on how to apply this container version in the
+        # User notes on how to apply this container version in the container. @mutable
-        # container.
+        # tagmanager.accounts.containers.versions.update
-        # @mutable tagmanager.accounts.containers.versions.update
         # Corresponds to the JSON property `notes`
         # @return [String]
         attr_accessor :notes
@@ -452,8 +430,7 @@ module Google
         # @return [String]
         attr_accessor :notes
       
-        # The creation of this version may be for quick preview and
+        # The creation of this version may be for quick preview and shouldn't be saved.
-        # shouldn't be saved.
         # Corresponds to the JSON property `quickPreview`
         # @return [Boolean]
         attr_accessor :quick_preview
@@ -529,16 +506,15 @@ module Google
         attr_accessor :container_version_id
       
         # The environment description. Can be set or changed only on USER type
-        # environments.
+        # environments. @mutable tagmanager.accounts.containers.environments.create @
-        # @mutable tagmanager.accounts.containers.environments.create
+        # mutable tagmanager.accounts.containers.environments.update
-        # @mutable tagmanager.accounts.containers.environments.update
         # Corresponds to the JSON property `description`
         # @return [String]
         attr_accessor :description
       
-        # Whether or not to enable debug by default on for the environment.
+        # Whether or not to enable debug by default on for the environment. @mutable
-        # @mutable tagmanager.accounts.containers.environments.create
+        # tagmanager.accounts.containers.environments.create @mutable tagmanager.
-        # @mutable tagmanager.accounts.containers.environments.update
+        # accounts.containers.environments.update
         # Corresponds to the JSON property `enableDebug`
         # @return [Boolean]
         attr_accessor :enable_debug
@@ -549,16 +525,15 @@ module Google
         # @return [String]
         attr_accessor :environment_id
       
-        # The fingerprint of the GTM environment as computed at storage time.
+        # The fingerprint of the GTM environment as computed at storage time. This value
-        # This value is recomputed whenever the environment is modified.
+        # is recomputed whenever the environment is modified.
         # Corresponds to the JSON property `fingerprint`
         # @return [String]
         attr_accessor :fingerprint
       
         # The environment display name. Can be set or changed only on USER type
-        # environments.
+        # environments. @mutable tagmanager.accounts.containers.environments.create @
-        # @mutable tagmanager.accounts.containers.environments.create
+        # mutable tagmanager.accounts.containers.environments.update
-        # @mutable tagmanager.accounts.containers.environments.update
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -568,9 +543,9 @@ module Google
         # @return [String]
         attr_accessor :type
       
-        # Default preview page url for the environment.
+        # Default preview page url for the environment. @mutable tagmanager.accounts.
-        # @mutable tagmanager.accounts.containers.environments.create
+        # containers.environments.create @mutable tagmanager.accounts.containers.
-        # @mutable tagmanager.accounts.containers.environments.update
+        # environments.update
         # Corresponds to the JSON property `url`
         # @return [String]
         attr_accessor :url
@@ -610,8 +585,8 @@ module Google
         # @return [String]
         attr_accessor :container_id
       
-        # The fingerprint of the GTM Folder as computed at storage time.
+        # The fingerprint of the GTM Folder as computed at storage time. This value is
-        # This value is recomputed whenever the folder is modified.
+        # recomputed whenever the folder is modified.
         # Corresponds to the JSON property `fingerprint`
         # @return [String]
         attr_accessor :fingerprint
@@ -621,9 +596,8 @@ module Google
         # @return [String]
         attr_accessor :folder_id
       
-        # Folder display name.
+        # Folder display name. @mutable tagmanager.accounts.containers.folders.create @
-        # @mutable tagmanager.accounts.containers.folders.create
+        # mutable tagmanager.accounts.containers.folders.update
-        # @mutable tagmanager.accounts.containers.folders.update
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -866,24 +840,24 @@ module Google
       
         # For mobile containers only: A list of rule IDs for disabling conditional
         # macros; the macro is enabled if one of the enabling rules is true while all
-        # the disabling rules are false. Treated as an unordered set.
+        # the disabling rules are false. Treated as an unordered set. @mutable
-        # @mutable tagmanager.accounts.containers.macros.create
+        # tagmanager.accounts.containers.macros.create @mutable tagmanager.accounts.
-        # @mutable tagmanager.accounts.containers.macros.update
+        # containers.macros.update
         # Corresponds to the JSON property `disablingRuleId`
         # @return [Array<String>]
         attr_accessor :disabling_rule_id
       
-        # For mobile containers only: A list of rule IDs for enabling conditional
+        # For mobile containers only: A list of rule IDs for enabling conditional macros;
-        # macros; the macro is enabled if one of the enabling rules is true while all
+        # the macro is enabled if one of the enabling rules is true while all the
-        # the disabling rules are false. Treated as an unordered set.
+        # disabling rules are false. Treated as an unordered set. @mutable tagmanager.
-        # @mutable tagmanager.accounts.containers.macros.create
+        # accounts.containers.macros.create @mutable tagmanager.accounts.containers.
-        # @mutable tagmanager.accounts.containers.macros.update
+        # macros.update
         # Corresponds to the JSON property `enablingRuleId`
         # @return [Array<String>]
         attr_accessor :enabling_rule_id
       
-        # The fingerprint of the GTM Macro as computed at storage time.
+        # The fingerprint of the GTM Macro as computed at storage time. This value is
-        # This value is recomputed whenever the macro is modified.
+        # recomputed whenever the macro is modified.
         # Corresponds to the JSON property `fingerprint`
         # @return [String]
         attr_accessor :fingerprint
@@ -893,23 +867,21 @@ module Google
         # @return [String]
         attr_accessor :macro_id
       
-        # Macro display name.
+        # Macro display name. @mutable tagmanager.accounts.containers.macros.create @
-        # @mutable tagmanager.accounts.containers.macros.create
+        # mutable tagmanager.accounts.containers.macros.update
-        # @mutable tagmanager.accounts.containers.macros.update
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # User notes on how to apply this macro in the container.
+        # User notes on how to apply this macro in the container. @mutable tagmanager.
-        # @mutable tagmanager.accounts.containers.macros.create
+        # accounts.containers.macros.create @mutable tagmanager.accounts.containers.
-        # @mutable tagmanager.accounts.containers.macros.update
+        # macros.update
         # Corresponds to the JSON property `notes`
         # @return [String]
         attr_accessor :notes
       
-        # The macro's parameters.
+        # The macro's parameters. @mutable tagmanager.accounts.containers.macros.create @
-        # @mutable tagmanager.accounts.containers.macros.create
+        # mutable tagmanager.accounts.containers.macros.update
-        # @mutable tagmanager.accounts.containers.macros.update
         # Corresponds to the JSON property `parameter`
         # @return [Array<Google::Apis::TagmanagerV1::Parameter>]
         attr_accessor :parameter
@@ -919,23 +891,22 @@ module Google
         # @return [String]
         attr_accessor :parent_folder_id
       
-        # The end timestamp in milliseconds to schedule a macro.
+        # The end timestamp in milliseconds to schedule a macro. @mutable tagmanager.
-        # @mutable tagmanager.accounts.containers.macros.create
+        # accounts.containers.macros.create @mutable tagmanager.accounts.containers.
-        # @mutable tagmanager.accounts.containers.macros.update
+        # macros.update
         # Corresponds to the JSON property `scheduleEndMs`
         # @return [Fixnum]
         attr_accessor :schedule_end_ms
       
-        # The start timestamp in milliseconds to schedule a macro.
+        # The start timestamp in milliseconds to schedule a macro. @mutable tagmanager.
-        # @mutable tagmanager.accounts.containers.macros.create
+        # accounts.containers.macros.create @mutable tagmanager.accounts.containers.
-        # @mutable tagmanager.accounts.containers.macros.update
+        # macros.update
         # Corresponds to the JSON property `scheduleStartMs`
         # @return [Fixnum]
         attr_accessor :schedule_start_ms
       
-        # GTM Macro Type.
+        # GTM Macro Type. @mutable tagmanager.accounts.containers.macros.create @mutable
-        # @mutable tagmanager.accounts.containers.macros.create
+        # tagmanager.accounts.containers.macros.update
-        # @mutable tagmanager.accounts.containers.macros.update
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type
@@ -966,74 +937,59 @@ module Google
       class Parameter
         include Google::Apis::Core::Hashable
       
-        # The named key that uniquely identifies a parameter.  Required for top-level
+        # The named key that uniquely identifies a parameter. Required for top-level
-        # parameters, as well as map values.  Ignored for list values.
+        # parameters, as well as map values. Ignored for list values. @mutable
-        # @mutable tagmanager.accounts.containers.variables.create
+        # tagmanager.accounts.containers.variables.create @mutable tagmanager.accounts.
-        # @mutable tagmanager.accounts.containers.variables.update
+        # containers.variables.update @mutable tagmanager.accounts.containers.triggers.
-        # @mutable tagmanager.accounts.containers.triggers.create
+        # create @mutable tagmanager.accounts.containers.triggers.update @mutable
-        # @mutable tagmanager.accounts.containers.triggers.update
+        # tagmanager.accounts.containers.tags.create @mutable tagmanager.accounts.
-        # @mutable tagmanager.accounts.containers.tags.create
+        # containers.tags.update
-        # @mutable tagmanager.accounts.containers.tags.update
         # Corresponds to the JSON property `key`
         # @return [String]
         attr_accessor :key
       
-        # This list parameter's parameters (keys will be ignored).
+        # This list parameter's parameters (keys will be ignored). @mutable tagmanager.
-        # @mutable tagmanager.accounts.containers.variables.create
+        # accounts.containers.variables.create @mutable tagmanager.accounts.containers.
-        # @mutable tagmanager.accounts.containers.variables.update
+        # variables.update @mutable tagmanager.accounts.containers.triggers.create @
-        # @mutable tagmanager.accounts.containers.triggers.create
+        # mutable tagmanager.accounts.containers.triggers.update @mutable tagmanager.
-        # @mutable tagmanager.accounts.containers.triggers.update
+        # accounts.containers.tags.create @mutable tagmanager.accounts.containers.tags.
-        # @mutable tagmanager.accounts.containers.tags.create
+        # update
-        # @mutable tagmanager.accounts.containers.tags.update
         # Corresponds to the JSON property `list`
         # @return [Array<Google::Apis::TagmanagerV1::Parameter>]
         attr_accessor :list
       
-        # This map parameter's parameters (must have keys; keys must be unique).
+        # This map parameter's parameters (must have keys; keys must be unique). @
-        # @mutable tagmanager.accounts.containers.variables.create
+        # mutable tagmanager.accounts.containers.variables.create @mutable tagmanager.
-        # @mutable tagmanager.accounts.containers.variables.update
+        # accounts.containers.variables.update @mutable tagmanager.accounts.containers.
-        # @mutable tagmanager.accounts.containers.triggers.create
+        # triggers.create @mutable tagmanager.accounts.containers.triggers.update @
-        # @mutable tagmanager.accounts.containers.triggers.update
+        # mutable tagmanager.accounts.containers.tags.create @mutable tagmanager.
-        # @mutable tagmanager.accounts.containers.tags.create
+        # accounts.containers.tags.update
-        # @mutable tagmanager.accounts.containers.tags.update
         # Corresponds to the JSON property `map`
         # @return [Array<Google::Apis::TagmanagerV1::Parameter>]
         attr_accessor :map
       
-        # The parameter type.  Valid values are:<ul>
+        # The parameter type. Valid values are: - boolean: The value represents a
-        # <li><code>boolean</code>: The value represents a boolean, represented as
+        # boolean, represented as 'true' or 'false' - integer: The value represents a 64-
-        # 'true' or 'false'</li>
+        # bit signed integer value, in base 10 - list: A list of parameters should be
-        # <li><code>integer</code>: The value represents a 64-bit signed integer
+        # specified - map: A map of parameters should be specified - template: The value
-        # value, in base 10</li>
+        # represents any text; this can include variable references (even variable
-        # <li><code>list</code>: A list of parameters should be specified</li>
+        # references that might return non-string types) - trigger_reference: The value
-        # <li><code>map</code>: A map of parameters should be specified</li>
+        # represents a trigger, represented as the trigger id - tag_reference: The value
-        # <li><code>template</code>: The value represents any text; this can include
+        # represents a tag, represented as the tag name @mutable tagmanager.accounts.
-        # variable references (even variable references that might return
+        # containers.variables.create @mutable tagmanager.accounts.containers.variables.
-        # non-string types)</li>
+        # update @mutable tagmanager.accounts.containers.triggers.create @mutable
-        # <li><code>trigger_reference</code>: The value represents a trigger,
+        # tagmanager.accounts.containers.triggers.update @mutable tagmanager.accounts.
-        # represented as the trigger id</li>
+        # containers.tags.create @mutable tagmanager.accounts.containers.tags.update
-        # <li><code>tag_reference</code>: The value represents a tag, represented as
-        # the tag name</li>
-        # </ul>
-        # @mutable tagmanager.accounts.containers.variables.create
-        # @mutable tagmanager.accounts.containers.variables.update
-        # @mutable tagmanager.accounts.containers.triggers.create
-        # @mutable tagmanager.accounts.containers.triggers.update
-        # @mutable tagmanager.accounts.containers.tags.create
-        # @mutable tagmanager.accounts.containers.tags.update
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type
       
-        # A parameter's value (may contain variable references such as
+        # A parameter's value (may contain variable references such as "``myVariable``")
-        # "``myVariable``")
+        # as appropriate to the specified type. @mutable tagmanager.accounts.containers.
-        # as appropriate to the specified type.
+        # variables.create @mutable tagmanager.accounts.containers.variables.update @
-        # @mutable tagmanager.accounts.containers.variables.create
+        # mutable tagmanager.accounts.containers.triggers.create @mutable tagmanager.
-        # @mutable tagmanager.accounts.containers.variables.update
+        # accounts.containers.triggers.update @mutable tagmanager.accounts.containers.
-        # @mutable tagmanager.accounts.containers.triggers.create
+        # tags.create @mutable tagmanager.accounts.containers.tags.update
-        # @mutable tagmanager.accounts.containers.triggers.update
-        # @mutable tagmanager.accounts.containers.tags.create
-        # @mutable tagmanager.accounts.containers.tags.update
         # Corresponds to the JSON property `value`
         # @return [String]
         attr_accessor :value
@@ -1087,9 +1043,9 @@ module Google
         # @return [String]
         attr_accessor :account_id
       
-        # The list of conditions that make up this rule (implicit AND between them).
+        # The list of conditions that make up this rule (implicit AND between them). @
-        # @mutable tagmanager.accounts.containers.rules.create
+        # mutable tagmanager.accounts.containers.rules.create @mutable tagmanager.
-        # @mutable tagmanager.accounts.containers.rules.update
+        # accounts.containers.rules.update
         # Corresponds to the JSON property `condition`
         # @return [Array<Google::Apis::TagmanagerV1::Condition>]
         attr_accessor :condition
@@ -1099,22 +1055,21 @@ module Google
         # @return [String]
         attr_accessor :container_id
       
-        # The fingerprint of the GTM Rule as computed at storage time.
+        # The fingerprint of the GTM Rule as computed at storage time. This value is
-        # This value is recomputed whenever the rule is modified.
+        # recomputed whenever the rule is modified.
         # Corresponds to the JSON property `fingerprint`
         # @return [String]
         attr_accessor :fingerprint
       
-        # Rule display name.
+        # Rule display name. @mutable tagmanager.accounts.containers.rules.create @
-        # @mutable tagmanager.accounts.containers.rules.create
+        # mutable tagmanager.accounts.containers.rules.update
-        # @mutable tagmanager.accounts.containers.rules.update
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # User notes on how to apply this rule in the container.
+        # User notes on how to apply this rule in the container. @mutable tagmanager.
-        # @mutable tagmanager.accounts.containers.rules.create
+        # accounts.containers.rules.create @mutable tagmanager.accounts.containers.rules.
-        # @mutable tagmanager.accounts.containers.rules.update
+        # update
         # Corresponds to the JSON property `notes`
         # @return [String]
         attr_accessor :notes
@@ -1144,9 +1099,8 @@ module Google
       class SetupTag
         include Google::Apis::Core::Hashable
       
-        # If true, fire the main tag if and only if the setup tag fires
+        # If true, fire the main tag if and only if the setup tag fires successfully. If
-        # successfully.
+        # false, fire the main tag regardless of setup tag firing status.
-        # If false, fire the main tag regardless of setup tag firing status.
         # Corresponds to the JSON property `stopOnSetupFailure`
         # @return [Boolean]
         attr_accessor :stop_on_setup_failure
@@ -1177,19 +1131,16 @@ module Google
         # @return [String]
         attr_accessor :account_id
       
-        # Blocking rule IDs. If any of the listed rules evaluate to true, the tag
+        # Blocking rule IDs. If any of the listed rules evaluate to true, the tag will
-        # will not fire.
+        # not fire. @mutable tagmanager.accounts.containers.tags.create @mutable
-        # @mutable tagmanager.accounts.containers.tags.create
+        # tagmanager.accounts.containers.tags.update
-        # @mutable tagmanager.accounts.containers.tags.update
         # Corresponds to the JSON property `blockingRuleId`
         # @return [Array<String>]
         attr_accessor :blocking_rule_id
       
-        # Blocking trigger IDs. If any of the listed triggers evaluate to true, the
+        # Blocking trigger IDs. If any of the listed triggers evaluate to true, the tag
-        # tag
+        # will not fire. @mutable tagmanager.accounts.containers.tags.create @mutable
-        # will not fire.
+        # tagmanager.accounts.containers.tags.update
-        # @mutable tagmanager.accounts.containers.tags.create
-        # @mutable tagmanager.accounts.containers.tags.update
         # Corresponds to the JSON property `blockingTriggerId`
         # @return [Array<String>]
         attr_accessor :blocking_trigger_id
@@ -1199,55 +1150,51 @@ module Google
         # @return [String]
         attr_accessor :container_id
       
-        # The fingerprint of the GTM Tag as computed at storage time.
+        # The fingerprint of the GTM Tag as computed at storage time. This value is
-        # This value is recomputed whenever the tag is modified.
+        # recomputed whenever the tag is modified.
         # Corresponds to the JSON property `fingerprint`
         # @return [String]
         attr_accessor :fingerprint
       
-        # Firing rule IDs. A tag will fire when any of the listed rules are true and
+        # Firing rule IDs. A tag will fire when any of the listed rules are true and all
-        # all of its <code>blockingRuleIds</code> (if any specified) are false.
+        # of its blockingRuleIds (if any specified) are false. @mutable tagmanager.
-        # @mutable tagmanager.accounts.containers.tags.create
+        # accounts.containers.tags.create @mutable tagmanager.accounts.containers.tags.
-        # @mutable tagmanager.accounts.containers.tags.update
+        # update
         # Corresponds to the JSON property `firingRuleId`
         # @return [Array<String>]
         attr_accessor :firing_rule_id
       
-        # Firing trigger IDs. A tag will fire when any of the listed triggers are
+        # Firing trigger IDs. A tag will fire when any of the listed triggers are true
-        # true and all of its <code>blockingTriggerIds</code> (if any specified) are
+        # and all of its blockingTriggerIds (if any specified) are false. @mutable
-        # false.
+        # tagmanager.accounts.containers.tags.create @mutable tagmanager.accounts.
-        # @mutable tagmanager.accounts.containers.tags.create
+        # containers.tags.update
-        # @mutable tagmanager.accounts.containers.tags.update
         # Corresponds to the JSON property `firingTriggerId`
         # @return [Array<String>]
         attr_accessor :firing_trigger_id
       
-        # If set to true, this tag will only fire in the live environment (e.g. not
+        # If set to true, this tag will only fire in the live environment (e.g. not in
-        # in preview or debug mode).
+        # preview or debug mode). @mutable tagmanager.accounts.containers.tags.create @
-        # @mutable tagmanager.accounts.containers.tags.create
+        # mutable tagmanager.accounts.containers.tags.update
-        # @mutable tagmanager.accounts.containers.tags.update
         # Corresponds to the JSON property `liveOnly`
         # @return [Boolean]
         attr_accessor :live_only
         alias_method :live_only?, :live_only
       
-        # Tag display name.
+        # Tag display name. @mutable tagmanager.accounts.containers.tags.create @mutable
-        # @mutable tagmanager.accounts.containers.tags.create
+        # tagmanager.accounts.containers.tags.update
-        # @mutable tagmanager.accounts.containers.tags.update
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # User notes on how to apply this tag in the container.
+        # User notes on how to apply this tag in the container. @mutable tagmanager.
-        # @mutable tagmanager.accounts.containers.tags.create
+        # accounts.containers.tags.create @mutable tagmanager.accounts.containers.tags.
-        # @mutable tagmanager.accounts.containers.tags.update
+        # update
         # Corresponds to the JSON property `notes`
         # @return [String]
         attr_accessor :notes
       
-        # The tag's parameters.
+        # The tag's parameters. @mutable tagmanager.accounts.containers.tags.create @
-        # @mutable tagmanager.accounts.containers.tags.create
+        # mutable tagmanager.accounts.containers.tags.update
-        # @mutable tagmanager.accounts.containers.tags.update
         # Corresponds to the JSON property `parameter`
         # @return [Array<Google::Apis::TagmanagerV1::Parameter>]
         attr_accessor :parameter
@@ -1257,8 +1204,7 @@ module Google
         # @return [String]
         attr_accessor :parent_folder_id
       
-        # True if the tag is paused.
+        # True if the tag is paused. @mutable tagmanager.accounts.containers.tags.create
-        # @mutable tagmanager.accounts.containers.tags.create
         # @mutable tagmanager.accounts.containers.tags.update
         # Corresponds to the JSON property `paused`
         # @return [Boolean]
@@ -1270,16 +1216,16 @@ module Google
         # @return [Google::Apis::TagmanagerV1::Parameter]
         attr_accessor :priority
       
-        # The end timestamp in milliseconds to schedule a tag.
+        # The end timestamp in milliseconds to schedule a tag. @mutable tagmanager.
-        # @mutable tagmanager.accounts.containers.tags.create
+        # accounts.containers.tags.create @mutable tagmanager.accounts.containers.tags.
-        # @mutable tagmanager.accounts.containers.tags.update
+        # update
         # Corresponds to the JSON property `scheduleEndMs`
         # @return [Fixnum]
         attr_accessor :schedule_end_ms
       
-        # The start timestamp in milliseconds to schedule a tag.
+        # The start timestamp in milliseconds to schedule a tag. @mutable tagmanager.
-        # @mutable tagmanager.accounts.containers.tags.create
+        # accounts.containers.tags.create @mutable tagmanager.accounts.containers.tags.
-        # @mutable tagmanager.accounts.containers.tags.update
+        # update
         # Corresponds to the JSON property `scheduleStartMs`
         # @return [Fixnum]
         attr_accessor :schedule_start_ms
@@ -1304,9 +1250,8 @@ module Google
         # @return [Array<Google::Apis::TagmanagerV1::TeardownTag>]
         attr_accessor :teardown_tag
       
-        # GTM Tag Type.
+        # GTM Tag Type. @mutable tagmanager.accounts.containers.tags.create @mutable
-        # @mutable tagmanager.accounts.containers.tags.create
+        # tagmanager.accounts.containers.tags.update
-        # @mutable tagmanager.accounts.containers.tags.update
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type
@@ -1345,8 +1290,7 @@ module Google
       class TeardownTag
         include Google::Apis::Core::Hashable
       
-        # If true, fire the teardown tag if and only if the main tag fires
+        # If true, fire the teardown tag if and only if the main tag fires successfully.
-        # successfully.
         # If false, fire the teardown tag regardless of main tag firing status.
         # Corresponds to the JSON property `stopTeardownOnFailure`
         # @return [Boolean]
@@ -1378,9 +1322,9 @@ module Google
         # @return [String]
         attr_accessor :account_id
       
-        # Used in the case of auto event tracking.
+        # Used in the case of auto event tracking. @mutable tagmanager.accounts.
-        # @mutable tagmanager.accounts.containers.triggers.create
+        # containers.triggers.create @mutable tagmanager.accounts.containers.triggers.
-        # @mutable tagmanager.accounts.containers.triggers.update
+        # update
         # Corresponds to the JSON property `autoEventFilter`
         # @return [Array<Google::Apis::TagmanagerV1::Condition>]
         attr_accessor :auto_event_filter
@@ -1400,10 +1344,9 @@ module Google
         # @return [Google::Apis::TagmanagerV1::Parameter]
         attr_accessor :continuous_time_min_milliseconds
       
-        # Used in the case of custom event, which is fired iff all Conditions are
+        # Used in the case of custom event, which is fired iff all Conditions are true. @
-        # true.
+        # mutable tagmanager.accounts.containers.triggers.create @mutable tagmanager.
-        # @mutable tagmanager.accounts.containers.triggers.create
+        # accounts.containers.triggers.update
-        # @mutable tagmanager.accounts.containers.triggers.update
         # Corresponds to the JSON property `customEventFilter`
         # @return [Array<Google::Apis::TagmanagerV1::Condition>]
         attr_accessor :custom_event_filter
@@ -1413,15 +1356,15 @@ module Google
         # @return [Google::Apis::TagmanagerV1::Parameter]
         attr_accessor :event_name
       
-        # The trigger will only fire iff all Conditions are true.
+        # The trigger will only fire iff all Conditions are true. @mutable tagmanager.
-        # @mutable tagmanager.accounts.containers.triggers.create
+        # accounts.containers.triggers.create @mutable tagmanager.accounts.containers.
-        # @mutable tagmanager.accounts.containers.triggers.update
+        # triggers.update
         # Corresponds to the JSON property `filter`
         # @return [Array<Google::Apis::TagmanagerV1::Condition>]
         attr_accessor :filter
       
-        # The fingerprint of the GTM Trigger as computed at storage time.
+        # The fingerprint of the GTM Trigger as computed at storage time. This value is
-        # This value is recomputed whenever the trigger is modified.
+        # recomputed whenever the trigger is modified.
         # Corresponds to the JSON property `fingerprint`
         # @return [String]
         attr_accessor :fingerprint
@@ -1451,16 +1394,15 @@ module Google
         # @return [Google::Apis::TagmanagerV1::Parameter]
         attr_accessor :max_timer_length_seconds
       
-        # Trigger display name.
+        # Trigger display name. @mutable tagmanager.accounts.containers.triggers.create @
-        # @mutable tagmanager.accounts.containers.triggers.create
+        # mutable tagmanager.accounts.containers.triggers.update
-        # @mutable tagmanager.accounts.containers.triggers.update
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # Additional parameters.
+        # Additional parameters. @mutable tagmanager.accounts.containers.workspaces.
-        # @mutable tagmanager.accounts.containers.workspaces.triggers.create
+        # triggers.create @mutable tagmanager.accounts.containers.workspaces.triggers.
-        # @mutable tagmanager.accounts.containers.workspaces.triggers.update
+        # update
         # Corresponds to the JSON property `parameter`
         # @return [Array<Google::Apis::TagmanagerV1::Parameter>]
         attr_accessor :parameter
@@ -1485,9 +1427,9 @@ module Google
         # @return [String]
         attr_accessor :trigger_id
       
-        # Defines the data layer event that causes this trigger.
+        # Defines the data layer event that causes this trigger. @mutable tagmanager.
-        # @mutable tagmanager.accounts.containers.triggers.create
+        # accounts.containers.triggers.create @mutable tagmanager.accounts.containers.
-        # @mutable tagmanager.accounts.containers.triggers.update
+        # triggers.update
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type
@@ -1578,15 +1520,13 @@ module Google
         # @return [String]
         attr_accessor :account_id
       
-        # GTM Container access permissions.
+        # GTM Container access permissions. @mutable tagmanager.accounts.permissions.
-        # @mutable tagmanager.accounts.permissions.create
+        # create @mutable tagmanager.accounts.permissions.update
-        # @mutable tagmanager.accounts.permissions.update
         # Corresponds to the JSON property `containerAccess`
         # @return [Array<Google::Apis::TagmanagerV1::ContainerAccess>]
         attr_accessor :container_access
       
-        # User's email address.
+        # User's email address. @mutable tagmanager.accounts.permissions.create
-        # @mutable tagmanager.accounts.permissions.create
         # Corresponds to the JSON property `emailAddress`
         # @return [String]
         attr_accessor :email_address
@@ -1626,45 +1566,43 @@ module Google
       
         # For mobile containers only: A list of trigger IDs for disabling conditional
         # variables; the variable is enabled if one of the enabling trigger is true
-        # while all the disabling trigger are false. Treated as an unordered set.
+        # while all the disabling trigger are false. Treated as an unordered set. @
-        # @mutable tagmanager.accounts.containers.variables.create
+        # mutable tagmanager.accounts.containers.variables.create @mutable tagmanager.
-        # @mutable tagmanager.accounts.containers.variables.update
+        # accounts.containers.variables.update
         # Corresponds to the JSON property `disablingTriggerId`
         # @return [Array<String>]
         attr_accessor :disabling_trigger_id
       
         # For mobile containers only: A list of trigger IDs for enabling conditional
         # variables; the variable is enabled if one of the enabling triggers is true
-        # while all the disabling triggers are false. Treated as an unordered set.
+        # while all the disabling triggers are false. Treated as an unordered set. @
-        # @mutable tagmanager.accounts.containers.variables.create
+        # mutable tagmanager.accounts.containers.variables.create @mutable tagmanager.
-        # @mutable tagmanager.accounts.containers.variables.update
+        # accounts.containers.variables.update
         # Corresponds to the JSON property `enablingTriggerId`
         # @return [Array<String>]
         attr_accessor :enabling_trigger_id
       
-        # The fingerprint of the GTM Variable as computed at storage time.
+        # The fingerprint of the GTM Variable as computed at storage time. This value is
-        # This value is recomputed whenever the variable is modified.
+        # recomputed whenever the variable is modified.
         # Corresponds to the JSON property `fingerprint`
         # @return [String]
         attr_accessor :fingerprint
       
-        # Variable display name.
+        # Variable display name. @mutable tagmanager.accounts.containers.variables.
-        # @mutable tagmanager.accounts.containers.variables.create
+        # create @mutable tagmanager.accounts.containers.variables.update
-        # @mutable tagmanager.accounts.containers.variables.update
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # User notes on how to apply this variable in the container.
+        # User notes on how to apply this variable in the container. @mutable tagmanager.
-        # @mutable tagmanager.accounts.containers.variables.create
+        # accounts.containers.variables.create @mutable tagmanager.accounts.containers.
-        # @mutable tagmanager.accounts.containers.variables.update
+        # variables.update
         # Corresponds to the JSON property `notes`
         # @return [String]
         attr_accessor :notes
       
-        # The variable's parameters.
+        # The variable's parameters. @mutable tagmanager.accounts.containers.variables.
-        # @mutable tagmanager.accounts.containers.variables.create
+        # create @mutable tagmanager.accounts.containers.variables.update
-        # @mutable tagmanager.accounts.containers.variables.update
         # Corresponds to the JSON property `parameter`
         # @return [Array<Google::Apis::TagmanagerV1::Parameter>]
         attr_accessor :parameter
@@ -1674,23 +1612,22 @@ module Google
         # @return [String]
         attr_accessor :parent_folder_id
       
-        # The end timestamp in milliseconds to schedule a variable.
+        # The end timestamp in milliseconds to schedule a variable. @mutable tagmanager.
-        # @mutable tagmanager.accounts.containers.variables.create
+        # accounts.containers.variables.create @mutable tagmanager.accounts.containers.
-        # @mutable tagmanager.accounts.containers.variables.update
+        # variables.update
         # Corresponds to the JSON property `scheduleEndMs`
         # @return [Fixnum]
         attr_accessor :schedule_end_ms
       
-        # The start timestamp in milliseconds to schedule a variable.
+        # The start timestamp in milliseconds to schedule a variable. @mutable
-        # @mutable tagmanager.accounts.containers.variables.create
+        # tagmanager.accounts.containers.variables.create @mutable tagmanager.accounts.
-        # @mutable tagmanager.accounts.containers.variables.update
+        # containers.variables.update
         # Corresponds to the JSON property `scheduleStartMs`
         # @return [Fixnum]
         attr_accessor :schedule_start_ms
       
-        # GTM Variable Type.
+        # GTM Variable Type. @mutable tagmanager.accounts.containers.variables.create @
-        # @mutable tagmanager.accounts.containers.variables.create
+        # mutable tagmanager.accounts.containers.variables.update
-        # @mutable tagmanager.accounts.containers.variables.update
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type

generated/google/apis/tagmanager_v1/service.rb

@@ -22,8 +22,7 @@ module Google
     module TagmanagerV1
       # Tag Manager API
       #
-      # This API allows clients to access and modify container and tag
+      # This API allows clients to access and modify container and tag configuration.
-      #  configuration.
       #
       # @example
       #    require 'google/apis/tagmanager_v1'
@@ -110,8 +109,8 @@ module Google
         #   The GTM Account ID.
         # @param [Google::Apis::TagmanagerV1::Account] account_object
         # @param [String] fingerprint
-        #   When provided, this fingerprint must match the fingerprint of the account
+        #   When provided, this fingerprint must match the fingerprint of the account in
-        #   in storage.
+        #   storage.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -276,8 +275,8 @@ module Google
         #   The GTM Container ID.
         # @param [Google::Apis::TagmanagerV1::Container] container_object
         # @param [String] fingerprint
-        #   When provided, this fingerprint must match the fingerprint of the
+        #   When provided, this fingerprint must match the fingerprint of the container in
-        #   container in storage.
+        #   storage.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -457,8 +456,8 @@ module Google
         #   The GTM Environment ID.
         # @param [Google::Apis::TagmanagerV1::Environment] environment_object
         # @param [String] fingerprint
-        #   When provided, this fingerprint must match the fingerprint of the
+        #   When provided, this fingerprint must match the fingerprint of the environment
-        #   environment in storage.
+        #   in storage.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1124,8 +1123,8 @@ module Google
         #   The GTM Trigger ID.
         # @param [Google::Apis::TagmanagerV1::Trigger] trigger_object
         # @param [String] fingerprint
-        #   When provided, this fingerprint must match the fingerprint of the trigger
+        #   When provided, this fingerprint must match the fingerprint of the trigger in
-        #   in storage.
+        #   storage.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1306,8 +1305,8 @@ module Google
         #   The GTM Variable ID.
         # @param [Google::Apis::TagmanagerV1::Variable] variable_object
         # @param [String] fingerprint
-        #   When provided, this fingerprint must match the fingerprint of the variable
+        #   When provided, this fingerprint must match the fingerprint of the variable in
-        #   in storage.
+        #   storage.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1416,8 +1415,8 @@ module Google
         # @param [String] container_id
         #   The GTM Container ID.
         # @param [String] container_version_id
-        #   The GTM Container Version ID. Specify <code>published</code> to retrieve
+        #   The GTM Container Version ID. Specify published to retrieve the currently
-        #   the currently published version.
+        #   published version.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1494,8 +1493,8 @@ module Google
         # @param [String] container_version_id
         #   The GTM Container Version ID.
         # @param [String] fingerprint
-        #   When provided, this fingerprint must match the fingerprint of the
+        #   When provided, this fingerprint must match the fingerprint of the container
-        #   container version in storage.
+        #   version in storage.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1527,9 +1526,9 @@ module Google
         end
         
         # Restores a Container Version. This will overwrite the container's current
-        # configuration (including its variables, triggers and tags). The operation
+        # configuration (including its variables, triggers and tags). The operation will
-        # will not have any effect on the version that is being served (i.e. the
+        # not have any effect on the version that is being served (i.e. the published
-        # published version).
+        # version).
         # @param [String] account_id
         #   The GTM Account ID.
         # @param [String] container_id
@@ -1610,8 +1609,8 @@ module Google
         #   The GTM Container Version ID.
         # @param [Google::Apis::TagmanagerV1::ContainerVersion] container_version_object
         # @param [String] fingerprint
-        #   When provided, this fingerprint must match the fingerprint of the
+        #   When provided, this fingerprint must match the fingerprint of the container
-        #   container version in storage.
+        #   version in storage.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user

generated/google/apis/tagmanager_v2.rb

@@ -20,13 +20,12 @@ module Google
   module Apis
     # Tag Manager API
     #
-    # This API allows clients to access and modify container and tag
+    # This API allows clients to access and modify container and tag configuration.
-    # configuration.
     #
     # @see https://developers.google.com/tag-manager
     module TagmanagerV2
       VERSION = 'V2'
-      REVISION = '20200728'
+      REVISION = '20200803'
 
       # Delete your Google Tag Manager containers
       AUTH_TAGMANAGER_DELETE_CONTAINERS = 'https://www.googleapis.com/auth/tagmanager.delete.containers'

generated/google/apis/tagmanager_v2/classes.rb

@@ -31,15 +31,14 @@ module Google
         # @return [String]
         attr_accessor :account_id
       
-        # The fingerprint of the GTM Account as computed at storage time.
+        # The fingerprint of the GTM Account as computed at storage time. This value is
-        # This value is recomputed whenever the account is modified.
+        # recomputed whenever the account is modified.
         # Corresponds to the JSON property `fingerprint`
         # @return [String]
         attr_accessor :fingerprint
       
-        # Account display name.
+        # Account display name. @mutable tagmanager.accounts.create @mutable tagmanager.
-        # @mutable tagmanager.accounts.create
+        # accounts.update
-        # @mutable tagmanager.accounts.update
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -49,13 +48,12 @@ module Google
         # @return [String]
         attr_accessor :path
       
-        # Whether the account shares data anonymously with Google and others.
+        # Whether the account shares data anonymously with Google and others. This flag
-        # This flag enables benchmarking by sharing your data in an anonymous form.
+        # enables benchmarking by sharing your data in an anonymous form. Google will
-        # Google will remove all identifiable information about your website, combine
+        # remove all identifiable information about your website, combine the data with
-        # the data with hundreds of other anonymous sites and report aggregate trends
+        # hundreds of other anonymous sites and report aggregate trends in the
-        # in the benchmarking service.
+        # benchmarking service. @mutable tagmanager.accounts.create @mutable tagmanager.
-        # @mutable tagmanager.accounts.create
+        # accounts.update
-        # @mutable tagmanager.accounts.update
         # Corresponds to the JSON property `shareData`
         # @return [Boolean]
         attr_accessor :share_data
@@ -85,9 +83,9 @@ module Google
       class AccountAccess
         include Google::Apis::Core::Hashable
       
-        # Whether the user has no access, user access, or admin access to an account.
+        # Whether the user has no access, user access, or admin access to an account. @
-        # @mutable tagmanager.accounts.permissions.create
+        # mutable tagmanager.accounts.permissions.create @mutable tagmanager.accounts.
-        # @mutable tagmanager.accounts.permissions.update
+        # permissions.update
         # Corresponds to the JSON property `permission`
         # @return [String]
         attr_accessor :permission
@@ -104,8 +102,8 @@ module Google
       
       # Built-in variables are a special category of variables that are pre-created
       # and non-customizable. They provide common functionality like accessing
-      # propeties of the gtm data layer, monitoring clicks, or accessing elements
+      # propeties of the gtm data layer, monitoring clicks, or accessing elements of a
-      # of a page URL.
+      # page URL.
       class BuiltInVariable
         include Google::Apis::Core::Hashable
       
@@ -129,9 +127,9 @@ module Google
         # @return [String]
         attr_accessor :path
       
-        # Type of built-in variable.
+        # Type of built-in variable. @required.tagmanager.accounts.containers.workspaces.
-        # @required.tagmanager.accounts.containers.workspaces.built_in_variable.update
+        # built_in_variable.update @mutable tagmanager.accounts.containers.workspaces.
-        # @mutable tagmanager.accounts.containers.workspaces.built_in_variable.update
+        # built_in_variable.update
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type
@@ -175,22 +173,22 @@ module Google
         # @return [String]
         attr_accessor :container_id
       
-        # The fingerprint of the GTM Client as computed at storage time.
+        # The fingerprint of the GTM Client as computed at storage time. This value is
-        # This value is recomputed whenever the client is modified.
+        # recomputed whenever the client is modified.
         # Corresponds to the JSON property `fingerprint`
         # @return [String]
         attr_accessor :fingerprint
       
-        # Client display name.
+        # Client display name. @mutable tagmanager.accounts.containers.workspaces.
-        # @mutable tagmanager.accounts.containers.workspaces.clients.create
+        # clients.create @mutable tagmanager.accounts.containers.workspaces.clients.
-        # @mutable tagmanager.accounts.containers.workspaces.clients.update
+        # update
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # The client's parameters.
+        # The client's parameters. @mutable tagmanager.accounts.containers.workspaces.
-        # @mutable tagmanager.accounts.containers.workspaces.clients.create
+        # clients.create @mutable tagmanager.accounts.containers.workspaces.clients.
-        # @mutable tagmanager.accounts.containers.workspaces.clients.update
+        # update
         # Corresponds to the JSON property `parameter`
         # @return [Array<Google::Apis::TagmanagerV2::Parameter>]
         attr_accessor :parameter
@@ -205,9 +203,9 @@ module Google
         # @return [String]
         attr_accessor :path
       
-        # Priority determines relative firing order.
+        # Priority determines relative firing order. @mutable tagmanager.accounts.
-        # @mutable tagmanager.accounts.containers.workspaces.clients.create
+        # containers.workspaces.clients.create @mutable tagmanager.accounts.containers.
-        # @mutable tagmanager.accounts.containers.workspaces.clients.update
+        # workspaces.clients.update
         # Corresponds to the JSON property `priority`
         # @return [Fixnum]
         attr_accessor :priority
@@ -217,8 +215,7 @@ module Google
         # @return [String]
         attr_accessor :tag_manager_url
       
-        # Client type.
+        # Client type. @mutable tagmanager.accounts.containers.workspaces.clients.create
-        # @mutable tagmanager.accounts.containers.workspaces.clients.create
         # @mutable tagmanager.accounts.containers.workspaces.clients.update
         # Corresponds to the JSON property `type`
         # @return [String]
@@ -255,29 +252,22 @@ module Google
         include Google::Apis::Core::Hashable
       
         # A list of named parameters (key/value), depending on the condition's type.
-        # Notes:<ul>
+        # Notes: - For binary operators, include parameters named arg0 and arg1 for
-        # <li>For binary operators, include parameters named <code>arg0</code> and
+        # specifying the left and right operands, respectively. - At this time, the left
-        # <code>arg1</code> for specifying the left and right operands,
+        # operand (arg0) must be a reference to a variable. - For case-insensitive Regex
-        # respectively.</li>
+        # matching, include a boolean parameter named ignore_case that is set to true.
-        # <li>At this time, the left operand (<code>arg0</code>) must be a reference
-        # to a variable.</li>
-        # <li>For case-insensitive Regex matching, include a boolean parameter named
-        # <code>ignore_case</code> that is set to <code>true</code>.
         # If not specified or set to any other value, the matching will be case
-        # sensitive.</li>
+        # sensitive. - To negate an operator, include a boolean parameter named negate
-        # <li>To negate an operator, include a boolean parameter named
+        # boolean parameter that is set to true. @mutable tagmanager.accounts.containers.
-        # <code>negate</code> boolean parameter that is set to <code>true</code>.
+        # workspaces.triggers.create @mutable tagmanager.accounts.containers.workspaces.
-        # </li>
+        # triggers.update
-        # </ul>
-        # @mutable tagmanager.accounts.containers.workspaces.triggers.create
-        # @mutable tagmanager.accounts.containers.workspaces.triggers.update
         # Corresponds to the JSON property `parameter`
         # @return [Array<Google::Apis::TagmanagerV2::Parameter>]
         attr_accessor :parameter
       
-        # The type of operator for this condition.
+        # The type of operator for this condition. @mutable tagmanager.accounts.
-        # @mutable tagmanager.accounts.containers.workspaces.triggers.create
+        # containers.workspaces.triggers.create @mutable tagmanager.accounts.containers.
-        # @mutable tagmanager.accounts.containers.workspaces.triggers.update
+        # workspaces.triggers.update
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type
@@ -308,29 +298,26 @@ module Google
         # @return [String]
         attr_accessor :container_id
       
-        # List of domain names associated with the Container.
+        # List of domain names associated with the Container. @mutable tagmanager.
-        # @mutable tagmanager.accounts.containers.create
+        # accounts.containers.create @mutable tagmanager.accounts.containers.update
-        # @mutable tagmanager.accounts.containers.update
         # Corresponds to the JSON property `domainName`
         # @return [Array<String>]
         attr_accessor :domain_name
       
-        # The fingerprint of the GTM Container as computed at storage time.  This
+        # The fingerprint of the GTM Container as computed at storage time. This value
-        # value is recomputed whenever the account is modified.
+        # is recomputed whenever the account is modified.
         # Corresponds to the JSON property `fingerprint`
         # @return [String]
         attr_accessor :fingerprint
       
-        # Container display name.
+        # Container display name. @mutable tagmanager.accounts.containers.create @
-        # @mutable tagmanager.accounts.containers.create
+        # mutable tagmanager.accounts.containers.update
-        # @mutable tagmanager.accounts.containers.update
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # Container Notes.
+        # Container Notes. @mutable tagmanager.accounts.containers.create @mutable
-        # @mutable tagmanager.accounts.containers.create
+        # tagmanager.accounts.containers.update
-        # @mutable tagmanager.accounts.containers.update
         # Corresponds to the JSON property `notes`
         # @return [String]
         attr_accessor :notes
@@ -350,10 +337,9 @@ module Google
         # @return [String]
         attr_accessor :tag_manager_url
       
-        # List of Usage Contexts for the Container. Valid values include: <code>web,
+        # List of Usage Contexts for the Container. Valid values include: web, android,
-        # android, or ios</code>.
+        # or ios. @mutable tagmanager.accounts.containers.create @mutable tagmanager.
-        # @mutable tagmanager.accounts.containers.create
+        # accounts.containers.update
-        # @mutable tagmanager.accounts.containers.update
         # Corresponds to the JSON property `usageContext`
         # @return [Array<String>]
         attr_accessor :usage_context
@@ -381,15 +367,13 @@ module Google
       class ContainerAccess
         include Google::Apis::Core::Hashable
       
-        # GTM Container ID.
+        # GTM Container ID. @mutable tagmanager.accounts.permissions.create @mutable
-        # @mutable tagmanager.accounts.permissions.create
+        # tagmanager.accounts.permissions.update
-        # @mutable tagmanager.accounts.permissions.update
         # Corresponds to the JSON property `containerId`
         # @return [String]
         attr_accessor :container_id
       
-        # List of Container permissions.
+        # List of Container permissions. @mutable tagmanager.accounts.permissions.create
-        # @mutable tagmanager.accounts.permissions.create
         # @mutable tagmanager.accounts.permissions.update
         # Corresponds to the JSON property `permission`
         # @return [String]
@@ -452,15 +436,14 @@ module Google
         attr_accessor :deleted
         alias_method :deleted?, :deleted
       
-        # Container version description.
+        # Container version description. @mutable tagmanager.accounts.containers.
-        # @mutable tagmanager.accounts.containers.versions.update
+        # versions.update
         # Corresponds to the JSON property `description`
         # @return [String]
         attr_accessor :description
       
-        # The fingerprint of the GTM Container Version as computed at
+        # The fingerprint of the GTM Container Version as computed at storage time. This
-        # storage time. This value is recomputed whenever the container version is
+        # value is recomputed whenever the container version is modified.
-        # modified.
         # Corresponds to the JSON property `fingerprint`
         # @return [String]
         attr_accessor :fingerprint
@@ -470,8 +453,8 @@ module Google
         # @return [Array<Google::Apis::TagmanagerV2::Folder>]
         attr_accessor :folder
       
-        # Container version display name.
+        # Container version display name. @mutable tagmanager.accounts.containers.
-        # @mutable tagmanager.accounts.containers.versions.update
+        # versions.update
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -685,8 +668,7 @@ module Google
         attr_accessor :container_version
       
         # Auto generated workspace path created as a result of version creation. This
-        # field should only be populated if the created version was not a quick
+        # field should only be populated if the created version was not a quick preview.
-        # preview.
         # Corresponds to the JSON property `newWorkspacePath`
         # @return [String]
         attr_accessor :new_workspace_path
@@ -723,8 +705,8 @@ module Google
         # @return [String]
         attr_accessor :container_id
       
-        # The fingerprint of the GTM Custom Template as computed at storage time.
+        # The fingerprint of the GTM Custom Template as computed at storage time. This
-        # This value is recomputed whenever the template is modified.
+        # value is recomputed whenever the template is modified.
         # Corresponds to the JSON property `fingerprint`
         # @return [String]
         attr_accessor :fingerprint
@@ -860,16 +842,15 @@ module Google
         attr_accessor :container_version_id
       
         # The environment description. Can be set or changed only on USER type
-        # environments.
+        # environments. @mutable tagmanager.accounts.containers.environments.create @
-        # @mutable tagmanager.accounts.containers.environments.create
+        # mutable tagmanager.accounts.containers.environments.update
-        # @mutable tagmanager.accounts.containers.environments.update
         # Corresponds to the JSON property `description`
         # @return [String]
         attr_accessor :description
       
-        # Whether or not to enable debug by default for the environment.
+        # Whether or not to enable debug by default for the environment. @mutable
-        # @mutable tagmanager.accounts.containers.environments.create
+        # tagmanager.accounts.containers.environments.create @mutable tagmanager.
-        # @mutable tagmanager.accounts.containers.environments.update
+        # accounts.containers.environments.update
         # Corresponds to the JSON property `enableDebug`
         # @return [Boolean]
         attr_accessor :enable_debug
@@ -880,16 +861,15 @@ module Google
         # @return [String]
         attr_accessor :environment_id
       
-        # The fingerprint of the GTM environment as computed at storage time.
+        # The fingerprint of the GTM environment as computed at storage time. This value
-        # This value is recomputed whenever the environment is modified.
+        # is recomputed whenever the environment is modified.
         # Corresponds to the JSON property `fingerprint`
         # @return [String]
         attr_accessor :fingerprint
       
         # The environment display name. Can be set or changed only on USER type
-        # environments.
+        # environments. @mutable tagmanager.accounts.containers.environments.create @
-        # @mutable tagmanager.accounts.containers.environments.create
+        # mutable tagmanager.accounts.containers.environments.update
-        # @mutable tagmanager.accounts.containers.environments.update
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -909,9 +889,9 @@ module Google
         # @return [String]
         attr_accessor :type
       
-        # Default preview page url for the environment.
+        # Default preview page url for the environment. @mutable tagmanager.accounts.
-        # @mutable tagmanager.accounts.containers.environments.create
+        # containers.environments.create @mutable tagmanager.accounts.containers.
-        # @mutable tagmanager.accounts.containers.environments.update
+        # environments.update
         # Corresponds to the JSON property `url`
         # @return [String]
         attr_accessor :url
@@ -959,8 +939,8 @@ module Google
         # @return [String]
         attr_accessor :container_id
       
-        # The fingerprint of the GTM Folder as computed at storage time.
+        # The fingerprint of the GTM Folder as computed at storage time. This value is
-        # This value is recomputed whenever the folder is modified.
+        # recomputed whenever the folder is modified.
         # Corresponds to the JSON property `fingerprint`
         # @return [String]
         attr_accessor :fingerprint
@@ -970,16 +950,16 @@ module Google
         # @return [String]
         attr_accessor :folder_id
       
-        # Folder display name.
+        # Folder display name. @mutable tagmanager.accounts.containers.workspaces.
-        # @mutable tagmanager.accounts.containers.workspaces.folders.create
+        # folders.create @mutable tagmanager.accounts.containers.workspaces.folders.
-        # @mutable tagmanager.accounts.containers.workspaces.folders.update
+        # update
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # User notes on how to apply this folder in the container.
+        # User notes on how to apply this folder in the container. @mutable tagmanager.
-        # @mutable tagmanager.accounts.containers.workspaces.folders.create
+        # accounts.containers.workspaces.folders.create @mutable tagmanager.accounts.
-        # @mutable tagmanager.accounts.containers.workspaces.folders.update
+        # containers.workspaces.folders.update
         # Corresponds to the JSON property `notes`
         # @return [String]
         attr_accessor :notes
@@ -1064,7 +1044,7 @@ module Google
         # @return [String]
         attr_accessor :host
       
-        # If a user has manually edited the community  gallery template.
+        # If a user has manually edited the community gallery template.
         # Corresponds to the JSON property `isModified`
         # @return [Boolean]
         attr_accessor :is_modified
@@ -1488,74 +1468,62 @@ module Google
       class Parameter
         include Google::Apis::Core::Hashable
       
-        # The named key that uniquely identifies a parameter.  Required for top-level
+        # The named key that uniquely identifies a parameter. Required for top-level
-        # parameters, as well as map values.  Ignored for list values.
+        # parameters, as well as map values. Ignored for list values. @mutable
-        # @mutable tagmanager.accounts.containers.workspaces.variables.create
+        # tagmanager.accounts.containers.workspaces.variables.create @mutable tagmanager.
-        # @mutable tagmanager.accounts.containers.workspaces.variables.update
+        # accounts.containers.workspaces.variables.update @mutable tagmanager.accounts.
-        # @mutable tagmanager.accounts.containers.workspaces.triggers.create
+        # containers.workspaces.triggers.create @mutable tagmanager.accounts.containers.
-        # @mutable tagmanager.accounts.containers.workspaces.triggers.update
+        # workspaces.triggers.update @mutable tagmanager.accounts.containers.workspaces.
-        # @mutable tagmanager.accounts.containers.workspaces.tags.create
+        # tags.create @mutable tagmanager.accounts.containers.workspaces.tags.update
-        # @mutable tagmanager.accounts.containers.workspaces.tags.update
         # Corresponds to the JSON property `key`
         # @return [String]
         attr_accessor :key
       
-        # This list parameter's parameters (keys will be ignored).
+        # This list parameter's parameters (keys will be ignored). @mutable tagmanager.
-        # @mutable tagmanager.accounts.containers.workspaces.variables.create
+        # accounts.containers.workspaces.variables.create @mutable tagmanager.accounts.
-        # @mutable tagmanager.accounts.containers.workspaces.variables.update
+        # containers.workspaces.variables.update @mutable tagmanager.accounts.containers.
-        # @mutable tagmanager.accounts.containers.workspaces.triggers.create
+        # workspaces.triggers.create @mutable tagmanager.accounts.containers.workspaces.
-        # @mutable tagmanager.accounts.containers.workspaces.triggers.update
+        # triggers.update @mutable tagmanager.accounts.containers.workspaces.tags.create
-        # @mutable tagmanager.accounts.containers.workspaces.tags.create
         # @mutable tagmanager.accounts.containers.workspaces.tags.update
         # Corresponds to the JSON property `list`
         # @return [Array<Google::Apis::TagmanagerV2::Parameter>]
         attr_accessor :list
       
-        # This map parameter's parameters (must have keys; keys must be unique).
+        # This map parameter's parameters (must have keys; keys must be unique). @
-        # @mutable tagmanager.accounts.containers.workspaces.variables.create
+        # mutable tagmanager.accounts.containers.workspaces.variables.create @mutable
-        # @mutable tagmanager.accounts.containers.workspaces.variables.update
+        # tagmanager.accounts.containers.workspaces.variables.update @mutable tagmanager.
-        # @mutable tagmanager.accounts.containers.workspaces.triggers.create
+        # accounts.containers.workspaces.triggers.create @mutable tagmanager.accounts.
-        # @mutable tagmanager.accounts.containers.workspaces.triggers.update
+        # containers.workspaces.triggers.update @mutable tagmanager.accounts.containers.
-        # @mutable tagmanager.accounts.containers.workspaces.tags.create
+        # workspaces.tags.create @mutable tagmanager.accounts.containers.workspaces.tags.
-        # @mutable tagmanager.accounts.containers.workspaces.tags.update
+        # update
         # Corresponds to the JSON property `map`
         # @return [Array<Google::Apis::TagmanagerV2::Parameter>]
         attr_accessor :map
       
-        # The parameter type.  Valid values are:<ul>
+        # The parameter type. Valid values are: - boolean: The value represents a
-        # <li><code>boolean</code>: The value represents a boolean, represented as
+        # boolean, represented as 'true' or 'false' - integer: The value represents a 64-
-        # 'true' or 'false'</li>
+        # bit signed integer value, in base 10 - list: A list of parameters should be
-        # <li><code>integer</code>: The value represents a 64-bit signed integer
+        # specified - map: A map of parameters should be specified - template: The value
-        # value, in base 10</li>
+        # represents any text; this can include variable references (even variable
-        # <li><code>list</code>: A list of parameters should be specified</li>
+        # references that might return non-string types) - trigger_reference: The value
-        # <li><code>map</code>: A map of parameters should be specified</li>
+        # represents a trigger, represented as the trigger id - tag_reference: The value
-        # <li><code>template</code>: The value represents any text; this can include
+        # represents a tag, represented as the tag name @mutable tagmanager.accounts.
-        # variable references (even variable references that might return
+        # containers.workspaces.variables.create @mutable tagmanager.accounts.containers.
-        # non-string types)</li>
+        # workspaces.variables.update @mutable tagmanager.accounts.containers.workspaces.
-        # <li><code>trigger_reference</code>: The value represents a trigger,
+        # triggers.create @mutable tagmanager.accounts.containers.workspaces.triggers.
-        # represented as the trigger id</li>
+        # update @mutable tagmanager.accounts.containers.workspaces.tags.create @mutable
-        # <li><code>tag_reference</code>: The value represents a tag, represented as
+        # tagmanager.accounts.containers.workspaces.tags.update
-        # the tag name</li>
-        # </ul>
-        # @mutable tagmanager.accounts.containers.workspaces.variables.create
-        # @mutable tagmanager.accounts.containers.workspaces.variables.update
-        # @mutable tagmanager.accounts.containers.workspaces.triggers.create
-        # @mutable tagmanager.accounts.containers.workspaces.triggers.update
-        # @mutable tagmanager.accounts.containers.workspaces.tags.create
-        # @mutable tagmanager.accounts.containers.workspaces.tags.update
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type
       
-        # A parameter's value (may contain variable references such as
+        # A parameter's value (may contain variable references such as "``myVariable``")
-        # "``myVariable``")
+        # as appropriate to the specified type. @mutable tagmanager.accounts.containers.
-        # as appropriate to the specified type.
+        # workspaces.variables.create @mutable tagmanager.accounts.containers.workspaces.
-        # @mutable tagmanager.accounts.containers.workspaces.variables.create
+        # variables.update @mutable tagmanager.accounts.containers.workspaces.triggers.
-        # @mutable tagmanager.accounts.containers.workspaces.variables.update
+        # create @mutable tagmanager.accounts.containers.workspaces.triggers.update @
-        # @mutable tagmanager.accounts.containers.workspaces.triggers.create
+        # mutable tagmanager.accounts.containers.workspaces.tags.create @mutable
-        # @mutable tagmanager.accounts.containers.workspaces.triggers.update
+        # tagmanager.accounts.containers.workspaces.tags.update
-        # @mutable tagmanager.accounts.containers.workspaces.tags.create
-        # @mutable tagmanager.accounts.containers.workspaces.tags.update
         # Corresponds to the JSON property `value`
         # @return [String]
         attr_accessor :value
@@ -1766,14 +1734,13 @@ module Google
         end
       end
       
-      # Represents a reference to atag that fires before another tag in order to
+      # Represents a reference to atag that fires before another tag in order to set
-      # set up dependencies.
+      # up dependencies.
       class SetupTag
         include Google::Apis::Core::Hashable
       
-        # If true, fire the main tag if and only if the setup tag fires
+        # If true, fire the main tag if and only if the setup tag fires successfully. If
-        # successfully.
+        # false, fire the main tag regardless of setup tag firing status.
-        # If false, fire the main tag regardless of setup tag firing status.
         # Corresponds to the JSON property `stopOnSetupFailure`
         # @return [Boolean]
         attr_accessor :stop_on_setup_failure
@@ -1826,9 +1793,9 @@ module Google
       class SyncWorkspaceResponse
         include Google::Apis::Core::Hashable
       
-        # The merge conflict after sync.
+        # The merge conflict after sync. If this field is not empty, the sync is still
-        # If this field is not empty, the sync is still treated as successful.
+        # treated as successful. But a version cannot be created until all conflicts are
-        # But a version cannot be created until all conflicts are resolved.
+        # resolved.
         # Corresponds to the JSON property `mergeConflict`
         # @return [Array<Google::Apis::TagmanagerV2::MergeConflict>]
         attr_accessor :merge_conflict
@@ -1858,18 +1825,16 @@ module Google
         # @return [String]
         attr_accessor :account_id
       
-        # Blocking rule IDs. If any of the listed rules evaluate to true, the tag
+        # Blocking rule IDs. If any of the listed rules evaluate to true, the tag will
-        # will not fire.
+        # not fire. @mutable tagmanager.accounts.containers.workspaces.tags.create @
-        # @mutable tagmanager.accounts.containers.workspaces.tags.create
+        # mutable tagmanager.accounts.containers.workspaces.tags.update
-        # @mutable tagmanager.accounts.containers.workspaces.tags.update
         # Corresponds to the JSON property `blockingRuleId`
         # @return [Array<String>]
         attr_accessor :blocking_rule_id
       
-        # Blocking trigger IDs. If any of the listed triggers evaluate to true, the
+        # Blocking trigger IDs. If any of the listed triggers evaluate to true, the tag
-        # tag will not fire.
+        # will not fire. @mutable tagmanager.accounts.containers.workspaces.tags.create @
-        # @mutable tagmanager.accounts.containers.workspaces.tags.create
+        # mutable tagmanager.accounts.containers.workspaces.tags.update
-        # @mutable tagmanager.accounts.containers.workspaces.tags.update
         # Corresponds to the JSON property `blockingTriggerId`
         # @return [Array<String>]
         attr_accessor :blocking_trigger_id
@@ -1879,33 +1844,31 @@ module Google
         # @return [String]
         attr_accessor :container_id
       
-        # The fingerprint of the GTM Tag as computed at storage time.
+        # The fingerprint of the GTM Tag as computed at storage time. This value is
-        # This value is recomputed whenever the tag is modified.
+        # recomputed whenever the tag is modified.
         # Corresponds to the JSON property `fingerprint`
         # @return [String]
         attr_accessor :fingerprint
       
-        # Firing rule IDs. A tag will fire when any of the listed rules are true and
+        # Firing rule IDs. A tag will fire when any of the listed rules are true and all
-        # all of its <code>blockingRuleIds</code> (if any specified) are false.
+        # of its blockingRuleIds (if any specified) are false. @mutable tagmanager.
-        # @mutable tagmanager.accounts.containers.workspaces.tags.create
+        # accounts.containers.workspaces.tags.create @mutable tagmanager.accounts.
-        # @mutable tagmanager.accounts.containers.workspaces.tags.update
+        # containers.workspaces.tags.update
         # Corresponds to the JSON property `firingRuleId`
         # @return [Array<String>]
         attr_accessor :firing_rule_id
       
-        # Firing trigger IDs. A tag will fire when any of the listed triggers are
+        # Firing trigger IDs. A tag will fire when any of the listed triggers are true
-        # true and all of its <code>blockingTriggerIds</code> (if any specified) are
+        # and all of its blockingTriggerIds (if any specified) are false. @mutable
-        # false.
+        # tagmanager.accounts.containers.workspaces.tags.create @mutable tagmanager.
-        # @mutable tagmanager.accounts.containers.workspaces.tags.create
+        # accounts.containers.workspaces.tags.update
-        # @mutable tagmanager.accounts.containers.workspaces.tags.update
         # Corresponds to the JSON property `firingTriggerId`
         # @return [Array<String>]
         attr_accessor :firing_trigger_id
       
-        # If set to true, this tag will only fire in the live environment (e.g. not
+        # If set to true, this tag will only fire in the live environment (e.g. not in
-        # in preview or debug mode).
+        # preview or debug mode). @mutable tagmanager.accounts.containers.workspaces.
-        # @mutable tagmanager.accounts.containers.workspaces.tags.create
+        # tags.create @mutable tagmanager.accounts.containers.workspaces.tags.update
-        # @mutable tagmanager.accounts.containers.workspaces.tags.update
         # Corresponds to the JSON property `liveOnly`
         # @return [Boolean]
         attr_accessor :live_only
@@ -1917,30 +1880,28 @@ module Google
         attr_accessor :monitoring_metadata
       
         # If non-empty, then the tag display name will be included in the monitoring
-        # metadata map using the key specified.
+        # metadata map using the key specified. @mutable tagmanager.accounts.containers.
-        # @mutable tagmanager.accounts.containers.workspaces.tags.create
+        # workspaces.tags.create @mutable tagmanager.accounts.containers.workspaces.tags.
-        # @mutable tagmanager.accounts.containers.workspaces.tags.update
+        # update
         # Corresponds to the JSON property `monitoringMetadataTagNameKey`
         # @return [String]
         attr_accessor :monitoring_metadata_tag_name_key
       
-        # Tag display name.
+        # Tag display name. @mutable tagmanager.accounts.containers.workspaces.tags.
-        # @mutable tagmanager.accounts.containers.workspaces.tags.create
+        # create @mutable tagmanager.accounts.containers.workspaces.tags.update
-        # @mutable tagmanager.accounts.containers.workspaces.tags.update
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # User notes on how to apply this tag in the container.
+        # User notes on how to apply this tag in the container. @mutable tagmanager.
-        # @mutable tagmanager.accounts.containers.workspaces.tags.create
+        # accounts.containers.workspaces.tags.create @mutable tagmanager.accounts.
-        # @mutable tagmanager.accounts.containers.workspaces.tags.update
+        # containers.workspaces.tags.update
         # Corresponds to the JSON property `notes`
         # @return [String]
         attr_accessor :notes
       
-        # The tag's parameters.
+        # The tag's parameters. @mutable tagmanager.accounts.containers.workspaces.tags.
-        # @mutable tagmanager.accounts.containers.workspaces.tags.create
+        # create @mutable tagmanager.accounts.containers.workspaces.tags.update
-        # @mutable tagmanager.accounts.containers.workspaces.tags.update
         # Corresponds to the JSON property `parameter`
         # @return [Array<Google::Apis::TagmanagerV2::Parameter>]
         attr_accessor :parameter
@@ -1955,9 +1916,9 @@ module Google
         # @return [String]
         attr_accessor :path
       
-        # Indicates whether the tag is paused, which prevents the tag from firing.
+        # Indicates whether the tag is paused, which prevents the tag from firing. @
-        # @mutable tagmanager.accounts.containers.workspaces.tags.create
+        # mutable tagmanager.accounts.containers.workspaces.tags.create @mutable
-        # @mutable tagmanager.accounts.containers.workspaces.tags.update
+        # tagmanager.accounts.containers.workspaces.tags.update
         # Corresponds to the JSON property `paused`
         # @return [Boolean]
         attr_accessor :paused
@@ -1968,16 +1929,16 @@ module Google
         # @return [Google::Apis::TagmanagerV2::Parameter]
         attr_accessor :priority
       
-        # The end timestamp in milliseconds to schedule a tag.
+        # The end timestamp in milliseconds to schedule a tag. @mutable tagmanager.
-        # @mutable tagmanager.accounts.containers.workspaces.tags.create
+        # accounts.containers.workspaces.tags.create @mutable tagmanager.accounts.
-        # @mutable tagmanager.accounts.containers.workspaces.tags.update
+        # containers.workspaces.tags.update
         # Corresponds to the JSON property `scheduleEndMs`
         # @return [Fixnum]
         attr_accessor :schedule_end_ms
       
-        # The start timestamp in milliseconds to schedule a tag.
+        # The start timestamp in milliseconds to schedule a tag. @mutable tagmanager.
-        # @mutable tagmanager.accounts.containers.workspaces.tags.create
+        # accounts.containers.workspaces.tags.create @mutable tagmanager.accounts.
-        # @mutable tagmanager.accounts.containers.workspaces.tags.update
+        # containers.workspaces.tags.update
         # Corresponds to the JSON property `scheduleStartMs`
         # @return [Fixnum]
         attr_accessor :schedule_start_ms
@@ -2007,9 +1968,8 @@ module Google
         # @return [Array<Google::Apis::TagmanagerV2::TeardownTag>]
         attr_accessor :teardown_tag
       
-        # GTM Tag Type.
+        # GTM Tag Type. @mutable tagmanager.accounts.containers.workspaces.tags.create @
-        # @mutable tagmanager.accounts.containers.workspaces.tags.create
+        # mutable tagmanager.accounts.containers.workspaces.tags.update
-        # @mutable tagmanager.accounts.containers.workspaces.tags.update
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type
@@ -2059,8 +2019,7 @@ module Google
       class TeardownTag
         include Google::Apis::Core::Hashable
       
-        # If true, fire the teardown tag if and only if the main tag fires
+        # If true, fire the teardown tag if and only if the main tag fires successfully.
-        # successfully.
         # If false, fire the teardown tag regardless of main tag firing status.
         # Corresponds to the JSON property `stopTeardownOnFailure`
         # @return [Boolean]
@@ -2092,9 +2051,9 @@ module Google
         # @return [String]
         attr_accessor :account_id
       
-        # Used in the case of auto event tracking.
+        # Used in the case of auto event tracking. @mutable tagmanager.accounts.
-        # @mutable tagmanager.accounts.containers.workspaces.triggers.create
+        # containers.workspaces.triggers.create @mutable tagmanager.accounts.containers.
-        # @mutable tagmanager.accounts.containers.workspaces.triggers.update
+        # workspaces.triggers.update
         # Corresponds to the JSON property `autoEventFilter`
         # @return [Array<Google::Apis::TagmanagerV2::Condition>]
         attr_accessor :auto_event_filter
@@ -2114,10 +2073,9 @@ module Google
         # @return [Google::Apis::TagmanagerV2::Parameter]
         attr_accessor :continuous_time_min_milliseconds
       
-        # Used in the case of custom event, which is fired iff all Conditions are
+        # Used in the case of custom event, which is fired iff all Conditions are true. @
-        # true.
+        # mutable tagmanager.accounts.containers.workspaces.triggers.create @mutable
-        # @mutable tagmanager.accounts.containers.workspaces.triggers.create
+        # tagmanager.accounts.containers.workspaces.triggers.update
-        # @mutable tagmanager.accounts.containers.workspaces.triggers.update
         # Corresponds to the JSON property `customEventFilter`
         # @return [Array<Google::Apis::TagmanagerV2::Condition>]
         attr_accessor :custom_event_filter
@@ -2127,15 +2085,15 @@ module Google
         # @return [Google::Apis::TagmanagerV2::Parameter]
         attr_accessor :event_name
       
-        # The trigger will only fire iff all Conditions are true.
+        # The trigger will only fire iff all Conditions are true. @mutable tagmanager.
-        # @mutable tagmanager.accounts.containers.workspaces.triggers.create
+        # accounts.containers.workspaces.triggers.create @mutable tagmanager.accounts.
-        # @mutable tagmanager.accounts.containers.workspaces.triggers.update
+        # containers.workspaces.triggers.update
         # Corresponds to the JSON property `filter`
         # @return [Array<Google::Apis::TagmanagerV2::Condition>]
         attr_accessor :filter
       
-        # The fingerprint of the GTM Trigger as computed at storage time.
+        # The fingerprint of the GTM Trigger as computed at storage time. This value is
-        # This value is recomputed whenever the trigger is modified.
+        # recomputed whenever the trigger is modified.
         # Corresponds to the JSON property `fingerprint`
         # @return [String]
         attr_accessor :fingerprint
@@ -2165,23 +2123,23 @@ module Google
         # @return [Google::Apis::TagmanagerV2::Parameter]
         attr_accessor :max_timer_length_seconds
       
-        # Trigger display name.
+        # Trigger display name. @mutable tagmanager.accounts.containers.workspaces.
-        # @mutable tagmanager.accounts.containers.workspaces.triggers.create
+        # triggers.create @mutable tagmanager.accounts.containers.workspaces.triggers.
-        # @mutable tagmanager.accounts.containers.workspaces.triggers.update
+        # update
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # User notes on how to apply this trigger in the container.
+        # User notes on how to apply this trigger in the container. @mutable tagmanager.
-        # @mutable tagmanager.accounts.containers.workspaces.triggers.create
+        # accounts.containers.workspaces.triggers.create @mutable tagmanager.accounts.
-        # @mutable tagmanager.accounts.containers.workspaces.triggers.update
+        # containers.workspaces.triggers.update
         # Corresponds to the JSON property `notes`
         # @return [String]
         attr_accessor :notes
       
-        # Additional parameters.
+        # Additional parameters. @mutable tagmanager.accounts.containers.workspaces.
-        # @mutable tagmanager.accounts.containers.workspaces.triggers.create
+        # triggers.create @mutable tagmanager.accounts.containers.workspaces.triggers.
-        # @mutable tagmanager.accounts.containers.workspaces.triggers.update
+        # update
         # Corresponds to the JSON property `parameter`
         # @return [Array<Google::Apis::TagmanagerV2::Parameter>]
         attr_accessor :parameter
@@ -2216,9 +2174,9 @@ module Google
         # @return [String]
         attr_accessor :trigger_id
       
-        # Defines the data layer event that causes this trigger.
+        # Defines the data layer event that causes this trigger. @mutable tagmanager.
-        # @mutable tagmanager.accounts.containers.workspaces.triggers.create
+        # accounts.containers.workspaces.triggers.create @mutable tagmanager.accounts.
-        # @mutable tagmanager.accounts.containers.workspaces.triggers.update
+        # containers.workspaces.triggers.update
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type
@@ -2318,15 +2276,13 @@ module Google
         # @return [String]
         attr_accessor :account_id
       
-        # GTM Container access permissions.
+        # GTM Container access permissions. @mutable tagmanager.accounts.permissions.
-        # @mutable tagmanager.accounts.permissions.create
+        # create @mutable tagmanager.accounts.permissions.update
-        # @mutable tagmanager.accounts.permissions.update
         # Corresponds to the JSON property `containerAccess`
         # @return [Array<Google::Apis::TagmanagerV2::ContainerAccess>]
         attr_accessor :container_access
       
-        # User's email address.
+        # User's email address. @mutable tagmanager.accounts.permissions.create
-        # @mutable tagmanager.accounts.permissions.create
         # Corresponds to the JSON property `emailAddress`
         # @return [String]
         attr_accessor :email_address
@@ -2366,24 +2322,24 @@ module Google
       
         # For mobile containers only: A list of trigger IDs for disabling conditional
         # variables; the variable is enabled if one of the enabling trigger is true
-        # while all the disabling trigger are false. Treated as an unordered set.
+        # while all the disabling trigger are false. Treated as an unordered set. @
-        # @mutable tagmanager.accounts.containers.workspaces.variables.create
+        # mutable tagmanager.accounts.containers.workspaces.variables.create @mutable
-        # @mutable tagmanager.accounts.containers.workspaces.variables.update
+        # tagmanager.accounts.containers.workspaces.variables.update
         # Corresponds to the JSON property `disablingTriggerId`
         # @return [Array<String>]
         attr_accessor :disabling_trigger_id
       
         # For mobile containers only: A list of trigger IDs for enabling conditional
         # variables; the variable is enabled if one of the enabling triggers is true
-        # while all the disabling triggers are false. Treated as an unordered set.
+        # while all the disabling triggers are false. Treated as an unordered set. @
-        # @mutable tagmanager.accounts.containers.workspaces.variables.create
+        # mutable tagmanager.accounts.containers.workspaces.variables.create @mutable
-        # @mutable tagmanager.accounts.containers.workspaces.variables.update
+        # tagmanager.accounts.containers.workspaces.variables.update
         # Corresponds to the JSON property `enablingTriggerId`
         # @return [Array<String>]
         attr_accessor :enabling_trigger_id
       
-        # The fingerprint of the GTM Variable as computed at storage time.
+        # The fingerprint of the GTM Variable as computed at storage time. This value is
-        # This value is recomputed whenever the variable is modified.
+        # recomputed whenever the variable is modified.
         # Corresponds to the JSON property `fingerprint`
         # @return [String]
         attr_accessor :fingerprint
@@ -2393,23 +2349,23 @@ module Google
         # @return [Google::Apis::TagmanagerV2::VariableFormatValue]
         attr_accessor :format_value
       
-        # Variable display name.
+        # Variable display name. @mutable tagmanager.accounts.containers.workspaces.
-        # @mutable tagmanager.accounts.containers.workspaces.variables.create
+        # variables.create @mutable tagmanager.accounts.containers.workspaces.variables.
-        # @mutable tagmanager.accounts.containers.workspaces.variables.update
+        # update
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # User notes on how to apply this variable in the container.
+        # User notes on how to apply this variable in the container. @mutable tagmanager.
-        # @mutable tagmanager.accounts.containers.workspaces.variables.create
+        # accounts.containers.workspaces.variables.create @mutable tagmanager.accounts.
-        # @mutable tagmanager.accounts.containers.workspaces.variables.update
+        # containers.workspaces.variables.update
         # Corresponds to the JSON property `notes`
         # @return [String]
         attr_accessor :notes
       
-        # The variable's parameters.
+        # The variable's parameters. @mutable tagmanager.accounts.containers.workspaces.
-        # @mutable tagmanager.accounts.containers.workspaces.variables.create
+        # variables.create @mutable tagmanager.accounts.containers.workspaces.variables.
-        # @mutable tagmanager.accounts.containers.workspaces.variables.update
+        # update
         # Corresponds to the JSON property `parameter`
         # @return [Array<Google::Apis::TagmanagerV2::Parameter>]
         attr_accessor :parameter
@@ -2424,16 +2380,16 @@ module Google
         # @return [String]
         attr_accessor :path
       
-        # The end timestamp in milliseconds to schedule a variable.
+        # The end timestamp in milliseconds to schedule a variable. @mutable tagmanager.
-        # @mutable tagmanager.accounts.containers.workspaces.variables.create
+        # accounts.containers.workspaces.variables.create @mutable tagmanager.accounts.
-        # @mutable tagmanager.accounts.containers.workspaces.variables.update
+        # containers.workspaces.variables.update
         # Corresponds to the JSON property `scheduleEndMs`
         # @return [Fixnum]
         attr_accessor :schedule_end_ms
       
-        # The start timestamp in milliseconds to schedule a variable.
+        # The start timestamp in milliseconds to schedule a variable. @mutable
-        # @mutable tagmanager.accounts.containers.workspaces.variables.create
+        # tagmanager.accounts.containers.workspaces.variables.create @mutable tagmanager.
-        # @mutable tagmanager.accounts.containers.workspaces.variables.update
+        # accounts.containers.workspaces.variables.update
         # Corresponds to the JSON property `scheduleStartMs`
         # @return [Fixnum]
         attr_accessor :schedule_start_ms
@@ -2443,9 +2399,9 @@ module Google
         # @return [String]
         attr_accessor :tag_manager_url
       
-        # GTM Variable Type.
+        # GTM Variable Type. @mutable tagmanager.accounts.containers.workspaces.
-        # @mutable tagmanager.accounts.containers.workspaces.variables.create
+        # variables.create @mutable tagmanager.accounts.containers.workspaces.variables.
-        # @mutable tagmanager.accounts.containers.workspaces.variables.update
+        # update
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type
@@ -2544,22 +2500,20 @@ module Google
         # @return [String]
         attr_accessor :container_id
       
-        # Workspace description.
+        # Workspace description. @mutable tagmanager.accounts.containers.workspaces.
-        # @mutable tagmanager.accounts.containers.workspaces.create
+        # create @mutable tagmanager.accounts.containers.workspaces.update
-        # @mutable tagmanager.accounts.containers.workspaces.update
         # Corresponds to the JSON property `description`
         # @return [String]
         attr_accessor :description
       
-        # The fingerprint of the GTM Workspace as computed at storage time. This
+        # The fingerprint of the GTM Workspace as computed at storage time. This value
-        # value is recomputed whenever the workspace is modified.
+        # is recomputed whenever the workspace is modified.
         # Corresponds to the JSON property `fingerprint`
         # @return [String]
         attr_accessor :fingerprint
       
-        # Workspace display name.
+        # Workspace display name. @mutable tagmanager.accounts.containers.workspaces.
-        # @mutable tagmanager.accounts.containers.workspaces.create
+        # create @mutable tagmanager.accounts.containers.workspaces.update
-        # @mutable tagmanager.accounts.containers.workspaces.update
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -2620,8 +2574,8 @@ module Google
         # @return [String]
         attr_accessor :container_id
       
-        # The fingerprint of the GTM Zone as computed at storage time.
+        # The fingerprint of the GTM Zone as computed at storage time. This value is
-        # This value is recomputed whenever the zone is modified.
+        # recomputed whenever the zone is modified.
         # Corresponds to the JSON property `fingerprint`
         # @return [String]
         attr_accessor :fingerprint
@@ -2691,8 +2645,8 @@ module Google
         # @return [Array<Google::Apis::TagmanagerV2::Condition>]
         attr_accessor :condition
       
-        # Custom evaluation trigger IDs. A zone will evaluate its boundary
+        # Custom evaluation trigger IDs. A zone will evaluate its boundary conditions
-        # conditions when any of the listed triggers are true.
+        # when any of the listed triggers are true.
         # Corresponds to the JSON property `customEvaluationTriggerId`
         # @return [Array<String>]
         attr_accessor :custom_evaluation_trigger_id

generated/google/apis/tagmanager_v2/service.rb

@@ -22,8 +22,7 @@ module Google
     module TagmanagerV2
       # Tag Manager API
       #
-      # This API allows clients to access and modify container and tag
+      # This API allows clients to access and modify container and tag configuration.
-      #  configuration.
       #
       # @example
       #    require 'google/apis/tagmanager_v2'
@@ -50,8 +49,7 @@ module Google
         
         # Gets a GTM Account.
         # @param [String] path
-        #   GTM Accounts's API relative path.
+        #   GTM Accounts's API relative path. Example: accounts/`account_id`
-        #   Example: accounts/`account_id`
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -111,12 +109,11 @@ module Google
         
         # Updates a GTM Account.
         # @param [String] path
-        #   GTM Accounts's API relative path.
+        #   GTM Accounts's API relative path. Example: accounts/`account_id`
-        #   Example: accounts/`account_id`
         # @param [Google::Apis::TagmanagerV2::Account] account_object
         # @param [String] fingerprint
-        #   When provided, this fingerprint must match the fingerprint of the account
+        #   When provided, this fingerprint must match the fingerprint of the account in
-        #   in storage.
+        #   storage.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -149,8 +146,7 @@ module Google
         
         # Creates a Container.
         # @param [String] parent
-        #   GTM Account's API relative path.
+        #   GTM Account's API relative path. Example: accounts/`account_id`.
-        #   Example: accounts/`account_id`.
         # @param [Google::Apis::TagmanagerV2::Container] container_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -183,8 +179,8 @@ module Google
         
         # Deletes a Container.
         # @param [String] path
-        #   GTM Container's API relative path.
+        #   GTM Container's API relative path. Example: accounts/`account_id`/containers/`
-        #   Example: accounts/`account_id`/containers/`container_id`
+        #   container_id`
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -212,8 +208,8 @@ module Google
         
         # Gets a Container.
         # @param [String] path
-        #   GTM Container's API relative path.
+        #   GTM Container's API relative path. Example: accounts/`account_id`/containers/`
-        #   Example: accounts/`account_id`/containers/`container_id`
+        #   container_id`
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -243,8 +239,7 @@ module Google
         
         # Lists all Containers that belongs to a GTM Account.
         # @param [String] parent
-        #   GTM Accounts's API relative path.
+        #   GTM Accounts's API relative path. Example: accounts/`account_id`.
-        #   Example: accounts/`account_id`.
         # @param [String] page_token
         #   Continuation token for fetching the next page of results.
         # @param [String] fields
@@ -277,12 +272,12 @@ module Google
         
         # Updates a Container.
         # @param [String] path
-        #   GTM Container's API relative path.
+        #   GTM Container's API relative path. Example: accounts/`account_id`/containers/`
-        #   Example: accounts/`account_id`/containers/`container_id`
+        #   container_id`
         # @param [Google::Apis::TagmanagerV2::Container] container_object
         # @param [String] fingerprint
-        #   When provided, this fingerprint must match the fingerprint of the
+        #   When provided, this fingerprint must match the fingerprint of the container in
-        #   container in storage.
+        #   storage.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -315,8 +310,8 @@ module Google
         
         # Creates a GTM Environment.
         # @param [String] parent
-        #   GTM Container's API relative path.
+        #   GTM Container's API relative path. Example: accounts/`account_id`/containers/`
-        #   Example: accounts/`account_id`/containers/`container_id`
+        #   container_id`
         # @param [Google::Apis::TagmanagerV2::Environment] environment_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -349,9 +344,8 @@ module Google
         
         # Deletes a GTM Environment.
         # @param [String] path
-        #   GTM Environment's API relative path.
+        #   GTM Environment's API relative path. Example: accounts/`account_id`/containers/
-        #   Example:
+        #   `container_id`/environments/`environment_id`
-        #   accounts/`account_id`/containers/`container_id`/environments/`environment_id`
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -379,9 +373,8 @@ module Google
         
         # Gets a GTM Environment.
         # @param [String] path
-        #   GTM Environment's API relative path.
+        #   GTM Environment's API relative path. Example: accounts/`account_id`/containers/
-        #   Example:
+        #   `container_id`/environments/`environment_id`
-        #   accounts/`account_id`/containers/`container_id`/environments/`environment_id`
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -411,8 +404,8 @@ module Google
         
         # Lists all GTM Environments of a GTM Container.
         # @param [String] parent
-        #   GTM Container's API relative path.
+        #   GTM Container's API relative path. Example: accounts/`account_id`/containers/`
-        #   Example: accounts/`account_id`/containers/`container_id`
+        #   container_id`
         # @param [String] page_token
         #   Continuation token for fetching the next page of results.
         # @param [String] fields
@@ -445,9 +438,8 @@ module Google
         
         # Re-generates the authorization code for a GTM Environment.
         # @param [String] path
-        #   GTM Environment's API relative path.
+        #   GTM Environment's API relative path. Example: accounts/`account_id`/containers/
-        #   Example:
+        #   `container_id`/environments/`environment_id`
-        #   accounts/`account_id`/containers/`container_id`/environments/`environment_id`
         # @param [Google::Apis::TagmanagerV2::Environment] environment_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -480,13 +472,12 @@ module Google
         
         # Updates a GTM Environment.
         # @param [String] path
-        #   GTM Environment's API relative path.
+        #   GTM Environment's API relative path. Example: accounts/`account_id`/containers/
-        #   Example:
+        #   `container_id`/environments/`environment_id`
-        #   accounts/`account_id`/containers/`container_id`/environments/`environment_id`
         # @param [Google::Apis::TagmanagerV2::Environment] environment_object
         # @param [String] fingerprint
-        #   When provided, this fingerprint must match the fingerprint of the
+        #   When provided, this fingerprint must match the fingerprint of the environment
-        #   environment in storage.
+        #   in storage.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -519,8 +510,8 @@ module Google
         
         # Gets the latest container version header
         # @param [String] parent
-        #   GTM Container's API relative path.
+        #   GTM Container's API relative path. Example: accounts/`account_id`/containers/`
-        #   Example: accounts/`account_id`/containers/`container_id`
+        #   container_id`
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -550,8 +541,8 @@ module Google
         
         # Lists all Container Versions of a GTM Container.
         # @param [String] parent
-        #   GTM Container's API relative path.
+        #   GTM Container's API relative path. Example: accounts/`account_id`/containers/`
-        #   Example: accounts/`account_id`/containers/`container_id`
+        #   container_id`
         # @param [Boolean] include_deleted
         #   Also retrieve deleted (archived) versions when true.
         # @param [String] page_token
@@ -587,9 +578,8 @@ module Google
         
         # Deletes a Container Version.
         # @param [String] path
-        #   GTM ContainerVersion's API relative path.
+        #   GTM ContainerVersion's API relative path. Example: accounts/`account_id`/
-        #   Example:
+        #   containers/`container_id`/versions/`version_id`
-        #   accounts/`account_id`/containers/`container_id`/versions/`version_id`
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -617,12 +607,11 @@ module Google
         
         # Gets a Container Version.
         # @param [String] path
-        #   GTM ContainerVersion's API relative path.
+        #   GTM ContainerVersion's API relative path. Example: accounts/`account_id`/
-        #   Example:
+        #   containers/`container_id`/versions/`version_id`
-        #   accounts/`account_id`/containers/`container_id`/versions/`version_id`
         # @param [String] container_version_id
-        #   The GTM ContainerVersion ID. Specify <code>published</code> to retrieve
+        #   The GTM ContainerVersion ID. Specify published to retrieve the currently
-        #   the currently published version.
+        #   published version.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -653,8 +642,8 @@ module Google
         
         # Gets the live (i.e. published) container version
         # @param [String] parent
-        #   GTM Container's API relative path.
+        #   GTM Container's API relative path. Example: accounts/`account_id`/containers/`
-        #   Example: accounts/`account_id`/containers/`container_id`
+        #   container_id`
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -684,12 +673,11 @@ module Google
         
         # Publishes a Container Version.
         # @param [String] path
-        #   GTM ContainerVersion's API relative path.
+        #   GTM ContainerVersion's API relative path. Example: accounts/`account_id`/
-        #   Example:
+        #   containers/`container_id`/versions/`version_id`
-        #   accounts/`account_id`/containers/`container_id`/versions/`version_id`
         # @param [String] fingerprint
-        #   When provided, this fingerprint must match the fingerprint of the
+        #   When provided, this fingerprint must match the fingerprint of the container
-        #   container version in storage.
+        #   version in storage.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -718,12 +706,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Sets the latest version used for synchronization of workspaces when
+        # Sets the latest version used for synchronization of workspaces when detecting
-        # detecting conflicts and errors.
+        # conflicts and errors.
         # @param [String] path
-        #   GTM ContainerVersion's API relative path.
+        #   GTM ContainerVersion's API relative path. Example: accounts/`account_id`/
-        #   Example:
+        #   containers/`container_id`/versions/`version_id`
-        #   accounts/`account_id`/containers/`container_id`/versions/`version_id`
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -753,9 +740,8 @@ module Google
         
         # Undeletes a Container Version.
         # @param [String] path
-        #   GTM ContainerVersion's API relative path.
+        #   GTM ContainerVersion's API relative path. Example: accounts/`account_id`/
-        #   Example:
+        #   containers/`container_id`/versions/`version_id`
-        #   accounts/`account_id`/containers/`container_id`/versions/`version_id`
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -785,13 +771,12 @@ module Google
         
         # Updates a Container Version.
         # @param [String] path
-        #   GTM ContainerVersion's API relative path.
+        #   GTM ContainerVersion's API relative path. Example: accounts/`account_id`/
-        #   Example:
+        #   containers/`container_id`/versions/`version_id`
-        #   accounts/`account_id`/containers/`container_id`/versions/`version_id`
         # @param [Google::Apis::TagmanagerV2::ContainerVersion] container_version_object
         # @param [String] fingerprint
-        #   When provided, this fingerprint must match the fingerprint of the
+        #   When provided, this fingerprint must match the fingerprint of the container
-        #   container version in storage.
+        #   version in storage.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -824,8 +809,8 @@ module Google
         
         # Creates a Workspace.
         # @param [String] parent
-        #   GTM parent Container's API relative path.
+        #   GTM parent Container's API relative path. Example: accounts/`account_id`/
-        #   Example: accounts/`account_id`/containers/`container_id`
+        #   containers/`container_id`
         # @param [Google::Apis::TagmanagerV2::Workspace] workspace_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -860,9 +845,8 @@ module Google
         # deletes the workspace, and sets the base container version to the newly
         # created version.
         # @param [String] path
-        #   GTM Workspace's API relative path.
+        #   GTM Workspace's API relative path. Example: accounts/`account_id`/containers/`
-        #   Example:
+        #   container_id`/workspaces/`workspace_id`
-        #   accounts/`account_id`/containers/`container_id`/workspaces/`workspace_id`
         # @param [Google::Apis::TagmanagerV2::CreateContainerVersionRequestVersionOptions] create_container_version_request_version_options_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -895,9 +879,8 @@ module Google
         
         # Deletes a Workspace.
         # @param [String] path
-        #   GTM Workspace's API relative path.
+        #   GTM Workspace's API relative path. Example: accounts/`account_id`/containers/`
-        #   Example:
+        #   container_id`/workspaces/`workspace_id`
-        #   accounts/`account_id`/containers/`container_id`/workspaces/`workspace_id`
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -925,9 +908,8 @@ module Google
         
         # Gets a Workspace.
         # @param [String] path
-        #   GTM Workspace's API relative path.
+        #   GTM Workspace's API relative path. Example: accounts/`account_id`/containers/`
-        #   Example:
+        #   container_id`/workspaces/`workspace_id`
-        #   accounts/`account_id`/containers/`container_id`/workspaces/`workspace_id`
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -957,9 +939,8 @@ module Google
         
         # Finds conflicting and modified entities in the workspace.
         # @param [String] path
-        #   GTM Workspace's API relative path.
+        #   GTM Workspace's API relative path. Example: accounts/`account_id`/containers/`
-        #   Example:
+        #   container_id`/workspaces/`workspace_id`
-        #   accounts/`account_id`/containers/`container_id`/workspaces/`workspace_id`
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -989,8 +970,8 @@ module Google
         
         # Lists all Workspaces that belong to a GTM Container.
         # @param [String] parent
-        #   GTM parent Container's API relative path.
+        #   GTM parent Container's API relative path. Example: accounts/`account_id`/
-        #   Example: accounts/`account_id`/containers/`container_id`
+        #   containers/`container_id`
         # @param [String] page_token
         #   Continuation token for fetching the next page of results.
         # @param [String] fields
@@ -1024,9 +1005,8 @@ module Google
         # Quick previews a workspace by creating a fake container version from all
         # entities in the provided workspace.
         # @param [String] path
-        #   GTM Workspace's API relative path.
+        #   GTM Workspace's API relative path. Example: accounts/`account_id`/containers/`
-        #   Example:
+        #   container_id`/workspaces/`workspace_id`
-        #   accounts/`account_id`/containers/`container_id`/workspaces/`workspace_id`
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1057,9 +1037,8 @@ module Google
         # Resolves a merge conflict for a workspace entity by updating it to the
         # resolved entity passed in the request.
         # @param [String] path
-        #   GTM Workspace's API relative path.
+        #   GTM Workspace's API relative path. Example: accounts/`account_id`/containers/`
-        #   Example:
+        #   container_id`/workspaces/`workspace_id`
-        #   accounts/`account_id`/containers/`container_id`/workspaces/`workspace_id`
         # @param [Google::Apis::TagmanagerV2::Entity] entity_object
         # @param [String] fingerprint
         #   When provided, this fingerprint must match the fingerprint of the
@@ -1092,13 +1071,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Syncs a workspace to the latest container version by updating all
+        # Syncs a workspace to the latest container version by updating all unmodified
-        # unmodified workspace entities and displaying conflicts for modified
+        # workspace entities and displaying conflicts for modified entities.
-        # entities.
         # @param [String] path
-        #   GTM Workspace's API relative path.
+        #   GTM Workspace's API relative path. Example: accounts/`account_id`/containers/`
-        #   Example:
+        #   container_id`/workspaces/`workspace_id`
-        #   accounts/`account_id`/containers/`container_id`/workspaces/`workspace_id`
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1128,13 +1105,12 @@ module Google
         
         # Updates a Workspace.
         # @param [String] path
-        #   GTM Workspace's API relative path.
+        #   GTM Workspace's API relative path. Example: accounts/`account_id`/containers/`
-        #   Example:
+        #   container_id`/workspaces/`workspace_id`
-        #   accounts/`account_id`/containers/`container_id`/workspaces/`workspace_id`
         # @param [Google::Apis::TagmanagerV2::Workspace] workspace_object
         # @param [String] fingerprint
-        #   When provided, this fingerprint must match the fingerprint of the
+        #   When provided, this fingerprint must match the fingerprint of the workspace in
-        #   workspace in storage.
+        #   storage.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1167,9 +1143,8 @@ module Google
         
         # Creates one or more GTM Built-In Variables.
         # @param [String] parent
-        #   GTM Workspace's API relative path.
+        #   GTM Workspace's API relative path. Example: accounts/`account_id`/containers/`
-        #   Example:
+        #   container_id`/workspaces/`workspace_id`
-        #   accounts/`account_id`/containers/`container_id`/workspaces/`workspace_id`
         # @param [Array<String>, String] type
         #   The types of built-in variables to enable.
         # @param [String] fields
@@ -1202,10 +1177,8 @@ module Google
         
         # Deletes one or more GTM Built-In Variables.
         # @param [String] path
-        #   GTM BuiltInVariable's API relative path.
+        #   GTM BuiltInVariable's API relative path. Example: accounts/`account_id`/
-        #   Example:
+        #   containers/`container_id`/workspaces/`workspace_id`/built_in_variables
-        #   accounts/`account_id`/containers/`container_id`/workspaces/`workspace_id`/
-        #   built_in_variables
         # @param [Array<String>, String] type
         #   The types of built-in variables to delete.
         # @param [String] fields
@@ -1236,9 +1209,8 @@ module Google
         
         # Lists all the enabled Built-In Variables of a GTM Container.
         # @param [String] parent
-        #   GTM Workspace's API relative path.
+        #   GTM Workspace's API relative path. Example: accounts/`account_id`/containers/`
-        #   Example:
+        #   container_id`/workspaces/`workspace_id`
-        #   accounts/`account_id`/containers/`container_id`/workspaces/`workspace_id`
         # @param [String] page_token
         #   Continuation token for fetching the next page of results.
         # @param [String] fields
@@ -1271,10 +1243,8 @@ module Google
         
         # Reverts changes to a GTM Built-In Variables in a GTM Workspace.
         # @param [String] path
-        #   GTM BuiltInVariable's API relative path.
+        #   GTM BuiltInVariable's API relative path. Example: accounts/`account_id`/
-        #   Example:
+        #   containers/`container_id`/workspaces/`workspace_id`/built_in_variables
-        #   accounts/`account_id`/containers/`container_id`/workspaces/`workspace_id`/
-        #   built_in_variables
         # @param [String] type
         #   The type of built-in variable to revert.
         # @param [String] fields
@@ -1307,9 +1277,8 @@ module Google
         
         # Creates a GTM Folder.
         # @param [String] parent
-        #   GTM Workspace's API relative path.
+        #   GTM Workspace's API relative path. Example: accounts/`account_id`/containers/`
-        #   Example:
+        #   container_id`/workspaces/`workspace_id`
-        #   accounts/`account_id`/containers/`container_id`/workspaces/`workspace_id`
         # @param [Google::Apis::TagmanagerV2::Folder] folder_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1342,10 +1311,8 @@ module Google
         
         # Deletes a GTM Folder.
         # @param [String] path
-        #   GTM Folder's API relative path.
+        #   GTM Folder's API relative path. Example: accounts/`account_id`/containers/`
-        #   Example:
+        #   container_id`/workspaces/`workspace_id`/folders/`folder_id`
-        #   accounts/`account_id`/containers/`container_id`/workspaces/`workspace_id`/
-        #   folders/`folder_id`
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1373,10 +1340,8 @@ module Google
         
         # List all entities in a GTM Folder.
         # @param [String] path
-        #   GTM Folder's API relative path.
+        #   GTM Folder's API relative path. Example: accounts/`account_id`/containers/`
-        #   Example:
+        #   container_id`/workspaces/`workspace_id`/folders/`folder_id`
-        #   accounts/`account_id`/containers/`container_id`/workspaces/`workspace_id`/
-        #   folders/`folder_id`
         # @param [String] page_token
         #   Continuation token for fetching the next page of results.
         # @param [String] fields
@@ -1409,10 +1374,8 @@ module Google
         
         # Gets a GTM Folder.
         # @param [String] path
-        #   GTM Folder's API relative path.
+        #   GTM Folder's API relative path. Example: accounts/`account_id`/containers/`
-        #   Example:
+        #   container_id`/workspaces/`workspace_id`/folders/`folder_id`
-        #   accounts/`account_id`/containers/`container_id`/workspaces/`workspace_id`/
-        #   folders/`folder_id`
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1442,9 +1405,8 @@ module Google
         
         # Lists all GTM Folders of a Container.
         # @param [String] parent
-        #   GTM Workspace's API relative path.
+        #   GTM Workspace's API relative path. Example: accounts/`account_id`/containers/`
-        #   Example:
+        #   container_id`/workspaces/`workspace_id`
-        #   accounts/`account_id`/containers/`container_id`/workspaces/`workspace_id`
         # @param [String] page_token
         #   Continuation token for fetching the next page of results.
         # @param [String] fields
@@ -1477,10 +1439,8 @@ module Google
         
         # Moves entities to a GTM Folder.
         # @param [String] path
-        #   GTM Folder's API relative path.
+        #   GTM Folder's API relative path. Example: accounts/`account_id`/containers/`
-        #   Example:
+        #   container_id`/workspaces/`workspace_id`/folders/`folder_id`
-        #   accounts/`account_id`/containers/`container_id`/workspaces/`workspace_id`/
-        #   folders/`folder_id`
         # @param [Google::Apis::TagmanagerV2::Folder] folder_object
         # @param [Array<String>, String] tag_id
         #   The tags to be moved to the folder.
@@ -1520,13 +1480,11 @@ module Google
         
         # Reverts changes to a GTM Folder in a GTM Workspace.
         # @param [String] path
-        #   GTM Folder's API relative path.
+        #   GTM Folder's API relative path. Example: accounts/`account_id`/containers/`
-        #   Example:
+        #   container_id`/workspaces/`workspace_id`/folders/`folder_id`
-        #   accounts/`account_id`/containers/`container_id`/workspaces/`workspace_id`/
-        #   folders/`folder_id`
         # @param [String] fingerprint
-        #   When provided, this fingerprint must match the fingerprint of the tag
+        #   When provided, this fingerprint must match the fingerprint of the tag in
-        #   in storage.
+        #   storage.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1557,10 +1515,8 @@ module Google
         
         # Updates a GTM Folder.
         # @param [String] path
-        #   GTM Folder's API relative path.
+        #   GTM Folder's API relative path. Example: accounts/`account_id`/containers/`
-        #   Example:
+        #   container_id`/workspaces/`workspace_id`/folders/`folder_id`
-        #   accounts/`account_id`/containers/`container_id`/workspaces/`workspace_id`/
-        #   folders/`folder_id`
         # @param [Google::Apis::TagmanagerV2::Folder] folder_object
         # @param [String] fingerprint
         #   When provided, this fingerprint must match the fingerprint of the folder in
@@ -1597,9 +1553,8 @@ module Google
         
         # Creates a GTM Tag.
         # @param [String] parent
-        #   GTM Workspace's API relative path.
+        #   GTM Workspace's API relative path. Example: accounts/`account_id`/containers/`
-        #   Example:
+        #   container_id`/workspaces/`workspace_id`
-        #   accounts/`account_id`/containers/`container_id`/workspaces/`workspace_id`
         # @param [Google::Apis::TagmanagerV2::Tag] tag_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1632,10 +1587,8 @@ module Google
         
         # Deletes a GTM Tag.
         # @param [String] path
-        #   GTM Tag's API relative path.
+        #   GTM Tag's API relative path. Example: accounts/`account_id`/containers/`
-        #   Example:
+        #   container_id`/workspaces/`workspace_id`/tags/`tag_id`
-        #   accounts/`account_id`/containers/`container_id`/workspaces/`workspace_id`/tags/
-        #   `tag_id`
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1663,10 +1616,8 @@ module Google
         
         # Gets a GTM Tag.
         # @param [String] path
-        #   GTM Tag's API relative path.
+        #   GTM Tag's API relative path. Example: accounts/`account_id`/containers/`
-        #   Example:
+        #   container_id`/workspaces/`workspace_id`/tags/`tag_id`
-        #   accounts/`account_id`/containers/`container_id`/workspaces/`workspace_id`/tags/
-        #   `tag_id`
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1696,9 +1647,8 @@ module Google
         
         # Lists all GTM Tags of a Container.
         # @param [String] parent
-        #   GTM Workspace's API relative path.
+        #   GTM Workspace's API relative path. Example: accounts/`account_id`/containers/`
-        #   Example:
+        #   container_id`/workspaces/`workspace_id`
-        #   accounts/`account_id`/containers/`container_id`/workspaces/`workspace_id`
         # @param [String] page_token
         #   Continuation token for fetching the next page of results.
         # @param [String] fields
@@ -1731,13 +1681,11 @@ module Google
         
         # Reverts changes to a GTM Tag in a GTM Workspace.
         # @param [String] path
-        #   GTM Tag's API relative path.
+        #   GTM Tag's API relative path. Example: accounts/`account_id`/containers/`
-        #   Example:
+        #   container_id`/workspaces/`workspace_id`/tags/`tag_id`
-        #   accounts/`account_id`/containers/`container_id`/workspaces/`workspace_id`/tags/
-        #   `tag_id`
         # @param [String] fingerprint
-        #   When provided, this fingerprint must match the fingerprint of thetag
+        #   When provided, this fingerprint must match the fingerprint of thetag in
-        #   in storage.
+        #   storage.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1768,10 +1716,8 @@ module Google
         
         # Updates a GTM Tag.
         # @param [String] path
-        #   GTM Tag's API relative path.
+        #   GTM Tag's API relative path. Example: accounts/`account_id`/containers/`
-        #   Example:
+        #   container_id`/workspaces/`workspace_id`/tags/`tag_id`
-        #   accounts/`account_id`/containers/`container_id`/workspaces/`workspace_id`/tags/
-        #   `tag_id`
         # @param [Google::Apis::TagmanagerV2::Tag] tag_object
         # @param [String] fingerprint
         #   When provided, this fingerprint must match the fingerprint of the tag in
@@ -1808,9 +1754,8 @@ module Google
         
         # Creates a GTM Custom Template.
         # @param [String] parent
-        #   GTM Workspace's API relative path.
+        #   GTM Workspace's API relative path. Example: accounts/`account_id`/containers/`
-        #   Example:
+        #   container_id`/workspaces/`workspace_id`
-        #   accounts/`account_id`/containers/`container_id`/workspaces/`workspace_id`
         # @param [Google::Apis::TagmanagerV2::CustomTemplate] custom_template_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1843,10 +1788,8 @@ module Google
         
         # Deletes a GTM Template.
         # @param [String] path
-        #   GTM Custom Template's API relative path.
+        #   GTM Custom Template's API relative path. Example: accounts/`account_id`/
-        #   Example:
+        #   containers/`container_id`/workspaces/`workspace_id`/templates/`template_id`
-        #   accounts/`account_id`/containers/`container_id`/workspaces/`workspace_id`/
-        #   templates/`template_id`
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1874,10 +1817,8 @@ module Google
         
         # Gets a GTM Template.
         # @param [String] path
-        #   GTM Custom Template's API relative path.
+        #   GTM Custom Template's API relative path. Example: accounts/`account_id`/
-        #   Example:
+        #   containers/`container_id`/workspaces/`workspace_id`/templates/`template_id`
-        #   accounts/`account_id`/containers/`container_id`/workspaces/`workspace_id`/
-        #   templates/`template_id`
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1907,9 +1848,8 @@ module Google
         
         # Lists all GTM Templates of a GTM container workspace.
         # @param [String] parent
-        #   GTM Workspace's API relative path.
+        #   GTM Workspace's API relative path. Example: accounts/`account_id`/containers/`
-        #   Example:
+        #   container_id`/workspaces/`workspace_id`
-        #   accounts/`account_id`/containers/`container_id`/workspaces/`workspace_id`
         # @param [String] page_token
         #   Continuation token for fetching the next page of results.
         # @param [String] fields
@@ -1942,13 +1882,11 @@ module Google
         
         # Reverts changes to a GTM Template in a GTM Workspace.
         # @param [String] path
-        #   GTM Custom Template's API relative path.
+        #   GTM Custom Template's API relative path. Example: accounts/`account_id`/
-        #   Example:
+        #   containers/`container_id`/workspaces/`workspace_id`/templates/`template_id`
-        #   accounts/`account_id`/containers/`container_id`/workspaces/`workspace_id`/
-        #   templates/`template_id`
         # @param [String] fingerprint
-        #   When provided, this fingerprint must match the fingerprint of the template
+        #   When provided, this fingerprint must match the fingerprint of the template in
-        #   in storage.
+        #   storage.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1979,14 +1917,12 @@ module Google
         
         # Updates a GTM Template.
         # @param [String] path
-        #   GTM Custom Template's API relative path.
+        #   GTM Custom Template's API relative path. Example: accounts/`account_id`/
-        #   Example:
+        #   containers/`container_id`/workspaces/`workspace_id`/templates/`template_id`
-        #   accounts/`account_id`/containers/`container_id`/workspaces/`workspace_id`/
-        #   templates/`template_id`
         # @param [Google::Apis::TagmanagerV2::CustomTemplate] custom_template_object
         # @param [String] fingerprint
-        #   When provided, this fingerprint must match the fingerprint of the templates
+        #   When provided, this fingerprint must match the fingerprint of the templates in
-        #   in storage.
+        #   storage.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -2019,9 +1955,8 @@ module Google
         
         # Creates a GTM Trigger.
         # @param [String] parent
-        #   GTM Workspaces's API relative path.
+        #   GTM Workspaces's API relative path. Example: accounts/`account_id`/containers/`
-        #   Example:
+        #   container_id`/workspaces/`workspace_id`
-        #   accounts/`account_id`/containers/`container_id`/workspaces/`workspace_id`
         # @param [Google::Apis::TagmanagerV2::Trigger] trigger_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -2054,10 +1989,8 @@ module Google
         
         # Deletes a GTM Trigger.
         # @param [String] path
-        #   GTM Trigger's API relative path.
+        #   GTM Trigger's API relative path. Example: accounts/`account_id`/containers/`
-        #   Example:
+        #   container_id`/workspaces/`workspace_id`/triggers/`trigger_id`
-        #   accounts/`account_id`/containers/`container_id`/workspaces/`workspace_id`/
-        #   triggers/`trigger_id`
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -2085,10 +2018,8 @@ module Google
         
         # Gets a GTM Trigger.
         # @param [String] path
-        #   GTM Trigger's API relative path.
+        #   GTM Trigger's API relative path. Example: accounts/`account_id`/containers/`
-        #   Example:
+        #   container_id`/workspaces/`workspace_id`/triggers/`trigger_id`
-        #   accounts/`account_id`/containers/`container_id`/workspaces/`workspace_id`/
-        #   triggers/`trigger_id`
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -2118,9 +2049,8 @@ module Google
         
         # Lists all GTM Triggers of a Container.
         # @param [String] parent
-        #   GTM Workspaces's API relative path.
+        #   GTM Workspaces's API relative path. Example: accounts/`account_id`/containers/`
-        #   Example:
+        #   container_id`/workspaces/`workspace_id`
-        #   accounts/`account_id`/containers/`container_id`/workspaces/`workspace_id`
         # @param [String] page_token
         #   Continuation token for fetching the next page of results.
         # @param [String] fields
@@ -2153,13 +2083,11 @@ module Google
         
         # Reverts changes to a GTM Trigger in a GTM Workspace.
         # @param [String] path
-        #   GTM Trigger's API relative path.
+        #   GTM Trigger's API relative path. Example: accounts/`account_id`/containers/`
-        #   Example:
+        #   container_id`/workspaces/`workspace_id`/triggers/`trigger_id`
-        #   accounts/`account_id`/containers/`container_id`/workspaces/`workspace_id`/
-        #   triggers/`trigger_id`
         # @param [String] fingerprint
-        #   When provided, this fingerprint must match the fingerprint of the trigger
+        #   When provided, this fingerprint must match the fingerprint of the trigger in
-        #   in storage.
+        #   storage.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -2190,14 +2118,12 @@ module Google
         
         # Updates a GTM Trigger.
         # @param [String] path
-        #   GTM Trigger's API relative path.
+        #   GTM Trigger's API relative path. Example: accounts/`account_id`/containers/`
-        #   Example:
+        #   container_id`/workspaces/`workspace_id`/triggers/`trigger_id`
-        #   accounts/`account_id`/containers/`container_id`/workspaces/`workspace_id`/
-        #   triggers/`trigger_id`
         # @param [Google::Apis::TagmanagerV2::Trigger] trigger_object
         # @param [String] fingerprint
-        #   When provided, this fingerprint must match the fingerprint of the trigger
+        #   When provided, this fingerprint must match the fingerprint of the trigger in
-        #   in storage.
+        #   storage.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -2230,9 +2156,8 @@ module Google
         
         # Creates a GTM Variable.
         # @param [String] parent
-        #   GTM Workspace's API relative path.
+        #   GTM Workspace's API relative path. Example: accounts/`account_id`/containers/`
-        #   Example:
+        #   container_id`/workspaces/`workspace_id`
-        #   accounts/`account_id`/containers/`container_id`/workspaces/`workspace_id`
         # @param [Google::Apis::TagmanagerV2::Variable] variable_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -2265,10 +2190,8 @@ module Google
         
         # Deletes a GTM Variable.
         # @param [String] path
-        #   GTM Variable's API relative path.
+        #   GTM Variable's API relative path. Example: accounts/`account_id`/containers/`
-        #   Example:
+        #   container_id`/workspaces/`workspace_id`/variables/`variable_id`
-        #   accounts/`account_id`/containers/`container_id`/workspaces/`workspace_id`/
-        #   variables/`variable_id`
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -2296,10 +2219,8 @@ module Google
         
         # Gets a GTM Variable.
         # @param [String] path
-        #   GTM Variable's API relative path.
+        #   GTM Variable's API relative path. Example: accounts/`account_id`/containers/`
-        #   Example:
+        #   container_id`/workspaces/`workspace_id`/variables/`variable_id`
-        #   accounts/`account_id`/containers/`container_id`/workspaces/`workspace_id`/
-        #   variables/`variable_id`
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -2329,9 +2250,8 @@ module Google
         
         # Lists all GTM Variables of a Container.
         # @param [String] parent
-        #   GTM Workspace's API relative path.
+        #   GTM Workspace's API relative path. Example: accounts/`account_id`/containers/`
-        #   Example:
+        #   container_id`/workspaces/`workspace_id`
-        #   accounts/`account_id`/containers/`container_id`/workspaces/`workspace_id`
         # @param [String] page_token
         #   Continuation token for fetching the next page of results.
         # @param [String] fields
@@ -2364,13 +2284,11 @@ module Google
         
         # Reverts changes to a GTM Variable in a GTM Workspace.
         # @param [String] path
-        #   GTM Variable's API relative path.
+        #   GTM Variable's API relative path. Example: accounts/`account_id`/containers/`
-        #   Example:
+        #   container_id`/workspaces/`workspace_id`/variables/`variable_id`
-        #   accounts/`account_id`/containers/`container_id`/workspaces/`workspace_id`/
-        #   variables/`variable_id`
         # @param [String] fingerprint
-        #   When provided, this fingerprint must match the fingerprint of the variable
+        #   When provided, this fingerprint must match the fingerprint of the variable in
-        #   in storage.
+        #   storage.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -2401,14 +2319,12 @@ module Google
         
         # Updates a GTM Variable.
         # @param [String] path
-        #   GTM Variable's API relative path.
+        #   GTM Variable's API relative path. Example: accounts/`account_id`/containers/`
-        #   Example:
+        #   container_id`/workspaces/`workspace_id`/variables/`variable_id`
-        #   accounts/`account_id`/containers/`container_id`/workspaces/`workspace_id`/
-        #   variables/`variable_id`
         # @param [Google::Apis::TagmanagerV2::Variable] variable_object
         # @param [String] fingerprint
-        #   When provided, this fingerprint must match the fingerprint of the variable
+        #   When provided, this fingerprint must match the fingerprint of the variable in
-        #   in storage.
+        #   storage.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -2441,9 +2357,8 @@ module Google
         
         # Creates a GTM Zone.
         # @param [String] parent
-        #   GTM Workspace's API relative path.
+        #   GTM Workspace's API relative path. Example: accounts/`account_id`/containers/`
-        #   Example:
+        #   container_id`/workspaces/`workspace_id`
-        #   accounts/`account_id`/containers/`container_id`/workspaces/`workspace_id`
         # @param [Google::Apis::TagmanagerV2::Zone] zone_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -2476,10 +2391,8 @@ module Google
         
         # Deletes a GTM Zone.
         # @param [String] path
-        #   GTM Zone's API relative path.
+        #   GTM Zone's API relative path. Example: accounts/`account_id`/containers/`
-        #   Example:
+        #   container_id`/workspaces/`workspace_id`/zones/`zone_id`
-        #   accounts/`account_id`/containers/`container_id`/workspaces/`workspace_id`/
-        #   zones/`zone_id`
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -2507,10 +2420,8 @@ module Google
         
         # Gets a GTM Zone.
         # @param [String] path
-        #   GTM Zone's API relative path.
+        #   GTM Zone's API relative path. Example: accounts/`account_id`/containers/`
-        #   Example:
+        #   container_id`/workspaces/`workspace_id`/zones/`zone_id`
-        #   accounts/`account_id`/containers/`container_id`/workspaces/`workspace_id`/
-        #   zones/`zone_id`
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -2540,9 +2451,8 @@ module Google
         
         # Lists all GTM Zones of a GTM container workspace.
         # @param [String] parent
-        #   GTM Workspace's API relative path.
+        #   GTM Workspace's API relative path. Example: accounts/`account_id`/containers/`
-        #   Example:
+        #   container_id`/workspaces/`workspace_id`
-        #   accounts/`account_id`/containers/`container_id`/workspaces/`workspace_id`
         # @param [String] page_token
         #   Continuation token for fetching the next page of results.
         # @param [String] fields
@@ -2575,10 +2485,8 @@ module Google
         
         # Reverts changes to a GTM Zone in a GTM Workspace.
         # @param [String] path
-        #   GTM Zone's API relative path.
+        #   GTM Zone's API relative path. Example: accounts/`account_id`/containers/`
-        #   Example:
+        #   container_id`/workspaces/`workspace_id`/zones/`zone_id`
-        #   accounts/`account_id`/containers/`container_id`/workspaces/`workspace_id`/
-        #   zones/`zone_id`
         # @param [String] fingerprint
         #   When provided, this fingerprint must match the fingerprint of the zone in
         #   storage.
@@ -2612,10 +2520,8 @@ module Google
         
         # Updates a GTM Zone.
         # @param [String] path
-        #   GTM Zone's API relative path.
+        #   GTM Zone's API relative path. Example: accounts/`account_id`/containers/`
-        #   Example:
+        #   container_id`/workspaces/`workspace_id`/zones/`zone_id`
-        #   accounts/`account_id`/containers/`container_id`/workspaces/`workspace_id`/
-        #   zones/`zone_id`
         # @param [Google::Apis::TagmanagerV2::Zone] zone_object
         # @param [String] fingerprint
         #   When provided, this fingerprint must match the fingerprint of the zone in
@@ -2652,8 +2558,7 @@ module Google
         
         # Creates a user's Account & Container access.
         # @param [String] parent
-        #   GTM Account's API relative path.
+        #   GTM Account's API relative path. Example: accounts/`account_id`
-        #   Example: accounts/`account_id`
         # @param [Google::Apis::TagmanagerV2::UserPermission] user_permission_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -2687,8 +2592,8 @@ module Google
         # Removes a user from the account, revoking access to it and all of its
         # containers.
         # @param [String] path
-        #   GTM UserPermission's API relative path.
+        #   GTM UserPermission's API relative path. Example: accounts/`account_id`/
-        #   Example: accounts/`account_id`/user_permissions/`user_permission_id`
+        #   user_permissions/`user_permission_id`
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -2716,8 +2621,8 @@ module Google
         
         # Gets a user's Account & Container access.
         # @param [String] path
-        #   GTM UserPermission's API relative path.
+        #   GTM UserPermission's API relative path. Example: accounts/`account_id`/
-        #   Example: accounts/`account_id`/user_permissions/`user_permission_id`
+        #   user_permissions/`user_permission_id`
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -2748,8 +2653,7 @@ module Google
         # List all users that have access to the account along with Account and
         # Container user access granted to each of them.
         # @param [String] parent
-        #   GTM Accounts's API relative path.
+        #   GTM Accounts's API relative path. Example: accounts/`account_id`
-        #   Example: accounts/`account_id`
         # @param [String] page_token
         #   Continuation token for fetching the next page of results.
         # @param [String] fields
@@ -2782,8 +2686,8 @@ module Google
         
         # Updates a user's Account & Container access.
         # @param [String] path
-        #   GTM UserPermission's API relative path.
+        #   GTM UserPermission's API relative path. Example: accounts/`account_id`/
-        #   Example: accounts/`account_id`/user_permissions/`user_permission_id`
+        #   user_permissions/`user_permission_id`
         # @param [Google::Apis::TagmanagerV2::UserPermission] user_permission_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.

generated/google/apis/vision_v1.rb

@@ -27,7 +27,7 @@ module Google
     # @see https://cloud.google.com/vision/
     module VisionV1
       VERSION = 'V1'
-      REVISION = '20200710'
+      REVISION = '20200801'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

generated/google/apis/vision_v1/service.rb

@@ -49,12 +49,11 @@ module Google
           @batch_path = 'batch'
         end
         
-        # Service that performs image detection and annotation for a batch of files.
+        # Service that performs image detection and annotation for a batch of files. Now
-        # Now only "application/pdf", "image/tiff" and "image/gif" are supported.
+        # only "application/pdf", "image/tiff" and "image/gif" are supported. This
-        # This service will extract at most 5 (customers can specify which 5 in
+        # service will extract at most 5 (customers can specify which 5 in
-        # AnnotateFileRequest.pages) frames (gif) or pages (pdf or tiff) from each
+        # AnnotateFileRequest.pages) frames (gif) or pages (pdf or tiff) from each file
-        # file provided and perform detection and annotation for each image
+        # provided and perform detection and annotation for each image extracted.
-        # extracted.
         # @param [Google::Apis::VisionV1::BatchAnnotateFilesRequest] batch_annotate_files_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -84,12 +83,12 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Run asynchronous image detection and annotation for a list of generic
+        # Run asynchronous image detection and annotation for a list of generic files,
-        # files, such as PDF files, which may contain multiple pages and multiple
+        # such as PDF files, which may contain multiple pages and multiple images per
-        # images per page. Progress and results can be retrieved through the
+        # page. Progress and results can be retrieved through the `google.longrunning.
-        # `google.longrunning.Operations` interface.
+        # Operations` interface. `Operation.metadata` contains `OperationMetadata` (
-        # `Operation.metadata` contains `OperationMetadata` (metadata).
+        # metadata). `Operation.response` contains `AsyncBatchAnnotateFilesResponse` (
-        # `Operation.response` contains `AsyncBatchAnnotateFilesResponse` (results).
+        # results).
         # @param [Google::Apis::VisionV1::AsyncBatchAnnotateFilesRequest] async_batch_annotate_files_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -149,13 +148,12 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Run asynchronous image detection and annotation for a list of images.
+        # Run asynchronous image detection and annotation for a list of images. Progress
-        # Progress and results can be retrieved through the
+        # and results can be retrieved through the `google.longrunning.Operations`
-        # `google.longrunning.Operations` interface.
+        # interface. `Operation.metadata` contains `OperationMetadata` (metadata). `
-        # `Operation.metadata` contains `OperationMetadata` (metadata).
+        # Operation.response` contains `AsyncBatchAnnotateImagesResponse` (results).
-        # `Operation.response` contains `AsyncBatchAnnotateImagesResponse` (results).
+        # This service will write image annotation outputs to json files in customer GCS
-        # This service will write image annotation outputs to json files in customer
+        # bucket, each json file containing BatchAnnotateImagesResponse proto.
-        # GCS bucket, each json file containing BatchAnnotateImagesResponse proto.
         # @param [Google::Apis::VisionV1::AsyncBatchAnnotateImagesRequest] async_batch_annotate_images_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -185,9 +183,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets the latest state of a long-running operation.  Clients can use this
+        # Gets the latest state of a long-running operation. Clients can use this method
-        # method to poll the operation result at intervals as recommended by the API
+        # to poll the operation result at intervals as recommended by the API service.
-        # service.
         # @param [String] name
         #   The name of the operation resource.
         # @param [String] fields
@@ -217,15 +214,13 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Starts asynchronous cancellation on a long-running operation.  The server
+        # Starts asynchronous cancellation on a long-running operation. The server makes
-        # makes a best effort to cancel the operation, but success is not
+        # a best effort to cancel the operation, but success is not guaranteed. If the
-        # guaranteed.  If the server doesn't support this method, it returns
+        # server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.
-        # `google.rpc.Code.UNIMPLEMENTED`.  Clients can use
+        # Clients can use Operations.GetOperation or other methods to check whether the
-        # Operations.GetOperation or
+        # cancellation succeeded or whether the operation completed despite cancellation.
-        # other methods to check whether the cancellation succeeded or whether the
+        # On successful cancellation, the operation is not deleted; instead, it becomes
-        # operation completed despite cancellation. On successful cancellation,
+        # an operation with an Operation.error value with a google.rpc.Status.code of 1,
-        # the operation is not deleted; instead, it becomes an operation with
-        # an Operation.error value with a google.rpc.Status.code of 1,
         # corresponding to `Code.CANCELLED`.
         # @param [String] name
         #   The name of the operation resource to be cancelled.
@@ -259,10 +254,10 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes a long-running operation. This method indicates that the client is
+        # Deletes a long-running operation. This method indicates that the client is no
-        # no longer interested in the operation result. It does not cancel the
+        # longer interested in the operation result. It does not cancel the operation.
-        # operation. If the server doesn't support this method, it returns
+        # If the server doesn't support this method, it returns `google.rpc.Code.
-        # `google.rpc.Code.UNIMPLEMENTED`.
+        # UNIMPLEMENTED`.
         # @param [String] name
         #   The name of the operation resource to be deleted.
         # @param [String] fields
@@ -292,9 +287,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets the latest state of a long-running operation.  Clients can use this
+        # Gets the latest state of a long-running operation. Clients can use this method
-        # method to poll the operation result at intervals as recommended by the API
+        # to poll the operation result at intervals as recommended by the API service.
-        # service.
         # @param [String] name
         #   The name of the operation resource.
         # @param [String] fields
@@ -324,15 +318,14 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists operations that match the specified filter in the request. If the
+        # Lists operations that match the specified filter in the request. If the server
-        # server doesn't support this method, it returns `UNIMPLEMENTED`.
+        # doesn't support this method, it returns `UNIMPLEMENTED`. NOTE: the `name`
-        # NOTE: the `name` binding allows API services to override the binding
+        # binding allows API services to override the binding to use different resource
-        # to use different resource name schemes, such as `users/*/operations`. To
+        # name schemes, such as `users/*/operations`. To override the binding, API
-        # override the binding, API services can add a binding such as
+        # services can add a binding such as `"/v1/`name=users/*`/operations"` to their
-        # `"/v1/`name=users/*`/operations"` to their service configuration.
+        # service configuration. For backwards compatibility, the default name includes
-        # For backwards compatibility, the default name includes the operations
+        # the operations collection id, however overriding users must ensure the name
-        # collection id, however overriding users must ensure the name binding
+        # binding is the parent resource, without the operations collection id.
-        # is the parent resource, without the operations collection id.
         # @param [String] name
         #   The name of the operation's parent resource.
         # @param [String] filter
@@ -371,21 +364,17 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Service that performs image detection and annotation for a batch of files.
+        # Service that performs image detection and annotation for a batch of files. Now
-        # Now only "application/pdf", "image/tiff" and "image/gif" are supported.
+        # only "application/pdf", "image/tiff" and "image/gif" are supported. This
-        # This service will extract at most 5 (customers can specify which 5 in
+        # service will extract at most 5 (customers can specify which 5 in
-        # AnnotateFileRequest.pages) frames (gif) or pages (pdf or tiff) from each
+        # AnnotateFileRequest.pages) frames (gif) or pages (pdf or tiff) from each file
-        # file provided and perform detection and annotation for each image
+        # provided and perform detection and annotation for each image extracted.
-        # extracted.
         # @param [String] parent
-        #   Optional. Target project and location to make a call.
+        #   Optional. Target project and location to make a call. Format: `projects/`
-        #   Format: `projects/`project-id`/locations/`location-id``.
+        #   project-id`/locations/`location-id``. If no parent is specified, a region will
-        #   If no parent is specified, a region will be chosen automatically.
+        #   be chosen automatically. Supported location-ids: `us`: USA country only, `asia`
-        #   Supported location-ids:
+        #   : East asia areas, like Japan, Taiwan, `eu`: The European Union. Example: `
-        #   `us`: USA country only,
+        #   projects/project-A/locations/eu`.
-        #   `asia`: East asia areas, like Japan, Taiwan,
-        #   `eu`: The European Union.
-        #   Example: `projects/project-A/locations/eu`.
         # @param [Google::Apis::VisionV1::BatchAnnotateFilesRequest] batch_annotate_files_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -416,21 +405,18 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Run asynchronous image detection and annotation for a list of generic
+        # Run asynchronous image detection and annotation for a list of generic files,
-        # files, such as PDF files, which may contain multiple pages and multiple
+        # such as PDF files, which may contain multiple pages and multiple images per
-        # images per page. Progress and results can be retrieved through the
+        # page. Progress and results can be retrieved through the `google.longrunning.
-        # `google.longrunning.Operations` interface.
+        # Operations` interface. `Operation.metadata` contains `OperationMetadata` (
-        # `Operation.metadata` contains `OperationMetadata` (metadata).
+        # metadata). `Operation.response` contains `AsyncBatchAnnotateFilesResponse` (
-        # `Operation.response` contains `AsyncBatchAnnotateFilesResponse` (results).
+        # results).
         # @param [String] parent
-        #   Optional. Target project and location to make a call.
+        #   Optional. Target project and location to make a call. Format: `projects/`
-        #   Format: `projects/`project-id`/locations/`location-id``.
+        #   project-id`/locations/`location-id``. If no parent is specified, a region will
-        #   If no parent is specified, a region will be chosen automatically.
+        #   be chosen automatically. Supported location-ids: `us`: USA country only, `asia`
-        #   Supported location-ids:
+        #   : East asia areas, like Japan, Taiwan, `eu`: The European Union. Example: `
-        #   `us`: USA country only,
+        #   projects/project-A/locations/eu`.
-        #   `asia`: East asia areas, like Japan, Taiwan,
-        #   `eu`: The European Union.
-        #   Example: `projects/project-A/locations/eu`.
         # @param [Google::Apis::VisionV1::AsyncBatchAnnotateFilesRequest] async_batch_annotate_files_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -463,14 +449,11 @@ module Google
         
         # Run image detection and annotation for a batch of images.
         # @param [String] parent
-        #   Optional. Target project and location to make a call.
+        #   Optional. Target project and location to make a call. Format: `projects/`
-        #   Format: `projects/`project-id`/locations/`location-id``.
+        #   project-id`/locations/`location-id``. If no parent is specified, a region will
-        #   If no parent is specified, a region will be chosen automatically.
+        #   be chosen automatically. Supported location-ids: `us`: USA country only, `asia`
-        #   Supported location-ids:
+        #   : East asia areas, like Japan, Taiwan, `eu`: The European Union. Example: `
-        #   `us`: USA country only,
+        #   projects/project-A/locations/eu`.
-        #   `asia`: East asia areas, like Japan, Taiwan,
-        #   `eu`: The European Union.
-        #   Example: `projects/project-A/locations/eu`.
         # @param [Google::Apis::VisionV1::BatchAnnotateImagesRequest] batch_annotate_images_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -501,22 +484,18 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Run asynchronous image detection and annotation for a list of images.
+        # Run asynchronous image detection and annotation for a list of images. Progress
-        # Progress and results can be retrieved through the
+        # and results can be retrieved through the `google.longrunning.Operations`
-        # `google.longrunning.Operations` interface.
+        # interface. `Operation.metadata` contains `OperationMetadata` (metadata). `
-        # `Operation.metadata` contains `OperationMetadata` (metadata).
+        # Operation.response` contains `AsyncBatchAnnotateImagesResponse` (results).
-        # `Operation.response` contains `AsyncBatchAnnotateImagesResponse` (results).
+        # This service will write image annotation outputs to json files in customer GCS
-        # This service will write image annotation outputs to json files in customer
+        # bucket, each json file containing BatchAnnotateImagesResponse proto.
-        # GCS bucket, each json file containing BatchAnnotateImagesResponse proto.
         # @param [String] parent
-        #   Optional. Target project and location to make a call.
+        #   Optional. Target project and location to make a call. Format: `projects/`
-        #   Format: `projects/`project-id`/locations/`location-id``.
+        #   project-id`/locations/`location-id``. If no parent is specified, a region will
-        #   If no parent is specified, a region will be chosen automatically.
+        #   be chosen automatically. Supported location-ids: `us`: USA country only, `asia`
-        #   Supported location-ids:
+        #   : East asia areas, like Japan, Taiwan, `eu`: The European Union. Example: `
-        #   `us`: USA country only,
+        #   projects/project-A/locations/eu`.
-        #   `asia`: East asia areas, like Japan, Taiwan,
-        #   `eu`: The European Union.
-        #   Example: `projects/project-A/locations/eu`.
         # @param [Google::Apis::VisionV1::AsyncBatchAnnotateImagesRequest] async_batch_annotate_images_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -547,21 +526,17 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Service that performs image detection and annotation for a batch of files.
+        # Service that performs image detection and annotation for a batch of files. Now
-        # Now only "application/pdf", "image/tiff" and "image/gif" are supported.
+        # only "application/pdf", "image/tiff" and "image/gif" are supported. This
-        # This service will extract at most 5 (customers can specify which 5 in
+        # service will extract at most 5 (customers can specify which 5 in
-        # AnnotateFileRequest.pages) frames (gif) or pages (pdf or tiff) from each
+        # AnnotateFileRequest.pages) frames (gif) or pages (pdf or tiff) from each file
-        # file provided and perform detection and annotation for each image
+        # provided and perform detection and annotation for each image extracted.
-        # extracted.
         # @param [String] parent
-        #   Optional. Target project and location to make a call.
+        #   Optional. Target project and location to make a call. Format: `projects/`
-        #   Format: `projects/`project-id`/locations/`location-id``.
+        #   project-id`/locations/`location-id``. If no parent is specified, a region will
-        #   If no parent is specified, a region will be chosen automatically.
+        #   be chosen automatically. Supported location-ids: `us`: USA country only, `asia`
-        #   Supported location-ids:
+        #   : East asia areas, like Japan, Taiwan, `eu`: The European Union. Example: `
-        #   `us`: USA country only,
+        #   projects/project-A/locations/eu`.
-        #   `asia`: East asia areas, like Japan, Taiwan,
-        #   `eu`: The European Union.
-        #   Example: `projects/project-A/locations/eu`.
         # @param [Google::Apis::VisionV1::BatchAnnotateFilesRequest] batch_annotate_files_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -592,21 +567,18 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Run asynchronous image detection and annotation for a list of generic
+        # Run asynchronous image detection and annotation for a list of generic files,
-        # files, such as PDF files, which may contain multiple pages and multiple
+        # such as PDF files, which may contain multiple pages and multiple images per
-        # images per page. Progress and results can be retrieved through the
+        # page. Progress and results can be retrieved through the `google.longrunning.
-        # `google.longrunning.Operations` interface.
+        # Operations` interface. `Operation.metadata` contains `OperationMetadata` (
-        # `Operation.metadata` contains `OperationMetadata` (metadata).
+        # metadata). `Operation.response` contains `AsyncBatchAnnotateFilesResponse` (
-        # `Operation.response` contains `AsyncBatchAnnotateFilesResponse` (results).
+        # results).
         # @param [String] parent
-        #   Optional. Target project and location to make a call.
+        #   Optional. Target project and location to make a call. Format: `projects/`
-        #   Format: `projects/`project-id`/locations/`location-id``.
+        #   project-id`/locations/`location-id``. If no parent is specified, a region will
-        #   If no parent is specified, a region will be chosen automatically.
+        #   be chosen automatically. Supported location-ids: `us`: USA country only, `asia`
-        #   Supported location-ids:
+        #   : East asia areas, like Japan, Taiwan, `eu`: The European Union. Example: `
-        #   `us`: USA country only,
+        #   projects/project-A/locations/eu`.
-        #   `asia`: East asia areas, like Japan, Taiwan,
-        #   `eu`: The European Union.
-        #   Example: `projects/project-A/locations/eu`.
         # @param [Google::Apis::VisionV1::AsyncBatchAnnotateFilesRequest] async_batch_annotate_files_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -639,14 +611,11 @@ module Google
         
         # Run image detection and annotation for a batch of images.
         # @param [String] parent
-        #   Optional. Target project and location to make a call.
+        #   Optional. Target project and location to make a call. Format: `projects/`
-        #   Format: `projects/`project-id`/locations/`location-id``.
+        #   project-id`/locations/`location-id``. If no parent is specified, a region will
-        #   If no parent is specified, a region will be chosen automatically.
+        #   be chosen automatically. Supported location-ids: `us`: USA country only, `asia`
-        #   Supported location-ids:
+        #   : East asia areas, like Japan, Taiwan, `eu`: The European Union. Example: `
-        #   `us`: USA country only,
+        #   projects/project-A/locations/eu`.
-        #   `asia`: East asia areas, like Japan, Taiwan,
-        #   `eu`: The European Union.
-        #   Example: `projects/project-A/locations/eu`.
         # @param [Google::Apis::VisionV1::BatchAnnotateImagesRequest] batch_annotate_images_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -677,22 +646,18 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Run asynchronous image detection and annotation for a list of images.
+        # Run asynchronous image detection and annotation for a list of images. Progress
-        # Progress and results can be retrieved through the
+        # and results can be retrieved through the `google.longrunning.Operations`
-        # `google.longrunning.Operations` interface.
+        # interface. `Operation.metadata` contains `OperationMetadata` (metadata). `
-        # `Operation.metadata` contains `OperationMetadata` (metadata).
+        # Operation.response` contains `AsyncBatchAnnotateImagesResponse` (results).
-        # `Operation.response` contains `AsyncBatchAnnotateImagesResponse` (results).
+        # This service will write image annotation outputs to json files in customer GCS
-        # This service will write image annotation outputs to json files in customer
+        # bucket, each json file containing BatchAnnotateImagesResponse proto.
-        # GCS bucket, each json file containing BatchAnnotateImagesResponse proto.
         # @param [String] parent
-        #   Optional. Target project and location to make a call.
+        #   Optional. Target project and location to make a call. Format: `projects/`
-        #   Format: `projects/`project-id`/locations/`location-id``.
+        #   project-id`/locations/`location-id``. If no parent is specified, a region will
-        #   If no parent is specified, a region will be chosen automatically.
+        #   be chosen automatically. Supported location-ids: `us`: USA country only, `asia`
-        #   Supported location-ids:
+        #   : East asia areas, like Japan, Taiwan, `eu`: The European Union. Example: `
-        #   `us`: USA country only,
+        #   projects/project-A/locations/eu`.
-        #   `asia`: East asia areas, like Japan, Taiwan,
-        #   `eu`: The European Union.
-        #   Example: `projects/project-A/locations/eu`.
         # @param [Google::Apis::VisionV1::AsyncBatchAnnotateImagesRequest] async_batch_annotate_images_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -723,9 +688,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets the latest state of a long-running operation.  Clients can use this
+        # Gets the latest state of a long-running operation. Clients can use this method
-        # method to poll the operation result at intervals as recommended by the API
+        # to poll the operation result at intervals as recommended by the API service.
-        # service.
         # @param [String] name
         #   The name of the operation resource.
         # @param [String] fields
@@ -755,15 +719,13 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Adds a Product to the specified ProductSet. If the Product is already
+        # Adds a Product to the specified ProductSet. If the Product is already present,
-        # present, no change is made.
+        # no change is made. One Product can be added to at most 100 ProductSets.
-        # One Product can be added to at most 100 ProductSets.
+        # Possible errors: * Returns NOT_FOUND if the Product or the ProductSet doesn't
-        # Possible errors:
+        # exist.
-        # * Returns NOT_FOUND if the Product or the ProductSet doesn't exist.
         # @param [String] name
-        #   Required. The resource name for the ProductSet to modify.
+        #   Required. The resource name for the ProductSet to modify. Format is: `projects/
-        #   Format is:
+        #   PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`
-        #   `projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`
         # @param [Google::Apis::VisionV1::AddProductToProductSetRequest] add_product_to_product_set_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -794,13 +756,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates and returns a new ProductSet resource.
+        # Creates and returns a new ProductSet resource. Possible errors: * Returns
-        # Possible errors:
+        # INVALID_ARGUMENT if display_name is missing, or is longer than 4096 characters.
-        # * Returns INVALID_ARGUMENT if display_name is missing, or is longer than
-        # 4096 characters.
         # @param [String] parent
-        #   Required. The project in which the ProductSet should be created.
+        #   Required. The project in which the ProductSet should be created. Format is `
-        #   Format is `projects/PROJECT_ID/locations/LOC_ID`.
+        #   projects/PROJECT_ID/locations/LOC_ID`.
         # @param [Google::Apis::VisionV1::ProductSet] product_set_object
         # @param [String] product_set_id
         #   A user-supplied resource id for this ProductSet. If set, the server will
@@ -838,12 +798,11 @@ module Google
         end
         
         # Permanently deletes a ProductSet. Products and ReferenceImages in the
-        # ProductSet are not deleted.
+        # ProductSet are not deleted. The actual image files are not deleted from Google
-        # The actual image files are not deleted from Google Cloud Storage.
+        # Cloud Storage.
         # @param [String] name
-        #   Required. Resource name of the ProductSet to delete.
+        #   Required. Resource name of the ProductSet to delete. Format is: `projects/
-        #   Format is:
+        #   PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`
-        #   `projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -871,13 +830,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets information associated with a ProductSet.
+        # Gets information associated with a ProductSet. Possible errors: * Returns
-        # Possible errors:
+        # NOT_FOUND if the ProductSet does not exist.
-        # * Returns NOT_FOUND if the ProductSet does not exist.
         # @param [String] name
-        #   Required. Resource name of the ProductSet to get.
+        #   Required. Resource name of the ProductSet to get. Format is: `projects/
-        #   Format is:
+        #   PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`
-        #   `projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -905,18 +862,16 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Asynchronous API that imports a list of reference images to specified
+        # Asynchronous API that imports a list of reference images to specified product
-        # product sets based on a list of image information.
+        # sets based on a list of image information. The google.longrunning.Operation
-        # The google.longrunning.Operation API can be used to keep track of the
+        # API can be used to keep track of the progress and results of the request. `
-        # progress and results of the request.
+        # Operation.metadata` contains `BatchOperationMetadata`. (progress) `Operation.
-        # `Operation.metadata` contains `BatchOperationMetadata`. (progress)
+        # response` contains `ImportProductSetsResponse`. (results) The input source of
-        # `Operation.response` contains `ImportProductSetsResponse`. (results)
+        # this method is a csv file on Google Cloud Storage. For the format of the csv
-        # The input source of this method is a csv file on Google Cloud Storage.
+        # file please see ImportProductSetsGcsSource.csv_file_uri.
-        # For the format of the csv file please see
-        # ImportProductSetsGcsSource.csv_file_uri.
         # @param [String] parent
-        #   Required. The project in which the ProductSets should be imported.
+        #   Required. The project in which the ProductSets should be imported. Format is `
-        #   Format is `projects/PROJECT_ID/locations/LOC_ID`.
+        #   projects/PROJECT_ID/locations/LOC_ID`.
         # @param [Google::Apis::VisionV1::ImportProductSetsRequest] import_product_sets_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -947,13 +902,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists ProductSets in an unspecified order.
+        # Lists ProductSets in an unspecified order. Possible errors: * Returns
-        # Possible errors:
+        # INVALID_ARGUMENT if page_size is greater than 100, or less than 1.
-        # * Returns INVALID_ARGUMENT if page_size is greater than 100, or less
-        # than 1.
         # @param [String] parent
-        #   Required. The project from which ProductSets should be listed.
+        #   Required. The project from which ProductSets should be listed. Format is `
-        #   Format is `projects/PROJECT_ID/locations/LOC_ID`.
+        #   projects/PROJECT_ID/locations/LOC_ID`.
         # @param [Fixnum] page_size
         #   The maximum number of items to return. Default 10, maximum 100.
         # @param [String] page_token
@@ -987,23 +940,19 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Makes changes to a ProductSet resource.
+        # Makes changes to a ProductSet resource. Only display_name can be updated
-        # Only display_name can be updated currently.
+        # currently. Possible errors: * Returns NOT_FOUND if the ProductSet does not
-        # Possible errors:
+        # exist. * Returns INVALID_ARGUMENT if display_name is present in update_mask
-        # * Returns NOT_FOUND if the ProductSet does not exist.
+        # but missing from the request or longer than 4096 characters.
-        # * Returns INVALID_ARGUMENT if display_name is present in update_mask but
-        # missing from the request or longer than 4096 characters.
         # @param [String] name
-        #   The resource name of the ProductSet.
+        #   The resource name of the ProductSet. Format is: `projects/PROJECT_ID/locations/
-        #   Format is:
+        #   LOC_ID/productSets/PRODUCT_SET_ID`. This field is ignored when creating a
-        #   `projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`.
+        #   ProductSet.
-        #   This field is ignored when creating a ProductSet.
         # @param [Google::Apis::VisionV1::ProductSet] product_set_object
         # @param [String] update_mask
-        #   The FieldMask that specifies which fields to
+        #   The FieldMask that specifies which fields to update. If update_mask isn't
-        #   update.
+        #   specified, all mutable fields are to be updated. Valid mask path is `
-        #   If update_mask isn't specified, all mutable fields are to be updated.
+        #   display_name`.
-        #   Valid mask path is `display_name`.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1036,9 +985,8 @@ module Google
         
         # Removes a Product from the specified ProductSet.
         # @param [String] name
-        #   Required. The resource name for the ProductSet to modify.
+        #   Required. The resource name for the ProductSet to modify. Format is: `projects/
-        #   Format is:
+        #   PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`
-        #   `projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`
         # @param [Google::Apis::VisionV1::RemoveProductFromProductSetRequest] remove_product_from_product_set_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1069,15 +1017,13 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists the Products in a ProductSet, in an unspecified order. If the
+        # Lists the Products in a ProductSet, in an unspecified order. If the ProductSet
-        # ProductSet does not exist, the products field of the response will be
+        # does not exist, the products field of the response will be empty. Possible
-        # empty.
+        # errors: * Returns INVALID_ARGUMENT if page_size is greater than 100 or less
-        # Possible errors:
+        # than 1.
-        # * Returns INVALID_ARGUMENT if page_size is greater than 100 or less than 1.
         # @param [String] name
-        #   Required. The ProductSet resource for which to retrieve Products.
+        #   Required. The ProductSet resource for which to retrieve Products. Format is: `
-        #   Format is:
+        #   projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`
-        #   `projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`
         # @param [Fixnum] page_size
         #   The maximum number of items to return. Default 10, maximum 100.
         # @param [String] page_token
@@ -1111,22 +1057,19 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates and returns a new product resource.
+        # Creates and returns a new product resource. Possible errors: * Returns
-        # Possible errors:
+        # INVALID_ARGUMENT if display_name is missing or longer than 4096 characters. *
-        # * Returns INVALID_ARGUMENT if display_name is missing or longer than 4096
+        # Returns INVALID_ARGUMENT if description is longer than 4096 characters. *
-        # characters.
+        # Returns INVALID_ARGUMENT if product_category is missing or invalid.
-        # * Returns INVALID_ARGUMENT if description is longer than 4096 characters.
-        # * Returns INVALID_ARGUMENT if product_category is missing or invalid.
         # @param [String] parent
-        #   Required. The project in which the Product should be created.
+        #   Required. The project in which the Product should be created. Format is `
-        #   Format is
+        #   projects/PROJECT_ID/locations/LOC_ID`.
-        #   `projects/PROJECT_ID/locations/LOC_ID`.
         # @param [Google::Apis::VisionV1::Product] product_object
         # @param [String] product_id
-        #   A user-supplied resource id for this Product. If set, the server will
+        #   A user-supplied resource id for this Product. If set, the server will attempt
-        #   attempt to use this value as the resource id. If it is already in use, an
+        #   to use this value as the resource id. If it is already in use, an error is
-        #   error is returned with code ALREADY_EXISTS. Must be at most 128 characters
+        #   returned with code ALREADY_EXISTS. Must be at most 128 characters long. It
-        #   long. It cannot contain the character `/`.
+        #   cannot contain the character `/`.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1157,14 +1100,13 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Permanently deletes a product and its reference images.
+        # Permanently deletes a product and its reference images. Metadata of the
-        # Metadata of the product and all its images will be deleted right away, but
+        # product and all its images will be deleted right away, but search queries
-        # search queries against ProductSets containing the product may still work
+        # against ProductSets containing the product may still work until all related
-        # until all related caches are refreshed.
+        # caches are refreshed.
         # @param [String] name
-        #   Required. Resource name of product to delete.
+        #   Required. Resource name of product to delete. Format is: `projects/PROJECT_ID/
-        #   Format is:
+        #   locations/LOC_ID/products/PRODUCT_ID`
-        #   `projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID`
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1192,13 +1134,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets information associated with a Product.
+        # Gets information associated with a Product. Possible errors: * Returns
-        # Possible errors:
+        # NOT_FOUND if the Product does not exist.
-        # * Returns NOT_FOUND if the Product does not exist.
         # @param [String] name
-        #   Required. Resource name of the Product to get.
+        #   Required. Resource name of the Product to get. Format is: `projects/PROJECT_ID/
-        #   Format is:
+        #   locations/LOC_ID/products/PRODUCT_ID`
-        #   `projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID`
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1226,13 +1166,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists products in an unspecified order.
+        # Lists products in an unspecified order. Possible errors: * Returns
-        # Possible errors:
+        # INVALID_ARGUMENT if page_size is greater than 100 or less than 1.
-        # * Returns INVALID_ARGUMENT if page_size is greater than 100 or less than 1.
         # @param [String] parent
         #   Required. The project OR ProductSet from which Products should be listed.
-        #   Format:
+        #   Format: `projects/PROJECT_ID/locations/LOC_ID`
-        #   `projects/PROJECT_ID/locations/LOC_ID`
         # @param [Fixnum] page_size
         #   The maximum number of items to return. Default 10, maximum 100.
         # @param [String] page_token
@@ -1266,30 +1204,22 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Makes changes to a Product resource.
+        # Makes changes to a Product resource. Only the `display_name`, `description`,
-        # Only the `display_name`, `description`, and `labels` fields can be updated
+        # and `labels` fields can be updated right now. If labels are updated, the
-        # right now.
+        # change will not be reflected in queries until the next index time. Possible
-        # If labels are updated, the change will not be reflected in queries until
+        # errors: * Returns NOT_FOUND if the Product does not exist. * Returns
-        # the next index time.
+        # INVALID_ARGUMENT if display_name is present in update_mask but is missing from
-        # Possible errors:
+        # the request or longer than 4096 characters. * Returns INVALID_ARGUMENT if
-        # * Returns NOT_FOUND if the Product does not exist.
+        # description is present in update_mask but is longer than 4096 characters. *
-        # * Returns INVALID_ARGUMENT if display_name is present in update_mask but is
+        # Returns INVALID_ARGUMENT if product_category is present in update_mask.
-        # missing from the request or longer than 4096 characters.
-        # * Returns INVALID_ARGUMENT if description is present in update_mask but is
-        # longer than 4096 characters.
-        # * Returns INVALID_ARGUMENT if product_category is present in update_mask.
         # @param [String] name
-        #   The resource name of the product.
+        #   The resource name of the product. Format is: `projects/PROJECT_ID/locations/
-        #   Format is:
+        #   LOC_ID/products/PRODUCT_ID`. This field is ignored when creating a product.
-        #   `projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID`.
-        #   This field is ignored when creating a product.
         # @param [Google::Apis::VisionV1::Product] product_object
         # @param [String] update_mask
-        #   The FieldMask that specifies which fields
+        #   The FieldMask that specifies which fields to update. If update_mask isn't
-        #   to update.
+        #   specified, all mutable fields are to be updated. Valid mask paths include `
-        #   If update_mask isn't specified, all mutable fields are to be updated.
+        #   product_labels`, `display_name`, and `description`.
-        #   Valid mask paths include `product_labels`, `display_name`, and
-        #   `description`.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1320,25 +1250,22 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Asynchronous API to delete all Products in a ProductSet or all Products
+        # Asynchronous API to delete all Products in a ProductSet or all Products that
-        # that are in no ProductSet.
+        # are in no ProductSet. If a Product is a member of the specified ProductSet in
-        # If a Product is a member of the specified ProductSet in addition to other
+        # addition to other ProductSets, the Product will still be deleted. It is
-        # ProductSets, the Product will still be deleted.
+        # recommended to not delete the specified ProductSet until after this operation
-        # It is recommended to not delete the specified ProductSet until after this
+        # has completed. It is also recommended to not add any of the Products involved
-        # operation has completed. It is also recommended to not add any of the
+        # in the batch delete to a new ProductSet while this operation is running
-        # Products involved in the batch delete to a new ProductSet while this
+        # because those Products may still end up deleted. It's not possible to undo the
-        # operation is running because those Products may still end up deleted.
+        # PurgeProducts operation. Therefore, it is recommended to keep the csv files
-        # It's not possible to undo the PurgeProducts operation. Therefore, it is
+        # used in ImportProductSets (if that was how you originally built the Product
-        # recommended to keep the csv files used in ImportProductSets (if that was
+        # Set) before starting PurgeProducts, in case you need to re-import the data
-        # how you originally built the Product Set) before starting PurgeProducts, in
+        # after deletion. If the plan is to purge all of the Products from a ProductSet
-        # case you need to re-import the data after deletion.
+        # and then re-use the empty ProductSet to re-import new Products into the empty
-        # If the plan is to purge all of the Products from a ProductSet and then
+        # ProductSet, you must wait until the PurgeProducts operation has finished for
-        # re-use the empty ProductSet to re-import new Products into the empty
+        # that ProductSet. The google.longrunning.Operation API can be used to keep
-        # ProductSet, you must wait until the PurgeProducts operation has finished
+        # track of the progress and results of the request. `Operation.metadata`
-        # for that ProductSet.
+        # contains `BatchOperationMetadata`. (progress)
-        # The google.longrunning.Operation API can be used to keep track of the
-        # progress and results of the request.
-        # `Operation.metadata` contains `BatchOperationMetadata`. (progress)
         # @param [String] parent
         #   Required. The project and location in which the Products should be deleted.
         #   Format is `projects/PROJECT_ID/locations/LOC_ID`.
@@ -1372,31 +1299,27 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates and returns a new ReferenceImage resource.
+        # Creates and returns a new ReferenceImage resource. The `bounding_poly` field
-        # The `bounding_poly` field is optional. If `bounding_poly` is not specified,
+        # is optional. If `bounding_poly` is not specified, the system will try to
-        # the system will try to detect regions of interest in the image that are
+        # detect regions of interest in the image that are compatible with the
-        # compatible with the product_category on the parent product. If it is
+        # product_category on the parent product. If it is specified, detection is
-        # specified, detection is ALWAYS skipped. The system converts polygons into
+        # ALWAYS skipped. The system converts polygons into non-rotated rectangles. Note
-        # non-rotated rectangles.
+        # that the pipeline will resize the image if the image resolution is too large
-        # Note that the pipeline will resize the image if the image resolution is too
+        # to process (above 50MP). Possible errors: * Returns INVALID_ARGUMENT if the
-        # large to process (above 50MP).
+        # image_uri is missing or longer than 4096 characters. * Returns
-        # Possible errors:
+        # INVALID_ARGUMENT if the product does not exist. * Returns INVALID_ARGUMENT if
-        # * Returns INVALID_ARGUMENT if the image_uri is missing or longer than 4096
+        # bounding_poly is not provided, and nothing compatible with the parent product'
-        # characters.
+        # s product_category is detected. * Returns INVALID_ARGUMENT if bounding_poly
-        # * Returns INVALID_ARGUMENT if the product does not exist.
+        # contains more than 10 polygons.
-        # * Returns INVALID_ARGUMENT if bounding_poly is not provided, and nothing
-        # compatible with the parent product's product_category is detected.
-        # * Returns INVALID_ARGUMENT if bounding_poly contains more than 10 polygons.
         # @param [String] parent
         #   Required. Resource name of the product in which to create the reference image.
-        #   Format is
+        #   Format is `projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID`.
-        #   `projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID`.
         # @param [Google::Apis::VisionV1::ReferenceImage] reference_image_object
         # @param [String] reference_image_id
-        #   A user-supplied resource id for the ReferenceImage to be added. If set,
+        #   A user-supplied resource id for the ReferenceImage to be added. If set, the
-        #   the server will attempt to use this value as the resource id. If it is
+        #   server will attempt to use this value as the resource id. If it is already in
-        #   already in use, an error is returned with code ALREADY_EXISTS. Must be at
+        #   use, an error is returned with code ALREADY_EXISTS. Must be at most 128
-        #   most 128 characters long. It cannot contain the character `/`.
+        #   characters long. It cannot contain the character `/`.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1427,15 +1350,13 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Permanently deletes a reference image.
+        # Permanently deletes a reference image. The image metadata will be deleted
-        # The image metadata will be deleted right away, but search queries
+        # right away, but search queries against ProductSets containing the image may
-        # against ProductSets containing the image may still work until all related
+        # still work until all related caches are refreshed. The actual image files are
-        # caches are refreshed.
+        # not deleted from Google Cloud Storage.
-        # The actual image files are not deleted from Google Cloud Storage.
         # @param [String] name
-        #   Required. The resource name of the reference image to delete.
+        #   Required. The resource name of the reference image to delete. Format is: `
-        #   Format is:
+        #   projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID/referenceImages/
-        #   `projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID/referenceImages/
         #   IMAGE_ID`
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1464,14 +1385,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets information associated with a ReferenceImage.
+        # Gets information associated with a ReferenceImage. Possible errors: * Returns
-        # Possible errors:
+        # NOT_FOUND if the specified image does not exist.
-        # * Returns NOT_FOUND if the specified image does not exist.
         # @param [String] name
-        #   Required. The resource name of the ReferenceImage to get.
+        #   Required. The resource name of the ReferenceImage to get. Format is: `projects/
-        #   Format is:
+        #   PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID/referenceImages/IMAGE_ID`.
-        #   `projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID/referenceImages/
-        #   IMAGE_ID`.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1499,21 +1417,18 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists reference images.
+        # Lists reference images. Possible errors: * Returns NOT_FOUND if the parent
-        # Possible errors:
+        # product does not exist. * Returns INVALID_ARGUMENT if the page_size is greater
-        # * Returns NOT_FOUND if the parent product does not exist.
+        # than 100, or less than 1.
-        # * Returns INVALID_ARGUMENT if the page_size is greater than 100, or less
-        # than 1.
         # @param [String] parent
-        #   Required. Resource name of the product containing the reference images.
+        #   Required. Resource name of the product containing the reference images. Format
-        #   Format is
+        #   is `projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID`.
-        #   `projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID`.
         # @param [Fixnum] page_size
         #   The maximum number of items to return. Default 10, maximum 100.
         # @param [String] page_token
-        #   A token identifying a page of results to be returned. This is the value
+        #   A token identifying a page of results to be returned. This is the value of `
-        #   of `nextPageToken` returned in a previous reference image list request.
+        #   nextPageToken` returned in a previous reference image list request. Defaults
-        #   Defaults to the first page if not specified.
+        #   to the first page if not specified.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1543,9 +1458,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets the latest state of a long-running operation.  Clients can use this
+        # Gets the latest state of a long-running operation. Clients can use this method
-        # method to poll the operation result at intervals as recommended by the API
+        # to poll the operation result at intervals as recommended by the API service.
-        # service.
         # @param [String] name
         #   The name of the operation resource.
         # @param [String] fields

generated/google/apis/vision_v1p1beta1.rb

@@ -27,7 +27,7 @@ module Google
     # @see https://cloud.google.com/vision/
     module VisionV1p1beta1
       VERSION = 'V1p1beta1'
-      REVISION = '20200710'
+      REVISION = '20200801'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

generated/google/apis/vision_v1p1beta1/service.rb

@@ -49,12 +49,11 @@ module Google
           @batch_path = 'batch'
         end
         
-        # Service that performs image detection and annotation for a batch of files.
+        # Service that performs image detection and annotation for a batch of files. Now
-        # Now only "application/pdf", "image/tiff" and "image/gif" are supported.
+        # only "application/pdf", "image/tiff" and "image/gif" are supported. This
-        # This service will extract at most 5 (customers can specify which 5 in
+        # service will extract at most 5 (customers can specify which 5 in
-        # AnnotateFileRequest.pages) frames (gif) or pages (pdf or tiff) from each
+        # AnnotateFileRequest.pages) frames (gif) or pages (pdf or tiff) from each file
-        # file provided and perform detection and annotation for each image
+        # provided and perform detection and annotation for each image extracted.
-        # extracted.
         # @param [Google::Apis::VisionV1p1beta1::GoogleCloudVisionV1p1beta1BatchAnnotateFilesRequest] google_cloud_vision_v1p1beta1_batch_annotate_files_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -84,12 +83,12 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Run asynchronous image detection and annotation for a list of generic
+        # Run asynchronous image detection and annotation for a list of generic files,
-        # files, such as PDF files, which may contain multiple pages and multiple
+        # such as PDF files, which may contain multiple pages and multiple images per
-        # images per page. Progress and results can be retrieved through the
+        # page. Progress and results can be retrieved through the `google.longrunning.
-        # `google.longrunning.Operations` interface.
+        # Operations` interface. `Operation.metadata` contains `OperationMetadata` (
-        # `Operation.metadata` contains `OperationMetadata` (metadata).
+        # metadata). `Operation.response` contains `AsyncBatchAnnotateFilesResponse` (
-        # `Operation.response` contains `AsyncBatchAnnotateFilesResponse` (results).
+        # results).
         # @param [Google::Apis::VisionV1p1beta1::GoogleCloudVisionV1p1beta1AsyncBatchAnnotateFilesRequest] google_cloud_vision_v1p1beta1_async_batch_annotate_files_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -149,13 +148,12 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Run asynchronous image detection and annotation for a list of images.
+        # Run asynchronous image detection and annotation for a list of images. Progress
-        # Progress and results can be retrieved through the
+        # and results can be retrieved through the `google.longrunning.Operations`
-        # `google.longrunning.Operations` interface.
+        # interface. `Operation.metadata` contains `OperationMetadata` (metadata). `
-        # `Operation.metadata` contains `OperationMetadata` (metadata).
+        # Operation.response` contains `AsyncBatchAnnotateImagesResponse` (results).
-        # `Operation.response` contains `AsyncBatchAnnotateImagesResponse` (results).
+        # This service will write image annotation outputs to json files in customer GCS
-        # This service will write image annotation outputs to json files in customer
+        # bucket, each json file containing BatchAnnotateImagesResponse proto.
-        # GCS bucket, each json file containing BatchAnnotateImagesResponse proto.
         # @param [Google::Apis::VisionV1p1beta1::GoogleCloudVisionV1p1beta1AsyncBatchAnnotateImagesRequest] google_cloud_vision_v1p1beta1_async_batch_annotate_images_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -185,21 +183,17 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Service that performs image detection and annotation for a batch of files.
+        # Service that performs image detection and annotation for a batch of files. Now
-        # Now only "application/pdf", "image/tiff" and "image/gif" are supported.
+        # only "application/pdf", "image/tiff" and "image/gif" are supported. This
-        # This service will extract at most 5 (customers can specify which 5 in
+        # service will extract at most 5 (customers can specify which 5 in
-        # AnnotateFileRequest.pages) frames (gif) or pages (pdf or tiff) from each
+        # AnnotateFileRequest.pages) frames (gif) or pages (pdf or tiff) from each file
-        # file provided and perform detection and annotation for each image
+        # provided and perform detection and annotation for each image extracted.
-        # extracted.
         # @param [String] parent
-        #   Optional. Target project and location to make a call.
+        #   Optional. Target project and location to make a call. Format: `projects/`
-        #   Format: `projects/`project-id`/locations/`location-id``.
+        #   project-id`/locations/`location-id``. If no parent is specified, a region will
-        #   If no parent is specified, a region will be chosen automatically.
+        #   be chosen automatically. Supported location-ids: `us`: USA country only, `asia`
-        #   Supported location-ids:
+        #   : East asia areas, like Japan, Taiwan, `eu`: The European Union. Example: `
-        #   `us`: USA country only,
+        #   projects/project-A/locations/eu`.
-        #   `asia`: East asia areas, like Japan, Taiwan,
-        #   `eu`: The European Union.
-        #   Example: `projects/project-A/locations/eu`.
         # @param [Google::Apis::VisionV1p1beta1::GoogleCloudVisionV1p1beta1BatchAnnotateFilesRequest] google_cloud_vision_v1p1beta1_batch_annotate_files_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -230,21 +224,18 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Run asynchronous image detection and annotation for a list of generic
+        # Run asynchronous image detection and annotation for a list of generic files,
-        # files, such as PDF files, which may contain multiple pages and multiple
+        # such as PDF files, which may contain multiple pages and multiple images per
-        # images per page. Progress and results can be retrieved through the
+        # page. Progress and results can be retrieved through the `google.longrunning.
-        # `google.longrunning.Operations` interface.
+        # Operations` interface. `Operation.metadata` contains `OperationMetadata` (
-        # `Operation.metadata` contains `OperationMetadata` (metadata).
+        # metadata). `Operation.response` contains `AsyncBatchAnnotateFilesResponse` (
-        # `Operation.response` contains `AsyncBatchAnnotateFilesResponse` (results).
+        # results).
         # @param [String] parent
-        #   Optional. Target project and location to make a call.
+        #   Optional. Target project and location to make a call. Format: `projects/`
-        #   Format: `projects/`project-id`/locations/`location-id``.
+        #   project-id`/locations/`location-id``. If no parent is specified, a region will
-        #   If no parent is specified, a region will be chosen automatically.
+        #   be chosen automatically. Supported location-ids: `us`: USA country only, `asia`
-        #   Supported location-ids:
+        #   : East asia areas, like Japan, Taiwan, `eu`: The European Union. Example: `
-        #   `us`: USA country only,
+        #   projects/project-A/locations/eu`.
-        #   `asia`: East asia areas, like Japan, Taiwan,
-        #   `eu`: The European Union.
-        #   Example: `projects/project-A/locations/eu`.
         # @param [Google::Apis::VisionV1p1beta1::GoogleCloudVisionV1p1beta1AsyncBatchAnnotateFilesRequest] google_cloud_vision_v1p1beta1_async_batch_annotate_files_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -277,14 +268,11 @@ module Google
         
         # Run image detection and annotation for a batch of images.
         # @param [String] parent
-        #   Optional. Target project and location to make a call.
+        #   Optional. Target project and location to make a call. Format: `projects/`
-        #   Format: `projects/`project-id`/locations/`location-id``.
+        #   project-id`/locations/`location-id``. If no parent is specified, a region will
-        #   If no parent is specified, a region will be chosen automatically.
+        #   be chosen automatically. Supported location-ids: `us`: USA country only, `asia`
-        #   Supported location-ids:
+        #   : East asia areas, like Japan, Taiwan, `eu`: The European Union. Example: `
-        #   `us`: USA country only,
+        #   projects/project-A/locations/eu`.
-        #   `asia`: East asia areas, like Japan, Taiwan,
-        #   `eu`: The European Union.
-        #   Example: `projects/project-A/locations/eu`.
         # @param [Google::Apis::VisionV1p1beta1::GoogleCloudVisionV1p1beta1BatchAnnotateImagesRequest] google_cloud_vision_v1p1beta1_batch_annotate_images_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -315,22 +303,18 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Run asynchronous image detection and annotation for a list of images.
+        # Run asynchronous image detection and annotation for a list of images. Progress
-        # Progress and results can be retrieved through the
+        # and results can be retrieved through the `google.longrunning.Operations`
-        # `google.longrunning.Operations` interface.
+        # interface. `Operation.metadata` contains `OperationMetadata` (metadata). `
-        # `Operation.metadata` contains `OperationMetadata` (metadata).
+        # Operation.response` contains `AsyncBatchAnnotateImagesResponse` (results).
-        # `Operation.response` contains `AsyncBatchAnnotateImagesResponse` (results).
+        # This service will write image annotation outputs to json files in customer GCS
-        # This service will write image annotation outputs to json files in customer
+        # bucket, each json file containing BatchAnnotateImagesResponse proto.
-        # GCS bucket, each json file containing BatchAnnotateImagesResponse proto.
         # @param [String] parent
-        #   Optional. Target project and location to make a call.
+        #   Optional. Target project and location to make a call. Format: `projects/`
-        #   Format: `projects/`project-id`/locations/`location-id``.
+        #   project-id`/locations/`location-id``. If no parent is specified, a region will
-        #   If no parent is specified, a region will be chosen automatically.
+        #   be chosen automatically. Supported location-ids: `us`: USA country only, `asia`
-        #   Supported location-ids:
+        #   : East asia areas, like Japan, Taiwan, `eu`: The European Union. Example: `
-        #   `us`: USA country only,
+        #   projects/project-A/locations/eu`.
-        #   `asia`: East asia areas, like Japan, Taiwan,
-        #   `eu`: The European Union.
-        #   Example: `projects/project-A/locations/eu`.
         # @param [Google::Apis::VisionV1p1beta1::GoogleCloudVisionV1p1beta1AsyncBatchAnnotateImagesRequest] google_cloud_vision_v1p1beta1_async_batch_annotate_images_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -361,21 +345,17 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Service that performs image detection and annotation for a batch of files.
+        # Service that performs image detection and annotation for a batch of files. Now
-        # Now only "application/pdf", "image/tiff" and "image/gif" are supported.
+        # only "application/pdf", "image/tiff" and "image/gif" are supported. This
-        # This service will extract at most 5 (customers can specify which 5 in
+        # service will extract at most 5 (customers can specify which 5 in
-        # AnnotateFileRequest.pages) frames (gif) or pages (pdf or tiff) from each
+        # AnnotateFileRequest.pages) frames (gif) or pages (pdf or tiff) from each file
-        # file provided and perform detection and annotation for each image
+        # provided and perform detection and annotation for each image extracted.
-        # extracted.
         # @param [String] parent
-        #   Optional. Target project and location to make a call.
+        #   Optional. Target project and location to make a call. Format: `projects/`
-        #   Format: `projects/`project-id`/locations/`location-id``.
+        #   project-id`/locations/`location-id``. If no parent is specified, a region will
-        #   If no parent is specified, a region will be chosen automatically.
+        #   be chosen automatically. Supported location-ids: `us`: USA country only, `asia`
-        #   Supported location-ids:
+        #   : East asia areas, like Japan, Taiwan, `eu`: The European Union. Example: `
-        #   `us`: USA country only,
+        #   projects/project-A/locations/eu`.
-        #   `asia`: East asia areas, like Japan, Taiwan,
-        #   `eu`: The European Union.
-        #   Example: `projects/project-A/locations/eu`.
         # @param [Google::Apis::VisionV1p1beta1::GoogleCloudVisionV1p1beta1BatchAnnotateFilesRequest] google_cloud_vision_v1p1beta1_batch_annotate_files_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -406,21 +386,18 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Run asynchronous image detection and annotation for a list of generic
+        # Run asynchronous image detection and annotation for a list of generic files,
-        # files, such as PDF files, which may contain multiple pages and multiple
+        # such as PDF files, which may contain multiple pages and multiple images per
-        # images per page. Progress and results can be retrieved through the
+        # page. Progress and results can be retrieved through the `google.longrunning.
-        # `google.longrunning.Operations` interface.
+        # Operations` interface. `Operation.metadata` contains `OperationMetadata` (
-        # `Operation.metadata` contains `OperationMetadata` (metadata).
+        # metadata). `Operation.response` contains `AsyncBatchAnnotateFilesResponse` (
-        # `Operation.response` contains `AsyncBatchAnnotateFilesResponse` (results).
+        # results).
         # @param [String] parent
-        #   Optional. Target project and location to make a call.
+        #   Optional. Target project and location to make a call. Format: `projects/`
-        #   Format: `projects/`project-id`/locations/`location-id``.
+        #   project-id`/locations/`location-id``. If no parent is specified, a region will
-        #   If no parent is specified, a region will be chosen automatically.
+        #   be chosen automatically. Supported location-ids: `us`: USA country only, `asia`
-        #   Supported location-ids:
+        #   : East asia areas, like Japan, Taiwan, `eu`: The European Union. Example: `
-        #   `us`: USA country only,
+        #   projects/project-A/locations/eu`.
-        #   `asia`: East asia areas, like Japan, Taiwan,
-        #   `eu`: The European Union.
-        #   Example: `projects/project-A/locations/eu`.
         # @param [Google::Apis::VisionV1p1beta1::GoogleCloudVisionV1p1beta1AsyncBatchAnnotateFilesRequest] google_cloud_vision_v1p1beta1_async_batch_annotate_files_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -453,14 +430,11 @@ module Google
         
         # Run image detection and annotation for a batch of images.
         # @param [String] parent
-        #   Optional. Target project and location to make a call.
+        #   Optional. Target project and location to make a call. Format: `projects/`
-        #   Format: `projects/`project-id`/locations/`location-id``.
+        #   project-id`/locations/`location-id``. If no parent is specified, a region will
-        #   If no parent is specified, a region will be chosen automatically.
+        #   be chosen automatically. Supported location-ids: `us`: USA country only, `asia`
-        #   Supported location-ids:
+        #   : East asia areas, like Japan, Taiwan, `eu`: The European Union. Example: `
-        #   `us`: USA country only,
+        #   projects/project-A/locations/eu`.
-        #   `asia`: East asia areas, like Japan, Taiwan,
-        #   `eu`: The European Union.
-        #   Example: `projects/project-A/locations/eu`.
         # @param [Google::Apis::VisionV1p1beta1::GoogleCloudVisionV1p1beta1BatchAnnotateImagesRequest] google_cloud_vision_v1p1beta1_batch_annotate_images_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -491,22 +465,18 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Run asynchronous image detection and annotation for a list of images.
+        # Run asynchronous image detection and annotation for a list of images. Progress
-        # Progress and results can be retrieved through the
+        # and results can be retrieved through the `google.longrunning.Operations`
-        # `google.longrunning.Operations` interface.
+        # interface. `Operation.metadata` contains `OperationMetadata` (metadata). `
-        # `Operation.metadata` contains `OperationMetadata` (metadata).
+        # Operation.response` contains `AsyncBatchAnnotateImagesResponse` (results).
-        # `Operation.response` contains `AsyncBatchAnnotateImagesResponse` (results).
+        # This service will write image annotation outputs to json files in customer GCS
-        # This service will write image annotation outputs to json files in customer
+        # bucket, each json file containing BatchAnnotateImagesResponse proto.
-        # GCS bucket, each json file containing BatchAnnotateImagesResponse proto.
         # @param [String] parent
-        #   Optional. Target project and location to make a call.
+        #   Optional. Target project and location to make a call. Format: `projects/`
-        #   Format: `projects/`project-id`/locations/`location-id``.
+        #   project-id`/locations/`location-id``. If no parent is specified, a region will
-        #   If no parent is specified, a region will be chosen automatically.
+        #   be chosen automatically. Supported location-ids: `us`: USA country only, `asia`
-        #   Supported location-ids:
+        #   : East asia areas, like Japan, Taiwan, `eu`: The European Union. Example: `
-        #   `us`: USA country only,
+        #   projects/project-A/locations/eu`.
-        #   `asia`: East asia areas, like Japan, Taiwan,
-        #   `eu`: The European Union.
-        #   Example: `projects/project-A/locations/eu`.
         # @param [Google::Apis::VisionV1p1beta1::GoogleCloudVisionV1p1beta1AsyncBatchAnnotateImagesRequest] google_cloud_vision_v1p1beta1_async_batch_annotate_images_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.

generated/google/apis/vision_v1p2beta1.rb

@@ -27,7 +27,7 @@ module Google
     # @see https://cloud.google.com/vision/
     module VisionV1p2beta1
       VERSION = 'V1p2beta1'
-      REVISION = '20200710'
+      REVISION = '20200801'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

generated/google/apis/vision_v1p2beta1/service.rb

@@ -49,12 +49,11 @@ module Google
           @batch_path = 'batch'
         end
         
-        # Service that performs image detection and annotation for a batch of files.
+        # Service that performs image detection and annotation for a batch of files. Now
-        # Now only "application/pdf", "image/tiff" and "image/gif" are supported.
+        # only "application/pdf", "image/tiff" and "image/gif" are supported. This
-        # This service will extract at most 5 (customers can specify which 5 in
+        # service will extract at most 5 (customers can specify which 5 in
-        # AnnotateFileRequest.pages) frames (gif) or pages (pdf or tiff) from each
+        # AnnotateFileRequest.pages) frames (gif) or pages (pdf or tiff) from each file
-        # file provided and perform detection and annotation for each image
+        # provided and perform detection and annotation for each image extracted.
-        # extracted.
         # @param [Google::Apis::VisionV1p2beta1::GoogleCloudVisionV1p2beta1BatchAnnotateFilesRequest] google_cloud_vision_v1p2beta1_batch_annotate_files_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -84,12 +83,12 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Run asynchronous image detection and annotation for a list of generic
+        # Run asynchronous image detection and annotation for a list of generic files,
-        # files, such as PDF files, which may contain multiple pages and multiple
+        # such as PDF files, which may contain multiple pages and multiple images per
-        # images per page. Progress and results can be retrieved through the
+        # page. Progress and results can be retrieved through the `google.longrunning.
-        # `google.longrunning.Operations` interface.
+        # Operations` interface. `Operation.metadata` contains `OperationMetadata` (
-        # `Operation.metadata` contains `OperationMetadata` (metadata).
+        # metadata). `Operation.response` contains `AsyncBatchAnnotateFilesResponse` (
-        # `Operation.response` contains `AsyncBatchAnnotateFilesResponse` (results).
+        # results).
         # @param [Google::Apis::VisionV1p2beta1::GoogleCloudVisionV1p2beta1AsyncBatchAnnotateFilesRequest] google_cloud_vision_v1p2beta1_async_batch_annotate_files_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -149,13 +148,12 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Run asynchronous image detection and annotation for a list of images.
+        # Run asynchronous image detection and annotation for a list of images. Progress
-        # Progress and results can be retrieved through the
+        # and results can be retrieved through the `google.longrunning.Operations`
-        # `google.longrunning.Operations` interface.
+        # interface. `Operation.metadata` contains `OperationMetadata` (metadata). `
-        # `Operation.metadata` contains `OperationMetadata` (metadata).
+        # Operation.response` contains `AsyncBatchAnnotateImagesResponse` (results).
-        # `Operation.response` contains `AsyncBatchAnnotateImagesResponse` (results).
+        # This service will write image annotation outputs to json files in customer GCS
-        # This service will write image annotation outputs to json files in customer
+        # bucket, each json file containing BatchAnnotateImagesResponse proto.
-        # GCS bucket, each json file containing BatchAnnotateImagesResponse proto.
         # @param [Google::Apis::VisionV1p2beta1::GoogleCloudVisionV1p2beta1AsyncBatchAnnotateImagesRequest] google_cloud_vision_v1p2beta1_async_batch_annotate_images_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -185,21 +183,17 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Service that performs image detection and annotation for a batch of files.
+        # Service that performs image detection and annotation for a batch of files. Now
-        # Now only "application/pdf", "image/tiff" and "image/gif" are supported.
+        # only "application/pdf", "image/tiff" and "image/gif" are supported. This
-        # This service will extract at most 5 (customers can specify which 5 in
+        # service will extract at most 5 (customers can specify which 5 in
-        # AnnotateFileRequest.pages) frames (gif) or pages (pdf or tiff) from each
+        # AnnotateFileRequest.pages) frames (gif) or pages (pdf or tiff) from each file
-        # file provided and perform detection and annotation for each image
+        # provided and perform detection and annotation for each image extracted.
-        # extracted.
         # @param [String] parent
-        #   Optional. Target project and location to make a call.
+        #   Optional. Target project and location to make a call. Format: `projects/`
-        #   Format: `projects/`project-id`/locations/`location-id``.
+        #   project-id`/locations/`location-id``. If no parent is specified, a region will
-        #   If no parent is specified, a region will be chosen automatically.
+        #   be chosen automatically. Supported location-ids: `us`: USA country only, `asia`
-        #   Supported location-ids:
+        #   : East asia areas, like Japan, Taiwan, `eu`: The European Union. Example: `
-        #   `us`: USA country only,
+        #   projects/project-A/locations/eu`.
-        #   `asia`: East asia areas, like Japan, Taiwan,
-        #   `eu`: The European Union.
-        #   Example: `projects/project-A/locations/eu`.
         # @param [Google::Apis::VisionV1p2beta1::GoogleCloudVisionV1p2beta1BatchAnnotateFilesRequest] google_cloud_vision_v1p2beta1_batch_annotate_files_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -230,21 +224,18 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Run asynchronous image detection and annotation for a list of generic
+        # Run asynchronous image detection and annotation for a list of generic files,
-        # files, such as PDF files, which may contain multiple pages and multiple
+        # such as PDF files, which may contain multiple pages and multiple images per
-        # images per page. Progress and results can be retrieved through the
+        # page. Progress and results can be retrieved through the `google.longrunning.
-        # `google.longrunning.Operations` interface.
+        # Operations` interface. `Operation.metadata` contains `OperationMetadata` (
-        # `Operation.metadata` contains `OperationMetadata` (metadata).
+        # metadata). `Operation.response` contains `AsyncBatchAnnotateFilesResponse` (
-        # `Operation.response` contains `AsyncBatchAnnotateFilesResponse` (results).
+        # results).
         # @param [String] parent
-        #   Optional. Target project and location to make a call.
+        #   Optional. Target project and location to make a call. Format: `projects/`
-        #   Format: `projects/`project-id`/locations/`location-id``.
+        #   project-id`/locations/`location-id``. If no parent is specified, a region will
-        #   If no parent is specified, a region will be chosen automatically.
+        #   be chosen automatically. Supported location-ids: `us`: USA country only, `asia`
-        #   Supported location-ids:
+        #   : East asia areas, like Japan, Taiwan, `eu`: The European Union. Example: `
-        #   `us`: USA country only,
+        #   projects/project-A/locations/eu`.
-        #   `asia`: East asia areas, like Japan, Taiwan,
-        #   `eu`: The European Union.
-        #   Example: `projects/project-A/locations/eu`.
         # @param [Google::Apis::VisionV1p2beta1::GoogleCloudVisionV1p2beta1AsyncBatchAnnotateFilesRequest] google_cloud_vision_v1p2beta1_async_batch_annotate_files_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -277,14 +268,11 @@ module Google
         
         # Run image detection and annotation for a batch of images.
         # @param [String] parent
-        #   Optional. Target project and location to make a call.
+        #   Optional. Target project and location to make a call. Format: `projects/`
-        #   Format: `projects/`project-id`/locations/`location-id``.
+        #   project-id`/locations/`location-id``. If no parent is specified, a region will
-        #   If no parent is specified, a region will be chosen automatically.
+        #   be chosen automatically. Supported location-ids: `us`: USA country only, `asia`
-        #   Supported location-ids:
+        #   : East asia areas, like Japan, Taiwan, `eu`: The European Union. Example: `
-        #   `us`: USA country only,
+        #   projects/project-A/locations/eu`.
-        #   `asia`: East asia areas, like Japan, Taiwan,
-        #   `eu`: The European Union.
-        #   Example: `projects/project-A/locations/eu`.
         # @param [Google::Apis::VisionV1p2beta1::GoogleCloudVisionV1p2beta1BatchAnnotateImagesRequest] google_cloud_vision_v1p2beta1_batch_annotate_images_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -315,22 +303,18 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Run asynchronous image detection and annotation for a list of images.
+        # Run asynchronous image detection and annotation for a list of images. Progress
-        # Progress and results can be retrieved through the
+        # and results can be retrieved through the `google.longrunning.Operations`
-        # `google.longrunning.Operations` interface.
+        # interface. `Operation.metadata` contains `OperationMetadata` (metadata). `
-        # `Operation.metadata` contains `OperationMetadata` (metadata).
+        # Operation.response` contains `AsyncBatchAnnotateImagesResponse` (results).
-        # `Operation.response` contains `AsyncBatchAnnotateImagesResponse` (results).
+        # This service will write image annotation outputs to json files in customer GCS
-        # This service will write image annotation outputs to json files in customer
+        # bucket, each json file containing BatchAnnotateImagesResponse proto.
-        # GCS bucket, each json file containing BatchAnnotateImagesResponse proto.
         # @param [String] parent
-        #   Optional. Target project and location to make a call.
+        #   Optional. Target project and location to make a call. Format: `projects/`
-        #   Format: `projects/`project-id`/locations/`location-id``.
+        #   project-id`/locations/`location-id``. If no parent is specified, a region will
-        #   If no parent is specified, a region will be chosen automatically.
+        #   be chosen automatically. Supported location-ids: `us`: USA country only, `asia`
-        #   Supported location-ids:
+        #   : East asia areas, like Japan, Taiwan, `eu`: The European Union. Example: `
-        #   `us`: USA country only,
+        #   projects/project-A/locations/eu`.
-        #   `asia`: East asia areas, like Japan, Taiwan,
-        #   `eu`: The European Union.
-        #   Example: `projects/project-A/locations/eu`.
         # @param [Google::Apis::VisionV1p2beta1::GoogleCloudVisionV1p2beta1AsyncBatchAnnotateImagesRequest] google_cloud_vision_v1p2beta1_async_batch_annotate_images_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -361,21 +345,17 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Service that performs image detection and annotation for a batch of files.
+        # Service that performs image detection and annotation for a batch of files. Now
-        # Now only "application/pdf", "image/tiff" and "image/gif" are supported.
+        # only "application/pdf", "image/tiff" and "image/gif" are supported. This
-        # This service will extract at most 5 (customers can specify which 5 in
+        # service will extract at most 5 (customers can specify which 5 in
-        # AnnotateFileRequest.pages) frames (gif) or pages (pdf or tiff) from each
+        # AnnotateFileRequest.pages) frames (gif) or pages (pdf or tiff) from each file
-        # file provided and perform detection and annotation for each image
+        # provided and perform detection and annotation for each image extracted.
-        # extracted.
         # @param [String] parent
-        #   Optional. Target project and location to make a call.
+        #   Optional. Target project and location to make a call. Format: `projects/`
-        #   Format: `projects/`project-id`/locations/`location-id``.
+        #   project-id`/locations/`location-id``. If no parent is specified, a region will
-        #   If no parent is specified, a region will be chosen automatically.
+        #   be chosen automatically. Supported location-ids: `us`: USA country only, `asia`
-        #   Supported location-ids:
+        #   : East asia areas, like Japan, Taiwan, `eu`: The European Union. Example: `
-        #   `us`: USA country only,
+        #   projects/project-A/locations/eu`.
-        #   `asia`: East asia areas, like Japan, Taiwan,
-        #   `eu`: The European Union.
-        #   Example: `projects/project-A/locations/eu`.
         # @param [Google::Apis::VisionV1p2beta1::GoogleCloudVisionV1p2beta1BatchAnnotateFilesRequest] google_cloud_vision_v1p2beta1_batch_annotate_files_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -406,21 +386,18 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Run asynchronous image detection and annotation for a list of generic
+        # Run asynchronous image detection and annotation for a list of generic files,
-        # files, such as PDF files, which may contain multiple pages and multiple
+        # such as PDF files, which may contain multiple pages and multiple images per
-        # images per page. Progress and results can be retrieved through the
+        # page. Progress and results can be retrieved through the `google.longrunning.
-        # `google.longrunning.Operations` interface.
+        # Operations` interface. `Operation.metadata` contains `OperationMetadata` (
-        # `Operation.metadata` contains `OperationMetadata` (metadata).
+        # metadata). `Operation.response` contains `AsyncBatchAnnotateFilesResponse` (
-        # `Operation.response` contains `AsyncBatchAnnotateFilesResponse` (results).
+        # results).
         # @param [String] parent
-        #   Optional. Target project and location to make a call.
+        #   Optional. Target project and location to make a call. Format: `projects/`
-        #   Format: `projects/`project-id`/locations/`location-id``.
+        #   project-id`/locations/`location-id``. If no parent is specified, a region will
-        #   If no parent is specified, a region will be chosen automatically.
+        #   be chosen automatically. Supported location-ids: `us`: USA country only, `asia`
-        #   Supported location-ids:
+        #   : East asia areas, like Japan, Taiwan, `eu`: The European Union. Example: `
-        #   `us`: USA country only,
+        #   projects/project-A/locations/eu`.
-        #   `asia`: East asia areas, like Japan, Taiwan,
-        #   `eu`: The European Union.
-        #   Example: `projects/project-A/locations/eu`.
         # @param [Google::Apis::VisionV1p2beta1::GoogleCloudVisionV1p2beta1AsyncBatchAnnotateFilesRequest] google_cloud_vision_v1p2beta1_async_batch_annotate_files_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -453,14 +430,11 @@ module Google
         
         # Run image detection and annotation for a batch of images.
         # @param [String] parent
-        #   Optional. Target project and location to make a call.
+        #   Optional. Target project and location to make a call. Format: `projects/`
-        #   Format: `projects/`project-id`/locations/`location-id``.
+        #   project-id`/locations/`location-id``. If no parent is specified, a region will
-        #   If no parent is specified, a region will be chosen automatically.
+        #   be chosen automatically. Supported location-ids: `us`: USA country only, `asia`
-        #   Supported location-ids:
+        #   : East asia areas, like Japan, Taiwan, `eu`: The European Union. Example: `
-        #   `us`: USA country only,
+        #   projects/project-A/locations/eu`.
-        #   `asia`: East asia areas, like Japan, Taiwan,
-        #   `eu`: The European Union.
-        #   Example: `projects/project-A/locations/eu`.
         # @param [Google::Apis::VisionV1p2beta1::GoogleCloudVisionV1p2beta1BatchAnnotateImagesRequest] google_cloud_vision_v1p2beta1_batch_annotate_images_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -491,22 +465,18 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Run asynchronous image detection and annotation for a list of images.
+        # Run asynchronous image detection and annotation for a list of images. Progress
-        # Progress and results can be retrieved through the
+        # and results can be retrieved through the `google.longrunning.Operations`
-        # `google.longrunning.Operations` interface.
+        # interface. `Operation.metadata` contains `OperationMetadata` (metadata). `
-        # `Operation.metadata` contains `OperationMetadata` (metadata).
+        # Operation.response` contains `AsyncBatchAnnotateImagesResponse` (results).
-        # `Operation.response` contains `AsyncBatchAnnotateImagesResponse` (results).
+        # This service will write image annotation outputs to json files in customer GCS
-        # This service will write image annotation outputs to json files in customer
+        # bucket, each json file containing BatchAnnotateImagesResponse proto.
-        # GCS bucket, each json file containing BatchAnnotateImagesResponse proto.
         # @param [String] parent
-        #   Optional. Target project and location to make a call.
+        #   Optional. Target project and location to make a call. Format: `projects/`
-        #   Format: `projects/`project-id`/locations/`location-id``.
+        #   project-id`/locations/`location-id``. If no parent is specified, a region will
-        #   If no parent is specified, a region will be chosen automatically.
+        #   be chosen automatically. Supported location-ids: `us`: USA country only, `asia`
-        #   Supported location-ids:
+        #   : East asia areas, like Japan, Taiwan, `eu`: The European Union. Example: `
-        #   `us`: USA country only,
+        #   projects/project-A/locations/eu`.
-        #   `asia`: East asia areas, like Japan, Taiwan,
-        #   `eu`: The European Union.
-        #   Example: `projects/project-A/locations/eu`.
         # @param [Google::Apis::VisionV1p2beta1::GoogleCloudVisionV1p2beta1AsyncBatchAnnotateImagesRequest] google_cloud_vision_v1p2beta1_async_batch_annotate_images_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.