google-api-client 0.42.2 → 0.45.0

data/generated/google/apis/digitalassetlinks_v1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://developers.google.com/digital-asset-links/
     module DigitalassetlinksV1
       VERSION = 'V1'
-      REVISION = '20200222'
+      REVISION = '20200829'
     end
   end
 end

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

@@ -31,10 +31,9 @@ module Google
         # @return [Google::Apis::DigitalassetlinksV1::CertificateInfo]
         attr_accessor :certificate
       
-        # Android App assets are naturally identified by their Java package name.
-        # For example, the Google Maps app uses the package name
-        # `com.google.android.apps.maps`.
-        # REQUIRED
+        # Android App assets are naturally identified by their Java package name. For
+        # example, the Google Maps app uses the package name `com.google.android.apps.
+        # maps`. REQUIRED
         # Corresponds to the JSON property `packageName`
         # @return [String]
         attr_accessor :package_name
@@ -50,10 +49,9 @@ module Google
         end
       end
       
-      # Uniquely identifies an asset.
-      # A digital asset is an identifiable and addressable online entity that
-      # typically provides some service or content.  Examples of assets are websites,
-      # Android apps, Twitter feeds, and Plus Pages.
+      # Uniquely identifies an asset. A digital asset is an identifiable and
+      # addressable online entity that typically provides some service or content.
+      # Examples of assets are websites, Android apps, Twitter feeds, and Plus Pages.
       class Asset
         include Google::Apis::Core::Hashable
       
@@ -82,22 +80,18 @@ module Google
       class CertificateInfo
         include Google::Apis::Core::Hashable
       
-        # The uppercase SHA-265 fingerprint of the certificate.  From the PEM
-        # certificate, it can be acquired like this:
-        # $ keytool -printcert -file $CERTFILE | grep SHA256:
-        # SHA256: 14:6D:E9:83:C5:73:06:50:D8:EE:B9:95:2F:34:FC:64:16:A0:83: \
-        # 42:E6:1D:BE:A8:8A:04:96:B2:3F:CF:44:E5
-        # or like this:
-        # $ openssl x509 -in $CERTFILE -noout -fingerprint -sha256
-        # SHA256 Fingerprint=14:6D:E9:83:C5:73:06:50:D8:EE:B9:95:2F:34:FC:64: \
-        # 16:A0:83:42:E6:1D:BE:A8:8A:04:96:B2:3F:CF:44:E5
-        # In this example, the contents of this field would be `14:6D:E9:83:C5:73:
-        # 06:50:D8:EE:B9:95:2F:34:FC:64:16:A0:83:42:E6:1D:BE:A8:8A:04:96:B2:3F:CF:
-        # 44:E5`.
-        # If these tools are not available to you, you can convert the PEM
-        # certificate into the DER format, compute the SHA-256 hash of that string
-        # and represent the result as a hexstring (that is, uppercase hexadecimal
-        # representations of each octet, separated by colons).
+        # The uppercase SHA-265 fingerprint of the certificate. From the PEM certificate,
+        # it can be acquired like this: $ keytool -printcert -file $CERTFILE | grep
+        # SHA256: SHA256: 14:6D:E9:83:C5:73:06:50:D8:EE:B9:95:2F:34:FC:64:16:A0:83: \ 42:
+        # E6:1D:BE:A8:8A:04:96:B2:3F:CF:44:E5 or like this: $ openssl x509 -in $CERTFILE
+        # -noout -fingerprint -sha256 SHA256 Fingerprint=14:6D:E9:83:C5:73:06:50:D8:EE:
+        # B9:95:2F:34:FC:64: \ 16:A0:83:42:E6:1D:BE:A8:8A:04:96:B2:3F:CF:44:E5 In this
+        # example, the contents of this field would be `14:6D:E9:83:C5:73: 06:50:D8:EE:
+        # B9:95:2F:34:FC:64:16:A0:83:42:E6:1D:BE:A8:8A:04:96:B2:3F:CF: 44:E5`. If these
+        # tools are not available to you, you can convert the PEM certificate into the
+        # DER format, compute the SHA-256 hash of that string and represent the result
+        # as a hexstring (that is, uppercase hexadecimal representations of each octet,
+        # separated by colons).
         # Corresponds to the JSON property `sha256Fingerprint`
         # @return [String]
         attr_accessor :sha256_fingerprint
@@ -117,13 +111,12 @@ module Google
         include Google::Apis::Core::Hashable
       
         # Human-readable message containing information intended to help end users
-        # understand, reproduce and debug the result.
-        # The message will be in English and we are currently not planning to offer
-        # any translations.
-        # Please note that no guarantees are made about the contents or format of
-        # this string.  Any aspect of it may be subject to change without notice.
-        # You should not attempt to programmatically parse this data.  For
-        # programmatic access, use the error_code field below.
+        # understand, reproduce and debug the result. The message will be in English and
+        # we are currently not planning to offer any translations. Please note that no
+        # guarantees are made about the contents or format of this string. Any aspect of
+        # it may be subject to change without notice. You should not attempt to
+        # programmatically parse this data. For programmatic access, use the error_code
+        # field below.
         # Corresponds to the JSON property `debugString`
         # @return [String]
         attr_accessor :debug_string
@@ -133,16 +126,15 @@ module Google
         # @return [Array<String>]
         attr_accessor :error_code
       
-        # Set to true if the assets specified in the request are linked by the
-        # relation specified in the request.
+        # Set to true if the assets specified in the request are linked by the relation
+        # specified in the request.
         # Corresponds to the JSON property `linked`
         # @return [Boolean]
         attr_accessor :linked
         alias_method :linked?, :linked
       
         # From serving time, how much longer the response should be considered valid
-        # barring further updates.
-        # REQUIRED
+        # barring further updates. REQUIRED
         # Corresponds to the JSON property `maxAge`
         # @return [String]
         attr_accessor :max_age
@@ -165,13 +157,12 @@ module Google
         include Google::Apis::Core::Hashable
       
         # Human-readable message containing information intended to help end users
-        # understand, reproduce and debug the result.
-        # The message will be in English and we are currently not planning to offer
-        # any translations.
-        # Please note that no guarantees are made about the contents or format of
-        # this string.  Any aspect of it may be subject to change without notice.
-        # You should not attempt to programmatically parse this data.  For
-        # programmatic access, use the error_code field below.
+        # understand, reproduce and debug the result. The message will be in English and
+        # we are currently not planning to offer any translations. Please note that no
+        # guarantees are made about the contents or format of this string. Any aspect of
+        # it may be subject to change without notice. You should not attempt to
+        # programmatically parse this data. For programmatic access, use the error_code
+        # field below.
         # Corresponds to the JSON property `debugString`
         # @return [String]
         attr_accessor :debug_string
@@ -182,8 +173,7 @@ module Google
         attr_accessor :error_code
       
         # From serving time, how much longer the response should be considered valid
-        # barring further updates.
-        # REQUIRED
+        # barring further updates. REQUIRED
         # Corresponds to the JSON property `maxAge`
         # @return [String]
         attr_accessor :max_age
@@ -207,42 +197,36 @@ module Google
       end
       
       # Describes a reliable statement that has been made about the relationship
-      # between a source asset and a target asset.
-      # Statements are always made by the source asset, either directly or by
-      # delegating to a statement list that is stored elsewhere.
-      # For more detailed definitions of statements and assets, please refer
-      # to our [API documentation landing
-      # page](/digital-asset-links/v1/getting-started).
+      # between a source asset and a target asset. Statements are always made by the
+      # source asset, either directly or by delegating to a statement list that is
+      # stored elsewhere. For more detailed definitions of statements and assets,
+      # please refer to our [API documentation landing page](/digital-asset-links/v1/
+      # getting-started).
       class Statement
         include Google::Apis::Core::Hashable
       
         # The relation identifies the use of the statement as intended by the source
-        # asset's owner (that is, the person or entity who issued the statement).
-        # Every complete statement has a relation.
-        # We identify relations with strings of the format `<kind>/<detail>`, where
-        # `<kind>` must be one of a set of pre-defined purpose categories, and
-        # `<detail>` is a free-form lowercase alphanumeric string that describes the
-        # specific use case of the statement.
-        # Refer to [our API documentation](/digital-asset-links/v1/relation-strings)
-        # for the current list of supported relations.
-        # Example: `delegate_permission/common.handle_all_urls`
-        # REQUIRED
+        # asset's owner (that is, the person or entity who issued the statement). Every
+        # complete statement has a relation. We identify relations with strings of the
+        # format `/`, where `` must be one of a set of pre-defined purpose categories,
+        # and `` is a free-form lowercase alphanumeric string that describes the
+        # specific use case of the statement. Refer to [our API documentation](/digital-
+        # asset-links/v1/relation-strings) for the current list of supported relations.
+        # Example: `delegate_permission/common.handle_all_urls` REQUIRED
         # Corresponds to the JSON property `relation`
         # @return [String]
         attr_accessor :relation
       
-        # Uniquely identifies an asset.
-        # A digital asset is an identifiable and addressable online entity that
-        # typically provides some service or content.  Examples of assets are websites,
-        # Android apps, Twitter feeds, and Plus Pages.
+        # Uniquely identifies an asset. A digital asset is an identifiable and
+        # addressable online entity that typically provides some service or content.
+        # Examples of assets are websites, Android apps, Twitter feeds, and Plus Pages.
         # Corresponds to the JSON property `source`
         # @return [Google::Apis::DigitalassetlinksV1::Asset]
         attr_accessor :source
       
-        # Uniquely identifies an asset.
-        # A digital asset is an identifiable and addressable online entity that
-        # typically provides some service or content.  Examples of assets are websites,
-        # Android apps, Twitter feeds, and Plus Pages.
+        # Uniquely identifies an asset. A digital asset is an identifiable and
+        # addressable online entity that typically provides some service or content.
+        # Examples of assets are websites, Android apps, Twitter feeds, and Plus Pages.
         # Corresponds to the JSON property `target`
         # @return [Google::Apis::DigitalassetlinksV1::Asset]
         attr_accessor :target
@@ -263,30 +247,20 @@ module Google
       class WebAsset
         include Google::Apis::Core::Hashable
       
-        # Web assets are identified by a URL that contains only the scheme, hostname
-        # and port parts.  The format is
-        # http[s]://<hostname>[:<port>]
-        # Hostnames must be fully qualified: they must end in a single period
-        # ("`.`").
-        # Only the schemes "http" and "https" are currently allowed.
-        # Port numbers are given as a decimal number, and they must be omitted if the
-        # standard port numbers are used: 80 for http and 443 for https.
-        # We call this limited URL the "site".  All URLs that share the same scheme,
-        # hostname and port are considered to be a part of the site and thus belong
-        # to the web asset.
-        # Example: the asset with the site `https://www.google.com` contains all
-        # these URLs:
-        # *   `https://www.google.com/`
-        # *   `https://www.google.com:443/`
-        # *   `https://www.google.com/foo`
-        # *   `https://www.google.com/foo?bar`
-        # *   `https://www.google.com/foo#bar`
-        # *   `https://user@password:www.google.com/`
-        # But it does not contain these URLs:
-        # *   `http://www.google.com/`       (wrong scheme)
-        # *   `https://google.com/`          (hostname does not match)
-        # *   `https://www.google.com:444/`  (port does not match)
-        # REQUIRED
+        # Web assets are identified by a URL that contains only the scheme, hostname and
+        # port parts. The format is http[s]://[:] Hostnames must be fully qualified:
+        # they must end in a single period ("`.`"). Only the schemes "http" and "https"
+        # are currently allowed. Port numbers are given as a decimal number, and they
+        # must be omitted if the standard port numbers are used: 80 for http and 443 for
+        # https. We call this limited URL the "site". All URLs that share the same
+        # scheme, hostname and port are considered to be a part of the site and thus
+        # belong to the web asset. Example: the asset with the site `https://www.google.
+        # com` contains all these URLs: * `https://www.google.com/` * `https://www.
+        # google.com:443/` * `https://www.google.com/foo` * `https://www.google.com/foo?
+        # bar` * `https://www.google.com/foo#bar` * `https://user@password:www.google.
+        # com/` But it does not contain these URLs: * `http://www.google.com/` (wrong
+        # scheme) * `https://google.com/` (hostname does not match) * `https://www.
+        # google.com:444/` (port does not match) REQUIRED
         # Corresponds to the JSON property `site`
         # @return [String]
         attr_accessor :site

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

@@ -47,134 +47,98 @@ module Google
           @batch_path = 'batch'
         end
         
-        # Determines whether the specified (directional) relationship exists between
-        # the specified source and target assets.
-        # The relation describes the intent of the link between the two assets as
-        # claimed by the source asset.  An example for such relationships is the
-        # delegation of privileges or permissions.
-        # This command is most often used by infrastructure systems to check
-        # preconditions for an action.  For example, a client may want to know if it
-        # is OK to send a web URL to a particular mobile app instead. The client can
-        # check for the relevant asset link from the website to the mobile app to
-        # decide if the operation should be allowed.
-        # A note about security: if you specify a secure asset as the source, such as
-        # an HTTPS website or an Android app, the API will ensure that any
-        # statements used to generate the response have been made in a secure way by
-        # the owner of that asset.  Conversely, if the source asset is an insecure
-        # HTTP website (that is, the URL starts with `http://` instead of
-        # `https://`), the API cannot verify its statements securely, and it is not
+        # Determines whether the specified (directional) relationship exists between the
+        # specified source and target assets. The relation describes the intent of the
+        # link between the two assets as claimed by the source asset. An example for
+        # such relationships is the delegation of privileges or permissions. This
+        # command is most often used by infrastructure systems to check preconditions
+        # for an action. For example, a client may want to know if it is OK to send a
+        # web URL to a particular mobile app instead. The client can check for the
+        # relevant asset link from the website to the mobile app to decide if the
+        # operation should be allowed. A note about security: if you specify a secure
+        # asset as the source, such as an HTTPS website or an Android app, the API will
+        # ensure that any statements used to generate the response have been made in a
+        # secure way by the owner of that asset. Conversely, if the source asset is an
+        # insecure HTTP website (that is, the URL starts with `http://` instead of `
+        # https://`), the API cannot verify its statements securely, and it is not
         # possible to ensure that the website's statements have not been altered by a
-        # third party.  For more information, see the [Digital Asset Links technical
-        # design
-        # specification](https://github.com/google/digitalassetlinks/blob/master/well-
-        # known/details.md).
+        # third party. For more information, see the [Digital Asset Links technical
+        # design specification](https://github.com/google/digitalassetlinks/blob/master/
+        # well-known/details.md).
         # @param [String] relation
-        #   Query string for the relation.
-        #   We identify relations with strings of the format `<kind>/<detail>`, where
-        #   `<kind>` must be one of a set of pre-defined purpose categories, and
-        #   `<detail>` is a free-form lowercase alphanumeric string that describes the
-        #   specific use case of the statement.
-        #   Refer to [our API documentation](/digital-asset-links/v1/relation-strings)
-        #   for the current list of supported relations.
+        #   Query string for the relation. We identify relations with strings of the
+        #   format `/`, where `` must be one of a set of pre-defined purpose categories,
+        #   and `` is a free-form lowercase alphanumeric string that describes the
+        #   specific use case of the statement. Refer to [our API documentation](/digital-
+        #   asset-links/v1/relation-strings) for the current list of supported relations.
         #   For a query to match an asset link, both the query's and the asset link's
-        #   relation strings must match exactly.
-        #   Example: A query with relation `delegate_permission/common.handle_all_urls`
-        #   matches an asset link with relation
-        #   `delegate_permission/common.handle_all_urls`.
+        #   relation strings must match exactly. Example: A query with relation `
+        #   delegate_permission/common.handle_all_urls` matches an asset link with
+        #   relation `delegate_permission/common.handle_all_urls`.
         # @param [String] source_android_app_certificate_sha256_fingerprint
-        #   The uppercase SHA-265 fingerprint of the certificate.  From the PEM
-        #   certificate, it can be acquired like this:
-        #   $ keytool -printcert -file $CERTFILE | grep SHA256:
-        #   SHA256: 14:6D:E9:83:C5:73:06:50:D8:EE:B9:95:2F:34:FC:64:16:A0:83: \
-        #   42:E6:1D:BE:A8:8A:04:96:B2:3F:CF:44:E5
-        #   or like this:
-        #   $ openssl x509 -in $CERTFILE -noout -fingerprint -sha256
-        #   SHA256 Fingerprint=14:6D:E9:83:C5:73:06:50:D8:EE:B9:95:2F:34:FC:64: \
-        #   16:A0:83:42:E6:1D:BE:A8:8A:04:96:B2:3F:CF:44:E5
-        #   In this example, the contents of this field would be `14:6D:E9:83:C5:73:
-        #   06:50:D8:EE:B9:95:2F:34:FC:64:16:A0:83:42:E6:1D:BE:A8:8A:04:96:B2:3F:CF:
-        #   44:E5`.
-        #   If these tools are not available to you, you can convert the PEM
-        #   certificate into the DER format, compute the SHA-256 hash of that string
-        #   and represent the result as a hexstring (that is, uppercase hexadecimal
-        #   representations of each octet, separated by colons).
+        #   The uppercase SHA-265 fingerprint of the certificate. From the PEM certificate,
+        #   it can be acquired like this: $ keytool -printcert -file $CERTFILE | grep
+        #   SHA256: SHA256: 14:6D:E9:83:C5:73:06:50:D8:EE:B9:95:2F:34:FC:64:16:A0:83: \ 42:
+        #   E6:1D:BE:A8:8A:04:96:B2:3F:CF:44:E5 or like this: $ openssl x509 -in $CERTFILE
+        #   -noout -fingerprint -sha256 SHA256 Fingerprint=14:6D:E9:83:C5:73:06:50:D8:EE:
+        #   B9:95:2F:34:FC:64: \ 16:A0:83:42:E6:1D:BE:A8:8A:04:96:B2:3F:CF:44:E5 In this
+        #   example, the contents of this field would be `14:6D:E9:83:C5:73: 06:50:D8:EE:
+        #   B9:95:2F:34:FC:64:16:A0:83:42:E6:1D:BE:A8:8A:04:96:B2:3F:CF: 44:E5`. If these
+        #   tools are not available to you, you can convert the PEM certificate into the
+        #   DER format, compute the SHA-256 hash of that string and represent the result
+        #   as a hexstring (that is, uppercase hexadecimal representations of each octet,
+        #   separated by colons).
         # @param [String] source_android_app_package_name
-        #   Android App assets are naturally identified by their Java package name.
-        #   For example, the Google Maps app uses the package name
-        #   `com.google.android.apps.maps`.
-        #   REQUIRED
+        #   Android App assets are naturally identified by their Java package name. For
+        #   example, the Google Maps app uses the package name `com.google.android.apps.
+        #   maps`. REQUIRED
         # @param [String] source_web_site
-        #   Web assets are identified by a URL that contains only the scheme, hostname
-        #   and port parts.  The format is
-        #   http[s]://<hostname>[:<port>]
-        #   Hostnames must be fully qualified: they must end in a single period
-        #   ("`.`").
-        #   Only the schemes "http" and "https" are currently allowed.
-        #   Port numbers are given as a decimal number, and they must be omitted if the
-        #   standard port numbers are used: 80 for http and 443 for https.
-        #   We call this limited URL the "site".  All URLs that share the same scheme,
-        #   hostname and port are considered to be a part of the site and thus belong
-        #   to the web asset.
-        #   Example: the asset with the site `https://www.google.com` contains all
-        #   these URLs:
-        #   *   `https://www.google.com/`
-        #   *   `https://www.google.com:443/`
-        #   *   `https://www.google.com/foo`
-        #   *   `https://www.google.com/foo?bar`
-        #   *   `https://www.google.com/foo#bar`
-        #   *   `https://user@password:www.google.com/`
-        #   But it does not contain these URLs:
-        #   *   `http://www.google.com/`       (wrong scheme)
-        #   *   `https://google.com/`          (hostname does not match)
-        #   *   `https://www.google.com:444/`  (port does not match)
-        #   REQUIRED
+        #   Web assets are identified by a URL that contains only the scheme, hostname and
+        #   port parts. The format is http[s]://[:] Hostnames must be fully qualified:
+        #   they must end in a single period ("`.`"). Only the schemes "http" and "https"
+        #   are currently allowed. Port numbers are given as a decimal number, and they
+        #   must be omitted if the standard port numbers are used: 80 for http and 443 for
+        #   https. We call this limited URL the "site". All URLs that share the same
+        #   scheme, hostname and port are considered to be a part of the site and thus
+        #   belong to the web asset. Example: the asset with the site `https://www.google.
+        #   com` contains all these URLs: * `https://www.google.com/` * `https://www.
+        #   google.com:443/` * `https://www.google.com/foo` * `https://www.google.com/foo?
+        #   bar` * `https://www.google.com/foo#bar` * `https://user@password:www.google.
+        #   com/` But it does not contain these URLs: * `http://www.google.com/` (wrong
+        #   scheme) * `https://google.com/` (hostname does not match) * `https://www.
+        #   google.com:444/` (port does not match) REQUIRED
         # @param [String] target_android_app_certificate_sha256_fingerprint
-        #   The uppercase SHA-265 fingerprint of the certificate.  From the PEM
-        #   certificate, it can be acquired like this:
-        #   $ keytool -printcert -file $CERTFILE | grep SHA256:
-        #   SHA256: 14:6D:E9:83:C5:73:06:50:D8:EE:B9:95:2F:34:FC:64:16:A0:83: \
-        #   42:E6:1D:BE:A8:8A:04:96:B2:3F:CF:44:E5
-        #   or like this:
-        #   $ openssl x509 -in $CERTFILE -noout -fingerprint -sha256
-        #   SHA256 Fingerprint=14:6D:E9:83:C5:73:06:50:D8:EE:B9:95:2F:34:FC:64: \
-        #   16:A0:83:42:E6:1D:BE:A8:8A:04:96:B2:3F:CF:44:E5
-        #   In this example, the contents of this field would be `14:6D:E9:83:C5:73:
-        #   06:50:D8:EE:B9:95:2F:34:FC:64:16:A0:83:42:E6:1D:BE:A8:8A:04:96:B2:3F:CF:
-        #   44:E5`.
-        #   If these tools are not available to you, you can convert the PEM
-        #   certificate into the DER format, compute the SHA-256 hash of that string
-        #   and represent the result as a hexstring (that is, uppercase hexadecimal
-        #   representations of each octet, separated by colons).
+        #   The uppercase SHA-265 fingerprint of the certificate. From the PEM certificate,
+        #   it can be acquired like this: $ keytool -printcert -file $CERTFILE | grep
+        #   SHA256: SHA256: 14:6D:E9:83:C5:73:06:50:D8:EE:B9:95:2F:34:FC:64:16:A0:83: \ 42:
+        #   E6:1D:BE:A8:8A:04:96:B2:3F:CF:44:E5 or like this: $ openssl x509 -in $CERTFILE
+        #   -noout -fingerprint -sha256 SHA256 Fingerprint=14:6D:E9:83:C5:73:06:50:D8:EE:
+        #   B9:95:2F:34:FC:64: \ 16:A0:83:42:E6:1D:BE:A8:8A:04:96:B2:3F:CF:44:E5 In this
+        #   example, the contents of this field would be `14:6D:E9:83:C5:73: 06:50:D8:EE:
+        #   B9:95:2F:34:FC:64:16:A0:83:42:E6:1D:BE:A8:8A:04:96:B2:3F:CF: 44:E5`. If these
+        #   tools are not available to you, you can convert the PEM certificate into the
+        #   DER format, compute the SHA-256 hash of that string and represent the result
+        #   as a hexstring (that is, uppercase hexadecimal representations of each octet,
+        #   separated by colons).
         # @param [String] target_android_app_package_name
-        #   Android App assets are naturally identified by their Java package name.
-        #   For example, the Google Maps app uses the package name
-        #   `com.google.android.apps.maps`.
-        #   REQUIRED
+        #   Android App assets are naturally identified by their Java package name. For
+        #   example, the Google Maps app uses the package name `com.google.android.apps.
+        #   maps`. REQUIRED
         # @param [String] target_web_site
-        #   Web assets are identified by a URL that contains only the scheme, hostname
-        #   and port parts.  The format is
-        #   http[s]://<hostname>[:<port>]
-        #   Hostnames must be fully qualified: they must end in a single period
-        #   ("`.`").
-        #   Only the schemes "http" and "https" are currently allowed.
-        #   Port numbers are given as a decimal number, and they must be omitted if the
-        #   standard port numbers are used: 80 for http and 443 for https.
-        #   We call this limited URL the "site".  All URLs that share the same scheme,
-        #   hostname and port are considered to be a part of the site and thus belong
-        #   to the web asset.
-        #   Example: the asset with the site `https://www.google.com` contains all
-        #   these URLs:
-        #   *   `https://www.google.com/`
-        #   *   `https://www.google.com:443/`
-        #   *   `https://www.google.com/foo`
-        #   *   `https://www.google.com/foo?bar`
-        #   *   `https://www.google.com/foo#bar`
-        #   *   `https://user@password:www.google.com/`
-        #   But it does not contain these URLs:
-        #   *   `http://www.google.com/`       (wrong scheme)
-        #   *   `https://google.com/`          (hostname does not match)
-        #   *   `https://www.google.com:444/`  (port does not match)
-        #   REQUIRED
+        #   Web assets are identified by a URL that contains only the scheme, hostname and
+        #   port parts. The format is http[s]://[:] Hostnames must be fully qualified:
+        #   they must end in a single period ("`.`"). Only the schemes "http" and "https"
+        #   are currently allowed. Port numbers are given as a decimal number, and they
+        #   must be omitted if the standard port numbers are used: 80 for http and 443 for
+        #   https. We call this limited URL the "site". All URLs that share the same
+        #   scheme, hostname and port are considered to be a part of the site and thus
+        #   belong to the web asset. Example: the asset with the site `https://www.google.
+        #   com` contains all these URLs: * `https://www.google.com/` * `https://www.
+        #   google.com:443/` * `https://www.google.com/foo` * `https://www.google.com/foo?
+        #   bar` * `https://www.google.com/foo#bar` * `https://user@password:www.google.
+        #   com/` But it does not contain these URLs: * `http://www.google.com/` (wrong
+        #   scheme) * `https://google.com/` (hostname does not match) * `https://www.
+        #   google.com:444/` (port does not match) REQUIRED
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -209,79 +173,58 @@ module Google
         end
         
         # Retrieves a list of all statements from a given source that match the
-        # specified target and statement string.
-        # The API guarantees that all statements with secure source assets, such as
-        # HTTPS websites or Android apps, have been made in a secure way by the owner
-        # of those assets, as described in the [Digital Asset Links technical design
-        # specification](https://github.com/google/digitalassetlinks/blob/master/well-
-        # known/details.md).
-        # Specifically, you should consider that for insecure websites (that is,
-        # where the URL starts with `http://` instead of `https://`), this guarantee
-        # cannot be made.
-        # The `List` command is most useful in cases where the API client wants to
-        # know all the ways in which two assets are related, or enumerate all the
-        # relationships from a particular source asset.  Example: a feature that
-        # helps users navigate to related items.  When a mobile app is running on a
-        # device, the feature would make it easy to navigate to the corresponding web
-        # site or Google+ profile.
+        # specified target and statement string. The API guarantees that all statements
+        # with secure source assets, such as HTTPS websites or Android apps, have been
+        # made in a secure way by the owner of those assets, as described in the [
+        # Digital Asset Links technical design specification](https://github.com/google/
+        # digitalassetlinks/blob/master/well-known/details.md). Specifically, you should
+        # consider that for insecure websites (that is, where the URL starts with `http:/
+        # /` instead of `https://`), this guarantee cannot be made. The `List` command
+        # is most useful in cases where the API client wants to know all the ways in
+        # which two assets are related, or enumerate all the relationships from a
+        # particular source asset. Example: a feature that helps users navigate to
+        # related items. When a mobile app is running on a device, the feature would
+        # make it easy to navigate to the corresponding web site or Google+ profile.
         # @param [String] relation
-        #   Use only associations that match the specified relation.
-        #   See the [`Statement`](#Statement) message for a detailed definition of
-        #   relation strings.
-        #   For a query to match a statement, one of the following must be true:
-        #   *    both the query's and the statement's relation strings match exactly,
-        #   or
-        #   *    the query's relation string is empty or missing.
-        #   Example: A query with relation `delegate_permission/common.handle_all_urls`
-        #   matches an asset link with relation
-        #   `delegate_permission/common.handle_all_urls`.
+        #   Use only associations that match the specified relation. See the [`Statement`](
+        #   #Statement) message for a detailed definition of relation strings. For a query
+        #   to match a statement, one of the following must be true: * both the query's
+        #   and the statement's relation strings match exactly, or * the query's relation
+        #   string is empty or missing. Example: A query with relation `
+        #   delegate_permission/common.handle_all_urls` matches an asset link with
+        #   relation `delegate_permission/common.handle_all_urls`.
         # @param [String] source_android_app_certificate_sha256_fingerprint
-        #   The uppercase SHA-265 fingerprint of the certificate.  From the PEM
-        #   certificate, it can be acquired like this:
-        #   $ keytool -printcert -file $CERTFILE | grep SHA256:
-        #   SHA256: 14:6D:E9:83:C5:73:06:50:D8:EE:B9:95:2F:34:FC:64:16:A0:83: \
-        #   42:E6:1D:BE:A8:8A:04:96:B2:3F:CF:44:E5
-        #   or like this:
-        #   $ openssl x509 -in $CERTFILE -noout -fingerprint -sha256
-        #   SHA256 Fingerprint=14:6D:E9:83:C5:73:06:50:D8:EE:B9:95:2F:34:FC:64: \
-        #   16:A0:83:42:E6:1D:BE:A8:8A:04:96:B2:3F:CF:44:E5
-        #   In this example, the contents of this field would be `14:6D:E9:83:C5:73:
-        #   06:50:D8:EE:B9:95:2F:34:FC:64:16:A0:83:42:E6:1D:BE:A8:8A:04:96:B2:3F:CF:
-        #   44:E5`.
-        #   If these tools are not available to you, you can convert the PEM
-        #   certificate into the DER format, compute the SHA-256 hash of that string
-        #   and represent the result as a hexstring (that is, uppercase hexadecimal
-        #   representations of each octet, separated by colons).
+        #   The uppercase SHA-265 fingerprint of the certificate. From the PEM certificate,
+        #   it can be acquired like this: $ keytool -printcert -file $CERTFILE | grep
+        #   SHA256: SHA256: 14:6D:E9:83:C5:73:06:50:D8:EE:B9:95:2F:34:FC:64:16:A0:83: \ 42:
+        #   E6:1D:BE:A8:8A:04:96:B2:3F:CF:44:E5 or like this: $ openssl x509 -in $CERTFILE
+        #   -noout -fingerprint -sha256 SHA256 Fingerprint=14:6D:E9:83:C5:73:06:50:D8:EE:
+        #   B9:95:2F:34:FC:64: \ 16:A0:83:42:E6:1D:BE:A8:8A:04:96:B2:3F:CF:44:E5 In this
+        #   example, the contents of this field would be `14:6D:E9:83:C5:73: 06:50:D8:EE:
+        #   B9:95:2F:34:FC:64:16:A0:83:42:E6:1D:BE:A8:8A:04:96:B2:3F:CF: 44:E5`. If these
+        #   tools are not available to you, you can convert the PEM certificate into the
+        #   DER format, compute the SHA-256 hash of that string and represent the result
+        #   as a hexstring (that is, uppercase hexadecimal representations of each octet,
+        #   separated by colons).
         # @param [String] source_android_app_package_name
-        #   Android App assets are naturally identified by their Java package name.
-        #   For example, the Google Maps app uses the package name
-        #   `com.google.android.apps.maps`.
-        #   REQUIRED
+        #   Android App assets are naturally identified by their Java package name. For
+        #   example, the Google Maps app uses the package name `com.google.android.apps.
+        #   maps`. REQUIRED
         # @param [String] source_web_site
-        #   Web assets are identified by a URL that contains only the scheme, hostname
-        #   and port parts.  The format is
-        #   http[s]://<hostname>[:<port>]
-        #   Hostnames must be fully qualified: they must end in a single period
-        #   ("`.`").
-        #   Only the schemes "http" and "https" are currently allowed.
-        #   Port numbers are given as a decimal number, and they must be omitted if the
-        #   standard port numbers are used: 80 for http and 443 for https.
-        #   We call this limited URL the "site".  All URLs that share the same scheme,
-        #   hostname and port are considered to be a part of the site and thus belong
-        #   to the web asset.
-        #   Example: the asset with the site `https://www.google.com` contains all
-        #   these URLs:
-        #   *   `https://www.google.com/`
-        #   *   `https://www.google.com:443/`
-        #   *   `https://www.google.com/foo`
-        #   *   `https://www.google.com/foo?bar`
-        #   *   `https://www.google.com/foo#bar`
-        #   *   `https://user@password:www.google.com/`
-        #   But it does not contain these URLs:
-        #   *   `http://www.google.com/`       (wrong scheme)
-        #   *   `https://google.com/`          (hostname does not match)
-        #   *   `https://www.google.com:444/`  (port does not match)
-        #   REQUIRED
+        #   Web assets are identified by a URL that contains only the scheme, hostname and
+        #   port parts. The format is http[s]://[:] Hostnames must be fully qualified:
+        #   they must end in a single period ("`.`"). Only the schemes "http" and "https"
+        #   are currently allowed. Port numbers are given as a decimal number, and they
+        #   must be omitted if the standard port numbers are used: 80 for http and 443 for
+        #   https. We call this limited URL the "site". All URLs that share the same
+        #   scheme, hostname and port are considered to be a part of the site and thus
+        #   belong to the web asset. Example: the asset with the site `https://www.google.
+        #   com` contains all these URLs: * `https://www.google.com/` * `https://www.
+        #   google.com:443/` * `https://www.google.com/foo` * `https://www.google.com/foo?
+        #   bar` * `https://www.google.com/foo#bar` * `https://user@password:www.google.
+        #   com/` But it does not contain these URLs: * `http://www.google.com/` (wrong
+        #   scheme) * `https://google.com/` (hostname does not match) * `https://www.
+        #   google.com:444/` (port does not match) REQUIRED
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user