Sheets

Foglio

Un foglio di un foglio di lavoro.

Rappresentazione JSON 
{
  "properties": {
    object (SheetProperties)
  },
  "data": [
    {
      object (GridData)
    }
  ],
  "merges": [
    {
      object (GridRange)
    }
  ],
  "conditionalFormats": [
    {
      object (ConditionalFormatRule)
    }
  ],
  "filterViews": [
    {
      object (FilterView)
    }
  ],
  "protectedRanges": [
    {
      object (ProtectedRange)
    }
  ],
  "basicFilter": {
    object (BasicFilter)
  },
  "charts": [
    {
      object (EmbeddedChart)
    }
  ],
  "bandedRanges": [
    {
      object (BandedRange)
    }
  ],
  "developerMetadata": [
    {
      object (DeveloperMetadata)
    }
  ],
  "rowGroups": [
    {
      object (DimensionGroup)
    }
  ],
  "columnGroups": [
    {
      object (DimensionGroup)
    }
  ],
  "slicers": [
    {
      object (Slicer)
    }
  ],
  "tables": [
    {
      object (Table)
    }
  ]
}
Campi
properties

object (SheetProperties)

Le proprietà del foglio.

data[]

object (GridData)

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 questo rappresenta Sheet1 e il foglio di lavoro è stato richiesto con gli intervalli Sheet1!A1:C10 e Sheet1!D15:E20, il primo GridData avrà un startRow / startColumn di 0, mentre il secondo avrà startRow 14 (riga 15 in base zero) e startColumn 3 (colonna D in base zero).

Per un foglio DATA_SOURCE, non puoi richiedere un intervallo specifico. GridData contiene tutti i valori.

merges[]

object (GridRange)

Gli intervalli uniti.

conditionalFormats[]

object (ConditionalFormatRule)

Le regole di formattazione condizionale in questo foglio.

filterViews[]

object (FilterView)

Le visualizzazioni filtrate in questo foglio.

protectedRanges[]

object (ProtectedRange)

Gli intervalli protetti in questo foglio.

basicFilter

object (BasicFilter)

Il filtro in questo foglio, se presente.

charts[]

object (EmbeddedChart)

Le specifiche di ogni grafico in questo foglio.

bandedRanges[]

object (BandedRange)

Gli intervalli a bande (colori alternati) in questo foglio.

developerMetadata[]

object (DeveloperMetadata)

I metadati dello sviluppatore associati a un foglio.

rowGroups[]

object (DimensionGroup)

Tutti i gruppi di righe in questo foglio, ordinati in base all'indice iniziale dell'intervallo crescente, quindi in base alla profondità del gruppo.

columnGroups[]

object (DimensionGroup)

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[]

object (Slicer)

I filtri in questo foglio.

tables[]

object (Table)

Le tabelle in questo foglio.

SheetProperties

Proprietà di un foglio.

Rappresentazione JSON 
{
  "sheetId": integer,
  "title": string,
  "index": integer,
  "sheetType": enum (SheetType),
  "gridProperties": {
    object (GridProperties)
  },
  "hidden": boolean,
  "tabColor": {
    object (Color)
  },
  "tabColorStyle": {
    object (ColorStyle)
  },
  "rightToLeft": boolean,
  "dataSourceSheetProperties": {
    object (DataSourceSheetProperties)
  }
}
Campi
sheetId

integer

L'ID del foglio. Non deve essere un valore negativo. Questo campo non può essere modificato una volta impostato.

title

string

Il nome del foglio.

index

integer

L'indice del foglio all'interno del foglio di lavoro. Quando aggiungi o aggiorni le proprietà del foglio, se questo campo è 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 sono tre fogli (F1, F2, F3) per spostare F1 prima di F2, 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

enum (SheetType)

Il tipo di foglio. Il valore predefinito è GRID. Questo campo non può essere modificato una volta impostato.

gridProperties

object (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. Quando si scrive, è un errore impostare le proprietà della griglia su fogli non a griglia.

Se questo foglio è un DATA_SOURCE foglio, questo campo è solo di output, ma contiene le proprietà che riflettono il modo in cui un foglio dell'origine dati viene visualizzato nell'interfaccia utente, ad esempio rowCount.

hidden

boolean

Vero se il foglio è nascosto nell'interfaccia utente, falso se è visibile.

tabColor
(deprecated)

object (Color)

Il colore della scheda nell'interfaccia utente. Deprecata: utilizza tabColorStyle.

tabColorStyle

object (ColorStyle)

Il colore della scheda nell'interfaccia utente. Se è impostato anche tabColor, questo campo ha la precedenza.

rightToLeft

boolean

True se il foglio è un foglio RTL anziché un foglio LTR.

dataSourceSheetProperties

object (DataSourceSheetProperties)

Solo output. Se presente, il campo contiene DATA_SOURCE proprietà specifiche del foglio.

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 e contiene invece un oggetto come un grafico o un'immagine.
DATA_SOURCE Il foglio si connette 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

integer

Il numero di righe nella griglia.

columnCount

integer

Il numero di colonne nella griglia.

frozenRowCount

integer

Il numero di righe bloccate nella griglia.

frozenColumnCount

integer

Il numero di colonne bloccate nella griglia.

hideGridlines

boolean

Vero se la griglia non mostra le linee della griglia nell'interfaccia utente.

rowGroupControlAfter

boolean

True se il pulsante di attivazione/disattivazione del controllo del raggruppamento di righe viene visualizzato dopo il gruppo.

columnGroupControlAfter

boolean

True se il pulsante di attivazione/disattivazione del controllo del raggruppamento delle colonne viene visualizzato dopo il gruppo.

DataSourceSheetProperties

Proprietà aggiuntive di un foglio DATA_SOURCE.

Rappresentazione JSON 
{
  "dataSourceId": string,
  "columns": [
    {
      object (DataSourceColumn)
    }
  ],
  "dataExecutionStatus": {
    object (DataExecutionStatus)
  }
}
Campi
dataSourceId

string

ID del DataSource a cui è collegato il foglio.

columns[]

object (DataSourceColumn)

Le colonne visualizzate nel foglio, corrispondenti ai valori in RowData.

dataExecutionStatus

object (DataExecutionStatus)

Lo stato di esecuzione dei dati.

GridData

I dati nella griglia, nonché i metadati sulle dimensioni.

Rappresentazione JSON 
{
  "startRow": integer,
  "startColumn": integer,
  "rowData": [
    {
      object (RowData)
    }
  ],
  "rowMetadata": [
    {
      object (DimensionProperties)
    }
  ],
  "columnMetadata": [
    {
      object (DimensionProperties)
    }
  ]
}
Campi
startRow

integer

La prima riga a cui fa riferimento GridData, in base zero.

startColumn

integer

La prima colonna a cui fa riferimento GridData, in base zero.

rowData[]

object (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 startColumn.

rowMetadata[]

object (DimensionProperties)

Metadati sulle righe richieste nella griglia, a partire dalla riga in startRow.

columnMetadata[]

object (DimensionProperties)

Metadati sulle colonne richieste nella griglia, a partire dalla colonna in startColumn.

RowData

Dati su ogni cella di una riga.

Rappresentazione JSON 
{
  "values": [
    {
      object (CellData)
    }
  ]
}
Campi
values[]

object (CellData)

I valori nella riga, uno per colonna.

DimensionProperties

Proprietà di una dimensione.

Rappresentazione JSON 
{
  "hiddenByFilter": boolean,
  "hiddenByUser": boolean,
  "pixelSize": integer,
  "developerMetadata": [
    {
      object (DeveloperMetadata)
    }
  ],
  "dataSourceColumnReference": {
    object (DataSourceColumnReference)
  }
}
Campi
hiddenByFilter

boolean

True se questa dimensione viene filtrata. Questo campo è di sola lettura.

hiddenByUser

boolean

True se questa dimensione è nascosta in modo esplicito.

pixelSize

integer

L'altezza (se una riga) o la larghezza (se una colonna) della dimensione in pixel.

developerMetadata[]

object (DeveloperMetadata)

I metadati dello sviluppatore associati a una singola riga o colonna.

dataSourceColumnReference

object (DataSourceColumnReference)

Solo output. Se impostata, questa è una colonna in un foglio dell'origine dati.

ConditionalFormatRule

Una regola che descrive un formato condizionale.

Rappresentazione JSON 
{
  "ranges": [
    {
      object (GridRange)
    }
  ],

  // Union field rule can be only one of the following:
  "booleanRule": {
    object (BooleanRule)
  },
  "gradientRule": {
    object (GradientRule)
  }
  // End of list of possible types for union field rule.
}
Campi
ranges[]

object (GridRange)

Gli intervalli 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 volta. rule può essere solo uno dei seguenti tipi:
booleanRule

object (BooleanRule)

La formattazione è "on" o "off" a seconda della regola.

gradientRule

object (GradientRule)

La formattazione varia in base ai gradienti della regola.

BooleanRule

Una regola che può corrispondere o meno, a seconda della condizione.

Rappresentazione JSON 
{
  "condition": {
    object (BooleanCondition)
  },
  "format": {
    object (CellFormat)
  }
}
Campi
condition

object (BooleanCondition)

La condizione della regola. Se la condizione restituisce il valore true, viene applicata la formattazione.

format

object (CellFormat)

Il formato da applicare. La formattazione condizionale può applicare solo un sottoinsieme di formattazione: bold, italic, strikethrough, foreground color e, background color.

GradientRule

Una regola che applica un formato di scala di colori sfumati, 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 (InterpolationPoint)
  },
  "midpoint": {
    object (InterpolationPoint)
  },
  "maxpoint": {
    object (InterpolationPoint)
  }
}
Campi
minpoint

object (InterpolationPoint)

Il punto di interpolazione iniziale.

midpoint

object (InterpolationPoint)

Un punto di interpolazione intermedio facoltativo.

maxpoint

object (InterpolationPoint)

Il punto di interpolazione finale.

InterpolationPoint

Un singolo punto di interpolazione in un formato condizionale con gradiente. Questi bloccano la scala di colori del gradiente in base al colore, al tipo e al valore scelti.

Rappresentazione JSON 
{
  "color": {
    object (Color)
  },
  "colorStyle": {
    object (ColorStyle)
  },
  "type": enum (InterpolationPointType),
  "value": string
}
Campi
color
(deprecated)

object (Color)

Il colore che deve utilizzare questo punto di interpolazione. Deprecata: utilizza colorStyle.

colorStyle

object (ColorStyle)

Il colore che deve utilizzare questo punto di interpolazione. Se è impostato anche color, questo campo ha la precedenza.

type

enum (InterpolationPointType)

Come deve essere interpretato il valore.

value

string

Il valore utilizzato da questo punto di interpolazione. Potrebbe essere una formula. Non utilizzato se type è MIN o MAX.

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 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 NUMBER se il valore era: =(MAX(FLATTEN(range)) * (value / 100)) + (MIN(FLATTEN(range)) * (1 - (value / 100))) (dove gli errori nell'intervallo vengono ignorati durante l'appiattimento).

PERCENTILE Il punto di interpolazione è il percentile specificato per 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 l'appiattimento).

FilterView

Una visualizzazione filtrata. Per saperne di più, consulta Gestire la visibilità dei dati con i filtri.

Rappresentazione JSON 
{
  "filterViewId": integer,
  "title": string,
  "range": {
    object (GridRange)
  },
  "namedRangeId": string,
  "tableId": string,
  "sortSpecs": [
    {
      object (SortSpec)
    }
  ],
  "criteria": {
    integer: {
      object (FilterCriteria)
    },
    ...
  },
  "filterSpecs": [
    {
      object (FilterSpec)
    }
  ]
}
Campi
filterViewId

integer

L'ID della visualizzazione filtrata.

title

string

Il nome della visualizzazione filtrata.

range

object (GridRange)

L'intervallo coperto da questa visualizzazione filtrata.

Durante la scrittura, è possibile impostare solo uno dei seguenti valori: range, namedRangeId o tableId.

namedRangeId

string

L'intervallo denominato su cui si basa questa visualizzazione filtrata, se presente.

Durante la scrittura, è possibile impostare solo uno dei seguenti valori: range, namedRangeId o tableId.

tableId

string

La tabella su cui si basa questa visualizzazione filtrata, se presente.

Durante la scrittura, è possibile impostare solo uno dei seguenti valori: range, namedRangeId o tableId.

sortSpecs[]

object (SortSpec)

L'ordine di ordinamento per colonna. Le specifiche successive vengono utilizzate quando i valori sono uguali nelle specifiche precedenti.

criteria
(deprecated)

map (key: integer, value: object ( FilterCriteria))

I criteri per mostrare/nascondere i valori per colonna. La chiave della mappa è l'indice della colonna e il valore è il criterio per quella colonna.

Questo campo è deprecato a favore di filterSpecs.

filterSpecs[]

object (FilterSpec)

I criteri di filtro per mostrare o nascondere i valori per colonna.

Sia criteria che filterSpecs vengono compilati nelle risposte. Se entrambi i campi vengono specificati in una richiesta di aggiornamento, questo campo ha la precedenza.

ProtectedRange

Un intervallo protetto.

Rappresentazione JSON 
{
  "protectedRangeId": integer,
  "range": {
    object (GridRange)
  },
  "namedRangeId": string,
  "tableId": string,
  "description": string,
  "warningOnly": boolean,
  "requestingUserCanEdit": boolean,
  "unprotectedRanges": [
    {
      object (GridRange)
    }
  ],
  "editors": {
    object (Editors)
  }
}
Campi
protectedRangeId

integer

L'ID dell'intervallo protetto. Questo campo è di sola lettura.

range

object (GridRange)

L'intervallo che viene protetto. L'intervallo può essere completamente illimitato, nel qual caso viene considerato un foglio protetto.

Durante la scrittura, è possibile impostare solo uno dei seguenti valori: range o namedRangeId o tableId.

namedRangeId

string

L'intervallo denominato su cui si basa questo intervallo protetto, se presente.

Durante la scrittura, è possibile impostare solo uno dei seguenti valori: range o namedRangeId o tableId.

tableId

string

La tabella su cui si basa questo intervallo protetto, se presente.

Durante la scrittura, è possibile impostare solo uno dei seguenti valori: range o namedRangeId o tableId.

description

string

La descrizione di questo intervallo protetto.

warningOnly

boolean

True se questo intervallo protetto mostrerà un avviso durante la modifica. La protezione basata sugli avvisi significa che ogni utente può modificare i dati nell'intervallo protetto, ma la modifica genererà un avviso che chiede all'utente di confermarla.

Durante la scrittura: se questo campo è true, allora editors vengono ignorati. Inoltre, se questo campo viene modificato da true a false e il editors non è impostato (né incluso nella maschera del campo), gli editor verranno impostati su tutti gli editor del documento.

requestingUserCanEdit

boolean

True se l'utente che ha richiesto questo intervallo protetto può modificare l'area protetta. Questo campo è di sola lettura.

unprotectedRanges[]

object (GridRange)

L'elenco degli intervalli non protetti all'interno di un foglio protetto. Gli intervalli non protetti sono supportati solo sui fogli protetti.

editors

object (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 warningOnly.

Editor

Gli editor di un intervallo protetto.

Rappresentazione JSON 
{
  "users": [
    string
  ],
  "groups": [
    string
  ],
  "domainUsersCanEdit": boolean
}
Campi
users[]

string

Gli indirizzi email degli utenti con accesso in modifica all'intervallo protetto.

groups[]

string

Gli indirizzi email dei gruppi con accesso in modifica all'intervallo protetto.

domainUsersCanEdit

boolean

Vero se chiunque nel dominio del documento ha accesso in modifica all'intervallo protetto. La protezione del dominio è supportata solo sui documenti all'interno di un dominio.

BasicFilter

Il filtro predefinito associato a un foglio. Per saperne di più, consulta Gestire la visibilità dei dati con i filtri.

Rappresentazione JSON 
{
  "range": {
    object (GridRange)
  },
  "tableId": string,
  "sortSpecs": [
    {
      object (SortSpec)
    }
  ],
  "criteria": {
    integer: {
      object (FilterCriteria)
    },
    ...
  },
  "filterSpecs": [
    {
      object (FilterSpec)
    }
  ]
}
Campi
range

object (GridRange)

L'intervallo coperto dal filtro.

tableId

string

La tabella su cui si basa questo filtro, se presente. Durante la scrittura, è possibile impostare solo uno dei seguenti valori: range o tableId.

sortSpecs[]

object (SortSpec)

L'ordine di ordinamento per colonna. Le specifiche successive vengono utilizzate quando i valori sono uguali nelle specifiche precedenti.

criteria
(deprecated)

map (key: integer, value: object ( FilterCriteria))

I criteri per mostrare/nascondere i valori per colonna. La chiave della mappa è l'indice della colonna e il valore è il criterio per quella colonna.

Questo campo è deprecato a favore di filterSpecs.

filterSpecs[]

object (FilterSpec)

I criteri di filtro per colonna.

Sia criteria che filterSpecs vengono compilati nelle risposte. Se entrambi i campi vengono specificati in una richiesta di aggiornamento, questo campo ha la precedenza.

BandedRange

Un intervallo a bande (con colori alternati) in un foglio.

Rappresentazione JSON 
{
  "bandedRangeId": integer,
  "bandedRangeReference": string,
  "range": {
    object (GridRange)
  },
  "rowProperties": {
    object (BandingProperties)
  },
  "columnProperties": {
    object (BandingProperties)
  }
}
Campi
bandedRangeId

integer

L'ID dell'intervallo a bande. Se non è impostato, consulta bandedRangeReference.

bandedRangeReference

string

Solo output. Il riferimento dell'intervallo a bande, utilizzato per identificare l'ID non supportato da bandedRangeId.

range

object (GridRange)

L'intervallo su cui vengono applicate queste proprietà.

rowProperties

object (BandingProperties)

Proprietà per le bande di righe. Queste proprietà vengono applicate riga per riga a tutte le righe dell'intervallo. È necessario specificare almeno un valore per rowProperties o columnProperties.

columnProperties

object (BandingProperties)

Proprietà per le bande di colonne. Queste proprietà vengono applicate colonna per colonna a tutte le colonne dell'intervallo. È necessario specificare almeno un valore per rowProperties o columnProperties.

BandingProperties

Proprietà che fanno riferimento a una singola dimensione (riga o colonna). Se sono impostati sia BandedRange.row_properties che BandedRange.column_properties, i colori di riempimento vengono applicati alle celle in base alle seguenti regole:

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. Allo stesso modo, l'intestazione di riga ha la precedenza sull'intestazione di colonna nella cella in alto a sinistra, ma l'intestazione di colonna ha la precedenza sul colore della prima riga se l'intestazione di riga non è impostata.

Rappresentazione JSON 
{
  "headerColor": {
    object (Color)
  },
  "headerColorStyle": {
    object (ColorStyle)
  },
  "firstBandColor": {
    object (Color)
  },
  "firstBandColorStyle": {
    object (ColorStyle)
  },
  "secondBandColor": {
    object (Color)
  },
  "secondBandColorStyle": {
    object (ColorStyle)
  },
  "footerColor": {
    object (Color)
  },
  "footerColorStyle": {
    object (ColorStyle)
  }
}
Campi
headerColor
(deprecated)

object (Color)

Il colore della prima riga o colonna. Se questo campo è impostato, la prima riga o colonna viene riempita con questo colore e i colori alternano tra firstBandColor e secondBandColor a partire dalla seconda riga o colonna. In caso contrario, la prima riga o colonna viene riempita con firstBandColor e i colori continuano ad alternarsi come di consueto. Deprecata: utilizza headerColorStyle.

headerColorStyle

object (ColorStyle)

Il colore della prima riga o colonna. Se questo campo è impostato, la prima riga o colonna viene riempita con questo colore e i colori alternano tra firstBandColor e secondBandColor a partire dalla seconda riga o colonna. In caso contrario, la prima riga o colonna viene riempita con firstBandColor e i colori continuano ad alternarsi come di consueto. Se è impostato anche headerColor, questo campo ha la precedenza.

firstBandColor
(deprecated)

object (Color)

Il primo colore alternato. (Obbligatorio) Deprecata: utilizza firstBandColorStyle.

firstBandColorStyle

object (ColorStyle)

Il primo colore alternato. (Obbligatorio) Se firstBandColor è impostato anche questo campo, ha la precedenza.

secondBandColor
(deprecated)

object (Color)

Il secondo colore alternato. (Obbligatorio) Deprecata: utilizza secondBandColorStyle.

secondBandColorStyle

object (ColorStyle)

Il secondo colore alternato. (Obbligatorio) Se secondBandColor è impostato anche questo campo, ha la precedenza.

footerColor
(deprecated)

object (Color)

Il colore dell'ultima riga o colonna. Se questo campo non è impostato, l'ultima riga o colonna viene riempita con firstBandColor o secondBandColor, a seconda del colore della riga o della colonna precedente. Deprecata: utilizza footerColorStyle.

footerColorStyle

object (ColorStyle)

Il colore dell'ultima riga o colonna. Se questo campo non è impostato, l'ultima riga o colonna viene riempita con firstBandColor o secondBandColor, a seconda del colore della riga o della colonna precedente. Se è impostato anche footerColor, questo campo ha la precedenza.

DimensionGroup

Un gruppo su un intervallo di righe o colonne di un foglio, che può contenere o essere contenuto all'interno di altri gruppi. Un gruppo può essere compresso o espanso come unità nel foglio.

Rappresentazione JSON 
{
  "range": {
    object (DimensionRange)
  },
  "depth": integer,
  "collapsed": boolean
}
Campi
range

object (DimensionRange)

L'intervallo in cui esiste questo gruppo.

depth

integer

La profondità del gruppo, che rappresenta il numero di gruppi il cui intervallo contiene interamente l'intervallo di questo gruppo.

collapsed

boolean

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 questo campo è true o su visibili se questo campo è false.

Controllo filtro

Un filtro in un foglio.

Rappresentazione JSON 
{
  "slicerId": integer,
  "spec": {
    object (SlicerSpec)
  },
  "position": {
    object (EmbeddedObjectPosition)
  }
}
Campi
slicerId

integer

L'ID del segmento.

spec

object (SlicerSpec)

La specifica del selettore.

position

object (EmbeddedObjectPosition)

La posizione del cursore. Tieni presente che il filtro può essere posizionato solo sul foglio esistente. Inoltre, la larghezza e l'altezza dello strumento di sezionamento possono essere regolate automaticamente per mantenerlo entro i limiti consentiti.

SlicerSpec

Le specifiche di uno slicer.

Rappresentazione JSON 
{
  "dataRange": {
    object (GridRange)
  },
  "filterCriteria": {
    object (FilterCriteria)
  },
  "columnIndex": integer,
  "applyToPivotTables": boolean,
  "title": string,
  "textFormat": {
    object (TextFormat)
  },
  "backgroundColor": {
    object (Color)
  },
  "backgroundColorStyle": {
    object (ColorStyle)
  },
  "horizontalAlignment": enum (HorizontalAlign)
}
Campi
dataRange

object (GridRange)

L'intervallo di dati del controllo filtro.

filterCriteria

object (FilterCriteria)

I criteri di filtro del segmento.

columnIndex

integer

L'indice della colonna basato su zero nella tabella dei dati a cui viene applicato il filtro.

applyToPivotTables

boolean

True se il filtro deve essere applicato alle tabelle pivot. Se non viene impostato, il valore predefinito è True.

title

string

Il titolo del segmento.

textFormat

object (TextFormat)

Il formato del testo del titolo nel segmento. Il campo del link non è supportato.

backgroundColor
(deprecated)

object (Color)

Il colore di sfondo del cursore. Deprecata: utilizza backgroundColorStyle.

backgroundColorStyle

object (ColorStyle)

Il colore di sfondo del cursore. Se è impostato anche backgroundColor, questo campo ha la precedenza.

horizontalAlignment

enum (HorizontalAlign)

L'allineamento orizzontale del titolo nel segmento. Se non specificato, il valore predefinito è LEFT

Tabella

Una tabella.

Rappresentazione JSON 
{
  "tableId": string,
  "name": string,
  "range": {
    object (GridRange)
  },
  "rowsProperties": {
    object (TableRowsProperties)
  },
  "columnProperties": [
    {
      object (TableColumnProperties)
    }
  ]
}
Campi
tableId

string

L'ID della tabella.

name

string

Il nome della tabella. Questo valore è univoco per tutte le tabelle dello stesso foglio di lavoro.

range

object (GridRange)

L'intervallo della tabella.

rowsProperties

object (TableRowsProperties)

Le proprietà delle righe della tabella.

columnProperties[]

object (TableColumnProperties)

Le proprietà della colonna della tabella.

TableRowsProperties

Le proprietà della riga della tabella.

Rappresentazione JSON 
{
  "headerColorStyle": {
    object (ColorStyle)
  },
  "firstBandColorStyle": {
    object (ColorStyle)
  },
  "secondBandColorStyle": {
    object (ColorStyle)
  },
  "footerColorStyle": {
    object (ColorStyle)
  }
}
Campi
headerColorStyle

object (ColorStyle)

Il colore della riga di intestazione. Se questo campo è impostato, la riga di intestazione viene riempita con il colore specificato. In caso contrario, la riga di intestazione viene riempita con un colore predefinito.

firstBandColorStyle

object (ColorStyle)

Il primo colore alternato. Se questo campo è impostato, la prima riga a bande viene riempita con il colore specificato. In caso contrario, la prima riga a bande viene riempita con un colore predefinito.

secondBandColorStyle

object (ColorStyle)

Il secondo colore alternato. Se questo campo è impostato, la seconda riga a bande viene riempita con il colore specificato. In caso contrario, la seconda riga a bande viene riempita con un colore predefinito.

footerColorStyle

object (ColorStyle)

Il colore dell'ultima riga. Se questo campo non è impostato, non viene aggiunto un piè di pagina e l'ultima riga viene riempita con firstBandColorStyle o secondBandColorStyle, a seconda del colore della riga precedente. Se aggiorni una tabella esistente senza un piè di pagina in modo che ne abbia uno, l'intervallo verrà espanso di una riga. Se aggiorni una tabella esistente con un piè di pagina e lo rimuovi, l'intervallo verrà ridotto di una riga.

TableColumnProperties

La colonna della tabella.

Rappresentazione JSON 
{
  "columnIndex": integer,
  "columnName": string,
  "columnType": enum (ColumnType),
  "dataValidationRule": {
    object (TableColumnDataValidationRule)
  }
}
Campi
columnIndex

integer

L'indice di colonna a base 0. Questo indice è relativo alla sua posizione nella tabella e non corrisponde necessariamente all'indice di colonna nel foglio.

columnName

string

Il nome della colonna.

columnType

enum (ColumnType)

Il tipo di colonna.

dataValidationRule

object (TableColumnDataValidationRule)

La regola di convalida dei dati della colonna. Valore impostato solo per il tipo di colonna a discesa.

ColumnType

Il tipo di colonna per una determinata colonna in una tabella.

Enum
COLUMN_TYPE_UNSPECIFIED Un tipo di colonna non specificato.
DOUBLE Il tipo di colonna numerica.
CURRENCY Il tipo di colonna valuta.
PERCENT Il tipo di colonna percentuale.
DATE Il tipo di colonna data.
TIME Il tipo di colonna ora.
DATE_TIME Il tipo di colonna data e ora.
TEXT Il tipo di colonna di testo.
BOOLEAN Il tipo di colonna booleana.
DROPDOWN Il tipo di colonna del menu a discesa.
FILES_CHIP Il tipo di colonna chip di file
PEOPLE_CHIP Il tipo di colonna chip di persona
FINANCE_CHIP Il tipo di colonna chip finanziario
PLACE_CHIP Tipo di colonna con chip di luogo
RATINGS_CHIP Il tipo di colonna con chip di valutazione

TableColumnDataValidationRule

Una regola di convalida dei dati per una colonna di una tabella.

Rappresentazione JSON 
{
  "condition": {
    object (BooleanCondition)
  }
}
Campi
condition

object (BooleanCondition)

La condizione che i dati nella cella devono soddisfare. Valido solo se [BooleanCondition.type] è ONE_OF_LIST.