docs: update generated docs (#1053)

Updates for both discovery docs and epydoc API Documentation

Fixes: #1049
diff --git a/docs/dyn/bigqueryreservation_v1.projects.locations.reservations.html b/docs/dyn/bigqueryreservation_v1.projects.locations.reservations.html
index e58dfc0..a2b3dab 100644
--- a/docs/dyn/bigqueryreservation_v1.projects.locations.reservations.html
+++ b/docs/dyn/bigqueryreservation_v1.projects.locations.reservations.html
@@ -80,16 +80,19 @@
 <p class="firstline">Returns the assignments Resource.</p>
 
 <p class="toc_element">
+  <code><a href="#close">close()</a></code></p>
+<p class="firstline">Close httplib2 connections.</p>
+<p class="toc_element">
   <code><a href="#create">create(parent, body=None, reservationId=None, x__xgafv=None)</a></code></p>
 <p class="firstline">Creates a new reservation resource.</p>
 <p class="toc_element">
   <code><a href="#delete">delete(name, x__xgafv=None)</a></code></p>
-<p class="firstline">Deletes a reservation.</p>
+<p class="firstline">Deletes a reservation. Returns `google.rpc.Code.FAILED_PRECONDITION` when reservation has assignments.</p>
 <p class="toc_element">
   <code><a href="#get">get(name, x__xgafv=None)</a></code></p>
 <p class="firstline">Returns information about the reservation.</p>
 <p class="toc_element">
-  <code><a href="#list">list(parent, pageSize=None, pageToken=None, x__xgafv=None)</a></code></p>
+  <code><a href="#list">list(parent, pageToken=None, pageSize=None, x__xgafv=None)</a></code></p>
 <p class="firstline">Lists all the reservations for the project in the specified location.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
@@ -99,35 +102,28 @@
 <p class="firstline">Updates an existing reservation resource.</p>
 <h3>Method Details</h3>
 <div class="method">
+    <code class="details" id="close">close()</code>
+  <pre>Close httplib2 connections.</pre>
+</div>
+
+<div class="method">
     <code class="details" id="create">create(parent, body=None, reservationId=None, x__xgafv=None)</code>
   <pre>Creates a new reservation resource.
 
 Args:
-  parent: string, Required. Project, location. E.g.,
-`projects/myproject/locations/US` (required)
+  parent: string, Required. Project, location. E.g., `projects/myproject/locations/US` (required)
   body: object, The request body.
     The object takes the form of:
 
 { # A reservation is a mechanism used to guarantee slots to users.
-  &quot;name&quot;: &quot;A String&quot;, # The resource name of the reservation, e.g.,
-      # `projects/*/locations/*/reservations/team1-prod`.
-  &quot;slotCapacity&quot;: &quot;A String&quot;, # Minimum slots available to this reservation. A slot is a unit of
-      # computational power in BigQuery, and serves as the unit of parallelism.
-      # 
-      # Queries using this reservation might use more slots during runtime if
-      # ignore_idle_slots is set to false.
-      # 
-      # If the new reservation&#x27;s slot capacity exceed the parent&#x27;s slot capacity or
-      # if total slot capacity of the new reservation and its siblings exceeds the
-      # parent&#x27;s slot capacity, the request will fail with
-      # `google.rpc.Code.RESOURCE_EXHAUSTED`.
-  &quot;ignoreIdleSlots&quot;: True or False, # If false, any query using this reservation will use idle slots from other
-      # reservations within the same admin project. If true, a query using this
-      # reservation will execute with the slot capacity specified above at most.
-}
+    &quot;slotCapacity&quot;: &quot;A String&quot;, # Minimum slots available to this reservation. A slot is a unit of computational power in BigQuery, and serves as the unit of parallelism. Queries using this reservation might use more slots during runtime if ignore_idle_slots is set to false. If the new reservation&#x27;s slot capacity exceed the parent&#x27;s slot capacity or if total slot capacity of the new reservation and its siblings exceeds the parent&#x27;s slot capacity, the request will fail with `google.rpc.Code.RESOURCE_EXHAUSTED`.
+    &quot;ignoreIdleSlots&quot;: True or False, # If false, any query using this reservation will use idle slots from other reservations within the same admin project. If true, a query using this reservation will execute with the slot capacity specified above at most.
+    &quot;updateTime&quot;: &quot;A String&quot;, # Output only. Last update time of the reservation.
+    &quot;name&quot;: &quot;A String&quot;, # The resource name of the reservation, e.g., `projects/*/locations/*/reservations/team1-prod`.
+    &quot;creationTime&quot;: &quot;A String&quot;, # Output only. Creation time of the reservation.
+  }
 
-  reservationId: string, The reservation ID. This field must only contain lower case alphanumeric
-characters or dash. Max length is 64 characters.
+  reservationId: string, The reservation ID. This field must only contain lower case alphanumeric characters or dash. Max length is 64 characters.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -137,33 +133,20 @@
   An object of the form:
 
     { # A reservation is a mechanism used to guarantee slots to users.
-    &quot;name&quot;: &quot;A String&quot;, # The resource name of the reservation, e.g.,
-        # `projects/*/locations/*/reservations/team1-prod`.
-    &quot;slotCapacity&quot;: &quot;A String&quot;, # Minimum slots available to this reservation. A slot is a unit of
-        # computational power in BigQuery, and serves as the unit of parallelism.
-        #
-        # Queries using this reservation might use more slots during runtime if
-        # ignore_idle_slots is set to false.
-        #
-        # If the new reservation&#x27;s slot capacity exceed the parent&#x27;s slot capacity or
-        # if total slot capacity of the new reservation and its siblings exceeds the
-        # parent&#x27;s slot capacity, the request will fail with
-        # `google.rpc.Code.RESOURCE_EXHAUSTED`.
-    &quot;ignoreIdleSlots&quot;: True or False, # If false, any query using this reservation will use idle slots from other
-        # reservations within the same admin project. If true, a query using this
-        # reservation will execute with the slot capacity specified above at most.
-  }</pre>
+      &quot;slotCapacity&quot;: &quot;A String&quot;, # Minimum slots available to this reservation. A slot is a unit of computational power in BigQuery, and serves as the unit of parallelism. Queries using this reservation might use more slots during runtime if ignore_idle_slots is set to false. If the new reservation&#x27;s slot capacity exceed the parent&#x27;s slot capacity or if total slot capacity of the new reservation and its siblings exceeds the parent&#x27;s slot capacity, the request will fail with `google.rpc.Code.RESOURCE_EXHAUSTED`.
+      &quot;ignoreIdleSlots&quot;: True or False, # If false, any query using this reservation will use idle slots from other reservations within the same admin project. If true, a query using this reservation will execute with the slot capacity specified above at most.
+      &quot;updateTime&quot;: &quot;A String&quot;, # Output only. Last update time of the reservation.
+      &quot;name&quot;: &quot;A String&quot;, # The resource name of the reservation, e.g., `projects/*/locations/*/reservations/team1-prod`.
+      &quot;creationTime&quot;: &quot;A String&quot;, # Output only. Creation time of the reservation.
+    }</pre>
 </div>
 
 <div class="method">
     <code class="details" id="delete">delete(name, x__xgafv=None)</code>
-  <pre>Deletes a reservation.
-Returns `google.rpc.Code.FAILED_PRECONDITION` when reservation has
-assignments.
+  <pre>Deletes a reservation. Returns `google.rpc.Code.FAILED_PRECONDITION` when reservation has assignments.
 
 Args:
-  name: string, Required. Resource name of the reservation to retrieve. E.g.,
-   `projects/myproject/locations/US/reservations/team1-prod` (required)
+  name: string, Required. Resource name of the reservation to retrieve. E.g., `projects/myproject/locations/US/reservations/team1-prod` (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -172,15 +155,7 @@
 Returns:
   An object of the form:
 
-    { # A generic empty message that you can re-use to avoid defining duplicated
-      # empty messages in your APIs. A typical example is to use it as the request
-      # or the response type of an API method. For instance:
-      #
-      #     service Foo {
-      #       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
-      #     }
-      #
-      # The JSON representation for `Empty` is empty JSON object `{}`.
+    { # A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); } The JSON representation for `Empty` is empty JSON object `{}`.
   }</pre>
 </div>
 
@@ -189,8 +164,7 @@
   <pre>Returns information about the reservation.
 
 Args:
-  name: string, Required. Resource name of the reservation to retrieve. E.g.,
-   `projects/myproject/locations/US/reservations/team1-prod` (required)
+  name: string, Required. Resource name of the reservation to retrieve. E.g., `projects/myproject/locations/US/reservations/team1-prod` (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -200,33 +174,22 @@
   An object of the form:
 
     { # A reservation is a mechanism used to guarantee slots to users.
-    &quot;name&quot;: &quot;A String&quot;, # The resource name of the reservation, e.g.,
-        # `projects/*/locations/*/reservations/team1-prod`.
-    &quot;slotCapacity&quot;: &quot;A String&quot;, # Minimum slots available to this reservation. A slot is a unit of
-        # computational power in BigQuery, and serves as the unit of parallelism.
-        #
-        # Queries using this reservation might use more slots during runtime if
-        # ignore_idle_slots is set to false.
-        #
-        # If the new reservation&#x27;s slot capacity exceed the parent&#x27;s slot capacity or
-        # if total slot capacity of the new reservation and its siblings exceeds the
-        # parent&#x27;s slot capacity, the request will fail with
-        # `google.rpc.Code.RESOURCE_EXHAUSTED`.
-    &quot;ignoreIdleSlots&quot;: True or False, # If false, any query using this reservation will use idle slots from other
-        # reservations within the same admin project. If true, a query using this
-        # reservation will execute with the slot capacity specified above at most.
-  }</pre>
+      &quot;slotCapacity&quot;: &quot;A String&quot;, # Minimum slots available to this reservation. A slot is a unit of computational power in BigQuery, and serves as the unit of parallelism. Queries using this reservation might use more slots during runtime if ignore_idle_slots is set to false. If the new reservation&#x27;s slot capacity exceed the parent&#x27;s slot capacity or if total slot capacity of the new reservation and its siblings exceeds the parent&#x27;s slot capacity, the request will fail with `google.rpc.Code.RESOURCE_EXHAUSTED`.
+      &quot;ignoreIdleSlots&quot;: True or False, # If false, any query using this reservation will use idle slots from other reservations within the same admin project. If true, a query using this reservation will execute with the slot capacity specified above at most.
+      &quot;updateTime&quot;: &quot;A String&quot;, # Output only. Last update time of the reservation.
+      &quot;name&quot;: &quot;A String&quot;, # The resource name of the reservation, e.g., `projects/*/locations/*/reservations/team1-prod`.
+      &quot;creationTime&quot;: &quot;A String&quot;, # Output only. Creation time of the reservation.
+    }</pre>
 </div>
 
 <div class="method">
-    <code class="details" id="list">list(parent, pageSize=None, pageToken=None, x__xgafv=None)</code>
+    <code class="details" id="list">list(parent, pageToken=None, pageSize=None, x__xgafv=None)</code>
   <pre>Lists all the reservations for the project in the specified location.
 
 Args:
-  parent: string, Required. The parent resource name containing project and location, e.g.:
-  `projects/myproject/locations/US` (required)
-  pageSize: integer, The maximum number of items to return per page.
+  parent: string, Required. The parent resource name containing project and location, e.g.: `projects/myproject/locations/US` (required)
   pageToken: string, The next_page_token value returned from a previous List request, if any.
+  pageSize: integer, The maximum number of items to return per page.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -238,25 +201,14 @@
     { # The response for ReservationService.ListReservations.
     &quot;reservations&quot;: [ # List of reservations visible to the user.
       { # A reservation is a mechanism used to guarantee slots to users.
-        &quot;name&quot;: &quot;A String&quot;, # The resource name of the reservation, e.g.,
-            # `projects/*/locations/*/reservations/team1-prod`.
-        &quot;slotCapacity&quot;: &quot;A String&quot;, # Minimum slots available to this reservation. A slot is a unit of
-            # computational power in BigQuery, and serves as the unit of parallelism.
-            #
-            # Queries using this reservation might use more slots during runtime if
-            # ignore_idle_slots is set to false.
-            #
-            # If the new reservation&#x27;s slot capacity exceed the parent&#x27;s slot capacity or
-            # if total slot capacity of the new reservation and its siblings exceeds the
-            # parent&#x27;s slot capacity, the request will fail with
-            # `google.rpc.Code.RESOURCE_EXHAUSTED`.
-        &quot;ignoreIdleSlots&quot;: True or False, # If false, any query using this reservation will use idle slots from other
-            # reservations within the same admin project. If true, a query using this
-            # reservation will execute with the slot capacity specified above at most.
-      },
+          &quot;slotCapacity&quot;: &quot;A String&quot;, # Minimum slots available to this reservation. A slot is a unit of computational power in BigQuery, and serves as the unit of parallelism. Queries using this reservation might use more slots during runtime if ignore_idle_slots is set to false. If the new reservation&#x27;s slot capacity exceed the parent&#x27;s slot capacity or if total slot capacity of the new reservation and its siblings exceeds the parent&#x27;s slot capacity, the request will fail with `google.rpc.Code.RESOURCE_EXHAUSTED`.
+          &quot;ignoreIdleSlots&quot;: True or False, # If false, any query using this reservation will use idle slots from other reservations within the same admin project. If true, a query using this reservation will execute with the slot capacity specified above at most.
+          &quot;updateTime&quot;: &quot;A String&quot;, # Output only. Last update time of the reservation.
+          &quot;name&quot;: &quot;A String&quot;, # The resource name of the reservation, e.g., `projects/*/locations/*/reservations/team1-prod`.
+          &quot;creationTime&quot;: &quot;A String&quot;, # Output only. Creation time of the reservation.
+        },
     ],
-    &quot;nextPageToken&quot;: &quot;A String&quot;, # Token to retrieve the next page of results, or empty if there are no
-        # more results in the list.
+    &quot;nextPageToken&quot;: &quot;A String&quot;, # Token to retrieve the next page of results, or empty if there are no more results in the list.
   }</pre>
 </div>
 
@@ -279,28 +231,17 @@
   <pre>Updates an existing reservation resource.
 
 Args:
-  name: string, The resource name of the reservation, e.g.,
-`projects/*/locations/*/reservations/team1-prod`. (required)
+  name: string, The resource name of the reservation, e.g., `projects/*/locations/*/reservations/team1-prod`. (required)
   body: object, The request body.
     The object takes the form of:
 
 { # A reservation is a mechanism used to guarantee slots to users.
-  &quot;name&quot;: &quot;A String&quot;, # The resource name of the reservation, e.g.,
-      # `projects/*/locations/*/reservations/team1-prod`.
-  &quot;slotCapacity&quot;: &quot;A String&quot;, # Minimum slots available to this reservation. A slot is a unit of
-      # computational power in BigQuery, and serves as the unit of parallelism.
-      # 
-      # Queries using this reservation might use more slots during runtime if
-      # ignore_idle_slots is set to false.
-      # 
-      # If the new reservation&#x27;s slot capacity exceed the parent&#x27;s slot capacity or
-      # if total slot capacity of the new reservation and its siblings exceeds the
-      # parent&#x27;s slot capacity, the request will fail with
-      # `google.rpc.Code.RESOURCE_EXHAUSTED`.
-  &quot;ignoreIdleSlots&quot;: True or False, # If false, any query using this reservation will use idle slots from other
-      # reservations within the same admin project. If true, a query using this
-      # reservation will execute with the slot capacity specified above at most.
-}
+    &quot;slotCapacity&quot;: &quot;A String&quot;, # Minimum slots available to this reservation. A slot is a unit of computational power in BigQuery, and serves as the unit of parallelism. Queries using this reservation might use more slots during runtime if ignore_idle_slots is set to false. If the new reservation&#x27;s slot capacity exceed the parent&#x27;s slot capacity or if total slot capacity of the new reservation and its siblings exceeds the parent&#x27;s slot capacity, the request will fail with `google.rpc.Code.RESOURCE_EXHAUSTED`.
+    &quot;ignoreIdleSlots&quot;: True or False, # If false, any query using this reservation will use idle slots from other reservations within the same admin project. If true, a query using this reservation will execute with the slot capacity specified above at most.
+    &quot;updateTime&quot;: &quot;A String&quot;, # Output only. Last update time of the reservation.
+    &quot;name&quot;: &quot;A String&quot;, # The resource name of the reservation, e.g., `projects/*/locations/*/reservations/team1-prod`.
+    &quot;creationTime&quot;: &quot;A String&quot;, # Output only. Creation time of the reservation.
+  }
 
   updateMask: string, Standard field mask for the set of fields to be updated.
   x__xgafv: string, V1 error format.
@@ -312,22 +253,12 @@
   An object of the form:
 
     { # A reservation is a mechanism used to guarantee slots to users.
-    &quot;name&quot;: &quot;A String&quot;, # The resource name of the reservation, e.g.,
-        # `projects/*/locations/*/reservations/team1-prod`.
-    &quot;slotCapacity&quot;: &quot;A String&quot;, # Minimum slots available to this reservation. A slot is a unit of
-        # computational power in BigQuery, and serves as the unit of parallelism.
-        #
-        # Queries using this reservation might use more slots during runtime if
-        # ignore_idle_slots is set to false.
-        #
-        # If the new reservation&#x27;s slot capacity exceed the parent&#x27;s slot capacity or
-        # if total slot capacity of the new reservation and its siblings exceeds the
-        # parent&#x27;s slot capacity, the request will fail with
-        # `google.rpc.Code.RESOURCE_EXHAUSTED`.
-    &quot;ignoreIdleSlots&quot;: True or False, # If false, any query using this reservation will use idle slots from other
-        # reservations within the same admin project. If true, a query using this
-        # reservation will execute with the slot capacity specified above at most.
-  }</pre>
+      &quot;slotCapacity&quot;: &quot;A String&quot;, # Minimum slots available to this reservation. A slot is a unit of computational power in BigQuery, and serves as the unit of parallelism. Queries using this reservation might use more slots during runtime if ignore_idle_slots is set to false. If the new reservation&#x27;s slot capacity exceed the parent&#x27;s slot capacity or if total slot capacity of the new reservation and its siblings exceeds the parent&#x27;s slot capacity, the request will fail with `google.rpc.Code.RESOURCE_EXHAUSTED`.
+      &quot;ignoreIdleSlots&quot;: True or False, # If false, any query using this reservation will use idle slots from other reservations within the same admin project. If true, a query using this reservation will execute with the slot capacity specified above at most.
+      &quot;updateTime&quot;: &quot;A String&quot;, # Output only. Last update time of the reservation.
+      &quot;name&quot;: &quot;A String&quot;, # The resource name of the reservation, e.g., `projects/*/locations/*/reservations/team1-prod`.
+      &quot;creationTime&quot;: &quot;A String&quot;, # Output only. Creation time of the reservation.
+    }</pre>
 </div>
 
 </body></html>
\ No newline at end of file