docs: update generated docs (#981)
diff --git a/docs/dyn/digitalassetlinks_v1.statements.html b/docs/dyn/digitalassetlinks_v1.statements.html
index 7517f91..b6d6110 100644
--- a/docs/dyn/digitalassetlinks_v1.statements.html
+++ b/docs/dyn/digitalassetlinks_v1.statements.html
@@ -75,11 +75,11 @@
<h1><a href="digitalassetlinks_v1.html">Digital Asset Links API</a> . <a href="digitalassetlinks_v1.statements.html">statements</a></h1>
<h2>Instance Methods</h2>
<p class="toc_element">
- <code><a href="#list">list(source_web_site=None, source_androidApp_packageName=None, source_androidApp_certificate_sha256Fingerprint=None, SHA256=None, relation=None, x__xgafv=None)</a></code></p>
+ <code><a href="#list">list(relation=None, source_androidApp_packageName=None, source_web_site=None, source_androidApp_certificate_sha256Fingerprint=None, SHA256=None, x__xgafv=None)</a></code></p>
<p class="firstline">Retrieves a list of all statements from a given source that match the</p>
<h3>Method Details</h3>
<div class="method">
- <code class="details" id="list">list(source_web_site=None, source_androidApp_packageName=None, source_androidApp_certificate_sha256Fingerprint=None, SHA256=None, relation=None, x__xgafv=None)</code>
+ <code class="details" id="list">list(relation=None, source_androidApp_packageName=None, source_web_site=None, source_androidApp_certificate_sha256Fingerprint=None, SHA256=None, x__xgafv=None)</code>
<pre>Retrieves a list of all statements from a given source that match the
specified target and statement string.
@@ -99,6 +99,24 @@
site or Google+ profile.
Args:
+ relation: string, 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`.
+ source_androidApp_packageName: string, 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
source_web_site: string, Web assets are identified by a URL that contains only the scheme, hostname
and port parts. The format is
@@ -132,10 +150,6 @@
* `https://google.com/` (hostname does not match)
* `https://www.google.com:444/` (port does not match)
REQUIRED
- source_androidApp_packageName: string, 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
source_androidApp_certificate_sha256Fingerprint: string, The uppercase SHA-265 fingerprint of the certificate. From the PEM
certificate, it can be acquired like this:
@@ -157,20 +171,6 @@
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).
- relation: string, 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`.
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
@@ -183,6 +183,20 @@
"errorCode": [ # Error codes that describe the result of the List operation.
"A String",
],
+ "maxAge": "A String", # From serving time, how much longer the response should be considered valid
+ # barring further updates.
+ # REQUIRED
+ "debugString": "A String", # 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.
"statements": [ # A list of all the matching statements that have been found.
{ # Describes a reliable statement that has been made about the relationship
# between a source asset and a target asset.
@@ -199,41 +213,6 @@
# 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.
- "web": { # Describes a web asset. # Set if this is a web asset.
- "site": "A String", # 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
- },
"androidApp": { # Describes an android app asset. # Set if this is an Android App asset.
"packageName": "A String", # Android App assets are naturally identified by their Java package name.
# For example, the Google Maps app uses the package name
@@ -277,13 +256,6 @@
# representations of each octet, separated by colons).
},
},
- },
- "source": { # Uniquely identifies an asset. # Every statement has a source asset.
- # REQUIRED
- #
- # 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.
"web": { # Describes a web asset. # Set if this is a web asset.
"site": "A String", # Web assets are identified by a URL that contains only the scheme, hostname
# and port parts. The format is
@@ -319,49 +291,6 @@
# * `https://www.google.com:444/` (port does not match)
# REQUIRED
},
- "androidApp": { # Describes an android app asset. # Set if this is an Android App asset.
- "packageName": "A String", # 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
- "certificate": { # Describes an X509 certificate. # Because there is no global enforcement of package name uniqueness, we also
- # require a signing certificate, which in combination with the package name
- # uniquely identifies an app.
- #
- # Some apps' signing keys are rotated, so they may be signed by different
- # keys over time. We treat these as distinct assets, since we use (package
- # name, cert) as the unique ID. This should not normally pose any problems
- # as both versions of the app will make the same or similar statements.
- # Other assets making statements about the app will have to be updated when a
- # key is rotated, however.
- #
- # (Note that the syntaxes for publishing and querying for statements contain
- # syntactic sugar to easily let you specify apps that are known by multiple
- # certificates.)
- # REQUIRED
- "sha256Fingerprint": "A String", # 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).
- },
- },
},
"relation": "A String", # 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).
@@ -377,22 +306,93 @@
#
# Example: `delegate_permission/common.handle_all_urls`
# REQUIRED
+ "source": { # Uniquely identifies an asset. # Every statement has a source asset.
+ # REQUIRED
+ #
+ # 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.
+ "androidApp": { # Describes an android app asset. # Set if this is an Android App asset.
+ "packageName": "A String", # 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
+ "certificate": { # Describes an X509 certificate. # Because there is no global enforcement of package name uniqueness, we also
+ # require a signing certificate, which in combination with the package name
+ # uniquely identifies an app.
+ #
+ # Some apps' signing keys are rotated, so they may be signed by different
+ # keys over time. We treat these as distinct assets, since we use (package
+ # name, cert) as the unique ID. This should not normally pose any problems
+ # as both versions of the app will make the same or similar statements.
+ # Other assets making statements about the app will have to be updated when a
+ # key is rotated, however.
+ #
+ # (Note that the syntaxes for publishing and querying for statements contain
+ # syntactic sugar to easily let you specify apps that are known by multiple
+ # certificates.)
+ # REQUIRED
+ "sha256Fingerprint": "A String", # 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).
+ },
+ },
+ "web": { # Describes a web asset. # Set if this is a web asset.
+ "site": "A String", # 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
+ },
+ },
},
],
- "debugString": "A String", # 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.
- "maxAge": "A String", # From serving time, how much longer the response should be considered valid
- # barring further updates.
- # REQUIRED
}</pre>
</div>