REST Resource: spreadsheets

Risorsa: foglio di lavoro

Risorsa che rappresenta un foglio di lavoro.

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

string

L'ID del foglio di lavoro. Questo campo è di sola lettura.

properties

object (SpreadsheetProperties)

Proprietà generali di un foglio di lavoro.

sheets[]

object (Sheet)

I fogli che fanno parte di un foglio di lavoro.

namedRanges[]

object (NamedRange)

Gli intervalli denominati definiti in un foglio di lavoro.

spreadsheetUrl

string

L'URL del foglio di lavoro. Questo campo è di sola lettura.

developerMetadata[]

object (DeveloperMetadata)

I metadati dello sviluppatore associati a un foglio di lavoro.

dataSources[]

object (DataSource)

Un elenco di origini dati esterne collegate al foglio di lavoro.

dataSourceSchedules[]

object (DataSourceRefreshSchedule)

Solo output. Un elenco di pianificazioni di aggiornamento dell'origine dati.

SpreadsheetProperties

Proprietà di un foglio di lavoro.

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

string

Il titolo del foglio di lavoro.

locale

string

Le impostazioni internazionali del foglio di lavoro in uno dei seguenti formati:

  • Un codice lingua ISO 639-1 come en

  • Un codice lingua ISO 639-2 come fil, se non esiste un codice 639-1

  • una combinazione del codice lingua ISO e del codice paese, ad esempio en_US

Nota: quando aggiorni questo campo, non sono supportate tutte le lingue o tutti i paesi.

autoRecalc

enum (RecalculationInterval)

Il tempo di attesa prima che le funzioni volatili vengano ricalcolate.

timeZone

string

Il fuso orario del foglio di lavoro, in formato CLDR, ad esempio America/New_York. Se il fuso orario non viene riconosciuto, potrebbe essere un fuso orario personalizzato, ad esempio GMT-07:00.

defaultFormat

object (CellFormat)

Il formato predefinito di tutte le celle nel foglio di lavoro. CellData.effectiveFormat non verrà impostato se il formato della cella è uguale a questo formato predefinito. Questo campo è di sola lettura.

iterativeCalculationSettings

object (IterativeCalculationSettings)

Determina se e come i riferimenti circolari vengono risolti con un calcolo iterativo. L'assenza di questo campo significa che i riferimenti circolari comportano errori di calcolo.

spreadsheetTheme

object (SpreadsheetTheme)

Tema applicato al foglio di lavoro.

importFunctionsExternalUrlAccessAllowed

boolean

Indica se consentire l'accesso all'URL esterno per le funzioni di immagine e importazione. Leggi solo se true. Se il valore è false, puoi impostarlo su true.

RecalculationInterval

Un'enumerazione delle possibili opzioni di intervallo di ricalcolo.

Enum
RECALCULATION_INTERVAL_UNSPECIFIED Valore predefinito. Questo valore non deve essere utilizzato.
ON_CHANGE Le funzioni volatili vengono aggiornate a ogni modifica.
MINUTE Le funzioni volatili vengono aggiornate a ogni modifica e ogni minuto.
HOUR Le funzioni volatili vengono aggiornate a ogni variazione e ogni ora.

IterativeCalculationSettings

Impostazioni per controllare il modo in cui le dipendenze circolari vengono risolte con calcoli iterativi.

Rappresentazione JSON
{
  "maxIterations": integer,
  "convergenceThreshold": number
}
Campi
maxIterations

integer

Quando è abilitato il calcolo iterativo, il numero massimo di arrotondamenti di calcolo da eseguire.

convergenceThreshold

number

Quando il calcolo iterativo è attivato e i risultati successivi differiscono di meno di questo valore di soglia, l'arrotondamento del calcolo viene interrotto.

SpreadsheetTheme

Rappresenta il tema del foglio di lavoro

Rappresentazione JSON
{
  "primaryFontFamily": string,
  "themeColors": [
    {
      object (ThemeColorPair)
    }
  ]
}
Campi
primaryFontFamily

string

Nome della famiglia di caratteri principale.

themeColors[]

object (ThemeColorPair)

Le coppie di colori del tema del foglio di lavoro. Per eseguire l'aggiornamento, devi fornire tutte le coppie di colori del tema.

ThemeColorPair

Una coppia che mappa il tipo di colore di un tema del foglio di lavoro al colore di cemento che rappresenta.

Rappresentazione JSON
{
  "colorType": enum (ThemeColorType),
  "color": {
    object (ColorStyle)
  }
}
Campi
colorType

enum (ThemeColorType)

Il tipo di colore del tema del foglio di lavoro.

color

object (ColorStyle)

Il colore cemento corrispondente al tipo di colore del tema.

NamedRange

Un intervallo denominato.

Rappresentazione JSON
{
  "namedRangeId": string,
  "name": string,
  "range": {
    object (GridRange)
  }
}
Campi
namedRangeId

string

L'ID dell'intervallo denominato.

name

string

Il nome dell'intervallo denominato.

range

object (GridRange)

L'intervallo che rappresenta.

Origine dati

Informazioni su un'origine dati esterna nel foglio di lavoro.

Rappresentazione JSON
{
  "dataSourceId": string,
  "spec": {
    object (DataSourceSpec)
  },
  "calculatedColumns": [
    {
      object (DataSourceColumn)
    }
  ],
  "sheetId": integer
}
Campi
dataSourceId

string

L'ID univoco basato sul foglio di lavoro che identifica l'origine dati. Esempio: 1080547365.

spec

object (DataSourceSpec)

DataSourceSpec per l'origine dati collegata a questo foglio di lavoro.

calculatedColumns[]

object (DataSourceColumn)

Tutte le colonne calcolate nell'origine dati.

sheetId

integer

L'ID di Sheet connesso all'origine dati. Una volta impostato, il campo non può essere modificato.

Quando crei un'origine dati, viene creato anche un foglio DATA_SOURCE associato. Se il campo non viene specificato, l'ID del foglio creato verrà generato in modo casuale.

DataSourceSpec

Specifica i dettagli dell'origine dati. Ad esempio, per BigQuery, specifica informazioni sull'origine BigQuery.

Rappresentazione JSON
{
  "parameters": [
    {
      object (DataSourceParameter)
    }
  ],

  // Union field spec can be only one of the following:
  "bigQuery": {
    object (BigQueryDataSourceSpec)
  },
  "looker": {
    object (LookerDataSourceSpec)
  }
  // End of list of possible types for union field spec.
}
Campi
parameters[]

object (DataSourceParameter)

I parametri dell'origine dati, utilizzati per eseguire query sull'origine dati.

Campo unione spec. La specifica effettiva per tipo di origine dati. spec può essere solo uno dei seguenti:
bigQuery

object (BigQueryDataSourceSpec)

Un BigQueryDataSourceSpec.

looker

object (LookerDataSourceSpec)

Un LookerDataSourceSpec.

BigQueryDataSourceSpec

La specifica di un'origine dati BigQuery collegata a un foglio.

Rappresentazione 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.
}
Campi
projectId

string

L'ID di un progetto Google Cloud abilitato per BigQuery a cui è collegato un account di fatturazione. Il progetto viene addebitato per eventuali query eseguite sull'origine dati.

Campo unione spec. La specifica effettiva. spec può essere solo uno dei seguenti:
querySpec

object (BigQueryQuerySpec)

Un BigQueryQuerySpec.

tableSpec

object (BigQueryTableSpec)

Un BigQueryTableSpec.

BigQueryQuerySpec

Specifica una query BigQuery personalizzata.

Rappresentazione JSON
{
  "rawQuery": string
}
Campi
rawQuery

string

La stringa di query non elaborata.

BigQueryTableSpec

Specifica una definizione di tabella BigQuery. Sono consentite solo tabelle native.

Rappresentazione JSON
{
  "tableProjectId": string,
  "tableId": string,
  "datasetId": string
}
Campi
tableProjectId

string

L'ID di un progetto BigQuery a cui appartiene la tabella. Se non specificato, si presume il valore projectId.

tableId

string

L'ID della tabella BigQuery.

datasetId

string

L'ID del set di dati BigQuery.

LookerDataSourceSpec

La specifica di un'origine dati di Looker.

Rappresentazione JSON
{
  "instanceUri": string,
  "model": string,
  "explore": string
}
Campi
instanceUri

string

L'URL di un'istanza di Looker.

model

string

Nome di un modello Looker.

explore

string

Nome dell'esplorazione di un modello Looker.

DataSourceParameter

Un parametro nella query di un'origine dati. Il parametro consente all'utente di trasferire i valori del foglio di lavoro in una query.

Rappresentazione 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.
}
Campi
Campo unione identifier. L'identificatore del parametro. identifier può essere solo uno dei seguenti:
name

string

Parametro denominato. Deve essere un identificatore legittimo per il DataSource che lo supporta. Ad esempio, identificatore BigQuery.

Campo unione value. Il valore del parametro. value può essere solo uno dei seguenti:
namedRangeId

string

ID di NamedRange. Le sue dimensioni devono essere 1 x 1.

range

object (GridRange)

Un intervallo che contiene il valore del parametro. La sua dimensione deve essere 1 x 1.

DataSourceRefreshSchedule

Pianifica l'aggiornamento dell'origine dati.

Le origini dati nel foglio di lavoro vengono aggiornate entro un intervallo di tempo. Puoi specificare l'ora di inizio facendo clic sul pulsante Aggiornamento pianificato nell'editor di Fogli, ma l'intervallo è fisso su 4 ore. Ad esempio, se specifichi come ora di inizio le 8:00 , l'aggiornamento verrà eseguito ogni giorno tra le 8:00 e le 12:00.

Rappresentazione 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.
}
Campi
enabled

boolean

True se la pianificazione dell'aggiornamento è abilitata o false in caso contrario.

refreshScope

enum (DataSourceRefreshScope)

L'ambito dell'aggiornamento. Deve essere ALL_DATA_SOURCES.

nextRun

object (Interval)

Solo output. L'intervallo di tempo della prossima esecuzione.

Campo unione schedule_config. Le configurazioni di pianificazione schedule_config possono essere solo una delle seguenti:
dailySchedule

object (DataSourceRefreshDailySchedule)

Programma dell'aggiornamento giornaliero.

weeklySchedule

object (DataSourceRefreshWeeklySchedule)

Pianificazione dell'aggiornamento settimanale.

monthlySchedule

object (DataSourceRefreshMonthlySchedule)

Pianificazione dell'aggiornamento mensile.

DataSourceRefreshScope

Gli ambiti di aggiornamento dell'origine dati.

Enum
DATA_SOURCE_REFRESH_SCOPE_UNSPECIFIED Valore predefinito, non utilizzare.
ALL_DATA_SOURCES Aggiorna tutte le origini dati e i relativi oggetti associati nel foglio di lavoro.

DataSourceRefreshDailySchedule

Una pianificazione dell'aggiornamento dei dati ogni giorno in un determinato intervallo di tempo.

Rappresentazione JSON
{
  "startTime": {
    object (TimeOfDay)
  }
}
Campi
startTime

object (TimeOfDay)

L'ora di inizio di un intervallo di tempo in cui è pianificato un aggiornamento dell'origine dati. Viene utilizzata solo la parte hours. La dimensione predefinita dell'intervallo di tempo è quella nell'editor di Fogli.

TimeOfDay

Rappresenta un'ora del giorno. La data e il fuso orario non sono significativi o sono specificati altrove. Un'API può scegliere di consentire i secondi intercalari. I tipi correlati sono google.type.Date e google.protobuf.Timestamp.

Rappresentazione JSON
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
Campi
hours

integer

Le ore del giorno nel formato 24 ore. Deve essere compreso tra 0 e 23. Un'API può scegliere di consentire il valore "24:00:00" per scenari come l'orario di chiusura dell'attività.

minutes

integer

Minuti dell'ora del giorno. Il valore deve essere compreso tra 0 e 59.

seconds

integer

Secondi di minuti del tempo. Normalmente deve essere compreso tra 0 e 59. Un'API potrebbe consentire il valore 60 se consente i secondi intercalari.

nanos

integer

Frazioni di secondi in nanosecondi. Deve essere compreso tra 0 e 999.999.999.

DataSourceRefreshWeeklySchedule

Una pianificazione settimanale dell'aggiornamento dei dati in giorni specifici in un determinato intervallo di tempo.

Rappresentazione JSON
{
  "startTime": {
    object (TimeOfDay)
  },
  "daysOfWeek": [
    enum (DayOfWeek)
  ]
}
Campi
startTime

object (TimeOfDay)

L'ora di inizio di un intervallo di tempo in cui è pianificato un aggiornamento dell'origine dati. Viene utilizzata solo la parte hours. La dimensione predefinita dell'intervallo di tempo è quella nell'editor di Fogli.

daysOfWeek[]

enum (DayOfWeek)

Giorni della settimana da aggiornare. È necessario specificare almeno un giorno.

DayOfWeek

Rappresenta un giorno della settimana.

Enum
DAY_OF_WEEK_UNSPECIFIED Il giorno della settimana non è specificato.
MONDAY Lunedì
TUESDAY Martedì
WEDNESDAY Mercoledì
THURSDAY Giovedì
FRIDAY Venerdì
SATURDAY Sabato
SUNDAY Domenica

DataSourceRefreshMonthlySchedule

Pianificazione mensile dell'aggiornamento dei dati in giorni specifici del mese in un determinato intervallo di tempo.

Rappresentazione JSON
{
  "startTime": {
    object (TimeOfDay)
  },
  "daysOfMonth": [
    integer
  ]
}
Campi
startTime

object (TimeOfDay)

L'ora di inizio di un intervallo di tempo in cui è pianificato l'aggiornamento di un'origine dati. Viene utilizzata solo la parte hours. La dimensione predefinita dell'intervallo di tempo è quella nell'editor di Fogli.

daysOfMonth[]

integer

Giorni del mese da aggiornare. ne sono supportati solo i valori da 1 a 28, con la mappatura dal 1° al 28° giorno. È necessario specificare almeno un giorno.

Intervallo

Rappresenta un intervallo di tempo, codificato come inizio timestamp (incluso) e fine timestamp (escluso).

L'inizio deve essere inferiore o uguale alla fine. Quando l'inizio corrisponde alla fine, l'intervallo è vuoto (non corrisponde a un orario). Quando non sono specificati entrambi i valori, l'intervallo può corrispondere a qualsiasi momento.

Rappresentazione JSON
{
  "startTime": string,
  "endTime": string
}
Campi
startTime

string (Timestamp format)

(Facoltativo) Inizio inclusivo dell'intervallo.

Se specificato, un timestamp corrispondente a questo intervallo dovrà essere uguale o successivo all'inizio.

endTime

string (Timestamp format)

(Facoltativo) Fine dell'intervallo.

Se specificato, un timestamp corrispondente a questo intervallo dovrà essere precedente alla fine.

Metodi

batchUpdate

Applica uno o più aggiornamenti al foglio di lavoro.

create

Crea un foglio di lavoro, restituendo quello appena creato.

get

Restituisce il foglio di lavoro nell'ID specificato.

getByDataFilter

Restituisce il foglio di lavoro nell'ID specificato.