@googleapis/storage 5.1.0 → 5.1.2

package/build/v1.d.ts

@@ -921,50 +921,6 @@ export declare namespace storage_v1 {
         constructor(context: APIRequestContext);
         /**
          * Permanently deletes the ACL entry for the specified entity on the specified bucket.
-         * @example
-         * ```js
-         * // Before running the sample:
-         * // - Enable the API at:
-         * //   https://console.developers.google.com/apis/api/storage.googleapis.com
-         * // - Login into gcloud by running:
-         * //   `$ gcloud auth application-default login`
-         * // - Install the npm module by running:
-         * //   `$ npm install googleapis`
-         *
-         * const {google} = require('googleapis');
-         * const storage = google.storage('v1');
-         *
-         * async function main() {
-         *   const auth = new google.auth.GoogleAuth({
-         *     // Scopes can be specified either as an array or as a single, space-delimited string.
-         *     scopes: [
-         *       'https://www.googleapis.com/auth/cloud-platform',
-         *       'https://www.googleapis.com/auth/devstorage.full_control',
-         *     ],
-         *   });
-         *
-         *   // Acquire an auth client, and bind it to all future calls
-         *   const authClient = await auth.getClient();
-         *   google.options({auth: authClient});
-         *
-         *   // Do the magic
-         *   const res = await storage.bucketAccessControls.delete({
-         *     // Name of a bucket.
-         *     bucket: 'placeholder-value',
-         *     // The entity holding the permission. Can be user-userId, user-emailAddress, group-groupId, group-emailAddress, allUsers, or allAuthenticatedUsers.
-         *     entity: 'placeholder-value',
-         *     // The project to be billed for this request. Required for Requester Pays buckets.
-         *     userProject: 'placeholder-value',
-         *   });
-         *   console.log(res.data);
-         * }
-         *
-         * main().catch(e => {
-         *   console.error(e);
-         *   throw e;
-         * });
-         *
-         * ```
          *
          * @param params - Parameters for request
          * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -979,65 +935,6 @@ export declare namespace storage_v1 {
         delete(callback: BodyResponseCallback<void>): void;
         /**
          * Returns the ACL entry for the specified entity on the specified bucket.
-         * @example
-         * ```js
-         * // Before running the sample:
-         * // - Enable the API at:
-         * //   https://console.developers.google.com/apis/api/storage.googleapis.com
-         * // - Login into gcloud by running:
-         * //   `$ gcloud auth application-default login`
-         * // - Install the npm module by running:
-         * //   `$ npm install googleapis`
-         *
-         * const {google} = require('googleapis');
-         * const storage = google.storage('v1');
-         *
-         * async function main() {
-         *   const auth = new google.auth.GoogleAuth({
-         *     // Scopes can be specified either as an array or as a single, space-delimited string.
-         *     scopes: [
-         *       'https://www.googleapis.com/auth/cloud-platform',
-         *       'https://www.googleapis.com/auth/devstorage.full_control',
-         *     ],
-         *   });
-         *
-         *   // Acquire an auth client, and bind it to all future calls
-         *   const authClient = await auth.getClient();
-         *   google.options({auth: authClient});
-         *
-         *   // Do the magic
-         *   const res = await storage.bucketAccessControls.get({
-         *     // Name of a bucket.
-         *     bucket: 'placeholder-value',
-         *     // The entity holding the permission. Can be user-userId, user-emailAddress, group-groupId, group-emailAddress, allUsers, or allAuthenticatedUsers.
-         *     entity: 'placeholder-value',
-         *     // The project to be billed for this request. Required for Requester Pays buckets.
-         *     userProject: 'placeholder-value',
-         *   });
-         *   console.log(res.data);
-         *
-         *   // Example response
-         *   // {
-         *   //   "bucket": "my_bucket",
-         *   //   "domain": "my_domain",
-         *   //   "email": "my_email",
-         *   //   "entity": "my_entity",
-         *   //   "entityId": "my_entityId",
-         *   //   "etag": "my_etag",
-         *   //   "id": "my_id",
-         *   //   "kind": "my_kind",
-         *   //   "projectTeam": {},
-         *   //   "role": "my_role",
-         *   //   "selfLink": "my_selfLink"
-         *   // }
-         * }
-         *
-         * main().catch(e => {
-         *   console.error(e);
-         *   throw e;
-         * });
-         *
-         * ```
          *
          * @param params - Parameters for request
          * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -1052,81 +949,6 @@ export declare namespace storage_v1 {
         get(callback: BodyResponseCallback<Schema$BucketAccessControl>): void;
         /**
          * Creates a new ACL entry on the specified bucket.
-         * @example
-         * ```js
-         * // Before running the sample:
-         * // - Enable the API at:
-         * //   https://console.developers.google.com/apis/api/storage.googleapis.com
-         * // - Login into gcloud by running:
-         * //   `$ gcloud auth application-default login`
-         * // - Install the npm module by running:
-         * //   `$ npm install googleapis`
-         *
-         * const {google} = require('googleapis');
-         * const storage = google.storage('v1');
-         *
-         * async function main() {
-         *   const auth = new google.auth.GoogleAuth({
-         *     // Scopes can be specified either as an array or as a single, space-delimited string.
-         *     scopes: [
-         *       'https://www.googleapis.com/auth/cloud-platform',
-         *       'https://www.googleapis.com/auth/devstorage.full_control',
-         *     ],
-         *   });
-         *
-         *   // Acquire an auth client, and bind it to all future calls
-         *   const authClient = await auth.getClient();
-         *   google.options({auth: authClient});
-         *
-         *   // Do the magic
-         *   const res = await storage.bucketAccessControls.insert({
-         *     // Name of a bucket.
-         *     bucket: 'placeholder-value',
-         *     // The project to be billed for this request. Required for Requester Pays buckets.
-         *     userProject: 'placeholder-value',
-         *
-         *     // Request body metadata
-         *     requestBody: {
-         *       // request body parameters
-         *       // {
-         *       //   "bucket": "my_bucket",
-         *       //   "domain": "my_domain",
-         *       //   "email": "my_email",
-         *       //   "entity": "my_entity",
-         *       //   "entityId": "my_entityId",
-         *       //   "etag": "my_etag",
-         *       //   "id": "my_id",
-         *       //   "kind": "my_kind",
-         *       //   "projectTeam": {},
-         *       //   "role": "my_role",
-         *       //   "selfLink": "my_selfLink"
-         *       // }
-         *     },
-         *   });
-         *   console.log(res.data);
-         *
-         *   // Example response
-         *   // {
-         *   //   "bucket": "my_bucket",
-         *   //   "domain": "my_domain",
-         *   //   "email": "my_email",
-         *   //   "entity": "my_entity",
-         *   //   "entityId": "my_entityId",
-         *   //   "etag": "my_etag",
-         *   //   "id": "my_id",
-         *   //   "kind": "my_kind",
-         *   //   "projectTeam": {},
-         *   //   "role": "my_role",
-         *   //   "selfLink": "my_selfLink"
-         *   // }
-         * }
-         *
-         * main().catch(e => {
-         *   console.error(e);
-         *   throw e;
-         * });
-         *
-         * ```
          *
          * @param params - Parameters for request
          * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -1141,54 +963,6 @@ export declare namespace storage_v1 {
         insert(callback: BodyResponseCallback<Schema$BucketAccessControl>): void;
         /**
          * Retrieves ACL entries on the specified bucket.
-         * @example
-         * ```js
-         * // Before running the sample:
-         * // - Enable the API at:
-         * //   https://console.developers.google.com/apis/api/storage.googleapis.com
-         * // - Login into gcloud by running:
-         * //   `$ gcloud auth application-default login`
-         * // - Install the npm module by running:
-         * //   `$ npm install googleapis`
-         *
-         * const {google} = require('googleapis');
-         * const storage = google.storage('v1');
-         *
-         * async function main() {
-         *   const auth = new google.auth.GoogleAuth({
-         *     // Scopes can be specified either as an array or as a single, space-delimited string.
-         *     scopes: [
-         *       'https://www.googleapis.com/auth/cloud-platform',
-         *       'https://www.googleapis.com/auth/devstorage.full_control',
-         *     ],
-         *   });
-         *
-         *   // Acquire an auth client, and bind it to all future calls
-         *   const authClient = await auth.getClient();
-         *   google.options({auth: authClient});
-         *
-         *   // Do the magic
-         *   const res = await storage.bucketAccessControls.list({
-         *     // Name of a bucket.
-         *     bucket: 'placeholder-value',
-         *     // The project to be billed for this request. Required for Requester Pays buckets.
-         *     userProject: 'placeholder-value',
-         *   });
-         *   console.log(res.data);
-         *
-         *   // Example response
-         *   // {
-         *   //   "items": [],
-         *   //   "kind": "my_kind"
-         *   // }
-         * }
-         *
-         * main().catch(e => {
-         *   console.error(e);
-         *   throw e;
-         * });
-         *
-         * ```
          *
          * @param params - Parameters for request
          * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -1203,83 +977,6 @@ export declare namespace storage_v1 {
         list(callback: BodyResponseCallback<Schema$BucketAccessControls>): void;
         /**
          * Patches an ACL entry on the specified bucket.
-         * @example
-         * ```js
-         * // Before running the sample:
-         * // - Enable the API at:
-         * //   https://console.developers.google.com/apis/api/storage.googleapis.com
-         * // - Login into gcloud by running:
-         * //   `$ gcloud auth application-default login`
-         * // - Install the npm module by running:
-         * //   `$ npm install googleapis`
-         *
-         * const {google} = require('googleapis');
-         * const storage = google.storage('v1');
-         *
-         * async function main() {
-         *   const auth = new google.auth.GoogleAuth({
-         *     // Scopes can be specified either as an array or as a single, space-delimited string.
-         *     scopes: [
-         *       'https://www.googleapis.com/auth/cloud-platform',
-         *       'https://www.googleapis.com/auth/devstorage.full_control',
-         *     ],
-         *   });
-         *
-         *   // Acquire an auth client, and bind it to all future calls
-         *   const authClient = await auth.getClient();
-         *   google.options({auth: authClient});
-         *
-         *   // Do the magic
-         *   const res = await storage.bucketAccessControls.patch({
-         *     // Name of a bucket.
-         *     bucket: 'placeholder-value',
-         *     // The entity holding the permission. Can be user-userId, user-emailAddress, group-groupId, group-emailAddress, allUsers, or allAuthenticatedUsers.
-         *     entity: 'placeholder-value',
-         *     // The project to be billed for this request. Required for Requester Pays buckets.
-         *     userProject: 'placeholder-value',
-         *
-         *     // Request body metadata
-         *     requestBody: {
-         *       // request body parameters
-         *       // {
-         *       //   "bucket": "my_bucket",
-         *       //   "domain": "my_domain",
-         *       //   "email": "my_email",
-         *       //   "entity": "my_entity",
-         *       //   "entityId": "my_entityId",
-         *       //   "etag": "my_etag",
-         *       //   "id": "my_id",
-         *       //   "kind": "my_kind",
-         *       //   "projectTeam": {},
-         *       //   "role": "my_role",
-         *       //   "selfLink": "my_selfLink"
-         *       // }
-         *     },
-         *   });
-         *   console.log(res.data);
-         *
-         *   // Example response
-         *   // {
-         *   //   "bucket": "my_bucket",
-         *   //   "domain": "my_domain",
-         *   //   "email": "my_email",
-         *   //   "entity": "my_entity",
-         *   //   "entityId": "my_entityId",
-         *   //   "etag": "my_etag",
-         *   //   "id": "my_id",
-         *   //   "kind": "my_kind",
-         *   //   "projectTeam": {},
-         *   //   "role": "my_role",
-         *   //   "selfLink": "my_selfLink"
-         *   // }
-         * }
-         *
-         * main().catch(e => {
-         *   console.error(e);
-         *   throw e;
-         * });
-         *
-         * ```
          *
          * @param params - Parameters for request
          * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -1294,83 +991,6 @@ export declare namespace storage_v1 {
         patch(callback: BodyResponseCallback<Schema$BucketAccessControl>): void;
         /**
          * Updates an ACL entry on the specified bucket.
-         * @example
-         * ```js
-         * // Before running the sample:
-         * // - Enable the API at:
-         * //   https://console.developers.google.com/apis/api/storage.googleapis.com
-         * // - Login into gcloud by running:
-         * //   `$ gcloud auth application-default login`
-         * // - Install the npm module by running:
-         * //   `$ npm install googleapis`
-         *
-         * const {google} = require('googleapis');
-         * const storage = google.storage('v1');
-         *
-         * async function main() {
-         *   const auth = new google.auth.GoogleAuth({
-         *     // Scopes can be specified either as an array or as a single, space-delimited string.
-         *     scopes: [
-         *       'https://www.googleapis.com/auth/cloud-platform',
-         *       'https://www.googleapis.com/auth/devstorage.full_control',
-         *     ],
-         *   });
-         *
-         *   // Acquire an auth client, and bind it to all future calls
-         *   const authClient = await auth.getClient();
-         *   google.options({auth: authClient});
-         *
-         *   // Do the magic
-         *   const res = await storage.bucketAccessControls.update({
-         *     // Name of a bucket.
-         *     bucket: 'placeholder-value',
-         *     // The entity holding the permission. Can be user-userId, user-emailAddress, group-groupId, group-emailAddress, allUsers, or allAuthenticatedUsers.
-         *     entity: 'placeholder-value',
-         *     // The project to be billed for this request. Required for Requester Pays buckets.
-         *     userProject: 'placeholder-value',
-         *
-         *     // Request body metadata
-         *     requestBody: {
-         *       // request body parameters
-         *       // {
-         *       //   "bucket": "my_bucket",
-         *       //   "domain": "my_domain",
-         *       //   "email": "my_email",
-         *       //   "entity": "my_entity",
-         *       //   "entityId": "my_entityId",
-         *       //   "etag": "my_etag",
-         *       //   "id": "my_id",
-         *       //   "kind": "my_kind",
-         *       //   "projectTeam": {},
-         *       //   "role": "my_role",
-         *       //   "selfLink": "my_selfLink"
-         *       // }
-         *     },
-         *   });
-         *   console.log(res.data);
-         *
-         *   // Example response
-         *   // {
-         *   //   "bucket": "my_bucket",
-         *   //   "domain": "my_domain",
-         *   //   "email": "my_email",
-         *   //   "entity": "my_entity",
-         *   //   "entityId": "my_entityId",
-         *   //   "etag": "my_etag",
-         *   //   "id": "my_id",
-         *   //   "kind": "my_kind",
-         *   //   "projectTeam": {},
-         *   //   "role": "my_role",
-         *   //   "selfLink": "my_selfLink"
-         *   // }
-         * }
-         *
-         * main().catch(e => {
-         *   console.error(e);
-         *   throw e;
-         * });
-         *
-         * ```
          *
          * @param params - Parameters for request
          * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -1477,53 +1097,6 @@ export declare namespace storage_v1 {
         constructor(context: APIRequestContext);
         /**
          * Permanently deletes an empty bucket.
-         * @example
-         * ```js
-         * // Before running the sample:
-         * // - Enable the API at:
-         * //   https://console.developers.google.com/apis/api/storage.googleapis.com
-         * // - Login into gcloud by running:
-         * //   `$ gcloud auth application-default login`
-         * // - Install the npm module by running:
-         * //   `$ npm install googleapis`
-         *
-         * const {google} = require('googleapis');
-         * const storage = google.storage('v1');
-         *
-         * async function main() {
-         *   const auth = new google.auth.GoogleAuth({
-         *     // Scopes can be specified either as an array or as a single, space-delimited string.
-         *     scopes: [
-         *       'https://www.googleapis.com/auth/cloud-platform',
-         *       'https://www.googleapis.com/auth/devstorage.full_control',
-         *       'https://www.googleapis.com/auth/devstorage.read_write',
-         *     ],
-         *   });
-         *
-         *   // Acquire an auth client, and bind it to all future calls
-         *   const authClient = await auth.getClient();
-         *   google.options({auth: authClient});
-         *
-         *   // Do the magic
-         *   const res = await storage.buckets.delete({
-         *     // Name of a bucket.
-         *     bucket: 'placeholder-value',
-         *     // If set, only deletes the bucket if its metageneration matches this value.
-         *     ifMetagenerationMatch: 'placeholder-value',
-         *     // If set, only deletes the bucket if its metageneration does not match this value.
-         *     ifMetagenerationNotMatch: 'placeholder-value',
-         *     // The project to be billed for this request. Required for Requester Pays buckets.
-         *     userProject: 'placeholder-value',
-         *   });
-         *   console.log(res.data);
-         * }
-         *
-         * main().catch(e => {
-         *   console.error(e);
-         *   throw e;
-         * });
-         *
-         * ```
          *
          * @param params - Parameters for request
          * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -1538,91 +1111,6 @@ export declare namespace storage_v1 {
         delete(callback: BodyResponseCallback<void>): void;
         /**
          * Returns metadata for the specified bucket.
-         * @example
-         * ```js
-         * // Before running the sample:
-         * // - Enable the API at:
-         * //   https://console.developers.google.com/apis/api/storage.googleapis.com
-         * // - Login into gcloud by running:
-         * //   `$ gcloud auth application-default login`
-         * // - Install the npm module by running:
-         * //   `$ npm install googleapis`
-         *
-         * const {google} = require('googleapis');
-         * const storage = google.storage('v1');
-         *
-         * async function main() {
-         *   const auth = new google.auth.GoogleAuth({
-         *     // Scopes can be specified either as an array or as a single, space-delimited string.
-         *     scopes: [
-         *       'https://www.googleapis.com/auth/cloud-platform',
-         *       'https://www.googleapis.com/auth/cloud-platform.read-only',
-         *       'https://www.googleapis.com/auth/devstorage.full_control',
-         *       'https://www.googleapis.com/auth/devstorage.read_only',
-         *       'https://www.googleapis.com/auth/devstorage.read_write',
-         *     ],
-         *   });
-         *
-         *   // Acquire an auth client, and bind it to all future calls
-         *   const authClient = await auth.getClient();
-         *   google.options({auth: authClient});
-         *
-         *   // Do the magic
-         *   const res = await storage.buckets.get({
-         *     // Name of a bucket.
-         *     bucket: 'placeholder-value',
-         *     // Makes the return of the bucket metadata conditional on whether the bucket's current metageneration matches the given value.
-         *     ifMetagenerationMatch: 'placeholder-value',
-         *     // Makes the return of the bucket metadata conditional on whether the bucket's current metageneration does not match the given value.
-         *     ifMetagenerationNotMatch: 'placeholder-value',
-         *     // Set of properties to return. Defaults to noAcl.
-         *     projection: 'placeholder-value',
-         *     // The project to be billed for this request. Required for Requester Pays buckets.
-         *     userProject: 'placeholder-value',
-         *   });
-         *   console.log(res.data);
-         *
-         *   // Example response
-         *   // {
-         *   //   "acl": [],
-         *   //   "autoclass": {},
-         *   //   "billing": {},
-         *   //   "cors": [],
-         *   //   "customPlacementConfig": {},
-         *   //   "defaultEventBasedHold": false,
-         *   //   "defaultObjectAcl": [],
-         *   //   "encryption": {},
-         *   //   "etag": "my_etag",
-         *   //   "iamConfiguration": {},
-         *   //   "id": "my_id",
-         *   //   "kind": "my_kind",
-         *   //   "labels": {},
-         *   //   "lifecycle": {},
-         *   //   "location": "my_location",
-         *   //   "locationType": "my_locationType",
-         *   //   "logging": {},
-         *   //   "metageneration": "my_metageneration",
-         *   //   "name": "my_name",
-         *   //   "owner": {},
-         *   //   "projectNumber": "my_projectNumber",
-         *   //   "retentionPolicy": {},
-         *   //   "rpo": "my_rpo",
-         *   //   "satisfiesPZS": false,
-         *   //   "selfLink": "my_selfLink",
-         *   //   "storageClass": "my_storageClass",
-         *   //   "timeCreated": "my_timeCreated",
-         *   //   "updated": "my_updated",
-         *   //   "versioning": {},
-         *   //   "website": {}
-         *   // }
-         * }
-         *
-         * main().catch(e => {
-         *   console.error(e);
-         *   throw e;
-         * });
-         *
-         * ```
          *
          * @param params - Parameters for request
          * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -1637,59 +1125,6 @@ export declare namespace storage_v1 {
         get(callback: BodyResponseCallback<Schema$Bucket>): void;
         /**
          * Returns an IAM policy for the specified bucket.
-         * @example
-         * ```js
-         * // Before running the sample:
-         * // - Enable the API at:
-         * //   https://console.developers.google.com/apis/api/storage.googleapis.com
-         * // - Login into gcloud by running:
-         * //   `$ gcloud auth application-default login`
-         * // - Install the npm module by running:
-         * //   `$ npm install googleapis`
-         *
-         * const {google} = require('googleapis');
-         * const storage = google.storage('v1');
-         *
-         * async function main() {
-         *   const auth = new google.auth.GoogleAuth({
-         *     // Scopes can be specified either as an array or as a single, space-delimited string.
-         *     scopes: [
-         *       'https://www.googleapis.com/auth/cloud-platform',
-         *       'https://www.googleapis.com/auth/devstorage.full_control',
-         *     ],
-         *   });
-         *
-         *   // Acquire an auth client, and bind it to all future calls
-         *   const authClient = await auth.getClient();
-         *   google.options({auth: authClient});
-         *
-         *   // Do the magic
-         *   const res = await storage.buckets.getIamPolicy({
-         *     // Name of a bucket.
-         *     bucket: 'placeholder-value',
-         *     // The IAM policy format version to be returned. If the optionsRequestedPolicyVersion is for an older version that doesn't support part of the requested IAM policy, the request fails.
-         *     optionsRequestedPolicyVersion: 'placeholder-value',
-         *     // The project to be billed for this request. Required for Requester Pays buckets.
-         *     userProject: 'placeholder-value',
-         *   });
-         *   console.log(res.data);
-         *
-         *   // Example response
-         *   // {
-         *   //   "bindings": [],
-         *   //   "etag": "my_etag",
-         *   //   "kind": "my_kind",
-         *   //   "resourceId": "my_resourceId",
-         *   //   "version": 0
-         *   // }
-         * }
-         *
-         * main().catch(e => {
-         *   console.error(e);
-         *   throw e;
-         * });
-         *
-         * ```
          *
          * @param params - Parameters for request
          * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -1704,126 +1139,6 @@ export declare namespace storage_v1 {
         getIamPolicy(callback: BodyResponseCallback<Schema$Policy>): void;
         /**
          * Creates a new bucket.
-         * @example
-         * ```js
-         * // Before running the sample:
-         * // - Enable the API at:
-         * //   https://console.developers.google.com/apis/api/storage.googleapis.com
-         * // - Login into gcloud by running:
-         * //   `$ gcloud auth application-default login`
-         * // - Install the npm module by running:
-         * //   `$ npm install googleapis`
-         *
-         * const {google} = require('googleapis');
-         * const storage = google.storage('v1');
-         *
-         * async function main() {
-         *   const auth = new google.auth.GoogleAuth({
-         *     // Scopes can be specified either as an array or as a single, space-delimited string.
-         *     scopes: [
-         *       'https://www.googleapis.com/auth/cloud-platform',
-         *       'https://www.googleapis.com/auth/devstorage.full_control',
-         *       'https://www.googleapis.com/auth/devstorage.read_write',
-         *     ],
-         *   });
-         *
-         *   // Acquire an auth client, and bind it to all future calls
-         *   const authClient = await auth.getClient();
-         *   google.options({auth: authClient});
-         *
-         *   // Do the magic
-         *   const res = await storage.buckets.insert({
-         *     // Apply a predefined set of access controls to this bucket.
-         *     predefinedAcl: 'placeholder-value',
-         *     // Apply a predefined set of default object access controls to this bucket.
-         *     predefinedDefaultObjectAcl: 'placeholder-value',
-         *     // A valid API project identifier.
-         *     project: 'placeholder-value',
-         *     // Set of properties to return. Defaults to noAcl, unless the bucket resource specifies acl or defaultObjectAcl properties, when it defaults to full.
-         *     projection: 'placeholder-value',
-         *     // The project to be billed for this request.
-         *     userProject: 'placeholder-value',
-         *
-         *     // Request body metadata
-         *     requestBody: {
-         *       // request body parameters
-         *       // {
-         *       //   "acl": [],
-         *       //   "autoclass": {},
-         *       //   "billing": {},
-         *       //   "cors": [],
-         *       //   "customPlacementConfig": {},
-         *       //   "defaultEventBasedHold": false,
-         *       //   "defaultObjectAcl": [],
-         *       //   "encryption": {},
-         *       //   "etag": "my_etag",
-         *       //   "iamConfiguration": {},
-         *       //   "id": "my_id",
-         *       //   "kind": "my_kind",
-         *       //   "labels": {},
-         *       //   "lifecycle": {},
-         *       //   "location": "my_location",
-         *       //   "locationType": "my_locationType",
-         *       //   "logging": {},
-         *       //   "metageneration": "my_metageneration",
-         *       //   "name": "my_name",
-         *       //   "owner": {},
-         *       //   "projectNumber": "my_projectNumber",
-         *       //   "retentionPolicy": {},
-         *       //   "rpo": "my_rpo",
-         *       //   "satisfiesPZS": false,
-         *       //   "selfLink": "my_selfLink",
-         *       //   "storageClass": "my_storageClass",
-         *       //   "timeCreated": "my_timeCreated",
-         *       //   "updated": "my_updated",
-         *       //   "versioning": {},
-         *       //   "website": {}
-         *       // }
-         *     },
-         *   });
-         *   console.log(res.data);
-         *
-         *   // Example response
-         *   // {
-         *   //   "acl": [],
-         *   //   "autoclass": {},
-         *   //   "billing": {},
-         *   //   "cors": [],
-         *   //   "customPlacementConfig": {},
-         *   //   "defaultEventBasedHold": false,
-         *   //   "defaultObjectAcl": [],
-         *   //   "encryption": {},
-         *   //   "etag": "my_etag",
-         *   //   "iamConfiguration": {},
-         *   //   "id": "my_id",
-         *   //   "kind": "my_kind",
-         *   //   "labels": {},
-         *   //   "lifecycle": {},
-         *   //   "location": "my_location",
-         *   //   "locationType": "my_locationType",
-         *   //   "logging": {},
-         *   //   "metageneration": "my_metageneration",
-         *   //   "name": "my_name",
-         *   //   "owner": {},
-         *   //   "projectNumber": "my_projectNumber",
-         *   //   "retentionPolicy": {},
-         *   //   "rpo": "my_rpo",
-         *   //   "satisfiesPZS": false,
-         *   //   "selfLink": "my_selfLink",
-         *   //   "storageClass": "my_storageClass",
-         *   //   "timeCreated": "my_timeCreated",
-         *   //   "updated": "my_updated",
-         *   //   "versioning": {},
-         *   //   "website": {}
-         *   // }
-         * }
-         *
-         * main().catch(e => {
-         *   console.error(e);
-         *   throw e;
-         * });
-         *
-         * ```
          *
          * @param params - Parameters for request
          * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -1838,66 +1153,6 @@ export declare namespace storage_v1 {
         insert(callback: BodyResponseCallback<Schema$Bucket>): void;
         /**
          * Retrieves a list of buckets for a given project.
-         * @example
-         * ```js
-         * // Before running the sample:
-         * // - Enable the API at:
-         * //   https://console.developers.google.com/apis/api/storage.googleapis.com
-         * // - Login into gcloud by running:
-         * //   `$ gcloud auth application-default login`
-         * // - Install the npm module by running:
-         * //   `$ npm install googleapis`
-         *
-         * const {google} = require('googleapis');
-         * const storage = google.storage('v1');
-         *
-         * async function main() {
-         *   const auth = new google.auth.GoogleAuth({
-         *     // Scopes can be specified either as an array or as a single, space-delimited string.
-         *     scopes: [
-         *       'https://www.googleapis.com/auth/cloud-platform',
-         *       'https://www.googleapis.com/auth/cloud-platform.read-only',
-         *       'https://www.googleapis.com/auth/devstorage.full_control',
-         *       'https://www.googleapis.com/auth/devstorage.read_only',
-         *       'https://www.googleapis.com/auth/devstorage.read_write',
-         *     ],
-         *   });
-         *
-         *   // Acquire an auth client, and bind it to all future calls
-         *   const authClient = await auth.getClient();
-         *   google.options({auth: authClient});
-         *
-         *   // Do the magic
-         *   const res = await storage.buckets.list({
-         *     // Maximum number of buckets to return in a single response. The service will use this parameter or 1,000 items, whichever is smaller.
-         *     maxResults: 'placeholder-value',
-         *     // A previously-returned page token representing part of the larger set of results to view.
-         *     pageToken: 'placeholder-value',
-         *     // Filter results to buckets whose names begin with this prefix.
-         *     prefix: 'placeholder-value',
-         *     // A valid API project identifier.
-         *     project: 'placeholder-value',
-         *     // Set of properties to return. Defaults to noAcl.
-         *     projection: 'placeholder-value',
-         *     // The project to be billed for this request.
-         *     userProject: 'placeholder-value',
-         *   });
-         *   console.log(res.data);
-         *
-         *   // Example response
-         *   // {
-         *   //   "items": [],
-         *   //   "kind": "my_kind",
-         *   //   "nextPageToken": "my_nextPageToken"
-         *   // }
-         * }
-         *
-         * main().catch(e => {
-         *   console.error(e);
-         *   throw e;
-         * });
-         *
-         * ```
          *
          * @param params - Parameters for request
          * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -1912,85 +1167,6 @@ export declare namespace storage_v1 {
         list(callback: BodyResponseCallback<Schema$Buckets>): void;
         /**
          * Locks retention policy on a bucket.
-         * @example
-         * ```js
-         * // Before running the sample:
-         * // - Enable the API at:
-         * //   https://console.developers.google.com/apis/api/storage.googleapis.com
-         * // - Login into gcloud by running:
-         * //   `$ gcloud auth application-default login`
-         * // - Install the npm module by running:
-         * //   `$ npm install googleapis`
-         *
-         * const {google} = require('googleapis');
-         * const storage = google.storage('v1');
-         *
-         * async function main() {
-         *   const auth = new google.auth.GoogleAuth({
-         *     // Scopes can be specified either as an array or as a single, space-delimited string.
-         *     scopes: [
-         *       'https://www.googleapis.com/auth/cloud-platform',
-         *       'https://www.googleapis.com/auth/devstorage.full_control',
-         *       'https://www.googleapis.com/auth/devstorage.read_write',
-         *     ],
-         *   });
-         *
-         *   // Acquire an auth client, and bind it to all future calls
-         *   const authClient = await auth.getClient();
-         *   google.options({auth: authClient});
-         *
-         *   // Do the magic
-         *   const res = await storage.buckets.lockRetentionPolicy({
-         *     // Name of a bucket.
-         *     bucket: 'placeholder-value',
-         *     // Makes the operation conditional on whether bucket's current metageneration matches the given value.
-         *     ifMetagenerationMatch: 'placeholder-value',
-         *     // The project to be billed for this request. Required for Requester Pays buckets.
-         *     userProject: 'placeholder-value',
-         *   });
-         *   console.log(res.data);
-         *
-         *   // Example response
-         *   // {
-         *   //   "acl": [],
-         *   //   "autoclass": {},
-         *   //   "billing": {},
-         *   //   "cors": [],
-         *   //   "customPlacementConfig": {},
-         *   //   "defaultEventBasedHold": false,
-         *   //   "defaultObjectAcl": [],
-         *   //   "encryption": {},
-         *   //   "etag": "my_etag",
-         *   //   "iamConfiguration": {},
-         *   //   "id": "my_id",
-         *   //   "kind": "my_kind",
-         *   //   "labels": {},
-         *   //   "lifecycle": {},
-         *   //   "location": "my_location",
-         *   //   "locationType": "my_locationType",
-         *   //   "logging": {},
-         *   //   "metageneration": "my_metageneration",
-         *   //   "name": "my_name",
-         *   //   "owner": {},
-         *   //   "projectNumber": "my_projectNumber",
-         *   //   "retentionPolicy": {},
-         *   //   "rpo": "my_rpo",
-         *   //   "satisfiesPZS": false,
-         *   //   "selfLink": "my_selfLink",
-         *   //   "storageClass": "my_storageClass",
-         *   //   "timeCreated": "my_timeCreated",
-         *   //   "updated": "my_updated",
-         *   //   "versioning": {},
-         *   //   "website": {}
-         *   // }
-         * }
-         *
-         * main().catch(e => {
-         *   console.error(e);
-         *   throw e;
-         * });
-         *
-         * ```
          *
          * @param params - Parameters for request
          * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -2005,129 +1181,6 @@ export declare namespace storage_v1 {
         lockRetentionPolicy(callback: BodyResponseCallback<Schema$Bucket>): void;
         /**
          * Patches a bucket. Changes to the bucket will be readable immediately after writing, but configuration changes may take time to propagate.
-         * @example
-         * ```js
-         * // Before running the sample:
-         * // - Enable the API at:
-         * //   https://console.developers.google.com/apis/api/storage.googleapis.com
-         * // - Login into gcloud by running:
-         * //   `$ gcloud auth application-default login`
-         * // - Install the npm module by running:
-         * //   `$ npm install googleapis`
-         *
-         * const {google} = require('googleapis');
-         * const storage = google.storage('v1');
-         *
-         * async function main() {
-         *   const auth = new google.auth.GoogleAuth({
-         *     // Scopes can be specified either as an array or as a single, space-delimited string.
-         *     scopes: [
-         *       'https://www.googleapis.com/auth/cloud-platform',
-         *       'https://www.googleapis.com/auth/devstorage.full_control',
-         *     ],
-         *   });
-         *
-         *   // Acquire an auth client, and bind it to all future calls
-         *   const authClient = await auth.getClient();
-         *   google.options({auth: authClient});
-         *
-         *   // Do the magic
-         *   const res = await storage.buckets.patch({
-         *     // Name of a bucket.
-         *     bucket: 'placeholder-value',
-         *     // Makes the return of the bucket metadata conditional on whether the bucket's current metageneration matches the given value.
-         *     ifMetagenerationMatch: 'placeholder-value',
-         *     // Makes the return of the bucket metadata conditional on whether the bucket's current metageneration does not match the given value.
-         *     ifMetagenerationNotMatch: 'placeholder-value',
-         *     // Apply a predefined set of access controls to this bucket.
-         *     predefinedAcl: 'placeholder-value',
-         *     // Apply a predefined set of default object access controls to this bucket.
-         *     predefinedDefaultObjectAcl: 'placeholder-value',
-         *     // Set of properties to return. Defaults to full.
-         *     projection: 'placeholder-value',
-         *     // The project to be billed for this request. Required for Requester Pays buckets.
-         *     userProject: 'placeholder-value',
-         *
-         *     // Request body metadata
-         *     requestBody: {
-         *       // request body parameters
-         *       // {
-         *       //   "acl": [],
-         *       //   "autoclass": {},
-         *       //   "billing": {},
-         *       //   "cors": [],
-         *       //   "customPlacementConfig": {},
-         *       //   "defaultEventBasedHold": false,
-         *       //   "defaultObjectAcl": [],
-         *       //   "encryption": {},
-         *       //   "etag": "my_etag",
-         *       //   "iamConfiguration": {},
-         *       //   "id": "my_id",
-         *       //   "kind": "my_kind",
-         *       //   "labels": {},
-         *       //   "lifecycle": {},
-         *       //   "location": "my_location",
-         *       //   "locationType": "my_locationType",
-         *       //   "logging": {},
-         *       //   "metageneration": "my_metageneration",
-         *       //   "name": "my_name",
-         *       //   "owner": {},
-         *       //   "projectNumber": "my_projectNumber",
-         *       //   "retentionPolicy": {},
-         *       //   "rpo": "my_rpo",
-         *       //   "satisfiesPZS": false,
-         *       //   "selfLink": "my_selfLink",
-         *       //   "storageClass": "my_storageClass",
-         *       //   "timeCreated": "my_timeCreated",
-         *       //   "updated": "my_updated",
-         *       //   "versioning": {},
-         *       //   "website": {}
-         *       // }
-         *     },
-         *   });
-         *   console.log(res.data);
-         *
-         *   // Example response
-         *   // {
-         *   //   "acl": [],
-         *   //   "autoclass": {},
-         *   //   "billing": {},
-         *   //   "cors": [],
-         *   //   "customPlacementConfig": {},
-         *   //   "defaultEventBasedHold": false,
-         *   //   "defaultObjectAcl": [],
-         *   //   "encryption": {},
-         *   //   "etag": "my_etag",
-         *   //   "iamConfiguration": {},
-         *   //   "id": "my_id",
-         *   //   "kind": "my_kind",
-         *   //   "labels": {},
-         *   //   "lifecycle": {},
-         *   //   "location": "my_location",
-         *   //   "locationType": "my_locationType",
-         *   //   "logging": {},
-         *   //   "metageneration": "my_metageneration",
-         *   //   "name": "my_name",
-         *   //   "owner": {},
-         *   //   "projectNumber": "my_projectNumber",
-         *   //   "retentionPolicy": {},
-         *   //   "rpo": "my_rpo",
-         *   //   "satisfiesPZS": false,
-         *   //   "selfLink": "my_selfLink",
-         *   //   "storageClass": "my_storageClass",
-         *   //   "timeCreated": "my_timeCreated",
-         *   //   "updated": "my_updated",
-         *   //   "versioning": {},
-         *   //   "website": {}
-         *   // }
-         * }
-         *
-         * main().catch(e => {
-         *   console.error(e);
-         *   throw e;
-         * });
-         *
-         * ```
          *
          * @param params - Parameters for request
          * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -2142,69 +1195,6 @@ export declare namespace storage_v1 {
         patch(callback: BodyResponseCallback<Schema$Bucket>): void;
         /**
          * Updates an IAM policy for the specified bucket.
-         * @example
-         * ```js
-         * // Before running the sample:
-         * // - Enable the API at:
-         * //   https://console.developers.google.com/apis/api/storage.googleapis.com
-         * // - Login into gcloud by running:
-         * //   `$ gcloud auth application-default login`
-         * // - Install the npm module by running:
-         * //   `$ npm install googleapis`
-         *
-         * const {google} = require('googleapis');
-         * const storage = google.storage('v1');
-         *
-         * async function main() {
-         *   const auth = new google.auth.GoogleAuth({
-         *     // Scopes can be specified either as an array or as a single, space-delimited string.
-         *     scopes: [
-         *       'https://www.googleapis.com/auth/cloud-platform',
-         *       'https://www.googleapis.com/auth/devstorage.full_control',
-         *     ],
-         *   });
-         *
-         *   // Acquire an auth client, and bind it to all future calls
-         *   const authClient = await auth.getClient();
-         *   google.options({auth: authClient});
-         *
-         *   // Do the magic
-         *   const res = await storage.buckets.setIamPolicy({
-         *     // Name of a bucket.
-         *     bucket: 'placeholder-value',
-         *     // The project to be billed for this request. Required for Requester Pays buckets.
-         *     userProject: 'placeholder-value',
-         *
-         *     // Request body metadata
-         *     requestBody: {
-         *       // request body parameters
-         *       // {
-         *       //   "bindings": [],
-         *       //   "etag": "my_etag",
-         *       //   "kind": "my_kind",
-         *       //   "resourceId": "my_resourceId",
-         *       //   "version": 0
-         *       // }
-         *     },
-         *   });
-         *   console.log(res.data);
-         *
-         *   // Example response
-         *   // {
-         *   //   "bindings": [],
-         *   //   "etag": "my_etag",
-         *   //   "kind": "my_kind",
-         *   //   "resourceId": "my_resourceId",
-         *   //   "version": 0
-         *   // }
-         * }
-         *
-         * main().catch(e => {
-         *   console.error(e);
-         *   throw e;
-         * });
-         *
-         * ```
          *
          * @param params - Parameters for request
          * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -2219,59 +1209,6 @@ export declare namespace storage_v1 {
         setIamPolicy(callback: BodyResponseCallback<Schema$Policy>): void;
         /**
          * Tests a set of permissions on the given bucket to see which, if any, are held by the caller.
-         * @example
-         * ```js
-         * // Before running the sample:
-         * // - Enable the API at:
-         * //   https://console.developers.google.com/apis/api/storage.googleapis.com
-         * // - Login into gcloud by running:
-         * //   `$ gcloud auth application-default login`
-         * // - Install the npm module by running:
-         * //   `$ npm install googleapis`
-         *
-         * const {google} = require('googleapis');
-         * const storage = google.storage('v1');
-         *
-         * async function main() {
-         *   const auth = new google.auth.GoogleAuth({
-         *     // Scopes can be specified either as an array or as a single, space-delimited string.
-         *     scopes: [
-         *       'https://www.googleapis.com/auth/cloud-platform',
-         *       'https://www.googleapis.com/auth/cloud-platform.read-only',
-         *       'https://www.googleapis.com/auth/devstorage.full_control',
-         *       'https://www.googleapis.com/auth/devstorage.read_only',
-         *       'https://www.googleapis.com/auth/devstorage.read_write',
-         *     ],
-         *   });
-         *
-         *   // Acquire an auth client, and bind it to all future calls
-         *   const authClient = await auth.getClient();
-         *   google.options({auth: authClient});
-         *
-         *   // Do the magic
-         *   const res = await storage.buckets.testIamPermissions({
-         *     // Name of a bucket.
-         *     bucket: 'placeholder-value',
-         *     // Permissions to test.
-         *     permissions: 'placeholder-value',
-         *     // The project to be billed for this request. Required for Requester Pays buckets.
-         *     userProject: 'placeholder-value',
-         *   });
-         *   console.log(res.data);
-         *
-         *   // Example response
-         *   // {
-         *   //   "kind": "my_kind",
-         *   //   "permissions": []
-         *   // }
-         * }
-         *
-         * main().catch(e => {
-         *   console.error(e);
-         *   throw e;
-         * });
-         *
-         * ```
          *
          * @param params - Parameters for request
          * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -2286,129 +1223,6 @@ export declare namespace storage_v1 {
         testIamPermissions(callback: BodyResponseCallback<Schema$TestIamPermissionsResponse>): void;
         /**
          * Updates a bucket. Changes to the bucket will be readable immediately after writing, but configuration changes may take time to propagate.
-         * @example
-         * ```js
-         * // Before running the sample:
-         * // - Enable the API at:
-         * //   https://console.developers.google.com/apis/api/storage.googleapis.com
-         * // - Login into gcloud by running:
-         * //   `$ gcloud auth application-default login`
-         * // - Install the npm module by running:
-         * //   `$ npm install googleapis`
-         *
-         * const {google} = require('googleapis');
-         * const storage = google.storage('v1');
-         *
-         * async function main() {
-         *   const auth = new google.auth.GoogleAuth({
-         *     // Scopes can be specified either as an array or as a single, space-delimited string.
-         *     scopes: [
-         *       'https://www.googleapis.com/auth/cloud-platform',
-         *       'https://www.googleapis.com/auth/devstorage.full_control',
-         *     ],
-         *   });
-         *
-         *   // Acquire an auth client, and bind it to all future calls
-         *   const authClient = await auth.getClient();
-         *   google.options({auth: authClient});
-         *
-         *   // Do the magic
-         *   const res = await storage.buckets.update({
-         *     // Name of a bucket.
-         *     bucket: 'placeholder-value',
-         *     // Makes the return of the bucket metadata conditional on whether the bucket's current metageneration matches the given value.
-         *     ifMetagenerationMatch: 'placeholder-value',
-         *     // Makes the return of the bucket metadata conditional on whether the bucket's current metageneration does not match the given value.
-         *     ifMetagenerationNotMatch: 'placeholder-value',
-         *     // Apply a predefined set of access controls to this bucket.
-         *     predefinedAcl: 'placeholder-value',
-         *     // Apply a predefined set of default object access controls to this bucket.
-         *     predefinedDefaultObjectAcl: 'placeholder-value',
-         *     // Set of properties to return. Defaults to full.
-         *     projection: 'placeholder-value',
-         *     // The project to be billed for this request. Required for Requester Pays buckets.
-         *     userProject: 'placeholder-value',
-         *
-         *     // Request body metadata
-         *     requestBody: {
-         *       // request body parameters
-         *       // {
-         *       //   "acl": [],
-         *       //   "autoclass": {},
-         *       //   "billing": {},
-         *       //   "cors": [],
-         *       //   "customPlacementConfig": {},
-         *       //   "defaultEventBasedHold": false,
-         *       //   "defaultObjectAcl": [],
-         *       //   "encryption": {},
-         *       //   "etag": "my_etag",
-         *       //   "iamConfiguration": {},
-         *       //   "id": "my_id",
-         *       //   "kind": "my_kind",
-         *       //   "labels": {},
-         *       //   "lifecycle": {},
-         *       //   "location": "my_location",
-         *       //   "locationType": "my_locationType",
-         *       //   "logging": {},
-         *       //   "metageneration": "my_metageneration",
-         *       //   "name": "my_name",
-         *       //   "owner": {},
-         *       //   "projectNumber": "my_projectNumber",
-         *       //   "retentionPolicy": {},
-         *       //   "rpo": "my_rpo",
-         *       //   "satisfiesPZS": false,
-         *       //   "selfLink": "my_selfLink",
-         *       //   "storageClass": "my_storageClass",
-         *       //   "timeCreated": "my_timeCreated",
-         *       //   "updated": "my_updated",
-         *       //   "versioning": {},
-         *       //   "website": {}
-         *       // }
-         *     },
-         *   });
-         *   console.log(res.data);
-         *
-         *   // Example response
-         *   // {
-         *   //   "acl": [],
-         *   //   "autoclass": {},
-         *   //   "billing": {},
-         *   //   "cors": [],
-         *   //   "customPlacementConfig": {},
-         *   //   "defaultEventBasedHold": false,
-         *   //   "defaultObjectAcl": [],
-         *   //   "encryption": {},
-         *   //   "etag": "my_etag",
-         *   //   "iamConfiguration": {},
-         *   //   "id": "my_id",
-         *   //   "kind": "my_kind",
-         *   //   "labels": {},
-         *   //   "lifecycle": {},
-         *   //   "location": "my_location",
-         *   //   "locationType": "my_locationType",
-         *   //   "logging": {},
-         *   //   "metageneration": "my_metageneration",
-         *   //   "name": "my_name",
-         *   //   "owner": {},
-         *   //   "projectNumber": "my_projectNumber",
-         *   //   "retentionPolicy": {},
-         *   //   "rpo": "my_rpo",
-         *   //   "satisfiesPZS": false,
-         *   //   "selfLink": "my_selfLink",
-         *   //   "storageClass": "my_storageClass",
-         *   //   "timeCreated": "my_timeCreated",
-         *   //   "updated": "my_updated",
-         *   //   "versioning": {},
-         *   //   "website": {}
-         *   // }
-         * }
-         *
-         * main().catch(e => {
-         *   console.error(e);
-         *   throw e;
-         * });
-         *
-         * ```
          *
          * @param params - Parameters for request
          * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -2643,63 +1457,6 @@ export declare namespace storage_v1 {
         constructor(context: APIRequestContext);
         /**
          * Stop watching resources through this channel
-         * @example
-         * ```js
-         * // Before running the sample:
-         * // - Enable the API at:
-         * //   https://console.developers.google.com/apis/api/storage.googleapis.com
-         * // - Login into gcloud by running:
-         * //   `$ gcloud auth application-default login`
-         * // - Install the npm module by running:
-         * //   `$ npm install googleapis`
-         *
-         * const {google} = require('googleapis');
-         * const storage = google.storage('v1');
-         *
-         * async function main() {
-         *   const auth = new google.auth.GoogleAuth({
-         *     // Scopes can be specified either as an array or as a single, space-delimited string.
-         *     scopes: [
-         *       'https://www.googleapis.com/auth/cloud-platform',
-         *       'https://www.googleapis.com/auth/cloud-platform.read-only',
-         *       'https://www.googleapis.com/auth/devstorage.full_control',
-         *       'https://www.googleapis.com/auth/devstorage.read_only',
-         *       'https://www.googleapis.com/auth/devstorage.read_write',
-         *     ],
-         *   });
-         *
-         *   // Acquire an auth client, and bind it to all future calls
-         *   const authClient = await auth.getClient();
-         *   google.options({auth: authClient});
-         *
-         *   // Do the magic
-         *   const res = await storage.channels.stop({
-         *     // Request body metadata
-         *     requestBody: {
-         *       // request body parameters
-         *       // {
-         *       //   "address": "my_address",
-         *       //   "expiration": "my_expiration",
-         *       //   "id": "my_id",
-         *       //   "kind": "my_kind",
-         *       //   "params": {},
-         *       //   "payload": false,
-         *       //   "resourceId": "my_resourceId",
-         *       //   "resourceUri": "my_resourceUri",
-         *       //   "token": "my_token",
-         *       //   "type": "my_type"
-         *       // }
-         *     },
-         *   });
-         *   console.log(res.data);
-         * }
-         *
-         * main().catch(e => {
-         *   console.error(e);
-         *   throw e;
-         * });
-         *
-         * ```
          *
          * @param params - Parameters for request
          * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -2724,50 +1481,6 @@ export declare namespace storage_v1 {
         constructor(context: APIRequestContext);
         /**
          * Permanently deletes the default object ACL entry for the specified entity on the specified bucket.
-         * @example
-         * ```js
-         * // Before running the sample:
-         * // - Enable the API at:
-         * //   https://console.developers.google.com/apis/api/storage.googleapis.com
-         * // - Login into gcloud by running:
-         * //   `$ gcloud auth application-default login`
-         * // - Install the npm module by running:
-         * //   `$ npm install googleapis`
-         *
-         * const {google} = require('googleapis');
-         * const storage = google.storage('v1');
-         *
-         * async function main() {
-         *   const auth = new google.auth.GoogleAuth({
-         *     // Scopes can be specified either as an array or as a single, space-delimited string.
-         *     scopes: [
-         *       'https://www.googleapis.com/auth/cloud-platform',
-         *       'https://www.googleapis.com/auth/devstorage.full_control',
-         *     ],
-         *   });
-         *
-         *   // Acquire an auth client, and bind it to all future calls
-         *   const authClient = await auth.getClient();
-         *   google.options({auth: authClient});
-         *
-         *   // Do the magic
-         *   const res = await storage.defaultObjectAccessControls.delete({
-         *     // Name of a bucket.
-         *     bucket: 'placeholder-value',
-         *     // The entity holding the permission. Can be user-userId, user-emailAddress, group-groupId, group-emailAddress, allUsers, or allAuthenticatedUsers.
-         *     entity: 'placeholder-value',
-         *     // The project to be billed for this request. Required for Requester Pays buckets.
-         *     userProject: 'placeholder-value',
-         *   });
-         *   console.log(res.data);
-         * }
-         *
-         * main().catch(e => {
-         *   console.error(e);
-         *   throw e;
-         * });
-         *
-         * ```
          *
          * @param params - Parameters for request
          * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -2782,67 +1495,6 @@ export declare namespace storage_v1 {
         delete(callback: BodyResponseCallback<void>): void;
         /**
          * Returns the default object ACL entry for the specified entity on the specified bucket.
-         * @example
-         * ```js
-         * // Before running the sample:
-         * // - Enable the API at:
-         * //   https://console.developers.google.com/apis/api/storage.googleapis.com
-         * // - Login into gcloud by running:
-         * //   `$ gcloud auth application-default login`
-         * // - Install the npm module by running:
-         * //   `$ npm install googleapis`
-         *
-         * const {google} = require('googleapis');
-         * const storage = google.storage('v1');
-         *
-         * async function main() {
-         *   const auth = new google.auth.GoogleAuth({
-         *     // Scopes can be specified either as an array or as a single, space-delimited string.
-         *     scopes: [
-         *       'https://www.googleapis.com/auth/cloud-platform',
-         *       'https://www.googleapis.com/auth/devstorage.full_control',
-         *     ],
-         *   });
-         *
-         *   // Acquire an auth client, and bind it to all future calls
-         *   const authClient = await auth.getClient();
-         *   google.options({auth: authClient});
-         *
-         *   // Do the magic
-         *   const res = await storage.defaultObjectAccessControls.get({
-         *     // Name of a bucket.
-         *     bucket: 'placeholder-value',
-         *     // The entity holding the permission. Can be user-userId, user-emailAddress, group-groupId, group-emailAddress, allUsers, or allAuthenticatedUsers.
-         *     entity: 'placeholder-value',
-         *     // The project to be billed for this request. Required for Requester Pays buckets.
-         *     userProject: 'placeholder-value',
-         *   });
-         *   console.log(res.data);
-         *
-         *   // Example response
-         *   // {
-         *   //   "bucket": "my_bucket",
-         *   //   "domain": "my_domain",
-         *   //   "email": "my_email",
-         *   //   "entity": "my_entity",
-         *   //   "entityId": "my_entityId",
-         *   //   "etag": "my_etag",
-         *   //   "generation": "my_generation",
-         *   //   "id": "my_id",
-         *   //   "kind": "my_kind",
-         *   //   "object": "my_object",
-         *   //   "projectTeam": {},
-         *   //   "role": "my_role",
-         *   //   "selfLink": "my_selfLink"
-         *   // }
-         * }
-         *
-         * main().catch(e => {
-         *   console.error(e);
-         *   throw e;
-         * });
-         *
-         * ```
          *
          * @param params - Parameters for request
          * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -2857,85 +1509,6 @@ export declare namespace storage_v1 {
         get(callback: BodyResponseCallback<Schema$ObjectAccessControl>): void;
         /**
          * Creates a new default object ACL entry on the specified bucket.
-         * @example
-         * ```js
-         * // Before running the sample:
-         * // - Enable the API at:
-         * //   https://console.developers.google.com/apis/api/storage.googleapis.com
-         * // - Login into gcloud by running:
-         * //   `$ gcloud auth application-default login`
-         * // - Install the npm module by running:
-         * //   `$ npm install googleapis`
-         *
-         * const {google} = require('googleapis');
-         * const storage = google.storage('v1');
-         *
-         * async function main() {
-         *   const auth = new google.auth.GoogleAuth({
-         *     // Scopes can be specified either as an array or as a single, space-delimited string.
-         *     scopes: [
-         *       'https://www.googleapis.com/auth/cloud-platform',
-         *       'https://www.googleapis.com/auth/devstorage.full_control',
-         *     ],
-         *   });
-         *
-         *   // Acquire an auth client, and bind it to all future calls
-         *   const authClient = await auth.getClient();
-         *   google.options({auth: authClient});
-         *
-         *   // Do the magic
-         *   const res = await storage.defaultObjectAccessControls.insert({
-         *     // Name of a bucket.
-         *     bucket: 'placeholder-value',
-         *     // The project to be billed for this request. Required for Requester Pays buckets.
-         *     userProject: 'placeholder-value',
-         *
-         *     // Request body metadata
-         *     requestBody: {
-         *       // request body parameters
-         *       // {
-         *       //   "bucket": "my_bucket",
-         *       //   "domain": "my_domain",
-         *       //   "email": "my_email",
-         *       //   "entity": "my_entity",
-         *       //   "entityId": "my_entityId",
-         *       //   "etag": "my_etag",
-         *       //   "generation": "my_generation",
-         *       //   "id": "my_id",
-         *       //   "kind": "my_kind",
-         *       //   "object": "my_object",
-         *       //   "projectTeam": {},
-         *       //   "role": "my_role",
-         *       //   "selfLink": "my_selfLink"
-         *       // }
-         *     },
-         *   });
-         *   console.log(res.data);
-         *
-         *   // Example response
-         *   // {
-         *   //   "bucket": "my_bucket",
-         *   //   "domain": "my_domain",
-         *   //   "email": "my_email",
-         *   //   "entity": "my_entity",
-         *   //   "entityId": "my_entityId",
-         *   //   "etag": "my_etag",
-         *   //   "generation": "my_generation",
-         *   //   "id": "my_id",
-         *   //   "kind": "my_kind",
-         *   //   "object": "my_object",
-         *   //   "projectTeam": {},
-         *   //   "role": "my_role",
-         *   //   "selfLink": "my_selfLink"
-         *   // }
-         * }
-         *
-         * main().catch(e => {
-         *   console.error(e);
-         *   throw e;
-         * });
-         *
-         * ```
          *
          * @param params - Parameters for request
          * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -2950,58 +1523,6 @@ export declare namespace storage_v1 {
         insert(callback: BodyResponseCallback<Schema$ObjectAccessControl>): void;
         /**
          * Retrieves default object ACL entries on the specified bucket.
-         * @example
-         * ```js
-         * // Before running the sample:
-         * // - Enable the API at:
-         * //   https://console.developers.google.com/apis/api/storage.googleapis.com
-         * // - Login into gcloud by running:
-         * //   `$ gcloud auth application-default login`
-         * // - Install the npm module by running:
-         * //   `$ npm install googleapis`
-         *
-         * const {google} = require('googleapis');
-         * const storage = google.storage('v1');
-         *
-         * async function main() {
-         *   const auth = new google.auth.GoogleAuth({
-         *     // Scopes can be specified either as an array or as a single, space-delimited string.
-         *     scopes: [
-         *       'https://www.googleapis.com/auth/cloud-platform',
-         *       'https://www.googleapis.com/auth/devstorage.full_control',
-         *     ],
-         *   });
-         *
-         *   // Acquire an auth client, and bind it to all future calls
-         *   const authClient = await auth.getClient();
-         *   google.options({auth: authClient});
-         *
-         *   // Do the magic
-         *   const res = await storage.defaultObjectAccessControls.list({
-         *     // Name of a bucket.
-         *     bucket: 'placeholder-value',
-         *     // If present, only return default ACL listing if the bucket's current metageneration matches this value.
-         *     ifMetagenerationMatch: 'placeholder-value',
-         *     // If present, only return default ACL listing if the bucket's current metageneration does not match the given value.
-         *     ifMetagenerationNotMatch: 'placeholder-value',
-         *     // The project to be billed for this request. Required for Requester Pays buckets.
-         *     userProject: 'placeholder-value',
-         *   });
-         *   console.log(res.data);
-         *
-         *   // Example response
-         *   // {
-         *   //   "items": [],
-         *   //   "kind": "my_kind"
-         *   // }
-         * }
-         *
-         * main().catch(e => {
-         *   console.error(e);
-         *   throw e;
-         * });
-         *
-         * ```
          *
          * @param params - Parameters for request
          * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -3016,87 +1537,6 @@ export declare namespace storage_v1 {
         list(callback: BodyResponseCallback<Schema$ObjectAccessControls>): void;
         /**
          * Patches a default object ACL entry on the specified bucket.
-         * @example
-         * ```js
-         * // Before running the sample:
-         * // - Enable the API at:
-         * //   https://console.developers.google.com/apis/api/storage.googleapis.com
-         * // - Login into gcloud by running:
-         * //   `$ gcloud auth application-default login`
-         * // - Install the npm module by running:
-         * //   `$ npm install googleapis`
-         *
-         * const {google} = require('googleapis');
-         * const storage = google.storage('v1');
-         *
-         * async function main() {
-         *   const auth = new google.auth.GoogleAuth({
-         *     // Scopes can be specified either as an array or as a single, space-delimited string.
-         *     scopes: [
-         *       'https://www.googleapis.com/auth/cloud-platform',
-         *       'https://www.googleapis.com/auth/devstorage.full_control',
-         *     ],
-         *   });
-         *
-         *   // Acquire an auth client, and bind it to all future calls
-         *   const authClient = await auth.getClient();
-         *   google.options({auth: authClient});
-         *
-         *   // Do the magic
-         *   const res = await storage.defaultObjectAccessControls.patch({
-         *     // Name of a bucket.
-         *     bucket: 'placeholder-value',
-         *     // The entity holding the permission. Can be user-userId, user-emailAddress, group-groupId, group-emailAddress, allUsers, or allAuthenticatedUsers.
-         *     entity: 'placeholder-value',
-         *     // The project to be billed for this request. Required for Requester Pays buckets.
-         *     userProject: 'placeholder-value',
-         *
-         *     // Request body metadata
-         *     requestBody: {
-         *       // request body parameters
-         *       // {
-         *       //   "bucket": "my_bucket",
-         *       //   "domain": "my_domain",
-         *       //   "email": "my_email",
-         *       //   "entity": "my_entity",
-         *       //   "entityId": "my_entityId",
-         *       //   "etag": "my_etag",
-         *       //   "generation": "my_generation",
-         *       //   "id": "my_id",
-         *       //   "kind": "my_kind",
-         *       //   "object": "my_object",
-         *       //   "projectTeam": {},
-         *       //   "role": "my_role",
-         *       //   "selfLink": "my_selfLink"
-         *       // }
-         *     },
-         *   });
-         *   console.log(res.data);
-         *
-         *   // Example response
-         *   // {
-         *   //   "bucket": "my_bucket",
-         *   //   "domain": "my_domain",
-         *   //   "email": "my_email",
-         *   //   "entity": "my_entity",
-         *   //   "entityId": "my_entityId",
-         *   //   "etag": "my_etag",
-         *   //   "generation": "my_generation",
-         *   //   "id": "my_id",
-         *   //   "kind": "my_kind",
-         *   //   "object": "my_object",
-         *   //   "projectTeam": {},
-         *   //   "role": "my_role",
-         *   //   "selfLink": "my_selfLink"
-         *   // }
-         * }
-         *
-         * main().catch(e => {
-         *   console.error(e);
-         *   throw e;
-         * });
-         *
-         * ```
          *
          * @param params - Parameters for request
          * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -3111,87 +1551,6 @@ export declare namespace storage_v1 {
         patch(callback: BodyResponseCallback<Schema$ObjectAccessControl>): void;
         /**
          * Updates a default object ACL entry on the specified bucket.
-         * @example
-         * ```js
-         * // Before running the sample:
-         * // - Enable the API at:
-         * //   https://console.developers.google.com/apis/api/storage.googleapis.com
-         * // - Login into gcloud by running:
-         * //   `$ gcloud auth application-default login`
-         * // - Install the npm module by running:
-         * //   `$ npm install googleapis`
-         *
-         * const {google} = require('googleapis');
-         * const storage = google.storage('v1');
-         *
-         * async function main() {
-         *   const auth = new google.auth.GoogleAuth({
-         *     // Scopes can be specified either as an array or as a single, space-delimited string.
-         *     scopes: [
-         *       'https://www.googleapis.com/auth/cloud-platform',
-         *       'https://www.googleapis.com/auth/devstorage.full_control',
-         *     ],
-         *   });
-         *
-         *   // Acquire an auth client, and bind it to all future calls
-         *   const authClient = await auth.getClient();
-         *   google.options({auth: authClient});
-         *
-         *   // Do the magic
-         *   const res = await storage.defaultObjectAccessControls.update({
-         *     // Name of a bucket.
-         *     bucket: 'placeholder-value',
-         *     // The entity holding the permission. Can be user-userId, user-emailAddress, group-groupId, group-emailAddress, allUsers, or allAuthenticatedUsers.
-         *     entity: 'placeholder-value',
-         *     // The project to be billed for this request. Required for Requester Pays buckets.
-         *     userProject: 'placeholder-value',
-         *
-         *     // Request body metadata
-         *     requestBody: {
-         *       // request body parameters
-         *       // {
-         *       //   "bucket": "my_bucket",
-         *       //   "domain": "my_domain",
-         *       //   "email": "my_email",
-         *       //   "entity": "my_entity",
-         *       //   "entityId": "my_entityId",
-         *       //   "etag": "my_etag",
-         *       //   "generation": "my_generation",
-         *       //   "id": "my_id",
-         *       //   "kind": "my_kind",
-         *       //   "object": "my_object",
-         *       //   "projectTeam": {},
-         *       //   "role": "my_role",
-         *       //   "selfLink": "my_selfLink"
-         *       // }
-         *     },
-         *   });
-         *   console.log(res.data);
-         *
-         *   // Example response
-         *   // {
-         *   //   "bucket": "my_bucket",
-         *   //   "domain": "my_domain",
-         *   //   "email": "my_email",
-         *   //   "entity": "my_entity",
-         *   //   "entityId": "my_entityId",
-         *   //   "etag": "my_etag",
-         *   //   "generation": "my_generation",
-         *   //   "id": "my_id",
-         *   //   "kind": "my_kind",
-         *   //   "object": "my_object",
-         *   //   "projectTeam": {},
-         *   //   "role": "my_role",
-         *   //   "selfLink": "my_selfLink"
-         *   // }
-         * }
-         *
-         * main().catch(e => {
-         *   console.error(e);
-         *   throw e;
-         * });
-         *
-         * ```
          *
          * @param params - Parameters for request
          * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -3306,51 +1665,6 @@ export declare namespace storage_v1 {
         constructor(context: APIRequestContext);
         /**
          * Permanently deletes a notification subscription.
-         * @example
-         * ```js
-         * // Before running the sample:
-         * // - Enable the API at:
-         * //   https://console.developers.google.com/apis/api/storage.googleapis.com
-         * // - Login into gcloud by running:
-         * //   `$ gcloud auth application-default login`
-         * // - Install the npm module by running:
-         * //   `$ npm install googleapis`
-         *
-         * const {google} = require('googleapis');
-         * const storage = google.storage('v1');
-         *
-         * async function main() {
-         *   const auth = new google.auth.GoogleAuth({
-         *     // Scopes can be specified either as an array or as a single, space-delimited string.
-         *     scopes: [
-         *       'https://www.googleapis.com/auth/cloud-platform',
-         *       'https://www.googleapis.com/auth/devstorage.full_control',
-         *       'https://www.googleapis.com/auth/devstorage.read_write',
-         *     ],
-         *   });
-         *
-         *   // Acquire an auth client, and bind it to all future calls
-         *   const authClient = await auth.getClient();
-         *   google.options({auth: authClient});
-         *
-         *   // Do the magic
-         *   const res = await storage.notifications.delete({
-         *     // The parent bucket of the notification.
-         *     bucket: 'placeholder-value',
-         *     // ID of the notification to delete.
-         *     notification: 'placeholder-value',
-         *     // The project to be billed for this request. Required for Requester Pays buckets.
-         *     userProject: 'placeholder-value',
-         *   });
-         *   console.log(res.data);
-         * }
-         *
-         * main().catch(e => {
-         *   console.error(e);
-         *   throw e;
-         * });
-         *
-         * ```
          *
          * @param params - Parameters for request
          * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -3365,66 +1679,6 @@ export declare namespace storage_v1 {
         delete(callback: BodyResponseCallback<void>): void;
         /**
          * View a notification configuration.
-         * @example
-         * ```js
-         * // Before running the sample:
-         * // - Enable the API at:
-         * //   https://console.developers.google.com/apis/api/storage.googleapis.com
-         * // - Login into gcloud by running:
-         * //   `$ gcloud auth application-default login`
-         * // - Install the npm module by running:
-         * //   `$ npm install googleapis`
-         *
-         * const {google} = require('googleapis');
-         * const storage = google.storage('v1');
-         *
-         * async function main() {
-         *   const auth = new google.auth.GoogleAuth({
-         *     // Scopes can be specified either as an array or as a single, space-delimited string.
-         *     scopes: [
-         *       'https://www.googleapis.com/auth/cloud-platform',
-         *       'https://www.googleapis.com/auth/cloud-platform.read-only',
-         *       'https://www.googleapis.com/auth/devstorage.full_control',
-         *       'https://www.googleapis.com/auth/devstorage.read_only',
-         *       'https://www.googleapis.com/auth/devstorage.read_write',
-         *     ],
-         *   });
-         *
-         *   // Acquire an auth client, and bind it to all future calls
-         *   const authClient = await auth.getClient();
-         *   google.options({auth: authClient});
-         *
-         *   // Do the magic
-         *   const res = await storage.notifications.get({
-         *     // The parent bucket of the notification.
-         *     bucket: 'placeholder-value',
-         *     // Notification ID
-         *     notification: 'placeholder-value',
-         *     // The project to be billed for this request. Required for Requester Pays buckets.
-         *     userProject: 'placeholder-value',
-         *   });
-         *   console.log(res.data);
-         *
-         *   // Example response
-         *   // {
-         *   //   "custom_attributes": {},
-         *   //   "etag": "my_etag",
-         *   //   "event_types": [],
-         *   //   "id": "my_id",
-         *   //   "kind": "my_kind",
-         *   //   "object_name_prefix": "my_object_name_prefix",
-         *   //   "payload_format": "my_payload_format",
-         *   //   "selfLink": "my_selfLink",
-         *   //   "topic": "my_topic"
-         *   // }
-         * }
-         *
-         * main().catch(e => {
-         *   console.error(e);
-         *   throw e;
-         * });
-         *
-         * ```
          *
          * @param params - Parameters for request
          * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -3439,78 +1693,6 @@ export declare namespace storage_v1 {
         get(callback: BodyResponseCallback<Schema$Notification>): void;
         /**
          * Creates a notification subscription for a given bucket.
-         * @example
-         * ```js
-         * // Before running the sample:
-         * // - Enable the API at:
-         * //   https://console.developers.google.com/apis/api/storage.googleapis.com
-         * // - Login into gcloud by running:
-         * //   `$ gcloud auth application-default login`
-         * // - Install the npm module by running:
-         * //   `$ npm install googleapis`
-         *
-         * const {google} = require('googleapis');
-         * const storage = google.storage('v1');
-         *
-         * async function main() {
-         *   const auth = new google.auth.GoogleAuth({
-         *     // Scopes can be specified either as an array or as a single, space-delimited string.
-         *     scopes: [
-         *       'https://www.googleapis.com/auth/cloud-platform',
-         *       'https://www.googleapis.com/auth/devstorage.full_control',
-         *       'https://www.googleapis.com/auth/devstorage.read_write',
-         *     ],
-         *   });
-         *
-         *   // Acquire an auth client, and bind it to all future calls
-         *   const authClient = await auth.getClient();
-         *   google.options({auth: authClient});
-         *
-         *   // Do the magic
-         *   const res = await storage.notifications.insert({
-         *     // The parent bucket of the notification.
-         *     bucket: 'placeholder-value',
-         *     // The project to be billed for this request. Required for Requester Pays buckets.
-         *     userProject: 'placeholder-value',
-         *
-         *     // Request body metadata
-         *     requestBody: {
-         *       // request body parameters
-         *       // {
-         *       //   "custom_attributes": {},
-         *       //   "etag": "my_etag",
-         *       //   "event_types": [],
-         *       //   "id": "my_id",
-         *       //   "kind": "my_kind",
-         *       //   "object_name_prefix": "my_object_name_prefix",
-         *       //   "payload_format": "my_payload_format",
-         *       //   "selfLink": "my_selfLink",
-         *       //   "topic": "my_topic"
-         *       // }
-         *     },
-         *   });
-         *   console.log(res.data);
-         *
-         *   // Example response
-         *   // {
-         *   //   "custom_attributes": {},
-         *   //   "etag": "my_etag",
-         *   //   "event_types": [],
-         *   //   "id": "my_id",
-         *   //   "kind": "my_kind",
-         *   //   "object_name_prefix": "my_object_name_prefix",
-         *   //   "payload_format": "my_payload_format",
-         *   //   "selfLink": "my_selfLink",
-         *   //   "topic": "my_topic"
-         *   // }
-         * }
-         *
-         * main().catch(e => {
-         *   console.error(e);
-         *   throw e;
-         * });
-         *
-         * ```
          *
          * @param params - Parameters for request
          * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -3525,57 +1707,6 @@ export declare namespace storage_v1 {
         insert(callback: BodyResponseCallback<Schema$Notification>): void;
         /**
          * Retrieves a list of notification subscriptions for a given bucket.
-         * @example
-         * ```js
-         * // Before running the sample:
-         * // - Enable the API at:
-         * //   https://console.developers.google.com/apis/api/storage.googleapis.com
-         * // - Login into gcloud by running:
-         * //   `$ gcloud auth application-default login`
-         * // - Install the npm module by running:
-         * //   `$ npm install googleapis`
-         *
-         * const {google} = require('googleapis');
-         * const storage = google.storage('v1');
-         *
-         * async function main() {
-         *   const auth = new google.auth.GoogleAuth({
-         *     // Scopes can be specified either as an array or as a single, space-delimited string.
-         *     scopes: [
-         *       'https://www.googleapis.com/auth/cloud-platform',
-         *       'https://www.googleapis.com/auth/cloud-platform.read-only',
-         *       'https://www.googleapis.com/auth/devstorage.full_control',
-         *       'https://www.googleapis.com/auth/devstorage.read_only',
-         *       'https://www.googleapis.com/auth/devstorage.read_write',
-         *     ],
-         *   });
-         *
-         *   // Acquire an auth client, and bind it to all future calls
-         *   const authClient = await auth.getClient();
-         *   google.options({auth: authClient});
-         *
-         *   // Do the magic
-         *   const res = await storage.notifications.list({
-         *     // Name of a Google Cloud Storage bucket.
-         *     bucket: 'placeholder-value',
-         *     // The project to be billed for this request. Required for Requester Pays buckets.
-         *     userProject: 'placeholder-value',
-         *   });
-         *   console.log(res.data);
-         *
-         *   // Example response
-         *   // {
-         *   //   "items": [],
-         *   //   "kind": "my_kind"
-         *   // }
-         * }
-         *
-         * main().catch(e => {
-         *   console.error(e);
-         *   throw e;
-         * });
-         *
-         * ```
          *
          * @param params - Parameters for request
          * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -3646,54 +1777,6 @@ export declare namespace storage_v1 {
         constructor(context: APIRequestContext);
         /**
          * Permanently deletes the ACL entry for the specified entity on the specified object.
-         * @example
-         * ```js
-         * // Before running the sample:
-         * // - Enable the API at:
-         * //   https://console.developers.google.com/apis/api/storage.googleapis.com
-         * // - Login into gcloud by running:
-         * //   `$ gcloud auth application-default login`
-         * // - Install the npm module by running:
-         * //   `$ npm install googleapis`
-         *
-         * const {google} = require('googleapis');
-         * const storage = google.storage('v1');
-         *
-         * async function main() {
-         *   const auth = new google.auth.GoogleAuth({
-         *     // Scopes can be specified either as an array or as a single, space-delimited string.
-         *     scopes: [
-         *       'https://www.googleapis.com/auth/cloud-platform',
-         *       'https://www.googleapis.com/auth/devstorage.full_control',
-         *     ],
-         *   });
-         *
-         *   // Acquire an auth client, and bind it to all future calls
-         *   const authClient = await auth.getClient();
-         *   google.options({auth: authClient});
-         *
-         *   // Do the magic
-         *   const res = await storage.objectAccessControls.delete({
-         *     // Name of a bucket.
-         *     bucket: 'placeholder-value',
-         *     // The entity holding the permission. Can be user-userId, user-emailAddress, group-groupId, group-emailAddress, allUsers, or allAuthenticatedUsers.
-         *     entity: 'placeholder-value',
-         *     // If present, selects a specific revision of this object (as opposed to the latest version, the default).
-         *     generation: 'placeholder-value',
-         *     // Name of the object. For information about how to URL encode object names to be path safe, see [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-endpoints#encoding).
-         *     object: 'placeholder-value',
-         *     // The project to be billed for this request. Required for Requester Pays buckets.
-         *     userProject: 'placeholder-value',
-         *   });
-         *   console.log(res.data);
-         * }
-         *
-         * main().catch(e => {
-         *   console.error(e);
-         *   throw e;
-         * });
-         *
-         * ```
          *
          * @param params - Parameters for request
          * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -3708,71 +1791,6 @@ export declare namespace storage_v1 {
         delete(callback: BodyResponseCallback<void>): void;
         /**
          * Returns the ACL entry for the specified entity on the specified object.
-         * @example
-         * ```js
-         * // Before running the sample:
-         * // - Enable the API at:
-         * //   https://console.developers.google.com/apis/api/storage.googleapis.com
-         * // - Login into gcloud by running:
-         * //   `$ gcloud auth application-default login`
-         * // - Install the npm module by running:
-         * //   `$ npm install googleapis`
-         *
-         * const {google} = require('googleapis');
-         * const storage = google.storage('v1');
-         *
-         * async function main() {
-         *   const auth = new google.auth.GoogleAuth({
-         *     // Scopes can be specified either as an array or as a single, space-delimited string.
-         *     scopes: [
-         *       'https://www.googleapis.com/auth/cloud-platform',
-         *       'https://www.googleapis.com/auth/devstorage.full_control',
-         *     ],
-         *   });
-         *
-         *   // Acquire an auth client, and bind it to all future calls
-         *   const authClient = await auth.getClient();
-         *   google.options({auth: authClient});
-         *
-         *   // Do the magic
-         *   const res = await storage.objectAccessControls.get({
-         *     // Name of a bucket.
-         *     bucket: 'placeholder-value',
-         *     // The entity holding the permission. Can be user-userId, user-emailAddress, group-groupId, group-emailAddress, allUsers, or allAuthenticatedUsers.
-         *     entity: 'placeholder-value',
-         *     // If present, selects a specific revision of this object (as opposed to the latest version, the default).
-         *     generation: 'placeholder-value',
-         *     // Name of the object. For information about how to URL encode object names to be path safe, see [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-endpoints#encoding).
-         *     object: 'placeholder-value',
-         *     // The project to be billed for this request. Required for Requester Pays buckets.
-         *     userProject: 'placeholder-value',
-         *   });
-         *   console.log(res.data);
-         *
-         *   // Example response
-         *   // {
-         *   //   "bucket": "my_bucket",
-         *   //   "domain": "my_domain",
-         *   //   "email": "my_email",
-         *   //   "entity": "my_entity",
-         *   //   "entityId": "my_entityId",
-         *   //   "etag": "my_etag",
-         *   //   "generation": "my_generation",
-         *   //   "id": "my_id",
-         *   //   "kind": "my_kind",
-         *   //   "object": "my_object",
-         *   //   "projectTeam": {},
-         *   //   "role": "my_role",
-         *   //   "selfLink": "my_selfLink"
-         *   // }
-         * }
-         *
-         * main().catch(e => {
-         *   console.error(e);
-         *   throw e;
-         * });
-         *
-         * ```
          *
          * @param params - Parameters for request
          * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -3787,89 +1805,6 @@ export declare namespace storage_v1 {
         get(callback: BodyResponseCallback<Schema$ObjectAccessControl>): void;
         /**
          * Creates a new ACL entry on the specified object.
-         * @example
-         * ```js
-         * // Before running the sample:
-         * // - Enable the API at:
-         * //   https://console.developers.google.com/apis/api/storage.googleapis.com
-         * // - Login into gcloud by running:
-         * //   `$ gcloud auth application-default login`
-         * // - Install the npm module by running:
-         * //   `$ npm install googleapis`
-         *
-         * const {google} = require('googleapis');
-         * const storage = google.storage('v1');
-         *
-         * async function main() {
-         *   const auth = new google.auth.GoogleAuth({
-         *     // Scopes can be specified either as an array or as a single, space-delimited string.
-         *     scopes: [
-         *       'https://www.googleapis.com/auth/cloud-platform',
-         *       'https://www.googleapis.com/auth/devstorage.full_control',
-         *     ],
-         *   });
-         *
-         *   // Acquire an auth client, and bind it to all future calls
-         *   const authClient = await auth.getClient();
-         *   google.options({auth: authClient});
-         *
-         *   // Do the magic
-         *   const res = await storage.objectAccessControls.insert({
-         *     // Name of a bucket.
-         *     bucket: 'placeholder-value',
-         *     // If present, selects a specific revision of this object (as opposed to the latest version, the default).
-         *     generation: 'placeholder-value',
-         *     // Name of the object. For information about how to URL encode object names to be path safe, see [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-endpoints#encoding).
-         *     object: 'placeholder-value',
-         *     // The project to be billed for this request. Required for Requester Pays buckets.
-         *     userProject: 'placeholder-value',
-         *
-         *     // Request body metadata
-         *     requestBody: {
-         *       // request body parameters
-         *       // {
-         *       //   "bucket": "my_bucket",
-         *       //   "domain": "my_domain",
-         *       //   "email": "my_email",
-         *       //   "entity": "my_entity",
-         *       //   "entityId": "my_entityId",
-         *       //   "etag": "my_etag",
-         *       //   "generation": "my_generation",
-         *       //   "id": "my_id",
-         *       //   "kind": "my_kind",
-         *       //   "object": "my_object",
-         *       //   "projectTeam": {},
-         *       //   "role": "my_role",
-         *       //   "selfLink": "my_selfLink"
-         *       // }
-         *     },
-         *   });
-         *   console.log(res.data);
-         *
-         *   // Example response
-         *   // {
-         *   //   "bucket": "my_bucket",
-         *   //   "domain": "my_domain",
-         *   //   "email": "my_email",
-         *   //   "entity": "my_entity",
-         *   //   "entityId": "my_entityId",
-         *   //   "etag": "my_etag",
-         *   //   "generation": "my_generation",
-         *   //   "id": "my_id",
-         *   //   "kind": "my_kind",
-         *   //   "object": "my_object",
-         *   //   "projectTeam": {},
-         *   //   "role": "my_role",
-         *   //   "selfLink": "my_selfLink"
-         *   // }
-         * }
-         *
-         * main().catch(e => {
-         *   console.error(e);
-         *   throw e;
-         * });
-         *
-         * ```
          *
          * @param params - Parameters for request
          * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -3884,58 +1819,6 @@ export declare namespace storage_v1 {
         insert(callback: BodyResponseCallback<Schema$ObjectAccessControl>): void;
         /**
          * Retrieves ACL entries on the specified object.
-         * @example
-         * ```js
-         * // Before running the sample:
-         * // - Enable the API at:
-         * //   https://console.developers.google.com/apis/api/storage.googleapis.com
-         * // - Login into gcloud by running:
-         * //   `$ gcloud auth application-default login`
-         * // - Install the npm module by running:
-         * //   `$ npm install googleapis`
-         *
-         * const {google} = require('googleapis');
-         * const storage = google.storage('v1');
-         *
-         * async function main() {
-         *   const auth = new google.auth.GoogleAuth({
-         *     // Scopes can be specified either as an array or as a single, space-delimited string.
-         *     scopes: [
-         *       'https://www.googleapis.com/auth/cloud-platform',
-         *       'https://www.googleapis.com/auth/devstorage.full_control',
-         *     ],
-         *   });
-         *
-         *   // Acquire an auth client, and bind it to all future calls
-         *   const authClient = await auth.getClient();
-         *   google.options({auth: authClient});
-         *
-         *   // Do the magic
-         *   const res = await storage.objectAccessControls.list({
-         *     // Name of a bucket.
-         *     bucket: 'placeholder-value',
-         *     // If present, selects a specific revision of this object (as opposed to the latest version, the default).
-         *     generation: 'placeholder-value',
-         *     // Name of the object. For information about how to URL encode object names to be path safe, see [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-endpoints#encoding).
-         *     object: 'placeholder-value',
-         *     // The project to be billed for this request. Required for Requester Pays buckets.
-         *     userProject: 'placeholder-value',
-         *   });
-         *   console.log(res.data);
-         *
-         *   // Example response
-         *   // {
-         *   //   "items": [],
-         *   //   "kind": "my_kind"
-         *   // }
-         * }
-         *
-         * main().catch(e => {
-         *   console.error(e);
-         *   throw e;
-         * });
-         *
-         * ```
          *
          * @param params - Parameters for request
          * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -3950,91 +1833,6 @@ export declare namespace storage_v1 {
         list(callback: BodyResponseCallback<Schema$ObjectAccessControls>): void;
         /**
          * Patches an ACL entry on the specified object.
-         * @example
-         * ```js
-         * // Before running the sample:
-         * // - Enable the API at:
-         * //   https://console.developers.google.com/apis/api/storage.googleapis.com
-         * // - Login into gcloud by running:
-         * //   `$ gcloud auth application-default login`
-         * // - Install the npm module by running:
-         * //   `$ npm install googleapis`
-         *
-         * const {google} = require('googleapis');
-         * const storage = google.storage('v1');
-         *
-         * async function main() {
-         *   const auth = new google.auth.GoogleAuth({
-         *     // Scopes can be specified either as an array or as a single, space-delimited string.
-         *     scopes: [
-         *       'https://www.googleapis.com/auth/cloud-platform',
-         *       'https://www.googleapis.com/auth/devstorage.full_control',
-         *     ],
-         *   });
-         *
-         *   // Acquire an auth client, and bind it to all future calls
-         *   const authClient = await auth.getClient();
-         *   google.options({auth: authClient});
-         *
-         *   // Do the magic
-         *   const res = await storage.objectAccessControls.patch({
-         *     // Name of a bucket.
-         *     bucket: 'placeholder-value',
-         *     // The entity holding the permission. Can be user-userId, user-emailAddress, group-groupId, group-emailAddress, allUsers, or allAuthenticatedUsers.
-         *     entity: 'placeholder-value',
-         *     // If present, selects a specific revision of this object (as opposed to the latest version, the default).
-         *     generation: 'placeholder-value',
-         *     // Name of the object. For information about how to URL encode object names to be path safe, see [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-endpoints#encoding).
-         *     object: 'placeholder-value',
-         *     // The project to be billed for this request. Required for Requester Pays buckets.
-         *     userProject: 'placeholder-value',
-         *
-         *     // Request body metadata
-         *     requestBody: {
-         *       // request body parameters
-         *       // {
-         *       //   "bucket": "my_bucket",
-         *       //   "domain": "my_domain",
-         *       //   "email": "my_email",
-         *       //   "entity": "my_entity",
-         *       //   "entityId": "my_entityId",
-         *       //   "etag": "my_etag",
-         *       //   "generation": "my_generation",
-         *       //   "id": "my_id",
-         *       //   "kind": "my_kind",
-         *       //   "object": "my_object",
-         *       //   "projectTeam": {},
-         *       //   "role": "my_role",
-         *       //   "selfLink": "my_selfLink"
-         *       // }
-         *     },
-         *   });
-         *   console.log(res.data);
-         *
-         *   // Example response
-         *   // {
-         *   //   "bucket": "my_bucket",
-         *   //   "domain": "my_domain",
-         *   //   "email": "my_email",
-         *   //   "entity": "my_entity",
-         *   //   "entityId": "my_entityId",
-         *   //   "etag": "my_etag",
-         *   //   "generation": "my_generation",
-         *   //   "id": "my_id",
-         *   //   "kind": "my_kind",
-         *   //   "object": "my_object",
-         *   //   "projectTeam": {},
-         *   //   "role": "my_role",
-         *   //   "selfLink": "my_selfLink"
-         *   // }
-         * }
-         *
-         * main().catch(e => {
-         *   console.error(e);
-         *   throw e;
-         * });
-         *
-         * ```
          *
          * @param params - Parameters for request
          * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -4049,91 +1847,6 @@ export declare namespace storage_v1 {
         patch(callback: BodyResponseCallback<Schema$ObjectAccessControl>): void;
         /**
          * Updates an ACL entry on the specified object.
-         * @example
-         * ```js
-         * // Before running the sample:
-         * // - Enable the API at:
-         * //   https://console.developers.google.com/apis/api/storage.googleapis.com
-         * // - Login into gcloud by running:
-         * //   `$ gcloud auth application-default login`
-         * // - Install the npm module by running:
-         * //   `$ npm install googleapis`
-         *
-         * const {google} = require('googleapis');
-         * const storage = google.storage('v1');
-         *
-         * async function main() {
-         *   const auth = new google.auth.GoogleAuth({
-         *     // Scopes can be specified either as an array or as a single, space-delimited string.
-         *     scopes: [
-         *       'https://www.googleapis.com/auth/cloud-platform',
-         *       'https://www.googleapis.com/auth/devstorage.full_control',
-         *     ],
-         *   });
-         *
-         *   // Acquire an auth client, and bind it to all future calls
-         *   const authClient = await auth.getClient();
-         *   google.options({auth: authClient});
-         *
-         *   // Do the magic
-         *   const res = await storage.objectAccessControls.update({
-         *     // Name of a bucket.
-         *     bucket: 'placeholder-value',
-         *     // The entity holding the permission. Can be user-userId, user-emailAddress, group-groupId, group-emailAddress, allUsers, or allAuthenticatedUsers.
-         *     entity: 'placeholder-value',
-         *     // If present, selects a specific revision of this object (as opposed to the latest version, the default).
-         *     generation: 'placeholder-value',
-         *     // Name of the object. For information about how to URL encode object names to be path safe, see [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-endpoints#encoding).
-         *     object: 'placeholder-value',
-         *     // The project to be billed for this request. Required for Requester Pays buckets.
-         *     userProject: 'placeholder-value',
-         *
-         *     // Request body metadata
-         *     requestBody: {
-         *       // request body parameters
-         *       // {
-         *       //   "bucket": "my_bucket",
-         *       //   "domain": "my_domain",
-         *       //   "email": "my_email",
-         *       //   "entity": "my_entity",
-         *       //   "entityId": "my_entityId",
-         *       //   "etag": "my_etag",
-         *       //   "generation": "my_generation",
-         *       //   "id": "my_id",
-         *       //   "kind": "my_kind",
-         *       //   "object": "my_object",
-         *       //   "projectTeam": {},
-         *       //   "role": "my_role",
-         *       //   "selfLink": "my_selfLink"
-         *       // }
-         *     },
-         *   });
-         *   console.log(res.data);
-         *
-         *   // Example response
-         *   // {
-         *   //   "bucket": "my_bucket",
-         *   //   "domain": "my_domain",
-         *   //   "email": "my_email",
-         *   //   "entity": "my_entity",
-         *   //   "entityId": "my_entityId",
-         *   //   "etag": "my_etag",
-         *   //   "generation": "my_generation",
-         *   //   "id": "my_id",
-         *   //   "kind": "my_kind",
-         *   //   "object": "my_object",
-         *   //   "projectTeam": {},
-         *   //   "role": "my_role",
-         *   //   "selfLink": "my_selfLink"
-         *   // }
-         * }
-         *
-         * main().catch(e => {
-         *   console.error(e);
-         *   throw e;
-         * });
-         *
-         * ```
          *
          * @param params - Parameters for request
          * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -4288,105 +2001,6 @@ export declare namespace storage_v1 {
         constructor(context: APIRequestContext);
         /**
          * Concatenates a list of existing objects into a new object in the same bucket.
-         * @example
-         * ```js
-         * // Before running the sample:
-         * // - Enable the API at:
-         * //   https://console.developers.google.com/apis/api/storage.googleapis.com
-         * // - Login into gcloud by running:
-         * //   `$ gcloud auth application-default login`
-         * // - Install the npm module by running:
-         * //   `$ npm install googleapis`
-         *
-         * const {google} = require('googleapis');
-         * const storage = google.storage('v1');
-         *
-         * async function main() {
-         *   const auth = new google.auth.GoogleAuth({
-         *     // Scopes can be specified either as an array or as a single, space-delimited string.
-         *     scopes: [
-         *       'https://www.googleapis.com/auth/cloud-platform',
-         *       'https://www.googleapis.com/auth/devstorage.full_control',
-         *       'https://www.googleapis.com/auth/devstorage.read_write',
-         *     ],
-         *   });
-         *
-         *   // Acquire an auth client, and bind it to all future calls
-         *   const authClient = await auth.getClient();
-         *   google.options({auth: authClient});
-         *
-         *   // Do the magic
-         *   const res = await storage.objects.compose({
-         *     // Name of the bucket containing the source objects. The destination object is stored in this bucket.
-         *     destinationBucket: 'placeholder-value',
-         *     // Name of the new object. For information about how to URL encode object names to be path safe, see [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-endpoints#encoding).
-         *     destinationObject: 'placeholder-value',
-         *     // Apply a predefined set of access controls to the destination object.
-         *     destinationPredefinedAcl: 'placeholder-value',
-         *     // Makes the operation conditional on whether the object's current generation matches the given value. Setting to 0 makes the operation succeed only if there are no live versions of the object.
-         *     ifGenerationMatch: 'placeholder-value',
-         *     // Makes the operation conditional on whether the object's current metageneration matches the given value.
-         *     ifMetagenerationMatch: 'placeholder-value',
-         *     // Resource name of the Cloud KMS key, of the form projects/my-project/locations/global/keyRings/my-kr/cryptoKeys/my-key, that will be used to encrypt the object. Overrides the object metadata's kms_key_name value, if any.
-         *     kmsKeyName: 'placeholder-value',
-         *     // The project to be billed for this request. Required for Requester Pays buckets.
-         *     userProject: 'placeholder-value',
-         *
-         *     // Request body metadata
-         *     requestBody: {
-         *       // request body parameters
-         *       // {
-         *       //   "destination": {},
-         *       //   "kind": "my_kind",
-         *       //   "sourceObjects": []
-         *       // }
-         *     },
-         *   });
-         *   console.log(res.data);
-         *
-         *   // Example response
-         *   // {
-         *   //   "acl": [],
-         *   //   "bucket": "my_bucket",
-         *   //   "cacheControl": "my_cacheControl",
-         *   //   "componentCount": 0,
-         *   //   "contentDisposition": "my_contentDisposition",
-         *   //   "contentEncoding": "my_contentEncoding",
-         *   //   "contentLanguage": "my_contentLanguage",
-         *   //   "contentType": "my_contentType",
-         *   //   "crc32c": "my_crc32c",
-         *   //   "customTime": "my_customTime",
-         *   //   "customerEncryption": {},
-         *   //   "etag": "my_etag",
-         *   //   "eventBasedHold": false,
-         *   //   "generation": "my_generation",
-         *   //   "id": "my_id",
-         *   //   "kind": "my_kind",
-         *   //   "kmsKeyName": "my_kmsKeyName",
-         *   //   "md5Hash": "my_md5Hash",
-         *   //   "mediaLink": "my_mediaLink",
-         *   //   "metadata": {},
-         *   //   "metageneration": "my_metageneration",
-         *   //   "name": "my_name",
-         *   //   "owner": {},
-         *   //   "retentionExpirationTime": "my_retentionExpirationTime",
-         *   //   "selfLink": "my_selfLink",
-         *   //   "size": "my_size",
-         *   //   "storageClass": "my_storageClass",
-         *   //   "temporaryHold": false,
-         *   //   "timeCreated": "my_timeCreated",
-         *   //   "timeDeleted": "my_timeDeleted",
-         *   //   "timeStorageClassUpdated": "my_timeStorageClassUpdated",
-         *   //   "updated": "my_updated"
-         *   // }
-         * }
-         *
-         * main().catch(e => {
-         *   console.error(e);
-         *   throw e;
-         * });
-         *
-         * ```
          *
          * @param params - Parameters for request
          * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -4401,154 +2015,6 @@ export declare namespace storage_v1 {
         compose(callback: BodyResponseCallback<Schema$Object>): void;
         /**
          * Copies a source object to a destination object. Optionally overrides metadata.
-         * @example
-         * ```js
-         * // Before running the sample:
-         * // - Enable the API at:
-         * //   https://console.developers.google.com/apis/api/storage.googleapis.com
-         * // - Login into gcloud by running:
-         * //   `$ gcloud auth application-default login`
-         * // - Install the npm module by running:
-         * //   `$ npm install googleapis`
-         *
-         * const {google} = require('googleapis');
-         * const storage = google.storage('v1');
-         *
-         * async function main() {
-         *   const auth = new google.auth.GoogleAuth({
-         *     // Scopes can be specified either as an array or as a single, space-delimited string.
-         *     scopes: [
-         *       'https://www.googleapis.com/auth/cloud-platform',
-         *       'https://www.googleapis.com/auth/devstorage.full_control',
-         *       'https://www.googleapis.com/auth/devstorage.read_write',
-         *     ],
-         *   });
-         *
-         *   // Acquire an auth client, and bind it to all future calls
-         *   const authClient = await auth.getClient();
-         *   google.options({auth: authClient});
-         *
-         *   // Do the magic
-         *   const res = await storage.objects.copy({
-         *     // Name of the bucket in which to store the new object. Overrides the provided object metadata's bucket value, if any.For information about how to URL encode object names to be path safe, see [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-endpoints#encoding).
-         *     destinationBucket: 'placeholder-value',
-         *     // Resource name of the Cloud KMS key, of the form projects/my-project/locations/global/keyRings/my-kr/cryptoKeys/my-key, that will be used to encrypt the object. Overrides the object metadata's kms_key_name value, if any.
-         *     destinationKmsKeyName: 'placeholder-value',
-         *     // Name of the new object. Required when the object metadata is not otherwise provided. Overrides the object metadata's name value, if any.
-         *     destinationObject: 'placeholder-value',
-         *     // Apply a predefined set of access controls to the destination object.
-         *     destinationPredefinedAcl: 'placeholder-value',
-         *     // Makes the operation conditional on whether the destination object's current generation matches the given value. Setting to 0 makes the operation succeed only if there are no live versions of the object.
-         *     ifGenerationMatch: 'placeholder-value',
-         *     // Makes the operation conditional on whether the destination object's current generation does not match the given value. If no live object exists, the precondition fails. Setting to 0 makes the operation succeed only if there is a live version of the object.
-         *     ifGenerationNotMatch: 'placeholder-value',
-         *     // Makes the operation conditional on whether the destination object's current metageneration matches the given value.
-         *     ifMetagenerationMatch: 'placeholder-value',
-         *     // Makes the operation conditional on whether the destination object's current metageneration does not match the given value.
-         *     ifMetagenerationNotMatch: 'placeholder-value',
-         *     // Makes the operation conditional on whether the source object's current generation matches the given value.
-         *     ifSourceGenerationMatch: 'placeholder-value',
-         *     // Makes the operation conditional on whether the source object's current generation does not match the given value.
-         *     ifSourceGenerationNotMatch: 'placeholder-value',
-         *     // Makes the operation conditional on whether the source object's current metageneration matches the given value.
-         *     ifSourceMetagenerationMatch: 'placeholder-value',
-         *     // Makes the operation conditional on whether the source object's current metageneration does not match the given value.
-         *     ifSourceMetagenerationNotMatch: 'placeholder-value',
-         *     // Set of properties to return. Defaults to noAcl, unless the object resource specifies the acl property, when it defaults to full.
-         *     projection: 'placeholder-value',
-         *     // Name of the bucket in which to find the source object.
-         *     sourceBucket: 'placeholder-value',
-         *     // If present, selects a specific revision of the source object (as opposed to the latest version, the default).
-         *     sourceGeneration: 'placeholder-value',
-         *     // Name of the source object. For information about how to URL encode object names to be path safe, see [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-endpoints#encoding).
-         *     sourceObject: 'placeholder-value',
-         *     // The project to be billed for this request. Required for Requester Pays buckets.
-         *     userProject: 'placeholder-value',
-         *
-         *     // Request body metadata
-         *     requestBody: {
-         *       // request body parameters
-         *       // {
-         *       //   "acl": [],
-         *       //   "bucket": "my_bucket",
-         *       //   "cacheControl": "my_cacheControl",
-         *       //   "componentCount": 0,
-         *       //   "contentDisposition": "my_contentDisposition",
-         *       //   "contentEncoding": "my_contentEncoding",
-         *       //   "contentLanguage": "my_contentLanguage",
-         *       //   "contentType": "my_contentType",
-         *       //   "crc32c": "my_crc32c",
-         *       //   "customTime": "my_customTime",
-         *       //   "customerEncryption": {},
-         *       //   "etag": "my_etag",
-         *       //   "eventBasedHold": false,
-         *       //   "generation": "my_generation",
-         *       //   "id": "my_id",
-         *       //   "kind": "my_kind",
-         *       //   "kmsKeyName": "my_kmsKeyName",
-         *       //   "md5Hash": "my_md5Hash",
-         *       //   "mediaLink": "my_mediaLink",
-         *       //   "metadata": {},
-         *       //   "metageneration": "my_metageneration",
-         *       //   "name": "my_name",
-         *       //   "owner": {},
-         *       //   "retentionExpirationTime": "my_retentionExpirationTime",
-         *       //   "selfLink": "my_selfLink",
-         *       //   "size": "my_size",
-         *       //   "storageClass": "my_storageClass",
-         *       //   "temporaryHold": false,
-         *       //   "timeCreated": "my_timeCreated",
-         *       //   "timeDeleted": "my_timeDeleted",
-         *       //   "timeStorageClassUpdated": "my_timeStorageClassUpdated",
-         *       //   "updated": "my_updated"
-         *       // }
-         *     },
-         *   });
-         *   console.log(res.data);
-         *
-         *   // Example response
-         *   // {
-         *   //   "acl": [],
-         *   //   "bucket": "my_bucket",
-         *   //   "cacheControl": "my_cacheControl",
-         *   //   "componentCount": 0,
-         *   //   "contentDisposition": "my_contentDisposition",
-         *   //   "contentEncoding": "my_contentEncoding",
-         *   //   "contentLanguage": "my_contentLanguage",
-         *   //   "contentType": "my_contentType",
-         *   //   "crc32c": "my_crc32c",
-         *   //   "customTime": "my_customTime",
-         *   //   "customerEncryption": {},
-         *   //   "etag": "my_etag",
-         *   //   "eventBasedHold": false,
-         *   //   "generation": "my_generation",
-         *   //   "id": "my_id",
-         *   //   "kind": "my_kind",
-         *   //   "kmsKeyName": "my_kmsKeyName",
-         *   //   "md5Hash": "my_md5Hash",
-         *   //   "mediaLink": "my_mediaLink",
-         *   //   "metadata": {},
-         *   //   "metageneration": "my_metageneration",
-         *   //   "name": "my_name",
-         *   //   "owner": {},
-         *   //   "retentionExpirationTime": "my_retentionExpirationTime",
-         *   //   "selfLink": "my_selfLink",
-         *   //   "size": "my_size",
-         *   //   "storageClass": "my_storageClass",
-         *   //   "temporaryHold": false,
-         *   //   "timeCreated": "my_timeCreated",
-         *   //   "timeDeleted": "my_timeDeleted",
-         *   //   "timeStorageClassUpdated": "my_timeStorageClassUpdated",
-         *   //   "updated": "my_updated"
-         *   // }
-         * }
-         *
-         * main().catch(e => {
-         *   console.error(e);
-         *   throw e;
-         * });
-         *
-         * ```
          *
          * @param params - Parameters for request
          * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -4563,61 +2029,6 @@ export declare namespace storage_v1 {
         copy(callback: BodyResponseCallback<Schema$Object>): void;
         /**
          * Deletes an object and its metadata. Deletions are permanent if versioning is not enabled for the bucket, or if the generation parameter is used.
-         * @example
-         * ```js
-         * // Before running the sample:
-         * // - Enable the API at:
-         * //   https://console.developers.google.com/apis/api/storage.googleapis.com
-         * // - Login into gcloud by running:
-         * //   `$ gcloud auth application-default login`
-         * // - Install the npm module by running:
-         * //   `$ npm install googleapis`
-         *
-         * const {google} = require('googleapis');
-         * const storage = google.storage('v1');
-         *
-         * async function main() {
-         *   const auth = new google.auth.GoogleAuth({
-         *     // Scopes can be specified either as an array or as a single, space-delimited string.
-         *     scopes: [
-         *       'https://www.googleapis.com/auth/cloud-platform',
-         *       'https://www.googleapis.com/auth/devstorage.full_control',
-         *       'https://www.googleapis.com/auth/devstorage.read_write',
-         *     ],
-         *   });
-         *
-         *   // Acquire an auth client, and bind it to all future calls
-         *   const authClient = await auth.getClient();
-         *   google.options({auth: authClient});
-         *
-         *   // Do the magic
-         *   const res = await storage.objects.delete({
-         *     // Name of the bucket in which the object resides.
-         *     bucket: 'placeholder-value',
-         *     // If present, permanently deletes a specific revision of this object (as opposed to the latest version, the default).
-         *     generation: 'placeholder-value',
-         *     // Makes the operation conditional on whether the object's current generation matches the given value. Setting to 0 makes the operation succeed only if there are no live versions of the object.
-         *     ifGenerationMatch: 'placeholder-value',
-         *     // Makes the operation conditional on whether the object's current generation does not match the given value. If no live object exists, the precondition fails. Setting to 0 makes the operation succeed only if there is a live version of the object.
-         *     ifGenerationNotMatch: 'placeholder-value',
-         *     // Makes the operation conditional on whether the object's current metageneration matches the given value.
-         *     ifMetagenerationMatch: 'placeholder-value',
-         *     // Makes the operation conditional on whether the object's current metageneration does not match the given value.
-         *     ifMetagenerationNotMatch: 'placeholder-value',
-         *     // Name of the object. For information about how to URL encode object names to be path safe, see [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-endpoints#encoding).
-         *     object: 'placeholder-value',
-         *     // The project to be billed for this request. Required for Requester Pays buckets.
-         *     userProject: 'placeholder-value',
-         *   });
-         *   console.log(res.data);
-         * }
-         *
-         * main().catch(e => {
-         *   console.error(e);
-         *   throw e;
-         * });
-         *
-         * ```
          *
          * @param params - Parameters for request
          * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -4632,101 +2043,6 @@ export declare namespace storage_v1 {
         delete(callback: BodyResponseCallback<void>): void;
         /**
          * Retrieves an object or its metadata.
-         * @example
-         * ```js
-         * // Before running the sample:
-         * // - Enable the API at:
-         * //   https://console.developers.google.com/apis/api/storage.googleapis.com
-         * // - Login into gcloud by running:
-         * //   `$ gcloud auth application-default login`
-         * // - Install the npm module by running:
-         * //   `$ npm install googleapis`
-         *
-         * const {google} = require('googleapis');
-         * const storage = google.storage('v1');
-         *
-         * async function main() {
-         *   const auth = new google.auth.GoogleAuth({
-         *     // Scopes can be specified either as an array or as a single, space-delimited string.
-         *     scopes: [
-         *       'https://www.googleapis.com/auth/cloud-platform',
-         *       'https://www.googleapis.com/auth/cloud-platform.read-only',
-         *       'https://www.googleapis.com/auth/devstorage.full_control',
-         *       'https://www.googleapis.com/auth/devstorage.read_only',
-         *       'https://www.googleapis.com/auth/devstorage.read_write',
-         *     ],
-         *   });
-         *
-         *   // Acquire an auth client, and bind it to all future calls
-         *   const authClient = await auth.getClient();
-         *   google.options({auth: authClient});
-         *
-         *   // Do the magic
-         *   const res = await storage.objects.get({
-         *     // Name of the bucket in which the object resides.
-         *     bucket: 'placeholder-value',
-         *     // If present, selects a specific revision of this object (as opposed to the latest version, the default).
-         *     generation: 'placeholder-value',
-         *     // Makes the operation conditional on whether the object's current generation matches the given value. Setting to 0 makes the operation succeed only if there are no live versions of the object.
-         *     ifGenerationMatch: 'placeholder-value',
-         *     // Makes the operation conditional on whether the object's current generation does not match the given value. If no live object exists, the precondition fails. Setting to 0 makes the operation succeed only if there is a live version of the object.
-         *     ifGenerationNotMatch: 'placeholder-value',
-         *     // Makes the operation conditional on whether the object's current metageneration matches the given value.
-         *     ifMetagenerationMatch: 'placeholder-value',
-         *     // Makes the operation conditional on whether the object's current metageneration does not match the given value.
-         *     ifMetagenerationNotMatch: 'placeholder-value',
-         *     // Name of the object. For information about how to URL encode object names to be path safe, see [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-endpoints#encoding).
-         *     object: 'placeholder-value',
-         *     // Set of properties to return. Defaults to noAcl.
-         *     projection: 'placeholder-value',
-         *     // The project to be billed for this request. Required for Requester Pays buckets.
-         *     userProject: 'placeholder-value',
-         *   });
-         *   console.log(res.data);
-         *
-         *   // Example response
-         *   // {
-         *   //   "acl": [],
-         *   //   "bucket": "my_bucket",
-         *   //   "cacheControl": "my_cacheControl",
-         *   //   "componentCount": 0,
-         *   //   "contentDisposition": "my_contentDisposition",
-         *   //   "contentEncoding": "my_contentEncoding",
-         *   //   "contentLanguage": "my_contentLanguage",
-         *   //   "contentType": "my_contentType",
-         *   //   "crc32c": "my_crc32c",
-         *   //   "customTime": "my_customTime",
-         *   //   "customerEncryption": {},
-         *   //   "etag": "my_etag",
-         *   //   "eventBasedHold": false,
-         *   //   "generation": "my_generation",
-         *   //   "id": "my_id",
-         *   //   "kind": "my_kind",
-         *   //   "kmsKeyName": "my_kmsKeyName",
-         *   //   "md5Hash": "my_md5Hash",
-         *   //   "mediaLink": "my_mediaLink",
-         *   //   "metadata": {},
-         *   //   "metageneration": "my_metageneration",
-         *   //   "name": "my_name",
-         *   //   "owner": {},
-         *   //   "retentionExpirationTime": "my_retentionExpirationTime",
-         *   //   "selfLink": "my_selfLink",
-         *   //   "size": "my_size",
-         *   //   "storageClass": "my_storageClass",
-         *   //   "temporaryHold": false,
-         *   //   "timeCreated": "my_timeCreated",
-         *   //   "timeDeleted": "my_timeDeleted",
-         *   //   "timeStorageClassUpdated": "my_timeStorageClassUpdated",
-         *   //   "updated": "my_updated"
-         *   // }
-         * }
-         *
-         * main().catch(e => {
-         *   console.error(e);
-         *   throw e;
-         * });
-         *
-         * ```
          *
          * @param params - Parameters for request
          * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -4741,64 +2057,6 @@ export declare namespace storage_v1 {
         get(callback: BodyResponseCallback<Schema$Object>): void;
         /**
          * Returns an IAM policy for the specified object.
-         * @example
-         * ```js
-         * // Before running the sample:
-         * // - Enable the API at:
-         * //   https://console.developers.google.com/apis/api/storage.googleapis.com
-         * // - Login into gcloud by running:
-         * //   `$ gcloud auth application-default login`
-         * // - Install the npm module by running:
-         * //   `$ npm install googleapis`
-         *
-         * const {google} = require('googleapis');
-         * const storage = google.storage('v1');
-         *
-         * async function main() {
-         *   const auth = new google.auth.GoogleAuth({
-         *     // Scopes can be specified either as an array or as a single, space-delimited string.
-         *     scopes: [
-         *       'https://www.googleapis.com/auth/cloud-platform',
-         *       'https://www.googleapis.com/auth/cloud-platform.read-only',
-         *       'https://www.googleapis.com/auth/devstorage.full_control',
-         *       'https://www.googleapis.com/auth/devstorage.read_only',
-         *       'https://www.googleapis.com/auth/devstorage.read_write',
-         *     ],
-         *   });
-         *
-         *   // Acquire an auth client, and bind it to all future calls
-         *   const authClient = await auth.getClient();
-         *   google.options({auth: authClient});
-         *
-         *   // Do the magic
-         *   const res = await storage.objects.getIamPolicy({
-         *     // Name of the bucket in which the object resides.
-         *     bucket: 'placeholder-value',
-         *     // If present, selects a specific revision of this object (as opposed to the latest version, the default).
-         *     generation: 'placeholder-value',
-         *     // Name of the object. For information about how to URL encode object names to be path safe, see [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-endpoints#encoding).
-         *     object: 'placeholder-value',
-         *     // The project to be billed for this request. Required for Requester Pays buckets.
-         *     userProject: 'placeholder-value',
-         *   });
-         *   console.log(res.data);
-         *
-         *   // Example response
-         *   // {
-         *   //   "bindings": [],
-         *   //   "etag": "my_etag",
-         *   //   "kind": "my_kind",
-         *   //   "resourceId": "my_resourceId",
-         *   //   "version": 0
-         *   // }
-         * }
-         *
-         * main().catch(e => {
-         *   console.error(e);
-         *   throw e;
-         * });
-         *
-         * ```
          *
          * @param params - Parameters for request
          * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -4813,146 +2071,6 @@ export declare namespace storage_v1 {
         getIamPolicy(callback: BodyResponseCallback<Schema$Policy>): void;
         /**
          * Stores a new object and metadata.
-         * @example
-         * ```js
-         * // Before running the sample:
-         * // - Enable the API at:
-         * //   https://console.developers.google.com/apis/api/storage.googleapis.com
-         * // - Login into gcloud by running:
-         * //   `$ gcloud auth application-default login`
-         * // - Install the npm module by running:
-         * //   `$ npm install googleapis`
-         *
-         * const {google} = require('googleapis');
-         * const storage = google.storage('v1');
-         *
-         * async function main() {
-         *   const auth = new google.auth.GoogleAuth({
-         *     // Scopes can be specified either as an array or as a single, space-delimited string.
-         *     scopes: [
-         *       'https://www.googleapis.com/auth/cloud-platform',
-         *       'https://www.googleapis.com/auth/devstorage.full_control',
-         *       'https://www.googleapis.com/auth/devstorage.read_write',
-         *     ],
-         *   });
-         *
-         *   // Acquire an auth client, and bind it to all future calls
-         *   const authClient = await auth.getClient();
-         *   google.options({auth: authClient});
-         *
-         *   // Do the magic
-         *   const res = await storage.objects.insert({
-         *     // Name of the bucket in which to store the new object. Overrides the provided object metadata's bucket value, if any.
-         *     bucket: 'placeholder-value',
-         *     // If set, sets the contentEncoding property of the final object to this value. Setting this parameter is equivalent to setting the contentEncoding metadata property. This can be useful when uploading an object with uploadType=media to indicate the encoding of the content being uploaded.
-         *     contentEncoding: 'placeholder-value',
-         *     // Makes the operation conditional on whether the object's current generation matches the given value. Setting to 0 makes the operation succeed only if there are no live versions of the object.
-         *     ifGenerationMatch: 'placeholder-value',
-         *     // Makes the operation conditional on whether the object's current generation does not match the given value. If no live object exists, the precondition fails. Setting to 0 makes the operation succeed only if there is a live version of the object.
-         *     ifGenerationNotMatch: 'placeholder-value',
-         *     // Makes the operation conditional on whether the object's current metageneration matches the given value.
-         *     ifMetagenerationMatch: 'placeholder-value',
-         *     // Makes the operation conditional on whether the object's current metageneration does not match the given value.
-         *     ifMetagenerationNotMatch: 'placeholder-value',
-         *     // Resource name of the Cloud KMS key, of the form projects/my-project/locations/global/keyRings/my-kr/cryptoKeys/my-key, that will be used to encrypt the object. Overrides the object metadata's kms_key_name value, if any.
-         *     kmsKeyName: 'placeholder-value',
-         *     // Name of the object. Required when the object metadata is not otherwise provided. Overrides the object metadata's name value, if any. For information about how to URL encode object names to be path safe, see [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-endpoints#encoding).
-         *     name: 'placeholder-value',
-         *     // Apply a predefined set of access controls to this object.
-         *     predefinedAcl: 'placeholder-value',
-         *     // Set of properties to return. Defaults to noAcl, unless the object resource specifies the acl property, when it defaults to full.
-         *     projection: 'placeholder-value',
-         *     // The project to be billed for this request. Required for Requester Pays buckets.
-         *     userProject: 'placeholder-value',
-         *
-         *     // Request body metadata
-         *     requestBody: {
-         *       // request body parameters
-         *       // {
-         *       //   "acl": [],
-         *       //   "bucket": "my_bucket",
-         *       //   "cacheControl": "my_cacheControl",
-         *       //   "componentCount": 0,
-         *       //   "contentDisposition": "my_contentDisposition",
-         *       //   "contentEncoding": "my_contentEncoding",
-         *       //   "contentLanguage": "my_contentLanguage",
-         *       //   "contentType": "my_contentType",
-         *       //   "crc32c": "my_crc32c",
-         *       //   "customTime": "my_customTime",
-         *       //   "customerEncryption": {},
-         *       //   "etag": "my_etag",
-         *       //   "eventBasedHold": false,
-         *       //   "generation": "my_generation",
-         *       //   "id": "my_id",
-         *       //   "kind": "my_kind",
-         *       //   "kmsKeyName": "my_kmsKeyName",
-         *       //   "md5Hash": "my_md5Hash",
-         *       //   "mediaLink": "my_mediaLink",
-         *       //   "metadata": {},
-         *       //   "metageneration": "my_metageneration",
-         *       //   "name": "my_name",
-         *       //   "owner": {},
-         *       //   "retentionExpirationTime": "my_retentionExpirationTime",
-         *       //   "selfLink": "my_selfLink",
-         *       //   "size": "my_size",
-         *       //   "storageClass": "my_storageClass",
-         *       //   "temporaryHold": false,
-         *       //   "timeCreated": "my_timeCreated",
-         *       //   "timeDeleted": "my_timeDeleted",
-         *       //   "timeStorageClassUpdated": "my_timeStorageClassUpdated",
-         *       //   "updated": "my_updated"
-         *       // }
-         *     },
-         *     media: {
-         *       mimeType: 'placeholder-value',
-         *       body: 'placeholder-value',
-         *     },
-         *   });
-         *   console.log(res.data);
-         *
-         *   // Example response
-         *   // {
-         *   //   "acl": [],
-         *   //   "bucket": "my_bucket",
-         *   //   "cacheControl": "my_cacheControl",
-         *   //   "componentCount": 0,
-         *   //   "contentDisposition": "my_contentDisposition",
-         *   //   "contentEncoding": "my_contentEncoding",
-         *   //   "contentLanguage": "my_contentLanguage",
-         *   //   "contentType": "my_contentType",
-         *   //   "crc32c": "my_crc32c",
-         *   //   "customTime": "my_customTime",
-         *   //   "customerEncryption": {},
-         *   //   "etag": "my_etag",
-         *   //   "eventBasedHold": false,
-         *   //   "generation": "my_generation",
-         *   //   "id": "my_id",
-         *   //   "kind": "my_kind",
-         *   //   "kmsKeyName": "my_kmsKeyName",
-         *   //   "md5Hash": "my_md5Hash",
-         *   //   "mediaLink": "my_mediaLink",
-         *   //   "metadata": {},
-         *   //   "metageneration": "my_metageneration",
-         *   //   "name": "my_name",
-         *   //   "owner": {},
-         *   //   "retentionExpirationTime": "my_retentionExpirationTime",
-         *   //   "selfLink": "my_selfLink",
-         *   //   "size": "my_size",
-         *   //   "storageClass": "my_storageClass",
-         *   //   "temporaryHold": false,
-         *   //   "timeCreated": "my_timeCreated",
-         *   //   "timeDeleted": "my_timeDeleted",
-         *   //   "timeStorageClassUpdated": "my_timeStorageClassUpdated",
-         *   //   "updated": "my_updated"
-         *   // }
-         * }
-         *
-         * main().catch(e => {
-         *   console.error(e);
-         *   throw e;
-         * });
-         *
-         * ```
          *
          * @param params - Parameters for request
          * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -4967,79 +2085,6 @@ export declare namespace storage_v1 {
         insert(callback: BodyResponseCallback<Schema$Object>): void;
         /**
          * Retrieves a list of objects matching the criteria.
-         * @example
-         * ```js
-         * // Before running the sample:
-         * // - Enable the API at:
-         * //   https://console.developers.google.com/apis/api/storage.googleapis.com
-         * // - Login into gcloud by running:
-         * //   `$ gcloud auth application-default login`
-         * // - Install the npm module by running:
-         * //   `$ npm install googleapis`
-         *
-         * const {google} = require('googleapis');
-         * const storage = google.storage('v1');
-         *
-         * async function main() {
-         *   const auth = new google.auth.GoogleAuth({
-         *     // Scopes can be specified either as an array or as a single, space-delimited string.
-         *     scopes: [
-         *       'https://www.googleapis.com/auth/cloud-platform',
-         *       'https://www.googleapis.com/auth/cloud-platform.read-only',
-         *       'https://www.googleapis.com/auth/devstorage.full_control',
-         *       'https://www.googleapis.com/auth/devstorage.read_only',
-         *       'https://www.googleapis.com/auth/devstorage.read_write',
-         *     ],
-         *   });
-         *
-         *   // Acquire an auth client, and bind it to all future calls
-         *   const authClient = await auth.getClient();
-         *   google.options({auth: authClient});
-         *
-         *   // Do the magic
-         *   const res = await storage.objects.list({
-         *     // Name of the bucket in which to look for objects.
-         *     bucket: 'placeholder-value',
-         *     // Returns results in a directory-like mode. items will contain only objects whose names, aside from the prefix, do not contain delimiter. Objects whose names, aside from the prefix, contain delimiter will have their name, truncated after the delimiter, returned in prefixes. Duplicate prefixes are omitted.
-         *     delimiter: 'placeholder-value',
-         *     // Filter results to objects whose names are lexicographically before endOffset. If startOffset is also set, the objects listed will have names between startOffset (inclusive) and endOffset (exclusive).
-         *     endOffset: 'placeholder-value',
-         *     // If true, objects that end in exactly one instance of delimiter will have their metadata included in items in addition to prefixes.
-         *     includeTrailingDelimiter: 'placeholder-value',
-         *     // Filter results to objects and prefixes that match this glob pattern.
-         *     matchGlob: 'placeholder-value',
-         *     // Maximum number of items plus prefixes to return in a single page of responses. As duplicate prefixes are omitted, fewer total results may be returned than requested. The service will use this parameter or 1,000 items, whichever is smaller.
-         *     maxResults: 'placeholder-value',
-         *     // A previously-returned page token representing part of the larger set of results to view.
-         *     pageToken: 'placeholder-value',
-         *     // Filter results to objects whose names begin with this prefix.
-         *     prefix: 'placeholder-value',
-         *     // Set of properties to return. Defaults to noAcl.
-         *     projection: 'placeholder-value',
-         *     // Filter results to objects whose names are lexicographically equal to or after startOffset. If endOffset is also set, the objects listed will have names between startOffset (inclusive) and endOffset (exclusive).
-         *     startOffset: 'placeholder-value',
-         *     // The project to be billed for this request. Required for Requester Pays buckets.
-         *     userProject: 'placeholder-value',
-         *     // If true, lists all versions of an object as distinct results. The default is false. For more information, see Object Versioning.
-         *     versions: 'placeholder-value',
-         *   });
-         *   console.log(res.data);
-         *
-         *   // Example response
-         *   // {
-         *   //   "items": [],
-         *   //   "kind": "my_kind",
-         *   //   "nextPageToken": "my_nextPageToken",
-         *   //   "prefixes": []
-         *   // }
-         * }
-         *
-         * main().catch(e => {
-         *   console.error(e);
-         *   throw e;
-         * });
-         *
-         * ```
          *
          * @param params - Parameters for request
          * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -5054,139 +2099,6 @@ export declare namespace storage_v1 {
         list(callback: BodyResponseCallback<Schema$Objects>): void;
         /**
          * Patches an object's metadata.
-         * @example
-         * ```js
-         * // Before running the sample:
-         * // - Enable the API at:
-         * //   https://console.developers.google.com/apis/api/storage.googleapis.com
-         * // - Login into gcloud by running:
-         * //   `$ gcloud auth application-default login`
-         * // - Install the npm module by running:
-         * //   `$ npm install googleapis`
-         *
-         * const {google} = require('googleapis');
-         * const storage = google.storage('v1');
-         *
-         * async function main() {
-         *   const auth = new google.auth.GoogleAuth({
-         *     // Scopes can be specified either as an array or as a single, space-delimited string.
-         *     scopes: [
-         *       'https://www.googleapis.com/auth/cloud-platform',
-         *       'https://www.googleapis.com/auth/devstorage.full_control',
-         *     ],
-         *   });
-         *
-         *   // Acquire an auth client, and bind it to all future calls
-         *   const authClient = await auth.getClient();
-         *   google.options({auth: authClient});
-         *
-         *   // Do the magic
-         *   const res = await storage.objects.patch({
-         *     // Name of the bucket in which the object resides.
-         *     bucket: 'placeholder-value',
-         *     // If present, selects a specific revision of this object (as opposed to the latest version, the default).
-         *     generation: 'placeholder-value',
-         *     // Makes the operation conditional on whether the object's current generation matches the given value. Setting to 0 makes the operation succeed only if there are no live versions of the object.
-         *     ifGenerationMatch: 'placeholder-value',
-         *     // Makes the operation conditional on whether the object's current generation does not match the given value. If no live object exists, the precondition fails. Setting to 0 makes the operation succeed only if there is a live version of the object.
-         *     ifGenerationNotMatch: 'placeholder-value',
-         *     // Makes the operation conditional on whether the object's current metageneration matches the given value.
-         *     ifMetagenerationMatch: 'placeholder-value',
-         *     // Makes the operation conditional on whether the object's current metageneration does not match the given value.
-         *     ifMetagenerationNotMatch: 'placeholder-value',
-         *     // Name of the object. For information about how to URL encode object names to be path safe, see [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-endpoints#encoding).
-         *     object: 'placeholder-value',
-         *     // Apply a predefined set of access controls to this object.
-         *     predefinedAcl: 'placeholder-value',
-         *     // Set of properties to return. Defaults to full.
-         *     projection: 'placeholder-value',
-         *     // The project to be billed for this request, for Requester Pays buckets.
-         *     userProject: 'placeholder-value',
-         *
-         *     // Request body metadata
-         *     requestBody: {
-         *       // request body parameters
-         *       // {
-         *       //   "acl": [],
-         *       //   "bucket": "my_bucket",
-         *       //   "cacheControl": "my_cacheControl",
-         *       //   "componentCount": 0,
-         *       //   "contentDisposition": "my_contentDisposition",
-         *       //   "contentEncoding": "my_contentEncoding",
-         *       //   "contentLanguage": "my_contentLanguage",
-         *       //   "contentType": "my_contentType",
-         *       //   "crc32c": "my_crc32c",
-         *       //   "customTime": "my_customTime",
-         *       //   "customerEncryption": {},
-         *       //   "etag": "my_etag",
-         *       //   "eventBasedHold": false,
-         *       //   "generation": "my_generation",
-         *       //   "id": "my_id",
-         *       //   "kind": "my_kind",
-         *       //   "kmsKeyName": "my_kmsKeyName",
-         *       //   "md5Hash": "my_md5Hash",
-         *       //   "mediaLink": "my_mediaLink",
-         *       //   "metadata": {},
-         *       //   "metageneration": "my_metageneration",
-         *       //   "name": "my_name",
-         *       //   "owner": {},
-         *       //   "retentionExpirationTime": "my_retentionExpirationTime",
-         *       //   "selfLink": "my_selfLink",
-         *       //   "size": "my_size",
-         *       //   "storageClass": "my_storageClass",
-         *       //   "temporaryHold": false,
-         *       //   "timeCreated": "my_timeCreated",
-         *       //   "timeDeleted": "my_timeDeleted",
-         *       //   "timeStorageClassUpdated": "my_timeStorageClassUpdated",
-         *       //   "updated": "my_updated"
-         *       // }
-         *     },
-         *   });
-         *   console.log(res.data);
-         *
-         *   // Example response
-         *   // {
-         *   //   "acl": [],
-         *   //   "bucket": "my_bucket",
-         *   //   "cacheControl": "my_cacheControl",
-         *   //   "componentCount": 0,
-         *   //   "contentDisposition": "my_contentDisposition",
-         *   //   "contentEncoding": "my_contentEncoding",
-         *   //   "contentLanguage": "my_contentLanguage",
-         *   //   "contentType": "my_contentType",
-         *   //   "crc32c": "my_crc32c",
-         *   //   "customTime": "my_customTime",
-         *   //   "customerEncryption": {},
-         *   //   "etag": "my_etag",
-         *   //   "eventBasedHold": false,
-         *   //   "generation": "my_generation",
-         *   //   "id": "my_id",
-         *   //   "kind": "my_kind",
-         *   //   "kmsKeyName": "my_kmsKeyName",
-         *   //   "md5Hash": "my_md5Hash",
-         *   //   "mediaLink": "my_mediaLink",
-         *   //   "metadata": {},
-         *   //   "metageneration": "my_metageneration",
-         *   //   "name": "my_name",
-         *   //   "owner": {},
-         *   //   "retentionExpirationTime": "my_retentionExpirationTime",
-         *   //   "selfLink": "my_selfLink",
-         *   //   "size": "my_size",
-         *   //   "storageClass": "my_storageClass",
-         *   //   "temporaryHold": false,
-         *   //   "timeCreated": "my_timeCreated",
-         *   //   "timeDeleted": "my_timeDeleted",
-         *   //   "timeStorageClassUpdated": "my_timeStorageClassUpdated",
-         *   //   "updated": "my_updated"
-         *   // }
-         * }
-         *
-         * main().catch(e => {
-         *   console.error(e);
-         *   throw e;
-         * });
-         *
-         * ```
          *
          * @param params - Parameters for request
          * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -5201,132 +2113,6 @@ export declare namespace storage_v1 {
         patch(callback: BodyResponseCallback<Schema$Object>): void;
         /**
          * Rewrites a source object to a destination object. Optionally overrides metadata.
-         * @example
-         * ```js
-         * // Before running the sample:
-         * // - Enable the API at:
-         * //   https://console.developers.google.com/apis/api/storage.googleapis.com
-         * // - Login into gcloud by running:
-         * //   `$ gcloud auth application-default login`
-         * // - Install the npm module by running:
-         * //   `$ npm install googleapis`
-         *
-         * const {google} = require('googleapis');
-         * const storage = google.storage('v1');
-         *
-         * async function main() {
-         *   const auth = new google.auth.GoogleAuth({
-         *     // Scopes can be specified either as an array or as a single, space-delimited string.
-         *     scopes: [
-         *       'https://www.googleapis.com/auth/cloud-platform',
-         *       'https://www.googleapis.com/auth/devstorage.full_control',
-         *       'https://www.googleapis.com/auth/devstorage.read_write',
-         *     ],
-         *   });
-         *
-         *   // Acquire an auth client, and bind it to all future calls
-         *   const authClient = await auth.getClient();
-         *   google.options({auth: authClient});
-         *
-         *   // Do the magic
-         *   const res = await storage.objects.rewrite({
-         *     // Name of the bucket in which to store the new object. Overrides the provided object metadata's bucket value, if any.
-         *     destinationBucket: 'placeholder-value',
-         *     // Resource name of the Cloud KMS key, of the form projects/my-project/locations/global/keyRings/my-kr/cryptoKeys/my-key, that will be used to encrypt the object. Overrides the object metadata's kms_key_name value, if any.
-         *     destinationKmsKeyName: 'placeholder-value',
-         *     // Name of the new object. Required when the object metadata is not otherwise provided. Overrides the object metadata's name value, if any. For information about how to URL encode object names to be path safe, see [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-endpoints#encoding).
-         *     destinationObject: 'placeholder-value',
-         *     // Apply a predefined set of access controls to the destination object.
-         *     destinationPredefinedAcl: 'placeholder-value',
-         *     // Makes the operation conditional on whether the object's current generation matches the given value. Setting to 0 makes the operation succeed only if there are no live versions of the object.
-         *     ifGenerationMatch: 'placeholder-value',
-         *     // Makes the operation conditional on whether the object's current generation does not match the given value. If no live object exists, the precondition fails. Setting to 0 makes the operation succeed only if there is a live version of the object.
-         *     ifGenerationNotMatch: 'placeholder-value',
-         *     // Makes the operation conditional on whether the destination object's current metageneration matches the given value.
-         *     ifMetagenerationMatch: 'placeholder-value',
-         *     // Makes the operation conditional on whether the destination object's current metageneration does not match the given value.
-         *     ifMetagenerationNotMatch: 'placeholder-value',
-         *     // Makes the operation conditional on whether the source object's current generation matches the given value.
-         *     ifSourceGenerationMatch: 'placeholder-value',
-         *     // Makes the operation conditional on whether the source object's current generation does not match the given value.
-         *     ifSourceGenerationNotMatch: 'placeholder-value',
-         *     // Makes the operation conditional on whether the source object's current metageneration matches the given value.
-         *     ifSourceMetagenerationMatch: 'placeholder-value',
-         *     // Makes the operation conditional on whether the source object's current metageneration does not match the given value.
-         *     ifSourceMetagenerationNotMatch: 'placeholder-value',
-         *     // The maximum number of bytes that will be rewritten per rewrite request. Most callers shouldn't need to specify this parameter - it is primarily in place to support testing. If specified the value must be an integral multiple of 1 MiB (1048576). Also, this only applies to requests where the source and destination span locations and/or storage classes. Finally, this value must not change across rewrite calls else you'll get an error that the rewriteToken is invalid.
-         *     maxBytesRewrittenPerCall: 'placeholder-value',
-         *     // Set of properties to return. Defaults to noAcl, unless the object resource specifies the acl property, when it defaults to full.
-         *     projection: 'placeholder-value',
-         *     // Include this field (from the previous rewrite response) on each rewrite request after the first one, until the rewrite response 'done' flag is true. Calls that provide a rewriteToken can omit all other request fields, but if included those fields must match the values provided in the first rewrite request.
-         *     rewriteToken: 'placeholder-value',
-         *     // Name of the bucket in which to find the source object.
-         *     sourceBucket: 'placeholder-value',
-         *     // If present, selects a specific revision of the source object (as opposed to the latest version, the default).
-         *     sourceGeneration: 'placeholder-value',
-         *     // Name of the source object. For information about how to URL encode object names to be path safe, see [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-endpoints#encoding).
-         *     sourceObject: 'placeholder-value',
-         *     // The project to be billed for this request. Required for Requester Pays buckets.
-         *     userProject: 'placeholder-value',
-         *
-         *     // Request body metadata
-         *     requestBody: {
-         *       // request body parameters
-         *       // {
-         *       //   "acl": [],
-         *       //   "bucket": "my_bucket",
-         *       //   "cacheControl": "my_cacheControl",
-         *       //   "componentCount": 0,
-         *       //   "contentDisposition": "my_contentDisposition",
-         *       //   "contentEncoding": "my_contentEncoding",
-         *       //   "contentLanguage": "my_contentLanguage",
-         *       //   "contentType": "my_contentType",
-         *       //   "crc32c": "my_crc32c",
-         *       //   "customTime": "my_customTime",
-         *       //   "customerEncryption": {},
-         *       //   "etag": "my_etag",
-         *       //   "eventBasedHold": false,
-         *       //   "generation": "my_generation",
-         *       //   "id": "my_id",
-         *       //   "kind": "my_kind",
-         *       //   "kmsKeyName": "my_kmsKeyName",
-         *       //   "md5Hash": "my_md5Hash",
-         *       //   "mediaLink": "my_mediaLink",
-         *       //   "metadata": {},
-         *       //   "metageneration": "my_metageneration",
-         *       //   "name": "my_name",
-         *       //   "owner": {},
-         *       //   "retentionExpirationTime": "my_retentionExpirationTime",
-         *       //   "selfLink": "my_selfLink",
-         *       //   "size": "my_size",
-         *       //   "storageClass": "my_storageClass",
-         *       //   "temporaryHold": false,
-         *       //   "timeCreated": "my_timeCreated",
-         *       //   "timeDeleted": "my_timeDeleted",
-         *       //   "timeStorageClassUpdated": "my_timeStorageClassUpdated",
-         *       //   "updated": "my_updated"
-         *       // }
-         *     },
-         *   });
-         *   console.log(res.data);
-         *
-         *   // Example response
-         *   // {
-         *   //   "done": false,
-         *   //   "kind": "my_kind",
-         *   //   "objectSize": "my_objectSize",
-         *   //   "resource": {},
-         *   //   "rewriteToken": "my_rewriteToken",
-         *   //   "totalBytesRewritten": "my_totalBytesRewritten"
-         *   // }
-         * }
-         *
-         * main().catch(e => {
-         *   console.error(e);
-         *   throw e;
-         * });
-         *
-         * ```
          *
          * @param params - Parameters for request
          * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -5341,74 +2127,6 @@ export declare namespace storage_v1 {
         rewrite(callback: BodyResponseCallback<Schema$RewriteResponse>): void;
         /**
          * Updates an IAM policy for the specified object.
-         * @example
-         * ```js
-         * // Before running the sample:
-         * // - Enable the API at:
-         * //   https://console.developers.google.com/apis/api/storage.googleapis.com
-         * // - Login into gcloud by running:
-         * //   `$ gcloud auth application-default login`
-         * // - Install the npm module by running:
-         * //   `$ npm install googleapis`
-         *
-         * const {google} = require('googleapis');
-         * const storage = google.storage('v1');
-         *
-         * async function main() {
-         *   const auth = new google.auth.GoogleAuth({
-         *     // Scopes can be specified either as an array or as a single, space-delimited string.
-         *     scopes: [
-         *       'https://www.googleapis.com/auth/cloud-platform',
-         *       'https://www.googleapis.com/auth/devstorage.full_control',
-         *       'https://www.googleapis.com/auth/devstorage.read_write',
-         *     ],
-         *   });
-         *
-         *   // Acquire an auth client, and bind it to all future calls
-         *   const authClient = await auth.getClient();
-         *   google.options({auth: authClient});
-         *
-         *   // Do the magic
-         *   const res = await storage.objects.setIamPolicy({
-         *     // Name of the bucket in which the object resides.
-         *     bucket: 'placeholder-value',
-         *     // If present, selects a specific revision of this object (as opposed to the latest version, the default).
-         *     generation: 'placeholder-value',
-         *     // Name of the object. For information about how to URL encode object names to be path safe, see [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-endpoints#encoding).
-         *     object: 'placeholder-value',
-         *     // The project to be billed for this request. Required for Requester Pays buckets.
-         *     userProject: 'placeholder-value',
-         *
-         *     // Request body metadata
-         *     requestBody: {
-         *       // request body parameters
-         *       // {
-         *       //   "bindings": [],
-         *       //   "etag": "my_etag",
-         *       //   "kind": "my_kind",
-         *       //   "resourceId": "my_resourceId",
-         *       //   "version": 0
-         *       // }
-         *     },
-         *   });
-         *   console.log(res.data);
-         *
-         *   // Example response
-         *   // {
-         *   //   "bindings": [],
-         *   //   "etag": "my_etag",
-         *   //   "kind": "my_kind",
-         *   //   "resourceId": "my_resourceId",
-         *   //   "version": 0
-         *   // }
-         * }
-         *
-         * main().catch(e => {
-         *   console.error(e);
-         *   throw e;
-         * });
-         *
-         * ```
          *
          * @param params - Parameters for request
          * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -5423,63 +2141,6 @@ export declare namespace storage_v1 {
         setIamPolicy(callback: BodyResponseCallback<Schema$Policy>): void;
         /**
          * Tests a set of permissions on the given object to see which, if any, are held by the caller.
-         * @example
-         * ```js
-         * // Before running the sample:
-         * // - Enable the API at:
-         * //   https://console.developers.google.com/apis/api/storage.googleapis.com
-         * // - Login into gcloud by running:
-         * //   `$ gcloud auth application-default login`
-         * // - Install the npm module by running:
-         * //   `$ npm install googleapis`
-         *
-         * const {google} = require('googleapis');
-         * const storage = google.storage('v1');
-         *
-         * async function main() {
-         *   const auth = new google.auth.GoogleAuth({
-         *     // Scopes can be specified either as an array or as a single, space-delimited string.
-         *     scopes: [
-         *       'https://www.googleapis.com/auth/cloud-platform',
-         *       'https://www.googleapis.com/auth/cloud-platform.read-only',
-         *       'https://www.googleapis.com/auth/devstorage.full_control',
-         *       'https://www.googleapis.com/auth/devstorage.read_only',
-         *       'https://www.googleapis.com/auth/devstorage.read_write',
-         *     ],
-         *   });
-         *
-         *   // Acquire an auth client, and bind it to all future calls
-         *   const authClient = await auth.getClient();
-         *   google.options({auth: authClient});
-         *
-         *   // Do the magic
-         *   const res = await storage.objects.testIamPermissions({
-         *     // Name of the bucket in which the object resides.
-         *     bucket: 'placeholder-value',
-         *     // If present, selects a specific revision of this object (as opposed to the latest version, the default).
-         *     generation: 'placeholder-value',
-         *     // Name of the object. For information about how to URL encode object names to be path safe, see [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-endpoints#encoding).
-         *     object: 'placeholder-value',
-         *     // Permissions to test.
-         *     permissions: 'placeholder-value',
-         *     // The project to be billed for this request. Required for Requester Pays buckets.
-         *     userProject: 'placeholder-value',
-         *   });
-         *   console.log(res.data);
-         *
-         *   // Example response
-         *   // {
-         *   //   "kind": "my_kind",
-         *   //   "permissions": []
-         *   // }
-         * }
-         *
-         * main().catch(e => {
-         *   console.error(e);
-         *   throw e;
-         * });
-         *
-         * ```
          *
          * @param params - Parameters for request
          * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -5494,139 +2155,6 @@ export declare namespace storage_v1 {
         testIamPermissions(callback: BodyResponseCallback<Schema$TestIamPermissionsResponse>): void;
         /**
          * Updates an object's metadata.
-         * @example
-         * ```js
-         * // Before running the sample:
-         * // - Enable the API at:
-         * //   https://console.developers.google.com/apis/api/storage.googleapis.com
-         * // - Login into gcloud by running:
-         * //   `$ gcloud auth application-default login`
-         * // - Install the npm module by running:
-         * //   `$ npm install googleapis`
-         *
-         * const {google} = require('googleapis');
-         * const storage = google.storage('v1');
-         *
-         * async function main() {
-         *   const auth = new google.auth.GoogleAuth({
-         *     // Scopes can be specified either as an array or as a single, space-delimited string.
-         *     scopes: [
-         *       'https://www.googleapis.com/auth/cloud-platform',
-         *       'https://www.googleapis.com/auth/devstorage.full_control',
-         *     ],
-         *   });
-         *
-         *   // Acquire an auth client, and bind it to all future calls
-         *   const authClient = await auth.getClient();
-         *   google.options({auth: authClient});
-         *
-         *   // Do the magic
-         *   const res = await storage.objects.update({
-         *     // Name of the bucket in which the object resides.
-         *     bucket: 'placeholder-value',
-         *     // If present, selects a specific revision of this object (as opposed to the latest version, the default).
-         *     generation: 'placeholder-value',
-         *     // Makes the operation conditional on whether the object's current generation matches the given value. Setting to 0 makes the operation succeed only if there are no live versions of the object.
-         *     ifGenerationMatch: 'placeholder-value',
-         *     // Makes the operation conditional on whether the object's current generation does not match the given value. If no live object exists, the precondition fails. Setting to 0 makes the operation succeed only if there is a live version of the object.
-         *     ifGenerationNotMatch: 'placeholder-value',
-         *     // Makes the operation conditional on whether the object's current metageneration matches the given value.
-         *     ifMetagenerationMatch: 'placeholder-value',
-         *     // Makes the operation conditional on whether the object's current metageneration does not match the given value.
-         *     ifMetagenerationNotMatch: 'placeholder-value',
-         *     // Name of the object. For information about how to URL encode object names to be path safe, see [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-endpoints#encoding).
-         *     object: 'placeholder-value',
-         *     // Apply a predefined set of access controls to this object.
-         *     predefinedAcl: 'placeholder-value',
-         *     // Set of properties to return. Defaults to full.
-         *     projection: 'placeholder-value',
-         *     // The project to be billed for this request. Required for Requester Pays buckets.
-         *     userProject: 'placeholder-value',
-         *
-         *     // Request body metadata
-         *     requestBody: {
-         *       // request body parameters
-         *       // {
-         *       //   "acl": [],
-         *       //   "bucket": "my_bucket",
-         *       //   "cacheControl": "my_cacheControl",
-         *       //   "componentCount": 0,
-         *       //   "contentDisposition": "my_contentDisposition",
-         *       //   "contentEncoding": "my_contentEncoding",
-         *       //   "contentLanguage": "my_contentLanguage",
-         *       //   "contentType": "my_contentType",
-         *       //   "crc32c": "my_crc32c",
-         *       //   "customTime": "my_customTime",
-         *       //   "customerEncryption": {},
-         *       //   "etag": "my_etag",
-         *       //   "eventBasedHold": false,
-         *       //   "generation": "my_generation",
-         *       //   "id": "my_id",
-         *       //   "kind": "my_kind",
-         *       //   "kmsKeyName": "my_kmsKeyName",
-         *       //   "md5Hash": "my_md5Hash",
-         *       //   "mediaLink": "my_mediaLink",
-         *       //   "metadata": {},
-         *       //   "metageneration": "my_metageneration",
-         *       //   "name": "my_name",
-         *       //   "owner": {},
-         *       //   "retentionExpirationTime": "my_retentionExpirationTime",
-         *       //   "selfLink": "my_selfLink",
-         *       //   "size": "my_size",
-         *       //   "storageClass": "my_storageClass",
-         *       //   "temporaryHold": false,
-         *       //   "timeCreated": "my_timeCreated",
-         *       //   "timeDeleted": "my_timeDeleted",
-         *       //   "timeStorageClassUpdated": "my_timeStorageClassUpdated",
-         *       //   "updated": "my_updated"
-         *       // }
-         *     },
-         *   });
-         *   console.log(res.data);
-         *
-         *   // Example response
-         *   // {
-         *   //   "acl": [],
-         *   //   "bucket": "my_bucket",
-         *   //   "cacheControl": "my_cacheControl",
-         *   //   "componentCount": 0,
-         *   //   "contentDisposition": "my_contentDisposition",
-         *   //   "contentEncoding": "my_contentEncoding",
-         *   //   "contentLanguage": "my_contentLanguage",
-         *   //   "contentType": "my_contentType",
-         *   //   "crc32c": "my_crc32c",
-         *   //   "customTime": "my_customTime",
-         *   //   "customerEncryption": {},
-         *   //   "etag": "my_etag",
-         *   //   "eventBasedHold": false,
-         *   //   "generation": "my_generation",
-         *   //   "id": "my_id",
-         *   //   "kind": "my_kind",
-         *   //   "kmsKeyName": "my_kmsKeyName",
-         *   //   "md5Hash": "my_md5Hash",
-         *   //   "mediaLink": "my_mediaLink",
-         *   //   "metadata": {},
-         *   //   "metageneration": "my_metageneration",
-         *   //   "name": "my_name",
-         *   //   "owner": {},
-         *   //   "retentionExpirationTime": "my_retentionExpirationTime",
-         *   //   "selfLink": "my_selfLink",
-         *   //   "size": "my_size",
-         *   //   "storageClass": "my_storageClass",
-         *   //   "temporaryHold": false,
-         *   //   "timeCreated": "my_timeCreated",
-         *   //   "timeDeleted": "my_timeDeleted",
-         *   //   "timeStorageClassUpdated": "my_timeStorageClassUpdated",
-         *   //   "updated": "my_updated"
-         *   // }
-         * }
-         *
-         * main().catch(e => {
-         *   console.error(e);
-         *   throw e;
-         * });
-         *
-         * ```
          *
          * @param params - Parameters for request
          * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -5641,100 +2169,6 @@ export declare namespace storage_v1 {
         update(callback: BodyResponseCallback<Schema$Object>): void;
         /**
          * Watch for changes on all objects in a bucket.
-         * @example
-         * ```js
-         * // Before running the sample:
-         * // - Enable the API at:
-         * //   https://console.developers.google.com/apis/api/storage.googleapis.com
-         * // - Login into gcloud by running:
-         * //   `$ gcloud auth application-default login`
-         * // - Install the npm module by running:
-         * //   `$ npm install googleapis`
-         *
-         * const {google} = require('googleapis');
-         * const storage = google.storage('v1');
-         *
-         * async function main() {
-         *   const auth = new google.auth.GoogleAuth({
-         *     // Scopes can be specified either as an array or as a single, space-delimited string.
-         *     scopes: [
-         *       'https://www.googleapis.com/auth/cloud-platform',
-         *       'https://www.googleapis.com/auth/cloud-platform.read-only',
-         *       'https://www.googleapis.com/auth/devstorage.full_control',
-         *       'https://www.googleapis.com/auth/devstorage.read_only',
-         *       'https://www.googleapis.com/auth/devstorage.read_write',
-         *     ],
-         *   });
-         *
-         *   // Acquire an auth client, and bind it to all future calls
-         *   const authClient = await auth.getClient();
-         *   google.options({auth: authClient});
-         *
-         *   // Do the magic
-         *   const res = await storage.objects.watchAll({
-         *     // Name of the bucket in which to look for objects.
-         *     bucket: 'placeholder-value',
-         *     // Returns results in a directory-like mode. items will contain only objects whose names, aside from the prefix, do not contain delimiter. Objects whose names, aside from the prefix, contain delimiter will have their name, truncated after the delimiter, returned in prefixes. Duplicate prefixes are omitted.
-         *     delimiter: 'placeholder-value',
-         *     // Filter results to objects whose names are lexicographically before endOffset. If startOffset is also set, the objects listed will have names between startOffset (inclusive) and endOffset (exclusive).
-         *     endOffset: 'placeholder-value',
-         *     // If true, objects that end in exactly one instance of delimiter will have their metadata included in items in addition to prefixes.
-         *     includeTrailingDelimiter: 'placeholder-value',
-         *     // Maximum number of items plus prefixes to return in a single page of responses. As duplicate prefixes are omitted, fewer total results may be returned than requested. The service will use this parameter or 1,000 items, whichever is smaller.
-         *     maxResults: 'placeholder-value',
-         *     // A previously-returned page token representing part of the larger set of results to view.
-         *     pageToken: 'placeholder-value',
-         *     // Filter results to objects whose names begin with this prefix.
-         *     prefix: 'placeholder-value',
-         *     // Set of properties to return. Defaults to noAcl.
-         *     projection: 'placeholder-value',
-         *     // Filter results to objects whose names are lexicographically equal to or after startOffset. If endOffset is also set, the objects listed will have names between startOffset (inclusive) and endOffset (exclusive).
-         *     startOffset: 'placeholder-value',
-         *     // The project to be billed for this request. Required for Requester Pays buckets.
-         *     userProject: 'placeholder-value',
-         *     // If true, lists all versions of an object as distinct results. The default is false. For more information, see Object Versioning.
-         *     versions: 'placeholder-value',
-         *
-         *     // Request body metadata
-         *     requestBody: {
-         *       // request body parameters
-         *       // {
-         *       //   "address": "my_address",
-         *       //   "expiration": "my_expiration",
-         *       //   "id": "my_id",
-         *       //   "kind": "my_kind",
-         *       //   "params": {},
-         *       //   "payload": false,
-         *       //   "resourceId": "my_resourceId",
-         *       //   "resourceUri": "my_resourceUri",
-         *       //   "token": "my_token",
-         *       //   "type": "my_type"
-         *       // }
-         *     },
-         *   });
-         *   console.log(res.data);
-         *
-         *   // Example response
-         *   // {
-         *   //   "address": "my_address",
-         *   //   "expiration": "my_expiration",
-         *   //   "id": "my_id",
-         *   //   "kind": "my_kind",
-         *   //   "params": {},
-         *   //   "payload": false,
-         *   //   "resourceId": "my_resourceId",
-         *   //   "resourceUri": "my_resourceUri",
-         *   //   "token": "my_token",
-         *   //   "type": "my_type"
-         *   // }
-         * }
-         *
-         * main().catch(e => {
-         *   console.error(e);
-         *   throw e;
-         * });
-         *
-         * ```
          *
          * @param params - Parameters for request
          * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -6338,57 +2772,6 @@ export declare namespace storage_v1 {
         constructor(context: APIRequestContext);
         /**
          * Creates a new HMAC key for the specified service account.
-         * @example
-         * ```js
-         * // Before running the sample:
-         * // - Enable the API at:
-         * //   https://console.developers.google.com/apis/api/storage.googleapis.com
-         * // - Login into gcloud by running:
-         * //   `$ gcloud auth application-default login`
-         * // - Install the npm module by running:
-         * //   `$ npm install googleapis`
-         *
-         * const {google} = require('googleapis');
-         * const storage = google.storage('v1');
-         *
-         * async function main() {
-         *   const auth = new google.auth.GoogleAuth({
-         *     // Scopes can be specified either as an array or as a single, space-delimited string.
-         *     scopes: [
-         *       'https://www.googleapis.com/auth/cloud-platform',
-         *       'https://www.googleapis.com/auth/devstorage.full_control',
-         *     ],
-         *   });
-         *
-         *   // Acquire an auth client, and bind it to all future calls
-         *   const authClient = await auth.getClient();
-         *   google.options({auth: authClient});
-         *
-         *   // Do the magic
-         *   const res = await storage.projects.hmacKeys.create({
-         *     // Project ID owning the service account.
-         *     projectId: 'placeholder-value',
-         *     // Email address of the service account.
-         *     serviceAccountEmail: 'placeholder-value',
-         *     // The project to be billed for this request.
-         *     userProject: 'placeholder-value',
-         *   });
-         *   console.log(res.data);
-         *
-         *   // Example response
-         *   // {
-         *   //   "kind": "my_kind",
-         *   //   "metadata": {},
-         *   //   "secret": "my_secret"
-         *   // }
-         * }
-         *
-         * main().catch(e => {
-         *   console.error(e);
-         *   throw e;
-         * });
-         *
-         * ```
          *
          * @param params - Parameters for request
          * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -6403,51 +2786,6 @@ export declare namespace storage_v1 {
         create(callback: BodyResponseCallback<Schema$HmacKey>): void;
         /**
          * Deletes an HMAC key.
-         * @example
-         * ```js
-         * // Before running the sample:
-         * // - Enable the API at:
-         * //   https://console.developers.google.com/apis/api/storage.googleapis.com
-         * // - Login into gcloud by running:
-         * //   `$ gcloud auth application-default login`
-         * // - Install the npm module by running:
-         * //   `$ npm install googleapis`
-         *
-         * const {google} = require('googleapis');
-         * const storage = google.storage('v1');
-         *
-         * async function main() {
-         *   const auth = new google.auth.GoogleAuth({
-         *     // Scopes can be specified either as an array or as a single, space-delimited string.
-         *     scopes: [
-         *       'https://www.googleapis.com/auth/cloud-platform',
-         *       'https://www.googleapis.com/auth/devstorage.full_control',
-         *       'https://www.googleapis.com/auth/devstorage.read_write',
-         *     ],
-         *   });
-         *
-         *   // Acquire an auth client, and bind it to all future calls
-         *   const authClient = await auth.getClient();
-         *   google.options({auth: authClient});
-         *
-         *   // Do the magic
-         *   const res = await storage.projects.hmacKeys.delete({
-         *     // Name of the HMAC key to be deleted.
-         *     accessId: 'placeholder-value',
-         *     // Project ID owning the requested key
-         *     projectId: 'placeholder-value',
-         *     // The project to be billed for this request.
-         *     userProject: 'placeholder-value',
-         *   });
-         *   console.log(res.data);
-         * }
-         *
-         * main().catch(e => {
-         *   console.error(e);
-         *   throw e;
-         * });
-         *
-         * ```
          *
          * @param params - Parameters for request
          * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -6462,66 +2800,6 @@ export declare namespace storage_v1 {
         delete(callback: BodyResponseCallback<void>): void;
         /**
          * Retrieves an HMAC key's metadata
-         * @example
-         * ```js
-         * // Before running the sample:
-         * // - Enable the API at:
-         * //   https://console.developers.google.com/apis/api/storage.googleapis.com
-         * // - Login into gcloud by running:
-         * //   `$ gcloud auth application-default login`
-         * // - Install the npm module by running:
-         * //   `$ npm install googleapis`
-         *
-         * const {google} = require('googleapis');
-         * const storage = google.storage('v1');
-         *
-         * async function main() {
-         *   const auth = new google.auth.GoogleAuth({
-         *     // Scopes can be specified either as an array or as a single, space-delimited string.
-         *     scopes: [
-         *       'https://www.googleapis.com/auth/cloud-platform',
-         *       'https://www.googleapis.com/auth/cloud-platform.read-only',
-         *       'https://www.googleapis.com/auth/devstorage.full_control',
-         *       'https://www.googleapis.com/auth/devstorage.read_only',
-         *     ],
-         *   });
-         *
-         *   // Acquire an auth client, and bind it to all future calls
-         *   const authClient = await auth.getClient();
-         *   google.options({auth: authClient});
-         *
-         *   // Do the magic
-         *   const res = await storage.projects.hmacKeys.get({
-         *     // Name of the HMAC key.
-         *     accessId: 'placeholder-value',
-         *     // Project ID owning the service account of the requested key.
-         *     projectId: 'placeholder-value',
-         *     // The project to be billed for this request.
-         *     userProject: 'placeholder-value',
-         *   });
-         *   console.log(res.data);
-         *
-         *   // Example response
-         *   // {
-         *   //   "accessId": "my_accessId",
-         *   //   "etag": "my_etag",
-         *   //   "id": "my_id",
-         *   //   "kind": "my_kind",
-         *   //   "projectId": "my_projectId",
-         *   //   "selfLink": "my_selfLink",
-         *   //   "serviceAccountEmail": "my_serviceAccountEmail",
-         *   //   "state": "my_state",
-         *   //   "timeCreated": "my_timeCreated",
-         *   //   "updated": "my_updated"
-         *   // }
-         * }
-         *
-         * main().catch(e => {
-         *   console.error(e);
-         *   throw e;
-         * });
-         *
-         * ```
          *
          * @param params - Parameters for request
          * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -6536,65 +2814,6 @@ export declare namespace storage_v1 {
         get(callback: BodyResponseCallback<Schema$HmacKeyMetadata>): void;
         /**
          * Retrieves a list of HMAC keys matching the criteria.
-         * @example
-         * ```js
-         * // Before running the sample:
-         * // - Enable the API at:
-         * //   https://console.developers.google.com/apis/api/storage.googleapis.com
-         * // - Login into gcloud by running:
-         * //   `$ gcloud auth application-default login`
-         * // - Install the npm module by running:
-         * //   `$ npm install googleapis`
-         *
-         * const {google} = require('googleapis');
-         * const storage = google.storage('v1');
-         *
-         * async function main() {
-         *   const auth = new google.auth.GoogleAuth({
-         *     // Scopes can be specified either as an array or as a single, space-delimited string.
-         *     scopes: [
-         *       'https://www.googleapis.com/auth/cloud-platform',
-         *       'https://www.googleapis.com/auth/cloud-platform.read-only',
-         *       'https://www.googleapis.com/auth/devstorage.full_control',
-         *       'https://www.googleapis.com/auth/devstorage.read_only',
-         *     ],
-         *   });
-         *
-         *   // Acquire an auth client, and bind it to all future calls
-         *   const authClient = await auth.getClient();
-         *   google.options({auth: authClient});
-         *
-         *   // Do the magic
-         *   const res = await storage.projects.hmacKeys.list({
-         *     // Maximum number of items to return in a single page of responses. The service uses this parameter or 250 items, whichever is smaller. The max number of items per page will also be limited by the number of distinct service accounts in the response. If the number of service accounts in a single response is too high, the page will truncated and a next page token will be returned.
-         *     maxResults: 'placeholder-value',
-         *     // A previously-returned page token representing part of the larger set of results to view.
-         *     pageToken: 'placeholder-value',
-         *     // Name of the project in which to look for HMAC keys.
-         *     projectId: 'placeholder-value',
-         *     // If present, only keys for the given service account are returned.
-         *     serviceAccountEmail: 'placeholder-value',
-         *     // Whether or not to show keys in the DELETED state.
-         *     showDeletedKeys: 'placeholder-value',
-         *     // The project to be billed for this request.
-         *     userProject: 'placeholder-value',
-         *   });
-         *   console.log(res.data);
-         *
-         *   // Example response
-         *   // {
-         *   //   "items": [],
-         *   //   "kind": "my_kind",
-         *   //   "nextPageToken": "my_nextPageToken"
-         *   // }
-         * }
-         *
-         * main().catch(e => {
-         *   console.error(e);
-         *   throw e;
-         * });
-         *
-         * ```
          *
          * @param params - Parameters for request
          * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -6609,81 +2828,6 @@ export declare namespace storage_v1 {
         list(callback: BodyResponseCallback<Schema$HmacKeysMetadata>): void;
         /**
          * Updates the state of an HMAC key. See the HMAC Key resource descriptor for valid states.
-         * @example
-         * ```js
-         * // Before running the sample:
-         * // - Enable the API at:
-         * //   https://console.developers.google.com/apis/api/storage.googleapis.com
-         * // - Login into gcloud by running:
-         * //   `$ gcloud auth application-default login`
-         * // - Install the npm module by running:
-         * //   `$ npm install googleapis`
-         *
-         * const {google} = require('googleapis');
-         * const storage = google.storage('v1');
-         *
-         * async function main() {
-         *   const auth = new google.auth.GoogleAuth({
-         *     // Scopes can be specified either as an array or as a single, space-delimited string.
-         *     scopes: [
-         *       'https://www.googleapis.com/auth/cloud-platform',
-         *       'https://www.googleapis.com/auth/devstorage.full_control',
-         *     ],
-         *   });
-         *
-         *   // Acquire an auth client, and bind it to all future calls
-         *   const authClient = await auth.getClient();
-         *   google.options({auth: authClient});
-         *
-         *   // Do the magic
-         *   const res = await storage.projects.hmacKeys.update({
-         *     // Name of the HMAC key being updated.
-         *     accessId: 'placeholder-value',
-         *     // Project ID owning the service account of the updated key.
-         *     projectId: 'placeholder-value',
-         *     // The project to be billed for this request.
-         *     userProject: 'placeholder-value',
-         *
-         *     // Request body metadata
-         *     requestBody: {
-         *       // request body parameters
-         *       // {
-         *       //   "accessId": "my_accessId",
-         *       //   "etag": "my_etag",
-         *       //   "id": "my_id",
-         *       //   "kind": "my_kind",
-         *       //   "projectId": "my_projectId",
-         *       //   "selfLink": "my_selfLink",
-         *       //   "serviceAccountEmail": "my_serviceAccountEmail",
-         *       //   "state": "my_state",
-         *       //   "timeCreated": "my_timeCreated",
-         *       //   "updated": "my_updated"
-         *       // }
-         *     },
-         *   });
-         *   console.log(res.data);
-         *
-         *   // Example response
-         *   // {
-         *   //   "accessId": "my_accessId",
-         *   //   "etag": "my_etag",
-         *   //   "id": "my_id",
-         *   //   "kind": "my_kind",
-         *   //   "projectId": "my_projectId",
-         *   //   "selfLink": "my_selfLink",
-         *   //   "serviceAccountEmail": "my_serviceAccountEmail",
-         *   //   "state": "my_state",
-         *   //   "timeCreated": "my_timeCreated",
-         *   //   "updated": "my_updated"
-         *   // }
-         * }
-         *
-         * main().catch(e => {
-         *   console.error(e);
-         *   throw e;
-         * });
-         *
-         * ```
          *
          * @param params - Parameters for request
          * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -6788,57 +2932,6 @@ export declare namespace storage_v1 {
         constructor(context: APIRequestContext);
         /**
          * Get the email address of this project's Google Cloud Storage service account.
-         * @example
-         * ```js
-         * // Before running the sample:
-         * // - Enable the API at:
-         * //   https://console.developers.google.com/apis/api/storage.googleapis.com
-         * // - Login into gcloud by running:
-         * //   `$ gcloud auth application-default login`
-         * // - Install the npm module by running:
-         * //   `$ npm install googleapis`
-         *
-         * const {google} = require('googleapis');
-         * const storage = google.storage('v1');
-         *
-         * async function main() {
-         *   const auth = new google.auth.GoogleAuth({
-         *     // Scopes can be specified either as an array or as a single, space-delimited string.
-         *     scopes: [
-         *       'https://www.googleapis.com/auth/cloud-platform',
-         *       'https://www.googleapis.com/auth/cloud-platform.read-only',
-         *       'https://www.googleapis.com/auth/devstorage.full_control',
-         *       'https://www.googleapis.com/auth/devstorage.read_only',
-         *       'https://www.googleapis.com/auth/devstorage.read_write',
-         *     ],
-         *   });
-         *
-         *   // Acquire an auth client, and bind it to all future calls
-         *   const authClient = await auth.getClient();
-         *   google.options({auth: authClient});
-         *
-         *   // Do the magic
-         *   const res = await storage.projects.serviceAccount.get({
-         *     // Project ID
-         *     projectId: 'placeholder-value',
-         *     // The project to be billed for this request.
-         *     userProject: 'placeholder-value',
-         *   });
-         *   console.log(res.data);
-         *
-         *   // Example response
-         *   // {
-         *   //   "email_address": "my_email_address",
-         *   //   "kind": "my_kind"
-         *   // }
-         * }
-         *
-         * main().catch(e => {
-         *   console.error(e);
-         *   throw e;
-         * });
-         *
-         * ```
          *
          * @param params - Parameters for request
          * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.