Foglio
Un foglio di un foglio di lavoro.
Rappresentazione JSON |
---|
{ "properties": { object ( |
Campi | |
---|---|
properties
|
Le proprietà del foglio. |
data[]
|
Dati nella griglia, se si tratta di un foglio a griglia.
Il numero di oggetti GridData restituiti dipende dal numero di intervalli richiesti in questo foglio. Ad esempio, se rappresenta
Per un foglio
|
merges[]
|
Gli intervalli che vengono uniti. |
conditionalFormats[]
|
Le regole di formattazione condizionale in questo foglio. |
filterViews[]
|
Le visualizzazioni dei filtri in questo foglio. |
protectedRanges[]
|
Gli intervalli protetti in questo foglio. |
basicFilter
|
Il filtro in questo foglio, se presente. |
charts[]
|
Le specifiche di ogni grafico in questo foglio. |
bandedRanges[]
|
Gli intervalli a bande (colori alternati) in questo foglio. |
developerMetadata[]
|
I metadati dello sviluppatore associati a un foglio. |
rowGroups[]
|
Tutti i gruppi di righe in questo foglio, ordinati per indice iniziale dell'intervallo crescente e poi per profondità del gruppo. |
columnGroups[]
|
Tutti i gruppi di colonne di questo foglio, ordinati in base all'indice di inizio dell'intervallo crescente e poi in base alla profondità del gruppo. |
slicers[]
|
Gli slicer in questo foglio. |
SheetProperties
Proprietà di un foglio.
Rappresentazione JSON |
---|
{ "sheetId": integer, "title": string, "index": integer, "sheetType": enum ( |
Campi | |
---|---|
sheetId
|
L'ID del foglio. Non deve essere un valore negativo. Una volta impostato, questo campo non può essere modificato. |
title
|
Il nome del foglio. |
index
|
L'indice del foglio all'interno del foglio di lavoro. Quando aggiungi o aggiorni le proprietà dei fogli, se questo campo viene escluso, il foglio viene aggiunto o spostato alla fine dell'elenco dei fogli. Quando aggiorni gli indici dei fogli o inserisci i fogli, lo spostamento viene considerato negli indici "prima dello spostamento". Ad esempio, se ci sono tre fogli (S1, S2, S3) per spostare S1 davanti a S2 l'indice deve essere impostato su 2. Una richiesta di aggiornamento dell'indice del foglio viene ignorata se l'indice richiesto è identico all'indice corrente del foglio o se il nuovo indice richiesto è uguale all'indice corrente del foglio + 1. |
sheetType
|
Il tipo di foglio. Il valore predefinito è
|
gridProperties
|
Proprietà aggiuntive del foglio se si tratta di una griglia. Se il foglio è un foglio di oggetti contenente un grafico o un'immagine, questo campo non sarà presente. Durante la scrittura è un errore impostare le proprietà della griglia sui fogli non griglia.
Se questo foglio è un foglio
|
tabColor
|
Il colore della scheda nell'interfaccia utente. Deprecato: utilizza
|
tabColorStyle
|
Il colore della scheda nell'interfaccia utente. Se è impostato anche
|
rightToLeft
|
True se il foglio è da destra a sinistra anziché da sinistra a destra. |
dataSourceSheetProperties
|
Solo output. Se presente, il campo contiene proprietà specifiche del foglio
|
SheetType
Il tipo di foglio.
Enum | |
---|---|
SHEET_TYPE_UNSPECIFIED
|
Valore predefinito, non da utilizzare. |
GRID
|
Il foglio è una griglia. |
OBJECT
|
Il foglio non ha una griglia, ma contiene un oggetto come un grafico o un'immagine. |
DATA_SOURCE
|
Il foglio si collega a un componente
DataSource
esterno e mostra l'anteprima dei dati.
|
GridProperties
Proprietà di una griglia.
Rappresentazione JSON |
---|
{ "rowCount": integer, "columnCount": integer, "frozenRowCount": integer, "frozenColumnCount": integer, "hideGridlines": boolean, "rowGroupControlAfter": boolean, "columnGroupControlAfter": boolean } |
Campi | |
---|---|
rowCount
|
Il numero di righe nella griglia. |
columnCount
|
Il numero di colonne nella griglia. |
frozenRowCount
|
Il numero di righe bloccate nella griglia. |
frozenColumnCount
|
Il numero di colonne bloccate nella griglia. |
hideGridlines
|
True se la griglia non mostra le linee della griglia nella UI. |
rowGroupControlAfter
|
True se il pulsante di attivazione/disattivazione del controllo del raggruppamento delle righe viene mostrato dopo il gruppo. |
columnGroupControlAfter
|
True se l'opzione di controllo del raggruppamento delle colonne viene visualizzata dopo il gruppo. |
DataSourceSheetProperties
Proprietà aggiuntive di un foglio DATA_SOURCE
.
Rappresentazione JSON |
---|
{ "dataSourceId": string, "columns": [ { object ( |
Campi | |
---|---|
dataSourceId
|
ID dell'elemento
|
columns[]
|
Le colonne visualizzate nel foglio, corrispondenti ai valori in
|
dataExecutionStatus
|
Lo stato di esecuzione dei dati. |
GridData
I dati nella griglia, nonché i metadati relativi alle dimensioni.
Rappresentazione JSON |
---|
{ "startRow": integer, "startColumn": integer, "rowData": [ { object ( |
Campi | |
---|---|
startRow
|
La prima riga a cui fa riferimento questo GridData, in base zero. |
startColumn
|
La prima colonna a cui fa riferimento questo oggetto GridData, con inizio da zero. |
rowData[]
|
I dati nella griglia, una voce per riga, a partire dalla riga in startRow. I valori in RowData corrisponderanno alle colonne a partire da
|
rowMetadata[]
|
Metadati relativi alle righe richieste nella griglia, a partire dalla riga in
|
columnMetadata[]
|
Metadati sulle colonne richieste nella griglia, a partire dalla colonna in
|
RowData
Dati su ogni cella di una riga.
Rappresentazione JSON |
---|
{
"values": [
{
object ( |
Campi | |
---|---|
values[]
|
I valori nella riga, uno per colonna. |
DimensionProperties
Proprietà relative a una dimensione.
Rappresentazione JSON |
---|
{ "hiddenByFilter": boolean, "hiddenByUser": boolean, "pixelSize": integer, "developerMetadata": [ { object ( |
Campi | |
---|---|
pixelSize
|
L'altezza (se una riga) o la larghezza (se una colonna) della dimensione in pixel. |
developerMetadata[]
|
I metadati dello sviluppatore associati a una singola riga o colonna. |
dataSourceColumnReference
|
Solo output. Se impostato, si tratta di una colonna in un foglio dell'origine dati. |
ConditionalFormatRule
Una regola che descrive un formato condizionale.
Rappresentazione JSON |
---|
{ "ranges": [ { object ( |
Campi | |
---|---|
ranges[]
|
Gli intervalli che vengono formattati se la condizione è vera. Tutti gli intervalli devono trovarsi nella stessa griglia. |
Campo unione
rule . La regola che controlla questo formato condizionale, deve essere impostata esattamente una.
rule
può essere solo uno dei seguenti:
|
|
booleanRule
|
La formattazione è "on" o "off" in base alla regola. |
gradientRule
|
La formattazione varia in base ai gradienti nella regola. |
BooleanRule
Una regola che può corrispondere o meno a seconda della condizione.
Rappresentazione JSON |
---|
{ "condition": { object ( |
Campi | |
---|---|
condition
|
La condizione della regola. Se la condizione restituisce true, il formato viene applicato. |
format
|
Il formato da applicare. La formattazione condizionale può applicare solo un sottoinsieme di formattazione:
|
GradientRule
Una regola che applica un formato della scala di colori a gradiente in base ai punti di interpolazione elencati. Il formato di una cella varia in base ai relativi contenuti rispetto ai valori dei punti di interpolazione.
Rappresentazione JSON |
---|
{ "minpoint": { object ( |
Campi | |
---|---|
minpoint
|
Il punto di interpolazione iniziale. |
midpoint
|
Un punto di interpolazione intermedio facoltativo. |
maxpoint
|
Il punto di interpolazione finale. |
InterpolationPoint
Un singolo punto di interpolazione in un formato condizionale con gradiente. Questi fissano la scala di colori del gradiente in base al colore, al tipo e al valore scelto.
Rappresentazione JSON |
---|
{ "color": { object ( |
Campi | |
---|---|
color
|
Il colore da utilizzare per questo punto di interpolazione. Deprecato: utilizza
|
colorStyle
|
Il colore da utilizzare per questo punto di interpolazione. Se è impostato anche il criterio |
type
|
Come deve essere interpretato il valore. |
value
|
Il valore utilizzato da questo punto di interpolazione. Può essere una formula. Non utilizzato se
|
InterpolationPointType
Il tipo di punto di interpolazione.
Enum | |
---|---|
INTERPOLATION_POINT_TYPE_UNSPECIFIED
|
Il valore predefinito, da non utilizzare. |
MIN
|
Il punto di interpolazione utilizza il valore minimo nelle celle nell'intervallo del formato condizionale. |
MAX
|
Il punto di interpolazione utilizza il valore massimo nelle celle nell'intervallo del formato condizionale. |
NUMBER
|
Il punto di interpolazione utilizza esattamente il valore in
InterpolationPoint.value .
|
PERCENT
|
Il punto di interpolazione è la percentuale specificata in tutte le celle dell'intervallo del formato condizionale. Questo è equivalente a
|
PERCENTILE
|
Il punto di interpolazione è il percentile specificato tra tutte le celle dell'intervallo del formato condizionale. Questo è equivalente a
NUMBER
se il valore fosse:
=PERCENTILE(FLATTEN(range), value / 100)
(dove gli errori nell'intervallo vengono ignorati durante l'appiattimento).
|
FilterView
Una visualizzazione filtrata.
Rappresentazione JSON |
---|
{ "filterViewId": integer, "title": string, "range": { object ( |
Campi | |
---|---|
filterViewId
|
L'ID della visualizzazione filtrata. |
title
|
Il nome della vista filtro. |
range
|
L'intervallo coperto da questa visualizzazione filtrata.
Durante la scrittura, è possibile impostare solo uno dei valori
|
namedRangeId
|
L'intervallo denominato a cui si basa questa visualizzazione filtrata, se presente.
Durante la scrittura, è possibile impostare solo uno di
|
sortSpecs[]
|
L'ordine di ordinamento per colonna. Specifiche successive vengono utilizzate quando i valori sono uguali nelle specifiche precedenti. |
criteria
|
I criteri per mostrare/nascondere i valori per colonna. La chiave della mappa è l'indice di colonna e il valore è il criterio per quella colonna.
Questo campo è deprecato in favore di
|
filterSpecs[]
|
I criteri di filtro per mostrare/nascondere i valori per colonna.
Sia
|
ProtectedRange
Un intervallo protetto.
Rappresentazione JSON |
---|
{ "protectedRangeId": integer, "range": { object ( |
Campi | |
---|---|
protectedRangeId
|
L'ID dell'intervallo protetto. Questo campo è di sola lettura. |
range
|
L'intervallo che viene protetto. L'intervallo può essere completamente illimitato, in questo caso si tratta di un foglio protetto.
Durante la scrittura, è possibile impostare solo uno di
|
namedRangeId
|
L'intervallo denominato a cui si basa questo intervallo protetto, se presente.
Durante la scrittura, è possibile impostare solo uno di
|
description
|
La descrizione di questo intervallo protetto. |
warningOnly
|
True se questo intervallo protetto mostrerà un avviso durante la modifica. La protezione basata su avviso significa che ogni utente può modificare i dati nell'intervallo protetto, a meno che la modifica non venga visualizzata un avviso che chiede all'utente di confermare la modifica.
Quando scrivi: se questo campo è true, then
|
requestingUserCanEdit
|
True se l'utente che ha richiesto questo intervallo protetto può modificare l'area protetta. Questo campo è di sola lettura. |
unprotectedRanges[]
|
L'elenco degli intervalli non protetti all'interno di un foglio protetto. Gli intervalli non protetti sono supportati solo nei fogli protetti. |
editors
|
Gli utenti e i gruppi con accesso in modifica all'intervallo protetto. Questo campo è visibile solo agli utenti con accesso in modifica all'intervallo protetto e al documento. Gli editor non sono supportati con la protezione |
Editor
Gli editor di un intervallo protetto.
Rappresentazione JSON |
---|
{ "users": [ string ], "groups": [ string ], "domainUsersCanEdit": boolean } |
Campi | |
---|---|
users[]
|
Gli indirizzi email degli utenti con accesso in modifica all'intervallo protetto. |
groups[]
|
Gli indirizzi email dei gruppi con accesso in modifica all'intervallo protetto. |
domainUsersCanEdit
|
True se chiunque nel dominio del documento ha accesso in modifica all'intervallo protetto. La protezione del dominio è supportata solo per i documenti all'interno di un dominio. |
BasicFilter
Il filtro predefinito associato a un foglio.
Rappresentazione JSON |
---|
{ "range": { object ( |
Campi | |
---|---|
range
|
L'intervallo coperto dal filtro. |
sortSpecs[]
|
L'ordine di ordinamento per colonna. Le specifiche successive vengono utilizzate quando i valori sono uguali nelle specifiche precedenti. |
criteria
|
I criteri per mostrare/nascondere i valori per colonna. La chiave della mappa è l'indice della colonna e il valore è i criteri per quella colonna.
Questo campo è deprecato in favore di
|
filterSpecs[]
|
I criteri di filtro per colonna.
Sia
|
BandedRange
Un intervallo a bande (colori alternati) in un foglio.
Rappresentazione JSON |
---|
{ "bandedRangeId": integer, "range": { object ( |
Campi | |
---|---|
bandedRangeId
|
L'ID dell'intervallo a bande. |
range
|
L'intervallo su cui vengono applicate queste proprietà. |
rowProperties
|
Proprietà delle bande di riga. Queste proprietà vengono applicate riga per riga a tutte le righe dell'intervallo. È necessario specificare almeno un valore per |
columnProperties
|
Proprietà per le bande delle colonne. Queste proprietà vengono applicate su base colonna per colonna a tutte le colonne dell'intervallo. È necessario specificare almeno un valore per |
BandingProperties
Proprietà che fanno riferimento a una singola dimensione (riga o colonna). Se sono impostati entrambi i valori BandedRange.row_properties
e BandedRange.column_properties
, i colori di riempimento vengono applicati alle celle in base alle seguenti regole:
-
headerColor
efooterColor
hanno la priorità sui colori del cinturino. -
firstBandColor
ha la precedenza susecondBandColor
. -
rowProperties
ha la precedenza sucolumnProperties
.
Ad esempio, il colore della prima riga ha la priorità sul colore della prima colonna, ma il colore della prima colonna ha la priorità sul colore della seconda riga. Analogamente, l'intestazione di riga ha la priorità sull'intestazione di colonna nella cella in alto a sinistra, ma l'intestazione di colonna ha la priorità sul colore della prima riga se l'intestazione della riga non è impostata.
Rappresentazione JSON |
---|
{ "headerColor": { object ( |
Campi | |
---|---|
headerColor
|
Il colore della prima riga o colonna. Se questo campo è impostato, la prima riga o colonna viene riempita con questo colore e i colori si alternano tra
|
headerColorStyle
|
Il colore della prima riga o colonna. Se questo campo è impostato, la prima riga o colonna viene riempita con questo colore e i colori si alternano tra
|
firstBandColor
|
Il primo colore alternato. (Obbligatorio) Ritirato: utilizza
|
firstBandColorStyle
|
Il primo colore alternato. (Obbligatorio) Se è impostato anche |
secondBandColor
|
Il secondo colore alternato. (Obbligatorio) Deprecato: utilizza
|
secondBandColorStyle
|
Il secondo colore alternato. (Obbligatorio) Se è impostato anche |
footerColor
|
Il colore dell'ultima riga o colonna. Se questo campo non è impostato, l'ultima riga o colonna viene riempita con
|
footerColorStyle
|
Il colore dell'ultima riga o colonna. Se questo campo non è impostato, l'ultima riga o colonna viene compilata con
|
DimensionGroup
Un gruppo su un intervallo di righe o colonne in un foglio, che può contenere o essere contenuto in altri gruppi. Un gruppo può essere compresso o espanso come unità sul foglio.
Rappresentazione JSON |
---|
{
"range": {
object ( |
Campi | |
---|---|
range
|
L'intervallo in cui esiste questo gruppo. |
depth
|
La profondità del gruppo, che indica il numero di gruppi con un intervallo che contiene interamente l'intervallo di questo gruppo. |
collapsed
|
Questo campo è True se il gruppo è compresso. Un gruppo compresso rimane compresso se viene espanso un gruppo sovrapposto a una profondità inferiore. Un valore true non implica che tutte le dimensioni all'interno del gruppo siano nascoste, poiché la visibilità di una dimensione può cambiare indipendentemente da questa proprietà del gruppo. Tuttavia, quando questa proprietà viene aggiornata, tutte le dimensioni al suo interno vengono impostate su nascoste se il campo è true o su visibili se il campo è false. |
Controllo filtro
Un'apposita funzionalità in un foglio.
Rappresentazione JSON |
---|
{ "slicerId": integer, "spec": { object ( |
Campi | |
---|---|
slicerId
|
L'ID dell'elemento Slicer. |
spec
|
La specifica del controllo filtro. |
position
|
La posizione del controllo filtro. Tieni presente che il cursore può essere posizionato solo nel foglio esistente. Inoltre, la larghezza e l'altezza del controllo filtro possono essere regolate automaticamente per mantenerla entro i limiti consentiti. |
SlicerSpec
Le specifiche di un'apposita funzionalità.
Rappresentazione JSON |
---|
{ "dataRange": { object ( |
Campi | |
---|---|
dataRange
|
L'intervallo di dati del controllo filtro. |
filterCriteria
|
I criteri di filtro del controllo filtro. |
columnIndex
|
L'indice della colonna basato su zero nella tabella di dati a cui viene applicato il filtro. |
applyToPivotTables
|
True se il filtro deve essere applicato alle tabelle pivot. Se non viene impostato, il valore predefinito è
|
title
|
Il titolo dell'elemento Slicer. |
textFormat
|
Il formato del testo del titolo nel cursore. Il campo link non è supportato. |
backgroundColor
|
Il colore di sfondo dell'ellisse. Funzionalità deprecata: utilizza
|
backgroundColorStyle
|
Il colore di sfondo del controllo filtro. Se è impostato anche
|
horizontalAlignment
|
L'allineamento orizzontale del titolo nel selettore. Se non specificato, il valore predefinito è
|