Questa pagina è stata tradotta dall'API Cloud Translation.

Cells

CellData

Dati su una cella specifica.

Rappresentazione JSON

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`) } }

{
  "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 esempio `1234`, `'Hello'` o `=NOW()` Nota: le date, le ore e le date e ore sono rappresentate come numeri doppi nel formato `serial number`.
`effectiveValue`	`object (ExtendedValue)` Il valore effettivo della cella. Per le celle con formule, si tratta del valore calcolato. Per le celle con valori letterali, è uguale a userEnteredValue. Questo campo è di sola lettura.
`formattedValue`	`string` Il valore formato 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. Sono inclusi 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`	`string` 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 impostarlo, utilizza una formula `=HYPERLINK` nel campo `userEnteredValue.formulaValue`. Un collegamento a livello di cella può essere impostato anche dal `userEnteredFormat.textFormat` campo. In alternativa, imposta un link ipertestuale nel `textFormatRun.format.link` campo che occupa l'intera cella.
`note`	`string` Qualsiasi nota sulla cella.
`textFormatRuns[]`	`object (TextFormatRun)` Sequenze di testo avanzato applicate a 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'esecuzione iniziano in un indice specifico del 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 vengono cancellate.
`dataValidation`	`object (DataValidationRule)` Una regola di convalida dei dati nella 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 dinamicamente 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 `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 del risultato della tabella dell'origine dati nei rispettivi campi `effectiveValue`.
`dataSourceFormula`	`object (DataSourceFormula)` Solo output. Informazioni su una formula dell'origine dati nella cella. Il campo viene impostato se `userEnteredValue` è una formula che fa riferimento a un foglio `DATA_SOURCE`, ad esempio `=SUM(DataSheet!Column)`.

CellFormat

Il formato di una cella.

Rappresentazione JSON

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`) } }

{
  "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)` Questo elemento è deprecato. 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 a capo 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). L'impostazione di un collegamento a livello di cella qui cancella i collegamenti esistenti della cella. L'impostazione del campo del link in un `TextFormatRun` ha la precedenza sul link a livello di cella.
`hyperlinkDisplayType`	`enum (HyperlinkDisplayType)` Se ne esiste uno, come dovrebbe essere visualizzato un link ipertestuale nella 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

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 è impostato, verrà utilizzato un pattern predefinito basato sulle impostazioni internazionali dell'utente, se necessario per il tipo specificato. Consulta la guida Formati di data e numeri per ulteriori informazioni sui pattern supportati.

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 è impostato, verrà utilizzato un pattern predefinito basato sulle impostazioni internazionali dell'utente, se necessario per il tipo specificato. Consulta la guida 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 sui contenuti della cella. Non utilizzarlo esplicitamente.
`TEXT`	Formattazione del testo, ad es.`1000.12`
`NUMBER`	Formattazione dei numeri, ad es.`1,000.12`
`PERCENT`	Formattazione percentuale, ad esempio `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 esempio `3:59:00 PM`
`DATE_TIME`	Formattazione della data e dell'ora, ad es.`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` Questo elemento è deprecato. La larghezza del bordo, in pixel. Deprecato; la larghezza è determinata dal campo "stile".
`color (deprecated)`	`object (Color)` Questo elemento è deprecato. Il colore del bordo. Deprecato: utilizza `colorStyle`.
`colorStyle`	`object (ColorStyle)` Il colore del bordo. Se è impostato anche il criterio `color`, questo campo ha la precedenza.

Stile

Lo stile di un bordo.

Enum
`STYLE_UNSPECIFIED`	Lo stile non è specificato. Non utilizzarlo.
`DOTTED`	Il bordo è tratteggiate.
`DASHED`	Il bordo è trattenuto.
`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. Viene utilizzato solo per aggiornare un bordo al fine di 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, è necessario specificare ogni campo.

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

Campi
`top`	`integer` Il riempimento superiore della cella.
`right`	`integer` Il rivestimento destro 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 questa opzione.
`TOP`	Il testo è allineato esplicitamente nella parte superiore della cella.
`MIDDLE`	Il testo viene allineato esplicitamente al centro della cella.
`BOTTOM`	Il testo è allineato esplicitamente alla parte inferiore della cella.

WrapStrategy

Come inserire un a capo in una cella.

Enum
`WRAP_STRATEGY_UNSPECIFIED`	Il valore predefinito, da 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, il comportamento è lo stesso di `CLIP`. Il testo non verrà mai a capo nella riga successiva, 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 a capo rappresenta la vecchia strategia di a capo di Fogli Google, in cui le parole più lunghe di una riga vengono tagliate anziché suddivise. Questa strategia non è supportata su tutte le piattaforme e verrà ritirata gradualmente. Esempio: `\| Cell has a \| \| loooooooooo\| <- Word is clipped. \| word. \|`
`CLIP`	Le righe più lunghe della larghezza della cella verranno troncate. Il testo non verrà mai a capo nella riga successiva, 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 a capo a livello di carattere anziché essere troncate. Esempio: `\| Cell has a \| \| loooooooooo\| <- Word is broken. \| ong word. \|`

TextDirection

La direzione del testo in una cella.

Enum
`TEXT_DIRECTION_UNSPECIFIED`	L'orientamento del testo non è specificato. Non utilizzare questa opzione.
`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: il link ipertestuale viene visualizzato. Non utilizzare questa opzione.
`LINKED`	Un link ipertestuale deve essere visualizzato esplicitamente.
`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

Campi
Campo unione `type`. Il tipo di rotazione, verticale o inclinata. `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 inclinati verso l'alto, mentre quelli negativi sono inclinati 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 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 \|`

Campo unione type. Il tipo di rotazione, verticale o inclinata. 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 inclinati verso l'alto, mentre quelli negativi sono inclinati 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 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

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

Campi
`startIndex`	`integer` L'indice di caratteri in base zero in cui 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.

startIndex

integer

L'indice di caratteri in base zero in cui 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 a cui devono corrispondere i dati nella cella.
`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, le condizioni "Elenco" mostreranno un menu a discesa.

DataSourceTable

Una tabella di origine dati che consente all'utente di importare una tabella statica di dati da DataSource in Fogli. Questa operazione è nota anche come "Estrai" nell'editor di Fogli.

Rappresentazione JSON

Rappresentazione JSON
{ "dataSourceId": string, "columnSelectionType": enum (`DataSourceTableColumnSelectionType`), "columns": [ { object (`DataSourceColumnReference`) } ], "filterSpecs": [ { object (`FilterSpec`) } ], "sortSpecs": [ { object (`SortSpec`) } ], "rowLimit": integer, "dataExecutionStatus": { object (`DataExecutionStatus`) } }

{
  "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. `columnSelectionType` deve essere `SELECTED`.
`filterSpecs[]`	`object (FilterSpec)` Specifiche dei filtri 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. Per il limite predefinito e il limite massimo, fai riferimento all'editor di 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 di colonne predefinito, da non utilizzare.

SELECTED Seleziona le colonne specificate dal campo columns.

Enum
`DATA_SOURCE_TABLE_COLUMN_SELECTION_TYPE_UNSPECIFIED`	Il tipo di selezione di colonne predefinito, da non utilizzare.
`SELECTED`	Seleziona le colonne specificate dal campo `columns`.
`SYNC_ALL`	Sincronizza tutte le colonne correnti e future nell'origine dati. Se impostato, la tabella dell'origine dati recupera tutte le colonne dell'origine dati al momento dell'aggiornamento.

SYNC_ALL

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

Se impostato, 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

Campi
`dataSourceId`	`string` L'ID dell'origine dati a cui è associata la formula.
`dataExecutionStatus`	`object (DataExecutionStatus)` Solo output. Lo stato di esecuzione dei dati.

dataSourceId

string

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

dataExecutionStatus

object (DataExecutionStatus)

Solo output. Lo stato di esecuzione dei dati.