@maxim_mazurok/gapi.client.sheets-v4 0.0.20250314 → 0.0.20250325

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/index.d.ts +18 -18
  2. package/package.json +1 -1
  3. package/readme.md +3 -3
package/index.d.ts CHANGED
@@ -1,5 +1,5 @@
1
1
  /* Type definitions for non-npm package Google Sheets API v4 0.0 */
2
- // Project: https://developers.google.com/sheets/
2
+ // Project: https://developers.google.com/workspace/sheets/
3
3
  // Definitions by: Maxim Mazurok <https://github.com/Maxim-Mazurok>
4
4
  // Nick Amoscato <https://github.com/namoscato>
5
5
  // Declan Vong <https://github.com/declanvong>
@@ -9,7 +9,7 @@
9
9
  // This file was generated by https://github.com/Maxim-Mazurok/google-api-typings-generator. Please do not edit it manually.
10
10
  // In case of any problems please post issue to https://github.com/Maxim-Mazurok/google-api-typings-generator
11
11
  // Generated from: https://sheets.googleapis.com/$discovery/rest?version=v4
12
- // Revision: 20250314
12
+ // Revision: 20250325
13
13
 
14
14
  /// <reference types="gapi.client" />
15
15
 
@@ -277,13 +277,13 @@ declare namespace gapi.client {
277
277
  dataFilters?: DataFilter[];
278
278
  }
279
279
  interface BatchClearValuesByDataFilterResponse {
280
- /** The ranges that were cleared, in [A1 notation](/sheets/api/guides/concepts#cell). If the requests are for an unbounded range or a ranger larger than the bounds of the sheet, this is the actual ranges that were cleared, bounded to the sheet's limits. */
280
+ /** The ranges that were cleared, in [A1 notation](https://developers.google.com/workspace/sheets/api/guides/concepts#cell). If the requests are for an unbounded range or a ranger larger than the bounds of the sheet, this is the actual ranges that were cleared, bounded to the sheet's limits. */
281
281
  clearedRanges?: string[];
282
282
  /** The spreadsheet the updates were applied to. */
283
283
  spreadsheetId?: string;
284
284
  }
285
285
  interface BatchClearValuesRequest {
286
- /** The ranges to clear, in [A1 notation or R1C1 notation](/sheets/api/guides/concepts#cell). */
286
+ /** The ranges to clear, in [A1 notation or R1C1 notation](https://developers.google.com/workspace/sheets/api/guides/concepts#cell). */
287
287
  ranges?: string[];
288
288
  }
289
289
  interface BatchClearValuesResponse {
@@ -1374,7 +1374,7 @@ declare namespace gapi.client {
1374
1374
  range?: GridRange;
1375
1375
  }
1376
1376
  interface NumberFormat {
1377
- /** Pattern string used for formatting. If not set, a default pattern based on the user's locale will be used if necessary for the given type. See the [Date and Number Formats guide](/sheets/api/guides/formats) for more information about the supported patterns. */
1377
+ /** Pattern string used for formatting. If not set, a default pattern based on the user's locale will be used if necessary for the given type. See the [Date and Number Formats guide](https://developers.google.com/workspace/sheets/api/guides/formats) for more information about the supported patterns. */
1378
1378
  pattern?: string;
1379
1379
  /** The type of the number format. When writing, this field must be set. */
1380
1380
  type?: string;
@@ -2262,7 +2262,7 @@ declare namespace gapi.client {
2262
2262
  updatedColumns?: number;
2263
2263
  /** The values of the cells in the range matched by the dataFilter after all updates were applied. This is only included if the request's `includeValuesInResponse` field was `true`. */
2264
2264
  updatedData?: ValueRange;
2265
- /** The range (in [A1 notation](/sheets/api/guides/concepts#cell)) that updates were applied to. */
2265
+ /** The range (in [A1 notation](https://developers.google.com/workspace/sheets/api/guides/concepts#cell)) that updates were applied to. */
2266
2266
  updatedRange?: string;
2267
2267
  /** The number of rows where at least one cell in the row was updated. */
2268
2268
  updatedRows?: number;
@@ -2284,7 +2284,7 @@ declare namespace gapi.client {
2284
2284
  interface ValueRange {
2285
2285
  /** The major dimension of the values. For output, if the spreadsheet data is: `A1=1,B1=2,A2=3,B2=4`, then requesting `range=A1:B2,majorDimension=ROWS` will return `[[1,2],[3,4]]`, whereas requesting `range=A1:B2,majorDimension=COLUMNS` will return `[[1,3],[2,4]]`. For input, with `range=A1:B2,majorDimension=ROWS` then `[[1,2],[3,4]]` will set `A1=1,B1=2,A2=3,B2=4`. With `range=A1:B2,majorDimension=COLUMNS` then `[[1,2],[3,4]]` will set `A1=1,B1=3,A2=2,B2=4`. When writing, if this field is not set, it defaults to ROWS. */
2286
2286
  majorDimension?: string;
2287
- /** The range the values cover, in [A1 notation](/sheets/api/guides/concepts#cell). For output, this range indicates the entire requested range, even though the values will exclude trailing rows and columns. When appending values, this field represents the range to search for a table, after which values will be appended. */
2287
+ /** The range the values cover, in [A1 notation](https://developers.google.com/workspace/sheets/api/guides/concepts#cell). For output, this range indicates the entire requested range, even though the values will exclude trailing rows and columns. When appending values, this field represents the range to search for a table, after which values will be appended. */
2288
2288
  range?: string;
2289
2289
  /** The data that was read or to be written. This is an array of arrays, the outer array representing all the data and each inner array representing a major dimension. Each item in the inner array corresponds with one cell. For output, empty trailing rows and columns will not be included. For input, supported value types are: bool, string, and double. Null values will be skipped. To set a cell to an empty value, set the string value to an empty string. */
2290
2290
  values?: any[][];
@@ -2497,7 +2497,7 @@ declare namespace gapi.client {
2497
2497
  ): client.Request<SheetProperties>;
2498
2498
  }
2499
2499
  interface ValuesResource {
2500
- /** 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](/sheets/api/guides/values#appending_values) and [sample code](/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. */
2500
+ /** 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. */
2501
2501
  append(request: {
2502
2502
  /** V1 error format. */
2503
2503
  '$.xgafv'?: string;
@@ -2521,7 +2521,7 @@ declare namespace gapi.client {
2521
2521
  prettyPrint?: boolean;
2522
2522
  /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
2523
2523
  quotaUser?: string;
2524
- /** The [A1 notation](/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. */
2524
+ /** 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. */
2525
2525
  range: string;
2526
2526
  /** 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. */
2527
2527
  responseDateTimeRenderOption?: string;
@@ -2562,7 +2562,7 @@ declare namespace gapi.client {
2562
2562
  prettyPrint?: boolean;
2563
2563
  /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
2564
2564
  quotaUser?: string;
2565
- /** The [A1 notation](/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. */
2565
+ /** 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. */
2566
2566
  range: string;
2567
2567
  /** 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. */
2568
2568
  responseDateTimeRenderOption?: string;
@@ -2719,7 +2719,7 @@ declare namespace gapi.client {
2719
2719
  prettyPrint?: boolean;
2720
2720
  /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
2721
2721
  quotaUser?: string;
2722
- /** The [A1 notation or R1C1 notation](/sheets/api/guides/concepts#cell) of the range to retrieve values from. */
2722
+ /** The [A1 notation or R1C1 notation](https://developers.google.com/workspace/sheets/api/guides/concepts#cell) of the range to retrieve values from. */
2723
2723
  ranges?: string | string[];
2724
2724
  /** The ID of the spreadsheet to retrieve data from. */
2725
2725
  spreadsheetId: string;
@@ -2924,7 +2924,7 @@ declare namespace gapi.client {
2924
2924
  prettyPrint?: boolean;
2925
2925
  /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
2926
2926
  quotaUser?: string;
2927
- /** The [A1 notation or R1C1 notation](/sheets/api/guides/concepts#cell) of the values to clear. */
2927
+ /** The [A1 notation or R1C1 notation](https://developers.google.com/workspace/sheets/api/guides/concepts#cell) of the values to clear. */
2928
2928
  range: string;
2929
2929
  /** The ID of the spreadsheet to update. */
2930
2930
  spreadsheetId: string;
@@ -2955,7 +2955,7 @@ declare namespace gapi.client {
2955
2955
  prettyPrint?: boolean;
2956
2956
  /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
2957
2957
  quotaUser?: string;
2958
- /** The [A1 notation or R1C1 notation](/sheets/api/guides/concepts#cell) of the values to clear. */
2958
+ /** The [A1 notation or R1C1 notation](https://developers.google.com/workspace/sheets/api/guides/concepts#cell) of the values to clear. */
2959
2959
  range: string;
2960
2960
  /** The ID of the spreadsheet to update. */
2961
2961
  spreadsheetId: string;
@@ -2990,7 +2990,7 @@ declare namespace gapi.client {
2990
2990
  prettyPrint?: boolean;
2991
2991
  /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
2992
2992
  quotaUser?: string;
2993
- /** The [A1 notation or R1C1 notation](/sheets/api/guides/concepts#cell) of the range to retrieve values from. */
2993
+ /** The [A1 notation or R1C1 notation](https://developers.google.com/workspace/sheets/api/guides/concepts#cell) of the range to retrieve values from. */
2994
2994
  range: string;
2995
2995
  /** The ID of the spreadsheet to retrieve data from. */
2996
2996
  spreadsheetId: string;
@@ -3023,7 +3023,7 @@ declare namespace gapi.client {
3023
3023
  prettyPrint?: boolean;
3024
3024
  /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
3025
3025
  quotaUser?: string;
3026
- /** The [A1 notation](/sheets/api/guides/concepts#cell) of the values to update. */
3026
+ /** The [A1 notation](https://developers.google.com/workspace/sheets/api/guides/concepts#cell) of the values to update. */
3027
3027
  range: string;
3028
3028
  /** 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. */
3029
3029
  responseDateTimeRenderOption?: string;
@@ -3062,7 +3062,7 @@ declare namespace gapi.client {
3062
3062
  prettyPrint?: boolean;
3063
3063
  /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
3064
3064
  quotaUser?: string;
3065
- /** The [A1 notation](/sheets/api/guides/concepts#cell) of the values to update. */
3065
+ /** The [A1 notation](https://developers.google.com/workspace/sheets/api/guides/concepts#cell) of the values to update. */
3066
3066
  range: string;
3067
3067
  /** 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. */
3068
3068
  responseDateTimeRenderOption?: string;
@@ -3193,7 +3193,7 @@ declare namespace gapi.client {
3193
3193
  },
3194
3194
  body: Spreadsheet,
3195
3195
  ): client.Request<Spreadsheet>;
3196
- /** 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/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](/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. */
3196
+ /** 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. */
3197
3197
  get(request?: {
3198
3198
  /** V1 error format. */
3199
3199
  '$.xgafv'?: string;
@@ -3224,7 +3224,7 @@ declare namespace gapi.client {
3224
3224
  /** Legacy upload protocol for media (e.g. "media", "multipart"). */
3225
3225
  uploadType?: string;
3226
3226
  }): client.Request<Spreadsheet>;
3227
- /** 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/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. */
3227
+ /** 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. */
3228
3228
  getByDataFilter(request: {
3229
3229
  /** V1 error format. */
3230
3230
  '$.xgafv'?: string;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@maxim_mazurok/gapi.client.sheets-v4",
3
- "version": "0.0.20250314",
3
+ "version": "0.0.20250325",
4
4
  "description": "TypeScript typings for Google Sheets API v4",
5
5
  "repository": {
6
6
  "type": "git",
package/readme.md CHANGED
@@ -1,7 +1,7 @@
1
1
  # TypeScript typings for Google Sheets API v4
2
2
 
3
3
  Reads and writes Google Sheets.
4
- For detailed description please check [documentation](https://developers.google.com/sheets/).
4
+ For detailed description please check [documentation](https://developers.google.com/workspace/sheets/).
5
5
 
6
6
  ## Installing
7
7
 
@@ -94,12 +94,12 @@ Creates a spreadsheet, returning the newly created spreadsheet.
94
94
  await gapi.client.sheets.spreadsheets.create({});
95
95
 
96
96
  /*
97
- 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/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](/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.
97
+ 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.
98
98
  */
99
99
  await gapi.client.sheets.spreadsheets.get({spreadsheetId: 'spreadsheetId'});
100
100
 
101
101
  /*
102
- 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/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.
102
+ 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.
103
103
  */
104
104
  await gapi.client.sheets.spreadsheets.getByDataFilter({
105
105
  spreadsheetId: 'spreadsheetId',