Other

Colore

Rappresenta un colore nello spazio colore RGBA. Questa rappresentazione è progettata per semplificare la conversione da e verso le rappresentazioni dei colori in varie lingue, piuttosto che per la compattezza. Ad esempio, i campi di questa rappresentazione possono essere forniti in modo semplice al costruttore di java.awt.Color in Java; possono anche essere forniti in modo semplice al metodo +colorWithRed:green:blue:alpha di UIColor in iOS; e, con un po' di lavoro, possono essere facilmente formattati in una stringa rgba() CSS in JavaScript.

Questa pagina di riferimento non contiene informazioni sullo spazio colore assoluto da utilizzare per interpretare il valore RGB, ad esempio sRGB, Adobe RGB, DCI-P3 e BT.2020. Per impostazione predefinita, le applicazioni devono utilizzare lo spazio colore sRGB.

Quando è necessario decidere l'uguaglianza dei colori, le implementazioni, se non diversamente documentato, considerano due colori uguali se tutti i loro valori di rosso, verde, blu e alfa differiscono al massimo di 1e-5.

Esempio (Java):

 import com.google.type.Color;

 // ...
 public static java.awt.Color fromProto(Color protocolor) {
   float alpha = protocolor.hasAlpha()
       ? protocolor.getAlpha().getValue()
       : 1.0;

   return new java.awt.Color(
       protocolor.getRed(),
       protocolor.getGreen(),
       protocolor.getBlue(),
       alpha);
 }

 public static Color toProto(java.awt.Color color) {
   float red = (float) color.getRed();
   float green = (float) color.getGreen();
   float blue = (float) color.getBlue();
   float denominator = 255.0;
   Color.Builder resultBuilder =
       Color
           .newBuilder()
           .setRed(red / denominator)
           .setGreen(green / denominator)
           .setBlue(blue / denominator);
   int alpha = color.getAlpha();
   if (alpha != 255) {
     result.setAlpha(
         FloatValue
             .newBuilder()
             .setValue(((float) alpha) / denominator)
             .build());
   }
   return resultBuilder.build();
 }
 // ...

Esempio (iOS / Obj-C):

 // ...
 static UIColor* fromProto(Color* protocolor) {
    float red = [protocolor red];
    float green = [protocolor green];
    float blue = [protocolor blue];
    FloatValue* alpha_wrapper = [protocolor alpha];
    float alpha = 1.0;
    if (alpha_wrapper != nil) {
      alpha = [alpha_wrapper value];
    }
    return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
 }

 static Color* toProto(UIColor* color) {
     CGFloat red, green, blue, alpha;
     if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
       return nil;
     }
     Color* result = [[Color alloc] init];
     [result setRed:red];
     [result setGreen:green];
     [result setBlue:blue];
     if (alpha <= 0.9999) {
       [result setAlpha:floatWrapperWithValue(alpha)];
     }
     [result autorelease];
     return result;
}
// ...

Esempio (JavaScript):

// ...

var protoToCssColor = function(rgbColor) {
   var redFrac = rgbColor.red || 0.0;
   var greenFrac = rgbColor.green || 0.0;
   var blueFrac = rgbColor.blue || 0.0;
   var red = Math.floor(redFrac * 255);
   var green = Math.floor(greenFrac * 255);
   var blue = Math.floor(blueFrac * 255);

   if (!('alpha' in rgbColor)) {
      return rgbToCssColor(red, green, blue);
   }

   var alphaFrac = rgbColor.alpha.value || 0.0;
   var rgbParams = [red, green, blue].join(',');
   return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
};

var rgbToCssColor = function(red, green, blue) {
  var rgbNumber = new Number((red << 16) | (green << 8) | blue);
  var hexString = rgbNumber.toString(16);
  var missingZeros = 6 - hexString.length;
  var resultBuilder = ['#'];
  for (var i = 0; i < missingZeros; i++) {
     resultBuilder.push('0');
  }
  resultBuilder.push(hexString);
  return resultBuilder.join('');
};

// ...

Rappresentazione JSON
{ "red": number, "green": number, "blue": number, "alpha": number }

Campi
`red`	`number` La quantità di rosso nel colore come valore nell'intervallo [0, 1].
`green`	`number` La quantità di verde nel colore come valore nell'intervallo [0, 1].
`blue`	`number` La quantità di blu nel colore come valore nell'intervallo [0, 1].
`alpha`	`number` La frazione di questo colore da applicare al pixel. ovvero il colore finale del pixel è definito dall'equazione: `pixel color = alpha * (this color) + (1.0 - alpha) * (background color)` Ciò significa che un valore pari a 1,0 corrisponde a un colore pieno, mentre un valore pari a 0,0 corrisponde a un colore completamente trasparente. Utilizza un messaggio wrapper anziché un semplice scalare float, in modo da poter distinguere tra un valore predefinito e il valore che viene annullato. Se omesso, questo oggetto colore viene visualizzato come un colore solido (come se al valore alfa fosse stato assegnato esplicitamente un valore di 1.0).

ColorStyle

Un valore colore.

Rappresentazione JSON
{ // Union field `kind` can be only one of the following: "rgbColor": { object (`Color`) }, "themeColor": enum (`ThemeColorType`) // End of list of possible types for union field `kind`. }

Campi

Campi
Campo unione `kind`. Il tipo di valore del colore. `kind` può essere solo uno dei seguenti tipi:
`rgbColor`	`object (Color)` Colore RGB. Il valore `alpha` nell'oggetto `Color` non è generalmente supportato.
`themeColor`	`enum (ThemeColorType)` Colore del tema.

Campo unione kind. Il tipo di valore del colore. kind può essere solo uno dei seguenti tipi:

rgbColor

object (Color)

Colore RGB. Il valore alpha nell'oggetto Color non è generalmente supportato.

themeColor

enum (ThemeColorType)

Colore del tema.

ThemeColorType

Tipi di colore del tema.

SpreadsheetProperties contengono un SpreadsheetTheme che definisce una mappatura di questi tipi di colori del tema a colori concreti.

Enum
`THEME_COLOR_TYPE_UNSPECIFIED`	Colore del tema non specificato
`TEXT`	Rappresenta il colore del testo principale
`BACKGROUND`	Rappresenta il colore di sfondo principale
`ACCENT1`	Rappresenta il primo colore di contrasto
`ACCENT2`	Rappresenta il secondo colore intenso
`ACCENT3`	Rappresenta il terzo colore di accento
`ACCENT4`	Rappresenta il quarto colore di accento
`ACCENT5`	Rappresenta il quinto colore di accento
`ACCENT6`	Rappresenta il sesto colore di accento
`LINK`	Rappresenta il colore da utilizzare per i link ipertestuali

HorizontalAlign

L'allineamento orizzontale del testo in una cella.

Enum
`HORIZONTAL_ALIGN_UNSPECIFIED`	L'allineamento orizzontale non è specificato. Non utilizzare questo.
`LEFT`	Il testo è allineato in modo esplicito a sinistra della cella.
`CENTER`	Il testo è allineato in modo esplicito al centro della cella.
`RIGHT`	Il testo è allineato in modo esplicito a destra della cella.

TextFormat

Il formato di una sequenza di testo in una cella. I valori assenti indicano che il campo non è specificato.

Rappresentazione JSON

Rappresentazione JSON
{ "foregroundColor": { object (`Color`) }, "foregroundColorStyle": { object (`ColorStyle`) }, "fontFamily": string, "fontSize": integer, "bold": boolean, "italic": boolean, "strikethrough": boolean, "underline": boolean, "link": { object (`Link`) } }

{
  "foregroundColor": {
    object (Color)
  },
  "foregroundColorStyle": {
    object (ColorStyle)
  },
  "fontFamily": string,
  "fontSize": integer,
  "bold": boolean,
  "italic": boolean,
  "strikethrough": boolean,
  "underline": boolean,
  "link": {
    object (Link)
  }
}

Campi
`foregroundColor (deprecated)`	`object (Color)` Questo elemento è deprecato. Il colore di primo piano del testo. Deprecata: utilizza `foregroundColorStyle`.
`foregroundColorStyle`	`object (ColorStyle)` Il colore di primo piano del testo. Se è impostato anche `foregroundColor`, questo campo ha la precedenza.
`fontFamily`	`string` La famiglia di caratteri.
`fontSize`	`integer` Le dimensioni del carattere.
`bold`	`boolean` True se il testo è in grassetto.
`italic`	`boolean` Vero se il testo è in corsivo.
`strikethrough`	`boolean` True se il testo è barrato.
`underline`	`boolean` True se il testo è sottolineato.
`link`	`object (Link)` La destinazione del link del testo, se presente. L'impostazione del campo del link in un `TextFormatRun` cancellerà i link esistenti della cella o un link a livello di cella impostato nella stessa richiesta. Quando viene impostato un link, il colore del testo in primo piano viene impostato sul colore predefinito del link e il testo viene sottolineato. Se questi campi vengono modificati nella stessa richiesta, verranno utilizzati questi valori anziché quelli predefiniti del link.

Link

Un riferimento esterno o locale.

Rappresentazione JSON
{ // Union field `destination` can be only one of the following: "uri": string // End of list of possible types for union field `destination`. }

Campi

Campi
Campo unione `destination`. La destinazione del link. `destination` può essere solo uno dei seguenti tipi:
`uri`	`string` L'identificatore del link.

Campo unione destination. La destinazione del link. destination può essere solo uno dei seguenti tipi:

uri

string

L'identificatore del link.

DataSourceColumn

Una colonna in un'origine dati.

Rappresentazione JSON
{ "reference": { object (`DataSourceColumnReference`) }, "formula": string }

Campi

Campi
`reference`	`object (DataSourceColumnReference)` Il riferimento alla colonna.
`formula`	`string` La formula della colonna calcolata.

reference

object (DataSourceColumnReference)

Il riferimento alla colonna.

formula

string

La formula della colonna calcolata.

DataSourceColumnReference

Un identificatore univoco che fa riferimento a una colonna dell'origine dati.

Rappresentazione JSON
{ "name": string }

Campi

Campi
`name`	`string` Nome visualizzato della colonna. Deve essere univoco all'interno di un'origine dati.

name

string

Nome visualizzato della colonna. Deve essere univoco all'interno di un'origine dati.

DataExecutionStatus

Lo stato di esecuzione dei dati.

Viene creata un'esecuzione dei dati per sincronizzare un oggetto dell'origine dati con i dati più recenti di un DataSource. In genere è programmato per essere eseguito in background. Puoi controllare il relativo state per sapere se un'esecuzione viene completata.

Esistono diversi scenari in cui viene attivata l'esecuzione di un'importazione di dati:

Adding a data source crea un foglio di origine dati associato, nonché un'esecuzione dei dati per sincronizzare i dati dall'origine dati al foglio.
Updating a data source crea un'esecuzione dei dati per aggiornare in modo simile il foglio dell'origine dati associata.
Puoi inviare refresh request per aggiornare esplicitamente uno o più oggetti dell'origine dati.

Rappresentazione JSON
{ "state": enum (`DataExecutionState`), "errorCode": enum (`DataExecutionErrorCode`), "errorMessage": string, "lastRefreshTime": string }

Campi
`state`	`enum (DataExecutionState)` Lo stato dell'esecuzione dei dati.
`errorCode`	`enum (DataExecutionErrorCode)` Il codice di errore.
`errorMessage`	`string` Il messaggio di errore, che potrebbe essere vuoto.
`lastRefreshTime`	`string (Timestamp format)` Recupera l'ora dell'ultimo aggiornamento riuscito dei dati.

DataExecutionState

Un'enumerazione degli stati di esecuzione dei dati.

Enum
`DATA_EXECUTION_STATE_UNSPECIFIED`	Valore predefinito, non utilizzare.
`NOT_STARTED`	L'esecuzione dei dati non è stata avviata.
`RUNNING`	L'esecuzione dei dati è stata avviata ed è in corso.
`CANCELLING`	L'esecuzione dei dati è attualmente in fase di annullamento.
`SUCCEEDED`	L'esecuzione dei dati è stata completata correttamente.
`FAILED`	L'esecuzione dei dati è stata completata con errori.

DataExecutionErrorCode

Un'enumerazione del codice di errore di esecuzione dei dati.

Enum
`DATA_EXECUTION_ERROR_CODE_UNSPECIFIED`	Valore predefinito, non utilizzare.
`TIMED_OUT`	Timeout dell'esecuzione dei dati.
`TOO_MANY_ROWS`	L'esecuzione dei dati restituisce più righe del limite.
`TOO_MANY_COLUMNS`	L'esecuzione dei dati restituisce un numero di colonne superiore al limite.
`TOO_MANY_CELLS`	L'esecuzione dei dati restituisce più celle del limite.
`ENGINE`	L'errore viene ricevuto dal motore di esecuzione dei dati di backend (ad es. BigQuery). Per i dettagli, consulta `errorMessage`.
`PARAMETER_INVALID`	Uno o alcuni dei parametri dell'origine dati forniti non sono validi.
`UNSUPPORTED_DATA_TYPE`	L'esecuzione dei dati restituisce un tipo di dati non supportato.
`DUPLICATE_COLUMN_NAMES`	L'esecuzione dei dati restituisce nomi o alias di colonna duplicati.
`INTERRUPTED`	L'esecuzione dei dati viene interrotta. Aggiorna più tardi.
`CONCURRENT_QUERY`	L'esecuzione dei dati è attualmente in corso e non può essere aggiornata finché non viene completata.
`OTHER`	Altri errori.
`TOO_MANY_CHARS_PER_CELL`	L'esecuzione dei dati restituisce valori che superano il numero massimo di caratteri consentiti in una singola cella.
`DATA_NOT_FOUND`	Il database a cui fa riferimento l'origine dati non è stato trovato. */
`PERMISSION_DENIED`	L'utente non ha accesso al database a cui fa riferimento l'origine dati.
`MISSING_COLUMN_ALIAS`	L'esecuzione dei dati restituisce colonne con alias mancanti.
`OBJECT_NOT_FOUND`	L'oggetto dell'origine dati non esiste.
`OBJECT_IN_ERROR_STATE`	L'oggetto dell'origine dati è attualmente in stato di errore. Per forzare l'aggiornamento, imposta `force` in `RefreshDataSourceRequest`.
`OBJECT_SPEC_INVALID`	La specifica dell'oggetto origine dati non è valida.
`DATA_EXECUTION_CANCELLED`	L'esecuzione dei dati è stata annullata.

ExtendedValue

I tipi di valori che una cella di un foglio di lavoro può contenere.

Rappresentazione JSON

Rappresentazione JSON
{ // Union field `value` can be only one of the following: "numberValue": number, "stringValue": string, "boolValue": boolean, "formulaValue": string, "errorValue": { object (`ErrorValue`) } // End of list of possible types for union field `value`. }

{

  // Union field value can be only one of the following:
  "numberValue": number,
  "stringValue": string,
  "boolValue": boolean,
  "formulaValue": string,
  "errorValue": {
    object (ErrorValue)
  }
  // End of list of possible types for union field value.
}

Campi
Campo unione `value`. Il tipo di valore in una cella. Se non è impostato alcun campo, la cella non contiene dati. `value` può essere solo uno dei seguenti tipi:
`numberValue`	`number` Rappresenta un valore doppio. Nota: date, ore e date/ore sono rappresentate come numeri doppi nel formato `SERIAL_NUMBER`.
`stringValue`	`string` Rappresenta un valore stringa. Le virgolette singole iniziali non sono incluse. Ad esempio, se l'utente ha digitato `'123` nell'interfaccia utente, questo valore verrà rappresentato come `stringValue` di `"123"`.
`boolValue`	`boolean` Rappresenta un valore booleano.
`formulaValue`	`string` Rappresenta una formula.
`errorValue`	`object (ErrorValue)` Rappresenta un errore. Questo campo è di sola lettura.

ErrorValue

Un errore in una cella.

Rappresentazione JSON
{ "type": enum (`ErrorType`), "message": string }

Campi

Campi
`type`	`enum (ErrorType)` Il tipo di errore.
`message`	`string` Un messaggio con ulteriori informazioni sull'errore (nelle impostazioni internazionali del foglio di lavoro).

type

enum (ErrorType)

Il tipo di errore.

message

string

Un messaggio con ulteriori informazioni sull'errore (nelle impostazioni internazionali del foglio di lavoro).

ErrorType

Il tipo di errore.

Enum
`ERROR_TYPE_UNSPECIFIED`	Il tipo di errore predefinito, non utilizzarlo.
`ERROR`	Corrisponde all'errore `#ERROR!`.
`NULL_VALUE`	Corrisponde all'errore `#NULL!`.
`DIVIDE_BY_ZERO`	Corrisponde all'errore `#DIV/0`.
`VALUE`	Corrisponde all'errore `#VALUE!`.
`REF`	Corrisponde all'errore `#REF!`.
`NAME`	Corrisponde all'errore `#NAME?`.
`NUM`	Corrisponde all'errore `#NUM!`.
`N_A`	Corrisponde all'errore `#N/A`.
`LOADING`	Corrisponde allo stato `Loading...`.

BooleanCondition

Una condizione che può restituire true o false. BooleanConditions vengono utilizzati dalla formattazione condizionale, dalla convalida dei dati e dai criteri nei filtri.

Rappresentazione JSON
{ "type": enum (`ConditionType`), "values": [ { object (`ConditionValue`) } ] }

Campi

Campi
`type`	`enum (ConditionType)` Il tipo di condizione.
`values[]`	`object (ConditionValue)` I valori della condizione. Il numero di valori supportati dipende da `condition type`. Alcuni supportano valori pari a zero, altri uno o due valori e `ConditionType.ONE_OF_LIST` supporta un numero arbitrario di valori.

type

enum (ConditionType)

Il tipo di condizione.

values[]

object (ConditionValue)

I valori della condizione. Il numero di valori supportati dipende da condition type. Alcuni supportano valori pari a zero, altri uno o due valori e ConditionType.ONE_OF_LIST supporta un numero arbitrario di valori.

ConditionType

Il tipo di condizione.

Enum
`CONDITION_TYPE_UNSPECIFIED`	Il valore predefinito, non utilizzare.
`NUMBER_GREATER`	Il valore della cella deve essere maggiore del valore della condizione. Supportato da convalida dei dati, formattazione condizionale e filtri. Richiede un singolo `ConditionValue`.
`NUMBER_GREATER_THAN_EQ`	Il valore della cella deve essere maggiore o uguale al valore della condizione. Supportato da convalida dei dati, formattazione condizionale e filtri. Richiede un singolo `ConditionValue`.
`NUMBER_LESS`	Il valore della cella deve essere inferiore al valore della condizione. Supportato da convalida dei dati, formattazione condizionale e filtri. Richiede un singolo `ConditionValue`.
`NUMBER_LESS_THAN_EQ`	Il valore della cella deve essere minore o uguale al valore della condizione. Supportato da convalida dei dati, formattazione condizionale e filtri. Richiede un singolo `ConditionValue`.
`NUMBER_EQ`	Il valore della cella deve essere uguale al valore della condizione. Supportato da convalida dei dati, formattazione condizionale e filtri. Richiede un singolo `ConditionValue` per la convalida dei dati, la formattazione condizionale e i filtri sugli oggetti non di origine dati e almeno un `ConditionValue` per i filtri sugli oggetti di origine dati.
`NUMBER_NOT_EQ`	Il valore della cella non deve essere uguale al valore della condizione. Supportato da convalida dei dati, formattazione condizionale e filtri. Richiede un singolo `ConditionValue` per la convalida dei dati, la formattazione condizionale e i filtri sugli oggetti non di origine dati e almeno un `ConditionValue` per i filtri sugli oggetti di origine dati.
`NUMBER_BETWEEN`	Il valore della cella deve essere compreso tra i due valori della condizione. Supportato da convalida dei dati, formattazione condizionale e filtri. Richiede esattamente due `ConditionValues`.
`NUMBER_NOT_BETWEEN`	Il valore della cella non deve essere compreso tra i due valori della condizione. Supportato da convalida dei dati, formattazione condizionale e filtri. Richiede esattamente due `ConditionValues`.
`TEXT_CONTAINS`	Il valore della cella deve contenere il valore della condizione. Supportato da convalida dei dati, formattazione condizionale e filtri. Richiede un singolo `ConditionValue`.
`TEXT_NOT_CONTAINS`	Il valore della cella non deve contenere il valore della condizione. Supportato da convalida dei dati, formattazione condizionale e filtri. Richiede un singolo `ConditionValue`.
`TEXT_STARTS_WITH`	Il valore della cella deve iniziare con il valore della condizione. Supportato dalla formattazione condizionale e dai filtri. Richiede un singolo `ConditionValue`.
`TEXT_ENDS_WITH`	Il valore della cella deve terminare con il valore della condizione. Supportato dalla formattazione condizionale e dai filtri. Richiede un singolo `ConditionValue`.
`TEXT_EQ`	Il valore della cella deve corrispondere esattamente al valore della condizione. Supportato da convalida dei dati, formattazione condizionale e filtri. Richiede un singolo `ConditionValue` per la convalida dei dati, la formattazione condizionale e i filtri sugli oggetti non di origine dati e almeno un `ConditionValue` per i filtri sugli oggetti di origine dati.
`TEXT_IS_EMAIL`	Il valore della cella deve essere un indirizzo email valido. Supportato dalla convalida dei dati. Non richiede `ConditionValues`.
`TEXT_IS_URL`	Il valore della cella deve essere un URL valido. Supportato dalla convalida dei dati. Non richiede `ConditionValues`.
`DATE_EQ`	Il valore della cella deve corrispondere alla data del valore della condizione. Supportato da convalida dei dati, formattazione condizionale e filtri. Richiede un singolo `ConditionValue` per la convalida dei dati, la formattazione condizionale e i filtri sugli oggetti non di origine dati e almeno un `ConditionValue` per i filtri sugli oggetti di origine dati.
`DATE_BEFORE`	Il valore della cella deve essere precedente alla data del valore della condizione. Supportato da convalida dei dati, formattazione condizionale e filtri. Richiede un singolo `ConditionValue` che può essere un `relative date`.
`DATE_AFTER`	Il valore della cella deve essere successivo alla data del valore della condizione. Supportato da convalida dei dati, formattazione condizionale e filtri. Richiede un singolo `ConditionValue` che può essere un `relative date`.
`DATE_ON_OR_BEFORE`	Il valore della cella deve essere uguale o precedente alla data del valore della condizione. Supportato dalla convalida dei dati. Richiede un singolo `ConditionValue` che può essere un `relative date`.
`DATE_ON_OR_AFTER`	Il valore della cella deve essere uguale o successivo alla data del valore della condizione. Supportato dalla convalida dei dati. Richiede un singolo `ConditionValue` che può essere un `relative date`.
`DATE_BETWEEN`	Il valore della cella deve essere compreso tra le date dei due valori della condizione. Supportato dalla convalida dei dati. Richiede esattamente due `ConditionValues`.
`DATE_NOT_BETWEEN`	Il valore della cella deve essere al di fuori delle date dei due valori della condizione. Supportato dalla convalida dei dati. Richiede esattamente due `ConditionValues`.
`DATE_IS_VALID`	Il valore della cella deve essere una data. Supportato dalla convalida dei dati. Non richiede `ConditionValues`.
`ONE_OF_RANGE`	Il valore della cella deve essere elencato nella griglia nell'intervallo del valore della condizione. Supportato dalla convalida dei dati. Richiede un singolo `ConditionValue` e il valore deve essere un intervallo valido nella notazione A1.
`ONE_OF_LIST`	Il valore della cella deve essere presente nell'elenco dei valori della condizione. Supportato dalla convalida dei dati. Supporta un numero qualsiasi di `condition values`, uno per ogni elemento dell'elenco. Le formule non sono supportate nei valori.
`BLANK`	Il valore della cella deve essere vuoto. Supportato dalla formattazione condizionale e dai filtri. Non richiede `ConditionValues`.
`NOT_BLANK`	Il valore della cella non deve essere vuoto. Supportato dalla formattazione condizionale e dai filtri. Non richiede `ConditionValues`.
`CUSTOM_FORMULA`	La formula della condizione deve restituire true. Supportato da convalida dei dati, formattazione condizionale e filtri. Non supportato dai filtri del foglio dell'origine dati. Richiede un singolo `ConditionValue`.
`BOOLEAN`	Il valore della cella deve essere TRUE/FALSE o nell'elenco dei valori di condizione. Supportato dalla convalida dei dati. Viene visualizzato come casella di controllo della cella. Supporta zero, uno o due `ConditionValues`. Nessun valore indica che la cella deve essere TRUE o FALSE, dove TRUE viene visualizzato come selezionato e FALSE come deselezionato. Un valore indica che la cella verrà visualizzata come selezionata quando contiene quel valore e deselezionata quando è vuota. Due valori indicano che la cella verrà visualizzata come selezionata quando contiene il primo valore e come non selezionata quando contiene il secondo valore. Ad esempio, ["Yes","No"] indica che la cella mostrerà una casella selezionata quando ha il valore "Yes" e una casella deselezionata quando ha il valore "No".
`TEXT_NOT_EQ`	Il valore della cella non deve corrispondere esattamente al valore della condizione. Supportato dai filtri sugli oggetti dell'origine dati. Richiede almeno un `ConditionValue`.
`DATE_NOT_EQ`	Il valore della cella non deve corrispondere esattamente al valore della condizione. Supportato dai filtri sugli oggetti dell'origine dati. Richiede almeno un `ConditionValue`.
`FILTER_EXPRESSION`	Il valore della cella deve seguire il pattern specificato. Richiede un singolo `ConditionValue`.

ConditionValue

Il valore della condizione.

Rappresentazione JSON
{ // Union field `value` can be only one of the following: "relativeDate": enum (`RelativeDate`), "userEnteredValue": string // End of list of possible types for union field `value`. }

Campi

Campi
Campo unione `value`. Il valore della condizione, deve essere impostato esattamente uno. `value` può essere solo uno dei seguenti tipi:
`relativeDate`	`enum (RelativeDate)` Una data relativa (in base alla data attuale). Valido solo se `type` è `DATE_BEFORE`, `DATE_AFTER`, `DATE_ON_OR_BEFORE` o `DATE_ON_OR_AFTER`. Le date relative non sono supportate nella convalida dei dati. Sono supportati solo nella formattazione condizionale e nei filtri condizionali.
`userEnteredValue`	`string` Un valore su cui si basa la condizione. Il valore viene analizzato come se l'utente lo avesse digitato in una cella. Le formule sono supportate (e devono iniziare con un `=` o un "+").

Campo unione value. Il valore della condizione, deve essere impostato esattamente uno. value può essere solo uno dei seguenti tipi:

relativeDate

enum (RelativeDate)

Una data relativa (in base alla data attuale). Valido solo se type è DATE_BEFORE, DATE_AFTER, DATE_ON_OR_BEFORE o DATE_ON_OR_AFTER.

Le date relative non sono supportate nella convalida dei dati. Sono supportati solo nella formattazione condizionale e nei filtri condizionali.

userEnteredValue

string

Un valore su cui si basa la condizione. Il valore viene analizzato come se l'utente lo avesse digitato in una cella. Le formule sono supportate (e devono iniziare con un = o un "+").

RelativeDate

Controlla in che modo viene valutata una condizione di data.

Enum
`RELATIVE_DATE_UNSPECIFIED`	Valore predefinito, non utilizzare.
`PAST_YEAR`	Il valore è un anno prima della data odierna.
`PAST_MONTH`	Il valore è un mese prima di oggi.
`PAST_WEEK`	Il valore è una settimana prima di oggi.
`YESTERDAY`	Il valore è ieri.
`TODAY`	Il valore è oggi.
`TOMORROW`	Il valore è domani.

GridRange

Un intervallo in un foglio. Tutti gli indici sono basati su zero. Gli indici sono semiaperti, ovvero l'indice iniziale è incluso e l'indice finale è escluso: [startIndex, endIndex). Gli indici mancanti indicano che l'intervallo non è delimitato su quel lato.

Ad esempio, se "Sheet1" è l'ID foglio 123456, allora:

Sheet1!A1:A1 == sheetId: 123456, startRowIndex: 0, endRowIndex: 1, startColumnIndex: 0, endColumnIndex: 1

Sheet1!A3:B4 == sheetId: 123456, startRowIndex: 2, endRowIndex: 4, startColumnIndex: 0, endColumnIndex: 2

Sheet1!A:B == sheetId: 123456, startColumnIndex: 0, endColumnIndex: 2

Sheet1!A5:B == sheetId: 123456, startRowIndex: 4, startColumnIndex: 0, endColumnIndex: 2

Sheet1 == sheetId: 123456

L'indice iniziale deve essere sempre inferiore o uguale all'indice finale. Se l'indice iniziale è uguale all'indice finale, l'intervallo è vuoto. Gli intervalli vuoti in genere non sono significativi e vengono visualizzati nell'interfaccia utente come #REF!.

Rappresentazione JSON
{ "sheetId": integer, "startRowIndex": integer, "endRowIndex": integer, "startColumnIndex": integer, "endColumnIndex": integer }

Campi
`sheetId`	`integer` Il foglio in cui si trova questo intervallo.
`startRowIndex`	`integer` La riga iniziale (inclusa) dell'intervallo o non impostata se illimitata.
`endRowIndex`	`integer` La riga finale (esclusa) dell'intervallo o non impostata se senza limiti.
`startColumnIndex`	`integer` La colonna iniziale (inclusa) dell'intervallo o non impostata se illimitata.
`endColumnIndex`	`integer` La colonna finale (esclusa) dell'intervallo o non impostata se illimitata.

SortOrder

Un ordinamento.

Enum
`SORT_ORDER_UNSPECIFIED`	Valore predefinito, non utilizzare questo valore.
`ASCENDING`	Ordina in ordine crescente.
`DESCENDING`	Ordina in ordine decrescente.

FilterSpec

I criteri di filtro associati a una colonna specifica.

Rappresentazione JSON

Rappresentazione JSON
{ "filterCriteria": { object (`FilterCriteria`) }, // Union field `reference` can be only one of the following: "columnIndex": integer, "dataSourceColumnReference": { object (`DataSourceColumnReference`) } // End of list of possible types for union field `reference`. }

{
  "filterCriteria": {
    object (FilterCriteria)
  },

  // Union field reference can be only one of the following:
  "columnIndex": integer,
  "dataSourceColumnReference": {
    object (DataSourceColumnReference)
  }
  // End of list of possible types for union field reference.
}

Campi
`filterCriteria`	`object (FilterCriteria)` I criteri per la colonna.
Campo unione `reference`. Riferimento alla colonna filtrata. `reference` può essere solo uno dei seguenti tipi:
`columnIndex`	`integer` L'indice di colonna in base zero.
`dataSourceColumnReference`	`object (DataSourceColumnReference)` Riferimento a una colonna dell'origine dati.

FilterCriteria

Criteri per mostrare o nascondere le righe in un filtro o in una visualizzazione filtrata.

Rappresentazione JSON

Rappresentazione JSON
{ "hiddenValues": [ string ], "condition": { object (`BooleanCondition`) }, "visibleBackgroundColor": { object (`Color`) }, "visibleBackgroundColorStyle": { object (`ColorStyle`) }, "visibleForegroundColor": { object (`Color`) }, "visibleForegroundColorStyle": { object (`ColorStyle`) } }

{
  "hiddenValues": [
    string
  ],
  "condition": {
    object (BooleanCondition)
  },
  "visibleBackgroundColor": {
    object (Color)
  },
  "visibleBackgroundColorStyle": {
    object (ColorStyle)
  },
  "visibleForegroundColor": {
    object (Color)
  },
  "visibleForegroundColorStyle": {
    object (ColorStyle)
  }
}

Campi
`hiddenValues[]`	`string` Valori da nascondere.
`condition`	`object (BooleanCondition)` Una condizione che deve essere `true` affinché i valori vengano mostrati. (Questo non esegue l'override di `hiddenValues` se un valore è elencato lì, rimarrà comunque nascosto.)
`visibleBackgroundColor (deprecated)`	`object (Color)` Questo elemento è deprecato. Il colore di riempimento dello sfondo in base al quale filtrare; vengono visualizzate solo le celle con questo colore di riempimento. Esclusivo con `visibleForegroundColor`. Deprecata: utilizza `visibleBackgroundColorStyle`.
`visibleBackgroundColorStyle`	`object (ColorStyle)` Il colore di riempimento dello sfondo in base al quale filtrare; vengono visualizzate solo le celle con questo colore di riempimento. Questo campo si esclude a vicenda con `visibleForegroundColor` e deve essere impostato su un colore di tipo RGB. Se è impostato anche `visibleBackgroundColor`, questo campo ha la precedenza.
`visibleForegroundColor (deprecated)`	`object (Color)` Questo elemento è deprecato. Il colore in primo piano in base al quale filtrare; vengono visualizzate solo le celle con questo colore in primo piano. Esclusivo con `visibleBackgroundColor`. Deprecata: utilizza `visibleForegroundColorStyle`.
`visibleForegroundColorStyle`	`object (ColorStyle)` Il colore in primo piano in base al quale filtrare; vengono visualizzate solo le celle con questo colore in primo piano. Questo campo si esclude a vicenda con `visibleBackgroundColor` e deve essere impostato su un colore di tipo RGB. Se è impostato anche `visibleForegroundColor`, questo campo ha la precedenza.

SortSpec

Un ordine di ordinamento associato a una colonna o una riga specifica.

Rappresentazione JSON

Rappresentazione JSON
{ "sortOrder": enum (`SortOrder`), "foregroundColor": { object (`Color`) }, "foregroundColorStyle": { object (`ColorStyle`) }, "backgroundColor": { object (`Color`) }, "backgroundColorStyle": { object (`ColorStyle`) }, // Union field `reference` can be only one of the following: "dimensionIndex": integer, "dataSourceColumnReference": { object (`DataSourceColumnReference`) } // End of list of possible types for union field `reference`. }

{
  "sortOrder": enum (SortOrder),
  "foregroundColor": {
    object (Color)
  },
  "foregroundColorStyle": {
    object (ColorStyle)
  },
  "backgroundColor": {
    object (Color)
  },
  "backgroundColorStyle": {
    object (ColorStyle)
  },

  // Union field reference can be only one of the following:
  "dimensionIndex": integer,
  "dataSourceColumnReference": {
    object (DataSourceColumnReference)
  }
  // End of list of possible types for union field reference.
}

Campi
`sortOrder`	`enum (SortOrder)` I dati sugli ordini devono essere ordinati.
`foregroundColor (deprecated)`	`object (Color)` Questo elemento è deprecato. Il colore in primo piano in base al quale ordinare; le celle con questo colore in primo piano vengono ordinate in alto. Esclusivo con `backgroundColor`. Deprecata: utilizza `foregroundColorStyle`.
`foregroundColorStyle`	`object (ColorStyle)` Il colore in primo piano in base al quale ordinare; le celle con questo colore in primo piano vengono ordinate in alto. Esclusivo con `backgroundColor` e deve essere un colore di tipo RGB. Se è impostato anche `foregroundColor`, questo campo ha la precedenza.
`backgroundColor (deprecated)`	`object (Color)` Questo elemento è deprecato. Il colore di riempimento dello sfondo in base al quale ordinare; le celle con questo colore di riempimento vengono ordinate in alto. Esclusivo con `foregroundColor`. Deprecata: utilizza `backgroundColorStyle`.
`backgroundColorStyle`	`object (ColorStyle)` Il colore di riempimento dello sfondo in base al quale ordinare; le celle con questo colore di riempimento vengono ordinate in alto. Esclusivo con `foregroundColor` e deve essere un colore di tipo RGB. Se è impostato anche `backgroundColor`, questo campo ha la precedenza.
Campo unione `reference`. Riferimento alla dimensione ordinata. `reference` può essere solo uno dei seguenti tipi:
`dimensionIndex`	`integer` La dimensione a cui deve essere applicato l'ordinamento.
`dataSourceColumnReference`	`object (DataSourceColumnReference)` Riferimento a una colonna dell'origine dati.

EmbeddedObjectPosition

La posizione di un oggetto incorporato, ad esempio un grafico.

Rappresentazione JSON

Rappresentazione JSON
{ // Union field `location` can be only one of the following: "sheetId": integer, "overlayPosition": { object (`OverlayPosition`) }, "newSheet": boolean // End of list of possible types for union field `location`. }

{

  // Union field location can be only one of the following:
  "sheetId": integer,
  "overlayPosition": {
    object (OverlayPosition)
  },
  "newSheet": boolean
  // End of list of possible types for union field location.
}

Campi
Campo unione `location`. La posizione dell'oggetto. È necessario impostare esattamente un valore. `location` può essere solo uno dei seguenti tipi:
`sheetId`	`integer` Il foglio in cui si trova. Imposta solo se l'oggetto incorporato si trova su un foglio separato. Non deve essere un valore negativo.
`overlayPosition`	`object (OverlayPosition)` La posizione in cui l'oggetto viene sovrapposto a una griglia.
`newSheet`	`boolean` Se è true, l'oggetto incorporato viene inserito in un nuovo foglio il cui ID viene scelto automaticamente. Utilizzato solo durante la scrittura.

OverlayPosition

La posizione in cui un oggetto viene sovrapposto a una griglia.

Rappresentazione JSON
{ "anchorCell": { object (`GridCoordinate`) }, "offsetXPixels": integer, "offsetYPixels": integer, "widthPixels": integer, "heightPixels": integer }

Campi
`anchorCell`	`object (GridCoordinate)` La cella a cui è ancorato l'oggetto.
`offsetXPixels`	`integer` L'offset orizzontale, in pixel, dell'oggetto rispetto alla cella di ancoraggio.
`offsetYPixels`	`integer` L'offset verticale, in pixel, dell'oggetto rispetto alla cella di ancoraggio.
`widthPixels`	`integer` La larghezza dell'oggetto, in pixel. Il valore predefinito è 600.
`heightPixels`	`integer` L'altezza dell'oggetto, in pixel. Il valore predefinito è 371.

GridCoordinate

Una coordinata in un foglio. Tutti gli indici sono basati su zero.

Rappresentazione JSON
{ "sheetId": integer, "rowIndex": integer, "columnIndex": integer }

Campi

Campi
`sheetId`	`integer` Il foglio in cui si trova questa coordinata.
`rowIndex`	`integer` L'indice di riga della coordinata.
`columnIndex`	`integer` L'indice della colonna della coordinata.

sheetId

integer

Il foglio in cui si trova questa coordinata.

rowIndex

integer

L'indice di riga della coordinata.

columnIndex

integer

L'indice della colonna della coordinata.

Other Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Colore

ColorStyle

ThemeColorType

HorizontalAlign

TextFormat

Link

DataSourceColumn

DataSourceColumnReference

DataExecutionStatus

DataExecutionState

DataExecutionErrorCode

ExtendedValue

ErrorValue

ErrorType

BooleanCondition

ConditionType

ConditionValue

RelativeDate

GridRange

SortOrder

FilterSpec

FilterCriteria

SortSpec

EmbeddedObjectPosition

OverlayPosition

GridCoordinate

Other