REST Resource: spreadsheets

Ресурс: электронная таблица

Ресурс, представляющий электронную таблицу.

Представление JSON
{
  "spreadsheetId": string,
  "properties": {
    object (SpreadsheetProperties)
  },
  "sheets": [
    {
      object (Sheet)
    }
  ],
  "namedRanges": [
    {
      object (NamedRange)
    }
  ],
  "spreadsheetUrl": string,
  "developerMetadata": [
    {
      object (DeveloperMetadata)
    }
  ],
  "dataSources": [
    {
      object (DataSource)
    }
  ],
  "dataSourceSchedules": [
    {
      object (DataSourceRefreshSchedule)
    }
  ]
}
Поля
spreadsheetId

string

Идентификатор электронной таблицы. Это поле доступно только для чтения.

properties

object ( SpreadsheetProperties )

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

sheets[]

object ( Sheet )

Листы, являющиеся частью электронной таблицы.

namedRanges[]

object ( NamedRange )

Именованные диапазоны, определенные в электронной таблице.

spreadsheetUrl

string

URL таблицы. Это поле доступно только для чтения.

developerMetadata[]

object ( DeveloperMetadata )

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

dataSources[]

object ( DataSource )

Список внешних источников данных, связанных с электронной таблицей.

dataSourceSchedules[]

object ( DataSourceRefreshSchedule )

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

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

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

Представление JSON
{
  "title": string,
  "locale": string,
  "autoRecalc": enum (RecalculationInterval),
  "timeZone": string,
  "defaultFormat": {
    object (CellFormat)
  },
  "iterativeCalculationSettings": {
    object (IterativeCalculationSettings)
  },
  "spreadsheetTheme": {
    object (SpreadsheetTheme)
  }
}
Поля
title

string

Название электронной таблицы.

locale

string

Языковой стандарт электронной таблицы в одном из следующих форматов:

  • код языка ISO 639-1, такой как en

  • код языка ISO 639-2, такой как fil , если код 639-1 не существует

  • комбинация кода языка ISO и кода страны, например en_US

Примечание: при обновлении этого поля поддерживаются не все локали/языки.

autoRecalc

enum ( RecalculationInterval )

Время ожидания перед пересчетом энергозависимых функций.

timeZone

string

Часовой пояс электронной таблицы в формате CLDR, например America/New_York . Если часовой пояс не распознается, это может быть пользовательский часовой пояс, например GMT-07:00 .

defaultFormat

object ( CellFormat )

Формат по умолчанию для всех ячеек электронной таблицы. CellData.effectiveFormat не будет установлен, если формат ячейки равен этому формату по умолчанию. Это поле доступно только для чтения.

iterativeCalculationSettings

object ( IterativeCalculationSettings )

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

spreadsheetTheme

object ( SpreadsheetTheme )

Тема применена к электронной таблице.

Интервал пересчета

Перечисление возможных вариантов интервала пересчета.

перечисления
RECALCULATION_INTERVAL_UNSPECIFIED Значение по умолчанию. Это значение не должно использоваться.
ON_CHANGE Неустойчивые функции обновляются при каждом изменении.
MINUTE Нестабильные функции обновляются при каждом изменении и каждую минуту.
HOUR Нестабильные функции обновляются при каждом изменении и ежечасно.

Параметры итеративного расчета

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

Представление JSON
{
  "maxIterations": integer,
  "convergenceThreshold": number
}
Поля
maxIterations

integer

Когда включен итеративный расчет, максимальное количество циклов расчета для выполнения.

convergenceThreshold

number

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

ТаблицаТема

Представляет тему электронной таблицы

Представление JSON
{
  "primaryFontFamily": string,
  "themeColors": [
    {
      object (ThemeColorPair)
    }
  ]
}
Поля
primaryFontFamily

string

Имя основного семейства шрифтов.

themeColors[]

object ( ThemeColorPair )

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

ТемаЦветПара

Пара, отображающая тип цвета темы электронной таблицы на конкретный цвет, который он представляет.

Представление JSON
{
  "colorType": enum (ThemeColorType),
  "color": {
    object (ColorStyle)
  }
}
Поля
colorType

enum ( ThemeColorType )

Тип цвета темы электронной таблицы.

color

object ( ColorStyle )

Конкретный цвет, соответствующий цветовому типу темы.

Именованный диапазон

Именованный диапазон.

Представление JSON
{
  "namedRangeId": string,
  "name": string,
  "range": {
    object (GridRange)
  }
}
Поля
namedRangeId

string

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

name

string

Имя именованного диапазона.

range

object ( GridRange )

Диапазон, который это представляет.

Источник данных

Информация о внешнем источнике данных в электронной таблице.

Представление JSON
{
  "dataSourceId": string,
  "spec": {
    object (DataSourceSpec)
  },
  "calculatedColumns": [
    {
      object (DataSourceColumn)
    }
  ],
  "sheetId": integer
}
Поля
dataSourceId

string

Уникальный идентификатор на уровне электронной таблицы, который идентифицирует источник данных. Пример: 1080547365.

spec

object ( DataSourceSpec )

DataSourceSpec для источника данных, связанного с этой электронной таблицей.

calculatedColumns[]

object ( DataSourceColumn )

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

sheetId

integer

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

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

Спецификация источника данных

Это указывает детали источника данных. Например, для BigQuery это указывает информацию об источнике BigQuery.

Представление JSON
{
  "parameters": [
    {
      object (DataSourceParameter)
    }
  ],

  // Union field spec can be only one of the following:
  "bigQuery": {
    object (BigQueryDataSourceSpec)
  }
  // End of list of possible types for union field spec.
}
Поля
parameters[]

object ( DataSourceParameter )

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

spec поля союза. Фактическая спецификация для каждого типа источника данных. spec может быть только одним из следующих:
bigQuery

object ( BigQueryDataSourceSpec )

BigQueryDataSourceSpec .

BigQueryDataSourceSpec

Спецификация источника данных BigQuery, подключенного к таблице.

Представление JSON
{
  "projectId": string,

  // Union field spec can be only one of the following:
  "querySpec": {
    object (BigQueryQuerySpec)
  },
  "tableSpec": {
    object (BigQueryTableSpec)
  }
  // End of list of possible types for union field spec.
}
Поля
projectId

string

Идентификатор проекта Google Cloud с поддержкой BigQuery, к которому подключен платежный аккаунт. Плата взимается за любые запросы, выполненные к источнику данных.

spec поля союза. Собственно спецификация. spec может быть только одним из следующих:
querySpec

object ( BigQueryQuerySpec )

BigQueryQuerySpec .

tableSpec

object ( BigQueryTableSpec )

Таблица BigQueryTableSpec .

BigQueryQuerySpec

Задает пользовательский запрос BigQuery.

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

string

Необработанная строка запроса.

BigQueryTableSpec

Указывает определение таблицы BigQuery. Разрешены только собственные таблицы .

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

string

Идентификатор проекта BigQuery, которому принадлежит таблица. Если не указано, предполагается projectId .

tableId

string

Идентификатор таблицы BigQuery.

datasetId

string

Идентификатор набора данных BigQuery.

DataSourceParameter

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

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

  // Union field identifier can be only one of the following:
  "name": string
  // End of list of possible types for union field identifier.

  // Union field value can be only one of the following:
  "namedRangeId": string,
  "range": {
    object (GridRange)
  }
  // End of list of possible types for union field value.
}
Поля
identifier поля объединения. Идентификатор параметра. identifier может быть только одним из следующих:
name

string

Именованный параметр. Должен быть допустимым идентификатором DataSource , который его поддерживает. Например, идентификатор BigQuery .

value поля объединения. Значение параметра. value может быть только одним из следующих:
namedRangeId

string

Идентификатор NamedRange . Его размер должен быть 1x1.

range

object ( GridRange )

Диапазон, содержащий значение параметра. Его размер должен быть 1x1.

Источник данныхRefreshSchedule

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

Источники данных в электронной таблице обновляются через определенный интервал времени. Вы можете указать время начала, нажав кнопку «Обновление по расписанию» в редакторе таблиц, но фиксированный интервал составляет 4 часа. Например, если вы укажете время начала 8:00, обновление будет происходить с 8:00 до 12:00 каждый день.

Представление JSON
{
  "enabled": boolean,
  "refreshScope": enum (DataSourceRefreshScope),
  "nextRun": {
    object (Interval)
  },

  // Union field schedule_config can be only one of the following:
  "dailySchedule": {
    object (DataSourceRefreshDailySchedule)
  },
  "weeklySchedule": {
    object (DataSourceRefreshWeeklySchedule)
  },
  "monthlySchedule": {
    object (DataSourceRefreshMonthlySchedule)
  }
  // End of list of possible types for union field schedule_config.
}
Поля
enabled

boolean

True, если расписание обновления включено, или false в противном случае.

refreshScope

enum ( DataSourceRefreshScope )

Объем обновления. Должен быть ALL_DATA_SOURCES .

nextRun

object ( Interval )

Только вывод. Временной интервал следующего запуска.

Объединение полей schedule_config . Конфигурации расписания schedule_config может быть только одним из следующих:
dailySchedule

object ( DataSourceRefreshDailySchedule )

Ежедневное расписание обновления.

weeklySchedule

object ( DataSourceRefreshWeeklySchedule )

Еженедельное расписание обновления.

monthlySchedule

object ( DataSourceRefreshMonthlySchedule )

Ежемесячный график обновления.

DataSourceRefreshScope

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

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

Источник данныхRefreshDailySchedule

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

Представление JSON
{
  "startTime": {
    object (TimeOfDay)
  }
}
Поля
startTime

object ( TimeOfDay )

Время начала временного интервала, на который запланировано обновление источника данных. Используется только hours часть. Размер временного интервала по умолчанию соответствует размеру в редакторе Таблиц.

время дня

Представляет время суток. Дата и часовой пояс либо не имеют значения, либо указаны в другом месте. API может разрешить дополнительные секунды. Связанными типами являются google.type.Date и google.protobuf.Timestamp .

Представление JSON
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
Поля
hours

integer

Часы суток в 24-часовом формате. Должно быть от 0 до 23. API может выбрать значение «24:00:00» для таких сценариев, как время закрытия предприятия.

minutes

integer

Минуты часа дня. Должно быть от 0 до 59.

seconds

integer

Секунды минут времени. Обычно должно быть от 0 до 59. API может разрешить значение 60, если он допускает дополнительные секунды.

nanos

integer

Доли секунд в наносекундах. Должно быть от 0 до 999 999 999.

Источник данныхRefreshWeeklySchedule

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

Представление JSON
{
  "startTime": {
    object (TimeOfDay)
  },
  "daysOfWeek": [
    enum (DayOfWeek)
  ]
}
Поля
startTime

object ( TimeOfDay )

Время начала временного интервала, на который запланировано обновление источника данных. Используется только hours часть. Размер временного интервала по умолчанию соответствует размеру в редакторе Таблиц.

daysOfWeek[]

enum ( DayOfWeek )

Дни недели для обновления. Необходимо указать хотя бы один день.

День недели

Представляет день недели.

перечисления
DAY_OF_WEEK_UNSPECIFIED День недели не указан.
MONDAY Понедельник
TUESDAY Вторник
WEDNESDAY Среда
THURSDAY Четверг
FRIDAY Пятница
SATURDAY Суббота
SUNDAY Воскресенье

DataSourceRefreshMonthlySchedule

Ежемесячное расписание обновления данных в определенные дни месяца в заданный интервал времени.

Представление JSON
{
  "startTime": {
    object (TimeOfDay)
  },
  "daysOfMonth": [
    integer
  ]
}
Поля
startTime

object ( TimeOfDay )

Время начала временного интервала, на который запланировано обновление источника данных. Используется только hours часть. Размер временного интервала по умолчанию соответствует размеру в редакторе Таблиц.

daysOfMonth[]

integer

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

Интервал

Представляет временной интервал, закодированный как начало временной метки (включительно) и окончание временной метки (исключая).

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

Представление JSON
{
  "startTime": string,
  "endTime": string
}
Поля
startTime

string ( Timestamp format)

Необязательный. включительно начало интервала.

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

endTime

string ( Timestamp format)

Необязательный. Эксклюзивное окончание интервала.

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

Методы

batchUpdate

Применяет одно или несколько обновлений к электронной таблице.

create

Создает электронную таблицу, возвращая только что созданную электронную таблицу.

get

Возвращает электронную таблицу с заданным идентификатором.

getByDataFilter

Возвращает электронную таблицу с заданным идентификатором.
,

Ресурс: электронная таблица

Ресурс, представляющий электронную таблицу.

Представление JSON
{
  "spreadsheetId": string,
  "properties": {
    object (SpreadsheetProperties)
  },
  "sheets": [
    {
      object (Sheet)
    }
  ],
  "namedRanges": [
    {
      object (NamedRange)
    }
  ],
  "spreadsheetUrl": string,
  "developerMetadata": [
    {
      object (DeveloperMetadata)
    }
  ],
  "dataSources": [
    {
      object (DataSource)
    }
  ],
  "dataSourceSchedules": [
    {
      object (DataSourceRefreshSchedule)
    }
  ]
}
Поля
spreadsheetId

string

Идентификатор электронной таблицы. Это поле доступно только для чтения.

properties

object ( SpreadsheetProperties )

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

sheets[]

object ( Sheet )

Листы, являющиеся частью электронной таблицы.

namedRanges[]

object ( NamedRange )

Именованные диапазоны, определенные в электронной таблице.

spreadsheetUrl

string

URL таблицы. Это поле доступно только для чтения.

developerMetadata[]

object ( DeveloperMetadata )

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

dataSources[]

object ( DataSource )

Список внешних источников данных, связанных с электронной таблицей.

dataSourceSchedules[]

object ( DataSourceRefreshSchedule )

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

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

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

Представление JSON
{
  "title": string,
  "locale": string,
  "autoRecalc": enum (RecalculationInterval),
  "timeZone": string,
  "defaultFormat": {
    object (CellFormat)
  },
  "iterativeCalculationSettings": {
    object (IterativeCalculationSettings)
  },
  "spreadsheetTheme": {
    object (SpreadsheetTheme)
  }
}
Поля
title

string

Название электронной таблицы.

locale

string

Языковой стандарт электронной таблицы в одном из следующих форматов:

  • код языка ISO 639-1, такой как en

  • код языка ISO 639-2, такой как fil , если код 639-1 не существует

  • комбинация кода языка ISO и кода страны, например en_US

Примечание: при обновлении этого поля поддерживаются не все локали/языки.

autoRecalc

enum ( RecalculationInterval )

Время ожидания перед пересчетом энергозависимых функций.

timeZone

string

Часовой пояс электронной таблицы в формате CLDR, например America/New_York . Если часовой пояс не распознается, это может быть пользовательский часовой пояс, например GMT-07:00 .

defaultFormat

object ( CellFormat )

Формат по умолчанию для всех ячеек электронной таблицы. CellData.effectiveFormat не будет установлен, если формат ячейки равен этому формату по умолчанию. Это поле доступно только для чтения.

iterativeCalculationSettings

object ( IterativeCalculationSettings )

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

spreadsheetTheme

object ( SpreadsheetTheme )

Тема применена к электронной таблице.

Интервал пересчета

Перечисление возможных вариантов интервала пересчета.

перечисления
RECALCULATION_INTERVAL_UNSPECIFIED Значение по умолчанию. Это значение не должно использоваться.
ON_CHANGE Неустойчивые функции обновляются при каждом изменении.
MINUTE Нестабильные функции обновляются при каждом изменении и каждую минуту.
HOUR Нестабильные функции обновляются при каждом изменении и ежечасно.

Параметры итеративного расчета

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

Представление JSON
{
  "maxIterations": integer,
  "convergenceThreshold": number
}
Поля
maxIterations

integer

Когда включен итеративный расчет, максимальное количество циклов расчета для выполнения.

convergenceThreshold

number

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

ТаблицаТема

Представляет тему электронной таблицы

Представление JSON
{
  "primaryFontFamily": string,
  "themeColors": [
    {
      object (ThemeColorPair)
    }
  ]
}
Поля
primaryFontFamily

string

Имя основного семейства шрифтов.

themeColors[]

object ( ThemeColorPair )

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

ТемаЦветПара

Пара, отображающая тип цвета темы электронной таблицы на конкретный цвет, который он представляет.

Представление JSON
{
  "colorType": enum (ThemeColorType),
  "color": {
    object (ColorStyle)
  }
}
Поля
colorType

enum ( ThemeColorType )

Тип цвета темы электронной таблицы.

color

object ( ColorStyle )

Конкретный цвет, соответствующий цветовому типу темы.

Именованный диапазон

Именованный диапазон.

Представление JSON
{
  "namedRangeId": string,
  "name": string,
  "range": {
    object (GridRange)
  }
}
Поля
namedRangeId

string

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

name

string

Имя именованного диапазона.

range

object ( GridRange )

Диапазон, который это представляет.

Источник данных

Информация о внешнем источнике данных в электронной таблице.

Представление JSON
{
  "dataSourceId": string,
  "spec": {
    object (DataSourceSpec)
  },
  "calculatedColumns": [
    {
      object (DataSourceColumn)
    }
  ],
  "sheetId": integer
}
Поля
dataSourceId

string

Уникальный идентификатор на уровне электронной таблицы, который идентифицирует источник данных. Пример: 1080547365.

spec

object ( DataSourceSpec )

DataSourceSpec для источника данных, связанного с этой электронной таблицей.

calculatedColumns[]

object ( DataSourceColumn )

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

sheetId

integer

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

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

Спецификация источника данных

Это указывает детали источника данных. Например, для BigQuery это указывает информацию об источнике BigQuery.

Представление JSON
{
  "parameters": [
    {
      object (DataSourceParameter)
    }
  ],

  // Union field spec can be only one of the following:
  "bigQuery": {
    object (BigQueryDataSourceSpec)
  }
  // End of list of possible types for union field spec.
}
Поля
parameters[]

object ( DataSourceParameter )

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

spec поля союза. Фактическая спецификация для каждого типа источника данных. spec может быть только одним из следующих:
bigQuery

object ( BigQueryDataSourceSpec )

BigQueryDataSourceSpec .

BigQueryDataSourceSpec

Спецификация источника данных BigQuery, подключенного к таблице.

Представление JSON
{
  "projectId": string,

  // Union field spec can be only one of the following:
  "querySpec": {
    object (BigQueryQuerySpec)
  },
  "tableSpec": {
    object (BigQueryTableSpec)
  }
  // End of list of possible types for union field spec.
}
Поля
projectId

string

Идентификатор проекта Google Cloud с поддержкой BigQuery, к которому подключен платежный аккаунт. Плата взимается за любые запросы, выполненные к источнику данных.

spec поля союза. Собственно спецификация. spec может быть только одним из следующих:
querySpec

object ( BigQueryQuerySpec )

BigQueryQuerySpec .

tableSpec

object ( BigQueryTableSpec )

Таблица BigQueryTableSpec .

BigQueryQuerySpec

Задает пользовательский запрос BigQuery.

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

string

Необработанная строка запроса.

BigQueryTableSpec

Указывает определение таблицы BigQuery. Разрешены только собственные таблицы .

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

string

Идентификатор проекта BigQuery, которому принадлежит таблица. Если не указано, предполагается projectId .

tableId

string

Идентификатор таблицы BigQuery.

datasetId

string

Идентификатор набора данных BigQuery.

DataSourceParameter

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

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

  // Union field identifier can be only one of the following:
  "name": string
  // End of list of possible types for union field identifier.

  // Union field value can be only one of the following:
  "namedRangeId": string,
  "range": {
    object (GridRange)
  }
  // End of list of possible types for union field value.
}
Поля
identifier поля объединения. Идентификатор параметра. identifier может быть только одним из следующих:
name

string

Именованный параметр. Должен быть допустимым идентификатором DataSource , который его поддерживает. Например, идентификатор BigQuery .

value поля объединения. Значение параметра. value может быть только одним из следующих:
namedRangeId

string

Идентификатор NamedRange . Его размер должен быть 1x1.

range

object ( GridRange )

Диапазон, содержащий значение параметра. Его размер должен быть 1x1.

Источник данныхRefreshSchedule

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

Источники данных в электронной таблице обновляются через определенный интервал времени. Вы можете указать время начала, нажав кнопку «Обновление по расписанию» в редакторе таблиц, но фиксированный интервал составляет 4 часа. Например, если вы укажете время начала 8:00, обновление будет происходить с 8:00 до 12:00 каждый день.

Представление JSON
{
  "enabled": boolean,
  "refreshScope": enum (DataSourceRefreshScope),
  "nextRun": {
    object (Interval)
  },

  // Union field schedule_config can be only one of the following:
  "dailySchedule": {
    object (DataSourceRefreshDailySchedule)
  },
  "weeklySchedule": {
    object (DataSourceRefreshWeeklySchedule)
  },
  "monthlySchedule": {
    object (DataSourceRefreshMonthlySchedule)
  }
  // End of list of possible types for union field schedule_config.
}
Поля
enabled

boolean

True, если расписание обновления включено, или false в противном случае.

refreshScope

enum ( DataSourceRefreshScope )

Объем обновления. Должен быть ALL_DATA_SOURCES .

nextRun

object ( Interval )

Только вывод. Временной интервал следующего запуска.

Объединение полей schedule_config . Конфигурации расписания schedule_config может быть только одним из следующих:
dailySchedule

object ( DataSourceRefreshDailySchedule )

Ежедневное расписание обновления.

weeklySchedule

object ( DataSourceRefreshWeeklySchedule )

Еженедельное расписание обновления.

monthlySchedule

object ( DataSourceRefreshMonthlySchedule )

Ежемесячный график обновления.

DataSourceRefreshScope

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

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

Источник данныхRefreshDailySchedule

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

Представление JSON
{
  "startTime": {
    object (TimeOfDay)
  }
}
Поля
startTime

object ( TimeOfDay )

Время начала временного интервала, на который запланировано обновление источника данных. Используется только hours часть. Размер временного интервала по умолчанию соответствует размеру в редакторе Таблиц.

время дня

Представляет время суток. Дата и часовой пояс либо не имеют значения, либо указаны в другом месте. API может разрешить дополнительные секунды. Связанными типами являются google.type.Date и google.protobuf.Timestamp .

Представление JSON
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
Поля
hours

integer

Часы суток в 24-часовом формате. Должно быть от 0 до 23. API может выбрать значение «24:00:00» для таких сценариев, как время закрытия предприятия.

minutes

integer

Минуты часа дня. Должно быть от 0 до 59.

seconds

integer

Секунды минут времени. Обычно должно быть от 0 до 59. API может разрешить значение 60, если он допускает дополнительные секунды.

nanos

integer

Доли секунд в наносекундах. Должно быть от 0 до 999 999 999.

Источник данныхRefreshWeeklySchedule

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

Представление JSON
{
  "startTime": {
    object (TimeOfDay)
  },
  "daysOfWeek": [
    enum (DayOfWeek)
  ]
}
Поля
startTime

object ( TimeOfDay )

Время начала временного интервала, на который запланировано обновление источника данных. Используется только hours часть. Размер временного интервала по умолчанию соответствует размеру в редакторе Таблиц.

daysOfWeek[]

enum ( DayOfWeek )

Дни недели для обновления. Необходимо указать хотя бы один день.

День недели

Представляет день недели.

перечисления
DAY_OF_WEEK_UNSPECIFIED День недели не указан.
MONDAY Понедельник
TUESDAY Вторник
WEDNESDAY Среда
THURSDAY Четверг
FRIDAY Пятница
SATURDAY Суббота
SUNDAY Воскресенье

DataSourceRefreshMonthlySchedule

Ежемесячное расписание обновления данных в определенные дни месяца в заданный интервал времени.

Представление JSON
{
  "startTime": {
    object (TimeOfDay)
  },
  "daysOfMonth": [
    integer
  ]
}
Поля
startTime

object ( TimeOfDay )

Время начала временного интервала, на который запланировано обновление источника данных. Используется только hours часть. Размер временного интервала по умолчанию соответствует размеру в редакторе Таблиц.

daysOfMonth[]

integer

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

Интервал

Представляет временной интервал, закодированный как начало временной метки (включительно) и окончание временной метки (исключая).

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

Представление JSON
{
  "startTime": string,
  "endTime": string
}
Поля
startTime

string ( Timestamp format)

Необязательный. включительно начало интервала.

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

endTime

string ( Timestamp format)

Необязательный. Эксклюзивное окончание интервала.

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

Методы

batchUpdate

Применяет одно или несколько обновлений к электронной таблице.

create

Создает электронную таблицу, возвращая только что созданную электронную таблицу.

get

Возвращает электронную таблицу с заданным идентификатором.

getByDataFilter

Возвращает электронную таблицу с заданным идентификатором.