@maxim_mazurok/gapi.client.sheets-v4 0.0.20220804
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.
- package/index.d.ts +3721 -0
- package/package.json +20 -0
- package/readme.md +100 -0
- package/tests.ts +12033 -0
- package/tsconfig.json +18 -0
- package/tslint.json +6 -0
package/index.d.ts
ADDED
|
@@ -0,0 +1,3721 @@
|
|
|
1
|
+
/* Type definitions for non-npm package Google Sheets API v4 0.0 */
|
|
2
|
+
// Project: https://developers.google.com/sheets/
|
|
3
|
+
// Definitions by: Maxim Mazurok <https://github.com/Maxim-Mazurok>
|
|
4
|
+
// Nick Amoscato <https://github.com/namoscato>
|
|
5
|
+
// Declan Vong <https://github.com/declanvong>
|
|
6
|
+
// Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
|
|
7
|
+
// TypeScript Version: 2.8
|
|
8
|
+
|
|
9
|
+
// IMPORTANT
|
|
10
|
+
// This file was generated by https://github.com/Maxim-Mazurok/google-api-typings-generator. Please do not edit it manually.
|
|
11
|
+
// In case of any problems please post issue to https://github.com/Maxim-Mazurok/google-api-typings-generator
|
|
12
|
+
// Generated from: https://sheets.googleapis.com/$discovery/rest?version=v4
|
|
13
|
+
// Revision: 20220804
|
|
14
|
+
|
|
15
|
+
/// <reference types="gapi.client" />
|
|
16
|
+
|
|
17
|
+
declare namespace gapi.client {
|
|
18
|
+
/** Load Google Sheets API v4 */
|
|
19
|
+
function load(urlOrObject: "https://sheets.googleapis.com/$discovery/rest?version=v4"): Promise<void>;
|
|
20
|
+
/** @deprecated Please load APIs with discovery documents. */
|
|
21
|
+
function load(name: "sheets", version: "v4"): Promise<void>;
|
|
22
|
+
/** @deprecated Please load APIs with discovery documents. */
|
|
23
|
+
function load(name: "sheets", version: "v4", callback: () => any): void;
|
|
24
|
+
|
|
25
|
+
namespace sheets {
|
|
26
|
+
interface AddBandingRequest {
|
|
27
|
+
/** The banded range to add. The bandedRangeId field is optional; if one is not set, an id will be randomly generated. (It is an error to specify the ID of a range that already exists.) */
|
|
28
|
+
bandedRange?: BandedRange;
|
|
29
|
+
}
|
|
30
|
+
interface AddBandingResponse {
|
|
31
|
+
/** The banded range that was added. */
|
|
32
|
+
bandedRange?: BandedRange;
|
|
33
|
+
}
|
|
34
|
+
interface AddChartRequest {
|
|
35
|
+
/**
|
|
36
|
+
* The chart that should be added to the spreadsheet, including the position where it should be placed. The chartId field is optional; if one is not set, an id will be randomly
|
|
37
|
+
* generated. (It is an error to specify the ID of an embedded object that already exists.)
|
|
38
|
+
*/
|
|
39
|
+
chart?: EmbeddedChart;
|
|
40
|
+
}
|
|
41
|
+
interface AddChartResponse {
|
|
42
|
+
/** The newly added chart. */
|
|
43
|
+
chart?: EmbeddedChart;
|
|
44
|
+
}
|
|
45
|
+
interface AddConditionalFormatRuleRequest {
|
|
46
|
+
/** The zero-based index where the rule should be inserted. */
|
|
47
|
+
index?: number;
|
|
48
|
+
/** The rule to add. */
|
|
49
|
+
rule?: ConditionalFormatRule;
|
|
50
|
+
}
|
|
51
|
+
interface AddDataSourceRequest {
|
|
52
|
+
/** The data source to add. */
|
|
53
|
+
dataSource?: DataSource;
|
|
54
|
+
}
|
|
55
|
+
interface AddDataSourceResponse {
|
|
56
|
+
/** The data execution status. */
|
|
57
|
+
dataExecutionStatus?: DataExecutionStatus;
|
|
58
|
+
/** The data source that was created. */
|
|
59
|
+
dataSource?: DataSource;
|
|
60
|
+
}
|
|
61
|
+
interface AddDimensionGroupRequest {
|
|
62
|
+
/** The range over which to create a group. */
|
|
63
|
+
range?: DimensionRange;
|
|
64
|
+
}
|
|
65
|
+
interface AddDimensionGroupResponse {
|
|
66
|
+
/** All groups of a dimension after adding a group to that dimension. */
|
|
67
|
+
dimensionGroups?: DimensionGroup[];
|
|
68
|
+
}
|
|
69
|
+
interface AddFilterViewRequest {
|
|
70
|
+
/** The filter to add. The filterViewId field is optional; if one is not set, an id will be randomly generated. (It is an error to specify the ID of a filter that already exists.) */
|
|
71
|
+
filter?: FilterView;
|
|
72
|
+
}
|
|
73
|
+
interface AddFilterViewResponse {
|
|
74
|
+
/** The newly added filter view. */
|
|
75
|
+
filter?: FilterView;
|
|
76
|
+
}
|
|
77
|
+
interface AddNamedRangeRequest {
|
|
78
|
+
/** The named range to add. The namedRangeId field is optional; if one is not set, an id will be randomly generated. (It is an error to specify the ID of a range that already exists.) */
|
|
79
|
+
namedRange?: NamedRange;
|
|
80
|
+
}
|
|
81
|
+
interface AddNamedRangeResponse {
|
|
82
|
+
/** The named range to add. */
|
|
83
|
+
namedRange?: NamedRange;
|
|
84
|
+
}
|
|
85
|
+
interface AddProtectedRangeRequest {
|
|
86
|
+
/**
|
|
87
|
+
* The protected range to be added. The protectedRangeId field is optional; if one is not set, an id will be randomly generated. (It is an error to specify the ID of a range that
|
|
88
|
+
* already exists.)
|
|
89
|
+
*/
|
|
90
|
+
protectedRange?: ProtectedRange;
|
|
91
|
+
}
|
|
92
|
+
interface AddProtectedRangeResponse {
|
|
93
|
+
/** The newly added protected range. */
|
|
94
|
+
protectedRange?: ProtectedRange;
|
|
95
|
+
}
|
|
96
|
+
interface AddSheetRequest {
|
|
97
|
+
/**
|
|
98
|
+
* The properties the new sheet should have. All properties are optional. The sheetId field is optional; if one is not set, an id will be randomly generated. (It is an error to specify
|
|
99
|
+
* the ID of a sheet that already exists.)
|
|
100
|
+
*/
|
|
101
|
+
properties?: SheetProperties;
|
|
102
|
+
}
|
|
103
|
+
interface AddSheetResponse {
|
|
104
|
+
/** The properties of the newly added sheet. */
|
|
105
|
+
properties?: SheetProperties;
|
|
106
|
+
}
|
|
107
|
+
interface AddSlicerRequest {
|
|
108
|
+
/**
|
|
109
|
+
* The slicer that should be added to the spreadsheet, including the position where it should be placed. The slicerId field is optional; if one is not set, an id will be randomly
|
|
110
|
+
* generated. (It is an error to specify the ID of a slicer that already exists.)
|
|
111
|
+
*/
|
|
112
|
+
slicer?: Slicer;
|
|
113
|
+
}
|
|
114
|
+
interface AddSlicerResponse {
|
|
115
|
+
/** The newly added slicer. */
|
|
116
|
+
slicer?: Slicer;
|
|
117
|
+
}
|
|
118
|
+
interface AppendCellsRequest {
|
|
119
|
+
/**
|
|
120
|
+
* The fields of CellData that should be updated. At least one field must be specified. The root is the CellData; 'row.values.' should not be specified. A single `"*"` can be used as
|
|
121
|
+
* short-hand for listing every field.
|
|
122
|
+
*/
|
|
123
|
+
fields?: string;
|
|
124
|
+
/** The data to append. */
|
|
125
|
+
rows?: RowData[];
|
|
126
|
+
/** The sheet ID to append the data to. */
|
|
127
|
+
sheetId?: number;
|
|
128
|
+
}
|
|
129
|
+
interface AppendDimensionRequest {
|
|
130
|
+
/** Whether rows or columns should be appended. */
|
|
131
|
+
dimension?: string;
|
|
132
|
+
/** The number of rows or columns to append. */
|
|
133
|
+
length?: number;
|
|
134
|
+
/** The sheet to append rows or columns to. */
|
|
135
|
+
sheetId?: number;
|
|
136
|
+
}
|
|
137
|
+
interface AppendValuesResponse {
|
|
138
|
+
/** The spreadsheet the updates were applied to. */
|
|
139
|
+
spreadsheetId?: string;
|
|
140
|
+
/** The range (in A1 notation) of the table that values are being appended to (before the values were appended). Empty if no table was found. */
|
|
141
|
+
tableRange?: string;
|
|
142
|
+
/** Information about the updates that were applied. */
|
|
143
|
+
updates?: UpdateValuesResponse;
|
|
144
|
+
}
|
|
145
|
+
interface AutoFillRequest {
|
|
146
|
+
/** The range to autofill. This will examine the range and detect the location that has data and automatically fill that data in to the rest of the range. */
|
|
147
|
+
range?: GridRange;
|
|
148
|
+
/** The source and destination areas to autofill. This explicitly lists the source of the autofill and where to extend that data. */
|
|
149
|
+
sourceAndDestination?: SourceAndDestination;
|
|
150
|
+
/** True if we should generate data with the "alternate" series. This differs based on the type and amount of source data. */
|
|
151
|
+
useAlternateSeries?: boolean;
|
|
152
|
+
}
|
|
153
|
+
interface AutoResizeDimensionsRequest {
|
|
154
|
+
/** The dimensions on a data source sheet to automatically resize. */
|
|
155
|
+
dataSourceSheetDimensions?: DataSourceSheetDimensionRange;
|
|
156
|
+
/** The dimensions to automatically resize. */
|
|
157
|
+
dimensions?: DimensionRange;
|
|
158
|
+
}
|
|
159
|
+
interface BandedRange {
|
|
160
|
+
/** The id of the banded range. */
|
|
161
|
+
bandedRangeId?: number;
|
|
162
|
+
/**
|
|
163
|
+
* 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
|
|
164
|
+
* must be specified.
|
|
165
|
+
*/
|
|
166
|
+
columnProperties?: BandingProperties;
|
|
167
|
+
/** The range over which these properties are applied. */
|
|
168
|
+
range?: GridRange;
|
|
169
|
+
/**
|
|
170
|
+
* Properties for row bands. These properties are applied on a row-by-row basis throughout all the rows in the range. At least one of row_properties or column_properties must be
|
|
171
|
+
* specified.
|
|
172
|
+
*/
|
|
173
|
+
rowProperties?: BandingProperties;
|
|
174
|
+
}
|
|
175
|
+
interface BandingProperties {
|
|
176
|
+
/** The first color that is alternating. (Required) Deprecated: Use first_band_color_style. */
|
|
177
|
+
firstBandColor?: Color;
|
|
178
|
+
/** The first color that is alternating. (Required) If first_band_color is also set, this field takes precedence. */
|
|
179
|
+
firstBandColorStyle?: ColorStyle;
|
|
180
|
+
/**
|
|
181
|
+
* The color of the last row or column. If this field is not set, the last row or column is filled with either first_band_color or second_band_color, depending on the color of the
|
|
182
|
+
* previous row or column. Deprecated: Use footer_color_style.
|
|
183
|
+
*/
|
|
184
|
+
footerColor?: Color;
|
|
185
|
+
/**
|
|
186
|
+
* The color of the last row or column. If this field is not set, the last row or column is filled with either first_band_color or second_band_color, depending on the color of the
|
|
187
|
+
* previous row or column. If footer_color is also set, this field takes precedence.
|
|
188
|
+
*/
|
|
189
|
+
footerColorStyle?: ColorStyle;
|
|
190
|
+
/**
|
|
191
|
+
* The color of the first row or column. If this field is set, the first row or column is filled with this color and the colors alternate between first_band_color and second_band_color
|
|
192
|
+
* starting from the second row or column. Otherwise, the first row or column is filled with first_band_color and the colors proceed to alternate as they normally would. Deprecated:
|
|
193
|
+
* Use header_color_style.
|
|
194
|
+
*/
|
|
195
|
+
headerColor?: Color;
|
|
196
|
+
/**
|
|
197
|
+
* The color of the first row or column. If this field is set, the first row or column is filled with this color and the colors alternate between first_band_color and second_band_color
|
|
198
|
+
* starting from the second row or column. Otherwise, the first row or column is filled with first_band_color and the colors proceed to alternate as they normally would. If
|
|
199
|
+
* header_color is also set, this field takes precedence.
|
|
200
|
+
*/
|
|
201
|
+
headerColorStyle?: ColorStyle;
|
|
202
|
+
/** The second color that is alternating. (Required) Deprecated: Use second_band_color_style. */
|
|
203
|
+
secondBandColor?: Color;
|
|
204
|
+
/** The second color that is alternating. (Required) If second_band_color is also set, this field takes precedence. */
|
|
205
|
+
secondBandColorStyle?: ColorStyle;
|
|
206
|
+
}
|
|
207
|
+
interface BaselineValueFormat {
|
|
208
|
+
/** The comparison type of key value with baseline value. */
|
|
209
|
+
comparisonType?: string;
|
|
210
|
+
/** Description which is appended after the baseline value. This field is optional. */
|
|
211
|
+
description?: string;
|
|
212
|
+
/** Color to be used, in case baseline value represents a negative change for key value. This field is optional. Deprecated: Use negative_color_style. */
|
|
213
|
+
negativeColor?: Color;
|
|
214
|
+
/** Color to be used, in case baseline value represents a negative change for key value. This field is optional. If negative_color is also set, this field takes precedence. */
|
|
215
|
+
negativeColorStyle?: ColorStyle;
|
|
216
|
+
/** Specifies the horizontal text positioning of baseline value. This field is optional. If not specified, default positioning is used. */
|
|
217
|
+
position?: TextPosition;
|
|
218
|
+
/** Color to be used, in case baseline value represents a positive change for key value. This field is optional. Deprecated: Use positive_color_style. */
|
|
219
|
+
positiveColor?: Color;
|
|
220
|
+
/** Color to be used, in case baseline value represents a positive change for key value. This field is optional. If positive_color is also set, this field takes precedence. */
|
|
221
|
+
positiveColorStyle?: ColorStyle;
|
|
222
|
+
/** Text formatting options for baseline value. The link field is not supported. */
|
|
223
|
+
textFormat?: TextFormat;
|
|
224
|
+
}
|
|
225
|
+
interface BasicChartAxis {
|
|
226
|
+
/** The format of the title. Only valid if the axis is not associated with the domain. The link field is not supported. */
|
|
227
|
+
format?: TextFormat;
|
|
228
|
+
/** The position of this axis. */
|
|
229
|
+
position?: string;
|
|
230
|
+
/** The title of this axis. If set, this overrides any title inferred from headers of the data. */
|
|
231
|
+
title?: string;
|
|
232
|
+
/** The axis title text position. */
|
|
233
|
+
titleTextPosition?: TextPosition;
|
|
234
|
+
/** The view window options for this axis. */
|
|
235
|
+
viewWindowOptions?: ChartAxisViewWindowOptions;
|
|
236
|
+
}
|
|
237
|
+
interface BasicChartDomain {
|
|
238
|
+
/** The data of the domain. For example, if charting stock prices over time, this is the data representing the dates. */
|
|
239
|
+
domain?: ChartData;
|
|
240
|
+
/** True to reverse the order of the domain values (horizontal axis). */
|
|
241
|
+
reversed?: boolean;
|
|
242
|
+
}
|
|
243
|
+
interface BasicChartSeries {
|
|
244
|
+
/** The color for elements (such as bars, lines, and points) associated with this series. If empty, a default color is used. Deprecated: Use color_style. */
|
|
245
|
+
color?: Color;
|
|
246
|
+
/** The color for elements (such as bars, lines, and points) associated with this series. If empty, a default color is used. If color is also set, this field takes precedence. */
|
|
247
|
+
colorStyle?: ColorStyle;
|
|
248
|
+
/** Information about the data labels for this series. */
|
|
249
|
+
dataLabel?: DataLabel;
|
|
250
|
+
/** The line style of this series. Valid only if the chartType is AREA, LINE, or SCATTER. COMBO charts are also supported if the series chart type is AREA or LINE. */
|
|
251
|
+
lineStyle?: LineStyle;
|
|
252
|
+
/**
|
|
253
|
+
* The style for points associated with this series. Valid only if the chartType is AREA, LINE, or SCATTER. COMBO charts are also supported if the series chart type is AREA, LINE, or
|
|
254
|
+
* SCATTER. If empty, a default point style is used.
|
|
255
|
+
*/
|
|
256
|
+
pointStyle?: PointStyle;
|
|
257
|
+
/** The data being visualized in this chart series. */
|
|
258
|
+
series?: ChartData;
|
|
259
|
+
/** Style override settings for series data points. */
|
|
260
|
+
styleOverrides?: BasicSeriesDataPointStyleOverride[];
|
|
261
|
+
/**
|
|
262
|
+
* The minor axis that will specify the range of values for this series. For example, if charting stocks over time, the "Volume" series may want to be pinned to the right with the
|
|
263
|
+
* prices pinned to the left, because the scale of trading volume is different than the scale of prices. It is an error to specify an axis that isn't a valid minor axis for the chart's
|
|
264
|
+
* type.
|
|
265
|
+
*/
|
|
266
|
+
targetAxis?: string;
|
|
267
|
+
/** The type of this series. Valid only if the chartType is COMBO. Different types will change the way the series is visualized. Only LINE, AREA, and COLUMN are supported. */
|
|
268
|
+
type?: string;
|
|
269
|
+
}
|
|
270
|
+
interface BasicChartSpec {
|
|
271
|
+
/** The axis on the chart. */
|
|
272
|
+
axis?: BasicChartAxis[];
|
|
273
|
+
/** The type of the chart. */
|
|
274
|
+
chartType?: string;
|
|
275
|
+
/** The behavior of tooltips and data highlighting when hovering on data and chart area. */
|
|
276
|
+
compareMode?: string;
|
|
277
|
+
/** The domain of data this is charting. Only a single domain is supported. */
|
|
278
|
+
domains?: BasicChartDomain[];
|
|
279
|
+
/**
|
|
280
|
+
* The number of rows or columns in the data that are "headers". If not set, Google Sheets will guess how many rows are headers based on the data. (Note that BasicChartAxis.title may
|
|
281
|
+
* override the axis title inferred from the header values.)
|
|
282
|
+
*/
|
|
283
|
+
headerCount?: number;
|
|
284
|
+
/**
|
|
285
|
+
* If some values in a series are missing, gaps may appear in the chart (e.g, segments of lines in a line chart will be missing). To eliminate these gaps set this to true. Applies to
|
|
286
|
+
* Line, Area, and Combo charts.
|
|
287
|
+
*/
|
|
288
|
+
interpolateNulls?: boolean;
|
|
289
|
+
/** The position of the chart legend. */
|
|
290
|
+
legendPosition?: string;
|
|
291
|
+
/** Gets whether all lines should be rendered smooth or straight by default. Applies to Line charts. */
|
|
292
|
+
lineSmoothing?: boolean;
|
|
293
|
+
/** The data this chart is visualizing. */
|
|
294
|
+
series?: BasicChartSeries[];
|
|
295
|
+
/** The stacked type for charts that support vertical stacking. Applies to Area, Bar, Column, Combo, and Stepped Area charts. */
|
|
296
|
+
stackedType?: string;
|
|
297
|
+
/** True to make the chart 3D. Applies to Bar and Column charts. */
|
|
298
|
+
threeDimensional?: boolean;
|
|
299
|
+
/**
|
|
300
|
+
* Controls whether to display additional data labels on stacked charts which sum the total value of all stacked values at each value along the domain axis. These data labels can only
|
|
301
|
+
* be set when chart_type is one of AREA, BAR, COLUMN, COMBO or STEPPED_AREA and stacked_type is either STACKED or PERCENT_STACKED. In addition, for COMBO, this will only be supported
|
|
302
|
+
* if there is only one type of stackable series type or one type has more series than the others and each of the other types have no more than one series. For example, if a chart has
|
|
303
|
+
* two stacked bar series and one area series, the total data labels will be supported. If it has three bar series and two area series, total data labels are not allowed. Neither
|
|
304
|
+
* CUSTOM nor placement can be set on the total_data_label.
|
|
305
|
+
*/
|
|
306
|
+
totalDataLabel?: DataLabel;
|
|
307
|
+
}
|
|
308
|
+
interface BasicFilter {
|
|
309
|
+
/**
|
|
310
|
+
* The criteria for showing/hiding values per column. The map's key is the column index, and the value is the criteria for that column. This field is deprecated in favor of
|
|
311
|
+
* filter_specs.
|
|
312
|
+
*/
|
|
313
|
+
criteria?: { [P in string]: FilterCriteria };
|
|
314
|
+
/** The filter criteria per column. Both criteria and filter_specs are populated in responses. If both fields are specified in an update request, this field takes precedence. */
|
|
315
|
+
filterSpecs?: FilterSpec[];
|
|
316
|
+
/** The range the filter covers. */
|
|
317
|
+
range?: GridRange;
|
|
318
|
+
/** The sort order per column. Later specifications are used when values are equal in the earlier specifications. */
|
|
319
|
+
sortSpecs?: SortSpec[];
|
|
320
|
+
}
|
|
321
|
+
interface BasicSeriesDataPointStyleOverride {
|
|
322
|
+
/** Color of the series data point. If empty, the series default is used. Deprecated: Use color_style. */
|
|
323
|
+
color?: Color;
|
|
324
|
+
/** Color of the series data point. If empty, the series default is used. If color is also set, this field takes precedence. */
|
|
325
|
+
colorStyle?: ColorStyle;
|
|
326
|
+
/** Zero based index of the series data point. */
|
|
327
|
+
index?: number;
|
|
328
|
+
/**
|
|
329
|
+
* Point style of the series data point. Valid only if the chartType is AREA, LINE, or SCATTER. COMBO charts are also supported if the series chart type is AREA, LINE, or SCATTER. If
|
|
330
|
+
* empty, the series default is used.
|
|
331
|
+
*/
|
|
332
|
+
pointStyle?: PointStyle;
|
|
333
|
+
}
|
|
334
|
+
interface BatchClearValuesByDataFilterRequest {
|
|
335
|
+
/** The DataFilters used to determine which ranges to clear. */
|
|
336
|
+
dataFilters?: DataFilter[];
|
|
337
|
+
}
|
|
338
|
+
interface BatchClearValuesByDataFilterResponse {
|
|
339
|
+
/**
|
|
340
|
+
* 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
|
|
341
|
+
* the actual ranges that were cleared, bounded to the sheet's limits.
|
|
342
|
+
*/
|
|
343
|
+
clearedRanges?: string[];
|
|
344
|
+
/** The spreadsheet the updates were applied to. */
|
|
345
|
+
spreadsheetId?: string;
|
|
346
|
+
}
|
|
347
|
+
interface BatchClearValuesRequest {
|
|
348
|
+
/** The ranges to clear, in [A1 notation or R1C1 notation](/sheets/api/guides/concepts#cell). */
|
|
349
|
+
ranges?: string[];
|
|
350
|
+
}
|
|
351
|
+
interface BatchClearValuesResponse {
|
|
352
|
+
/**
|
|
353
|
+
* The ranges that were cleared, in A1 notation. 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
|
|
354
|
+
* cleared, bounded to the sheet's limits.
|
|
355
|
+
*/
|
|
356
|
+
clearedRanges?: string[];
|
|
357
|
+
/** The spreadsheet the updates were applied to. */
|
|
358
|
+
spreadsheetId?: string;
|
|
359
|
+
}
|
|
360
|
+
interface BatchGetValuesByDataFilterRequest {
|
|
361
|
+
/** The data filters used to match the ranges of values to retrieve. Ranges that match any of the specified data filters are included in the response. */
|
|
362
|
+
dataFilters?: DataFilter[];
|
|
363
|
+
/** 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. */
|
|
364
|
+
dateTimeRenderOption?: string;
|
|
365
|
+
/**
|
|
366
|
+
* The major dimension that results should use. For example, if the spreadsheet data is: `A1=1,B1=2,A2=3,B2=4`, then a request that selects that range and sets `majorDimension=ROWS`
|
|
367
|
+
* returns `[[1,2],[3,4]]`, whereas a request that sets `majorDimension=COLUMNS` returns `[[1,3],[2,4]]`.
|
|
368
|
+
*/
|
|
369
|
+
majorDimension?: string;
|
|
370
|
+
/** How values should be represented in the output. The default render option is FORMATTED_VALUE. */
|
|
371
|
+
valueRenderOption?: string;
|
|
372
|
+
}
|
|
373
|
+
interface BatchGetValuesByDataFilterResponse {
|
|
374
|
+
/** The ID of the spreadsheet the data was retrieved from. */
|
|
375
|
+
spreadsheetId?: string;
|
|
376
|
+
/** The requested values with the list of data filters that matched them. */
|
|
377
|
+
valueRanges?: MatchedValueRange[];
|
|
378
|
+
}
|
|
379
|
+
interface BatchGetValuesResponse {
|
|
380
|
+
/** The ID of the spreadsheet the data was retrieved from. */
|
|
381
|
+
spreadsheetId?: string;
|
|
382
|
+
/** The requested values. The order of the ValueRanges is the same as the order of the requested ranges. */
|
|
383
|
+
valueRanges?: ValueRange[];
|
|
384
|
+
}
|
|
385
|
+
interface BatchUpdateSpreadsheetRequest {
|
|
386
|
+
/** Determines if the update response should include the spreadsheet resource. */
|
|
387
|
+
includeSpreadsheetInResponse?: boolean;
|
|
388
|
+
/** A list of updates to apply to the spreadsheet. Requests will be applied in the order they are specified. If any request is not valid, no requests will be applied. */
|
|
389
|
+
requests?: Request[];
|
|
390
|
+
/** True if grid data should be returned. Meaningful only if include_spreadsheet_in_response is 'true'. This parameter is ignored if a field mask was set in the request. */
|
|
391
|
+
responseIncludeGridData?: boolean;
|
|
392
|
+
/** Limits the ranges included in the response spreadsheet. Meaningful only if include_spreadsheet_in_response is 'true'. */
|
|
393
|
+
responseRanges?: string[];
|
|
394
|
+
}
|
|
395
|
+
interface BatchUpdateSpreadsheetResponse {
|
|
396
|
+
/** The reply of the updates. This maps 1:1 with the updates, although replies to some requests may be empty. */
|
|
397
|
+
replies?: Response[];
|
|
398
|
+
/** The spreadsheet the updates were applied to. */
|
|
399
|
+
spreadsheetId?: string;
|
|
400
|
+
/** The spreadsheet after updates were applied. This is only set if BatchUpdateSpreadsheetRequest.include_spreadsheet_in_response is `true`. */
|
|
401
|
+
updatedSpreadsheet?: Spreadsheet;
|
|
402
|
+
}
|
|
403
|
+
interface BatchUpdateValuesByDataFilterRequest {
|
|
404
|
+
/** The new values to apply to the spreadsheet. If more than one range is matched by the specified DataFilter the specified values are applied to all of those ranges. */
|
|
405
|
+
data?: DataFilterValueRange[];
|
|
406
|
+
/**
|
|
407
|
+
* Determines if the update response should include the values of the cells that were updated. By default, responses do not include the updated values. The `updatedData` field within
|
|
408
|
+
* each of the BatchUpdateValuesResponse.responses contains the updated values. If the range to write was larger than the range actually written, the response includes all values in
|
|
409
|
+
* the requested range (excluding trailing empty rows and columns).
|
|
410
|
+
*/
|
|
411
|
+
includeValuesInResponse?: boolean;
|
|
412
|
+
/**
|
|
413
|
+
* 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
|
|
414
|
+
* is SERIAL_NUMBER.
|
|
415
|
+
*/
|
|
416
|
+
responseDateTimeRenderOption?: string;
|
|
417
|
+
/** Determines how values in the response should be rendered. The default render option is FORMATTED_VALUE. */
|
|
418
|
+
responseValueRenderOption?: string;
|
|
419
|
+
/** How the input data should be interpreted. */
|
|
420
|
+
valueInputOption?: string;
|
|
421
|
+
}
|
|
422
|
+
interface BatchUpdateValuesByDataFilterResponse {
|
|
423
|
+
/** The response for each range updated. */
|
|
424
|
+
responses?: UpdateValuesByDataFilterResponse[];
|
|
425
|
+
/** The spreadsheet the updates were applied to. */
|
|
426
|
+
spreadsheetId?: string;
|
|
427
|
+
/** The total number of cells updated. */
|
|
428
|
+
totalUpdatedCells?: number;
|
|
429
|
+
/** The total number of columns where at least one cell in the column was updated. */
|
|
430
|
+
totalUpdatedColumns?: number;
|
|
431
|
+
/** The total number of rows where at least one cell in the row was updated. */
|
|
432
|
+
totalUpdatedRows?: number;
|
|
433
|
+
/** The total number of sheets where at least one cell in the sheet was updated. */
|
|
434
|
+
totalUpdatedSheets?: number;
|
|
435
|
+
}
|
|
436
|
+
interface BatchUpdateValuesRequest {
|
|
437
|
+
/** The new values to apply to the spreadsheet. */
|
|
438
|
+
data?: ValueRange[];
|
|
439
|
+
/**
|
|
440
|
+
* Determines if the update response should include the values of the cells that were updated. By default, responses do not include the updated values. The `updatedData` field within
|
|
441
|
+
* each of the BatchUpdateValuesResponse.responses contains the updated values. If the range to write was larger than the range actually written, the response includes all values in
|
|
442
|
+
* the requested range (excluding trailing empty rows and columns).
|
|
443
|
+
*/
|
|
444
|
+
includeValuesInResponse?: boolean;
|
|
445
|
+
/**
|
|
446
|
+
* 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
|
|
447
|
+
* is SERIAL_NUMBER.
|
|
448
|
+
*/
|
|
449
|
+
responseDateTimeRenderOption?: string;
|
|
450
|
+
/** Determines how values in the response should be rendered. The default render option is FORMATTED_VALUE. */
|
|
451
|
+
responseValueRenderOption?: string;
|
|
452
|
+
/** How the input data should be interpreted. */
|
|
453
|
+
valueInputOption?: string;
|
|
454
|
+
}
|
|
455
|
+
interface BatchUpdateValuesResponse {
|
|
456
|
+
/** One UpdateValuesResponse per requested range, in the same order as the requests appeared. */
|
|
457
|
+
responses?: UpdateValuesResponse[];
|
|
458
|
+
/** The spreadsheet the updates were applied to. */
|
|
459
|
+
spreadsheetId?: string;
|
|
460
|
+
/** The total number of cells updated. */
|
|
461
|
+
totalUpdatedCells?: number;
|
|
462
|
+
/** The total number of columns where at least one cell in the column was updated. */
|
|
463
|
+
totalUpdatedColumns?: number;
|
|
464
|
+
/** The total number of rows where at least one cell in the row was updated. */
|
|
465
|
+
totalUpdatedRows?: number;
|
|
466
|
+
/** The total number of sheets where at least one cell in the sheet was updated. */
|
|
467
|
+
totalUpdatedSheets?: number;
|
|
468
|
+
}
|
|
469
|
+
interface BigQueryDataSourceSpec {
|
|
470
|
+
/** The ID of a BigQuery enabled GCP project with a billing account attached. For any queries executed against the data source, the project is charged. */
|
|
471
|
+
projectId?: string;
|
|
472
|
+
/** A BigQueryQuerySpec. */
|
|
473
|
+
querySpec?: BigQueryQuerySpec;
|
|
474
|
+
/** A BigQueryTableSpec. */
|
|
475
|
+
tableSpec?: BigQueryTableSpec;
|
|
476
|
+
}
|
|
477
|
+
interface BigQueryQuerySpec {
|
|
478
|
+
/** The raw query string. */
|
|
479
|
+
rawQuery?: string;
|
|
480
|
+
}
|
|
481
|
+
interface BigQueryTableSpec {
|
|
482
|
+
/** The BigQuery dataset id. */
|
|
483
|
+
datasetId?: string;
|
|
484
|
+
/** The BigQuery table id. */
|
|
485
|
+
tableId?: string;
|
|
486
|
+
/** The ID of a BigQuery project the table belongs to. If not specified, the project_id is assumed. */
|
|
487
|
+
tableProjectId?: string;
|
|
488
|
+
}
|
|
489
|
+
interface BooleanCondition {
|
|
490
|
+
/** The type of condition. */
|
|
491
|
+
type?: string;
|
|
492
|
+
/**
|
|
493
|
+
* The values of the condition. The number of supported values depends on the condition type. Some support zero values, others one or two values, and ConditionType.ONE_OF_LIST supports
|
|
494
|
+
* an arbitrary number of values.
|
|
495
|
+
*/
|
|
496
|
+
values?: ConditionValue[];
|
|
497
|
+
}
|
|
498
|
+
interface BooleanRule {
|
|
499
|
+
/** The condition of the rule. If the condition evaluates to true, the format is applied. */
|
|
500
|
+
condition?: BooleanCondition;
|
|
501
|
+
/** The format to apply. Conditional formatting can only apply a subset of formatting: bold, italic, strikethrough, foreground color & background color. */
|
|
502
|
+
format?: CellFormat;
|
|
503
|
+
}
|
|
504
|
+
interface Border {
|
|
505
|
+
/** The color of the border. Deprecated: Use color_style. */
|
|
506
|
+
color?: Color;
|
|
507
|
+
/** The color of the border. If color is also set, this field takes precedence. */
|
|
508
|
+
colorStyle?: ColorStyle;
|
|
509
|
+
/** The style of the border. */
|
|
510
|
+
style?: string;
|
|
511
|
+
/** The width of the border, in pixels. Deprecated; the width is determined by the "style" field. */
|
|
512
|
+
width?: number;
|
|
513
|
+
}
|
|
514
|
+
interface Borders {
|
|
515
|
+
/** The bottom border of the cell. */
|
|
516
|
+
bottom?: Border;
|
|
517
|
+
/** The left border of the cell. */
|
|
518
|
+
left?: Border;
|
|
519
|
+
/** The right border of the cell. */
|
|
520
|
+
right?: Border;
|
|
521
|
+
/** The top border of the cell. */
|
|
522
|
+
top?: Border;
|
|
523
|
+
}
|
|
524
|
+
interface BubbleChartSpec {
|
|
525
|
+
/** The bubble border color. Deprecated: Use bubble_border_color_style. */
|
|
526
|
+
bubbleBorderColor?: Color;
|
|
527
|
+
/** The bubble border color. If bubble_border_color is also set, this field takes precedence. */
|
|
528
|
+
bubbleBorderColorStyle?: ColorStyle;
|
|
529
|
+
/** The data containing the bubble labels. These do not need to be unique. */
|
|
530
|
+
bubbleLabels?: ChartData;
|
|
531
|
+
/** The max radius size of the bubbles, in pixels. If specified, the field must be a positive value. */
|
|
532
|
+
bubbleMaxRadiusSize?: number;
|
|
533
|
+
/** The minimum radius size of the bubbles, in pixels. If specific, the field must be a positive value. */
|
|
534
|
+
bubbleMinRadiusSize?: number;
|
|
535
|
+
/** The opacity of the bubbles between 0 and 1.0. 0 is fully transparent and 1 is fully opaque. */
|
|
536
|
+
bubbleOpacity?: number;
|
|
537
|
+
/**
|
|
538
|
+
* The data containing the bubble sizes. Bubble sizes are used to draw the bubbles at different sizes relative to each other. If specified, group_ids must also be specified. This field
|
|
539
|
+
* is optional.
|
|
540
|
+
*/
|
|
541
|
+
bubbleSizes?: ChartData;
|
|
542
|
+
/** The format of the text inside the bubbles. Strikethrough, underline, and link are not supported. */
|
|
543
|
+
bubbleTextStyle?: TextFormat;
|
|
544
|
+
/** The data containing the bubble x-values. These values locate the bubbles in the chart horizontally. */
|
|
545
|
+
domain?: ChartData;
|
|
546
|
+
/**
|
|
547
|
+
* The data containing the bubble group IDs. All bubbles with the same group ID are drawn in the same color. If bubble_sizes is specified then this field must also be specified but may
|
|
548
|
+
* contain blank values. This field is optional.
|
|
549
|
+
*/
|
|
550
|
+
groupIds?: ChartData;
|
|
551
|
+
/** Where the legend of the chart should be drawn. */
|
|
552
|
+
legendPosition?: string;
|
|
553
|
+
/** The data containing the bubble y-values. These values locate the bubbles in the chart vertically. */
|
|
554
|
+
series?: ChartData;
|
|
555
|
+
}
|
|
556
|
+
interface CandlestickChartSpec {
|
|
557
|
+
/** The Candlestick chart data. Only one CandlestickData is supported. */
|
|
558
|
+
data?: CandlestickData[];
|
|
559
|
+
/** The domain data (horizontal axis) for the candlestick chart. String data will be treated as discrete labels, other data will be treated as continuous values. */
|
|
560
|
+
domain?: CandlestickDomain;
|
|
561
|
+
}
|
|
562
|
+
interface CandlestickData {
|
|
563
|
+
/**
|
|
564
|
+
* The range data (vertical axis) for the close/final value for each candle. This is the top of the candle body. If greater than the open value the candle will be filled. Otherwise the
|
|
565
|
+
* candle will be hollow.
|
|
566
|
+
*/
|
|
567
|
+
closeSeries?: CandlestickSeries;
|
|
568
|
+
/** The range data (vertical axis) for the high/maximum value for each candle. This is the top of the candle's center line. */
|
|
569
|
+
highSeries?: CandlestickSeries;
|
|
570
|
+
/** The range data (vertical axis) for the low/minimum value for each candle. This is the bottom of the candle's center line. */
|
|
571
|
+
lowSeries?: CandlestickSeries;
|
|
572
|
+
/**
|
|
573
|
+
* The range data (vertical axis) for the open/initial value for each candle. This is the bottom of the candle body. If less than the close value the candle will be filled. Otherwise
|
|
574
|
+
* the candle will be hollow.
|
|
575
|
+
*/
|
|
576
|
+
openSeries?: CandlestickSeries;
|
|
577
|
+
}
|
|
578
|
+
interface CandlestickDomain {
|
|
579
|
+
/** The data of the CandlestickDomain. */
|
|
580
|
+
data?: ChartData;
|
|
581
|
+
/** True to reverse the order of the domain values (horizontal axis). */
|
|
582
|
+
reversed?: boolean;
|
|
583
|
+
}
|
|
584
|
+
interface CandlestickSeries {
|
|
585
|
+
/** The data of the CandlestickSeries. */
|
|
586
|
+
data?: ChartData;
|
|
587
|
+
}
|
|
588
|
+
interface CellData {
|
|
589
|
+
/**
|
|
590
|
+
* 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.
|
|
591
|
+
* `=SUM(DataSheet!Column)`.
|
|
592
|
+
*/
|
|
593
|
+
dataSourceFormula?: DataSourceFormula;
|
|
594
|
+
/**
|
|
595
|
+
* A data source table anchored at this cell. The size of data source table itself is computed dynamically based on its configuration. Only the first cell of the data source table
|
|
596
|
+
* contains the data source table definition. The other cells will contain the display values of the data source table result in their effective_value fields.
|
|
597
|
+
*/
|
|
598
|
+
dataSourceTable?: DataSourceTable;
|
|
599
|
+
/** A data validation rule on the cell, if any. When writing, the new data validation rule will overwrite any prior rule. */
|
|
600
|
+
dataValidation?: DataValidationRule;
|
|
601
|
+
/**
|
|
602
|
+
* The effective format being used by the cell. This includes the results of applying any conditional formatting and, if the cell contains a formula, the computed number format. If the
|
|
603
|
+
* effective format is the default format, effective format will not be written. This field is read-only.
|
|
604
|
+
*/
|
|
605
|
+
effectiveFormat?: CellFormat;
|
|
606
|
+
/** The effective value of the cell. For cells with formulas, this is the calculated value. For cells with literals, this is the same as the user_entered_value. This field is read-only. */
|
|
607
|
+
effectiveValue?: ExtendedValue;
|
|
608
|
+
/** The formatted value of the cell. This is the value as it's shown to the user. This field is read-only. */
|
|
609
|
+
formattedValue?: string;
|
|
610
|
+
/**
|
|
611
|
+
* A hyperlink this cell points to, if any. If the cell contains multiple hyperlinks, this field will be empty. This field is read-only. To set it, use a `=HYPERLINK` formula in the
|
|
612
|
+
* userEnteredValue.formulaValue field. A cell-level link can also be set from the userEnteredFormat.textFormat field. Alternatively, set a hyperlink in the textFormatRun.format.link
|
|
613
|
+
* field that spans the entire cell.
|
|
614
|
+
*/
|
|
615
|
+
hyperlink?: string;
|
|
616
|
+
/** Any note on the cell. */
|
|
617
|
+
note?: string;
|
|
618
|
+
/**
|
|
619
|
+
* A pivot table anchored at this cell. The size of pivot table itself is computed dynamically based on its data, grouping, filters, values, etc. Only the top-left cell of the pivot
|
|
620
|
+
* table contains the pivot table definition. The other cells will contain the calculated values of the results of the pivot in their effective_value fields.
|
|
621
|
+
*/
|
|
622
|
+
pivotTable?: PivotTable;
|
|
623
|
+
/**
|
|
624
|
+
* Runs of rich text applied to subsections of the cell. Runs are only valid on user entered strings, not formulas, bools, or numbers. Properties of a run start at a specific index in
|
|
625
|
+
* the text and continue until the next run. Runs will inherit the properties of the cell unless explicitly changed. When writing, the new runs will overwrite any prior runs. When
|
|
626
|
+
* writing a new user_entered_value, previous runs are erased.
|
|
627
|
+
*/
|
|
628
|
+
textFormatRuns?: TextFormatRun[];
|
|
629
|
+
/** The format the user entered for the cell. When writing, the new format will be merged with the existing format. */
|
|
630
|
+
userEnteredFormat?: CellFormat;
|
|
631
|
+
/** The value the user entered in the cell. e.g, `1234`, `'Hello'`, or `=NOW()` Note: Dates, Times and DateTimes are represented as doubles in serial number format. */
|
|
632
|
+
userEnteredValue?: ExtendedValue;
|
|
633
|
+
}
|
|
634
|
+
interface CellFormat {
|
|
635
|
+
/** The background color of the cell. Deprecated: Use background_color_style. */
|
|
636
|
+
backgroundColor?: Color;
|
|
637
|
+
/** The background color of the cell. If background_color is also set, this field takes precedence. */
|
|
638
|
+
backgroundColorStyle?: ColorStyle;
|
|
639
|
+
/** The borders of the cell. */
|
|
640
|
+
borders?: Borders;
|
|
641
|
+
/** The horizontal alignment of the value in the cell. */
|
|
642
|
+
horizontalAlignment?: string;
|
|
643
|
+
/** If one exists, how a hyperlink should be displayed in the cell. */
|
|
644
|
+
hyperlinkDisplayType?: string;
|
|
645
|
+
/** A format describing how number values should be represented to the user. */
|
|
646
|
+
numberFormat?: NumberFormat;
|
|
647
|
+
/** The padding of the cell. */
|
|
648
|
+
padding?: Padding;
|
|
649
|
+
/** The direction of the text in the cell. */
|
|
650
|
+
textDirection?: string;
|
|
651
|
+
/**
|
|
652
|
+
* The format of the text in the cell (unless overridden by a format run). Setting a cell-level link here clears the cell's existing links. Setting the link field in a TextFormatRun
|
|
653
|
+
* takes precedence over the cell-level link.
|
|
654
|
+
*/
|
|
655
|
+
textFormat?: TextFormat;
|
|
656
|
+
/** The rotation applied to text in the cell. */
|
|
657
|
+
textRotation?: TextRotation;
|
|
658
|
+
/** The vertical alignment of the value in the cell. */
|
|
659
|
+
verticalAlignment?: string;
|
|
660
|
+
/** The wrap strategy for the value in the cell. */
|
|
661
|
+
wrapStrategy?: string;
|
|
662
|
+
}
|
|
663
|
+
interface ChartAxisViewWindowOptions {
|
|
664
|
+
/** The maximum numeric value to be shown in this view window. If unset, will automatically determine a maximum value that looks good for the data. */
|
|
665
|
+
viewWindowMax?: number;
|
|
666
|
+
/** The minimum numeric value to be shown in this view window. If unset, will automatically determine a minimum value that looks good for the data. */
|
|
667
|
+
viewWindowMin?: number;
|
|
668
|
+
/** The view window's mode. */
|
|
669
|
+
viewWindowMode?: string;
|
|
670
|
+
}
|
|
671
|
+
interface ChartCustomNumberFormatOptions {
|
|
672
|
+
/** Custom prefix to be prepended to the chart attribute. This field is optional. */
|
|
673
|
+
prefix?: string;
|
|
674
|
+
/** Custom suffix to be appended to the chart attribute. This field is optional. */
|
|
675
|
+
suffix?: string;
|
|
676
|
+
}
|
|
677
|
+
interface ChartData {
|
|
678
|
+
/** The aggregation type for the series of a data source chart. Only supported for data source charts. */
|
|
679
|
+
aggregateType?: string;
|
|
680
|
+
/** The reference to the data source column that the data reads from. */
|
|
681
|
+
columnReference?: DataSourceColumnReference;
|
|
682
|
+
/** The rule to group the data by if the ChartData backs the domain of a data source chart. Only supported for data source charts. */
|
|
683
|
+
groupRule?: ChartGroupRule;
|
|
684
|
+
/** The source ranges of the data. */
|
|
685
|
+
sourceRange?: ChartSourceRange;
|
|
686
|
+
}
|
|
687
|
+
interface ChartDateTimeRule {
|
|
688
|
+
/** The type of date-time grouping to apply. */
|
|
689
|
+
type?: string;
|
|
690
|
+
}
|
|
691
|
+
interface ChartGroupRule {
|
|
692
|
+
/** A ChartDateTimeRule. */
|
|
693
|
+
dateTimeRule?: ChartDateTimeRule;
|
|
694
|
+
/** A ChartHistogramRule */
|
|
695
|
+
histogramRule?: ChartHistogramRule;
|
|
696
|
+
}
|
|
697
|
+
interface ChartHistogramRule {
|
|
698
|
+
/** The size of the buckets that are created. Must be positive. */
|
|
699
|
+
intervalSize?: number;
|
|
700
|
+
/** The maximum value at which items are placed into buckets. Values greater than the maximum are grouped into a single bucket. If omitted, it is determined by the maximum item value. */
|
|
701
|
+
maxValue?: number;
|
|
702
|
+
/**
|
|
703
|
+
* The minimum value at which items are placed into buckets. Values that are less than the minimum are grouped into a single bucket. If omitted, it is determined by the minimum item
|
|
704
|
+
* value.
|
|
705
|
+
*/
|
|
706
|
+
minValue?: number;
|
|
707
|
+
}
|
|
708
|
+
interface ChartSourceRange {
|
|
709
|
+
/**
|
|
710
|
+
* The ranges of data for a series or domain. Exactly one dimension must have a length of 1, and all sources in the list must have the same dimension with length 1. The domain (if it
|
|
711
|
+
* exists) & all series must have the same number of source ranges. If using more than one source range, then the source range at a given offset must be in order and contiguous across
|
|
712
|
+
* the domain and series. For example, these are valid configurations: domain sources: A1:A5 series1 sources: B1:B5 series2 sources: D6:D10 domain sources: A1:A5, C10:C12 series1
|
|
713
|
+
* sources: B1:B5, D10:D12 series2 sources: C1:C5, E10:E12
|
|
714
|
+
*/
|
|
715
|
+
sources?: GridRange[];
|
|
716
|
+
}
|
|
717
|
+
interface ChartSpec {
|
|
718
|
+
/** The alternative text that describes the chart. This is often used for accessibility. */
|
|
719
|
+
altText?: string;
|
|
720
|
+
/** The background color of the entire chart. Not applicable to Org charts. Deprecated: Use background_color_style. */
|
|
721
|
+
backgroundColor?: Color;
|
|
722
|
+
/** The background color of the entire chart. Not applicable to Org charts. If background_color is also set, this field takes precedence. */
|
|
723
|
+
backgroundColorStyle?: ColorStyle;
|
|
724
|
+
/** A basic chart specification, can be one of many kinds of charts. See BasicChartType for the list of all charts this supports. */
|
|
725
|
+
basicChart?: BasicChartSpec;
|
|
726
|
+
/** A bubble chart specification. */
|
|
727
|
+
bubbleChart?: BubbleChartSpec;
|
|
728
|
+
/** A candlestick chart specification. */
|
|
729
|
+
candlestickChart?: CandlestickChartSpec;
|
|
730
|
+
/** If present, the field contains data source chart specific properties. */
|
|
731
|
+
dataSourceChartProperties?: DataSourceChartProperties;
|
|
732
|
+
/** The filters applied to the source data of the chart. Only supported for data source charts. */
|
|
733
|
+
filterSpecs?: FilterSpec[];
|
|
734
|
+
/** The name of the font to use by default for all chart text (e.g. title, axis labels, legend). If a font is specified for a specific part of the chart it will override this font name. */
|
|
735
|
+
fontName?: string;
|
|
736
|
+
/** Determines how the charts will use hidden rows or columns. */
|
|
737
|
+
hiddenDimensionStrategy?: string;
|
|
738
|
+
/** A histogram chart specification. */
|
|
739
|
+
histogramChart?: HistogramChartSpec;
|
|
740
|
+
/** True to make a chart fill the entire space in which it's rendered with minimum padding. False to use the default padding. (Not applicable to Geo and Org charts.) */
|
|
741
|
+
maximized?: boolean;
|
|
742
|
+
/** An org chart specification. */
|
|
743
|
+
orgChart?: OrgChartSpec;
|
|
744
|
+
/** A pie chart specification. */
|
|
745
|
+
pieChart?: PieChartSpec;
|
|
746
|
+
/** A scorecard chart specification. */
|
|
747
|
+
scorecardChart?: ScorecardChartSpec;
|
|
748
|
+
/** The order to sort the chart data by. Only a single sort spec is supported. Only supported for data source charts. */
|
|
749
|
+
sortSpecs?: SortSpec[];
|
|
750
|
+
/** The subtitle of the chart. */
|
|
751
|
+
subtitle?: string;
|
|
752
|
+
/** The subtitle text format. Strikethrough, underline, and link are not supported. */
|
|
753
|
+
subtitleTextFormat?: TextFormat;
|
|
754
|
+
/** The subtitle text position. This field is optional. */
|
|
755
|
+
subtitleTextPosition?: TextPosition;
|
|
756
|
+
/** The title of the chart. */
|
|
757
|
+
title?: string;
|
|
758
|
+
/** The title text format. Strikethrough, underline, and link are not supported. */
|
|
759
|
+
titleTextFormat?: TextFormat;
|
|
760
|
+
/** The title text position. This field is optional. */
|
|
761
|
+
titleTextPosition?: TextPosition;
|
|
762
|
+
/** A treemap chart specification. */
|
|
763
|
+
treemapChart?: TreemapChartSpec;
|
|
764
|
+
/** A waterfall chart specification. */
|
|
765
|
+
waterfallChart?: WaterfallChartSpec;
|
|
766
|
+
}
|
|
767
|
+
interface ClearBasicFilterRequest {
|
|
768
|
+
/** The sheet ID on which the basic filter should be cleared. */
|
|
769
|
+
sheetId?: number;
|
|
770
|
+
}
|
|
771
|
+
// tslint:disable-next-line:no-empty-interface
|
|
772
|
+
interface ClearValuesRequest {
|
|
773
|
+
}
|
|
774
|
+
interface ClearValuesResponse {
|
|
775
|
+
/**
|
|
776
|
+
* The range (in A1 notation) that was cleared. (If the request was for an unbounded range or a ranger larger than the bounds of the sheet, this will be the actual range that was
|
|
777
|
+
* cleared, bounded to the sheet's limits.)
|
|
778
|
+
*/
|
|
779
|
+
clearedRange?: string;
|
|
780
|
+
/** The spreadsheet the updates were applied to. */
|
|
781
|
+
spreadsheetId?: string;
|
|
782
|
+
}
|
|
783
|
+
interface Color {
|
|
784
|
+
/**
|
|
785
|
+
* The fraction of this color that should be applied to the pixel. That is, the final pixel color is defined by the equation: `pixel color = alpha * (this color) + (1.0 - alpha) *
|
|
786
|
+
* (background color)` This means that a value of 1.0 corresponds to a solid color, whereas a value of 0.0 corresponds to a completely transparent color. This uses a wrapper message
|
|
787
|
+
* rather than a simple float scalar so that it is possible to distinguish between a default value and the value being unset. If omitted, this color object is rendered as a solid color
|
|
788
|
+
* (as if the alpha value had been explicitly given a value of 1.0).
|
|
789
|
+
*/
|
|
790
|
+
alpha?: number;
|
|
791
|
+
/** The amount of blue in the color as a value in the interval [0, 1]. */
|
|
792
|
+
blue?: number;
|
|
793
|
+
/** The amount of green in the color as a value in the interval [0, 1]. */
|
|
794
|
+
green?: number;
|
|
795
|
+
/** The amount of red in the color as a value in the interval [0, 1]. */
|
|
796
|
+
red?: number;
|
|
797
|
+
}
|
|
798
|
+
interface ColorStyle {
|
|
799
|
+
/**
|
|
800
|
+
* RGB color. The [`alpha`](/sheets/api/reference/rest/v4/spreadsheets/other#Color.FIELDS.alpha) value in the [`Color`](/sheets/api/reference/rest/v4/spreadsheets/other#color) object
|
|
801
|
+
* isn't generally supported.
|
|
802
|
+
*/
|
|
803
|
+
rgbColor?: Color;
|
|
804
|
+
/** Theme color. */
|
|
805
|
+
themeColor?: string;
|
|
806
|
+
}
|
|
807
|
+
interface ConditionalFormatRule {
|
|
808
|
+
/** The formatting is either "on" or "off" according to the rule. */
|
|
809
|
+
booleanRule?: BooleanRule;
|
|
810
|
+
/** The formatting will vary based on the gradients in the rule. */
|
|
811
|
+
gradientRule?: GradientRule;
|
|
812
|
+
/** The ranges that are formatted if the condition is true. All the ranges must be on the same grid. */
|
|
813
|
+
ranges?: GridRange[];
|
|
814
|
+
}
|
|
815
|
+
interface ConditionValue {
|
|
816
|
+
/**
|
|
817
|
+
* A relative date (based on the current date). Valid only if the type is DATE_BEFORE, DATE_AFTER, DATE_ON_OR_BEFORE or DATE_ON_OR_AFTER. Relative dates are not supported in data
|
|
818
|
+
* validation. They are supported only in conditional formatting and conditional filters.
|
|
819
|
+
*/
|
|
820
|
+
relativeDate?: string;
|
|
821
|
+
/** A value the condition is based on. The value is parsed as if the user typed into a cell. Formulas are supported (and must begin with an `=` or a '+'). */
|
|
822
|
+
userEnteredValue?: string;
|
|
823
|
+
}
|
|
824
|
+
interface CopyPasteRequest {
|
|
825
|
+
/**
|
|
826
|
+
* The location to paste to. If the range covers a span that's a multiple of the source's height or width, then the data will be repeated to fill in the destination range. If the range
|
|
827
|
+
* is smaller than the source range, the entire source data will still be copied (beyond the end of the destination range).
|
|
828
|
+
*/
|
|
829
|
+
destination?: GridRange;
|
|
830
|
+
/** How that data should be oriented when pasting. */
|
|
831
|
+
pasteOrientation?: string;
|
|
832
|
+
/** What kind of data to paste. */
|
|
833
|
+
pasteType?: string;
|
|
834
|
+
/** The source range to copy. */
|
|
835
|
+
source?: GridRange;
|
|
836
|
+
}
|
|
837
|
+
interface CopySheetToAnotherSpreadsheetRequest {
|
|
838
|
+
/** The ID of the spreadsheet to copy the sheet to. */
|
|
839
|
+
destinationSpreadsheetId?: string;
|
|
840
|
+
}
|
|
841
|
+
interface CreateDeveloperMetadataRequest {
|
|
842
|
+
/** The developer metadata to create. */
|
|
843
|
+
developerMetadata?: DeveloperMetadata;
|
|
844
|
+
}
|
|
845
|
+
interface CreateDeveloperMetadataResponse {
|
|
846
|
+
/** The developer metadata that was created. */
|
|
847
|
+
developerMetadata?: DeveloperMetadata;
|
|
848
|
+
}
|
|
849
|
+
interface CutPasteRequest {
|
|
850
|
+
/** The top-left coordinate where the data should be pasted. */
|
|
851
|
+
destination?: GridCoordinate;
|
|
852
|
+
/** What kind of data to paste. All the source data will be cut, regardless of what is pasted. */
|
|
853
|
+
pasteType?: string;
|
|
854
|
+
/** The source data to cut. */
|
|
855
|
+
source?: GridRange;
|
|
856
|
+
}
|
|
857
|
+
interface DataExecutionStatus {
|
|
858
|
+
/** The error code. */
|
|
859
|
+
errorCode?: string;
|
|
860
|
+
/** The error message, which may be empty. */
|
|
861
|
+
errorMessage?: string;
|
|
862
|
+
/** Gets the time the data last successfully refreshed. */
|
|
863
|
+
lastRefreshTime?: string;
|
|
864
|
+
/** The state of the data execution. */
|
|
865
|
+
state?: string;
|
|
866
|
+
}
|
|
867
|
+
interface DataFilter {
|
|
868
|
+
/** Selects data that matches the specified A1 range. */
|
|
869
|
+
a1Range?: string;
|
|
870
|
+
/** Selects data associated with the developer metadata matching the criteria described by this DeveloperMetadataLookup. */
|
|
871
|
+
developerMetadataLookup?: DeveloperMetadataLookup;
|
|
872
|
+
/** Selects data that matches the range described by the GridRange. */
|
|
873
|
+
gridRange?: GridRange;
|
|
874
|
+
}
|
|
875
|
+
interface DataFilterValueRange {
|
|
876
|
+
/** The data filter describing the location of the values in the spreadsheet. */
|
|
877
|
+
dataFilter?: DataFilter;
|
|
878
|
+
/** The major dimension of the values. */
|
|
879
|
+
majorDimension?: string;
|
|
880
|
+
/**
|
|
881
|
+
* The data to be written. If the provided values exceed any of the ranges matched by the data filter then the request fails. If the provided values are less than the matched ranges
|
|
882
|
+
* only the specified values are written, existing values in the matched ranges remain unaffected.
|
|
883
|
+
*/
|
|
884
|
+
values?: any[][];
|
|
885
|
+
}
|
|
886
|
+
interface DataLabel {
|
|
887
|
+
/**
|
|
888
|
+
* Data to use for custom labels. Only used if type is set to CUSTOM. This data must be the same length as the series or other element this data label is applied to. In addition, if
|
|
889
|
+
* the series is split into multiple source ranges, this source data must come from the next column in the source data. For example, if the series is B2:B4,E6:E8 then this data must
|
|
890
|
+
* come from C2:C4,F6:F8.
|
|
891
|
+
*/
|
|
892
|
+
customLabelData?: ChartData;
|
|
893
|
+
/** The placement of the data label relative to the labeled data. */
|
|
894
|
+
placement?: string;
|
|
895
|
+
/** The text format used for the data label. The link field is not supported. */
|
|
896
|
+
textFormat?: TextFormat;
|
|
897
|
+
/** The type of the data label. */
|
|
898
|
+
type?: string;
|
|
899
|
+
}
|
|
900
|
+
interface DataSource {
|
|
901
|
+
/** All calculated columns in the data source. */
|
|
902
|
+
calculatedColumns?: DataSourceColumn[];
|
|
903
|
+
/** The spreadsheet-scoped unique ID that identifies the data source. Example: 1080547365. */
|
|
904
|
+
dataSourceId?: string;
|
|
905
|
+
/**
|
|
906
|
+
* The ID of the Sheet connected with the data source. The field cannot be changed once set. When creating a data source, an associated DATA_SOURCE sheet is also created, if the field
|
|
907
|
+
* is not specified, the ID of the created sheet will be randomly generated.
|
|
908
|
+
*/
|
|
909
|
+
sheetId?: number;
|
|
910
|
+
/** The DataSourceSpec for the data source connected with this spreadsheet. */
|
|
911
|
+
spec?: DataSourceSpec;
|
|
912
|
+
}
|
|
913
|
+
interface DataSourceChartProperties {
|
|
914
|
+
/** Output only. The data execution status. */
|
|
915
|
+
dataExecutionStatus?: DataExecutionStatus;
|
|
916
|
+
/** ID of the data source that the chart is associated with. */
|
|
917
|
+
dataSourceId?: string;
|
|
918
|
+
}
|
|
919
|
+
interface DataSourceColumn {
|
|
920
|
+
/** The formula of the calculated column. */
|
|
921
|
+
formula?: string;
|
|
922
|
+
/** The column reference. */
|
|
923
|
+
reference?: DataSourceColumnReference;
|
|
924
|
+
}
|
|
925
|
+
interface DataSourceColumnReference {
|
|
926
|
+
/** The display name of the column. It should be unique within a data source. */
|
|
927
|
+
name?: string;
|
|
928
|
+
}
|
|
929
|
+
interface DataSourceFormula {
|
|
930
|
+
/** Output only. The data execution status. */
|
|
931
|
+
dataExecutionStatus?: DataExecutionStatus;
|
|
932
|
+
/** The ID of the data source the formula is associated with. */
|
|
933
|
+
dataSourceId?: string;
|
|
934
|
+
}
|
|
935
|
+
interface DataSourceObjectReference {
|
|
936
|
+
/** References to a data source chart. */
|
|
937
|
+
chartId?: number;
|
|
938
|
+
/** References to a cell containing DataSourceFormula. */
|
|
939
|
+
dataSourceFormulaCell?: GridCoordinate;
|
|
940
|
+
/** References to a data source PivotTable anchored at the cell. */
|
|
941
|
+
dataSourcePivotTableAnchorCell?: GridCoordinate;
|
|
942
|
+
/** References to a DataSourceTable anchored at the cell. */
|
|
943
|
+
dataSourceTableAnchorCell?: GridCoordinate;
|
|
944
|
+
/** References to a DATA_SOURCE sheet. */
|
|
945
|
+
sheetId?: string;
|
|
946
|
+
}
|
|
947
|
+
interface DataSourceObjectReferences {
|
|
948
|
+
/** The references. */
|
|
949
|
+
references?: DataSourceObjectReference[];
|
|
950
|
+
}
|
|
951
|
+
interface DataSourceParameter {
|
|
952
|
+
/**
|
|
953
|
+
* Named parameter. Must be a legitimate identifier for the DataSource that supports it. For example, [BigQuery
|
|
954
|
+
* identifier](https://cloud.google.com/bigquery/docs/reference/standard-sql/lexical#identifiers).
|
|
955
|
+
*/
|
|
956
|
+
name?: string;
|
|
957
|
+
/** ID of a NamedRange. Its size must be 1x1. */
|
|
958
|
+
namedRangeId?: string;
|
|
959
|
+
/** A range that contains the value of the parameter. Its size must be 1x1. */
|
|
960
|
+
range?: GridRange;
|
|
961
|
+
}
|
|
962
|
+
interface DataSourceRefreshDailySchedule {
|
|
963
|
+
/** The start time of a time interval in which a data source refresh is scheduled. Only `hours` part is used. The time interval size defaults to that in the Sheets editor. */
|
|
964
|
+
startTime?: TimeOfDay;
|
|
965
|
+
}
|
|
966
|
+
interface DataSourceRefreshMonthlySchedule {
|
|
967
|
+
/** Days of the month to refresh. Only 1-28 are supported, mapping to the 1st to the 28th day. At lesat one day must be specified. */
|
|
968
|
+
daysOfMonth?: number[];
|
|
969
|
+
/** The start time of a time interval in which a data source refresh is scheduled. Only `hours` part is used. The time interval size defaults to that in the Sheets editor. */
|
|
970
|
+
startTime?: TimeOfDay;
|
|
971
|
+
}
|
|
972
|
+
interface DataSourceRefreshSchedule {
|
|
973
|
+
/** Daily refresh schedule. */
|
|
974
|
+
dailySchedule?: DataSourceRefreshDailySchedule;
|
|
975
|
+
/** True if the refresh schedule is enabled, or false otherwise. */
|
|
976
|
+
enabled?: boolean;
|
|
977
|
+
/** Monthly refresh schedule. */
|
|
978
|
+
monthlySchedule?: DataSourceRefreshMonthlySchedule;
|
|
979
|
+
/** Output only. The time interval of the next run. */
|
|
980
|
+
nextRun?: Interval;
|
|
981
|
+
/** The scope of the refresh. Must be ALL_DATA_SOURCES. */
|
|
982
|
+
refreshScope?: string;
|
|
983
|
+
/** Weekly refresh schedule. */
|
|
984
|
+
weeklySchedule?: DataSourceRefreshWeeklySchedule;
|
|
985
|
+
}
|
|
986
|
+
interface DataSourceRefreshWeeklySchedule {
|
|
987
|
+
/** Days of the week to refresh. At least one day must be specified. */
|
|
988
|
+
daysOfWeek?: string[];
|
|
989
|
+
/** The start time of a time interval in which a data source refresh is scheduled. Only `hours` part is used. The time interval size defaults to that in the Sheets editor. */
|
|
990
|
+
startTime?: TimeOfDay;
|
|
991
|
+
}
|
|
992
|
+
interface DataSourceSheetDimensionRange {
|
|
993
|
+
/** The columns on the data source sheet. */
|
|
994
|
+
columnReferences?: DataSourceColumnReference[];
|
|
995
|
+
/** The ID of the data source sheet the range is on. */
|
|
996
|
+
sheetId?: number;
|
|
997
|
+
}
|
|
998
|
+
interface DataSourceSheetProperties {
|
|
999
|
+
/** The columns displayed on the sheet, corresponding to the values in RowData. */
|
|
1000
|
+
columns?: DataSourceColumn[];
|
|
1001
|
+
/** The data execution status. */
|
|
1002
|
+
dataExecutionStatus?: DataExecutionStatus;
|
|
1003
|
+
/** ID of the DataSource the sheet is connected to. */
|
|
1004
|
+
dataSourceId?: string;
|
|
1005
|
+
}
|
|
1006
|
+
interface DataSourceSpec {
|
|
1007
|
+
/** A BigQueryDataSourceSpec. */
|
|
1008
|
+
bigQuery?: BigQueryDataSourceSpec;
|
|
1009
|
+
/** The parameters of the data source, used when querying the data source. */
|
|
1010
|
+
parameters?: DataSourceParameter[];
|
|
1011
|
+
}
|
|
1012
|
+
interface DataSourceTable {
|
|
1013
|
+
/** Columns selected for the data source table. The column_selection_type must be SELECTED. */
|
|
1014
|
+
columns?: DataSourceColumnReference[];
|
|
1015
|
+
/** The type to select columns for the data source table. Defaults to SELECTED. */
|
|
1016
|
+
columnSelectionType?: string;
|
|
1017
|
+
/** Output only. The data execution status. */
|
|
1018
|
+
dataExecutionStatus?: DataExecutionStatus;
|
|
1019
|
+
/** The ID of the data source the data source table is associated with. */
|
|
1020
|
+
dataSourceId?: string;
|
|
1021
|
+
/** Filter specifications in the data source table. */
|
|
1022
|
+
filterSpecs?: FilterSpec[];
|
|
1023
|
+
/** The limit of rows to return. If not set, a default limit is applied. Please refer to the Sheets editor for the default and max limit. */
|
|
1024
|
+
rowLimit?: number;
|
|
1025
|
+
/** Sort specifications in the data source table. The result of the data source table is sorted based on the sort specifications in order. */
|
|
1026
|
+
sortSpecs?: SortSpec[];
|
|
1027
|
+
}
|
|
1028
|
+
interface DataValidationRule {
|
|
1029
|
+
/** The condition that data in the cell must match. */
|
|
1030
|
+
condition?: BooleanCondition;
|
|
1031
|
+
/** A message to show the user when adding data to the cell. */
|
|
1032
|
+
inputMessage?: string;
|
|
1033
|
+
/** True if the UI should be customized based on the kind of condition. If true, "List" conditions will show a dropdown. */
|
|
1034
|
+
showCustomUi?: boolean;
|
|
1035
|
+
/** True if invalid data should be rejected. */
|
|
1036
|
+
strict?: boolean;
|
|
1037
|
+
}
|
|
1038
|
+
interface DateTimeRule {
|
|
1039
|
+
/** The type of date-time grouping to apply. */
|
|
1040
|
+
type?: string;
|
|
1041
|
+
}
|
|
1042
|
+
interface DeleteBandingRequest {
|
|
1043
|
+
/** The ID of the banded range to delete. */
|
|
1044
|
+
bandedRangeId?: number;
|
|
1045
|
+
}
|
|
1046
|
+
interface DeleteConditionalFormatRuleRequest {
|
|
1047
|
+
/** The zero-based index of the rule to be deleted. */
|
|
1048
|
+
index?: number;
|
|
1049
|
+
/** The sheet the rule is being deleted from. */
|
|
1050
|
+
sheetId?: number;
|
|
1051
|
+
}
|
|
1052
|
+
interface DeleteConditionalFormatRuleResponse {
|
|
1053
|
+
/** The rule that was deleted. */
|
|
1054
|
+
rule?: ConditionalFormatRule;
|
|
1055
|
+
}
|
|
1056
|
+
interface DeleteDataSourceRequest {
|
|
1057
|
+
/** The ID of the data source to delete. */
|
|
1058
|
+
dataSourceId?: string;
|
|
1059
|
+
}
|
|
1060
|
+
interface DeleteDeveloperMetadataRequest {
|
|
1061
|
+
/** The data filter describing the criteria used to select which developer metadata entry to delete. */
|
|
1062
|
+
dataFilter?: DataFilter;
|
|
1063
|
+
}
|
|
1064
|
+
interface DeleteDeveloperMetadataResponse {
|
|
1065
|
+
/** The metadata that was deleted. */
|
|
1066
|
+
deletedDeveloperMetadata?: DeveloperMetadata[];
|
|
1067
|
+
}
|
|
1068
|
+
interface DeleteDimensionGroupRequest {
|
|
1069
|
+
/** The range of the group to be deleted. */
|
|
1070
|
+
range?: DimensionRange;
|
|
1071
|
+
}
|
|
1072
|
+
interface DeleteDimensionGroupResponse {
|
|
1073
|
+
/** All groups of a dimension after deleting a group from that dimension. */
|
|
1074
|
+
dimensionGroups?: DimensionGroup[];
|
|
1075
|
+
}
|
|
1076
|
+
interface DeleteDimensionRequest {
|
|
1077
|
+
/** The dimensions to delete from the sheet. */
|
|
1078
|
+
range?: DimensionRange;
|
|
1079
|
+
}
|
|
1080
|
+
interface DeleteDuplicatesRequest {
|
|
1081
|
+
/** The columns in the range to analyze for duplicate values. If no columns are selected then all columns are analyzed for duplicates. */
|
|
1082
|
+
comparisonColumns?: DimensionRange[];
|
|
1083
|
+
/** The range to remove duplicates rows from. */
|
|
1084
|
+
range?: GridRange;
|
|
1085
|
+
}
|
|
1086
|
+
interface DeleteDuplicatesResponse {
|
|
1087
|
+
/** The number of duplicate rows removed. */
|
|
1088
|
+
duplicatesRemovedCount?: number;
|
|
1089
|
+
}
|
|
1090
|
+
interface DeleteEmbeddedObjectRequest {
|
|
1091
|
+
/** The ID of the embedded object to delete. */
|
|
1092
|
+
objectId?: number;
|
|
1093
|
+
}
|
|
1094
|
+
interface DeleteFilterViewRequest {
|
|
1095
|
+
/** The ID of the filter to delete. */
|
|
1096
|
+
filterId?: number;
|
|
1097
|
+
}
|
|
1098
|
+
interface DeleteNamedRangeRequest {
|
|
1099
|
+
/** The ID of the named range to delete. */
|
|
1100
|
+
namedRangeId?: string;
|
|
1101
|
+
}
|
|
1102
|
+
interface DeleteProtectedRangeRequest {
|
|
1103
|
+
/** The ID of the protected range to delete. */
|
|
1104
|
+
protectedRangeId?: number;
|
|
1105
|
+
}
|
|
1106
|
+
interface DeleteRangeRequest {
|
|
1107
|
+
/** The range of cells to delete. */
|
|
1108
|
+
range?: GridRange;
|
|
1109
|
+
/**
|
|
1110
|
+
* The dimension from which deleted cells will be replaced with. If ROWS, existing cells will be shifted upward to replace the deleted cells. If COLUMNS, existing cells will be shifted
|
|
1111
|
+
* left to replace the deleted cells.
|
|
1112
|
+
*/
|
|
1113
|
+
shiftDimension?: string;
|
|
1114
|
+
}
|
|
1115
|
+
interface DeleteSheetRequest {
|
|
1116
|
+
/** The ID of the sheet to delete. If the sheet is of DATA_SOURCE type, the associated DataSource is also deleted. */
|
|
1117
|
+
sheetId?: number;
|
|
1118
|
+
}
|
|
1119
|
+
interface DeveloperMetadata {
|
|
1120
|
+
/** The location where the metadata is associated. */
|
|
1121
|
+
location?: DeveloperMetadataLocation;
|
|
1122
|
+
/**
|
|
1123
|
+
* The spreadsheet-scoped unique ID that identifies the metadata. IDs may be specified when metadata is created, otherwise one will be randomly generated and assigned. Must be
|
|
1124
|
+
* positive.
|
|
1125
|
+
*/
|
|
1126
|
+
metadataId?: number;
|
|
1127
|
+
/** The metadata key. There may be multiple metadata in a spreadsheet with the same key. Developer metadata must always have a key specified. */
|
|
1128
|
+
metadataKey?: string;
|
|
1129
|
+
/** Data associated with the metadata's key. */
|
|
1130
|
+
metadataValue?: string;
|
|
1131
|
+
/** The metadata visibility. Developer metadata must always have a visibility specified. */
|
|
1132
|
+
visibility?: string;
|
|
1133
|
+
}
|
|
1134
|
+
interface DeveloperMetadataLocation {
|
|
1135
|
+
/**
|
|
1136
|
+
* Represents the row or column when metadata is associated with a dimension. The specified DimensionRange must represent a single row or column; it cannot be unbounded or span
|
|
1137
|
+
* multiple rows or columns.
|
|
1138
|
+
*/
|
|
1139
|
+
dimensionRange?: DimensionRange;
|
|
1140
|
+
/** The type of location this object represents. This field is read-only. */
|
|
1141
|
+
locationType?: string;
|
|
1142
|
+
/** The ID of the sheet when metadata is associated with an entire sheet. */
|
|
1143
|
+
sheetId?: number;
|
|
1144
|
+
/** True when metadata is associated with an entire spreadsheet. */
|
|
1145
|
+
spreadsheet?: boolean;
|
|
1146
|
+
}
|
|
1147
|
+
interface DeveloperMetadataLookup {
|
|
1148
|
+
/**
|
|
1149
|
+
* Determines how this lookup matches the location. If this field is specified as EXACT, only developer metadata associated on the exact location specified is matched. If this field is
|
|
1150
|
+
* specified to INTERSECTING, developer metadata associated on intersecting locations is also matched. If left unspecified, this field assumes a default value of INTERSECTING. If this
|
|
1151
|
+
* field is specified, a metadataLocation must also be specified.
|
|
1152
|
+
*/
|
|
1153
|
+
locationMatchingStrategy?: string;
|
|
1154
|
+
/**
|
|
1155
|
+
* Limits the selected developer metadata to those entries which are associated with locations of the specified type. For example, when this field is specified as ROW this lookup only
|
|
1156
|
+
* considers developer metadata associated on rows. If the field is left unspecified, all location types are considered. This field cannot be specified as SPREADSHEET when the
|
|
1157
|
+
* locationMatchingStrategy is specified as INTERSECTING or when the metadataLocation is specified as a non-spreadsheet location: spreadsheet metadata cannot intersect any other
|
|
1158
|
+
* developer metadata location. This field also must be left unspecified when the locationMatchingStrategy is specified as EXACT.
|
|
1159
|
+
*/
|
|
1160
|
+
locationType?: string;
|
|
1161
|
+
/** Limits the selected developer metadata to that which has a matching DeveloperMetadata.metadata_id. */
|
|
1162
|
+
metadataId?: number;
|
|
1163
|
+
/** Limits the selected developer metadata to that which has a matching DeveloperMetadata.metadata_key. */
|
|
1164
|
+
metadataKey?: string;
|
|
1165
|
+
/**
|
|
1166
|
+
* Limits the selected developer metadata to those entries associated with the specified location. This field either matches exact locations or all intersecting locations according the
|
|
1167
|
+
* specified locationMatchingStrategy.
|
|
1168
|
+
*/
|
|
1169
|
+
metadataLocation?: DeveloperMetadataLocation;
|
|
1170
|
+
/** Limits the selected developer metadata to that which has a matching DeveloperMetadata.metadata_value. */
|
|
1171
|
+
metadataValue?: string;
|
|
1172
|
+
/**
|
|
1173
|
+
* Limits the selected developer metadata to that which has a matching DeveloperMetadata.visibility. If left unspecified, all developer metadata visibile to the requesting project is
|
|
1174
|
+
* considered.
|
|
1175
|
+
*/
|
|
1176
|
+
visibility?: string;
|
|
1177
|
+
}
|
|
1178
|
+
interface DimensionGroup {
|
|
1179
|
+
/**
|
|
1180
|
+
* This field is true if this group is collapsed. A collapsed group remains collapsed if an overlapping group at a shallower depth is expanded. A true value does not imply that all
|
|
1181
|
+
* dimensions within the group are hidden, since a dimension's visibility can change independently from this group property. However, when this property is updated, all dimensions
|
|
1182
|
+
* within it are set to hidden if this field is true, or set to visible if this field is false.
|
|
1183
|
+
*/
|
|
1184
|
+
collapsed?: boolean;
|
|
1185
|
+
/** The depth of the group, representing how many groups have a range that wholly contains the range of this group. */
|
|
1186
|
+
depth?: number;
|
|
1187
|
+
/** The range over which this group exists. */
|
|
1188
|
+
range?: DimensionRange;
|
|
1189
|
+
}
|
|
1190
|
+
interface DimensionProperties {
|
|
1191
|
+
/** Output only. If set, this is a column in a data source sheet. */
|
|
1192
|
+
dataSourceColumnReference?: DataSourceColumnReference;
|
|
1193
|
+
/** The developer metadata associated with a single row or column. */
|
|
1194
|
+
developerMetadata?: DeveloperMetadata[];
|
|
1195
|
+
/** True if this dimension is being filtered. This field is read-only. */
|
|
1196
|
+
hiddenByFilter?: boolean;
|
|
1197
|
+
/** True if this dimension is explicitly hidden. */
|
|
1198
|
+
hiddenByUser?: boolean;
|
|
1199
|
+
/** The height (if a row) or width (if a column) of the dimension in pixels. */
|
|
1200
|
+
pixelSize?: number;
|
|
1201
|
+
}
|
|
1202
|
+
interface DimensionRange {
|
|
1203
|
+
/** The dimension of the span. */
|
|
1204
|
+
dimension?: string;
|
|
1205
|
+
/** The end (exclusive) of the span, or not set if unbounded. */
|
|
1206
|
+
endIndex?: number;
|
|
1207
|
+
/** The sheet this span is on. */
|
|
1208
|
+
sheetId?: number;
|
|
1209
|
+
/** The start (inclusive) of the span, or not set if unbounded. */
|
|
1210
|
+
startIndex?: number;
|
|
1211
|
+
}
|
|
1212
|
+
interface DuplicateFilterViewRequest {
|
|
1213
|
+
/** The ID of the filter being duplicated. */
|
|
1214
|
+
filterId?: number;
|
|
1215
|
+
}
|
|
1216
|
+
interface DuplicateFilterViewResponse {
|
|
1217
|
+
/** The newly created filter. */
|
|
1218
|
+
filter?: FilterView;
|
|
1219
|
+
}
|
|
1220
|
+
interface DuplicateSheetRequest {
|
|
1221
|
+
/** The zero-based index where the new sheet should be inserted. The index of all sheets after this are incremented. */
|
|
1222
|
+
insertSheetIndex?: number;
|
|
1223
|
+
/** If set, the ID of the new sheet. If not set, an ID is chosen. If set, the ID must not conflict with any existing sheet ID. If set, it must be non-negative. */
|
|
1224
|
+
newSheetId?: number;
|
|
1225
|
+
/** The name of the new sheet. If empty, a new name is chosen for you. */
|
|
1226
|
+
newSheetName?: string;
|
|
1227
|
+
/**
|
|
1228
|
+
* The sheet to duplicate. If the source sheet is of DATA_SOURCE type, its backing DataSource is also duplicated and associated with the new copy of the sheet. No data execution is
|
|
1229
|
+
* triggered, the grid data of this sheet is also copied over but only available after the batch request completes.
|
|
1230
|
+
*/
|
|
1231
|
+
sourceSheetId?: number;
|
|
1232
|
+
}
|
|
1233
|
+
interface DuplicateSheetResponse {
|
|
1234
|
+
/** The properties of the duplicate sheet. */
|
|
1235
|
+
properties?: SheetProperties;
|
|
1236
|
+
}
|
|
1237
|
+
interface Editors {
|
|
1238
|
+
/** True if anyone in the document's domain has edit access to the protected range. Domain protection is only supported on documents within a domain. */
|
|
1239
|
+
domainUsersCanEdit?: boolean;
|
|
1240
|
+
/** The email addresses of groups with edit access to the protected range. */
|
|
1241
|
+
groups?: string[];
|
|
1242
|
+
/** The email addresses of users with edit access to the protected range. */
|
|
1243
|
+
users?: string[];
|
|
1244
|
+
}
|
|
1245
|
+
interface EmbeddedChart {
|
|
1246
|
+
/** The border of the chart. */
|
|
1247
|
+
border?: EmbeddedObjectBorder;
|
|
1248
|
+
/** The ID of the chart. */
|
|
1249
|
+
chartId?: number;
|
|
1250
|
+
/** The position of the chart. */
|
|
1251
|
+
position?: EmbeddedObjectPosition;
|
|
1252
|
+
/** The specification of the chart. */
|
|
1253
|
+
spec?: ChartSpec;
|
|
1254
|
+
}
|
|
1255
|
+
interface EmbeddedObjectBorder {
|
|
1256
|
+
/** The color of the border. Deprecated: Use color_style. */
|
|
1257
|
+
color?: Color;
|
|
1258
|
+
/** The color of the border. If color is also set, this field takes precedence. */
|
|
1259
|
+
colorStyle?: ColorStyle;
|
|
1260
|
+
}
|
|
1261
|
+
interface EmbeddedObjectPosition {
|
|
1262
|
+
/** If true, the embedded object is put on a new sheet whose ID is chosen for you. Used only when writing. */
|
|
1263
|
+
newSheet?: boolean;
|
|
1264
|
+
/** The position at which the object is overlaid on top of a grid. */
|
|
1265
|
+
overlayPosition?: OverlayPosition;
|
|
1266
|
+
/** The sheet this is on. Set only if the embedded object is on its own sheet. Must be non-negative. */
|
|
1267
|
+
sheetId?: number;
|
|
1268
|
+
}
|
|
1269
|
+
interface ErrorValue {
|
|
1270
|
+
/** A message with more information about the error (in the spreadsheet's locale). */
|
|
1271
|
+
message?: string;
|
|
1272
|
+
/** The type of error. */
|
|
1273
|
+
type?: string;
|
|
1274
|
+
}
|
|
1275
|
+
interface ExtendedValue {
|
|
1276
|
+
/** Represents a boolean value. */
|
|
1277
|
+
boolValue?: boolean;
|
|
1278
|
+
/** Represents an error. This field is read-only. */
|
|
1279
|
+
errorValue?: ErrorValue;
|
|
1280
|
+
/** Represents a formula. */
|
|
1281
|
+
formulaValue?: string;
|
|
1282
|
+
/** Represents a double value. Note: Dates, Times and DateTimes are represented as doubles in SERIAL_NUMBER format. */
|
|
1283
|
+
numberValue?: number;
|
|
1284
|
+
/** Represents a string value. Leading single quotes are not included. For example, if the user typed `'123` into the UI, this would be represented as a `stringValue` of `"123"`. */
|
|
1285
|
+
stringValue?: string;
|
|
1286
|
+
}
|
|
1287
|
+
interface FilterCriteria {
|
|
1288
|
+
/** A condition that must be true for values to be shown. (This does not override hidden_values -- if a value is listed there, it will still be hidden.) */
|
|
1289
|
+
condition?: BooleanCondition;
|
|
1290
|
+
/** Values that should be hidden. */
|
|
1291
|
+
hiddenValues?: string[];
|
|
1292
|
+
/** The background fill color to filter by; only cells with this fill color are shown. Mutually exclusive with visible_foreground_color. Deprecated: Use visible_background_color_style. */
|
|
1293
|
+
visibleBackgroundColor?: Color;
|
|
1294
|
+
/**
|
|
1295
|
+
* The background fill color to filter by; only cells with this fill color are shown. This field is mutually exclusive with visible_foreground_color, and must be set to an RGB-type
|
|
1296
|
+
* color. If visible_background_color is also set, this field takes precedence.
|
|
1297
|
+
*/
|
|
1298
|
+
visibleBackgroundColorStyle?: ColorStyle;
|
|
1299
|
+
/** The foreground color to filter by; only cells with this foreground color are shown. Mutually exclusive with visible_background_color. Deprecated: Use visible_foreground_color_style. */
|
|
1300
|
+
visibleForegroundColor?: Color;
|
|
1301
|
+
/**
|
|
1302
|
+
* The foreground color to filter by; only cells with this foreground color are shown. This field is mutually exclusive with visible_background_color, and must be set to an RGB-type
|
|
1303
|
+
* color. If visible_foreground_color is also set, this field takes precedence.
|
|
1304
|
+
*/
|
|
1305
|
+
visibleForegroundColorStyle?: ColorStyle;
|
|
1306
|
+
}
|
|
1307
|
+
interface FilterSpec {
|
|
1308
|
+
/** The column index. */
|
|
1309
|
+
columnIndex?: number;
|
|
1310
|
+
/** Reference to a data source column. */
|
|
1311
|
+
dataSourceColumnReference?: DataSourceColumnReference;
|
|
1312
|
+
/** The criteria for the column. */
|
|
1313
|
+
filterCriteria?: FilterCriteria;
|
|
1314
|
+
}
|
|
1315
|
+
interface FilterView {
|
|
1316
|
+
/**
|
|
1317
|
+
* The criteria for showing/hiding values per column. The map's key is the column index, and the value is the criteria for that column. This field is deprecated in favor of
|
|
1318
|
+
* filter_specs.
|
|
1319
|
+
*/
|
|
1320
|
+
criteria?: { [P in string]: FilterCriteria };
|
|
1321
|
+
/**
|
|
1322
|
+
* The filter criteria for showing/hiding values per column. Both criteria and filter_specs are populated in responses. If both fields are specified in an update request, this field
|
|
1323
|
+
* takes precedence.
|
|
1324
|
+
*/
|
|
1325
|
+
filterSpecs?: FilterSpec[];
|
|
1326
|
+
/** The ID of the filter view. */
|
|
1327
|
+
filterViewId?: number;
|
|
1328
|
+
/** The named range this filter view is backed by, if any. When writing, only one of range or named_range_id may be set. */
|
|
1329
|
+
namedRangeId?: string;
|
|
1330
|
+
/** The range this filter view covers. When writing, only one of range or named_range_id may be set. */
|
|
1331
|
+
range?: GridRange;
|
|
1332
|
+
/** The sort order per column. Later specifications are used when values are equal in the earlier specifications. */
|
|
1333
|
+
sortSpecs?: SortSpec[];
|
|
1334
|
+
/** The name of the filter view. */
|
|
1335
|
+
title?: string;
|
|
1336
|
+
}
|
|
1337
|
+
interface FindReplaceRequest {
|
|
1338
|
+
/** True to find/replace over all sheets. */
|
|
1339
|
+
allSheets?: boolean;
|
|
1340
|
+
/** The value to search. */
|
|
1341
|
+
find?: string;
|
|
1342
|
+
/** True if the search should include cells with formulas. False to skip cells with formulas. */
|
|
1343
|
+
includeFormulas?: boolean;
|
|
1344
|
+
/** True if the search is case sensitive. */
|
|
1345
|
+
matchCase?: boolean;
|
|
1346
|
+
/** True if the find value should match the entire cell. */
|
|
1347
|
+
matchEntireCell?: boolean;
|
|
1348
|
+
/** The range to find/replace over. */
|
|
1349
|
+
range?: GridRange;
|
|
1350
|
+
/** The value to use as the replacement. */
|
|
1351
|
+
replacement?: string;
|
|
1352
|
+
/**
|
|
1353
|
+
* True if the find value is a regex. The regular expression and replacement should follow Java regex rules at https://docs.oracle.com/javase/8/docs/api/java/util/regex/Pattern.html.
|
|
1354
|
+
* The replacement string is allowed to refer to capturing groups. For example, if one cell has the contents `"Google Sheets"` and another has `"Google Docs"`, then searching for `"o.*
|
|
1355
|
+
* (.*)"` with a replacement of `"$1 Rocks"` would change the contents of the cells to `"GSheets Rocks"` and `"GDocs Rocks"` respectively.
|
|
1356
|
+
*/
|
|
1357
|
+
searchByRegex?: boolean;
|
|
1358
|
+
/** The sheet to find/replace over. */
|
|
1359
|
+
sheetId?: number;
|
|
1360
|
+
}
|
|
1361
|
+
interface FindReplaceResponse {
|
|
1362
|
+
/** The number of formula cells changed. */
|
|
1363
|
+
formulasChanged?: number;
|
|
1364
|
+
/**
|
|
1365
|
+
* The number of occurrences (possibly multiple within a cell) changed. For example, if replacing `"e"` with `"o"` in `"Google Sheets"`, this would be `"3"` because `"Google Sheets"`
|
|
1366
|
+
* -> `"Googlo Shoots"`.
|
|
1367
|
+
*/
|
|
1368
|
+
occurrencesChanged?: number;
|
|
1369
|
+
/** The number of rows changed. */
|
|
1370
|
+
rowsChanged?: number;
|
|
1371
|
+
/** The number of sheets changed. */
|
|
1372
|
+
sheetsChanged?: number;
|
|
1373
|
+
/** The number of non-formula cells changed. */
|
|
1374
|
+
valuesChanged?: number;
|
|
1375
|
+
}
|
|
1376
|
+
interface GetSpreadsheetByDataFilterRequest {
|
|
1377
|
+
/** The DataFilters used to select which ranges to retrieve from the spreadsheet. */
|
|
1378
|
+
dataFilters?: DataFilter[];
|
|
1379
|
+
/** True if grid data should be returned. This parameter is ignored if a field mask was set in the request. */
|
|
1380
|
+
includeGridData?: boolean;
|
|
1381
|
+
}
|
|
1382
|
+
interface GradientRule {
|
|
1383
|
+
/** The final interpolation point. */
|
|
1384
|
+
maxpoint?: InterpolationPoint;
|
|
1385
|
+
/** An optional midway interpolation point. */
|
|
1386
|
+
midpoint?: InterpolationPoint;
|
|
1387
|
+
/** The starting interpolation point. */
|
|
1388
|
+
minpoint?: InterpolationPoint;
|
|
1389
|
+
}
|
|
1390
|
+
interface GridCoordinate {
|
|
1391
|
+
/** The column index of the coordinate. */
|
|
1392
|
+
columnIndex?: number;
|
|
1393
|
+
/** The row index of the coordinate. */
|
|
1394
|
+
rowIndex?: number;
|
|
1395
|
+
/** The sheet this coordinate is on. */
|
|
1396
|
+
sheetId?: number;
|
|
1397
|
+
}
|
|
1398
|
+
interface GridData {
|
|
1399
|
+
/** Metadata about the requested columns in the grid, starting with the column in start_column. */
|
|
1400
|
+
columnMetadata?: DimensionProperties[];
|
|
1401
|
+
/** The data in the grid, one entry per row, starting with the row in startRow. The values in RowData will correspond to columns starting at start_column. */
|
|
1402
|
+
rowData?: RowData[];
|
|
1403
|
+
/** Metadata about the requested rows in the grid, starting with the row in start_row. */
|
|
1404
|
+
rowMetadata?: DimensionProperties[];
|
|
1405
|
+
/** The first column this GridData refers to, zero-based. */
|
|
1406
|
+
startColumn?: number;
|
|
1407
|
+
/** The first row this GridData refers to, zero-based. */
|
|
1408
|
+
startRow?: number;
|
|
1409
|
+
}
|
|
1410
|
+
interface GridProperties {
|
|
1411
|
+
/** The number of columns in the grid. */
|
|
1412
|
+
columnCount?: number;
|
|
1413
|
+
/** True if the column grouping control toggle is shown after the group. */
|
|
1414
|
+
columnGroupControlAfter?: boolean;
|
|
1415
|
+
/** The number of columns that are frozen in the grid. */
|
|
1416
|
+
frozenColumnCount?: number;
|
|
1417
|
+
/** The number of rows that are frozen in the grid. */
|
|
1418
|
+
frozenRowCount?: number;
|
|
1419
|
+
/** True if the grid isn't showing gridlines in the UI. */
|
|
1420
|
+
hideGridlines?: boolean;
|
|
1421
|
+
/** The number of rows in the grid. */
|
|
1422
|
+
rowCount?: number;
|
|
1423
|
+
/** True if the row grouping control toggle is shown after the group. */
|
|
1424
|
+
rowGroupControlAfter?: boolean;
|
|
1425
|
+
}
|
|
1426
|
+
interface GridRange {
|
|
1427
|
+
/** The end column (exclusive) of the range, or not set if unbounded. */
|
|
1428
|
+
endColumnIndex?: number;
|
|
1429
|
+
/** The end row (exclusive) of the range, or not set if unbounded. */
|
|
1430
|
+
endRowIndex?: number;
|
|
1431
|
+
/** The sheet this range is on. */
|
|
1432
|
+
sheetId?: number;
|
|
1433
|
+
/** The start column (inclusive) of the range, or not set if unbounded. */
|
|
1434
|
+
startColumnIndex?: number;
|
|
1435
|
+
/** The start row (inclusive) of the range, or not set if unbounded. */
|
|
1436
|
+
startRowIndex?: number;
|
|
1437
|
+
}
|
|
1438
|
+
interface HistogramChartSpec {
|
|
1439
|
+
/**
|
|
1440
|
+
* By default the bucket size (the range of values stacked in a single column) is chosen automatically, but it may be overridden here. E.g., A bucket size of 1.5 results in buckets
|
|
1441
|
+
* from 0 - 1.5, 1.5 - 3.0, etc. Cannot be negative. This field is optional.
|
|
1442
|
+
*/
|
|
1443
|
+
bucketSize?: number;
|
|
1444
|
+
/** The position of the chart legend. */
|
|
1445
|
+
legendPosition?: string;
|
|
1446
|
+
/**
|
|
1447
|
+
* The outlier percentile is used to ensure that outliers do not adversely affect the calculation of bucket sizes. For example, setting an outlier percentile of 0.05 indicates that the
|
|
1448
|
+
* top and bottom 5% of values when calculating buckets. The values are still included in the chart, they will be added to the first or last buckets instead of their own buckets. Must
|
|
1449
|
+
* be between 0.0 and 0.5.
|
|
1450
|
+
*/
|
|
1451
|
+
outlierPercentile?: number;
|
|
1452
|
+
/**
|
|
1453
|
+
* The series for a histogram may be either a single series of values to be bucketed or multiple series, each of the same length, containing the name of the series followed by the
|
|
1454
|
+
* values to be bucketed for that series.
|
|
1455
|
+
*/
|
|
1456
|
+
series?: HistogramSeries[];
|
|
1457
|
+
/** Whether horizontal divider lines should be displayed between items in each column. */
|
|
1458
|
+
showItemDividers?: boolean;
|
|
1459
|
+
}
|
|
1460
|
+
interface HistogramRule {
|
|
1461
|
+
/** The maximum value at which items are placed into buckets of constant size. Values above end are lumped into a single bucket. This field is optional. */
|
|
1462
|
+
end?: number;
|
|
1463
|
+
/** The size of the buckets that are created. Must be positive. */
|
|
1464
|
+
interval?: number;
|
|
1465
|
+
/** The minimum value at which items are placed into buckets of constant size. Values below start are lumped into a single bucket. This field is optional. */
|
|
1466
|
+
start?: number;
|
|
1467
|
+
}
|
|
1468
|
+
interface HistogramSeries {
|
|
1469
|
+
/** The color of the column representing this series in each bucket. This field is optional. Deprecated: Use bar_color_style. */
|
|
1470
|
+
barColor?: Color;
|
|
1471
|
+
/** The color of the column representing this series in each bucket. This field is optional. If bar_color is also set, this field takes precedence. */
|
|
1472
|
+
barColorStyle?: ColorStyle;
|
|
1473
|
+
/** The data for this histogram series. */
|
|
1474
|
+
data?: ChartData;
|
|
1475
|
+
}
|
|
1476
|
+
interface InsertDimensionRequest {
|
|
1477
|
+
/**
|
|
1478
|
+
* Whether dimension properties should be extended from the dimensions before or after the newly inserted dimensions. True to inherit from the dimensions before (in which case the
|
|
1479
|
+
* start index must be greater than 0), and false to inherit from the dimensions after. For example, if row index 0 has red background and row index 1 has a green background, then
|
|
1480
|
+
* inserting 2 rows at index 1 can inherit either the green or red background. If `inheritFromBefore` is true, the two new rows will be red (because the row before the insertion point
|
|
1481
|
+
* was red), whereas if `inheritFromBefore` is false, the two new rows will be green (because the row after the insertion point was green).
|
|
1482
|
+
*/
|
|
1483
|
+
inheritFromBefore?: boolean;
|
|
1484
|
+
/** The dimensions to insert. Both the start and end indexes must be bounded. */
|
|
1485
|
+
range?: DimensionRange;
|
|
1486
|
+
}
|
|
1487
|
+
interface InsertRangeRequest {
|
|
1488
|
+
/** The range to insert new cells into. */
|
|
1489
|
+
range?: GridRange;
|
|
1490
|
+
/** The dimension which will be shifted when inserting cells. If ROWS, existing cells will be shifted down. If COLUMNS, existing cells will be shifted right. */
|
|
1491
|
+
shiftDimension?: string;
|
|
1492
|
+
}
|
|
1493
|
+
interface InterpolationPoint {
|
|
1494
|
+
/** The color this interpolation point should use. Deprecated: Use color_style. */
|
|
1495
|
+
color?: Color;
|
|
1496
|
+
/** The color this interpolation point should use. If color is also set, this field takes precedence. */
|
|
1497
|
+
colorStyle?: ColorStyle;
|
|
1498
|
+
/** How the value should be interpreted. */
|
|
1499
|
+
type?: string;
|
|
1500
|
+
/** The value this interpolation point uses. May be a formula. Unused if type is MIN or MAX. */
|
|
1501
|
+
value?: string;
|
|
1502
|
+
}
|
|
1503
|
+
interface Interval {
|
|
1504
|
+
/** Optional. Exclusive end of the interval. If specified, a Timestamp matching this interval will have to be before the end. */
|
|
1505
|
+
endTime?: string;
|
|
1506
|
+
/** Optional. Inclusive start of the interval. If specified, a Timestamp matching this interval will have to be the same or after the start. */
|
|
1507
|
+
startTime?: string;
|
|
1508
|
+
}
|
|
1509
|
+
interface IterativeCalculationSettings {
|
|
1510
|
+
/** When iterative calculation is enabled and successive results differ by less than this threshold value, the calculation rounds stop. */
|
|
1511
|
+
convergenceThreshold?: number;
|
|
1512
|
+
/** When iterative calculation is enabled, the maximum number of calculation rounds to perform. */
|
|
1513
|
+
maxIterations?: number;
|
|
1514
|
+
}
|
|
1515
|
+
interface KeyValueFormat {
|
|
1516
|
+
/** Specifies the horizontal text positioning of key value. This field is optional. If not specified, default positioning is used. */
|
|
1517
|
+
position?: TextPosition;
|
|
1518
|
+
/** Text formatting options for key value. The link field is not supported. */
|
|
1519
|
+
textFormat?: TextFormat;
|
|
1520
|
+
}
|
|
1521
|
+
interface LineStyle {
|
|
1522
|
+
/** The dash type of the line. */
|
|
1523
|
+
type?: string;
|
|
1524
|
+
/** The thickness of the line, in px. */
|
|
1525
|
+
width?: number;
|
|
1526
|
+
}
|
|
1527
|
+
interface Link {
|
|
1528
|
+
/** The link identifier. */
|
|
1529
|
+
uri?: string;
|
|
1530
|
+
}
|
|
1531
|
+
interface ManualRule {
|
|
1532
|
+
/** The list of group names and the corresponding items from the source data that map to each group name. */
|
|
1533
|
+
groups?: ManualRuleGroup[];
|
|
1534
|
+
}
|
|
1535
|
+
interface ManualRuleGroup {
|
|
1536
|
+
/** The group name, which must be a string. Each group in a given ManualRule must have a unique group name. */
|
|
1537
|
+
groupName?: ExtendedValue;
|
|
1538
|
+
/**
|
|
1539
|
+
* The items in the source data that should be placed into this group. Each item may be a string, number, or boolean. Items may appear in at most one group within a given ManualRule.
|
|
1540
|
+
* Items that do not appear in any group will appear on their own.
|
|
1541
|
+
*/
|
|
1542
|
+
items?: ExtendedValue[];
|
|
1543
|
+
}
|
|
1544
|
+
interface MatchedDeveloperMetadata {
|
|
1545
|
+
/** All filters matching the returned developer metadata. */
|
|
1546
|
+
dataFilters?: DataFilter[];
|
|
1547
|
+
/** The developer metadata matching the specified filters. */
|
|
1548
|
+
developerMetadata?: DeveloperMetadata;
|
|
1549
|
+
}
|
|
1550
|
+
interface MatchedValueRange {
|
|
1551
|
+
/** The DataFilters from the request that matched the range of values. */
|
|
1552
|
+
dataFilters?: DataFilter[];
|
|
1553
|
+
/** The values matched by the DataFilter. */
|
|
1554
|
+
valueRange?: ValueRange;
|
|
1555
|
+
}
|
|
1556
|
+
interface MergeCellsRequest {
|
|
1557
|
+
/** How the cells should be merged. */
|
|
1558
|
+
mergeType?: string;
|
|
1559
|
+
/** The range of cells to merge. */
|
|
1560
|
+
range?: GridRange;
|
|
1561
|
+
}
|
|
1562
|
+
interface MoveDimensionRequest {
|
|
1563
|
+
/**
|
|
1564
|
+
* The zero-based start index of where to move the source data to, based on the coordinates *before* the source data is removed from the grid. Existing data will be shifted down or
|
|
1565
|
+
* right (depending on the dimension) to make room for the moved dimensions. The source dimensions are removed from the grid, so the the data may end up in a different index than
|
|
1566
|
+
* specified. For example, given `A1..A5` of `0, 1, 2, 3, 4` and wanting to move `"1"` and `"2"` to between `"3"` and `"4"`, the source would be `ROWS [1..3)`,and the destination index
|
|
1567
|
+
* would be `"4"` (the zero-based index of row 5). The end result would be `A1..A5` of `0, 3, 1, 2, 4`.
|
|
1568
|
+
*/
|
|
1569
|
+
destinationIndex?: number;
|
|
1570
|
+
/** The source dimensions to move. */
|
|
1571
|
+
source?: DimensionRange;
|
|
1572
|
+
}
|
|
1573
|
+
interface NamedRange {
|
|
1574
|
+
/** The name of the named range. */
|
|
1575
|
+
name?: string;
|
|
1576
|
+
/** The ID of the named range. */
|
|
1577
|
+
namedRangeId?: string;
|
|
1578
|
+
/** The range this represents. */
|
|
1579
|
+
range?: GridRange;
|
|
1580
|
+
}
|
|
1581
|
+
interface NumberFormat {
|
|
1582
|
+
/**
|
|
1583
|
+
* 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
|
|
1584
|
+
* guide](/sheets/api/guides/formats) for more information about the supported patterns.
|
|
1585
|
+
*/
|
|
1586
|
+
pattern?: string;
|
|
1587
|
+
/** The type of the number format. When writing, this field must be set. */
|
|
1588
|
+
type?: string;
|
|
1589
|
+
}
|
|
1590
|
+
interface OrgChartSpec {
|
|
1591
|
+
/** The data containing the labels for all the nodes in the chart. Labels must be unique. */
|
|
1592
|
+
labels?: ChartData;
|
|
1593
|
+
/** The color of the org chart nodes. Deprecated: Use node_color_style. */
|
|
1594
|
+
nodeColor?: Color;
|
|
1595
|
+
/** The color of the org chart nodes. If node_color is also set, this field takes precedence. */
|
|
1596
|
+
nodeColorStyle?: ColorStyle;
|
|
1597
|
+
/** The size of the org chart nodes. */
|
|
1598
|
+
nodeSize?: string;
|
|
1599
|
+
/** The data containing the label of the parent for the corresponding node. A blank value indicates that the node has no parent and is a top-level node. This field is optional. */
|
|
1600
|
+
parentLabels?: ChartData;
|
|
1601
|
+
/** The color of the selected org chart nodes. Deprecated: Use selected_node_color_style. */
|
|
1602
|
+
selectedNodeColor?: Color;
|
|
1603
|
+
/** The color of the selected org chart nodes. If selected_node_color is also set, this field takes precedence. */
|
|
1604
|
+
selectedNodeColorStyle?: ColorStyle;
|
|
1605
|
+
/** The data containing the tooltip for the corresponding node. A blank value results in no tooltip being displayed for the node. This field is optional. */
|
|
1606
|
+
tooltips?: ChartData;
|
|
1607
|
+
}
|
|
1608
|
+
interface OverlayPosition {
|
|
1609
|
+
/** The cell the object is anchored to. */
|
|
1610
|
+
anchorCell?: GridCoordinate;
|
|
1611
|
+
/** The height of the object, in pixels. Defaults to 371. */
|
|
1612
|
+
heightPixels?: number;
|
|
1613
|
+
/** The horizontal offset, in pixels, that the object is offset from the anchor cell. */
|
|
1614
|
+
offsetXPixels?: number;
|
|
1615
|
+
/** The vertical offset, in pixels, that the object is offset from the anchor cell. */
|
|
1616
|
+
offsetYPixels?: number;
|
|
1617
|
+
/** The width of the object, in pixels. Defaults to 600. */
|
|
1618
|
+
widthPixels?: number;
|
|
1619
|
+
}
|
|
1620
|
+
interface Padding {
|
|
1621
|
+
/** The bottom padding of the cell. */
|
|
1622
|
+
bottom?: number;
|
|
1623
|
+
/** The left padding of the cell. */
|
|
1624
|
+
left?: number;
|
|
1625
|
+
/** The right padding of the cell. */
|
|
1626
|
+
right?: number;
|
|
1627
|
+
/** The top padding of the cell. */
|
|
1628
|
+
top?: number;
|
|
1629
|
+
}
|
|
1630
|
+
interface PasteDataRequest {
|
|
1631
|
+
/** The coordinate at which the data should start being inserted. */
|
|
1632
|
+
coordinate?: GridCoordinate;
|
|
1633
|
+
/** The data to insert. */
|
|
1634
|
+
data?: string;
|
|
1635
|
+
/** The delimiter in the data. */
|
|
1636
|
+
delimiter?: string;
|
|
1637
|
+
/** True if the data is HTML. */
|
|
1638
|
+
html?: boolean;
|
|
1639
|
+
/** How the data should be pasted. */
|
|
1640
|
+
type?: string;
|
|
1641
|
+
}
|
|
1642
|
+
interface PieChartSpec {
|
|
1643
|
+
/** The data that covers the domain of the pie chart. */
|
|
1644
|
+
domain?: ChartData;
|
|
1645
|
+
/** Where the legend of the pie chart should be drawn. */
|
|
1646
|
+
legendPosition?: string;
|
|
1647
|
+
/** The size of the hole in the pie chart. */
|
|
1648
|
+
pieHole?: number;
|
|
1649
|
+
/** The data that covers the one and only series of the pie chart. */
|
|
1650
|
+
series?: ChartData;
|
|
1651
|
+
/** True if the pie is three dimensional. */
|
|
1652
|
+
threeDimensional?: boolean;
|
|
1653
|
+
}
|
|
1654
|
+
interface PivotFilterCriteria {
|
|
1655
|
+
/**
|
|
1656
|
+
* A condition that must be true for values to be shown. (`visibleValues` does not override this -- even if a value is listed there, it is still hidden if it does not meet the
|
|
1657
|
+
* condition.) Condition values that refer to ranges in A1-notation are evaluated relative to the pivot table sheet. References are treated absolutely, so are not filled down the pivot
|
|
1658
|
+
* table. For example, a condition value of `=A1` on "Pivot Table 1" is treated as `'Pivot Table 1'!$A$1`. The source data of the pivot table can be referenced by column header name.
|
|
1659
|
+
* For example, if the source data has columns named "Revenue" and "Cost" and a condition is applied to the "Revenue" column with type `NUMBER_GREATER` and value `=Cost`, then only
|
|
1660
|
+
* columns where "Revenue" > "Cost" are included.
|
|
1661
|
+
*/
|
|
1662
|
+
condition?: BooleanCondition;
|
|
1663
|
+
/**
|
|
1664
|
+
* Whether values are visible by default. If true, the visible_values are ignored, all values that meet condition (if specified) are shown. If false, values that are both in
|
|
1665
|
+
* visible_values and meet condition are shown.
|
|
1666
|
+
*/
|
|
1667
|
+
visibleByDefault?: boolean;
|
|
1668
|
+
/** Values that should be included. Values not listed here are excluded. */
|
|
1669
|
+
visibleValues?: string[];
|
|
1670
|
+
}
|
|
1671
|
+
interface PivotFilterSpec {
|
|
1672
|
+
/** The column offset of the source range. */
|
|
1673
|
+
columnOffsetIndex?: number;
|
|
1674
|
+
/** The reference to the data source column. */
|
|
1675
|
+
dataSourceColumnReference?: DataSourceColumnReference;
|
|
1676
|
+
/** The criteria for the column. */
|
|
1677
|
+
filterCriteria?: PivotFilterCriteria;
|
|
1678
|
+
}
|
|
1679
|
+
interface PivotGroup {
|
|
1680
|
+
/** The reference to the data source column this grouping is based on. */
|
|
1681
|
+
dataSourceColumnReference?: DataSourceColumnReference;
|
|
1682
|
+
/** The count limit on rows or columns to apply to this pivot group. */
|
|
1683
|
+
groupLimit?: PivotGroupLimit;
|
|
1684
|
+
/** The group rule to apply to this row/column group. */
|
|
1685
|
+
groupRule?: PivotGroupRule;
|
|
1686
|
+
/**
|
|
1687
|
+
* The labels to use for the row/column groups which can be customized. For example, in the following pivot table, the row label is `Region` (which could be renamed to `State`) and the
|
|
1688
|
+
* column label is `Product` (which could be renamed `Item`). Pivot tables created before December 2017 do not have header labels. If you'd like to add header labels to an existing
|
|
1689
|
+
* pivot table, please delete the existing pivot table and then create a new pivot table with same parameters. +--------------+---------+-------+ | SUM of Units | Product | | | Region
|
|
1690
|
+
* | Pen | Paper | +--------------+---------+-------+ | New York | 345 | 98 | | Oregon | 234 | 123 | | Tennessee | 531 | 415 | +--------------+---------+-------+ | Grand Total | 1110 |
|
|
1691
|
+
* 636 | +--------------+---------+-------+
|
|
1692
|
+
*/
|
|
1693
|
+
label?: string;
|
|
1694
|
+
/**
|
|
1695
|
+
* True if the headings in this pivot group should be repeated. This is only valid for row groupings and is ignored by columns. By default, we minimize repetition of headings by not
|
|
1696
|
+
* showing higher level headings where they are the same. For example, even though the third row below corresponds to "Q1 Mar", "Q1" is not shown because it is redundant with previous
|
|
1697
|
+
* rows. Setting repeat_headings to true would cause "Q1" to be repeated for "Feb" and "Mar". +--------------+ | Q1 | Jan | | | Feb | | | Mar | +--------+-----+ | Q1 Total |
|
|
1698
|
+
* +--------------+
|
|
1699
|
+
*/
|
|
1700
|
+
repeatHeadings?: boolean;
|
|
1701
|
+
/** True if the pivot table should include the totals for this grouping. */
|
|
1702
|
+
showTotals?: boolean;
|
|
1703
|
+
/** The order the values in this group should be sorted. */
|
|
1704
|
+
sortOrder?: string;
|
|
1705
|
+
/**
|
|
1706
|
+
* The column offset of the source range that this grouping is based on. For example, if the source was `C10:E15`, a `sourceColumnOffset` of `0` means this group refers to column `C`,
|
|
1707
|
+
* whereas the offset `1` would refer to column `D`.
|
|
1708
|
+
*/
|
|
1709
|
+
sourceColumnOffset?: number;
|
|
1710
|
+
/** The bucket of the opposite pivot group to sort by. If not specified, sorting is alphabetical by this group's values. */
|
|
1711
|
+
valueBucket?: PivotGroupSortValueBucket;
|
|
1712
|
+
/** Metadata about values in the grouping. */
|
|
1713
|
+
valueMetadata?: PivotGroupValueMetadata[];
|
|
1714
|
+
}
|
|
1715
|
+
interface PivotGroupLimit {
|
|
1716
|
+
/**
|
|
1717
|
+
* The order in which the group limit is applied to the pivot table. Pivot group limits are applied from lower to higher order number. Order numbers are normalized to consecutive
|
|
1718
|
+
* integers from 0. For write request, to fully customize the applying orders, all pivot group limits should have this field set with an unique number. Otherwise, the order is
|
|
1719
|
+
* determined by the index in the PivotTable.rows list and then the PivotTable.columns list.
|
|
1720
|
+
*/
|
|
1721
|
+
applyOrder?: number;
|
|
1722
|
+
/** The count limit. */
|
|
1723
|
+
countLimit?: number;
|
|
1724
|
+
}
|
|
1725
|
+
interface PivotGroupRule {
|
|
1726
|
+
/** A DateTimeRule. */
|
|
1727
|
+
dateTimeRule?: DateTimeRule;
|
|
1728
|
+
/** A HistogramRule. */
|
|
1729
|
+
histogramRule?: HistogramRule;
|
|
1730
|
+
/** A ManualRule. */
|
|
1731
|
+
manualRule?: ManualRule;
|
|
1732
|
+
}
|
|
1733
|
+
interface PivotGroupSortValueBucket {
|
|
1734
|
+
/**
|
|
1735
|
+
* Determines the bucket from which values are chosen to sort. For example, in a pivot table with one row group & two column groups, the row group can list up to two values. The first
|
|
1736
|
+
* value corresponds to a value within the first column group, and the second value corresponds to a value in the second column group. If no values are listed, this would indicate that
|
|
1737
|
+
* the row should be sorted according to the "Grand Total" over the column groups. If a single value is listed, this would correspond to using the "Total" of that bucket.
|
|
1738
|
+
*/
|
|
1739
|
+
buckets?: ExtendedValue[];
|
|
1740
|
+
/** The offset in the PivotTable.values list which the values in this grouping should be sorted by. */
|
|
1741
|
+
valuesIndex?: number;
|
|
1742
|
+
}
|
|
1743
|
+
interface PivotGroupValueMetadata {
|
|
1744
|
+
/** True if the data corresponding to the value is collapsed. */
|
|
1745
|
+
collapsed?: boolean;
|
|
1746
|
+
/** The calculated value the metadata corresponds to. (Note that formulaValue is not valid, because the values will be calculated.) */
|
|
1747
|
+
value?: ExtendedValue;
|
|
1748
|
+
}
|
|
1749
|
+
interface PivotTable {
|
|
1750
|
+
/** Each column grouping in the pivot table. */
|
|
1751
|
+
columns?: PivotGroup[];
|
|
1752
|
+
/**
|
|
1753
|
+
* An optional mapping of filters per source column offset. The filters are applied before aggregating data into the pivot table. The map's key is the column offset of the source range
|
|
1754
|
+
* that you want to filter, and the value is the criteria for that column. For example, if the source was `C10:E15`, a key of `0` will have the filter for column `C`, whereas the key
|
|
1755
|
+
* `1` is for column `D`. This field is deprecated in favor of filter_specs.
|
|
1756
|
+
*/
|
|
1757
|
+
criteria?: { [P in string]: PivotFilterCriteria };
|
|
1758
|
+
/** Output only. The data execution status for data source pivot tables. */
|
|
1759
|
+
dataExecutionStatus?: DataExecutionStatus;
|
|
1760
|
+
/** The ID of the data source the pivot table is reading data from. */
|
|
1761
|
+
dataSourceId?: string;
|
|
1762
|
+
/**
|
|
1763
|
+
* The filters applied to the source columns before aggregating data for the pivot table. Both criteria and filter_specs are populated in responses. If both fields are specified in an
|
|
1764
|
+
* update request, this field takes precedence.
|
|
1765
|
+
*/
|
|
1766
|
+
filterSpecs?: PivotFilterSpec[];
|
|
1767
|
+
/** Each row grouping in the pivot table. */
|
|
1768
|
+
rows?: PivotGroup[];
|
|
1769
|
+
/** The range the pivot table is reading data from. */
|
|
1770
|
+
source?: GridRange;
|
|
1771
|
+
/** Whether values should be listed horizontally (as columns) or vertically (as rows). */
|
|
1772
|
+
valueLayout?: string;
|
|
1773
|
+
/** A list of values to include in the pivot table. */
|
|
1774
|
+
values?: PivotValue[];
|
|
1775
|
+
}
|
|
1776
|
+
interface PivotValue {
|
|
1777
|
+
/**
|
|
1778
|
+
* If specified, indicates that pivot values should be displayed as the result of a calculation with another pivot value. For example, if calculated_display_type is specified as
|
|
1779
|
+
* PERCENT_OF_GRAND_TOTAL, all the pivot values are displayed as the percentage of the grand total. In the Sheets editor, this is referred to as "Show As" in the value section of a
|
|
1780
|
+
* pivot table.
|
|
1781
|
+
*/
|
|
1782
|
+
calculatedDisplayType?: string;
|
|
1783
|
+
/** The reference to the data source column that this value reads from. */
|
|
1784
|
+
dataSourceColumnReference?: DataSourceColumnReference;
|
|
1785
|
+
/** A custom formula to calculate the value. The formula must start with an `=` character. */
|
|
1786
|
+
formula?: string;
|
|
1787
|
+
/** A name to use for the value. */
|
|
1788
|
+
name?: string;
|
|
1789
|
+
/**
|
|
1790
|
+
* The column offset of the source range that this value reads from. For example, if the source was `C10:E15`, a `sourceColumnOffset` of `0` means this value refers to column `C`,
|
|
1791
|
+
* whereas the offset `1` would refer to column `D`.
|
|
1792
|
+
*/
|
|
1793
|
+
sourceColumnOffset?: number;
|
|
1794
|
+
/** A function to summarize the value. If formula is set, the only supported values are SUM and CUSTOM. If sourceColumnOffset is set, then `CUSTOM` is not supported. */
|
|
1795
|
+
summarizeFunction?: string;
|
|
1796
|
+
}
|
|
1797
|
+
interface PointStyle {
|
|
1798
|
+
/** The point shape. If empty or unspecified, a default shape is used. */
|
|
1799
|
+
shape?: string;
|
|
1800
|
+
/** The point size. If empty, a default size is used. */
|
|
1801
|
+
size?: number;
|
|
1802
|
+
}
|
|
1803
|
+
interface ProtectedRange {
|
|
1804
|
+
/** The description of this protected range. */
|
|
1805
|
+
description?: string;
|
|
1806
|
+
/**
|
|
1807
|
+
* The users and groups with edit access to the protected range. This field is only visible to users with edit access to the protected range and the document. Editors are not supported
|
|
1808
|
+
* with warning_only protection.
|
|
1809
|
+
*/
|
|
1810
|
+
editors?: Editors;
|
|
1811
|
+
/** The named range this protected range is backed by, if any. When writing, only one of range or named_range_id may be set. */
|
|
1812
|
+
namedRangeId?: string;
|
|
1813
|
+
/** The ID of the protected range. This field is read-only. */
|
|
1814
|
+
protectedRangeId?: number;
|
|
1815
|
+
/**
|
|
1816
|
+
* The range that is being protected. The range may be fully unbounded, in which case this is considered a protected sheet. When writing, only one of range or named_range_id may be
|
|
1817
|
+
* set.
|
|
1818
|
+
*/
|
|
1819
|
+
range?: GridRange;
|
|
1820
|
+
/** True if the user who requested this protected range can edit the protected area. This field is read-only. */
|
|
1821
|
+
requestingUserCanEdit?: boolean;
|
|
1822
|
+
/** The list of unprotected ranges within a protected sheet. Unprotected ranges are only supported on protected sheets. */
|
|
1823
|
+
unprotectedRanges?: GridRange[];
|
|
1824
|
+
/**
|
|
1825
|
+
* True if this protected range will show a warning when editing. Warning-based protection means that every user can edit data in the protected range, except editing will prompt a
|
|
1826
|
+
* warning asking the user to confirm the edit. When writing: if this field is true, then editors is ignored. Additionally, if this field is changed from true to false and the
|
|
1827
|
+
* `editors` field is not set (nor included in the field mask), then the editors will be set to all the editors in the document.
|
|
1828
|
+
*/
|
|
1829
|
+
warningOnly?: boolean;
|
|
1830
|
+
}
|
|
1831
|
+
interface RandomizeRangeRequest {
|
|
1832
|
+
/** The range to randomize. */
|
|
1833
|
+
range?: GridRange;
|
|
1834
|
+
}
|
|
1835
|
+
interface RefreshDataSourceObjectExecutionStatus {
|
|
1836
|
+
/** The data execution status. */
|
|
1837
|
+
dataExecutionStatus?: DataExecutionStatus;
|
|
1838
|
+
/** Reference to a data source object being refreshed. */
|
|
1839
|
+
reference?: DataSourceObjectReference;
|
|
1840
|
+
}
|
|
1841
|
+
interface RefreshDataSourceRequest {
|
|
1842
|
+
/** Reference to a DataSource. If specified, refreshes all associated data source objects for the data source. */
|
|
1843
|
+
dataSourceId?: string;
|
|
1844
|
+
/** Refreshes the data source objects regardless of the current state. If not set and a referenced data source object was in error state, the refresh will fail immediately. */
|
|
1845
|
+
force?: boolean;
|
|
1846
|
+
/** Refreshes all existing data source objects in the spreadsheet. */
|
|
1847
|
+
isAll?: boolean;
|
|
1848
|
+
/** References to data source objects to refresh. */
|
|
1849
|
+
references?: DataSourceObjectReferences;
|
|
1850
|
+
}
|
|
1851
|
+
interface RefreshDataSourceResponse {
|
|
1852
|
+
/** All the refresh status for the data source object references specified in the request. If is_all is specified, the field contains only those in failure status. */
|
|
1853
|
+
statuses?: RefreshDataSourceObjectExecutionStatus[];
|
|
1854
|
+
}
|
|
1855
|
+
interface RepeatCellRequest {
|
|
1856
|
+
/** The data to write. */
|
|
1857
|
+
cell?: CellData;
|
|
1858
|
+
/**
|
|
1859
|
+
* The fields that should be updated. At least one field must be specified. The root `cell` is implied and should not be specified. A single `"*"` can be used as short-hand for listing
|
|
1860
|
+
* every field.
|
|
1861
|
+
*/
|
|
1862
|
+
fields?: string;
|
|
1863
|
+
/** The range to repeat the cell in. */
|
|
1864
|
+
range?: GridRange;
|
|
1865
|
+
}
|
|
1866
|
+
interface Request {
|
|
1867
|
+
/** Adds a new banded range */
|
|
1868
|
+
addBanding?: AddBandingRequest;
|
|
1869
|
+
/** Adds a chart. */
|
|
1870
|
+
addChart?: AddChartRequest;
|
|
1871
|
+
/** Adds a new conditional format rule. */
|
|
1872
|
+
addConditionalFormatRule?: AddConditionalFormatRuleRequest;
|
|
1873
|
+
/** Adds a data source. */
|
|
1874
|
+
addDataSource?: AddDataSourceRequest;
|
|
1875
|
+
/** Creates a group over the specified range. */
|
|
1876
|
+
addDimensionGroup?: AddDimensionGroupRequest;
|
|
1877
|
+
/** Adds a filter view. */
|
|
1878
|
+
addFilterView?: AddFilterViewRequest;
|
|
1879
|
+
/** Adds a named range. */
|
|
1880
|
+
addNamedRange?: AddNamedRangeRequest;
|
|
1881
|
+
/** Adds a protected range. */
|
|
1882
|
+
addProtectedRange?: AddProtectedRangeRequest;
|
|
1883
|
+
/** Adds a sheet. */
|
|
1884
|
+
addSheet?: AddSheetRequest;
|
|
1885
|
+
/** Adds a slicer. */
|
|
1886
|
+
addSlicer?: AddSlicerRequest;
|
|
1887
|
+
/** Appends cells after the last row with data in a sheet. */
|
|
1888
|
+
appendCells?: AppendCellsRequest;
|
|
1889
|
+
/** Appends dimensions to the end of a sheet. */
|
|
1890
|
+
appendDimension?: AppendDimensionRequest;
|
|
1891
|
+
/** Automatically fills in more data based on existing data. */
|
|
1892
|
+
autoFill?: AutoFillRequest;
|
|
1893
|
+
/** Automatically resizes one or more dimensions based on the contents of the cells in that dimension. */
|
|
1894
|
+
autoResizeDimensions?: AutoResizeDimensionsRequest;
|
|
1895
|
+
/** Clears the basic filter on a sheet. */
|
|
1896
|
+
clearBasicFilter?: ClearBasicFilterRequest;
|
|
1897
|
+
/** Copies data from one area and pastes it to another. */
|
|
1898
|
+
copyPaste?: CopyPasteRequest;
|
|
1899
|
+
/** Creates new developer metadata */
|
|
1900
|
+
createDeveloperMetadata?: CreateDeveloperMetadataRequest;
|
|
1901
|
+
/** Cuts data from one area and pastes it to another. */
|
|
1902
|
+
cutPaste?: CutPasteRequest;
|
|
1903
|
+
/** Removes a banded range */
|
|
1904
|
+
deleteBanding?: DeleteBandingRequest;
|
|
1905
|
+
/** Deletes an existing conditional format rule. */
|
|
1906
|
+
deleteConditionalFormatRule?: DeleteConditionalFormatRuleRequest;
|
|
1907
|
+
/** Deletes a data source. */
|
|
1908
|
+
deleteDataSource?: DeleteDataSourceRequest;
|
|
1909
|
+
/** Deletes developer metadata */
|
|
1910
|
+
deleteDeveloperMetadata?: DeleteDeveloperMetadataRequest;
|
|
1911
|
+
/** Deletes rows or columns in a sheet. */
|
|
1912
|
+
deleteDimension?: DeleteDimensionRequest;
|
|
1913
|
+
/** Deletes a group over the specified range. */
|
|
1914
|
+
deleteDimensionGroup?: DeleteDimensionGroupRequest;
|
|
1915
|
+
/** Removes rows containing duplicate values in specified columns of a cell range. */
|
|
1916
|
+
deleteDuplicates?: DeleteDuplicatesRequest;
|
|
1917
|
+
/** Deletes an embedded object (e.g, chart, image) in a sheet. */
|
|
1918
|
+
deleteEmbeddedObject?: DeleteEmbeddedObjectRequest;
|
|
1919
|
+
/** Deletes a filter view from a sheet. */
|
|
1920
|
+
deleteFilterView?: DeleteFilterViewRequest;
|
|
1921
|
+
/** Deletes a named range. */
|
|
1922
|
+
deleteNamedRange?: DeleteNamedRangeRequest;
|
|
1923
|
+
/** Deletes a protected range. */
|
|
1924
|
+
deleteProtectedRange?: DeleteProtectedRangeRequest;
|
|
1925
|
+
/** Deletes a range of cells from a sheet, shifting the remaining cells. */
|
|
1926
|
+
deleteRange?: DeleteRangeRequest;
|
|
1927
|
+
/** Deletes a sheet. */
|
|
1928
|
+
deleteSheet?: DeleteSheetRequest;
|
|
1929
|
+
/** Duplicates a filter view. */
|
|
1930
|
+
duplicateFilterView?: DuplicateFilterViewRequest;
|
|
1931
|
+
/** Duplicates a sheet. */
|
|
1932
|
+
duplicateSheet?: DuplicateSheetRequest;
|
|
1933
|
+
/** Finds and replaces occurrences of some text with other text. */
|
|
1934
|
+
findReplace?: FindReplaceRequest;
|
|
1935
|
+
/** Inserts new rows or columns in a sheet. */
|
|
1936
|
+
insertDimension?: InsertDimensionRequest;
|
|
1937
|
+
/** Inserts new cells in a sheet, shifting the existing cells. */
|
|
1938
|
+
insertRange?: InsertRangeRequest;
|
|
1939
|
+
/** Merges cells together. */
|
|
1940
|
+
mergeCells?: MergeCellsRequest;
|
|
1941
|
+
/** Moves rows or columns to another location in a sheet. */
|
|
1942
|
+
moveDimension?: MoveDimensionRequest;
|
|
1943
|
+
/** Pastes data (HTML or delimited) into a sheet. */
|
|
1944
|
+
pasteData?: PasteDataRequest;
|
|
1945
|
+
/** Randomizes the order of the rows in a range. */
|
|
1946
|
+
randomizeRange?: RandomizeRangeRequest;
|
|
1947
|
+
/** Refreshs one or multiple data sources and associated dbobjects. */
|
|
1948
|
+
refreshDataSource?: RefreshDataSourceRequest;
|
|
1949
|
+
/** Repeats a single cell across a range. */
|
|
1950
|
+
repeatCell?: RepeatCellRequest;
|
|
1951
|
+
/** Sets the basic filter on a sheet. */
|
|
1952
|
+
setBasicFilter?: SetBasicFilterRequest;
|
|
1953
|
+
/** Sets data validation for one or more cells. */
|
|
1954
|
+
setDataValidation?: SetDataValidationRequest;
|
|
1955
|
+
/** Sorts data in a range. */
|
|
1956
|
+
sortRange?: SortRangeRequest;
|
|
1957
|
+
/** Converts a column of text into many columns of text. */
|
|
1958
|
+
textToColumns?: TextToColumnsRequest;
|
|
1959
|
+
/** Trims cells of whitespace (such as spaces, tabs, or new lines). */
|
|
1960
|
+
trimWhitespace?: TrimWhitespaceRequest;
|
|
1961
|
+
/** Unmerges merged cells. */
|
|
1962
|
+
unmergeCells?: UnmergeCellsRequest;
|
|
1963
|
+
/** Updates a banded range */
|
|
1964
|
+
updateBanding?: UpdateBandingRequest;
|
|
1965
|
+
/** Updates the borders in a range of cells. */
|
|
1966
|
+
updateBorders?: UpdateBordersRequest;
|
|
1967
|
+
/** Updates many cells at once. */
|
|
1968
|
+
updateCells?: UpdateCellsRequest;
|
|
1969
|
+
/** Updates a chart's specifications. */
|
|
1970
|
+
updateChartSpec?: UpdateChartSpecRequest;
|
|
1971
|
+
/** Updates an existing conditional format rule. */
|
|
1972
|
+
updateConditionalFormatRule?: UpdateConditionalFormatRuleRequest;
|
|
1973
|
+
/** Updates a data source. */
|
|
1974
|
+
updateDataSource?: UpdateDataSourceRequest;
|
|
1975
|
+
/** Updates an existing developer metadata entry */
|
|
1976
|
+
updateDeveloperMetadata?: UpdateDeveloperMetadataRequest;
|
|
1977
|
+
/** Updates the state of the specified group. */
|
|
1978
|
+
updateDimensionGroup?: UpdateDimensionGroupRequest;
|
|
1979
|
+
/** Updates dimensions' properties. */
|
|
1980
|
+
updateDimensionProperties?: UpdateDimensionPropertiesRequest;
|
|
1981
|
+
/** Updates an embedded object's border. */
|
|
1982
|
+
updateEmbeddedObjectBorder?: UpdateEmbeddedObjectBorderRequest;
|
|
1983
|
+
/** Updates an embedded object's (e.g. chart, image) position. */
|
|
1984
|
+
updateEmbeddedObjectPosition?: UpdateEmbeddedObjectPositionRequest;
|
|
1985
|
+
/** Updates the properties of a filter view. */
|
|
1986
|
+
updateFilterView?: UpdateFilterViewRequest;
|
|
1987
|
+
/** Updates a named range. */
|
|
1988
|
+
updateNamedRange?: UpdateNamedRangeRequest;
|
|
1989
|
+
/** Updates a protected range. */
|
|
1990
|
+
updateProtectedRange?: UpdateProtectedRangeRequest;
|
|
1991
|
+
/** Updates a sheet's properties. */
|
|
1992
|
+
updateSheetProperties?: UpdateSheetPropertiesRequest;
|
|
1993
|
+
/** Updates a slicer's specifications. */
|
|
1994
|
+
updateSlicerSpec?: UpdateSlicerSpecRequest;
|
|
1995
|
+
/** Updates the spreadsheet's properties. */
|
|
1996
|
+
updateSpreadsheetProperties?: UpdateSpreadsheetPropertiesRequest;
|
|
1997
|
+
}
|
|
1998
|
+
interface Response {
|
|
1999
|
+
/** A reply from adding a banded range. */
|
|
2000
|
+
addBanding?: AddBandingResponse;
|
|
2001
|
+
/** A reply from adding a chart. */
|
|
2002
|
+
addChart?: AddChartResponse;
|
|
2003
|
+
/** A reply from adding a data source. */
|
|
2004
|
+
addDataSource?: AddDataSourceResponse;
|
|
2005
|
+
/** A reply from adding a dimension group. */
|
|
2006
|
+
addDimensionGroup?: AddDimensionGroupResponse;
|
|
2007
|
+
/** A reply from adding a filter view. */
|
|
2008
|
+
addFilterView?: AddFilterViewResponse;
|
|
2009
|
+
/** A reply from adding a named range. */
|
|
2010
|
+
addNamedRange?: AddNamedRangeResponse;
|
|
2011
|
+
/** A reply from adding a protected range. */
|
|
2012
|
+
addProtectedRange?: AddProtectedRangeResponse;
|
|
2013
|
+
/** A reply from adding a sheet. */
|
|
2014
|
+
addSheet?: AddSheetResponse;
|
|
2015
|
+
/** A reply from adding a slicer. */
|
|
2016
|
+
addSlicer?: AddSlicerResponse;
|
|
2017
|
+
/** A reply from creating a developer metadata entry. */
|
|
2018
|
+
createDeveloperMetadata?: CreateDeveloperMetadataResponse;
|
|
2019
|
+
/** A reply from deleting a conditional format rule. */
|
|
2020
|
+
deleteConditionalFormatRule?: DeleteConditionalFormatRuleResponse;
|
|
2021
|
+
/** A reply from deleting a developer metadata entry. */
|
|
2022
|
+
deleteDeveloperMetadata?: DeleteDeveloperMetadataResponse;
|
|
2023
|
+
/** A reply from deleting a dimension group. */
|
|
2024
|
+
deleteDimensionGroup?: DeleteDimensionGroupResponse;
|
|
2025
|
+
/** A reply from removing rows containing duplicate values. */
|
|
2026
|
+
deleteDuplicates?: DeleteDuplicatesResponse;
|
|
2027
|
+
/** A reply from duplicating a filter view. */
|
|
2028
|
+
duplicateFilterView?: DuplicateFilterViewResponse;
|
|
2029
|
+
/** A reply from duplicating a sheet. */
|
|
2030
|
+
duplicateSheet?: DuplicateSheetResponse;
|
|
2031
|
+
/** A reply from doing a find/replace. */
|
|
2032
|
+
findReplace?: FindReplaceResponse;
|
|
2033
|
+
/** A reply from refreshing data source objects. */
|
|
2034
|
+
refreshDataSource?: RefreshDataSourceResponse;
|
|
2035
|
+
/** A reply from trimming whitespace. */
|
|
2036
|
+
trimWhitespace?: TrimWhitespaceResponse;
|
|
2037
|
+
/** A reply from updating a conditional format rule. */
|
|
2038
|
+
updateConditionalFormatRule?: UpdateConditionalFormatRuleResponse;
|
|
2039
|
+
/** A reply from updating a data source. */
|
|
2040
|
+
updateDataSource?: UpdateDataSourceResponse;
|
|
2041
|
+
/** A reply from updating a developer metadata entry. */
|
|
2042
|
+
updateDeveloperMetadata?: UpdateDeveloperMetadataResponse;
|
|
2043
|
+
/** A reply from updating an embedded object's position. */
|
|
2044
|
+
updateEmbeddedObjectPosition?: UpdateEmbeddedObjectPositionResponse;
|
|
2045
|
+
}
|
|
2046
|
+
interface RowData {
|
|
2047
|
+
/** The values in the row, one per column. */
|
|
2048
|
+
values?: CellData[];
|
|
2049
|
+
}
|
|
2050
|
+
interface ScorecardChartSpec {
|
|
2051
|
+
/**
|
|
2052
|
+
* The aggregation type for key and baseline chart data in scorecard chart. This field is not supported for data source charts. Use the ChartData.aggregateType field of the
|
|
2053
|
+
* key_value_data or baseline_value_data instead for data source charts. This field is optional.
|
|
2054
|
+
*/
|
|
2055
|
+
aggregateType?: string;
|
|
2056
|
+
/** The data for scorecard baseline value. This field is optional. */
|
|
2057
|
+
baselineValueData?: ChartData;
|
|
2058
|
+
/** Formatting options for baseline value. This field is needed only if baseline_value_data is specified. */
|
|
2059
|
+
baselineValueFormat?: BaselineValueFormat;
|
|
2060
|
+
/** Custom formatting options for numeric key/baseline values in scorecard chart. This field is used only when number_format_source is set to CUSTOM. This field is optional. */
|
|
2061
|
+
customFormatOptions?: ChartCustomNumberFormatOptions;
|
|
2062
|
+
/** The data for scorecard key value. */
|
|
2063
|
+
keyValueData?: ChartData;
|
|
2064
|
+
/** Formatting options for key value. */
|
|
2065
|
+
keyValueFormat?: KeyValueFormat;
|
|
2066
|
+
/** The number format source used in the scorecard chart. This field is optional. */
|
|
2067
|
+
numberFormatSource?: string;
|
|
2068
|
+
/** Value to scale scorecard key and baseline value. For example, a factor of 10 can be used to divide all values in the chart by 10. This field is optional. */
|
|
2069
|
+
scaleFactor?: number;
|
|
2070
|
+
}
|
|
2071
|
+
interface SearchDeveloperMetadataRequest {
|
|
2072
|
+
/**
|
|
2073
|
+
* The data filters describing the criteria used to determine which DeveloperMetadata entries to return. DeveloperMetadata matching any of the specified filters are included in the
|
|
2074
|
+
* response.
|
|
2075
|
+
*/
|
|
2076
|
+
dataFilters?: DataFilter[];
|
|
2077
|
+
}
|
|
2078
|
+
interface SearchDeveloperMetadataResponse {
|
|
2079
|
+
/** The metadata matching the criteria of the search request. */
|
|
2080
|
+
matchedDeveloperMetadata?: MatchedDeveloperMetadata[];
|
|
2081
|
+
}
|
|
2082
|
+
interface SetBasicFilterRequest {
|
|
2083
|
+
/** The filter to set. */
|
|
2084
|
+
filter?: BasicFilter;
|
|
2085
|
+
}
|
|
2086
|
+
interface SetDataValidationRequest {
|
|
2087
|
+
/** The range the data validation rule should apply to. */
|
|
2088
|
+
range?: GridRange;
|
|
2089
|
+
/** The data validation rule to set on each cell in the range, or empty to clear the data validation in the range. */
|
|
2090
|
+
rule?: DataValidationRule;
|
|
2091
|
+
}
|
|
2092
|
+
interface Sheet {
|
|
2093
|
+
/** The banded (alternating colors) ranges on this sheet. */
|
|
2094
|
+
bandedRanges?: BandedRange[];
|
|
2095
|
+
/** The filter on this sheet, if any. */
|
|
2096
|
+
basicFilter?: BasicFilter;
|
|
2097
|
+
/** The specifications of every chart on this sheet. */
|
|
2098
|
+
charts?: EmbeddedChart[];
|
|
2099
|
+
/** All column groups on this sheet, ordered by increasing range start index, then by group depth. */
|
|
2100
|
+
columnGroups?: DimensionGroup[];
|
|
2101
|
+
/** The conditional format rules in this sheet. */
|
|
2102
|
+
conditionalFormats?: ConditionalFormatRule[];
|
|
2103
|
+
/**
|
|
2104
|
+
* Data in the grid, if this is a grid sheet. The number of GridData objects returned is dependent on the number of ranges requested on this sheet. For example, if this is representing
|
|
2105
|
+
* `Sheet1`, and the spreadsheet was requested with ranges `Sheet1!A1:C10` and `Sheet1!D15:E20`, then the first GridData will have a startRow/startColumn of `0`, while the second one
|
|
2106
|
+
* will have `startRow 14` (zero-based row 15), and `startColumn 3` (zero-based column D). For a DATA_SOURCE sheet, you can not request a specific range, the GridData contains all the
|
|
2107
|
+
* values.
|
|
2108
|
+
*/
|
|
2109
|
+
data?: GridData[];
|
|
2110
|
+
/** The developer metadata associated with a sheet. */
|
|
2111
|
+
developerMetadata?: DeveloperMetadata[];
|
|
2112
|
+
/** The filter views in this sheet. */
|
|
2113
|
+
filterViews?: FilterView[];
|
|
2114
|
+
/** The ranges that are merged together. */
|
|
2115
|
+
merges?: GridRange[];
|
|
2116
|
+
/** The properties of the sheet. */
|
|
2117
|
+
properties?: SheetProperties;
|
|
2118
|
+
/** The protected ranges in this sheet. */
|
|
2119
|
+
protectedRanges?: ProtectedRange[];
|
|
2120
|
+
/** All row groups on this sheet, ordered by increasing range start index, then by group depth. */
|
|
2121
|
+
rowGroups?: DimensionGroup[];
|
|
2122
|
+
/** The slicers on this sheet. */
|
|
2123
|
+
slicers?: Slicer[];
|
|
2124
|
+
}
|
|
2125
|
+
interface SheetProperties {
|
|
2126
|
+
/** Output only. If present, the field contains DATA_SOURCE sheet specific properties. */
|
|
2127
|
+
dataSourceSheetProperties?: DataSourceSheetProperties;
|
|
2128
|
+
/**
|
|
2129
|
+
* Additional properties of the sheet if this sheet is a grid. (If the sheet is an object sheet, containing a chart or image, then this field will be absent.) When writing it is an
|
|
2130
|
+
* error to set any grid properties on non-grid sheets. If this sheet is a DATA_SOURCE sheet, this field is output only but contains the properties that reflect how a data source sheet
|
|
2131
|
+
* is rendered in the UI, e.g. row_count.
|
|
2132
|
+
*/
|
|
2133
|
+
gridProperties?: GridProperties;
|
|
2134
|
+
/** True if the sheet is hidden in the UI, false if it's visible. */
|
|
2135
|
+
hidden?: boolean;
|
|
2136
|
+
/**
|
|
2137
|
+
* The index of the sheet within the spreadsheet. When adding or updating sheet properties, if this field is excluded then the sheet is added or moved to the end of the sheet list.
|
|
2138
|
+
* When updating sheet indices or inserting sheets, movement is considered in "before the move" indexes. For example, if there were 3 sheets (S1, S2, S3) in order to move S1 ahead of
|
|
2139
|
+
* S2 the index would have to be set to 2. A sheet index update request is ignored if the requested index is identical to the sheets current index or if the requested new index is
|
|
2140
|
+
* equal to the current sheet index + 1.
|
|
2141
|
+
*/
|
|
2142
|
+
index?: number;
|
|
2143
|
+
/** True if the sheet is an RTL sheet instead of an LTR sheet. */
|
|
2144
|
+
rightToLeft?: boolean;
|
|
2145
|
+
/** The ID of the sheet. Must be non-negative. This field cannot be changed once set. */
|
|
2146
|
+
sheetId?: number;
|
|
2147
|
+
/** The type of sheet. Defaults to GRID. This field cannot be changed once set. */
|
|
2148
|
+
sheetType?: string;
|
|
2149
|
+
/** The color of the tab in the UI. Deprecated: Use tab_color_style. */
|
|
2150
|
+
tabColor?: Color;
|
|
2151
|
+
/** The color of the tab in the UI. If tab_color is also set, this field takes precedence. */
|
|
2152
|
+
tabColorStyle?: ColorStyle;
|
|
2153
|
+
/** The name of the sheet. */
|
|
2154
|
+
title?: string;
|
|
2155
|
+
}
|
|
2156
|
+
interface Slicer {
|
|
2157
|
+
/**
|
|
2158
|
+
* The position of the slicer. Note that slicer can be positioned only on existing sheet. Also, width and height of slicer can be automatically adjusted to keep it within permitted
|
|
2159
|
+
* limits.
|
|
2160
|
+
*/
|
|
2161
|
+
position?: EmbeddedObjectPosition;
|
|
2162
|
+
/** The ID of the slicer. */
|
|
2163
|
+
slicerId?: number;
|
|
2164
|
+
/** The specification of the slicer. */
|
|
2165
|
+
spec?: SlicerSpec;
|
|
2166
|
+
}
|
|
2167
|
+
interface SlicerSpec {
|
|
2168
|
+
/** True if the filter should apply to pivot tables. If not set, default to `True`. */
|
|
2169
|
+
applyToPivotTables?: boolean;
|
|
2170
|
+
/** The background color of the slicer. Deprecated: Use background_color_style. */
|
|
2171
|
+
backgroundColor?: Color;
|
|
2172
|
+
/** The background color of the slicer. If background_color is also set, this field takes precedence. */
|
|
2173
|
+
backgroundColorStyle?: ColorStyle;
|
|
2174
|
+
/** The column index in the data table on which the filter is applied to. */
|
|
2175
|
+
columnIndex?: number;
|
|
2176
|
+
/** The data range of the slicer. */
|
|
2177
|
+
dataRange?: GridRange;
|
|
2178
|
+
/** The filtering criteria of the slicer. */
|
|
2179
|
+
filterCriteria?: FilterCriteria;
|
|
2180
|
+
/** The horizontal alignment of title in the slicer. If unspecified, defaults to `LEFT` */
|
|
2181
|
+
horizontalAlignment?: string;
|
|
2182
|
+
/** The text format of title in the slicer. The link field is not supported. */
|
|
2183
|
+
textFormat?: TextFormat;
|
|
2184
|
+
/** The title of the slicer. */
|
|
2185
|
+
title?: string;
|
|
2186
|
+
}
|
|
2187
|
+
interface SortRangeRequest {
|
|
2188
|
+
/** The range to sort. */
|
|
2189
|
+
range?: GridRange;
|
|
2190
|
+
/** The sort order per column. Later specifications are used when values are equal in the earlier specifications. */
|
|
2191
|
+
sortSpecs?: SortSpec[];
|
|
2192
|
+
}
|
|
2193
|
+
interface SortSpec {
|
|
2194
|
+
/** The background fill color to sort by; cells with this fill color are sorted to the top. Mutually exclusive with foreground_color. Deprecated: Use background_color_style. */
|
|
2195
|
+
backgroundColor?: Color;
|
|
2196
|
+
/**
|
|
2197
|
+
* The background fill color to sort by; cells with this fill color are sorted to the top. Mutually exclusive with foreground_color, and must be an RGB-type color. If background_color
|
|
2198
|
+
* is also set, this field takes precedence.
|
|
2199
|
+
*/
|
|
2200
|
+
backgroundColorStyle?: ColorStyle;
|
|
2201
|
+
/** Reference to a data source column. */
|
|
2202
|
+
dataSourceColumnReference?: DataSourceColumnReference;
|
|
2203
|
+
/** The dimension the sort should be applied to. */
|
|
2204
|
+
dimensionIndex?: number;
|
|
2205
|
+
/** The foreground color to sort by; cells with this foreground color are sorted to the top. Mutually exclusive with background_color. Deprecated: Use foreground_color_style. */
|
|
2206
|
+
foregroundColor?: Color;
|
|
2207
|
+
/**
|
|
2208
|
+
* The foreground color to sort by; cells with this foreground color are sorted to the top. Mutually exclusive with background_color, and must be an RGB-type color. If foreground_color
|
|
2209
|
+
* is also set, this field takes precedence.
|
|
2210
|
+
*/
|
|
2211
|
+
foregroundColorStyle?: ColorStyle;
|
|
2212
|
+
/** The order data should be sorted. */
|
|
2213
|
+
sortOrder?: string;
|
|
2214
|
+
}
|
|
2215
|
+
interface SourceAndDestination {
|
|
2216
|
+
/** The dimension that data should be filled into. */
|
|
2217
|
+
dimension?: string;
|
|
2218
|
+
/**
|
|
2219
|
+
* The number of rows or columns that data should be filled into. Positive numbers expand beyond the last row or last column of the source. Negative numbers expand before the first row
|
|
2220
|
+
* or first column of the source.
|
|
2221
|
+
*/
|
|
2222
|
+
fillLength?: number;
|
|
2223
|
+
/** The location of the data to use as the source of the autofill. */
|
|
2224
|
+
source?: GridRange;
|
|
2225
|
+
}
|
|
2226
|
+
interface Spreadsheet {
|
|
2227
|
+
/** A list of external data sources connected with the spreadsheet. */
|
|
2228
|
+
dataSources?: DataSource[];
|
|
2229
|
+
/** Output only. A list of data source refresh schedules. */
|
|
2230
|
+
dataSourceSchedules?: DataSourceRefreshSchedule[];
|
|
2231
|
+
/** The developer metadata associated with a spreadsheet. */
|
|
2232
|
+
developerMetadata?: DeveloperMetadata[];
|
|
2233
|
+
/** The named ranges defined in a spreadsheet. */
|
|
2234
|
+
namedRanges?: NamedRange[];
|
|
2235
|
+
/** Overall properties of a spreadsheet. */
|
|
2236
|
+
properties?: SpreadsheetProperties;
|
|
2237
|
+
/** The sheets that are part of a spreadsheet. */
|
|
2238
|
+
sheets?: Sheet[];
|
|
2239
|
+
/** The ID of the spreadsheet. This field is read-only. */
|
|
2240
|
+
spreadsheetId?: string;
|
|
2241
|
+
/** The url of the spreadsheet. This field is read-only. */
|
|
2242
|
+
spreadsheetUrl?: string;
|
|
2243
|
+
}
|
|
2244
|
+
interface SpreadsheetProperties {
|
|
2245
|
+
/** The amount of time to wait before volatile functions are recalculated. */
|
|
2246
|
+
autoRecalc?: string;
|
|
2247
|
+
/** The default format of all cells in the spreadsheet. CellData.effectiveFormat will not be set if the cell's format is equal to this default format. This field is read-only. */
|
|
2248
|
+
defaultFormat?: CellFormat;
|
|
2249
|
+
/** Determines whether and how circular references are resolved with iterative calculation. Absence of this field means that circular references result in calculation errors. */
|
|
2250
|
+
iterativeCalculationSettings?: IterativeCalculationSettings;
|
|
2251
|
+
/**
|
|
2252
|
+
* The locale of the spreadsheet in one of the following formats: * an ISO 639-1 language code such as `en` * an ISO 639-2 language code such as `fil`, if no 639-1 code exists * a
|
|
2253
|
+
* combination of the ISO language code and country code, such as `en_US` Note: when updating this field, not all locales/languages are supported.
|
|
2254
|
+
*/
|
|
2255
|
+
locale?: string;
|
|
2256
|
+
/** Theme applied to the spreadsheet. */
|
|
2257
|
+
spreadsheetTheme?: SpreadsheetTheme;
|
|
2258
|
+
/** The time zone of the spreadsheet, in CLDR format such as `America/New_York`. If the time zone isn't recognized, this may be a custom time zone such as `GMT-07:00`. */
|
|
2259
|
+
timeZone?: string;
|
|
2260
|
+
/** The title of the spreadsheet. */
|
|
2261
|
+
title?: string;
|
|
2262
|
+
}
|
|
2263
|
+
interface SpreadsheetTheme {
|
|
2264
|
+
/** Name of the primary font family. */
|
|
2265
|
+
primaryFontFamily?: string;
|
|
2266
|
+
/** The spreadsheet theme color pairs. To update you must provide all theme color pairs. */
|
|
2267
|
+
themeColors?: ThemeColorPair[];
|
|
2268
|
+
}
|
|
2269
|
+
interface TextFormat {
|
|
2270
|
+
/** True if the text is bold. */
|
|
2271
|
+
bold?: boolean;
|
|
2272
|
+
/** The font family. */
|
|
2273
|
+
fontFamily?: string;
|
|
2274
|
+
/** The size of the font. */
|
|
2275
|
+
fontSize?: number;
|
|
2276
|
+
/** The foreground color of the text. Deprecated: Use foreground_color_style. */
|
|
2277
|
+
foregroundColor?: Color;
|
|
2278
|
+
/** The foreground color of the text. If foreground_color is also set, this field takes precedence. */
|
|
2279
|
+
foregroundColorStyle?: ColorStyle;
|
|
2280
|
+
/** True if the text is italicized. */
|
|
2281
|
+
italic?: boolean;
|
|
2282
|
+
/**
|
|
2283
|
+
* The link destination of the text, if any. Setting the link field in a TextFormatRun will clear the cell's existing links or a cell-level link set in the same request. When a link is
|
|
2284
|
+
* set, the text foreground color will be set to the default link color and the text will be underlined. If these fields are modified in the same request, those values will be used
|
|
2285
|
+
* instead of the link defaults.
|
|
2286
|
+
*/
|
|
2287
|
+
link?: Link;
|
|
2288
|
+
/** True if the text has a strikethrough. */
|
|
2289
|
+
strikethrough?: boolean;
|
|
2290
|
+
/** True if the text is underlined. */
|
|
2291
|
+
underline?: boolean;
|
|
2292
|
+
}
|
|
2293
|
+
interface TextFormatRun {
|
|
2294
|
+
/** The format of this run. Absent values inherit the cell's format. */
|
|
2295
|
+
format?: TextFormat;
|
|
2296
|
+
/** The character index where this run starts. */
|
|
2297
|
+
startIndex?: number;
|
|
2298
|
+
}
|
|
2299
|
+
interface TextPosition {
|
|
2300
|
+
/** Horizontal alignment setting for the piece of text. */
|
|
2301
|
+
horizontalAlignment?: string;
|
|
2302
|
+
}
|
|
2303
|
+
interface TextRotation {
|
|
2304
|
+
/**
|
|
2305
|
+
* The angle between the standard orientation and the desired orientation. Measured in degrees. Valid values are between -90 and 90. Positive angles are angled upwards, negative are
|
|
2306
|
+
* angled downwards. Note: For LTR text direction positive angles are in the counterclockwise direction, whereas for RTL they are in the clockwise direction
|
|
2307
|
+
*/
|
|
2308
|
+
angle?: number;
|
|
2309
|
+
/** If true, text reads top to bottom, but the orientation of individual characters is unchanged. For example: | V | | e | | r | | t | | i | | c | | a | | l | */
|
|
2310
|
+
vertical?: boolean;
|
|
2311
|
+
}
|
|
2312
|
+
interface TextToColumnsRequest {
|
|
2313
|
+
/** The delimiter to use. Used only if delimiterType is CUSTOM. */
|
|
2314
|
+
delimiter?: string;
|
|
2315
|
+
/** The delimiter type to use. */
|
|
2316
|
+
delimiterType?: string;
|
|
2317
|
+
/** The source data range. This must span exactly one column. */
|
|
2318
|
+
source?: GridRange;
|
|
2319
|
+
}
|
|
2320
|
+
interface ThemeColorPair {
|
|
2321
|
+
/** The concrete color corresponding to the theme color type. */
|
|
2322
|
+
color?: ColorStyle;
|
|
2323
|
+
/** The type of the spreadsheet theme color. */
|
|
2324
|
+
colorType?: string;
|
|
2325
|
+
}
|
|
2326
|
+
interface TimeOfDay {
|
|
2327
|
+
/** Hours of day in 24 hour format. Should be from 0 to 23. An API may choose to allow the value "24:00:00" for scenarios like business closing time. */
|
|
2328
|
+
hours?: number;
|
|
2329
|
+
/** Minutes of hour of day. Must be from 0 to 59. */
|
|
2330
|
+
minutes?: number;
|
|
2331
|
+
/** Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999. */
|
|
2332
|
+
nanos?: number;
|
|
2333
|
+
/** Seconds of minutes of the time. Must normally be from 0 to 59. An API may allow the value 60 if it allows leap-seconds. */
|
|
2334
|
+
seconds?: number;
|
|
2335
|
+
}
|
|
2336
|
+
interface TreemapChartColorScale {
|
|
2337
|
+
/** The background color for cells with a color value greater than or equal to maxValue. Defaults to #109618 if not specified. Deprecated: Use max_value_color_style. */
|
|
2338
|
+
maxValueColor?: Color;
|
|
2339
|
+
/**
|
|
2340
|
+
* The background color for cells with a color value greater than or equal to maxValue. Defaults to #109618 if not specified. If max_value_color is also set, this field takes
|
|
2341
|
+
* precedence.
|
|
2342
|
+
*/
|
|
2343
|
+
maxValueColorStyle?: ColorStyle;
|
|
2344
|
+
/** The background color for cells with a color value at the midpoint between minValue and maxValue. Defaults to #efe6dc if not specified. Deprecated: Use mid_value_color_style. */
|
|
2345
|
+
midValueColor?: Color;
|
|
2346
|
+
/**
|
|
2347
|
+
* The background color for cells with a color value at the midpoint between minValue and maxValue. Defaults to #efe6dc if not specified. If mid_value_color is also set, this field
|
|
2348
|
+
* takes precedence.
|
|
2349
|
+
*/
|
|
2350
|
+
midValueColorStyle?: ColorStyle;
|
|
2351
|
+
/** The background color for cells with a color value less than or equal to minValue. Defaults to #dc3912 if not specified. Deprecated: Use min_value_color_style. */
|
|
2352
|
+
minValueColor?: Color;
|
|
2353
|
+
/** The background color for cells with a color value less than or equal to minValue. Defaults to #dc3912 if not specified. If min_value_color is also set, this field takes precedence. */
|
|
2354
|
+
minValueColorStyle?: ColorStyle;
|
|
2355
|
+
/** The background color for cells that have no color data associated with them. Defaults to #000000 if not specified. Deprecated: Use no_data_color_style. */
|
|
2356
|
+
noDataColor?: Color;
|
|
2357
|
+
/** The background color for cells that have no color data associated with them. Defaults to #000000 if not specified. If no_data_color is also set, this field takes precedence. */
|
|
2358
|
+
noDataColorStyle?: ColorStyle;
|
|
2359
|
+
}
|
|
2360
|
+
interface TreemapChartSpec {
|
|
2361
|
+
/**
|
|
2362
|
+
* The data that determines the background color of each treemap data cell. This field is optional. If not specified, size_data is used to determine background colors. If specified,
|
|
2363
|
+
* the data is expected to be numeric. color_scale will determine how the values in this data map to data cell background colors.
|
|
2364
|
+
*/
|
|
2365
|
+
colorData?: ChartData;
|
|
2366
|
+
/**
|
|
2367
|
+
* The color scale for data cells in the treemap chart. Data cells are assigned colors based on their color values. These color values come from color_data, or from size_data if
|
|
2368
|
+
* color_data is not specified. Cells with color values less than or equal to min_value will have minValueColor as their background color. Cells with color values greater than or equal
|
|
2369
|
+
* to max_value will have maxValueColor as their background color. Cells with color values between min_value and max_value will have background colors on a gradient between
|
|
2370
|
+
* minValueColor and maxValueColor, the midpoint of the gradient being midValueColor. Cells with missing or non-numeric color values will have noDataColor as their background color.
|
|
2371
|
+
*/
|
|
2372
|
+
colorScale?: TreemapChartColorScale;
|
|
2373
|
+
/** The background color for header cells. Deprecated: Use header_color_style. */
|
|
2374
|
+
headerColor?: Color;
|
|
2375
|
+
/** The background color for header cells. If header_color is also set, this field takes precedence. */
|
|
2376
|
+
headerColorStyle?: ColorStyle;
|
|
2377
|
+
/** True to hide tooltips. */
|
|
2378
|
+
hideTooltips?: boolean;
|
|
2379
|
+
/**
|
|
2380
|
+
* The number of additional data levels beyond the labeled levels to be shown on the treemap chart. These levels are not interactive and are shown without their labels. Defaults to 0
|
|
2381
|
+
* if not specified.
|
|
2382
|
+
*/
|
|
2383
|
+
hintedLevels?: number;
|
|
2384
|
+
/** The data that contains the treemap cell labels. */
|
|
2385
|
+
labels?: ChartData;
|
|
2386
|
+
/** The number of data levels to show on the treemap chart. These levels are interactive and are shown with their labels. Defaults to 2 if not specified. */
|
|
2387
|
+
levels?: number;
|
|
2388
|
+
/**
|
|
2389
|
+
* The maximum possible data value. Cells with values greater than this will have the same color as cells with this value. If not specified, defaults to the actual maximum value from
|
|
2390
|
+
* color_data, or the maximum value from size_data if color_data is not specified.
|
|
2391
|
+
*/
|
|
2392
|
+
maxValue?: number;
|
|
2393
|
+
/**
|
|
2394
|
+
* The minimum possible data value. Cells with values less than this will have the same color as cells with this value. If not specified, defaults to the actual minimum value from
|
|
2395
|
+
* color_data, or the minimum value from size_data if color_data is not specified.
|
|
2396
|
+
*/
|
|
2397
|
+
minValue?: number;
|
|
2398
|
+
/** The data the contains the treemap cells' parent labels. */
|
|
2399
|
+
parentLabels?: ChartData;
|
|
2400
|
+
/**
|
|
2401
|
+
* The data that determines the size of each treemap data cell. This data is expected to be numeric. The cells corresponding to non-numeric or missing data will not be rendered. If
|
|
2402
|
+
* color_data is not specified, this data is used to determine data cell background colors as well.
|
|
2403
|
+
*/
|
|
2404
|
+
sizeData?: ChartData;
|
|
2405
|
+
/** The text format for all labels on the chart. The link field is not supported. */
|
|
2406
|
+
textFormat?: TextFormat;
|
|
2407
|
+
}
|
|
2408
|
+
interface TrimWhitespaceRequest {
|
|
2409
|
+
/** The range whose cells to trim. */
|
|
2410
|
+
range?: GridRange;
|
|
2411
|
+
}
|
|
2412
|
+
interface TrimWhitespaceResponse {
|
|
2413
|
+
/** The number of cells that were trimmed of whitespace. */
|
|
2414
|
+
cellsChangedCount?: number;
|
|
2415
|
+
}
|
|
2416
|
+
interface UnmergeCellsRequest {
|
|
2417
|
+
/** The range within which all cells should be unmerged. If the range spans multiple merges, all will be unmerged. The range must not partially span any merge. */
|
|
2418
|
+
range?: GridRange;
|
|
2419
|
+
}
|
|
2420
|
+
interface UpdateBandingRequest {
|
|
2421
|
+
/** The banded range to update with the new properties. */
|
|
2422
|
+
bandedRange?: BandedRange;
|
|
2423
|
+
/**
|
|
2424
|
+
* The fields that should be updated. At least one field must be specified. The root `bandedRange` is implied and should not be specified. A single `"*"` can be used as short-hand for
|
|
2425
|
+
* listing every field.
|
|
2426
|
+
*/
|
|
2427
|
+
fields?: string;
|
|
2428
|
+
}
|
|
2429
|
+
interface UpdateBordersRequest {
|
|
2430
|
+
/** The border to put at the bottom of the range. */
|
|
2431
|
+
bottom?: Border;
|
|
2432
|
+
/** The horizontal border to put within the range. */
|
|
2433
|
+
innerHorizontal?: Border;
|
|
2434
|
+
/** The vertical border to put within the range. */
|
|
2435
|
+
innerVertical?: Border;
|
|
2436
|
+
/** The border to put at the left of the range. */
|
|
2437
|
+
left?: Border;
|
|
2438
|
+
/** The range whose borders should be updated. */
|
|
2439
|
+
range?: GridRange;
|
|
2440
|
+
/** The border to put at the right of the range. */
|
|
2441
|
+
right?: Border;
|
|
2442
|
+
/** The border to put at the top of the range. */
|
|
2443
|
+
top?: Border;
|
|
2444
|
+
}
|
|
2445
|
+
interface UpdateCellsRequest {
|
|
2446
|
+
/**
|
|
2447
|
+
* The fields of CellData that should be updated. At least one field must be specified. The root is the CellData; 'row.values.' should not be specified. A single `"*"` can be used as
|
|
2448
|
+
* short-hand for listing every field.
|
|
2449
|
+
*/
|
|
2450
|
+
fields?: string;
|
|
2451
|
+
/** The range to write data to. If the data in rows does not cover the entire requested range, the fields matching those set in fields will be cleared. */
|
|
2452
|
+
range?: GridRange;
|
|
2453
|
+
/** The data to write. */
|
|
2454
|
+
rows?: RowData[];
|
|
2455
|
+
/** The coordinate to start writing data at. Any number of rows and columns (including a different number of columns per row) may be written. */
|
|
2456
|
+
start?: GridCoordinate;
|
|
2457
|
+
}
|
|
2458
|
+
interface UpdateChartSpecRequest {
|
|
2459
|
+
/** The ID of the chart to update. */
|
|
2460
|
+
chartId?: number;
|
|
2461
|
+
/** The specification to apply to the chart. */
|
|
2462
|
+
spec?: ChartSpec;
|
|
2463
|
+
}
|
|
2464
|
+
interface UpdateConditionalFormatRuleRequest {
|
|
2465
|
+
/** The zero-based index of the rule that should be replaced or moved. */
|
|
2466
|
+
index?: number;
|
|
2467
|
+
/** The zero-based new index the rule should end up at. */
|
|
2468
|
+
newIndex?: number;
|
|
2469
|
+
/** The rule that should replace the rule at the given index. */
|
|
2470
|
+
rule?: ConditionalFormatRule;
|
|
2471
|
+
/** The sheet of the rule to move. Required if new_index is set, unused otherwise. */
|
|
2472
|
+
sheetId?: number;
|
|
2473
|
+
}
|
|
2474
|
+
interface UpdateConditionalFormatRuleResponse {
|
|
2475
|
+
/** The index of the new rule. */
|
|
2476
|
+
newIndex?: number;
|
|
2477
|
+
/** The new rule that replaced the old rule (if replacing), or the rule that was moved (if moved) */
|
|
2478
|
+
newRule?: ConditionalFormatRule;
|
|
2479
|
+
/** The old index of the rule. Not set if a rule was replaced (because it is the same as new_index). */
|
|
2480
|
+
oldIndex?: number;
|
|
2481
|
+
/** The old (deleted) rule. Not set if a rule was moved (because it is the same as new_rule). */
|
|
2482
|
+
oldRule?: ConditionalFormatRule;
|
|
2483
|
+
}
|
|
2484
|
+
interface UpdateDataSourceRequest {
|
|
2485
|
+
/** The data source to update. */
|
|
2486
|
+
dataSource?: DataSource;
|
|
2487
|
+
/**
|
|
2488
|
+
* The fields that should be updated. At least one field must be specified. The root `dataSource` is implied and should not be specified. A single `"*"` can be used as short-hand for
|
|
2489
|
+
* listing every field.
|
|
2490
|
+
*/
|
|
2491
|
+
fields?: string;
|
|
2492
|
+
}
|
|
2493
|
+
interface UpdateDataSourceResponse {
|
|
2494
|
+
/** The data execution status. */
|
|
2495
|
+
dataExecutionStatus?: DataExecutionStatus;
|
|
2496
|
+
/** The updated data source. */
|
|
2497
|
+
dataSource?: DataSource;
|
|
2498
|
+
}
|
|
2499
|
+
interface UpdateDeveloperMetadataRequest {
|
|
2500
|
+
/** The filters matching the developer metadata entries to update. */
|
|
2501
|
+
dataFilters?: DataFilter[];
|
|
2502
|
+
/** The value that all metadata matched by the data filters will be updated to. */
|
|
2503
|
+
developerMetadata?: DeveloperMetadata;
|
|
2504
|
+
/**
|
|
2505
|
+
* The fields that should be updated. At least one field must be specified. The root `developerMetadata` is implied and should not be specified. A single `"*"` can be used as
|
|
2506
|
+
* short-hand for listing every field.
|
|
2507
|
+
*/
|
|
2508
|
+
fields?: string;
|
|
2509
|
+
}
|
|
2510
|
+
interface UpdateDeveloperMetadataResponse {
|
|
2511
|
+
/** The updated developer metadata. */
|
|
2512
|
+
developerMetadata?: DeveloperMetadata[];
|
|
2513
|
+
}
|
|
2514
|
+
interface UpdateDimensionGroupRequest {
|
|
2515
|
+
/** The group whose state should be updated. The range and depth of the group should specify a valid group on the sheet, and all other fields updated. */
|
|
2516
|
+
dimensionGroup?: DimensionGroup;
|
|
2517
|
+
/**
|
|
2518
|
+
* The fields that should be updated. At least one field must be specified. The root `dimensionGroup` is implied and should not be specified. A single `"*"` can be used as short-hand
|
|
2519
|
+
* for listing every field.
|
|
2520
|
+
*/
|
|
2521
|
+
fields?: string;
|
|
2522
|
+
}
|
|
2523
|
+
interface UpdateDimensionPropertiesRequest {
|
|
2524
|
+
/** The columns on a data source sheet to update. */
|
|
2525
|
+
dataSourceSheetRange?: DataSourceSheetDimensionRange;
|
|
2526
|
+
/**
|
|
2527
|
+
* The fields that should be updated. At least one field must be specified. The root `properties` is implied and should not be specified. A single `"*"` can be used as short-hand for
|
|
2528
|
+
* listing every field.
|
|
2529
|
+
*/
|
|
2530
|
+
fields?: string;
|
|
2531
|
+
/** Properties to update. */
|
|
2532
|
+
properties?: DimensionProperties;
|
|
2533
|
+
/** The rows or columns to update. */
|
|
2534
|
+
range?: DimensionRange;
|
|
2535
|
+
}
|
|
2536
|
+
interface UpdateEmbeddedObjectBorderRequest {
|
|
2537
|
+
/** The border that applies to the embedded object. */
|
|
2538
|
+
border?: EmbeddedObjectBorder;
|
|
2539
|
+
/**
|
|
2540
|
+
* The fields that should be updated. At least one field must be specified. The root `border` is implied and should not be specified. A single `"*"` can be used as short-hand for
|
|
2541
|
+
* listing every field.
|
|
2542
|
+
*/
|
|
2543
|
+
fields?: string;
|
|
2544
|
+
/** The ID of the embedded object to update. */
|
|
2545
|
+
objectId?: number;
|
|
2546
|
+
}
|
|
2547
|
+
interface UpdateEmbeddedObjectPositionRequest {
|
|
2548
|
+
/**
|
|
2549
|
+
* The fields of OverlayPosition that should be updated when setting a new position. Used only if newPosition.overlayPosition is set, in which case at least one field must be
|
|
2550
|
+
* specified. The root `newPosition.overlayPosition` is implied and should not be specified. A single `"*"` can be used as short-hand for listing every field.
|
|
2551
|
+
*/
|
|
2552
|
+
fields?: string;
|
|
2553
|
+
/**
|
|
2554
|
+
* An explicit position to move the embedded object to. If newPosition.sheetId is set, a new sheet with that ID will be created. If newPosition.newSheet is set to true, a new sheet
|
|
2555
|
+
* will be created with an ID that will be chosen for you.
|
|
2556
|
+
*/
|
|
2557
|
+
newPosition?: EmbeddedObjectPosition;
|
|
2558
|
+
/** The ID of the object to moved. */
|
|
2559
|
+
objectId?: number;
|
|
2560
|
+
}
|
|
2561
|
+
interface UpdateEmbeddedObjectPositionResponse {
|
|
2562
|
+
/** The new position of the embedded object. */
|
|
2563
|
+
position?: EmbeddedObjectPosition;
|
|
2564
|
+
}
|
|
2565
|
+
interface UpdateFilterViewRequest {
|
|
2566
|
+
/**
|
|
2567
|
+
* The fields that should be updated. At least one field must be specified. The root `filter` is implied and should not be specified. A single `"*"` can be used as short-hand for
|
|
2568
|
+
* listing every field.
|
|
2569
|
+
*/
|
|
2570
|
+
fields?: string;
|
|
2571
|
+
/** The new properties of the filter view. */
|
|
2572
|
+
filter?: FilterView;
|
|
2573
|
+
}
|
|
2574
|
+
interface UpdateNamedRangeRequest {
|
|
2575
|
+
/**
|
|
2576
|
+
* The fields that should be updated. At least one field must be specified. The root `namedRange` is implied and should not be specified. A single `"*"` can be used as short-hand for
|
|
2577
|
+
* listing every field.
|
|
2578
|
+
*/
|
|
2579
|
+
fields?: string;
|
|
2580
|
+
/** The named range to update with the new properties. */
|
|
2581
|
+
namedRange?: NamedRange;
|
|
2582
|
+
}
|
|
2583
|
+
interface UpdateProtectedRangeRequest {
|
|
2584
|
+
/**
|
|
2585
|
+
* The fields that should be updated. At least one field must be specified. The root `protectedRange` is implied and should not be specified. A single `"*"` can be used as short-hand
|
|
2586
|
+
* for listing every field.
|
|
2587
|
+
*/
|
|
2588
|
+
fields?: string;
|
|
2589
|
+
/** The protected range to update with the new properties. */
|
|
2590
|
+
protectedRange?: ProtectedRange;
|
|
2591
|
+
}
|
|
2592
|
+
interface UpdateSheetPropertiesRequest {
|
|
2593
|
+
/**
|
|
2594
|
+
* The fields that should be updated. At least one field must be specified. The root `properties` is implied and should not be specified. A single `"*"` can be used as short-hand for
|
|
2595
|
+
* listing every field.
|
|
2596
|
+
*/
|
|
2597
|
+
fields?: string;
|
|
2598
|
+
/** The properties to update. */
|
|
2599
|
+
properties?: SheetProperties;
|
|
2600
|
+
}
|
|
2601
|
+
interface UpdateSlicerSpecRequest {
|
|
2602
|
+
/**
|
|
2603
|
+
* The fields that should be updated. At least one field must be specified. The root `SlicerSpec` is implied and should not be specified. A single "*"` can be used as short-hand for
|
|
2604
|
+
* listing every field.
|
|
2605
|
+
*/
|
|
2606
|
+
fields?: string;
|
|
2607
|
+
/** The id of the slicer to update. */
|
|
2608
|
+
slicerId?: number;
|
|
2609
|
+
/** The specification to apply to the slicer. */
|
|
2610
|
+
spec?: SlicerSpec;
|
|
2611
|
+
}
|
|
2612
|
+
interface UpdateSpreadsheetPropertiesRequest {
|
|
2613
|
+
/**
|
|
2614
|
+
* The fields that should be updated. At least one field must be specified. The root 'properties' is implied and should not be specified. A single `"*"` can be used as short-hand for
|
|
2615
|
+
* listing every field.
|
|
2616
|
+
*/
|
|
2617
|
+
fields?: string;
|
|
2618
|
+
/** The properties to update. */
|
|
2619
|
+
properties?: SpreadsheetProperties;
|
|
2620
|
+
}
|
|
2621
|
+
interface UpdateValuesByDataFilterResponse {
|
|
2622
|
+
/** The data filter that selected the range that was updated. */
|
|
2623
|
+
dataFilter?: DataFilter;
|
|
2624
|
+
/** The number of cells updated. */
|
|
2625
|
+
updatedCells?: number;
|
|
2626
|
+
/** The number of columns where at least one cell in the column was updated. */
|
|
2627
|
+
updatedColumns?: number;
|
|
2628
|
+
/** 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`. */
|
|
2629
|
+
updatedData?: ValueRange;
|
|
2630
|
+
/** The range (in [A1 notation](/sheets/api/guides/concepts#cell)) that updates were applied to. */
|
|
2631
|
+
updatedRange?: string;
|
|
2632
|
+
/** The number of rows where at least one cell in the row was updated. */
|
|
2633
|
+
updatedRows?: number;
|
|
2634
|
+
}
|
|
2635
|
+
interface UpdateValuesResponse {
|
|
2636
|
+
/** The spreadsheet the updates were applied to. */
|
|
2637
|
+
spreadsheetId?: string;
|
|
2638
|
+
/** The number of cells updated. */
|
|
2639
|
+
updatedCells?: number;
|
|
2640
|
+
/** The number of columns where at least one cell in the column was updated. */
|
|
2641
|
+
updatedColumns?: number;
|
|
2642
|
+
/** The values of the cells after updates were applied. This is only included if the request's `includeValuesInResponse` field was `true`. */
|
|
2643
|
+
updatedData?: ValueRange;
|
|
2644
|
+
/** The range (in A1 notation) that updates were applied to. */
|
|
2645
|
+
updatedRange?: string;
|
|
2646
|
+
/** The number of rows where at least one cell in the row was updated. */
|
|
2647
|
+
updatedRows?: number;
|
|
2648
|
+
}
|
|
2649
|
+
interface ValueRange {
|
|
2650
|
+
/**
|
|
2651
|
+
* 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]]`,
|
|
2652
|
+
* 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
|
|
2653
|
+
* `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.
|
|
2654
|
+
*/
|
|
2655
|
+
majorDimension?: string;
|
|
2656
|
+
/**
|
|
2657
|
+
* 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
|
|
2658
|
+
* trailing rows and columns. When appending values, this field represents the range to search for a table, after which values will be appended.
|
|
2659
|
+
*/
|
|
2660
|
+
range?: string;
|
|
2661
|
+
/**
|
|
2662
|
+
* 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
|
|
2663
|
+
* 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
|
|
2664
|
+
* will be skipped. To set a cell to an empty value, set the string value to an empty string.
|
|
2665
|
+
*/
|
|
2666
|
+
values?: any[][];
|
|
2667
|
+
}
|
|
2668
|
+
interface WaterfallChartColumnStyle {
|
|
2669
|
+
/** The color of the column. Deprecated: Use color_style. */
|
|
2670
|
+
color?: Color;
|
|
2671
|
+
/** The color of the column. If color is also set, this field takes precedence. */
|
|
2672
|
+
colorStyle?: ColorStyle;
|
|
2673
|
+
/** The label of the column's legend. */
|
|
2674
|
+
label?: string;
|
|
2675
|
+
}
|
|
2676
|
+
interface WaterfallChartCustomSubtotal {
|
|
2677
|
+
/** True if the data point at subtotal_index is the subtotal. If false, the subtotal will be computed and appear after the data point. */
|
|
2678
|
+
dataIsSubtotal?: boolean;
|
|
2679
|
+
/** A label for the subtotal column. */
|
|
2680
|
+
label?: string;
|
|
2681
|
+
/**
|
|
2682
|
+
* The 0-based index of a data point within the series. If data_is_subtotal is true, the data point at this index is the subtotal. Otherwise, the subtotal appears after the data point
|
|
2683
|
+
* with this index. A series can have multiple subtotals at arbitrary indices, but subtotals do not affect the indices of the data points. For example, if a series has three data
|
|
2684
|
+
* points, their indices will always be 0, 1, and 2, regardless of how many subtotals exist on the series or what data points they are associated with.
|
|
2685
|
+
*/
|
|
2686
|
+
subtotalIndex?: number;
|
|
2687
|
+
}
|
|
2688
|
+
interface WaterfallChartDomain {
|
|
2689
|
+
/** The data of the WaterfallChartDomain. */
|
|
2690
|
+
data?: ChartData;
|
|
2691
|
+
/** True to reverse the order of the domain values (horizontal axis). */
|
|
2692
|
+
reversed?: boolean;
|
|
2693
|
+
}
|
|
2694
|
+
interface WaterfallChartSeries {
|
|
2695
|
+
/** Custom subtotal columns appearing in this series. The order in which subtotals are defined is not significant. Only one subtotal may be defined for each data point. */
|
|
2696
|
+
customSubtotals?: WaterfallChartCustomSubtotal[];
|
|
2697
|
+
/** The data being visualized in this series. */
|
|
2698
|
+
data?: ChartData;
|
|
2699
|
+
/** Information about the data labels for this series. */
|
|
2700
|
+
dataLabel?: DataLabel;
|
|
2701
|
+
/**
|
|
2702
|
+
* True to hide the subtotal column from the end of the series. By default, a subtotal column will appear at the end of each series. Setting this field to true will hide that subtotal
|
|
2703
|
+
* column for this series.
|
|
2704
|
+
*/
|
|
2705
|
+
hideTrailingSubtotal?: boolean;
|
|
2706
|
+
/** Styles for all columns in this series with negative values. */
|
|
2707
|
+
negativeColumnsStyle?: WaterfallChartColumnStyle;
|
|
2708
|
+
/** Styles for all columns in this series with positive values. */
|
|
2709
|
+
positiveColumnsStyle?: WaterfallChartColumnStyle;
|
|
2710
|
+
/** Styles for all subtotal columns in this series. */
|
|
2711
|
+
subtotalColumnsStyle?: WaterfallChartColumnStyle;
|
|
2712
|
+
}
|
|
2713
|
+
interface WaterfallChartSpec {
|
|
2714
|
+
/** The line style for the connector lines. */
|
|
2715
|
+
connectorLineStyle?: LineStyle;
|
|
2716
|
+
/** The domain data (horizontal axis) for the waterfall chart. */
|
|
2717
|
+
domain?: WaterfallChartDomain;
|
|
2718
|
+
/** True to interpret the first value as a total. */
|
|
2719
|
+
firstValueIsTotal?: boolean;
|
|
2720
|
+
/** True to hide connector lines between columns. */
|
|
2721
|
+
hideConnectorLines?: boolean;
|
|
2722
|
+
/** The data this waterfall chart is visualizing. */
|
|
2723
|
+
series?: WaterfallChartSeries[];
|
|
2724
|
+
/** The stacked type. */
|
|
2725
|
+
stackedType?: string;
|
|
2726
|
+
/**
|
|
2727
|
+
* Controls whether to display additional data labels on stacked charts which sum the total value of all stacked values at each value along the domain axis. stacked_type must be
|
|
2728
|
+
* STACKED and neither CUSTOM nor placement can be set on the total_data_label.
|
|
2729
|
+
*/
|
|
2730
|
+
totalDataLabel?: DataLabel;
|
|
2731
|
+
}
|
|
2732
|
+
interface DeveloperMetadataResource {
|
|
2733
|
+
/** Returns the developer metadata with the specified ID. The caller must specify the spreadsheet ID and the developer metadata's unique metadataId. */
|
|
2734
|
+
get(request?: {
|
|
2735
|
+
/** V1 error format. */
|
|
2736
|
+
"$.xgafv"?: string;
|
|
2737
|
+
/** OAuth access token. */
|
|
2738
|
+
access_token?: string;
|
|
2739
|
+
/** Data format for response. */
|
|
2740
|
+
alt?: string;
|
|
2741
|
+
/** JSONP */
|
|
2742
|
+
callback?: string;
|
|
2743
|
+
/** Selector specifying which fields to include in a partial response. */
|
|
2744
|
+
fields?: string;
|
|
2745
|
+
/** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
|
|
2746
|
+
key?: string;
|
|
2747
|
+
/** The ID of the developer metadata to retrieve. */
|
|
2748
|
+
metadataId: number;
|
|
2749
|
+
/** OAuth 2.0 token for the current user. */
|
|
2750
|
+
oauth_token?: string;
|
|
2751
|
+
/** Returns response with indentations and line breaks. */
|
|
2752
|
+
prettyPrint?: boolean;
|
|
2753
|
+
/** 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. */
|
|
2754
|
+
quotaUser?: string;
|
|
2755
|
+
/** The ID of the spreadsheet to retrieve metadata from. */
|
|
2756
|
+
spreadsheetId: string;
|
|
2757
|
+
/** Upload protocol for media (e.g. "raw", "multipart"). */
|
|
2758
|
+
upload_protocol?: string;
|
|
2759
|
+
/** Legacy upload protocol for media (e.g. "media", "multipart"). */
|
|
2760
|
+
uploadType?: string;
|
|
2761
|
+
}): client.Request<DeveloperMetadata>;
|
|
2762
|
+
/**
|
|
2763
|
+
* Returns all developer metadata matching the specified DataFilter. If the provided DataFilter represents a DeveloperMetadataLookup object, this will return all DeveloperMetadata
|
|
2764
|
+
* 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.
|
|
2765
|
+
*/
|
|
2766
|
+
search(request: {
|
|
2767
|
+
/** V1 error format. */
|
|
2768
|
+
"$.xgafv"?: string;
|
|
2769
|
+
/** OAuth access token. */
|
|
2770
|
+
access_token?: string;
|
|
2771
|
+
/** Data format for response. */
|
|
2772
|
+
alt?: string;
|
|
2773
|
+
/** JSONP */
|
|
2774
|
+
callback?: string;
|
|
2775
|
+
/** Selector specifying which fields to include in a partial response. */
|
|
2776
|
+
fields?: string;
|
|
2777
|
+
/** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
|
|
2778
|
+
key?: string;
|
|
2779
|
+
/** OAuth 2.0 token for the current user. */
|
|
2780
|
+
oauth_token?: string;
|
|
2781
|
+
/** Returns response with indentations and line breaks. */
|
|
2782
|
+
prettyPrint?: boolean;
|
|
2783
|
+
/** 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. */
|
|
2784
|
+
quotaUser?: string;
|
|
2785
|
+
/** The ID of the spreadsheet to retrieve metadata from. */
|
|
2786
|
+
spreadsheetId: string;
|
|
2787
|
+
/** Upload protocol for media (e.g. "raw", "multipart"). */
|
|
2788
|
+
upload_protocol?: string;
|
|
2789
|
+
/** Legacy upload protocol for media (e.g. "media", "multipart"). */
|
|
2790
|
+
uploadType?: string;
|
|
2791
|
+
/** Request body */
|
|
2792
|
+
resource: SearchDeveloperMetadataRequest;
|
|
2793
|
+
}): client.Request<SearchDeveloperMetadataResponse>;
|
|
2794
|
+
search(request: {
|
|
2795
|
+
/** V1 error format. */
|
|
2796
|
+
"$.xgafv"?: string;
|
|
2797
|
+
/** OAuth access token. */
|
|
2798
|
+
access_token?: string;
|
|
2799
|
+
/** Data format for response. */
|
|
2800
|
+
alt?: string;
|
|
2801
|
+
/** JSONP */
|
|
2802
|
+
callback?: string;
|
|
2803
|
+
/** Selector specifying which fields to include in a partial response. */
|
|
2804
|
+
fields?: string;
|
|
2805
|
+
/** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
|
|
2806
|
+
key?: string;
|
|
2807
|
+
/** OAuth 2.0 token for the current user. */
|
|
2808
|
+
oauth_token?: string;
|
|
2809
|
+
/** Returns response with indentations and line breaks. */
|
|
2810
|
+
prettyPrint?: boolean;
|
|
2811
|
+
/** 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. */
|
|
2812
|
+
quotaUser?: string;
|
|
2813
|
+
/** The ID of the spreadsheet to retrieve metadata from. */
|
|
2814
|
+
spreadsheetId: string;
|
|
2815
|
+
/** Upload protocol for media (e.g. "raw", "multipart"). */
|
|
2816
|
+
upload_protocol?: string;
|
|
2817
|
+
/** Legacy upload protocol for media (e.g. "media", "multipart"). */
|
|
2818
|
+
uploadType?: string;
|
|
2819
|
+
},
|
|
2820
|
+
body: SearchDeveloperMetadataRequest): client.Request<SearchDeveloperMetadataResponse>;
|
|
2821
|
+
}
|
|
2822
|
+
interface SheetsResource {
|
|
2823
|
+
/** Copies a single sheet from a spreadsheet to another spreadsheet. Returns the properties of the newly created sheet. */
|
|
2824
|
+
copyTo(request: {
|
|
2825
|
+
/** V1 error format. */
|
|
2826
|
+
"$.xgafv"?: string;
|
|
2827
|
+
/** OAuth access token. */
|
|
2828
|
+
access_token?: string;
|
|
2829
|
+
/** Data format for response. */
|
|
2830
|
+
alt?: string;
|
|
2831
|
+
/** JSONP */
|
|
2832
|
+
callback?: string;
|
|
2833
|
+
/** Selector specifying which fields to include in a partial response. */
|
|
2834
|
+
fields?: string;
|
|
2835
|
+
/** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
|
|
2836
|
+
key?: string;
|
|
2837
|
+
/** OAuth 2.0 token for the current user. */
|
|
2838
|
+
oauth_token?: string;
|
|
2839
|
+
/** Returns response with indentations and line breaks. */
|
|
2840
|
+
prettyPrint?: boolean;
|
|
2841
|
+
/** 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. */
|
|
2842
|
+
quotaUser?: string;
|
|
2843
|
+
/** The ID of the sheet to copy. */
|
|
2844
|
+
sheetId: number;
|
|
2845
|
+
/** The ID of the spreadsheet containing the sheet to copy. */
|
|
2846
|
+
spreadsheetId: string;
|
|
2847
|
+
/** Upload protocol for media (e.g. "raw", "multipart"). */
|
|
2848
|
+
upload_protocol?: string;
|
|
2849
|
+
/** Legacy upload protocol for media (e.g. "media", "multipart"). */
|
|
2850
|
+
uploadType?: string;
|
|
2851
|
+
/** Request body */
|
|
2852
|
+
resource: CopySheetToAnotherSpreadsheetRequest;
|
|
2853
|
+
}): client.Request<SheetProperties>;
|
|
2854
|
+
copyTo(request: {
|
|
2855
|
+
/** V1 error format. */
|
|
2856
|
+
"$.xgafv"?: string;
|
|
2857
|
+
/** OAuth access token. */
|
|
2858
|
+
access_token?: string;
|
|
2859
|
+
/** Data format for response. */
|
|
2860
|
+
alt?: string;
|
|
2861
|
+
/** JSONP */
|
|
2862
|
+
callback?: string;
|
|
2863
|
+
/** Selector specifying which fields to include in a partial response. */
|
|
2864
|
+
fields?: string;
|
|
2865
|
+
/** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
|
|
2866
|
+
key?: string;
|
|
2867
|
+
/** OAuth 2.0 token for the current user. */
|
|
2868
|
+
oauth_token?: string;
|
|
2869
|
+
/** Returns response with indentations and line breaks. */
|
|
2870
|
+
prettyPrint?: boolean;
|
|
2871
|
+
/** 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. */
|
|
2872
|
+
quotaUser?: string;
|
|
2873
|
+
/** The ID of the sheet to copy. */
|
|
2874
|
+
sheetId: number;
|
|
2875
|
+
/** The ID of the spreadsheet containing the sheet to copy. */
|
|
2876
|
+
spreadsheetId: string;
|
|
2877
|
+
/** Upload protocol for media (e.g. "raw", "multipart"). */
|
|
2878
|
+
upload_protocol?: string;
|
|
2879
|
+
/** Legacy upload protocol for media (e.g. "media", "multipart"). */
|
|
2880
|
+
uploadType?: string;
|
|
2881
|
+
},
|
|
2882
|
+
body: CopySheetToAnotherSpreadsheetRequest): client.Request<SheetProperties>;
|
|
2883
|
+
}
|
|
2884
|
+
interface ValuesResource {
|
|
2885
|
+
/**
|
|
2886
|
+
* 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,
|
|
2887
|
+
* 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
|
|
2888
|
+
* 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
|
|
2889
|
+
* 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.
|
|
2890
|
+
*/
|
|
2891
|
+
append(request: {
|
|
2892
|
+
/** V1 error format. */
|
|
2893
|
+
"$.xgafv"?: string;
|
|
2894
|
+
/** OAuth access token. */
|
|
2895
|
+
access_token?: string;
|
|
2896
|
+
/** Data format for response. */
|
|
2897
|
+
alt?: string;
|
|
2898
|
+
/** JSONP */
|
|
2899
|
+
callback?: string;
|
|
2900
|
+
/** Selector specifying which fields to include in a partial response. */
|
|
2901
|
+
fields?: string;
|
|
2902
|
+
/** Determines if the update response should include the values of the cells that were appended. By default, responses do not include the updated values. */
|
|
2903
|
+
includeValuesInResponse?: boolean;
|
|
2904
|
+
/** How the input data should be inserted. */
|
|
2905
|
+
insertDataOption?: string;
|
|
2906
|
+
/** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
|
|
2907
|
+
key?: string;
|
|
2908
|
+
/** OAuth 2.0 token for the current user. */
|
|
2909
|
+
oauth_token?: string;
|
|
2910
|
+
/** Returns response with indentations and line breaks. */
|
|
2911
|
+
prettyPrint?: boolean;
|
|
2912
|
+
/** 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. */
|
|
2913
|
+
quotaUser?: string;
|
|
2914
|
+
/** 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. */
|
|
2915
|
+
range: string;
|
|
2916
|
+
/**
|
|
2917
|
+
* 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
|
|
2918
|
+
* option is SERIAL_NUMBER.
|
|
2919
|
+
*/
|
|
2920
|
+
responseDateTimeRenderOption?: string;
|
|
2921
|
+
/** Determines how values in the response should be rendered. The default render option is FORMATTED_VALUE. */
|
|
2922
|
+
responseValueRenderOption?: string;
|
|
2923
|
+
/** The ID of the spreadsheet to update. */
|
|
2924
|
+
spreadsheetId: string;
|
|
2925
|
+
/** Upload protocol for media (e.g. "raw", "multipart"). */
|
|
2926
|
+
upload_protocol?: string;
|
|
2927
|
+
/** Legacy upload protocol for media (e.g. "media", "multipart"). */
|
|
2928
|
+
uploadType?: string;
|
|
2929
|
+
/** How the input data should be interpreted. */
|
|
2930
|
+
valueInputOption?: string;
|
|
2931
|
+
/** Request body */
|
|
2932
|
+
resource: ValueRange;
|
|
2933
|
+
}): client.Request<AppendValuesResponse>;
|
|
2934
|
+
append(request: {
|
|
2935
|
+
/** V1 error format. */
|
|
2936
|
+
"$.xgafv"?: string;
|
|
2937
|
+
/** OAuth access token. */
|
|
2938
|
+
access_token?: string;
|
|
2939
|
+
/** Data format for response. */
|
|
2940
|
+
alt?: string;
|
|
2941
|
+
/** JSONP */
|
|
2942
|
+
callback?: string;
|
|
2943
|
+
/** Selector specifying which fields to include in a partial response. */
|
|
2944
|
+
fields?: string;
|
|
2945
|
+
/** Determines if the update response should include the values of the cells that were appended. By default, responses do not include the updated values. */
|
|
2946
|
+
includeValuesInResponse?: boolean;
|
|
2947
|
+
/** How the input data should be inserted. */
|
|
2948
|
+
insertDataOption?: string;
|
|
2949
|
+
/** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
|
|
2950
|
+
key?: string;
|
|
2951
|
+
/** OAuth 2.0 token for the current user. */
|
|
2952
|
+
oauth_token?: string;
|
|
2953
|
+
/** Returns response with indentations and line breaks. */
|
|
2954
|
+
prettyPrint?: boolean;
|
|
2955
|
+
/** 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. */
|
|
2956
|
+
quotaUser?: string;
|
|
2957
|
+
/** 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. */
|
|
2958
|
+
range: string;
|
|
2959
|
+
/**
|
|
2960
|
+
* 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
|
|
2961
|
+
* option is SERIAL_NUMBER.
|
|
2962
|
+
*/
|
|
2963
|
+
responseDateTimeRenderOption?: string;
|
|
2964
|
+
/** Determines how values in the response should be rendered. The default render option is FORMATTED_VALUE. */
|
|
2965
|
+
responseValueRenderOption?: string;
|
|
2966
|
+
/** The ID of the spreadsheet to update. */
|
|
2967
|
+
spreadsheetId: string;
|
|
2968
|
+
/** Upload protocol for media (e.g. "raw", "multipart"). */
|
|
2969
|
+
upload_protocol?: string;
|
|
2970
|
+
/** Legacy upload protocol for media (e.g. "media", "multipart"). */
|
|
2971
|
+
uploadType?: string;
|
|
2972
|
+
/** How the input data should be interpreted. */
|
|
2973
|
+
valueInputOption?: string;
|
|
2974
|
+
},
|
|
2975
|
+
body: ValueRange): client.Request<AppendValuesResponse>;
|
|
2976
|
+
/**
|
|
2977
|
+
* 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
|
|
2978
|
+
* cell (such as formatting and data validation) are kept.
|
|
2979
|
+
*/
|
|
2980
|
+
batchClear(request: {
|
|
2981
|
+
/** V1 error format. */
|
|
2982
|
+
"$.xgafv"?: string;
|
|
2983
|
+
/** OAuth access token. */
|
|
2984
|
+
access_token?: string;
|
|
2985
|
+
/** Data format for response. */
|
|
2986
|
+
alt?: string;
|
|
2987
|
+
/** JSONP */
|
|
2988
|
+
callback?: string;
|
|
2989
|
+
/** Selector specifying which fields to include in a partial response. */
|
|
2990
|
+
fields?: string;
|
|
2991
|
+
/** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
|
|
2992
|
+
key?: string;
|
|
2993
|
+
/** OAuth 2.0 token for the current user. */
|
|
2994
|
+
oauth_token?: string;
|
|
2995
|
+
/** Returns response with indentations and line breaks. */
|
|
2996
|
+
prettyPrint?: boolean;
|
|
2997
|
+
/** 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. */
|
|
2998
|
+
quotaUser?: string;
|
|
2999
|
+
/** The ID of the spreadsheet to update. */
|
|
3000
|
+
spreadsheetId: string;
|
|
3001
|
+
/** Upload protocol for media (e.g. "raw", "multipart"). */
|
|
3002
|
+
upload_protocol?: string;
|
|
3003
|
+
/** Legacy upload protocol for media (e.g. "media", "multipart"). */
|
|
3004
|
+
uploadType?: string;
|
|
3005
|
+
/** Request body */
|
|
3006
|
+
resource: BatchClearValuesRequest;
|
|
3007
|
+
}): client.Request<BatchClearValuesResponse>;
|
|
3008
|
+
batchClear(request: {
|
|
3009
|
+
/** V1 error format. */
|
|
3010
|
+
"$.xgafv"?: string;
|
|
3011
|
+
/** OAuth access token. */
|
|
3012
|
+
access_token?: string;
|
|
3013
|
+
/** Data format for response. */
|
|
3014
|
+
alt?: string;
|
|
3015
|
+
/** JSONP */
|
|
3016
|
+
callback?: string;
|
|
3017
|
+
/** Selector specifying which fields to include in a partial response. */
|
|
3018
|
+
fields?: string;
|
|
3019
|
+
/** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
|
|
3020
|
+
key?: string;
|
|
3021
|
+
/** OAuth 2.0 token for the current user. */
|
|
3022
|
+
oauth_token?: string;
|
|
3023
|
+
/** Returns response with indentations and line breaks. */
|
|
3024
|
+
prettyPrint?: boolean;
|
|
3025
|
+
/** 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. */
|
|
3026
|
+
quotaUser?: string;
|
|
3027
|
+
/** The ID of the spreadsheet to update. */
|
|
3028
|
+
spreadsheetId: string;
|
|
3029
|
+
/** Upload protocol for media (e.g. "raw", "multipart"). */
|
|
3030
|
+
upload_protocol?: string;
|
|
3031
|
+
/** Legacy upload protocol for media (e.g. "media", "multipart"). */
|
|
3032
|
+
uploadType?: string;
|
|
3033
|
+
},
|
|
3034
|
+
body: BatchClearValuesRequest): client.Request<BatchClearValuesResponse>;
|
|
3035
|
+
/**
|
|
3036
|
+
* 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
|
|
3037
|
+
* will be cleared. Only values are cleared -- all other properties of the cell (such as formatting, data validation, etc..) are kept.
|
|
3038
|
+
*/
|
|
3039
|
+
batchClearByDataFilter(request: {
|
|
3040
|
+
/** V1 error format. */
|
|
3041
|
+
"$.xgafv"?: string;
|
|
3042
|
+
/** OAuth access token. */
|
|
3043
|
+
access_token?: string;
|
|
3044
|
+
/** Data format for response. */
|
|
3045
|
+
alt?: string;
|
|
3046
|
+
/** JSONP */
|
|
3047
|
+
callback?: string;
|
|
3048
|
+
/** Selector specifying which fields to include in a partial response. */
|
|
3049
|
+
fields?: string;
|
|
3050
|
+
/** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
|
|
3051
|
+
key?: string;
|
|
3052
|
+
/** OAuth 2.0 token for the current user. */
|
|
3053
|
+
oauth_token?: string;
|
|
3054
|
+
/** Returns response with indentations and line breaks. */
|
|
3055
|
+
prettyPrint?: boolean;
|
|
3056
|
+
/** 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. */
|
|
3057
|
+
quotaUser?: string;
|
|
3058
|
+
/** The ID of the spreadsheet to update. */
|
|
3059
|
+
spreadsheetId: string;
|
|
3060
|
+
/** Upload protocol for media (e.g. "raw", "multipart"). */
|
|
3061
|
+
upload_protocol?: string;
|
|
3062
|
+
/** Legacy upload protocol for media (e.g. "media", "multipart"). */
|
|
3063
|
+
uploadType?: string;
|
|
3064
|
+
/** Request body */
|
|
3065
|
+
resource: BatchClearValuesByDataFilterRequest;
|
|
3066
|
+
}): client.Request<BatchClearValuesByDataFilterResponse>;
|
|
3067
|
+
batchClearByDataFilter(request: {
|
|
3068
|
+
/** V1 error format. */
|
|
3069
|
+
"$.xgafv"?: string;
|
|
3070
|
+
/** OAuth access token. */
|
|
3071
|
+
access_token?: string;
|
|
3072
|
+
/** Data format for response. */
|
|
3073
|
+
alt?: string;
|
|
3074
|
+
/** JSONP */
|
|
3075
|
+
callback?: string;
|
|
3076
|
+
/** Selector specifying which fields to include in a partial response. */
|
|
3077
|
+
fields?: string;
|
|
3078
|
+
/** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
|
|
3079
|
+
key?: string;
|
|
3080
|
+
/** OAuth 2.0 token for the current user. */
|
|
3081
|
+
oauth_token?: string;
|
|
3082
|
+
/** Returns response with indentations and line breaks. */
|
|
3083
|
+
prettyPrint?: boolean;
|
|
3084
|
+
/** 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. */
|
|
3085
|
+
quotaUser?: string;
|
|
3086
|
+
/** The ID of the spreadsheet to update. */
|
|
3087
|
+
spreadsheetId: string;
|
|
3088
|
+
/** Upload protocol for media (e.g. "raw", "multipart"). */
|
|
3089
|
+
upload_protocol?: string;
|
|
3090
|
+
/** Legacy upload protocol for media (e.g. "media", "multipart"). */
|
|
3091
|
+
uploadType?: string;
|
|
3092
|
+
},
|
|
3093
|
+
body: BatchClearValuesByDataFilterRequest): client.Request<BatchClearValuesByDataFilterResponse>;
|
|
3094
|
+
/** Returns one or more ranges of values from a spreadsheet. The caller must specify the spreadsheet ID and one or more ranges. */
|
|
3095
|
+
batchGet(request?: {
|
|
3096
|
+
/** V1 error format. */
|
|
3097
|
+
"$.xgafv"?: string;
|
|
3098
|
+
/** OAuth access token. */
|
|
3099
|
+
access_token?: string;
|
|
3100
|
+
/** Data format for response. */
|
|
3101
|
+
alt?: string;
|
|
3102
|
+
/** JSONP */
|
|
3103
|
+
callback?: string;
|
|
3104
|
+
/**
|
|
3105
|
+
* 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
|
|
3106
|
+
* SERIAL_NUMBER.
|
|
3107
|
+
*/
|
|
3108
|
+
dateTimeRenderOption?: string;
|
|
3109
|
+
/** Selector specifying which fields to include in a partial response. */
|
|
3110
|
+
fields?: string;
|
|
3111
|
+
/** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
|
|
3112
|
+
key?: string;
|
|
3113
|
+
/**
|
|
3114
|
+
* 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
|
|
3115
|
+
* `[[1,2],[3,4]]`, whereas requesting `ranges=["A1:B2"],majorDimension=COLUMNS` returns `[[1,3],[2,4]]`.
|
|
3116
|
+
*/
|
|
3117
|
+
majorDimension?: string;
|
|
3118
|
+
/** OAuth 2.0 token for the current user. */
|
|
3119
|
+
oauth_token?: string;
|
|
3120
|
+
/** Returns response with indentations and line breaks. */
|
|
3121
|
+
prettyPrint?: boolean;
|
|
3122
|
+
/** 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. */
|
|
3123
|
+
quotaUser?: string;
|
|
3124
|
+
/** The [A1 notation or R1C1 notation](/sheets/api/guides/concepts#cell) of the range to retrieve values from. */
|
|
3125
|
+
ranges?: string | string[];
|
|
3126
|
+
/** The ID of the spreadsheet to retrieve data from. */
|
|
3127
|
+
spreadsheetId: string;
|
|
3128
|
+
/** Upload protocol for media (e.g. "raw", "multipart"). */
|
|
3129
|
+
upload_protocol?: string;
|
|
3130
|
+
/** Legacy upload protocol for media (e.g. "media", "multipart"). */
|
|
3131
|
+
uploadType?: string;
|
|
3132
|
+
/** How values should be represented in the output. The default render option is ValueRenderOption.FORMATTED_VALUE. */
|
|
3133
|
+
valueRenderOption?: string;
|
|
3134
|
+
}): client.Request<BatchGetValuesResponse>;
|
|
3135
|
+
/**
|
|
3136
|
+
* 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
|
|
3137
|
+
* filters in the request will be returned.
|
|
3138
|
+
*/
|
|
3139
|
+
batchGetByDataFilter(request: {
|
|
3140
|
+
/** V1 error format. */
|
|
3141
|
+
"$.xgafv"?: string;
|
|
3142
|
+
/** OAuth access token. */
|
|
3143
|
+
access_token?: string;
|
|
3144
|
+
/** Data format for response. */
|
|
3145
|
+
alt?: string;
|
|
3146
|
+
/** JSONP */
|
|
3147
|
+
callback?: string;
|
|
3148
|
+
/** Selector specifying which fields to include in a partial response. */
|
|
3149
|
+
fields?: string;
|
|
3150
|
+
/** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
|
|
3151
|
+
key?: string;
|
|
3152
|
+
/** OAuth 2.0 token for the current user. */
|
|
3153
|
+
oauth_token?: string;
|
|
3154
|
+
/** Returns response with indentations and line breaks. */
|
|
3155
|
+
prettyPrint?: boolean;
|
|
3156
|
+
/** 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. */
|
|
3157
|
+
quotaUser?: string;
|
|
3158
|
+
/** The ID of the spreadsheet to retrieve data from. */
|
|
3159
|
+
spreadsheetId: string;
|
|
3160
|
+
/** Upload protocol for media (e.g. "raw", "multipart"). */
|
|
3161
|
+
upload_protocol?: string;
|
|
3162
|
+
/** Legacy upload protocol for media (e.g. "media", "multipart"). */
|
|
3163
|
+
uploadType?: string;
|
|
3164
|
+
/** Request body */
|
|
3165
|
+
resource: BatchGetValuesByDataFilterRequest;
|
|
3166
|
+
}): client.Request<BatchGetValuesByDataFilterResponse>;
|
|
3167
|
+
batchGetByDataFilter(request: {
|
|
3168
|
+
/** V1 error format. */
|
|
3169
|
+
"$.xgafv"?: string;
|
|
3170
|
+
/** OAuth access token. */
|
|
3171
|
+
access_token?: string;
|
|
3172
|
+
/** Data format for response. */
|
|
3173
|
+
alt?: string;
|
|
3174
|
+
/** JSONP */
|
|
3175
|
+
callback?: string;
|
|
3176
|
+
/** Selector specifying which fields to include in a partial response. */
|
|
3177
|
+
fields?: string;
|
|
3178
|
+
/** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
|
|
3179
|
+
key?: string;
|
|
3180
|
+
/** OAuth 2.0 token for the current user. */
|
|
3181
|
+
oauth_token?: string;
|
|
3182
|
+
/** Returns response with indentations and line breaks. */
|
|
3183
|
+
prettyPrint?: boolean;
|
|
3184
|
+
/** 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. */
|
|
3185
|
+
quotaUser?: string;
|
|
3186
|
+
/** The ID of the spreadsheet to retrieve data from. */
|
|
3187
|
+
spreadsheetId: string;
|
|
3188
|
+
/** Upload protocol for media (e.g. "raw", "multipart"). */
|
|
3189
|
+
upload_protocol?: string;
|
|
3190
|
+
/** Legacy upload protocol for media (e.g. "media", "multipart"). */
|
|
3191
|
+
uploadType?: string;
|
|
3192
|
+
},
|
|
3193
|
+
body: BatchGetValuesByDataFilterRequest): client.Request<BatchGetValuesByDataFilterResponse>;
|
|
3194
|
+
/** Sets values in one or more ranges of a spreadsheet. The caller must specify the spreadsheet ID, a valueInputOption, and one or more ValueRanges. */
|
|
3195
|
+
batchUpdate(request: {
|
|
3196
|
+
/** V1 error format. */
|
|
3197
|
+
"$.xgafv"?: string;
|
|
3198
|
+
/** OAuth access token. */
|
|
3199
|
+
access_token?: string;
|
|
3200
|
+
/** Data format for response. */
|
|
3201
|
+
alt?: string;
|
|
3202
|
+
/** JSONP */
|
|
3203
|
+
callback?: string;
|
|
3204
|
+
/** Selector specifying which fields to include in a partial response. */
|
|
3205
|
+
fields?: string;
|
|
3206
|
+
/** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
|
|
3207
|
+
key?: string;
|
|
3208
|
+
/** OAuth 2.0 token for the current user. */
|
|
3209
|
+
oauth_token?: string;
|
|
3210
|
+
/** Returns response with indentations and line breaks. */
|
|
3211
|
+
prettyPrint?: boolean;
|
|
3212
|
+
/** 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. */
|
|
3213
|
+
quotaUser?: string;
|
|
3214
|
+
/** The ID of the spreadsheet to update. */
|
|
3215
|
+
spreadsheetId: string;
|
|
3216
|
+
/** Upload protocol for media (e.g. "raw", "multipart"). */
|
|
3217
|
+
upload_protocol?: string;
|
|
3218
|
+
/** Legacy upload protocol for media (e.g. "media", "multipart"). */
|
|
3219
|
+
uploadType?: string;
|
|
3220
|
+
/** Request body */
|
|
3221
|
+
resource: BatchUpdateValuesRequest;
|
|
3222
|
+
}): client.Request<BatchUpdateValuesResponse>;
|
|
3223
|
+
batchUpdate(request: {
|
|
3224
|
+
/** V1 error format. */
|
|
3225
|
+
"$.xgafv"?: string;
|
|
3226
|
+
/** OAuth access token. */
|
|
3227
|
+
access_token?: string;
|
|
3228
|
+
/** Data format for response. */
|
|
3229
|
+
alt?: string;
|
|
3230
|
+
/** JSONP */
|
|
3231
|
+
callback?: string;
|
|
3232
|
+
/** Selector specifying which fields to include in a partial response. */
|
|
3233
|
+
fields?: string;
|
|
3234
|
+
/** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
|
|
3235
|
+
key?: string;
|
|
3236
|
+
/** OAuth 2.0 token for the current user. */
|
|
3237
|
+
oauth_token?: string;
|
|
3238
|
+
/** Returns response with indentations and line breaks. */
|
|
3239
|
+
prettyPrint?: boolean;
|
|
3240
|
+
/** 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. */
|
|
3241
|
+
quotaUser?: string;
|
|
3242
|
+
/** The ID of the spreadsheet to update. */
|
|
3243
|
+
spreadsheetId: string;
|
|
3244
|
+
/** Upload protocol for media (e.g. "raw", "multipart"). */
|
|
3245
|
+
upload_protocol?: string;
|
|
3246
|
+
/** Legacy upload protocol for media (e.g. "media", "multipart"). */
|
|
3247
|
+
uploadType?: string;
|
|
3248
|
+
},
|
|
3249
|
+
body: BatchUpdateValuesRequest): client.Request<BatchUpdateValuesResponse>;
|
|
3250
|
+
/** Sets values in one or more ranges of a spreadsheet. The caller must specify the spreadsheet ID, a valueInputOption, and one or more DataFilterValueRanges. */
|
|
3251
|
+
batchUpdateByDataFilter(request: {
|
|
3252
|
+
/** V1 error format. */
|
|
3253
|
+
"$.xgafv"?: string;
|
|
3254
|
+
/** OAuth access token. */
|
|
3255
|
+
access_token?: string;
|
|
3256
|
+
/** Data format for response. */
|
|
3257
|
+
alt?: string;
|
|
3258
|
+
/** JSONP */
|
|
3259
|
+
callback?: string;
|
|
3260
|
+
/** Selector specifying which fields to include in a partial response. */
|
|
3261
|
+
fields?: string;
|
|
3262
|
+
/** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
|
|
3263
|
+
key?: string;
|
|
3264
|
+
/** OAuth 2.0 token for the current user. */
|
|
3265
|
+
oauth_token?: string;
|
|
3266
|
+
/** Returns response with indentations and line breaks. */
|
|
3267
|
+
prettyPrint?: boolean;
|
|
3268
|
+
/** 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. */
|
|
3269
|
+
quotaUser?: string;
|
|
3270
|
+
/** The ID of the spreadsheet to update. */
|
|
3271
|
+
spreadsheetId: string;
|
|
3272
|
+
/** Upload protocol for media (e.g. "raw", "multipart"). */
|
|
3273
|
+
upload_protocol?: string;
|
|
3274
|
+
/** Legacy upload protocol for media (e.g. "media", "multipart"). */
|
|
3275
|
+
uploadType?: string;
|
|
3276
|
+
/** Request body */
|
|
3277
|
+
resource: BatchUpdateValuesByDataFilterRequest;
|
|
3278
|
+
}): client.Request<BatchUpdateValuesByDataFilterResponse>;
|
|
3279
|
+
batchUpdateByDataFilter(request: {
|
|
3280
|
+
/** V1 error format. */
|
|
3281
|
+
"$.xgafv"?: string;
|
|
3282
|
+
/** OAuth access token. */
|
|
3283
|
+
access_token?: string;
|
|
3284
|
+
/** Data format for response. */
|
|
3285
|
+
alt?: string;
|
|
3286
|
+
/** JSONP */
|
|
3287
|
+
callback?: string;
|
|
3288
|
+
/** Selector specifying which fields to include in a partial response. */
|
|
3289
|
+
fields?: string;
|
|
3290
|
+
/** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
|
|
3291
|
+
key?: string;
|
|
3292
|
+
/** OAuth 2.0 token for the current user. */
|
|
3293
|
+
oauth_token?: string;
|
|
3294
|
+
/** Returns response with indentations and line breaks. */
|
|
3295
|
+
prettyPrint?: boolean;
|
|
3296
|
+
/** 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. */
|
|
3297
|
+
quotaUser?: string;
|
|
3298
|
+
/** The ID of the spreadsheet to update. */
|
|
3299
|
+
spreadsheetId: string;
|
|
3300
|
+
/** Upload protocol for media (e.g. "raw", "multipart"). */
|
|
3301
|
+
upload_protocol?: string;
|
|
3302
|
+
/** Legacy upload protocol for media (e.g. "media", "multipart"). */
|
|
3303
|
+
uploadType?: string;
|
|
3304
|
+
},
|
|
3305
|
+
body: BatchUpdateValuesByDataFilterRequest): client.Request<BatchUpdateValuesByDataFilterResponse>;
|
|
3306
|
+
/**
|
|
3307
|
+
* 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
|
|
3308
|
+
* validation, etc..) are kept.
|
|
3309
|
+
*/
|
|
3310
|
+
clear(request: {
|
|
3311
|
+
/** V1 error format. */
|
|
3312
|
+
"$.xgafv"?: string;
|
|
3313
|
+
/** OAuth access token. */
|
|
3314
|
+
access_token?: string;
|
|
3315
|
+
/** Data format for response. */
|
|
3316
|
+
alt?: string;
|
|
3317
|
+
/** JSONP */
|
|
3318
|
+
callback?: string;
|
|
3319
|
+
/** Selector specifying which fields to include in a partial response. */
|
|
3320
|
+
fields?: string;
|
|
3321
|
+
/** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
|
|
3322
|
+
key?: string;
|
|
3323
|
+
/** OAuth 2.0 token for the current user. */
|
|
3324
|
+
oauth_token?: string;
|
|
3325
|
+
/** Returns response with indentations and line breaks. */
|
|
3326
|
+
prettyPrint?: boolean;
|
|
3327
|
+
/** 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. */
|
|
3328
|
+
quotaUser?: string;
|
|
3329
|
+
/** The [A1 notation or R1C1 notation](/sheets/api/guides/concepts#cell) of the values to clear. */
|
|
3330
|
+
range: string;
|
|
3331
|
+
/** The ID of the spreadsheet to update. */
|
|
3332
|
+
spreadsheetId: string;
|
|
3333
|
+
/** Upload protocol for media (e.g. "raw", "multipart"). */
|
|
3334
|
+
upload_protocol?: string;
|
|
3335
|
+
/** Legacy upload protocol for media (e.g. "media", "multipart"). */
|
|
3336
|
+
uploadType?: string;
|
|
3337
|
+
/** Request body */
|
|
3338
|
+
resource: ClearValuesRequest;
|
|
3339
|
+
}): client.Request<ClearValuesResponse>;
|
|
3340
|
+
clear(request: {
|
|
3341
|
+
/** V1 error format. */
|
|
3342
|
+
"$.xgafv"?: string;
|
|
3343
|
+
/** OAuth access token. */
|
|
3344
|
+
access_token?: string;
|
|
3345
|
+
/** Data format for response. */
|
|
3346
|
+
alt?: string;
|
|
3347
|
+
/** JSONP */
|
|
3348
|
+
callback?: string;
|
|
3349
|
+
/** Selector specifying which fields to include in a partial response. */
|
|
3350
|
+
fields?: string;
|
|
3351
|
+
/** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
|
|
3352
|
+
key?: string;
|
|
3353
|
+
/** OAuth 2.0 token for the current user. */
|
|
3354
|
+
oauth_token?: string;
|
|
3355
|
+
/** Returns response with indentations and line breaks. */
|
|
3356
|
+
prettyPrint?: boolean;
|
|
3357
|
+
/** 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. */
|
|
3358
|
+
quotaUser?: string;
|
|
3359
|
+
/** The [A1 notation or R1C1 notation](/sheets/api/guides/concepts#cell) of the values to clear. */
|
|
3360
|
+
range: string;
|
|
3361
|
+
/** The ID of the spreadsheet to update. */
|
|
3362
|
+
spreadsheetId: string;
|
|
3363
|
+
/** Upload protocol for media (e.g. "raw", "multipart"). */
|
|
3364
|
+
upload_protocol?: string;
|
|
3365
|
+
/** Legacy upload protocol for media (e.g. "media", "multipart"). */
|
|
3366
|
+
uploadType?: string;
|
|
3367
|
+
},
|
|
3368
|
+
body: ClearValuesRequest): client.Request<ClearValuesResponse>;
|
|
3369
|
+
/** Returns a range of values from a spreadsheet. The caller must specify the spreadsheet ID and a range. */
|
|
3370
|
+
get(request?: {
|
|
3371
|
+
/** V1 error format. */
|
|
3372
|
+
"$.xgafv"?: string;
|
|
3373
|
+
/** OAuth access token. */
|
|
3374
|
+
access_token?: string;
|
|
3375
|
+
/** Data format for response. */
|
|
3376
|
+
alt?: string;
|
|
3377
|
+
/** JSONP */
|
|
3378
|
+
callback?: string;
|
|
3379
|
+
/**
|
|
3380
|
+
* 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
|
|
3381
|
+
* SERIAL_NUMBER.
|
|
3382
|
+
*/
|
|
3383
|
+
dateTimeRenderOption?: string;
|
|
3384
|
+
/** Selector specifying which fields to include in a partial response. */
|
|
3385
|
+
fields?: string;
|
|
3386
|
+
/** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
|
|
3387
|
+
key?: string;
|
|
3388
|
+
/**
|
|
3389
|
+
* The major dimension that results should use. For example, if the spreadsheet data is: `A1=1,B1=2,A2=3,B2=4`, then requesting `range=A1:B2,majorDimension=ROWS` returns
|
|
3390
|
+
* `[[1,2],[3,4]]`, whereas requesting `range=A1:B2,majorDimension=COLUMNS` returns `[[1,3],[2,4]]`.
|
|
3391
|
+
*/
|
|
3392
|
+
majorDimension?: string;
|
|
3393
|
+
/** OAuth 2.0 token for the current user. */
|
|
3394
|
+
oauth_token?: string;
|
|
3395
|
+
/** Returns response with indentations and line breaks. */
|
|
3396
|
+
prettyPrint?: boolean;
|
|
3397
|
+
/** 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. */
|
|
3398
|
+
quotaUser?: string;
|
|
3399
|
+
/** The [A1 notation or R1C1 notation](/sheets/api/guides/concepts#cell) of the range to retrieve values from. */
|
|
3400
|
+
range: string;
|
|
3401
|
+
/** The ID of the spreadsheet to retrieve data from. */
|
|
3402
|
+
spreadsheetId: string;
|
|
3403
|
+
/** Upload protocol for media (e.g. "raw", "multipart"). */
|
|
3404
|
+
upload_protocol?: string;
|
|
3405
|
+
/** Legacy upload protocol for media (e.g. "media", "multipart"). */
|
|
3406
|
+
uploadType?: string;
|
|
3407
|
+
/** How values should be represented in the output. The default render option is FORMATTED_VALUE. */
|
|
3408
|
+
valueRenderOption?: string;
|
|
3409
|
+
}): client.Request<ValueRange>;
|
|
3410
|
+
/** Sets values in a range of a spreadsheet. The caller must specify the spreadsheet ID, range, and a valueInputOption. */
|
|
3411
|
+
update(request: {
|
|
3412
|
+
/** V1 error format. */
|
|
3413
|
+
"$.xgafv"?: string;
|
|
3414
|
+
/** OAuth access token. */
|
|
3415
|
+
access_token?: string;
|
|
3416
|
+
/** Data format for response. */
|
|
3417
|
+
alt?: string;
|
|
3418
|
+
/** JSONP */
|
|
3419
|
+
callback?: string;
|
|
3420
|
+
/** Selector specifying which fields to include in a partial response. */
|
|
3421
|
+
fields?: string;
|
|
3422
|
+
/**
|
|
3423
|
+
* 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
|
|
3424
|
+
* larger than the range actually written, the response includes all values in the requested range (excluding trailing empty rows and columns).
|
|
3425
|
+
*/
|
|
3426
|
+
includeValuesInResponse?: boolean;
|
|
3427
|
+
/** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
|
|
3428
|
+
key?: string;
|
|
3429
|
+
/** OAuth 2.0 token for the current user. */
|
|
3430
|
+
oauth_token?: string;
|
|
3431
|
+
/** Returns response with indentations and line breaks. */
|
|
3432
|
+
prettyPrint?: boolean;
|
|
3433
|
+
/** 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. */
|
|
3434
|
+
quotaUser?: string;
|
|
3435
|
+
/** The [A1 notation](/sheets/api/guides/concepts#cell) of the values to update. */
|
|
3436
|
+
range: string;
|
|
3437
|
+
/**
|
|
3438
|
+
* 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
|
|
3439
|
+
* option is SERIAL_NUMBER.
|
|
3440
|
+
*/
|
|
3441
|
+
responseDateTimeRenderOption?: string;
|
|
3442
|
+
/** Determines how values in the response should be rendered. The default render option is FORMATTED_VALUE. */
|
|
3443
|
+
responseValueRenderOption?: string;
|
|
3444
|
+
/** The ID of the spreadsheet to update. */
|
|
3445
|
+
spreadsheetId: string;
|
|
3446
|
+
/** Upload protocol for media (e.g. "raw", "multipart"). */
|
|
3447
|
+
upload_protocol?: string;
|
|
3448
|
+
/** Legacy upload protocol for media (e.g. "media", "multipart"). */
|
|
3449
|
+
uploadType?: string;
|
|
3450
|
+
/** How the input data should be interpreted. */
|
|
3451
|
+
valueInputOption?: string;
|
|
3452
|
+
/** Request body */
|
|
3453
|
+
resource: ValueRange;
|
|
3454
|
+
}): client.Request<UpdateValuesResponse>;
|
|
3455
|
+
update(request: {
|
|
3456
|
+
/** V1 error format. */
|
|
3457
|
+
"$.xgafv"?: string;
|
|
3458
|
+
/** OAuth access token. */
|
|
3459
|
+
access_token?: string;
|
|
3460
|
+
/** Data format for response. */
|
|
3461
|
+
alt?: string;
|
|
3462
|
+
/** JSONP */
|
|
3463
|
+
callback?: string;
|
|
3464
|
+
/** Selector specifying which fields to include in a partial response. */
|
|
3465
|
+
fields?: string;
|
|
3466
|
+
/**
|
|
3467
|
+
* 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
|
|
3468
|
+
* larger than the range actually written, the response includes all values in the requested range (excluding trailing empty rows and columns).
|
|
3469
|
+
*/
|
|
3470
|
+
includeValuesInResponse?: boolean;
|
|
3471
|
+
/** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
|
|
3472
|
+
key?: string;
|
|
3473
|
+
/** OAuth 2.0 token for the current user. */
|
|
3474
|
+
oauth_token?: string;
|
|
3475
|
+
/** Returns response with indentations and line breaks. */
|
|
3476
|
+
prettyPrint?: boolean;
|
|
3477
|
+
/** 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. */
|
|
3478
|
+
quotaUser?: string;
|
|
3479
|
+
/** The [A1 notation](/sheets/api/guides/concepts#cell) of the values to update. */
|
|
3480
|
+
range: string;
|
|
3481
|
+
/**
|
|
3482
|
+
* 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
|
|
3483
|
+
* option is SERIAL_NUMBER.
|
|
3484
|
+
*/
|
|
3485
|
+
responseDateTimeRenderOption?: string;
|
|
3486
|
+
/** Determines how values in the response should be rendered. The default render option is FORMATTED_VALUE. */
|
|
3487
|
+
responseValueRenderOption?: string;
|
|
3488
|
+
/** The ID of the spreadsheet to update. */
|
|
3489
|
+
spreadsheetId: string;
|
|
3490
|
+
/** Upload protocol for media (e.g. "raw", "multipart"). */
|
|
3491
|
+
upload_protocol?: string;
|
|
3492
|
+
/** Legacy upload protocol for media (e.g. "media", "multipart"). */
|
|
3493
|
+
uploadType?: string;
|
|
3494
|
+
/** How the input data should be interpreted. */
|
|
3495
|
+
valueInputOption?: string;
|
|
3496
|
+
},
|
|
3497
|
+
body: ValueRange): client.Request<UpdateValuesResponse>;
|
|
3498
|
+
}
|
|
3499
|
+
interface SpreadsheetsResource {
|
|
3500
|
+
/**
|
|
3501
|
+
* 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
|
|
3502
|
+
* 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
|
|
3503
|
+
* 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
|
|
3504
|
+
* 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.
|
|
3505
|
+
* Your changes may be altered with respect to collaborator changes. If there are no collaborators, the spreadsheet should reflect your changes.
|
|
3506
|
+
*/
|
|
3507
|
+
batchUpdate(request: {
|
|
3508
|
+
/** V1 error format. */
|
|
3509
|
+
"$.xgafv"?: string;
|
|
3510
|
+
/** OAuth access token. */
|
|
3511
|
+
access_token?: string;
|
|
3512
|
+
/** Data format for response. */
|
|
3513
|
+
alt?: string;
|
|
3514
|
+
/** JSONP */
|
|
3515
|
+
callback?: string;
|
|
3516
|
+
/** Selector specifying which fields to include in a partial response. */
|
|
3517
|
+
fields?: string;
|
|
3518
|
+
/** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
|
|
3519
|
+
key?: string;
|
|
3520
|
+
/** OAuth 2.0 token for the current user. */
|
|
3521
|
+
oauth_token?: string;
|
|
3522
|
+
/** Returns response with indentations and line breaks. */
|
|
3523
|
+
prettyPrint?: boolean;
|
|
3524
|
+
/** 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. */
|
|
3525
|
+
quotaUser?: string;
|
|
3526
|
+
/** The spreadsheet to apply the updates to. */
|
|
3527
|
+
spreadsheetId: string;
|
|
3528
|
+
/** Upload protocol for media (e.g. "raw", "multipart"). */
|
|
3529
|
+
upload_protocol?: string;
|
|
3530
|
+
/** Legacy upload protocol for media (e.g. "media", "multipart"). */
|
|
3531
|
+
uploadType?: string;
|
|
3532
|
+
/** Request body */
|
|
3533
|
+
resource: BatchUpdateSpreadsheetRequest;
|
|
3534
|
+
}): client.Request<BatchUpdateSpreadsheetResponse>;
|
|
3535
|
+
batchUpdate(request: {
|
|
3536
|
+
/** V1 error format. */
|
|
3537
|
+
"$.xgafv"?: string;
|
|
3538
|
+
/** OAuth access token. */
|
|
3539
|
+
access_token?: string;
|
|
3540
|
+
/** Data format for response. */
|
|
3541
|
+
alt?: string;
|
|
3542
|
+
/** JSONP */
|
|
3543
|
+
callback?: string;
|
|
3544
|
+
/** Selector specifying which fields to include in a partial response. */
|
|
3545
|
+
fields?: string;
|
|
3546
|
+
/** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
|
|
3547
|
+
key?: string;
|
|
3548
|
+
/** OAuth 2.0 token for the current user. */
|
|
3549
|
+
oauth_token?: string;
|
|
3550
|
+
/** Returns response with indentations and line breaks. */
|
|
3551
|
+
prettyPrint?: boolean;
|
|
3552
|
+
/** 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. */
|
|
3553
|
+
quotaUser?: string;
|
|
3554
|
+
/** The spreadsheet to apply the updates to. */
|
|
3555
|
+
spreadsheetId: string;
|
|
3556
|
+
/** Upload protocol for media (e.g. "raw", "multipart"). */
|
|
3557
|
+
upload_protocol?: string;
|
|
3558
|
+
/** Legacy upload protocol for media (e.g. "media", "multipart"). */
|
|
3559
|
+
uploadType?: string;
|
|
3560
|
+
},
|
|
3561
|
+
body: BatchUpdateSpreadsheetRequest): client.Request<BatchUpdateSpreadsheetResponse>;
|
|
3562
|
+
/** Creates a spreadsheet, returning the newly created spreadsheet. */
|
|
3563
|
+
create(request: {
|
|
3564
|
+
/** V1 error format. */
|
|
3565
|
+
"$.xgafv"?: string;
|
|
3566
|
+
/** OAuth access token. */
|
|
3567
|
+
access_token?: string;
|
|
3568
|
+
/** Data format for response. */
|
|
3569
|
+
alt?: string;
|
|
3570
|
+
/** JSONP */
|
|
3571
|
+
callback?: string;
|
|
3572
|
+
/** Selector specifying which fields to include in a partial response. */
|
|
3573
|
+
fields?: string;
|
|
3574
|
+
/** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
|
|
3575
|
+
key?: string;
|
|
3576
|
+
/** OAuth 2.0 token for the current user. */
|
|
3577
|
+
oauth_token?: string;
|
|
3578
|
+
/** Returns response with indentations and line breaks. */
|
|
3579
|
+
prettyPrint?: boolean;
|
|
3580
|
+
/** 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. */
|
|
3581
|
+
quotaUser?: string;
|
|
3582
|
+
/** Upload protocol for media (e.g. "raw", "multipart"). */
|
|
3583
|
+
upload_protocol?: string;
|
|
3584
|
+
/** Legacy upload protocol for media (e.g. "media", "multipart"). */
|
|
3585
|
+
uploadType?: string;
|
|
3586
|
+
/** Request body */
|
|
3587
|
+
resource: Spreadsheet;
|
|
3588
|
+
}): client.Request<Spreadsheet>;
|
|
3589
|
+
create(request: {
|
|
3590
|
+
/** V1 error format. */
|
|
3591
|
+
"$.xgafv"?: string;
|
|
3592
|
+
/** OAuth access token. */
|
|
3593
|
+
access_token?: string;
|
|
3594
|
+
/** Data format for response. */
|
|
3595
|
+
alt?: string;
|
|
3596
|
+
/** JSONP */
|
|
3597
|
+
callback?: string;
|
|
3598
|
+
/** Selector specifying which fields to include in a partial response. */
|
|
3599
|
+
fields?: string;
|
|
3600
|
+
/** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
|
|
3601
|
+
key?: string;
|
|
3602
|
+
/** OAuth 2.0 token for the current user. */
|
|
3603
|
+
oauth_token?: string;
|
|
3604
|
+
/** Returns response with indentations and line breaks. */
|
|
3605
|
+
prettyPrint?: boolean;
|
|
3606
|
+
/** 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. */
|
|
3607
|
+
quotaUser?: string;
|
|
3608
|
+
/** Upload protocol for media (e.g. "raw", "multipart"). */
|
|
3609
|
+
upload_protocol?: string;
|
|
3610
|
+
/** Legacy upload protocol for media (e.g. "media", "multipart"). */
|
|
3611
|
+
uploadType?: string;
|
|
3612
|
+
},
|
|
3613
|
+
body: Spreadsheet): client.Request<Spreadsheet>;
|
|
3614
|
+
/**
|
|
3615
|
+
* 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: *
|
|
3616
|
+
* Specify a field mask 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
|
|
3617
|
+
* `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
|
|
3618
|
+
* 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
|
|
3619
|
+
* 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
|
|
3620
|
+
* example, `?ranges=A1:D5&ranges=Sheet2!A1:C4`). Limiting the range returns only the portions of the spreadsheet that intersect the requested ranges.
|
|
3621
|
+
*/
|
|
3622
|
+
get(request?: {
|
|
3623
|
+
/** V1 error format. */
|
|
3624
|
+
"$.xgafv"?: string;
|
|
3625
|
+
/** OAuth access token. */
|
|
3626
|
+
access_token?: string;
|
|
3627
|
+
/** Data format for response. */
|
|
3628
|
+
alt?: string;
|
|
3629
|
+
/** JSONP */
|
|
3630
|
+
callback?: string;
|
|
3631
|
+
/** Selector specifying which fields to include in a partial response. */
|
|
3632
|
+
fields?: string;
|
|
3633
|
+
/** True if grid data should be returned. This parameter is ignored if a field mask was set in the request. */
|
|
3634
|
+
includeGridData?: boolean;
|
|
3635
|
+
/** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
|
|
3636
|
+
key?: string;
|
|
3637
|
+
/** OAuth 2.0 token for the current user. */
|
|
3638
|
+
oauth_token?: string;
|
|
3639
|
+
/** Returns response with indentations and line breaks. */
|
|
3640
|
+
prettyPrint?: boolean;
|
|
3641
|
+
/** 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. */
|
|
3642
|
+
quotaUser?: string;
|
|
3643
|
+
/** The ranges to retrieve from the spreadsheet. */
|
|
3644
|
+
ranges?: string | string[];
|
|
3645
|
+
/** The spreadsheet to request. */
|
|
3646
|
+
spreadsheetId: string;
|
|
3647
|
+
/** Upload protocol for media (e.g. "raw", "multipart"). */
|
|
3648
|
+
upload_protocol?: string;
|
|
3649
|
+
/** Legacy upload protocol for media (e.g. "media", "multipart"). */
|
|
3650
|
+
uploadType?: string;
|
|
3651
|
+
}): client.Request<Spreadsheet>;
|
|
3652
|
+
/**
|
|
3653
|
+
* 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
|
|
3654
|
+
* 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
|
|
3655
|
+
* 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 listing your desired
|
|
3656
|
+
* 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
|
|
3657
|
+
* spreadsheets, as a best practice, retrieve only the specific spreadsheet fields that you want.
|
|
3658
|
+
*/
|
|
3659
|
+
getByDataFilter(request: {
|
|
3660
|
+
/** V1 error format. */
|
|
3661
|
+
"$.xgafv"?: string;
|
|
3662
|
+
/** OAuth access token. */
|
|
3663
|
+
access_token?: string;
|
|
3664
|
+
/** Data format for response. */
|
|
3665
|
+
alt?: string;
|
|
3666
|
+
/** JSONP */
|
|
3667
|
+
callback?: string;
|
|
3668
|
+
/** Selector specifying which fields to include in a partial response. */
|
|
3669
|
+
fields?: string;
|
|
3670
|
+
/** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
|
|
3671
|
+
key?: string;
|
|
3672
|
+
/** OAuth 2.0 token for the current user. */
|
|
3673
|
+
oauth_token?: string;
|
|
3674
|
+
/** Returns response with indentations and line breaks. */
|
|
3675
|
+
prettyPrint?: boolean;
|
|
3676
|
+
/** 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. */
|
|
3677
|
+
quotaUser?: string;
|
|
3678
|
+
/** The spreadsheet to request. */
|
|
3679
|
+
spreadsheetId: string;
|
|
3680
|
+
/** Upload protocol for media (e.g. "raw", "multipart"). */
|
|
3681
|
+
upload_protocol?: string;
|
|
3682
|
+
/** Legacy upload protocol for media (e.g. "media", "multipart"). */
|
|
3683
|
+
uploadType?: string;
|
|
3684
|
+
/** Request body */
|
|
3685
|
+
resource: GetSpreadsheetByDataFilterRequest;
|
|
3686
|
+
}): client.Request<Spreadsheet>;
|
|
3687
|
+
getByDataFilter(request: {
|
|
3688
|
+
/** V1 error format. */
|
|
3689
|
+
"$.xgafv"?: string;
|
|
3690
|
+
/** OAuth access token. */
|
|
3691
|
+
access_token?: string;
|
|
3692
|
+
/** Data format for response. */
|
|
3693
|
+
alt?: string;
|
|
3694
|
+
/** JSONP */
|
|
3695
|
+
callback?: string;
|
|
3696
|
+
/** Selector specifying which fields to include in a partial response. */
|
|
3697
|
+
fields?: string;
|
|
3698
|
+
/** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
|
|
3699
|
+
key?: string;
|
|
3700
|
+
/** OAuth 2.0 token for the current user. */
|
|
3701
|
+
oauth_token?: string;
|
|
3702
|
+
/** Returns response with indentations and line breaks. */
|
|
3703
|
+
prettyPrint?: boolean;
|
|
3704
|
+
/** 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. */
|
|
3705
|
+
quotaUser?: string;
|
|
3706
|
+
/** The spreadsheet to request. */
|
|
3707
|
+
spreadsheetId: string;
|
|
3708
|
+
/** Upload protocol for media (e.g. "raw", "multipart"). */
|
|
3709
|
+
upload_protocol?: string;
|
|
3710
|
+
/** Legacy upload protocol for media (e.g. "media", "multipart"). */
|
|
3711
|
+
uploadType?: string;
|
|
3712
|
+
},
|
|
3713
|
+
body: GetSpreadsheetByDataFilterRequest): client.Request<Spreadsheet>;
|
|
3714
|
+
developerMetadata: DeveloperMetadataResource;
|
|
3715
|
+
sheets: SheetsResource;
|
|
3716
|
+
values: ValuesResource;
|
|
3717
|
+
}
|
|
3718
|
+
|
|
3719
|
+
const spreadsheets: SpreadsheetsResource;
|
|
3720
|
+
}
|
|
3721
|
+
}
|