docs: update generated docs (#981)

describe.py

@@ -379,12 +379,13 @@ def document_collection_recursive(resource, path, root_discovery, discovery):
             )
 
 
-def document_api(name, version):
+def document_api(name, version, uri):
     """Document the given API.
 
   Args:
     name: string, Name of the API.
     version: string, Version of the API.
+    uri: string, URI of the API's discovery document
   """
     try:
         service = build(name, version)
@@ -397,7 +398,7 @@ def document_api(name, version):
 
     http = build_http()
     response, content = http.request(
-        uritemplate.expand(
+        uri or uritemplate.expand(
             FLAGS.discovery_uri_template, {"api": name, "apiVersion": version}
         )
     )
@@ -443,7 +444,7 @@ def document_api_from_discovery_document(uri):
         if resp.status == 200:
             directory = json.loads(content)["items"]
             for api in directory:
-                document_api(api["name"], api["version"])
+                document_api(api["name"], api["version"], api["discoveryRestUrl"])
                 api_directory[api["name"]].append(api["version"])
 
             # sort by api name and version number

docs/dyn/abusiveexperiencereport_v1.sites.html

@@ -96,9 +96,6 @@ <h3>Method Details</h3>
   An object of the form:
 
     { # Response message for GetSiteSummary.
-    &quot;filterStatus&quot;: &quot;A String&quot;, # The site&#x27;s [enforcement
-        # status](https://support.google.com/webtools/answer/7538608).
-    &quot;underReview&quot;: True or False, # Whether the site is currently under review.
     &quot;reportUrl&quot;: &quot;A String&quot;, # A link to the full Abusive Experience Report for the site.
         #
         # Not set in
@@ -108,15 +105,18 @@ <h3>Method Details</h3>
         # process](https://support.google.com/webmasters/answer/9008080) for the site
         # before you can access the full report.
     &quot;lastChangeTime&quot;: &quot;A String&quot;, # The time at which the site&#x27;s status last changed.
-    &quot;reviewedSite&quot;: &quot;A String&quot;, # The name of the reviewed site, e.g. `google.com`.
-    &quot;abusiveStatus&quot;: &quot;A String&quot;, # The site&#x27;s Abusive Experience Report status.
+    &quot;filterStatus&quot;: &quot;A String&quot;, # The site&#x27;s [enforcement
+        # status](https://support.google.com/webtools/answer/7538608).
     &quot;enforcementTime&quot;: &quot;A String&quot;, # The time at which
         # [enforcement](https://support.google.com/webtools/answer/7538608) against
         # the site began or will begin.
         #
         # Not set when the
         # filter_status
         # is OFF.
+    &quot;underReview&quot;: True or False, # Whether the site is currently under review.
+    &quot;reviewedSite&quot;: &quot;A String&quot;, # The name of the reviewed site, e.g. `google.com`.
+    &quot;abusiveStatus&quot;: &quot;A String&quot;, # The site&#x27;s Abusive Experience Report status.
   }</pre>
 </div>
 

docs/dyn/abusiveexperiencereport_v1.violatingSites.html

@@ -94,9 +94,6 @@ <h3>Method Details</h3>
     { # Response message for ListViolatingSites.
     &quot;violatingSites&quot;: [ # The list of violating sites.
       { # Response message for GetSiteSummary.
-        &quot;filterStatus&quot;: &quot;A String&quot;, # The site&#x27;s [enforcement
-            # status](https://support.google.com/webtools/answer/7538608).
-        &quot;underReview&quot;: True or False, # Whether the site is currently under review.
         &quot;reportUrl&quot;: &quot;A String&quot;, # A link to the full Abusive Experience Report for the site.
             #
             # Not set in
@@ -106,15 +103,18 @@ <h3>Method Details</h3>
             # process](https://support.google.com/webmasters/answer/9008080) for the site
             # before you can access the full report.
         &quot;lastChangeTime&quot;: &quot;A String&quot;, # The time at which the site&#x27;s status last changed.
-        &quot;reviewedSite&quot;: &quot;A String&quot;, # The name of the reviewed site, e.g. `google.com`.
-        &quot;abusiveStatus&quot;: &quot;A String&quot;, # The site&#x27;s Abusive Experience Report status.
+        &quot;filterStatus&quot;: &quot;A String&quot;, # The site&#x27;s [enforcement
+            # status](https://support.google.com/webtools/answer/7538608).
         &quot;enforcementTime&quot;: &quot;A String&quot;, # The time at which
             # [enforcement](https://support.google.com/webtools/answer/7538608) against
             # the site began or will begin.
             #
             # Not set when the
             # filter_status
             # is OFF.
+        &quot;underReview&quot;: True or False, # Whether the site is currently under review.
+        &quot;reviewedSite&quot;: &quot;A String&quot;, # The name of the reviewed site, e.g. `google.com`.
+        &quot;abusiveStatus&quot;: &quot;A String&quot;, # The site&#x27;s Abusive Experience Report status.
       },
     ],
   }</pre>

docs/dyn/acceleratedmobilepageurl_v1.ampUrls.html

@@ -88,12 +88,12 @@ <h3>Method Details</h3>
     The object takes the form of:
 
 { # AMP URL request for a batch of URLs.
+    &quot;lookupStrategy&quot;: &quot;A String&quot;, # The lookup_strategy being requested.
     &quot;urls&quot;: [ # List of URLs to look up for the paired AMP URLs.
         # The URLs are case-sensitive. Up to 50 URLs per lookup
         # (see [Usage Limits](/amp/cache/reference/limits)).
       &quot;A String&quot;,
     ],
-    &quot;lookupStrategy&quot;: &quot;A String&quot;, # The lookup_strategy being requested.
   }
 
   x__xgafv: string, V1 error format.
@@ -112,15 +112,15 @@ <h3>Method Details</h3>
       { # AMP URL response for a requested URL.
         &quot;cdnAmpUrl&quot;: &quot;A String&quot;, # The [AMP Cache URL](/amp/cache/overview#amp-cache-url-format) pointing to
             # the cached document in the Google AMP Cache.
-        &quot;originalUrl&quot;: &quot;A String&quot;, # The original non-AMP URL.
         &quot;ampUrl&quot;: &quot;A String&quot;, # The AMP URL pointing to the publisher&#x27;s web server.
+        &quot;originalUrl&quot;: &quot;A String&quot;, # The original non-AMP URL.
       },
     ],
     &quot;urlErrors&quot;: [ # The errors for requested URLs that have no AMP URL.
       { # AMP URL Error resource for a requested URL that couldn&#x27;t be found.
+        &quot;originalUrl&quot;: &quot;A String&quot;, # The original non-AMP URL.
         &quot;errorMessage&quot;: &quot;A String&quot;, # An optional descriptive error message.
         &quot;errorCode&quot;: &quot;A String&quot;, # The error code of an API call.
-        &quot;originalUrl&quot;: &quot;A String&quot;, # The original non-AMP URL.
       },
     ],
   }</pre>