"description":"The direction of the text in the cell.",
"type":"string"
},
"wrapStrategy":{
"description":"The wrap strategy for the value in the cell.",
"type":"string",
"enumDescriptions":[
"The default value, do not use.",
"Lines that are longer than the cell width will be written in the next\ncell over, so long as that cell is empty. If the next cell over is\nnon-empty, this behaves the same as CLIP. The text will never wrap\nto the next line unless the user manually inserts a new line.\nExample:\n\n | First sentence. |\n | Manual newline that is very long. \u003c- Text continues into next cell\n | Next newline. |",
"This wrap strategy represents the old Google Sheets wrap strategy where\nwords that are longer than a line are clipped rather than broken. This\nstrategy is not supported on all platforms and is being phased out.\nExample:\n\n | Cell has a |\n | loooooooooo| \u003c- Word is clipped.\n | word. |",
"Lines that are longer than the cell width will be clipped.\nThe text will never wrap to the next line unless the user manually\ninserts a new line.\nExample:\n\n | First sentence. |\n | Manual newline t| \u003c- Text is clipped\n | Next newline. |",
"Words that are longer than a line are wrapped at the character level\nrather than clipped.\nExample:\n\n | Cell has a |\n | loooooooooo| \u003c- Word is broken.\n | ong word. |"
],
"enum":[
"WRAP_STRATEGY_UNSPECIFIED",
"OVERFLOW_CELL",
"LEGACY_WRAP",
"CLIP",
"WRAP"
]
},
"textRotation":{
"description":"The rotation applied to text in a cell",
"description":"The range (in A1 notation) that was cleared.\n(If the request was for an unbounded range or a ranger larger\n than the bounds of the sheet, this will be the actual range\n that was cleared, bounded to the sheet's limits.)",
"type":"string"
}
},
"id":"ClearValuesResponse",
"description":"The response when clearing a range of values in a spreadsheet.",
"type":"object"
},
"DeleteConditionalFormatRuleRequest":{
"properties":{
"index":{
"description":"The zero-based index of the rule to be deleted.",
"format":"int32",
"type":"integer"
},
"sheetId":{
"description":"The sheet the rule is being deleted from.",
"format":"int32",
"type":"integer"
}
},
"id":"DeleteConditionalFormatRuleRequest",
"description":"Deletes a conditional format rule at the given index.\nAll subsequent rules' indexes are decremented.",
"type":"object"
},
"AddBandingResponse":{
"id":"AddBandingResponse",
"description":"The result of adding a banded range.",
"type":"object",
"properties":{
"bandedRange":{
"$ref":"BandedRange",
"description":"The banded range that was added."
}
}
},
"DeleteNamedRangeRequest":{
"description":"Removes the named range with the given ID from the spreadsheet.",
"type":"object",
"properties":{
"namedRangeId":{
"description":"The ID of the named range to delete.",
"type":"string"
}
},
"id":"DeleteNamedRangeRequest"
},
"ChartData":{
"properties":{
"sourceRange":{
"$ref":"ChartSourceRange",
"description":"The source ranges of the data."
}
},
"id":"ChartData",
"description":"The data included in a domain or series.",
"type":"object"
},
"BatchGetValuesResponse":{
"description":"The response when retrieving more than one range of values in a spreadsheet.",
"type":"object",
"properties":{
"spreadsheetId":{
"description":"The ID of the spreadsheet the data was retrieved from.",
"type":"string"
},
"valueRanges":{
"description":"The requested values. The order of the ValueRanges is the same as the\norder of the requested ranges.",
"description":"Updates properties of the supplied banded range.",
"type":"object",
"properties":{
"fields":{
"description":"The fields that should be updated. At least one field must be specified.\nThe root `bandedRange` is implied and should not be specified.\nA single `\"*\"` can be used as short-hand for listing every field.",
"description":"The banded range to update with the new properties.",
"$ref":"BandedRange"
}
},
"id":"UpdateBandingRequest"
},
"Color":{
"description":"Represents a color in the RGBA color space. This representation is designed\nfor simplicity of conversion to/from color representations in various\nlanguages over compactness; for example, the fields of this representation\ncan be trivially provided to the constructor of \"java.awt.Color\" in Java; it\ncan also be trivially provided to UIColor's \"+colorWithRed:green:blue:alpha\"\nmethod in iOS; and, with just a little work, it can be easily formatted into\na CSS \"rgba()\" string in JavaScript, as well. Here are some examples:\n\nExample (Java):\n\n import com.google.type.Color;\n\n // ...\n public static java.awt.Color fromProto(Color protocolor) {\n float alpha = protocolor.hasAlpha()\n ? protocolor.getAlpha().getValue()\n : 1.0;\n\n return new java.awt.Color(\n protocolor.getRed(),\n protocolor.getGreen(),\n protocolor.getBlue(),\n alpha);\n }\n\n public static Color toProto(java.awt.Color color) {\n float red = (float) color.getRed();\n float green = (float) color.getGreen();\n float blue = (float) color.getBlue();\n float denominator = 255.0;\n Color.Builder resultBuilder =\n Color\n .newBuilder()\n .setRed(red / denominator)\n .setGreen(green / denominator)\n .setBlue(blue / denominator);\n int alpha = color.getAlpha();\n if (alpha != 255) {\n result.setAlpha(\n FloatValue\n .newBuilder()\n .setValue(((float) alpha) / denominator)\n .build());\n }\n return resultBuilder.build();\n }\n // ...\n\nExample (iOS / Obj-C):\n\n // ...\n static UIColor* fromProto(Color* protocolor) {\n float red = [protocolor red];\n float green = [protocolor green];\n float blue = [protocolor blue];\n FloatValue* alpha_wrapper = [protocolor alpha];\n float alpha = 1.0;\n if (alpha_wrapper != nil) {\n alpha = [alpha_wrapper value];\n }\n return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];\n }\n\n static Color* toProto(UIColor* color) {\n CGFloat red, green, blue, alpha;\n if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {\n return nil;\n }\n Color* result = [Color alloc] init];\n [result setRed:red];\n [result setGreen:green];\n [result setBlue:blue];\n if (alpha \u003c= 0.9999) {\n [result setAlpha:floatWrapperWithValue(alpha)];\n }\n [result autorelease];\n return result;\n }\n // ...\n\n Example (JavaScript):\n\n // ...\n\n var protoToCssColor = function(rgb_color) {\n var redFrac = rgb_color.red || 0.0;\n var greenFrac = rgb_color.green || 0.0;\n var blueFrac = rgb_color.blue || 0.0;\n var red = Math.floor(redFrac * 255);\n var green = Math.floor(greenFrac * 255);\n var blue = Math.floor(blueFrac * 255);\n\n if (!('alpha' in rgb_color)) {\n return rgbToCssColor_(red, green, blue);\n }\n\n var alphaFrac = rgb_color.alpha.value || 0.0;\n var rgbParams = [red, green, blue].join(',');\n return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');\n };\n\n var rgbToCssColor_ = function(red, green, blue) {\n var rgbNumber = new Number((red \u003c\u003c 16) | (green \u003c\u003c 8) | blue);\n var hexString = rgbNumber.toString(16);\n var missingZeros = 6 - hexString.length;\n var resultBuilder = ['#'];\n for (var i = 0; i \u003c missingZeros; i++) {\n resultBuilder.push('0');\n }\n resultBuilder.push(hexString);\n return resultBuilder.join('');\n };\n\n // ...",
"type":"object",
"properties":{
"green":{
"description":"The amount of green in the color as a value in the interval [0, 1].",
"format":"float",
"type":"number"
},
"blue":{
"description":"The amount of blue in the color as a value in the interval [0, 1].",
"format":"float",
"type":"number"
},
"alpha":{
"description":"The fraction of this color that should be applied to the pixel. That is,\nthe final pixel color is defined by the equation:\n\n pixel color = alpha * (this color) + (1.0 - alpha) * (background color)\n\nThis means that a value of 1.0 corresponds to a solid color, whereas\na value of 0.0 corresponds to a completely transparent color. This\nuses a wrapper message rather than a simple float scalar so that it is\npossible to distinguish between a default value and the value being unset.\nIf omitted, this color object is to be rendered as a solid color\n(as if the alpha value had been explicitly given with a value of 1.0).",
"format":"float",
"type":"number"
},
"red":{
"description":"The amount of red in the color as a value in the interval [0, 1].",
"format":"float",
"type":"number"
}
},
"id":"Color"
},
"PivotGroup":{
"id":"PivotGroup",
"description":"A single grouping (either row or column) in a pivot table.",
"type":"object",
"properties":{
"valueBucket":{
"$ref":"PivotGroupSortValueBucket",
"description":"The bucket of the opposite pivot group to sort by.\nIf not specified, sorting is alphabetical by this group's values."
},
"sourceColumnOffset":{
"type":"integer",
"description":"The column offset of the source range that this grouping is based on.\n\nFor example, if the source was `C10:E15`, a `sourceColumnOffset` of `0`\nmeans this group refers to column `C`, whereas the offset `1` would refer\nto column `D`.",
"format":"int32"
},
"showTotals":{
"description":"True if the pivot table should include the totals for this grouping.",
"type":"boolean"
},
"valueMetadata":{
"description":"Metadata about values in the grouping.",
"description":"Whether values should be listed horizontally (as columns)\nor vertically (as rows).",
"type":"string"
},
"values":{
"description":"A list of values to include in the pivot table.",
"type":"array",
"items":{
"$ref":"PivotValue"
}
},
"source":{
"$ref":"GridRange",
"description":"The range the pivot table is reading data from."
},
"columns":{
"description":"Each column grouping in the pivot table.",
"type":"array",
"items":{
"$ref":"PivotGroup"
}
},
"criteria":{
"additionalProperties":{
"$ref":"PivotFilterCriteria"
},
"description":"An optional mapping of filters per source column offset.\n\nThe filters will be applied before aggregating data into the pivot table.\nThe map's key is the column offset of the source range that you want to\nfilter, and the value is the criteria for that column.\n\nFor example, if the source was `C10:E15`, a key of `0` will have the filter\nfor column `C`, whereas the key `1` is for column `D`.",
"type":"object"
},
"rows":{
"type":"array",
"items":{
"$ref":"PivotGroup"
},
"description":"Each row grouping in the pivot table."
"description":"The ranges of data for a series or domain.\nExactly one dimension must have a length of 1,\nand all sources in the list must have the same dimension\nwith length 1.\nThe domain (if it exists) & all series must have the same number\nof source ranges. If using more than one source range, then the source\nrange at a given offset must be contiguous across the domain and series.\n\nFor example, these are valid configurations:\n\n domain sources: A1:A5\n series1 sources: B1:B5\n series2 sources: D6:D10\n\n domain sources: A1:A5, C10:C12\n series1 sources: B1:B5, D10:D12\n series2 sources: C1:C5, E10:E12",
"description":"Adds new cells after the last row with data in a sheet,\ninserting new rows into the sheet if necessary.",
"type":"object",
"properties":{
"rows":{
"description":"The data to append.",
"type":"array",
"items":{
"$ref":"RowData"
}
},
"fields":{
"description":"The fields of CellData that should be updated.\nAt least one field must be specified.\nThe root is the CellData; 'row.values.' should not be specified.\nA single `\"*\"` can be used as short-hand for listing every field.",
"format":"google-fieldmask",
"type":"string"
},
"sheetId":{
"description":"The sheet ID to append the data to.",
"description":"The range the values cover, in A1 notation.\nFor output, this range indicates the entire requested range,\neven though the values will exclude trailing rows and columns.\nWhen appending values, this field represents the range to search for a\ntable, after which values will be appended.",
"description":"The major dimension of the values.\n\nFor output, if the spreadsheet data is: `A1=1,B1=2,A2=3,B2=4`,\nthen requesting `range=A1:B2,majorDimension=ROWS` will return\n`[[1,2],[3,4]]`,\nwhereas requesting `range=A1:B2,majorDimension=COLUMNS` will return\n`[[1,3],[2,4]]`.\n\nFor input, with `range=A1:B2,majorDimension=ROWS` then `[[1,2],[3,4]]`\nwill set `A1=1,B1=2,A2=3,B2=4`. With `range=A1:B2,majorDimension=COLUMNS`\nthen `[[1,2],[3,4]]` will set `A1=1,B1=3,A2=2,B2=4`.\n\nWhen writing, if this field is not set, it defaults to ROWS.",
"type":"string",
"enumDescriptions":[
"The default value, do not use.",
"Operates on the rows of a sheet.",
"Operates on the columns of a sheet."
],
"enum":[
"DIMENSION_UNSPECIFIED",
"ROWS",
"COLUMNS"
]
},
"values":{
"description":"The data that was read or to be written. This is an array of arrays,\nthe outer array representing all the data and each inner array\nrepresenting a major dimension. Each item in the inner array\ncorresponds with one cell.\n\nFor output, empty trailing rows and columns will not be included.\n\nFor input, supported value types are: bool, string, and double.\nNull values will be skipped.\nTo set a cell to an empty value, set the string value to an empty string.",
"description":"The banded range to add. The bandedRangeId\nfield is optional; if one is not set, an id will be randomly generated. (It\nis an error to specify the ID of a range that already exists.)",
"description":"The dimension which will be shifted when inserting cells.\nIf ROWS, existing cells will be shifted down.\nIf COLUMNS, existing cells will be shifted right.",
"description":"The format of this run. Absent values inherit the cell's format."
}
},
"id":"TextFormatRun",
"description":"A run of a text format. The format of this run continues until the start\nindex of the next run.\nWhen updating, all fields must be set.",
"description":"The data in the grid, one entry per row,\nstarting with the row in startRow.\nThe values in RowData will correspond to columns starting\nat start_column.",
"type":"array",
"items":{
"$ref":"RowData"
}
},
"startRow":{
"description":"The first row this GridData refers to, zero-based.",
"description":"The named range to update with the new properties."
},
"fields":{
"type":"string",
"description":"The fields that should be updated. At least one field must be specified.\nThe root `namedRange` is implied and should not be specified.\nA single `\"*\"` can be used as short-hand for listing every field.",
"description":"The value to use as the replacement.",
"type":"string"
},
"range":{
"$ref":"GridRange",
"description":"The range to find/replace over."
},
"sheetId":{
"description":"The sheet to find/replace over.",
"format":"int32",
"type":"integer"
},
"matchCase":{
"description":"True if the search is case sensitive.",
"type":"boolean"
},
"allSheets":{
"description":"True to find/replace over all sheets.",
"type":"boolean"
},
"includeFormulas":{
"type":"boolean",
"description":"True if the search should include cells with formulas.\nFalse to skip cells with formulas."
},
"matchEntireCell":{
"description":"True if the find value should match the entire cell.",
"type":"boolean"
},
"find":{
"description":"The value to search.",
"type":"string"
},
"searchByRegex":{
"description":"True if the find value is a regex.\nThe regular expression and replacement should follow Java regex rules\nat https://docs.oracle.com/javase/8/docs/api/java/util/regex/Pattern.html.\nThe replacement string is allowed to refer to capturing groups.\nFor example, if one cell has the contents `\"Google Sheets\"` and another\nhas `\"Google Docs\"`, then searching for `\"o.* (.*)\"` with a replacement of\n`\"$1 Rocks\"` would change the contents of the cells to\n`\"GSheets Rocks\"` and `\"GDocs Rocks\"` respectively.",
"description":"The properties the new sheet should have.\nAll properties are optional.\nThe sheetId field is optional; if one is not\nset, an id will be randomly generated. (It is an error to specify the ID\nof a sheet that already exists.)"
}
},
"id":"AddSheetRequest",
"description":"Adds a new sheet.\nWhen a sheet is added at a given index,\nall subsequent sheets' indexes are incremented.\nTo add an object sheet, use AddChartRequest instead and specify\nEmbeddedObjectPosition.sheetId or\nEmbeddedObjectPosition.newSheet."
},
"UpdateCellsRequest":{
"description":"Updates all cells in a range with new data.",
"type":"object",
"properties":{
"start":{
"$ref":"GridCoordinate",
"description":"The coordinate to start writing data at.\nAny number of rows and columns (including a different number of\ncolumns per row) may be written."
"description":"The range to write data to.\n\nIf the data in rows does not cover the entire requested range,\nthe fields matching those set in fields will be cleared."
"description":"The fields of CellData that should be updated.\nAt least one field must be specified.\nThe root is the CellData; 'row.values.' should not be specified.\nA single `\"*\"` can be used as short-hand for listing every field.",
"description":"The dimension from which deleted cells will be replaced with.\nIf ROWS, existing cells will be shifted upward to\nreplace the deleted cells. If COLUMNS, existing cells\nwill be shifted left to replace the deleted cells.",
"description":"The fields that should be updated. At least one field must be specified.\nThe root `properties` is implied and should not be specified.\nA single `\"*\"` can be used as short-hand for listing every field.",
"description":"The range within which all cells should be unmerged.\nIf the range spans multiple merges, all will be unmerged.\nThe range must not partially span any merge."
}
},
"id":"UnmergeCellsRequest"
},
"SortSpec":{
"description":"A sort order associated with a specific column or row.",
"type":"object",
"properties":{
"dimensionIndex":{
"description":"The dimension the sort should be applied to.",
"description":"Data in the grid, if this is a grid sheet.\nThe number of GridData objects returned is dependent on the number of\nranges requested on this sheet. For example, if this is representing\n`Sheet1`, and the spreadsheet was requested with ranges\n`Sheet1!A1:C10` and `Sheet1!D15:E20`, then the first GridData will have a\nstartRow/startColumn of `0`,\nwhile the second one will have `startRow 14` (zero-based row 15),\nand `startColumn 3` (zero-based column D).",
"description":"The result of updating an embedded object's position.",
"type":"object",
"properties":{
"position":{
"description":"The new position of the embedded object.",
"$ref":"EmbeddedObjectPosition"
}
},
"id":"UpdateEmbeddedObjectPositionResponse"
},
"BooleanRule":{
"properties":{
"format":{
"description":"The format to apply.\nConditional formatting can only apply a subset of formatting:\nbold, italic,\nstrikethrough,\nforeground color &\nbackground color.",
"description":"A condition that must be true for values to be shown.\n(This does not override hiddenValues -- if a value is listed there,\n it will still be hidden.)"
}
},
"id":"FilterCriteria",
"description":"Criteria for showing/hiding rows in a filter or filter view."
},
"PivotGroupValueMetadata":{
"description":"Metadata about a value in a pivot grouping.",
"type":"object",
"properties":{
"value":{
"$ref":"ExtendedValue",
"description":"The calculated value the metadata corresponds to.\n(Note that formulaValue is not valid,\n because the values will be calculated.)"
"description":"True if anyone in the document's domain has edit access to the protected\nrange. Domain protection is only supported on documents within a domain.",
"type":"boolean"
}
},
"id":"Editors"
},
"UpdateConditionalFormatRuleRequest":{
"id":"UpdateConditionalFormatRuleRequest",
"description":"Updates a conditional format rule at the given index,\nor moves a conditional format rule to another index.",
"type":"object",
"properties":{
"index":{
"description":"The zero-based index of the rule that should be replaced or moved.",
"description":"Whether rows or columns should be appended.",
"type":"string"
}
},
"id":"AppendDimensionRequest"
},
"AddNamedRangeRequest":{
"description":"Adds a named range to the spreadsheet.",
"type":"object",
"properties":{
"namedRange":{
"description":"The named range to add. The namedRangeId\nfield is optional; if one is not set, an id will be randomly generated. (It\nis an error to specify the ID of a range that already exists.)",
"$ref":"NamedRange"
}
},
"id":"AddNamedRangeRequest"
},
"CreateDeveloperMetadataResponse":{
"properties":{
"developerMetadata":{
"$ref":"DeveloperMetadata",
"description":"The developer metadata that was created."
}
},
"id":"CreateDeveloperMetadataResponse",
"description":"The response from creating developer metadata.",
"type":"object"
},
"UpdateEmbeddedObjectPositionRequest":{
"id":"UpdateEmbeddedObjectPositionRequest",
"description":"Update an embedded object's position (such as a moving or resizing a\nchart or image).",
"type":"object",
"properties":{
"newPosition":{
"$ref":"EmbeddedObjectPosition",
"description":"An explicit position to move the embedded object to.\nIf newPosition.sheetId is set,\na new sheet with that ID will be created.\nIf newPosition.newSheet is set to true,\na new sheet will be created with an ID that will be chosen for you."
},
"fields":{
"description":"The fields of OverlayPosition\nthat should be updated when setting a new position. Used only if\nnewPosition.overlayPosition\nis set, in which case at least one field must\nbe specified. The root `newPosition.overlayPosition` is implied and\nshould not be specified.\nA single `\"*\"` can be used as short-hand for listing every field.",
"description":"The rotation applied to text in a cell.",
"type":"object",
"properties":{
"angle":{
"description":"The angle between the standard orientation and the desired orientation.\nMeasured in degrees. Valid values are between -90 and 90. Positive\nangles are angled upwards, negative are angled downwards.\n\nNote: For LTR text direction positive angles are in the counterclockwise\ndirection, whereas for RTL they are in the clockwise direction",
"description":"If true, text reads top to bottom, but the orientation of individual\ncharacters is unchanged.\nFor example:\n\n | V |\n | e |\n | r |\n | t |\n | i |\n | c |\n | a |\n | l |",
"description":"The fields that should be updated. At least one field must be specified.\nThe root `developerMetadata` is implied and should not be specified.\nA single `\"*\"` can be used as short-hand for listing every field.",
"format":"google-fieldmask",
"type":"string"
}
},
"id":"UpdateDeveloperMetadataRequest",
"description":"A request to update properties of developer metadata.\nUpdates the properties of the developer metadata selected by the filters to\nthe values provided in the DeveloperMetadata resource. Callers must\nspecify the properties they wish to update in the fields parameter, as well\nas specify at least one DataFilter matching the metadata they wish to\nupdate.",
"type":"object"
},
"UpdateFilterViewRequest":{
"description":"Updates properties of the filter view.",
"type":"object",
"properties":{
"filter":{
"$ref":"FilterView",
"description":"The new properties of the filter view."
},
"fields":{
"description":"The fields that should be updated. At least one field must be specified.\nThe root `filter` is implied and should not be specified.\nA single `\"*\"` can be used as short-hand for listing every field.",
"format":"google-fieldmask",
"type":"string"
}
},
"id":"UpdateFilterViewRequest"
},
"ConditionalFormatRule":{
"description":"A rule describing a conditional format.",
"type":"object",
"properties":{
"ranges":{
"description":"The ranges that will be formatted if the condition is true.\nAll the ranges must be on the same grid.",
"description":"The location to paste to. If the range covers a span that's\na multiple of the source's height or width, then the\ndata will be repeated to fill in the destination range.\nIf the range is smaller than the source range, the entire\nsource data will still be copied (beyond the end of the destination range)."
"The cell's value must be greater than the condition's value.\nSupported by data validation, conditional formatting and filters.\nRequires a single ConditionValue.",
"The cell's value must be greater than or equal to the condition's value.\nSupported by data validation, conditional formatting and filters.\nRequires a single ConditionValue.",
"The cell's value must be less than the condition's value.\nSupported by data validation, conditional formatting and filters.\nRequires a single ConditionValue.",
"The cell's value must be less than or equal to the condition's value.\nSupported by data validation, conditional formatting and filters.\nRequires a single ConditionValue.",
"The cell's value must be equal to the condition's value.\nSupported by data validation, conditional formatting and filters.\nRequires a single ConditionValue.",
"The cell's value must be not equal to the condition's value.\nSupported by data validation, conditional formatting and filters.\nRequires a single ConditionValue.",
"The cell's value must be between the two condition values.\nSupported by data validation, conditional formatting and filters.\nRequires exactly two ConditionValues.",
"The cell's value must not be between the two condition values.\nSupported by data validation, conditional formatting and filters.\nRequires exactly two ConditionValues.",
"The cell's value must contain the condition's value.\nSupported by data validation, conditional formatting and filters.\nRequires a single ConditionValue.",
"The cell's value must not contain the condition's value.\nSupported by data validation, conditional formatting and filters.\nRequires a single ConditionValue.",
"The cell's value must start with the condition's value.\nSupported by conditional formatting and filters.\nRequires a single ConditionValue.",
"The cell's value must end with the condition's value.\nSupported by conditional formatting and filters.\nRequires a single ConditionValue.",
"The cell's value must be exactly the condition's value.\nSupported by data validation, conditional formatting and filters.\nRequires a single ConditionValue.",
"The cell's value must be a valid email address.\nSupported by data validation.\nRequires no ConditionValues.",
"The cell's value must be a valid URL.\nSupported by data validation.\nRequires no ConditionValues.",
"The cell's value must be the same date as the condition's value.\nSupported by data validation, conditional formatting and filters.\nRequires a single ConditionValue.",
"The cell's value must be before the date of the condition's value.\nSupported by data validation, conditional formatting and filters.\nRequires a single ConditionValue\nthat may be a relative date.",
"The cell's value must be after the date of the condition's value.\nSupported by data validation, conditional formatting and filters.\nRequires a single ConditionValue\nthat may be a relative date.",
"The cell's value must be on or before the date of the condition's value.\nSupported by data validation.\nRequires a single ConditionValue\nthat may be a relative date.",
"The cell's value must be on or after the date of the condition's value.\nSupported by data validation.\nRequires a single ConditionValue\nthat may be a relative date.",
"The cell's value must be between the dates of the two condition values.\nSupported by data validation.\nRequires exactly two ConditionValues.",
"The cell's value must be outside the dates of the two condition values.\nSupported by data validation.\nRequires exactly two ConditionValues.",
"The cell's value must be a date.\nSupported by data validation.\nRequires no ConditionValues.",
"The cell's value must be listed in the grid in condition value's range.\nSupported by data validation.\nRequires a single ConditionValue,\nand the value must be a valid range in A1 notation.",
"The cell's value must in the list of condition values.\nSupported by data validation.\nSupports any number of condition values,\none per item in the list.\nFormulas are not supported in the values.",
"The cell's value must be empty.\nSupported by conditional formatting and filters.\nRequires no ConditionValues.",
"The cell's value must not be empty.\nSupported by conditional formatting and filters.\nRequires no ConditionValues.",
"The condition's formula must evaluate to true.\nSupported by data validation, conditional formatting and filters.\nRequires a single ConditionValue."
"description":"The values of the condition. The number of supported values depends\non the condition type. Some support zero values,\nothers one or two values,\nand ConditionType.ONE_OF_LIST supports an arbitrary number of values."
"description":"A condition that can evaluate to true or false.\nBooleanConditions are used by conditional formatting,\ndata validation, and the criteria in filters.",
"description":"A range on a sheet.\nAll indexes are zero-based.\nIndexes are half open, e.g the start index is inclusive\nand the end index is exclusive -- [start_index, end_index).\nMissing indexes indicate the range is unbounded on that side.\n\nFor example, if `\"Sheet1\"` is sheet ID 0, then:\n\n `Sheet1!A1:A1 == sheet_id: 0,\n start_row_index: 0, end_row_index: 1,\n start_column_index: 0, end_column_index: 1`\n\n `Sheet1!A3:B4 == sheet_id: 0,\n start_row_index: 2, end_row_index: 4,\n start_column_index: 0, end_column_index: 2`\n\n `Sheet1!A:B == sheet_id: 0,\n start_column_index: 0, end_column_index: 2`\n\n `Sheet1!A5:B == sheet_id: 0,\n start_row_index: 4,\n start_column_index: 0, end_column_index: 2`\n\n `Sheet1 == sheet_id:0`\n\nThe start index must always be less than or equal to the end index.\nIf the start index equals the end index, then the range is empty.\nEmpty ranges are typically not meaningful and are usually rendered in the\nUI as `#REF!`.",
"description":"If some values in a series are missing, gaps may appear in the chart (e.g,\nsegments of lines in a line chart will be missing). To eliminate these\ngaps set this to true.\nApplies to Line, Area, and Combo charts.",
"type":"boolean"
},
"series":{
"description":"The data this chart is visualizing.",
"description":"The number of rows or columns in the data that are \"headers\".\nIf not set, Google Sheets will guess how many rows are headers based\non the data.\n\n(Note that BasicChartAxis.title may override the axis title\n inferred from the header values.)",
"description":"The format of the text inside the bubbles.\nUnderline and Strikethrough are not supported."
},
"bubbleBorderColor":{
"description":"The bubble border color.",
"$ref":"Color"
},
"groupIds":{
"description":"The data containing the bubble group IDs. All bubbles with the same group\nID will be drawn in the same color. If bubble_sizes is specified then\nthis field must also be specified but may contain blank values.\nThis field is optional.",
"$ref":"ChartData"
},
"bubbleLabels":{
"$ref":"ChartData",
"description":"The data containing the bubble labels. These do not need to be unique."
},
"bubbleMinRadiusSize":{
"description":"The minimum radius size of the bubbles, in pixels.\nIf specific, the field must be a positive value.",
"description":"Where the legend of the chart should be drawn.",
"type":"string"
},
"bubbleOpacity":{
"description":"The opacity of the bubbles between 0 and 1.0.\n0 is fully transparent and 1 is fully opaque.",
"format":"float",
"type":"number"
},
"bubbleSizes":{
"$ref":"ChartData",
"description":"The data contianing the bubble sizes. Bubble sizes are used to draw\nthe bubbles at different sizes relative to each other.\nIf specified, group_ids must also be specified. This field is\noptional."
},
"domain":{
"description":"The data containing the bubble x-values. These values locate the bubbles\nin the chart horizontally.",
"description":"A pivot table anchored at this cell. The size of pivot table itself\nis computed dynamically based on its data, grouping, filters, values,\netc. Only the top-left cell of the pivot table contains the pivot table\ndefinition. The other cells will contain the calculated values of the\nresults of the pivot in their effective_value fields.",
"$ref":"PivotTable"
},
"userEnteredFormat":{
"$ref":"CellFormat",
"description":"The format the user entered for the cell.\n\nWhen writing, the new format will be merged with the existing format."
},
"note":{
"description":"Any note on the cell.",
"type":"string"
},
"effectiveFormat":{
"$ref":"CellFormat",
"description":"The effective format being used by the cell.\nThis includes the results of applying any conditional formatting and,\nif the cell contains a formula, the computed number format.\nIf the effective format is the default format, effective format will\nnot be written.\nThis field is read-only."
},
"userEnteredValue":{
"$ref":"ExtendedValue",
"description":"The value the user entered in the cell. e.g, `1234`, `'Hello'`, or `=NOW()`\nNote: Dates, Times and DateTimes are represented as doubles in\nserial number format."
},
"dataValidation":{
"$ref":"DataValidationRule",
"description":"A data validation rule on the cell, if any.\n\nWhen writing, the new data validation rule will overwrite any prior rule."
},
"effectiveValue":{
"$ref":"ExtendedValue",
"description":"The effective value of the cell. For cells with formulas, this will be\nthe calculated value. For cells with literals, this will be\nthe same as the user_entered_value.\nThis field is read-only."
},
"formattedValue":{
"description":"The formatted value of the cell.\nThis is the value as it's shown to the user.\nThis field is read-only.",
"description":"Runs of rich text applied to subsections of the cell. Runs are only valid\non user entered strings, not formulas, bools, or numbers.\nRuns start at specific indexes in the text and continue until the next\nrun. Properties of a run will continue unless explicitly changed\nin a subsequent run (and properties of the first run will continue\nthe properties of the cell unless explicitly changed).\n\nWhen writing, the new runs will overwrite any prior runs. When writing a\nnew user_entered_value, previous runs will be erased."
},
"hyperlink":{
"description":"A hyperlink this cell points to, if any.\nThis field is read-only. (To set it, use a `=HYPERLINK` formula\nin the userEnteredValue.formulaValue\nfield.)",
"Values will be calculated & formatted in the reply according to the\ncell's formatting. Formatting is based on the spreadsheet's locale,\nnot the requesting user's locale.\nFor example, if `A1` is `1.23` and `A2` is `=A1` and formatted as currency,\nthen `A2` would return `\"$1.23\"`.",
"Values will be calculated, but not formatted in the reply.\nFor example, if `A1` is `1.23` and `A2` is `=A1` and formatted as currency,\nthen `A2` would return the number `1.23`.",
"Values will not be calculated. The reply will include the formulas.\nFor example, if `A1` is `1.23` and `A2` is `=A1` and formatted as currency,\nthen A2 would return `\"=A1\"`."
],
"enum":[
"FORMATTED_VALUE",
"UNFORMATTED_VALUE",
"FORMULA"
],
"description":"Determines how values in the response should be rendered.\nThe default render option is ValueRenderOption.FORMATTED_VALUE.",
"description":"Determines if the update response should include the values\nof the cells that were updated. By default, responses\ndo not include the updated values. The `updatedData` field within\neach of the BatchUpdateValuesResponse.responses will contain\nthe updated values. If the range to write was larger than than the range\nactually written, the response will include all values in the requested\nrange (excluding trailing empty rows and columns).",
"Default input value. This value must not be used.",
"The values the user has entered will not be parsed and will be stored\nas-is.",
"The values will be parsed as if the user typed them into the UI.\nNumbers will stay as numbers, but strings may be converted to numbers,\ndates, etc. following the same rules that are applied when entering\ntext into a cell via the Google Sheets UI."
"description":"The new values to apply to the spreadsheet. If more than one range is\nmatched by the specified DataFilter the specified values will be\napplied to all of those ranges.",
"description":"Determines how dates, times, and durations in the response should be\nrendered. This is ignored if response_value_render_option is\nFORMATTED_VALUE.\nThe default dateTime render option is\nDateTimeRenderOption.SERIAL_NUMBER.",
"Instructs date, time, datetime, and duration fields to be output\nas doubles in \"serial number\" format, as popularized by Lotus 1-2-3.\nThe whole number portion of the value (left of the decimal) counts\nthe days since December 30th 1899. The fractional portion (right of\nthe decimal) counts the time as a fraction of the day. For example,\nJanuary 1st 1900 at noon would be 2.5, 2 because it's 2 days after\nDecember 30st 1899, and .5 because noon is half a day. February 1st\n1900 at 3pm would be 33.625. This correctly treats the year 1900 as\nnot a leap year.",
"Instructs date, time, datetime, and duration fields to be output\nas strings in their given number format (which is dependent\non the spreadsheet locale)."
"description":"A list of updates to apply to the spreadsheet.\nRequests will be applied in the order they are specified.\nIf any request is not valid, no requests will be applied.",
"description":"Limits the ranges included in the response spreadsheet.\nMeaningful only if include_spreadsheet_response is 'true'.",
"type":"array",
"items":{
"type":"string"
}
},
"responseIncludeGridData":{
"description":"True if grid data should be returned. Meaningful only if\nif include_spreadsheet_response is 'true'.\nThis parameter is ignored if a field mask was set in the request.",
"description":"Updates a chart's specifications.\n(This does not move or resize a chart. To move or resize a chart, use\n UpdateEmbeddedObjectPositionRequest.)",
"description":"How values should be represented in the output.\nThe default render option is ValueRenderOption.FORMATTED_VALUE.",
"type":"string",
"enumDescriptions":[
"Values will be calculated & formatted in the reply according to the\ncell's formatting. Formatting is based on the spreadsheet's locale,\nnot the requesting user's locale.\nFor example, if `A1` is `1.23` and `A2` is `=A1` and formatted as currency,\nthen `A2` would return `\"$1.23\"`.",
"Values will be calculated, but not formatted in the reply.\nFor example, if `A1` is `1.23` and `A2` is `=A1` and formatted as currency,\nthen `A2` would return the number `1.23`.",
"Values will not be calculated. The reply will include the formulas.\nFor example, if `A1` is `1.23` and `A2` is `=A1` and formatted as currency,\nthen A2 would return `\"=A1\"`."
"description":"How dates, times, and durations should be represented in the output.\nThis is ignored if value_render_option is\nFORMATTED_VALUE.\nThe default dateTime render option is [DateTimeRenderOption.SERIAL_NUMBER].",
"Instructs date, time, datetime, and duration fields to be output\nas doubles in \"serial number\" format, as popularized by Lotus 1-2-3.\nThe whole number portion of the value (left of the decimal) counts\nthe days since December 30th 1899. The fractional portion (right of\nthe decimal) counts the time as a fraction of the day. For example,\nJanuary 1st 1900 at noon would be 2.5, 2 because it's 2 days after\nDecember 30st 1899, and .5 because noon is half a day. February 1st\n1900 at 3pm would be 33.625. This correctly treats the year 1900 as\nnot a leap year.",
"Instructs date, time, datetime, and duration fields to be output\nas strings in their given number format (which is dependent\non the spreadsheet locale)."
"description":"The major dimension that results should use.\n\nFor example, if the spreadsheet data is: `A1=1,B1=2,A2=3,B2=4`,\nthen a request that selects that range and sets `majorDimension=ROWS` will\nreturn `[[1,2],[3,4]]`,\nwhereas a request that sets `majorDimension=COLUMNS` will return\n`[[1,3],[2,4]]`.",
"description":"The data filters used to match the ranges of values to retrieve. Ranges\nthat match any of the specified data filters will be included in the\nresponse.",
"type":"array",
"items":{
"$ref":"DataFilter"
}
}
},
"id":"BatchGetValuesByDataFilterRequest",
"description":"The request for retrieving a range of values in a spreadsheet selected by a\nset of DataFilters.",
"type":"object"
},
"DeleteDeveloperMetadataResponse":{
"description":"The response from deleting developer metadata.",
"type":"object",
"properties":{
"deletedDeveloperMetadata":{
"description":"The metadata that was deleted.",
"type":"array",
"items":{
"$ref":"DeveloperMetadata"
}
}
},
"id":"DeleteDeveloperMetadataResponse"
},
"BatchUpdateValuesResponse":{
"id":"BatchUpdateValuesResponse",
"description":"The response when updating a range of values in a spreadsheet.",
"type":"object",
"properties":{
"totalUpdatedSheets":{
"description":"The total number of sheets where at least one cell in the sheet was\nupdated.",
"description":"The protected range to be added. The\nprotectedRangeId field is optional; if\none is not set, an id will be randomly generated. (It is an error to\nspecify the ID of a range that already exists.)"
"description":"The ranges to clear, in A1 notation.",
"type":"array",
"items":{
"type":"string"
}
}
},
"id":"BatchClearValuesRequest",
"description":"The request for clearing more than one range of values in a spreadsheet.",
"type":"object"
},
"DeveloperMetadata":{
"description":"Developer metadata associated with a location or object in a spreadsheet.\nDeveloper metadata may be used to associate arbitrary data with various\nparts of a spreadsheet and will remain associated at those locations as they\nmove around and the spreadsheet is edited. For example, if developer\nmetadata is associated with row 5 and another row is then subsequently\ninserted above row 5, that original metadata will still be associated with\nthe row it was first associated with (what is now row 6). If the associated\nobject is deleted its metadata will be deleted too.",
"description":"The metadata key. There may be multiple metadata in a spreadsheet with the\nsame key. Developer metadata must always have a key specified.",
"description":"The spreadsheet-scoped unique ID that identifies the metadata. IDs may be\nspecified when metadata is created, otherwise one will be randomly\ngenerated and assigned. Must be positive.",
"description":"The spreadsheet after updates were applied. This is only set if\n[BatchUpdateSpreadsheetRequest.include_spreadsheet_in_response] is `true`."
},
"spreadsheetId":{
"description":"The spreadsheet the updates were applied to.",
"description":"The range (in A1 notation) of the table that values are being appended to\n(before the values were appended).\nEmpty if no table was found.",
"description":"The filter to add. The filterViewId\nfield is optional; if one is not set, an id will be randomly generated. (It\nis an error to specify the ID of a filter that already exists.)"
"description":"The zero-based start index of where to move the source data to,\nbased on the coordinates *before* the source data is removed\nfrom the grid. Existing data will be shifted down or right\n(depending on the dimension) to make room for the moved dimensions.\nThe source dimensions are removed from the grid, so the\nthe data may end up in a different index than specified.\n\nFor example, given `A1..A5` of `0, 1, 2, 3, 4` and wanting to move\n`\"1\"` and `\"2\"` to between `\"3\"` and `\"4\"`, the source would be\n`ROWS [1..3)`,and the destination index would be `\"4\"`\n(the zero-based index of row 5).\nThe end result would be `A1..A5` of `0, 3, 1, 2, 4`.",
"description":"The name of the font to use by default for all chart text (e.g. title,\naxis labels, legend). If a font is specified for a specific part of the\nchart it will override this font name.",
"description":"True to make a chart fill the entire space in which it's rendered with\nminimum padding. False to use the default padding.\n(Not applicable to Geo and Org charts.)",
"description":"Pattern string used for formatting. If not set, a default pattern based on\nthe user's locale will be used if necessary for the given type.\nSee the [Date and Number Formats guide](/sheets/api/guides/formats) for more\ninformation about the supported patterns.",
"description":"The data to be written. If the provided values exceed any of the ranges\nmatched by the data filter then the request will fail. If the provided\nvalues are less than the matched ranges only the specified values will be\nwritten, existing values in the matched ranges will remain unaffected.",
"description":"The index of the sheet within the spreadsheet.\nWhen adding or updating sheet properties, if this field\nis excluded then the sheet will be added or moved to the end\nof the sheet list. When updating sheet indices or inserting\nsheets, movement is considered in \"before the move\" indexes.\nFor example, if there were 3 sheets (S1, S2, S3) in order to\nmove S1 ahead of S2 the index would have to be set to 2. A sheet\nindex update request will be ignored if the requested index is\nidentical to the sheets current index or if the requested new\nindex is equal to the current sheet index + 1.",
"description":"True if the sheet is an RTL sheet instead of an LTR sheet.",
"type":"boolean"
},
"hidden":{
"description":"True if the sheet is hidden in the UI, false if it's visible.",
"type":"boolean"
},
"sheetType":{
"enumDescriptions":[
"Default value, do not use.",
"The sheet is a grid.",
"The sheet has no grid and instead has an object like a chart or image."
],
"enum":[
"SHEET_TYPE_UNSPECIFIED",
"GRID",
"OBJECT"
],
"description":"The type of sheet. Defaults to GRID.\nThis field cannot be changed once set.",
"type":"string"
},
"gridProperties":{
"$ref":"GridProperties",
"description":"Additional properties of the sheet if this sheet is a grid.\n(If the sheet is an object sheet, containing a chart or image, then\nthis field will be absent.)\nWhen writing it is an error to set any grid properties on non-grid sheets."
"description":"The fields that should be updated. At least one field must be specified.\nThe root `properties` is implied and should not be specified.\nA single `\"*\"` can be used as short-hand for listing every field.",
"description":"The number of rows or columns that data should be filled into.\nPositive numbers expand beyond the last row or last column\nof the source. Negative numbers expand before the first row\nor first column of the source.",
"description":"The location of the data to use as the source of the autofill."
}
},
"id":"SourceAndDestination"
},
"OrgChartSpec":{
"description":"An \u003ca href=\"/chart/interactive/docs/gallery/orgchart\"\u003eorg chart\u003c/a\u003e.\nOrg charts require a unique set of labels in labels and may\noptionally include parent_labels and tooltips.\nparent_labels contain, for each node, the label identifying the parent\nnode. tooltips contain, for each node, an optional tooltip.\n\nFor example, to describe an OrgChart with Alice as the CEO, Bob as the\nPresident (reporting to Alice) and Cathy as VP of Sales (also reporting to\nAlice), have labels contain \"Alice\", \"Bob\", \"Cathy\",\nparent_labels contain \"\", \"Alice\", \"Alice\" and tooltips contain\n\"CEO\", \"President\", \"VP Sales\".",
"type":"object",
"properties":{
"selectedNodeColor":{
"$ref":"Color",
"description":"The color of the selected org chart nodes."
"description":"The data containing the label of the parent for the corresponding node.\nA blank value indicates that the node has no parent and is a top-level\nnode.\nThis field is optional."
"description":"The data containing the tooltip for the corresponding node. A blank value\nresults in no tooltip being displayed for the node.\nThis field is optional."
"description":"The criteria for showing/hiding values per column.\nThe map's key is the column index, and the value is the criteria for\nthat column.",
"description":"The data filters describing the criteria used to determine which\nDeveloperMetadata entries to return. DeveloperMetadata matching any of the\nspecified filters will be included in the response.",
"description":"The color of the last row or column. If this field is not set, the last\nrow or column will be filled with either first_band_color or\nsecond_band_color, depending on the color of the previous row or\ncolumn.",
"description":"The color of the first row or column. If this field is set, the first\nrow or column will be filled with this color and the colors will\nalternate between first_band_color and second_band_color starting\nfrom the second row or column. Otherwise, the first row or column will be\nfilled with first_band_color and the colors will proceed to alternate\nas they normally would."
"description":"Properties referring a single dimension (either row or column). If both\nBandedRange.row_properties and BandedRange.column_properties are\nset, the fill colors are applied to cells according to the following rules:\n\n* header_color and footer_color take priority over band colors.\n* first_band_color takes priority over second_band_color.\n* row_properties takes priority over column_properties.\n\nFor example, the first row color takes priority over the first column\ncolor, but the first column color takes priority over the second row color.\nSimilarly, the row header takes priority over the column header in the\ntop left cell, but the column header takes priority over the first row\ncolor if the row header is not set.",
"description":"The criteria for showing/hiding values per column.\nThe map's key is the column index, and the value is the criteria for\nthat column.",
"description":"A \u003ca href=\"/chart/interactive/docs/gallery/histogram\"\u003ehistogram chart\u003c/a\u003e.\nA histogram chart groups data items into bins, displaying each bin as a\ncolumn of stacked items. Histograms are used to display the distribution\nof a dataset. Each column of items represents a range into which those\nitems fall. The number of bins can be chosen automatically or specified\nexplicitly.",
"description":"By default the bucket size (the range of values stacked in a single\ncolumn) is chosen automatically, but it may be overridden here.\nE.g., A bucket size of 1.5 results in buckets from 0 - 1.5, 1.5 - 3.0, etc.\nCannot be negative.\nThis field is optional.",
"description":"The outlier percentile is used to ensure that outliers do not adversely\naffect the calculation of bucket sizes. For example, setting an outlier\npercentile of 0.05 indicates that the top and bottom 5% of values when\ncalculating buckets. The values are still included in the chart, they will\nbe added to the first or last buckets instead of their own buckets.\nMust be between 0.0 and 0.5.",
"description":"The series for a histogram may be either a single series of values to be\nbucketed or multiple series, each of the same length, containing the name\nof the series followed by the values to be bucketed for that series.",
"description":"The values of the cells after updates were applied.\nThis is only included if the request's `includeValuesInResponse` field\nwas `true`."
"description":"The column offset of the source range that this value reads from.\n\nFor example, if the source was `C10:E15`, a `sourceColumnOffset` of `0`\nmeans this value refers to column `C`, whereas the offset `1` would\nrefer to column `D`.",
"description":"A function to summarize the value.\nIf formula is set, the only supported values are\nSUM and\nCUSTOM.\nIf sourceColumnOffset is set, then `CUSTOM`\nis not supported."
}
},
"id":"PivotValue"
},
"CopySheetToAnotherSpreadsheetRequest":{
"description":"The request to copy a sheet across spreadsheets.",
"type":"object",
"properties":{
"destinationSpreadsheetId":{
"description":"The ID of the spreadsheet to copy the sheet to.",
"description":"Determines the bucket from which values are chosen to sort.\n\nFor example, in a pivot table with one row group & two column groups,\nthe row group can list up to two values. The first value corresponds\nto a value within the first column group, and the second value\ncorresponds to a value in the second column group. If no values\nare listed, this would indicate that the row should be sorted according\nto the \"Grand Total\" over the column groups. If a single value is listed,\nthis would correspond to using the \"Total\" of that bucket.",
"description":"The domain data (horizontal axis) for the candlestick chart. String data\nwill be treated as discrete labels, other data will be treated as\ncontinuous values.",
"description":"The ranges that were cleared, in A1 notation.\n(If the requests were for an unbounded range or a ranger larger\n than the bounds of the sheet, this will be the actual ranges\n that were cleared, bounded to the sheet's limits.)"
}
},
"id":"BatchClearValuesByDataFilterResponse",
"description":"The response when clearing a range of values selected with\nDataFilters in a spreadsheet."
},
"CandlestickData":{
"properties":{
"highSeries":{
"$ref":"CandlestickSeries",
"description":"The range data (vertical axis) for the high/maximum value for each\ncandle. This is the top of the candle's center line."
"description":"The range data (vertical axis) for the close/final value for each candle.\nThis is the top of the candle body. If greater than the open value the\ncandle will be filled. Otherwise the candle will be hollow.",
"$ref":"CandlestickSeries"
},
"openSeries":{
"$ref":"CandlestickSeries",
"description":"The range data (vertical axis) for the open/initial value for each\ncandle. This is the bottom of the candle body. If less than the close\nvalue the candle will be filled. Otherwise the candle will be hollow."
"description":"Selects DeveloperMetadata that matches all of the specified fields. For\nexample, if only a metadata ID is specified this considers the\nDeveloperMetadata with that particular unique ID. If a metadata key is\nspecified, this considers all developer metadata with that key. If a\nkey, visibility, and location type are all specified, this considers all\ndeveloper metadata with that key and visibility that are associated with a\nlocation of that type. In general, this\nselects all DeveloperMetadata that matches the intersection of all the\nspecified fields; any field or combination of fields may be specified.",
"Document-visible metadata is accessible from any developer project with\naccess to the document.",
"Project-visible metadata is only visible to and accessible by the developer\nproject that created the metadata."
],
"enum":[
"DEVELOPER_METADATA_VISIBILITY_UNSPECIFIED",
"DOCUMENT",
"PROJECT"
],
"description":"Limits the selected developer metadata to that which has a matching\nDeveloperMetadata.visibility. If left unspecified, all developer\nmetadata visibile to the requesting project is considered."
"Indicates that a specified location should be matched exactly. For\nexample, if row three were specified as a location this matching strategy\nwould only match developer metadata also associated on row three. Metadata\nassociated on other locations would not be considered.",
"Indicates that a specified location should match that exact location as\nwell as any intersecting locations. For example, if row three were\nspecified as a location this matching strategy would match developer\nmetadata associated on row three as well as metadata associated on\nlocations that intersect row three. If, for instance, there was developer\nmetadata associated on column B, this matching strategy would also match\nthat location because column B intersects row three."
"description":"Determines how this lookup matches the location. If this field is\nspecified as EXACT, only developer metadata associated on the exact\nlocation specified is matched. If this field is specified to INTERSECTING,\ndeveloper metadata associated on intersecting locations is also\nmatched. If left unspecified, this field assumes a default value of\nINTERSECTING.\nIf this field is specified, a metadataLocation\nmust also be specified.",
"description":"Limits the selected developer metadata to those entries associated with\nthe specified location. This field either matches exact locations or all\nintersecting locations according the specified\nlocationMatchingStrategy."
"Developer metadata associated on an entire row dimension.",
"Developer metadata associated on an entire column dimension.",
"Developer metadata associated on an entire sheet.",
"Developer metadata associated on the entire spreadsheet."
],
"enum":[
"DEVELOPER_METADATA_LOCATION_TYPE_UNSPECIFIED",
"ROW",
"COLUMN",
"SHEET",
"SPREADSHEET"
],
"description":"Limits the selected developer metadata to those entries which are\nassociated with locations of the specified type. For example, when this\nfield is specified as ROW this lookup\nonly considers developer metadata associated on rows. If the field is left\nunspecified, all location types are considered. This field cannot be\nspecified as SPREADSHEET when\nthe locationMatchingStrategy\nis specified as INTERSECTING or when the\nmetadataLocation is specified as a\nnon-spreadsheet location: spreadsheet metadata cannot intersect any other\ndeveloper metadata location. This field also must be left unspecified when\nthe locationMatchingStrategy\nis specified as EXACT.",
"description":"True if we should generate data with the \"alternate\" series.\nThis differs based on the type and amount of source data.",
"type":"boolean"
},
"sourceAndDestination":{
"description":"The source and destination areas to autofill.\nThis explicitly lists the source of the autofill and where to\nextend that data.",
"$ref":"SourceAndDestination"
},
"range":{
"description":"The range to autofill. This will examine the range and detect\nthe location that has data and automatically fill that data\nin to the rest of the range.",
"description":"A rule that applies a gradient color scale format, based on\nthe interpolation points listed. The format of a cell will vary\nbased on its contents as compared to the values of the interpolation\npoints.",
"description":"A single interpolation point on a gradient conditional format.\nThese pin the gradient color scale according to the color,\ntype and value chosen.",
"description":"How the value should be interpreted.",
"type":"string",
"enumDescriptions":[
"The default value, do not use.",
"The interpolation point will use the minimum value in the\ncells over the range of the conditional format.",
"The interpolation point will use the maximum value in the\ncells over the range of the conditional format.",
"The interpolation point will use exactly the value in\nInterpolationPoint.value.",
"The interpolation point will be the given percentage over\nall the cells in the range of the conditional format.\nThis is equivalent to NUMBER if the value was:\n`=(MAX(FLATTEN(range)) * (value / 100))\n + (MIN(FLATTEN(range)) * (1 - (value / 100)))`\n(where errors in the range are ignored when flattening).",
"The interpolation point will be the given percentile\nover all the cells in the range of the conditional format.\nThis is equivalent to NUMBER if the value was:\n`=PERCENTILE(FLATTEN(range), value / 100)`\n(where errors in the range are ignored when flattening)."
"description":"The number of non-formula cells changed.",
"format":"int32"
},
"occurrencesChanged":{
"description":"The number of occurrences (possibly multiple within a cell) changed.\nFor example, if replacing `\"e\"` with `\"o\"` in `\"Google Sheets\"`, this would\nbe `\"3\"` because `\"Google Sheets\"` -\u003e `\"Googlo Shoots\"`.",
"description":"The values of the cells in the range matched by the dataFilter after all\nupdates were applied. This is only included if the request's\n`includeValuesInResponse` field was `true`."
"description":"Represents the row or column when metadata is associated with\na dimension. The specified DimensionRange must represent a single row\nor column; it cannot be unbounded or span multiple rows or columns.",
"description":"The old index of the rule. Not set if a rule was replaced\n(because it is the same as new_index).",
"format":"int32",
"type":"integer"
},
"newRule":{
"$ref":"ConditionalFormatRule",
"description":"The new rule that replaced the old rule (if replacing),\nor the rule that was moved (if moved)"
}
},
"id":"UpdateConditionalFormatRuleResponse"
},
"ConditionValue":{
"description":"The value of the condition.",
"type":"object",
"properties":{
"relativeDate":{
"description":"A relative date (based on the current date).\nValid only if the type is\nDATE_BEFORE,\nDATE_AFTER,\nDATE_ON_OR_BEFORE or\nDATE_ON_OR_AFTER.\n\nRelative dates are not supported in data validation.\nThey are supported only in conditional formatting and\nconditional filters.",
"description":"A value the condition is based on.\nThe value will be parsed as if the user typed into a cell.\nFormulas are supported (and must begin with an `=`).",
"description":"If set, the ID of the new sheet. If not set, an ID is chosen.\nIf set, the ID must not conflict with any existing sheet ID.\nIf set, it must be non-negative.",
"description":"Represents a double value.\nNote: Dates, Times and DateTimes are represented as doubles in\n\"serial number\" format.",
"format":"double",
"type":"number"
},
"errorValue":{
"description":"Represents an error.\nThis field is read-only.",
"$ref":"ErrorValue"
},
"stringValue":{
"description":"Represents a string value.\nLeading single quotes are not included. For example, if the user typed\n`'123` into the UI, this would be represented as a `stringValue` of\n`\"123\"`.",
"description":"The chart that should be added to the spreadsheet, including the position\nwhere it should be placed. The chartId\nfield is optional; if one is not set, an id will be randomly generated. (It\nis an error to specify the ID of a chart that already exists.)"
}
},
"id":"AddChartRequest"
},
"BatchClearValuesResponse":{
"id":"BatchClearValuesResponse",
"description":"The response when clearing a range of values in a spreadsheet.",
"type":"object",
"properties":{
"spreadsheetId":{
"description":"The spreadsheet the updates were applied to.",
"description":"The ranges that were cleared, in A1 notation.\n(If the requests were for an unbounded range or a ranger larger\n than the bounds of the sheet, this will be the actual ranges\n that were cleared, bounded to the sheet's limits.)",
"type":"array",
"items":{
"type":"string"
}
}
}
},
"HistogramSeries":{
"properties":{
"barColor":{
"description":"The color of the column representing this series in each bucket.\nThis field is optional.",
"description":"Properties for row bands. These properties will be applied on a row-by-row\nbasis throughout all the rows in the range. At least one of\nrow_properties or column_properties must be specified."
"description":"Properties for column bands. These properties will be applied on a column-\nby-column basis throughout all the columns in the range. At least one of\nrow_properties or column_properties must be specified."
"description":"The fields that should be updated. At least one field must be specified.\nThe root `protectedRange` is implied and should not be specified.\nA single `\"*\"` can be used as short-hand for listing every field.",
"description":"The default format of all cells in the spreadsheet.\nCellData.effectiveFormat will not be set if the\ncell's format is equal to this default format.\nThis field is read-only.",
"description":"The time zone of the spreadsheet, in CLDR format such as\n`America/New_York`. If the time zone isn't recognized, this may\nbe a custom time zone such as `GMT-07:00`.",
"description":"The locale of the spreadsheet in one of the following formats:\n\n* an ISO 639-1 language code such as `en`\n\n* an ISO 639-2 language code such as `fil`, if no 639-1 code exists\n\n* a combination of the ISO language code and country code, such as `en_US`\n\nNote: when updating this field, not all locales/languages are supported.",
"description":"Determines whether and how circular references are resolved with iterative\ncalculation. Absence of this field means that circular references will\nresult in calculation errors."
"description":"The fields that should be updated. At least one field must be specified.\nThe root `cell` is implied and should not be specified.\nA single `\"*\"` can be used as short-hand for listing every field.",
"description":"Updates all cells in the range to the values in the given Cell object.\nOnly the fields listed in the fields field are updated; others are\nunchanged.\n\nIf writing a cell with a formula, the formula's ranges will automatically\nincrement for each field in the range.\nFor example, if writing a cell with formula `=A1` into range B2:C4,\nB2 would be `=A1`, B3 would be `=A2`, B4 would be `=A3`,\nC2 would be `=B1`, C3 would be `=B2`, C4 would be `=B3`.\n\nTo keep the formula's ranges static, use the `$` indicator.\nFor example, use the formula `=$A$1` to prevent both the row and the\ncolumn from incrementing.",
"description":"The dimensions to insert. Both the start and end indexes must be bounded."
},
"inheritFromBefore":{
"description":"Whether dimension properties should be extended from the dimensions\nbefore or after the newly inserted dimensions.\nTrue to inherit from the dimensions before (in which case the start\nindex must be greater than 0), and false to inherit from the dimensions\nafter.\n\nFor example, if row index 0 has red background and row index 1\nhas a green background, then inserting 2 rows at index 1 can inherit\neither the green or red background. If `inheritFromBefore` is true,\nthe two new rows will be red (because the row before the insertion point\nwas red), whereas if `inheritFromBefore` is false, the two new rows will\nbe green (because the row after the insertion point was green).",
"description":"The fields that should be updated. At least one field must be specified.\nThe root 'properties' is implied and should not be specified.\nA single `\"*\"` can be used as short-hand for listing every field.",
"Default input value. This value must not be used.",
"The values the user has entered will not be parsed and will be stored\nas-is.",
"The values will be parsed as if the user typed them into the UI.\nNumbers will stay as numbers, but strings may be converted to numbers,\ndates, etc. following the same rules that are applied when entering\ntext into a cell via the Google Sheets UI."
"description":"Determines how dates, times, and durations in the response should be\nrendered. This is ignored if response_value_render_option is\nFORMATTED_VALUE.\nThe default dateTime render option is\nDateTimeRenderOption.SERIAL_NUMBER.",
"Instructs date, time, datetime, and duration fields to be output\nas doubles in \"serial number\" format, as popularized by Lotus 1-2-3.\nThe whole number portion of the value (left of the decimal) counts\nthe days since December 30th 1899. The fractional portion (right of\nthe decimal) counts the time as a fraction of the day. For example,\nJanuary 1st 1900 at noon would be 2.5, 2 because it's 2 days after\nDecember 30st 1899, and .5 because noon is half a day. February 1st\n1900 at 3pm would be 33.625. This correctly treats the year 1900 as\nnot a leap year.",
"Instructs date, time, datetime, and duration fields to be output\nas strings in their given number format (which is dependent\non the spreadsheet locale)."
"Values will be calculated & formatted in the reply according to the\ncell's formatting. Formatting is based on the spreadsheet's locale,\nnot the requesting user's locale.\nFor example, if `A1` is `1.23` and `A2` is `=A1` and formatted as currency,\nthen `A2` would return `\"$1.23\"`.",
"Values will be calculated, but not formatted in the reply.\nFor example, if `A1` is `1.23` and `A2` is `=A1` and formatted as currency,\nthen `A2` would return the number `1.23`.",
"Values will not be calculated. The reply will include the formulas.\nFor example, if `A1` is `1.23` and `A2` is `=A1` and formatted as currency,\nthen A2 would return `\"=A1\"`."
],
"enum":[
"FORMATTED_VALUE",
"UNFORMATTED_VALUE",
"FORMULA"
],
"description":"Determines how values in the response should be rendered.\nThe default render option is ValueRenderOption.FORMATTED_VALUE."
"description":"Determines if the update response should include the values\nof the cells that were updated. By default, responses\ndo not include the updated values. The `updatedData` field within\neach of the BatchUpdateValuesResponse.responses will contain\nthe updated values. If the range to write was larger than than the range\nactually written, the response will include all values in the requested\nrange (excluding trailing empty rows and columns).",
"description":"The users and groups with edit access to the protected range.\nThis field is only visible to users with edit access to the protected\nrange and the document.\nEditors are not supported with warning_only protection.",
"$ref":"Editors"
},
"range":{
"$ref":"GridRange",
"description":"The range that is being protected.\nThe range may be fully unbounded, in which case this is considered\na protected sheet.\n\nWhen writing, only one of range or named_range_id\nmay be set."
},
"description":{
"description":"The description of this protected range.",
"type":"string"
},
"unprotectedRanges":{
"description":"The list of unprotected ranges within a protected sheet.\nUnprotected ranges are only supported on protected sheets.",
"description":"The named range this protected range is backed by, if any.\n\nWhen writing, only one of range or named_range_id\nmay be set.",
"type":"string"
},
"protectedRangeId":{
"type":"integer",
"description":"The ID of the protected range.\nThis field is read-only.",
"format":"int32"
},
"warningOnly":{
"description":"True if this protected range will show a warning when editing.\nWarning-based protection means that every user can edit data in the\nprotected range, except editing will prompt a warning asking the user\nto confirm the edit.\n\nWhen writing: if this field is true, then editors is ignored.\nAdditionally, if this field is changed from true to false and the\n`editors` field is not set (nor included in the field mask), then\nthe editors will be set to all the editors in the document.",
"type":"boolean"
},
"requestingUserCanEdit":{
"description":"True if the user who requested this protected range can edit the\nprotected area.\nThis field is read-only.",
"description":"A range along a single dimension on a sheet.\nAll indexes are zero-based.\nIndexes are half open: the start index is inclusive\nand the end index is exclusive.\nMissing indexes indicate the range is unbounded on that side.",
"description":"The minor axis that will specify the range of values for this series.\nFor example, if charting stocks over time, the \"Volume\" series\nmay want to be pinned to the right with the prices pinned to the left,\nbecause the scale of trading volume is different than the scale of\nprices.\nIt is an error to specify an axis that isn't a valid minor axis\nfor the chart's type.",
"type":"string",
"enumDescriptions":[
"Default value, do not use.",
"The axis rendered at the bottom of a chart.\nFor most charts, this is the standard major axis.\nFor bar charts, this is a minor axis.",
"The axis rendered at the left of a chart.\nFor most charts, this is a minor axis.\nFor bar charts, this is the standard major axis.",
"The axis rendered at the right of a chart.\nFor most charts, this is a minor axis.\nFor bar charts, this is an unusual major axis."
"description":"The type of this series. Valid only if the\nchartType is\nCOMBO.\nDifferent types will change the way the series is visualized.\nOnly LINE, AREA,\nand COLUMN are supported.",
"description":"A single series of data in a chart.\nFor example, if charting stock prices over time, multiple series may exist,\none for the \"Open Price\", \"High Price\", \"Low Price\" and \"Close Price\".",
"description":"Updates the borders of a range.\nIf a field is not set in the request, that means the border remains as-is.\nFor example, with two subsequent UpdateBordersRequest:\n\n 1. range: A1:A5 `{ top: RED, bottom: WHITE }`\n 2. range: A1:A5 `{ left: BLUE }`\n\nThat would result in A1:A5 having a borders of\n`{ top: RED, bottom: WHITE, left: BLUE }`.\nIf you want to clear a border, explicitly set the style to\nNONE.",
"description":"Applies one or more updates to the spreadsheet.\n\nEach request is validated before\nbeing applied. If any request is not valid then the entire request will\nfail and nothing will be applied.\n\nSome requests have replies to\ngive you some information about how\nthey are applied. The replies will mirror the requests. For example,\nif you applied 4 updates and the 3rd one had a reply, then the\nresponse will have 2 empty replies, the actual reply, and another empty\nreply, in that order.\n\nDue to the collaborative nature of spreadsheets, it is not guaranteed that\nthe spreadsheet will reflect exactly your changes after this completes,\nhowever it is guaranteed that the updates in the request will be\napplied together atomically. Your changes may be altered with respect to\ncollaborator changes. If there are no collaborators, the spreadsheet\nshould reflect your changes.",
"httpMethod":"POST",
"parameterOrder":[
"spreadsheetId"
],
"response":{
"$ref":"BatchUpdateSpreadsheetResponse"
},
"parameters":{
"spreadsheetId":{
"description":"The spreadsheet to apply the updates to.",
"description":"Returns the spreadsheet at the given ID.\nThe caller must specify the spreadsheet ID.\n\nBy default, data within grids will not be returned.\nYou can include grid data one of two ways:\n\n* Specify a field mask listing your desired fields using the `fields` URL\nparameter in HTTP\n\n* Set the includeGridData\nURL parameter to true. If a field mask is set, the `includeGridData`\nparameter is ignored\n\nFor large spreadsheets, it is recommended to retrieve only the specific\nfields of the spreadsheet that you want.\n\nTo retrieve only subsets of the spreadsheet, use the\nranges URL parameter.\nMultiple ranges can be specified. Limiting the range will\nreturn only the portions of the spreadsheet that intersect the requested\nranges. Ranges are specified using A1 notation.",
"response":{
"$ref":"Spreadsheet"
},
"parameterOrder":[
"spreadsheetId"
],
"httpMethod":"GET",
"parameters":{
"ranges":{
"description":"The ranges to retrieve from the spreadsheet.",
"type":"string",
"repeated":true,
"location":"query"
},
"includeGridData":{
"description":"True if grid data should be returned.\nThis parameter is ignored if a field mask was set in the request.",
"description":"Returns the spreadsheet at the given ID.\nThe caller must specify the spreadsheet ID.\n\nThis method differs from GetSpreadsheet in that it allows selecting\nwhich subsets of spreadsheet data to return by specifying a\ndataFilters parameter.\nMultiple DataFilters can be specified. Specifying one or\nmore data filters will return the portions of the spreadsheet that\nintersect ranges matched by any of the filters.\n\nBy default, data within grids will not be returned.\nYou can include grid data one of two ways:\n\n* Specify a field mask listing your desired fields using the `fields` URL\nparameter in HTTP\n\n* Set the includeGridData\nparameter to true. If a field mask is set, the `includeGridData`\nparameter is ignored\n\nFor large spreadsheets, it is recommended to retrieve only the specific\nfields of the spreadsheet that you want."
"description":"Returns all developer metadata matching the specified DataFilter.\nIf the provided DataFilter represents a DeveloperMetadataLookup object,\nthis will return all DeveloperMetadata entries selected by it. If the\nDataFilter represents a location in a spreadsheet, this will return all\ndeveloper metadata associated with locations intersecting that region.",
"request":{
"$ref":"SearchDeveloperMetadataRequest"
},
"httpMethod":"POST",
"parameterOrder":[
"spreadsheetId"
],
"response":{
"$ref":"SearchDeveloperMetadataResponse"
},
"scopes":[
"https://www.googleapis.com/auth/drive",
"https://www.googleapis.com/auth/drive.file",
"https://www.googleapis.com/auth/spreadsheets"
],
"parameters":{
"spreadsheetId":{
"required":true,
"type":"string",
"location":"path",
"description":"The ID of the spreadsheet to retrieve metadata from."
"description":"Returns the developer metadata with the specified ID.\nThe caller must specify the spreadsheet ID and the developer metadata's\nunique metadataId.",
"response":{
"$ref":"DeveloperMetadata"
},
"parameterOrder":[
"spreadsheetId",
"metadataId"
],
"httpMethod":"GET",
"scopes":[
"https://www.googleapis.com/auth/drive",
"https://www.googleapis.com/auth/drive.file",
"https://www.googleapis.com/auth/spreadsheets"
],
"parameters":{
"metadataId":{
"location":"path",
"description":"The ID of the developer metadata to retrieve.",
"format":"int32",
"required":true,
"type":"integer"
},
"spreadsheetId":{
"location":"path",
"description":"The ID of the spreadsheet to retrieve metadata from.",
"description":"Appends values to a spreadsheet. The input range is used to search for\nexisting data and find a \"table\" within that range. Values will be\nappended to the next row of the table, starting with the first column of\nthe table. See the\n[guide](/sheets/api/guides/values#appending_values)\nand\n[sample code](/sheets/api/samples/writing#append_values)\nfor specific details of how tables are detected and data is appended.\n\nThe caller must specify the spreadsheet ID, range, and\na valueInputOption. The `valueInputOption` only\ncontrols how the input data will be added to the sheet (column-wise or\nrow-wise), it does not influence what cell the data starts being written\nto.",
"request":{
"$ref":"ValueRange"
},
"response":{
"$ref":"AppendValuesResponse"
},
"parameterOrder":[
"spreadsheetId",
"range"
],
"httpMethod":"POST",
"scopes":[
"https://www.googleapis.com/auth/drive",
"https://www.googleapis.com/auth/drive.file",
"https://www.googleapis.com/auth/spreadsheets"
],
"parameters":{
"range":{
"description":"The A1 notation of a range to search for a logical table of data.\nValues will be appended after the last row of the table.",
"required":true,
"type":"string",
"location":"path"
},
"includeValuesInResponse":{
"type":"boolean",
"location":"query",
"description":"Determines if the update response should include the values\nof the cells that were appended. By default, responses\ndo not include the updated values."
},
"spreadsheetId":{
"location":"path",
"description":"The ID of the spreadsheet to update.",
"required":true,
"type":"string"
},
"responseValueRenderOption":{
"location":"query",
"enum":[
"FORMATTED_VALUE",
"UNFORMATTED_VALUE",
"FORMULA"
],
"description":"Determines how values in the response should be rendered.\nThe default render option is ValueRenderOption.FORMATTED_VALUE.",
"type":"string"
},
"insertDataOption":{
"location":"query",
"enum":[
"OVERWRITE",
"INSERT_ROWS"
],
"description":"How the input data should be inserted.",
"type":"string"
},
"valueInputOption":{
"description":"How the input data should be interpreted.",
"type":"string",
"location":"query",
"enum":[
"INPUT_VALUE_OPTION_UNSPECIFIED",
"RAW",
"USER_ENTERED"
]
},
"responseDateTimeRenderOption":{
"location":"query",
"enum":[
"SERIAL_NUMBER",
"FORMATTED_STRING"
],
"description":"Determines how dates, times, and durations in the response should be\nrendered. This is ignored if response_value_render_option is\nFORMATTED_VALUE.\nThe default dateTime render option is [DateTimeRenderOption.SERIAL_NUMBER].",
"description":"Returns one or more ranges of values that match the specified data filters.\nThe caller must specify the spreadsheet ID and one or more\nDataFilters. Ranges that match any of the data filters in\nthe request will be returned.",
"request":{
"$ref":"BatchGetValuesByDataFilterRequest"
},
"response":{
"$ref":"BatchGetValuesByDataFilterResponse"
},
"parameterOrder":[
"spreadsheetId"
],
"httpMethod":"POST",
"scopes":[
"https://www.googleapis.com/auth/drive",
"https://www.googleapis.com/auth/drive.file",
"https://www.googleapis.com/auth/spreadsheets"
],
"parameters":{
"spreadsheetId":{
"location":"path",
"description":"The ID of the spreadsheet to retrieve data from.",
"description":"Clears one or more ranges of values from a spreadsheet.\nThe caller must specify the spreadsheet ID and one or more ranges.\nOnly values are cleared -- all other properties of the cell (such as\nformatting, data validation, etc..) are kept."
},
"get":{
"response":{
"$ref":"ValueRange"
},
"parameterOrder":[
"spreadsheetId",
"range"
],
"httpMethod":"GET",
"parameters":{
"range":{
"location":"path",
"description":"The A1 notation of the values to retrieve.",
"required":true,
"type":"string"
},
"valueRenderOption":{
"description":"How values should be represented in the output.\nThe default render option is ValueRenderOption.FORMATTED_VALUE.",
"type":"string",
"location":"query",
"enum":[
"FORMATTED_VALUE",
"UNFORMATTED_VALUE",
"FORMULA"
]
},
"dateTimeRenderOption":{
"location":"query",
"enum":[
"SERIAL_NUMBER",
"FORMATTED_STRING"
],
"description":"How dates, times, and durations should be represented in the output.\nThis is ignored if value_render_option is\nFORMATTED_VALUE.\nThe default dateTime render option is [DateTimeRenderOption.SERIAL_NUMBER].",
"type":"string"
},
"majorDimension":{
"enum":[
"DIMENSION_UNSPECIFIED",
"ROWS",
"COLUMNS"
],
"description":"The major dimension that results should use.\n\nFor example, if the spreadsheet data is: `A1=1,B1=2,A2=3,B2=4`,\nthen requesting `range=A1:B2,majorDimension=ROWS` will return\n`[[1,2],[3,4]]`,\nwhereas requesting `range=A1:B2,majorDimension=COLUMNS` will return\n`[[1,3],[2,4]]`.",
"type":"string",
"location":"query"
},
"spreadsheetId":{
"location":"path",
"description":"The ID of the spreadsheet to retrieve data from.",
"description":"Sets values in one or more ranges of a spreadsheet.\nThe caller must specify the spreadsheet ID,\na valueInputOption, and one or more\nDataFilterValueRanges.",
"httpMethod":"POST",
"parameterOrder":[
"spreadsheetId"
],
"response":{
"$ref":"BatchUpdateValuesByDataFilterResponse"
},
"parameters":{
"spreadsheetId":{
"description":"The ID of the spreadsheet to update.",
"required":true,
"type":"string",
"location":"path"
}
},
"scopes":[
"https://www.googleapis.com/auth/drive",
"https://www.googleapis.com/auth/drive.file",
"https://www.googleapis.com/auth/spreadsheets"
]
},
"update":{
"description":"Sets values in a range of a spreadsheet.\nThe caller must specify the spreadsheet ID, range, and\na valueInputOption.",
"request":{
"$ref":"ValueRange"
},
"response":{
"$ref":"UpdateValuesResponse"
},
"parameterOrder":[
"spreadsheetId",
"range"
],
"httpMethod":"PUT",
"scopes":[
"https://www.googleapis.com/auth/drive",
"https://www.googleapis.com/auth/drive.file",
"https://www.googleapis.com/auth/spreadsheets"
],
"parameters":{
"spreadsheetId":{
"location":"path",
"description":"The ID of the spreadsheet to update.",
"required":true,
"type":"string"
},
"responseValueRenderOption":{
"description":"Determines how values in the response should be rendered.\nThe default render option is ValueRenderOption.FORMATTED_VALUE.",
"type":"string",
"location":"query",
"enum":[
"FORMATTED_VALUE",
"UNFORMATTED_VALUE",
"FORMULA"
]
},
"valueInputOption":{
"type":"string",
"location":"query",
"enum":[
"INPUT_VALUE_OPTION_UNSPECIFIED",
"RAW",
"USER_ENTERED"
],
"description":"How the input data should be interpreted."
},
"responseDateTimeRenderOption":{
"location":"query",
"enum":[
"SERIAL_NUMBER",
"FORMATTED_STRING"
],
"description":"Determines how dates, times, and durations in the response should be\nrendered. This is ignored if response_value_render_option is\nFORMATTED_VALUE.\nThe default dateTime render option is [DateTimeRenderOption.SERIAL_NUMBER].",
"type":"string"
},
"includeValuesInResponse":{
"location":"query",
"description":"Determines if the update response should include the values\nof the cells that were updated. By default, responses\ndo not include the updated values.\nIf the range to write was larger than than the range actually written,\nthe response will include all values in the requested range (excluding\ntrailing empty rows and columns).",
"type":"boolean"
},
"range":{
"description":"The A1 notation of the values to update.",
"description":"Sets values in one or more ranges of a spreadsheet.\nThe caller must specify the spreadsheet ID,\na valueInputOption, and one or more\nValueRanges.",
"httpMethod":"POST",
"parameterOrder":[
"spreadsheetId"
],
"response":{
"$ref":"BatchUpdateValuesResponse"
},
"parameters":{
"spreadsheetId":{
"location":"path",
"description":"The ID of the spreadsheet to update.",
"required":true,
"type":"string"
}
},
"scopes":[
"https://www.googleapis.com/auth/drive",
"https://www.googleapis.com/auth/drive.file",
"https://www.googleapis.com/auth/spreadsheets"
]
},
"clear":{
"httpMethod":"POST",
"parameterOrder":[
"spreadsheetId",
"range"
],
"response":{
"$ref":"ClearValuesResponse"
},
"scopes":[
"https://www.googleapis.com/auth/drive",
"https://www.googleapis.com/auth/drive.file",
"https://www.googleapis.com/auth/spreadsheets"
],
"parameters":{
"range":{
"description":"The A1 notation of the values to clear.",
"required":true,
"type":"string",
"location":"path"
},
"spreadsheetId":{
"description":"The ID of the spreadsheet to update.",
"description":"Clears values from a spreadsheet.\nThe caller must specify the spreadsheet ID and range.\nOnly values are cleared -- all other properties of the cell (such as\nformatting, data validation, etc..) are kept.",
"request":{
"$ref":"ClearValuesRequest"
}
},
"batchGet":{
"description":"Returns one or more ranges of values from a spreadsheet.\nThe caller must specify the spreadsheet ID and one or more ranges.",
"description":"The ID of the spreadsheet to retrieve data from.",
"required":true,
"type":"string"
},
"valueRenderOption":{
"location":"query",
"enum":[
"FORMATTED_VALUE",
"UNFORMATTED_VALUE",
"FORMULA"
],
"description":"How values should be represented in the output.\nThe default render option is ValueRenderOption.FORMATTED_VALUE.",
"type":"string"
},
"dateTimeRenderOption":{
"location":"query",
"enum":[
"SERIAL_NUMBER",
"FORMATTED_STRING"
],
"description":"How dates, times, and durations should be represented in the output.\nThis is ignored if value_render_option is\nFORMATTED_VALUE.\nThe default dateTime render option is [DateTimeRenderOption.SERIAL_NUMBER].",
"type":"string"
},
"ranges":{
"description":"The A1 notation of the values to retrieve.",
"type":"string",
"repeated":true,
"location":"query"
},
"majorDimension":{
"enum":[
"DIMENSION_UNSPECIFIED",
"ROWS",
"COLUMNS"
],
"description":"The major dimension that results should use.\n\nFor example, if the spreadsheet data is: `A1=1,B1=2,A2=3,B2=4`,\nthen requesting `range=A1:B2,majorDimension=ROWS` will return\n`[[1,2],[3,4]]`,\nwhereas requesting `range=A1:B2,majorDimension=COLUMNS` will return\n`[[1,3],[2,4]]`.",
"description":"Clears one or more ranges of values from a spreadsheet.\nThe caller must specify the spreadsheet ID and one or more\nDataFilters. Ranges matching any of the specified data\nfilters will be cleared. Only values are cleared -- all other properties\nof the cell (such as formatting, data validation, etc..) are kept.",
"request":{
"$ref":"BatchClearValuesByDataFilterRequest"
},
"response":{
"$ref":"BatchClearValuesByDataFilterResponse"
},
"parameterOrder":[
"spreadsheetId"
],
"httpMethod":"POST",
"scopes":[
"https://www.googleapis.com/auth/drive",
"https://www.googleapis.com/auth/drive.file",
"https://www.googleapis.com/auth/spreadsheets"
],
"parameters":{
"spreadsheetId":{
"location":"path",
"description":"The ID of the spreadsheet to update.",
"description":"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."
"description":"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.",
