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 griglia.
Il numero di oggetti GridData restituiti dipende dal numero di intervalli richiesti in questo foglio. Ad esempio, se questo rappresenta
Per un
|
merges[]
|
Gli intervalli che vengono uniti. |
conditionalFormats[]
|
Le regole di formattazione condizionale in questo foglio. |
filterViews[]
|
Le visualizzazioni filtrate in questo foglio. |
protectedRanges[]
|
Gli intervalli protetti in questo foglio. |
basicFilter
|
L'eventuale filtro in questo foglio. |
charts[]
|
Le specifiche di ogni grafico in questo foglio. |
bandedRanges[]
|
L'intervallo di colori a strisce (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 in questo foglio, ordinati per indice iniziale dell'intervallo crescente e poi per profondità del gruppo. |
slicers[]
|
I controlli filtro in questo foglio. |
SheetProperties
Proprietà di un foglio.
Rappresentazione JSON |
---|
{ "sheetId": integer, "title": string, "index": integer, "sheetType": enum ( |
Campi | |
---|---|
sheetId
|
L'ID del foglio. Deve essere un numero non 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à del foglio, 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 "prima dello spostamento" indici di appartenenza. 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 dei fogli viene ignorata se l'indice richiesto è identico all'indice attuale dei fogli o se il nuovo indice richiesto è uguale all'indice del foglio corrente 1. |
sheetType
|
Il tipo di foglio. Il valore predefinito è
|
gridProperties
|
Proprietà aggiuntive del foglio se questo foglio è 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
|
tabColor
|
Il colore della scheda nell'interfaccia utente. Obsoleta: utilizza
|
tabColorStyle
|
Il colore della scheda nell'interfaccia utente. Se
|
rightToLeft
|
True se il foglio è un foglio RTL anziché un foglio LTR. |
dataSourceSheetProperties
|
Solo output. Se presente, il campo contiene
|
SheetType
Il tipo di foglio.
Enum | |
---|---|
SHEET_TYPE_UNSPECIFIED
|
Valore predefinito, non utilizzare. |
GRID
|
Il foglio è una griglia. |
OBJECT
|
Il foglio non ha una griglia, ma un oggetto come un grafico o un'immagine. |
DATA_SOURCE
|
Il foglio si collega a un
DataSource
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 il pulsante di attivazione/disattivazione del controllo del raggruppamento delle colonne viene mostrato dopo il gruppo. |
DataSourceSheetProperties
Ulteriori proprietà di un
DATA_SOURCE
in un foglio di calcolo.
Rappresentazione JSON |
---|
{ "dataSourceId": string, "columns": [ { object ( |
Campi | |
---|---|
dataSourceId
|
ID del
|
columns[]
|
Le colonne visualizzate nel foglio, corrispondenti ai valori in
|
dataExecutionStatus
|
Lo stato di esecuzione dei dati. |
GridData
Dati nella griglia, nonché metadati relativi alle dimensioni.
Rappresentazione JSON |
---|
{ "startRow": integer, "startColumn": integer, "rowData": [ { object ( |
Campi | |
---|---|
startRow
|
La prima riga a cui si riferisce questo GridData, in base zero. |
startColumn
|
La prima colonna a cui fa riferimento questo GridData, in base zero. |
rowData[]
|
I dati nella griglia, una voce per riga, a partire dalla riga in startRow. I valori in RowData corrisponderanno alle colonne che iniziano per
|
rowMetadata[]
|
Metadati sulle righe richieste nella griglia, a partire dalla riga in
|
columnMetadata[]
|
Metadati sulle colonne richieste nella griglia, a partire dalla colonna in
|
RowData
Dati relativi a 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, questa è una colonna nel foglio di un'origine dati. |
ConditionalFormatRule
Una regola che descrive un formato condizionale.
Rappresentazione JSON |
---|
{ "ranges": [ { object ( |
Campi | |
---|---|
ranges[]
|
Gli intervalli formattati se la condizione è true. Tutti gli intervalli devono trovarsi sulla stessa griglia. |
Campo unione
rule . Deve essere impostata esattamente una regola che controlla questo formato condizionale.
rule
può essere solo uno dei seguenti:
|
|
booleanRule
|
La formattazione è "attivata" 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 con scala di colori gradiente in base ai punti di interpolazione elencati. Il formato di una cella varia in base al contenuto e 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 a gradiente. Fissano la scala dei colori del gradiente in base al colore, al tipo e al valore scelti.
Rappresentazione JSON |
---|
{ "color": { object ( |
Campi | |
---|---|
color
|
Il colore che deve essere utilizzato da questo punto di interpolazione. Obsoleta: utilizza
|
colorStyle
|
Il colore che deve essere utilizzato da questo punto di interpolazione. Se
|
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, non utilizzare. |
MIN
|
Il punto di interpolazione utilizza il valore minimo nelle celle dell'intervallo del formato condizionale. |
MAX
|
Il punto di interpolazione utilizza il valore massimo nelle celle dell'intervallo del formato condizionale. |
NUMBER
|
Il punto di interpolazione utilizza esattamente il valore in
InterpolationPoint.value .
|
PERCENT
|
Il punto di interpolazione è la percentuale specificata su tutte le celle dell'intervallo del formato condizionale. Equivale a
|
PERCENTILE
|
Il punto di interpolazione è il percentile specificato tra tutte le celle dell'intervallo del formato condizionale. Equivale a
NUMBER
se il valore era:
=PERCENTILE(FLATTEN(range), value / 100)
(dove gli errori nell'intervallo vengono ignorati durante la suddivisione).
|
FilterView
Una visualizzazione filtrata.
Rappresentazione JSON |
---|
{ "filterViewId": integer, "title": string, "range": { object ( |
Campi | |
---|---|
filterViewId
|
L'ID della visualizzazione filtrata. |
title
|
Il nome della visualizzazione filtrata. |
range
|
L'intervallo coperto da questa visualizzazione filtrata.
Quando scrivi, solo uno dei
|
namedRangeId
|
L'intervallo denominato da cui è supportata la visualizzazione filtrata, se presente.
Quando scrivi, solo uno dei
|
sortSpecs[]
|
L'ordinamento per colonna. Specifiche successive vengono utilizzate quando i valori sono uguali nelle specifiche precedenti. |
criteria
|
I criteri per mostrare/nascondere i valori per ogni colonna. La chiave della mappa è l'indice di colonna e il valore è il criterio per quella colonna.
Questo campo è stato ritirato a favore di
|
filterSpecs[]
|
I criteri del filtro per mostrare/nascondere i valori per ciascuna colonna.
Entrambi
|
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 potrebbe essere completamente illimitato, nel qual caso viene considerato un foglio protetto.
Quando scrivi, solo uno dei
|
namedRangeId
|
L'intervallo denominato da cui è supportato questo intervallo protetto, se presente.
Quando scrivi, solo uno dei
|
description
|
La descrizione di questo intervallo protetto. |
warningOnly
|
True se l'intervallo protetto mostrerà un avviso durante la modifica. La protezione basata su avvisi indica che ogni utente può modificare i dati nell'intervallo protetto, ad eccezione del fatto che la modifica mostrerà un avviso che chiede all'utente di confermare la modifica.
Quando scrivi: se questo campo è true,
|
requestingUserCanEdit
|
True se l'utente che ha richiesto questo intervallo protetto può modificare l'area protetta. Questo campo è di sola lettura. |
unprotectedRanges[]
|
L'elenco di intervalli non protetti all'interno di un foglio protetto. Gli intervalli non protetti sono supportati solo sui 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
|
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 un utente 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'ordinamento per colonna. Specifiche successive vengono utilizzate quando i valori sono uguali nelle specifiche precedenti. |
criteria
|
I criteri per mostrare/nascondere i valori per ogni colonna. La chiave della mappa è l'indice di colonna e il valore è il criterio per quella colonna.
Questo campo è stato ritirato a favore di
|
filterSpecs[]
|
I criteri del filtro per colonna.
Entrambi
|
BandedRange
Un intervallo a strisce (colori alternati) in un foglio.
Rappresentazione JSON |
---|
{ "bandedRangeId": integer, "range": { object ( |
Campi | |
---|---|
bandedRangeId
|
L'ID dell'intervallo a bande. |
range
|
L'intervallo a cui vengono applicate queste proprietà. |
rowProperties
|
Proprietà delle bande di riga. Queste proprietà vengono applicate riga per riga a tutte le righe dell'intervallo. Almeno uno di
|
columnProperties
|
Proprietà per le bande delle colonne. Queste proprietà vengono applicate colonna per colonna a tutte le colonne dell'intervallo. Almeno uno di
|
BandingProperties
Proprietà che fanno riferimento a una singola dimensione (riga o colonna). Se entrambi
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 priorità susecondBandColor
. -
rowProperties
ha la priorità sucolumnProperties
.
Ad esempio, il primo colore della riga ha la priorità sul colore del primo colore della colonna, ma il primo colore della colonna ha la priorità sul secondo colore della 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) Deprecato: utilizza
|
firstBandColorStyle
|
Il primo colore alternato. (Obbligatorio) Se
|
secondBandColor
|
Il secondo colore alternato. (Obbligatorio) Deprecato: utilizza
|
secondBandColorStyle
|
Il secondo colore alternato. (Obbligatorio) Se
|
footerColor
|
Il colore dell'ultima riga o colonna. Se questo campo non viene impostato, l'ultima riga o colonna viene compilata con
|
footerColorStyle
|
Il colore dell'ultima riga o colonna. Se questo campo non viene impostato, l'ultima riga o colonna viene compilata con
|
DimensionGroup
Un gruppo su un intervallo di righe o colonne su un foglio, che può contenere o essere contenuto all'interno di altri gruppi. Un gruppo può essere compresso o espanso come unità sul foglio.
Rappresentazione JSON |
---|
{
"range": {
object (
|
Campi | |
---|---|
range
|
L'intervallo nel quale esiste questo gruppo. |
depth
|
La profondità del gruppo, che rappresenta quanti gruppi hanno un intervallo che contiene interamente l'intervallo di questo gruppo. |
collapsed
|
Questo campo è true se il gruppo è compresso. Un gruppo compresso rimane compresso se si espande 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 questo campo è vero oppure su visibile se questo campo è falso. |
Controllo filtro
Un controllo filtro in un foglio.
Rappresentazione JSON |
---|
{ "slicerId": integer, "spec": { object ( |
Campi | |
---|---|
slicerId
|
L'ID del controllo filtro. |
spec
|
La specifica del controllo filtro. |
position
|
La posizione del controllo filtro. Tieni presente che il controllo filtro può essere posizionato solo su un 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 controllo filtro.
Rappresentazione JSON |
---|
{ "dataRange": { object ( |
Campi | |
---|---|
dataRange
|
L'intervallo di dati del controllo filtro. |
filterCriteria
|
I criteri di filtro del controllo filtro. |
columnIndex
|
L'indice di colonna in base 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 configurato, il valore predefinito è
|
title
|
Il titolo del controllo filtro. |
textFormat
|
Il formato di testo del titolo nel controllo filtro. Il campo del link non è supportato. |
backgroundColor
|
Il colore di sfondo del controllo filtro. Obsoleta: utilizza
|
backgroundColorStyle
|
Il colore di sfondo del controllo filtro. Se
|
horizontalAlignment
|
L'allineamento orizzontale del titolo nel controllo filtro. Se non specificato, il valore predefinito è
|