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)
  },
  "chipRuns": [
    {
      object (ChipRun)
    }
  ]
}
Campi
userEnteredValue

object (ExtendedValue)

Il valore inserito dall'utente nella cella. Ad es. 1234, 'Hello' o =NOW() Nota: date, ore e date/ore sono rappresentate come numeri reali in 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, è uguale a userEnteredValue. Questo campo è di sola lettura.

formattedValue

string

Il valore formattato della cella. Questo è il valore visualizzato dall'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. Sono inclusi i risultati dell'applicazione di qualsiasi formattazione condizionale e, se la cella contiene una formula, il formato numerico calcolato. Se il formato effettivo è quello predefinito, non verrà scritto. Questo campo è di sola lettura.

note

string

Qualsiasi nota sulla cella.

textFormatRuns[]

object (TextFormatRun)

Sequenze di testo RTF applicate alle sottosezioni della cella. Le esecuzioni sono valide solo per le stringhe inserite dall'utente, non per formule, valori booleani o numeri. Le proprietà di un run iniziano a un indice specifico nel testo e continuano fino al run successivo. Le esecuzioni ereditano le proprietà della cella, a meno che non vengano modificate esplicitamente.

Durante la scrittura, le nuove corse sovrascriveranno quelle precedenti. Quando scrivi un nuovo userEnteredValue, le corse precedenti vengono cancellate.

dataValidation

object (DataValidationRule)

Una regola di convalida dei dati nella cella, se presente.

Durante la 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 vengono calcolate dinamicamente in base a dati, raggruppamento, filtri, 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 della tabella pivot nei relativi campi effectiveValue.

dataSourceTable

object (DataSourceTable)

Una tabella dell'origine dati ancorata a questa cella. Le dimensioni della tabella dell'origine dati vengono calcolate in modo dinamico in base alla sua configurazione. Solo la prima cella della tabella dell'origine dati contiene la definizione della tabella dell'origine dati. Le altre celle conterranno i valori di visualizzazione del risultato della tabella dell'origine dati nei relativi campi effectiveValue.

dataSourceFormula

object (DataSourceFormula)

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

chipRuns[]

object (ChipRun)

Facoltativo. Esecuzioni di chip applicate alle sottosezioni della cella. Le proprietà di un run iniziano a un indice specifico nel testo e continuano fino al run successivo.

Durante la lettura, vengono inclusi tutti i giri con e senza chip. Le corse senza chip avranno un valore Chip vuoto.

Quando scrivi, vengono incluse solo le corse con chip. Le sequenze contenenti chip hanno lunghezza 1 e sono rappresentate nel testo inserito dall'utente dal simbolo segnaposto "@". Le nuove esecuzioni sovrascriveranno quelle precedenti. La scrittura di un nuovo userEnteredValue cancellerà le corse precedenti.

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. Deprecata: 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)

Il riempimento 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 wrapping 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 di formattazione). Se imposti un collegamento a livello di cella qui, i collegamenti esistenti della cella vengono cancellati. L'impostazione del campo del 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. Durante la scrittura, questo campo deve essere impostato.

pattern

string

Stringa di pattern utilizzata per la formattazione. Se non impostato, verrà utilizzato un pattern predefinito basato sulle impostazioni internazionali del foglio di lavoro, se necessario per il tipo specificato. Consulta la guida ai formati di data e numero per ulteriori informazioni sui pattern supportati.

NumberFormatType

Il formato numerico della cella. In questa documentazione si presuppone 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 utilizzare questo valore in modo esplicito.
TEXT Formattazione del testo, ad es.1000.12
NUMBER Formattazione dei numeri, ad esempio, 1,000.12
PERCENT Formattazione percentuale, ad es.10.12%
CURRENCY Formattazione della valuta, ad esempio $1,000.12
DATE Formattazione della data, ad es.9/26/2008
TIME Formattazione dell'ora, ad es.3:59:00 PM
DATE_TIME Formattazione di data e ora, ad esempio 9/26/08 15:59:00
SCIENTIFIC Formattazione scientifica dei numeri, ad es.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.

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

La larghezza del bordo, in pixel. Obsoleto; la larghezza è determinata dal campo "style".

color
(deprecated)

object (Color)

Il colore del bordo. Deprecata: 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 utilizzare questo.
DOTTED Il bordo è punteggiato.
DASHED Il bordo è tratteggiato.
SOLID Il bordo è una linea continua sottile.
SOLID_MEDIUM Il bordo è una linea continua media.
SOLID_THICK Il bordo è una linea continua spessa.
NONE Nessun 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 intorno alla cella, in pixel. Quando aggiorni il padding, devi specificare ogni campo.

Rappresentazione JSON 
{
  "top": integer,
  "right": integer,
  "bottom": integer,
  "left": integer
}
Campi
top

integer

Il riempimento superiore della cella.

right

integer

Il riempimento a destra della cella.

bottom

integer

La spaziatura interna inferiore della cella.

left

integer

La spaziatura interna a sinistra della cella.

VerticalAlign

L'allineamento verticale del testo in una cella.

Enum
VERTICAL_ALIGN_UNSPECIFIED L'allineamento verticale non è specificato. Non utilizzare questo.
TOP Il testo è allineato in modo esplicito alla parte superiore della cella.
MIDDLE Il testo è allineato in modo esplicito al centro della cella.
BOTTOM Il testo è allineato in modo esplicito alla parte inferiore della cella.

WrapStrategy

Come mandare a capo il testo 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, a condizione che sia vuota. Se la cella successiva non è vuota, il comportamento è lo stesso di CLIP. Il testo non andrà mai a capo a meno che l'utente non inserisca manualmente una nuova riga. 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 ritorno a capo di Fogli Google, in cui le parole più lunghe di una riga vengono troncate anziché suddivise. Questa strategia non è supportata su tutte le piattaforme e verrà ritirata. Esempio: 

| Cell has a |
| loooooooooo| <- Word is clipped.
| word.      |
CLIP

Le righe più lunghe della larghezza della cella verranno troncate. Il testo non andrà mai a capo a meno che l'utente non inserisca manualmente una nuova riga. Esempio: 

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

Le parole più lunghe di una riga vengono mandate a capo 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 utilizzare questo.
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, l'hyperlink è collegato.

Enum
LINKED Un link ipertestuale deve essere visualizzato in modo esplicito.
PLAIN_TEXT Un link ipertestuale non deve essere visualizzato.

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 angolata. type può essere solo uno dei seguenti tipi:
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 inclinati verso l'alto, mentre quelli negativi sono inclinati verso il basso.

Nota: per la direzione del testo da sinistra a destra, gli angoli positivi sono in senso antiorario, mentre per la direzione da destra a sinistra sono in senso orario.

vertical

boolean

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

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

TextFormatRun

Una sequenza di un formato di testo. Il formato di questa esecuzione continua fino all'indice iniziale dell'esecuzione 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 in cui inizia questa esecuzione, in 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 soddisfare.

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, le condizioni "Elenco" mostreranno un menu a discesa.

DataSourceTable

Una tabella dell'origine dati, che consente all'utente di importare una tabella statica di dati da DataSource in Fogli. Questa operazione è anche nota come "Estrai" nell'editor 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. Il columnSelectionType deve essere SELECTED.

filterSpecs[]

object (FilterSpec)

Specifiche del filtro 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 impostato, viene applicato un limite predefinito. Per il limite predefinito e massimo, consulta l'editor Fogli.

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 dal campo columns.
SYNC_ALL

Sincronizza tutte le colonne correnti e future nell'origine dati.

Se impostata, la tabella dell'origine dati recupera tutte le colonne dell'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.

ChipRun

La corsa di un chip. Il chip continua fino all'indice iniziale dell'esecuzione successiva.

Rappresentazione JSON 
{
  "startIndex": integer,
  "chip": {
    object (Chip)
  }
}
Campi
startIndex

integer

Obbligatorio. L'indice dei caratteri in base zero in cui inizia questa esecuzione, in unità di codice UTF-16.

chip

object (Chip)

Facoltativo. Il chip di questa corsa.

Chip

Lo smart chip.

Rappresentazione JSON 
{

  // Union field properties can be only one of the following:
  "personProperties": {
    object (PersonProperties)
  },
  "richLinkProperties": {
    object (RichLinkProperties)
  }
  // End of list of possible types for union field properties.
}
Campi
Campo unione properties. Le proprietà del chip. properties può essere solo uno dei seguenti tipi:
personProperties

object (PersonProperties)

Proprietà di una persona collegata.

PersonProperties

Proprietà specifiche di una persona collegata.

Rappresentazione JSON 
{
  "email": string,
  "displayFormat": enum (DisplayFormat)
}
Campi
email

string

Obbligatorio. L'indirizzo email collegato a questa persona. Questo campo è sempre presente.

displayFormat

enum (DisplayFormat)

Facoltativo. Il formato di visualizzazione del chip persona. Se non viene impostato, viene utilizzato il formato di visualizzazione predefinito.

DisplayFormat

Formato di visualizzazione preferito, se disponibile.

Enum
DISPLAY_FORMAT_UNSPECIFIED Valore predefinito, non utilizzare.
DEFAULT Formato di visualizzazione predefinito.
LAST_NAME_COMMA_FIRST_NAME Formato di visualizzazione del cognome e del nome.
EMAIL Formato di visualizzazione dell'email.

RichLinkProperties

Proprietà di un link a una risorsa Google (ad esempio un file in Drive, un video di YouTube, un indirizzo di Maps o un evento di Calendar). Solo i file di Drive possono essere scritti come chip. Tutti gli altri tipi di link avanzati sono di sola lettura.

Gli URI non possono superare i 2000 byte durante la scrittura.

NOTA: per scrivere chip di file di Drive è necessario almeno uno degli ambiti OAuth drive.file, drive.readonly o drive.

Rappresentazione JSON 
{
  "uri": string,
  "mimeType": string
}
Campi
uri

string

Obbligatorio. L'URI del link. Questo è sempre presente.

mimeType

string

Solo output. Il tipo MIME del link, se presente (ad esempio, quando si tratta di un file in Drive).