feat(gen): run the generator (#1814)

BREAKING CHANGES: This release has multiple breaking changes.  The following APIs have been removed:
- appstate/v1
- compute/alpha
- run/v1beta1

In addition, the default rootUrl for the compute API has been switched from `www.googleapis.com` to `compute.googleapis.com`.  

The following APIs have been added:
- bigqueryreservation/v1
- bigqueryreservation/v1alpha2
- domainsrdap/v1
- homegraph/v1
- speech/v2beta
- translate/v3beta1
- verifiedaccess/v1

Author: JustinBeckwith

src/apis/abusiveexperiencereport/v1.ts

@@ -124,27 +124,27 @@ export namespace abusiveexperiencereport_v1 {
    */
   export interface Schema$SiteSummaryResponse {
     /**
-     * The status of the site reviewed for the abusive experiences.
+     * The site's Abusive Experience Report status.
      */
     abusiveStatus?: string;
     /**
-     * The date on which enforcement begins.
+     * 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.
      */
     enforcementTime?: string;
     /**
-     * The abusive experience enforcement status of the site.
+     * The site's [enforcement status](https://support.google.com/webtools/answer/7538608).
      */
     filterStatus?: string;
     /**
-     * The last time that the site changed status.
+     * The time at which the site's status last changed.
      */
     lastChangeTime?: string;
     /**
-     * A link that leads to a full abusive experience report.
+     * A link to the full Abusive Experience Report for the site.  Not set in ViolatingSitesResponse.  Note that you must complete the [Search Console verification process](https://support.google.com/webmasters/answer/9008080) for the site before you can access the full report.
      */
     reportUrl?: string;
     /**
-     * The name of the site reviewed.
+     * The name of the reviewed site, e.g. `google.com`.
      */
     reviewedSite?: string;
     /**
@@ -157,7 +157,7 @@ export namespace abusiveexperiencereport_v1 {
    */
   export interface Schema$ViolatingSitesResponse {
     /**
-     * A list of summaries of violating sites.
+     * The list of violating sites.
      */
     violatingSites?: Schema$SiteSummaryResponse[];
   }
@@ -170,12 +170,12 @@ export namespace abusiveexperiencereport_v1 {
 
     /**
      * abusiveexperiencereport.sites.get
-     * @desc Gets a summary of the abusive experience rating of a site.
+     * @desc Gets a site's Abusive Experience Report summary.
      * @alias abusiveexperiencereport.sites.get
      * @memberOf! ()
      *
      * @param {object} params Parameters for request
-     * @param {string} params.name The required site name. This is the site property whose abusive experiences have been reviewed, and it must be URL-encoded. For example, sites/https%3A%2F%2Fwww.google.com. The server will return an error of BAD_REQUEST if this field is not filled in. Note that if the site property is not yet verified in Search Console, the reportUrl field returned by the API will lead to the verification page, prompting the user to go through that process before they can gain access to the Abusive Experience Report.
+     * @param {string} params.name Required. The name of the site whose summary to get, e.g. `sites/http%3A%2F%2Fwww.google.com%2F`.  Format: `sites/{site}`
      * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`.
      * @param {callback} callback The callback that handles the response.
      * @return {object} Request object
@@ -247,7 +247,7 @@ export namespace abusiveexperiencereport_v1 {
     auth?: string | OAuth2Client | JWT | Compute | UserRefreshClient;
 
     /**
-     * The required site name. This is the site property whose abusive experiences have been reviewed, and it must be URL-encoded. For example, sites/https%3A%2F%2Fwww.google.com. The server will return an error of BAD_REQUEST if this field is not filled in. Note that if the site property is not yet verified in Search Console, the reportUrl field returned by the API will lead to the verification page, prompting the user to go through that process before they can gain access to the Abusive Experience Report.
+     * Required. The name of the site whose summary to get, e.g. `sites/http%3A%2F%2Fwww.google.com%2F`.  Format: `sites/{site}`
      */
     name?: string;
   }
@@ -260,7 +260,7 @@ export namespace abusiveexperiencereport_v1 {
 
     /**
      * abusiveexperiencereport.violatingSites.list
-     * @desc Lists sites with Abusive Experience Report statuses of "Failing".
+     * @desc Lists sites that are failing in the Abusive Experience Report.
      * @alias abusiveexperiencereport.violatingSites.list
      * @memberOf! ()
      *

src/apis/accessapproval/v1beta1.ts

@@ -125,6 +125,10 @@ export namespace accessapproval_v1beta1 {
    * Settings on a Project/Folder/Organization related to Access Approval.
    */
   export interface Schema$AccessApprovalSettings {
+    /**
+     * A list of Google Cloud Services for which the given resource has Access Approval enrolled. Access requests for the resource given by name against any of these services contained here will be required to have explicit approval. If name refers to an organization, enrollment can be done for individual services. If name refers to a folder or project, enrollment can only be done on an all or nothing basis.  If a cloud_product is repeated in this list, the first entry will be honored and all following entries will be discarded.
+     */
+    enrolledServices?: Schema$EnrolledService[];
     /**
      * The resource name of the settings. Format is one of: <ol>   <li>"projects/{project_id}/accessApprovalSettings"</li>   <li>"folders/{folder_id}/accessApprovalSettings"</li>   <li>"organizations/{organization_id}/accessApprovalSettings"</li> <ol>
      */
@@ -233,6 +237,19 @@ export namespace accessapproval_v1beta1 {
      */
     dismissTime?: string;
   }
+  /**
+   * Represents the enrollment of a cloud resource into a specific service.
+   */
+  export interface Schema$EnrolledService {
+    /**
+     * The product for which Access Approval will be enrolled. Allowed values are listed below (case-sensitive): <ol>   <li>all</li>   <li>appengine.googleapis.com</li>   <li>bigquery.googleapis.com</li>   <li>bigtable.googleapis.com</li>   <li>cloudkms.googleapis.com</li>   <li>compute.googleapis.com</li>   <li>dataflow.googleapis.com</li>   <li>iam.googleapis.com</li>   <li>pubsub.googleapis.com</li>   <li>storage.googleapis.com</li> <ol>
+     */
+    cloudProduct?: string;
+    /**
+     * The enrollment level of the service.
+     */
+    enrollmentLevel?: string;
+  }
   /**
    * Response to listing of ApprovalRequest objects.
    */
@@ -344,12 +361,13 @@ export namespace accessapproval_v1beta1 {
 
     /**
      * accessapproval.folders.updateAccessApprovalSettings
-     * @desc Updates the settings associated with a project, folder, or organization. Completely replaces the existing settings.
+     * @desc Updates the settings associated with a project, folder, or organization. Settings to update are determined by the value of field_mask.
      * @alias accessapproval.folders.updateAccessApprovalSettings
      * @memberOf! ()
      *
      * @param {object} params Parameters for request
      * @param {string} params.name The resource name of the settings. Format is one of: <ol>   <li>"projects/{project_id}/accessApprovalSettings"</li>   <li>"folders/{folder_id}/accessApprovalSettings"</li>   <li>"organizations/{organization_id}/accessApprovalSettings"</li> <ol>
+     * @param {string=} params.updateMask The update mask applies to the settings. For the `FieldMask` definition, see https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask If this field is left unset, only the notification_emails field will be updated.
      * @param {().AccessApprovalSettings} params.resource Request body data
      * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`.
      * @param {callback} callback The callback that handles the response.
@@ -443,6 +461,10 @@ export namespace accessapproval_v1beta1 {
      * The resource name of the settings. Format is one of: <ol>   <li>"projects/{project_id}/accessApprovalSettings"</li>   <li>"folders/{folder_id}/accessApprovalSettings"</li>   <li>"organizations/{organization_id}/accessApprovalSettings"</li> <ol>
      */
     name?: string;
+    /**
+     * The update mask applies to the settings. For the `FieldMask` definition, see https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask If this field is left unset, only the notification_emails field will be updated.
+     */
+    updateMask?: string;
 
     /**
      * Request body metadata
@@ -927,12 +949,13 @@ export namespace accessapproval_v1beta1 {
 
     /**
      * accessapproval.organizations.updateAccessApprovalSettings
-     * @desc Updates the settings associated with a project, folder, or organization. Completely replaces the existing settings.
+     * @desc Updates the settings associated with a project, folder, or organization. Settings to update are determined by the value of field_mask.
      * @alias accessapproval.organizations.updateAccessApprovalSettings
      * @memberOf! ()
      *
      * @param {object} params Parameters for request
      * @param {string} params.name The resource name of the settings. Format is one of: <ol>   <li>"projects/{project_id}/accessApprovalSettings"</li>   <li>"folders/{folder_id}/accessApprovalSettings"</li>   <li>"organizations/{organization_id}/accessApprovalSettings"</li> <ol>
+     * @param {string=} params.updateMask The update mask applies to the settings. For the `FieldMask` definition, see https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask If this field is left unset, only the notification_emails field will be updated.
      * @param {().AccessApprovalSettings} params.resource Request body data
      * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`.
      * @param {callback} callback The callback that handles the response.
@@ -1026,6 +1049,10 @@ export namespace accessapproval_v1beta1 {
      * The resource name of the settings. Format is one of: <ol>   <li>"projects/{project_id}/accessApprovalSettings"</li>   <li>"folders/{folder_id}/accessApprovalSettings"</li>   <li>"organizations/{organization_id}/accessApprovalSettings"</li> <ol>
      */
     name?: string;
+    /**
+     * The update mask applies to the settings. For the `FieldMask` definition, see https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask If this field is left unset, only the notification_emails field will be updated.
+     */
+    updateMask?: string;
 
     /**
      * Request body metadata
@@ -1510,12 +1537,13 @@ export namespace accessapproval_v1beta1 {
 
     /**
      * accessapproval.projects.updateAccessApprovalSettings
-     * @desc Updates the settings associated with a project, folder, or organization. Completely replaces the existing settings.
+     * @desc Updates the settings associated with a project, folder, or organization. Settings to update are determined by the value of field_mask.
      * @alias accessapproval.projects.updateAccessApprovalSettings
      * @memberOf! ()
      *
      * @param {object} params Parameters for request
      * @param {string} params.name The resource name of the settings. Format is one of: <ol>   <li>"projects/{project_id}/accessApprovalSettings"</li>   <li>"folders/{folder_id}/accessApprovalSettings"</li>   <li>"organizations/{organization_id}/accessApprovalSettings"</li> <ol>
+     * @param {string=} params.updateMask The update mask applies to the settings. For the `FieldMask` definition, see https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask If this field is left unset, only the notification_emails field will be updated.
      * @param {().AccessApprovalSettings} params.resource Request body data
      * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`.
      * @param {callback} callback The callback that handles the response.
@@ -1609,6 +1637,10 @@ export namespace accessapproval_v1beta1 {
      * The resource name of the settings. Format is one of: <ol>   <li>"projects/{project_id}/accessApprovalSettings"</li>   <li>"folders/{folder_id}/accessApprovalSettings"</li>   <li>"organizations/{organization_id}/accessApprovalSettings"</li> <ol>
      */
     name?: string;
+    /**
+     * The update mask applies to the settings. For the `FieldMask` definition, see https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask If this field is left unset, only the notification_emails field will be updated.
+     */
+    updateMask?: string;
 
     /**
      * Request body metadata

src/apis/adexperiencereport/v1.ts

@@ -120,35 +120,35 @@ export namespace adexperiencereport_v1 {
   }
 
   /**
-   * Summary of the ad experience rating of a site for a specific platform.
+   * A site's Ad Experience Report summary on a single platform.
    */
   export interface Schema$PlatformSummary {
     /**
-     * The status of the site reviewed for the Better Ads Standards.
+     * The site's Ad Experience Report status on this platform.
      */
     betterAdsStatus?: string;
     /**
-     * The date on which ad filtering begins.
+     * The time at which [enforcement](https://support.google.com/webtools/answer/7308033) against the site began or will begin on this platform.  Not set when the filter_status is OFF.
      */
     enforcementTime?: string;
     /**
-     * The ad filtering status of the site.
+     * The site's [enforcement status](https://support.google.com/webtools/answer/7308033) on this platform.
      */
     filterStatus?: string;
     /**
-     * The last time that the site changed status.
+     * The time at which the site's status last changed on this platform.
      */
     lastChangeTime?: string;
     /**
-     * The assigned regions for the site and platform.
+     * The site's regions on this platform.  No longer populated, because there is no longer any semantic difference between sites in different regions.
      */
     region?: string[];
     /**
-     * A link that leads to a full ad experience report.
+     * A link to the full Ad Experience Report for the site on this platform..  Not set in ViolatingSitesResponse.  Note that you must complete the [Search Console verification process](https://support.google.com/webmasters/answer/9008080) for the site before you can access the full report.
      */
     reportUrl?: string;
     /**
-     * Whether the site is currently under review.
+     * Whether the site is currently under review on this platform.
      */
     underReview?: boolean;
   }
@@ -157,15 +157,15 @@ export namespace adexperiencereport_v1 {
    */
   export interface Schema$SiteSummaryResponse {
     /**
-     * Summary for the desktop review of the site.
+     * The site's Ad Experience Report summary on desktop.
      */
     desktopSummary?: Schema$PlatformSummary;
     /**
-     * Summary for the mobile review of the site.
+     * The site's Ad Experience Report summary on mobile.
      */
     mobileSummary?: Schema$PlatformSummary;
     /**
-     * The name of the site reviewed.
+     * The name of the reviewed site, e.g. `google.com`.
      */
     reviewedSite?: string;
   }
@@ -174,7 +174,7 @@ export namespace adexperiencereport_v1 {
    */
   export interface Schema$ViolatingSitesResponse {
     /**
-     * A list of summaries of violating sites.
+     * The list of violating sites.
      */
     violatingSites?: Schema$SiteSummaryResponse[];
   }
@@ -187,12 +187,12 @@ export namespace adexperiencereport_v1 {
 
     /**
      * adexperiencereport.sites.get
-     * @desc Gets a summary of the ad experience rating of a site.
+     * @desc Gets a site's Ad Experience Report summary.
      * @alias adexperiencereport.sites.get
      * @memberOf! ()
      *
      * @param {object} params Parameters for request
-     * @param {string} params.name The required site name. It should be the site property whose ad experiences may have been reviewed, and it should be URL-encoded. For example, sites/https%3A%2F%2Fwww.google.com. The server will return an error of BAD_REQUEST if this field is not filled in. Note that if the site property is not yet verified in Search Console, the reportUrl field returned by the API will lead to the verification page, prompting the user to go through that process before they can gain access to the Ad Experience Report.
+     * @param {string} params.name Required. The name of the site whose summary to get, e.g. `sites/http%3A%2F%2Fwww.google.com%2F`.  Format: `sites/{site}`
      * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`.
      * @param {callback} callback The callback that handles the response.
      * @return {object} Request object
@@ -264,7 +264,7 @@ export namespace adexperiencereport_v1 {
     auth?: string | OAuth2Client | JWT | Compute | UserRefreshClient;
 
     /**
-     * The required site name. It should be the site property whose ad experiences may have been reviewed, and it should be URL-encoded. For example, sites/https%3A%2F%2Fwww.google.com. The server will return an error of BAD_REQUEST if this field is not filled in. Note that if the site property is not yet verified in Search Console, the reportUrl field returned by the API will lead to the verification page, prompting the user to go through that process before they can gain access to the Ad Experience Report.
+     * Required. The name of the site whose summary to get, e.g. `sites/http%3A%2F%2Fwww.google.com%2F`.  Format: `sites/{site}`
      */
     name?: string;
   }
@@ -277,7 +277,7 @@ export namespace adexperiencereport_v1 {
 
     /**
      * adexperiencereport.violatingSites.list
-     * @desc Lists sites with Ad Experience Report statuses of "Failing" or "Warning".
+     * @desc Lists sites that are failing in the Ad Experience Report on at least one platform.
      * @alias adexperiencereport.violatingSites.list
      * @memberOf! ()
      *