@maxim_mazurok/gapi.client.bigquery-v2 0.1.20260513 → 0.1.20260605

package/index.d.ts

@@ -9,7 +9,7 @@
 // This file was generated by https://github.com/Maxim-Mazurok/google-api-typings-generator. Please do not edit it manually.
 // In case of any problems please post issue to https://github.com/Maxim-Mazurok/google-api-typings-generator
 // Generated from: https://bigquery.googleapis.com/$discovery/rest?version=v2
-// Revision: 20260513
+// Revision: 20260605
 
 /// <reference types="gapi.client" />
 
@@ -1711,7 +1711,7 @@ declare namespace gapi.client {
       totalServicesSkuSlotMs?: string;
       /** Output only. Slot-milliseconds for the job. */
       totalSlotMs?: string;
-      /** Output only. Total bytes transferred for cross-cloud queries such as Cross Cloud Transfer and CREATE TABLE AS SELECT (CTAS). */
+      /** Output only. Total bytes transferred for BigQuery Omni queries from the remote cloud back to Google Cloud. This tracks data movement over Google-managed connections (like query results). It doesn't include input data read from the external data lake (for example, S3) because that data stays within the remote cloud. */
       transferredBytes?: string;
       /** Output only. GoogleSQL only: list of undeclared query parameters detected during a dry run validation. */
       undeclaredQueryParameters?: QueryParameter[];
@@ -3531,7 +3531,7 @@ declare namespace gapi.client {
       userDefinedFunctionResources?: UserDefinedFunctionResource[];
     }
     interface DatasetsResource {
-      /** Deletes the dataset specified by the datasetId value. Before you can delete a dataset, you must delete all its tables, either manually or by specifying deleteContents. Immediately after deletion, you can create another dataset with the same name. */
+      /** Deletes the dataset specified by the datasetId value. Before you can delete a dataset, you must delete all its tables, either manually or by specifying deleteContents. Immediately after deletion, you can create another dataset with the same name. # IAM Permissions Requires the `bigquery.datasets.delete` permission on the dataset. */
       delete(request?: {
         /** V1 error format. */
         '$.xgafv'?: '1' | '2';
@@ -3562,7 +3562,7 @@ declare namespace gapi.client {
         /** Legacy upload protocol for media (e.g. "media", "multipart"). */
         uploadType?: string;
       }): Request<void>;
-      /** Returns the dataset specified by datasetID. */
+      /** Returns the dataset specified by datasetID. # IAM Permissions Requires the `bigquery.datasets.get` permission on the dataset. */
       get(request?: {
         /** V1 error format. */
         '$.xgafv'?: '1' | '2';
@@ -3595,7 +3595,7 @@ declare namespace gapi.client {
         /** Legacy upload protocol for media (e.g. "media", "multipart"). */
         uploadType?: string;
       }): Request<Dataset>;
-      /** Creates a new empty dataset. */
+      /** Creates a new empty dataset. # IAM Permissions Requires the `bigquery.datasets.create` permission on the project. */
       insert(request: {
         /** V1 error format. */
         '$.xgafv'?: '1' | '2';
@@ -3657,7 +3657,7 @@ declare namespace gapi.client {
         },
         body: Dataset,
       ): Request<Dataset>;
-      /** Lists all datasets in the specified project to which the user has been granted the READER dataset role. */
+      /** Lists all datasets in the specified project to which the user has been granted the READER dataset role. # IAM Permissions Requires no specific IAM permission(s) to use this method. Results are filtered to only include datasets on which the caller has the `bigquery.datasets.get` permission. */
       list(request?: {
         /** V1 error format. */
         '$.xgafv'?: '1' | '2';
@@ -3692,7 +3692,7 @@ declare namespace gapi.client {
         /** Legacy upload protocol for media (e.g. "media", "multipart"). */
         uploadType?: string;
       }): Request<DatasetList>;
-      /** Updates information in an existing dataset. The update method replaces the entire dataset resource, whereas the patch method only replaces fields that are provided in the submitted dataset resource. This method supports RFC5789 patch semantics. */
+      /** Updates information in an existing dataset. The update method replaces the entire dataset resource, whereas the patch method only replaces fields that are provided in the submitted dataset resource. This method supports RFC5789 patch semantics. # IAM Permissions Requires the following IAM permission(s) to use this method: - `bigquery.datasets.update` on the dataset. - `bigquery.datasets.get` on the dataset. */
       patch(request: {
         /** V1 error format. */
         '$.xgafv'?: '1' | '2';
@@ -3770,7 +3770,7 @@ declare namespace gapi.client {
         },
         body: Dataset,
       ): Request<Dataset>;
-      /** Undeletes a dataset which is within time travel window based on datasetId. If a time is specified, the dataset version deleted at that time is undeleted, else the last live version is undeleted. */
+      /** Undeletes a dataset which is within time travel window based on datasetId. If a time is specified, the dataset version deleted at that time is undeleted, else the last live version is undeleted. # IAM Permissions Requires the following IAM permission(s) to use this method: - `bigquery.datasets.create` on the project. - `bigquery.datasets.get` on the dataset. */
       undelete(request: {
         /** V1 error format. */
         '$.xgafv'?: '1' | '2';
@@ -3832,7 +3832,7 @@ declare namespace gapi.client {
         },
         body: UndeleteDatasetRequest,
       ): Request<Dataset>;
-      /** Updates information in an existing dataset. The update method replaces the entire dataset resource, whereas the patch method only replaces fields that are provided in the submitted dataset resource. */
+      /** Updates information in an existing dataset. The update method replaces the entire dataset resource, whereas the patch method only replaces fields that are provided in the submitted dataset resource. # IAM Permissions Requires the `bigquery.datasets.update` permission on the dataset. */
       update(request: {
         /** V1 error format. */
         '$.xgafv'?: '1' | '2';
@@ -3912,7 +3912,7 @@ declare namespace gapi.client {
       ): Request<Dataset>;
     }
     interface JobsResource {
-      /** Requests that a job be cancelled. This call will return immediately, and the client will need to poll for the job status to see if the cancel completed successfully. Cancelled jobs may still incur costs. */
+      /** Requests that a job be cancelled. This call will return immediately, and the client will need to poll for the job status to see if the cancel completed successfully. Cancelled jobs may still incur costs. # IAM Permissions Requires the `bigquery.jobs.update` permission on the job resource. If the user matches the creator of the job, the `bigquery.jobs.create` permission on the project is required instead. */
       cancel(request?: {
         /** V1 error format. */
         '$.xgafv'?: '1' | '2';
@@ -3943,7 +3943,7 @@ declare namespace gapi.client {
         /** Legacy upload protocol for media (e.g. "media", "multipart"). */
         uploadType?: string;
       }): Request<JobCancelResponse>;
-      /** Requests the deletion of the metadata of a job. This call returns when the job's metadata is deleted. */
+      /** Requests the deletion of the metadata of a job. This call returns when the job's metadata is deleted. # IAM Permissions Requires the `bigquery.jobs.delete` permission on the job resource. */
       delete(request?: {
         /** V1 error format. */
         '$.xgafv'?: '1' | '2';
@@ -3974,7 +3974,7 @@ declare namespace gapi.client {
         /** Legacy upload protocol for media (e.g. "media", "multipart"). */
         uploadType?: string;
       }): Request<void>;
-      /** Returns information about a specific job. Job information is available for a six month period after creation. Requires that you're the person who ran the job, or have the Is Owner project role. */
+      /** Returns information about a specific job. Job information is available for a six month period after creation. Requires that you're the person who ran the job, or have the Is Owner project role. # IAM Permissions Requires the `bigquery.jobs.get` permission on the job resource. If the user matches the creator of the job, the `bigquery.jobs.create` permission on the project is required instead. */
       get(request?: {
         /** V1 error format. */
         '$.xgafv'?: '1' | '2';
@@ -4005,7 +4005,7 @@ declare namespace gapi.client {
         /** Legacy upload protocol for media (e.g. "media", "multipart"). */
         uploadType?: string;
       }): Request<Job>;
-      /** RPC to get the results of a query job. */
+      /** RPC to get the results of a query job. # IAM Permissions Requires the following IAM permission(s) to use this method: - `bigquery.jobs.get` on the job. - `bigquery.tables.getData` on the destination table. If the user matches the creator of the job, the following IAM permission(s) are required instead: - `bigquery.jobs.create` on the project. - `bigquery.tables.getData` on the destination table. */
       getQueryResults(request?: {
         /** V1 error format. */
         '$.xgafv'?: '1' | '2';
@@ -4052,7 +4052,7 @@ declare namespace gapi.client {
         /** Legacy upload protocol for media (e.g. "media", "multipart"). */
         uploadType?: string;
       }): Request<GetQueryResultsResponse>;
-      /** Starts a new asynchronous job. This API has two different kinds of endpoint URIs, as this method supports a variety of use cases. * The *Metadata* URI is used for most interactions, as it accepts the job configuration directly. * The *Upload* URI is ONLY for the case when you're sending both a load job configuration and a data stream together. In this case, the Upload URI accepts the job configuration and the data as two distinct multipart MIME parts. */
+      /** Starts a new asynchronous job. This API has two different kinds of endpoint URIs, as this method supports a variety of use cases. * The *Metadata* URI is used for most interactions, as it accepts the job configuration directly. * The *Upload* URI is ONLY for the case when you're sending both a load job configuration and a data stream together. In this case, the Upload URI accepts the job configuration and the data as two distinct multipart MIME parts. # IAM Permissions Requires the `bigquery.jobs.create` permission on the project resource. Additional permissions are required depending on the job type: - **Load, Export, and Copy jobs**: Generally require data-level permissions such as `bigquery.tables.export` or access to external storage. - **Query jobs**: Permissions are dependent on the SQL statement. Complex queries (DDL, DCL) may require additional permissions to create reservations, modify IAM policies, or update project settings. */
       insert(request: {
         /** V1 error format. */
         '$.xgafv'?: '1' | '2';
@@ -4110,7 +4110,7 @@ declare namespace gapi.client {
         },
         body: Job,
       ): Request<Job>;
-      /** Lists all jobs that you started in the specified project. Job information is available for a six month period after creation. The job list is sorted in reverse chronological order, by job creation time. Requires the Can View project role, or the Is Owner project role if you set the allUsers property. */
+      /** Lists all jobs that you started in the specified project. Job information is available for a six month period after creation. The job list is sorted in reverse chronological order, by job creation time. Requires the Can View project role, or the Is Owner project role if you set the allUsers property. # IAM Permissions Requires no specific IAM permission(s) to use this method. Users are able to list the jobs they created. Additional access is granted based on the following permissions: - Users with the `bigquery.jobs.listAll` permission can list all jobs with all metadata. - Users with the `bigquery.jobs.list` permission can list all jobs, but with redacted information for jobs they did not create. */
       list(request?: {
         /** V1 error format. */
         '$.xgafv'?: '1' | '2';
@@ -4157,7 +4157,7 @@ declare namespace gapi.client {
         /** Legacy upload protocol for media (e.g. "media", "multipart"). */
         uploadType?: string;
       }): Request<JobList>;
-      /** Runs a BigQuery SQL query synchronously and returns query results if the query completes within a specified timeout. */
+      /** Runs a BigQuery SQL query synchronously and returns query results if the query completes within a specified timeout. # IAM Permissions Requires the `bigquery.jobs.create` permission on the project resource. Data-level permissions are highly dependent on the SQL statement being executed. While standard queries require data access (such as `bigquery.tables.getData`), complex operations like DDL or DCL may require permissions to manage reservations, IAM policies, or project settings. */
       query(request: {
         /** V1 error format. */
         '$.xgafv'?: '1' | '2';
@@ -4217,7 +4217,7 @@ declare namespace gapi.client {
       ): Request<QueryResponse>;
     }
     interface ModelsResource {
-      /** Deletes the model specified by modelId from the dataset. */
+      /** Deletes the model specified by modelId from the dataset. # IAM Permissions Requires the `bigquery.models.delete` permission on the model. */
       delete(request?: {
         /** V1 error format. */
         '$.xgafv'?: '1' | '2';
@@ -4248,7 +4248,7 @@ declare namespace gapi.client {
         /** Legacy upload protocol for media (e.g. "media", "multipart"). */
         uploadType?: string;
       }): Request<void>;
-      /** Gets the specified model resource by model ID. */
+      /** Gets the specified model resource by model ID. # IAM Permissions Requires the `bigquery.models.getMetadata` permission on the model. */
       get(request?: {
         /** V1 error format. */
         '$.xgafv'?: '1' | '2';
@@ -4279,7 +4279,7 @@ declare namespace gapi.client {
         /** Legacy upload protocol for media (e.g. "media", "multipart"). */
         uploadType?: string;
       }): Request<Model>;
-      /** Lists all models in the specified dataset. Requires the READER dataset role. After retrieving the list of models, you can get information about a particular model by calling the models.get method. */
+      /** Lists all models in the specified dataset. Requires the READER dataset role. After retrieving the list of models, you can get information about a particular model by calling the models.get method. # IAM Permissions Requires the `bigquery.models.list` permission on the dataset. */
       list(request?: {
         /** V1 error format. */
         '$.xgafv'?: '1' | '2';
@@ -4312,7 +4312,7 @@ declare namespace gapi.client {
         /** Legacy upload protocol for media (e.g. "media", "multipart"). */
         uploadType?: string;
       }): Request<ListModelsResponse>;
-      /** Patch specific fields in the specified model. */
+      /** Patch specific fields in the specified model. # IAM Permissions Requires the `bigquery.models.updateMetadata` permission on the model. */
       patch(request: {
         /** V1 error format. */
         '$.xgafv'?: '1' | '2';
@@ -4380,7 +4380,7 @@ declare namespace gapi.client {
       ): Request<Model>;
     }
     interface ProjectsResource {
-      /** RPC to get the service account for a project used for interactions with Google Cloud KMS */
+      /** RPC to get the service account for a project used for interactions with Google Cloud KMS. Requires the `bigquery.jobs.create` permission on the project resource. This permission is required to authorize the retrieval of the project's service identity for technical management tasks like encryption configuration. */
       getServiceAccount(request?: {
         /** V1 error format. */
         '$.xgafv'?: '1' | '2';
@@ -4407,7 +4407,7 @@ declare namespace gapi.client {
         /** Legacy upload protocol for media (e.g. "media", "multipart"). */
         uploadType?: string;
       }): Request<GetServiceAccountResponse>;
-      /** RPC to list projects to which the user has been granted any project role. Users of this method are encouraged to consider the [Resource Manager](https://cloud.google.com/resource-manager/docs/) API, which provides the underlying data for this method and has more capabilities. */
+      /** RPC to list projects to which the user has been granted any project role. Users of this method are encouraged to consider the [Resource Manager](https://cloud.google.com/resource-manager/docs/) API, which provides the underlying data for this method and has more capabilities. # IAM Permissions Requires no specific IAM permission(s) to use this method. The results are filtered to only include projects on which the caller has been granted a project-level role such as a BigQuery predefined IAM role or a basic role such as Viewer or Owner. */
       list(request?: {
         /** V1 error format. */
         '$.xgafv'?: '1' | '2';
@@ -4438,7 +4438,7 @@ declare namespace gapi.client {
       }): Request<ProjectList>;
     }
     interface RoutinesResource {
-      /** Deletes the routine specified by routineId from the dataset. */
+      /** Deletes the routine specified by routineId from the dataset. # IAM Permissions Requires the `bigquery.routines.delete` permission on the routine. */
       delete(request?: {
         /** V1 error format. */
         '$.xgafv'?: '1' | '2';
@@ -4469,7 +4469,7 @@ declare namespace gapi.client {
         /** Legacy upload protocol for media (e.g. "media", "multipart"). */
         uploadType?: string;
       }): Request<void>;
-      /** Gets the specified routine resource by routine ID. */
+      /** Gets the specified routine resource by routine ID. # IAM Permissions Requires the `bigquery.routines.get` permission on the routine. */
       get(request?: {
         /** V1 error format. */
         '$.xgafv'?: '1' | '2';
@@ -4532,7 +4532,7 @@ declare namespace gapi.client {
         },
         body: GetIamPolicyRequest,
       ): Request<Policy>;
-      /** Creates a new routine in the dataset. */
+      /** Creates a new routine in the dataset. # IAM Permissions Requires the `bigquery.routines.create` permission on the dataset. */
       insert(request: {
         /** V1 error format. */
         '$.xgafv'?: '1' | '2';
@@ -4594,7 +4594,7 @@ declare namespace gapi.client {
         },
         body: Routine,
       ): Request<Routine>;
-      /** Lists all routines in the specified dataset. Requires the READER dataset role. */
+      /** Lists all routines in the specified dataset. Requires the READER dataset role. # IAM Permissions Requires the `bigquery.routines.list` permission on the dataset. */
       list(request?: {
         /** V1 error format. */
         '$.xgafv'?: '1' | '2';
@@ -4691,7 +4691,7 @@ declare namespace gapi.client {
         },
         body: TestIamPermissionsRequest,
       ): Request<TestIamPermissionsResponse>;
-      /** Updates information in an existing routine. The update method replaces the entire Routine resource. */
+      /** Updates information in an existing routine. The update method replaces the entire Routine resource. # IAM Permissions Requires the `bigquery.routines.update` permission on the routine. */
       update(request: {
         /** V1 error format. */
         '$.xgafv'?: '1' | '2';
@@ -4759,7 +4759,7 @@ declare namespace gapi.client {
       ): Request<Routine>;
     }
     interface RowAccessPoliciesResource {
-      /** Deletes provided row access policies. */
+      /** Deletes provided row access policies. # IAM Permissions Requires the following IAM permission(s) on the table: - `bigquery.rowAccessPolicies.delete` - `bigquery.rowAccessPolicies.setIamPolicy` */
       batchDelete(request: {
         /** V1 error format. */
         '$.xgafv'?: '1' | '2';
@@ -4825,7 +4825,7 @@ declare namespace gapi.client {
         },
         body: BatchDeleteRowAccessPoliciesRequest,
       ): Request<void>;
-      /** Deletes a row access policy. */
+      /** Deletes a row access policy. # IAM Permissions Requires the following IAM permission(s) on the table: - `bigquery.rowAccessPolicies.delete` - `bigquery.rowAccessPolicies.setIamPolicy` */
       delete(request?: {
         /** V1 error format. */
         '$.xgafv'?: '1' | '2';
@@ -4860,7 +4860,7 @@ declare namespace gapi.client {
         /** Legacy upload protocol for media (e.g. "media", "multipart"). */
         uploadType?: string;
       }): Request<void>;
-      /** Gets the specified row access policy by policy ID. */
+      /** Gets the specified row access policy by policy ID. # IAM Permissions Requires the `bigquery.rowAccessPolicies.get` permission on the table. */
       get(request?: {
         /** V1 error format. */
         '$.xgafv'?: '1' | '2';
@@ -4923,7 +4923,7 @@ declare namespace gapi.client {
         },
         body: GetIamPolicyRequest,
       ): Request<Policy>;
-      /** Creates a row access policy. */
+      /** Creates a row access policy. # IAM Permissions Requires the following IAM permission(s) on the table: - `bigquery.rowAccessPolicies.create` - `bigquery.rowAccessPolicies.setIamPolicy` - `bigquery.tables.getData` */
       insert(request: {
         /** V1 error format. */
         '$.xgafv'?: '1' | '2';
@@ -4989,7 +4989,7 @@ declare namespace gapi.client {
         },
         body: RowAccessPolicy,
       ): Request<RowAccessPolicy>;
-      /** Lists all row access policies on the specified table. */
+      /** Lists all row access policies on the specified table. # IAM Permissions Requires the `bigquery.rowAccessPolicies.list` permission on the table. */
       list(request?: {
         /** V1 error format. */
         '$.xgafv'?: '1' | '2';
@@ -5054,7 +5054,7 @@ declare namespace gapi.client {
         },
         body: TestIamPermissionsRequest,
       ): Request<TestIamPermissionsResponse>;
-      /** Updates a row access policy. */
+      /** Updates a row access policy. # IAM Permissions Requires the following IAM permission(s) on the table: - `bigquery.rowAccessPolicies.update` - `bigquery.rowAccessPolicies.setIamPolicy` - `bigquery.tables.getData` */
       update(request: {
         /** V1 error format. */
         '$.xgafv'?: '1' | '2';
@@ -5126,7 +5126,7 @@ declare namespace gapi.client {
       ): Request<RowAccessPolicy>;
     }
     interface TabledataResource {
-      /** Streams data into BigQuery one record at a time without needing to run a load job. */
+      /** Streams data into BigQuery one record at a time without needing to run a load job. # IAM Permissions Requires the following IAM permission(s) to use this method: - `bigquery.tables.updateData` on the table. - `bigquery.tables.get` on the table. - `bigquery.datasets.get` on the dataset. */
       insertAll(request: {
         /** V1 error format. */
         '$.xgafv'?: '1' | '2';
@@ -5192,7 +5192,7 @@ declare namespace gapi.client {
         },
         body: TableDataInsertAllRequest,
       ): Request<TableDataInsertAllResponse>;
-      /** List the content of a table in rows. */
+      /** List the content of a table in rows. # IAM Permissions Requires the `bigquery.tables.getData` permission on the table. */
       list(request?: {
         /** V1 error format. */
         '$.xgafv'?: '1' | '2';
@@ -5241,7 +5241,7 @@ declare namespace gapi.client {
       }): Request<TableDataList>;
     }
     interface TablesResource {
-      /** Deletes the table specified by tableId from the dataset. If the table contains data, all the data will be deleted. */
+      /** Deletes the table specified by tableId from the dataset. If the table contains data, all the data will be deleted. # IAM Permissions Requires the `bigquery.tables.delete` permission on the table. */
       delete(request?: {
         /** V1 error format. */
         '$.xgafv'?: '1' | '2';
@@ -5272,7 +5272,7 @@ declare namespace gapi.client {
         /** Legacy upload protocol for media (e.g. "media", "multipart"). */
         uploadType?: string;
       }): Request<void>;
-      /** Gets the specified table resource by table ID. This method does not return the data in the table, it only returns the table resource, which describes the structure of this table. */
+      /** Gets the specified table resource by table ID. This method does not return the data in the table, it only returns the table resource, which describes the structure of this table. # IAM Permissions Requires the `bigquery.tables.get` permission on the table. */
       get(request?: {
         /** V1 error format. */
         '$.xgafv'?: '1' | '2';
@@ -5341,7 +5341,7 @@ declare namespace gapi.client {
         },
         body: GetIamPolicyRequest,
       ): Request<Policy>;
-      /** Creates a new, empty table in the dataset. */
+      /** Creates a new, empty table in the dataset. # IAM Permissions Requires the `bigquery.tables.create` permission on the dataset. */
       insert(request: {
         /** V1 error format. */
         '$.xgafv'?: '1' | '2';
@@ -5403,7 +5403,7 @@ declare namespace gapi.client {
         },
         body: Table,
       ): Request<Table>;
-      /** Lists all tables in the specified dataset. Requires the READER dataset role. */
+      /** Lists all tables in the specified dataset. Requires the READER dataset role. # IAM Permissions Requires the `bigquery.tables.list` permission on the dataset. */
       list(request?: {
         /** V1 error format. */
         '$.xgafv'?: '1' | '2';
@@ -5436,7 +5436,7 @@ declare namespace gapi.client {
         /** Legacy upload protocol for media (e.g. "media", "multipart"). */
         uploadType?: string;
       }): Request<TableList>;
-      /** Updates information in an existing table. The update method replaces the entire table resource, whereas the patch method only replaces fields that are provided in the submitted table resource. This method supports RFC5789 patch semantics. */
+      /** Updates information in an existing table. The update method replaces the entire table resource, whereas the patch method only replaces fields that are provided in the submitted table resource. This method supports RFC5789 patch semantics. # IAM Permissions Requires the following IAM permission(s) on the table: - `bigquery.tables.update` - `bigquery.tables.get` */
       patch(request: {
         /** V1 error format. */
         '$.xgafv'?: '1' | '2';
@@ -5566,7 +5566,7 @@ declare namespace gapi.client {
         },
         body: TestIamPermissionsRequest,
       ): Request<TestIamPermissionsResponse>;
-      /** Updates information in an existing table. The update method replaces the entire Table resource, whereas the patch method only replaces fields that are provided in the submitted Table resource. */
+      /** Updates information in an existing table. The update method replaces the entire Table resource, whereas the patch method only replaces fields that are provided in the submitted Table resource. # IAM Permissions Requires the `bigquery.tables.update` permission on the table. */
       update(request: {
         /** V1 error format. */
         '$.xgafv'?: '1' | '2';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maxim_mazurok/gapi.client.bigquery-v2",
-  "version": "0.1.20260513",
+  "version": "0.1.20260605",
   "description": "TypeScript typings for BigQuery API v2",
   "repository": {
     "type": "git",

package/readme.md

@@ -100,7 +100,7 @@ After that you can use BigQuery API resources: <!-- TODO: make this work for mul
 
 ```typescript
 /*
-Deletes the dataset specified by the datasetId value. Before you can delete a dataset, you must delete all its tables, either manually or by specifying deleteContents. Immediately after deletion, you can create another dataset with the same name.
+Deletes the dataset specified by the datasetId value. Before you can delete a dataset, you must delete all its tables, either manually or by specifying deleteContents. Immediately after deletion, you can create another dataset with the same name. # IAM Permissions Requires the `bigquery.datasets.delete` permission on the dataset.
 */
 await gapi.client.bigquery.datasets.delete({
   datasetId: 'datasetId',
@@ -108,7 +108,7 @@ await gapi.client.bigquery.datasets.delete({
 });
 
 /*
-Returns the dataset specified by datasetID.
+Returns the dataset specified by datasetID. # IAM Permissions Requires the `bigquery.datasets.get` permission on the dataset.
 */
 await gapi.client.bigquery.datasets.get({
   datasetId: 'datasetId',
@@ -116,17 +116,17 @@ await gapi.client.bigquery.datasets.get({
 });
 
 /*
-Creates a new empty dataset.
+Creates a new empty dataset. # IAM Permissions Requires the `bigquery.datasets.create` permission on the project.
 */
 await gapi.client.bigquery.datasets.insert({projectId: 'projectId'});
 
 /*
-Lists all datasets in the specified project to which the user has been granted the READER dataset role.
+Lists all datasets in the specified project to which the user has been granted the READER dataset role. # IAM Permissions Requires no specific IAM permission(s) to use this method. Results are filtered to only include datasets on which the caller has the `bigquery.datasets.get` permission.
 */
 await gapi.client.bigquery.datasets.list({projectId: 'projectId'});
 
 /*
-Updates information in an existing dataset. The update method replaces the entire dataset resource, whereas the patch method only replaces fields that are provided in the submitted dataset resource. This method supports RFC5789 patch semantics.
+Updates information in an existing dataset. The update method replaces the entire dataset resource, whereas the patch method only replaces fields that are provided in the submitted dataset resource. This method supports RFC5789 patch semantics. # IAM Permissions Requires the following IAM permission(s) to use this method: - `bigquery.datasets.update` on the dataset. - `bigquery.datasets.get` on the dataset.
 */
 await gapi.client.bigquery.datasets.patch({
   datasetId: 'datasetId',
@@ -134,7 +134,7 @@ await gapi.client.bigquery.datasets.patch({
 });
 
 /*
-Undeletes a dataset which is within time travel window based on datasetId. If a time is specified, the dataset version deleted at that time is undeleted, else the last live version is undeleted.
+Undeletes a dataset which is within time travel window based on datasetId. If a time is specified, the dataset version deleted at that time is undeleted, else the last live version is undeleted. # IAM Permissions Requires the following IAM permission(s) to use this method: - `bigquery.datasets.create` on the project. - `bigquery.datasets.get` on the dataset.
 */
 await gapi.client.bigquery.datasets.undelete({
   datasetId: 'datasetId',
@@ -142,7 +142,7 @@ await gapi.client.bigquery.datasets.undelete({
 });
 
 /*
-Updates information in an existing dataset. The update method replaces the entire dataset resource, whereas the patch method only replaces fields that are provided in the submitted dataset resource.
+Updates information in an existing dataset. The update method replaces the entire dataset resource, whereas the patch method only replaces fields that are provided in the submitted dataset resource. # IAM Permissions Requires the `bigquery.datasets.update` permission on the dataset.
 */
 await gapi.client.bigquery.datasets.update({
   datasetId: 'datasetId',
@@ -150,7 +150,7 @@ await gapi.client.bigquery.datasets.update({
 });
 
 /*
-Requests that a job be cancelled. This call will return immediately, and the client will need to poll for the job status to see if the cancel completed successfully. Cancelled jobs may still incur costs.
+Requests that a job be cancelled. This call will return immediately, and the client will need to poll for the job status to see if the cancel completed successfully. Cancelled jobs may still incur costs. # IAM Permissions Requires the `bigquery.jobs.update` permission on the job resource. If the user matches the creator of the job, the `bigquery.jobs.create` permission on the project is required instead.
 */
 await gapi.client.bigquery.jobs.cancel({
   jobId: 'jobId',
@@ -158,7 +158,7 @@ await gapi.client.bigquery.jobs.cancel({
 });
 
 /*
-Requests the deletion of the metadata of a job. This call returns when the job's metadata is deleted.
+Requests the deletion of the metadata of a job. This call returns when the job's metadata is deleted. # IAM Permissions Requires the `bigquery.jobs.delete` permission on the job resource.
 */
 await gapi.client.bigquery.jobs.delete({
   jobId: 'jobId',
@@ -166,12 +166,12 @@ await gapi.client.bigquery.jobs.delete({
 });
 
 /*
-Returns information about a specific job. Job information is available for a six month period after creation. Requires that you're the person who ran the job, or have the Is Owner project role.
+Returns information about a specific job. Job information is available for a six month period after creation. Requires that you're the person who ran the job, or have the Is Owner project role. # IAM Permissions Requires the `bigquery.jobs.get` permission on the job resource. If the user matches the creator of the job, the `bigquery.jobs.create` permission on the project is required instead.
 */
 await gapi.client.bigquery.jobs.get({jobId: 'jobId', projectId: 'projectId'});
 
 /*
-RPC to get the results of a query job.
+RPC to get the results of a query job. # IAM Permissions Requires the following IAM permission(s) to use this method: - `bigquery.jobs.get` on the job. - `bigquery.tables.getData` on the destination table. If the user matches the creator of the job, the following IAM permission(s) are required instead: - `bigquery.jobs.create` on the project. - `bigquery.tables.getData` on the destination table.
 */
 await gapi.client.bigquery.jobs.getQueryResults({
   jobId: 'jobId',
@@ -179,22 +179,22 @@ await gapi.client.bigquery.jobs.getQueryResults({
 });
 
 /*
-Starts a new asynchronous job. This API has two different kinds of endpoint URIs, as this method supports a variety of use cases. * The *Metadata* URI is used for most interactions, as it accepts the job configuration directly. * The *Upload* URI is ONLY for the case when you're sending both a load job configuration and a data stream together. In this case, the Upload URI accepts the job configuration and the data as two distinct multipart MIME parts.
+Starts a new asynchronous job. This API has two different kinds of endpoint URIs, as this method supports a variety of use cases. * The *Metadata* URI is used for most interactions, as it accepts the job configuration directly. * The *Upload* URI is ONLY for the case when you're sending both a load job configuration and a data stream together. In this case, the Upload URI accepts the job configuration and the data as two distinct multipart MIME parts. # IAM Permissions Requires the `bigquery.jobs.create` permission on the project resource. Additional permissions are required depending on the job type: - **Load, Export, and Copy jobs**: Generally require data-level permissions such as `bigquery.tables.export` or access to external storage. - **Query jobs**: Permissions are dependent on the SQL statement. Complex queries (DDL, DCL) may require additional permissions to create reservations, modify IAM policies, or update project settings.
 */
 await gapi.client.bigquery.jobs.insert({projectId: 'projectId'});
 
 /*
-Lists all jobs that you started in the specified project. Job information is available for a six month period after creation. The job list is sorted in reverse chronological order, by job creation time. Requires the Can View project role, or the Is Owner project role if you set the allUsers property.
+Lists all jobs that you started in the specified project. Job information is available for a six month period after creation. The job list is sorted in reverse chronological order, by job creation time. Requires the Can View project role, or the Is Owner project role if you set the allUsers property. # IAM Permissions Requires no specific IAM permission(s) to use this method. Users are able to list the jobs they created. Additional access is granted based on the following permissions: - Users with the `bigquery.jobs.listAll` permission can list all jobs with all metadata. - Users with the `bigquery.jobs.list` permission can list all jobs, but with redacted information for jobs they did not create.
 */
 await gapi.client.bigquery.jobs.list({projectId: 'projectId'});
 
 /*
-Runs a BigQuery SQL query synchronously and returns query results if the query completes within a specified timeout.
+Runs a BigQuery SQL query synchronously and returns query results if the query completes within a specified timeout. # IAM Permissions Requires the `bigquery.jobs.create` permission on the project resource. Data-level permissions are highly dependent on the SQL statement being executed. While standard queries require data access (such as `bigquery.tables.getData`), complex operations like DDL or DCL may require permissions to manage reservations, IAM policies, or project settings.
 */
 await gapi.client.bigquery.jobs.query({projectId: 'projectId'});
 
 /*
-Deletes the model specified by modelId from the dataset.
+Deletes the model specified by modelId from the dataset. # IAM Permissions Requires the `bigquery.models.delete` permission on the model.
 */
 await gapi.client.bigquery.models.delete({
   datasetId: 'datasetId',
@@ -203,7 +203,7 @@ await gapi.client.bigquery.models.delete({
 });
 
 /*
-Gets the specified model resource by model ID.
+Gets the specified model resource by model ID. # IAM Permissions Requires the `bigquery.models.getMetadata` permission on the model.
 */
 await gapi.client.bigquery.models.get({
   datasetId: 'datasetId',
@@ -212,7 +212,7 @@ await gapi.client.bigquery.models.get({
 });
 
 /*
-Lists all models in the specified dataset. Requires the READER dataset role. After retrieving the list of models, you can get information about a particular model by calling the models.get method.
+Lists all models in the specified dataset. Requires the READER dataset role. After retrieving the list of models, you can get information about a particular model by calling the models.get method. # IAM Permissions Requires the `bigquery.models.list` permission on the dataset.
 */
 await gapi.client.bigquery.models.list({
   datasetId: 'datasetId',
@@ -220,7 +220,7 @@ await gapi.client.bigquery.models.list({
 });
 
 /*
-Patch specific fields in the specified model.
+Patch specific fields in the specified model. # IAM Permissions Requires the `bigquery.models.updateMetadata` permission on the model.
 */
 await gapi.client.bigquery.models.patch({
   datasetId: 'datasetId',
@@ -229,17 +229,17 @@ await gapi.client.bigquery.models.patch({
 });
 
 /*
-RPC to get the service account for a project used for interactions with Google Cloud KMS
+RPC to get the service account for a project used for interactions with Google Cloud KMS. Requires the `bigquery.jobs.create` permission on the project resource. This permission is required to authorize the retrieval of the project's service identity for technical management tasks like encryption configuration.
 */
 await gapi.client.bigquery.projects.getServiceAccount({projectId: 'projectId'});
 
 /*
-RPC to list projects to which the user has been granted any project role. Users of this method are encouraged to consider the [Resource Manager](https://cloud.google.com/resource-manager/docs/) API, which provides the underlying data for this method and has more capabilities.
+RPC to list projects to which the user has been granted any project role. Users of this method are encouraged to consider the [Resource Manager](https://cloud.google.com/resource-manager/docs/) API, which provides the underlying data for this method and has more capabilities. # IAM Permissions Requires no specific IAM permission(s) to use this method. The results are filtered to only include projects on which the caller has been granted a project-level role such as a BigQuery predefined IAM role or a basic role such as Viewer or Owner.
 */
 await gapi.client.bigquery.projects.list({});
 
 /*
-Deletes the routine specified by routineId from the dataset.
+Deletes the routine specified by routineId from the dataset. # IAM Permissions Requires the `bigquery.routines.delete` permission on the routine.
 */
 await gapi.client.bigquery.routines.delete({
   datasetId: 'datasetId',
@@ -248,7 +248,7 @@ await gapi.client.bigquery.routines.delete({
 });
 
 /*
-Gets the specified routine resource by routine ID.
+Gets the specified routine resource by routine ID. # IAM Permissions Requires the `bigquery.routines.get` permission on the routine.
 */
 await gapi.client.bigquery.routines.get({
   datasetId: 'datasetId',
@@ -262,7 +262,7 @@ Gets the access control policy for a resource. Returns an empty policy if the re
 await gapi.client.bigquery.routines.getIamPolicy({resource: 'resource'});
 
 /*
-Creates a new routine in the dataset.
+Creates a new routine in the dataset. # IAM Permissions Requires the `bigquery.routines.create` permission on the dataset.
 */
 await gapi.client.bigquery.routines.insert({
   datasetId: 'datasetId',
@@ -270,7 +270,7 @@ await gapi.client.bigquery.routines.insert({
 });
 
 /*
-Lists all routines in the specified dataset. Requires the READER dataset role.
+Lists all routines in the specified dataset. Requires the READER dataset role. # IAM Permissions Requires the `bigquery.routines.list` permission on the dataset.
 */
 await gapi.client.bigquery.routines.list({
   datasetId: 'datasetId',
@@ -288,7 +288,7 @@ Returns permissions that a caller has on the specified resource. If the resource
 await gapi.client.bigquery.routines.testIamPermissions({resource: 'resource'});
 
 /*
-Updates information in an existing routine. The update method replaces the entire Routine resource.
+Updates information in an existing routine. The update method replaces the entire Routine resource. # IAM Permissions Requires the `bigquery.routines.update` permission on the routine.
 */
 await gapi.client.bigquery.routines.update({
   datasetId: 'datasetId',
@@ -297,7 +297,7 @@ await gapi.client.bigquery.routines.update({
 });
 
 /*
-Deletes provided row access policies.
+Deletes provided row access policies. # IAM Permissions Requires the following IAM permission(s) on the table: - `bigquery.rowAccessPolicies.delete` - `bigquery.rowAccessPolicies.setIamPolicy`
 */
 await gapi.client.bigquery.rowAccessPolicies.batchDelete({
   datasetId: 'datasetId',
@@ -306,7 +306,7 @@ await gapi.client.bigquery.rowAccessPolicies.batchDelete({
 });
 
 /*
-Deletes a row access policy.
+Deletes a row access policy. # IAM Permissions Requires the following IAM permission(s) on the table: - `bigquery.rowAccessPolicies.delete` - `bigquery.rowAccessPolicies.setIamPolicy`
 */
 await gapi.client.bigquery.rowAccessPolicies.delete({
   datasetId: 'datasetId',
@@ -316,7 +316,7 @@ await gapi.client.bigquery.rowAccessPolicies.delete({
 });
 
 /*
-Gets the specified row access policy by policy ID.
+Gets the specified row access policy by policy ID. # IAM Permissions Requires the `bigquery.rowAccessPolicies.get` permission on the table.
 */
 await gapi.client.bigquery.rowAccessPolicies.get({
   datasetId: 'datasetId',
@@ -333,7 +333,7 @@ await gapi.client.bigquery.rowAccessPolicies.getIamPolicy({
 });
 
 /*
-Creates a row access policy.
+Creates a row access policy. # IAM Permissions Requires the following IAM permission(s) on the table: - `bigquery.rowAccessPolicies.create` - `bigquery.rowAccessPolicies.setIamPolicy` - `bigquery.tables.getData`
 */
 await gapi.client.bigquery.rowAccessPolicies.insert({
   datasetId: 'datasetId',
@@ -342,7 +342,7 @@ await gapi.client.bigquery.rowAccessPolicies.insert({
 });
 
 /*
-Lists all row access policies on the specified table.
+Lists all row access policies on the specified table. # IAM Permissions Requires the `bigquery.rowAccessPolicies.list` permission on the table.
 */
 await gapi.client.bigquery.rowAccessPolicies.list({
   datasetId: 'datasetId',
@@ -358,7 +358,7 @@ await gapi.client.bigquery.rowAccessPolicies.testIamPermissions({
 });
 
 /*
-Updates a row access policy.
+Updates a row access policy. # IAM Permissions Requires the following IAM permission(s) on the table: - `bigquery.rowAccessPolicies.update` - `bigquery.rowAccessPolicies.setIamPolicy` - `bigquery.tables.getData`
 */
 await gapi.client.bigquery.rowAccessPolicies.update({
   datasetId: 'datasetId',
@@ -368,7 +368,7 @@ await gapi.client.bigquery.rowAccessPolicies.update({
 });
 
 /*
-Streams data into BigQuery one record at a time without needing to run a load job.
+Streams data into BigQuery one record at a time without needing to run a load job. # IAM Permissions Requires the following IAM permission(s) to use this method: - `bigquery.tables.updateData` on the table. - `bigquery.tables.get` on the table. - `bigquery.datasets.get` on the dataset.
 */
 await gapi.client.bigquery.tabledata.insertAll({
   datasetId: 'datasetId',
@@ -377,7 +377,7 @@ await gapi.client.bigquery.tabledata.insertAll({
 });
 
 /*
-List the content of a table in rows.
+List the content of a table in rows. # IAM Permissions Requires the `bigquery.tables.getData` permission on the table.
 */
 await gapi.client.bigquery.tabledata.list({
   datasetId: 'datasetId',
@@ -386,7 +386,7 @@ await gapi.client.bigquery.tabledata.list({
 });
 
 /*
-Deletes the table specified by tableId from the dataset. If the table contains data, all the data will be deleted.
+Deletes the table specified by tableId from the dataset. If the table contains data, all the data will be deleted. # IAM Permissions Requires the `bigquery.tables.delete` permission on the table.
 */
 await gapi.client.bigquery.tables.delete({
   datasetId: 'datasetId',
@@ -395,7 +395,7 @@ await gapi.client.bigquery.tables.delete({
 });
 
 /*
-Gets the specified table resource by table ID. This method does not return the data in the table, it only returns the table resource, which describes the structure of this table.
+Gets the specified table resource by table ID. This method does not return the data in the table, it only returns the table resource, which describes the structure of this table. # IAM Permissions Requires the `bigquery.tables.get` permission on the table.
 */
 await gapi.client.bigquery.tables.get({
   datasetId: 'datasetId',
@@ -409,7 +409,7 @@ Gets the access control policy for a resource. Returns an empty policy if the re
 await gapi.client.bigquery.tables.getIamPolicy({resource: 'resource'});
 
 /*
-Creates a new, empty table in the dataset.
+Creates a new, empty table in the dataset. # IAM Permissions Requires the `bigquery.tables.create` permission on the dataset.
 */
 await gapi.client.bigquery.tables.insert({
   datasetId: 'datasetId',
@@ -417,7 +417,7 @@ await gapi.client.bigquery.tables.insert({
 });
 
 /*
-Lists all tables in the specified dataset. Requires the READER dataset role.
+Lists all tables in the specified dataset. Requires the READER dataset role. # IAM Permissions Requires the `bigquery.tables.list` permission on the dataset.
 */
 await gapi.client.bigquery.tables.list({
   datasetId: 'datasetId',
@@ -425,7 +425,7 @@ await gapi.client.bigquery.tables.list({
 });
 
 /*
-Updates information in an existing table. The update method replaces the entire table resource, whereas the patch method only replaces fields that are provided in the submitted table resource. This method supports RFC5789 patch semantics.
+Updates information in an existing table. The update method replaces the entire table resource, whereas the patch method only replaces fields that are provided in the submitted table resource. This method supports RFC5789 patch semantics. # IAM Permissions Requires the following IAM permission(s) on the table: - `bigquery.tables.update` - `bigquery.tables.get`
 */
 await gapi.client.bigquery.tables.patch({
   datasetId: 'datasetId',
@@ -444,7 +444,7 @@ Returns permissions that a caller has on the specified resource. If the resource
 await gapi.client.bigquery.tables.testIamPermissions({resource: 'resource'});
 
 /*
-Updates information in an existing table. The update method replaces the entire Table resource, whereas the patch method only replaces fields that are provided in the submitted Table resource.
+Updates information in an existing table. The update method replaces the entire Table resource, whereas the patch method only replaces fields that are provided in the submitted Table resource. # IAM Permissions Requires the `bigquery.tables.update` permission on the table.
 */
 await gapi.client.bigquery.tables.update({
   datasetId: 'datasetId',