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 della griglia.
Il numero di oggetti GridData restituiti dipende dal numero di intervalli richiesti in questo foglio. Ad esempio, se si tratta di
Per un foglio |
merges[]
|
Gli intervalli 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
|
Il filtro in questo foglio, se presente. |
charts[]
|
Le specifiche di ogni grafico in questo foglio. |
bandedRanges[]
|
Il foglio varia in base al colore (alternato). |
developerMetadata[]
|
I metadati dello sviluppatore associati a un foglio. |
rowGroups[]
|
Tutti i gruppi di righe in questo foglio, ordinati in base all'indice iniziale di intervallo crescente, quindi in base alla profondità del gruppo. |
columnGroups[]
|
Tutti i gruppi di colonne in questo foglio, ordinati in base all'indice iniziale dell'intervallo crescente, quindi in base alla profondità del gruppo. |
slicers[]
|
Le affettatrici in questo foglio. |
Proprietà Foglio
Proprietà di un foglio.
Rappresentazione JSON |
---|
{ "sheetId": integer, "title": string, "index": integer, "sheetType": enum ( |
Campi | |
---|---|
sheetId
|
ID del foglio. Non deve essere un numero 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 fogli, il movimento viene considerato negli indici "prima dello spostamento". Ad esempio, se ci fossero tre fogli (S1, S2, S3) per spostare S1 davanti a S2, l'indice dovrebbe essere impostato su 2. Una richiesta di aggiornamento dell'indice dei fogli viene ignorata se l'indice richiesto è identico all'indice corrente dei fogli o se il nuovo indice richiesto è uguale all'indice del foglio corrente + 1. |
sheetType
|
Il tipo di foglio. Il valore predefinito è |
gridProperties
|
Ulteriori proprietà del foglio se il foglio è una griglia. Se il foglio è un foglio oggetto, che contiene un grafico o un'immagine, questo campo sarà assente. Durante la scrittura è un errore impostare le proprietà della griglia su fogli diversi dalla 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 è un foglio RTL anziché un foglio LTR. |
dataSourceSheetProperties
|
Solo output. Se presente, il campo contiene proprietà specifiche del foglio |
Tipo di foglio
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 connette con un
DataSource
esterno e mostra l'anteprima dei dati.
|
Proprietà griglia
Le 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
|
Vero se la griglia non mostra linee della griglia nella UI. |
rowGroupControlAfter
|
True se il gruppo di controllo del controllo di raggruppamento delle righe viene visualizzato dopo il gruppo. |
columnGroupControlAfter
|
True se il pulsante di attivazione/disattivazione del controllo del raggruppamento delle colonne viene visualizzato dopo il gruppo. |
ProprietàFoglioSchedaFonte
Proprietà aggiuntive di un foglio DATA_SOURCE
.
Rappresentazione JSON |
---|
{ "dataSourceId": string, "columns": [ { object ( |
Campi | |
---|---|
dataSourceId
|
ID del
|
columns[]
|
Le colonne visualizzate nel foglio, corrispondenti ai valori di
|
dataExecutionStatus
|
Lo stato di esecuzione dei dati. |
Dati griglia
Dati nella griglia, nonché metadati sulle 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 GridData, in base zero. |
rowData[]
|
I dati nella griglia, una voce per riga, a partire dalla riga in startRow. I valori in RowData corrispondono alle colonne a partire da
|
rowMetadata[]
|
I metadati sulle righe richieste nella griglia, a partire dalla riga |
columnMetadata[]
|
I metadati sulle colonne richieste nella griglia, a partire dalla colonna in
|
DatiRiga
Dati su ogni cella di una riga.
Rappresentazione JSON |
---|
{
"values": [
{
object (
|
Campi | |
---|---|
values[]
|
I valori nella riga, uno per colonna. |
ProprietàDimensione
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 impostata, questa è una colonna del foglio di un'origine dati. |
Regola di condizione condizionale
Una regola che descrive un formato condizionale.
Rappresentazione JSON |
---|
{ "ranges": [ { object ( |
Campi | |
---|---|
ranges[]
|
Gli intervalli formattati se la condizione è vera. Tutti gli intervalli devono essere sulla stessa griglia. |
Campo Union
rule . La regola che controlla questo formato condizionale deve essere impostata esattamente una.
rule
può essere solo uno dei seguenti:
|
|
booleanRule
|
La formattazione è "attiva" o "disattivata" in base alla regola. |
gradientRule
|
La formattazione varierà in base ai gradienti della regola. |
BooleanRegola
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:
|
Regola Gradiente
Una regola che applica un formato di scala dei colori gradiente, in base ai punti di interpolazione elencati. Il formato di una cella varia in base ai suoi 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 a metà. |
maxpoint
|
Il punto di interpolazione finale. |
Punto di interpolazione
Un singolo punto di interpolazione in un formato condizionale con gradiente. Fissa la scala dei colori gradiente in base al colore, al tipo e al valore scelti.
Rappresentazione JSON |
---|
{ "color": { object ( |
Campi | |
---|---|
color
|
Il colore che deve utilizzare questo punto di interpolazione. Deprecato: utilizza
|
colorStyle
|
Il colore che deve utilizzare questo punto di interpolazione. Se è impostato anche |
type
|
Come deve essere interpretato il valore. |
value
|
Il valore utilizzato da questo punto di interpolazione. Potrebbe essere una formula. Non utilizzato se
|
Tipo di punto di interpolazione
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 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 su tutte le celle dell'intervallo del formato condizionale. Equivale a
|
PERCENTILE
|
Il punto di interpolazione è il percentile dato su tutte le celle nell'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).
|
Visualizzazione filtrata
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 compreso in questa visualizzazione filtrata.
Quando scrivi, è possibile impostare solo un elemento
|
namedRangeId
|
L'intervallo denominato da cui è supportata questa visualizzazione filtrata, se presente.
Quando scrivi, è possibile impostare solo un elemento
|
sortSpecs[]
|
L'ordinamento per colonna. Le specifiche successive vengono utilizzate quando i valori sono uguali a quelli delle specifiche precedenti. |
criteria
|
I criteri per mostrare/nascondere i valori per colonna. La chiave della mappa è l'indice della colonna, mentre il valore è il criterio per quella colonna.
Questo campo è stato ritirato a favore di |
filterSpecs[]
|
Criteri di filtro per mostrare/nascondere i valori per colonna.
Sia
|
Intervallo protetto
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 questo è considerato un foglio protetto.
Quando scrivi, è possibile impostare solo un elemento
|
namedRangeId
|
L'intervallo denominato da cui è supportato questo intervallo protetto.
Quando scrivi, è possibile impostare solo un elemento
|
description
|
La descrizione di questo intervallo protetto. |
warningOnly
|
True se questo intervallo protetto mostra un avviso durante la modifica. Grazie alla protezione basata su avvisi, ogni utente può modificare i dati nell'intervallo protetto, ad eccezione della modifica verrà visualizzato un avviso che chiede all'utente di confermare la modifica.
Quando scrivi: se questo campo è vero, |
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 dai 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 qualcuno nel dominio del documento ha accesso in modifica all'intervallo protetto. La protezione del dominio è supportata solo sui documenti all'interno di un dominio. |
Filtro di base
Il filtro predefinito associato a un foglio.
Rappresentazione JSON |
---|
{ "range": { object ( |
Campi | |
---|---|
range
|
L'intervallo previsto dal filtro. |
sortSpecs[]
|
L'ordinamento per colonna. Le specifiche successive vengono utilizzate quando i valori sono uguali a quelli delle specifiche precedenti. |
criteria
|
I criteri per mostrare/nascondere i valori per colonna. La chiave della mappa è l'indice della colonna, mentre il valore è il criterio per quella colonna.
Questo campo è stato ritirato a favore di |
filterSpecs[]
|
Criteri di filtro per colonna.
Sia
|
Intervallo fasciato
Un intervallo con fasce (colori alternativi) in un foglio.
Rappresentazione JSON |
---|
{ "bandedRangeId": integer, "range": { object ( |
Campi | |
---|---|
bandedRangeId
|
L'ID dell'intervallo fasciato. |
range
|
L'intervallo in cui vengono applicate queste proprietà. |
rowProperties
|
Proprietà delle bande di righe. Queste proprietà vengono applicate riga per riga in tutte le righe dell'intervallo. È necessario specificare almeno uno dei seguenti valori: |
columnProperties
|
Proprietà delle bande di colonne. Queste proprietà vengono applicate colonna per colonna in tutte le colonne dell'intervallo. È necessario specificare almeno uno dei seguenti valori: |
Proprietà delle bande
Proprietà che fanno riferimento a una singola dimensione (riga o colonna). Se hai impostato 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 priorità susecondBandColor
. -
rowProperties
ha la priorità 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 precedenza sul colore della prima riga, se 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) obsoleto: utilizza |
firstBandColorStyle
|
Il primo colore alternato. (Obbligatorio) Se è impostato anche |
secondBandColor
|
Il secondo colore alternato. (Obbligatorio) obsoleto: 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 riempita con |
Gruppodidimensioni
Un gruppo basato su un intervallo di righe o colonne su 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 si trova 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 è vero se questo gruppo è compresso. Un gruppo compresso rimane compresso se viene espanso un gruppo sovrapposto a una profondità inferiore. Un valore vero non implica che tutte le dimensioni all'interno del gruppo siano nascoste, poiché la visibilità di una dimensione può cambiare in modo indipendente da questa proprietà del gruppo. Tuttavia, quando questa proprietà viene aggiornata, tutte le dimensioni al suo interno vengono impostate su nascoste se il campo è vero o su visibili se il campo è falso. |
Affettatrice
Un'affettatrice in un foglio.
Rappresentazione JSON |
---|
{ "slicerId": integer, "spec": { object ( |
Campi | |
---|---|
slicerId
|
L'ID dell'affettatrice. |
spec
|
Le specifiche dell'affettatrice. |
position
|
La posizione dell'affettatrice. Tieni presente che l'affettatrice può essere posizionata solo su fogli esistenti. Inoltre, la larghezza e l'altezza dell'affettatrice possono essere regolate automaticamente per mantenerla entro i limiti consentiti. |
SlicerSpec
Le specifiche di un'affettatrice.
Rappresentazione JSON |
---|
{ "dataRange": { object ( |
Campi | |
---|---|
dataRange
|
L'intervallo di dati dell'affettatrice. |
filterCriteria
|
I criteri di filtro dell'affettatrice. |
columnIndex
|
L'indice della colonna in base zero nella tabella dei 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 dell'affettatrice. |
textFormat
|
Il formato del testo del titolo nell'affettatrice. Il campo del link non è supportato. |
backgroundColor
|
Il colore di sfondo dell'affettatrice. Deprecato: utilizza
|
backgroundColorStyle
|
Il colore di sfondo dell'affettatrice. Se è impostato anche |
horizontalAlignment
|
L'allineamento orizzontale del titolo nell'affettatrice. Se non è specificato un valore, il valore predefinito è
|