Requests

Запрос

Один тип обновления для применения к электронной таблице.

JSON-представление
{

  // Union field kind can be only one of the following:
  "updateSpreadsheetProperties": {
    object (UpdateSpreadsheetPropertiesRequest)
  },
  "updateSheetProperties": {
    object (UpdateSheetPropertiesRequest)
  },
  "updateDimensionProperties": {
    object (UpdateDimensionPropertiesRequest)
  },
  "updateNamedRange": {
    object (UpdateNamedRangeRequest)
  },
  "repeatCell": {
    object (RepeatCellRequest)
  },
  "addNamedRange": {
    object (AddNamedRangeRequest)
  },
  "deleteNamedRange": {
    object (DeleteNamedRangeRequest)
  },
  "addSheet": {
    object (AddSheetRequest)
  },
  "deleteSheet": {
    object (DeleteSheetRequest)
  },
  "autoFill": {
    object (AutoFillRequest)
  },
  "cutPaste": {
    object (CutPasteRequest)
  },
  "copyPaste": {
    object (CopyPasteRequest)
  },
  "mergeCells": {
    object (MergeCellsRequest)
  },
  "unmergeCells": {
    object (UnmergeCellsRequest)
  },
  "updateBorders": {
    object (UpdateBordersRequest)
  },
  "updateCells": {
    object (UpdateCellsRequest)
  },
  "addFilterView": {
    object (AddFilterViewRequest)
  },
  "appendCells": {
    object (AppendCellsRequest)
  },
  "clearBasicFilter": {
    object (ClearBasicFilterRequest)
  },
  "deleteDimension": {
    object (DeleteDimensionRequest)
  },
  "deleteEmbeddedObject": {
    object (DeleteEmbeddedObjectRequest)
  },
  "deleteFilterView": {
    object (DeleteFilterViewRequest)
  },
  "duplicateFilterView": {
    object (DuplicateFilterViewRequest)
  },
  "duplicateSheet": {
    object (DuplicateSheetRequest)
  },
  "findReplace": {
    object (FindReplaceRequest)
  },
  "insertDimension": {
    object (InsertDimensionRequest)
  },
  "insertRange": {
    object (InsertRangeRequest)
  },
  "moveDimension": {
    object (MoveDimensionRequest)
  },
  "updateEmbeddedObjectPosition": {
    object (UpdateEmbeddedObjectPositionRequest)
  },
  "pasteData": {
    object (PasteDataRequest)
  },
  "textToColumns": {
    object (TextToColumnsRequest)
  },
  "updateFilterView": {
    object (UpdateFilterViewRequest)
  },
  "deleteRange": {
    object (DeleteRangeRequest)
  },
  "appendDimension": {
    object (AppendDimensionRequest)
  },
  "addConditionalFormatRule": {
    object (AddConditionalFormatRuleRequest)
  },
  "updateConditionalFormatRule": {
    object (UpdateConditionalFormatRuleRequest)
  },
  "deleteConditionalFormatRule": {
    object (DeleteConditionalFormatRuleRequest)
  },
  "sortRange": {
    object (SortRangeRequest)
  },
  "setDataValidation": {
    object (SetDataValidationRequest)
  },
  "setBasicFilter": {
    object (SetBasicFilterRequest)
  },
  "addProtectedRange": {
    object (AddProtectedRangeRequest)
  },
  "updateProtectedRange": {
    object (UpdateProtectedRangeRequest)
  },
  "deleteProtectedRange": {
    object (DeleteProtectedRangeRequest)
  },
  "autoResizeDimensions": {
    object (AutoResizeDimensionsRequest)
  },
  "addChart": {
    object (AddChartRequest)
  },
  "updateChartSpec": {
    object (UpdateChartSpecRequest)
  },
  "updateBanding": {
    object (UpdateBandingRequest)
  },
  "addBanding": {
    object (AddBandingRequest)
  },
  "deleteBanding": {
    object (DeleteBandingRequest)
  },
  "createDeveloperMetadata": {
    object (CreateDeveloperMetadataRequest)
  },
  "updateDeveloperMetadata": {
    object (UpdateDeveloperMetadataRequest)
  },
  "deleteDeveloperMetadata": {
    object (DeleteDeveloperMetadataRequest)
  },
  "randomizeRange": {
    object (RandomizeRangeRequest)
  },
  "addDimensionGroup": {
    object (AddDimensionGroupRequest)
  },
  "deleteDimensionGroup": {
    object (DeleteDimensionGroupRequest)
  },
  "updateDimensionGroup": {
    object (UpdateDimensionGroupRequest)
  },
  "trimWhitespace": {
    object (TrimWhitespaceRequest)
  },
  "deleteDuplicates": {
    object (DeleteDuplicatesRequest)
  },
  "updateEmbeddedObjectBorder": {
    object (UpdateEmbeddedObjectBorderRequest)
  },
  "addSlicer": {
    object (AddSlicerRequest)
  },
  "updateSlicerSpec": {
    object (UpdateSlicerSpecRequest)
  },
  "addDataSource": {
    object (AddDataSourceRequest)
  },
  "updateDataSource": {
    object (UpdateDataSourceRequest)
  },
  "deleteDataSource": {
    object (DeleteDataSourceRequest)
  },
  "refreshDataSource": {
    object (RefreshDataSourceRequest)
  },
  "cancelDataSourceRefresh": {
    object (CancelDataSourceRefreshRequest)
  },
  "addTable": {
    object (AddTableRequest)
  },
  "updateTable": {
    object (UpdateTableRequest)
  },
  "deleteTable": {
    object (DeleteTableRequest)
  }
  // End of list of possible types for union field kind.
}
Поля
Поле объединения kind . Тип обновления. Требуется ровно одно обязательное поле. kind может принимать только одно из следующих значений:
updateSpreadsheetProperties

object ( UpdateSpreadsheetPropertiesRequest )

Обновляет свойства электронной таблицы.

updateSheetProperties

object ( UpdateSheetPropertiesRequest )

Обновляет свойства листа.

updateDimensionProperties

object ( UpdateDimensionPropertiesRequest )

Обновляет свойства измерений.

updateNamedRange

object ( UpdateNamedRangeRequest )

Обновляет именованный диапазон.

repeatCell

object ( RepeatCellRequest )

Повторяет одну и ту же ячейку в заданном диапазоне.

addNamedRange

object ( AddNamedRangeRequest )

Добавляет именованный диапазон.

deleteNamedRange

object ( DeleteNamedRangeRequest )

Удаляет именованный диапазон.

addSheet

object ( AddSheetRequest )

Добавляет лист.

deleteSheet

object ( DeleteSheetRequest )

Удаляет лист.

autoFill

object ( AutoFillRequest )

Автоматически заполняет дополнительные данные на основе уже имеющихся данных.

cutPaste

object ( CutPasteRequest )

Вырезает данные из одной области и вставляет их в другую.

copyPaste

object ( CopyPasteRequest )

Копирует данные из одной области и вставляет их в другую.

mergeCells

object ( MergeCellsRequest )

Объединяет клетки.

unmergeCells

object ( UnmergeCellsRequest )

Разъединяет объединенные ячейки.

updateBorders

object ( UpdateBordersRequest )

Обновляет границы в диапазоне ячеек.

updateCells

object ( UpdateCellsRequest )

Обновляет сразу множество ячеек.

addFilterView

object ( AddFilterViewRequest )

Добавляет представление фильтра.

appendCells

object ( AppendCellsRequest )

Добавляет данные в ячейки после последней строки листа.

clearBasicFilter

object ( ClearBasicFilterRequest )

Сбрасывает основной фильтр на листе.

deleteDimension

object ( DeleteDimensionRequest )

Удаляет строки или столбцы в таблице.

deleteEmbeddedObject

object ( DeleteEmbeddedObjectRequest )

Удаляет встроенный объект (например, диаграмму, изображение) на листе.

deleteFilterView

object ( DeleteFilterViewRequest )

Удаляет представление фильтра из листа.

duplicateFilterView

object ( DuplicateFilterViewRequest )

Дублирует представление фильтра.

duplicateSheet

object ( DuplicateSheetRequest )

Создает копию листа.

findReplace

object ( FindReplaceRequest )

Находит и заменяет вхождения одного текста другим.

insertDimension

object ( InsertDimensionRequest )

Вставляет новые строки или столбцы в лист.

insertRange

object ( InsertRangeRequest )

Вставляет новые ячейки в лист, сдвигая существующие.

moveDimension

object ( MoveDimensionRequest )

Перемещает строки или столбцы в другое место на листе.

updateEmbeddedObjectPosition

object ( UpdateEmbeddedObjectPositionRequest )

Обновляет положение встроенного объекта (например, диаграммы, изображения).

pasteData

object ( PasteDataRequest )

Вставляет данные (HTML или с разделителями) в таблицу.

textToColumns

object ( TextToColumnsRequest )

Преобразует один столбец текста в несколько столбцов текста.

updateFilterView

object ( UpdateFilterViewRequest )

Обновляет свойства представления фильтра.

deleteRange

object ( DeleteRangeRequest )

Удаляет диапазон ячеек на листе, сдвигая оставшиеся ячейки.

appendDimension

object ( AppendDimensionRequest )

Добавляет размеры в конец листа.

addConditionalFormatRule

object ( AddConditionalFormatRuleRequest )

Добавляет новое правило условного форматирования.

updateConditionalFormatRule

object ( UpdateConditionalFormatRuleRequest )

Обновляет существующее правило условного форматирования.

deleteConditionalFormatRule

object ( DeleteConditionalFormatRuleRequest )

Удаляет существующее правило условного форматирования.

sortRange

object ( SortRangeRequest )

Сортирует данные в заданном диапазоне.

setDataValidation

object ( SetDataValidationRequest )

Задает параметры проверки данных для одной или нескольких ячеек.

setBasicFilter

object ( SetBasicFilterRequest )

Устанавливает базовый фильтр для листа.

addProtectedRange

object ( AddProtectedRangeRequest )

Добавляет защищённый диапазон.

updateProtectedRange

object ( UpdateProtectedRangeRequest )

Обновляет защищенный диапазон.

deleteProtectedRange

object ( DeleteProtectedRangeRequest )

Удаляет защищенный диапазон.

autoResizeDimensions

object ( AutoResizeDimensionsRequest )

Автоматически изменяет размер одного или нескольких измерений в зависимости от содержимого ячеек в этом измерении.

addChart

object ( AddChartRequest )

Добавляет диаграмму.

updateChartSpec

object ( UpdateChartSpecRequest )

Обновляет технические характеристики диаграммы.

updateBanding

object ( UpdateBandingRequest )

Обновляет диапазон полос

addBanding

object ( AddBandingRequest )

Добавляет новый диапазон полос

deleteBanding

object ( DeleteBandingRequest )

Удаляет полосатый диапазон

createDeveloperMetadata

object ( CreateDeveloperMetadataRequest )

Создает новые метаданные для разработчиков.

updateDeveloperMetadata

object ( UpdateDeveloperMetadataRequest )

Обновляет существующую запись метаданных разработчика.

deleteDeveloperMetadata

object ( DeleteDeveloperMetadataRequest )

Удаляет метаданные разработчика.

randomizeRange

object ( RandomizeRangeRequest )

В случайном порядке меняет порядок строк в заданном диапазоне.

addDimensionGroup

object ( AddDimensionGroupRequest )

Создает группу в указанном диапазоне.

deleteDimensionGroup

object ( DeleteDimensionGroupRequest )

Удаляет группу в указанном диапазоне.

updateDimensionGroup

object ( UpdateDimensionGroupRequest )

Обновляет состояние указанной группы.

trimWhitespace

object ( TrimWhitespaceRequest )

Удаляет пробелы (например, пробелы, табуляции или переносы строк) из ячеек.

deleteDuplicates

object ( DeleteDuplicatesRequest )

Удаляет строки, содержащие повторяющиеся значения в указанных столбцах диапазона ячеек.

updateEmbeddedObjectBorder

object ( UpdateEmbeddedObjectBorderRequest )

Обновляет границы встроенного объекта.

addSlicer

object ( AddSlicerRequest )

Добавляет инструмент для нарезки.

updateSlicerSpec

object ( UpdateSlicerSpecRequest )

Обновляет параметры слайсера.

addDataSource

object ( AddDataSourceRequest )

Добавляет источник данных.

updateDataSource

object ( UpdateDataSourceRequest )

Обновляет источник данных.

deleteDataSource

object ( DeleteDataSourceRequest )

Удаляет источник данных.

refreshDataSource

object ( RefreshDataSourceRequest )

Обновляет один или несколько источников данных и связанных с ними объектов dbobject.

cancelDataSourceRefresh

object ( CancelDataSourceRefreshRequest )

Отменяет обновление одного или нескольких источников данных и связанных с ними объектов dbobject.

addTable

object ( AddTableRequest )

Добавляет таблицу.

updateTable

object ( UpdateTableRequest )

Обновляет таблицу.

deleteTable

object ( DeleteTableRequest )

Запрос на удаление таблицы.

UpdateSpreadsheetPropertiesRequest

Обновляет свойства электронной таблицы.

JSON-представление
{
  "properties": {
    object (SpreadsheetProperties)
  },
  "fields": string
}
Поля
properties

object ( SpreadsheetProperties )

Свойства, которые необходимо обновить.

fields

string ( FieldMask format)

Поля, которые необходимо обновить. Необходимо указать как минимум одно поле. Корневой объект 'properties' подразумевается и не должен указываться отдельно. Для краткого перечисления всех полей можно использовать символ "*" .

UpdateSheetPropertiesRequest

Обновляет свойства листа с указанным sheetId .

JSON-представление
{
  "properties": {
    object (SheetProperties)
  },
  "fields": string
}
Поля
properties

object ( SheetProperties )

Свойства, которые необходимо обновить.

fields

string ( FieldMask format)

Поля, которые необходимо обновить. Необходимо указать как минимум одно поле. Корневые properties подразумеваются и не должны указываться. Для краткого перечисления всех полей можно использовать символ "*" .

UpdateDimensionPropertiesRequest

Обновляет свойства измерений в указанном диапазоне.

JSON-представление
{
  "properties": {
    object (DimensionProperties)
  },
  "fields": string,

  // Union field dimension_range can be only one of the following:
  "range": {
    object (DimensionRange)
  },
  "dataSourceSheetRange": {
    object (DataSourceSheetDimensionRange)
  }
  // End of list of possible types for union field dimension_range.
}
Поля
properties

object ( DimensionProperties )

Свойства, которые необходимо обновить.

fields

string ( FieldMask format)

Поля, которые необходимо обновить. Необходимо указать как минимум одно поле. Корневые properties подразумеваются и не должны указываться. Для краткого перечисления всех полей можно использовать символ "*" .

Поле объединения dimension_range . Диапазон измерений. dimension_range может принимать только одно из следующих значений:
range

object ( DimensionRange )

Строки или столбцы, которые необходимо обновить.

dataSourceSheetRange

object ( DataSourceSheetDimensionRange )

Столбцы в таблице источника данных, которые необходимо обновить.

DataSourceSheetDimensionRange

Диапазон значений по одному измерению на листе DATA_SOURCE .

JSON-представление
{
  "sheetId": integer,
  "columnReferences": [
    {
      object (DataSourceColumnReference)
    }
  ]
}
Поля
sheetId

integer

Идентификатор листа-источника данных, на котором находится диапазон.

columnReferences[]

object ( DataSourceColumnReference )

Столбцы на листе с источником данных.

UpdateNamedRangeRequest

Обновляет свойства именованного диапазона, используя указанный namedRangeId .

JSON-представление
{
  "namedRange": {
    object (NamedRange)
  },
  "fields": string
}
Поля
namedRange

object ( NamedRange )

Укажите именованный диапазон, который необходимо обновить с учетом новых свойств.

fields

string ( FieldMask format)

Поля, которые необходимо обновить. Необходимо указать как минимум одно поле. Корневой namedRange подразумевается и не должен указываться отдельно. Для краткого перечисления всех полей можно использовать символ "*" .

RepeatCellRequest

Обновляет все ячейки в диапазоне значениями из указанного объекта Cell. Обновляются только поля, перечисленные в поле fields ; остальные остаются без изменений.

При вводе формулы в ячейку диапазоны формулы будут автоматически увеличиваться для каждого поля в диапазоне. Например, если ввести формулу =A1 в ячейку в диапазоне B2:C4, то B2 будет =A1 , B3 будет =A2, B4 будет =A3 , C2 будет =A2 =B1 , C3 будет =B2 , C4 будет =B3 .

Чтобы диапазоны формулы оставались неизменными, используйте индикатор $ . Например, формула =$A$1 предотвратит увеличение значений как в строке, так и в столбце.

JSON-представление
{
  "range": {
    object (GridRange)
  },
  "cell": {
    object (CellData)
  },
  "fields": string
}
Поля
range

object ( GridRange )

Диапазон, в котором следует повторить ячейку.

cell

object ( CellData )

Данные для записи.

fields

string ( FieldMask format)

Поля, которые необходимо обновить. Необходимо указать как минимум одно поле. Корневая cell подразумевается и не должна указываться отдельно. Для краткого перечисления всех полей можно использовать символ "*" .

AddNamedRangeRequest

Добавляет именованный диапазон в электронную таблицу.

JSON-представление
{
  "namedRange": {
    object (NamedRange)
  }
}
Поля
namedRange

object ( NamedRange )

Именованный диапазон для добавления. Поле namedRangeId является необязательным; если оно не задано, идентификатор будет сгенерирован случайным образом. (Указание идентификатора уже существующего диапазона является ошибкой.)

DeleteNamedRangeRequest

Удаляет из электронной таблицы именованный диапазон с заданным идентификатором.

JSON-представление
{
  "namedRangeId": string
}
Поля
namedRangeId

string

Идентификатор именованного диапазона для удаления.

AddSheetRequest

Добавляет новый лист. При добавлении листа по заданному индексу индексы всех последующих листов увеличиваются. Чтобы добавить лист объекта, используйте вместо этого AddChartRequest и укажите EmbeddedObjectPosition.sheetId или EmbeddedObjectPosition.newSheet .

JSON-представление
{
  "properties": {
    object (SheetProperties)
  }
}
Поля
properties

object ( SheetProperties )

Свойства, которыми должен обладать новый лист. Все свойства необязательны. Поле sheetId является необязательным; если оно не задано, идентификатор будет сгенерирован случайным образом. (Указание идентификатора уже существующего листа является ошибкой.)

DeleteSheetRequest

Удаляет запрошенный лист.

JSON-представление
{
  "sheetId": integer
}
Поля
sheetId

integer

Идентификатор листа, который нужно удалить.

Если лист имеет тип DATA_SOURCE , то связанный с ним DataSource также удаляется.

AutoFillRequest

Заполняет пробелы в данных на основе уже имеющихся данных.

JSON-представление
{
  "useAlternateSeries": boolean,

  // Union field area can be only one of the following:
  "range": {
    object (GridRange)
  },
  "sourceAndDestination": {
    object (SourceAndDestination)
  }
  // End of list of possible types for union field area.
}
Поля
useAlternateSeries

boolean

Верно, если нам следует генерировать данные с использованием «альтернативной» серии. Это зависит от типа и объема исходных данных.

area объединения. Область для автоматического заполнения. area может быть только одной из следующих:
range

object ( GridRange )

Диапазон для автозаполнения. Программа проверит диапазон, определит место, содержащее данные, и автоматически заполнит оставшуюся часть диапазона этими данными.

sourceAndDestination

object ( SourceAndDestination )

Области источника и назначения для автозаполнения. Здесь явно указан источник автозаполнения и куда следует расширить эти данные.

ИсточникИНаправление

Сочетание диапазона источника и способов расширения этого источника.

JSON-представление
{
  "source": {
    object (GridRange)
  },
  "dimension": enum (Dimension),
  "fillLength": integer
}
Поля
source

object ( GridRange )

Местоположение данных, используемых в качестве источника для автозаполнения.

dimension

enum ( Dimension )

Размерность, в которую следует заполнить данные.

fillLength

integer

Количество строк или столбцов, в которые должны быть заполнены данные. Положительные числа выходят за пределы последней строки или последнего столбца исходных данных. Отрицательные числа выходят за пределы первой строки или первого столбца исходных данных.

CutPasteRequest

Перемещает данные из источника в пункт назначения.

JSON-представление
{
  "source": {
    object (GridRange)
  },
  "destination": {
    object (GridCoordinate)
  },
  "pasteType": enum (PasteType)
}
Поля
source

object ( GridRange )

Исходные данные, которые нужно удалить.

destination

object ( GridCoordinate )

Координата в верхнем левом углу, куда следует вставить данные.

pasteType

enum ( PasteType )

Какие данные вставлять? Все исходные данные будут скопированы, независимо от того, что вставляется.

PasteType

Какие данные следует вставить?

Перечисления
PASTE_NORMAL Вставка значений, формул, форматирование и слияние.
PASTE_VALUES Вставляйте ТОЛЬКО значения без форматирования, формул или слияния.
PASTE_FORMAT Вставляйте только формат и проверку данных.
PASTE_NO_BORDERS Аналогично PASTE_NORMAL , но без границ.
PASTE_FORMULA Вставьте только формулы.
PASTE_DATA_VALIDATION Вставьте только данные для проверки.
PASTE_CONDITIONAL_FORMATTING Вставляйте только правила условного форматирования.

КопироватьЗапрос

Копирует данные из источника в пункт назначения.

JSON-представление
{
  "source": {
    object (GridRange)
  },
  "destination": {
    object (GridRange)
  },
  "pasteType": enum (PasteType),
  "pasteOrientation": enum (PasteOrientation)
}
Поля
source

object ( GridRange )

Диапазон исходных данных для копирования.

destination

object ( GridRange )

Место для вставки. Если диапазон охватывает область, кратную высоте или ширине исходного диапазона, то данные будут повторены для заполнения целевого диапазона. Если диапазон меньше исходного диапазона, будут скопированы все исходные данные (за пределы целевого диапазона).

pasteType

enum ( PasteType )

Какие данные нужно вставить?

pasteOrientation

enum ( PasteOrientation )

Как следует ориентировать эти данные при вставке.

ВставкаОриентация

Как следует выполнять операцию вставки.

Перечисления
NORMAL Вставить обычным способом.
TRANSPOSE Вставьте текст с транспонированием, при котором все строки станут столбцами, и наоборот.

MergeCellsRequest

Объединяет все ячейки в заданном диапазоне.

JSON-представление
{
  "range": {
    object (GridRange)
  },
  "mergeType": enum (MergeType)
}
Поля
range

object ( GridRange )

Диапазон ячеек для слияния.

mergeType

enum ( MergeType )

Как следует объединять ячейки.

MergeType

Тип слияния, который необходимо создать.

Перечисления
MERGE_ALL Создайте единое слияние из диапазона
MERGE_COLUMNS Создайте операцию слияния для каждого столбца в диапазоне.
MERGE_ROWS Создайте операцию слияния для каждой строки в диапазоне.

UnmergeCellsRequest

Разъединяет ячейки в заданном диапазоне.

JSON-представление
{
  "range": {
    object (GridRange)
  }
}
Поля
range

object ( GridRange )

Диапазон, в пределах которого все ячейки должны быть разъединены. Если диапазон охватывает несколько слияний, все они будут разъединены. Диапазон не должен частично охватывать какое-либо слияние.

UpdateBordersRequest

Обновляет границы диапазона. Если поле не задано в запросе, это означает, что границы остаются без изменений. Например, при двух последовательных запросах UpdateBordersRequest:

  1. диапазон: A1:A5 { top: RED, bottom: WHITE }
  2. диапазон: A1:A5 { left: BLUE }

В результате, ячейки A1:A5 будут иметь границы вида { top: RED, bottom: WHITE, left: BLUE } . Если вы хотите убрать границу, явно установите стиль в NONE .

JSON-представление
{
  "range": {
    object (GridRange)
  },
  "top": {
    object (Border)
  },
  "bottom": {
    object (Border)
  },
  "left": {
    object (Border)
  },
  "right": {
    object (Border)
  },
  "innerHorizontal": {
    object (Border)
  },
  "innerVertical": {
    object (Border)
  }
}
Поля
range

object ( GridRange )

Диапазон, границы которого следует обновить.

top

object ( Border )

Граница, которую следует установить на самом верху диапазона.

bottom

object ( Border )

Граница, которую следует разместить в нижней части диапазона.

left

object ( Border )

Граница должна располагаться слева от хребта.

right

object ( Border )

Граница должна располагаться справа от хребта.

innerHorizontal

object ( Border )

Горизонтальная граница, которую необходимо разместить в пределах указанного диапазона.

innerVertical

object ( Border )

Вертикальная граница, которую необходимо разместить в пределах заданного диапазона.

UpdateCellsRequest

Обновляет все ячейки в заданном диапазоне новыми данными.

JSON-представление
{
  "rows": [
    {
      object (RowData)
    }
  ],
  "fields": string,

  // Union field area can be only one of the following:
  "start": {
    object (GridCoordinate)
  },
  "range": {
    object (GridRange)
  }
  // End of list of possible types for union field area.
}
Поля
rows[]

object ( RowData )

Данные для записи.

fields

string ( FieldMask format)

Поля объекта CellData, которые необходимо обновить. Необходимо указать как минимум одно поле. Корневым элементом является объект CellData; параметр 'row.values.' указывать не следует. Для краткого перечисления всех полей можно использовать один символ "*" .

Поле объединения « area ». Необходимо записать данные о местоположении. Должно быть задано ровно одно значение. area может принимать только одно из следующих значений:
start

object ( GridCoordinate )

Координата, с которой начинается запись данных. Можно записать любое количество строк и столбцов (включая различное количество столбцов в каждой строке).

range

object ( GridRange )

Диапазон для записи данных.

Если данные в строках не покрывают весь запрошенный диапазон, поля, соответствующие значениям, заданным в fields будут очищены.

AddFilterViewRequest

Добавляет представление фильтра.

JSON-представление
{
  "filter": {
    object (FilterView)
  }
}
Поля
filter

object ( FilterView )

Добавляемый фильтр. Поле filterViewId является необязательным. Если оно не задано, будет сгенерирован случайный идентификатор. (Указание идентификатора уже существующего фильтра является ошибкой.)

AppendCellsRequest

Добавляет новые ячейки после последней строки с данными на листе, при необходимости вставляя новые строки в лист.

JSON-представление
{
  "sheetId": integer,
  "rows": [
    {
      object (RowData)
    }
  ],
  "fields": string,

  // Union field area can be only one of the following:
  "tableId": string
  // End of list of possible types for union field area.
}
Поля
sheetId

integer

Идентификатор листа, к которому нужно добавить данные.

rows[]

object ( RowData )

Данные для добавления.

fields

string ( FieldMask format)

Поля объекта CellData, которые необходимо обновить. Необходимо указать как минимум одно поле. Корневым элементом является объект CellData; параметр 'row.values.' указывать не следует. Для краткого перечисления всех полей можно использовать один символ "*" .

area полевого участка Союза. Необходимо указать местоположение. area может быть только одной из следующих:
tableId

string

Идентификатор таблицы, в которую нужно добавить данные. Данные будут добавлены только в тело таблицы.

Это поле также имеет приоритет над полем sheetId .

ClearBasicFilterRequest

Сбрасывает основной фильтр, если таковой имеется в таблице.

JSON-представление
{
  "sheetId": integer
}
Поля
sheetId

integer

Идентификатор листа, для которого следует снять основной фильтр.

DeleteDimensionRequest

Удаляет размеры с листа.

JSON-представление
{
  "range": {
    object (DimensionRange)
  }
}
Поля
range

object ( DimensionRange )

Размеры, которые нужно удалить из листа.

DeleteEmbeddedObjectRequest

Удаляет встроенный объект с заданным идентификатором.

JSON-представление
{
  "objectId": integer
}
Поля
objectId

integer

Идентификатор встроенного объекта, который необходимо удалить.

DeleteFilterViewRequest

Удаляет определенный фильтр.

JSON-представление
{
  "filterId": integer
}
Поля
filterId

integer

Идентификатор фильтра, который нужно удалить.

DuplicateFilterViewRequest

Дублирует определенный фильтр.

JSON-представление
{
  "filterId": integer
}
Поля
filterId

integer

Идентификатор дублируемого фильтра.

DuplicateSheetRequest

Дублирует содержимое листа.

JSON-представление
{
  "sourceSheetId": integer,
  "insertSheetIndex": integer,
  "newSheetId": integer,
  "newSheetName": string
}
Поля
sourceSheetId

integer

Лист, который нужно скопировать.

Если исходный лист имеет тип DATA_SOURCE , то его базовый DataSource также дублируется и связывается с новой копией листа. При этом выполнение обработки данных не запускается, данные сетки этого листа также копируются, но становятся доступны только после завершения пакетного запроса.

insertSheetIndex

integer

Индекс, начинающийся с нуля, куда следует вставить новый лист. Индексы всех последующих листов увеличиваются с каждым последующим.

newSheetId

integer

Если задано, то указывается идентификатор нового листа. Если не задано, то выбирается идентификатор. Если задано, то идентификатор не должен конфликтовать с идентификаторами существующих листов. Если задано, то значение идентификатора должно быть неотрицательным.

newSheetName

string

Название нового листа. Если поле пустое, для вас будет выбрано новое имя.

FindReplaceRequest

Находит и заменяет данные в ячейках в заданном диапазоне, на листе или на всех листах.

JSON-представление
{
  "find": string,
  "replacement": string,
  "matchCase": boolean,
  "matchEntireCell": boolean,
  "searchByRegex": boolean,
  "includeFormulas": boolean,

  // Union field scope can be only one of the following:
  "range": {
    object (GridRange)
  },
  "sheetId": integer,
  "allSheets": boolean
  // End of list of possible types for union field scope.
}
Поля
find

string

Значение для поиска.

replacement

string

Значение, которое следует использовать в качестве замены.

matchCase

boolean

Возвращает true, если поиск чувствителен к регистру.

matchEntireCell

boolean

Возвращает true, если найденное значение должно соответствовать всей ячейке.

searchByRegex

boolean

Значение true, если значение поиска является регулярным выражением. Регулярное выражение и замена должны соответствовать правилам регулярных выражений Java, описанным по адресу https://docs.oracle.com/javase/8/docs/api/java/util/regex/Pattern.html . Строка замены может ссылаться на захватывающие группы. Например, если одна ячейка содержит "Google Sheets" , а другая - "Google Docs" , то поиск "o.* (.*)" с заменой "$1 Rocks" изменит содержимое ячеек на "GSheets Rocks" и "GDocs Rocks" соответственно.

includeFormulas

boolean

Значение True означает, что поиск должен включать ячейки с формулами. Значение False означает пропуск ячеек с формулами.

scope поля объединения. Область видимости, в пределах которой выполняется поиск/замена — должна быть задана только одна область видимости. scope может быть только одной из следующих:
range

object ( GridRange )

Диапазон поиска/замены.

sheetId

integer

Лист, который нужно найти/заменить.

allSheets

boolean

Функция "Найти/Заменить" работает корректно на всех листах.

InsertDimensionRequest

Вставляет строки или столбцы в лист по определенному индексу.

JSON-представление
{
  "range": {
    object (DimensionRange)
  },
  "inheritFromBefore": boolean
}
Поля
range

object ( DimensionRange )

Размеры для вставки. Начальный и конечный индексы должны быть ограничены.

inheritFromBefore

boolean

Определяет, следует ли наследовать свойства измерений от измерений, предшествующих или следующих за вновь вставленными измерениями. Значение true означает наследование от предыдущих измерений (в этом случае начальный индекс должен быть больше 0), а значение false — наследование от последующих измерений.

Например, если строка с индексом 0 имеет красный фон, а строка с индексом 1 — зеленый, то при вставке двух строк по индексу 1 фон может быть унаследован либо от зеленого, либо от красного. Если inheritFromBefore равно true, две новые строки будут красными (поскольку строка до точки вставки была красной), а если inheritFromBefore равно false, две новые строки будут зелеными (поскольку строка после точки вставки была зеленой).

InsertRangeRequest

Вставляет ячейки в диапазон, сдвигая существующие ячейки вправо или вниз.

JSON-представление
{
  "range": {
    object (GridRange)
  },
  "shiftDimension": enum (Dimension)
}
Поля
range

object ( GridRange )

Диапазон, в который следует вставлять новые ячейки. Диапазон ограничен текущими границами листа.

shiftDimension

enum ( Dimension )

Размер, который будет смещен при вставке ячеек. Если ROWS , существующие ячейки будут смещены вниз. Если COLUMNS , существующие ячейки будут смещены вправо.

MoveDimensionRequest

Перемещает одну или несколько строк или столбцов.

JSON-представление
{
  "source": {
    object (DimensionRange)
  },
  "destinationIndex": integer
}
Поля
source

object ( DimensionRange )

Исходные размеры, которые необходимо переместить.

destinationIndex

integer

Начальный индекс, отсчитываемый с нуля, определяет место перемещения исходных данных, исходя из координат до удаления исходных данных из сетки. Существующие данные будут сдвинуты вниз или вправо (в зависимости от измерения), чтобы освободить место для перемещенных измерений. Исходные измерения удаляются из сетки, поэтому данные могут оказаться в другом индексе, чем указано.

Например, если дана A1..A5 состоящая из 0, 1, 2, 3, 4 , и нужно переместить "1" и "2" в область между "3" и "4" , то источником будет ROWS [1..3) , а целевым индексом — "4" (индекс строки 5, начинающийся с нуля). В результате получится A1..A5 состоящая из 0, 3, 1, 2, 4 .

UpdateEmbeddedObjectPositionRequest

Обновить положение встроенного объекта (например, переместить или изменить размер диаграммы или изображения).

JSON-представление
{
  "objectId": integer,
  "newPosition": {
    object (EmbeddedObjectPosition)
  },
  "fields": string
}
Поля
objectId

integer

Идентификатор перемещаемого объекта.

newPosition

object ( EmbeddedObjectPosition )

Укажите позицию, в которую следует переместить встроенный объект. Если задано значение newPosition.sheetId , будет создан новый лист с этим ID. Если значение newPosition.newSheet равно true, будет создан новый лист с ID, который будет выбран автоматически.

fields

string ( FieldMask format)

Поля OverlayPosition , которые должны быть обновлены при установке новой позиции. Используется только в том случае, если задано значение newPosition.overlayPosition , в этом случае необходимо указать хотя бы одно поле. Корневой объект newPosition.overlayPosition подразумевается и не должен указываться. Для краткого перечисления всех полей можно использовать символ "*" .

PasteDataRequest

Вставляет данные в электронную таблицу, начиная с указанной координаты.

JSON-представление
{
  "coordinate": {
    object (GridCoordinate)
  },
  "data": string,
  "type": enum (PasteType),

  // Union field kind can be only one of the following:
  "delimiter": string,
  "html": boolean
  // End of list of possible types for union field kind.
}
Поля
coordinate

object ( GridCoordinate )

Координата, с которой следует начать вставку данных.

data

string

Данные для вставки.

type

enum ( PasteType )

Как следует вставить данные.

Поле объединения kind . Способ интерпретации данных: необходимо задать ровно одно значение. kind может принимать только одно из следующих значений:
delimiter

string

Разделитель в данных.

html

boolean

Возвращает true, если данные представлены в формате HTML.

TextToColumnsRequest

Разделяет столбец текста на несколько столбцов на основе разделителя в каждой ячейке.

JSON-представление
{
  "source": {
    object (GridRange)
  },
  "delimiter": string,
  "delimiterType": enum (DelimiterType)
}
Поля
source

object ( GridRange )

Диапазон исходных данных. Он должен занимать ровно один столбец.

delimiter

string

Используемый разделитель. Используется только в том случае, если delimiterType имеет значение CUSTOM .

delimiterType

enum ( DelimiterType )

Тип разделителя для использования.

DelimiterType

Разделитель, по которому будет производиться разделение.

Перечисления
DELIMITER_TYPE_UNSPECIFIED Значение по умолчанию. Это значение использовать нельзя.
COMMA ","
SEMICOLON ";"
PERIOD "."
SPACE " "
CUSTOM Пользовательское значение, определенное в параметре delimiter.
AUTODETECT Автоматическое определение столбцов.

UpdateFilterViewRequest

Обновляет свойства представления фильтра.

JSON-представление
{
  "filter": {
    object (FilterView)
  },
  "fields": string
}
Поля
filter

object ( FilterView )

Новые свойства представления фильтра.

fields

string ( FieldMask format)

Поля, которые необходимо обновить. Необходимо указать как минимум одно поле. Корневой filter подразумевается и не должен указываться отдельно. Для краткого перечисления всех полей можно использовать символ "*" .

DeleteRangeRequest

Удаляет диапазон ячеек, перемещая другие ячейки в удаленную область.

JSON-представление
{
  "range": {
    object (GridRange)
  },
  "shiftDimension": enum (Dimension)
}
Поля
range

object ( GridRange )

Диапазон ячеек для удаления.

shiftDimension

enum ( Dimension )

Размерность, на основе которой будут заменены удаленные ячейки. Если ROWS , существующие ячейки будут сдвинуты вверх для замены удаленных. Если COLUMNS , существующие ячейки будут сдвинуты влево для замены удаленных.

AppendDimensionRequest

Добавляет строки или столбцы в конец листа.

JSON-представление
{
  "sheetId": integer,
  "dimension": enum (Dimension),
  "length": integer
}
Поля
sheetId

integer

Лист, на который нужно добавить строки или столбцы.

dimension

enum ( Dimension )

Следует ли добавлять строки или столбцы.

length

integer

Количество строк или столбцов для добавления.

AddConditionalFormatRuleRequest

Добавляет новое правило условного форматирования по указанному индексу. Индексы всех последующих правил увеличиваются на единицу.

JSON-представление
{
  "rule": {
    object (ConditionalFormatRule)
  },
  "index": integer
}
Поля
rule

object ( ConditionalFormatRule )

Правило сложения.

index

integer

Индекс, начинающийся с нуля, куда следует вставить правило.

UpdateConditionalFormatRuleRequest

Обновляет правило условного форматирования по заданному индексу или перемещает правило условного форматирования в другой индекс.

JSON-представление
{
  "index": integer,
  "sheetId": integer,

  // Union field instruction can be only one of the following:
  "rule": {
    object (ConditionalFormatRule)
  },
  "newIndex": integer
  // End of list of possible types for union field instruction.
}
Поля
index

integer

Индекс правила, которое следует заменить или переместить, начиная с нуля.

sheetId

integer

Лист с правилом перемещения. Обязателен, если задан параметр newIndex , в противном случае не используется.

instruction по полевым работам профсоюза. Тип обновления, которое должно произойти. instruction может быть только одним из следующих:
rule

object ( ConditionalFormatRule )

Правило, которое должно заменить правило по заданному индексу.

newIndex

integer

Новый индекс, отсчитываемый с нуля, к которому должно прийти это правило.

DeleteConditionalFormatRuleRequest

Удаляет правило условного форматирования по указанному индексу. Индексы всех последующих правил уменьшаются.

JSON-представление
{
  "index": integer,
  "sheetId": integer
}
Поля
index

integer

Индекс правила, подлежащего удалению, начиная с нуля.

sheetId

integer

Лист, с которого удаляется правило.

SortRangeRequest

Сортирует данные по строкам в соответствии с порядком сортировки для каждого столбца.

JSON-представление
{
  "range": {
    object (GridRange)
  },
  "sortSpecs": [
    {
      object (SortSpec)
    }
  ]
}
Поля
range

object ( GridRange )

Диапазон для сортировки.

sortSpecs[]

object ( SortSpec )

Порядок сортировки по столбцам. При равенстве значений в предыдущих параметрах используются более поздние значения.

SetDataValidationRequest

Устанавливает правило проверки данных для каждой ячейки в диапазоне. Чтобы снять проверку в диапазоне, вызовите эту функцию, не указывая никакого правила.

JSON-представление
{
  "range": {
    object (GridRange)
  },
  "rule": {
    object (DataValidationRule)
  },
  "filteredRowsIncluded": boolean
}
Поля
range

object ( GridRange )

Диапазон, в котором должно применяться правило проверки данных.

rule

object ( DataValidationRule )

Правило проверки данных, которое нужно установить для каждой ячейки в диапазоне, или оставить пустым, чтобы отменить проверку данных в диапазоне.

filteredRowsIncluded

boolean

Необязательно. Если значение равно true, правило проверки данных будет применено и к отфильтрованным строкам.

SetBasicFilterRequest

Задает базовый фильтр, связанный с листом.

JSON-представление
{
  "filter": {
    object (BasicFilter)
  }
}
Поля
filter

object ( BasicFilter )

Фильтр для установки.

AddProtectedRangeRequest

Добавляет новый защищенный диапазон.

JSON-представление
{
  "protectedRange": {
    object (ProtectedRange)
  }
}
Поля
protectedRange

object ( ProtectedRange )

Добавляемый защищаемый диапазон. Поле protectedRangeId является необязательным; если оно не задано, идентификатор будет сгенерирован случайным образом. (Указание идентификатора уже существующего диапазона является ошибкой.)

UpdateProtectedRangeRequest

Обновляет существующий защищенный диапазон с указанным protectedRangeId .

JSON-представление
{
  "protectedRange": {
    object (ProtectedRange)
  },
  "fields": string
}
Поля
protectedRange

object ( ProtectedRange )

Защищенный диапазон необходимо обновить с учетом новых свойств.

fields

string ( FieldMask format)

Поля, которые необходимо обновить. Необходимо указать как минимум одно поле. Корневой protectedRange подразумевается и не должен указываться. Для краткого перечисления всех полей можно использовать символ "*" .

DeleteProtectedRangeRequest

Удаляет защищаемый диапазон с заданным идентификатором.

JSON-представление
{
  "protectedRangeId": integer
}
Поля
protectedRangeId

integer

Идентификатор защищаемого диапазона, который необходимо удалить.

AutoResizeDimensionsRequest

Автоматически изменяет размер одного или нескольких измерений в зависимости от содержимого ячеек в этом измерении.

JSON-представление
{

  // Union field dimension_range can be only one of the following:
  "dimensions": {
    object (DimensionRange)
  },
  "dataSourceSheetDimensions": {
    object (DataSourceSheetDimensionRange)
  }
  // End of list of possible types for union field dimension_range.
}
Поля
Поле объединения dimension_range . Диапазон измерений. dimension_range может принимать только одно из следующих значений:
dimensions

object ( DimensionRange )

Размеры, которые будут автоматически изменяться.

dataSourceSheetDimensions

object ( DataSourceSheetDimensionRange )

Размеры, указанные в таблице источника данных, которые необходимо автоматически изменить.

AddChartRequest

Добавляет диаграмму на лист в электронной таблице.

JSON-представление
{
  "chart": {
    object (EmbeddedChart)
  }
}
Поля
chart

object ( EmbeddedChart )

Диаграмма, которую следует добавить в электронную таблицу, включая место её размещения. Поле chartId является необязательным; если оно не задано, идентификатор будет сгенерирован случайным образом. (Указание идентификатора уже существующего встроенного объекта является ошибкой.)

UpdateChartSpecRequest

Обновляет характеристики диаграммы. (Это не перемещает и не изменяет размер диаграммы. Для перемещения или изменения размера диаграммы используйте UpdateEmbeddedObjectPositionRequest .)

JSON-представление
{
  "chartId": integer,
  "spec": {
    object (ChartSpec)
  }
}
Поля
chartId

integer

Идентификатор диаграммы, которую необходимо обновить.

spec

object ( ChartSpec )

Технические требования, применяемые к диаграмме.

UpdateBandingRequest

Обновляет свойства заданного диапазона полос.

JSON-представление
{
  "bandedRange": {
    object (BandedRange)
  },
  "fields": string
}
Поля
bandedRange

object ( BandedRange )

Диапазон значений, который необходимо обновить с учетом новых свойств.

fields

string ( FieldMask format)

Поля, которые необходимо обновить. Необходимо указать как минимум одно поле. Корневой bandedRange подразумевается и не должен указываться. Для краткого перечисления всех полей можно использовать один символ "*" .

AddBandingRequest

Добавляет в электронную таблицу новый диапазон значений.

JSON-представление
{
  "bandedRange": {
    object (BandedRange)
  }
}
Поля
bandedRange

object ( BandedRange )

Диапазон для добавления. Поле bandedRangeId является необязательным; если оно не задано, идентификатор будет сгенерирован случайным образом. (Указание идентификатора уже существующего диапазона является ошибкой.)

DeleteBandingRequest

Удаляет из электронной таблицы диапазон с заданным идентификатором.

JSON-представление
{
  "bandedRangeId": integer
}
Поля
bandedRangeId

integer

Идентификатор диапазона полос, который нужно удалить.

CreateDeveloperMetadataRequest

Запрос на создание метаданных для разработчиков.

JSON-представление
{
  "developerMetadata": {
    object (DeveloperMetadata)
  }
}
Поля
developerMetadata

object ( DeveloperMetadata )

Метаданные разработчика для создания.

UpdateDeveloperMetadataRequest

Запрос на обновление свойств метаданных разработчика. Обновляет свойства метаданных разработчика, выбранных фильтрами, до значений, указанных в ресурсе DeveloperMetadata . Вызывающие стороны должны указать свойства, которые они хотят обновить, в параметре fields, а также указать как минимум один DataFilter соответствующий метаданным, которые они хотят обновить.

JSON-представление
{
  "dataFilters": [
    {
      object (DataFilter)
    }
  ],
  "developerMetadata": {
    object (DeveloperMetadata)
  },
  "fields": string
}
Поля
dataFilters[]

object ( DataFilter )

Фильтры, соответствующие записям метаданных разработчика, подлежащим обновлению.

developerMetadata

object ( DeveloperMetadata )

Значение, до которого будут обновлены все метаданные, соответствующие фильтрам данных.

fields

string ( FieldMask format)

Поля, которые необходимо обновить. Необходимо указать как минимум одно поле. Корневой developerMetadata подразумевается и не должен указываться отдельно. Для краткого перечисления всех полей можно использовать символ "*" .

DeleteDeveloperMetadataRequest

Запрос на удаление метаданных разработчика.

JSON-представление
{
  "dataFilter": {
    object (DataFilter)
  }
}
Поля
dataFilter

object ( DataFilter )

Фильтр данных, описывающий критерии, используемые для выбора записи метаданных разработчика, которую следует удалить.

RandomizeRangeRequest

В случайном порядке меняет порядок строк в заданном диапазоне.

JSON-представление
{
  "range": {
    object (GridRange)
  }
}
Поля
range

object ( GridRange )

Диапазон для случайного выбора.

AddDimensionGroupRequest

Создает группу в указанном диапазоне.

Если запрашиваемый диапазон является надмножеством диапазона существующей группы G, то глубина группы G увеличивается, и новая группа G' имеет глубину этой группы. Например, группа [C:D, глубина 1] + [B:E] приводит к группам [B:E, глубина 1] и [C:D, глубина 2]. Если запрашиваемый диапазон является подмножеством диапазона существующей группы G, то глубина новой группы G' становится на единицу больше глубины G. Например, группа [B:E, глубина 1] + [C:D] приводит к группам [B:E, глубина 1] и [C:D, глубина 2]. Если запрашиваемый диапазон начинается до и заканчивается внутри, или начинается внутри и заканчивается после диапазона существующей группы G, то диапазон существующей группы G становится объединением диапазонов, и новая группа G' имеет глубину на единицу больше глубины G и диапазон, являющийся пересечением диапазонов. Например, группа [B:D, глубина 1] + [C:E] приводит к образованию групп [B:E, глубина 1] и [C:D, глубина 2].

JSON-представление
{
  "range": {
    object (DimensionRange)
  }
}
Поля
range

object ( DimensionRange )

Диапазон, в пределах которого следует создать группу.

DeleteDimensionGroupRequest

Удаляет группу в указанном диапазоне путем уменьшения глубины измерений в диапазоне.

Например, предположим, что на листе есть группа глубиной 1 над B:E и группа глубиной 2 над C:D. Удаление группы над D:E оставляет на листе группу глубиной 1 над B:D и группу глубиной 2 над C:C.

JSON-представление
{
  "range": {
    object (DimensionRange)
  }
}
Поля
range

object ( DimensionRange )

Диапазон групп, подлежащих удалению.

UpdateDimensionGroupRequest

Обновляет состояние указанной группы.

JSON-представление
{
  "dimensionGroup": {
    object (DimensionGroup)
  },
  "fields": string
}
Поля
dimensionGroup

object ( DimensionGroup )

Группа, состояние которой необходимо обновить. Диапазон и глубина группы должны указывать на действительную группу в таблице, а все остальные поля должны быть обновлены.

fields

string ( FieldMask format)

Поля, которые необходимо обновить. Необходимо указать как минимум одно поле. Корневая dimensionGroup подразумевается и не должна указываться отдельно. Для краткого перечисления всех полей можно использовать символ "*" .

TrimWhitespaceRequest

Удаляет пробелы (например, пробелы, табуляции или переносы строк) из каждой ячейки в указанном диапазоне. Этот запрос удаляет все пробелы в начале и конце текста каждой ячейки и сокращает любую последовательность оставшихся пробелов до одного пробела. Если полученный обрезанный текст начинается с символа '+' или '=', текст остается строковым значением и не интерпретируется как формула.

JSON-представление
{
  "range": {
    object (GridRange)
  }
}
Поля
range

object ( GridRange )

Диапазон ячеек, которые необходимо обрезать.

DeleteDuplicatesRequest

Удаляет строки в указанном диапазоне, содержащие значения в указанных столбцах, которые являются дубликатами значений в любой предыдущей строке. Строки с идентичными значениями, но разным регистром букв, форматированием или формулами считаются дубликатами.

Этот запрос также удаляет дублирующиеся строки, скрытые от просмотра (например, из-за фильтра). При удалении дубликатов первое вхождение каждой дублирующейся строки, сканируемой сверху вниз, сохраняется в результирующем диапазоне. Содержимое за пределами указанного диапазона не удаляется, и строки, считающиеся дубликатами, не обязательно должны быть смежными друг с другом в этом диапазоне.

JSON-представление
{
  "range": {
    object (GridRange)
  },
  "comparisonColumns": [
    {
      object (DimensionRange)
    }
  ]
}
Поля
range

object ( GridRange )

Диапазон, из которого следует удалить повторяющиеся строки.

comparisonColumns[]

object ( DimensionRange )

Укажите столбцы в диапазоне, которые необходимо проанализировать на наличие повторяющихся значений. Если ни один столбец не выбран, то на наличие дубликатов анализируются все столбцы.

UpdateEmbeddedObjectBorderRequest

Обновляет свойство границы встроенного объекта.

JSON-представление
{
  "objectId": integer,
  "border": {
    object (EmbeddedObjectBorder)
  },
  "fields": string
}
Поля
objectId

integer

Идентификатор встроенного объекта, который необходимо обновить.

border

object ( EmbeddedObjectBorder )

Граница, применяемая к встроенному объекту.

fields

string ( FieldMask format)

Поля, которые необходимо обновить. Необходимо указать как минимум одно поле. Корневая border подразумевается и не должна указываться. Для краткого перечисления всех полей можно использовать один символ "*" .

AddSlicerRequest

Добавляет фильтр на лист в электронной таблице.

JSON-представление
{
  "slicer": {
    object (Slicer)
  }
}
Поля
slicer

object ( Slicer )

Срез, который следует добавить в электронную таблицу, включая его местоположение. Поле slicerId является необязательным; если оно не задано, идентификатор будет сгенерирован случайным образом. (Указание идентификатора уже существующего среза является ошибкой.)

UpdateSlicerSpecRequest

Обновляет параметры среза. (Это не перемещает и не изменяет размер среза. Для перемещения или изменения размера среза используйте UpdateEmbeddedObjectPositionRequest .)

JSON-представление
{
  "slicerId": integer,
  "spec": {
    object (SlicerSpec)
  },
  "fields": string
}
Поля
slicerId

integer

Идентификатор среза, который необходимо обновить.

spec

object ( SlicerSpec )

Технические характеристики, применяемые к слайсеру.

fields

string ( FieldMask format)

Поля, которые необходимо обновить. Необходимо указать как минимум одно поле. Корневой SlicerSpec подразумевается и не должен указываться. Для краткого перечисления всех полей можно использовать один символ "*".

Добавить запрос источника данных

Добавляет источник данных. После успешного добавления источника данных создается связанный лист DATA_SOURCE , и запускается процесс обновления листа для чтения данных из источника.

Для добавления источника данных BigQuery требуется дополнительная область действия OAuth bigquery.readonly .

JSON-представление
{
  "dataSource": {
    object (DataSource)
  }
}
Поля
dataSource

object ( DataSource )

Источник данных, который необходимо добавить.

UpdateDataSourceRequest

Обновляет источник данных. После успешного обновления источника данных запускается процесс обновления соответствующего листа DATA_SOURCE для чтения данных из обновленного источника данных.

Для обновления источника данных BigQuery требуется дополнительная область действия OAuth bigquery.readonly .

JSON-представление
{
  "dataSource": {
    object (DataSource)
  },
  "fields": string
}
Поля
dataSource

object ( DataSource )

Источник данных для обновления.

fields

string ( FieldMask format)

Поля, которые необходимо обновить. Необходимо указать как минимум одно поле. Корневой dataSource подразумевается и не должен указываться. Для краткого перечисления всех полей можно использовать символ "*" .

DeleteDataSourceRequest

Удаляет источник данных. Запрос также удаляет связанный с ним лист источника данных и отменяет связь со всеми связанными объектами источника данных.

JSON-представление
{
  "dataSourceId": string
}
Поля
dataSourceId

string

Идентификатор источника данных для удаления.

RefreshDataSourceRequest

Обновляет один или несколько объектов источника данных в электронной таблице по указанным ссылкам.

Для обновления источника данных BigQuery требуется дополнительная область действия OAuth bigquery.readonly .

Если в одном пакете имеется несколько запросов на обновление, ссылающихся на одни и те же объекты источника данных, обрабатывается только последний запрос на обновление, и все эти запросы получат одинаковый ответ.

JSON-представление
{
  "force": boolean,

  // Union field target can be only one of the following:
  "references": {
    object (DataSourceObjectReferences)
  },
  "dataSourceId": string,
  "isAll": boolean
  // End of list of possible types for union field target.
}
Поля
force

boolean

Обновляет объекты источника данных независимо от текущего состояния. Если параметр не задан и объект источника данных, на который ссылается запрос, находится в состоянии ошибки, обновление немедленно завершится неудачей.

target поле объединения. Указывает, что нужно обновить. target может приниматься только одно из следующих:
references

object ( DataSourceObjectReferences )

Ссылки на объекты источников данных для обновления.

dataSourceId

string

Ссылка на DataSource . Если указано, обновляет все связанные объекты источника данных для данного источника.

isAll

boolean

Обновляет все существующие объекты источников данных в электронной таблице.

DataSourceObjectReferences

Список ссылок на объекты источников данных.

JSON-представление
{
  "references": [
    {
      object (DataSourceObjectReference)
    }
  ]
}
Поля
references[]

object ( DataSourceObjectReference )

Ссылки.

DataSourceObjectReference

Ссылка на объект источника данных.

JSON-представление
{

  // Union field value can be only one of the following:
  "sheetId": string,
  "chartId": integer,
  "dataSourceTableAnchorCell": {
    object (GridCoordinate)
  },
  "dataSourcePivotTableAnchorCell": {
    object (GridCoordinate)
  },
  "dataSourceFormulaCell": {
    object (GridCoordinate)
  }
  // End of list of possible types for union field value.
}
Поля
value поля объединения. Тип ссылки. value может принимать только одно из следующих значений:
sheetId

string

Ссылки на лист DATA_SOURCE .

chartId

integer

Ссылки на диаграмму источника данных.

dataSourceTableAnchorCell

object ( GridCoordinate )

Ссылки на DataSourceTable , привязанные к ячейке.

dataSourcePivotTableAnchorCell

object ( GridCoordinate )

Ссылки на источник данных PivotTable привязанную к ячейке.

dataSourceFormulaCell

object ( GridCoordinate )

Ссылки на ячейку, содержащую DataSourceFormula .

Отменить запрос на обновление источника данных

Отменяет одно или несколько обновлений объектов источника данных в электронной таблице по указанным ссылкам.

Для отмены обновления источника данных BigQuery требуется дополнительная область действия OAuth bigquery.readonly .

JSON-представление
{

  // Union field target can be only one of the following:
  "references": {
    object (DataSourceObjectReferences)
  },
  "dataSourceId": string,
  "isAll": boolean
  // End of list of possible types for union field target.
}
Поля
Поле объединения target . Указывает, что нужно отменить. target может быть только одним из следующих значений:
references

object ( DataSourceObjectReferences )

Ссылки на объекты источников данных, обновление которых необходимо отменить.

dataSourceId

string

Ссылка на DataSource . Если указано, отменяет все связанные обновления объектов источника данных для этого источника.

isAll

boolean

Отменяет все существующие обновления объектов источников данных для всех источников данных в электронной таблице.

AddTableRequest

Добавляет новую таблицу в электронную таблицу.

JSON-представление
{
  "table": {
    object (Table)
  }
}
Поля
table

object ( Table )

Обязательно. Таблица для добавления.

UpdateTableRequest

Обновляет таблицу в электронной таблице.

JSON-представление
{
  "table": {
    object (Table)
  },
  "fields": string
}
Поля
table

object ( Table )

Обязательно. Таблица для обновления.

fields

string ( FieldMask format)

Обязательно. Поля, которые необходимо обновить. Необходимо указать как минимум одно поле. Корневая table подразумевается и не должна указываться. Для краткого перечисления всех полей можно использовать символ "*" .

DeleteTableRequest

Удаляет из электронной таблицы таблицу с заданным ID.

JSON-представление
{
  "tableId": string
}
Поля
tableId

string

Идентификатор таблицы, которую нужно удалить.