REST Resource: spreadsheets

Recurso: Hoja de cálculo

Recurso que representa una hoja de cálculo.

Representación JSON
{
  "spreadsheetId": string,
  "properties": {
    object (SpreadsheetProperties)
  },
  "sheets": [
    {
      object (Sheet)
    }
  ],
  "namedRanges": [
    {
      object (NamedRange)
    }
  ],
  "spreadsheetUrl": string,
  "developerMetadata": [
    {
      object (DeveloperMetadata)
    }
  ],
  "dataSources": [
    {
      object (DataSource)
    }
  ],
  "dataSourceSchedules": [
    {
      object (DataSourceRefreshSchedule)
    }
  ]
}
Campos
spreadsheetId

string

El ID de la hoja de cálculo. Este campo es de solo lectura.

properties

object (SpreadsheetProperties)

Propiedades generales de una hoja de cálculo

sheets[]

object (Sheet)

Son las hojas que forman parte de una hoja de cálculo.

namedRanges[]

object (NamedRange)

Los rangos con nombre definidos en una hoja de cálculo.

spreadsheetUrl

string

Es la URL de la hoja de cálculo. Este campo es de solo lectura.

developerMetadata[]

object (DeveloperMetadata)

Los metadatos del desarrollador asociados con una hoja de cálculo.

dataSources[]

object (DataSource)

Una lista de fuentes de datos externas conectadas con la hoja de cálculo.

dataSourceSchedules[]

object (DataSourceRefreshSchedule)

Solo salida. Una lista de programaciones de actualización de fuentes de datos.

SpreadsheetProperties

Propiedades de una hoja de cálculo.

Representación JSON
{
  "title": string,
  "locale": string,
  "autoRecalc": enum (RecalculationInterval),
  "timeZone": string,
  "defaultFormat": {
    object (CellFormat)
  },
  "iterativeCalculationSettings": {
    object (IterativeCalculationSettings)
  },
  "spreadsheetTheme": {
    object (SpreadsheetTheme)
  },
  "importFunctionsExternalUrlAccessAllowed": boolean
}
Campos
title

string

Es el título de la hoja de cálculo.

locale

string

Es la configuración regional de la hoja de cálculo en uno de los siguientes formatos:

  • un código de idioma ISO 639-1, como en

  • un código de idioma ISO 639-2, como fil, si no existe un código de idioma 639-1

  • una combinación del código de idioma ISO y el código de país, como en_US

Nota: Cuando actualizas este campo, no se admiten todas las configuraciones regionales o los idiomas.

autoRecalc

enum (RecalculationInterval)

La cantidad de tiempo que se debe esperar antes de que se vuelvan a calcular las funciones volátiles.

timeZone

string

La zona horaria de la hoja de cálculo, en formato CLDR como America/New_York. Si no se reconoce la zona horaria, es posible que se trate de una zona horaria personalizada, como GMT-07:00.

defaultFormat

object (CellFormat)

Es el formato predeterminado de todas las celdas de la hoja de cálculo. No se establecerá CellData.effectiveFormat si el formato de la celda es igual a este formato predeterminado. Este campo es de solo lectura.

iterativeCalculationSettings

object (IterativeCalculationSettings)

Determina si las referencias circulares se resuelven y cómo se resuelven con un cálculo iterativo. La ausencia de este campo indica que las referencias circulares generan errores de cálculo.

spreadsheetTheme

object (SpreadsheetTheme)

Es el tema aplicado a la hoja de cálculo.

importFunctionsExternalUrlAccessAllowed

boolean

Indica si se debe permitir el acceso a URL externas para las funciones de importación y imágenes. Solo lectura cuando es verdadero. Cuando es falso, puedes configurarlo como verdadero.

RecalculationInterval

Una enumeración de las opciones posibles para el intervalo de recalcular.

Enumeradores
RECALCULATION_INTERVAL_UNSPECIFIED Valor predeterminado No se debe usar este valor.
ON_CHANGE Las funciones volátiles se actualizan con cada cambio.
MINUTE Las funciones volátiles se actualizan con cada cambio y cada minuto.
HOUR Las funciones volátiles se actualizan con cada cambio y cada hora.

IterativeCalculationSettings

Configuración para controlar cómo se resuelven las dependencias circulares con un cálculo iterativo.

Representación JSON
{
  "maxIterations": integer,
  "convergenceThreshold": number
}
Campos
maxIterations

integer

Cuando el cálculo iterativo está habilitado, la cantidad máxima de rondas de cálculo que se realizarán.

convergenceThreshold

number

Cuando el cálculo iterativo está habilitado y los resultados sucesivos difieren en menos que este valor límite, el cálculo se detiene.

SpreadsheetTheme

Representa el tema de la hoja de cálculo

Representación JSON
{
  "primaryFontFamily": string,
  "themeColors": [
    {
      object (ThemeColorPair)
    }
  ]
}
Campos
primaryFontFamily

string

Nombre de la familia de fuentes principal

themeColors[]

object (ThemeColorPair)

Los pares de colores del tema de la hoja de cálculo. Para realizar la actualización, debes proporcionar todos los pares de colores de tema.

ThemeColorPair

Un par que asigna un tipo de color de tema de hoja de cálculo al color concreto que representa.

Representación JSON
{
  "colorType": enum (ThemeColorType),
  "color": {
    object (ColorStyle)
  }
}
Campos
colorType

enum (ThemeColorType)

Es el tipo de color del tema de la hoja de cálculo.

color

object (ColorStyle)

El color concreto correspondiente al tipo de color del tema.

NamedRange

Un rango con nombre

Representación JSON
{
  "namedRangeId": string,
  "name": string,
  "range": {
    object (GridRange)
  }
}
Campos
namedRangeId

string

El ID del rango con nombre.

name

string

El nombre del rango con nombre.

range

object (GridRange)

Rango que esto representa.

DataSource

Información sobre una fuente de datos externa en la hoja de cálculo.

Representación JSON
{
  "dataSourceId": string,
  "spec": {
    object (DataSourceSpec)
  },
  "calculatedColumns": [
    {
      object (DataSourceColumn)
    }
  ],
  "sheetId": integer
}
Campos
dataSourceId

string

Es el ID único en el ámbito de la hoja de cálculo que identifica la fuente de datos. Ejemplo: 1080547365.

spec

object (DataSourceSpec)

Es el DataSourceSpec de la fuente de datos conectada con esta hoja de cálculo.

calculatedColumns[]

object (DataSourceColumn)

Todas las columnas calculadas en la fuente de datos.

sheetId

integer

El ID de la Sheet conectada con la fuente de datos. Una vez que se definió el campo, no se puede cambiar.

Al crear una fuente de datos, también se crea una hoja DATA_SOURCE asociada. Si no se especifica el campo, el ID de la hoja creada se generará de forma aleatoria.

DataSourceSpec

Esto especifica los detalles de la fuente de datos. Por ejemplo, en el caso de BigQuery, esto especifica información sobre la fuente de BigQuery.

Representación 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.
}
Campos
parameters[]

object (DataSourceParameter)

Los parámetros de la fuente de datos, que se usan cuando se consulta la fuente de datos.

Campo de unión spec. La especificación real por tipo de fuente de datos. Las direcciones (spec) solo pueden ser una de las siguientes opciones:
bigQuery

object (BigQueryDataSourceSpec)

Un objeto BigQueryDataSourceSpec.

BigQueryDataSourceSpec

Es la especificación de una fuente de datos de BigQuery que está conectada a una hoja de cálculo.

Representación 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.
}
Campos
projectId

string

El ID de un proyecto de Google Cloud habilitado para BigQuery con una cuenta de facturación vinculada. Se cobra el proyecto por cualquier consulta ejecutada en la fuente de datos.

Campo de unión spec. Es la especificación real. Las direcciones (spec) solo pueden ser una de las siguientes opciones:
querySpec

object (BigQueryQuerySpec)

Un objeto BigQueryQuerySpec.

tableSpec

object (BigQueryTableSpec)

Un objeto BigQueryTableSpec.

BigQueryQuerySpec

Especifica una consulta personalizada de BigQuery.

Representación JSON
{
  "rawQuery": string
}
Campos
rawQuery

string

la cadena de consulta sin procesar.

BigQueryTableSpec

Especifica una definición de tabla de BigQuery. Solo se permiten las tablas nativas.

Representación JSON
{
  "tableProjectId": string,
  "tableId": string,
  "datasetId": string
}
Campos
tableProjectId

string

El ID de un proyecto de BigQuery al que pertenece la tabla. Si no se especifica, se supone que es projectId.

tableId

string

El ID de la tabla de BigQuery.

datasetId

string

El ID del conjunto de datos de BigQuery.

DataSourceParameter

Un parámetro en una consulta de la fuente de datos. El parámetro permite al usuario pasar valores de la hoja de cálculo a una consulta.

Representación 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.
}
Campos
Campo de unión identifier. Es el identificador del parámetro. Las direcciones (identifier) solo pueden ser una de las siguientes opciones:
name

string

Parámetro con nombre. Debe ser un identificador legítimo para la DataSource que lo admite. Por ejemplo, el identificador de BigQuery.

Campo de unión value. Es el valor del parámetro. Las direcciones (value) solo pueden ser una de las siguientes opciones:
namedRangeId

string

ID de un NamedRange. Su tamaño debe ser 1 x 1.

range

object (GridRange)

Un rango que contiene el valor del parámetro. Su tamaño debe ser 1 x 1.

DataSourceRefreshSchedule

Programa la actualización de la fuente de datos.

Las fuentes de datos de la hoja de cálculo se actualizan dentro de un intervalo de tiempo. Para especificar la hora de inicio, haz clic en el botón Actualización programada del editor de Hojas de cálculo, pero el intervalo es fijo de 4 horas. Por ejemplo, si especificas la hora de inicio a las 8 a.m., la actualización se llevará a cabo todos los días entre las 8 a.m. y las 12 p.m.

Representación 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.
}
Campos
enabled

boolean

Verdadero si el programa de actualización está habilitado o falso de lo contrario.

refreshScope

enum (DataSourceRefreshScope)

El alcance de la actualización. Debe ser ALL_DATA_SOURCES.

nextRun

object (Interval)

Solo salida. El intervalo de tiempo de la siguiente ejecución.

Campo de unión schedule_config. Las configuraciones de programa schedule_config pueden ser solo una de las siguientes opciones:
dailySchedule

object (DataSourceRefreshDailySchedule)

Programa de actualización diaria.

weeklySchedule

object (DataSourceRefreshWeeklySchedule)

Programa de actualización semanal.

monthlySchedule

object (DataSourceRefreshMonthlySchedule)

Programa de actualización mensual.

DataSourceRefreshScope

Los permisos de actualización de la fuente de datos

Enumeradores
DATA_SOURCE_REFRESH_SCOPE_UNSPECIFIED Valor predeterminado, no usar.
ALL_DATA_SOURCES Actualiza todas las fuentes de datos y sus objetos de fuente de datos asociados en la hoja de cálculo.

DataSourceRefreshDailySchedule

Es un programa para que los datos se actualicen todos los días en un intervalo de tiempo determinado.

Representación JSON
{
  "startTime": {
    object (TimeOfDay)
  }
}
Campos
startTime

object (TimeOfDay)

Es la hora de inicio de un intervalo en el que se programa una actualización de la fuente de datos. Solo se usa la parte hours. El tamaño del intervalo de tiempo se establece de forma predeterminada en el del editor de Hojas de cálculo.

TimeOfDay

Representa una hora del día. La fecha y la zona horaria no son significativas o se especifican en otro lugar. Una API puede optar por permitir segundos bisiestos. Los tipos relacionados son google.type.Date y google.protobuf.Timestamp.

Representación JSON
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
Campos
hours

integer

Horas del día en formato de 24 horas. Debe ser del 0 al 23. Una API puede permitir el valor “24:00:00” para casos como el horario de cierre de empresas.

minutes

integer

Minutos de horas del día. Debe ser un valor entre 0 y 59.

seconds

integer

Segundos de minutos de la hora. Por lo general, debe ser un valor entre 0 y 59. Una API puede permitir el valor 60 si permite segundos bisiestos.

nanos

integer

Fracciones de segundos en nanosegundos. Debe ser un valor entre 0 y 999,999,999.

DataSourceRefreshWeeklySchedule

Una programación semanal para que los datos se actualicen en días específicos y en un intervalo de tiempo determinado.

Representación JSON
{
  "startTime": {
    object (TimeOfDay)
  },
  "daysOfWeek": [
    enum (DayOfWeek)
  ]
}
Campos
startTime

object (TimeOfDay)

Es la hora de inicio de un intervalo en el que se programa una actualización de la fuente de datos. Solo se usa la parte hours. El tamaño del intervalo de tiempo se establece de forma predeterminada en el del editor de Hojas de cálculo.

daysOfWeek[]

enum (DayOfWeek)

Días de la semana para actualizar Se debe especificar al menos un día.

DayOfWeek

Representa un día de la semana.

Enumeradores
DAY_OF_WEEK_UNSPECIFIED No se especifica el día de la semana.
MONDAY Lunes
TUESDAY Martes
WEDNESDAY Miércoles
THURSDAY Jueves
FRIDAY Viernes
SATURDAY Sábado
SUNDAY Domingo

DataSourceRefreshMonthlySchedule

Es una programación mensual para que los datos se actualicen en días específicos del mes dentro de un intervalo de tiempo determinado.

Representación JSON
{
  "startTime": {
    object (TimeOfDay)
  },
  "daysOfMonth": [
    integer
  ]
}
Campos
startTime

object (TimeOfDay)

Es la hora de inicio de un intervalo en el que se programa una actualización de la fuente de datos. Solo se usa la parte hours. El tamaño del intervalo de tiempo se establece de forma predeterminada en el del editor de Hojas de cálculo.

daysOfMonth[]

integer

Días del mes en que se actualizará Solo se admiten los números del 1 al 28, que se asignan del día 1 al 28. Se debe especificar al menos un día.

Intervalo

Representa un intervalo de tiempo, codificado como un inicio con marca de tiempo (inclusive) y un final con marca de tiempo (exclusivo).

El inicio debe ser menor o igual que el final. Cuando el inicio es igual al final, el intervalo está vacío (no coincide con ningún tiempo). Si no se especifican el inicio ni el final, el intervalo coincidirá en cualquier momento.

Representación JSON
{
  "startTime": string,
  "endTime": string
}
Campos
startTime

string (Timestamp format)

Opcional. Inicio inclusivo del intervalo.

Si se especifica, una marca de tiempo que coincida con este intervalo deberá ser la misma o posterior al inicio.

endTime

string (Timestamp format)

Opcional. Final exclusivo del intervalo.

Si se especifica, una marca de tiempo que coincida con este intervalo deberá ser anterior al final.

Métodos

batchUpdate

Aplica una o más actualizaciones a la hoja de cálculo.

create

Crea una hoja de cálculo y muestra la hoja de cálculo recién creada.

get

Muestra la hoja de cálculo con el ID determinado.

getByDataFilter

Muestra la hoja de cálculo con el ID determinado.