@googleapis/sheets 10.0.1 → 12.0.0

package/build/v4.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="node" />
 import { OAuth2Client, JWT, Compute, UserRefreshClient, BaseExternalAccountClient, GaxiosResponseWithHTTP2, GoogleConfigurable, MethodOptions, StreamMethodOptions, GlobalOptions, GoogleAuth, BodyResponseCallback, APIRequestContext } from 'googleapis-common';
 import { Readable } from 'stream';
 export declare namespace sheets_v4 {
@@ -259,6 +258,15 @@ export declare namespace sheets_v4 {
          */
         table?: Schema$Table;
     }
+    /**
+     * The result of adding a table.
+     */
+    export interface Schema$AddTableResponse {
+        /**
+         * Output only. The table that was added.
+         */
+        table?: Schema$Table;
+    }
     /**
      * Adds new cells after the last row with data in a sheet, inserting new rows into the sheet if necessary.
      */
@@ -349,9 +357,13 @@ export declare namespace sheets_v4 {
      */
     export interface Schema$BandedRange {
         /**
-         * The ID of the banded range.
+         * The ID of the banded range. If unset, refer to banded_range_reference.
          */
         bandedRangeId?: number | null;
+        /**
+         * Output only. The reference of the banded range, used to identify the ID that is not supported by the banded_range_id.
+         */
+        bandedRangeReference?: string | null;
         /**
          * Properties for column bands. These properties are applied on a column- by-column basis throughout all the columns in the range. At least one of row_properties or column_properties must be specified.
          */
@@ -1119,6 +1131,10 @@ export declare namespace sheets_v4 {
      * Data about a specific cell.
      */
     export interface Schema$CellData {
+        /**
+         * Optional. Runs of chips applied to subsections of the cell. Properties of a run start at a specific index in the text and continue until the next run. When reading, all chipped and non-chipped runs are included. Non-chipped runs will have an empty Chip. When writing, only runs with chips are included. Runs containing chips are of length 1 and are represented in the user-entered text by an “@” placeholder symbol. New runs will overwrite any prior runs. Writing a new user_entered_value will erase previous runs.
+         */
+        chipRuns?: Schema$ChipRun[];
         /**
          * Output only. Information about a data source formula on the cell. The field is set if user_entered_value is a formula referencing some DATA_SOURCE sheet, e.g. `=SUM(DataSheet!Column)`.
          */
@@ -1421,6 +1437,32 @@ export declare namespace sheets_v4 {
          */
         waterfallChart?: Schema$WaterfallChartSpec;
     }
+    /**
+     * The Smart Chip.
+     */
+    export interface Schema$Chip {
+        /**
+         * Properties of a linked person.
+         */
+        personProperties?: Schema$PersonProperties;
+        /**
+         * Properties of a rich link.
+         */
+        richLinkProperties?: Schema$RichLinkProperties;
+    }
+    /**
+     * The run of a chip. The chip continues until the start index of the next run.
+     */
+    export interface Schema$ChipRun {
+        /**
+         * Optional. The chip of this run.
+         */
+        chip?: Schema$Chip;
+        /**
+         * Required. The zero-based character index where this run starts, in UTF-16 code units.
+         */
+        startIndex?: number | null;
+    }
     /**
      * Clears the basic filter, if any exists on the sheet.
      */
@@ -3098,6 +3140,19 @@ export declare namespace sheets_v4 {
          */
         type?: string | null;
     }
+    /**
+     * Properties specific to a linked person.
+     */
+    export interface Schema$PersonProperties {
+        /**
+         * Optional. The display format of the person chip. If not set, the default display format is used.
+         */
+        displayFormat?: string | null;
+        /**
+         * Required. The email address linked to this person. This field is always present.
+         */
+        email?: string | null;
+    }
     /**
      * A pie chart.
      */
@@ -3787,6 +3842,10 @@ export declare namespace sheets_v4 {
          * A reply from adding a slicer.
          */
         addSlicer?: Schema$AddSlicerResponse;
+        /**
+         * A reply from adding a table.
+         */
+        addTable?: Schema$AddTableResponse;
         /**
          * A reply from cancelling data source object refreshes.
          */
@@ -3848,6 +3907,19 @@ export declare namespace sheets_v4 {
          */
         updateEmbeddedObjectPosition?: Schema$UpdateEmbeddedObjectPositionResponse;
     }
+    /**
+     * Properties of a link to a Google resource (such as a file in Drive, a YouTube video, a Maps address, or a Calendar event). Only Drive files can be written as chips. All other rich link types are read only. URIs cannot exceed 2000 bytes when writing. NOTE: Writing Drive file chips requires at least one of the `drive.file`, `drive.readonly`, or `drive` OAuth scopes.
+     */
+    export interface Schema$RichLinkProperties {
+        /**
+         * Output only. The [MIME type](https://developers.google.com/drive/api/v3/mime-types) of the link, if there's one (for example, when it's a file in Drive).
+         */
+        mimeType?: string | null;
+        /**
+         * Required. The URI to the link. This is always present.
+         */
+        uri?: string | null;
+    }
     /**
      * Data about each cell in a row.
      */
@@ -5118,6 +5190,69 @@ export declare namespace sheets_v4 {
         constructor(context: APIRequestContext);
         /**
          * Applies one or more updates to the spreadsheet. Each request is validated before being applied. If any request is not valid then the entire request will fail and nothing will be applied. Some requests have replies to give you some information about how they are applied. The replies will mirror the requests. For example, if you applied 4 updates and the 3rd one had a reply, then the response will have 2 empty replies, the actual reply, and another empty reply, in that order. Due to the collaborative nature of spreadsheets, it is not guaranteed that the spreadsheet will reflect exactly your changes after this completes, however it is guaranteed that the updates in the request will be applied together atomically. Your changes may be altered with respect to collaborator changes. If there are no collaborators, the spreadsheet should reflect your changes.
+         * @example
+         * ```js
+         * // Before running the sample:
+         * // - Enable the API at:
+         * //   https://console.developers.google.com/apis/api/sheets.googleapis.com
+         * // - Login into gcloud by running:
+         * //   ```sh
+         * //   $ gcloud auth application-default login
+         * //   ```
+         * // - Install the npm module by running:
+         * //   ```sh
+         * //   $ npm install googleapis
+         * //   ```
+         *
+         * const {google} = require('googleapis');
+         * const sheets = google.sheets('v4');
+         *
+         * 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/drive',
+         *       'https://www.googleapis.com/auth/drive.file',
+         *       'https://www.googleapis.com/auth/spreadsheets',
+         *     ],
+         *   });
+         *
+         *   // 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 sheets.spreadsheets.batchUpdate({
+         *     // The spreadsheet to apply the updates to.
+         *     spreadsheetId: 'placeholder-value',
+         *
+         *     // Request body metadata
+         *     requestBody: {
+         *       // request body parameters
+         *       // {
+         *       //   "includeSpreadsheetInResponse": false,
+         *       //   "requests": [],
+         *       //   "responseIncludeGridData": false,
+         *       //   "responseRanges": []
+         *       // }
+         *     },
+         *   });
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {
+         *   //   "replies": [],
+         *   //   "spreadsheetId": "my_spreadsheetId",
+         *   //   "updatedSpreadsheet": {}
+         *   // }
+         * }
+         *
+         * 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`.
@@ -5132,6 +5267,75 @@ export declare namespace sheets_v4 {
         batchUpdate(callback: BodyResponseCallback<Schema$BatchUpdateSpreadsheetResponse>): void;
         /**
          * Creates a spreadsheet, returning the newly created spreadsheet.
+         * @example
+         * ```js
+         * // Before running the sample:
+         * // - Enable the API at:
+         * //   https://console.developers.google.com/apis/api/sheets.googleapis.com
+         * // - Login into gcloud by running:
+         * //   ```sh
+         * //   $ gcloud auth application-default login
+         * //   ```
+         * // - Install the npm module by running:
+         * //   ```sh
+         * //   $ npm install googleapis
+         * //   ```
+         *
+         * const {google} = require('googleapis');
+         * const sheets = google.sheets('v4');
+         *
+         * 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/drive',
+         *       'https://www.googleapis.com/auth/drive.file',
+         *       'https://www.googleapis.com/auth/spreadsheets',
+         *     ],
+         *   });
+         *
+         *   // 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 sheets.spreadsheets.create({
+         *     // Request body metadata
+         *     requestBody: {
+         *       // request body parameters
+         *       // {
+         *       //   "dataSourceSchedules": [],
+         *       //   "dataSources": [],
+         *       //   "developerMetadata": [],
+         *       //   "namedRanges": [],
+         *       //   "properties": {},
+         *       //   "sheets": [],
+         *       //   "spreadsheetId": "my_spreadsheetId",
+         *       //   "spreadsheetUrl": "my_spreadsheetUrl"
+         *       // }
+         *     },
+         *   });
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {
+         *   //   "dataSourceSchedules": [],
+         *   //   "dataSources": [],
+         *   //   "developerMetadata": [],
+         *   //   "namedRanges": [],
+         *   //   "properties": {},
+         *   //   "sheets": [],
+         *   //   "spreadsheetId": "my_spreadsheetId",
+         *   //   "spreadsheetUrl": "my_spreadsheetUrl"
+         *   // }
+         * }
+         *
+         * 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`.
@@ -5146,6 +5350,71 @@ export declare namespace sheets_v4 {
         create(callback: BodyResponseCallback<Schema$Spreadsheet>): void;
         /**
          * Returns the spreadsheet at the given ID. The caller must specify the spreadsheet ID. By default, data within grids is not returned. You can include grid data in one of 2 ways: * Specify a [field mask](https://developers.google.com/workspace/sheets/api/guides/field-masks) listing your desired fields using the `fields` URL parameter in HTTP * Set the includeGridData URL parameter to true. If a field mask is set, the `includeGridData` parameter is ignored For large spreadsheets, as a best practice, retrieve only the specific spreadsheet fields that you want. To retrieve only subsets of spreadsheet data, use the ranges URL parameter. Ranges are specified using [A1 notation](https://developers.google.com/workspace/sheets/api/guides/concepts#cell). You can define a single cell (for example, `A1`) or multiple cells (for example, `A1:D5`). You can also get cells from other sheets within the same spreadsheet (for example, `Sheet2!A1:C4`) or retrieve multiple ranges at once (for example, `?ranges=A1:D5&ranges=Sheet2!A1:C4`). Limiting the range returns only the portions of the spreadsheet that intersect the requested ranges.
+         * @example
+         * ```js
+         * // Before running the sample:
+         * // - Enable the API at:
+         * //   https://console.developers.google.com/apis/api/sheets.googleapis.com
+         * // - Login into gcloud by running:
+         * //   ```sh
+         * //   $ gcloud auth application-default login
+         * //   ```
+         * // - Install the npm module by running:
+         * //   ```sh
+         * //   $ npm install googleapis
+         * //   ```
+         *
+         * const {google} = require('googleapis');
+         * const sheets = google.sheets('v4');
+         *
+         * 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/drive',
+         *       'https://www.googleapis.com/auth/drive.file',
+         *       'https://www.googleapis.com/auth/drive.readonly',
+         *       'https://www.googleapis.com/auth/spreadsheets',
+         *       'https://www.googleapis.com/auth/spreadsheets.readonly',
+         *     ],
+         *   });
+         *
+         *   // 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 sheets.spreadsheets.get({
+         *     // True if tables should be excluded in the banded ranges. False if not set.
+         *     excludeTablesInBandedRanges: 'placeholder-value',
+         *     // True if grid data should be returned. This parameter is ignored if a field mask was set in the request.
+         *     includeGridData: 'placeholder-value',
+         *     // The ranges to retrieve from the spreadsheet.
+         *     ranges: 'placeholder-value',
+         *     // The spreadsheet to request.
+         *     spreadsheetId: 'placeholder-value',
+         *   });
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {
+         *   //   "dataSourceSchedules": [],
+         *   //   "dataSources": [],
+         *   //   "developerMetadata": [],
+         *   //   "namedRanges": [],
+         *   //   "properties": {},
+         *   //   "sheets": [],
+         *   //   "spreadsheetId": "my_spreadsheetId",
+         *   //   "spreadsheetUrl": "my_spreadsheetUrl"
+         *   // }
+         * }
+         *
+         * 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`.
@@ -5160,6 +5429,73 @@ export declare namespace sheets_v4 {
         get(callback: BodyResponseCallback<Schema$Spreadsheet>): void;
         /**
          * Returns the spreadsheet at the given ID. The caller must specify the spreadsheet ID. This method differs from GetSpreadsheet in that it allows selecting which subsets of spreadsheet data to return by specifying a dataFilters parameter. Multiple DataFilters can be specified. Specifying one or more data filters returns the portions of the spreadsheet that intersect ranges matched by any of the filters. By default, data within grids is not returned. You can include grid data one of 2 ways: * Specify a [field mask](https://developers.google.com/workspace/sheets/api/guides/field-masks) listing your desired fields using the `fields` URL parameter in HTTP * Set the includeGridData parameter to true. If a field mask is set, the `includeGridData` parameter is ignored For large spreadsheets, as a best practice, retrieve only the specific spreadsheet fields that you want.
+         * @example
+         * ```js
+         * // Before running the sample:
+         * // - Enable the API at:
+         * //   https://console.developers.google.com/apis/api/sheets.googleapis.com
+         * // - Login into gcloud by running:
+         * //   ```sh
+         * //   $ gcloud auth application-default login
+         * //   ```
+         * // - Install the npm module by running:
+         * //   ```sh
+         * //   $ npm install googleapis
+         * //   ```
+         *
+         * const {google} = require('googleapis');
+         * const sheets = google.sheets('v4');
+         *
+         * 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/drive',
+         *       'https://www.googleapis.com/auth/drive.file',
+         *       'https://www.googleapis.com/auth/spreadsheets',
+         *     ],
+         *   });
+         *
+         *   // 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 sheets.spreadsheets.getByDataFilter({
+         *     // The spreadsheet to request.
+         *     spreadsheetId: 'placeholder-value',
+         *
+         *     // Request body metadata
+         *     requestBody: {
+         *       // request body parameters
+         *       // {
+         *       //   "dataFilters": [],
+         *       //   "excludeTablesInBandedRanges": false,
+         *       //   "includeGridData": false
+         *       // }
+         *     },
+         *   });
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {
+         *   //   "dataSourceSchedules": [],
+         *   //   "dataSources": [],
+         *   //   "developerMetadata": [],
+         *   //   "namedRanges": [],
+         *   //   "properties": {},
+         *   //   "sheets": [],
+         *   //   "spreadsheetId": "my_spreadsheetId",
+         *   //   "spreadsheetUrl": "my_spreadsheetUrl"
+         *   // }
+         * }
+         *
+         * 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`.
@@ -5222,6 +5558,62 @@ export declare namespace sheets_v4 {
         constructor(context: APIRequestContext);
         /**
          * Returns the developer metadata with the specified ID. The caller must specify the spreadsheet ID and the developer metadata's unique metadataId.
+         * @example
+         * ```js
+         * // Before running the sample:
+         * // - Enable the API at:
+         * //   https://console.developers.google.com/apis/api/sheets.googleapis.com
+         * // - Login into gcloud by running:
+         * //   ```sh
+         * //   $ gcloud auth application-default login
+         * //   ```
+         * // - Install the npm module by running:
+         * //   ```sh
+         * //   $ npm install googleapis
+         * //   ```
+         *
+         * const {google} = require('googleapis');
+         * const sheets = google.sheets('v4');
+         *
+         * 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/drive',
+         *       'https://www.googleapis.com/auth/drive.file',
+         *       'https://www.googleapis.com/auth/spreadsheets',
+         *     ],
+         *   });
+         *
+         *   // 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 sheets.spreadsheets.developerMetadata.get({
+         *     // The ID of the developer metadata to retrieve.
+         *     metadataId: 'placeholder-value',
+         *     // The ID of the spreadsheet to retrieve metadata from.
+         *     spreadsheetId: 'placeholder-value',
+         *   });
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {
+         *   //   "location": {},
+         *   //   "metadataId": 0,
+         *   //   "metadataKey": "my_metadataKey",
+         *   //   "metadataValue": "my_metadataValue",
+         *   //   "visibility": "my_visibility"
+         *   // }
+         * }
+         *
+         * 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`.
@@ -5236,6 +5628,64 @@ export declare namespace sheets_v4 {
         get(callback: BodyResponseCallback<Schema$DeveloperMetadata>): void;
         /**
          * Returns all developer metadata matching the specified DataFilter. If the provided DataFilter represents a DeveloperMetadataLookup object, this will return all DeveloperMetadata entries selected by it. If the DataFilter represents a location in a spreadsheet, this will return all developer metadata associated with locations intersecting that region.
+         * @example
+         * ```js
+         * // Before running the sample:
+         * // - Enable the API at:
+         * //   https://console.developers.google.com/apis/api/sheets.googleapis.com
+         * // - Login into gcloud by running:
+         * //   ```sh
+         * //   $ gcloud auth application-default login
+         * //   ```
+         * // - Install the npm module by running:
+         * //   ```sh
+         * //   $ npm install googleapis
+         * //   ```
+         *
+         * const {google} = require('googleapis');
+         * const sheets = google.sheets('v4');
+         *
+         * 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/drive',
+         *       'https://www.googleapis.com/auth/drive.file',
+         *       'https://www.googleapis.com/auth/spreadsheets',
+         *     ],
+         *   });
+         *
+         *   // 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 sheets.spreadsheets.developerMetadata.search({
+         *     // The ID of the spreadsheet to retrieve metadata from.
+         *     spreadsheetId: 'placeholder-value',
+         *
+         *     // Request body metadata
+         *     requestBody: {
+         *       // request body parameters
+         *       // {
+         *       //   "dataFilters": []
+         *       // }
+         *     },
+         *   });
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {
+         *   //   "matchedDeveloperMetadata": []
+         *   // }
+         * }
+         *
+         * 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`.
@@ -5274,6 +5724,75 @@ export declare namespace sheets_v4 {
         constructor(context: APIRequestContext);
         /**
          * Copies a single sheet from a spreadsheet to another spreadsheet. Returns the properties of the newly created sheet.
+         * @example
+         * ```js
+         * // Before running the sample:
+         * // - Enable the API at:
+         * //   https://console.developers.google.com/apis/api/sheets.googleapis.com
+         * // - Login into gcloud by running:
+         * //   ```sh
+         * //   $ gcloud auth application-default login
+         * //   ```
+         * // - Install the npm module by running:
+         * //   ```sh
+         * //   $ npm install googleapis
+         * //   ```
+         *
+         * const {google} = require('googleapis');
+         * const sheets = google.sheets('v4');
+         *
+         * 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/drive',
+         *       'https://www.googleapis.com/auth/drive.file',
+         *       'https://www.googleapis.com/auth/spreadsheets',
+         *     ],
+         *   });
+         *
+         *   // 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 sheets.spreadsheets.sheets.copyTo({
+         *     // The ID of the sheet to copy.
+         *     sheetId: 'placeholder-value',
+         *     // The ID of the spreadsheet containing the sheet to copy.
+         *     spreadsheetId: 'placeholder-value',
+         *
+         *     // Request body metadata
+         *     requestBody: {
+         *       // request body parameters
+         *       // {
+         *       //   "destinationSpreadsheetId": "my_destinationSpreadsheetId"
+         *       // }
+         *     },
+         *   });
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {
+         *   //   "dataSourceSheetProperties": {},
+         *   //   "gridProperties": {},
+         *   //   "hidden": false,
+         *   //   "index": 0,
+         *   //   "rightToLeft": false,
+         *   //   "sheetId": 0,
+         *   //   "sheetType": "my_sheetType",
+         *   //   "tabColor": {},
+         *   //   "tabColorStyle": {},
+         *   //   "title": "my_title"
+         *   // }
+         * }
+         *
+         * 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`.
@@ -5306,6 +5825,80 @@ export declare namespace sheets_v4 {
         constructor(context: APIRequestContext);
         /**
          * Appends values to a spreadsheet. The input range is used to search for existing data and find a "table" within that range. Values will be appended to the next row of the table, starting with the first column of the table. See the [guide](https://developers.google.com/workspace/sheets/api/guides/values#appending_values) and [sample code](https://developers.google.com/workspace/sheets/api/samples/writing#append_values) for specific details of how tables are detected and data is appended. The caller must specify the spreadsheet ID, range, and a valueInputOption. The `valueInputOption` only controls how the input data will be added to the sheet (column-wise or row-wise), it does not influence what cell the data starts being written to.
+         * @example
+         * ```js
+         * // Before running the sample:
+         * // - Enable the API at:
+         * //   https://console.developers.google.com/apis/api/sheets.googleapis.com
+         * // - Login into gcloud by running:
+         * //   ```sh
+         * //   $ gcloud auth application-default login
+         * //   ```
+         * // - Install the npm module by running:
+         * //   ```sh
+         * //   $ npm install googleapis
+         * //   ```
+         *
+         * const {google} = require('googleapis');
+         * const sheets = google.sheets('v4');
+         *
+         * 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/drive',
+         *       'https://www.googleapis.com/auth/drive.file',
+         *       'https://www.googleapis.com/auth/spreadsheets',
+         *     ],
+         *   });
+         *
+         *   // 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 sheets.spreadsheets.values.append({
+         *     // Determines if the update response should include the values of the cells that were appended. By default, responses do not include the updated values.
+         *     includeValuesInResponse: 'placeholder-value',
+         *     // How the input data should be inserted.
+         *     insertDataOption: 'placeholder-value',
+         *     // The [A1 notation](https://developers.google.com/workspace/sheets/api/guides/concepts#cell) of a range to search for a logical table of data. Values are appended after the last row of the table.
+         *     range: 'placeholder-value',
+         *     // Determines how dates, times, and durations in the response should be rendered. This is ignored if response_value_render_option is FORMATTED_VALUE. The default dateTime render option is SERIAL_NUMBER.
+         *     responseDateTimeRenderOption: 'placeholder-value',
+         *     // Determines how values in the response should be rendered. The default render option is FORMATTED_VALUE.
+         *     responseValueRenderOption: 'placeholder-value',
+         *     // The ID of the spreadsheet to update.
+         *     spreadsheetId: 'placeholder-value',
+         *     // How the input data should be interpreted.
+         *     valueInputOption: 'placeholder-value',
+         *
+         *     // Request body metadata
+         *     requestBody: {
+         *       // request body parameters
+         *       // {
+         *       //   "majorDimension": "my_majorDimension",
+         *       //   "range": "my_range",
+         *       //   "values": []
+         *       // }
+         *     },
+         *   });
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {
+         *   //   "spreadsheetId": "my_spreadsheetId",
+         *   //   "tableRange": "my_tableRange",
+         *   //   "updates": {}
+         *   // }
+         * }
+         *
+         * 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`.
@@ -5320,6 +5913,65 @@ export declare namespace sheets_v4 {
         append(callback: BodyResponseCallback<Schema$AppendValuesResponse>): void;
         /**
          * Clears one or more ranges of values from a spreadsheet. The caller must specify the spreadsheet ID and one or more ranges. Only values are cleared -- all other properties of the cell (such as formatting and data validation) are kept.
+         * @example
+         * ```js
+         * // Before running the sample:
+         * // - Enable the API at:
+         * //   https://console.developers.google.com/apis/api/sheets.googleapis.com
+         * // - Login into gcloud by running:
+         * //   ```sh
+         * //   $ gcloud auth application-default login
+         * //   ```
+         * // - Install the npm module by running:
+         * //   ```sh
+         * //   $ npm install googleapis
+         * //   ```
+         *
+         * const {google} = require('googleapis');
+         * const sheets = google.sheets('v4');
+         *
+         * 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/drive',
+         *       'https://www.googleapis.com/auth/drive.file',
+         *       'https://www.googleapis.com/auth/spreadsheets',
+         *     ],
+         *   });
+         *
+         *   // 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 sheets.spreadsheets.values.batchClear({
+         *     // The ID of the spreadsheet to update.
+         *     spreadsheetId: 'placeholder-value',
+         *
+         *     // Request body metadata
+         *     requestBody: {
+         *       // request body parameters
+         *       // {
+         *       //   "ranges": []
+         *       // }
+         *     },
+         *   });
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {
+         *   //   "clearedRanges": [],
+         *   //   "spreadsheetId": "my_spreadsheetId"
+         *   // }
+         * }
+         *
+         * 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`.
@@ -5334,6 +5986,65 @@ export declare namespace sheets_v4 {
         batchClear(callback: BodyResponseCallback<Schema$BatchClearValuesResponse>): void;
         /**
          * Clears one or more ranges of values from a spreadsheet. The caller must specify the spreadsheet ID and one or more DataFilters. Ranges matching any of the specified data filters will be cleared. Only values are cleared -- all other properties of the cell (such as formatting, data validation, etc..) are kept.
+         * @example
+         * ```js
+         * // Before running the sample:
+         * // - Enable the API at:
+         * //   https://console.developers.google.com/apis/api/sheets.googleapis.com
+         * // - Login into gcloud by running:
+         * //   ```sh
+         * //   $ gcloud auth application-default login
+         * //   ```
+         * // - Install the npm module by running:
+         * //   ```sh
+         * //   $ npm install googleapis
+         * //   ```
+         *
+         * const {google} = require('googleapis');
+         * const sheets = google.sheets('v4');
+         *
+         * 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/drive',
+         *       'https://www.googleapis.com/auth/drive.file',
+         *       'https://www.googleapis.com/auth/spreadsheets',
+         *     ],
+         *   });
+         *
+         *   // 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 sheets.spreadsheets.values.batchClearByDataFilter({
+         *     // The ID of the spreadsheet to update.
+         *     spreadsheetId: 'placeholder-value',
+         *
+         *     // Request body metadata
+         *     requestBody: {
+         *       // request body parameters
+         *       // {
+         *       //   "dataFilters": []
+         *       // }
+         *     },
+         *   });
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {
+         *   //   "clearedRanges": [],
+         *   //   "spreadsheetId": "my_spreadsheetId"
+         *   // }
+         * }
+         *
+         * 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`.
@@ -5348,6 +6059,67 @@ export declare namespace sheets_v4 {
         batchClearByDataFilter(callback: BodyResponseCallback<Schema$BatchClearValuesByDataFilterResponse>): void;
         /**
          * Returns one or more ranges of values from a spreadsheet. The caller must specify the spreadsheet ID and one or more ranges.
+         * @example
+         * ```js
+         * // Before running the sample:
+         * // - Enable the API at:
+         * //   https://console.developers.google.com/apis/api/sheets.googleapis.com
+         * // - Login into gcloud by running:
+         * //   ```sh
+         * //   $ gcloud auth application-default login
+         * //   ```
+         * // - Install the npm module by running:
+         * //   ```sh
+         * //   $ npm install googleapis
+         * //   ```
+         *
+         * const {google} = require('googleapis');
+         * const sheets = google.sheets('v4');
+         *
+         * 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/drive',
+         *       'https://www.googleapis.com/auth/drive.file',
+         *       'https://www.googleapis.com/auth/drive.readonly',
+         *       'https://www.googleapis.com/auth/spreadsheets',
+         *       'https://www.googleapis.com/auth/spreadsheets.readonly',
+         *     ],
+         *   });
+         *
+         *   // 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 sheets.spreadsheets.values.batchGet({
+         *     // How dates, times, and durations should be represented in the output. This is ignored if value_render_option is FORMATTED_VALUE. The default dateTime render option is SERIAL_NUMBER.
+         *     dateTimeRenderOption: 'placeholder-value',
+         *     // The major dimension that results should use. For example, if the spreadsheet data is: `A1=1,B1=2,A2=3,B2=4`, then requesting `ranges=["A1:B2"],majorDimension=ROWS` returns `[[1,2],[3,4]]`, whereas requesting `ranges=["A1:B2"],majorDimension=COLUMNS` returns `[[1,3],[2,4]]`.
+         *     majorDimension: 'placeholder-value',
+         *     // The [A1 notation or R1C1 notation](https://developers.google.com/workspace/sheets/api/guides/concepts#cell) of the range to retrieve values from.
+         *     ranges: 'placeholder-value',
+         *     // The ID of the spreadsheet to retrieve data from.
+         *     spreadsheetId: 'placeholder-value',
+         *     // How values should be represented in the output. The default render option is ValueRenderOption.FORMATTED_VALUE.
+         *     valueRenderOption: 'placeholder-value',
+         *   });
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {
+         *   //   "spreadsheetId": "my_spreadsheetId",
+         *   //   "valueRanges": []
+         *   // }
+         * }
+         *
+         * 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`.
@@ -5362,6 +6134,68 @@ export declare namespace sheets_v4 {
         batchGet(callback: BodyResponseCallback<Schema$BatchGetValuesResponse>): void;
         /**
          * Returns one or more ranges of values that match the specified data filters. The caller must specify the spreadsheet ID and one or more DataFilters. Ranges that match any of the data filters in the request will be returned.
+         * @example
+         * ```js
+         * // Before running the sample:
+         * // - Enable the API at:
+         * //   https://console.developers.google.com/apis/api/sheets.googleapis.com
+         * // - Login into gcloud by running:
+         * //   ```sh
+         * //   $ gcloud auth application-default login
+         * //   ```
+         * // - Install the npm module by running:
+         * //   ```sh
+         * //   $ npm install googleapis
+         * //   ```
+         *
+         * const {google} = require('googleapis');
+         * const sheets = google.sheets('v4');
+         *
+         * 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/drive',
+         *       'https://www.googleapis.com/auth/drive.file',
+         *       'https://www.googleapis.com/auth/spreadsheets',
+         *     ],
+         *   });
+         *
+         *   // 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 sheets.spreadsheets.values.batchGetByDataFilter({
+         *     // The ID of the spreadsheet to retrieve data from.
+         *     spreadsheetId: 'placeholder-value',
+         *
+         *     // Request body metadata
+         *     requestBody: {
+         *       // request body parameters
+         *       // {
+         *       //   "dataFilters": [],
+         *       //   "dateTimeRenderOption": "my_dateTimeRenderOption",
+         *       //   "majorDimension": "my_majorDimension",
+         *       //   "valueRenderOption": "my_valueRenderOption"
+         *       // }
+         *     },
+         *   });
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {
+         *   //   "spreadsheetId": "my_spreadsheetId",
+         *   //   "valueRanges": []
+         *   // }
+         * }
+         *
+         * 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`.
@@ -5376,6 +6210,73 @@ export declare namespace sheets_v4 {
         batchGetByDataFilter(callback: BodyResponseCallback<Schema$BatchGetValuesByDataFilterResponse>): void;
         /**
          * Sets values in one or more ranges of a spreadsheet. The caller must specify the spreadsheet ID, a valueInputOption, and one or more ValueRanges.
+         * @example
+         * ```js
+         * // Before running the sample:
+         * // - Enable the API at:
+         * //   https://console.developers.google.com/apis/api/sheets.googleapis.com
+         * // - Login into gcloud by running:
+         * //   ```sh
+         * //   $ gcloud auth application-default login
+         * //   ```
+         * // - Install the npm module by running:
+         * //   ```sh
+         * //   $ npm install googleapis
+         * //   ```
+         *
+         * const {google} = require('googleapis');
+         * const sheets = google.sheets('v4');
+         *
+         * 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/drive',
+         *       'https://www.googleapis.com/auth/drive.file',
+         *       'https://www.googleapis.com/auth/spreadsheets',
+         *     ],
+         *   });
+         *
+         *   // 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 sheets.spreadsheets.values.batchUpdate({
+         *     // The ID of the spreadsheet to update.
+         *     spreadsheetId: 'placeholder-value',
+         *
+         *     // Request body metadata
+         *     requestBody: {
+         *       // request body parameters
+         *       // {
+         *       //   "data": [],
+         *       //   "includeValuesInResponse": false,
+         *       //   "responseDateTimeRenderOption": "my_responseDateTimeRenderOption",
+         *       //   "responseValueRenderOption": "my_responseValueRenderOption",
+         *       //   "valueInputOption": "my_valueInputOption"
+         *       // }
+         *     },
+         *   });
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {
+         *   //   "responses": [],
+         *   //   "spreadsheetId": "my_spreadsheetId",
+         *   //   "totalUpdatedCells": 0,
+         *   //   "totalUpdatedColumns": 0,
+         *   //   "totalUpdatedRows": 0,
+         *   //   "totalUpdatedSheets": 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`.
@@ -5390,6 +6291,73 @@ export declare namespace sheets_v4 {
         batchUpdate(callback: BodyResponseCallback<Schema$BatchUpdateValuesResponse>): void;
         /**
          * Sets values in one or more ranges of a spreadsheet. The caller must specify the spreadsheet ID, a valueInputOption, and one or more DataFilterValueRanges.
+         * @example
+         * ```js
+         * // Before running the sample:
+         * // - Enable the API at:
+         * //   https://console.developers.google.com/apis/api/sheets.googleapis.com
+         * // - Login into gcloud by running:
+         * //   ```sh
+         * //   $ gcloud auth application-default login
+         * //   ```
+         * // - Install the npm module by running:
+         * //   ```sh
+         * //   $ npm install googleapis
+         * //   ```
+         *
+         * const {google} = require('googleapis');
+         * const sheets = google.sheets('v4');
+         *
+         * 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/drive',
+         *       'https://www.googleapis.com/auth/drive.file',
+         *       'https://www.googleapis.com/auth/spreadsheets',
+         *     ],
+         *   });
+         *
+         *   // 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 sheets.spreadsheets.values.batchUpdateByDataFilter({
+         *     // The ID of the spreadsheet to update.
+         *     spreadsheetId: 'placeholder-value',
+         *
+         *     // Request body metadata
+         *     requestBody: {
+         *       // request body parameters
+         *       // {
+         *       //   "data": [],
+         *       //   "includeValuesInResponse": false,
+         *       //   "responseDateTimeRenderOption": "my_responseDateTimeRenderOption",
+         *       //   "responseValueRenderOption": "my_responseValueRenderOption",
+         *       //   "valueInputOption": "my_valueInputOption"
+         *       // }
+         *     },
+         *   });
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {
+         *   //   "responses": [],
+         *   //   "spreadsheetId": "my_spreadsheetId",
+         *   //   "totalUpdatedCells": 0,
+         *   //   "totalUpdatedColumns": 0,
+         *   //   "totalUpdatedRows": 0,
+         *   //   "totalUpdatedSheets": 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`.
@@ -5404,6 +6372,65 @@ export declare namespace sheets_v4 {
         batchUpdateByDataFilter(callback: BodyResponseCallback<Schema$BatchUpdateValuesByDataFilterResponse>): void;
         /**
          * Clears values from a spreadsheet. The caller must specify the spreadsheet ID and range. Only values are cleared -- all other properties of the cell (such as formatting, data validation, etc..) are kept.
+         * @example
+         * ```js
+         * // Before running the sample:
+         * // - Enable the API at:
+         * //   https://console.developers.google.com/apis/api/sheets.googleapis.com
+         * // - Login into gcloud by running:
+         * //   ```sh
+         * //   $ gcloud auth application-default login
+         * //   ```
+         * // - Install the npm module by running:
+         * //   ```sh
+         * //   $ npm install googleapis
+         * //   ```
+         *
+         * const {google} = require('googleapis');
+         * const sheets = google.sheets('v4');
+         *
+         * 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/drive',
+         *       'https://www.googleapis.com/auth/drive.file',
+         *       'https://www.googleapis.com/auth/spreadsheets',
+         *     ],
+         *   });
+         *
+         *   // 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 sheets.spreadsheets.values.clear({
+         *     // The [A1 notation or R1C1 notation](https://developers.google.com/workspace/sheets/api/guides/concepts#cell) of the values to clear.
+         *     range: 'placeholder-value',
+         *     // The ID of the spreadsheet to update.
+         *     spreadsheetId: 'placeholder-value',
+         *
+         *     // Request body metadata
+         *     requestBody: {
+         *       // request body parameters
+         *       // {}
+         *     },
+         *   });
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {
+         *   //   "clearedRange": "my_clearedRange",
+         *   //   "spreadsheetId": "my_spreadsheetId"
+         *   // }
+         * }
+         *
+         * 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`.
@@ -5418,6 +6445,68 @@ export declare namespace sheets_v4 {
         clear(callback: BodyResponseCallback<Schema$ClearValuesResponse>): void;
         /**
          * Returns a range of values from a spreadsheet. The caller must specify the spreadsheet ID and a range.
+         * @example
+         * ```js
+         * // Before running the sample:
+         * // - Enable the API at:
+         * //   https://console.developers.google.com/apis/api/sheets.googleapis.com
+         * // - Login into gcloud by running:
+         * //   ```sh
+         * //   $ gcloud auth application-default login
+         * //   ```
+         * // - Install the npm module by running:
+         * //   ```sh
+         * //   $ npm install googleapis
+         * //   ```
+         *
+         * const {google} = require('googleapis');
+         * const sheets = google.sheets('v4');
+         *
+         * 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/drive',
+         *       'https://www.googleapis.com/auth/drive.file',
+         *       'https://www.googleapis.com/auth/drive.readonly',
+         *       'https://www.googleapis.com/auth/spreadsheets',
+         *       'https://www.googleapis.com/auth/spreadsheets.readonly',
+         *     ],
+         *   });
+         *
+         *   // 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 sheets.spreadsheets.values.get({
+         *     // How dates, times, and durations should be represented in the output. This is ignored if value_render_option is FORMATTED_VALUE. The default dateTime render option is SERIAL_NUMBER.
+         *     dateTimeRenderOption: 'placeholder-value',
+         *     // The major dimension that results should use. For example, if the spreadsheet data in Sheet1 is: `A1=1,B1=2,A2=3,B2=4`, then requesting `range=Sheet1!A1:B2?majorDimension=ROWS` returns `[[1,2],[3,4]]`, whereas requesting `range=Sheet1!A1:B2?majorDimension=COLUMNS` returns `[[1,3],[2,4]]`.
+         *     majorDimension: 'placeholder-value',
+         *     // The [A1 notation or R1C1 notation](https://developers.google.com/workspace/sheets/api/guides/concepts#cell) of the range to retrieve values from.
+         *     range: 'placeholder-value',
+         *     // The ID of the spreadsheet to retrieve data from.
+         *     spreadsheetId: 'placeholder-value',
+         *     // How values should be represented in the output. The default render option is FORMATTED_VALUE.
+         *     valueRenderOption: 'placeholder-value',
+         *   });
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {
+         *   //   "majorDimension": "my_majorDimension",
+         *   //   "range": "my_range",
+         *   //   "values": []
+         *   // }
+         * }
+         *
+         * 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`.
@@ -5432,6 +6521,81 @@ export declare namespace sheets_v4 {
         get(callback: BodyResponseCallback<Schema$ValueRange>): void;
         /**
          * Sets values in a range of a spreadsheet. The caller must specify the spreadsheet ID, range, and a valueInputOption.
+         * @example
+         * ```js
+         * // Before running the sample:
+         * // - Enable the API at:
+         * //   https://console.developers.google.com/apis/api/sheets.googleapis.com
+         * // - Login into gcloud by running:
+         * //   ```sh
+         * //   $ gcloud auth application-default login
+         * //   ```
+         * // - Install the npm module by running:
+         * //   ```sh
+         * //   $ npm install googleapis
+         * //   ```
+         *
+         * const {google} = require('googleapis');
+         * const sheets = google.sheets('v4');
+         *
+         * 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/drive',
+         *       'https://www.googleapis.com/auth/drive.file',
+         *       'https://www.googleapis.com/auth/spreadsheets',
+         *     ],
+         *   });
+         *
+         *   // 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 sheets.spreadsheets.values.update({
+         *     // Determines if the update response should include the values of the cells that were updated. By default, responses do not include the updated values. If the range to write was larger than the range actually written, the response includes all values in the requested range (excluding trailing empty rows and columns).
+         *     includeValuesInResponse: 'placeholder-value',
+         *     // The [A1 notation](https://developers.google.com/workspace/sheets/api/guides/concepts#cell) of the values to update.
+         *     range: 'placeholder-value',
+         *     // Determines how dates, times, and durations in the response should be rendered. This is ignored if response_value_render_option is FORMATTED_VALUE. The default dateTime render option is SERIAL_NUMBER.
+         *     responseDateTimeRenderOption: 'placeholder-value',
+         *     // Determines how values in the response should be rendered. The default render option is FORMATTED_VALUE.
+         *     responseValueRenderOption: 'placeholder-value',
+         *     // The ID of the spreadsheet to update.
+         *     spreadsheetId: 'placeholder-value',
+         *     // How the input data should be interpreted.
+         *     valueInputOption: 'placeholder-value',
+         *
+         *     // Request body metadata
+         *     requestBody: {
+         *       // request body parameters
+         *       // {
+         *       //   "majorDimension": "my_majorDimension",
+         *       //   "range": "my_range",
+         *       //   "values": []
+         *       // }
+         *     },
+         *   });
+         *   console.log(res.data);
+         *
+         *   // Example response
+         *   // {
+         *   //   "spreadsheetId": "my_spreadsheetId",
+         *   //   "updatedCells": 0,
+         *   //   "updatedColumns": 0,
+         *   //   "updatedData": {},
+         *   //   "updatedRange": "my_updatedRange",
+         *   //   "updatedRows": 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`.