Cells

Dati cellulare

Dati relativi a una cella specifica.

Rappresentazione JSON 
{
  "userEnteredValue": {
    object (ExtendedValue)
  },
  "effectiveValue": {
    object (ExtendedValue)
  },
  "formattedValue": string,
  "userEnteredFormat": {
    object (CellFormat)
  },
  "effectiveFormat": {
    object (CellFormat)
  },
  "hyperlink": string,
  "note": string,
  "textFormatRuns": [
    {
      object (TextFormatRun)
    }
  ],
  "dataValidation": {
    object (DataValidationRule)
  },
  "pivotTable": {
    object (PivotTable)
  },
  "dataSourceTable": {
    object (DataSourceTable)
  },
  "dataSourceFormula": {
    object (DataSourceFormula)
  }
}
Campi
userEnteredValue

object (ExtendedValue)

Il valore inserito dall'utente nella cella, ad es. 1234, 'Hello' o =NOW() Nota: le date, le ore e le date e le ore sono rappresentate come doppie nel formato serial number.

effectiveValue

object (ExtendedValue)

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

string

Il valore formattato della cella. Si tratta del valore che viene mostrato all'utente. Questo campo è di sola lettura

userEnteredFormat

object (CellFormat)

Il formato specificato dall'utente per la cella.

Quando scrivi, il nuovo formato verrà unito a quello esistente.

effectiveFormat

object (CellFormat)

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

note

string

Qualsiasi nota sulla cella.

textFormatRuns[]

object (TextFormatRun)

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 userEnteredValue, le esecuzioni precedenti vengono cancellate.

dataValidation

object (DataValidationRule)

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

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

dataSourceTable

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

dataSourceFormula

object (DataSourceFormula)

Solo output. Informazioni su una formula di origine dati sulla cella. Il campo è impostato se userEnteredValue è una formula che fa riferimento a un foglio DATA_SOURCE, ad esempio =SUM(DataSheet!Column).

Formato cella

Il formato di una cella.

Rappresentazione JSON 
{
  "numberFormat": {
    object (NumberFormat)
  },
  "backgroundColor": {
    object (Color)
  },
  "backgroundColorStyle": {
    object (ColorStyle)
  },
  "borders": {
    object (Borders)
  },
  "padding": {
    object (Padding)
  },
  "horizontalAlignment": enum (HorizontalAlign),
  "verticalAlignment": enum (VerticalAlign),
  "wrapStrategy": enum (WrapStrategy),
  "textDirection": enum (TextDirection),
  "textFormat": {
    object (TextFormat)
  },
  "hyperlinkDisplayType": enum (HyperlinkDisplayType),
  "textRotation": {
    object (TextRotation)
  }
}
Campi
numberFormat

object (NumberFormat)

Un formato che descrive in che modo i valori numerici devono essere rappresentati all'utente.

backgroundColor
(deprecated)

object (Color)

Il colore di sfondo della cella. Deprecato: utilizza backgroundColorStyle.

backgroundColorStyle

object (ColorStyle)

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

borders

object (Borders)

I bordi della cella.

padding

object (Padding)

La spaziatura interna della cella.

horizontalAlignment

enum (HorizontalAlign)

L'allineamento orizzontale del valore nella cella.

verticalAlignment

enum (VerticalAlign)

L'allineamento verticale del valore nella cella.

wrapStrategy

enum (WrapStrategy)

La strategia di aggregazione per il valore nella cella.

textDirection

enum (TextDirection)

La direzione del testo nella cella.

textFormat

object (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 TextFormatRun ha la precedenza sul link a livello di cella.

textRotation

object (TextRotation)

La rotazione applicata al testo nella cella.

FormatoNumero

Il formato numerico di una cella.

Rappresentazione JSON 
{
  "type": enum (NumberFormatType),
  "pattern": string
}
Campi
type

enum (NumberFormatType)

Il tipo del formato numerico. Durante la scrittura, questo campo deve essere impostato.

pattern

string

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 (Border)
  },
  "bottom": {
    object (Border)
  },
  "left": {
    object (Border)
  },
  "right": {
    object (Border)
  }
}
Campi
top

object (Border)

Il bordo superiore della cella.

bottom

object (Border)

Il bordo inferiore della cella.

left

object (Border)

Il bordo sinistro della cella.

right

object (Border)

Il bordo destro della cella.

Border

Un bordo lungo una cella.

Rappresentazione JSON 
{
  "style": enum (Style),
  "width": integer,
  "color": {
    object (Color)
  },
  "colorStyle": {
    object (ColorStyle)
  }
}
Campi
style

enum (Style)

Lo stile del bordo.

width
(deprecated)

integer

Lo spessore del bordo, in pixel. Obsoleto: la larghezza è determinata dal campo "stile".

color
(deprecated)

object (Color)

Il colore del bordo. Deprecato: utilizza colorStyle.

colorStyle

object (ColorStyle)

Il colore del bordo. Se è impostato anche color, questo campo ha la precedenza.

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

integer

La spaziatura interna superiore della cella.

right

integer

La spaziatura interna corretta della cella.

bottom

integer

Spaziatura interna inferiore della cella.

left

integer

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 CLIP. Il testo non andrà mai a capo nella riga successiva, a meno che l'utente non ne inserisca manualmente una nuova. Esempio: 

| First sentence. |
| Manual newline that is very long. <- Text continues into next cell
| Next newline.   |
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: 

| Cell has a |
| loooooooooo| <- Word is clipped.
| word.      |
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: 

| First sentence. |
| Manual newline t| <- Text is clipped
| Next newline.   |
WRAP

Le parole più lunghe di una riga vengono confezionate a livello di carattere anziché clip. Esempio: 

| Cell has a |
| loooooooooo| <- Word is broken.
| ong word.  |

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
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 type can be only one of the following:
  "angle": integer,
  "vertical": boolean
  // End of list of possible types for union field type.
}
Campi
Campo Union type. Il tipo di rotazione, verticale o angolata. type può essere solo uno dei seguenti:
angle

integer

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

boolean

Se true, il testo si legge dall'alto verso il basso, ma l'orientamento dei singoli caratteri è invariato. Ad esempio: 

| V |
| e |
| r |
| t |
| i |
| c |
| a |
| l |

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 (TextFormat)
  }
}
Campi
startIndex

integer

L'indice dei caratteri in base zero pari a dove inizia questa esecuzione, nelle unità di codice UTF-16.

format

object (TextFormat)

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 (BooleanCondition)
  },
  "inputMessage": string,
  "strict": boolean,
  "showCustomUi": boolean
}
Campi
condition

object (BooleanCondition)

La condizione in cui i dati nella cella devono corrispondere.

inputMessage

string

Un messaggio da mostrare all'utente quando aggiunge dati alla cella.

strict

boolean

True se i dati non validi devono essere rifiutati.

showCustomUi

boolean

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 (DataSourceTableColumnSelectionType),
  "columns": [
    {
      object (DataSourceColumnReference)
    }
  ],
  "filterSpecs": [
    {
      object (FilterSpec)
    }
  ],
  "sortSpecs": [
    {
      object (SortSpec)
    }
  ],
  "rowLimit": integer,
  "dataExecutionStatus": {
    object (DataExecutionStatus)
  }
}
Campi
dataSourceId

string

L'ID dell'origine dati a cui è associata la tabella dell'origine dati.

columnSelectionType

enum (DataSourceTableColumnSelectionType)

Il tipo per selezionare le colonne per la tabella di origine dati. Il valore predefinito è SELECTED.

columns[]

object (DataSourceColumnReference)

Colonne selezionate per la tabella di origine dati. columnSelectionType deve essere SELECTED.

filterSpecs[]

object (FilterSpec)

Filtra le specifiche nella tabella dell'origine dati.

sortSpecs[]

object (SortSpec)

Ordina le specifiche nella tabella dell'origine dati. Il risultato della tabella dell'origine dati viene ordinato in base alle specifiche di ordinamento.

rowLimit

integer

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

object (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 (DataExecutionStatus)
  }
}
Campi
dataSourceId

string

L'ID dell'origine dati a cui è associata la formula.

dataExecutionStatus

object (DataExecutionStatus)

Solo output. Lo stato di esecuzione dei dati.