CellData
Dati relativi a una cella specifica.
Rappresentazione JSON |
---|
{ "userEnteredValue": { object ( |
Campi | |
---|---|
userEnteredValue
|
Il valore che l'utente ha inserito 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, è uguale 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 inserito dall'utente per la cella. Durante la scrittura, il nuovo formato verrà unito a quello esistente. |
effectiveFormat
|
Il formato effettivo utilizzato dalla cella. Ciò include i risultati dell'applicazione di qualsiasi formattazione condizionale e, se la cella contiene una formula, il formato numerico calcolato. Se quello predefinito è quello effettivo, quello effettivo 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, questo campo sarà vuoto. Questo campo è di sola lettura. Per impostarla, utilizza un
|
note
|
Qualsiasi nota sulla cella. |
textFormatRuns[]
|
Eseguono il formato RTF applicato alle sottosezioni della cella. Le esecuzioni sono valide solo per le stringhe inserite dall'utente, non per formule, bool o numeri. Le proprietà di un'esecuzione iniziano in corrispondenza di un indice specifico nel testo e continuano fino all'esecuzione successiva. Le esecuzioni erediteranno le proprietà della cella, a meno che non vengano modificate esplicitamente.
Durante la scrittura, le nuove esecuzioni sovrascriveranno quelle precedenti. Quando scrivi un nuovo
|
dataValidation
|
Una regola di convalida dei dati sulla cella, se presente. In fase di scrittura, la nuova regola di convalida dei dati sovrascriverà qualsiasi regola precedente. |
pivotTable
|
Una tabella pivot ancorata a questa cella. Le dimensioni della tabella pivot stessa vengono calcolate in modo dinamico in base ai dati, al raggruppamento, ai filtri, ai valori e così via. Solo la cella superiore sinistra della tabella pivot contiene la definizione della tabella pivot. Le altre celle conterranno i valori calcolati dei risultati del pivot nei loro
|
dataSourceTable
|
Una tabella dell'origine dati ancorata a questa cella. Le dimensioni della tabella dell'origine dati stessa vengono calcolate dinamicamente in base alla sua configurazione. Solo la prima cella della tabella dell'origine dati contiene la definizione della tabella. Le altre celle conterranno i valori visualizzati della tabella dell'origine dati nei
|
dataSourceFormula
|
Solo output. Informazioni sulla formula di un'origine dati nella cella. Il campo viene impostato se
|
CellFormat
Il formato di una cella.
Rappresentazione JSON |
---|
{ "numberFormat": { object ( |
Campi | |
---|---|
numberFormat
|
Un formato che descrive come i valori numerici devono essere rappresentati all'utente. |
backgroundColor
|
Il colore di sfondo della cella. Obsoleta: utilizza
|
backgroundColorStyle
|
Il colore di sfondo della cella. Se
|
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). Se si imposta un link a livello di cella, i collegamenti esistenti della cella vengono cancellati. L'impostazione del campo Link in un
|
hyperlinkDisplayType
|
Se ne esiste uno, come dovrebbe essere visualizzato un link ipertestuale nella cella. |
textRotation
|
La rotazione applicata al testo nella cella. |
NumberFormat
Il formato numerico di una cella.
Rappresentazione JSON |
---|
{
"type": enum (
|
Campi | |
---|---|
type
|
Il tipo di formato numerico. In fase di scrittura, è necessario impostare questo campo. |
pattern
|
Stringa del pattern utilizzata per la formattazione. Se non viene configurato, per il tipo specificato verrà utilizzato un pattern predefinito basato sulle impostazioni internazionali dell'utente. Consulta le Guida ai formati di data e numeri per ulteriori informazioni sui pattern supportati. |
NumberFormatType
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 sul contenuto 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 data e 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
|
Bordo superiore della cella. |
bottom
|
Bordo inferiore della cella. |
left
|
Il bordo sinistro della cella. |
right
|
Il bordo destro della cella. |
Bordo
Un bordo lungo una cella.
Rappresentazione JSON |
---|
{ "style": enum ( |
Campi | |
---|---|
style
|
Lo stile del bordo. |
width
|
Lo spessore del bordo, in pixel. Deprecato; la larghezza è determinata dallo "stile" . |
color
|
Il colore del bordo. Obsoleta: utilizza
|
colorStyle
|
Il colore del bordo. Se
|
Stile
Lo stile di un bordo.
Enum | |
---|---|
STYLE_UNSPECIFIED
|
Lo stile non è specificato. Non utilizzarlo. |
DOTTED
|
Il bordo è punteggiato. |
DASHED
|
Il bordo è tratteggiato. |
SOLID
|
Il bordo è una sottile linea continua. |
SOLID_MEDIUM
|
Il bordo è una linea continua media. |
SOLID_THICK
|
Il bordo è una linea continua spessa. |
NONE
|
Senza bordo. Utilizzato solo durante l'aggiornamento di un bordo per cancellarlo. |
DOUBLE
|
Il bordo è costituito da due linee continue. |
Spaziatura interna
La quantità di spaziatura interna attorno alla cella, in pixel. Quando aggiorni la spaziatura interna, è necessario specificare ogni campo.
Rappresentazione JSON |
---|
{ "top": integer, "right": integer, "bottom": integer, "left": integer } |
Campi | |
---|---|
top
|
Spaziatura interna superiore della cella. |
right
|
La spaziatura interna destra della cella. |
bottom
|
La spaziatura interna inferiore della cella. |
left
|
La spaziatura interna sinistra della cella. |
VerticalAlign
L'allineamento verticale del testo in una cella.
Enum | |
---|---|
VERTICAL_ALIGN_UNSPECIFIED
|
L'allineamento verticale non è specificato. Non utilizzarlo. |
TOP
|
Il testo è allineato esplicitamente nella parte superiore della cella. |
MIDDLE
|
Il testo è allineato esplicitamente al centro della cella. |
BOTTOM
|
Il testo è allineato esplicitamente alla parte inferiore della cella. |
WrapStrategy
Eseguire il wrapping di un testo in una cella.
Enum | |
---|---|
WRAP_STRATEGY_UNSPECIFIED
|
Il valore predefinito, non utilizzare. |
OVERFLOW_CELL
|
Le linee più lunghe della larghezza della cella verranno scritte nella cella successiva, purché sia vuota. Se la cella successiva non è vuota, si comporta come
|
LEGACY_WRAP
|
Questa strategia di wrapping rappresenta la vecchia strategia di wrapping di Fogli Google in cui le parole più lunghe di una riga vengono troncate anziché interrotte. Questa strategia non è supportata su tutte le piattaforme ed è in fase di eliminazione. Esempio:
|
CLIP
|
Le linee più lunghe della larghezza della cella verranno troncate. 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 aggregate a livello di carattere anziché troncate. Esempio:
|
TextDirection
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. |
HyperlinkDisplayType
Indica se eseguire il rendering esplicito di un link ipertestuale. Se non specificato, il link ipertestuale è collegato.
Enum | |
---|---|
HYPERLINK_DISPLAY_TYPE_UNSPECIFIED
|
Il valore predefinito: viene visualizzato il link ipertestuale. Non utilizzarlo. |
LINKED
|
Dovrebbe essere eseguito il rendering esplicito di un link ipertestuale. |
PLAIN_TEXT
|
Non dovrebbe essere visualizzato un link ipertestuale. |
TextRotation
La rotazione applicata al testo in una cella.
Rappresentazione JSON |
---|
{ // Union field |
Campi | |
---|---|
Campo unione
type . Il tipo di rotazione, verticale o angolare.
type
può essere solo uno dei seguenti:
|
|
angle
|
L'angolo tra l'orientamento standard e quello desiderato. Misurato in gradi. I valori validi sono compresi tra -90 e 90. Gli angoli positivi sono angolati verso l'alto, quelli negativi verso il basso. Nota: per la direzione del testo LTR, gli angoli positivi sono in senso antiorario, mentre per RTL sono in senso orario. |
vertical
|
Se impostato su true, il testo viene visualizzato dall'alto verso il basso, ma l'orientamento dei singoli caratteri rimane invariato. Ad esempio:
|
TextFormatRun
Un'esecuzione di un formato di testo. Il formato di questa esecuzione continua fino all'indice iniziale della successiva. Durante l'aggiornamento, tutti i campi devono essere impostati.
Rappresentazione JSON |
---|
{
"startIndex": integer,
"format": {
object (
|
Campi | |
---|---|
startIndex
|
L'indice di caratteri in base zero dove inizia questa esecuzione, nelle unità di codice UTF-16. |
format
|
Il formato di questa esecuzione. I valori assenti ereditano il formato della cella. |
DataValidationRule
Una regola di convalida dei dati.
Rappresentazione JSON |
---|
{
"condition": {
object (
|
Campi | |
---|---|
condition
|
La condizione che 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 il valore è true, "Elenco" verrà mostrato un menu a discesa. |
DataSourceTable
Una tabella dell'origine dati che consente all'utente di importare una tabella statica di dati dal
DataSource
in Fogli. Questo processo è anche noto come "estrazione" 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 dell'origine dati. Il valore predefinito è
|
columns[]
|
Colonne selezionate per la tabella dell'origine dati. La
|
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 limite 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. |
DataSourceTableColumnSelectionType
I tipi di selezione delle colonne della tabella dell'origine dati.
Enum | |
---|---|
DATA_SOURCE_TABLE_COLUMN_SELECTION_TYPE_UNSPECIFIED
|
Il tipo di selezione delle colonne predefinito, non utilizzare. |
SELECTED
|
Seleziona le colonne specificate da
columns
.
|
SYNC_ALL
|
Sincronizzare 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. |
DataSourceFormula
Una formula dell'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. |