diff --git a/NAMESPACE b/NAMESPACE
index 54fea664a..aef9ffa92 100644
--- a/NAMESPACE
+++ b/NAMESPACE
@@ -1,18 +1,22 @@
 # Generated by roxygen2: do not edit by hand
 
+S3method(as_Sheet,data.frame)
 S3method(as_sheets_id,"NULL")
 S3method(as_sheets_id,character)
 S3method(as_sheets_id,default)
 S3method(as_sheets_id,dribble)
 S3method(as_sheets_id,drive_id)
+S3method(as_sheets_id,sheets_Spreadsheet)
 S3method(as_sheets_id,sheets_id)
 S3method(ctype,"NULL")
 S3method(ctype,SHEETS_CELL)
 S3method(ctype,character)
 S3method(ctype,default)
 S3method(ctype,list)
-S3method(format,sheets_meta)
-S3method(print,sheets_meta)
+S3method(format,sheets_Spreadsheet)
+S3method(print,sheets_Spreadsheet)
+S3method(tibblify,googlesheets4_Sheet)
+S3method(tibblify,googlesheets4_SheetProperties)
 export("%>%")
 export(anchored)
 export(as_sheets_id)
@@ -27,6 +31,7 @@ export(sheets_auth)
 export(sheets_auth_configure)
 export(sheets_browse)
 export(sheets_cells)
+export(sheets_create)
 export(sheets_deauth)
 export(sheets_endpoints)
 export(sheets_example)
@@ -52,6 +57,7 @@ importFrom(purrr,"%||%")
 importFrom(purrr,compact)
 importFrom(purrr,discard)
 importFrom(purrr,flatten)
+importFrom(purrr,imap)
 importFrom(purrr,keep)
 importFrom(purrr,map)
 importFrom(purrr,map2)
@@ -63,4 +69,5 @@ importFrom(purrr,modify_if)
 importFrom(purrr,pluck)
 importFrom(purrr,pmap_chr)
 importFrom(purrr,set_names)
+importFrom(purrr,transpose)
 importFrom(purrr,walk)
diff --git a/NEWS.md b/NEWS.md
index 761207c06..4937ab2a4 100644
--- a/NEWS.md
+++ b/NEWS.md
@@ -1,5 +1,7 @@
 # googlesheets4 (development version)
 
+* `sheets_create()` is a new function to create a new Sheet and, optionally, write one or more data frames into it (#61). *caution: function still under development*
+
 # googlesheets4 0.1.0
 
 * Added a `NEWS.md` file to track changes to the package.
diff --git a/R/googlesheets4-package.R b/R/googlesheets4-package.R
index 9b9b6994b..bb2b05c1f 100644
--- a/R/googlesheets4-package.R
+++ b/R/googlesheets4-package.R
@@ -1,4 +1,4 @@
 #' @keywords internal
 #' @importFrom purrr %||% map_lgl map_int map_dbl map_chr map map2 pluck walk
-#'   pmap_chr set_names discard keep flatten modify_if compact
+#'   pmap_chr set_names discard keep flatten modify_if compact transpose imap
 "_PACKAGE"
diff --git a/R/rectangle.R b/R/rectangle.R
new file mode 100644
index 000000000..17402b463
--- /dev/null
+++ b/R/rectangle.R
@@ -0,0 +1,12 @@
+# low-tech typed version of tidyr::hoist() that is "list in, vector out"
+hoist_lgl <- function(.x, ..., .default = NA) {
+  map_lgl(.x, ..., .default = .default)
+}
+
+hoist_chr <- function(.x, ..., .default = NA) {
+  map_chr(.x, ..., .default = .default)
+}
+
+hoist_int <- function(.x, ..., .default = NA) {
+  map_int(.x, ..., .default = .default)
+}
diff --git a/R/schema_Sheet.R b/R/schema_Sheet.R
new file mode 100644
index 000000000..b60f9edd7
--- /dev/null
+++ b/R/schema_Sheet.R
@@ -0,0 +1,65 @@
+#' @export
+tibblify.googlesheets4_Sheet <- function(x, ...) {
+  out <- tibblify(new("SheetProperties", !!!x$properties))
+  # TODO: come back to deal with `data`
+  tibble::add_column(out, data = list(NULL))
+}
+
+as_Sheet <- function(df, name) {
+  UseMethod("as_Sheet")
+}
+
+as_Sheet.default <- function(df, name) {
+  stop_glue(
+    "Don't know how to make an instance of {bt('Sheet')} from something of ",
+    "class {class_collapse(x)}."
+  )
+}
+
+#' @export
+as_Sheet.data.frame <- function(df, name) {
+  check_string(name)
+  x <- new(
+    id = "Sheet",
+    properties = new(
+      id = "SheetProperties",
+      title = name,
+      gridProperties = list(rowCount = nrow(df) + 1, columnCount = ncol(df))
+    ),
+    data = list( # an array of instances of GridData
+      list(
+        rowData = as_RowData(df) # an array of instances of RowData
+      )
+    )
+  )
+}
+
+as_RowData <- function(df) {
+  df_rows <- c(list(names(df)), transpose(df))
+  make_row <- function(x) {
+    map(x, ~ list(userEnteredValue = list(stringValue = as.character(.x))))
+  }
+  map(df_rows, ~ list(values = make_row(unname(.x))))
+  # list(
+  #   list(     # row 1
+  #     values = list(
+  #       list( # row 1 cell 1
+  #         userEnteredValue = list(stringValue = "A1")
+  #       ),
+  #       list( # row 1 cell 2
+  #         userEnteredValue = list(stringValue = "B1")
+  #       )
+  #     )
+  #   ),
+  #   list(   # row 2
+  #     values = list(
+  #       list( # row 2 cell 1
+  #         userEnteredValue = list(stringValue = "A2")
+  #       ),
+  #       list( # row 2 cell 2
+  #         userEnteredValue = list(stringValue = "B2")
+  #       )
+  #     )
+  #   )
+  # )
+}
diff --git a/R/schema_SheetProperties.R b/R/schema_SheetProperties.R
new file mode 100644
index 000000000..891937e6c
--- /dev/null
+++ b/R/schema_SheetProperties.R
@@ -0,0 +1,16 @@
+#' @export
+tibblify.googlesheets4_SheetProperties <- function(x, ...) {
+  # weird-looking workaround for the (current) lack of typed pluck()
+  # revisit this when I depend on vctrs directly
+  x <- list(x)
+  tibble::tibble(
+    # TODO: open question whether I should explicitly unescape title here
+    name         =  hoist_chr(x, "title"),
+    index        =  hoist_int(x, "index"),
+    id           =  hoist_int(x, "sheetId"),
+    type         =  hoist_chr(x, "sheetType"),
+    visible      = !hoist_lgl(x, "hidden", .default = FALSE),
+    grid_rows    =  hoist_int(x, c("gridProperties", "rowCount")),
+    grid_columns =  hoist_int(x, c("gridProperties", "columnCount"))
+  )
+}
diff --git a/R/schema_Spreadsheet.R b/R/schema_Spreadsheet.R
new file mode 100644
index 000000000..a7d07f131
--- /dev/null
+++ b/R/schema_Spreadsheet.R
@@ -0,0 +1,105 @@
+#  input: instance of Spreadsheet, in the Sheets API sense, as a named list
+# output: instance of sheets_Spreadsheet, which is how I want to hold this info
+sheets_Spreadsheet <- function(x = list()) {
+  ours_theirs <- list(
+    spreadsheet_id  = "spreadsheetId",
+    spreadsheet_url = "spreadsheetUrl",
+    name            = list("properties", "title"),
+    locale          = list("properties", "locale"),
+    time_zone       = list("properties", "timeZone")
+  )
+  out <- map(ours_theirs, ~ pluck(x, !!!.x))
+
+  if (!is.null(x$sheets)) {
+    sheets <- map(x$sheets, ~ new("Sheet", !!!.x))
+    sheets <- map(sheets, tibblify)
+    out$sheets <- do.call(rbind, sheets)
+  }
+
+  if (!is.null(x$namedRanges)) {
+    # TODO: refactor in terms of a to-be-created sheets_NamedRange()? changes
+    # the angle of attack to NamedRange-wise, whereas here I work column-wise
+    nr <- x$namedRanges
+    out$named_ranges <- tibble::tibble(
+      name         = map_chr(nr, "name"),
+      range        = NA_character_,
+      id           = map_chr(nr, "namedRangeId"),
+      # if there is only 1 sheet, sheetId might not be sent!
+      # https://github.com/tidyverse/googlesheets4/issues/29
+      sheet_id     = map_chr(nr, c("range", "sheetId"), .default = NA),
+      sheet_name   = NA_character_,
+      # TODO: extract into functions re: GridRange?
+      ## API sends zero-based row and column
+      ##   => we add one
+      ## API indices are half-open, i.e. [start, end)
+      ##   => we substract one from end_[row|column]
+      ## net effect
+      ##   => we add one to start_[row|column] but not to end_[row|column]
+      start_row    = map_int(nr, c("range", "startRowIndex"), .default = NA) + 1L,
+      end_row      = map_int(nr, c("range", "endRowIndex"), .default = NA),
+      start_column = map_int(nr, c("range", "startColumnIndex"), .default = NA) + 1L,
+      end_column   = map_int(nr, c("range", "endColumnIndex"), .default = NA)
+    )
+    no_sheet <- is.na(out$named_ranges$sheet_id)
+    if (any(no_sheet)) {
+      # if no associated sheetId, assume it's the first (only?) sheet
+      # https://github.com/tidyverse/googlesheets4/issues/29
+      out$named_ranges$sheet_id[no_sheet] <- out$sheets$id[[1]]
+    }
+    out$named_ranges$sheet_name <- vlookup(
+      out$named_ranges$sheet_id,
+      data = out$sheets,
+      key = "id",
+      value = "name"
+    )
+    out$named_ranges$range <- pmap_chr(out$named_ranges, make_range)
+  }
+
+  structure(out, class = c("sheets_Spreadsheet", "list"))
+}
+
+#' @export
+format.sheets_Spreadsheet <- function(x, ...) {
+
+  meta <- glue_data(
+    x,
+    "
+      Spreadsheet name: {name}
+                    ID: {spreadsheet_id}
+                Locale: {locale}
+             Time zone: {time_zone}
+           # of sheets: {nrow(x$sheets)}
+    ",
+    .sep = "\n"
+  )
+  meta <- strsplit(meta, split = "\n")[[1]]
+
+  col1 <- fr(c("(Sheet name)", x$sheets$name))
+  col2 <- c(
+    "(Nominal extent in rows x columns)",
+    glue_data(x$sheets, "{grid_rows} x {grid_columns}")
+  )
+  meta <- c(
+    meta,
+    "",
+    glue_data(list(col1 = col1, col2 = col2), "{col1}: {col2}")
+  )
+
+  if (!is.null(x$named_ranges)) {
+    col1 <- fr(c("(Named range)", x$named_ranges$name))
+    col2 <- fl(c("(A1 range)", x$named_ranges$range))
+    meta <- c(
+      meta,
+      "",
+      glue_data(list(col1 = col1, col2 = col2), "{col1}: {col2}")
+    )
+  }
+
+  meta
+}
+
+#' @export
+print.sheets_Spreadsheet <- function(x, ...) {
+  cat(format(x), sep = "\n")
+  invisible(x)
+}
diff --git a/R/schemas.R b/R/schemas.R
new file mode 100644
index 000000000..cda91e4ec
--- /dev/null
+++ b/R/schemas.R
@@ -0,0 +1,66 @@
+new <- function(id, ...) {
+  schema <- .tidy_schemas[[id]]
+  if (is.null(schema)) {
+    rlang::abort(glue("Can't find a tidy schema with id {sq(id)}"))
+  }
+  dots <- rlang::list2(...)
+
+  check_against_schema(dots, schema = schema)
+
+  structure(
+    dots,
+    # explicit 'list' class is a bit icky but makes jsonlite happy
+    # in various vctrs futures, this could need revisiting
+    class = c(id_as_class(id), "googlesheets4_schema", "list"),
+    schema = schema
+  )
+}
+
+# TODO: if it proves necessary, this could do more meaningful checks
+check_against_schema <- function(x, schema = NULL) {
+  schema <- schema %||% attr(x, "schema")
+  unexpected <- setdiff(names(x), schema$property)
+  if (length(unexpected) > 0) {
+    msg <- glue("
+    Properties not recognized for the {sq(attr(schema, 'id'))} schema:
+      * {glue_collapse(unexpected, sep = ', ')}
+    ")
+    rlang::abort(msg)
+  }
+  invisible(x)
+}
+
+id_as_class <- function(id) glue("googlesheets4_{id}")
+
+id_from_class <- function(x) {
+  m <- grep("^googlesheets4_", class(x), value = TRUE)[[1]]
+  sub("^googlesheets4_", "", m)
+}
+
+# patch ----
+patch <- function(x, ...) {
+  UseMethod("patch")
+}
+
+patch.default <- function(x, ...) {
+  stop_glue("
+  Don't know how to {bt('patch()')} an object of class {class_collapse(x)}
+  ")
+}
+
+patch.googlesheets4_schema <- function(x, ...) {
+  dots <- rlang::list2(...)
+  x[names(dots)] <- dots
+  check_against_schema(x)
+}
+
+# tibblify ----
+tibblify <- function(x, ...) {
+  UseMethod("tibblify")
+}
+
+tibblify.default <- function(x, ...) {
+  stop_glue("
+    Don't know how to {bt('tibblify()')} an object of class {class_collapse(x)}
+  ")
+}
diff --git a/R/sheets_create.R b/R/sheets_create.R
new file mode 100644
index 000000000..9499958b6
--- /dev/null
+++ b/R/sheets_create.R
@@ -0,0 +1,54 @@
+#' Create a new Sheet
+#'
+#' Creates an entirely new Sheet (spreadsheet or workbook). Offers some control
+#' over the initial set of sheets (worksheets or tabs). CAUTION: this function
+#' is still being developed and, for example, currently sends all data as
+#' character.
+#'
+#' @seealso Wraps the `spreadsheets.create` endpoint:
+#'   * <https://developers.google.com/sheets/api/reference/rest/v4/spreadsheets/create>
+#'
+#' @param name The name of the spreadsheet.
+#' @param ... Optional spreadsheet properties that can be set through this API
+#'   endpoint, such as locale and time zone.
+#' @param sheets Optional named list of data frames. One sheet is created for
+#'   each data frame.
+#'
+#' @inherit sheets_get return
+#' @export
+#'
+#' @examples
+#' if (sheets_has_token()) {
+#'   sheets_create("sheets-create-demo-1")
+#'
+#'   sheets_create("sheets-create-demo-2", locale = "en_CA")
+#'
+#'   sheets_create(
+#'     "sheets-create-demo-3",
+#'     locale = "fr_FR",
+#'     timeZone = "Europe/Paris"
+#'   )
+#'
+#'   sheets_create(
+#'     "sheets-create-demo-4",
+#'     sheets = list(iris = head(iris), mtcars = head(mtcars))
+#'   )
+#' }
+sheets_create <- function(name, ..., sheets = NULL) {
+  ss_body <- new("Spreadsheet") %>%
+    patch(properties = new(
+      id = "SpreadsheetProperties",
+      title = name, ...
+    ))
+  if (!is.null(sheets)) {
+    ss_body <- ss_body %>%
+      patch(sheets = unname(imap(sheets, as_Sheet)))
+  }
+  req <- request_generate(
+    "sheets.spreadsheets.create",
+    params = ss_body
+  )
+  raw_resp <- request_make(req)
+  resp <- gargle::response_process(raw_resp)
+  sheets_Spreadsheet(resp)
+}
diff --git a/R/sheets_get.R b/R/sheets_get.R
index 29018cbd9..113c70c8c 100644
--- a/R/sheets_get.R
+++ b/R/sheets_get.R
@@ -10,7 +10,7 @@
 #' @inheritParams read_sheet
 #'
 #' @return
-#'   * `sheets_get()`: A list with S3 class `sheets_meta`, for printing
+#'   * `sheets_get()`: A list with S3 class `sheets_Spreadsheet`, for printing
 #'     purposes.
 #'   * `sheets_sheets()`: A character vector.
 #' @export
@@ -21,7 +21,7 @@
 #' }
 sheets_get <- function(ss) {
   resp <- sheets_get_impl_(as_sheets_id(ss))
-  sheets_spreadsheet(resp)
+  sheets_Spreadsheet(resp)
 }
 
 #' @export
@@ -50,115 +50,3 @@ sheets_get_impl_ <- function(ssid,
   raw_resp <- request_make(req)
   gargle::response_process(raw_resp)
 }
-
-## input: an instance of Spreadsheet
-## https://developers.google.com/sheets/api/reference/rest/v4/spreadsheets#Spreadsheet
-## output: a list with S3 class `sheets_meta`
-sheets_spreadsheet <- function(x = list()) {
-  ours_theirs <- list(
-    spreadsheet_id  = "spreadsheetId",
-    spreadsheet_url = "spreadsheetUrl",
-    name            = list("properties", "title"),
-    locale          = list("properties", "locale"),
-    time_zone       = list("properties", "timeZone")
-  )
-  out <- map(ours_theirs, ~ pluck(x, !!!.x))
-
-  if (!is.null(x$sheets)) {
-    p <- map(x$sheets, "properties")
-    out$sheets <- tibble::tibble(
-      # TODO: open question whether I should explicitly unescape here
-      name         = map_chr(p, "title"),
-      index        = map_int(p, "index"),
-      id           = map_chr(p, "sheetId"),
-      type         = map_chr(p, "sheetType"),
-      visible      = !map_lgl(p, "hidden", .default = FALSE),
-      grid_rows    = map_int(p, c("gridProperties", "rowCount"), .default = NA),
-      grid_columns = map_int(p, c("gridProperties", "columnCount"), .default = NA)
-    )
-  }
-
-  if (!is.null(x$namedRanges)) {
-    nr <- x$namedRanges
-    out$named_ranges <- tibble::tibble(
-      name         = map_chr(nr, "name"),
-      range        = NA_character_,
-      id           = map_chr(nr, "namedRangeId"),
-      # if there is only 1 sheet, sheetId might not be sent!
-      # https://github.com/tidyverse/googlesheets4/issues/29
-      sheet_id     = map_chr(nr, c("range", "sheetId"), .default = NA),
-      sheet_name   = NA_character_,
-      ## API sends zero-based row and column
-      ##   => we add one
-      ## API indices are half-open, i.e. [start, end)
-      ##   => we substract one from end_[row|column]
-      ## net effect
-      ##   => we add one to start_[row|column] but not to end_[row|column]
-      start_row    = map_int(nr, c("range", "startRowIndex"), .default = NA) + 1L,
-      end_row      = map_int(nr, c("range", "endRowIndex"), .default = NA),
-      start_column = map_int(nr, c("range", "startColumnIndex"), .default = NA) + 1L,
-      end_column   = map_int(nr, c("range", "endColumnIndex"), .default = NA)
-    )
-    no_sheet <- is.na(out$named_ranges$sheet_id)
-    if (any(no_sheet)) {
-      # if no associated sheetId, assume it's the first (only?) sheet
-      # https://github.com/tidyverse/googlesheets4/issues/29
-      out$named_ranges$sheet_id[no_sheet] <- out$sheets$id[[1]]
-    }
-    out$named_ranges$sheet_name <- vlookup(
-      out$named_ranges$sheet_id,
-      data = out$sheets,
-      key = "id",
-      value = "name"
-    )
-    out$named_ranges$range <- purrr::pmap_chr(out$named_ranges, make_range)
-  }
-
-  structure(out, class = c("sheets_meta", "list"))
-}
-
-#' @export
-format.sheets_meta <- function(x, ...) {
-
-  meta <- glue_data(
-    x,
-    "
-      Spreadsheet name: {name}
-                    ID: {spreadsheet_id}
-                Locale: {locale}
-             Time zone: {time_zone}
-           # of sheets: {nrow(x$sheets)}
-    ",
-    .sep = "\n"
-  )
-  meta <- strsplit(meta, split = "\n")[[1]]
-
-  col1 <- fr(c("(Sheet name)", x$sheets$name))
-  col2 <- c(
-    "(Nominal extent in rows x columns)",
-    glue_data(x$sheets, "{grid_rows} x {grid_columns}")
-  )
-  meta <- c(
-    meta,
-    "",
-    glue_data(list(col1 = col1, col2 = col2), "{col1}: {col2}")
-  )
-
-  if (!is.null(x$named_ranges)) {
-    col1 <- fr(c("(Named range)", x$named_ranges$name))
-    col2 <- fl(c("(A1 range)", x$named_ranges$range))
-    meta <- c(
-      meta,
-      "",
-      glue_data(list(col1 = col1, col2 = col2), "{col1}: {col2}")
-    )
-  }
-
-  meta
-}
-
-#' @export
-print.sheets_meta <- function(x, ...) {
-  cat(format(x), sep = "\n")
-  invisible(x)
-}
diff --git a/R/sheets_id.R b/R/sheets_id.R
index d025ae73c..95921c5a7 100644
--- a/R/sheets_id.R
+++ b/R/sheets_id.R
@@ -56,18 +56,24 @@ sheets_id <- function(x) {
 #'   * Spreadsheet id, "a string containing letters, numbers, and some special
 #'   characters", typically 44 characters long, in our experience. Example:
 #'   `1qpyC0XzvTcKT6EISywvqESX3A0MwQoFDE8p-Bll4hps`.
-#'   * A URL, from which we can excavate a spreadsheet or file id. Example: <https://docs.google.com/spreadsheets/d/1BzfL0kZUz1TsI5zxJF1WNF01IxvC67FbOJUiiGMZ_mQ/edit#gid=1150108545>.
+#'   * A URL, from which we can excavate a spreadsheet or file id. Example:
+#'     <https://docs.google.com/spreadsheets/d/1BzfL0kZUz1TsI5zxJF1WNF01IxvC67FbOJUiiGMZ_mQ/edit#gid=1150108545>.
 #'   * A one-row [`dribble`][googledrive::dribble], a "Drive tibble" used by the
-#'   [googledrive] package. In general, a `dribble` can represent several files,
-#'   one row per file. Since googlesheets4 is not vectorized over spreadsheets,
-#'   we are only prepared to accept a one-row `dribble`.
-#'     - [`googledrive::drive_get("YOUR SHEET NAME")`][googledrive::drive_get()]
+#'     [googledrive] package. In general, a `dribble` can represent several
+#'     files, one row per file. Since googlesheets4 is not vectorized over
+#'     spreadsheets, we are only prepared to accept a one-row `dribble`.
+#'     - [`googledrive::drive_get("YOUR_SHEET_NAME")`][googledrive::drive_get()]
 #'     is a great way to look up a Sheet via its name.
+#'     - [`sheets_find("YOUR_SHEET_NAME")`][sheets_find()] is another good way
+#'     to get your hands on a Sheet.
+#'   * Spreadsheet meta data, as returned by, e.g., [sheets_get()]. Literally,
+#'     this is an object of class `sheets_Spreadsheet`.
 #'
 #' @description This is a generic function.
 #'
 #' @param x Something that uniquely identifies a Google Sheet: a [`sheets_id`],
-#'   URL, or [`dribble`][googledrive::dribble].
+#'   a URL, one-row [`dribble`][googledrive::dribble], or a
+#'   `sheets_Spreadsheet`.
 #' @param ... Other arguments passed down to methods. (Not used.)
 #' @export
 #' @examples
@@ -134,6 +140,11 @@ as_sheets_id.character <- function(x, ...) {
   sheets_id(out)
 }
 
+#' @export
+as_sheets_id.sheets_Spreadsheet <- function(x, ...) {
+  new_sheets_id(x$spreadsheet_id)
+}
+
 ## copied from googledrive
 one_id <- function(x) {
   if (!grepl("^http|/", x)) return(x)
diff --git a/R/sysdata.rda b/R/sysdata.rda
index 9cb1e5198..dc5157146 100644
Binary files a/R/sysdata.rda and b/R/sysdata.rda differ
diff --git a/R/utils.R b/R/utils.R
index 0a1edd385..ec06bcd31 100644
--- a/R/utils.R
+++ b/R/utils.R
@@ -1,5 +1,8 @@
 `%NA%` <- function(x, y) if (is.na(x)) y else x
 
+# for development only
+str1 <- function(x, ...) utils::str(x, ..., max.level = 1)
+
 noNA <- Negate(anyNA)
 allNA <- function(x) all(is.na(x))
 notNA <- Negate(is.na)
diff --git a/README.md b/README.md
index 6b53528bf..8e327a1c6 100644
--- a/README.md
+++ b/README.md
@@ -79,13 +79,13 @@ sheets_example("chicken-sheet") %>%
 #> Reading from 'chicken-sheet'
 #> 
 #> # A tibble: 5 x 4
-#>   chicken           breed        sex    motto                              
-#>   <chr>             <chr>        <chr>  <chr>                              
-#> 1 Foghorn Leghorn   Leghorn      roost… That's a joke, ah say, that's a jo…
-#> 2 Chicken Little    unknown      hen    The sky is falling!                
-#> 3 Ginger            Rhode Islan… hen    Listen. We'll either die free chic…
-#> 4 Camilla the Chic… Chantecler   hen    Bawk, buck, ba-gawk.               
-#> 5 Ernie The Giant … Brahma       roost… Put Captain Solo in the cargo hold.
+#>   chicken            breed         sex    motto                                 
+#>   <chr>              <chr>         <chr>  <chr>                                 
+#> 1 Foghorn Leghorn    Leghorn       roost… That's a joke, ah say, that's a joke,…
+#> 2 Chicken Little     unknown       hen    The sky is falling!                   
+#> 3 Ginger             Rhode Island… hen    Listen. We'll either die free chicken…
+#> 4 Camilla the Chick… Chantecler    hen    Bawk, buck, ba-gawk.                  
+#> 5 Ernie The Giant C… Brahma        roost… Put Captain Solo in the cargo hold.
 ```
 
 Read specific cells, from a specific sheet, using an A1-style notation:
@@ -96,19 +96,18 @@ sheets_example("deaths") %>%
 #> Reading from 'deaths'
 #> Range "'arts'!A5:F15"
 #> # A tibble: 10 x 6
-#>    Name  Profession   Age `Has kids` `Date of birth`    
-#>    <chr> <chr>      <dbl> <lgl>      <dttm>             
-#>  1 Davi… musician      69 TRUE       1947-01-08 00:00:00
-#>  2 Carr… actor         60 TRUE       1956-10-21 00:00:00
-#>  3 Chuc… musician      90 TRUE       1926-10-18 00:00:00
-#>  4 Bill… actor         61 TRUE       1955-05-17 00:00:00
-#>  5 Prin… musician      57 TRUE       1958-06-07 00:00:00
-#>  6 Alan… actor         69 FALSE      1946-02-21 00:00:00
-#>  7 Flor… actor         82 TRUE       1934-02-14 00:00:00
-#>  8 Harp… author        89 FALSE      1926-04-28 00:00:00
-#>  9 Zsa … actor         99 TRUE       1917-02-06 00:00:00
-#> 10 Geor… musician      53 FALSE      1963-06-25 00:00:00
-#> # … with 1 more variable: `Date of death` <dttm>
+#>    Name      Profession   Age `Has kids` `Date of birth`     `Date of death`    
+#>    <chr>     <chr>      <dbl> <lgl>      <dttm>              <dttm>             
+#>  1 David Bo… musician      69 TRUE       1947-01-08 00:00:00 2016-01-10 00:00:00
+#>  2 Carrie F… actor         60 TRUE       1956-10-21 00:00:00 2016-12-27 00:00:00
+#>  3 Chuck Be… musician      90 TRUE       1926-10-18 00:00:00 2017-03-18 00:00:00
+#>  4 Bill Pax… actor         61 TRUE       1955-05-17 00:00:00 2017-02-25 00:00:00
+#>  5 Prince    musician      57 TRUE       1958-06-07 00:00:00 2016-04-21 00:00:00
+#>  6 Alan Ric… actor         69 FALSE      1946-02-21 00:00:00 2016-01-14 00:00:00
+#>  7 Florence… actor         82 TRUE       1934-02-14 00:00:00 2016-11-24 00:00:00
+#>  8 Harper L… author        89 FALSE      1926-04-28 00:00:00 2016-02-19 00:00:00
+#>  9 Zsa Zsa … actor         99 TRUE       1917-02-06 00:00:00 2016-12-18 00:00:00
+#> 10 George M… musician      53 FALSE      1963-06-25 00:00:00 2016-12-25 00:00:00
 ```
 
 Read from a named range or region and specify (some of the ) column
@@ -120,18 +119,18 @@ sheets_example("deaths") %>%
 #> Reading from 'deaths'
 #> Range "arts_data"
 #> # A tibble: 10 x 6
-#>    Name         Profession   Age `Has kids` `Date of birth` `Date of death`
-#>    <chr>        <chr>      <int> <lgl>      <date>          <date>         
-#>  1 David Bowie  musician      69 TRUE       1947-01-08      2016-01-10     
-#>  2 Carrie Fish… actor         60 TRUE       1956-10-21      2016-12-27     
-#>  3 Chuck Berry  musician      90 TRUE       1926-10-18      2017-03-18     
-#>  4 Bill Paxton  actor         61 TRUE       1955-05-17      2017-02-25     
-#>  5 Prince       musician      57 TRUE       1958-06-07      2016-04-21     
-#>  6 Alan Rickman actor         69 FALSE      1946-02-21      2016-01-14     
-#>  7 Florence He… actor         82 TRUE       1934-02-14      2016-11-24     
-#>  8 Harper Lee   author        89 FALSE      1926-04-28      2016-02-19     
-#>  9 Zsa Zsa Gáb… actor         99 TRUE       1917-02-06      2016-12-18     
-#> 10 George Mich… musician      53 FALSE      1963-06-25      2016-12-25
+#>    Name              Profession   Age `Has kids` `Date of birth` `Date of death`
+#>    <chr>             <chr>      <int> <lgl>      <date>          <date>         
+#>  1 David Bowie       musician      69 TRUE       1947-01-08      2016-01-10     
+#>  2 Carrie Fisher     actor         60 TRUE       1956-10-21      2016-12-27     
+#>  3 Chuck Berry       musician      90 TRUE       1926-10-18      2017-03-18     
+#>  4 Bill Paxton       actor         61 TRUE       1955-05-17      2017-02-25     
+#>  5 Prince            musician      57 TRUE       1958-06-07      2016-04-21     
+#>  6 Alan Rickman      actor         69 FALSE      1946-02-21      2016-01-14     
+#>  7 Florence Henders… actor         82 TRUE       1934-02-14      2016-11-24     
+#>  8 Harper Lee        author        89 FALSE      1926-04-28      2016-02-19     
+#>  9 Zsa Zsa Gábor     actor         99 TRUE       1917-02-06      2016-12-18     
+#> 10 George Michael    musician      53 FALSE      1963-06-25      2016-12-25
 ```
 
 There are various ways to specify the target Sheet. The simplest, but
@@ -144,13 +143,13 @@ read_sheet(url)
 #> Reading from 'chicken-sheet'
 #> 
 #> # A tibble: 5 x 4
-#>   chicken           breed        sex    motto                              
-#>   <chr>             <chr>        <chr>  <chr>                              
-#> 1 Foghorn Leghorn   Leghorn      roost… That's a joke, ah say, that's a jo…
-#> 2 Chicken Little    unknown      hen    The sky is falling!                
-#> 3 Ginger            Rhode Islan… hen    Listen. We'll either die free chic…
-#> 4 Camilla the Chic… Chantecler   hen    Bawk, buck, ba-gawk.               
-#> 5 Ernie The Giant … Brahma       roost… Put Captain Solo in the cargo hold.
+#>   chicken            breed         sex    motto                                 
+#>   <chr>              <chr>         <chr>  <chr>                                 
+#> 1 Foghorn Leghorn    Leghorn       roost… That's a joke, ah say, that's a joke,…
+#> 2 Chicken Little     unknown       hen    The sky is falling!                   
+#> 3 Ginger             Rhode Island… hen    Listen. We'll either die free chicken…
+#> 4 Camilla the Chick… Chantecler    hen    Bawk, buck, ba-gawk.                  
+#> 5 Ernie The Giant C… Brahma        roost… Put Captain Solo in the cargo hold.
 ```
 
 For more information, see the package website:
diff --git a/data-raw/discovery-doc-prep.R b/data-raw/discovery-doc-prep.R
index d7eb628ae..11f443f21 100644
--- a/data-raw/discovery-doc-prep.R
+++ b/data-raw/discovery-doc-prep.R
@@ -4,6 +4,10 @@ source(
   system.file("discovery-doc-ingest", "ingest-functions.R", package = "gargle")
 )
 
+# if my use of schemas works out well, maybe this will migrate upstream into
+# gargle and join the other ingest helpers
+source(here::here("data-raw", "schema-rectangling.R"))
+
 x <- download_discovery_document("sheets:v4")
 dd <- read_discovery_document(x)
 
@@ -23,4 +27,30 @@ attr(.endpoints, "base_url") <- dd$rootUrl
 # to the "flattened" or "inlined" representation currently in .endpoints
 .schemas <- pluck(dd, "schemas")
 
-usethis::use_data(.endpoints, .schemas, internal = TRUE, overwrite = TRUE)
+these <- c(
+  "Spreadsheet",
+  "SpreadsheetProperties",
+  "Sheet",
+  "SheetProperties",
+  "NamedRange",
+  "GridRange"
+)
+
+.tidy_schemas <- these %>%
+  set_names() %>%
+  map(schema_rectangle)
+# View(.tidy_schemas)
+
+fs::dir_create(here::here("data-raw", "schemas"))
+write_one <- function(data, id) {
+  sink(here::here("data-raw", "schemas", id))
+  cat("#", id, " \n")
+  print(data)
+  sink()
+}
+iwalk(.tidy_schemas, write_one)
+
+usethis::use_data(
+  .endpoints, .schemas, .tidy_schemas,
+  internal = TRUE, overwrite = TRUE
+)
diff --git a/data-raw/schema-rectangling.R b/data-raw/schema-rectangling.R
new file mode 100644
index 000000000..bc4e7ec31
--- /dev/null
+++ b/data-raw/schema-rectangling.R
@@ -0,0 +1,53 @@
+schema_rectangle <- function(s) {
+  if (!"tidyverse" %in% .packages()) {
+    stop("Attach the tidyverse package before using schema_rectangle()")
+  }
+  schema <- pluck(.schemas, s)
+  if (schema$type != "object") {
+    msg <- glue::glue(
+      "Schema must be of type {sq('object')}, not {sq(schema$type)}"
+    )
+    stop(msg)
+  }
+
+  properties <- pluck(schema, "properties")
+  scaffold <- list(
+    description      = "Just a placeholder",
+    type             = "scaffold",
+    "$ref"           = "SCHEMA",
+    items            = list("$ref" = "SCHEMA"),
+    format           = "FORMAT",
+    enum             = letters[1:3],
+    enumDescriptions = LETTERS[1:3]
+  )
+  df <- tibble(properties = c(scaffold = list(scaffold), properties))
+
+  df <- df %>%
+    mutate(property = names(properties)) %>%
+    select(property, everything()) %>%
+    unnest_wider(properties) %>%
+    select(-description) %>%
+    mutate(type = replace_na(type, "object")) %>%
+    rename(instance_of = "$ref")
+
+  # workaround for https://github.com/tidyverse/tidyr/issues/806
+  repair <- function(x) {
+    map_if(x, ~ inherits(.x, "vctrs_unspecified"), ~ vctrs::unspecified(0))
+  }
+  df <- modify_if(df, is_list, repair)
+
+  df <- df %>%
+    hoist(items, array_of = "$ref")
+
+  df <- df %>%
+    mutate(new = map2(enum, enumDescriptions, ~ tibble(enum = .x, enumDesc = .y))) %>%
+    select(-starts_with("enum")) %>%
+    rename(enum = new) %>%
+    mutate(type = if_else(map_lgl(enum, ~ nrow(.x) > 0), "enum", type))
+
+  attr(df, "id") <- s
+
+  df %>%
+    filter(property != "scaffold") %>%
+    arrange(property)
+}
diff --git a/data-raw/schemas/GridRange b/data-raw/schemas/GridRange
new file mode 100644
index 000000000..75126d78b
--- /dev/null
+++ b/data-raw/schemas/GridRange
@@ -0,0 +1,9 @@
+# GridRange  
+# A tibble: 5 x 6
+  property         type    instance_of array_of format enum            
+  <chr>            <chr>   <chr>       <chr>    <chr>  <list>          
+1 endColumnIndex   integer <NA>        <NA>     int32  <tibble [0 × 2]>
+2 endRowIndex      integer <NA>        <NA>     int32  <tibble [0 × 2]>
+3 sheetId          integer <NA>        <NA>     int32  <tibble [0 × 2]>
+4 startColumnIndex integer <NA>        <NA>     int32  <tibble [0 × 2]>
+5 startRowIndex    integer <NA>        <NA>     int32  <tibble [0 × 2]>
diff --git a/data-raw/schemas/NamedRange b/data-raw/schemas/NamedRange
new file mode 100644
index 000000000..20998e7e5
--- /dev/null
+++ b/data-raw/schemas/NamedRange
@@ -0,0 +1,7 @@
+# NamedRange  
+# A tibble: 3 x 6
+  property     type   instance_of array_of format enum            
+  <chr>        <chr>  <chr>       <chr>    <chr>  <list>          
+1 name         string <NA>        <NA>     <NA>   <tibble [0 × 2]>
+2 namedRangeId string <NA>        <NA>     <NA>   <tibble [0 × 2]>
+3 range        object GridRange   <NA>     <NA>   <tibble [0 × 2]>
diff --git a/data-raw/schemas/Sheet b/data-raw/schemas/Sheet
new file mode 100644
index 000000000..805c38818
--- /dev/null
+++ b/data-raw/schemas/Sheet
@@ -0,0 +1,17 @@
+# Sheet  
+# A tibble: 13 x 6
+   property          type   instance_of    array_of            format enum          
+   <chr>             <chr>  <chr>          <chr>               <chr>  <list>        
+ 1 bandedRanges      array  <NA>           BandedRange         <NA>   <tibble [0 × …
+ 2 basicFilter       object BasicFilter    <NA>                <NA>   <tibble [0 × …
+ 3 charts            array  <NA>           EmbeddedChart       <NA>   <tibble [0 × …
+ 4 columnGroups      array  <NA>           DimensionGroup      <NA>   <tibble [0 × …
+ 5 conditionalForma… array  <NA>           ConditionalFormatR… <NA>   <tibble [0 × …
+ 6 data              array  <NA>           GridData            <NA>   <tibble [0 × …
+ 7 developerMetadata array  <NA>           DeveloperMetadata   <NA>   <tibble [0 × …
+ 8 filterViews       array  <NA>           FilterView          <NA>   <tibble [0 × …
+ 9 merges            array  <NA>           GridRange           <NA>   <tibble [0 × …
+10 properties        object SheetProperti… <NA>                <NA>   <tibble [0 × …
+11 protectedRanges   array  <NA>           ProtectedRange      <NA>   <tibble [0 × …
+12 rowGroups         array  <NA>           DimensionGroup      <NA>   <tibble [0 × …
+13 slicers           array  <NA>           Slicer              <NA>   <tibble [0 × …
diff --git a/data-raw/schemas/SheetProperties b/data-raw/schemas/SheetProperties
new file mode 100644
index 000000000..acc8931ae
--- /dev/null
+++ b/data-raw/schemas/SheetProperties
@@ -0,0 +1,12 @@
+# SheetProperties  
+# A tibble: 8 x 6
+  property       type    instance_of    array_of format enum            
+  <chr>          <chr>   <chr>          <chr>    <chr>  <list>          
+1 gridProperties object  GridProperties <NA>     <NA>   <tibble [0 × 2]>
+2 hidden         boolean <NA>           <NA>     <NA>   <tibble [0 × 2]>
+3 index          integer <NA>           <NA>     int32  <tibble [0 × 2]>
+4 rightToLeft    boolean <NA>           <NA>     <NA>   <tibble [0 × 2]>
+5 sheetId        integer <NA>           <NA>     int32  <tibble [0 × 2]>
+6 sheetType      enum    <NA>           <NA>     <NA>   <tibble [3 × 2]>
+7 tabColor       object  Color          <NA>     <NA>   <tibble [0 × 2]>
+8 title          string  <NA>           <NA>     <NA>   <tibble [0 × 2]>
diff --git a/data-raw/schemas/Spreadsheet b/data-raw/schemas/Spreadsheet
new file mode 100644
index 000000000..cc14ecba6
--- /dev/null
+++ b/data-raw/schemas/Spreadsheet
@@ -0,0 +1,10 @@
+# Spreadsheet  
+# A tibble: 6 x 6
+  property         type   instance_of          array_of        format enum          
+  <chr>            <chr>  <chr>                <chr>           <chr>  <list>        
+1 developerMetada… array  <NA>                 DeveloperMetad… <NA>   <tibble [0 × …
+2 namedRanges      array  <NA>                 NamedRange      <NA>   <tibble [0 × …
+3 properties       object SpreadsheetProperti… <NA>            <NA>   <tibble [0 × …
+4 sheets           array  <NA>                 Sheet           <NA>   <tibble [0 × …
+5 spreadsheetId    string <NA>                 <NA>            <NA>   <tibble [0 × …
+6 spreadsheetUrl   string <NA>                 <NA>            <NA>   <tibble [0 × …
diff --git a/data-raw/schemas/SpreadsheetProperties b/data-raw/schemas/SpreadsheetProperties
new file mode 100644
index 000000000..dc256b63d
--- /dev/null
+++ b/data-raw/schemas/SpreadsheetProperties
@@ -0,0 +1,10 @@
+# SpreadsheetProperties  
+# A tibble: 6 x 6
+  property               type   instance_of             array_of format enum        
+  <chr>                  <chr>  <chr>                   <chr>    <chr>  <list>      
+1 autoRecalc             enum   <NA>                    <NA>     <NA>   <tibble [4 …
+2 defaultFormat          object CellFormat              <NA>     <NA>   <tibble [0 …
+3 iterativeCalculationS… object IterativeCalculationSe… <NA>     <NA>   <tibble [0 …
+4 locale                 string <NA>                    <NA>     <NA>   <tibble [0 …
+5 timeZone               string <NA>                    <NA>     <NA>   <tibble [0 …
+6 title                  string <NA>                    <NA>     <NA>   <tibble [0 …
diff --git a/data-raw/sheets-v4_2019-11-05.json b/data-raw/sheets-v4_2019-11-15.json
similarity index 93%
rename from data-raw/sheets-v4_2019-11-05.json
rename to data-raw/sheets-v4_2019-11-15.json
index 50e1f2b80..f70ba0aae 100644
--- a/data-raw/sheets-v4_2019-11-05.json
+++ b/data-raw/sheets-v4_2019-11-15.json
@@ -1,1340 +1,1531 @@
 {
+  "basePath": "",
+  "revision": "20191115",
+  "documentationLink": "https://developers.google.com/sheets/",
+  "id": "sheets:v4",
+  "discoveryVersion": "v1",
   "version_module": true,
   "schemas": {
-    "UpdateDimensionGroupRequest": {
+    "InterpolationPoint": {
+      "id": "InterpolationPoint",
+      "description": "A single interpolation point on a gradient conditional format.\nThese pin the gradient color scale according to the color,\ntype and value chosen.",
       "type": "object",
       "properties": {
-        "dimensionGroup": {
-          "$ref": "DimensionGroup",
-          "description": "The group whose state should be updated. The range and depth of the group\nshould specify a valid group on the sheet, and all other fields updated."
+        "color": {
+          "$ref": "Color",
+          "description": "The color this interpolation point should use."
         },
-        "fields": {
+        "type": {
+          "description": "How the value should be interpreted.",
           "type": "string",
-          "description": "The fields that should be updated.  At least one field must be specified.\nThe root `dimensionGroup` is implied and should not be specified.\nA single `\"*\"` can be used as short-hand for listing every field.",
-          "format": "google-fieldmask"
+          "enumDescriptions": [
+            "The default value, do not use.",
+            "The interpolation point uses the minimum value in the\ncells over the range of the conditional format.",
+            "The interpolation point uses the maximum value in the\ncells over the range of the conditional format.",
+            "The interpolation point uses exactly the value in\nInterpolationPoint.value.",
+            "The interpolation point is 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 is 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)."
+          ],
+          "enum": [
+            "INTERPOLATION_POINT_TYPE_UNSPECIFIED",
+            "MIN",
+            "MAX",
+            "NUMBER",
+            "PERCENT",
+            "PERCENTILE"
+          ]
+        },
+        "value": {
+          "description": "The value this interpolation point uses.  May be a formula.\nUnused if type is MIN or\nMAX.",
+          "type": "string"
         }
-      },
-      "id": "UpdateDimensionGroupRequest",
-      "description": "Updates the state of the specified group."
+      }
     },
-    "DeleteDeveloperMetadataResponse": {
-      "description": "The response from deleting developer metadata.",
+    "FindReplaceResponse": {
+      "description": "The result of the find/replace.",
       "type": "object",
       "properties": {
-        "deletedDeveloperMetadata": {
-          "description": "The metadata that was deleted.",
-          "type": "array",
-          "items": {
-            "$ref": "DeveloperMetadata"
-          }
+        "valuesChanged": {
+          "description": "The number of non-formula cells changed.",
+          "format": "int32",
+          "type": "integer"
+        },
+        "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\"`.",
+          "format": "int32",
+          "type": "integer"
+        },
+        "rowsChanged": {
+          "description": "The number of rows changed.",
+          "format": "int32",
+          "type": "integer"
+        },
+        "sheetsChanged": {
+          "type": "integer",
+          "description": "The number of sheets changed.",
+          "format": "int32"
+        },
+        "formulasChanged": {
+          "description": "The number of formula cells changed.",
+          "format": "int32",
+          "type": "integer"
         }
       },
-      "id": "DeleteDeveloperMetadataResponse"
+      "id": "FindReplaceResponse"
     },
-    "SortRangeRequest": {
-      "description": "Sorts data in rows based on a sort order per column.",
+    "DuplicateFilterViewRequest": {
+      "id": "DuplicateFilterViewRequest",
+      "description": "Duplicates a particular filter view.",
       "type": "object",
       "properties": {
-        "range": {
-          "description": "The range to sort.",
-          "$ref": "GridRange"
-        },
-        "sortSpecs": {
-          "description": "The sort order per column. Later specifications are used when values\nare equal in the earlier specifications.",
-          "type": "array",
-          "items": {
-            "$ref": "SortSpec"
-          }
+        "filterId": {
+          "description": "The ID of the filter being duplicated.",
+          "format": "int32",
+          "type": "integer"
         }
-      },
-      "id": "SortRangeRequest"
+      }
     },
-    "MatchedDeveloperMetadata": {
-      "id": "MatchedDeveloperMetadata",
-      "description": "A developer metadata entry and the data filters specified in the original\nrequest that matched it.",
+    "UpdateConditionalFormatRuleResponse": {
       "type": "object",
       "properties": {
-        "dataFilters": {
-          "description": "All filters matching the returned developer metadata.",
-          "type": "array",
-          "items": {
-            "$ref": "DataFilter"
-          }
+        "newIndex": {
+          "description": "The index of the new rule.",
+          "format": "int32",
+          "type": "integer"
         },
-        "developerMetadata": {
-          "$ref": "DeveloperMetadata",
-          "description": "The developer metadata matching the specified filters."
+        "oldIndex": {
+          "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)"
+        },
+        "oldRule": {
+          "$ref": "ConditionalFormatRule",
+          "description": "The old (deleted) rule. Not set if a rule was moved\n(because it is the same as new_rule)."
         }
-      }
+      },
+      "id": "UpdateConditionalFormatRuleResponse",
+      "description": "The result of updating a conditional format rule."
     },
-    "MergeCellsRequest": {
+    "ConditionValue": {
+      "description": "The value of the condition.",
       "type": "object",
       "properties": {
-        "range": {
-          "description": "The range of cells to merge.",
-          "$ref": "GridRange"
-        },
-        "mergeType": {
+        "relativeDate": {
+          "type": "string",
           "enumDescriptions": [
-            "Create a single merge from the range",
-            "Create a merge for each column in the range",
-            "Create a merge for each row in the range"
+            "Default value, do not use.",
+            "The value is one year before today.",
+            "The value is one month before today.",
+            "The value is one week before today.",
+            "The value is yesterday.",
+            "The value is today.",
+            "The value is tomorrow."
           ],
           "enum": [
-            "MERGE_ALL",
-            "MERGE_COLUMNS",
-            "MERGE_ROWS"
+            "RELATIVE_DATE_UNSPECIFIED",
+            "PAST_YEAR",
+            "PAST_MONTH",
+            "PAST_WEEK",
+            "YESTERDAY",
+            "TODAY",
+            "TOMORROW"
           ],
-          "description": "How the cells should be merged.",
+          "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."
+        },
+        "userEnteredValue": {
+          "description": "A value the condition is based on.\nThe value is parsed as if the user typed into a cell.\nFormulas are supported (and must begin with an `=` or a '+').",
           "type": "string"
         }
       },
-      "id": "MergeCellsRequest",
-      "description": "Merges all cells in the range."
+      "id": "ConditionValue"
     },
-    "AddProtectedRangeRequest": {
-      "description": "Adds a new protected range.",
+    "DateTimeRule": {
+      "id": "DateTimeRule",
+      "description": "Allows you to organize the date-time values in a source data column into\nbuckets based on selected parts of their date or time values. For example,\nconsider a pivot table showing sales transactions by date:\n\n    +----------+--------------+\n    | Date     | SUM of Sales |\n    +----------+--------------+\n    | 1/1/2017 |      $621.14 |\n    | 2/3/2017 |      $708.84 |\n    | 5/8/2017 |      $326.84 |\n    ...\n    +----------+--------------+\nApplying a date-time group rule with a DateTimeRuleType of YEAR_MONTH\nresults in the following pivot table.\n\n    +--------------+--------------+\n    | Grouped Date | SUM of Sales |\n    +--------------+--------------+\n    | 2017-Jan     |   $53,731.78 |\n    | 2017-Feb     |   $83,475.32 |\n    | 2017-Mar     |   $94,385.05 |\n    ...\n    +--------------+--------------+",
       "type": "object",
       "properties": {
-        "protectedRange": {
-          "$ref": "ProtectedRange",
-          "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.)"
+        "type": {
+          "enumDescriptions": [
+            "The default type, do not use.",
+            "Group dates by second, from 0 to 59.",
+            "Group dates by minute, from 0 to 59.",
+            "Group dates by hour using a 24-hour system, from 0 to 23.",
+            "Group dates by hour and minute using a 24-hour system, for example 19:45.",
+            "Group dates by hour and minute using a 12-hour system, for example 7:45\nPM. The AM/PM designation is translated based on the spreadsheet\nlocale.",
+            "Group dates by day of week, for example Sunday. The days of the week will\nbe translated based on the spreadsheet locale.",
+            "Group dates by day of year, from 1 to 366. Note that dates after Feb. 29\nfall in different buckets in leap years than in non-leap years.",
+            "Group dates by day of month, from 1 to 31.",
+            "Group dates by day and month, for example 22-Nov. The month is\ntranslated based on the spreadsheet locale.",
+            "Group dates by month, for example Nov. The month is translated based\non the spreadsheet locale.",
+            "Group dates by quarter, for example Q1 (which represents Jan-Mar).",
+            "Group dates by year, for example 2008.",
+            "Group dates by year and month, for example 2008-Nov. The month is\ntranslated based on the spreadsheet locale.",
+            "Group dates by year and quarter, for example 2008 Q4.",
+            "Group dates by year, month, and day, for example 2008-11-22."
+          ],
+          "enum": [
+            "DATE_TIME_RULE_TYPE_UNSPECIFIED",
+            "SECOND",
+            "MINUTE",
+            "HOUR",
+            "HOUR_MINUTE",
+            "HOUR_MINUTE_AMPM",
+            "DAY_OF_WEEK",
+            "DAY_OF_YEAR",
+            "DAY_OF_MONTH",
+            "DAY_MONTH",
+            "MONTH",
+            "QUARTER",
+            "YEAR",
+            "YEAR_MONTH",
+            "YEAR_QUARTER",
+            "YEAR_MONTH_DAY"
+          ],
+          "description": "The type of date-time grouping to apply.",
+          "type": "string"
         }
-      },
-      "id": "AddProtectedRangeRequest"
+      }
     },
-    "DuplicateFilterViewResponse": {
-      "description": "The result of a filter view being duplicated.",
+    "HistogramSeries": {
       "type": "object",
       "properties": {
-        "filter": {
-          "description": "The newly created filter.",
-          "$ref": "FilterView"
+        "barColor": {
+          "$ref": "Color",
+          "description": "The color of the column representing this series in each bucket.\nThis field is optional."
+        },
+        "data": {
+          "$ref": "ChartData",
+          "description": "The data for this histogram series."
         }
       },
-      "id": "DuplicateFilterViewResponse"
+      "id": "HistogramSeries",
+      "description": "A histogram series containing the series color and data."
     },
-    "DuplicateSheetResponse": {
-      "description": "The result of duplicating a sheet.",
+    "Spreadsheet": {
       "type": "object",
       "properties": {
         "properties": {
-          "$ref": "SheetProperties",
-          "description": "The properties of the duplicate sheet."
-        }
-      },
-      "id": "DuplicateSheetResponse"
-    },
-    "BatchUpdateSpreadsheetResponse": {
-      "description": "The reply for batch updating a spreadsheet.",
-      "type": "object",
-      "properties": {
-        "replies": {
+          "$ref": "SpreadsheetProperties",
+          "description": "Overall properties of a spreadsheet."
+        },
+        "spreadsheetId": {
+          "description": "The ID of the spreadsheet.\nThis field is read-only.",
+          "type": "string"
+        },
+        "namedRanges": {
+          "description": "The named ranges defined in a spreadsheet.",
           "type": "array",
           "items": {
-            "$ref": "Response"
+            "$ref": "NamedRange"
+          }
+        },
+        "developerMetadata": {
+          "type": "array",
+          "items": {
+            "$ref": "DeveloperMetadata"
           },
-          "description": "The reply of the updates.  This maps 1:1 with the updates, although\nreplies to some requests may be empty."
+          "description": "The developer metadata associated with a spreadsheet."
         },
-        "updatedSpreadsheet": {
-          "description": "The spreadsheet after updates were applied. This is only set if\n[BatchUpdateSpreadsheetRequest.include_spreadsheet_in_response] is `true`.",
-          "$ref": "Spreadsheet"
+        "sheets": {
+          "description": "The sheets that are part of a spreadsheet.",
+          "type": "array",
+          "items": {
+            "$ref": "Sheet"
+          }
         },
-        "spreadsheetId": {
-          "description": "The spreadsheet the updates were applied to.",
+        "spreadsheetUrl": {
+          "description": "The url of the spreadsheet.\nThis field is read-only.",
           "type": "string"
         }
       },
-      "id": "BatchUpdateSpreadsheetResponse"
+      "id": "Spreadsheet",
+      "description": "Resource that represents a spreadsheet."
     },
-    "AddFilterViewRequest": {
+    "BandedRange": {
+      "description": "A banded (alternating colors) range in a sheet.",
       "type": "object",
       "properties": {
-        "filter": {
-          "$ref": "FilterView",
-          "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.)"
+        "rowProperties": {
+          "$ref": "BandingProperties",
+          "description": "Properties for row bands. These properties are 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."
+        },
+        "columnProperties": {
+          "$ref": "BandingProperties",
+          "description": "Properties for column bands. These properties are 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."
+        },
+        "range": {
+          "$ref": "GridRange",
+          "description": "The range over which these properties are applied."
+        },
+        "bandedRangeId": {
+          "description": "The id of the banded range.",
+          "format": "int32",
+          "type": "integer"
         }
       },
-      "id": "AddFilterViewRequest",
-      "description": "Adds a filter view."
+      "id": "BandedRange"
     },
-    "DataFilterValueRange": {
+    "AddChartRequest": {
+      "description": "Adds a chart to a sheet in the spreadsheet.",
       "type": "object",
       "properties": {
-        "majorDimension": {
-          "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"
-          ],
-          "description": "The major dimension of the values."
-        },
-        "values": {
-          "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.",
-          "type": "array",
-          "items": {
-            "type": "array",
-            "items": {
-              "type": "any"
-            }
-          }
-        },
-        "dataFilter": {
-          "$ref": "DataFilter",
-          "description": "The data filter describing the location of the values in the spreadsheet."
+        "chart": {
+          "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 an embedded object that already exists.)",
+          "$ref": "EmbeddedChart"
         }
       },
-      "id": "DataFilterValueRange",
-      "description": "A range of values whose location is specified by a DataFilter."
+      "id": "AddChartRequest"
     },
-    "NumberFormat": {
-      "description": "The number format of a cell.",
+    "HistogramRule": {
+      "description": "Allows you to organize the numeric values in a source data column into\nbuckets of a constant size. All values from HistogramRule.start to\nHistogramRule.end are placed into groups of size\nHistogramRule.interval. In addition, all values below\nHistogramRule.start are placed in one group, and all values above\nHistogramRule.end are placed in another. Only\nHistogramRule.interval is required, though if HistogramRule.start\nand HistogramRule.end are both provided, HistogramRule.start must\nbe less than HistogramRule.end. For example, a pivot table showing\naverage purchase amount by age that has 50+ rows:\n\n    +-----+-------------------+\n    | Age | AVERAGE of Amount |\n    +-----+-------------------+\n    | 16  |            $27.13 |\n    | 17  |             $5.24 |\n    | 18  |            $20.15 |\n    ...\n    +-----+-------------------+\ncould be turned into a pivot table that looks like the one below by\napplying a histogram group rule with a HistogramRule.start of 25,\nan HistogramRule.interval of 20, and an HistogramRule.end\nof 65.\n\n    +-------------+-------------------+\n    | Grouped Age | AVERAGE of Amount |\n    +-------------+-------------------+\n    | \u003c 25        |            $19.34 |\n    | 25-45       |            $31.43 |\n    | 45-65       |            $35.87 |\n    | \u003e 65        |            $27.55 |\n    +-------------+-------------------+\n    | Grand Total |            $29.12 |\n    +-------------+-------------------+",
       "type": "object",
       "properties": {
-        "type": {
-          "type": "string",
-          "enumDescriptions": [
-            "The number format is not specified\nand is based on the contents of the cell.\nDo not explicitly use this.",
-            "Text formatting, e.g `1000.12`",
-            "Number formatting, e.g, `1,000.12`",
-            "Percent formatting, e.g `10.12%`",
-            "Currency formatting, e.g `$1,000.12`",
-            "Date formatting, e.g `9/26/2008`",
-            "Time formatting, e.g `3:59:00 PM`",
-            "Date+Time formatting, e.g `9/26/08 15:59:00`",
-            "Scientific number formatting, e.g `1.01E+03`"
-          ],
-          "enum": [
-            "NUMBER_FORMAT_TYPE_UNSPECIFIED",
-            "TEXT",
-            "NUMBER",
-            "PERCENT",
-            "CURRENCY",
-            "DATE",
-            "TIME",
-            "DATE_TIME",
-            "SCIENTIFIC"
-          ],
-          "description": "The type of the number format.\nWhen writing, this field must be set."
+        "interval": {
+          "description": "The size of the buckets that are created. Must be positive.",
+          "format": "double",
+          "type": "number"
         },
-        "pattern": {
-          "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\nmore information about the supported patterns.",
-          "type": "string"
+        "start": {
+          "description": "The minimum value at which items are placed into buckets\nof constant size. Values below start are lumped into a single bucket.\nThis field is optional.",
+          "format": "double",
+          "type": "number"
+        },
+        "end": {
+          "type": "number",
+          "description": "The maximum value at which items are placed into buckets\nof constant size. Values above end are lumped into a single bucket.\nThis field is optional.",
+          "format": "double"
         }
       },
-      "id": "NumberFormat"
+      "id": "HistogramRule"
     },
-    "OrgChartSpec": {
+    "UpdateProtectedRangeRequest": {
+      "description": "Updates an existing protected range with the specified\nprotectedRangeId.",
       "type": "object",
       "properties": {
-        "tooltips": {
-          "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.",
-          "$ref": "ChartData"
-        },
-        "selectedNodeColor": {
-          "$ref": "Color",
-          "description": "The color of the selected org chart nodes."
-        },
-        "parentLabels": {
-          "$ref": "ChartData",
-          "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."
-        },
-        "nodeSize": {
-          "type": "string",
-          "enumDescriptions": [
-            "Default value, do not use.",
-            "The small org chart node size.",
-            "The medium org chart node size.",
-            "The large org chart node size."
-          ],
-          "enum": [
-            "ORG_CHART_LABEL_SIZE_UNSPECIFIED",
-            "SMALL",
-            "MEDIUM",
-            "LARGE"
-          ],
-          "description": "The size of the org chart nodes."
-        },
-        "labels": {
-          "$ref": "ChartData",
-          "description": "The data containing the labels for all the nodes in the chart.  Labels\nmust be unique."
+        "protectedRange": {
+          "$ref": "ProtectedRange",
+          "description": "The protected range to update with the new properties."
         },
-        "nodeColor": {
-          "$ref": "Color",
-          "description": "The color of the org chart nodes."
+        "fields": {
+          "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.",
+          "format": "google-fieldmask",
+          "type": "string"
         }
       },
-      "id": "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\"."
+      "id": "UpdateProtectedRangeRequest"
     },
-    "FilterView": {
-      "description": "A filter view.",
+    "AddSheetResponse": {
+      "description": "The result of adding a sheet.",
       "type": "object",
       "properties": {
-        "criteria": {
-          "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.",
-          "type": "object",
-          "additionalProperties": {
-            "$ref": "FilterCriteria"
-          }
-        },
-        "title": {
-          "type": "string",
-          "description": "The name of the filter view."
-        },
-        "range": {
-          "description": "The range this filter view covers.\n\nWhen writing, only one of range or named_range_id\nmay be set.",
-          "$ref": "GridRange"
-        },
-        "sortSpecs": {
-          "type": "array",
-          "items": {
-            "$ref": "SortSpec"
-          },
-          "description": "The sort order per column. Later specifications are used when values\nare equal in the earlier specifications."
-        },
-        "namedRangeId": {
-          "description": "The named range this filter view is backed by, if any.\n\nWhen writing, only one of range or named_range_id\nmay be set.",
-          "type": "string"
-        },
-        "filterViewId": {
-          "type": "integer",
-          "description": "The ID of the filter view.",
-          "format": "int32"
+        "properties": {
+          "$ref": "SheetProperties",
+          "description": "The properties of the newly added sheet."
         }
       },
-      "id": "FilterView"
+      "id": "AddSheetResponse"
     },
-    "Slicer": {
+    "PivotGroupRule": {
+      "id": "PivotGroupRule",
+      "description": "An optional setting on a PivotGroup that defines buckets for the values\nin the source data column rather than breaking out each individual value.\nOnly one PivotGroup with a group rule may be added for each column in\nthe source data, though on any given column you may add both a\nPivotGroup that has a rule and a PivotGroup that does not.",
       "type": "object",
       "properties": {
-        "position": {
-          "description": "The position of the slicer. Note that slicer can be positioned only on\nexisting sheet. Also, width and height of slicer can be automatically\nadjusted to keep it within permitted limits.",
-          "$ref": "EmbeddedObjectPosition"
+        "histogramRule": {
+          "$ref": "HistogramRule",
+          "description": "A HistogramRule."
         },
-        "spec": {
-          "$ref": "SlicerSpec",
-          "description": "The specification of the slicer."
+        "dateTimeRule": {
+          "$ref": "DateTimeRule",
+          "description": "A DateTimeRule."
         },
-        "slicerId": {
-          "description": "The ID of the slicer.",
-          "format": "int32",
-          "type": "integer"
+        "manualRule": {
+          "$ref": "ManualRule",
+          "description": "A ManualRule."
         }
-      },
-      "id": "Slicer",
-      "description": "A slicer in a sheet."
+      }
     },
-    "SearchDeveloperMetadataRequest": {
-      "description": "A request to retrieve all developer metadata matching the set of specified\ncriteria.",
+    "AddFilterViewResponse": {
+      "description": "The result of adding a filter view.",
       "type": "object",
       "properties": {
-        "dataFilters": {
-          "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.",
-          "type": "array",
-          "items": {
-            "$ref": "DataFilter"
-          }
+        "filter": {
+          "$ref": "FilterView",
+          "description": "The newly added filter view."
         }
       },
-      "id": "SearchDeveloperMetadataRequest"
+      "id": "AddFilterViewResponse"
     },
-    "BandingProperties": {
-      "id": "BandingProperties",
-      "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.",
+    "IterativeCalculationSettings": {
+      "description": "Settings to control how circular dependencies are resolved with iterative\ncalculation.",
       "type": "object",
       "properties": {
-        "secondBandColor": {
-          "$ref": "Color",
-          "description": "The second color that is alternating. (Required)"
-        },
-        "footerColor": {
-          "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.",
-          "$ref": "Color"
-        },
-        "headerColor": {
-          "$ref": "Color",
-          "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."
+        "maxIterations": {
+          "description": "When iterative calculation is enabled, the maximum number of calculation\nrounds to perform.",
+          "format": "int32",
+          "type": "integer"
         },
-        "firstBandColor": {
-          "$ref": "Color",
-          "description": "The first color that is alternating. (Required)"
+        "convergenceThreshold": {
+          "type": "number",
+          "description": "When iterative calculation is enabled and successive results differ by\nless than this threshold value, the calculation rounds stop.",
+          "format": "double"
         }
-      }
+      },
+      "id": "IterativeCalculationSettings"
     },
-    "BasicFilter": {
-      "id": "BasicFilter",
-      "description": "The default filter associated with a sheet.",
+    "ScorecardChartSpec": {
+      "description": "A scorecard chart. Scorecard charts are used to highlight key performance\nindicators, known as KPIs, on the spreadsheet. A scorecard chart can\nrepresent things like total sales, average cost, or a top selling item. You\ncan specify a single data value, or aggregate over a range of data.\nPercentage or absolute difference from a baseline value can be highlighted,\nlike changes over time.",
       "type": "object",
       "properties": {
-        "range": {
-          "$ref": "GridRange",
-          "description": "The range the filter covers."
+        "keyValueData": {
+          "$ref": "ChartData",
+          "description": "The data for scorecard key value."
         },
-        "criteria": {
-          "additionalProperties": {
-            "$ref": "FilterCriteria"
-          },
-          "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.",
-          "type": "object"
-        },
-        "sortSpecs": {
-          "description": "The sort order per column. Later specifications are used when values\nare equal in the earlier specifications.",
-          "type": "array",
-          "items": {
-            "$ref": "SortSpec"
-          }
-        }
-      }
-    },
-    "AddProtectedRangeResponse": {
-      "id": "AddProtectedRangeResponse",
-      "description": "The result of adding a new protected range.",
-      "type": "object",
-      "properties": {
-        "protectedRange": {
-          "$ref": "ProtectedRange",
-          "description": "The newly added protected range."
-        }
-      }
-    },
-    "PivotValue": {
-      "description": "The definition of how a value in a pivot table should be calculated.",
-      "type": "object",
-      "properties": {
-        "name": {
-          "description": "A name to use for the value.",
-          "type": "string"
-        },
-        "formula": {
+        "aggregateType": {
+          "enum": [
+            "CHART_AGGREGATE_TYPE_UNSPECIFIED",
+            "AVERAGE",
+            "COUNT",
+            "MAX",
+            "MEDIAN",
+            "MIN",
+            "SUM"
+          ],
+          "description": "The aggregation type for key and baseline chart data in scorecard chart.\nThis field is optional.",
           "type": "string",
-          "description": "A custom formula to calculate the value.  The formula must start\nwith an `=` character."
-        },
-        "calculatedDisplayType": {
           "enumDescriptions": [
             "Default value, do not use.",
-            "Shows the pivot values as percentage of the row total values.",
-            "Shows the pivot values as percentage of the column total values.",
-            "Shows the pivot values as percentage of the grand total values."
-          ],
-          "enum": [
-            "PIVOT_VALUE_CALCULATED_DISPLAY_TYPE_UNSPECIFIED",
-            "PERCENT_OF_ROW_TOTAL",
-            "PERCENT_OF_COLUMN_TOTAL",
-            "PERCENT_OF_GRAND_TOTAL"
-          ],
-          "description": "If specified, indicates that pivot values should be displayed as\nthe result of a calculation with another pivot value. For example, if\ncalculated_display_type is specified as PERCENT_OF_GRAND_TOTAL, all the\npivot values are displayed as the percentage of the grand total. In\nthe Sheets UI, this is referred to as \"Show As\" in the value section of a\npivot table.",
-          "type": "string"
+            "Average aggregate function.",
+            "Count aggregate function.",
+            "Maximum aggregate function.",
+            "Median aggregate function.",
+            "Minimum aggregate function.",
+            "Sum aggregate function."
+          ]
         },
-        "summarizeFunction": {
+        "numberFormatSource": {
+          "type": "string",
           "enumDescriptions": [
-            "The default, do not use.",
-            "Corresponds to the `SUM` function.",
-            "Corresponds to the `COUNTA` function.",
-            "Corresponds to the `COUNT` function.",
-            "Corresponds to the `COUNTUNIQUE` function.",
-            "Corresponds to the `AVERAGE` function.",
-            "Corresponds to the `MAX` function.",
-            "Corresponds to the `MIN` function.",
-            "Corresponds to the `MEDIAN` function.",
-            "Corresponds to the `PRODUCT` function.",
-            "Corresponds to the `STDEV` function.",
-            "Corresponds to the `STDEVP` function.",
-            "Corresponds to the `VAR` function.",
-            "Corresponds to the `VARP` function.",
-            "Indicates the formula should be used as-is.\nOnly valid if PivotValue.formula was set."
+            "Default value, do not use.",
+            "Inherit number formatting from data.",
+            "Apply custom formatting as specified by ChartCustomNumberFormatOptions."
           ],
           "enum": [
-            "PIVOT_STANDARD_VALUE_FUNCTION_UNSPECIFIED",
-            "SUM",
-            "COUNTA",
-            "COUNT",
-            "COUNTUNIQUE",
-            "AVERAGE",
-            "MAX",
-            "MIN",
-            "MEDIAN",
-            "PRODUCT",
-            "STDEV",
-            "STDEVP",
-            "VAR",
-            "VARP",
+            "CHART_NUMBER_FORMAT_SOURCE_UNDEFINED",
+            "FROM_DATA",
             "CUSTOM"
           ],
-          "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.",
-          "type": "string"
+          "description": "The number format source used in the scorecard chart.\nThis field is optional."
         },
-        "sourceColumnOffset": {
-          "type": "integer",
-          "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`.",
-          "format": "int32"
+        "keyValueFormat": {
+          "description": "Formatting options for key value.",
+          "$ref": "KeyValueFormat"
+        },
+        "customFormatOptions": {
+          "$ref": "ChartCustomNumberFormatOptions",
+          "description": "Custom formatting options for numeric key/baseline values in scorecard\nchart. This field is used only when number_format_source is set to\nCUSTOM. This field is optional."
+        },
+        "scaleFactor": {
+          "description": "Value to scale scorecard key and baseline value. For example, a factor of\n10 can be used to divide all values in the chart by 10.\nThis field is optional.",
+          "format": "double",
+          "type": "number"
+        },
+        "baselineValueFormat": {
+          "$ref": "BaselineValueFormat",
+          "description": "Formatting options for baseline value.\nThis field is needed only if baseline_value_data is specified."
+        },
+        "baselineValueData": {
+          "$ref": "ChartData",
+          "description": "The data for scorecard baseline value.\nThis field is optional."
         }
       },
-      "id": "PivotValue"
+      "id": "ScorecardChartSpec"
     },
-    "ErrorValue": {
-      "id": "ErrorValue",
-      "description": "An error in a cell.",
+    "SpreadsheetProperties": {
+      "id": "SpreadsheetProperties",
+      "description": "Properties of a spreadsheet.",
       "type": "object",
       "properties": {
-        "type": {
-          "enum": [
-            "ERROR_TYPE_UNSPECIFIED",
-            "ERROR",
-            "NULL_VALUE",
-            "DIVIDE_BY_ZERO",
-            "VALUE",
-            "REF",
-            "NAME",
-            "NUM",
-            "N_A",
-            "LOADING"
-          ],
-          "description": "The type of error.",
+        "title": {
           "type": "string",
-          "enumDescriptions": [
-            "The default error type, do not use this.",
-            "Corresponds to the `#ERROR!` error.",
-            "Corresponds to the `#NULL!` error.",
-            "Corresponds to the `#DIV/0` error.",
-            "Corresponds to the `#VALUE!` error.",
-            "Corresponds to the `#REF!` error.",
-            "Corresponds to the `#NAME?` error.",
-            "Corresponds to the `#NUM`! error.",
-            "Corresponds to the `#N/A` error.",
-            "Corresponds to the `Loading...` state."
-          ]
+          "description": "The title of the spreadsheet."
         },
-        "message": {
-          "description": "A message with more information about the error\n(in the spreadsheet's locale).",
+        "timeZone": {
+          "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`.",
+          "type": "string"
+        },
+        "locale": {
+          "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.",
+          "type": "string"
+        },
+        "iterativeCalculationSettings": {
+          "$ref": "IterativeCalculationSettings",
+          "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."
+        },
+        "autoRecalc": {
+          "enumDescriptions": [
+            "Default value. This value must not be used.",
+            "Volatile functions are updated on every change.",
+            "Volatile functions are updated on every change and every minute.",
+            "Volatile functions are updated on every change and hourly."
+          ],
+          "enum": [
+            "RECALCULATION_INTERVAL_UNSPECIFIED",
+            "ON_CHANGE",
+            "MINUTE",
+            "HOUR"
+          ],
+          "description": "The amount of time to wait before volatile functions are recalculated.",
           "type": "string"
+        },
+        "defaultFormat": {
+          "$ref": "CellFormat",
+          "description": "The default format of all cells in the spreadsheet.\nCellData.effectiveFormat will not be set if\nthe cell's format is equal to this default format. This field is read-only."
         }
       }
     },
-    "CopySheetToAnotherSpreadsheetRequest": {
-      "description": "The request to copy a sheet across spreadsheets.",
+    "OverlayPosition": {
       "type": "object",
       "properties": {
-        "destinationSpreadsheetId": {
-          "type": "string",
-          "description": "The ID of the spreadsheet to copy the sheet to."
+        "widthPixels": {
+          "description": "The width of the object, in pixels. Defaults to 600.",
+          "format": "int32",
+          "type": "integer"
+        },
+        "offsetXPixels": {
+          "description": "The horizontal offset, in pixels, that the object is offset\nfrom the anchor cell.",
+          "format": "int32",
+          "type": "integer"
+        },
+        "anchorCell": {
+          "description": "The cell the object is anchored to.",
+          "$ref": "GridCoordinate"
+        },
+        "offsetYPixels": {
+          "type": "integer",
+          "description": "The vertical offset, in pixels, that the object is offset\nfrom the anchor cell.",
+          "format": "int32"
+        },
+        "heightPixels": {
+          "description": "The height of the object, in pixels. Defaults to 371.",
+          "format": "int32",
+          "type": "integer"
         }
       },
-      "id": "CopySheetToAnotherSpreadsheetRequest"
+      "id": "OverlayPosition",
+      "description": "The location an object is overlaid on top of a grid."
     },
-    "CandlestickChartSpec": {
-      "description": "A \u003ca href=\"/chart/interactive/docs/gallery/candlestickchart\"\u003ecandlestick\nchart\u003c/a\u003e.",
+    "AddChartResponse": {
+      "id": "AddChartResponse",
+      "description": "The result of adding a chart to a spreadsheet.",
       "type": "object",
       "properties": {
-        "domain": {
-          "$ref": "CandlestickDomain",
-          "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."
-        },
-        "data": {
-          "type": "array",
-          "items": {
-            "$ref": "CandlestickData"
-          },
-          "description": "The Candlestick chart data.\nOnly one CandlestickData is supported."
+        "chart": {
+          "$ref": "EmbeddedChart",
+          "description": "The newly added chart."
         }
-      },
-      "id": "CandlestickChartSpec"
+      }
     },
-    "BatchClearValuesByDataFilterResponse": {
-      "id": "BatchClearValuesByDataFilterResponse",
-      "description": "The response when clearing a range of values selected with\nDataFilters in a spreadsheet.",
+    "InsertDimensionRequest": {
+      "description": "Inserts rows or columns in a sheet at a particular index.",
       "type": "object",
       "properties": {
-        "spreadsheetId": {
-          "description": "The spreadsheet the updates were applied to.",
-          "type": "string"
+        "range": {
+          "description": "The dimensions to insert.  Both the start and end indexes must be bounded.",
+          "$ref": "DimensionRange"
         },
-        "clearedRanges": {
-          "type": "array",
-          "items": {
-            "type": "string"
-          },
-          "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.)"
+        "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).",
+          "type": "boolean"
         }
-      }
+      },
+      "id": "InsertDimensionRequest"
     },
-    "TreemapChartColorScale": {
-      "description": "A color scale for a treemap chart.",
+    "BatchUpdateValuesRequest": {
       "type": "object",
       "properties": {
-        "midValueColor": {
-          "description": "The background color for cells with a color value at the midpoint between\nminValue and\nmaxValue. Defaults to #efe6dc if not\nspecified.",
-          "$ref": "Color"
-        },
-        "maxValueColor": {
-          "$ref": "Color",
-          "description": "The background color for cells with a color value greater than or equal\nto maxValue. Defaults to #109618 if not\nspecified."
-        },
-        "minValueColor": {
-          "$ref": "Color",
-          "description": "The background color for cells with a color value less than or equal to\nminValue. Defaults to #dc3912 if not\nspecified."
-        },
-        "noDataColor": {
-          "$ref": "Color",
-          "description": "The background color for cells that have no color data associated with\nthem. Defaults to #000000 if not specified."
-        }
-      },
-      "id": "TreemapChartColorScale"
-    },
-    "EmbeddedObjectPosition": {
-      "description": "The position of an embedded object such as a chart.",
-      "type": "object",
-      "properties": {
-        "sheetId": {
-          "description": "The sheet this is on. Set only if the embedded object\nis on its own sheet. Must be non-negative.",
-          "format": "int32",
-          "type": "integer"
-        },
-        "overlayPosition": {
-          "$ref": "OverlayPosition",
-          "description": "The position at which the object is overlaid on top of a grid."
-        },
-        "newSheet": {
-          "type": "boolean",
-          "description": "If true, the embedded object is put on a new sheet whose ID\nis chosen for you. Used only when writing."
-        }
-      },
-      "id": "EmbeddedObjectPosition"
-    },
-    "DeveloperMetadataLookup": {
-      "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.",
-      "type": "object",
-      "properties": {
-        "locationType": {
+        "responseDateTimeRenderOption": {
           "enumDescriptions": [
-            "Default value.",
-            "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."
+            "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)."
           ],
           "enum": [
-            "DEVELOPER_METADATA_LOCATION_TYPE_UNSPECIFIED",
-            "ROW",
-            "COLUMN",
-            "SHEET",
-            "SPREADSHEET"
+            "SERIAL_NUMBER",
+            "FORMATTED_STRING"
           ],
-          "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.",
-          "type": "string"
-        },
-        "metadataKey": {
-          "description": "Limits the selected developer metadata to that which has a matching\nDeveloperMetadata.metadata_key.",
+          "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.",
           "type": "string"
         },
-        "metadataId": {
-          "description": "Limits the selected developer metadata to that which has a matching\nDeveloperMetadata.metadata_id.",
-          "format": "int32",
-          "type": "integer"
-        },
-        "visibility": {
-          "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.",
+        "responseValueRenderOption": {
+          "description": "Determines how values in the response should be rendered.\nThe default render option is ValueRenderOption.FORMATTED_VALUE.",
           "type": "string",
           "enumDescriptions": [
-            "Default value.",
-            "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."
+            "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": [
-            "DEVELOPER_METADATA_VISIBILITY_UNSPECIFIED",
-            "DOCUMENT",
-            "PROJECT"
+            "FORMATTED_VALUE",
+            "UNFORMATTED_VALUE",
+            "FORMULA"
           ]
         },
-        "metadataValue": {
-          "description": "Limits the selected developer metadata to that which has a matching\nDeveloperMetadata.metadata_value.",
+        "includeValuesInResponse": {
+          "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).",
+          "type": "boolean"
+        },
+        "valueInputOption": {
+          "enumDescriptions": [
+            "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."
+          ],
+          "enum": [
+            "INPUT_VALUE_OPTION_UNSPECIFIED",
+            "RAW",
+            "USER_ENTERED"
+          ],
+          "description": "How the input data should be interpreted.",
           "type": "string"
         },
-        "metadataLocation": {
-          "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.",
-          "$ref": "DeveloperMetadataLocation"
+        "data": {
+          "description": "The new values to apply to the spreadsheet.",
+          "type": "array",
+          "items": {
+            "$ref": "ValueRange"
+          }
+        }
+      },
+      "id": "BatchUpdateValuesRequest",
+      "description": "The request for updating more than one range of values in a spreadsheet."
+    },
+    "CutPasteRequest": {
+      "description": "Moves data from the source to the destination.",
+      "type": "object",
+      "properties": {
+        "source": {
+          "$ref": "GridRange",
+          "description": "The source data to cut."
         },
-        "locationMatchingStrategy": {
+        "pasteType": {
+          "enumDescriptions": [
+            "Paste values, formulas, formats, and merges.",
+            "Paste the values ONLY without formats, formulas, or merges.",
+            "Paste the format and data validation only.",
+            "Like PASTE_NORMAL but without borders.",
+            "Paste the formulas only.",
+            "Paste the data validation only.",
+            "Paste the conditional formatting rules only."
+          ],
           "enum": [
-            "DEVELOPER_METADATA_LOCATION_MATCHING_STRATEGY_UNSPECIFIED",
-            "EXACT_LOCATION",
-            "INTERSECTING_LOCATION"
+            "PASTE_NORMAL",
+            "PASTE_VALUES",
+            "PASTE_FORMAT",
+            "PASTE_NO_BORDERS",
+            "PASTE_FORMULA",
+            "PASTE_DATA_VALIDATION",
+            "PASTE_CONDITIONAL_FORMATTING"
           ],
-          "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.",
-          "type": "string",
-          "enumDescriptions": [
-            "Default value. This value must not be used.",
-            "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": "What kind of data to paste.  All the source data will be cut, regardless\nof what is pasted.",
+          "type": "string"
+        },
+        "destination": {
+          "$ref": "GridCoordinate",
+          "description": "The top-left coordinate where the data should be pasted."
         }
       },
-      "id": "DeveloperMetadataLookup"
+      "id": "CutPasteRequest"
     },
-    "AutoFillRequest": {
-      "description": "Fills in more data based on existing data.",
+    "ChartAxisViewWindowOptions": {
+      "description": "The options that define a \"view window\" for a chart (such as the visible\nvalues in an axis).",
       "type": "object",
       "properties": {
-        "useAlternateSeries": {
-          "description": "True if we should generate data with the \"alternate\" series.\nThis differs based on the type and amount of source data.",
-          "type": "boolean"
+        "viewWindowMin": {
+          "type": "number",
+          "description": "The minimum numeric value to be shown in this view window. If unset, will\nautomatically determine a minimum value that looks good for the data.",
+          "format": "double"
         },
-        "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"
+        "viewWindowMax": {
+          "type": "number",
+          "description": "The maximum numeric value to be shown in this view window. If unset, will\nautomatically determine a maximum value that looks good for the data.",
+          "format": "double"
         },
-        "range": {
-          "$ref": "GridRange",
-          "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."
+        "viewWindowMode": {
+          "enumDescriptions": [
+            "The default view window mode used in the Sheets editor for this chart\ntype. In most cases, if set, the default mode is equivalent to\n`PRETTY`.",
+            "Do not use. Represents that the currently set mode is not supported by\nthe API.",
+            "Follows the min and max exactly if specified. If a value is unspecified,\nit will fall back to the `PRETTY` value.",
+            "Chooses a min and max that make the chart look good. Both min and max are\nignored in this mode."
+          ],
+          "enum": [
+            "DEFAULT_VIEW_WINDOW_MODE",
+            "VIEW_WINDOW_MODE_UNSUPPORTED",
+            "EXPLICIT",
+            "PRETTY"
+          ],
+          "description": "The view window's mode.",
+          "type": "string"
         }
       },
-      "id": "AutoFillRequest"
+      "id": "ChartAxisViewWindowOptions"
     },
-    "GradientRule": {
-      "id": "GradientRule",
-      "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.",
+    "BasicChartSeries": {
+      "id": "BasicChartSeries",
+      "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\".",
       "type": "object",
       "properties": {
-        "midpoint": {
-          "$ref": "InterpolationPoint",
-          "description": "An optional midway interpolation point."
+        "series": {
+          "$ref": "ChartData",
+          "description": "The data being visualized in this chart series."
         },
-        "minpoint": {
-          "$ref": "InterpolationPoint",
-          "description": "The starting interpolation point."
+        "type": {
+          "enum": [
+            "BASIC_CHART_TYPE_UNSPECIFIED",
+            "BAR",
+            "LINE",
+            "AREA",
+            "COLUMN",
+            "SCATTER",
+            "COMBO",
+            "STEPPED_AREA"
+          ],
+          "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.",
+          "type": "string",
+          "enumDescriptions": [
+            "Default value, do not use.",
+            "A \u003ca href=\"/chart/interactive/docs/gallery/barchart\"\u003ebar chart\u003c/a\u003e.",
+            "A \u003ca href=\"/chart/interactive/docs/gallery/linechart\"\u003eline chart\u003c/a\u003e.",
+            "An \u003ca href=\"/chart/interactive/docs/gallery/areachart\"\u003earea chart\u003c/a\u003e.",
+            "A \u003ca href=\"/chart/interactive/docs/gallery/columnchart\"\u003ecolumn chart\u003c/a\u003e.",
+            "A \u003ca href=\"/chart/interactive/docs/gallery/scatterchart\"\u003escatter\nchart\u003c/a\u003e.",
+            "A \u003ca href=\"/chart/interactive/docs/gallery/combochart\"\u003ecombo chart\u003c/a\u003e.",
+            "A \u003ca href=\"/chart/interactive/docs/gallery/steppedareachart\"\u003estepped area\nchart\u003c/a\u003e."
+          ]
         },
-        "maxpoint": {
-          "$ref": "InterpolationPoint",
-          "description": "The final interpolation point."
+        "targetAxis": {
+          "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."
+          ],
+          "enum": [
+            "BASIC_CHART_AXIS_POSITION_UNSPECIFIED",
+            "BOTTOM_AXIS",
+            "LEFT_AXIS",
+            "RIGHT_AXIS"
+          ],
+          "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"
+        },
+        "color": {
+          "description": "The color for elements (i.e. bars, lines, points) associated with this\nseries.  If empty, a default color is used.",
+          "$ref": "Color"
+        },
+        "lineStyle": {
+          "$ref": "LineStyle",
+          "description": "The line style of this series. Valid only if the\nchartType is AREA,\nLINE, or SCATTER.\nCOMBO charts are also supported if the\nseries chart type is\nAREA or LINE."
         }
       }
     },
-    "ClearValuesRequest": {
-      "type": "object",
-      "properties": {},
-      "id": "ClearValuesRequest",
-      "description": "The request for clearing a range of values in a spreadsheet."
-    },
-    "SetBasicFilterRequest": {
+    "AutoResizeDimensionsRequest": {
       "type": "object",
       "properties": {
-        "filter": {
-          "$ref": "BasicFilter",
-          "description": "The filter to set."
+        "dimensions": {
+          "$ref": "DimensionRange",
+          "description": "The dimensions to automatically resize."
         }
       },
-      "id": "SetBasicFilterRequest",
-      "description": "Sets the basic filter associated with a sheet."
+      "id": "AutoResizeDimensionsRequest",
+      "description": "Automatically resizes one or more dimensions based on the contents\nof the cells in that dimension."
     },
-    "BatchClearValuesByDataFilterRequest": {
-      "description": "The request for clearing more than one range selected by a\nDataFilter in a spreadsheet.",
+    "UpdateBordersRequest": {
+      "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.",
       "type": "object",
       "properties": {
-        "dataFilters": {
-          "description": "The DataFilters used to determine which ranges to clear.",
-          "type": "array",
-          "items": {
-            "$ref": "DataFilter"
-          }
+        "bottom": {
+          "$ref": "Border",
+          "description": "The border to put at the bottom of the range."
+        },
+        "innerVertical": {
+          "description": "The vertical border to put within the range.",
+          "$ref": "Border"
+        },
+        "right": {
+          "$ref": "Border",
+          "description": "The border to put at the right of the range."
+        },
+        "range": {
+          "$ref": "GridRange",
+          "description": "The range whose borders should be updated."
+        },
+        "innerHorizontal": {
+          "description": "The horizontal border to put within the range.",
+          "$ref": "Border"
+        },
+        "top": {
+          "$ref": "Border",
+          "description": "The border to put at the top of the range."
+        },
+        "left": {
+          "description": "The border to put at the left of the range.",
+          "$ref": "Border"
         }
       },
-      "id": "BatchClearValuesByDataFilterRequest"
+      "id": "UpdateBordersRequest"
     },
-    "GetSpreadsheetByDataFilterRequest": {
+    "CellFormat": {
+      "description": "The format of a cell.",
       "type": "object",
       "properties": {
-        "includeGridData": {
-          "description": "True if grid data should be returned.\nThis parameter is ignored if a field mask was set in the request.",
-          "type": "boolean"
+        "numberFormat": {
+          "description": "A format describing how number values should be represented to the user.",
+          "$ref": "NumberFormat"
         },
-        "dataFilters": {
-          "description": "The DataFilters used to select which ranges to retrieve from\nthe spreadsheet.",
-          "type": "array",
-          "items": {
-            "$ref": "DataFilter"
-          }
+        "hyperlinkDisplayType": {
+          "description": "How a hyperlink, if it exists, should be displayed in the cell.",
+          "type": "string",
+          "enumDescriptions": [
+            "The default value: the hyperlink is rendered. Do not use this.",
+            "A hyperlink should be explicitly rendered.",
+            "A hyperlink should not be rendered."
+          ],
+          "enum": [
+            "HYPERLINK_DISPLAY_TYPE_UNSPECIFIED",
+            "LINKED",
+            "PLAIN_TEXT"
+          ]
+        },
+        "horizontalAlignment": {
+          "description": "The horizontal alignment of the value in the cell.",
+          "type": "string",
+          "enumDescriptions": [
+            "The horizontal alignment is not specified. Do not use this.",
+            "The text is explicitly aligned to the left of the cell.",
+            "The text is explicitly aligned to the center of the cell.",
+            "The text is explicitly aligned to the right of the cell."
+          ],
+          "enum": [
+            "HORIZONTAL_ALIGN_UNSPECIFIED",
+            "LEFT",
+            "CENTER",
+            "RIGHT"
+          ]
+        },
+        "textFormat": {
+          "description": "The format of the text in the cell (unless overridden by a format run).",
+          "$ref": "TextFormat"
+        },
+        "backgroundColor": {
+          "$ref": "Color",
+          "description": "The background color of the cell."
+        },
+        "padding": {
+          "$ref": "Padding",
+          "description": "The padding of the cell."
+        },
+        "verticalAlignment": {
+          "enum": [
+            "VERTICAL_ALIGN_UNSPECIFIED",
+            "TOP",
+            "MIDDLE",
+            "BOTTOM"
+          ],
+          "description": "The vertical alignment of the value in the cell.",
+          "type": "string",
+          "enumDescriptions": [
+            "The vertical alignment is not specified.  Do not use this.",
+            "The text is explicitly aligned to the top of the cell.",
+            "The text is explicitly aligned to the middle of the cell.",
+            "The text is explicitly aligned to the bottom of the cell."
+          ]
+        },
+        "borders": {
+          "description": "The borders of the cell.",
+          "$ref": "Borders"
+        },
+        "textDirection": {
+          "enum": [
+            "TEXT_DIRECTION_UNSPECIFIED",
+            "LEFT_TO_RIGHT",
+            "RIGHT_TO_LEFT"
+          ],
+          "description": "The direction of the text in the cell.",
+          "type": "string",
+          "enumDescriptions": [
+            "The text direction is not specified. Do not use this.",
+            "The text direction of left-to-right was set by the user.",
+            "The text direction of right-to-left was set by the user."
+          ]
+        },
+        "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": {
+          "$ref": "TextRotation",
+          "description": "The rotation applied to text in a cell"
         }
       },
-      "id": "GetSpreadsheetByDataFilterRequest",
-      "description": "The request for retrieving a Spreadsheet."
+      "id": "CellFormat"
     },
-    "DeleteEmbeddedObjectRequest": {
-      "id": "DeleteEmbeddedObjectRequest",
-      "description": "Deletes the embedded object with the given ID.",
+    "ClearValuesResponse": {
+      "description": "The response when clearing a range of values in a spreadsheet.",
       "type": "object",
       "properties": {
-        "objectId": {
-          "description": "The ID of the embedded object to delete.",
-          "format": "int32",
-          "type": "integer"
+        "spreadsheetId": {
+          "description": "The spreadsheet the updates were applied to.",
+          "type": "string"
+        },
+        "clearedRange": {
+          "type": "string",
+          "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.)"
         }
-      }
+      },
+      "id": "ClearValuesResponse"
     },
-    "UpdateValuesByDataFilterResponse": {
-      "description": "The response when updating a range of values by a data filter in a\nspreadsheet.",
+    "WaterfallChartCustomSubtotal": {
+      "description": "A custom subtotal column for a waterfall chart series.",
       "type": "object",
       "properties": {
-        "updatedCells": {
-          "type": "integer",
-          "description": "The number of cells updated.",
-          "format": "int32"
-        },
-        "dataFilter": {
-          "$ref": "DataFilter",
-          "description": "The data filter that selected the range that was updated."
+        "label": {
+          "description": "A label for the subtotal column.",
+          "type": "string"
         },
-        "updatedRows": {
-          "description": "The number of rows where at least one cell in the row was updated.",
+        "subtotalIndex": {
+          "description": "The 0-based index of a data point within the series. If\ndata_is_subtotal is true, the data point at this index is the\nsubtotal. Otherwise, the subtotal appears after the data point with\nthis index. A series can have multiple subtotals at arbitrary indices,\nbut subtotals do not affect the indices of the data points. For\nexample, if a series has three data points, their indices will always\nbe 0, 1, and 2, regardless of how many subtotals exist on the series or\nwhat data points they are associated with.",
           "format": "int32",
           "type": "integer"
         },
-        "updatedData": {
-          "$ref": "ValueRange",
-          "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`."
-        },
-        "updatedColumns": {
-          "type": "integer",
-          "description": "The number of columns where at least one cell in the column was updated.",
-          "format": "int32"
-        },
-        "updatedRange": {
-          "description": "The range (in A1 notation) that updates were applied to.",
-          "type": "string"
+        "dataIsSubtotal": {
+          "type": "boolean",
+          "description": "True if the data point at subtotal_index is the subtotal. If false,\nthe subtotal will be computed and appear after the data point."
         }
       },
-      "id": "UpdateValuesByDataFilterResponse"
+      "id": "WaterfallChartCustomSubtotal"
     },
-    "DeleteSheetRequest": {
+    "ChartData": {
+      "description": "The data included in a domain or series.",
       "type": "object",
       "properties": {
-        "sheetId": {
-          "description": "The ID of the sheet to delete.",
-          "format": "int32",
-          "type": "integer"
+        "sourceRange": {
+          "$ref": "ChartSourceRange",
+          "description": "The source ranges of the data."
         }
       },
-      "id": "DeleteSheetRequest",
-      "description": "Deletes the requested sheet."
+      "id": "ChartData"
     },
-    "MatchedValueRange": {
+    "BatchGetValuesResponse": {
+      "id": "BatchGetValuesResponse",
+      "description": "The response when retrieving more than one range of values in a spreadsheet.",
       "type": "object",
       "properties": {
-        "valueRange": {
-          "description": "The values matched by the DataFilter.",
-          "$ref": "ValueRange"
+        "spreadsheetId": {
+          "description": "The ID of the spreadsheet the data was retrieved from.",
+          "type": "string"
         },
-        "dataFilters": {
-          "description": "The DataFilters from the request that matched the range of\nvalues.",
+        "valueRanges": {
           "type": "array",
           "items": {
-            "$ref": "DataFilter"
-          }
+            "$ref": "ValueRange"
+          },
+          "description": "The requested values. The order of the ValueRanges is the same as the\norder of the requested ranges."
         }
-      },
-      "id": "MatchedValueRange",
-      "description": "A value range that was matched by one or more data filers."
+      }
     },
-    "DeveloperMetadataLocation": {
-      "id": "DeveloperMetadataLocation",
-      "description": "A location where metadata may be associated in a spreadsheet.",
+    "UpdateBandingRequest": {
+      "description": "Updates properties of the supplied banded range.",
       "type": "object",
       "properties": {
-        "dimensionRange": {
-          "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.",
-          "$ref": "DimensionRange"
+        "fields": {
+          "type": "string",
+          "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.",
+          "format": "google-fieldmask"
         },
-        "spreadsheet": {
-          "type": "boolean",
-          "description": "True when metadata is associated with an entire spreadsheet."
+        "bandedRange": {
+          "$ref": "BandedRange",
+          "description": "The banded range to update with the new properties."
+        }
+      },
+      "id": "UpdateBandingRequest"
+    },
+    "Color": {
+      "id": "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.\n\nNote: this proto does not carry information about the absolute color space\nthat should be used to interpret the RGB value (e.g. sRGB, Adobe RGB,\nDCI-P3, BT.2020, etc.). By default, applications SHOULD assume the sRGB color\nspace.\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"
         },
-        "sheetId": {
-          "description": "The ID of the sheet when metadata is associated with an entire sheet.",
-          "format": "int32",
-          "type": "integer"
+        "blue": {
+          "type": "number",
+          "description": "The amount of blue in the color as a value in the interval [0, 1].",
+          "format": "float"
         },
-        "locationType": {
+        "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"
+        }
+      }
+    },
+    "TrimWhitespaceRequest": {
+      "id": "TrimWhitespaceRequest",
+      "description": "Trims the whitespace (such as spaces, tabs, or new lines) in every cell in\nthe specified range. This request removes all whitespace from the start and\nend of each cell's text, and reduces any subsequence of remaining whitespace\ncharacters to a single space. If the resulting trimmed text starts with a '+'\nor '=' character, the text remains as a string value and isn't interpreted\nas a formula.",
+      "type": "object",
+      "properties": {
+        "range": {
+          "$ref": "GridRange",
+          "description": "The range whose cells to trim."
+        }
+      }
+    },
+    "ChartSourceRange": {
+      "description": "Source ranges for a chart.",
+      "type": "object",
+      "properties": {
+        "sources": {
+          "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 in order and contiguous across the domain\nand 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",
+          "type": "array",
+          "items": {
+            "$ref": "GridRange"
+          }
+        }
+      },
+      "id": "ChartSourceRange"
+    },
+    "ValueRange": {
+      "description": "Data within a range of the spreadsheet.",
+      "type": "object",
+      "properties": {
+        "range": {
+          "type": "string",
+          "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."
+        },
+        "majorDimension": {
+          "type": "string",
           "enumDescriptions": [
-            "Default value.",
-            "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."
+            "The default value, do not use.",
+            "Operates on the rows of a sheet.",
+            "Operates on the columns of a sheet."
           ],
           "enum": [
-            "DEVELOPER_METADATA_LOCATION_TYPE_UNSPECIFIED",
-            "ROW",
-            "COLUMN",
-            "SHEET",
-            "SPREADSHEET"
+            "DIMENSION_UNSPECIFIED",
+            "ROWS",
+            "COLUMNS"
           ],
-          "description": "The type of location this object represents.  This field is read-only.",
-          "type": "string"
+          "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."
+        },
+        "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.",
+          "type": "array",
+          "items": {
+            "type": "array",
+            "items": {
+              "type": "any"
+            }
+          }
         }
-      }
+      },
+      "id": "ValueRange"
     },
-    "DuplicateSheetRequest": {
-      "description": "Duplicates the contents of a sheet.",
+    "AddBandingRequest": {
       "type": "object",
       "properties": {
-        "insertSheetIndex": {
-          "description": "The zero-based index where the new sheet should be inserted.\nThe index of all sheets after this are incremented.",
-          "format": "int32",
-          "type": "integer"
-        },
-        "newSheetName": {
-          "description": "The name of the new sheet.  If empty, a new name is chosen for you.",
-          "type": "string"
-        },
-        "sourceSheetId": {
-          "description": "The sheet to duplicate.",
-          "format": "int32",
-          "type": "integer"
-        },
-        "newSheetId": {
-          "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.",
-          "format": "int32",
-          "type": "integer"
+        "bandedRange": {
+          "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.)",
+          "$ref": "BandedRange"
         }
       },
-      "id": "DuplicateSheetRequest"
+      "id": "AddBandingRequest",
+      "description": "Adds a new banded range to the spreadsheet."
     },
-    "TreemapChartSpec": {
-      "description": "A \u003ca href=\"/chart/interactive/docs/gallery/treemap\"\u003eTreemap chart\u003c/a\u003e.",
+    "Response": {
       "type": "object",
       "properties": {
-        "sizeData": {
-          "$ref": "ChartData",
-          "description": "The data that determines the size of each treemap data cell. This data is\nexpected to be numeric. The cells corresponding to non-numeric or missing\ndata will not be rendered. If color_data is not specified, this data\nis used to determine data cell background colors as well."
+        "addSheet": {
+          "$ref": "AddSheetResponse",
+          "description": "A reply from adding a sheet."
         },
-        "textFormat": {
-          "$ref": "TextFormat",
-          "description": "The text format for all labels on the chart."
+        "updateConditionalFormatRule": {
+          "$ref": "UpdateConditionalFormatRuleResponse",
+          "description": "A reply from updating a conditional format rule."
         },
-        "parentLabels": {
-          "$ref": "ChartData",
-          "description": "The data the contains the treemap cells' parent labels."
+        "createDeveloperMetadata": {
+          "$ref": "CreateDeveloperMetadataResponse",
+          "description": "A reply from creating a developer metadata entry."
         },
-        "headerColor": {
-          "$ref": "Color",
-          "description": "The background color for header cells."
+        "addNamedRange": {
+          "$ref": "AddNamedRangeResponse",
+          "description": "A reply from adding a named range."
         },
-        "labels": {
-          "$ref": "ChartData",
-          "description": "The data that contains the treemap cell labels."
+        "deleteDeveloperMetadata": {
+          "$ref": "DeleteDeveloperMetadataResponse",
+          "description": "A reply from deleting a developer metadata entry."
         },
-        "colorData": {
-          "$ref": "ChartData",
-          "description": "The data that determines the background color of each treemap data cell.\nThis field is optional. If not specified, size_data is used to\ndetermine background colors. If specified, the data is expected to be\nnumeric. color_scale will determine how the values in this data map to\ndata cell background colors."
+        "trimWhitespace": {
+          "description": "A reply from trimming whitespace.",
+          "$ref": "TrimWhitespaceResponse"
         },
-        "colorScale": {
-          "$ref": "TreemapChartColorScale",
-          "description": "The color scale for data cells in the treemap chart. Data cells are\nassigned colors based on their color values. These color values come from\ncolor_data, or from size_data if color_data is not specified.\nCells with color values less than or equal to min_value will\nhave minValueColor as their\nbackground color. Cells with color values greater than or equal to\nmax_value will have\nmaxValueColor as their background\ncolor. Cells with color values between min_value and max_value will\nhave background colors on a gradient between\nminValueColor and\nmaxValueColor, the midpoint of\nthe gradient being midValueColor.\nCells with missing or non-numeric color values will have\nnoDataColor as their background\ncolor."
+        "deleteDuplicates": {
+          "$ref": "DeleteDuplicatesResponse",
+          "description": "A reply from removing rows containing duplicate values."
         },
-        "maxValue": {
-          "description": "The maximum possible data value. Cells with values greater than this will\nhave the same color as cells with this value. If not specified, defaults\nto the actual maximum value from color_data, or the maximum value from\nsize_data if color_data is not specified.",
-          "format": "double",
-          "type": "number"
+        "addFilterView": {
+          "$ref": "AddFilterViewResponse",
+          "description": "A reply from adding a filter view."
         },
-        "hideTooltips": {
-          "type": "boolean",
-          "description": "True to hide tooltips."
+        "addBanding": {
+          "$ref": "AddBandingResponse",
+          "description": "A reply from adding a banded range."
         },
-        "hintedLevels": {
-          "type": "integer",
-          "description": "The number of additional data levels beyond the labeled levels to be shown\non the treemap chart. These levels are not interactive and are shown\nwithout their labels. Defaults to 0 if not specified.",
-          "format": "int32"
+        "addProtectedRange": {
+          "$ref": "AddProtectedRangeResponse",
+          "description": "A reply from adding a protected range."
         },
-        "minValue": {
-          "description": "The minimum possible data value. Cells with values less than this will\nhave the same color as cells with this value. If not specified, defaults\nto the actual minimum value from color_data, or the minimum value from\nsize_data if color_data is not specified.",
-          "format": "double",
-          "type": "number"
+        "duplicateSheet": {
+          "description": "A reply from duplicating a sheet.",
+          "$ref": "DuplicateSheetResponse"
         },
-        "levels": {
-          "description": "The number of data levels to show on the treemap chart. These levels are\ninteractive and are shown with their labels. Defaults to 2 if not\nspecified.",
-          "format": "int32",
-          "type": "integer"
-        }
-      },
-      "id": "TreemapChartSpec"
-    },
-    "ExtendedValue": {
-      "id": "ExtendedValue",
-      "description": "The kinds of value that a cell in a spreadsheet can have.",
-      "type": "object",
-      "properties": {
-        "numberValue": {
-          "description": "Represents a double value.\nNote: Dates, Times and DateTimes are represented as doubles in\n\"serial number\" format.",
-          "format": "double",
-          "type": "number"
+        "deleteConditionalFormatRule": {
+          "$ref": "DeleteConditionalFormatRuleResponse",
+          "description": "A reply from deleting a conditional format rule."
         },
-        "errorValue": {
-          "$ref": "ErrorValue",
-          "description": "Represents an error.\nThis field is read-only."
+        "updateEmbeddedObjectPosition": {
+          "$ref": "UpdateEmbeddedObjectPositionResponse",
+          "description": "A reply from updating an embedded object's position."
         },
-        "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\"`.",
-          "type": "string"
+        "addSlicer": {
+          "$ref": "AddSlicerResponse",
+          "description": "A reply from adding a slicer."
         },
-        "boolValue": {
-          "description": "Represents a boolean value.",
-          "type": "boolean"
+        "deleteDimensionGroup": {
+          "description": "A reply from deleting a dimension group.",
+          "$ref": "DeleteDimensionGroupResponse"
         },
-        "formulaValue": {
-          "description": "Represents a formula.",
-          "type": "string"
-        }
-      }
-    },
-    "BatchClearValuesResponse": {
-      "type": "object",
-      "properties": {
-        "spreadsheetId": {
-          "description": "The spreadsheet the updates were applied to.",
-          "type": "string"
+        "duplicateFilterView": {
+          "$ref": "DuplicateFilterViewResponse",
+          "description": "A reply from duplicating a filter view."
         },
-        "clearedRanges": {
-          "type": "array",
-          "items": {
-            "type": "string"
-          },
-          "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.)"
+        "addDimensionGroup": {
+          "description": "A reply from adding a dimension group.",
+          "$ref": "AddDimensionGroupResponse"
+        },
+        "addChart": {
+          "description": "A reply from adding a chart.",
+          "$ref": "AddChartResponse"
+        },
+        "updateDeveloperMetadata": {
+          "description": "A reply from updating a developer metadata entry.",
+          "$ref": "UpdateDeveloperMetadataResponse"
+        },
+        "findReplace": {
+          "description": "A reply from doing a find/replace.",
+          "$ref": "FindReplaceResponse"
         }
       },
-      "id": "BatchClearValuesResponse",
-      "description": "The response when clearing a range of values in a spreadsheet."
+      "id": "Response",
+      "description": "A single response from an update."
     },
-    "DataFilter": {
+    "InsertRangeRequest": {
       "type": "object",
       "properties": {
-        "gridRange": {
-          "description": "Selects data that matches the range described by the GridRange.",
-          "$ref": "GridRange"
-        },
-        "developerMetadataLookup": {
-          "$ref": "DeveloperMetadataLookup",
-          "description": "Selects data associated with the developer metadata matching the criteria\ndescribed by this DeveloperMetadataLookup."
+        "shiftDimension": {
+          "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"
+          ],
+          "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."
         },
-        "a1Range": {
-          "description": "Selects data that matches the specified A1 range.",
-          "type": "string"
+        "range": {
+          "$ref": "GridRange",
+          "description": "The range to insert new cells into."
         }
       },
-      "id": "DataFilter",
-      "description": "Filter that describes what data should be selected or returned from a\nrequest."
+      "id": "InsertRangeRequest",
+      "description": "Inserts cells into a range, shifting the existing cells over or down."
     },
-    "TextFormat": {
+    "EmbeddedChart": {
+      "description": "A chart embedded in a sheet.",
       "type": "object",
       "properties": {
-        "fontFamily": {
-          "type": "string",
-          "description": "The font family."
-        },
-        "strikethrough": {
-          "description": "True if the text has a strikethrough.",
-          "type": "boolean"
-        },
-        "italic": {
-          "description": "True if the text is italicized.",
-          "type": "boolean"
-        },
-        "fontSize": {
-          "type": "integer",
-          "description": "The size of the font.",
-          "format": "int32"
-        },
-        "underline": {
-          "type": "boolean",
-          "description": "True if the text is underlined."
+        "chartId": {
+          "description": "The ID of the chart.",
+          "format": "int32",
+          "type": "integer"
         },
-        "bold": {
-          "description": "True if the text is bold.",
-          "type": "boolean"
+        "position": {
+          "$ref": "EmbeddedObjectPosition",
+          "description": "The position of the chart."
         },
-        "foregroundColor": {
-          "$ref": "Color",
-          "description": "The foreground color of the text."
+        "spec": {
+          "$ref": "ChartSpec",
+          "description": "The specification of the chart."
         }
       },
-      "id": "TextFormat",
-      "description": "The format of a run of text in a cell.\nAbsent values indicate that the field isn't specified."
+      "id": "EmbeddedChart"
     },
-    "DeleteDuplicatesRequest": {
-      "description": "Removes rows within this range that contain values in the specified columns\nthat are duplicates of values in any previous row. Rows with identical values\nbut different letter cases, formatting, or formulas are considered to be\nduplicates.\n\nThis request also removes duplicate rows hidden from view (for example, due\nto a filter). When removing duplicates, the first instance of each duplicate\nrow scanning from the top downwards is kept in the resulting range. Content\noutside of the specified range isn't removed, and rows considered duplicates\ndo not have to be adjacent to each other in the range.",
+    "AddNamedRangeResponse": {
+      "id": "AddNamedRangeResponse",
+      "description": "The result of adding a named range.",
       "type": "object",
       "properties": {
-        "range": {
-          "description": "The range to remove duplicates rows from.",
-          "$ref": "GridRange"
-        },
-        "comparisonColumns": {
-          "description": "The columns in the range to analyze for duplicate values. If no columns are\nselected then all columns are analyzed for duplicates.",
-          "type": "array",
-          "items": {
-            "$ref": "DimensionRange"
-          }
+        "namedRange": {
+          "$ref": "NamedRange",
+          "description": "The named range to add."
         }
-      },
-      "id": "DeleteDuplicatesRequest"
+      }
     },
-    "RepeatCellRequest": {
-      "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.",
+    "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.",
       "type": "object",
       "properties": {
-        "range": {
-          "description": "The range to repeat the cell in.",
-          "$ref": "GridRange"
-        },
-        "fields": {
-          "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.",
-          "format": "google-fieldmask",
-          "type": "string"
-        },
-        "cell": {
-          "$ref": "CellData",
-          "description": "The data to write."
+        "properties": {
+          "$ref": "SheetProperties",
+          "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": "RepeatCellRequest"
+      "id": "AddSheetRequest"
     },
-    "UpdateSpreadsheetPropertiesRequest": {
-      "id": "UpdateSpreadsheetPropertiesRequest",
-      "description": "Updates properties of a spreadsheet.",
+    "DeleteConditionalFormatRuleResponse": {
+      "id": "DeleteConditionalFormatRuleResponse",
+      "description": "The result of deleting a conditional format rule.",
       "type": "object",
       "properties": {
-        "properties": {
-          "$ref": "SpreadsheetProperties",
-          "description": "The properties to update."
-        },
-        "fields": {
-          "type": "string",
-          "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.",
-          "format": "google-fieldmask"
+        "rule": {
+          "$ref": "ConditionalFormatRule",
+          "description": "The rule that was deleted."
         }
       }
     },
-    "ProtectedRange": {
+    "AddSlicerRequest": {
+      "description": "Adds a slicer to a sheet in the spreadsheet.",
       "type": "object",
       "properties": {
-        "requestingUserCanEdit": {
-          "description": "True if the user who requested this protected range can edit the\nprotected area.\nThis field is read-only.",
-          "type": "boolean"
-        },
-        "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."
-        },
-        "editors": {
-          "$ref": "Editors",
-          "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."
-        },
-        "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.",
-          "type": "array",
-          "items": {
-            "$ref": "GridRange"
-          }
-        },
-        "namedRangeId": {
-          "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"
+        "slicer": {
+          "$ref": "Slicer",
+          "description": "The slicer that should be added to the spreadsheet, including\nthe position where it should be placed. The slicerId field is optional; if one is not set, an id\nwill be randomly generated. (It is an error to specify the ID\nof a slicer that already exists.)"
+        }
+      },
+      "id": "AddSlicerRequest"
+    },
+    "GridCoordinate": {
+      "type": "object",
+      "properties": {
+        "sheetId": {
+          "type": "integer",
+          "description": "The sheet this coordinate is on.",
+          "format": "int32"
         },
-        "protectedRangeId": {
-          "description": "The ID of the protected range.\nThis field is read-only.",
+        "rowIndex": {
+          "description": "The row index of the coordinate.",
           "format": "int32",
           "type": "integer"
         },
-        "warningOnly": {
-          "type": "boolean",
-          "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."
+        "columnIndex": {
+          "description": "The column index of the coordinate.",
+          "format": "int32",
+          "type": "integer"
         }
       },
-      "id": "ProtectedRange",
-      "description": "A protected range."
+      "id": "GridCoordinate",
+      "description": "A coordinate in a sheet.\nAll indexes are zero-based."
     },
-    "DimensionProperties": {
-      "id": "DimensionProperties",
-      "description": "Properties about a dimension.",
+    "UpdateSheetPropertiesRequest": {
+      "description": "Updates properties of the sheet with the specified\nsheetId.",
       "type": "object",
       "properties": {
-        "pixelSize": {
-          "description": "The height (if a row) or width (if a column) of the dimension in pixels.",
-          "format": "int32",
-          "type": "integer"
-        },
-        "hiddenByFilter": {
-          "description": "True if this dimension is being filtered.\nThis field is read-only.",
-          "type": "boolean"
-        },
-        "hiddenByUser": {
-          "description": "True if this dimension is explicitly hidden.",
-          "type": "boolean"
+        "properties": {
+          "$ref": "SheetProperties",
+          "description": "The properties to update."
         },
-        "developerMetadata": {
-          "description": "The developer metadata associated with a single row or column.",
-          "type": "array",
-          "items": {
-            "$ref": "DeveloperMetadata"
-          }
+        "fields": {
+          "type": "string",
+          "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.",
+          "format": "google-fieldmask"
         }
-      }
+      },
+      "id": "UpdateSheetPropertiesRequest"
     },
-    "DimensionRange": {
-      "id": "DimensionRange",
-      "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.",
+    "GridProperties": {
+      "description": "Properties of a grid.",
       "type": "object",
       "properties": {
-        "sheetId": {
-          "description": "The sheet this span is on.",
+        "frozenRowCount": {
+          "description": "The number of rows that are frozen in the grid.",
           "format": "int32",
           "type": "integer"
         },
-        "dimension": {
-          "description": "The dimension of the span.",
-          "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"
-          ]
+        "columnCount": {
+          "type": "integer",
+          "description": "The number of columns in the grid.",
+          "format": "int32"
         },
-        "startIndex": {
-          "description": "The start (inclusive) of the span, or not set if unbounded.",
+        "frozenColumnCount": {
+          "description": "The number of columns that are frozen in the grid.",
           "format": "int32",
           "type": "integer"
         },
-        "endIndex": {
-          "description": "The end (exclusive) of the span, or not set if unbounded.",
+        "columnGroupControlAfter": {
+          "description": "True if the column grouping control toggle is shown after the group.",
+          "type": "boolean"
+        },
+        "rowGroupControlAfter": {
+          "description": "True if the row grouping control toggle is shown after the group.",
+          "type": "boolean"
+        },
+        "rowCount": {
+          "description": "The number of rows in the grid.",
           "format": "int32",
           "type": "integer"
-        }
-      }
-    },
-    "NamedRange": {
-      "type": "object",
-      "properties": {
-        "namedRangeId": {
-          "type": "string",
-          "description": "The ID of the named range."
-        },
-        "range": {
-          "$ref": "GridRange",
-          "description": "The range this represents."
         },
-        "name": {
-          "type": "string",
-          "description": "The name of the named range."
+        "hideGridlines": {
+          "description": "True if the grid isn't showing gridlines in the UI.",
+          "type": "boolean"
         }
       },
-      "id": "NamedRange",
-      "description": "A named range."
+      "id": "GridProperties"
     },
-    "ChartCustomNumberFormatOptions": {
-      "id": "ChartCustomNumberFormatOptions",
-      "description": "Custom number formatting options for chart attributes.",
+    "AddSlicerResponse": {
+      "id": "AddSlicerResponse",
+      "description": "The result of adding a slicer to a spreadsheet.",
       "type": "object",
       "properties": {
-        "prefix": {
-          "description": "Custom prefix to be prepended to the chart attribute.\nThis field is optional.",
-          "type": "string"
-        },
-        "suffix": {
-          "description": "Custom suffix to be appended to the chart attribute.\nThis field is optional.",
-          "type": "string"
+        "slicer": {
+          "$ref": "Slicer",
+          "description": "The newly added slicer."
         }
       }
     },
-    "Borders": {
-      "id": "Borders",
-      "description": "The borders of the cell.",
+    "Sheet": {
+      "description": "A sheet in a spreadsheet.",
       "type": "object",
       "properties": {
-        "left": {
-          "$ref": "Border",
-          "description": "The left border of the cell."
-        },
-        "right": {
-          "$ref": "Border",
-          "description": "The right border of the cell."
+        "charts": {
+          "description": "The specifications of every chart on this sheet.",
+          "type": "array",
+          "items": {
+            "$ref": "EmbeddedChart"
+          }
         },
-        "bottom": {
-          "$ref": "Border",
-          "description": "The bottom border of the cell."
+        "filterViews": {
+          "description": "The filter views in this sheet.",
+          "type": "array",
+          "items": {
+            "$ref": "FilterView"
+          }
         },
-        "top": {
-          "$ref": "Border",
-          "description": "The top border of the cell."
+        "slicers": {
+          "description": "The slicers on this sheet.",
+          "type": "array",
+          "items": {
+            "$ref": "Slicer"
+          }
+        },
+        "rowGroups": {
+          "description": "All row groups on this sheet, ordered by increasing range start index, then\nby group depth.",
+          "type": "array",
+          "items": {
+            "$ref": "DimensionGroup"
+          }
+        },
+        "data": {
+          "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).",
+          "type": "array",
+          "items": {
+            "$ref": "GridData"
+          }
+        },
+        "properties": {
+          "description": "The properties of the sheet.",
+          "$ref": "SheetProperties"
+        },
+        "developerMetadata": {
+          "description": "The developer metadata associated with a sheet.",
+          "type": "array",
+          "items": {
+            "$ref": "DeveloperMetadata"
+          }
+        },
+        "protectedRanges": {
+          "description": "The protected ranges in this sheet.",
+          "type": "array",
+          "items": {
+            "$ref": "ProtectedRange"
+          }
+        },
+        "conditionalFormats": {
+          "description": "The conditional format rules in this sheet.",
+          "type": "array",
+          "items": {
+            "$ref": "ConditionalFormatRule"
+          }
+        },
+        "columnGroups": {
+          "description": "All column groups on this sheet, ordered by increasing range start index,\nthen by group depth.",
+          "type": "array",
+          "items": {
+            "$ref": "DimensionGroup"
+          }
+        },
+        "basicFilter": {
+          "$ref": "BasicFilter",
+          "description": "The filter on this sheet, if any."
+        },
+        "merges": {
+          "type": "array",
+          "items": {
+            "$ref": "GridRange"
+          },
+          "description": "The ranges that are merged together."
+        },
+        "bandedRanges": {
+          "type": "array",
+          "items": {
+            "$ref": "BandedRange"
+          },
+          "description": "The banded (alternating colors) ranges on this sheet."
         }
-      }
+      },
+      "id": "Sheet"
     },
-    "ManualRule": {
+    "PivotGroupValueMetadata": {
+      "description": "Metadata about a value in a pivot grouping.",
       "type": "object",
       "properties": {
-        "groups": {
-          "description": "The list of group names and the corresponding items from the source data\nthat map to each group name.",
+        "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.)"
+        },
+        "collapsed": {
+          "description": "True if the data corresponding to the value is collapsed.",
+          "type": "boolean"
+        }
+      },
+      "id": "PivotGroupValueMetadata"
+    },
+    "FilterCriteria": {
+      "description": "Criteria for showing/hiding rows in a filter or filter view.",
+      "type": "object",
+      "properties": {
+        "visibleForegroundColor": {
+          "$ref": "Color",
+          "description": "The text color to filter by; only cells with this text color are shown.\nMutually exclusive with all other filter criteria. Requests to set this\nfield will fail with a 400 error if any other filter criteria field is set."
+        },
+        "hiddenValues": {
+          "description": "Values that should be hidden.",
           "type": "array",
           "items": {
-            "$ref": "ManualRuleGroup"
+            "type": "string"
           }
+        },
+        "condition": {
+          "$ref": "BooleanCondition",
+          "description": "A condition that must be true for values to be shown.\n(This does not override hidden_values -- if a value is listed there,\n it will still be hidden.)"
+        },
+        "visibleBackgroundColor": {
+          "description": "The background fill color to filter by; only cells with this fill color are\nshown. Mutually exclusive with all other filter criteria. Requests to set\nthis field will fail with a 400 error if any other filter criteria field is\nset.",
+          "$ref": "Color"
         }
       },
-      "id": "ManualRule",
-      "description": "Allows you to manually organize the values in a source data column into\nbuckets with names of your choosing. For example, a pivot table that\naggregates population by state:\n\n    +-------+-------------------+\n    | State | SUM of Population |\n    +-------+-------------------+\n    | AK    |               0.7 |\n    | AL    |               4.8 |\n    | AR    |               2.9 |\n    ...\n    +-------+-------------------+\ncould be turned into a pivot table that aggregates population by time zone\nby providing a list of groups (for example, groupName = 'Central',\nitems = ['AL', 'AR', 'IA', ...]) to a manual group rule.\nNote that a similar effect could be achieved by adding a time zone column\nto the source data and adjusting the pivot table.\n\n    +-----------+-------------------+\n    | Time Zone | SUM of Population |\n    +-----------+-------------------+\n    | Central   |             106.3 |\n    | Eastern   |             151.9 |\n    | Mountain  |              17.4 |\n    ...\n    +-----------+-------------------+"
+      "id": "FilterCriteria"
     },
-    "DeleteConditionalFormatRuleRequest": {
-      "id": "DeleteConditionalFormatRuleRequest",
-      "description": "Deletes a conditional format rule at the given index.\nAll subsequent rules' indexes are decremented.",
+    "Editors": {
+      "description": "The editors of a protected range.",
       "type": "object",
       "properties": {
-        "sheetId": {
-          "description": "The sheet the rule is being deleted from.",
-          "format": "int32",
-          "type": "integer"
+        "users": {
+          "description": "The email addresses of users with edit access to the protected range.",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
         },
-        "index": {
-          "type": "integer",
-          "description": "The zero-based index of the rule to be deleted.",
-          "format": "int32"
+        "groups": {
+          "description": "The email addresses of groups with edit access to the protected range.",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "domainUsersCanEdit": {
+          "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"
     },
-    "DeleteNamedRangeRequest": {
-      "id": "DeleteNamedRangeRequest",
-      "description": "Removes the named range with the given ID from the spreadsheet.",
+    "DataValidationRule": {
+      "description": "A data validation rule.",
       "type": "object",
       "properties": {
-        "namedRangeId": {
-          "type": "string",
-          "description": "The ID of the named range to delete."
+        "condition": {
+          "description": "The condition that data in the cell must match.",
+          "$ref": "BooleanCondition"
+        },
+        "showCustomUi": {
+          "description": "True if the UI should be customized based on the kind of condition.\nIf true, \"List\" conditions will show a dropdown.",
+          "type": "boolean"
+        },
+        "strict": {
+          "description": "True if invalid data should be rejected.",
+          "type": "boolean"
+        },
+        "inputMessage": {
+          "description": "A message to show the user when adding data to the cell.",
+          "type": "string"
         }
-      }
+      },
+      "id": "DataValidationRule"
     },
-    "AddBandingResponse": {
-      "description": "The result of adding a banded range.",
+    "TextRotation": {
       "type": "object",
       "properties": {
-        "bandedRange": {
-          "$ref": "BandedRange",
-          "description": "The banded range that was added."
+        "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\ncounterclockwise direction, whereas for RTL they are in the clockwise\ndirection",
+          "format": "int32",
+          "type": "integer"
+        },
+        "vertical": {
+          "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 |",
+          "type": "boolean"
         }
       },
-      "id": "AddBandingResponse"
+      "id": "TextRotation",
+      "description": "The rotation applied to text in a cell."
     },
-    "AddDimensionGroupResponse": {
+    "DeleteDimensionGroupResponse": {
       "type": "object",
       "properties": {
         "dimensionGroups": {
@@ -1342,3053 +1533,3011 @@
           "items": {
             "$ref": "DimensionGroup"
           },
-          "description": "All groups of a dimension after adding a group to that dimension."
+          "description": "All groups of a dimension after deleting a group from that dimension."
         }
       },
-      "id": "AddDimensionGroupResponse",
-      "description": "The result of adding a group."
+      "id": "DeleteDimensionGroupResponse",
+      "description": "The result of deleting a group."
     },
-    "ManualRuleGroup": {
-      "description": "A group name and a list of items from the source data that should be placed\nin the group with this name.",
+    "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",
       "properties": {
-        "items": {
-          "description": "The items in the source data that should be placed into this group. Each\nitem may be a string, number, or boolean. Items may appear in at most one\ngroup within a given ManualRule. Items that do not appear in any\ngroup will appear on their own.",
+        "dataFilters": {
           "type": "array",
           "items": {
-            "$ref": "ExtendedValue"
-          }
+            "$ref": "DataFilter"
+          },
+          "description": "The filters matching the developer metadata entries to update."
         },
-        "groupName": {
-          "description": "The group name, which must be a string. Each group in a given\nManualRule must have a unique group name.",
-          "$ref": "ExtendedValue"
+        "fields": {
+          "type": "string",
+          "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"
+        },
+        "developerMetadata": {
+          "$ref": "DeveloperMetadata",
+          "description": "The value that all metadata matched by the data filters will be updated to."
         }
       },
-      "id": "ManualRuleGroup"
+      "id": "UpdateDeveloperMetadataRequest"
     },
-    "PivotGroup": {
-      "description": "A single grouping (either row or column) in a pivot table.",
+    "PieChartSpec": {
+      "description": "A \u003ca href=\"/chart/interactive/docs/gallery/piechart\"\u003epie chart\u003c/a\u003e.",
       "type": "object",
       "properties": {
-        "groupRule": {
-          "$ref": "PivotGroupRule",
-          "description": "The group rule to apply to this row/column group."
-        },
-        "label": {
-          "type": "string",
-          "description": "The labels to use for the row/column groups which can be customized. For\nexample, in the following pivot table, the row label is `Region` (which\ncould be renamed to `State`) and the column label is `Product` (which\ncould be renamed `Item`). Pivot tables created before December 2017 do\nnot have header labels. If you'd like to add header labels to an existing\npivot table, please delete the existing pivot table and then create a new\npivot table with same parameters.\n\n    +--------------+---------+-------+\n    | SUM of Units | Product |       |\n    | Region       | Pen     | Paper |\n    +--------------+---------+-------+\n    | New York     |     345 |    98 |\n    | Oregon       |     234 |   123 |\n    | Tennessee    |     531 |   415 |\n    +--------------+---------+-------+\n    | Grand Total  |    1110 |   636 |\n    +--------------+---------+-------+"
+        "domain": {
+          "description": "The data that covers the domain of the pie chart.",
+          "$ref": "ChartData"
         },
-        "repeatHeadings": {
-          "description": "True if the headings in this pivot group should be repeated.\nThis is only valid for row groupings and is ignored by columns.\n\nBy default, we minimize repitition of headings by not showing higher\nlevel headings where they are the same. For example, even though the\nthird row below corresponds to \"Q1 Mar\", \"Q1\" is not shown because\nit is redundant with previous rows. Setting repeat_headings to true\nwould cause \"Q1\" to be repeated for \"Feb\" and \"Mar\".\n\n    +--------------+\n    | Q1     | Jan |\n    |        | Feb |\n    |        | Mar |\n    +--------+-----+\n    | Q1 Total     |\n    +--------------+",
-          "type": "boolean"
+        "threeDimensional": {
+          "type": "boolean",
+          "description": "True if the pie is three dimensional."
         },
-        "sourceColumnOffset": {
-          "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",
-          "type": "integer"
+        "series": {
+          "$ref": "ChartData",
+          "description": "The data that covers the one and only series of the pie chart."
         },
-        "sortOrder": {
+        "legendPosition": {
           "enum": [
-            "SORT_ORDER_UNSPECIFIED",
-            "ASCENDING",
-            "DESCENDING"
+            "PIE_CHART_LEGEND_POSITION_UNSPECIFIED",
+            "BOTTOM_LEGEND",
+            "LEFT_LEGEND",
+            "RIGHT_LEGEND",
+            "TOP_LEGEND",
+            "NO_LEGEND",
+            "LABELED_LEGEND"
           ],
-          "description": "The order the values in this group should be sorted.",
+          "description": "Where the legend of the pie chart should be drawn.",
           "type": "string",
           "enumDescriptions": [
-            "Default value, do not use this.",
-            "Sort ascending.",
-            "Sort descending."
+            "Default value, do not use.",
+            "The legend is rendered on the bottom of the chart.",
+            "The legend is rendered on the left of the chart.",
+            "The legend is rendered on the right of the chart.",
+            "The legend is rendered on the top of the chart.",
+            "No legend is rendered.",
+            "Each pie slice has a label attached to it."
           ]
         },
-        "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."
-        },
-        "valueMetadata": {
-          "description": "Metadata about values in the grouping.",
-          "type": "array",
-          "items": {
-            "$ref": "PivotGroupValueMetadata"
-          }
-        },
-        "showTotals": {
-          "type": "boolean",
-          "description": "True if the pivot table should include the totals for this grouping."
+        "pieHole": {
+          "type": "number",
+          "description": "The size of the hole in the pie chart.",
+          "format": "double"
         }
       },
-      "id": "PivotGroup"
+      "id": "PieChartSpec"
     },
-    "TrimWhitespaceResponse": {
-      "id": "TrimWhitespaceResponse",
-      "description": "The result of trimming whitespace in cells.",
+    "UpdateSlicerSpecRequest": {
+      "description": "Updates a slicer’s specifications.\n(This does not move or resize a slicer. To move or resize a slicer use\nUpdateEmbeddedObjectPositionRequest.",
       "type": "object",
       "properties": {
-        "cellsChangedCount": {
+        "spec": {
+          "$ref": "SlicerSpec",
+          "description": "The specification to apply to the slicer."
+        },
+        "fields": {
+          "description": "The fields that should be updated.  At least one field must be specified.\nThe root `SlicerSpec` is implied and should not be specified. A single \"*\"`\ncan be used as short-hand for listing every field.",
+          "format": "google-fieldmask",
+          "type": "string"
+        },
+        "slicerId": {
           "type": "integer",
-          "description": "The number of cells that were trimmed of whitespace.",
+          "description": "The id of the slicer to update.",
           "format": "int32"
         }
-      }
+      },
+      "id": "UpdateSlicerSpecRequest"
     },
-    "PivotTable": {
-      "description": "A pivot table.",
+    "UpdateFilterViewRequest": {
+      "description": "Updates properties of the filter view.",
       "type": "object",
       "properties": {
-        "criteria": {
-          "description": "An optional mapping of filters per source column offset.\n\nThe filters are 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",
-          "additionalProperties": {
-            "$ref": "PivotFilterCriteria"
-          }
+        "filter": {
+          "$ref": "FilterView",
+          "description": "The new properties of the filter view."
         },
-        "rows": {
-          "description": "Each row grouping in the pivot table.",
+        "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": {
+      "type": "object",
+      "properties": {
+        "booleanRule": {
+          "$ref": "BooleanRule",
+          "description": "The formatting is either \"on\" or \"off\" according to the rule."
+        },
+        "ranges": {
           "type": "array",
           "items": {
-            "$ref": "PivotGroup"
-          }
+            "$ref": "GridRange"
+          },
+          "description": "The ranges that are formatted if the condition is true.\nAll the ranges must be on the same grid."
         },
-        "valueLayout": {
+        "gradientRule": {
+          "$ref": "GradientRule",
+          "description": "The formatting will vary based on the gradients in the rule."
+        }
+      },
+      "id": "ConditionalFormatRule",
+      "description": "A rule describing a conditional format."
+    },
+    "CopyPasteRequest": {
+      "id": "CopyPasteRequest",
+      "description": "Copies data from the source to the destination.",
+      "type": "object",
+      "properties": {
+        "destination": {
+          "$ref": "GridRange",
+          "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)."
+        },
+        "pasteOrientation": {
           "enum": [
-            "HORIZONTAL",
-            "VERTICAL"
+            "NORMAL",
+            "TRANSPOSE"
           ],
-          "description": "Whether values should be listed horizontally (as columns)\nor vertically (as rows).",
+          "description": "How that data should be oriented when pasting.",
           "type": "string",
           "enumDescriptions": [
-            "Values are laid out horizontally (as columns).",
-            "Values are laid out vertically (as rows)."
+            "Paste normally.",
+            "Paste transposed, where all rows become columns and vice versa."
           ]
         },
-        "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."
+          "description": "The source range to copy."
         },
-        "columns": {
-          "type": "array",
-          "items": {
-            "$ref": "PivotGroup"
-          },
-          "description": "Each column grouping in the pivot table."
+        "pasteType": {
+          "enumDescriptions": [
+            "Paste values, formulas, formats, and merges.",
+            "Paste the values ONLY without formats, formulas, or merges.",
+            "Paste the format and data validation only.",
+            "Like PASTE_NORMAL but without borders.",
+            "Paste the formulas only.",
+            "Paste the data validation only.",
+            "Paste the conditional formatting rules only."
+          ],
+          "enum": [
+            "PASTE_NORMAL",
+            "PASTE_VALUES",
+            "PASTE_FORMAT",
+            "PASTE_NO_BORDERS",
+            "PASTE_FORMULA",
+            "PASTE_DATA_VALIDATION",
+            "PASTE_CONDITIONAL_FORMATTING"
+          ],
+          "description": "What kind of data to paste.",
+          "type": "string"
         }
-      },
-      "id": "PivotTable"
+      }
     },
-    "SearchDeveloperMetadataResponse": {
-      "id": "SearchDeveloperMetadataResponse",
-      "description": "A reply to a developer metadata search request.",
+    "BooleanCondition": {
+      "id": "BooleanCondition",
+      "description": "A condition that can evaluate to true or false.\nBooleanConditions are used by conditional formatting,\ndata validation, and the criteria in filters.",
       "type": "object",
       "properties": {
-        "matchedDeveloperMetadata": {
-          "description": "The metadata matching the criteria of the search request.",
+        "type": {
+          "description": "The type of condition.",
+          "type": "string",
+          "enumDescriptions": [
+            "The default value, do not use.",
+            "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 be 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.",
+            "The cell's value must be TRUE/FALSE or in the list of condition values.\nSupported by data validation.\nRenders as a cell checkbox.\nSupports zero, one or two ConditionValues.  No\nvalues indicates the cell must be TRUE or FALSE, where TRUE renders as\nchecked and FALSE renders as unchecked.  One value indicates the cell\nwill render as checked when it contains that value and unchecked when it\nis blank.  Two values indicate that the cell will render as checked when\nit contains the first value and unchecked when it contains the second\nvalue.  For example, [\"Yes\",\"No\"] indicates that the cell will render a\nchecked box when it has the value \"Yes\" and an unchecked box when it has\nthe value \"No\"."
+          ],
+          "enum": [
+            "CONDITION_TYPE_UNSPECIFIED",
+            "NUMBER_GREATER",
+            "NUMBER_GREATER_THAN_EQ",
+            "NUMBER_LESS",
+            "NUMBER_LESS_THAN_EQ",
+            "NUMBER_EQ",
+            "NUMBER_NOT_EQ",
+            "NUMBER_BETWEEN",
+            "NUMBER_NOT_BETWEEN",
+            "TEXT_CONTAINS",
+            "TEXT_NOT_CONTAINS",
+            "TEXT_STARTS_WITH",
+            "TEXT_ENDS_WITH",
+            "TEXT_EQ",
+            "TEXT_IS_EMAIL",
+            "TEXT_IS_URL",
+            "DATE_EQ",
+            "DATE_BEFORE",
+            "DATE_AFTER",
+            "DATE_ON_OR_BEFORE",
+            "DATE_ON_OR_AFTER",
+            "DATE_BETWEEN",
+            "DATE_NOT_BETWEEN",
+            "DATE_IS_VALID",
+            "ONE_OF_RANGE",
+            "ONE_OF_LIST",
+            "BLANK",
+            "NOT_BLANK",
+            "CUSTOM_FORMULA",
+            "BOOLEAN"
+          ]
+        },
+        "values": {
+          "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.",
           "type": "array",
           "items": {
-            "$ref": "MatchedDeveloperMetadata"
+            "$ref": "ConditionValue"
           }
         }
       }
     },
-    "AppendCellsRequest": {
-      "description": "Adds new cells after the last row with data in a sheet,\ninserting new rows into the sheet if necessary.",
+    "AddDimensionGroupRequest": {
+      "description": "Creates a group over the specified range.\n\nIf the requested range is a superset of the range of an existing group G,\nthen the depth of G is incremented and this new group G' has the\ndepth of that group. For example, a group [C:D, depth 1] + [B:E] results in\ngroups [B:E, depth 1] and [C:D, depth 2].\nIf the requested range is a subset of the range of an existing group G,\nthen the depth of the new group G' becomes one greater than the depth of G.\nFor example, a group [B:E, depth 1] + [C:D] results in groups [B:E, depth 1]\nand [C:D, depth 2].\nIf the requested range starts before and ends within, or starts within and\nends after, the range of an existing group G, then the range of the existing\ngroup G becomes the union of the ranges, and the new group G' has\ndepth one greater than the depth of G and range as the intersection of the\nranges. For example, a group [B:D, depth 1] + [C:E] results in groups [B:E,\ndepth 1] and [C:D, depth 2].",
       "type": "object",
       "properties": {
-        "rows": {
-          "type": "array",
-          "items": {
-            "$ref": "RowData"
-          },
-          "description": "The data to append."
-        },
-        "fields": {
-          "type": "string",
-          "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"
-        },
-        "sheetId": {
-          "description": "The sheet ID to append the data to.",
-          "format": "int32",
-          "type": "integer"
+        "range": {
+          "description": "The range over which to create a group.",
+          "$ref": "DimensionRange"
         }
       },
-      "id": "AppendCellsRequest"
-    },
-    "TextFormatRun": {
-      "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.",
-      "type": "object",
-      "properties": {
-        "format": {
-          "$ref": "TextFormat",
-          "description": "The format of this run.  Absent values inherit the cell's format."
-        },
-        "startIndex": {
-          "description": "The character index where this run starts.",
-          "format": "int32",
-          "type": "integer"
-        }
-      }
+      "id": "AddDimensionGroupRequest"
     },
-    "BatchUpdateValuesByDataFilterResponse": {
-      "description": "The response when updating a range of values in a spreadsheet.",
+    "BasicChartSpec": {
+      "description": "The specification for a basic chart.  See BasicChartType for the list\nof charts this supports.",
       "type": "object",
       "properties": {
-        "totalUpdatedRows": {
-          "description": "The total number of rows where at least one cell in the row was updated.",
-          "format": "int32",
-          "type": "integer"
-        },
-        "responses": {
-          "description": "The response for each range updated.",
-          "type": "array",
-          "items": {
-            "$ref": "UpdateValuesByDataFilterResponse"
-          }
-        },
-        "totalUpdatedSheets": {
-          "description": "The total number of sheets where at least one cell in the sheet was\nupdated.",
+        "headerCount": {
+          "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.)",
           "format": "int32",
           "type": "integer"
         },
-        "totalUpdatedCells": {
-          "type": "integer",
-          "description": "The total number of cells updated.",
-          "format": "int32"
-        },
-        "totalUpdatedColumns": {
-          "type": "integer",
-          "description": "The total number of columns where at least one cell in the column was\nupdated.",
-          "format": "int32"
-        },
-        "spreadsheetId": {
+        "stackedType": {
+          "description": "The stacked type for charts that support vertical stacking.\nApplies to Area, Bar, Column, Combo, and Stepped Area charts.",
           "type": "string",
-          "description": "The spreadsheet the updates were applied to."
-        }
-      },
-      "id": "BatchUpdateValuesByDataFilterResponse"
-    },
-    "RowData": {
-      "description": "Data about each cell in a row.",
-      "type": "object",
-      "properties": {
-        "values": {
+          "enumDescriptions": [
+            "Default value, do not use.",
+            "Series are not stacked.",
+            "Series values are stacked, each value is rendered vertically beginning\nfrom the top of the value below it.",
+            "Vertical stacks are stretched to reach the top of the chart, with\nvalues laid out as percentages of each other."
+          ],
+          "enum": [
+            "BASIC_CHART_STACKED_TYPE_UNSPECIFIED",
+            "NOT_STACKED",
+            "STACKED",
+            "PERCENT_STACKED"
+          ]
+        },
+        "axis": {
           "type": "array",
           "items": {
-            "$ref": "CellData"
+            "$ref": "BasicChartAxis"
           },
-          "description": "The values in the row, one per column."
-        }
-      },
-      "id": "RowData"
-    },
-    "Border": {
-      "description": "A border along a cell.",
-      "type": "object",
-      "properties": {
-        "style": {
-          "description": "The style of the border.",
+          "description": "The axis on the chart."
+        },
+        "threeDimensional": {
+          "description": "True to make the chart 3D.\nApplies to Bar and Column charts.",
+          "type": "boolean"
+        },
+        "chartType": {
           "type": "string",
           "enumDescriptions": [
-            "The style is not specified. Do not use this.",
-            "The border is dotted.",
-            "The border is dashed.",
-            "The border is a thin solid line.",
-            "The border is a medium solid line.",
-            "The border is a thick solid line.",
-            "No border.\nUsed only when updating a border in order to erase it.",
-            "The border is two solid lines."
+            "Default value, do not use.",
+            "A \u003ca href=\"/chart/interactive/docs/gallery/barchart\"\u003ebar chart\u003c/a\u003e.",
+            "A \u003ca href=\"/chart/interactive/docs/gallery/linechart\"\u003eline chart\u003c/a\u003e.",
+            "An \u003ca href=\"/chart/interactive/docs/gallery/areachart\"\u003earea chart\u003c/a\u003e.",
+            "A \u003ca href=\"/chart/interactive/docs/gallery/columnchart\"\u003ecolumn chart\u003c/a\u003e.",
+            "A \u003ca href=\"/chart/interactive/docs/gallery/scatterchart\"\u003escatter\nchart\u003c/a\u003e.",
+            "A \u003ca href=\"/chart/interactive/docs/gallery/combochart\"\u003ecombo chart\u003c/a\u003e.",
+            "A \u003ca href=\"/chart/interactive/docs/gallery/steppedareachart\"\u003estepped area\nchart\u003c/a\u003e."
           ],
           "enum": [
-            "STYLE_UNSPECIFIED",
-            "DOTTED",
-            "DASHED",
-            "SOLID",
-            "SOLID_MEDIUM",
-            "SOLID_THICK",
-            "NONE",
-            "DOUBLE"
-          ]
+            "BASIC_CHART_TYPE_UNSPECIFIED",
+            "BAR",
+            "LINE",
+            "AREA",
+            "COLUMN",
+            "SCATTER",
+            "COMBO",
+            "STEPPED_AREA"
+          ],
+          "description": "The type of the chart."
         },
-        "color": {
-          "description": "The color of the border.",
-          "$ref": "Color"
+        "interpolateNulls": {
+          "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"
         },
-        "width": {
-          "description": "The width of the border, in pixels.\nDeprecated; the width is determined by the \"style\" field.",
-          "format": "int32",
-          "type": "integer"
-        }
-      },
-      "id": "Border"
-    },
-    "GridData": {
-      "type": "object",
-      "properties": {
-        "columnMetadata": {
-          "description": "Metadata about the requested columns in the grid, starting with the column\nin start_column.",
+        "series": {
+          "description": "The data this chart is visualizing.",
           "type": "array",
           "items": {
-            "$ref": "DimensionProperties"
+            "$ref": "BasicChartSeries"
           }
         },
-        "startColumn": {
-          "description": "The first column this GridData refers to, zero-based.",
-          "format": "int32",
-          "type": "integer"
+        "legendPosition": {
+          "type": "string",
+          "enumDescriptions": [
+            "Default value, do not use.",
+            "The legend is rendered on the bottom of the chart.",
+            "The legend is rendered on the left of the chart.",
+            "The legend is rendered on the right of the chart.",
+            "The legend is rendered on the top of the chart.",
+            "No legend is rendered."
+          ],
+          "enum": [
+            "BASIC_CHART_LEGEND_POSITION_UNSPECIFIED",
+            "BOTTOM_LEGEND",
+            "LEFT_LEGEND",
+            "RIGHT_LEGEND",
+            "TOP_LEGEND",
+            "NO_LEGEND"
+          ],
+          "description": "The position of the chart legend."
         },
-        "rowMetadata": {
-          "description": "Metadata about the requested rows in the grid, starting with the row\nin start_row.",
-          "type": "array",
-          "items": {
-            "$ref": "DimensionProperties"
-          }
+        "compareMode": {
+          "type": "string",
+          "enumDescriptions": [
+            "Default value, do not use.",
+            "Only the focused data element is highlighted and shown in the tooltip.",
+            "All data elements with the same category (e.g., domain value) are\nhighlighted and shown in the tooltip."
+          ],
+          "enum": [
+            "BASIC_CHART_COMPARE_MODE_UNSPECIFIED",
+            "DATUM",
+            "CATEGORY"
+          ],
+          "description": "The behavior of tooltips and data highlighting when hovering on data and\nchart area."
         },
-        "rowData": {
+        "domains": {
+          "description": "The domain of data this is charting.\nOnly a single domain is supported.",
           "type": "array",
           "items": {
-            "$ref": "RowData"
-          },
-          "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."
+            "$ref": "BasicChartDomain"
+          }
         },
-        "startRow": {
-          "type": "integer",
-          "description": "The first row this GridData refers to, zero-based.",
-          "format": "int32"
+        "lineSmoothing": {
+          "description": "Gets whether all lines should be rendered smooth or straight by default.\nApplies to Line charts.",
+          "type": "boolean"
         }
       },
-      "id": "GridData",
-      "description": "Data in the grid, as well as metadata about the dimensions."
+      "id": "BasicChartSpec"
     },
-    "FindReplaceRequest": {
-      "description": "Finds and replaces data in cells over a range, sheet, or all sheets.",
+    "CellData": {
+      "description": "Data about a specific cell.",
       "type": "object",
       "properties": {
-        "includeFormulas": {
-          "description": "True if the search should include cells with formulas.\nFalse to skip cells with formulas.",
-          "type": "boolean"
+        "formattedValue": {
+          "description": "The formatted value of the cell.\nThis is the value as it's shown to the user.\nThis field is read-only.",
+          "type": "string"
         },
-        "matchEntireCell": {
-          "description": "True if the find value should match the entire cell.",
-          "type": "boolean"
+        "textFormatRuns": {
+          "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 are erased.",
+          "type": "array",
+          "items": {
+            "$ref": "TextFormatRun"
+          }
         },
-        "find": {
-          "type": "string",
-          "description": "The value to search."
+        "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.)",
+          "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.",
-          "type": "boolean"
+        "pivotTable": {
+          "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"
         },
-        "replacement": {
-          "type": "string",
-          "description": "The value to use as the replacement."
+        "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."
         },
-        "range": {
-          "description": "The range to find/replace over.",
-          "$ref": "GridRange"
+        "note": {
+          "description": "Any note on the cell.",
+          "type": "string"
         },
-        "sheetId": {
-          "type": "integer",
-          "description": "The sheet to find/replace over.",
-          "format": "int32"
+        "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."
         },
-        "matchCase": {
-          "type": "boolean",
-          "description": "True if the search is case sensitive."
+        "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."
         },
-        "allSheets": {
-          "description": "True to find/replace over all sheets.",
-          "type": "boolean"
+        "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 is\nthe calculated value.  For cells with literals, this is\nthe same as the user_entered_value.\nThis field is read-only."
         }
       },
-      "id": "FindReplaceRequest"
+      "id": "CellData"
     },
-    "UpdateNamedRangeRequest": {
-      "id": "UpdateNamedRangeRequest",
-      "description": "Updates properties of the named range with the specified\nnamedRangeId.",
+    "BatchUpdateValuesByDataFilterRequest": {
+      "id": "BatchUpdateValuesByDataFilterRequest",
+      "description": "The request for updating more than one range of values in a spreadsheet.",
       "type": "object",
       "properties": {
-        "namedRange": {
-          "$ref": "NamedRange",
-          "description": "The named range to update with the new properties."
+        "includeValuesInResponse": {
+          "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).",
+          "type": "boolean"
         },
-        "fields": {
+        "valueInputOption": {
+          "enumDescriptions": [
+            "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."
+          ],
+          "enum": [
+            "INPUT_VALUE_OPTION_UNSPECIFIED",
+            "RAW",
+            "USER_ENTERED"
+          ],
+          "description": "How the input data should be interpreted.",
+          "type": "string"
+        },
+        "data": {
+          "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.",
+          "type": "array",
+          "items": {
+            "$ref": "DataFilterValueRange"
+          }
+        },
+        "responseDateTimeRenderOption": {
           "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.",
+          "enumDescriptions": [
+            "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)."
+          ],
+          "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\nDateTimeRenderOption.SERIAL_NUMBER."
+        },
+        "responseValueRenderOption": {
+          "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\"`."
+          ],
+          "enum": [
+            "FORMATTED_VALUE",
+            "UNFORMATTED_VALUE",
+            "FORMULA"
+          ],
+          "description": "Determines how values in the response should be rendered.\nThe default render option is ValueRenderOption.FORMATTED_VALUE."
+        }
+      }
+    },
+    "UpdateDimensionGroupRequest": {
+      "id": "UpdateDimensionGroupRequest",
+      "description": "Updates the state of the specified group.",
+      "type": "object",
+      "properties": {
+        "fields": {
+          "type": "string",
+          "description": "The fields that should be updated.  At least one field must be specified.\nThe root `dimensionGroup` is implied and should not be specified.\nA single `\"*\"` can be used as short-hand for listing every field.",
           "format": "google-fieldmask"
+        },
+        "dimensionGroup": {
+          "$ref": "DimensionGroup",
+          "description": "The group whose state should be updated. The range and depth of the group\nshould specify a valid group on the sheet, and all other fields updated."
         }
       }
     },
-    "UpdateCellsRequest": {
-      "id": "UpdateCellsRequest",
-      "description": "Updates all cells in a range with new data.",
+    "DeleteDeveloperMetadataResponse": {
+      "id": "DeleteDeveloperMetadataResponse",
+      "description": "The response from deleting developer metadata.",
+      "type": "object",
+      "properties": {
+        "deletedDeveloperMetadata": {
+          "description": "The metadata that was deleted.",
+          "type": "array",
+          "items": {
+            "$ref": "DeveloperMetadata"
+          }
+        }
+      }
+    },
+    "SortRangeRequest": {
+      "description": "Sorts data in rows based on a sort order per column.",
       "type": "object",
       "properties": {
         "range": {
-          "$ref": "GridRange",
-          "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 range to sort.",
+          "$ref": "GridRange"
         },
-        "rows": {
+        "sortSpecs": {
           "type": "array",
           "items": {
-            "$ref": "RowData"
+            "$ref": "SortSpec"
           },
-          "description": "The data to write."
-        },
-        "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"
-        },
-        "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 sort order per column. Later specifications are used when values\nare equal in the earlier specifications."
         }
-      }
+      },
+      "id": "SortRangeRequest"
     },
-    "RandomizeRangeRequest": {
+    "MergeCellsRequest": {
+      "description": "Merges all cells in the range.",
       "type": "object",
       "properties": {
         "range": {
           "$ref": "GridRange",
-          "description": "The range to randomize."
+          "description": "The range of cells to merge."
+        },
+        "mergeType": {
+          "enum": [
+            "MERGE_ALL",
+            "MERGE_COLUMNS",
+            "MERGE_ROWS"
+          ],
+          "description": "How the cells should be merged.",
+          "type": "string",
+          "enumDescriptions": [
+            "Create a single merge from the range",
+            "Create a merge for each column in the range",
+            "Create a merge for each row in the range"
+          ]
         }
       },
-      "id": "RandomizeRangeRequest",
-      "description": "Randomizes the order of the rows in a range."
+      "id": "MergeCellsRequest"
     },
-    "DeleteRangeRequest": {
-      "description": "Deletes a range of cells, shifting other cells into the deleted area.",
+    "MatchedDeveloperMetadata": {
+      "description": "A developer metadata entry and the data filters specified in the original\nrequest that matched it.",
       "type": "object",
       "properties": {
-        "shiftDimension": {
-          "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"
-          ],
-          "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."
+        "dataFilters": {
+          "type": "array",
+          "items": {
+            "$ref": "DataFilter"
+          },
+          "description": "All filters matching the returned developer metadata."
         },
-        "range": {
-          "$ref": "GridRange",
-          "description": "The range of cells to delete."
+        "developerMetadata": {
+          "description": "The developer metadata matching the specified filters.",
+          "$ref": "DeveloperMetadata"
         }
       },
-      "id": "DeleteRangeRequest"
+      "id": "MatchedDeveloperMetadata"
     },
-    "DeleteDuplicatesResponse": {
+    "AddProtectedRangeRequest": {
+      "description": "Adds a new protected range.",
       "type": "object",
       "properties": {
-        "duplicatesRemovedCount": {
-          "description": "The number of duplicate rows removed.",
-          "format": "int32",
-          "type": "integer"
+        "protectedRange": {
+          "$ref": "ProtectedRange",
+          "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.)"
         }
       },
-      "id": "DeleteDuplicatesResponse",
-      "description": "The result of removing duplicates in a range."
+      "id": "AddProtectedRangeRequest"
     },
-    "UnmergeCellsRequest": {
-      "description": "Unmerges cells in the given range.",
+    "DuplicateFilterViewResponse": {
       "type": "object",
       "properties": {
-        "range": {
-          "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.",
-          "$ref": "GridRange"
+        "filter": {
+          "$ref": "FilterView",
+          "description": "The newly created filter."
         }
       },
-      "id": "UnmergeCellsRequest"
+      "id": "DuplicateFilterViewResponse",
+      "description": "The result of a filter view being duplicated."
     },
-    "UpdateEmbeddedObjectPositionResponse": {
-      "description": "The result of updating an embedded object's position.",
+    "DuplicateSheetResponse": {
+      "description": "The result of duplicating a sheet.",
       "type": "object",
       "properties": {
-        "position": {
-          "description": "The new position of the embedded object.",
-          "$ref": "EmbeddedObjectPosition"
+        "properties": {
+          "$ref": "SheetProperties",
+          "description": "The properties of the duplicate sheet."
         }
       },
-      "id": "UpdateEmbeddedObjectPositionResponse"
+      "id": "DuplicateSheetResponse"
     },
-    "SortSpec": {
+    "BatchUpdateSpreadsheetResponse": {
+      "description": "The reply for batch updating a spreadsheet.",
       "type": "object",
       "properties": {
-        "foregroundColor": {
-          "$ref": "Color",
-          "description": "The text color to sort by. Mutually exclusive with sorting by background\nfill color. Requests to set this field will fail with a 400 error if\nbackground color is also set."
-        },
-        "dimensionIndex": {
-          "description": "The dimension the sort should be applied to.",
-          "format": "int32",
-          "type": "integer"
+        "spreadsheetId": {
+          "description": "The spreadsheet the updates were applied to.",
+          "type": "string"
         },
-        "backgroundColor": {
-          "$ref": "Color",
-          "description": "The background fill color to sort by. Mutually exclusive with sorting by\ntext color. Requests to set this field will fail with a 400 error if\nforeground color is also set."
+        "replies": {
+          "description": "The reply of the updates.  This maps 1:1 with the updates, although\nreplies to some requests may be empty.",
+          "type": "array",
+          "items": {
+            "$ref": "Response"
+          }
         },
-        "sortOrder": {
-          "description": "The order data should be sorted.",
-          "type": "string",
-          "enumDescriptions": [
-            "Default value, do not use this.",
-            "Sort ascending.",
-            "Sort descending."
-          ],
-          "enum": [
-            "SORT_ORDER_UNSPECIFIED",
-            "ASCENDING",
-            "DESCENDING"
-          ]
+        "updatedSpreadsheet": {
+          "$ref": "Spreadsheet",
+          "description": "The spreadsheet after updates were applied. This is only set if\n[BatchUpdateSpreadsheetRequest.include_spreadsheet_in_response] is `true`."
         }
       },
-      "id": "SortSpec",
-      "description": "A sort order associated with a specific column or row."
+      "id": "BatchUpdateSpreadsheetResponse"
     },
-    "BooleanRule": {
-      "description": "A rule that may or may not match, depending on the condition.",
+    "AddFilterViewRequest": {
+      "id": "AddFilterViewRequest",
+      "description": "Adds a filter view.",
       "type": "object",
       "properties": {
-        "format": {
-          "$ref": "CellFormat",
-          "description": "The format to apply.\nConditional formatting can only apply a subset of formatting:\nbold, italic,\nstrikethrough,\nforeground color &\nbackground color."
-        },
-        "condition": {
-          "$ref": "BooleanCondition",
-          "description": "The condition of the rule. If the condition evaluates to true,\nthe format is applied."
+        "filter": {
+          "$ref": "FilterView",
+          "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.)"
         }
-      },
-      "id": "BooleanRule"
+      }
     },
-    "WaterfallChartSpec": {
-      "description": "A waterfall chart.",
+    "DataFilterValueRange": {
+      "description": "A range of values whose location is specified by a DataFilter.",
       "type": "object",
       "properties": {
-        "series": {
-          "description": "The data this waterfall chart is visualizing.",
-          "type": "array",
-          "items": {
-            "$ref": "WaterfallChartSeries"
-          }
-        },
-        "connectorLineStyle": {
-          "$ref": "LineStyle",
-          "description": "The line style for the connector lines."
-        },
-        "domain": {
-          "$ref": "WaterfallChartDomain",
-          "description": "The domain data (horizontal axis) for the waterfall chart."
-        },
-        "firstValueIsTotal": {
-          "description": "True to interpret the first value as a total.",
-          "type": "boolean"
-        },
-        "stackedType": {
-          "description": "The stacked type.",
-          "type": "string",
+        "majorDimension": {
           "enumDescriptions": [
-            "Default value, do not use.",
-            "Values corresponding to the same domain (horizontal axis) value will be\nstacked vertically.",
-            "Series will spread out along the horizontal axis."
+            "The default value, do not use.",
+            "Operates on the rows of a sheet.",
+            "Operates on the columns of a sheet."
           ],
           "enum": [
-            "WATERFALL_STACKED_TYPE_UNSPECIFIED",
-            "STACKED",
-            "SEQUENTIAL"
-          ]
+            "DIMENSION_UNSPECIFIED",
+            "ROWS",
+            "COLUMNS"
+          ],
+          "description": "The major dimension of the values.",
+          "type": "string"
         },
-        "hideConnectorLines": {
-          "description": "True to hide connector lines between columns.",
-          "type": "boolean"
-        }
-      },
-      "id": "WaterfallChartSpec"
-    },
-    "UpdateConditionalFormatRuleRequest": {
-      "description": "Updates a conditional format rule at the given index,\nor moves a conditional format rule to another index.",
-      "type": "object",
-      "properties": {
-        "sheetId": {
-          "type": "integer",
-          "description": "The sheet of the rule to move.  Required if new_index is set,\nunused otherwise.",
-          "format": "int32"
-        },
-        "newIndex": {
-          "type": "integer",
-          "description": "The zero-based new index the rule should end up at.",
-          "format": "int32"
-        },
-        "rule": {
-          "$ref": "ConditionalFormatRule",
-          "description": "The rule that should replace the rule at the given index."
+        "values": {
+          "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.",
+          "type": "array",
+          "items": {
+            "type": "array",
+            "items": {
+              "type": "any"
+            }
+          }
         },
-        "index": {
-          "description": "The zero-based index of the rule that should be replaced or moved.",
-          "format": "int32",
-          "type": "integer"
+        "dataFilter": {
+          "$ref": "DataFilter",
+          "description": "The data filter describing the location of the values in the spreadsheet."
         }
       },
-      "id": "UpdateConditionalFormatRuleRequest"
+      "id": "DataFilterValueRange"
     },
-    "BasicChartDomain": {
-      "description": "The domain of a chart.\nFor example, if charting stock prices over time, this would be the date.",
+    "NumberFormat": {
+      "description": "The number format of a cell.",
       "type": "object",
       "properties": {
-        "domain": {
-          "$ref": "ChartData",
-          "description": "The data of the domain. For example, if charting stock prices over time,\nthis is the data representing the dates."
+        "type": {
+          "enum": [
+            "NUMBER_FORMAT_TYPE_UNSPECIFIED",
+            "TEXT",
+            "NUMBER",
+            "PERCENT",
+            "CURRENCY",
+            "DATE",
+            "TIME",
+            "DATE_TIME",
+            "SCIENTIFIC"
+          ],
+          "description": "The type of the number format.\nWhen writing, this field must be set.",
+          "type": "string",
+          "enumDescriptions": [
+            "The number format is not specified\nand is based on the contents of the cell.\nDo not explicitly use this.",
+            "Text formatting, e.g `1000.12`",
+            "Number formatting, e.g, `1,000.12`",
+            "Percent formatting, e.g `10.12%`",
+            "Currency formatting, e.g `$1,000.12`",
+            "Date formatting, e.g `9/26/2008`",
+            "Time formatting, e.g `3:59:00 PM`",
+            "Date+Time formatting, e.g `9/26/08 15:59:00`",
+            "Scientific number formatting, e.g `1.01E+03`"
+          ]
         },
-        "reversed": {
-          "description": "True to reverse the order of the domain values (horizontal axis).",
-          "type": "boolean"
+        "pattern": {
+          "type": "string",
+          "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\nmore information about the supported patterns."
         }
       },
-      "id": "BasicChartDomain"
+      "id": "NumberFormat"
     },
-    "PasteDataRequest": {
-      "description": "Inserts data into the spreadsheet starting at the specified coordinate.",
+    "OrgChartSpec": {
+      "id": "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": {
-        "type": {
+        "selectedNodeColor": {
+          "$ref": "Color",
+          "description": "The color of the selected org chart nodes."
+        },
+        "parentLabels": {
+          "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.",
+          "$ref": "ChartData"
+        },
+        "nodeSize": {
+          "description": "The size of the org chart nodes.",
           "type": "string",
           "enumDescriptions": [
-            "Paste values, formulas, formats, and merges.",
-            "Paste the values ONLY without formats, formulas, or merges.",
-            "Paste the format and data validation only.",
-            "Like PASTE_NORMAL but without borders.",
-            "Paste the formulas only.",
-            "Paste the data validation only.",
-            "Paste the conditional formatting rules only."
+            "Default value, do not use.",
+            "The small org chart node size.",
+            "The medium org chart node size.",
+            "The large org chart node size."
           ],
           "enum": [
-            "PASTE_NORMAL",
-            "PASTE_VALUES",
-            "PASTE_FORMAT",
-            "PASTE_NO_BORDERS",
-            "PASTE_FORMULA",
-            "PASTE_DATA_VALIDATION",
-            "PASTE_CONDITIONAL_FORMATTING"
-          ],
-          "description": "How the data should be pasted."
+            "ORG_CHART_LABEL_SIZE_UNSPECIFIED",
+            "SMALL",
+            "MEDIUM",
+            "LARGE"
+          ]
         },
-        "html": {
-          "description": "True if the data is HTML.",
-          "type": "boolean"
+        "labels": {
+          "description": "The data containing the labels for all the nodes in the chart.  Labels\nmust be unique.",
+          "$ref": "ChartData"
         },
-        "coordinate": {
-          "description": "The coordinate at which the data should start being inserted.",
-          "$ref": "GridCoordinate"
+        "nodeColor": {
+          "$ref": "Color",
+          "description": "The color of the org chart nodes."
         },
-        "data": {
-          "description": "The data to insert.",
+        "tooltips": {
+          "$ref": "ChartData",
+          "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."
+        }
+      }
+    },
+    "FilterView": {
+      "description": "A filter view.",
+      "type": "object",
+      "properties": {
+        "criteria": {
+          "additionalProperties": {
+            "$ref": "FilterCriteria"
+          },
+          "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.",
+          "type": "object"
+        },
+        "title": {
+          "description": "The name of the filter view.",
           "type": "string"
         },
-        "delimiter": {
-          "description": "The delimiter in the data.",
+        "range": {
+          "$ref": "GridRange",
+          "description": "The range this filter view covers.\n\nWhen writing, only one of range or named_range_id\nmay be set."
+        },
+        "sortSpecs": {
+          "description": "The sort order per column. Later specifications are used when values\nare equal in the earlier specifications.",
+          "type": "array",
+          "items": {
+            "$ref": "SortSpec"
+          }
+        },
+        "namedRangeId": {
+          "description": "The named range this filter view is backed by, if any.\n\nWhen writing, only one of range or named_range_id\nmay be set.",
           "type": "string"
+        },
+        "filterViewId": {
+          "description": "The ID of the filter view.",
+          "format": "int32",
+          "type": "integer"
         }
       },
-      "id": "PasteDataRequest"
+      "id": "FilterView"
     },
-    "UpdateDeveloperMetadataResponse": {
+    "Slicer": {
+      "id": "Slicer",
+      "description": "A slicer in a sheet.",
       "type": "object",
       "properties": {
-        "developerMetadata": {
-          "description": "The updated developer metadata.",
+        "position": {
+          "description": "The position of the slicer. Note that slicer can be positioned only on\nexisting sheet. Also, width and height of slicer can be automatically\nadjusted to keep it within permitted limits.",
+          "$ref": "EmbeddedObjectPosition"
+        },
+        "spec": {
+          "$ref": "SlicerSpec",
+          "description": "The specification of the slicer."
+        },
+        "slicerId": {
+          "description": "The ID of the slicer.",
+          "format": "int32",
+          "type": "integer"
+        }
+      }
+    },
+    "SearchDeveloperMetadataRequest": {
+      "description": "A request to retrieve all developer metadata matching the set of specified\ncriteria.",
+      "type": "object",
+      "properties": {
+        "dataFilters": {
+          "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.",
           "type": "array",
           "items": {
-            "$ref": "DeveloperMetadata"
+            "$ref": "DataFilter"
           }
         }
       },
-      "id": "UpdateDeveloperMetadataResponse",
-      "description": "The response from updating developer metadata."
+      "id": "SearchDeveloperMetadataRequest"
     },
-    "AppendDimensionRequest": {
-      "description": "Appends rows or columns to the end of a sheet.",
+    "BandingProperties": {
+      "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.",
       "type": "object",
       "properties": {
-        "sheetId": {
-          "description": "The sheet to append rows or columns to.",
-          "format": "int32",
-          "type": "integer"
+        "firstBandColor": {
+          "$ref": "Color",
+          "description": "The first color that is alternating. (Required)"
         },
-        "dimension": {
-          "enum": [
-            "DIMENSION_UNSPECIFIED",
-            "ROWS",
-            "COLUMNS"
-          ],
-          "description": "Whether rows or columns should be appended.",
-          "type": "string",
-          "enumDescriptions": [
-            "The default value, do not use.",
-            "Operates on the rows of a sheet.",
-            "Operates on the columns of a sheet."
-          ]
+        "secondBandColor": {
+          "description": "The second color that is alternating. (Required)",
+          "$ref": "Color"
         },
-        "length": {
-          "type": "integer",
-          "description": "The number of rows or columns to append.",
-          "format": "int32"
+        "footerColor": {
+          "$ref": "Color",
+          "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."
+        },
+        "headerColor": {
+          "$ref": "Color",
+          "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."
         }
       },
-      "id": "AppendDimensionRequest"
+      "id": "BandingProperties"
     },
-    "AddNamedRangeRequest": {
-      "description": "Adds a named range to the spreadsheet.",
+    "BasicFilter": {
       "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"
+        "range": {
+          "$ref": "GridRange",
+          "description": "The range the filter covers."
+        },
+        "criteria": {
+          "additionalProperties": {
+            "$ref": "FilterCriteria"
+          },
+          "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.",
+          "type": "object"
+        },
+        "sortSpecs": {
+          "description": "The sort order per column. Later specifications are used when values\nare equal in the earlier specifications.",
+          "type": "array",
+          "items": {
+            "$ref": "SortSpec"
+          }
         }
       },
-      "id": "AddNamedRangeRequest"
+      "id": "BasicFilter",
+      "description": "The default filter associated with a sheet."
     },
-    "CreateDeveloperMetadataResponse": {
-      "id": "CreateDeveloperMetadataResponse",
-      "description": "The response from creating developer metadata.",
+    "AddProtectedRangeResponse": {
+      "id": "AddProtectedRangeResponse",
+      "description": "The result of adding a new protected range.",
       "type": "object",
       "properties": {
-        "developerMetadata": {
-          "description": "The developer metadata that was created.",
-          "$ref": "DeveloperMetadata"
+        "protectedRange": {
+          "description": "The newly added protected range.",
+          "$ref": "ProtectedRange"
         }
       }
     },
-    "UpdateEmbeddedObjectPositionRequest": {
-      "description": "Update an embedded object's position (such as a moving or resizing a\nchart or image).",
+    "PivotValue": {
+      "id": "PivotValue",
+      "description": "The definition of how a value in a pivot table should be calculated.",
       "type": "object",
       "properties": {
-        "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.",
-          "format": "google-fieldmask",
+        "name": {
+          "type": "string",
+          "description": "A name to use for the value."
+        },
+        "formula": {
+          "description": "A custom formula to calculate the value.  The formula must start\nwith an `=` character.",
           "type": "string"
         },
-        "objectId": {
-          "description": "The ID of the object to moved.",
-          "format": "int32",
-          "type": "integer"
+        "calculatedDisplayType": {
+          "enumDescriptions": [
+            "Default value, do not use.",
+            "Shows the pivot values as percentage of the row total values.",
+            "Shows the pivot values as percentage of the column total values.",
+            "Shows the pivot values as percentage of the grand total values."
+          ],
+          "enum": [
+            "PIVOT_VALUE_CALCULATED_DISPLAY_TYPE_UNSPECIFIED",
+            "PERCENT_OF_ROW_TOTAL",
+            "PERCENT_OF_COLUMN_TOTAL",
+            "PERCENT_OF_GRAND_TOTAL"
+          ],
+          "description": "If specified, indicates that pivot values should be displayed as\nthe result of a calculation with another pivot value. For example, if\ncalculated_display_type is specified as PERCENT_OF_GRAND_TOTAL, all the\npivot values are displayed as the percentage of the grand total. In\nthe Sheets UI, this is referred to as \"Show As\" in the value section of a\npivot table.",
+          "type": "string"
         },
-        "newPosition": {
-          "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.",
-          "$ref": "EmbeddedObjectPosition"
+        "summarizeFunction": {
+          "type": "string",
+          "enumDescriptions": [
+            "The default, do not use.",
+            "Corresponds to the `SUM` function.",
+            "Corresponds to the `COUNTA` function.",
+            "Corresponds to the `COUNT` function.",
+            "Corresponds to the `COUNTUNIQUE` function.",
+            "Corresponds to the `AVERAGE` function.",
+            "Corresponds to the `MAX` function.",
+            "Corresponds to the `MIN` function.",
+            "Corresponds to the `MEDIAN` function.",
+            "Corresponds to the `PRODUCT` function.",
+            "Corresponds to the `STDEV` function.",
+            "Corresponds to the `STDEVP` function.",
+            "Corresponds to the `VAR` function.",
+            "Corresponds to the `VARP` function.",
+            "Indicates the formula should be used as-is.\nOnly valid if PivotValue.formula was set."
+          ],
+          "enum": [
+            "PIVOT_STANDARD_VALUE_FUNCTION_UNSPECIFIED",
+            "SUM",
+            "COUNTA",
+            "COUNT",
+            "COUNTUNIQUE",
+            "AVERAGE",
+            "MAX",
+            "MIN",
+            "MEDIAN",
+            "PRODUCT",
+            "STDEV",
+            "STDEVP",
+            "VAR",
+            "VARP",
+            "CUSTOM"
+          ],
+          "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."
+        },
+        "sourceColumnOffset": {
+          "type": "integer",
+          "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`.",
+          "format": "int32"
         }
-      },
-      "id": "UpdateEmbeddedObjectPositionRequest"
+      }
     },
-    "WaterfallChartColumnStyle": {
-      "id": "WaterfallChartColumnStyle",
-      "description": "Styles for a waterfall chart column.",
+    "ErrorValue": {
       "type": "object",
       "properties": {
-        "color": {
-          "description": "The color of the column.",
-          "$ref": "Color"
+        "type": {
+          "description": "The type of error.",
+          "type": "string",
+          "enumDescriptions": [
+            "The default error type, do not use this.",
+            "Corresponds to the `#ERROR!` error.",
+            "Corresponds to the `#NULL!` error.",
+            "Corresponds to the `#DIV/0` error.",
+            "Corresponds to the `#VALUE!` error.",
+            "Corresponds to the `#REF!` error.",
+            "Corresponds to the `#NAME?` error.",
+            "Corresponds to the `#NUM`! error.",
+            "Corresponds to the `#N/A` error.",
+            "Corresponds to the `Loading...` state."
+          ],
+          "enum": [
+            "ERROR_TYPE_UNSPECIFIED",
+            "ERROR",
+            "NULL_VALUE",
+            "DIVIDE_BY_ZERO",
+            "VALUE",
+            "REF",
+            "NAME",
+            "NUM",
+            "N_A",
+            "LOADING"
+          ]
         },
-        "label": {
-          "description": "The label of the column's legend.",
+        "message": {
+          "description": "A message with more information about the error\n(in the spreadsheet's locale).",
           "type": "string"
         }
-      }
+      },
+      "id": "ErrorValue",
+      "description": "An error in a cell."
     },
-    "Request": {
-      "description": "A single kind of update to apply to a spreadsheet.",
+    "CopySheetToAnotherSpreadsheetRequest": {
       "type": "object",
       "properties": {
-        "updateSheetProperties": {
-          "$ref": "UpdateSheetPropertiesRequest",
-          "description": "Updates a sheet's properties."
-        },
-        "deleteDimension": {
-          "description": "Deletes rows or columns in a sheet.",
-          "$ref": "DeleteDimensionRequest"
-        },
-        "autoFill": {
-          "description": "Automatically fills in more data based on existing data.",
-          "$ref": "AutoFillRequest"
-        },
-        "addSlicer": {
-          "$ref": "AddSlicerRequest",
-          "description": "Adds a slicer."
+        "destinationSpreadsheetId": {
+          "description": "The ID of the spreadsheet to copy the sheet to.",
+          "type": "string"
+        }
+      },
+      "id": "CopySheetToAnotherSpreadsheetRequest",
+      "description": "The request to copy a sheet across spreadsheets."
+    },
+    "CandlestickChartSpec": {
+      "description": "A \u003ca href=\"/chart/interactive/docs/gallery/candlestickchart\"\u003ecandlestick\nchart\u003c/a\u003e.",
+      "type": "object",
+      "properties": {
+        "domain": {
+          "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.",
+          "$ref": "CandlestickDomain"
         },
-        "sortRange": {
-          "description": "Sorts data in a range.",
-          "$ref": "SortRangeRequest"
+        "data": {
+          "type": "array",
+          "items": {
+            "$ref": "CandlestickData"
+          },
+          "description": "The Candlestick chart data.\nOnly one CandlestickData is supported."
+        }
+      },
+      "id": "CandlestickChartSpec"
+    },
+    "BatchClearValuesByDataFilterResponse": {
+      "id": "BatchClearValuesByDataFilterResponse",
+      "description": "The response when clearing a range of values selected with\nDataFilters in a spreadsheet.",
+      "type": "object",
+      "properties": {
+        "clearedRanges": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "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.)"
         },
-        "deleteDimensionGroup": {
-          "description": "Deletes a group over the specified range.",
-          "$ref": "DeleteDimensionGroupRequest"
+        "spreadsheetId": {
+          "type": "string",
+          "description": "The spreadsheet the updates were applied to."
+        }
+      }
+    },
+    "TreemapChartColorScale": {
+      "type": "object",
+      "properties": {
+        "minValueColor": {
+          "$ref": "Color",
+          "description": "The background color for cells with a color value less than or equal to\nminValue. Defaults to #dc3912 if not\nspecified."
         },
-        "deleteProtectedRange": {
-          "$ref": "DeleteProtectedRangeRequest",
-          "description": "Deletes a protected range."
+        "noDataColor": {
+          "$ref": "Color",
+          "description": "The background color for cells that have no color data associated with\nthem. Defaults to #000000 if not specified."
         },
-        "duplicateFilterView": {
-          "$ref": "DuplicateFilterViewRequest",
-          "description": "Duplicates a filter view."
+        "midValueColor": {
+          "$ref": "Color",
+          "description": "The background color for cells with a color value at the midpoint between\nminValue and\nmaxValue. Defaults to #efe6dc if not\nspecified."
         },
-        "addChart": {
-          "$ref": "AddChartRequest",
-          "description": "Adds a chart."
+        "maxValueColor": {
+          "$ref": "Color",
+          "description": "The background color for cells with a color value greater than or equal\nto maxValue. Defaults to #109618 if not\nspecified."
+        }
+      },
+      "id": "TreemapChartColorScale",
+      "description": "A color scale for a treemap chart."
+    },
+    "EmbeddedObjectPosition": {
+      "id": "EmbeddedObjectPosition",
+      "description": "The position of an embedded object such as a chart.",
+      "type": "object",
+      "properties": {
+        "sheetId": {
+          "description": "The sheet this is on. Set only if the embedded object\nis on its own sheet. Must be non-negative.",
+          "format": "int32",
+          "type": "integer"
         },
-        "findReplace": {
-          "$ref": "FindReplaceRequest",
-          "description": "Finds and replaces occurrences of some text with other text."
+        "overlayPosition": {
+          "$ref": "OverlayPosition",
+          "description": "The position at which the object is overlaid on top of a grid."
         },
-        "textToColumns": {
-          "$ref": "TextToColumnsRequest",
-          "description": "Converts a column of text into many columns of text."
+        "newSheet": {
+          "description": "If true, the embedded object is put on a new sheet whose ID\nis chosen for you. Used only when writing.",
+          "type": "boolean"
+        }
+      }
+    },
+    "DeveloperMetadataLookup": {
+      "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.",
+      "type": "object",
+      "properties": {
+        "metadataLocation": {
+          "$ref": "DeveloperMetadataLocation",
+          "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."
         },
-        "updateChartSpec": {
-          "$ref": "UpdateChartSpecRequest",
-          "description": "Updates a chart's specifications."
+        "locationMatchingStrategy": {
+          "type": "string",
+          "enumDescriptions": [
+            "Default value. This value must not be used.",
+            "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."
+          ],
+          "enum": [
+            "DEVELOPER_METADATA_LOCATION_MATCHING_STRATEGY_UNSPECIFIED",
+            "EXACT_LOCATION",
+            "INTERSECTING_LOCATION"
+          ],
+          "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."
         },
-        "addSheet": {
-          "description": "Adds a sheet.",
-          "$ref": "AddSheetRequest"
+        "locationType": {
+          "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.",
+          "type": "string",
+          "enumDescriptions": [
+            "Default value.",
+            "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"
+          ]
         },
-        "updateProtectedRange": {
-          "description": "Updates a protected range.",
-          "$ref": "UpdateProtectedRangeRequest"
+        "metadataKey": {
+          "description": "Limits the selected developer metadata to that which has a matching\nDeveloperMetadata.metadata_key.",
+          "type": "string"
         },
-        "deleteFilterView": {
-          "$ref": "DeleteFilterViewRequest",
-          "description": "Deletes a filter view from a sheet."
+        "metadataId": {
+          "description": "Limits the selected developer metadata to that which has a matching\nDeveloperMetadata.metadata_id.",
+          "format": "int32",
+          "type": "integer"
         },
-        "copyPaste": {
-          "$ref": "CopyPasteRequest",
-          "description": "Copies data from one area and pastes it to another."
-        },
-        "insertDimension": {
-          "description": "Inserts new rows or columns in a sheet.",
-          "$ref": "InsertDimensionRequest"
-        },
-        "deleteRange": {
-          "$ref": "DeleteRangeRequest",
-          "description": "Deletes a range of cells from a sheet, shifting the remaining cells."
-        },
-        "deleteBanding": {
-          "description": "Removes a banded range",
-          "$ref": "DeleteBandingRequest"
-        },
-        "addFilterView": {
-          "$ref": "AddFilterViewRequest",
-          "description": "Adds a filter view."
-        },
-        "deleteDuplicates": {
-          "description": "Removes rows containing duplicate values in specified columns of a cell\nrange.",
-          "$ref": "DeleteDuplicatesRequest"
-        },
-        "setDataValidation": {
-          "$ref": "SetDataValidationRequest",
-          "description": "Sets data validation for one or more cells."
-        },
-        "updateBorders": {
-          "$ref": "UpdateBordersRequest",
-          "description": "Updates the borders in a range of cells."
-        },
-        "deleteConditionalFormatRule": {
-          "$ref": "DeleteConditionalFormatRuleRequest",
-          "description": "Deletes an existing conditional format rule."
-        },
-        "repeatCell": {
-          "description": "Repeats a single cell across a range.",
-          "$ref": "RepeatCellRequest"
-        },
-        "clearBasicFilter": {
-          "$ref": "ClearBasicFilterRequest",
-          "description": "Clears the basic filter on a sheet."
-        },
-        "appendDimension": {
-          "$ref": "AppendDimensionRequest",
-          "description": "Appends dimensions to the end of a sheet."
-        },
-        "updateSlicerSpec": {
-          "$ref": "UpdateSlicerSpecRequest",
-          "description": "Updates a slicer's specifications."
-        },
-        "updateConditionalFormatRule": {
-          "$ref": "UpdateConditionalFormatRuleRequest",
-          "description": "Updates an existing conditional format rule."
-        },
-        "createDeveloperMetadata": {
-          "$ref": "CreateDeveloperMetadataRequest",
-          "description": "Creates new developer metadata"
-        },
-        "insertRange": {
-          "$ref": "InsertRangeRequest",
-          "description": "Inserts new cells in a sheet, shifting the existing cells."
-        },
-        "moveDimension": {
-          "$ref": "MoveDimensionRequest",
-          "description": "Moves rows or columns to another location in a sheet."
-        },
-        "deleteDeveloperMetadata": {
-          "$ref": "DeleteDeveloperMetadataRequest",
-          "description": "Deletes developer metadata"
-        },
-        "randomizeRange": {
-          "$ref": "RandomizeRangeRequest",
-          "description": "Randomizes the order of the rows in a range."
-        },
-        "updateBanding": {
-          "$ref": "UpdateBandingRequest",
-          "description": "Updates a banded range"
-        },
-        "addProtectedRange": {
-          "$ref": "AddProtectedRangeRequest",
-          "description": "Adds a protected range."
-        },
-        "deleteNamedRange": {
-          "$ref": "DeleteNamedRangeRequest",
-          "description": "Deletes a named range."
-        },
-        "duplicateSheet": {
-          "$ref": "DuplicateSheetRequest",
-          "description": "Duplicates a sheet."
-        },
-        "unmergeCells": {
-          "description": "Unmerges merged cells.",
-          "$ref": "UnmergeCellsRequest"
-        },
-        "deleteSheet": {
-          "description": "Deletes a sheet.",
-          "$ref": "DeleteSheetRequest"
-        },
-        "updateEmbeddedObjectPosition": {
-          "$ref": "UpdateEmbeddedObjectPositionRequest",
-          "description": "Updates an embedded object's (e.g. chart, image) position."
-        },
-        "addDimensionGroup": {
-          "description": "Creates a group over the specified range.",
-          "$ref": "AddDimensionGroupRequest"
-        },
-        "updateDeveloperMetadata": {
-          "$ref": "UpdateDeveloperMetadataRequest",
-          "description": "Updates an existing developer metadata entry"
-        },
-        "updateDimensionProperties": {
-          "$ref": "UpdateDimensionPropertiesRequest",
-          "description": "Updates dimensions' properties."
-        },
-        "pasteData": {
-          "$ref": "PasteDataRequest",
-          "description": "Pastes data (HTML or delimited) into a sheet."
-        },
-        "updateDimensionGroup": {
-          "$ref": "UpdateDimensionGroupRequest",
-          "description": "Updates the state of the specified group."
-        },
-        "setBasicFilter": {
-          "$ref": "SetBasicFilterRequest",
-          "description": "Sets the basic filter on a sheet."
-        },
-        "addConditionalFormatRule": {
-          "description": "Adds a new conditional format rule.",
-          "$ref": "AddConditionalFormatRuleRequest"
-        },
-        "addNamedRange": {
-          "description": "Adds a named range.",
-          "$ref": "AddNamedRangeRequest"
-        },
-        "updateCells": {
-          "$ref": "UpdateCellsRequest",
-          "description": "Updates many cells at once."
-        },
-        "updateSpreadsheetProperties": {
-          "$ref": "UpdateSpreadsheetPropertiesRequest",
-          "description": "Updates the spreadsheet's properties."
-        },
-        "trimWhitespace": {
-          "$ref": "TrimWhitespaceRequest",
-          "description": "Trims cells of whitespace (such as spaces, tabs, or new lines)."
-        },
-        "deleteEmbeddedObject": {
-          "$ref": "DeleteEmbeddedObjectRequest",
-          "description": "Deletes an embedded object (e.g, chart, image) in a sheet."
-        },
-        "updateFilterView": {
-          "$ref": "UpdateFilterViewRequest",
-          "description": "Updates the properties of a filter view."
-        },
-        "addBanding": {
-          "$ref": "AddBandingRequest",
-          "description": "Adds a new banded range"
-        },
-        "appendCells": {
-          "description": "Appends cells after the last row with data in a sheet.",
-          "$ref": "AppendCellsRequest"
-        },
-        "autoResizeDimensions": {
-          "$ref": "AutoResizeDimensionsRequest",
-          "description": "Automatically resizes one or more dimensions based on the contents\nof the cells in that dimension."
-        },
-        "cutPaste": {
-          "$ref": "CutPasteRequest",
-          "description": "Cuts data from one area and pastes it to another."
-        },
-        "mergeCells": {
-          "$ref": "MergeCellsRequest",
-          "description": "Merges cells together."
+        "visibility": {
+          "type": "string",
+          "enumDescriptions": [
+            "Default value.",
+            "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."
         },
-        "updateNamedRange": {
-          "$ref": "UpdateNamedRangeRequest",
-          "description": "Updates a named range."
+        "metadataValue": {
+          "description": "Limits the selected developer metadata to that which has a matching\nDeveloperMetadata.metadata_value.",
+          "type": "string"
         }
       },
-      "id": "Request"
+      "id": "DeveloperMetadataLookup"
     },
-    "GridRange": {
+    "AutoFillRequest": {
+      "id": "AutoFillRequest",
+      "description": "Fills in more data based on existing data.",
       "type": "object",
       "properties": {
-        "sheetId": {
-          "description": "The sheet this range is on.",
-          "format": "int32",
-          "type": "integer"
-        },
-        "endRowIndex": {
-          "description": "The end row (exclusive) of the range, or not set if unbounded.",
-          "format": "int32",
-          "type": "integer"
-        },
-        "endColumnIndex": {
-          "description": "The end column (exclusive) of the range, or not set if unbounded.",
-          "format": "int32",
-          "type": "integer"
+        "useAlternateSeries": {
+          "description": "True if we should generate data with the \"alternate\" series.\nThis differs based on the type and amount of source data.",
+          "type": "boolean"
         },
-        "startRowIndex": {
-          "description": "The start row (inclusive) of the range, or not set if unbounded.",
-          "format": "int32",
-          "type": "integer"
+        "sourceAndDestination": {
+          "$ref": "SourceAndDestination",
+          "description": "The source and destination areas to autofill.\nThis explicitly lists the source of the autofill and where to\nextend that data."
         },
-        "startColumnIndex": {
-          "description": "The start column (inclusive) of the range, or not set if unbounded.",
-          "format": "int32",
-          "type": "integer"
+        "range": {
+          "$ref": "GridRange",
+          "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."
         }
-      },
-      "id": "GridRange",
-      "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!`."
+      }
     },
-    "WaterfallChartDomain": {
-      "description": "The domain of a waterfall chart.",
+    "GradientRule": {
+      "id": "GradientRule",
+      "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.",
       "type": "object",
       "properties": {
-        "reversed": {
-          "description": "True to reverse the order of the domain values (horizontal axis).",
-          "type": "boolean"
+        "midpoint": {
+          "$ref": "InterpolationPoint",
+          "description": "An optional midway interpolation point."
         },
-        "data": {
-          "$ref": "ChartData",
-          "description": "The data of the WaterfallChartDomain."
+        "minpoint": {
+          "description": "The starting interpolation point.",
+          "$ref": "InterpolationPoint"
+        },
+        "maxpoint": {
+          "description": "The final interpolation point.",
+          "$ref": "InterpolationPoint"
         }
-      },
-      "id": "WaterfallChartDomain"
+      }
     },
-    "DeleteDimensionGroupRequest": {
-      "description": "Deletes a group over the specified range by decrementing the depth of the\ndimensions in the range.\n\nFor example, assume the sheet has a depth-1 group over B:E and a depth-2\ngroup over C:D. Deleting a group over D:E leaves the sheet with a\ndepth-1 group over B:D and a depth-2 group over C:C.",
+    "ClearValuesRequest": {
+      "id": "ClearValuesRequest",
+      "description": "The request for clearing a range of values in a spreadsheet.",
+      "type": "object",
+      "properties": {}
+    },
+    "SetBasicFilterRequest": {
+      "id": "SetBasicFilterRequest",
+      "description": "Sets the basic filter associated with a sheet.",
       "type": "object",
       "properties": {
-        "range": {
-          "description": "The range of the group to be deleted.",
-          "$ref": "DimensionRange"
+        "filter": {
+          "$ref": "BasicFilter",
+          "description": "The filter to set."
         }
-      },
-      "id": "DeleteDimensionGroupRequest"
+      }
     },
-    "SetDataValidationRequest": {
-      "description": "Sets a data validation rule to every cell in the range.\nTo clear validation in a range, call this with no rule specified.",
+    "BatchClearValuesByDataFilterRequest": {
       "type": "object",
       "properties": {
-        "rule": {
-          "$ref": "DataValidationRule",
-          "description": "The data validation rule to set on each cell in the range,\nor empty to clear the data validation in the range."
-        },
-        "range": {
-          "description": "The range the data validation rule should apply to.",
-          "$ref": "GridRange"
+        "dataFilters": {
+          "description": "The DataFilters used to determine which ranges to clear.",
+          "type": "array",
+          "items": {
+            "$ref": "DataFilter"
+          }
         }
       },
-      "id": "SetDataValidationRequest"
+      "id": "BatchClearValuesByDataFilterRequest",
+      "description": "The request for clearing more than one range selected by a\nDataFilter in a spreadsheet."
     },
-    "BubbleChartSpec": {
-      "id": "BubbleChartSpec",
-      "description": "A \u003ca href=\"/chart/interactive/docs/gallery/bubblechart\"\u003ebubble chart\u003c/a\u003e.",
+    "GetSpreadsheetByDataFilterRequest": {
       "type": "object",
       "properties": {
-        "series": {
-          "$ref": "ChartData",
-          "description": "The data contianing the bubble y-values.  These values locate the bubbles\nin the chart vertically."
+        "includeGridData": {
+          "description": "True if grid data should be returned.\nThis parameter is ignored if a field mask was set in the request.",
+          "type": "boolean"
         },
-        "legendPosition": {
-          "type": "string",
-          "enumDescriptions": [
-            "Default value, do not use.",
-            "The legend is rendered on the bottom of the chart.",
-            "The legend is rendered on the left of the chart.",
-            "The legend is rendered on the right of the chart.",
-            "The legend is rendered on the top of the chart.",
-            "No legend is rendered.",
-            "The legend is rendered inside the chart area."
-          ],
-          "enum": [
-            "BUBBLE_CHART_LEGEND_POSITION_UNSPECIFIED",
-            "BOTTOM_LEGEND",
-            "LEFT_LEGEND",
-            "RIGHT_LEGEND",
-            "TOP_LEGEND",
-            "NO_LEGEND",
-            "INSIDE_LEGEND"
-          ],
-          "description": "Where the legend of the chart should be drawn."
-        },
-        "domain": {
-          "$ref": "ChartData",
-          "description": "The data containing the bubble x-values.  These values locate the bubbles\nin the chart horizontally."
-        },
-        "bubbleSizes": {
-          "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.",
-          "$ref": "ChartData"
-        },
-        "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"
-        },
-        "bubbleTextStyle": {
-          "$ref": "TextFormat",
-          "description": "The format of the text inside the bubbles.\nUnderline and Strikethrough are not supported."
+        "dataFilters": {
+          "description": "The DataFilters used to select which ranges to retrieve from\nthe spreadsheet.",
+          "type": "array",
+          "items": {
+            "$ref": "DataFilter"
+          }
+        }
+      },
+      "id": "GetSpreadsheetByDataFilterRequest",
+      "description": "The request for retrieving a Spreadsheet."
+    },
+    "DeleteEmbeddedObjectRequest": {
+      "type": "object",
+      "properties": {
+        "objectId": {
+          "type": "integer",
+          "description": "The ID of the embedded object to delete.",
+          "format": "int32"
+        }
+      },
+      "id": "DeleteEmbeddedObjectRequest",
+      "description": "Deletes the embedded object with the given ID."
+    },
+    "UpdateValuesByDataFilterResponse": {
+      "description": "The response when updating a range of values by a data filter in a\nspreadsheet.",
+      "type": "object",
+      "properties": {
+        "updatedColumns": {
+          "description": "The number of columns where at least one cell in the column was updated.",
+          "format": "int32",
+          "type": "integer"
         },
-        "bubbleBorderColor": {
-          "$ref": "Color",
-          "description": "The bubble border color."
+        "updatedRange": {
+          "description": "The range (in A1 notation) that updates were applied to.",
+          "type": "string"
         },
-        "groupIds": {
-          "description": "The data containing the bubble group IDs. All bubbles with the same group\nID are 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"
+        "updatedCells": {
+          "type": "integer",
+          "description": "The number of cells updated.",
+          "format": "int32"
         },
-        "bubbleLabels": {
-          "$ref": "ChartData",
-          "description": "The data containing the bubble labels.  These do not need to be unique."
+        "dataFilter": {
+          "$ref": "DataFilter",
+          "description": "The data filter that selected the range that was updated."
         },
-        "bubbleMinRadiusSize": {
-          "description": "The minimum radius size of the bubbles, in pixels.\nIf specific, the field must be a positive value.",
-          "format": "int32",
-          "type": "integer"
+        "updatedData": {
+          "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`.",
+          "$ref": "ValueRange"
         },
-        "bubbleMaxRadiusSize": {
-          "description": "The max radius size of the bubbles, in pixels.\nIf specified, the field must be a positive value.",
+        "updatedRows": {
+          "description": "The number of rows where at least one cell in the row was updated.",
           "format": "int32",
           "type": "integer"
         }
-      }
+      },
+      "id": "UpdateValuesByDataFilterResponse"
     },
-    "TextPosition": {
-      "description": "Position settings for text.",
+    "DeleteSheetRequest": {
       "type": "object",
       "properties": {
-        "horizontalAlignment": {
-          "type": "string",
-          "enumDescriptions": [
-            "The horizontal alignment is not specified. Do not use this.",
-            "The text is explicitly aligned to the left of the cell.",
-            "The text is explicitly aligned to the center of the cell.",
-            "The text is explicitly aligned to the right of the cell."
-          ],
-          "enum": [
-            "HORIZONTAL_ALIGN_UNSPECIFIED",
-            "LEFT",
-            "CENTER",
-            "RIGHT"
-          ],
-          "description": "Horizontal alignment setting for the piece of text."
+        "sheetId": {
+          "type": "integer",
+          "description": "The ID of the sheet to delete.",
+          "format": "int32"
         }
       },
-      "id": "TextPosition"
+      "id": "DeleteSheetRequest",
+      "description": "Deletes the requested sheet."
     },
-    "BatchUpdateSpreadsheetRequest": {
+    "MatchedValueRange": {
+      "description": "A value range that was matched by one or more data filers.",
       "type": "object",
       "properties": {
-        "includeSpreadsheetInResponse": {
-          "description": "Determines if the update response should include the spreadsheet\nresource.",
-          "type": "boolean"
+        "valueRange": {
+          "$ref": "ValueRange",
+          "description": "The values matched by the DataFilter."
         },
-        "responseRanges": {
-          "description": "Limits the ranges included in the response spreadsheet.\nMeaningful only if include_spreadsheet_response is 'true'.",
+        "dataFilters": {
+          "description": "The DataFilters from the request that matched the range of\nvalues.",
           "type": "array",
           "items": {
-            "type": "string"
+            "$ref": "DataFilter"
           }
-        },
-        "responseIncludeGridData": {
-          "description": "True if grid data should be returned. Meaningful only if\nif include_spreadsheet_in_response is 'true'.\nThis parameter is ignored if a field mask was set in the request.",
-          "type": "boolean"
-        },
-        "requests": {
-          "type": "array",
-          "items": {
-            "$ref": "Request"
-          },
-          "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."
-        }
-      },
-      "id": "BatchUpdateSpreadsheetRequest",
-      "description": "The request for updating any aspect of a spreadsheet."
-    },
-    "Padding": {
-      "description": "The amount of padding around the cell, in pixels.\nWhen updating padding, every field must be specified.",
-      "type": "object",
-      "properties": {
-        "left": {
-          "description": "The left padding of the cell.",
-          "format": "int32",
-          "type": "integer"
-        },
-        "right": {
-          "description": "The right padding of the cell.",
-          "format": "int32",
-          "type": "integer"
-        },
-        "bottom": {
-          "description": "The bottom padding of the cell.",
-          "format": "int32",
-          "type": "integer"
-        },
-        "top": {
-          "description": "The top padding of the cell.",
-          "format": "int32",
-          "type": "integer"
         }
       },
-      "id": "Padding"
+      "id": "MatchedValueRange"
     },
-    "BasicChartAxis": {
+    "DeveloperMetadataLocation": {
       "type": "object",
       "properties": {
-        "viewWindowOptions": {
-          "description": "The view window options for this axis.",
-          "$ref": "ChartAxisViewWindowOptions"
-        },
-        "position": {
-          "description": "The position of this axis.",
+        "locationType": {
+          "description": "The type of location this object represents.  This field is read-only.",
           "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."
+            "Default value.",
+            "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": [
-            "BASIC_CHART_AXIS_POSITION_UNSPECIFIED",
-            "BOTTOM_AXIS",
-            "LEFT_AXIS",
-            "RIGHT_AXIS"
+            "DEVELOPER_METADATA_LOCATION_TYPE_UNSPECIFIED",
+            "ROW",
+            "COLUMN",
+            "SHEET",
+            "SPREADSHEET"
           ]
         },
-        "title": {
-          "type": "string",
-          "description": "The title of this axis. If set, this overrides any title inferred\nfrom headers of the data."
+        "dimensionRange": {
+          "$ref": "DimensionRange",
+          "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."
         },
-        "titleTextPosition": {
-          "$ref": "TextPosition",
-          "description": "The axis title text position."
+        "spreadsheet": {
+          "type": "boolean",
+          "description": "True when metadata is associated with an entire spreadsheet."
         },
-        "format": {
-          "$ref": "TextFormat",
-          "description": "The format of the title.\nOnly valid if the axis is not associated with the domain."
-        }
-      },
-      "id": "BasicChartAxis",
-      "description": "An axis of the chart.\nA chart may not have more than one axis per\naxis position."
-    },
-    "DeleteDimensionRequest": {
-      "type": "object",
-      "properties": {
-        "range": {
-          "$ref": "DimensionRange",
-          "description": "The dimensions to delete from the sheet."
+        "sheetId": {
+          "description": "The ID of the sheet when metadata is associated with an entire sheet.",
+          "format": "int32",
+          "type": "integer"
         }
       },
-      "id": "DeleteDimensionRequest",
-      "description": "Deletes the dimensions from the sheet."
+      "id": "DeveloperMetadataLocation",
+      "description": "A location where metadata may be associated in a spreadsheet."
     },
-    "UpdateChartSpecRequest": {
+    "DuplicateSheetRequest": {
       "type": "object",
       "properties": {
-        "chartId": {
-          "description": "The ID of the chart to update.",
+        "newSheetId": {
+          "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.",
           "format": "int32",
           "type": "integer"
         },
-        "spec": {
-          "description": "The specification to apply to the chart.",
-          "$ref": "ChartSpec"
-        }
-      },
-      "id": "UpdateChartSpecRequest",
-      "description": "Updates a chart's specifications.\n(This does not move or resize a chart. To move or resize a chart, use\n UpdateEmbeddedObjectPositionRequest.)"
-    },
-    "DeleteFilterViewRequest": {
-      "type": "object",
-      "properties": {
-        "filterId": {
-          "description": "The ID of the filter to delete.",
+        "insertSheetIndex": {
+          "description": "The zero-based index where the new sheet should be inserted.\nThe index of all sheets after this are incremented.",
           "format": "int32",
           "type": "integer"
+        },
+        "newSheetName": {
+          "description": "The name of the new sheet.  If empty, a new name is chosen for you.",
+          "type": "string"
+        },
+        "sourceSheetId": {
+          "type": "integer",
+          "description": "The sheet to duplicate.",
+          "format": "int32"
         }
       },
-      "id": "DeleteFilterViewRequest",
-      "description": "Deletes a particular filter view."
+      "id": "DuplicateSheetRequest",
+      "description": "Duplicates the contents of a sheet."
     },
-    "BatchGetValuesByDataFilterRequest": {
-      "description": "The request for retrieving a range of values in a spreadsheet selected by a\nset of DataFilters.",
+    "TreemapChartSpec": {
+      "id": "TreemapChartSpec",
+      "description": "A \u003ca href=\"/chart/interactive/docs/gallery/treemap\"\u003eTreemap chart\u003c/a\u003e.",
       "type": "object",
       "properties": {
-        "dataFilters": {
-          "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"
-          }
+        "parentLabels": {
+          "$ref": "ChartData",
+          "description": "The data the contains the treemap cells' parent labels."
         },
-        "valueRenderOption": {
-          "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\"`."
-          ],
-          "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"
+        "headerColor": {
+          "$ref": "Color",
+          "description": "The background color for header cells."
         },
-        "dateTimeRenderOption": {
-          "type": "string",
-          "enumDescriptions": [
-            "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)."
-          ],
-          "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]."
+        "labels": {
+          "$ref": "ChartData",
+          "description": "The data that contains the treemap cell labels."
         },
-        "majorDimension": {
-          "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]]`.",
-          "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"
-          ]
-        }
-      },
-      "id": "BatchGetValuesByDataFilterRequest"
-    },
-    "BatchUpdateValuesResponse": {
-      "id": "BatchUpdateValuesResponse",
-      "description": "The response when updating a range of values in a spreadsheet.",
-      "type": "object",
-      "properties": {
-        "totalUpdatedRows": {
-          "description": "The total number of rows where at least one cell in the row was updated.",
-          "format": "int32",
-          "type": "integer"
+        "colorData": {
+          "$ref": "ChartData",
+          "description": "The data that determines the background color of each treemap data cell.\nThis field is optional. If not specified, size_data is used to\ndetermine background colors. If specified, the data is expected to be\nnumeric. color_scale will determine how the values in this data map to\ndata cell background colors."
         },
-        "responses": {
-          "description": "One UpdateValuesResponse per requested range, in the same order as\nthe requests appeared.",
-          "type": "array",
-          "items": {
-            "$ref": "UpdateValuesResponse"
-          }
+        "maxValue": {
+          "description": "The maximum possible data value. Cells with values greater than this will\nhave the same color as cells with this value. If not specified, defaults\nto the actual maximum value from color_data, or the maximum value from\nsize_data if color_data is not specified.",
+          "format": "double",
+          "type": "number"
         },
-        "totalUpdatedSheets": {
-          "description": "The total number of sheets where at least one cell in the sheet was\nupdated.",
-          "format": "int32",
-          "type": "integer"
+        "colorScale": {
+          "$ref": "TreemapChartColorScale",
+          "description": "The color scale for data cells in the treemap chart. Data cells are\nassigned colors based on their color values. These color values come from\ncolor_data, or from size_data if color_data is not specified.\nCells with color values less than or equal to min_value will\nhave minValueColor as their\nbackground color. Cells with color values greater than or equal to\nmax_value will have\nmaxValueColor as their background\ncolor. Cells with color values between min_value and max_value will\nhave background colors on a gradient between\nminValueColor and\nmaxValueColor, the midpoint of\nthe gradient being midValueColor.\nCells with missing or non-numeric color values will have\nnoDataColor as their background\ncolor."
         },
-        "totalUpdatedCells": {
-          "description": "The total number of cells updated.",
+        "hideTooltips": {
+          "description": "True to hide tooltips.",
+          "type": "boolean"
+        },
+        "hintedLevels": {
+          "description": "The number of additional data levels beyond the labeled levels to be shown\non the treemap chart. These levels are not interactive and are shown\nwithout their labels. Defaults to 0 if not specified.",
           "format": "int32",
           "type": "integer"
         },
-        "totalUpdatedColumns": {
-          "description": "The total number of columns where at least one cell in the column was\nupdated.",
+        "minValue": {
+          "description": "The minimum possible data value. Cells with values less than this will\nhave the same color as cells with this value. If not specified, defaults\nto the actual minimum value from color_data, or the minimum value from\nsize_data if color_data is not specified.",
+          "format": "double",
+          "type": "number"
+        },
+        "levels": {
+          "description": "The number of data levels to show on the treemap chart. These levels are\ninteractive and are shown with their labels. Defaults to 2 if not\nspecified.",
           "format": "int32",
           "type": "integer"
         },
-        "spreadsheetId": {
-          "description": "The spreadsheet the updates were applied to.",
-          "type": "string"
+        "sizeData": {
+          "$ref": "ChartData",
+          "description": "The data that determines the size of each treemap data cell. This data is\nexpected to be numeric. The cells corresponding to non-numeric or missing\ndata will not be rendered. If color_data is not specified, this data\nis used to determine data cell background colors as well."
+        },
+        "textFormat": {
+          "$ref": "TextFormat",
+          "description": "The text format for all labels on the chart."
         }
       }
     },
-    "BatchClearValuesRequest": {
-      "id": "BatchClearValuesRequest",
-      "description": "The request for clearing more than one range of values in a spreadsheet.",
+    "ExtendedValue": {
+      "id": "ExtendedValue",
+      "description": "The kinds of value that a cell in a spreadsheet can have.",
       "type": "object",
       "properties": {
-        "ranges": {
-          "description": "The ranges to clear, in A1 notation.",
-          "type": "array",
-          "items": {
-            "type": "string"
-          }
+        "errorValue": {
+          "$ref": "ErrorValue",
+          "description": "Represents an error.\nThis field is read-only."
+        },
+        "stringValue": {
+          "type": "string",
+          "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\"`."
+        },
+        "boolValue": {
+          "type": "boolean",
+          "description": "Represents a boolean value."
+        },
+        "formulaValue": {
+          "description": "Represents a formula.",
+          "type": "string"
+        },
+        "numberValue": {
+          "description": "Represents a double value.\nNote: Dates, Times and DateTimes are represented as doubles in\n\"serial number\" format.",
+          "format": "double",
+          "type": "number"
         }
       }
     },
-    "KeyValueFormat": {
+    "BatchClearValuesResponse": {
+      "description": "The response when clearing a range of values in a spreadsheet.",
       "type": "object",
       "properties": {
-        "position": {
-          "$ref": "TextPosition",
-          "description": "Specifies the horizontal text positioning of key value.\nThis field is optional. If not specified, default positioning is used."
+        "clearedRanges": {
+          "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"
+          }
         },
-        "textFormat": {
-          "$ref": "TextFormat",
-          "description": "Text formatting options for key value."
+        "spreadsheetId": {
+          "description": "The spreadsheet the updates were applied to.",
+          "type": "string"
         }
       },
-      "id": "KeyValueFormat",
-      "description": "Formatting options for key value."
+      "id": "BatchClearValuesResponse"
     },
-    "DeveloperMetadata": {
+    "DataFilter": {
+      "description": "Filter that describes what data should be selected or returned from a\nrequest.",
       "type": "object",
       "properties": {
-        "metadataKey": {
-          "description": "The metadata key. There may be multiple metadata in a spreadsheet with the\nsame key.  Developer metadata must always have a key specified.",
-          "type": "string"
-        },
-        "metadataId": {
-          "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.",
-          "format": "int32",
-          "type": "integer"
+        "gridRange": {
+          "$ref": "GridRange",
+          "description": "Selects data that matches the range described by the GridRange."
         },
-        "location": {
-          "$ref": "DeveloperMetadataLocation",
-          "description": "The location where the metadata is associated."
+        "developerMetadataLookup": {
+          "$ref": "DeveloperMetadataLookup",
+          "description": "Selects data associated with the developer metadata matching the criteria\ndescribed by this DeveloperMetadataLookup."
         },
-        "visibility": {
+        "a1Range": {
           "type": "string",
-          "enumDescriptions": [
-            "Default value.",
-            "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": "The metadata visibility.  Developer metadata must always have a visibility\nspecified."
-        },
-        "metadataValue": {
-          "description": "Data associated with the metadata's key.",
-          "type": "string"
+          "description": "Selects data that matches the specified A1 range."
         }
       },
-      "id": "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 is deleted too."
+      "id": "DataFilter"
     },
-    "BaselineValueFormat": {
-      "description": "Formatting options for baseline value.",
+    "TextFormat": {
+      "description": "The format of a run of text in a cell.\nAbsent values indicate that the field isn't specified.",
       "type": "object",
       "properties": {
-        "negativeColor": {
-          "$ref": "Color",
-          "description": "Color to be used, in case baseline value represents a negative change for\nkey value. This field is optional."
-        },
-        "comparisonType": {
-          "enumDescriptions": [
-            "Default value, do not use.",
-            "Use absolute difference between key and baseline value.",
-            "Use percentage difference between key and baseline value."
-          ],
-          "enum": [
-            "COMPARISON_TYPE_UNDEFINED",
-            "ABSOLUTE_DIFFERENCE",
-            "PERCENTAGE_DIFFERENCE"
-          ],
-          "description": "The comparison type of key value with baseline value.",
-          "type": "string"
+        "underline": {
+          "description": "True if the text is underlined.",
+          "type": "boolean"
         },
-        "position": {
-          "$ref": "TextPosition",
-          "description": "Specifies the horizontal text positioning of baseline value.\nThis field is optional. If not specified, default positioning is used."
+        "bold": {
+          "description": "True if the text is bold.",
+          "type": "boolean"
         },
-        "positiveColor": {
+        "foregroundColor": {
           "$ref": "Color",
-          "description": "Color to be used, in case baseline value represents a positive change for\nkey value. This field is optional."
-        },
-        "textFormat": {
-          "description": "Text formatting options for baseline value.",
-          "$ref": "TextFormat"
+          "description": "The foreground color of the text."
         },
-        "description": {
+        "fontFamily": {
           "type": "string",
-          "description": "Description which is appended after the baseline value.\nThis field is optional."
-        }
-      },
-      "id": "BaselineValueFormat"
-    },
-    "DimensionGroup": {
-      "type": "object",
-      "properties": {
-        "collapsed": {
-          "description": "This field is true if this group is collapsed. A collapsed group remains\ncollapsed if an overlapping group at a shallower depth is expanded.\n\nA true value does not imply that all dimensions within the group are\nhidden, since a dimension's visibility can change independently from this\ngroup property. However, when this property is updated, all dimensions\nwithin it are set to hidden if this field is true, or set to visible if\nthis field is false.",
-          "type": "boolean"
+          "description": "The font family."
         },
-        "range": {
-          "$ref": "DimensionRange",
-          "description": "The range over which this group exists."
+        "strikethrough": {
+          "type": "boolean",
+          "description": "True if the text has a strikethrough."
         },
-        "depth": {
-          "type": "integer",
-          "description": "The depth of the group, representing how many groups have a range that\nwholly contains the range of this group.",
-          "format": "int32"
+        "italic": {
+          "description": "True if the text is italicized.",
+          "type": "boolean"
+        },
+        "fontSize": {
+          "description": "The size of the font.",
+          "format": "int32",
+          "type": "integer"
         }
       },
-      "id": "DimensionGroup",
-      "description": "A group over an interval of rows or columns on a sheet, which can contain or\nbe contained within other groups. A group can be collapsed or expanded as a\nunit on the sheet."
+      "id": "TextFormat"
     },
-    "ClearBasicFilterRequest": {
+    "DeleteDuplicatesRequest": {
+      "id": "DeleteDuplicatesRequest",
+      "description": "Removes rows within this range that contain values in the specified columns\nthat are duplicates of values in any previous row. Rows with identical values\nbut different letter cases, formatting, or formulas are considered to be\nduplicates.\n\nThis request also removes duplicate rows hidden from view (for example, due\nto a filter). When removing duplicates, the first instance of each duplicate\nrow scanning from the top downwards is kept in the resulting range. Content\noutside of the specified range isn't removed, and rows considered duplicates\ndo not have to be adjacent to each other in the range.",
       "type": "object",
       "properties": {
-        "sheetId": {
-          "type": "integer",
-          "description": "The sheet ID on which the basic filter should be cleared.",
-          "format": "int32"
+        "range": {
+          "$ref": "GridRange",
+          "description": "The range to remove duplicates rows from."
+        },
+        "comparisonColumns": {
+          "description": "The columns in the range to analyze for duplicate values. If no columns are\nselected then all columns are analyzed for duplicates.",
+          "type": "array",
+          "items": {
+            "$ref": "DimensionRange"
+          }
         }
-      },
-      "id": "ClearBasicFilterRequest",
-      "description": "Clears the basic filter, if any exists on the sheet."
+      }
     },
-    "TextToColumnsRequest": {
-      "id": "TextToColumnsRequest",
-      "description": "Splits a column of text into multiple columns,\nbased on a delimiter in each cell.",
+    "RepeatCellRequest": {
+      "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.",
       "type": "object",
       "properties": {
-        "delimiter": {
-          "description": "The delimiter to use. Used only if delimiterType is\nCUSTOM.",
-          "type": "string"
+        "cell": {
+          "$ref": "CellData",
+          "description": "The data to write."
         },
-        "source": {
-          "$ref": "GridRange",
-          "description": "The source data range.  This must span exactly one column."
+        "range": {
+          "description": "The range to repeat the cell in.",
+          "$ref": "GridRange"
         },
-        "delimiterType": {
-          "description": "The delimiter type to use.",
-          "type": "string",
-          "enumDescriptions": [
-            "Default value. This value must not be used.",
-            "\",\"",
-            "\";\"",
-            "\".\"",
-            "\" \"",
-            "A custom value as defined in delimiter.",
-            "Automatically detect columns."
-          ],
-          "enum": [
-            "DELIMITER_TYPE_UNSPECIFIED",
-            "COMMA",
-            "SEMICOLON",
-            "PERIOD",
-            "SPACE",
-            "CUSTOM",
-            "AUTODETECT"
-          ]
+        "fields": {
+          "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.",
+          "format": "google-fieldmask",
+          "type": "string"
         }
-      }
+      },
+      "id": "RepeatCellRequest"
     },
-    "DeleteBandingRequest": {
-      "id": "DeleteBandingRequest",
-      "description": "Removes the banded range with the given ID from the spreadsheet.",
+    "UpdateSpreadsheetPropertiesRequest": {
+      "id": "UpdateSpreadsheetPropertiesRequest",
+      "description": "Updates properties of a spreadsheet.",
       "type": "object",
       "properties": {
-        "bandedRangeId": {
-          "description": "The ID of the banded range to delete.",
-          "format": "int32",
-          "type": "integer"
+        "properties": {
+          "$ref": "SpreadsheetProperties",
+          "description": "The properties to update."
+        },
+        "fields": {
+          "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.",
+          "format": "google-fieldmask",
+          "type": "string"
         }
       }
     },
-    "AppendValuesResponse": {
-      "description": "The response when updating a range of values in a spreadsheet.",
+    "ProtectedRange": {
       "type": "object",
       "properties": {
-        "updates": {
-          "description": "Information about the updates that were applied.",
-          "$ref": "UpdateValuesResponse"
+        "range": {
+          "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.",
+          "$ref": "GridRange"
         },
-        "tableRange": {
-          "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.",
+        "editors": {
+          "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"
+        },
+        "description": {
+          "description": "The description of this protected range.",
           "type": "string"
         },
-        "spreadsheetId": {
-          "type": "string",
-          "description": "The spreadsheet the updates were applied to."
+        "unprotectedRanges": {
+          "type": "array",
+          "items": {
+            "$ref": "GridRange"
+          },
+          "description": "The list of unprotected ranges within a protected sheet.\nUnprotected ranges are only supported on protected sheets."
+        },
+        "namedRangeId": {
+          "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": {
+          "description": "The ID of the protected range.\nThis field is read-only.",
+          "format": "int32",
+          "type": "integer"
+        },
+        "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.",
+          "type": "boolean"
         }
       },
-      "id": "AppendValuesResponse"
+      "id": "ProtectedRange",
+      "description": "A protected range."
     },
-    "PivotFilterCriteria": {
+    "DimensionProperties": {
+      "description": "Properties about a dimension.",
       "type": "object",
       "properties": {
-        "visibleValues": {
-          "description": "Values that should be included.  Values not listed here are excluded.",
+        "developerMetadata": {
           "type": "array",
           "items": {
-            "type": "string"
-          }
+            "$ref": "DeveloperMetadata"
+          },
+          "description": "The developer metadata associated with a single row or column."
+        },
+        "pixelSize": {
+          "description": "The height (if a row) or width (if a column) of the dimension in pixels.",
+          "format": "int32",
+          "type": "integer"
+        },
+        "hiddenByFilter": {
+          "description": "True if this dimension is being filtered.\nThis field is read-only.",
+          "type": "boolean"
+        },
+        "hiddenByUser": {
+          "type": "boolean",
+          "description": "True if this dimension is explicitly hidden."
         }
       },
-      "id": "PivotFilterCriteria",
-      "description": "Criteria for showing/hiding rows in a pivot table."
+      "id": "DimensionProperties"
     },
-    "MoveDimensionRequest": {
-      "description": "Moves one or more rows or columns.",
+    "DimensionRange": {
+      "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.",
       "type": "object",
       "properties": {
-        "source": {
-          "$ref": "DimensionRange",
-          "description": "The source dimensions to move."
+        "sheetId": {
+          "type": "integer",
+          "description": "The sheet this span is on.",
+          "format": "int32"
         },
-        "destinationIndex": {
-          "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`.",
+        "dimension": {
+          "description": "The dimension of the span.",
+          "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"
+          ]
+        },
+        "startIndex": {
+          "type": "integer",
+          "description": "The start (inclusive) of the span, or not set if unbounded.",
+          "format": "int32"
+        },
+        "endIndex": {
+          "description": "The end (exclusive) of the span, or not set if unbounded.",
           "format": "int32",
           "type": "integer"
         }
       },
-      "id": "MoveDimensionRequest"
+      "id": "DimensionRange"
     },
-    "AddConditionalFormatRuleRequest": {
-      "description": "Adds a new conditional format rule at the given index.\nAll subsequent rules' indexes are incremented.",
+    "NamedRange": {
+      "description": "A named range.",
       "type": "object",
       "properties": {
-        "index": {
-          "description": "The zero-based index where the rule should be inserted.",
-          "format": "int32",
-          "type": "integer"
+        "range": {
+          "$ref": "GridRange",
+          "description": "The range this represents."
         },
-        "rule": {
-          "$ref": "ConditionalFormatRule",
-          "description": "The rule to add."
+        "name": {
+          "description": "The name of the named range.",
+          "type": "string"
+        },
+        "namedRangeId": {
+          "type": "string",
+          "description": "The ID of the named range."
         }
       },
-      "id": "AddConditionalFormatRuleRequest"
+      "id": "NamedRange"
     },
-    "ChartSpec": {
-      "description": "The specifications of a chart.",
+    "ChartCustomNumberFormatOptions": {
+      "description": "Custom number formatting options for chart attributes.",
       "type": "object",
       "properties": {
-        "subtitleTextFormat": {
-          "$ref": "TextFormat",
-          "description": "The subtitle text format.\nStrikethrough and underline are not supported."
-        },
-        "subtitle": {
-          "description": "The subtitle of the chart.",
+        "prefix": {
+          "description": "Custom prefix to be prepended to the chart attribute.\nThis field is optional.",
           "type": "string"
         },
-        "backgroundColor": {
-          "$ref": "Color",
-          "description": "The background color of the entire chart.\nNot applicable to Org charts."
-        },
-        "subtitleTextPosition": {
-          "description": "The subtitle text position.\nThis field is optional.",
-          "$ref": "TextPosition"
-        },
-        "basicChart": {
-          "$ref": "BasicChartSpec",
-          "description": "A basic chart specification, can be one of many kinds of charts.\nSee BasicChartType for the list of all\ncharts this supports."
-        },
-        "orgChart": {
-          "description": "An org chart specification.",
-          "$ref": "OrgChartSpec"
-        },
-        "scorecardChart": {
-          "description": "A scorecard chart specification.",
-          "$ref": "ScorecardChartSpec"
-        },
-        "pieChart": {
-          "$ref": "PieChartSpec",
-          "description": "A pie chart specification."
-        },
-        "titleTextFormat": {
-          "$ref": "TextFormat",
-          "description": "The title text format.\nStrikethrough and underline are not supported."
-        },
-        "title": {
-          "description": "The title of the chart.",
+        "suffix": {
+          "description": "Custom suffix to be appended to the chart attribute.\nThis field is optional.",
           "type": "string"
+        }
+      },
+      "id": "ChartCustomNumberFormatOptions"
+    },
+    "Borders": {
+      "type": "object",
+      "properties": {
+        "left": {
+          "$ref": "Border",
+          "description": "The left border of the cell."
         },
-        "altText": {
-          "type": "string",
-          "description": "The alternative text that describes the chart.  This is often used\nfor accessibility."
-        },
-        "titleTextPosition": {
-          "$ref": "TextPosition",
-          "description": "The title text position.\nThis field is optional."
-        },
-        "histogramChart": {
-          "description": "A histogram chart specification.",
-          "$ref": "HistogramChartSpec"
+        "right": {
+          "$ref": "Border",
+          "description": "The right border of the cell."
         },
-        "candlestickChart": {
-          "$ref": "CandlestickChartSpec",
-          "description": "A candlestick chart specification."
+        "bottom": {
+          "$ref": "Border",
+          "description": "The bottom border of the cell."
         },
-        "bubbleChart": {
-          "$ref": "BubbleChartSpec",
-          "description": "A bubble chart specification."
-        },
-        "waterfallChart": {
-          "description": "A waterfall chart specification.",
-          "$ref": "WaterfallChartSpec"
-        },
-        "fontName": {
-          "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.",
-          "type": "string"
-        },
-        "maximized": {
-          "type": "boolean",
-          "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.)"
-        },
-        "treemapChart": {
-          "$ref": "TreemapChartSpec",
-          "description": "A treemap chart specification."
-        },
-        "hiddenDimensionStrategy": {
-          "type": "string",
-          "enumDescriptions": [
-            "Default value, do not use.",
-            "Charts will skip hidden rows and columns.",
-            "Charts will skip hidden rows only.",
-            "Charts will skip hidden columns only.",
-            "Charts will not skip any hidden rows or columns."
-          ],
-          "enum": [
-            "CHART_HIDDEN_DIMENSION_STRATEGY_UNSPECIFIED",
-            "SKIP_HIDDEN_ROWS_AND_COLUMNS",
-            "SKIP_HIDDEN_ROWS",
-            "SKIP_HIDDEN_COLUMNS",
-            "SHOW_ALL"
-          ],
-          "description": "Determines how the charts will use hidden rows or columns."
+        "top": {
+          "$ref": "Border",
+          "description": "The top border of the cell."
         }
       },
-      "id": "ChartSpec"
+      "id": "Borders",
+      "description": "The borders of the cell."
     },
-    "CreateDeveloperMetadataRequest": {
+    "ManualRule": {
       "type": "object",
       "properties": {
-        "developerMetadata": {
-          "$ref": "DeveloperMetadata",
-          "description": "The developer metadata to create."
+        "groups": {
+          "description": "The list of group names and the corresponding items from the source data\nthat map to each group name.",
+          "type": "array",
+          "items": {
+            "$ref": "ManualRuleGroup"
+          }
         }
       },
-      "id": "CreateDeveloperMetadataRequest",
-      "description": "A request to create developer metadata."
+      "id": "ManualRule",
+      "description": "Allows you to manually organize the values in a source data column into\nbuckets with names of your choosing. For example, a pivot table that\naggregates population by state:\n\n    +-------+-------------------+\n    | State | SUM of Population |\n    +-------+-------------------+\n    | AK    |               0.7 |\n    | AL    |               4.8 |\n    | AR    |               2.9 |\n    ...\n    +-------+-------------------+\ncould be turned into a pivot table that aggregates population by time zone\nby providing a list of groups (for example, groupName = 'Central',\nitems = ['AL', 'AR', 'IA', ...]) to a manual group rule.\nNote that a similar effect could be achieved by adding a time zone column\nto the source data and adjusting the pivot table.\n\n    +-----------+-------------------+\n    | Time Zone | SUM of Population |\n    +-----------+-------------------+\n    | Central   |             106.3 |\n    | Eastern   |             151.9 |\n    | Mountain  |              17.4 |\n    ...\n    +-----------+-------------------+"
     },
-    "BatchGetValuesByDataFilterResponse": {
-      "description": "The response when retrieving more than one range of values in a spreadsheet\nselected by DataFilters.",
+    "DeleteConditionalFormatRuleRequest": {
       "type": "object",
       "properties": {
-        "valueRanges": {
-          "description": "The requested values with the list of data filters that matched them.",
-          "type": "array",
-          "items": {
-            "$ref": "MatchedValueRange"
-          }
+        "index": {
+          "description": "The zero-based index of the rule to be deleted.",
+          "format": "int32",
+          "type": "integer"
         },
-        "spreadsheetId": {
-          "description": "The ID of the spreadsheet the data was retrieved from.",
-          "type": "string"
+        "sheetId": {
+          "description": "The sheet the rule is being deleted from.",
+          "format": "int32",
+          "type": "integer"
         }
       },
-      "id": "BatchGetValuesByDataFilterResponse"
+      "id": "DeleteConditionalFormatRuleRequest",
+      "description": "Deletes a conditional format rule at the given index.\nAll subsequent rules' indexes are decremented."
     },
-    "LineStyle": {
-      "description": "Properties that describe the style of a line.",
+    "DeleteNamedRangeRequest": {
       "type": "object",
       "properties": {
-        "type": {
-          "description": "The dash type of the line.",
+        "namedRangeId": {
           "type": "string",
-          "enumDescriptions": [
-            "Default value, do not use.",
-            "No dash type, which is equivalent to a non-visible line.",
-            "A custom dash for a line. Modifying the exact custom dash style is\ncurrently unsupported.",
-            "A solid line.",
-            "A dotted line.",
-            "A dashed line where the dashes have \"medium\" length.",
-            "A line that alternates between a \"medium\" dash and a dot.",
-            "A dashed line where the dashes have \"long\" length.",
-            "A line that alternates between a \"long\" dash and a dot."
-          ],
-          "enum": [
-            "LINE_DASH_TYPE_UNSPECIFIED",
-            "INVISIBLE",
-            "CUSTOM",
-            "SOLID",
-            "DOTTED",
-            "MEDIUM_DASHED",
-            "MEDIUM_DASHED_DOTTED",
-            "LONG_DASHED",
-            "LONG_DASHED_DOTTED"
-          ]
-        },
-        "width": {
-          "description": "The thickness of the line, in px.",
-          "format": "int32",
-          "type": "integer"
+          "description": "The ID of the named range to delete."
         }
       },
-      "id": "LineStyle"
+      "id": "DeleteNamedRangeRequest",
+      "description": "Removes the named range with the given ID from the spreadsheet."
     },
-    "CandlestickDomain": {
-      "description": "The domain of a CandlestickChart.",
+    "AddBandingResponse": {
+      "description": "The result of adding a banded range.",
       "type": "object",
       "properties": {
-        "data": {
-          "$ref": "ChartData",
-          "description": "The data of the CandlestickDomain."
-        },
-        "reversed": {
-          "description": "True to reverse the order of the domain values (horizontal axis).",
-          "type": "boolean"
+        "bandedRange": {
+          "description": "The banded range that was added.",
+          "$ref": "BandedRange"
         }
       },
-      "id": "CandlestickDomain"
+      "id": "AddBandingResponse"
     },
-    "SheetProperties": {
+    "AddDimensionGroupResponse": {
+      "description": "The result of adding a group.",
       "type": "object",
       "properties": {
-        "hidden": {
-          "description": "True if the sheet is hidden in the UI, false if it's visible.",
-          "type": "boolean"
-        },
-        "sheetType": {
-          "description": "The type of sheet. Defaults to GRID.\nThis field cannot be changed once set.",
-          "type": "string",
-          "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"
-          ]
-        },
-        "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.",
-          "$ref": "GridProperties"
-        },
-        "title": {
-          "type": "string",
-          "description": "The name of the sheet."
-        },
-        "index": {
-          "description": "The index of the sheet within the spreadsheet.\nWhen adding or updating sheet properties, if this field\nis excluded then the sheet is 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 is 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.",
-          "format": "int32",
-          "type": "integer"
-        },
-        "tabColor": {
-          "$ref": "Color",
-          "description": "The color of the tab in the UI."
-        },
-        "sheetId": {
-          "description": "The ID of the sheet. Must be non-negative.\nThis field cannot be changed once set.",
-          "format": "int32",
-          "type": "integer"
-        },
-        "rightToLeft": {
-          "description": "True if the sheet is an RTL sheet instead of an LTR sheet.",
-          "type": "boolean"
+        "dimensionGroups": {
+          "description": "All groups of a dimension after adding a group to that dimension.",
+          "type": "array",
+          "items": {
+            "$ref": "DimensionGroup"
+          }
         }
       },
-      "id": "SheetProperties",
-      "description": "Properties of a sheet."
+      "id": "AddDimensionGroupResponse"
     },
-    "UpdateDimensionPropertiesRequest": {
-      "description": "Updates properties of dimensions within the specified range.",
+    "ManualRuleGroup": {
+      "description": "A group name and a list of items from the source data that should be placed\nin the group with this name.",
       "type": "object",
       "properties": {
-        "properties": {
-          "$ref": "DimensionProperties",
-          "description": "Properties to update."
-        },
-        "range": {
-          "$ref": "DimensionRange",
-          "description": "The rows or columns to update."
+        "groupName": {
+          "description": "The group name, which must be a string. Each group in a given\nManualRule must have a unique group name.",
+          "$ref": "ExtendedValue"
         },
-        "fields": {
-          "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.",
-          "format": "google-fieldmask",
-          "type": "string"
+        "items": {
+          "description": "The items in the source data that should be placed into this group. Each\nitem may be a string, number, or boolean. Items may appear in at most one\ngroup within a given ManualRule. Items that do not appear in any\ngroup will appear on their own.",
+          "type": "array",
+          "items": {
+            "$ref": "ExtendedValue"
+          }
         }
       },
-      "id": "UpdateDimensionPropertiesRequest"
+      "id": "ManualRuleGroup"
     },
-    "SourceAndDestination": {
-      "description": "A combination of a source range and how to extend that source.",
+    "PivotGroup": {
+      "id": "PivotGroup",
+      "description": "A single grouping (either row or column) in a pivot table.",
       "type": "object",
       "properties": {
-        "source": {
-          "description": "The location of the data to use as the source of the autofill.",
-          "$ref": "GridRange"
+        "label": {
+          "description": "The labels to use for the row/column groups which can be customized. For\nexample, in the following pivot table, the row label is `Region` (which\ncould be renamed to `State`) and the column label is `Product` (which\ncould be renamed `Item`). Pivot tables created before December 2017 do\nnot have header labels. If you'd like to add header labels to an existing\npivot table, please delete the existing pivot table and then create a new\npivot table with same parameters.\n\n    +--------------+---------+-------+\n    | SUM of Units | Product |       |\n    | Region       | Pen     | Paper |\n    +--------------+---------+-------+\n    | New York     |     345 |    98 |\n    | Oregon       |     234 |   123 |\n    | Tennessee    |     531 |   415 |\n    +--------------+---------+-------+\n    | Grand Total  |    1110 |   636 |\n    +--------------+---------+-------+",
+          "type": "string"
         },
-        "dimension": {
+        "repeatHeadings": {
+          "type": "boolean",
+          "description": "True if the headings in this pivot group should be repeated.\nThis is only valid for row groupings and is ignored by columns.\n\nBy default, we minimize repitition of headings by not showing higher\nlevel headings where they are the same. For example, even though the\nthird row below corresponds to \"Q1 Mar\", \"Q1\" is not shown because\nit is redundant with previous rows. Setting repeat_headings to true\nwould cause \"Q1\" to be repeated for \"Feb\" and \"Mar\".\n\n    +--------------+\n    | Q1     | Jan |\n    |        | Feb |\n    |        | Mar |\n    +--------+-----+\n    | Q1 Total     |\n    +--------------+"
+        },
+        "sourceColumnOffset": {
+          "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",
+          "type": "integer"
+        },
+        "sortOrder": {
+          "type": "string",
           "enumDescriptions": [
-            "The default value, do not use.",
-            "Operates on the rows of a sheet.",
-            "Operates on the columns of a sheet."
+            "Default value, do not use this.",
+            "Sort ascending.",
+            "Sort descending."
           ],
           "enum": [
-            "DIMENSION_UNSPECIFIED",
-            "ROWS",
-            "COLUMNS"
+            "SORT_ORDER_UNSPECIFIED",
+            "ASCENDING",
+            "DESCENDING"
           ],
-          "description": "The dimension that data should be filled into.",
-          "type": "string"
+          "description": "The order the values in this group should be sorted."
         },
-        "fillLength": {
+        "valueBucket": {
+          "description": "The bucket of the opposite pivot group to sort by.\nIf not specified, sorting is alphabetical by this group's values.",
+          "$ref": "PivotGroupSortValueBucket"
+        },
+        "showTotals": {
+          "description": "True if the pivot table should include the totals for this grouping.",
+          "type": "boolean"
+        },
+        "valueMetadata": {
+          "type": "array",
+          "items": {
+            "$ref": "PivotGroupValueMetadata"
+          },
+          "description": "Metadata about values in the grouping."
+        },
+        "groupRule": {
+          "$ref": "PivotGroupRule",
+          "description": "The group rule to apply to this row/column group."
+        }
+      }
+    },
+    "TrimWhitespaceResponse": {
+      "description": "The result of trimming whitespace in cells.",
+      "type": "object",
+      "properties": {
+        "cellsChangedCount": {
           "type": "integer",
-          "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 number of cells that were trimmed of whitespace.",
           "format": "int32"
         }
       },
-      "id": "SourceAndDestination"
+      "id": "TrimWhitespaceResponse"
     },
-    "SlicerSpec": {
+    "PivotTable": {
+      "description": "A pivot table.",
       "type": "object",
       "properties": {
-        "title": {
-          "type": "string",
-          "description": "The title of the slicer."
-        },
-        "horizontalAlignment": {
-          "description": "The horizontal alignment of title in the slicer.\nIf unspecified, defaults to `LEFT`",
-          "type": "string",
-          "enumDescriptions": [
-            "The horizontal alignment is not specified. Do not use this.",
-            "The text is explicitly aligned to the left of the cell.",
-            "The text is explicitly aligned to the center of the cell.",
-            "The text is explicitly aligned to the right of the cell."
+        "criteria": {
+          "additionalProperties": {
+            "$ref": "PivotFilterCriteria"
+          },
+          "description": "An optional mapping of filters per source column offset.\n\nThe filters are 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": {
+          "description": "Each row grouping in the pivot table.",
+          "type": "array",
+          "items": {
+            "$ref": "PivotGroup"
+          }
+        },
+        "valueLayout": {
+          "description": "Whether values should be listed horizontally (as columns)\nor vertically (as rows).",
+          "type": "string",
+          "enumDescriptions": [
+            "Values are laid out horizontally (as columns).",
+            "Values are laid out vertically (as rows)."
           ],
           "enum": [
-            "HORIZONTAL_ALIGN_UNSPECIFIED",
-            "LEFT",
-            "CENTER",
-            "RIGHT"
+            "HORIZONTAL",
+            "VERTICAL"
           ]
         },
-        "textFormat": {
-          "$ref": "TextFormat",
-          "description": "The text format of title in the slicer."
-        },
-        "backgroundColor": {
-          "$ref": "Color",
-          "description": "The background color of the slicer."
-        },
-        "filterCriteria": {
-          "$ref": "FilterCriteria",
-          "description": "The filtering criteria of the slicer."
-        },
-        "dataRange": {
-          "description": "The data range of the slicer.",
+        "source": {
+          "description": "The range the pivot table is reading data from.",
           "$ref": "GridRange"
         },
-        "applyToPivotTables": {
-          "description": "True if the filter should apply to pivot tables.\nIf not set, default to `True`.",
-          "type": "boolean"
+        "columns": {
+          "description": "Each column grouping in the pivot table.",
+          "type": "array",
+          "items": {
+            "$ref": "PivotGroup"
+          }
         },
-        "columnIndex": {
-          "description": "The column index in the data table on which the filter is applied to.",
-          "format": "int32",
-          "type": "integer"
+        "values": {
+          "type": "array",
+          "items": {
+            "$ref": "PivotValue"
+          },
+          "description": "A list of values to include in the pivot table."
         }
       },
-      "id": "SlicerSpec",
-      "description": "The specifications of a slicer."
+      "id": "PivotTable"
     },
-    "CandlestickSeries": {
-      "id": "CandlestickSeries",
-      "description": "The series of a CandlestickData.",
+    "SearchDeveloperMetadataResponse": {
+      "id": "SearchDeveloperMetadataResponse",
+      "description": "A reply to a developer metadata search request.",
       "type": "object",
       "properties": {
-        "data": {
-          "$ref": "ChartData",
-          "description": "The data of the CandlestickSeries."
+        "matchedDeveloperMetadata": {
+          "description": "The metadata matching the criteria of the search request.",
+          "type": "array",
+          "items": {
+            "$ref": "MatchedDeveloperMetadata"
+          }
         }
       }
     },
-    "HistogramChartSpec": {
-      "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.",
+    "AppendCellsRequest": {
+      "description": "Adds new cells after the last row with data in a sheet,\ninserting new rows into the sheet if necessary.",
       "type": "object",
       "properties": {
-        "bucketSize": {
-          "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.",
-          "format": "double",
-          "type": "number"
-        },
-        "outlierPercentile": {
-          "type": "number",
-          "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.",
-          "format": "double"
-        },
-        "showItemDividers": {
-          "description": "Whether horizontal divider lines should be displayed between items in each\ncolumn.",
-          "type": "boolean"
+        "sheetId": {
+          "description": "The sheet ID to append the data to.",
+          "format": "int32",
+          "type": "integer"
         },
-        "series": {
-          "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.",
+        "rows": {
+          "description": "The data to append.",
           "type": "array",
           "items": {
-            "$ref": "HistogramSeries"
+            "$ref": "RowData"
           }
         },
-        "legendPosition": {
-          "description": "The position of the chart legend.",
-          "type": "string",
-          "enumDescriptions": [
-            "Default value, do not use.",
-            "The legend is rendered on the bottom of the chart.",
-            "The legend is rendered on the left of the chart.",
-            "The legend is rendered on the right of the chart.",
-            "The legend is rendered on the top of the chart.",
-            "No legend is rendered.",
-            "The legend is rendered inside the chart area."
-          ],
-          "enum": [
-            "HISTOGRAM_CHART_LEGEND_POSITION_UNSPECIFIED",
-            "BOTTOM_LEGEND",
-            "LEFT_LEGEND",
-            "RIGHT_LEGEND",
-            "TOP_LEGEND",
-            "NO_LEGEND",
-            "INSIDE_LEGEND"
-          ]
+        "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"
         }
       },
-      "id": "HistogramChartSpec"
+      "id": "AppendCellsRequest"
     },
-    "UpdateValuesResponse": {
-      "id": "UpdateValuesResponse",
-      "description": "The response when updating a range of values in a spreadsheet.",
+    "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.",
       "type": "object",
       "properties": {
-        "updatedColumns": {
-          "description": "The number of columns where at least one cell in the column was updated.",
+        "startIndex": {
+          "description": "The character index where this run starts.",
           "format": "int32",
           "type": "integer"
         },
+        "format": {
+          "description": "The format of this run.  Absent values inherit the cell's format.",
+          "$ref": "TextFormat"
+        }
+      },
+      "id": "TextFormatRun"
+    },
+    "BatchUpdateValuesByDataFilterResponse": {
+      "type": "object",
+      "properties": {
         "spreadsheetId": {
           "description": "The spreadsheet the updates were applied to.",
           "type": "string"
         },
-        "updatedRange": {
-          "description": "The range (in A1 notation) that updates were applied to.",
-          "type": "string"
+        "totalUpdatedRows": {
+          "description": "The total number of rows where at least one cell in the row was updated.",
+          "format": "int32",
+          "type": "integer"
         },
-        "updatedCells": {
+        "responses": {
+          "type": "array",
+          "items": {
+            "$ref": "UpdateValuesByDataFilterResponse"
+          },
+          "description": "The response for each range updated."
+        },
+        "totalUpdatedSheets": {
+          "description": "The total number of sheets where at least one cell in the sheet was\nupdated.",
+          "format": "int32",
+          "type": "integer"
+        },
+        "totalUpdatedCells": {
           "type": "integer",
-          "description": "The number of cells updated.",
+          "description": "The total number of cells updated.",
           "format": "int32"
         },
-        "updatedData": {
-          "$ref": "ValueRange",
-          "description": "The values of the cells after updates were applied.\nThis is only included if the request's `includeValuesInResponse` field\nwas `true`."
-        },
-        "updatedRows": {
-          "description": "The number of rows where at least one cell in the row was updated.",
+        "totalUpdatedColumns": {
+          "description": "The total number of columns where at least one cell in the column was\nupdated.",
           "format": "int32",
           "type": "integer"
         }
-      }
+      },
+      "id": "BatchUpdateValuesByDataFilterResponse",
+      "description": "The response when updating a range of values in a spreadsheet."
     },
-    "WaterfallChartSeries": {
-      "description": "A single series of data for a waterfall chart.",
+    "RowData": {
       "type": "object",
       "properties": {
-        "customSubtotals": {
+        "values": {
           "type": "array",
           "items": {
-            "$ref": "WaterfallChartCustomSubtotal"
+            "$ref": "CellData"
           },
-          "description": "Custom subtotal columns appearing in this series. The order in which\nsubtotals are defined is not significant. Only one subtotal may be\ndefined for each data point."
-        },
-        "subtotalColumnsStyle": {
-          "$ref": "WaterfallChartColumnStyle",
-          "description": "Styles for all subtotal columns in this series."
-        },
-        "positiveColumnsStyle": {
-          "description": "Styles for all columns in this series with positive values.",
-          "$ref": "WaterfallChartColumnStyle"
-        },
-        "data": {
-          "$ref": "ChartData",
-          "description": "The data being visualized in this series."
+          "description": "The values in the row, one per column."
+        }
+      },
+      "id": "RowData",
+      "description": "Data about each cell in a row."
+    },
+    "Border": {
+      "type": "object",
+      "properties": {
+        "style": {
+          "type": "string",
+          "enumDescriptions": [
+            "The style is not specified. Do not use this.",
+            "The border is dotted.",
+            "The border is dashed.",
+            "The border is a thin solid line.",
+            "The border is a medium solid line.",
+            "The border is a thick solid line.",
+            "No border.\nUsed only when updating a border in order to erase it.",
+            "The border is two solid lines."
+          ],
+          "enum": [
+            "STYLE_UNSPECIFIED",
+            "DOTTED",
+            "DASHED",
+            "SOLID",
+            "SOLID_MEDIUM",
+            "SOLID_THICK",
+            "NONE",
+            "DOUBLE"
+          ],
+          "description": "The style of the border."
         },
-        "negativeColumnsStyle": {
-          "$ref": "WaterfallChartColumnStyle",
-          "description": "Styles for all columns in this series with negative values."
+        "color": {
+          "$ref": "Color",
+          "description": "The color of the border."
         },
-        "hideTrailingSubtotal": {
-          "description": "True to hide the subtotal column from the end of the series. By default,\na subtotal column will appear at the end of each series. Setting this\nfield to true will hide that subtotal column for this series.",
-          "type": "boolean"
+        "width": {
+          "description": "The width of the border, in pixels.\nDeprecated; the width is determined by the \"style\" field.",
+          "format": "int32",
+          "type": "integer"
         }
       },
-      "id": "WaterfallChartSeries"
+      "id": "Border",
+      "description": "A border along a cell."
     },
-    "PivotGroupSortValueBucket": {
-      "description": "Information about which values in a pivot group should be used for sorting.",
+    "GridData": {
       "type": "object",
       "properties": {
-        "valuesIndex": {
-          "description": "The offset in the PivotTable.values list which the values in this\ngrouping should be sorted by.",
+        "rowData": {
+          "type": "array",
+          "items": {
+            "$ref": "RowData"
+          },
+          "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."
+        },
+        "startRow": {
+          "description": "The first row this GridData refers to, zero-based.",
           "format": "int32",
           "type": "integer"
         },
-        "buckets": {
-          "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.",
+        "columnMetadata": {
+          "description": "Metadata about the requested columns in the grid, starting with the column\nin start_column.",
           "type": "array",
           "items": {
-            "$ref": "ExtendedValue"
+            "$ref": "DimensionProperties"
           }
-        }
-      },
-      "id": "PivotGroupSortValueBucket"
-    },
-    "DeleteDeveloperMetadataRequest": {
-      "description": "A request to delete developer metadata.",
+        },
+        "startColumn": {
+          "description": "The first column this GridData refers to, zero-based.",
+          "format": "int32",
+          "type": "integer"
+        },
+        "rowMetadata": {
+          "description": "Metadata about the requested rows in the grid, starting with the row\nin start_row.",
+          "type": "array",
+          "items": {
+            "$ref": "DimensionProperties"
+          }
+        }
+      },
+      "id": "GridData",
+      "description": "Data in the grid, as well as metadata about the dimensions."
+    },
+    "UpdateNamedRangeRequest": {
+      "description": "Updates properties of the named range with the specified\nnamedRangeId.",
       "type": "object",
       "properties": {
-        "dataFilter": {
-          "$ref": "DataFilter",
-          "description": "The data filter describing the criteria used to select which developer\nmetadata entry to delete."
+        "namedRange": {
+          "$ref": "NamedRange",
+          "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.",
+          "format": "google-fieldmask"
         }
       },
-      "id": "DeleteDeveloperMetadataRequest"
+      "id": "UpdateNamedRangeRequest"
     },
-    "CandlestickData": {
+    "FindReplaceRequest": {
+      "description": "Finds and replaces data in cells over a range, sheet, or all sheets.",
       "type": "object",
       "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."
+        "includeFormulas": {
+          "description": "True if the search should include cells with formulas.\nFalse to skip cells with formulas.",
+          "type": "boolean"
         },
-        "lowSeries": {
-          "$ref": "CandlestickSeries",
-          "description": "The range data (vertical axis) for the low/minimum value for each candle.\nThis is the bottom of the candle's center line."
+        "matchEntireCell": {
+          "description": "True if the find value should match the entire cell.",
+          "type": "boolean"
         },
-        "closeSeries": {
-          "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"
+        "find": {
+          "description": "The value to search.",
+          "type": "string"
         },
-        "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."
+        "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.",
+          "type": "boolean"
+        },
+        "replacement": {
+          "type": "string",
+          "description": "The value to use as the replacement."
+        },
+        "range": {
+          "description": "The range to find/replace over.",
+          "$ref": "GridRange"
+        },
+        "sheetId": {
+          "description": "The sheet to find/replace over.",
+          "format": "int32",
+          "type": "integer"
+        },
+        "matchCase": {
+          "description": "True if the search is case sensitive.",
+          "type": "boolean"
+        },
+        "allSheets": {
+          "type": "boolean",
+          "description": "True to find/replace over all sheets."
         }
       },
-      "id": "CandlestickData",
-      "description": "The Candlestick chart data, each containing the low, open, close, and high\nvalues for a series."
+      "id": "FindReplaceRequest"
     },
-    "DeleteProtectedRangeRequest": {
-      "description": "Deletes the protected range with the given ID.",
+    "UpdateCellsRequest": {
+      "description": "Updates all cells in a range with new data.",
       "type": "object",
       "properties": {
-        "protectedRangeId": {
-          "type": "integer",
-          "description": "The ID of the protected range to delete.",
-          "format": "int32"
+        "range": {
+          "$ref": "GridRange",
+          "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."
+        },
+        "rows": {
+          "type": "array",
+          "items": {
+            "$ref": "RowData"
+          },
+          "description": "The data to write."
+        },
+        "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"
+        },
+        "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."
         }
       },
-      "id": "DeleteProtectedRangeRequest"
+      "id": "UpdateCellsRequest"
     },
-    "InterpolationPoint": {
+    "RandomizeRangeRequest": {
       "type": "object",
       "properties": {
-        "type": {
+        "range": {
+          "$ref": "GridRange",
+          "description": "The range to randomize."
+        }
+      },
+      "id": "RandomizeRangeRequest",
+      "description": "Randomizes the order of the rows in a range."
+    },
+    "DeleteRangeRequest": {
+      "description": "Deletes a range of cells, shifting other cells into the deleted area.",
+      "type": "object",
+      "properties": {
+        "shiftDimension": {
           "type": "string",
           "enumDescriptions": [
             "The default value, do not use.",
-            "The interpolation point uses the minimum value in the\ncells over the range of the conditional format.",
-            "The interpolation point uses the maximum value in the\ncells over the range of the conditional format.",
-            "The interpolation point uses exactly the value in\nInterpolationPoint.value.",
-            "The interpolation point is 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 is 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)."
+            "Operates on the rows of a sheet.",
+            "Operates on the columns of a sheet."
           ],
           "enum": [
-            "INTERPOLATION_POINT_TYPE_UNSPECIFIED",
-            "MIN",
-            "MAX",
-            "NUMBER",
-            "PERCENT",
-            "PERCENTILE"
+            "DIMENSION_UNSPECIFIED",
+            "ROWS",
+            "COLUMNS"
           ],
-          "description": "How the value should be interpreted."
-        },
-        "value": {
-          "type": "string",
-          "description": "The value this interpolation point uses.  May be a formula.\nUnused if type is MIN or\nMAX."
+          "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."
         },
-        "color": {
-          "$ref": "Color",
-          "description": "The color this interpolation point should use."
+        "range": {
+          "$ref": "GridRange",
+          "description": "The range of cells to delete."
         }
       },
-      "id": "InterpolationPoint",
-      "description": "A single interpolation point on a gradient conditional format.\nThese pin the gradient color scale according to the color,\ntype and value chosen."
+      "id": "DeleteRangeRequest"
     },
-    "FindReplaceResponse": {
-      "description": "The result of the find/replace.",
+    "DeleteDuplicatesResponse": {
       "type": "object",
       "properties": {
-        "rowsChanged": {
-          "description": "The number of rows changed.",
-          "format": "int32",
-          "type": "integer"
-        },
-        "sheetsChanged": {
-          "description": "The number of sheets changed.",
-          "format": "int32",
-          "type": "integer"
-        },
-        "formulasChanged": {
-          "description": "The number of formula cells changed.",
-          "format": "int32",
-          "type": "integer"
-        },
-        "valuesChanged": {
-          "description": "The number of non-formula cells changed.",
-          "format": "int32",
-          "type": "integer"
-        },
-        "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\"`.",
+        "duplicatesRemovedCount": {
+          "description": "The number of duplicate rows removed.",
           "format": "int32",
           "type": "integer"
         }
       },
-      "id": "FindReplaceResponse"
+      "id": "DeleteDuplicatesResponse",
+      "description": "The result of removing duplicates in a range."
     },
-    "DuplicateFilterViewRequest": {
-      "description": "Duplicates a particular filter view.",
+    "UnmergeCellsRequest": {
       "type": "object",
       "properties": {
-        "filterId": {
-          "description": "The ID of the filter being duplicated.",
-          "format": "int32",
-          "type": "integer"
+        "range": {
+          "$ref": "GridRange",
+          "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": "DuplicateFilterViewRequest"
+      "id": "UnmergeCellsRequest",
+      "description": "Unmerges cells in the given range."
     },
-    "UpdateConditionalFormatRuleResponse": {
-      "id": "UpdateConditionalFormatRuleResponse",
-      "description": "The result of updating a conditional format rule.",
+    "SortSpec": {
+      "description": "A sort order associated with a specific column or row.",
       "type": "object",
       "properties": {
-        "newIndex": {
-          "type": "integer",
-          "description": "The index of the new rule.",
-          "format": "int32"
-        },
-        "oldIndex": {
-          "description": "The old index of the rule. Not set if a rule was replaced\n(because it is the same as new_index).",
+        "dimensionIndex": {
+          "description": "The dimension the sort should be applied to.",
           "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)"
+        "backgroundColor": {
+          "$ref": "Color",
+          "description": "The background fill color to sort by. Mutually exclusive with sorting by\ntext color. Requests to set this field will fail with a 400 error if\nforeground color is also set."
         },
-        "oldRule": {
-          "$ref": "ConditionalFormatRule",
-          "description": "The old (deleted) rule. Not set if a rule was moved\n(because it is the same as new_rule)."
-        }
-      }
-    },
-    "ConditionValue": {
-      "description": "The value of the condition.",
-      "type": "object",
-      "properties": {
-        "relativeDate": {
-          "enumDescriptions": [
-            "Default value, do not use.",
-            "The value is one year before today.",
-            "The value is one month before today.",
-            "The value is one week before today.",
-            "The value is yesterday.",
-            "The value is today.",
-            "The value is tomorrow."
-          ],
+        "sortOrder": {
           "enum": [
-            "RELATIVE_DATE_UNSPECIFIED",
-            "PAST_YEAR",
-            "PAST_MONTH",
-            "PAST_WEEK",
-            "YESTERDAY",
-            "TODAY",
-            "TOMORROW"
+            "SORT_ORDER_UNSPECIFIED",
+            "ASCENDING",
+            "DESCENDING"
           ],
-          "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.",
-          "type": "string"
+          "description": "The order data should be sorted.",
+          "type": "string",
+          "enumDescriptions": [
+            "Default value, do not use this.",
+            "Sort ascending.",
+            "Sort descending."
+          ]
         },
-        "userEnteredValue": {
-          "description": "A value the condition is based on.\nThe value is parsed as if the user typed into a cell.\nFormulas are supported (and must begin with an `=` or a '+').",
-          "type": "string"
+        "foregroundColor": {
+          "description": "The text color to sort by. Mutually exclusive with sorting by background\nfill color. Requests to set this field will fail with a 400 error if\nbackground color is also set.",
+          "$ref": "Color"
         }
       },
-      "id": "ConditionValue"
+      "id": "SortSpec"
     },
-    "DateTimeRule": {
+    "UpdateEmbeddedObjectPositionResponse": {
+      "description": "The result of updating an embedded object's position.",
       "type": "object",
       "properties": {
-        "type": {
-          "type": "string",
-          "enumDescriptions": [
-            "The default type, do not use.",
-            "Group dates by second, from 0 to 59.",
-            "Group dates by minute, from 0 to 59.",
-            "Group dates by hour using a 24-hour system, from 0 to 23.",
-            "Group dates by hour and minute using a 24-hour system, for example 19:45.",
-            "Group dates by hour and minute using a 12-hour system, for example 7:45\nPM. The AM/PM designation is translated based on the spreadsheet\nlocale.",
-            "Group dates by day of week, for example Sunday. The days of the week will\nbe translated based on the spreadsheet locale.",
-            "Group dates by day of year, from 1 to 366. Note that dates after Feb. 29\nfall in different buckets in leap years than in non-leap years.",
-            "Group dates by day of month, from 1 to 31.",
-            "Group dates by day and month, for example 22-Nov. The month is\ntranslated based on the spreadsheet locale.",
-            "Group dates by month, for example Nov. The month is translated based\non the spreadsheet locale.",
-            "Group dates by quarter, for example Q1 (which represents Jan-Mar).",
-            "Group dates by year, for example 2008.",
-            "Group dates by year and month, for example 2008-Nov. The month is\ntranslated based on the spreadsheet locale.",
-            "Group dates by year and quarter, for example 2008 Q4.",
-            "Group dates by year, month, and day, for example 2008-11-22."
-          ],
-          "enum": [
-            "DATE_TIME_RULE_TYPE_UNSPECIFIED",
-            "SECOND",
-            "MINUTE",
-            "HOUR",
-            "HOUR_MINUTE",
-            "HOUR_MINUTE_AMPM",
-            "DAY_OF_WEEK",
-            "DAY_OF_YEAR",
-            "DAY_OF_MONTH",
-            "DAY_MONTH",
-            "MONTH",
-            "QUARTER",
-            "YEAR",
-            "YEAR_MONTH",
-            "YEAR_QUARTER",
-            "YEAR_MONTH_DAY"
-          ],
-          "description": "The type of date-time grouping to apply."
-        }
-      },
-      "id": "DateTimeRule",
-      "description": "Allows you to organize the date-time values in a source data column into\nbuckets based on selected parts of their date or time values. For example,\nconsider a pivot table showing sales transactions by date:\n\n    +----------+--------------+\n    | Date     | SUM of Sales |\n    +----------+--------------+\n    | 1/1/2017 |      $621.14 |\n    | 2/3/2017 |      $708.84 |\n    | 5/8/2017 |      $326.84 |\n    ...\n    +----------+--------------+\nApplying a date-time group rule with a DateTimeRuleType of YEAR_MONTH\nresults in the following pivot table.\n\n    +--------------+--------------+\n    | Grouped Date | SUM of Sales |\n    +--------------+--------------+\n    | 2017-Jan     |   $53,731.78 |\n    | 2017-Feb     |   $83,475.32 |\n    | 2017-Mar     |   $94,385.05 |\n    ...\n    +--------------+--------------+"
-    },
-    "AddChartRequest": {
-      "description": "Adds a chart to a sheet in the spreadsheet.",
-      "type": "object",
-      "properties": {
-        "chart": {
-          "$ref": "EmbeddedChart",
-          "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 an embedded object that already exists.)"
+        "position": {
+          "description": "The new position of the embedded object.",
+          "$ref": "EmbeddedObjectPosition"
         }
       },
-      "id": "AddChartRequest"
+      "id": "UpdateEmbeddedObjectPositionResponse"
     },
-    "BandedRange": {
-      "description": "A banded (alternating colors) range in a sheet.",
+    "BooleanRule": {
+      "id": "BooleanRule",
+      "description": "A rule that may or may not match, depending on the condition.",
       "type": "object",
       "properties": {
-        "range": {
-          "$ref": "GridRange",
-          "description": "The range over which these properties are applied."
-        },
-        "bandedRangeId": {
-          "description": "The id of the banded range.",
-          "format": "int32",
-          "type": "integer"
-        },
-        "rowProperties": {
-          "$ref": "BandingProperties",
-          "description": "Properties for row bands. These properties are 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."
+        "format": {
+          "$ref": "CellFormat",
+          "description": "The format to apply.\nConditional formatting can only apply a subset of formatting:\nbold, italic,\nstrikethrough,\nforeground color &\nbackground color."
         },
-        "columnProperties": {
-          "$ref": "BandingProperties",
-          "description": "Properties for column bands. These properties are 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."
+        "condition": {
+          "$ref": "BooleanCondition",
+          "description": "The condition of the rule. If the condition evaluates to true,\nthe format is applied."
         }
-      },
-      "id": "BandedRange"
+      }
     },
-    "Spreadsheet": {
+    "WaterfallChartSpec": {
+      "id": "WaterfallChartSpec",
+      "description": "A waterfall chart.",
       "type": "object",
       "properties": {
-        "spreadsheetId": {
-          "description": "The ID of the spreadsheet.\nThis field is read-only.",
-          "type": "string"
-        },
-        "namedRanges": {
-          "type": "array",
-          "items": {
-            "$ref": "NamedRange"
-          },
-          "description": "The named ranges defined in a spreadsheet."
+        "hideConnectorLines": {
+          "description": "True to hide connector lines between columns.",
+          "type": "boolean"
         },
-        "developerMetadata": {
-          "description": "The developer metadata associated with a spreadsheet.",
-          "type": "array",
-          "items": {
-            "$ref": "DeveloperMetadata"
-          }
+        "stackedType": {
+          "enum": [
+            "WATERFALL_STACKED_TYPE_UNSPECIFIED",
+            "STACKED",
+            "SEQUENTIAL"
+          ],
+          "description": "The stacked type.",
+          "type": "string",
+          "enumDescriptions": [
+            "Default value, do not use.",
+            "Values corresponding to the same domain (horizontal axis) value will be\nstacked vertically.",
+            "Series will spread out along the horizontal axis."
+          ]
         },
-        "sheets": {
+        "series": {
           "type": "array",
           "items": {
-            "$ref": "Sheet"
+            "$ref": "WaterfallChartSeries"
           },
-          "description": "The sheets that are part of a spreadsheet."
+          "description": "The data this waterfall chart is visualizing."
         },
-        "spreadsheetUrl": {
-          "description": "The url of the spreadsheet.\nThis field is read-only.",
-          "type": "string"
+        "connectorLineStyle": {
+          "$ref": "LineStyle",
+          "description": "The line style for the connector lines."
         },
-        "properties": {
-          "$ref": "SpreadsheetProperties",
-          "description": "Overall properties of a spreadsheet."
-        }
-      },
-      "id": "Spreadsheet",
-      "description": "Resource that represents a spreadsheet."
-    },
-    "HistogramSeries": {
-      "id": "HistogramSeries",
-      "description": "A histogram series containing the series color and data.",
-      "type": "object",
-      "properties": {
-        "barColor": {
-          "$ref": "Color",
-          "description": "The color of the column representing this series in each bucket.\nThis field is optional."
+        "domain": {
+          "$ref": "WaterfallChartDomain",
+          "description": "The domain data (horizontal axis) for the waterfall chart."
         },
-        "data": {
-          "description": "The data for this histogram series.",
-          "$ref": "ChartData"
+        "firstValueIsTotal": {
+          "description": "True to interpret the first value as a total.",
+          "type": "boolean"
         }
       }
     },
-    "UpdateProtectedRangeRequest": {
-      "description": "Updates an existing protected range with the specified\nprotectedRangeId.",
+    "UpdateConditionalFormatRuleRequest": {
+      "description": "Updates a conditional format rule at the given index,\nor moves a conditional format rule to another index.",
       "type": "object",
       "properties": {
-        "protectedRange": {
-          "$ref": "ProtectedRange",
-          "description": "The protected range to update with the new properties."
+        "rule": {
+          "$ref": "ConditionalFormatRule",
+          "description": "The rule that should replace the rule at the given index."
         },
-        "fields": {
-          "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.",
-          "format": "google-fieldmask",
-          "type": "string"
+        "index": {
+          "description": "The zero-based index of the rule that should be replaced or moved.",
+          "format": "int32",
+          "type": "integer"
+        },
+        "sheetId": {
+          "type": "integer",
+          "description": "The sheet of the rule to move.  Required if new_index is set,\nunused otherwise.",
+          "format": "int32"
+        },
+        "newIndex": {
+          "description": "The zero-based new index the rule should end up at.",
+          "format": "int32",
+          "type": "integer"
         }
       },
-      "id": "UpdateProtectedRangeRequest"
+      "id": "UpdateConditionalFormatRuleRequest"
     },
-    "HistogramRule": {
-      "description": "Allows you to organize the numeric values in a source data column into\nbuckets of a constant size. All values from HistogramRule.start to\nHistogramRule.end are placed into groups of size\nHistogramRule.interval. In addition, all values below\nHistogramRule.start are placed in one group, and all values above\nHistogramRule.end are placed in another. Only\nHistogramRule.interval is required, though if HistogramRule.start\nand HistogramRule.end are both provided, HistogramRule.start must\nbe less than HistogramRule.end. For example, a pivot table showing\naverage purchase amount by age that has 50+ rows:\n\n    +-----+-------------------+\n    | Age | AVERAGE of Amount |\n    +-----+-------------------+\n    | 16  |            $27.13 |\n    | 17  |             $5.24 |\n    | 18  |            $20.15 |\n    ...\n    +-----+-------------------+\ncould be turned into a pivot table that looks like the one below by\napplying a histogram group rule with a HistogramRule.start of 25,\nan HistogramRule.interval of 20, and an HistogramRule.end\nof 65.\n\n    +-------------+-------------------+\n    | Grouped Age | AVERAGE of Amount |\n    +-------------+-------------------+\n    | \u003c 25        |            $19.34 |\n    | 25-45       |            $31.43 |\n    | 45-65       |            $35.87 |\n    | \u003e 65        |            $27.55 |\n    +-------------+-------------------+\n    | Grand Total |            $29.12 |\n    +-------------+-------------------+",
+    "BasicChartDomain": {
       "type": "object",
       "properties": {
-        "start": {
-          "description": "The minimum value at which items are placed into buckets\nof constant size. Values below start are lumped into a single bucket.\nThis field is optional.",
-          "format": "double",
-          "type": "number"
-        },
-        "end": {
-          "description": "The maximum value at which items are placed into buckets\nof constant size. Values above end are lumped into a single bucket.\nThis field is optional.",
-          "format": "double",
-          "type": "number"
+        "reversed": {
+          "description": "True to reverse the order of the domain values (horizontal axis).",
+          "type": "boolean"
         },
-        "interval": {
-          "description": "The size of the buckets that are created. Must be positive.",
-          "format": "double",
-          "type": "number"
+        "domain": {
+          "$ref": "ChartData",
+          "description": "The data of the domain. For example, if charting stock prices over time,\nthis is the data representing the dates."
         }
       },
-      "id": "HistogramRule"
+      "id": "BasicChartDomain",
+      "description": "The domain of a chart.\nFor example, if charting stock prices over time, this would be the date."
     },
-    "AddSheetResponse": {
-      "description": "The result of adding a sheet.",
+    "PasteDataRequest": {
+      "description": "Inserts data into the spreadsheet starting at the specified coordinate.",
       "type": "object",
       "properties": {
-        "properties": {
-          "$ref": "SheetProperties",
-          "description": "The properties of the newly added sheet."
+        "coordinate": {
+          "$ref": "GridCoordinate",
+          "description": "The coordinate at which the data should start being inserted."
+        },
+        "data": {
+          "type": "string",
+          "description": "The data to insert."
+        },
+        "delimiter": {
+          "description": "The delimiter in the data.",
+          "type": "string"
+        },
+        "type": {
+          "enum": [
+            "PASTE_NORMAL",
+            "PASTE_VALUES",
+            "PASTE_FORMAT",
+            "PASTE_NO_BORDERS",
+            "PASTE_FORMULA",
+            "PASTE_DATA_VALIDATION",
+            "PASTE_CONDITIONAL_FORMATTING"
+          ],
+          "description": "How the data should be pasted.",
+          "type": "string",
+          "enumDescriptions": [
+            "Paste values, formulas, formats, and merges.",
+            "Paste the values ONLY without formats, formulas, or merges.",
+            "Paste the format and data validation only.",
+            "Like PASTE_NORMAL but without borders.",
+            "Paste the formulas only.",
+            "Paste the data validation only.",
+            "Paste the conditional formatting rules only."
+          ]
+        },
+        "html": {
+          "description": "True if the data is HTML.",
+          "type": "boolean"
         }
       },
-      "id": "AddSheetResponse"
+      "id": "PasteDataRequest"
     },
-    "AddFilterViewResponse": {
-      "description": "The result of adding a filter view.",
+    "UpdateDeveloperMetadataResponse": {
       "type": "object",
       "properties": {
-        "filter": {
-          "$ref": "FilterView",
-          "description": "The newly added filter view."
+        "developerMetadata": {
+          "type": "array",
+          "items": {
+            "$ref": "DeveloperMetadata"
+          },
+          "description": "The updated developer metadata."
         }
       },
-      "id": "AddFilterViewResponse"
+      "id": "UpdateDeveloperMetadataResponse",
+      "description": "The response from updating developer metadata."
     },
-    "PivotGroupRule": {
-      "id": "PivotGroupRule",
-      "description": "An optional setting on a PivotGroup that defines buckets for the values\nin the source data column rather than breaking out each individual value.\nOnly one PivotGroup with a group rule may be added for each column in\nthe source data, though on any given column you may add both a\nPivotGroup that has a rule and a PivotGroup that does not.",
+    "AppendDimensionRequest": {
       "type": "object",
       "properties": {
-        "histogramRule": {
-          "description": "A HistogramRule.",
-          "$ref": "HistogramRule"
+        "dimension": {
+          "enum": [
+            "DIMENSION_UNSPECIFIED",
+            "ROWS",
+            "COLUMNS"
+          ],
+          "description": "Whether rows or columns should be appended.",
+          "type": "string",
+          "enumDescriptions": [
+            "The default value, do not use.",
+            "Operates on the rows of a sheet.",
+            "Operates on the columns of a sheet."
+          ]
         },
-        "dateTimeRule": {
-          "$ref": "DateTimeRule",
-          "description": "A DateTimeRule."
+        "length": {
+          "type": "integer",
+          "description": "The number of rows or columns to append.",
+          "format": "int32"
         },
-        "manualRule": {
-          "$ref": "ManualRule",
-          "description": "A ManualRule."
+        "sheetId": {
+          "type": "integer",
+          "description": "The sheet to append rows or columns to.",
+          "format": "int32"
         }
-      }
+      },
+      "id": "AppendDimensionRequest",
+      "description": "Appends rows or columns to the end of a sheet."
     },
-    "IterativeCalculationSettings": {
-      "description": "Settings to control how circular dependencies are resolved with iterative\ncalculation.",
+    "AddNamedRangeRequest": {
+      "id": "AddNamedRangeRequest",
+      "description": "Adds a named range to the spreadsheet.",
       "type": "object",
       "properties": {
-        "convergenceThreshold": {
-          "type": "number",
-          "description": "When iterative calculation is enabled and successive results differ by\nless than this threshold value, the calculation rounds stop.",
-          "format": "double"
-        },
-        "maxIterations": {
-          "description": "When iterative calculation is enabled, the maximum number of calculation\nrounds to perform.",
-          "format": "int32",
-          "type": "integer"
+        "namedRange": {
+          "$ref": "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.)"
         }
-      },
-      "id": "IterativeCalculationSettings"
+      }
     },
-    "ScorecardChartSpec": {
+    "CreateDeveloperMetadataResponse": {
+      "description": "The response from creating developer metadata.",
       "type": "object",
       "properties": {
-        "baselineValueData": {
-          "$ref": "ChartData",
-          "description": "The data for scorecard baseline value.\nThis field is optional."
-        },
-        "keyValueData": {
-          "$ref": "ChartData",
-          "description": "The data for scorecard key value."
-        },
-        "aggregateType": {
-          "description": "The aggregation type for key and baseline chart data in scorecard chart.\nThis field is optional.",
-          "type": "string",
-          "enumDescriptions": [
-            "Default value, do not use.",
-            "Average aggregate function.",
-            "Count aggregate function.",
-            "Maximum aggregate function.",
-            "Median aggregate function.",
-            "Minimum aggregate function.",
-            "Sum aggregate function."
-          ],
-          "enum": [
-            "CHART_AGGREGATE_TYPE_UNSPECIFIED",
-            "AVERAGE",
-            "COUNT",
-            "MAX",
-            "MEDIAN",
-            "MIN",
-            "SUM"
-          ]
-        },
-        "numberFormatSource": {
-          "type": "string",
-          "enumDescriptions": [
-            "Default value, do not use.",
-            "Inherit number formatting from data.",
-            "Apply custom formatting as specified by ChartCustomNumberFormatOptions."
-          ],
-          "enum": [
-            "CHART_NUMBER_FORMAT_SOURCE_UNDEFINED",
-            "FROM_DATA",
-            "CUSTOM"
-          ],
-          "description": "The number format source used in the scorecard chart.\nThis field is optional."
-        },
-        "keyValueFormat": {
-          "$ref": "KeyValueFormat",
-          "description": "Formatting options for key value."
-        },
-        "customFormatOptions": {
-          "description": "Custom formatting options for numeric key/baseline values in scorecard\nchart. This field is used only when number_format_source is set to\nCUSTOM. This field is optional.",
-          "$ref": "ChartCustomNumberFormatOptions"
-        },
-        "scaleFactor": {
-          "description": "Value to scale scorecard key and baseline value. For example, a factor of\n10 can be used to divide all values in the chart by 10.\nThis field is optional.",
-          "format": "double",
-          "type": "number"
-        },
-        "baselineValueFormat": {
-          "$ref": "BaselineValueFormat",
-          "description": "Formatting options for baseline value.\nThis field is needed only if baseline_value_data is specified."
+        "developerMetadata": {
+          "$ref": "DeveloperMetadata",
+          "description": "The developer metadata that was created."
         }
       },
-      "id": "ScorecardChartSpec",
-      "description": "A scorecard chart. Scorecard charts are used to highlight key performance\nindicators, known as KPIs, on the spreadsheet. A scorecard chart can\nrepresent things like total sales, average cost, or a top selling item. You\ncan specify a single data value, or aggregate over a range of data.\nPercentage or absolute difference from a baseline value can be highlighted,\nlike changes over time."
+      "id": "CreateDeveloperMetadataResponse"
     },
-    "OverlayPosition": {
-      "id": "OverlayPosition",
-      "description": "The location an object is overlaid on top of a grid.",
+    "UpdateEmbeddedObjectPositionRequest": {
       "type": "object",
       "properties": {
-        "offsetYPixels": {
-          "type": "integer",
-          "description": "The vertical offset, in pixels, that the object is offset\nfrom the anchor cell.",
-          "format": "int32"
-        },
-        "heightPixels": {
-          "type": "integer",
-          "description": "The height of the object, in pixels. Defaults to 371.",
-          "format": "int32"
-        },
-        "widthPixels": {
-          "description": "The width of the object, in pixels. Defaults to 600.",
-          "format": "int32",
-          "type": "integer"
-        },
-        "offsetXPixels": {
-          "description": "The horizontal offset, in pixels, that the object is offset\nfrom the anchor cell.",
+        "objectId": {
+          "description": "The ID of the object to moved.",
           "format": "int32",
           "type": "integer"
         },
-        "anchorCell": {
-          "description": "The cell the object is anchored to.",
-          "$ref": "GridCoordinate"
-        }
-      }
-    },
-    "SpreadsheetProperties": {
-      "description": "Properties of a spreadsheet.",
-      "type": "object",
-      "properties": {
-        "title": {
-          "description": "The title of the spreadsheet.",
-          "type": "string"
+        "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."
         },
-        "timeZone": {
-          "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`.",
+        "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.",
+          "format": "google-fieldmask",
           "type": "string"
-        },
-        "locale": {
-          "type": "string",
-          "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."
-        },
-        "iterativeCalculationSettings": {
-          "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.",
-          "$ref": "IterativeCalculationSettings"
-        },
-        "autoRecalc": {
-          "type": "string",
-          "enumDescriptions": [
-            "Default value. This value must not be used.",
-            "Volatile functions are updated on every change.",
-            "Volatile functions are updated on every change and every minute.",
-            "Volatile functions are updated on every change and hourly."
-          ],
-          "enum": [
-            "RECALCULATION_INTERVAL_UNSPECIFIED",
-            "ON_CHANGE",
-            "MINUTE",
-            "HOUR"
-          ],
-          "description": "The amount of time to wait before volatile functions are recalculated."
-        },
-        "defaultFormat": {
-          "description": "The default format of all cells in the spreadsheet.\nCellData.effectiveFormat will not be set if\nthe cell's format is equal to this default format. This field is read-only.",
-          "$ref": "CellFormat"
         }
       },
-      "id": "SpreadsheetProperties"
+      "id": "UpdateEmbeddedObjectPositionRequest",
+      "description": "Update an embedded object's position (such as a moving or resizing a\nchart or image)."
     },
-    "AddChartResponse": {
-      "id": "AddChartResponse",
-      "description": "The result of adding a chart to a spreadsheet.",
+    "WaterfallChartColumnStyle": {
+      "id": "WaterfallChartColumnStyle",
+      "description": "Styles for a waterfall chart column.",
       "type": "object",
       "properties": {
-        "chart": {
-          "$ref": "EmbeddedChart",
-          "description": "The newly added chart."
+        "color": {
+          "description": "The color of the column.",
+          "$ref": "Color"
+        },
+        "label": {
+          "description": "The label of the column's legend.",
+          "type": "string"
         }
       }
     },
-    "InsertDimensionRequest": {
+    "Request": {
       "type": "object",
       "properties": {
-        "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).",
-          "type": "boolean"
+        "autoResizeDimensions": {
+          "$ref": "AutoResizeDimensionsRequest",
+          "description": "Automatically resizes one or more dimensions based on the contents\nof the cells in that dimension."
         },
-        "range": {
-          "$ref": "DimensionRange",
-          "description": "The dimensions to insert.  Both the start and end indexes must be bounded."
-        }
-      },
-      "id": "InsertDimensionRequest",
-      "description": "Inserts rows or columns in a sheet at a particular index."
-    },
-    "BatchUpdateValuesRequest": {
-      "id": "BatchUpdateValuesRequest",
-      "description": "The request for updating more than one range of values in a spreadsheet.",
-      "type": "object",
-      "properties": {
-        "responseValueRenderOption": {
-          "description": "Determines how values in the response should be rendered.\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\"`."
-          ],
-          "enum": [
-            "FORMATTED_VALUE",
-            "UNFORMATTED_VALUE",
-            "FORMULA"
-          ]
+        "appendCells": {
+          "$ref": "AppendCellsRequest",
+          "description": "Appends cells after the last row with data in a sheet."
         },
-        "includeValuesInResponse": {
-          "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).",
-          "type": "boolean"
+        "cutPaste": {
+          "$ref": "CutPasteRequest",
+          "description": "Cuts data from one area and pastes it to another."
         },
-        "valueInputOption": {
-          "enumDescriptions": [
-            "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."
-          ],
-          "enum": [
-            "INPUT_VALUE_OPTION_UNSPECIFIED",
-            "RAW",
-            "USER_ENTERED"
-          ],
-          "description": "How the input data should be interpreted.",
-          "type": "string"
+        "mergeCells": {
+          "$ref": "MergeCellsRequest",
+          "description": "Merges cells together."
         },
-        "data": {
-          "description": "The new values to apply to the spreadsheet.",
-          "type": "array",
-          "items": {
-            "$ref": "ValueRange"
-          }
+        "updateNamedRange": {
+          "$ref": "UpdateNamedRangeRequest",
+          "description": "Updates a named range."
         },
-        "responseDateTimeRenderOption": {
-          "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.",
-          "type": "string",
-          "enumDescriptions": [
-            "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)."
-          ],
-          "enum": [
-            "SERIAL_NUMBER",
-            "FORMATTED_STRING"
-          ]
-        }
-      }
-    },
-    "CutPasteRequest": {
-      "type": "object",
-      "properties": {
-        "destination": {
-          "$ref": "GridCoordinate",
-          "description": "The top-left coordinate where the data should be pasted."
+        "updateSheetProperties": {
+          "$ref": "UpdateSheetPropertiesRequest",
+          "description": "Updates a sheet's properties."
         },
-        "source": {
-          "$ref": "GridRange",
-          "description": "The source data to cut."
+        "autoFill": {
+          "$ref": "AutoFillRequest",
+          "description": "Automatically fills in more data based on existing data."
         },
-        "pasteType": {
-          "enum": [
-            "PASTE_NORMAL",
-            "PASTE_VALUES",
-            "PASTE_FORMAT",
-            "PASTE_NO_BORDERS",
-            "PASTE_FORMULA",
-            "PASTE_DATA_VALIDATION",
-            "PASTE_CONDITIONAL_FORMATTING"
-          ],
-          "description": "What kind of data to paste.  All the source data will be cut, regardless\nof what is pasted.",
-          "type": "string",
-          "enumDescriptions": [
-            "Paste values, formulas, formats, and merges.",
-            "Paste the values ONLY without formats, formulas, or merges.",
-            "Paste the format and data validation only.",
-            "Like PASTE_NORMAL but without borders.",
-            "Paste the formulas only.",
-            "Paste the data validation only.",
-            "Paste the conditional formatting rules only."
-          ]
-        }
-      },
-      "id": "CutPasteRequest",
-      "description": "Moves data from the source to the destination."
-    },
-    "ChartAxisViewWindowOptions": {
-      "description": "The options that define a \"view window\" for a chart (such as the visible\nvalues in an axis).",
-      "type": "object",
-      "properties": {
-        "viewWindowMin": {
-          "description": "The minimum numeric value to be shown in this view window. If unset, will\nautomatically determine a minimum value that looks good for the data.",
-          "format": "double",
-          "type": "number"
+        "deleteDimension": {
+          "description": "Deletes rows or columns in a sheet.",
+          "$ref": "DeleteDimensionRequest"
         },
-        "viewWindowMax": {
-          "description": "The maximum numeric value to be shown in this view window. If unset, will\nautomatically determine a maximum value that looks good for the data.",
-          "format": "double",
-          "type": "number"
+        "sortRange": {
+          "$ref": "SortRangeRequest",
+          "description": "Sorts data in a range."
         },
-        "viewWindowMode": {
-          "description": "The view window's mode.",
-          "type": "string",
-          "enumDescriptions": [
-            "The default view window mode used in the Sheets editor for this chart\ntype. In most cases, if set, the default mode is equivalent to\n`PRETTY`.",
-            "Do not use. Represents that the currently set mode is not supported by\nthe API.",
-            "Follows the min and max exactly if specified. If a value is unspecified,\nit will fall back to the `PRETTY` value.",
-            "Chooses a min and max that make the chart look good. Both min and max are\nignored in this mode."
-          ],
-          "enum": [
-            "DEFAULT_VIEW_WINDOW_MODE",
-            "VIEW_WINDOW_MODE_UNSUPPORTED",
-            "EXPLICIT",
-            "PRETTY"
-          ]
-        }
-      },
-      "id": "ChartAxisViewWindowOptions"
-    },
-    "BasicChartSeries": {
-      "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\".",
-      "type": "object",
-      "properties": {
-        "color": {
-          "$ref": "Color",
-          "description": "The color for elements (i.e. bars, lines, points) associated with this\nseries.  If empty, a default color is used."
+        "addSlicer": {
+          "$ref": "AddSlicerRequest",
+          "description": "Adds a slicer."
         },
-        "lineStyle": {
-          "description": "The line style of this series. Valid only if the\nchartType is AREA,\nLINE, or SCATTER.\nCOMBO charts are also supported if the\nseries chart type is\nAREA or LINE.",
-          "$ref": "LineStyle"
+        "deleteProtectedRange": {
+          "$ref": "DeleteProtectedRangeRequest",
+          "description": "Deletes a protected range."
         },
-        "series": {
-          "$ref": "ChartData",
-          "description": "The data being visualized in this chart series."
+        "deleteDimensionGroup": {
+          "$ref": "DeleteDimensionGroupRequest",
+          "description": "Deletes a group over the specified range."
         },
-        "type": {
-          "enumDescriptions": [
-            "Default value, do not use.",
-            "A \u003ca href=\"/chart/interactive/docs/gallery/barchart\"\u003ebar chart\u003c/a\u003e.",
-            "A \u003ca href=\"/chart/interactive/docs/gallery/linechart\"\u003eline chart\u003c/a\u003e.",
-            "An \u003ca href=\"/chart/interactive/docs/gallery/areachart\"\u003earea chart\u003c/a\u003e.",
-            "A \u003ca href=\"/chart/interactive/docs/gallery/columnchart\"\u003ecolumn chart\u003c/a\u003e.",
-            "A \u003ca href=\"/chart/interactive/docs/gallery/scatterchart\"\u003escatter\nchart\u003c/a\u003e.",
-            "A \u003ca href=\"/chart/interactive/docs/gallery/combochart\"\u003ecombo chart\u003c/a\u003e.",
-            "A \u003ca href=\"/chart/interactive/docs/gallery/steppedareachart\"\u003estepped area\nchart\u003c/a\u003e."
-          ],
-          "enum": [
-            "BASIC_CHART_TYPE_UNSPECIFIED",
-            "BAR",
-            "LINE",
-            "AREA",
-            "COLUMN",
-            "SCATTER",
-            "COMBO",
-            "STEPPED_AREA"
-          ],
-          "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.",
-          "type": "string"
+        "duplicateFilterView": {
+          "$ref": "DuplicateFilterViewRequest",
+          "description": "Duplicates a filter view."
         },
-        "targetAxis": {
-          "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."
-          ],
-          "enum": [
-            "BASIC_CHART_AXIS_POSITION_UNSPECIFIED",
-            "BOTTOM_AXIS",
-            "LEFT_AXIS",
-            "RIGHT_AXIS"
-          ],
-          "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"
-        }
-      },
-      "id": "BasicChartSeries"
-    },
-    "AutoResizeDimensionsRequest": {
-      "id": "AutoResizeDimensionsRequest",
-      "description": "Automatically resizes one or more dimensions based on the contents\nof the cells in that dimension.",
-      "type": "object",
-      "properties": {
-        "dimensions": {
-          "$ref": "DimensionRange",
-          "description": "The dimensions to automatically resize."
-        }
-      }
-    },
-    "UpdateBordersRequest": {
-      "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.",
-      "type": "object",
-      "properties": {
-        "left": {
-          "$ref": "Border",
-          "description": "The border to put at the left of the range."
+        "addChart": {
+          "description": "Adds a chart.",
+          "$ref": "AddChartRequest"
         },
-        "bottom": {
-          "$ref": "Border",
-          "description": "The border to put at the bottom of the range."
+        "findReplace": {
+          "description": "Finds and replaces occurrences of some text with other text.",
+          "$ref": "FindReplaceRequest"
         },
-        "innerVertical": {
-          "description": "The vertical border to put within the range.",
-          "$ref": "Border"
+        "textToColumns": {
+          "$ref": "TextToColumnsRequest",
+          "description": "Converts a column of text into many columns of text."
         },
-        "right": {
-          "$ref": "Border",
-          "description": "The border to put at the right of the range."
+        "updateChartSpec": {
+          "$ref": "UpdateChartSpecRequest",
+          "description": "Updates a chart's specifications."
         },
-        "range": {
-          "$ref": "GridRange",
-          "description": "The range whose borders should be updated."
+        "addSheet": {
+          "$ref": "AddSheetRequest",
+          "description": "Adds a sheet."
         },
-        "innerHorizontal": {
-          "$ref": "Border",
-          "description": "The horizontal border to put within the range."
+        "updateProtectedRange": {
+          "$ref": "UpdateProtectedRangeRequest",
+          "description": "Updates a protected range."
         },
-        "top": {
-          "$ref": "Border",
-          "description": "The border to put at the top of the range."
+        "copyPaste": {
+          "$ref": "CopyPasteRequest",
+          "description": "Copies data from one area and pastes it to another."
+        },
+        "deleteFilterView": {
+          "$ref": "DeleteFilterViewRequest",
+          "description": "Deletes a filter view from a sheet."
+        },
+        "insertDimension": {
+          "$ref": "InsertDimensionRequest",
+          "description": "Inserts new rows or columns in a sheet."
+        },
+        "deleteRange": {
+          "$ref": "DeleteRangeRequest",
+          "description": "Deletes a range of cells from a sheet, shifting the remaining cells."
+        },
+        "deleteBanding": {
+          "$ref": "DeleteBandingRequest",
+          "description": "Removes a banded range"
+        },
+        "addFilterView": {
+          "$ref": "AddFilterViewRequest",
+          "description": "Adds a filter view."
+        },
+        "deleteDuplicates": {
+          "$ref": "DeleteDuplicatesRequest",
+          "description": "Removes rows containing duplicate values in specified columns of a cell\nrange."
+        },
+        "setDataValidation": {
+          "$ref": "SetDataValidationRequest",
+          "description": "Sets data validation for one or more cells."
+        },
+        "updateBorders": {
+          "$ref": "UpdateBordersRequest",
+          "description": "Updates the borders in a range of cells."
+        },
+        "deleteConditionalFormatRule": {
+          "$ref": "DeleteConditionalFormatRuleRequest",
+          "description": "Deletes an existing conditional format rule."
+        },
+        "repeatCell": {
+          "$ref": "RepeatCellRequest",
+          "description": "Repeats a single cell across a range."
+        },
+        "clearBasicFilter": {
+          "$ref": "ClearBasicFilterRequest",
+          "description": "Clears the basic filter on a sheet."
+        },
+        "appendDimension": {
+          "$ref": "AppendDimensionRequest",
+          "description": "Appends dimensions to the end of a sheet."
+        },
+        "updateSlicerSpec": {
+          "$ref": "UpdateSlicerSpecRequest",
+          "description": "Updates a slicer's specifications."
+        },
+        "createDeveloperMetadata": {
+          "description": "Creates new developer metadata",
+          "$ref": "CreateDeveloperMetadataRequest"
+        },
+        "updateConditionalFormatRule": {
+          "description": "Updates an existing conditional format rule.",
+          "$ref": "UpdateConditionalFormatRuleRequest"
+        },
+        "insertRange": {
+          "$ref": "InsertRangeRequest",
+          "description": "Inserts new cells in a sheet, shifting the existing cells."
+        },
+        "deleteDeveloperMetadata": {
+          "$ref": "DeleteDeveloperMetadataRequest",
+          "description": "Deletes developer metadata"
+        },
+        "moveDimension": {
+          "$ref": "MoveDimensionRequest",
+          "description": "Moves rows or columns to another location in a sheet."
+        },
+        "randomizeRange": {
+          "$ref": "RandomizeRangeRequest",
+          "description": "Randomizes the order of the rows in a range."
+        },
+        "updateBanding": {
+          "$ref": "UpdateBandingRequest",
+          "description": "Updates a banded range"
+        },
+        "deleteNamedRange": {
+          "$ref": "DeleteNamedRangeRequest",
+          "description": "Deletes a named range."
+        },
+        "addProtectedRange": {
+          "$ref": "AddProtectedRangeRequest",
+          "description": "Adds a protected range."
+        },
+        "duplicateSheet": {
+          "description": "Duplicates a sheet.",
+          "$ref": "DuplicateSheetRequest"
+        },
+        "unmergeCells": {
+          "$ref": "UnmergeCellsRequest",
+          "description": "Unmerges merged cells."
+        },
+        "deleteSheet": {
+          "$ref": "DeleteSheetRequest",
+          "description": "Deletes a sheet."
+        },
+        "updateEmbeddedObjectPosition": {
+          "description": "Updates an embedded object's (e.g. chart, image) position.",
+          "$ref": "UpdateEmbeddedObjectPositionRequest"
+        },
+        "addDimensionGroup": {
+          "$ref": "AddDimensionGroupRequest",
+          "description": "Creates a group over the specified range."
+        },
+        "updateDeveloperMetadata": {
+          "$ref": "UpdateDeveloperMetadataRequest",
+          "description": "Updates an existing developer metadata entry"
+        },
+        "updateDimensionProperties": {
+          "$ref": "UpdateDimensionPropertiesRequest",
+          "description": "Updates dimensions' properties."
+        },
+        "updateDimensionGroup": {
+          "$ref": "UpdateDimensionGroupRequest",
+          "description": "Updates the state of the specified group."
+        },
+        "pasteData": {
+          "$ref": "PasteDataRequest",
+          "description": "Pastes data (HTML or delimited) into a sheet."
+        },
+        "setBasicFilter": {
+          "description": "Sets the basic filter on a sheet.",
+          "$ref": "SetBasicFilterRequest"
+        },
+        "addConditionalFormatRule": {
+          "description": "Adds a new conditional format rule.",
+          "$ref": "AddConditionalFormatRuleRequest"
+        },
+        "updateCells": {
+          "$ref": "UpdateCellsRequest",
+          "description": "Updates many cells at once."
+        },
+        "addNamedRange": {
+          "$ref": "AddNamedRangeRequest",
+          "description": "Adds a named range."
+        },
+        "updateSpreadsheetProperties": {
+          "$ref": "UpdateSpreadsheetPropertiesRequest",
+          "description": "Updates the spreadsheet's properties."
+        },
+        "trimWhitespace": {
+          "$ref": "TrimWhitespaceRequest",
+          "description": "Trims cells of whitespace (such as spaces, tabs, or new lines)."
+        },
+        "deleteEmbeddedObject": {
+          "$ref": "DeleteEmbeddedObjectRequest",
+          "description": "Deletes an embedded object (e.g, chart, image) in a sheet."
+        },
+        "updateFilterView": {
+          "description": "Updates the properties of a filter view.",
+          "$ref": "UpdateFilterViewRequest"
+        },
+        "addBanding": {
+          "$ref": "AddBandingRequest",
+          "description": "Adds a new banded range"
         }
       },
-      "id": "UpdateBordersRequest"
+      "id": "Request",
+      "description": "A single kind of update to apply to a spreadsheet."
     },
-    "CellFormat": {
-      "id": "CellFormat",
-      "description": "The format of a cell.",
+    "WaterfallChartDomain": {
+      "description": "The domain of a waterfall chart.",
       "type": "object",
       "properties": {
-        "backgroundColor": {
-          "$ref": "Color",
-          "description": "The background color of the cell."
-        },
-        "padding": {
-          "$ref": "Padding",
-          "description": "The padding of the cell."
-        },
-        "verticalAlignment": {
-          "enum": [
-            "VERTICAL_ALIGN_UNSPECIFIED",
-            "TOP",
-            "MIDDLE",
-            "BOTTOM"
-          ],
-          "description": "The vertical alignment of the value in the cell.",
-          "type": "string",
-          "enumDescriptions": [
-            "The vertical alignment is not specified.  Do not use this.",
-            "The text is explicitly aligned to the top of the cell.",
-            "The text is explicitly aligned to the middle of the cell.",
-            "The text is explicitly aligned to the bottom of the cell."
-          ]
+        "data": {
+          "description": "The data of the WaterfallChartDomain.",
+          "$ref": "ChartData"
         },
-        "borders": {
-          "description": "The borders of the cell.",
-          "$ref": "Borders"
+        "reversed": {
+          "type": "boolean",
+          "description": "True to reverse the order of the domain values (horizontal axis)."
+        }
+      },
+      "id": "WaterfallChartDomain"
+    },
+    "GridRange": {
+      "id": "GridRange",
+      "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!`.",
+      "type": "object",
+      "properties": {
+        "startRowIndex": {
+          "type": "integer",
+          "description": "The start row (inclusive) of the range, or not set if unbounded.",
+          "format": "int32"
         },
-        "textDirection": {
-          "type": "string",
-          "enumDescriptions": [
-            "The text direction is not specified. Do not use this.",
-            "The text direction of left-to-right was set by the user.",
-            "The text direction of right-to-left was set by the user."
-          ],
-          "enum": [
-            "TEXT_DIRECTION_UNSPECIFIED",
-            "LEFT_TO_RIGHT",
-            "RIGHT_TO_LEFT"
-          ],
-          "description": "The direction of the text in the cell."
+        "startColumnIndex": {
+          "description": "The start column (inclusive) of the range, or not set if unbounded.",
+          "format": "int32",
+          "type": "integer"
         },
-        "wrapStrategy": {
-          "enum": [
-            "WRAP_STRATEGY_UNSPECIFIED",
-            "OVERFLOW_CELL",
-            "LEGACY_WRAP",
-            "CLIP",
-            "WRAP"
-          ],
-          "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.  |"
-          ]
+        "sheetId": {
+          "description": "The sheet this range is on.",
+          "format": "int32",
+          "type": "integer"
         },
-        "textRotation": {
-          "$ref": "TextRotation",
-          "description": "The rotation applied to text in a cell"
+        "endRowIndex": {
+          "description": "The end row (exclusive) of the range, or not set if unbounded.",
+          "format": "int32",
+          "type": "integer"
         },
-        "numberFormat": {
-          "$ref": "NumberFormat",
-          "description": "A format describing how number values should be represented to the user."
+        "endColumnIndex": {
+          "type": "integer",
+          "description": "The end column (exclusive) of the range, or not set if unbounded.",
+          "format": "int32"
+        }
+      }
+    },
+    "DeleteDimensionGroupRequest": {
+      "type": "object",
+      "properties": {
+        "range": {
+          "$ref": "DimensionRange",
+          "description": "The range of the group to be deleted."
+        }
+      },
+      "id": "DeleteDimensionGroupRequest",
+      "description": "Deletes a group over the specified range by decrementing the depth of the\ndimensions in the range.\n\nFor example, assume the sheet has a depth-1 group over B:E and a depth-2\ngroup over C:D. Deleting a group over D:E leaves the sheet with a\ndepth-1 group over B:D and a depth-2 group over C:C."
+    },
+    "BubbleChartSpec": {
+      "description": "A \u003ca href=\"/chart/interactive/docs/gallery/bubblechart\"\u003ebubble chart\u003c/a\u003e.",
+      "type": "object",
+      "properties": {
+        "series": {
+          "$ref": "ChartData",
+          "description": "The data contianing the bubble y-values.  These values locate the bubbles\nin the chart vertically."
         },
-        "hyperlinkDisplayType": {
+        "legendPosition": {
           "enumDescriptions": [
-            "The default value: the hyperlink is rendered. Do not use this.",
-            "A hyperlink should be explicitly rendered.",
-            "A hyperlink should not be rendered."
+            "Default value, do not use.",
+            "The legend is rendered on the bottom of the chart.",
+            "The legend is rendered on the left of the chart.",
+            "The legend is rendered on the right of the chart.",
+            "The legend is rendered on the top of the chart.",
+            "No legend is rendered.",
+            "The legend is rendered inside the chart area."
           ],
           "enum": [
-            "HYPERLINK_DISPLAY_TYPE_UNSPECIFIED",
-            "LINKED",
-            "PLAIN_TEXT"
+            "BUBBLE_CHART_LEGEND_POSITION_UNSPECIFIED",
+            "BOTTOM_LEGEND",
+            "LEFT_LEGEND",
+            "RIGHT_LEGEND",
+            "TOP_LEGEND",
+            "NO_LEGEND",
+            "INSIDE_LEGEND"
           ],
-          "description": "How a hyperlink, if it exists, should be displayed in the cell.",
+          "description": "Where the legend of the chart should be drawn.",
           "type": "string"
         },
+        "domain": {
+          "$ref": "ChartData",
+          "description": "The data containing the bubble x-values.  These values locate the bubbles\nin the chart horizontally."
+        },
+        "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."
+        },
+        "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"
+        },
+        "bubbleBorderColor": {
+          "$ref": "Color",
+          "description": "The bubble border color."
+        },
+        "bubbleTextStyle": {
+          "$ref": "TextFormat",
+          "description": "The format of the text inside the bubbles.\nUnderline and Strikethrough are not supported."
+        },
+        "groupIds": {
+          "$ref": "ChartData",
+          "description": "The data containing the bubble group IDs. All bubbles with the same group\nID are 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."
+        },
+        "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.",
+          "format": "int32",
+          "type": "integer"
+        },
+        "bubbleMaxRadiusSize": {
+          "description": "The max radius size of the bubbles, in pixels.\nIf specified, the field must be a positive value.",
+          "format": "int32",
+          "type": "integer"
+        }
+      },
+      "id": "BubbleChartSpec"
+    },
+    "SetDataValidationRequest": {
+      "type": "object",
+      "properties": {
+        "rule": {
+          "$ref": "DataValidationRule",
+          "description": "The data validation rule to set on each cell in the range,\nor empty to clear the data validation in the range."
+        },
+        "range": {
+          "description": "The range the data validation rule should apply to.",
+          "$ref": "GridRange"
+        }
+      },
+      "id": "SetDataValidationRequest",
+      "description": "Sets a data validation rule to every cell in the range.\nTo clear validation in a range, call this with no rule specified."
+    },
+    "TextPosition": {
+      "description": "Position settings for text.",
+      "type": "object",
+      "properties": {
         "horizontalAlignment": {
+          "description": "Horizontal alignment setting for the piece of text.",
           "type": "string",
           "enumDescriptions": [
             "The horizontal alignment is not specified. Do not use this.",
@@ -4401,153 +4550,151 @@
             "LEFT",
             "CENTER",
             "RIGHT"
-          ],
-          "description": "The horizontal alignment of the value in the cell."
-        },
-        "textFormat": {
-          "$ref": "TextFormat",
-          "description": "The format of the text in the cell (unless overridden by a format run)."
-        }
-      }
-    },
-    "ClearValuesResponse": {
-      "type": "object",
-      "properties": {
-        "spreadsheetId": {
-          "description": "The spreadsheet the updates were applied to.",
-          "type": "string"
-        },
-        "clearedRange": {
-          "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."
+      "id": "TextPosition"
     },
-    "WaterfallChartCustomSubtotal": {
+    "BatchUpdateSpreadsheetRequest": {
       "type": "object",
       "properties": {
-        "subtotalIndex": {
-          "description": "The 0-based index of a data point within the series. If\ndata_is_subtotal is true, the data point at this index is the\nsubtotal. Otherwise, the subtotal appears after the data point with\nthis index. A series can have multiple subtotals at arbitrary indices,\nbut subtotals do not affect the indices of the data points. For\nexample, if a series has three data points, their indices will always\nbe 0, 1, and 2, regardless of how many subtotals exist on the series or\nwhat data points they are associated with.",
-          "format": "int32",
-          "type": "integer"
+        "includeSpreadsheetInResponse": {
+          "description": "Determines if the update response should include the spreadsheet\nresource.",
+          "type": "boolean"
         },
-        "dataIsSubtotal": {
-          "description": "True if the data point at subtotal_index is the subtotal. If false,\nthe subtotal will be computed and appear after the data point.",
+        "responseRanges": {
+          "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_in_response is 'true'.\nThis parameter is ignored if a field mask was set in the request.",
           "type": "boolean"
         },
-        "label": {
-          "description": "A label for the subtotal column.",
-          "type": "string"
-        }
-      },
-      "id": "WaterfallChartCustomSubtotal",
-      "description": "A custom subtotal column for a waterfall chart series."
-    },
-    "ChartData": {
-      "description": "The data included in a domain or series.",
-      "type": "object",
-      "properties": {
-        "sourceRange": {
-          "$ref": "ChartSourceRange",
-          "description": "The source ranges of the data."
-        }
-      },
-      "id": "ChartData"
-    },
-    "BatchGetValuesResponse": {
-      "id": "BatchGetValuesResponse",
-      "description": "The response when retrieving more than one range of values in a spreadsheet.",
-      "type": "object",
-      "properties": {
-        "valueRanges": {
+        "requests": {
           "type": "array",
           "items": {
-            "$ref": "ValueRange"
+            "$ref": "Request"
           },
-          "description": "The requested values. The order of the ValueRanges is the same as the\norder of the requested ranges."
-        },
-        "spreadsheetId": {
-          "type": "string",
-          "description": "The ID of the spreadsheet the data was retrieved from."
+          "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."
         }
-      }
+      },
+      "id": "BatchUpdateSpreadsheetRequest",
+      "description": "The request for updating any aspect of a spreadsheet."
     },
-    "UpdateBandingRequest": {
+    "BasicChartAxis": {
+      "description": "An axis of the chart.\nA chart may not have more than one axis per\naxis position.",
       "type": "object",
       "properties": {
-        "bandedRange": {
-          "$ref": "BandedRange",
-          "description": "The banded range to update with the new properties."
+        "position": {
+          "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."
+          ],
+          "enum": [
+            "BASIC_CHART_AXIS_POSITION_UNSPECIFIED",
+            "BOTTOM_AXIS",
+            "LEFT_AXIS",
+            "RIGHT_AXIS"
+          ],
+          "description": "The position of this axis.",
+          "type": "string"
         },
-        "fields": {
+        "title": {
           "type": "string",
-          "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.",
-          "format": "google-fieldmask"
+          "description": "The title of this axis. If set, this overrides any title inferred\nfrom headers of the data."
+        },
+        "titleTextPosition": {
+          "description": "The axis title text position.",
+          "$ref": "TextPosition"
+        },
+        "format": {
+          "$ref": "TextFormat",
+          "description": "The format of the title.\nOnly valid if the axis is not associated with the domain."
+        },
+        "viewWindowOptions": {
+          "$ref": "ChartAxisViewWindowOptions",
+          "description": "The view window options for this axis."
         }
       },
-      "id": "UpdateBandingRequest",
-      "description": "Updates properties of the supplied banded range."
+      "id": "BasicChartAxis"
     },
-    "Color": {
-      "id": "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.\n\nNote: this proto does not carry information about the absolute color space\nthat should be used to interpret the RGB value (e.g. sRGB, Adobe RGB,\nDCI-P3, BT.2020, etc.). By default, applications SHOULD assume the sRGB color\nspace.\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    // ...",
+    "Padding": {
+      "description": "The amount of padding around the cell, in pixels.\nWhen updating padding, every field must be specified.",
       "type": "object",
       "properties": {
-        "green": {
-          "type": "number",
-          "description": "The amount of green in the color as a value in the interval [0, 1].",
-          "format": "float"
+        "top": {
+          "description": "The top padding of the cell.",
+          "format": "int32",
+          "type": "integer"
         },
-        "blue": {
-          "type": "number",
-          "description": "The amount of blue in the color as a value in the interval [0, 1].",
-          "format": "float"
+        "left": {
+          "description": "The left padding of the cell.",
+          "format": "int32",
+          "type": "integer"
         },
-        "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"
+        "right": {
+          "description": "The right padding of the cell.",
+          "format": "int32",
+          "type": "integer"
         },
-        "red": {
-          "description": "The amount of red in the color as a value in the interval [0, 1].",
-          "format": "float",
-          "type": "number"
+        "bottom": {
+          "description": "The bottom padding of the cell.",
+          "format": "int32",
+          "type": "integer"
+        }
+      },
+      "id": "Padding"
+    },
+    "DeleteDimensionRequest": {
+      "id": "DeleteDimensionRequest",
+      "description": "Deletes the dimensions from the sheet.",
+      "type": "object",
+      "properties": {
+        "range": {
+          "$ref": "DimensionRange",
+          "description": "The dimensions to delete from the sheet."
         }
       }
     },
-    "TrimWhitespaceRequest": {
-      "id": "TrimWhitespaceRequest",
-      "description": "Trims the whitespace (such as spaces, tabs, or new lines) in every cell in\nthe specified range. This request removes all whitespace from the start and\nend of each cell's text, and reduces any subsequence of remaining whitespace\ncharacters to a single space. If the resulting trimmed text starts with a '+'\nor '=' character, the text remains as a string value and isn't interpreted\nas a formula.",
+    "UpdateChartSpecRequest": {
+      "description": "Updates a chart's specifications.\n(This does not move or resize a chart. To move or resize a chart, use\n UpdateEmbeddedObjectPositionRequest.)",
       "type": "object",
       "properties": {
-        "range": {
-          "$ref": "GridRange",
-          "description": "The range whose cells to trim."
+        "chartId": {
+          "description": "The ID of the chart to update.",
+          "format": "int32",
+          "type": "integer"
+        },
+        "spec": {
+          "$ref": "ChartSpec",
+          "description": "The specification to apply to the chart."
         }
-      }
+      },
+      "id": "UpdateChartSpecRequest"
     },
-    "ChartSourceRange": {
+    "DeleteFilterViewRequest": {
       "type": "object",
       "properties": {
-        "sources": {
-          "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 in order and contiguous across the domain\nand 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",
-          "type": "array",
-          "items": {
-            "$ref": "GridRange"
-          }
+        "filterId": {
+          "description": "The ID of the filter to delete.",
+          "format": "int32",
+          "type": "integer"
         }
       },
-      "id": "ChartSourceRange",
-      "description": "Source ranges for a chart."
+      "id": "DeleteFilterViewRequest",
+      "description": "Deletes a particular filter view."
     },
-    "ValueRange": {
-      "id": "ValueRange",
-      "description": "Data within a range of the spreadsheet.",
+    "BatchGetValuesByDataFilterRequest": {
       "type": "object",
       "properties": {
         "majorDimension": {
+          "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]]`.",
+          "type": "string",
           "enumDescriptions": [
             "The default value, do not use.",
             "Operates on the rows of a sheet.",
@@ -4557,781 +4704,707 @@
             "DIMENSION_UNSPECIFIED",
             "ROWS",
             "COLUMNS"
-          ],
-          "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"
+          ]
         },
-        "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.",
+        "dataFilters": {
+          "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": {
-            "type": "array",
-            "items": {
-              "type": "any"
-            }
+            "$ref": "DataFilter"
           }
         },
-        "range": {
-          "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.",
-          "type": "string"
-        }
-      }
-    },
-    "AddBandingRequest": {
-      "type": "object",
-      "properties": {
-        "bandedRange": {
-          "$ref": "BandedRange",
-          "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.)"
+        "valueRenderOption": {
+          "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\"`."
+          ],
+          "enum": [
+            "FORMATTED_VALUE",
+            "UNFORMATTED_VALUE",
+            "FORMULA"
+          ],
+          "description": "How values should be represented in the output.\nThe default render option is ValueRenderOption.FORMATTED_VALUE."
+        },
+        "dateTimeRenderOption": {
+          "type": "string",
+          "enumDescriptions": [
+            "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)."
+          ],
+          "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]."
         }
       },
-      "id": "AddBandingRequest",
-      "description": "Adds a new banded range to the spreadsheet."
+      "id": "BatchGetValuesByDataFilterRequest",
+      "description": "The request for retrieving a range of values in a spreadsheet selected by a\nset of DataFilters."
     },
-    "Response": {
+    "BatchUpdateValuesResponse": {
+      "description": "The response when updating a range of values in a spreadsheet.",
       "type": "object",
       "properties": {
-        "updateDeveloperMetadata": {
-          "description": "A reply from updating a developer metadata entry.",
-          "$ref": "UpdateDeveloperMetadataResponse"
-        },
-        "findReplace": {
-          "$ref": "FindReplaceResponse",
-          "description": "A reply from doing a find/replace."
-        },
-        "addSheet": {
-          "$ref": "AddSheetResponse",
-          "description": "A reply from adding a sheet."
-        },
-        "updateConditionalFormatRule": {
-          "description": "A reply from updating a conditional format rule.",
-          "$ref": "UpdateConditionalFormatRuleResponse"
-        },
-        "createDeveloperMetadata": {
-          "$ref": "CreateDeveloperMetadataResponse",
-          "description": "A reply from creating a developer metadata entry."
-        },
-        "addNamedRange": {
-          "$ref": "AddNamedRangeResponse",
-          "description": "A reply from adding a named range."
-        },
-        "deleteDeveloperMetadata": {
-          "$ref": "DeleteDeveloperMetadataResponse",
-          "description": "A reply from deleting a developer metadata entry."
-        },
-        "trimWhitespace": {
-          "$ref": "TrimWhitespaceResponse",
-          "description": "A reply from trimming whitespace."
-        },
-        "addFilterView": {
-          "$ref": "AddFilterViewResponse",
-          "description": "A reply from adding a filter view."
-        },
-        "deleteDuplicates": {
-          "description": "A reply from removing rows containing duplicate values.",
-          "$ref": "DeleteDuplicatesResponse"
+        "totalUpdatedRows": {
+          "type": "integer",
+          "description": "The total number of rows where at least one cell in the row was updated.",
+          "format": "int32"
         },
-        "addBanding": {
-          "$ref": "AddBandingResponse",
-          "description": "A reply from adding a banded range."
+        "responses": {
+          "type": "array",
+          "items": {
+            "$ref": "UpdateValuesResponse"
+          },
+          "description": "One UpdateValuesResponse per requested range, in the same order as\nthe requests appeared."
         },
-        "addProtectedRange": {
-          "$ref": "AddProtectedRangeResponse",
-          "description": "A reply from adding a protected range."
+        "totalUpdatedSheets": {
+          "description": "The total number of sheets where at least one cell in the sheet was\nupdated.",
+          "format": "int32",
+          "type": "integer"
         },
-        "duplicateSheet": {
-          "$ref": "DuplicateSheetResponse",
-          "description": "A reply from duplicating a sheet."
+        "totalUpdatedCells": {
+          "type": "integer",
+          "description": "The total number of cells updated.",
+          "format": "int32"
         },
-        "updateEmbeddedObjectPosition": {
-          "$ref": "UpdateEmbeddedObjectPositionResponse",
-          "description": "A reply from updating an embedded object's position."
+        "totalUpdatedColumns": {
+          "description": "The total number of columns where at least one cell in the column was\nupdated.",
+          "format": "int32",
+          "type": "integer"
         },
-        "addSlicer": {
-          "$ref": "AddSlicerResponse",
-          "description": "A reply from adding a slicer."
+        "spreadsheetId": {
+          "type": "string",
+          "description": "The spreadsheet the updates were applied to."
+        }
+      },
+      "id": "BatchUpdateValuesResponse"
+    },
+    "BatchClearValuesRequest": {
+      "id": "BatchClearValuesRequest",
+      "description": "The request for clearing more than one range of values in a spreadsheet.",
+      "type": "object",
+      "properties": {
+        "ranges": {
+          "description": "The ranges to clear, in A1 notation.",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "KeyValueFormat": {
+      "id": "KeyValueFormat",
+      "description": "Formatting options for key value.",
+      "type": "object",
+      "properties": {
+        "position": {
+          "$ref": "TextPosition",
+          "description": "Specifies the horizontal text positioning of key value.\nThis field is optional. If not specified, default positioning is used."
         },
-        "deleteConditionalFormatRule": {
-          "$ref": "DeleteConditionalFormatRuleResponse",
-          "description": "A reply from deleting a conditional format rule."
+        "textFormat": {
+          "$ref": "TextFormat",
+          "description": "Text formatting options for key value."
+        }
+      }
+    },
+    "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 is deleted too.",
+      "type": "object",
+      "properties": {
+        "metadataValue": {
+          "description": "Data associated with the metadata's key.",
+          "type": "string"
         },
-        "deleteDimensionGroup": {
-          "$ref": "DeleteDimensionGroupResponse",
-          "description": "A reply from deleting a dimension group."
+        "metadataKey": {
+          "description": "The metadata key. There may be multiple metadata in a spreadsheet with the\nsame key.  Developer metadata must always have a key specified.",
+          "type": "string"
         },
-        "addDimensionGroup": {
-          "$ref": "AddDimensionGroupResponse",
-          "description": "A reply from adding a dimension group."
+        "metadataId": {
+          "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.",
+          "format": "int32",
+          "type": "integer"
         },
-        "duplicateFilterView": {
-          "$ref": "DuplicateFilterViewResponse",
-          "description": "A reply from duplicating a filter view."
+        "location": {
+          "$ref": "DeveloperMetadataLocation",
+          "description": "The location where the metadata is associated."
         },
-        "addChart": {
-          "$ref": "AddChartResponse",
-          "description": "A reply from adding a chart."
+        "visibility": {
+          "type": "string",
+          "enumDescriptions": [
+            "Default value.",
+            "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": "The metadata visibility.  Developer metadata must always have a visibility\nspecified."
         }
       },
-      "id": "Response",
-      "description": "A single response from an update."
+      "id": "DeveloperMetadata"
     },
-    "InsertRangeRequest": {
-      "description": "Inserts cells into a range, shifting the existing cells over or down.",
+    "BaselineValueFormat": {
+      "description": "Formatting options for baseline value.",
       "type": "object",
       "properties": {
-        "shiftDimension": {
-          "enumDescriptions": [
-            "The default value, do not use.",
-            "Operates on the rows of a sheet.",
-            "Operates on the columns of a sheet."
-          ],
+        "negativeColor": {
+          "description": "Color to be used, in case baseline value represents a negative change for\nkey value. This field is optional.",
+          "$ref": "Color"
+        },
+        "comparisonType": {
           "enum": [
-            "DIMENSION_UNSPECIFIED",
-            "ROWS",
-            "COLUMNS"
+            "COMPARISON_TYPE_UNDEFINED",
+            "ABSOLUTE_DIFFERENCE",
+            "PERCENTAGE_DIFFERENCE"
           ],
-          "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.",
-          "type": "string"
+          "description": "The comparison type of key value with baseline value.",
+          "type": "string",
+          "enumDescriptions": [
+            "Default value, do not use.",
+            "Use absolute difference between key and baseline value.",
+            "Use percentage difference between key and baseline value."
+          ]
+        },
+        "position": {
+          "description": "Specifies the horizontal text positioning of baseline value.\nThis field is optional. If not specified, default positioning is used.",
+          "$ref": "TextPosition"
+        },
+        "positiveColor": {
+          "$ref": "Color",
+          "description": "Color to be used, in case baseline value represents a positive change for\nkey value. This field is optional."
         },
-        "range": {
-          "description": "The range to insert new cells into.",
-          "$ref": "GridRange"
+        "textFormat": {
+          "$ref": "TextFormat",
+          "description": "Text formatting options for baseline value."
+        },
+        "description": {
+          "description": "Description which is appended after the baseline value.\nThis field is optional.",
+          "type": "string"
         }
       },
-      "id": "InsertRangeRequest"
+      "id": "BaselineValueFormat"
     },
-    "EmbeddedChart": {
-      "description": "A chart embedded in a sheet.",
+    "TextToColumnsRequest": {
+      "description": "Splits a column of text into multiple columns,\nbased on a delimiter in each cell.",
       "type": "object",
       "properties": {
-        "chartId": {
-          "description": "The ID of the chart.",
-          "format": "int32",
-          "type": "integer"
+        "source": {
+          "description": "The source data range.  This must span exactly one column.",
+          "$ref": "GridRange"
         },
-        "position": {
-          "$ref": "EmbeddedObjectPosition",
-          "description": "The position of the chart."
+        "delimiterType": {
+          "enum": [
+            "DELIMITER_TYPE_UNSPECIFIED",
+            "COMMA",
+            "SEMICOLON",
+            "PERIOD",
+            "SPACE",
+            "CUSTOM",
+            "AUTODETECT"
+          ],
+          "description": "The delimiter type to use.",
+          "type": "string",
+          "enumDescriptions": [
+            "Default value. This value must not be used.",
+            "\",\"",
+            "\";\"",
+            "\".\"",
+            "\" \"",
+            "A custom value as defined in delimiter.",
+            "Automatically detect columns."
+          ]
         },
-        "spec": {
-          "$ref": "ChartSpec",
-          "description": "The specification of the chart."
+        "delimiter": {
+          "description": "The delimiter to use. Used only if delimiterType is\nCUSTOM.",
+          "type": "string"
         }
       },
-      "id": "EmbeddedChart"
+      "id": "TextToColumnsRequest"
     },
-    "AddNamedRangeResponse": {
-      "id": "AddNamedRangeResponse",
-      "description": "The result of adding a named range.",
+    "ClearBasicFilterRequest": {
       "type": "object",
       "properties": {
-        "namedRange": {
-          "$ref": "NamedRange",
-          "description": "The named range to add."
+        "sheetId": {
+          "description": "The sheet ID on which the basic filter should be cleared.",
+          "format": "int32",
+          "type": "integer"
         }
-      }
+      },
+      "id": "ClearBasicFilterRequest",
+      "description": "Clears the basic filter, if any exists on the sheet."
     },
-    "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.",
+    "DimensionGroup": {
+      "description": "A group over an interval of rows or columns on a sheet, which can contain or\nbe contained within other groups. A group can be collapsed or expanded as a\nunit on the sheet.",
       "type": "object",
       "properties": {
-        "properties": {
-          "$ref": "SheetProperties",
-          "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.)"
+        "collapsed": {
+          "description": "This field is true if this group is collapsed. A collapsed group remains\ncollapsed if an overlapping group at a shallower depth is expanded.\n\nA true value does not imply that all dimensions within the group are\nhidden, since a dimension's visibility can change independently from this\ngroup property. However, when this property is updated, all dimensions\nwithin it are set to hidden if this field is true, or set to visible if\nthis field is false.",
+          "type": "boolean"
+        },
+        "range": {
+          "$ref": "DimensionRange",
+          "description": "The range over which this group exists."
+        },
+        "depth": {
+          "type": "integer",
+          "description": "The depth of the group, representing how many groups have a range that\nwholly contains the range of this group.",
+          "format": "int32"
         }
       },
-      "id": "AddSheetRequest"
+      "id": "DimensionGroup"
     },
-    "AddSlicerRequest": {
-      "description": "Adds a slicer to a sheet in the spreadsheet.",
+    "DeleteBandingRequest": {
+      "description": "Removes the banded range with the given ID from the spreadsheet.",
       "type": "object",
       "properties": {
-        "slicer": {
-          "$ref": "Slicer",
-          "description": "The slicer that should be added to the spreadsheet, including\nthe position where it should be placed. The slicerId field is optional; if one is not set, an id\nwill be randomly generated. (It is an error to specify the ID\nof a slicer that already exists.)"
+        "bandedRangeId": {
+          "description": "The ID of the banded range to delete.",
+          "format": "int32",
+          "type": "integer"
         }
       },
-      "id": "AddSlicerRequest"
+      "id": "DeleteBandingRequest"
     },
-    "DeleteConditionalFormatRuleResponse": {
-      "description": "The result of deleting a conditional format rule.",
+    "AppendValuesResponse": {
       "type": "object",
       "properties": {
-        "rule": {
-          "$ref": "ConditionalFormatRule",
-          "description": "The rule that was deleted."
+        "spreadsheetId": {
+          "type": "string",
+          "description": "The spreadsheet the updates were applied to."
+        },
+        "updates": {
+          "description": "Information about the updates that were applied.",
+          "$ref": "UpdateValuesResponse"
+        },
+        "tableRange": {
+          "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.",
+          "type": "string"
         }
       },
-      "id": "DeleteConditionalFormatRuleResponse"
+      "id": "AppendValuesResponse",
+      "description": "The response when updating a range of values in a spreadsheet."
     },
-    "GridCoordinate": {
-      "id": "GridCoordinate",
-      "description": "A coordinate in a sheet.\nAll indexes are zero-based.",
+    "MoveDimensionRequest": {
+      "id": "MoveDimensionRequest",
+      "description": "Moves one or more rows or columns.",
       "type": "object",
       "properties": {
-        "sheetId": {
-          "description": "The sheet this coordinate is on.",
-          "format": "int32",
-          "type": "integer"
-        },
-        "rowIndex": {
-          "description": "The row index of the coordinate.",
-          "format": "int32",
-          "type": "integer"
+        "source": {
+          "$ref": "DimensionRange",
+          "description": "The source dimensions to move."
         },
-        "columnIndex": {
-          "description": "The column index of the coordinate.",
+        "destinationIndex": {
+          "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`.",
           "format": "int32",
           "type": "integer"
         }
       }
     },
-    "UpdateSheetPropertiesRequest": {
-      "description": "Updates properties of the sheet with the specified\nsheetId.",
+    "PivotFilterCriteria": {
+      "description": "Criteria for showing/hiding rows in a pivot table.",
       "type": "object",
       "properties": {
-        "fields": {
-          "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.",
-          "format": "google-fieldmask",
-          "type": "string"
+        "visibleValues": {
+          "description": "Values that should be included.  Values not listed here are excluded.",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      },
+      "id": "PivotFilterCriteria"
+    },
+    "AddConditionalFormatRuleRequest": {
+      "type": "object",
+      "properties": {
+        "rule": {
+          "$ref": "ConditionalFormatRule",
+          "description": "The rule to add."
         },
-        "properties": {
-          "$ref": "SheetProperties",
-          "description": "The properties to update."
+        "index": {
+          "description": "The zero-based index where the rule should be inserted.",
+          "format": "int32",
+          "type": "integer"
         }
       },
-      "id": "UpdateSheetPropertiesRequest"
+      "id": "AddConditionalFormatRuleRequest",
+      "description": "Adds a new conditional format rule at the given index.\nAll subsequent rules' indexes are incremented."
     },
-    "AddSlicerResponse": {
-      "id": "AddSlicerResponse",
-      "description": "The result of adding a slicer to a spreadsheet.",
+    "CreateDeveloperMetadataRequest": {
       "type": "object",
       "properties": {
-        "slicer": {
-          "$ref": "Slicer",
-          "description": "The newly added slicer."
+        "developerMetadata": {
+          "$ref": "DeveloperMetadata",
+          "description": "The developer metadata to create."
         }
-      }
+      },
+      "id": "CreateDeveloperMetadataRequest",
+      "description": "A request to create developer metadata."
     },
-    "GridProperties": {
+    "ChartSpec": {
+      "description": "The specifications of a chart.",
       "type": "object",
       "properties": {
-        "frozenRowCount": {
-          "type": "integer",
-          "description": "The number of rows that are frozen in the grid.",
-          "format": "int32"
+        "subtitleTextFormat": {
+          "$ref": "TextFormat",
+          "description": "The subtitle text format.\nStrikethrough and underline are not supported."
         },
-        "columnCount": {
-          "type": "integer",
-          "description": "The number of columns in the grid.",
-          "format": "int32"
+        "subtitle": {
+          "description": "The subtitle of the chart.",
+          "type": "string"
         },
-        "frozenColumnCount": {
-          "description": "The number of columns that are frozen in the grid.",
-          "format": "int32",
-          "type": "integer"
+        "backgroundColor": {
+          "$ref": "Color",
+          "description": "The background color of the entire chart.\nNot applicable to Org charts."
         },
-        "columnGroupControlAfter": {
-          "type": "boolean",
-          "description": "True if the column grouping control toggle is shown after the group."
+        "subtitleTextPosition": {
+          "$ref": "TextPosition",
+          "description": "The subtitle text position.\nThis field is optional."
         },
-        "rowGroupControlAfter": {
-          "description": "True if the row grouping control toggle is shown after the group.",
-          "type": "boolean"
+        "basicChart": {
+          "$ref": "BasicChartSpec",
+          "description": "A basic chart specification, can be one of many kinds of charts.\nSee BasicChartType for the list of all\ncharts this supports."
         },
-        "rowCount": {
-          "description": "The number of rows in the grid.",
-          "format": "int32",
-          "type": "integer"
+        "orgChart": {
+          "$ref": "OrgChartSpec",
+          "description": "An org chart specification."
         },
-        "hideGridlines": {
-          "type": "boolean",
-          "description": "True if the grid isn't showing gridlines in the UI."
-        }
-      },
-      "id": "GridProperties",
-      "description": "Properties of a grid."
-    },
-    "Sheet": {
-      "id": "Sheet",
-      "description": "A sheet in a spreadsheet.",
-      "type": "object",
-      "properties": {
-        "data": {
-          "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).",
-          "type": "array",
-          "items": {
-            "$ref": "GridData"
-          }
+        "scorecardChart": {
+          "$ref": "ScorecardChartSpec",
+          "description": "A scorecard chart specification."
         },
-        "properties": {
-          "$ref": "SheetProperties",
-          "description": "The properties of the sheet."
+        "pieChart": {
+          "$ref": "PieChartSpec",
+          "description": "A pie chart specification."
         },
-        "developerMetadata": {
-          "description": "The developer metadata associated with a sheet.",
-          "type": "array",
-          "items": {
-            "$ref": "DeveloperMetadata"
-          }
+        "titleTextFormat": {
+          "$ref": "TextFormat",
+          "description": "The title text format.\nStrikethrough and underline are not supported."
         },
-        "protectedRanges": {
-          "description": "The protected ranges in this sheet.",
-          "type": "array",
-          "items": {
-            "$ref": "ProtectedRange"
-          }
+        "title": {
+          "description": "The title of the chart.",
+          "type": "string"
         },
-        "columnGroups": {
-          "description": "All column groups on this sheet, ordered by increasing range start index,\nthen by group depth.",
-          "type": "array",
-          "items": {
-            "$ref": "DimensionGroup"
-          }
+        "altText": {
+          "description": "The alternative text that describes the chart.  This is often used\nfor accessibility.",
+          "type": "string"
         },
-        "conditionalFormats": {
-          "description": "The conditional format rules in this sheet.",
-          "type": "array",
-          "items": {
-            "$ref": "ConditionalFormatRule"
-          }
+        "titleTextPosition": {
+          "$ref": "TextPosition",
+          "description": "The title text position.\nThis field is optional."
         },
-        "basicFilter": {
-          "$ref": "BasicFilter",
-          "description": "The filter on this sheet, if any."
+        "histogramChart": {
+          "$ref": "HistogramChartSpec",
+          "description": "A histogram chart specification."
         },
-        "merges": {
-          "type": "array",
-          "items": {
-            "$ref": "GridRange"
-          },
-          "description": "The ranges that are merged together."
+        "candlestickChart": {
+          "description": "A candlestick chart specification.",
+          "$ref": "CandlestickChartSpec"
         },
-        "bandedRanges": {
-          "description": "The banded (alternating colors) ranges on this sheet.",
-          "type": "array",
-          "items": {
-            "$ref": "BandedRange"
-          }
+        "bubbleChart": {
+          "$ref": "BubbleChartSpec",
+          "description": "A bubble chart specification."
         },
-        "charts": {
-          "type": "array",
-          "items": {
-            "$ref": "EmbeddedChart"
-          },
-          "description": "The specifications of every chart on this sheet."
+        "waterfallChart": {
+          "$ref": "WaterfallChartSpec",
+          "description": "A waterfall chart specification."
         },
-        "filterViews": {
-          "type": "array",
-          "items": {
-            "$ref": "FilterView"
-          },
-          "description": "The filter views in this sheet."
+        "fontName": {
+          "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.",
+          "type": "string"
         },
-        "slicers": {
-          "type": "array",
-          "items": {
-            "$ref": "Slicer"
-          },
-          "description": "The slicers on this sheet."
+        "treemapChart": {
+          "$ref": "TreemapChartSpec",
+          "description": "A treemap chart specification."
         },
-        "rowGroups": {
-          "description": "All row groups on this sheet, ordered by increasing range start index, then\nby group depth.",
-          "type": "array",
-          "items": {
-            "$ref": "DimensionGroup"
-          }
+        "maximized": {
+          "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.)",
+          "type": "boolean"
+        },
+        "hiddenDimensionStrategy": {
+          "description": "Determines how the charts will use hidden rows or columns.",
+          "type": "string",
+          "enumDescriptions": [
+            "Default value, do not use.",
+            "Charts will skip hidden rows and columns.",
+            "Charts will skip hidden rows only.",
+            "Charts will skip hidden columns only.",
+            "Charts will not skip any hidden rows or columns."
+          ],
+          "enum": [
+            "CHART_HIDDEN_DIMENSION_STRATEGY_UNSPECIFIED",
+            "SKIP_HIDDEN_ROWS_AND_COLUMNS",
+            "SKIP_HIDDEN_ROWS",
+            "SKIP_HIDDEN_COLUMNS",
+            "SHOW_ALL"
+          ]
         }
-      }
+      },
+      "id": "ChartSpec"
     },
-    "FilterCriteria": {
-      "description": "Criteria for showing/hiding rows in a filter or filter view.",
+    "BatchGetValuesByDataFilterResponse": {
+      "description": "The response when retrieving more than one range of values in a spreadsheet\nselected by DataFilters.",
       "type": "object",
       "properties": {
-        "visibleForegroundColor": {
-          "$ref": "Color",
-          "description": "The text color to filter by; only cells with this text color are shown.\nMutually exclusive with all other filter criteria. Requests to set this\nfield will fail with a 400 error if any other filter criteria field is set."
+        "spreadsheetId": {
+          "description": "The ID of the spreadsheet the data was retrieved from.",
+          "type": "string"
         },
-        "hiddenValues": {
-          "description": "Values that should be hidden.",
+        "valueRanges": {
+          "description": "The requested values with the list of data filters that matched them.",
           "type": "array",
           "items": {
-            "type": "string"
+            "$ref": "MatchedValueRange"
           }
-        },
-        "condition": {
-          "$ref": "BooleanCondition",
-          "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.)"
-        },
-        "visibleBackgroundColor": {
-          "$ref": "Color",
-          "description": "The background fill color to filter by; only cells with this fill color are\nshown. Mutually exclusive with all other filter criteria. Requests to set\nthis field will fail with a 400 error if any other filter criteria field is\nset."
         }
       },
-      "id": "FilterCriteria"
+      "id": "BatchGetValuesByDataFilterResponse"
     },
-    "PivotGroupValueMetadata": {
-      "id": "PivotGroupValueMetadata",
-      "description": "Metadata about a value in a pivot grouping.",
+    "LineStyle": {
+      "id": "LineStyle",
+      "description": "Properties that describe the style of a line.",
       "type": "object",
       "properties": {
-        "value": {
-          "description": "The calculated value the metadata corresponds to.\n(Note that formulaValue is not valid,\n because the values will be calculated.)",
-          "$ref": "ExtendedValue"
+        "type": {
+          "enum": [
+            "LINE_DASH_TYPE_UNSPECIFIED",
+            "INVISIBLE",
+            "CUSTOM",
+            "SOLID",
+            "DOTTED",
+            "MEDIUM_DASHED",
+            "MEDIUM_DASHED_DOTTED",
+            "LONG_DASHED",
+            "LONG_DASHED_DOTTED"
+          ],
+          "description": "The dash type of the line.",
+          "type": "string",
+          "enumDescriptions": [
+            "Default value, do not use.",
+            "No dash type, which is equivalent to a non-visible line.",
+            "A custom dash for a line. Modifying the exact custom dash style is\ncurrently unsupported.",
+            "A solid line.",
+            "A dotted line.",
+            "A dashed line where the dashes have \"medium\" length.",
+            "A line that alternates between a \"medium\" dash and a dot.",
+            "A dashed line where the dashes have \"long\" length.",
+            "A line that alternates between a \"long\" dash and a dot."
+          ]
         },
-        "collapsed": {
-          "type": "boolean",
-          "description": "True if the data corresponding to the value is collapsed."
+        "width": {
+          "description": "The thickness of the line, in px.",
+          "format": "int32",
+          "type": "integer"
         }
       }
     },
-    "Editors": {
-      "id": "Editors",
-      "description": "The editors of a protected range.",
+    "CandlestickDomain": {
       "type": "object",
       "properties": {
-        "groups": {
-          "description": "The email addresses of groups with edit access to the protected range.",
-          "type": "array",
-          "items": {
-            "type": "string"
-          }
-        },
-        "domainUsersCanEdit": {
-          "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.",
+        "reversed": {
+          "description": "True to reverse the order of the domain values (horizontal axis).",
           "type": "boolean"
         },
-        "users": {
-          "description": "The email addresses of users with edit access to the protected range.",
-          "type": "array",
-          "items": {
-            "type": "string"
-          }
+        "data": {
+          "$ref": "ChartData",
+          "description": "The data of the CandlestickDomain."
         }
-      }
+      },
+      "id": "CandlestickDomain",
+      "description": "The domain of a CandlestickChart."
     },
-    "DataValidationRule": {
+    "SheetProperties": {
+      "description": "Properties of a sheet.",
       "type": "object",
       "properties": {
-        "showCustomUi": {
-          "description": "True if the UI should be customized based on the kind of condition.\nIf true, \"List\" conditions will show a dropdown.",
-          "type": "boolean"
+        "title": {
+          "description": "The name of the sheet.",
+          "type": "string"
         },
-        "strict": {
-          "description": "True if invalid data should be rejected.",
-          "type": "boolean"
+        "index": {
+          "description": "The index of the sheet within the spreadsheet.\nWhen adding or updating sheet properties, if this field\nis excluded then the sheet is 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 is 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.",
+          "format": "int32",
+          "type": "integer"
         },
-        "inputMessage": {
-          "description": "A message to show the user when adding data to the cell.",
-          "type": "string"
+        "tabColor": {
+          "description": "The color of the tab in the UI.",
+          "$ref": "Color"
         },
-        "condition": {
-          "$ref": "BooleanCondition",
-          "description": "The condition that data in the cell must match."
-        }
-      },
-      "id": "DataValidationRule",
-      "description": "A data validation rule."
-    },
-    "TextRotation": {
-      "id": "TextRotation",
-      "description": "The rotation applied to text in a cell.",
-      "type": "object",
-      "properties": {
-        "angle": {
+        "sheetId": {
           "type": "integer",
-          "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\ncounterclockwise direction, whereas for RTL they are in the clockwise\ndirection",
+          "description": "The ID of the sheet. Must be non-negative.\nThis field cannot be changed once set.",
           "format": "int32"
         },
-        "vertical": {
-          "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 |",
-          "type": "boolean"
-        }
-      }
-    },
-    "DeleteDimensionGroupResponse": {
-      "description": "The result of deleting a group.",
-      "type": "object",
-      "properties": {
-        "dimensionGroups": {
-          "description": "All groups of a dimension after deleting a group from that dimension.",
-          "type": "array",
-          "items": {
-            "$ref": "DimensionGroup"
-          }
-        }
-      },
-      "id": "DeleteDimensionGroupResponse"
-    },
-    "PieChartSpec": {
-      "type": "object",
-      "properties": {
-        "domain": {
-          "$ref": "ChartData",
-          "description": "The data that covers the domain of the pie chart."
-        },
-        "threeDimensional": {
-          "description": "True if the pie is three dimensional.",
-          "type": "boolean"
+        "rightToLeft": {
+          "type": "boolean",
+          "description": "True if the sheet is an RTL sheet instead of an LTR sheet."
         },
-        "series": {
-          "$ref": "ChartData",
-          "description": "The data that covers the one and only series of the pie chart."
+        "hidden": {
+          "type": "boolean",
+          "description": "True if the sheet is hidden in the UI, false if it's visible."
         },
-        "legendPosition": {
+        "sheetType": {
           "type": "string",
           "enumDescriptions": [
             "Default value, do not use.",
-            "The legend is rendered on the bottom of the chart.",
-            "The legend is rendered on the left of the chart.",
-            "The legend is rendered on the right of the chart.",
-            "The legend is rendered on the top of the chart.",
-            "No legend is rendered.",
-            "Each pie slice has a label attached to it."
+            "The sheet is a grid.",
+            "The sheet has no grid and instead has an object like a chart or image."
           ],
           "enum": [
-            "PIE_CHART_LEGEND_POSITION_UNSPECIFIED",
-            "BOTTOM_LEGEND",
-            "LEFT_LEGEND",
-            "RIGHT_LEGEND",
-            "TOP_LEGEND",
-            "NO_LEGEND",
-            "LABELED_LEGEND"
+            "SHEET_TYPE_UNSPECIFIED",
+            "GRID",
+            "OBJECT"
           ],
-          "description": "Where the legend of the pie chart should be drawn."
+          "description": "The type of sheet. Defaults to GRID.\nThis field cannot be changed once set."
         },
-        "pieHole": {
-          "description": "The size of the hole in the pie chart.",
-          "format": "double",
-          "type": "number"
+        "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.",
+          "$ref": "GridProperties"
         }
       },
-      "id": "PieChartSpec",
-      "description": "A \u003ca href=\"/chart/interactive/docs/gallery/piechart\"\u003epie chart\u003c/a\u003e."
+      "id": "SheetProperties"
     },
-    "UpdateDeveloperMetadataRequest": {
-      "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.",
+    "UpdateDimensionPropertiesRequest": {
       "type": "object",
       "properties": {
-        "dataFilters": {
-          "description": "The filters matching the developer metadata entries to update.",
-          "type": "array",
-          "items": {
-            "$ref": "DataFilter"
-          }
+        "range": {
+          "description": "The rows or columns to update.",
+          "$ref": "DimensionRange"
         },
         "fields": {
           "type": "string",
-          "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.",
+          "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.",
           "format": "google-fieldmask"
         },
-        "developerMetadata": {
-          "$ref": "DeveloperMetadata",
-          "description": "The value that all metadata matched by the data filters will be updated to."
-        }
-      }
-    },
-    "UpdateFilterViewRequest": {
-      "id": "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"
+        "properties": {
+          "$ref": "DimensionProperties",
+          "description": "Properties to update."
         }
-      }
+      },
+      "id": "UpdateDimensionPropertiesRequest",
+      "description": "Updates properties of dimensions within the specified range."
     },
-    "UpdateSlicerSpecRequest": {
-      "description": "Updates a slicer’s specifications.\n(This does not move or resize a slicer. To move or resize a slicer use\nUpdateEmbeddedObjectPositionRequest.",
+    "SourceAndDestination": {
+      "description": "A combination of a source range and how to extend that source.",
       "type": "object",
       "properties": {
-        "spec": {
-          "$ref": "SlicerSpec",
-          "description": "The specification to apply to the slicer."
-        },
-        "fields": {
-          "description": "The fields that should be updated.  At least one field must be specified.\nThe root `SlicerSpec` is implied and should not be specified. A single \"*\"`\ncan be used as short-hand for listing every field.",
-          "format": "google-fieldmask",
-          "type": "string"
+        "dimension": {
+          "description": "The dimension that data should be filled into.",
+          "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"
+          ]
         },
-        "slicerId": {
-          "description": "The id of the slicer to update.",
+        "fillLength": {
+          "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.",
           "format": "int32",
           "type": "integer"
+        },
+        "source": {
+          "$ref": "GridRange",
+          "description": "The location of the data to use as the source of the autofill."
         }
       },
-      "id": "UpdateSlicerSpecRequest"
+      "id": "SourceAndDestination"
     },
-    "ConditionalFormatRule": {
-      "description": "A rule describing a conditional format.",
+    "SlicerSpec": {
+      "id": "SlicerSpec",
+      "description": "The specifications of a slicer.",
       "type": "object",
       "properties": {
-        "ranges": {
-          "description": "The ranges that are formatted if the condition is true.\nAll the ranges must be on the same grid.",
-          "type": "array",
-          "items": {
-            "$ref": "GridRange"
-          }
+        "backgroundColor": {
+          "$ref": "Color",
+          "description": "The background color of the slicer."
         },
-        "gradientRule": {
-          "$ref": "GradientRule",
-          "description": "The formatting will vary based on the gradients in the rule."
+        "filterCriteria": {
+          "$ref": "FilterCriteria",
+          "description": "The filtering criteria of the slicer."
         },
-        "booleanRule": {
-          "$ref": "BooleanRule",
-          "description": "The formatting is either \"on\" or \"off\" according to the rule."
-        }
-      },
-      "id": "ConditionalFormatRule"
-    },
-    "CopyPasteRequest": {
-      "type": "object",
-      "properties": {
-        "source": {
+        "dataRange": {
           "$ref": "GridRange",
-          "description": "The source range to copy."
+          "description": "The data range of the slicer."
         },
-        "pasteType": {
-          "enumDescriptions": [
-            "Paste values, formulas, formats, and merges.",
-            "Paste the values ONLY without formats, formulas, or merges.",
-            "Paste the format and data validation only.",
-            "Like PASTE_NORMAL but without borders.",
-            "Paste the formulas only.",
-            "Paste the data validation only.",
-            "Paste the conditional formatting rules only."
-          ],
-          "enum": [
-            "PASTE_NORMAL",
-            "PASTE_VALUES",
-            "PASTE_FORMAT",
-            "PASTE_NO_BORDERS",
-            "PASTE_FORMULA",
-            "PASTE_DATA_VALIDATION",
-            "PASTE_CONDITIONAL_FORMATTING"
-          ],
-          "description": "What kind of data to paste.",
-          "type": "string"
+        "applyToPivotTables": {
+          "description": "True if the filter should apply to pivot tables.\nIf not set, default to `True`.",
+          "type": "boolean"
         },
-        "destination": {
-          "$ref": "GridRange",
-          "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)."
+        "columnIndex": {
+          "description": "The column index in the data table on which the filter is applied to.",
+          "format": "int32",
+          "type": "integer"
         },
-        "pasteOrientation": {
-          "description": "How that data should be oriented when pasting.",
+        "title": {
+          "description": "The title of the slicer.",
+          "type": "string"
+        },
+        "horizontalAlignment": {
+          "enum": [
+            "HORIZONTAL_ALIGN_UNSPECIFIED",
+            "LEFT",
+            "CENTER",
+            "RIGHT"
+          ],
+          "description": "The horizontal alignment of title in the slicer.\nIf unspecified, defaults to `LEFT`",
           "type": "string",
           "enumDescriptions": [
-            "Paste normally.",
-            "Paste transposed, where all rows become columns and vice versa."
-          ],
-          "enum": [
-            "NORMAL",
-            "TRANSPOSE"
+            "The horizontal alignment is not specified. Do not use this.",
+            "The text is explicitly aligned to the left of the cell.",
+            "The text is explicitly aligned to the center of the cell.",
+            "The text is explicitly aligned to the right of the cell."
           ]
+        },
+        "textFormat": {
+          "$ref": "TextFormat",
+          "description": "The text format of title in the slicer."
+        }
+      }
+    },
+    "CandlestickSeries": {
+      "type": "object",
+      "properties": {
+        "data": {
+          "$ref": "ChartData",
+          "description": "The data of the CandlestickSeries."
         }
       },
-      "id": "CopyPasteRequest",
-      "description": "Copies data from the source to the destination."
+      "id": "CandlestickSeries",
+      "description": "The series of a CandlestickData."
     },
-    "BooleanCondition": {
-      "description": "A condition that can evaluate to true or false.\nBooleanConditions are used by conditional formatting,\ndata validation, and the criteria in filters.",
+    "HistogramChartSpec": {
       "type": "object",
       "properties": {
-        "type": {
-          "type": "string",
-          "enumDescriptions": [
-            "The default value, do not use.",
-            "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 be 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.",
-            "The cell's value must be TRUE/FALSE or in the list of condition values.\nSupported by data validation.\nRenders as a cell checkbox.\nSupports zero, one or two ConditionValues.  No\nvalues indicates the cell must be TRUE or FALSE, where TRUE renders as\nchecked and FALSE renders as unchecked.  One value indicates the cell\nwill render as checked when it contains that value and unchecked when it\nis blank.  Two values indicate that the cell will render as checked when\nit contains the first value and unchecked when it contains the second\nvalue.  For example, [\"Yes\",\"No\"] indicates that the cell will render a\nchecked box when it has the value \"Yes\" and an unchecked box when it has\nthe value \"No\"."
-          ],
-          "enum": [
-            "CONDITION_TYPE_UNSPECIFIED",
-            "NUMBER_GREATER",
-            "NUMBER_GREATER_THAN_EQ",
-            "NUMBER_LESS",
-            "NUMBER_LESS_THAN_EQ",
-            "NUMBER_EQ",
-            "NUMBER_NOT_EQ",
-            "NUMBER_BETWEEN",
-            "NUMBER_NOT_BETWEEN",
-            "TEXT_CONTAINS",
-            "TEXT_NOT_CONTAINS",
-            "TEXT_STARTS_WITH",
-            "TEXT_ENDS_WITH",
-            "TEXT_EQ",
-            "TEXT_IS_EMAIL",
-            "TEXT_IS_URL",
-            "DATE_EQ",
-            "DATE_BEFORE",
-            "DATE_AFTER",
-            "DATE_ON_OR_BEFORE",
-            "DATE_ON_OR_AFTER",
-            "DATE_BETWEEN",
-            "DATE_NOT_BETWEEN",
-            "DATE_IS_VALID",
-            "ONE_OF_RANGE",
-            "ONE_OF_LIST",
-            "BLANK",
-            "NOT_BLANK",
-            "CUSTOM_FORMULA",
-            "BOOLEAN"
-          ],
-          "description": "The type of condition."
+        "bucketSize": {
+          "type": "number",
+          "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.",
+          "format": "double"
+        },
+        "outlierPercentile": {
+          "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.",
+          "format": "double",
+          "type": "number"
+        },
+        "showItemDividers": {
+          "description": "Whether horizontal divider lines should be displayed between items in each\ncolumn.",
+          "type": "boolean"
         },
-        "values": {
-          "type": "array",
-          "items": {
-            "$ref": "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."
-        }
-      },
-      "id": "BooleanCondition"
-    },
-    "BasicChartSpec": {
-      "description": "The specification for a basic chart.  See BasicChartType for the list\nof charts this supports.",
-      "type": "object",
-      "properties": {
         "series": {
-          "description": "The data this chart is visualizing.",
           "type": "array",
           "items": {
-            "$ref": "BasicChartSeries"
-          }
+            "$ref": "HistogramSeries"
+          },
+          "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."
         },
         "legendPosition": {
           "type": "string",
@@ -5341,224 +5414,156 @@
             "The legend is rendered on the left of the chart.",
             "The legend is rendered on the right of the chart.",
             "The legend is rendered on the top of the chart.",
-            "No legend is rendered."
+            "No legend is rendered.",
+            "The legend is rendered inside the chart area."
           ],
           "enum": [
-            "BASIC_CHART_LEGEND_POSITION_UNSPECIFIED",
+            "HISTOGRAM_CHART_LEGEND_POSITION_UNSPECIFIED",
             "BOTTOM_LEGEND",
             "LEFT_LEGEND",
             "RIGHT_LEGEND",
             "TOP_LEGEND",
-            "NO_LEGEND"
+            "NO_LEGEND",
+            "INSIDE_LEGEND"
           ],
           "description": "The position of the chart legend."
-        },
-        "compareMode": {
-          "type": "string",
-          "enumDescriptions": [
-            "Default value, do not use.",
-            "Only the focused data element is highlighted and shown in the tooltip.",
-            "All data elements with the same category (e.g., domain value) are\nhighlighted and shown in the tooltip."
-          ],
-          "enum": [
-            "BASIC_CHART_COMPARE_MODE_UNSPECIFIED",
-            "DATUM",
-            "CATEGORY"
-          ],
-          "description": "The behavior of tooltips and data highlighting when hovering on data and\nchart area."
-        },
-        "domains": {
-          "type": "array",
-          "items": {
-            "$ref": "BasicChartDomain"
-          },
-          "description": "The domain of data this is charting.\nOnly a single domain is supported."
-        },
-        "lineSmoothing": {
-          "description": "Gets whether all lines should be rendered smooth or straight by default.\nApplies to Line charts.",
-          "type": "boolean"
-        },
-        "headerCount": {
+        }
+      },
+      "id": "HistogramChartSpec",
+      "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."
+    },
+    "UpdateValuesResponse": {
+      "type": "object",
+      "properties": {
+        "updatedColumns": {
           "type": "integer",
-          "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 number of columns where at least one cell in the column was updated.",
           "format": "int32"
         },
-        "stackedType": {
+        "spreadsheetId": {
           "type": "string",
-          "enumDescriptions": [
-            "Default value, do not use.",
-            "Series are not stacked.",
-            "Series values are stacked, each value is rendered vertically beginning\nfrom the top of the value below it.",
-            "Vertical stacks are stretched to reach the top of the chart, with\nvalues laid out as percentages of each other."
-          ],
-          "enum": [
-            "BASIC_CHART_STACKED_TYPE_UNSPECIFIED",
-            "NOT_STACKED",
-            "STACKED",
-            "PERCENT_STACKED"
-          ],
-          "description": "The stacked type for charts that support vertical stacking.\nApplies to Area, Bar, Column, Combo, and Stepped Area charts."
+          "description": "The spreadsheet the updates were applied to."
         },
-        "axis": {
-          "description": "The axis on the chart.",
-          "type": "array",
-          "items": {
-            "$ref": "BasicChartAxis"
-          }
+        "updatedRange": {
+          "description": "The range (in A1 notation) that updates were applied to.",
+          "type": "string"
         },
-        "threeDimensional": {
-          "description": "True to make the chart 3D.\nApplies to Bar and Column charts.",
-          "type": "boolean"
+        "updatedCells": {
+          "type": "integer",
+          "description": "The number of cells updated.",
+          "format": "int32"
         },
-        "interpolateNulls": {
-          "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"
+        "updatedRows": {
+          "description": "The number of rows where at least one cell in the row was updated.",
+          "format": "int32",
+          "type": "integer"
         },
-        "chartType": {
-          "enumDescriptions": [
-            "Default value, do not use.",
-            "A \u003ca href=\"/chart/interactive/docs/gallery/barchart\"\u003ebar chart\u003c/a\u003e.",
-            "A \u003ca href=\"/chart/interactive/docs/gallery/linechart\"\u003eline chart\u003c/a\u003e.",
-            "An \u003ca href=\"/chart/interactive/docs/gallery/areachart\"\u003earea chart\u003c/a\u003e.",
-            "A \u003ca href=\"/chart/interactive/docs/gallery/columnchart\"\u003ecolumn chart\u003c/a\u003e.",
-            "A \u003ca href=\"/chart/interactive/docs/gallery/scatterchart\"\u003escatter\nchart\u003c/a\u003e.",
-            "A \u003ca href=\"/chart/interactive/docs/gallery/combochart\"\u003ecombo chart\u003c/a\u003e.",
-            "A \u003ca href=\"/chart/interactive/docs/gallery/steppedareachart\"\u003estepped area\nchart\u003c/a\u003e."
-          ],
-          "enum": [
-            "BASIC_CHART_TYPE_UNSPECIFIED",
-            "BAR",
-            "LINE",
-            "AREA",
-            "COLUMN",
-            "SCATTER",
-            "COMBO",
-            "STEPPED_AREA"
-          ],
-          "description": "The type of the chart.",
-          "type": "string"
+        "updatedData": {
+          "description": "The values of the cells after updates were applied.\nThis is only included if the request's `includeValuesInResponse` field\nwas `true`.",
+          "$ref": "ValueRange"
         }
       },
-      "id": "BasicChartSpec"
-    },
-    "AddDimensionGroupRequest": {
-      "id": "AddDimensionGroupRequest",
-      "description": "Creates a group over the specified range.\n\nIf the requested range is a superset of the range of an existing group G,\nthen the depth of G is incremented and this new group G' has the\ndepth of that group. For example, a group [C:D, depth 1] + [B:E] results in\ngroups [B:E, depth 1] and [C:D, depth 2].\nIf the requested range is a subset of the range of an existing group G,\nthen the depth of the new group G' becomes one greater than the depth of G.\nFor example, a group [B:E, depth 1] + [C:D] results in groups [B:E, depth 1]\nand [C:D, depth 2].\nIf the requested range starts before and ends within, or starts within and\nends after, the range of an existing group G, then the range of the existing\ngroup G becomes the union of the ranges, and the new group G' has\ndepth one greater than the depth of G and range as the intersection of the\nranges. For example, a group [B:D, depth 1] + [C:E] results in groups [B:E,\ndepth 1] and [C:D, depth 2].",
-      "type": "object",
-      "properties": {
-        "range": {
-          "description": "The range over which to create a group.",
-          "$ref": "DimensionRange"
-        }
-      }
+      "id": "UpdateValuesResponse",
+      "description": "The response when updating a range of values in a spreadsheet."
     },
-    "CellData": {
-      "id": "CellData",
-      "description": "Data about a specific cell.",
+    "WaterfallChartSeries": {
+      "description": "A single series of data for a waterfall chart.",
       "type": "object",
       "properties": {
-        "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.)",
-          "type": "string"
-        },
-        "pivotTable": {
-          "$ref": "PivotTable",
-          "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."
-        },
-        "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."
+        "subtotalColumnsStyle": {
+          "$ref": "WaterfallChartColumnStyle",
+          "description": "Styles for all subtotal columns in this series."
         },
-        "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."
+        "positiveColumnsStyle": {
+          "$ref": "WaterfallChartColumnStyle",
+          "description": "Styles for all columns in this series with positive values."
         },
-        "dataValidation": {
-          "description": "A data validation rule on the cell, if any.\n\nWhen writing, the new data validation rule will overwrite any prior rule.",
-          "$ref": "DataValidationRule"
+        "data": {
+          "$ref": "ChartData",
+          "description": "The data being visualized in this series."
         },
-        "effectiveValue": {
-          "$ref": "ExtendedValue",
-          "description": "The effective value of the cell. For cells with formulas, this is\nthe calculated value.  For cells with literals, this is\nthe same as the user_entered_value.\nThis field is read-only."
+        "negativeColumnsStyle": {
+          "$ref": "WaterfallChartColumnStyle",
+          "description": "Styles for all columns in this series with negative values."
         },
-        "formattedValue": {
-          "description": "The formatted value of the cell.\nThis is the value as it's shown to the user.\nThis field is read-only.",
-          "type": "string"
+        "hideTrailingSubtotal": {
+          "description": "True to hide the subtotal column from the end of the series. By default,\na subtotal column will appear at the end of each series. Setting this\nfield to true will hide that subtotal column for this series.",
+          "type": "boolean"
         },
-        "textFormatRuns": {
-          "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 are erased.",
+        "customSubtotals": {
+          "description": "Custom subtotal columns appearing in this series. The order in which\nsubtotals are defined is not significant. Only one subtotal may be\ndefined for each data point.",
           "type": "array",
           "items": {
-            "$ref": "TextFormatRun"
+            "$ref": "WaterfallChartCustomSubtotal"
           }
         }
-      }
+      },
+      "id": "WaterfallChartSeries"
     },
-    "BatchUpdateValuesByDataFilterRequest": {
-      "description": "The request for updating more than one range of values in a spreadsheet.",
+    "PivotGroupSortValueBucket": {
+      "id": "PivotGroupSortValueBucket",
+      "description": "Information about which values in a pivot group should be used for sorting.",
       "type": "object",
       "properties": {
-        "responseValueRenderOption": {
-          "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\"`."
-          ],
-          "enum": [
-            "FORMATTED_VALUE",
-            "UNFORMATTED_VALUE",
-            "FORMULA"
-          ],
-          "description": "Determines how values in the response should be rendered.\nThe default render option is ValueRenderOption.FORMATTED_VALUE."
-        },
-        "includeValuesInResponse": {
-          "type": "boolean",
-          "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)."
-        },
-        "valueInputOption": {
-          "description": "How the input data should be interpreted.",
-          "type": "string",
-          "enumDescriptions": [
-            "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."
-          ],
-          "enum": [
-            "INPUT_VALUE_OPTION_UNSPECIFIED",
-            "RAW",
-            "USER_ENTERED"
-          ]
+        "valuesIndex": {
+          "type": "integer",
+          "description": "The offset in the PivotTable.values list which the values in this\ngrouping should be sorted by.",
+          "format": "int32"
         },
-        "data": {
+        "buckets": {
           "type": "array",
           "items": {
-            "$ref": "DataFilterValueRange"
+            "$ref": "ExtendedValue"
           },
-          "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 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."
+        }
+      }
+    },
+    "DeleteDeveloperMetadataRequest": {
+      "description": "A request to delete developer metadata.",
+      "type": "object",
+      "properties": {
+        "dataFilter": {
+          "description": "The data filter describing the criteria used to select which developer\nmetadata entry to delete.",
+          "$ref": "DataFilter"
+        }
+      },
+      "id": "DeleteDeveloperMetadataRequest"
+    },
+    "CandlestickData": {
+      "description": "The Candlestick chart data, each containing the low, open, close, and high\nvalues for a series.",
+      "type": "object",
+      "properties": {
+        "highSeries": {
+          "description": "The range data (vertical axis) for the high/maximum value for each\ncandle. This is the top of the candle's center line.",
+          "$ref": "CandlestickSeries"
         },
-        "responseDateTimeRenderOption": {
-          "enumDescriptions": [
-            "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)."
-          ],
-          "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\nDateTimeRenderOption.SERIAL_NUMBER.",
-          "type": "string"
+        "lowSeries": {
+          "description": "The range data (vertical axis) for the low/minimum value for each candle.\nThis is the bottom of the candle's center line.",
+          "$ref": "CandlestickSeries"
+        },
+        "closeSeries": {
+          "$ref": "CandlestickSeries",
+          "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."
+        },
+        "openSeries": {
+          "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.",
+          "$ref": "CandlestickSeries"
+        }
+      },
+      "id": "CandlestickData"
+    },
+    "DeleteProtectedRangeRequest": {
+      "description": "Deletes the protected range with the given ID.",
+      "type": "object",
+      "properties": {
+        "protectedRangeId": {
+          "description": "The ID of the protected range to delete.",
+          "format": "int32",
+          "type": "integer"
         }
       },
-      "id": "BatchUpdateValuesByDataFilterRequest"
+      "id": "DeleteProtectedRangeRequest"
     }
   },
   "protocol": "rest",
@@ -5598,31 +5603,69 @@
   "resources": {
     "spreadsheets": {
       "methods": {
-        "get": {
-          "flatPath": "v4/spreadsheets/{spreadsheetId}",
-          "path": "v4/spreadsheets/{spreadsheetId}",
-          "id": "sheets.spreadsheets.get",
-          "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.",
+        "create": {
+          "description": "Creates a spreadsheet, returning the newly created spreadsheet.",
+          "request": {
+            "$ref": "Spreadsheet"
+          },
+          "httpMethod": "POST",
+          "parameterOrder": [],
           "response": {
             "$ref": "Spreadsheet"
           },
+          "parameters": {},
+          "scopes": [
+            "https://www.googleapis.com/auth/drive",
+            "https://www.googleapis.com/auth/drive.file",
+            "https://www.googleapis.com/auth/spreadsheets"
+          ],
+          "flatPath": "v4/spreadsheets",
+          "id": "sheets.spreadsheets.create",
+          "path": "v4/spreadsheets"
+        },
+        "batchUpdate": {
+          "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.",
+          "request": {
+            "$ref": "BatchUpdateSpreadsheetRequest"
+          },
+          "httpMethod": "POST",
           "parameterOrder": [
             "spreadsheetId"
           ],
-          "httpMethod": "GET",
+          "response": {
+            "$ref": "BatchUpdateSpreadsheetResponse"
+          },
+          "parameters": {
+            "spreadsheetId": {
+              "location": "path",
+              "description": "The spreadsheet to apply the updates to.",
+              "required": true,
+              "type": "string"
+            }
+          },
           "scopes": [
             "https://www.googleapis.com/auth/drive",
             "https://www.googleapis.com/auth/drive.file",
-            "https://www.googleapis.com/auth/drive.readonly",
-            "https://www.googleapis.com/auth/spreadsheets",
-            "https://www.googleapis.com/auth/spreadsheets.readonly"
+            "https://www.googleapis.com/auth/spreadsheets"
+          ],
+          "flatPath": "v4/spreadsheets/{spreadsheetId}:batchUpdate",
+          "id": "sheets.spreadsheets.batchUpdate",
+          "path": "v4/spreadsheets/{spreadsheetId}:batchUpdate"
+        },
+        "get": {
+          "response": {
+            "$ref": "Spreadsheet"
+          },
+          "parameterOrder": [
+            "spreadsheetId"
           ],
+          "httpMethod": "GET",
           "parameters": {
             "ranges": {
+              "repeated": true,
               "location": "query",
               "description": "The ranges to retrieve from the spreadsheet.",
-              "type": "string",
-              "repeated": true
+              "type": "string"
             },
             "includeGridData": {
               "location": "query",
@@ -5635,20 +5678,20 @@
               "location": "path",
               "description": "The spreadsheet to request."
             }
-          }
-        },
-        "getByDataFilter": {
-          "request": {
-            "$ref": "GetSpreadsheetByDataFilterRequest"
-          },
-          "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.",
-          "response": {
-            "$ref": "Spreadsheet"
           },
-          "parameterOrder": [
-            "spreadsheetId"
+          "scopes": [
+            "https://www.googleapis.com/auth/drive",
+            "https://www.googleapis.com/auth/drive.file",
+            "https://www.googleapis.com/auth/drive.readonly",
+            "https://www.googleapis.com/auth/spreadsheets",
+            "https://www.googleapis.com/auth/spreadsheets.readonly"
           ],
-          "httpMethod": "POST",
+          "flatPath": "v4/spreadsheets/{spreadsheetId}",
+          "path": "v4/spreadsheets/{spreadsheetId}",
+          "id": "sheets.spreadsheets.get",
+          "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."
+        },
+        "getByDataFilter": {
           "scopes": [
             "https://www.googleapis.com/auth/drive",
             "https://www.googleapis.com/auth/drive.file",
@@ -5663,124 +5706,45 @@
             }
           },
           "flatPath": "v4/spreadsheets/{spreadsheetId}:getByDataFilter",
+          "id": "sheets.spreadsheets.getByDataFilter",
           "path": "v4/spreadsheets/{spreadsheetId}:getByDataFilter",
-          "id": "sheets.spreadsheets.getByDataFilter"
-        },
-        "create": {
-          "response": {
-            "$ref": "Spreadsheet"
-          },
-          "parameterOrder": [],
-          "httpMethod": "POST",
-          "parameters": {},
-          "scopes": [
-            "https://www.googleapis.com/auth/drive",
-            "https://www.googleapis.com/auth/drive.file",
-            "https://www.googleapis.com/auth/spreadsheets"
-          ],
-          "flatPath": "v4/spreadsheets",
-          "path": "v4/spreadsheets",
-          "id": "sheets.spreadsheets.create",
-          "description": "Creates a spreadsheet, returning the newly created spreadsheet.",
           "request": {
-            "$ref": "Spreadsheet"
-          }
-        },
-        "batchUpdate": {
-          "response": {
-            "$ref": "BatchUpdateSpreadsheetResponse"
+            "$ref": "GetSpreadsheetByDataFilterRequest"
           },
+          "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.",
+          "httpMethod": "POST",
           "parameterOrder": [
             "spreadsheetId"
           ],
-          "httpMethod": "POST",
-          "parameters": {
-            "spreadsheetId": {
-              "required": true,
-              "type": "string",
-              "location": "path",
-              "description": "The spreadsheet to apply the updates to."
-            }
-          },
-          "scopes": [
-            "https://www.googleapis.com/auth/drive",
-            "https://www.googleapis.com/auth/drive.file",
-            "https://www.googleapis.com/auth/spreadsheets"
-          ],
-          "flatPath": "v4/spreadsheets/{spreadsheetId}:batchUpdate",
-          "path": "v4/spreadsheets/{spreadsheetId}:batchUpdate",
-          "id": "sheets.spreadsheets.batchUpdate",
-          "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.",
-          "request": {
-            "$ref": "BatchUpdateSpreadsheetRequest"
+          "response": {
+            "$ref": "Spreadsheet"
           }
         }
       },
       "resources": {
-        "sheets": {
+        "developerMetadata": {
           "methods": {
-            "copyTo": {
-              "flatPath": "v4/spreadsheets/{spreadsheetId}/sheets/{sheetId}:copyTo",
-              "path": "v4/spreadsheets/{spreadsheetId}/sheets/{sheetId}:copyTo",
-              "id": "sheets.spreadsheets.sheets.copyTo",
-              "request": {
-                "$ref": "CopySheetToAnotherSpreadsheetRequest"
-              },
-              "description": "Copies a single sheet from a spreadsheet to another spreadsheet.\nReturns the properties of the newly created sheet.",
-              "response": {
-                "$ref": "SheetProperties"
-              },
-              "parameterOrder": [
-                "spreadsheetId",
-                "sheetId"
-              ],
-              "httpMethod": "POST",
-              "scopes": [
-                "https://www.googleapis.com/auth/drive",
-                "https://www.googleapis.com/auth/drive.file",
-                "https://www.googleapis.com/auth/spreadsheets"
-              ],
+            "search": {
               "parameters": {
-                "sheetId": {
-                  "location": "path",
-                  "description": "The ID of the sheet to copy.",
-                  "format": "int32",
-                  "required": true,
-                  "type": "integer"
-                },
                 "spreadsheetId": {
-                  "description": "The ID of the spreadsheet containing the sheet to copy.",
+                  "location": "path",
+                  "description": "The ID of the spreadsheet to retrieve metadata from.",
                   "required": true,
-                  "type": "string",
-                  "location": "path"
+                  "type": "string"
                 }
-              }
-            }
-          }
-        },
-        "developerMetadata": {
-          "methods": {
-            "search": {
+              },
               "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."
-                }
-              },
               "flatPath": "v4/spreadsheets/{spreadsheetId}/developerMetadata:search",
               "id": "sheets.spreadsheets.developerMetadata.search",
               "path": "v4/spreadsheets/{spreadsheetId}/developerMetadata:search",
+              "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"
               },
-              "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.",
               "httpMethod": "POST",
               "parameterOrder": [
                 "spreadsheetId"
@@ -5790,7 +5754,6 @@
               }
             },
             "get": {
-              "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"
               },
@@ -5812,87 +5775,29 @@
                   "type": "string"
                 },
                 "metadataId": {
+                  "location": "path",
                   "description": "The ID of the developer metadata to retrieve.",
                   "format": "int32",
                   "required": true,
-                  "type": "integer",
-                  "location": "path"
+                  "type": "integer"
                 }
               },
               "flatPath": "v4/spreadsheets/{spreadsheetId}/developerMetadata/{metadataId}",
               "path": "v4/spreadsheets/{spreadsheetId}/developerMetadata/{metadataId}",
-              "id": "sheets.spreadsheets.developerMetadata.get"
+              "id": "sheets.spreadsheets.developerMetadata.get",
+              "description": "Returns the developer metadata with the specified ID.\nThe caller must specify the spreadsheet ID and the developer metadata's\nunique metadataId."
             }
           }
         },
         "values": {
           "methods": {
-            "batchGetByDataFilter": {
-              "httpMethod": "POST",
-              "parameterOrder": [
-                "spreadsheetId"
-              ],
-              "response": {
-                "$ref": "BatchGetValuesByDataFilterResponse"
-              },
-              "parameters": {
-                "spreadsheetId": {
-                  "location": "path",
-                  "description": "The ID of the spreadsheet to retrieve data from.",
-                  "required": true,
-                  "type": "string"
-                }
-              },
-              "scopes": [
-                "https://www.googleapis.com/auth/drive",
-                "https://www.googleapis.com/auth/drive.file",
-                "https://www.googleapis.com/auth/spreadsheets"
-              ],
-              "flatPath": "v4/spreadsheets/{spreadsheetId}/values:batchGetByDataFilter",
-              "id": "sheets.spreadsheets.values.batchGetByDataFilter",
-              "path": "v4/spreadsheets/{spreadsheetId}/values:batchGetByDataFilter",
-              "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"
-              }
-            },
-            "batchClear": {
-              "response": {
-                "$ref": "BatchClearValuesResponse"
-              },
-              "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": {
-                  "required": true,
-                  "type": "string",
-                  "location": "path",
-                  "description": "The ID of the spreadsheet to update."
-                }
-              },
-              "flatPath": "v4/spreadsheets/{spreadsheetId}/values:batchClear",
-              "path": "v4/spreadsheets/{spreadsheetId}/values:batchClear",
-              "id": "sheets.spreadsheets.values.batchClear",
-              "request": {
-                "$ref": "BatchClearValuesRequest"
-              },
-              "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": {
-              "description": "Returns a range of values from a spreadsheet.\nThe caller must specify the spreadsheet ID and a range.",
+            "batchGet": {
+              "description": "Returns one or more ranges of values from a spreadsheet.\nThe caller must specify the spreadsheet ID and one or more ranges.",
               "response": {
-                "$ref": "ValueRange"
+                "$ref": "BatchGetValuesResponse"
               },
               "parameterOrder": [
-                "spreadsheetId",
-                "range"
+                "spreadsheetId"
               ],
               "httpMethod": "GET",
               "scopes": [
@@ -5903,92 +5808,150 @@
                 "https://www.googleapis.com/auth/spreadsheets.readonly"
               ],
               "parameters": {
-                "range": {
-                  "location": "path",
-                  "description": "The A1 notation of the values to retrieve.",
+                "spreadsheetId": {
+                  "description": "The ID of the spreadsheet to retrieve data from.",
                   "required": true,
-                  "type": "string"
+                  "type": "string",
+                  "location": "path"
                 },
                 "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"
-                  ]
+                  ],
+                  "description": "How values should be represented in the output.\nThe default render option is ValueRenderOption.FORMATTED_VALUE."
                 },
                 "dateTimeRenderOption": {
+                  "type": "string",
                   "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"
+                  "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]."
                 },
-                "majorDimension": {
+                "ranges": {
+                  "location": "query",
+                  "description": "The A1 notation of the values to retrieve.",
                   "type": "string",
+                  "repeated": true
+                },
+                "majorDimension": {
                   "location": "query",
                   "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]]`."
-                },
-                "spreadsheetId": {
-                  "description": "The ID of the spreadsheet to retrieve data from.",
-                  "required": true,
-                  "type": "string",
-                  "location": "path"
+                  "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"
                 }
               },
-              "flatPath": "v4/spreadsheets/{spreadsheetId}/values/{range}",
-              "path": "v4/spreadsheets/{spreadsheetId}/values/{range}",
-              "id": "sheets.spreadsheets.values.get"
+              "flatPath": "v4/spreadsheets/{spreadsheetId}/values:batchGet",
+              "path": "v4/spreadsheets/{spreadsheetId}/values:batchGet",
+              "id": "sheets.spreadsheets.values.batchGet"
             },
-            "update": {
+            "clear": {
               "response": {
-                "$ref": "UpdateValuesResponse"
+                "$ref": "ClearValuesResponse"
               },
               "parameterOrder": [
                 "spreadsheetId",
                 "range"
               ],
-              "httpMethod": "PUT",
+              "httpMethod": "POST",
+              "parameters": {
+                "spreadsheetId": {
+                  "required": true,
+                  "type": "string",
+                  "location": "path",
+                  "description": "The ID of the spreadsheet to update."
+                },
+                "range": {
+                  "description": "The A1 notation of the values to clear.",
+                  "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"
+              ],
+              "flatPath": "v4/spreadsheets/{spreadsheetId}/values/{range}:clear",
+              "path": "v4/spreadsheets/{spreadsheetId}/values/{range}:clear",
+              "id": "sheets.spreadsheets.values.clear",
+              "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"
+              }
+            },
+            "batchClearByDataFilter": {
               "scopes": [
                 "https://www.googleapis.com/auth/drive",
                 "https://www.googleapis.com/auth/drive.file",
                 "https://www.googleapis.com/auth/spreadsheets"
               ],
               "parameters": {
-                "responseDateTimeRenderOption": {
-                  "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.",
+                "spreadsheetId": {
+                  "required": true,
                   "type": "string",
-                  "location": "query",
-                  "enum": [
-                    "SERIAL_NUMBER",
-                    "FORMATTED_STRING"
-                  ]
+                  "location": "path",
+                  "description": "The ID of the spreadsheet to update."
+                }
+              },
+              "flatPath": "v4/spreadsheets/{spreadsheetId}/values:batchClearByDataFilter",
+              "path": "v4/spreadsheets/{spreadsheetId}/values:batchClearByDataFilter",
+              "id": "sheets.spreadsheets.values.batchClearByDataFilter",
+              "request": {
+                "$ref": "BatchClearValuesByDataFilterRequest"
+              },
+              "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.",
+              "response": {
+                "$ref": "BatchClearValuesByDataFilterResponse"
+              },
+              "parameterOrder": [
+                "spreadsheetId"
+              ],
+              "httpMethod": "POST"
+            },
+            "append": {
+              "flatPath": "v4/spreadsheets/{spreadsheetId}/values/{range}:append",
+              "path": "v4/spreadsheets/{spreadsheetId}/values/{range}:append",
+              "id": "sheets.spreadsheets.values.append",
+              "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",
+              "parameters": {
+                "range": {
+                  "location": "path",
+                  "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"
                 },
                 "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).",
+                  "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.",
                   "type": "boolean"
                 },
-                "range": {
-                  "description": "The A1 notation of the values to update.",
+                "spreadsheetId": {
                   "required": true,
                   "type": "string",
-                  "location": "path"
-                },
-                "spreadsheetId": {
                   "location": "path",
-                  "description": "The ID of the spreadsheet to update.",
-                  "required": true,
-                  "type": "string"
+                  "description": "The ID of the spreadsheet to update."
                 },
                 "responseValueRenderOption": {
                   "location": "query",
@@ -6000,6 +5963,15 @@
                   "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": {
                   "location": "query",
                   "enum": [
@@ -6009,53 +5981,53 @@
                   ],
                   "description": "How the input data should be interpreted.",
                   "type": "string"
+                },
+                "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"
                 }
               },
-              "flatPath": "v4/spreadsheets/{spreadsheetId}/values/{range}",
-              "path": "v4/spreadsheets/{spreadsheetId}/values/{range}",
-              "id": "sheets.spreadsheets.values.update",
-              "request": {
-                "$ref": "ValueRange"
-              },
-              "description": "Sets values in a range of a spreadsheet.\nThe caller must specify the spreadsheet ID, range, and\na valueInputOption."
+              "scopes": [
+                "https://www.googleapis.com/auth/drive",
+                "https://www.googleapis.com/auth/drive.file",
+                "https://www.googleapis.com/auth/spreadsheets"
+              ]
             },
-            "batchUpdateByDataFilter": {
-              "flatPath": "v4/spreadsheets/{spreadsheetId}/values:batchUpdateByDataFilter",
-              "path": "v4/spreadsheets/{spreadsheetId}/values:batchUpdateByDataFilter",
-              "id": "sheets.spreadsheets.values.batchUpdateByDataFilter",
-              "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.",
+            "batchGetByDataFilter": {
+              "id": "sheets.spreadsheets.values.batchGetByDataFilter",
+              "path": "v4/spreadsheets/{spreadsheetId}/values:batchGetByDataFilter",
+              "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": "BatchUpdateValuesByDataFilterRequest"
-              },
-              "response": {
-                "$ref": "BatchUpdateValuesByDataFilterResponse"
+                "$ref": "BatchGetValuesByDataFilterRequest"
               },
+              "httpMethod": "POST",
               "parameterOrder": [
                 "spreadsheetId"
               ],
-              "httpMethod": "POST",
+              "response": {
+                "$ref": "BatchGetValuesByDataFilterResponse"
+              },
               "parameters": {
                 "spreadsheetId": {
-                  "description": "The ID of the spreadsheet to update.",
+                  "location": "path",
+                  "description": "The ID of the spreadsheet to retrieve data from.",
                   "required": true,
-                  "type": "string",
-                  "location": "path"
+                  "type": "string"
                 }
               },
               "scopes": [
                 "https://www.googleapis.com/auth/drive",
                 "https://www.googleapis.com/auth/drive.file",
                 "https://www.googleapis.com/auth/spreadsheets"
-              ]
-            },
-            "batchUpdate": {
-              "httpMethod": "POST",
-              "parameterOrder": [
-                "spreadsheetId"
               ],
-              "response": {
-                "$ref": "BatchUpdateValuesResponse"
-              },
+              "flatPath": "v4/spreadsheets/{spreadsheetId}/values:batchGetByDataFilter"
+            },
+            "batchClear": {
               "scopes": [
                 "https://www.googleapis.com/auth/drive",
                 "https://www.googleapis.com/auth/drive.file",
@@ -6069,163 +6041,145 @@
                   "type": "string"
                 }
               },
-              "flatPath": "v4/spreadsheets/{spreadsheetId}/values:batchUpdate",
-              "id": "sheets.spreadsheets.values.batchUpdate",
-              "path": "v4/spreadsheets/{spreadsheetId}/values:batchUpdate",
+              "flatPath": "v4/spreadsheets/{spreadsheetId}/values:batchClear",
+              "path": "v4/spreadsheets/{spreadsheetId}/values:batchClear",
+              "id": "sheets.spreadsheets.values.batchClear",
               "request": {
-                "$ref": "BatchUpdateValuesRequest"
+                "$ref": "BatchClearValuesRequest"
               },
-              "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."
-            },
-            "clear": {
-              "httpMethod": "POST",
-              "parameterOrder": [
-                "spreadsheetId",
-                "range"
-              ],
+              "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.",
               "response": {
-                "$ref": "ClearValuesResponse"
-              },
-              "parameters": {
-                "spreadsheetId": {
-                  "description": "The ID of the spreadsheet to update.",
-                  "required": true,
-                  "type": "string",
-                  "location": "path"
-                },
-                "range": {
-                  "description": "The A1 notation of the values to clear.",
-                  "required": true,
-                  "type": "string",
-                  "location": "path"
-                }
+                "$ref": "BatchClearValuesResponse"
               },
-              "scopes": [
-                "https://www.googleapis.com/auth/drive",
-                "https://www.googleapis.com/auth/drive.file",
-                "https://www.googleapis.com/auth/spreadsheets"
+              "parameterOrder": [
+                "spreadsheetId"
               ],
-              "flatPath": "v4/spreadsheets/{spreadsheetId}/values/{range}:clear",
-              "id": "sheets.spreadsheets.values.clear",
-              "path": "v4/spreadsheets/{spreadsheetId}/values/{range}:clear",
-              "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"
-              }
+              "httpMethod": "POST"
             },
-            "batchGet": {
+            "get": {
+              "path": "v4/spreadsheets/{spreadsheetId}/values/{range}",
+              "id": "sheets.spreadsheets.values.get",
+              "description": "Returns a range of values from a spreadsheet.\nThe caller must specify the spreadsheet ID and a range.",
               "response": {
-                "$ref": "BatchGetValuesResponse"
+                "$ref": "ValueRange"
               },
               "parameterOrder": [
-                "spreadsheetId"
-              ],
-              "httpMethod": "GET",
-              "scopes": [
-                "https://www.googleapis.com/auth/drive",
-                "https://www.googleapis.com/auth/drive.file",
-                "https://www.googleapis.com/auth/drive.readonly",
-                "https://www.googleapis.com/auth/spreadsheets",
-                "https://www.googleapis.com/auth/spreadsheets.readonly"
+                "spreadsheetId",
+                "range"
               ],
+              "httpMethod": "GET",
               "parameters": {
+                "majorDimension": {
+                  "type": "string",
+                  "location": "query",
+                  "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]]`."
+                },
                 "spreadsheetId": {
                   "location": "path",
                   "description": "The ID of the spreadsheet to retrieve data from.",
                   "required": true,
                   "type": "string"
                 },
-                "valueRenderOption": {
-                  "description": "How values should be represented in the output.\nThe default render option is ValueRenderOption.FORMATTED_VALUE.",
+                "range": {
+                  "required": true,
                   "type": "string",
+                  "location": "path",
+                  "description": "The A1 notation of the values to retrieve."
+                },
+                "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": {
+                  "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",
                   "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]."
-                },
-                "ranges": {
-                  "description": "The A1 notation of the values to retrieve.",
-                  "type": "string",
-                  "repeated": true,
-                  "location": "query"
-                },
-                "majorDimension": {
-                  "location": "query",
-                  "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"
+                  ]
                 }
               },
-              "flatPath": "v4/spreadsheets/{spreadsheetId}/values:batchGet",
-              "path": "v4/spreadsheets/{spreadsheetId}/values:batchGet",
-              "id": "sheets.spreadsheets.values.batchGet",
-              "description": "Returns one or more ranges of values from a spreadsheet.\nThe caller must specify the spreadsheet ID and one or more ranges."
+              "scopes": [
+                "https://www.googleapis.com/auth/drive",
+                "https://www.googleapis.com/auth/drive.file",
+                "https://www.googleapis.com/auth/drive.readonly",
+                "https://www.googleapis.com/auth/spreadsheets",
+                "https://www.googleapis.com/auth/spreadsheets.readonly"
+              ],
+              "flatPath": "v4/spreadsheets/{spreadsheetId}/values/{range}"
             },
-            "batchClearByDataFilter": {
+            "batchUpdateByDataFilter": {
               "response": {
-                "$ref": "BatchClearValuesByDataFilterResponse"
+                "$ref": "BatchUpdateValuesByDataFilterResponse"
               },
               "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.",
                   "required": true,
-                  "type": "string",
-                  "location": "path"
+                  "type": "string"
                 }
               },
-              "flatPath": "v4/spreadsheets/{spreadsheetId}/values:batchClearByDataFilter",
-              "path": "v4/spreadsheets/{spreadsheetId}/values:batchClearByDataFilter",
-              "id": "sheets.spreadsheets.values.batchClearByDataFilter",
+              "scopes": [
+                "https://www.googleapis.com/auth/drive",
+                "https://www.googleapis.com/auth/drive.file",
+                "https://www.googleapis.com/auth/spreadsheets"
+              ],
+              "flatPath": "v4/spreadsheets/{spreadsheetId}/values:batchUpdateByDataFilter",
+              "path": "v4/spreadsheets/{spreadsheetId}/values:batchUpdateByDataFilter",
+              "id": "sheets.spreadsheets.values.batchUpdateByDataFilter",
+              "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.",
               "request": {
-                "$ref": "BatchClearValuesByDataFilterRequest"
-              },
-              "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."
+                "$ref": "BatchUpdateValuesByDataFilterRequest"
+              }
             },
-            "append": {
-              "id": "sheets.spreadsheets.values.append",
-              "path": "v4/spreadsheets/{spreadsheetId}/values/{range}:append",
-              "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"
-              },
-              "httpMethod": "POST",
+            "update": {
+              "httpMethod": "PUT",
               "parameterOrder": [
                 "spreadsheetId",
                 "range"
               ],
               "response": {
-                "$ref": "AppendValuesResponse"
+                "$ref": "UpdateValuesResponse"
               },
+              "scopes": [
+                "https://www.googleapis.com/auth/drive",
+                "https://www.googleapis.com/auth/drive.file",
+                "https://www.googleapis.com/auth/spreadsheets"
+              ],
               "parameters": {
-                "spreadsheetId": {
+                "range": {
                   "required": true,
                   "type": "string",
                   "location": "path",
-                  "description": "The ID of the spreadsheet to update."
+                  "description": "The A1 notation of the values to update."
+                },
+                "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"
+                },
+                "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.",
@@ -6237,24 +6191,15 @@
                     "FORMULA"
                   ]
                 },
-                "insertDataOption": {
-                  "description": "How the input data should be inserted.",
-                  "type": "string",
-                  "location": "query",
-                  "enum": [
-                    "OVERWRITE",
-                    "INSERT_ROWS"
-                  ]
-                },
                 "valueInputOption": {
+                  "type": "string",
                   "location": "query",
                   "enum": [
                     "INPUT_VALUE_OPTION_UNSPECIFIED",
                     "RAW",
                     "USER_ENTERED"
                   ],
-                  "description": "How the input data should be interpreted.",
-                  "type": "string"
+                  "description": "How the input data should be interpreted."
                 },
                 "responseDateTimeRenderOption": {
                   "location": "query",
@@ -6262,27 +6207,87 @@
                     "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": "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.",
                   "type": "string"
-                },
-                "includeValuesInResponse": {
-                  "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.",
-                  "type": "boolean",
-                  "location": "query"
-                },
-                "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.",
+                }
+              },
+              "flatPath": "v4/spreadsheets/{spreadsheetId}/values/{range}",
+              "id": "sheets.spreadsheets.values.update",
+              "path": "v4/spreadsheets/{spreadsheetId}/values/{range}",
+              "request": {
+                "$ref": "ValueRange"
+              },
+              "description": "Sets values in a range of a spreadsheet.\nThe caller must specify the spreadsheet ID, range, and\na valueInputOption."
+            },
+            "batchUpdate": {
+              "id": "sheets.spreadsheets.values.batchUpdate",
+              "path": "v4/spreadsheets/{spreadsheetId}/values:batchUpdate",
+              "request": {
+                "$ref": "BatchUpdateValuesRequest"
+              },
+              "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"
+              },
+              "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",
-                  "location": "path"
+                  "type": "string"
                 }
               },
+              "flatPath": "v4/spreadsheets/{spreadsheetId}/values:batchUpdate"
+            }
+          }
+        },
+        "sheets": {
+          "methods": {
+            "copyTo": {
               "scopes": [
                 "https://www.googleapis.com/auth/drive",
                 "https://www.googleapis.com/auth/drive.file",
                 "https://www.googleapis.com/auth/spreadsheets"
               ],
-              "flatPath": "v4/spreadsheets/{spreadsheetId}/values/{range}:append"
+              "parameters": {
+                "spreadsheetId": {
+                  "required": true,
+                  "type": "string",
+                  "location": "path",
+                  "description": "The ID of the spreadsheet containing the sheet to copy."
+                },
+                "sheetId": {
+                  "location": "path",
+                  "description": "The ID of the sheet to copy.",
+                  "format": "int32",
+                  "required": true,
+                  "type": "integer"
+                }
+              },
+              "flatPath": "v4/spreadsheets/{spreadsheetId}/sheets/{sheetId}:copyTo",
+              "path": "v4/spreadsheets/{spreadsheetId}/sheets/{sheetId}:copyTo",
+              "id": "sheets.spreadsheets.sheets.copyTo",
+              "request": {
+                "$ref": "CopySheetToAnotherSpreadsheetRequest"
+              },
+              "description": "Copies a single sheet from a spreadsheet to another spreadsheet.\nReturns the properties of the newly created sheet.",
+              "response": {
+                "$ref": "SheetProperties"
+              },
+              "parameterOrder": [
+                "spreadsheetId",
+                "sheetId"
+              ],
+              "httpMethod": "POST"
             }
           }
         }
@@ -6290,17 +6295,29 @@
     }
   },
   "parameters": {
-    "callback": {
+    "prettyPrint": {
       "location": "query",
-      "description": "JSONP",
-      "type": "string"
+      "description": "Returns response with indentations and line breaks.",
+      "type": "boolean",
+      "default": "true"
     },
-    "oauth_token": {
-      "description": "OAuth 2.0 token for the current user.",
+    "quotaUser": {
+      "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.",
       "type": "string",
       "location": "query"
     },
+    "fields": {
+      "type": "string",
+      "location": "query",
+      "description": "Selector specifying which fields to include in a partial response."
+    },
+    "uploadType": {
+      "type": "string",
+      "location": "query",
+      "description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\")."
+    },
     "$.xgafv": {
+      "description": "V1 error format.",
       "type": "string",
       "enumDescriptions": [
         "v1 error format",
@@ -6310,11 +6327,19 @@
       "enum": [
         "1",
         "2"
-      ],
-      "description": "V1 error format."
+      ]
+    },
+    "oauth_token": {
+      "location": "query",
+      "description": "OAuth 2.0 token for the current user.",
+      "type": "string"
+    },
+    "callback": {
+      "description": "JSONP",
+      "type": "string",
+      "location": "query"
     },
     "alt": {
-      "default": "json",
       "enum": [
         "json",
         "media",
@@ -6327,54 +6352,29 @@
         "Responses with Content-Type of application/x-protobuf"
       ],
       "location": "query",
-      "description": "Data format for response."
+      "description": "Data format for response.",
+      "default": "json"
     },
-    "access_token": {
-      "description": "OAuth access token.",
+    "key": {
+      "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.",
       "type": "string",
       "location": "query"
     },
-    "key": {
+    "access_token": {
       "type": "string",
       "location": "query",
-      "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": "OAuth access token."
     },
     "upload_protocol": {
       "location": "query",
       "description": "Upload protocol for media (e.g. \"raw\", \"multipart\").",
       "type": "string"
-    },
-    "quotaUser": {
-      "location": "query",
-      "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.",
-      "type": "string"
-    },
-    "prettyPrint": {
-      "type": "boolean",
-      "default": "true",
-      "location": "query",
-      "description": "Returns response with indentations and line breaks."
-    },
-    "fields": {
-      "description": "Selector specifying which fields to include in a partial response.",
-      "type": "string",
-      "location": "query"
-    },
-    "uploadType": {
-      "type": "string",
-      "location": "query",
-      "description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\")."
     }
   },
   "version": "v4",
   "baseUrl": "https://sheets.googleapis.com/",
-  "kind": "discovery#restDescription",
-  "description": "Reads and writes Google Sheets.",
   "servicePath": "",
-  "basePath": "",
-  "id": "sheets:v4",
-  "documentationLink": "https://developers.google.com/sheets/",
-  "revision": "20191105",
-  "discoveryVersion": "v1"
+  "kind": "discovery#restDescription",
+  "description": "Reads and writes Google Sheets."
 }
 
diff --git a/index.md b/index.md
index 3bc6b01ef..3414d0004 100644
--- a/index.md
+++ b/index.md
@@ -75,9 +75,9 @@ library(googlesheets4)
 
 (deaths <- drive_get("deaths"))
 #> # A tibble: 1 x 4
-#>   name   path     id                                       drive_resource  
-#>   <chr>  <chr>    <chr>                                    <list>          
-#> 1 deaths ~/deaths 1tuYKzSbLukDLe5ymf_ZKdQA8SfOyeMM7rmf6D6… <named list [34…
+#>   name   path     id                                           drive_resource   
+#>   <chr>  <chr>    <chr>                                        <list>           
+#> 1 deaths ~/deaths 1tuYKzSbLukDLe5ymf_ZKdQA8SfOyeMM7rmf6D6NJpxg <named list [34]>
 ```
 
 Pass the result to googlesheets4 functions such as:
@@ -112,11 +112,11 @@ read_sheet(deaths, range = "A5:F8")
 #> Reading from 'deaths'
 #> Range "A5:F8"
 #> # A tibble: 3 x 6
-#>   Name  Profession   Age `Has kids` `Date of birth`     `Date of death`    
-#>   <chr> <chr>      <dbl> <lgl>      <dttm>              <dttm>             
-#> 1 Davi… musician      69 TRUE       1947-01-08 00:00:00 2016-01-10 00:00:00
-#> 2 Carr… actor         60 TRUE       1956-10-21 00:00:00 2016-12-27 00:00:00
-#> 3 Chuc… musician      90 TRUE       1926-10-18 00:00:00 2017-03-18 00:00:00
+#>   Name       Profession   Age `Has kids` `Date of birth`     `Date of death`    
+#>   <chr>      <chr>      <dbl> <lgl>      <dttm>              <dttm>             
+#> 1 David Bow… musician      69 TRUE       1947-01-08 00:00:00 2016-01-10 00:00:00
+#> 2 Carrie Fi… actor         60 TRUE       1956-10-21 00:00:00 2016-12-27 00:00:00
+#> 3 Chuck Ber… musician      90 TRUE       1926-10-18 00:00:00 2017-03-18 00:00:00
 ```
 
 If you’re willing to refer to the spreadsheet by id (or URL), just
@@ -222,19 +222,18 @@ read_sheet(sheets_example("deaths"), skip = 4, n_max = 10)
 #> Reading from 'deaths'
 #> Range "5:5000000"
 #> # A tibble: 10 x 6
-#>    Name  Profession   Age `Has kids` `Date of birth`    
-#>    <chr> <chr>      <dbl> <lgl>      <dttm>             
-#>  1 Davi… musician      69 TRUE       1947-01-08 00:00:00
-#>  2 Carr… actor         60 TRUE       1956-10-21 00:00:00
-#>  3 Chuc… musician      90 TRUE       1926-10-18 00:00:00
-#>  4 Bill… actor         61 TRUE       1955-05-17 00:00:00
-#>  5 Prin… musician      57 TRUE       1958-06-07 00:00:00
-#>  6 Alan… actor         69 FALSE      1946-02-21 00:00:00
-#>  7 Flor… actor         82 TRUE       1934-02-14 00:00:00
-#>  8 Harp… author        89 FALSE      1926-04-28 00:00:00
-#>  9 Zsa … actor         99 TRUE       1917-02-06 00:00:00
-#> 10 Geor… musician      53 FALSE      1963-06-25 00:00:00
-#> # … with 1 more variable: `Date of death` <dttm>
+#>    Name      Profession   Age `Has kids` `Date of birth`     `Date of death`    
+#>    <chr>     <chr>      <dbl> <lgl>      <dttm>              <dttm>             
+#>  1 David Bo… musician      69 TRUE       1947-01-08 00:00:00 2016-01-10 00:00:00
+#>  2 Carrie F… actor         60 TRUE       1956-10-21 00:00:00 2016-12-27 00:00:00
+#>  3 Chuck Be… musician      90 TRUE       1926-10-18 00:00:00 2017-03-18 00:00:00
+#>  4 Bill Pax… actor         61 TRUE       1955-05-17 00:00:00 2017-02-25 00:00:00
+#>  5 Prince    musician      57 TRUE       1958-06-07 00:00:00 2016-04-21 00:00:00
+#>  6 Alan Ric… actor         69 FALSE      1946-02-21 00:00:00 2016-01-14 00:00:00
+#>  7 Florence… actor         82 TRUE       1934-02-14 00:00:00 2016-11-24 00:00:00
+#>  8 Harper L… author        89 FALSE      1926-04-28 00:00:00 2016-02-19 00:00:00
+#>  9 Zsa Zsa … actor         99 TRUE       1917-02-06 00:00:00 2016-12-18 00:00:00
+#> 10 George M… musician      53 FALSE      1963-06-25 00:00:00 2016-12-25 00:00:00
 
 read_sheet(
   sheets_example("deaths"), range = "other!A5:F15", col_types = "?ci??D"
@@ -242,18 +241,18 @@ read_sheet(
 #> Reading from 'deaths'
 #> Range "'other'!A5:F15"
 #> # A tibble: 10 x 6
-#>    Name     Profession   Age `Has kids` `Date of birth`     `Date of death`
-#>    <chr>    <chr>      <int> <lgl>      <dttm>              <date>         
-#>  1 Vera Ru… scientist     88 TRUE       1928-07-23 00:00:00 2016-12-25     
-#>  2 Mohamed… athlete       74 TRUE       1942-01-17 00:00:00 2016-06-03     
-#>  3 Morley … journalist    84 TRUE       1931-11-08 00:00:00 2016-05-19     
-#>  4 Fidel C… politician    90 TRUE       1926-08-13 00:00:00 2016-11-25     
-#>  5 Antonin… lawyer        79 TRUE       1936-03-11 00:00:00 2016-02-13     
-#>  6 Jo Cox   politician    41 TRUE       1974-06-22 00:00:00 2016-06-16     
-#>  7 Janet R… lawyer        78 FALSE      1938-07-21 00:00:00 2016-11-07     
-#>  8 Gwen If… journalist    61 FALSE      1955-09-29 00:00:00 2016-11-14     
-#>  9 John Gl… astronaut     95 TRUE       1921-07-28 00:00:00 2016-12-08     
-#> 10 Pat Sum… coach         64 TRUE       1952-06-14 00:00:00 2016-06-28
+#>    Name          Profession   Age `Has kids` `Date of birth`     `Date of death`
+#>    <chr>         <chr>      <int> <lgl>      <dttm>              <date>         
+#>  1 Vera Rubin    scientist     88 TRUE       1928-07-23 00:00:00 2016-12-25     
+#>  2 Mohamed Ali   athlete       74 TRUE       1942-01-17 00:00:00 2016-06-03     
+#>  3 Morley Safer  journalist    84 TRUE       1931-11-08 00:00:00 2016-05-19     
+#>  4 Fidel Castro  politician    90 TRUE       1926-08-13 00:00:00 2016-11-25     
+#>  5 Antonin Scal… lawyer        79 TRUE       1936-03-11 00:00:00 2016-02-13     
+#>  6 Jo Cox        politician    41 TRUE       1974-06-22 00:00:00 2016-06-16     
+#>  7 Janet Reno    lawyer        78 FALSE      1938-07-21 00:00:00 2016-11-07     
+#>  8 Gwen Ifill    journalist    61 FALSE      1955-09-29 00:00:00 2016-11-14     
+#>  9 John Glenn    astronaut     95 TRUE       1921-07-28 00:00:00 2016-12-08     
+#> 10 Pat Summit    coach         64 TRUE       1952-06-14 00:00:00 2016-06-28
 ```
 
 If you looked at the `deaths` spreadsheet in the browser (it’s
@@ -276,19 +275,18 @@ sheets_example("deaths") %>%
 #> Reading from 'deaths'
 #> Range "arts_data"
 #> # A tibble: 10 x 6
-#>    Name  Profession   Age `Has kids` `Date of birth`    
-#>    <chr> <chr>      <dbl> <lgl>      <dttm>             
-#>  1 Davi… musician      69 TRUE       1947-01-08 00:00:00
-#>  2 Carr… actor         60 TRUE       1956-10-21 00:00:00
-#>  3 Chuc… musician      90 TRUE       1926-10-18 00:00:00
-#>  4 Bill… actor         61 TRUE       1955-05-17 00:00:00
-#>  5 Prin… musician      57 TRUE       1958-06-07 00:00:00
-#>  6 Alan… actor         69 FALSE      1946-02-21 00:00:00
-#>  7 Flor… actor         82 TRUE       1934-02-14 00:00:00
-#>  8 Harp… author        89 FALSE      1926-04-28 00:00:00
-#>  9 Zsa … actor         99 TRUE       1917-02-06 00:00:00
-#> 10 Geor… musician      53 FALSE      1963-06-25 00:00:00
-#> # … with 1 more variable: `Date of death` <dttm>
+#>    Name      Profession   Age `Has kids` `Date of birth`     `Date of death`    
+#>    <chr>     <chr>      <dbl> <lgl>      <dttm>              <dttm>             
+#>  1 David Bo… musician      69 TRUE       1947-01-08 00:00:00 2016-01-10 00:00:00
+#>  2 Carrie F… actor         60 TRUE       1956-10-21 00:00:00 2016-12-27 00:00:00
+#>  3 Chuck Be… musician      90 TRUE       1926-10-18 00:00:00 2017-03-18 00:00:00
+#>  4 Bill Pax… actor         61 TRUE       1955-05-17 00:00:00 2017-02-25 00:00:00
+#>  5 Prince    musician      57 TRUE       1958-06-07 00:00:00 2016-04-21 00:00:00
+#>  6 Alan Ric… actor         69 FALSE      1946-02-21 00:00:00 2016-01-14 00:00:00
+#>  7 Florence… actor         82 TRUE       1934-02-14 00:00:00 2016-11-24 00:00:00
+#>  8 Harper L… author        89 FALSE      1926-04-28 00:00:00 2016-02-19 00:00:00
+#>  9 Zsa Zsa … actor         99 TRUE       1917-02-06 00:00:00 2016-12-18 00:00:00
+#> 10 George M… musician      53 FALSE      1963-06-25 00:00:00 2016-12-25 00:00:00
 ```
 
 The named ranges, if any exist, are part of the information returned by
@@ -304,7 +302,7 @@ First, put the iris data into a csv file.
 
 ``` r
 (iris_tempfile <- tempfile(pattern = "iris-", fileext = ".csv"))
-#> [1] "/var/folders/yx/3p5dt4jj1019st0x90vhm9rr0000gn/T//RtmpO9k96x/iris-52c01686c65f.csv"
+#> [1] "/var/folders/yx/3p5dt4jj1019st0x90vhm9rr0000gn/T//RtmpxgbcIq/iris-1435e49144926.csv"
 write.csv(iris, iris_tempfile, row.names = FALSE)
 ```
 
@@ -314,15 +312,15 @@ convert to a Sheet.
 ``` r
 (iris_ss <- drive_upload(iris_tempfile, type = "spreadsheet"))
 #> Local file:
-#>   * /var/folders/yx/3p5dt4jj1019st0x90vhm9rr0000gn/T//RtmpO9k96x/iris-52c01686c65f.csv
+#>   * /var/folders/yx/3p5dt4jj1019st0x90vhm9rr0000gn/T//RtmpxgbcIq/iris-1435e49144926.csv
 #> uploaded into Drive file:
-#>   * iris-52c01686c65f: 1igNr3u_vfO7DyEDquqPHOyYCvZuTVZZEU-Gp9huONBQ
+#>   * iris-1435e49144926: 12tzp-ojdfdaEU_oHL4iVMHGkZOO2-jE1idzfaRQW88I
 #> with MIME type:
 #>   * application/vnd.google-apps.spreadsheet
 #> # A tibble: 1 x 3
-#>   name             id                                      drive_resource  
-#> * <chr>            <chr>                                   <list>          
-#> 1 iris-52c01686c6… 1igNr3u_vfO7DyEDquqPHOyYCvZuTVZZEU-Gp9… <named list [34…
+#>   name               id                                         drive_resource  
+#> * <chr>              <chr>                                      <list>          
+#> 1 iris-1435e49144926 12tzp-ojdfdaEU_oHL4iVMHGkZOO2-jE1idzfaRQW… <named list [34…
 
 ## visit the new Sheet in the browser, in an interactive session!
 drive_browse(iris_ss)
@@ -332,7 +330,7 @@ Read data from the private Sheet into R.
 
 ``` r
 read_sheet(iris_ss, range = "B1:D6")
-#> Reading from 'iris-52c01686c65f'
+#> Reading from 'iris-1435e49144926'
 #> Range "B1:D6"
 #> # A tibble: 5 x 3
 #>   Sepal.Width Petal.Length Petal.Width
@@ -349,12 +347,12 @@ Download the Sheet as an Excel workbook and read it back in via
 
 ``` r
 (iris_xlsxfile <- sub("[.]csv", ".xlsx", iris_tempfile))
-#> [1] "/var/folders/yx/3p5dt4jj1019st0x90vhm9rr0000gn/T//RtmpO9k96x/iris-52c01686c65f.xlsx"
+#> [1] "/var/folders/yx/3p5dt4jj1019st0x90vhm9rr0000gn/T//RtmpxgbcIq/iris-1435e49144926.xlsx"
 drive_download(iris_ss, path = iris_xlsxfile, overwrite = TRUE)
 #> File downloaded:
-#>   * iris-52c01686c65f
+#>   * iris-1435e49144926
 #> Saved locally as:
-#>   * /var/folders/yx/3p5dt4jj1019st0x90vhm9rr0000gn/T//RtmpO9k96x/iris-52c01686c65f.xlsx
+#>   * /var/folders/yx/3p5dt4jj1019st0x90vhm9rr0000gn/T//RtmpxgbcIq/iris-1435e49144926.xlsx
 
 if (requireNamespace("readxl", quietly = TRUE)) {
   readxl::read_excel(iris_xlsxfile)  
@@ -382,7 +380,7 @@ file.remove(iris_tempfile, iris_xlsxfile)
 #> [1] TRUE TRUE
 drive_rm(iris_ss)
 #> Files deleted:
-#>   * iris-52c01686c65f: 1igNr3u_vfO7DyEDquqPHOyYCvZuTVZZEU-Gp9huONBQ
+#>   * iris-1435e49144926: 12tzp-ojdfdaEU_oHL4iVMHGkZOO2-jE1idzfaRQW88I
 ```
 
 ## Get Sheet metadata or detailed cell data
@@ -414,16 +412,16 @@ str(deaths_meta, max.level = 1)
 #>  $ name           : chr "deaths"
 #>  $ locale         : chr "en"
 #>  $ time_zone      : chr "America/Los_Angeles"
-#>  $ sheets         :Classes 'tbl_df', 'tbl' and 'data.frame': 2 obs. of  7 variables:
+#>  $ sheets         :Classes 'tbl_df', 'tbl' and 'data.frame': 2 obs. of  8 variables:
 #>  $ named_ranges   :Classes 'tbl_df', 'tbl' and 'data.frame': 2 obs. of  9 variables:
-#>  - attr(*, "class")= chr [1:2] "sheets_meta" "list"
+#>  - attr(*, "class")= chr [1:2] "sheets_Spreadsheet" "list"
 
 deaths_meta$sheets
-#> # A tibble: 2 x 7
-#>   name  index id         type  visible grid_rows grid_columns
-#>   <chr> <int> <chr>      <chr> <lgl>       <int>        <int>
-#> 1 arts      0 1210215306 GRID  TRUE         1000           26
-#> 2 other     1 28655153   GRID  TRUE         1000           26
+#> # A tibble: 2 x 8
+#>   name  index         id type  visible grid_rows grid_columns data  
+#>   <chr> <int>      <int> <chr> <lgl>       <int>        <int> <list>
+#> 1 arts      0 1210215306 GRID  TRUE         1000           26 <NULL>
+#> 2 other     1   28655153 GRID  TRUE         1000           26 <NULL>
 
 deaths_meta$named_ranges
 #> # A tibble: 2 x 9
diff --git a/man/as_sheets_id.Rd b/man/as_sheets_id.Rd
index 8f2b531f5..0b6f24e01 100644
--- a/man/as_sheets_id.Rd
+++ b/man/as_sheets_id.Rd
@@ -8,7 +8,8 @@ as_sheets_id(x, ...)
 }
 \arguments{
 \item{x}{Something that uniquely identifies a Google Sheet: a \code{\link{sheets_id}},
-URL, or \code{\link[googledrive:dribble]{dribble}}.}
+a URL, one-row \code{\link[googledrive:dribble]{dribble}}, or a
+\code{sheets_Spreadsheet}.}
 
 \item{...}{Other arguments passed down to methods. (Not used.)}
 }
@@ -19,15 +20,20 @@ Converts various representations of a Google Sheet into a
 \item Spreadsheet id, "a string containing letters, numbers, and some special
 characters", typically 44 characters long, in our experience. Example:
 \verb{1qpyC0XzvTcKT6EISywvqESX3A0MwQoFDE8p-Bll4hps}.
-\item A URL, from which we can excavate a spreadsheet or file id. Example: \url{https://docs.google.com/spreadsheets/d/1BzfL0kZUz1TsI5zxJF1WNF01IxvC67FbOJUiiGMZ_mQ/edit#gid=1150108545}.
+\item A URL, from which we can excavate a spreadsheet or file id. Example:
+\url{https://docs.google.com/spreadsheets/d/1BzfL0kZUz1TsI5zxJF1WNF01IxvC67FbOJUiiGMZ_mQ/edit#gid=1150108545}.
 \item A one-row \code{\link[googledrive:dribble]{dribble}}, a "Drive tibble" used by the
-\link{googledrive} package. In general, a \code{dribble} can represent several files,
-one row per file. Since googlesheets4 is not vectorized over spreadsheets,
-we are only prepared to accept a one-row \code{dribble}.
+\link{googledrive} package. In general, a \code{dribble} can represent several
+files, one row per file. Since googlesheets4 is not vectorized over
+spreadsheets, we are only prepared to accept a one-row \code{dribble}.
 \itemize{
-\item \code{\link[googledrive:drive_get]{googledrive::drive_get("YOUR SHEET NAME")}}
+\item \code{\link[googledrive:drive_get]{googledrive::drive_get("YOUR_SHEET_NAME")}}
 is a great way to look up a Sheet via its name.
+\item \code{\link[=sheets_find]{sheets_find("YOUR_SHEET_NAME")}} is another good way
+to get your hands on a Sheet.
 }
+\item Spreadsheet meta data, as returned by, e.g., \code{\link[=sheets_get]{sheets_get()}}. Literally,
+this is an object of class \code{sheets_Spreadsheet}.
 }
 
 This is a generic function.
diff --git a/man/sheets_create.Rd b/man/sheets_create.Rd
new file mode 100644
index 000000000..0efa9110c
--- /dev/null
+++ b/man/sheets_create.Rd
@@ -0,0 +1,54 @@
+% Generated by roxygen2: do not edit by hand
+% Please edit documentation in R/sheets_create.R
+\name{sheets_create}
+\alias{sheets_create}
+\title{Create a new Sheet}
+\usage{
+sheets_create(name, ..., sheets = NULL)
+}
+\arguments{
+\item{name}{The name of the spreadsheet.}
+
+\item{...}{Optional spreadsheet properties that can be set through this API
+endpoint, such as locale and time zone.}
+
+\item{sheets}{Optional named list of data frames. One sheet is created for
+each data frame.}
+}
+\value{
+\itemize{
+\item \code{sheets_get()}: A list with S3 class \code{sheets_Spreadsheet}, for printing
+purposes.
+\item \code{sheets_sheets()}: A character vector.
+}
+}
+\description{
+Creates an entirely new Sheet (spreadsheet or workbook). Offers some control
+over the initial set of sheets (worksheets or tabs). CAUTION: this function
+is still being developed and, for example, currently sends all data as
+character.
+}
+\examples{
+if (sheets_has_token()) {
+  sheets_create("sheets-create-demo-1")
+
+  sheets_create("sheets-create-demo-2", locale = "en_CA")
+
+  sheets_create(
+    "sheets-create-demo-3",
+    locale = "fr_FR",
+    timeZone = "Europe/Paris"
+  )
+
+  sheets_create(
+    "sheets-create-demo-4",
+    sheets = list(iris = head(iris), mtcars = head(mtcars))
+  )
+}
+}
+\seealso{
+Wraps the \code{spreadsheets.create} endpoint:
+\itemize{
+\item \url{https://developers.google.com/sheets/api/reference/rest/v4/spreadsheets/create}
+}
+}
diff --git a/man/sheets_get.Rd b/man/sheets_get.Rd
index 62989a3eb..b83a93248 100644
--- a/man/sheets_get.Rd
+++ b/man/sheets_get.Rd
@@ -17,7 +17,7 @@ is how googledrive represents Drive files. Processed through
 }
 \value{
 \itemize{
-\item \code{sheets_get()}: A list with S3 class \code{sheets_meta}, for printing
+\item \code{sheets_get()}: A list with S3 class \code{sheets_Spreadsheet}, for printing
 purposes.
 \item \code{sheets_sheets()}: A character vector.
 }
diff --git a/tests/testthat/test-schemas.R b/tests/testthat/test-schemas.R
new file mode 100644
index 000000000..3357f8273
--- /dev/null
+++ b/tests/testthat/test-schemas.R
@@ -0,0 +1,69 @@
+test_that("new() errors for non-existing id", {
+  expect_error(new("I_don't_exist"), "Can't find")
+})
+
+test_that("new() works (and doesn't require data)", {
+  out <- new("Spreadsheet")
+  expect_length(out, 0)
+  expect_s3_class(out, "googlesheets4_Spreadsheet")
+  expect_s3_class(out, "googlesheets4_schema")
+  expect_s3_class(attr(out, "schema"), "tbl_df")
+})
+
+test_that("new() accepts data expected for schema", {
+  out <- new("Spreadsheet", spreadsheetId = "abc")
+  expect_identical(out$spreadsheetId, "abc")
+})
+
+test_that("new() rejects data not expected for schema", {
+  expect_error(
+    new("Spreadsheet", foofy = "blah"),
+    "not recognized"
+  )
+  expect_error(
+    new("Spreadsheet", foofy = "blah", foo = "bar"),
+    "foofy, foo"
+  )
+})
+
+test_that("patch() fails informatively for non-schema input", {
+  expect_error(patch(1), "Don't know how")
+})
+
+test_that("patch() with no data passes input through", {
+  out <- new("Spreadsheet", spreadsheetId = "abc")
+  expect_identical(out, patch(out))
+})
+
+test_that("patch() accepts data expected for schema", {
+  expect_identical(
+    new("Spreadsheet", spreadsheetId = "abc"),
+    new("Spreadsheet") %>% patch(spreadsheetId = "abc")
+  )
+})
+
+test_that("patch() rejects data not expected for schema", {
+  x <- new("Spreadsheet")
+  expect_error(patch(x, foofy = "blah"), "not recognized")
+})
+
+test_that("patch() overwrites existing data", {
+  x <- new("Spreadsheet", spreadsheetId = "abc")
+  x <- patch(x, spreadsheetId = "xyz")
+  expect_identical(x$spreadsheetId, "xyz")
+  expect_length(x, 1)
+})
+
+test_that("patch() can clear a property", {
+  x <- new("Spreadsheet", spreadsheetId = "abc")
+  x <- patch(x, spreadsheetId = NULL)
+  expect_null(x$spreadsheetId)
+})
+
+test_that("patch() retains classes", {
+  x <- new("Spreadsheet")
+  classes_in <- class(x)
+  x <- patch(x, spreadsheetId = "abc")
+  classes_out <- class(x)
+  expect_identical(classes_in, classes_out)
+})
diff --git a/tests/testthat/test-sheets_id.R b/tests/testthat/test-sheets_id.R
index 316259368..5624e5f80 100644
--- a/tests/testthat/test-sheets_id.R
+++ b/tests/testthat/test-sheets_id.R
@@ -65,3 +65,10 @@ test_that("dribble with one Sheet can be coerced", {
   d <- d[d$mime_type == "application/vnd.google-apps.spreadsheet", ]
   expect_s3_class(as_sheets_id(d), "sheets_id")
 })
+
+test_that("a sheets_Spreadsheet can be coerced", {
+  x <- new("Spreadsheet", spreadsheetId = "123")
+  out <- as_sheets_id(sheets_Spreadsheet(x))
+  expect_s3_class(out, "sheets_id")
+  expect_identical(out, as_sheets_id("123"))
+})