Dati cellulare
Dati relativi a una cella specifica.
Rappresentazione JSON |
---|
{ "userEnteredValue": { object ( |
Campi | |
---|---|
userEnteredValue
|
Il valore inserito dall'utente nella cella, ad es.
|
effectiveValue
|
Il valore effettivo della cella. Per le celle con formule, questo è il valore calcolato. Per le celle con valori letterali, corrisponde a userEnteredValue. Questo campo è di sola lettura |
formattedValue
|
Il valore formattato della cella. Si tratta del valore che viene mostrato all'utente. Questo campo è di sola lettura |
userEnteredFormat
|
Il formato specificato dall'utente per la cella. Quando scrivi, il nuovo formato verrà unito a quello esistente. |
effectiveFormat
|
Il formato effettivo utilizzato dalla cella. Sono inclusi i risultati dell'applicazione di qualsiasi formattazione condizionale e, se la cella contiene una formula, il formato dei numeri calcolati. Se il formato effettivo è quello predefinito, non verrà scritto. Questo campo è di sola lettura |
hyperlink
|
Un link ipertestuale a cui rimanda questa cella, se presente. Se la cella contiene più link ipertestuali, il campo è vuoto. Questo campo è di sola lettura Per impostarlo, utilizza una formula
|
note
|
Qualsiasi nota sulla cella. |
textFormatRuns[]
|
Esecuzioni di testo RTF applicate alle sottosezioni della cella. Le esecuzioni sono valide solo per le stringhe inserite dall'utente, non per le formule, i numeri o i numeri. Le proprietà di un'esecuzione iniziano con un indice specifico nel testo e continuano fino all'esecuzione successiva. Le esecuzioni ereditano le proprietà della cella a meno che non vengano modificate in modo esplicito.
Durante la scrittura, le nuove esecuzioni sovrascriveranno quelle precedenti. Quando scrivi un nuovo
|
dataValidation
|
Una regola di convalida dei dati per la cella, se presente. Quando scrivi, la nuova regola di convalida dei dati sovrascriverà qualsiasi regola precedente. |
pivotTable
|
Una tabella pivot ancorata a questa cella. Le dimensioni della tabella pivot vengono calcolate in modo dinamico in base ai dati, al raggruppamento, ai filtri, ai valori e così via. Solo la cella in alto a sinistra della tabella pivot contiene la definizione della tabella pivot. Le altre celle conterranno i valori calcolati dei risultati del pivot nei rispettivi campi |
dataSourceTable
|
Una tabella di origine dati ancorata a questa cella. Le dimensioni della tabella dell'origine dati vengono calcolate in modo dinamico in base alla relativa configurazione. Solo la prima cella della tabella di origine dati contiene la definizione della tabella di origine dati. Le altre celle conterranno i valori di visualizzazione della tabella dell'origine dati nei rispettivi campi |
dataSourceFormula
|
Solo output. Informazioni su una formula di origine dati sulla cella. Il campo è impostato se
|
Formato cella
Il formato di una cella.
Rappresentazione JSON |
---|
{ "numberFormat": { object ( |
Campi | |
---|---|
numberFormat
|
Un formato che descrive in che modo i valori numerici devono essere rappresentati all'utente. |
backgroundColor
|
Il colore di sfondo della cella. Deprecato: utilizza
|
backgroundColorStyle
|
Il colore di sfondo della cella. Se è impostato anche |
borders
|
I bordi della cella. |
padding
|
La spaziatura interna della cella. |
horizontalAlignment
|
L'allineamento orizzontale del valore nella cella. |
verticalAlignment
|
L'allineamento verticale del valore nella cella. |
wrapStrategy
|
La strategia di aggregazione per il valore nella cella. |
textDirection
|
La direzione del testo nella cella. |
textFormat
|
Il formato del testo nella cella (a meno che non venga sostituito da un'esecuzione del formato). L'impostazione di un link a livello di cella cancella i collegamenti esistenti della cella. L'impostazione del campo del link in |
hyperlinkDisplayType
|
Se esistente, il modo in cui un link ipertestuale deve essere visualizzato nella cella. |
textRotation
|
La rotazione applicata al testo nella cella. |
FormatoNumero
Il formato numerico di una cella.
Rappresentazione JSON |
---|
{
"type": enum (
|
Campi | |
---|---|
type
|
Il tipo del formato numerico. Durante la scrittura, questo campo deve essere impostato. |
pattern
|
Stringa del pattern utilizzata per la formattazione. Se non viene configurato, verrà utilizzato un pattern predefinito basato sulle impostazioni internazionali dell'utente, se necessario per il tipo specificato. Consulta la guida ai formati di data e numero per ulteriori informazioni sui pattern supportati. |
Tipo di formato numero
Il formato numerico della cella. In questa documentazione si presume che le impostazioni internazionali siano en_US, ma il formato effettivo dipende dalle impostazioni internazionali del foglio di lavoro.
Enum | |
---|---|
NUMBER_FORMAT_TYPE_UNSPECIFIED
|
Il formato numerico non è specificato e si basa sui contenuti della cella. Non utilizzarlo esplicitamente. |
TEXT
|
Formattazione del testo, ad esempio
1000.12
|
NUMBER
|
Formattazione dei numeri, ad esempio
1,000.12
|
PERCENT
|
Formattazione percentuale, ad esempio
10.12%
|
CURRENCY
|
Formattazione della valuta, ad esempio $1,000.12
|
DATE
|
Formattazione della data, ad esempio
9/26/2008
|
TIME
|
Formattazione dell'ora, ad esempio
3:59:00 PM
|
DATE_TIME
|
Formattazione di data+ora, ad esempio
9/26/08 15:59:00
|
SCIENTIFIC
|
Formattazione scientifica dei numeri, ad esempio
1.01E+03
|
Bordi
I bordi della cella.
Rappresentazione JSON |
---|
{ "top": { object ( |
Campi | |
---|---|
top
|
Il bordo superiore della cella. |
bottom
|
Il bordo inferiore della cella. |
left
|
Il bordo sinistro della cella. |
right
|
Il bordo destro della cella. |
Border
Un bordo lungo una cella.
Rappresentazione JSON |
---|
{ "style": enum ( |
Campi | |
---|---|
style
|
Lo stile del bordo. |
width
|
Lo spessore del bordo, in pixel. Obsoleto: la larghezza è determinata dal campo "stile". |
color
|
Il colore del bordo. Deprecato: utilizza
|
colorStyle
|
Il colore del bordo. Se è impostato anche |
Stile
Lo stile di un bordo.
Enum | |
---|---|
STYLE_UNSPECIFIED
|
Lo stile non è specificato. Non utilizzarlo. |
DOTTED
|
Il bordo è tratteggiato. |
DASHED
|
Il bordo è tratteggiato. |
SOLID
|
Il bordo è una sottile linea continua. |
SOLID_MEDIUM
|
Il bordo è una linea media e continua. |
SOLID_THICK
|
Il bordo è una linea continua spessa. |
NONE
|
Nessun bordo. Utilizzato solo quando si aggiorna un bordo per cancellarlo. |
DOUBLE
|
Il bordo è costituito da due linee continue. |
Spaziatura interna
La quantità di spaziatura interna intorno alla cella, in pixel. Quando aggiorni la spaziatura interna, ogni campo deve essere specificato.
Rappresentazione JSON |
---|
{ "top": integer, "right": integer, "bottom": integer, "left": integer } |
Campi | |
---|---|
top
|
La spaziatura interna superiore della cella. |
right
|
La spaziatura interna corretta della cella. |
bottom
|
Spaziatura interna inferiore della cella. |
left
|
Spaziatura interna sinistra della cella. |
Allineamento verticale
L'allineamento verticale del testo in una cella.
Enum | |
---|---|
VERTICAL_ALIGN_UNSPECIFIED
|
L'allineamento verticale non è specificato. Non utilizzarlo. |
TOP
|
Il testo è allineato esplicitamente alla parte superiore della cella. |
MIDDLE
|
Il testo è allineato esplicitamente al centro della cella. |
BOTTOM
|
Il testo è allineato esplicitamente alla parte inferiore della cella. |
WrapStrategy
Come inserire un testo a capo in una cella.
Enum | |
---|---|
WRAP_STRATEGY_UNSPECIFIED
|
Il valore predefinito, non utilizzare. |
OVERFLOW_CELL
|
Le righe più lunghe della larghezza della cella verranno scritte nella cella successiva, purché tale cella sia vuota. Se la cella successiva non è vuota, si comporta come
|
LEGACY_WRAP
|
Questa strategia di ritorno a capo rappresenta la vecchia strategia di wrapping di Fogli Google in cui le parole che sono più lunghe di una riga vengono ritagliate anziché spezzate. Questa strategia non è supportata su tutte le piattaforme e verrà gradualmente eliminata. Esempio:
|
CLIP
|
Le linee che superano la larghezza della cella verranno ritagliate. Il testo non andrà mai a capo nella riga successiva, a meno che l'utente non ne inserisca manualmente una nuova. Esempio:
|
WRAP
|
Le parole più lunghe di una riga vengono confezionate a livello di carattere anziché clip. Esempio:
|
Direzione testo
La direzione del testo in una cella.
Enum | |
---|---|
TEXT_DIRECTION_UNSPECIFIED
|
La direzione del testo non è specificata. Non utilizzarlo. |
LEFT_TO_RIGHT
|
La direzione del testo da sinistra a destra è stata impostata dall'utente. |
RIGHT_TO_LEFT
|
La direzione del testo da destra a sinistra è stata impostata dall'utente. |
Tipo di link ipertestuale
Indica se eseguire esplicitamente il rendering di un link ipertestuale. Se non specificato, il link ipertestuale è collegato.
Enum | |
---|---|
HYPERLINK_DISPLAY_TYPE_UNSPECIFIED
|
Il valore predefinito è il rendering del link ipertestuale. Non utilizzarlo. |
LINKED
|
Un link ipertestuale deve essere sottoposto a rendering esplicito. |
PLAIN_TEXT
|
Non occorre eseguire il rendering di un link ipertestuale. |
Rotazione testo
La rotazione applicata al testo di una cella.
Rappresentazione JSON |
---|
{ // Union field |
Campi | |
---|---|
Campo Union
type . Il tipo di rotazione, verticale o angolata.
type
può essere solo uno dei seguenti:
|
|
angle
|
L'angolo tra l'orientamento standard e l'orientamento desiderato. Misurato in gradi. I valori validi sono compresi tra -90 e 90. Gli angoli positivi sono inclinati verso l'alto, quelli negativi sono inclinati verso il basso. Nota: per la direzione del testo LTR, gli angoli positivi sono nella direzione antiorario, mentre per RTL sono nella direzione oraria |
vertical
|
Se true, il testo si legge dall'alto verso il basso, ma l'orientamento dei singoli caratteri è invariato. Ad esempio:
|
TextTextRun
L'esecuzione di un formato di testo. Il formato di questa esecuzione continua fino all'indice di inizio di quella successiva. Durante l'aggiornamento, è necessario impostare tutti i campi.
Rappresentazione JSON |
---|
{
"startIndex": integer,
"format": {
object (
|
Campi | |
---|---|
startIndex
|
L'indice dei caratteri in base zero pari a dove inizia questa esecuzione, nelle unità di codice UTF-16. |
format
|
Il formato di questa esecuzione. I valori assenti ereditano il formato della cella. |
Regola di convalida dei dati
Una regola di convalida dei dati.
Rappresentazione JSON |
---|
{
"condition": {
object (
|
Campi | |
---|---|
condition
|
La condizione in cui i dati nella cella devono corrispondere. |
inputMessage
|
Un messaggio da mostrare all'utente quando aggiunge dati alla cella. |
strict
|
True se i dati non validi devono essere rifiutati. |
showCustomUi
|
True se l'interfaccia utente deve essere personalizzata in base al tipo di condizione. Se true, visualizzerai un menu a discesa per le condizioni "List" (Elenco). |
Tabella di origine dati
Una tabella di origine dati che consente all'utente di importare una tabella statica di dati da DataSource
in Fogli. Questa procedura è nota anche come "Estrai" nell'editor di Fogli.
Rappresentazione JSON |
---|
{ "dataSourceId": string, "columnSelectionType": enum ( |
Campi | |
---|---|
dataSourceId
|
L'ID dell'origine dati a cui è associata la tabella dell'origine dati. |
columnSelectionType
|
Il tipo per selezionare le colonne per la tabella di origine dati. Il valore predefinito è |
columns[]
|
Colonne selezionate per la tabella di origine dati. |
filterSpecs[]
|
Filtra le specifiche nella tabella dell'origine dati. |
sortSpecs[]
|
Ordina le specifiche nella tabella dell'origine dati. Il risultato della tabella dell'origine dati viene ordinato in base alle specifiche di ordinamento. |
rowLimit
|
Il numero di righe da restituire. Se non viene configurato, viene applicato un limite predefinito. Fai riferimento all'editor di Fogli per il limite predefinito e massimo. |
dataExecutionStatus
|
Solo output. Lo stato di esecuzione dei dati. |
TipoOrigineTabellaTabellaTabellaFonte
I tipi di selezione della colonna della tabella di origine dati.
Enum | |
---|---|
DATA_SOURCE_TABLE_COLUMN_SELECTION_TYPE_UNSPECIFIED
|
Non utilizzare il tipo di selezione di colonna predefinito. |
SELECTED
|
Seleziona le colonne specificate dal campo
columns .
|
SYNC_ALL
|
Sincronizza tutte le colonne attuali e future nell'origine dati. Se impostata, la tabella dell'origine dati recupera tutte le colonne nell'origine dati al momento dell'aggiornamento. |
Formula origine dati
Una formula per l'origine dati.
Rappresentazione JSON |
---|
{
"dataSourceId": string,
"dataExecutionStatus": {
object (
|
Campi | |
---|---|
dataSourceId
|
L'ID dell'origine dati a cui è associata la formula. |
dataExecutionStatus
|
Solo output. Lo stato di esecuzione dei dati. |