Cells

CellData

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 che l'utente ha inserito nella cella. ad es. 1234, 'Hello', oppure =NOW() Nota: Date, Time e DateTimes sono rappresentate come doppie in serial number formato.

effectiveValue

object (ExtendedValue)

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

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 inserito dall'utente per la cella.

Durante la scrittura, il nuovo formato verrà unito a quello esistente.

effectiveFormat

object (CellFormat)

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.

note

string

Qualsiasi nota sulla cella.

textFormatRuns[]

object (TextFormatRun)

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

dataValidation

object (DataValidationRule)

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

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

dataSourceTable

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

dataSourceFormula

object (DataSourceFormula)

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

CellFormat

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 come i valori numerici devono essere rappresentati all'utente.

backgroundColor
(deprecated)

object (Color)

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

backgroundColorStyle

object (ColorStyle)

Il colore di sfondo della cella. Se 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). Se si imposta un link a livello di cella, i collegamenti esistenti della cella vengono cancellati. L'impostazione del campo Link in un TextFormatRun ha la precedenza sul link a livello di cella.

textRotation

object (TextRotation)

La rotazione applicata al testo nella cella.

NumberFormat

Il formato numerico di una cella.

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

enum (NumberFormatType)

Il tipo di formato numerico. In fase di scrittura, è necessario impostare questo campo.

pattern

string

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

object (Border)

Bordo superiore della cella.

bottom

object (Border)

Bordo inferiore della cella.

left

object (Border)

Il bordo sinistro della cella.

right

object (Border)

Il bordo destro della cella.

Bordo

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. Deprecato; la larghezza è determinata dallo "stile" .

color
(deprecated)

object (Color)

Il colore del bordo. Obsoleta: utilizza colorStyle.

colorStyle

object (ColorStyle)

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

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

integer

Spaziatura interna superiore della cella.

right

integer

La spaziatura interna destra della cella.

bottom

integer

La spaziatura interna inferiore della cella.

left

integer

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 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 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:

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

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

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

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

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

integer

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

boolean

Se impostato su true, il testo viene visualizzato dall'alto verso il basso, ma l'orientamento dei singoli caratteri rimane invariato. Ad esempio:

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

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

integer

L'indice di caratteri in base zero 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.

DataValidationRule

Una regola di convalida dei dati.

Rappresentazione JSON
{
  "condition": {
    object (BooleanCondition)
  },
  "inputMessage": string,
  "strict": boolean,
  "showCustomUi": boolean
}
Campi
condition

object (BooleanCondition)

La condizione che 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 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 (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 dell'origine dati. Il valore predefinito è SELECTED.

columns[]

object (DataSourceColumnReference)

Colonne selezionate per la tabella dell'origine dati. La 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 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

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