Other

Colore

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

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

Quando è necessario stabilire la parità dei colori, le implementazioni, se non diversamente documentato, trattano due colori come se fossero uguali se tutti i valori di rosso, verde, blu e alpha differiscono al massimo 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. In altre parole, il colore pixel finale è definito dall'equazione:

pixel color = alpha * (this color) + (1.0 - alpha) * (background color)

Ciò significa che il valore 1,0 corrisponde a un colore a tinta unita, mentre il valore 0,0 corrisponde a un colore completamente trasparente. Viene utilizzato un messaggio wrapper anziché un semplice valore scalare in virgola mobile, in modo che sia possibile distinguere tra un valore predefinito e il valore che viene annullato. Se omesso, questo oggetto colore viene visualizzato come un colore a tinta unita (come se al valore alfa fosse stato esplicitamente assegnato un valore di 1,0).

ColorStyle

Un valore di 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
Campo di unione kind. Il tipo di valore del colore. kind può essere solo uno dei seguenti:
rgbColor

object (Color)

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

themeColor

enum (ThemeColorType)

Colore del tema.

ThemeColorType

Tipi di colori del tema.

SpreadsheetProperties contiene un valore 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 principale del testo
BACKGROUND Rappresenta il colore di sfondo principale
ACCENT1 Rappresenta il primo colore di contrasto
ACCENT2 Rappresenta il secondo colore di contrasto
ACCENT3 Rappresenta il terzo colore di contrasto
ACCENT4 Rappresenta il quarto colore intenso
ACCENT5 Rappresenta il quinto colore di contrasto
ACCENT6 Rappresenta il sesto colore di contrasto

HorizontalAlign

L'allineamento orizzontale del testo in una cella.

Enum
HORIZONTAL_ALIGN_UNSPECIFIED L'allineamento orizzontale non è specificato. Non utilizzarlo.
LEFT Il testo è esplicitamente allineato a sinistra della cella.
CENTER Il testo è esplicitamente allineato al centro della cella.
RIGHT Il testo è esplicitamente allineato a destra della cella.

TextFormat

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

Rappresentazione JSON 
{
  "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)

Il colore di primo piano del testo. Deprecato: 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

True se il testo è in corsivo.

strikethrough

boolean

True se il testo è barrato.

underline

boolean

True se il testo è sottolineato.

DataSourceColumn

Una colonna in un'origine dati.

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

object (DataSourceColumnReference)

Il riferimento della 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
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. Di solito è pianificata per l'esecuzione in background; puoi controllare la state per sapere se un'esecuzione è stata completata

Esistono diversi scenari in cui viene attivata l'esecuzione dei dati:

  • Adding a data source crea un foglio dell'origine dati associato e 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 associato.
  • Puoi inviare refresh request per aggiornare esplicitamente uno o più oggetti di 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)

Restituisce l'ora dell'ultimo aggiornamento dei dati riuscito.

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 è iniziata.
RUNNING L'esecuzione dei dati è iniziata ed è in esecuzione.
CANCELLING L'esecuzione dei dati è attualmente in fase di annullamento.
SUCCEEDED L'esecuzione dei dati è stata completata.
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 un numero di righe maggiore rispetto al limite.
TOO_MANY_COLUMNS L'esecuzione dei dati restituisce più colonne del limite.
TOO_MANY_CELLS L'esecuzione dei dati restituisce più celle rispetto al limite.
ENGINE Viene ricevuto un errore dal motore di esecuzione dei dati di backend (ad es. BigQuery). Consulta errorMessage per i dettagli.
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 di colonna o alias duplicati.
INTERRUPTED L'esecuzione dei dati è interrotta. Aggiorna più tardi.
CONCURRENT_QUERY L'esecuzione dei dati è attualmente in corso. Non può essere aggiornata fino al completamento.
OTHER Altri errori.
TOO_MANY_CHARS_PER_CELL L'esecuzione dei dati restituisce valori che superano il limite massimo di caratteri consentiti in una singola cella.
DATA_NOT_FOUND Impossibile trovare il database a cui fa riferimento l'origine dati. */
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 Al momento l'oggetto dell'origine dati è in stato di errore. Per forzare l'aggiornamento, imposta force in RefreshDataSourceRequest.
OBJECT_SPEC_INVALID La specifica dell'oggetto di origine dati non è valida.
DATA_EXECUTION_CANCELLED L'esecuzione dei dati è stata annullata.

ExtendedValue

I tipi di valore che una cella di un foglio di lavoro può avere.

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.
}
Campi
Campo di unione value. Il tipo di valore in una cella. Se non viene impostato alcun campo, la cella non contiene dati. value può essere solo uno dei seguenti:
numberValue

number

Rappresenta un valore doppio. Nota: le date, le ore e le date e ore sono rappresentate come doppie 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 nella UI, viene 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

Errore in una cella.

Rappresentazione JSON 
{
  "type": enum (ErrorType),
  "message": string
}
Campi
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 un valore true o false. Le condizioni booleane vengono utilizzate dalla formattazione condizionale, dalla convalida dei dati e dai criteri dei filtri.

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

enum (ConditionType)

Il tipo di condizione.

values[]

object (ConditionValue)

I valori della condizione. Il numero di valori supportati dipende da condition type. Alcune supportano valori zero, altre 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 di quello della condizione. Supportato dalla convalida dei dati, dalla formattazione condizionale e dai filtri. Richiede un singolo ConditionValue.
NUMBER_GREATER_THAN_EQ Il valore della cella deve essere maggiore o uguale al valore della condizione. Supportato dalla convalida dei dati, dalla formattazione condizionale e dai filtri. Richiede un singolo ConditionValue.
NUMBER_LESS Il valore della cella deve essere inferiore al valore della condizione. Supportato dalla convalida dei dati, dalla formattazione condizionale e dai filtri. Richiede un singolo ConditionValue.
NUMBER_LESS_THAN_EQ Il valore della cella deve essere inferiore o uguale al valore della condizione. Supportato dalla convalida dei dati, dalla formattazione condizionale e dai filtri. Richiede un singolo ConditionValue.
NUMBER_EQ Il valore della cella deve essere uguale al valore della condizione. Supportato dalla convalida dei dati, dalla formattazione condizionale e dai filtri. Richiede un singolo ConditionValue per la convalida dei dati, la formattazione condizionale e i filtri su oggetti non di origine dati e almeno un ConditionValue per i filtri sugli oggetti dell'origine dati.
NUMBER_NOT_EQ Il valore della cella deve essere diverso da quello della condizione. Supportato dalla convalida dei dati, dalla formattazione condizionale e dai filtri. Richiede un singolo ConditionValue per la convalida dei dati, la formattazione condizionale e i filtri su oggetti non di origine dati e almeno un ConditionValue per i filtri sugli oggetti dell'origine dati.
NUMBER_BETWEEN Il valore della cella deve essere compreso tra i due valori della condizione. Supportato dalla convalida dei dati, dalla formattazione condizionale e dai filtri. Richiede esattamente due ConditionValues.
NUMBER_NOT_BETWEEN Il valore della cella non deve essere compreso tra i due valori della condizione. Supportato dalla convalida dei dati, dalla formattazione condizionale e dai filtri. Richiede esattamente due ConditionValues.
TEXT_CONTAINS Il valore della cella deve contenere il valore della condizione. Supportato dalla convalida dei dati, dalla formattazione condizionale e dai filtri. Richiede un singolo ConditionValue.
TEXT_NOT_CONTAINS Il valore della cella non deve contenere il valore della condizione. Supportato dalla convalida dei dati, dalla formattazione condizionale e dai 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 dalla convalida dei dati, dalla formattazione condizionale e dai filtri. Richiede un singolo ConditionValue per la convalida dei dati, la formattazione condizionale e i filtri su oggetti non di origine dati e almeno un ConditionValue per i filtri sugli oggetti dell'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 dalla convalida dei dati, dalla formattazione condizionale e dai filtri. Richiede un singolo ConditionValue per la convalida dei dati, la formattazione condizionale e i filtri su oggetti non di origine dati e almeno un ConditionValue per i filtri sugli oggetti dell'origine dati.
DATE_BEFORE Il valore della cella deve essere precedente alla data del valore della condizione. Supportato dalla convalida dei dati, dalla formattazione condizionale e dai filtri. Richiede un singolo ConditionValue che potrebbe essere relative date.
DATE_AFTER Il valore della cella deve essere successivo alla data del valore della condizione. Supportato dalla convalida dei dati, dalla formattazione condizionale e dai filtri. Richiede un singolo ConditionValue che potrebbe essere relative date.
DATE_ON_OR_BEFORE Il valore della cella deve corrispondere o essere precedente alla data del valore della condizione. Supportato dalla convalida dei dati. Richiede un singolo ConditionValue che potrebbe essere relative date.
DATE_ON_OR_AFTER Il valore della cella deve corrispondere o essere successiva alla data del valore della condizione. Supportato dalla convalida dei dati. Richiede un singolo ConditionValue che potrebbe essere 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 non rientrare nelle 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 all'interno dell'intervallo del valore della condizione. Supportato dalla convalida dei dati. Richiede un singolo ConditionValue e il valore deve essere un intervallo valido in notazione A1.
ONE_OF_LIST Il valore della cella deve essere incluso nell'elenco dei valori della condizione. Supportato dalla convalida dei dati. Supporta qualsiasi numero di condition values, uno per elemento nell'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 il valore true. Supportato dalla convalida dei dati, dalla formattazione condizionale e dai filtri. Non supportata dai filtri del foglio di origine dati. Richiede un singolo ConditionValue.
BOOLEAN Il valore della cella deve essere TRUE/FALSE o nell'elenco dei valori della condizione. Supportato dalla convalida dei dati. Viene visualizzata come casella di controllo di una 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 visualizzato come non selezionato. 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 deselezionata quando contiene il secondo valore. Ad esempio, ["Sì","No"] indica che la cella mostrerà una casella selezionata quando presenta il valore "Sì" e una casella deselezionata quando il valore è "No".
TEXT_NOT_EQ Il valore della cella deve essere esattamente diverso dal valore della condizione. Supportata dai filtri sugli oggetti dell'origine dati. Richiede almeno un ConditionValue.
DATE_NOT_EQ Il valore della cella deve essere esattamente diverso dal valore della condizione. Supportata 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
Campo di unione value. Devi impostare il valore della condizione, esattamente uno. value può essere solo uno dei seguenti:
relativeDate

enum (RelativeDate)

Una data relativa (basata sulla data corrente). 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 avesse digitato una cella. Le formule sono supportate e devono iniziare con = o "+".

RelativeDate

Controlla il modo in cui viene valutata una condizione di data.

Enum
RELATIVE_DATE_UNSPECIFIED Valore predefinito, non utilizzare.
PAST_YEAR Il valore è un anno prima di oggi.
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 su un foglio. Tutti gli indici sono in base zero. Gli indici sono semiaperto, ad esempio l'indice iniziale è inclusivo e l'indice finale è escluso: [startIndex, endIndex). Gli indici mancanti indicano che l'intervallo è illimitato su quel lato.

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

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 di solito 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 oppure non impostata se non è limitata.

endRowIndex

integer

La riga finale (esclusiva) dell'intervallo oppure non impostata se non è limitata.

startColumnIndex

integer

La colonna iniziale (inclusa) dell'intervallo oppure non impostata se non è limitata.

endColumnIndex

integer

La colonna finale (esclusiva) dell'intervallo oppure non impostata se non è limitata.

SortOrder

Un ordinamento.

Enum
SORT_ORDER_UNSPECIFIED Valore predefinito, non utilizzarlo.
ASCENDING Ordine crescente.
DESCENDING Ordine decrescente.

FilterSpec

I criteri di filtro associati a una colonna specifica.

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.
}
Campi
filterCriteria

object (FilterCriteria)

I criteri per la colonna.

Campo di unione reference. Riferimento alla colonna filtrata. reference può essere solo uno dei seguenti:
columnIndex

integer

L'indice della colonna in base zero.

dataSourceColumnReference

object (DataSourceColumnReference)

Riferimento a una colonna dell'origine dati.

FilterCriteria

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

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

string

Valori che devono essere nascosti.

condition

object (BooleanCondition)

Una condizione che deve essere vera affinché i valori vengano visualizzati. Questa operazione non sostituisce hiddenValues: se un valore è presente nell'elenco, sarà comunque nascosto.

visibleBackgroundColor
(deprecated)

object (Color)

Il colore di riempimento dello sfondo in base al quale applicare il filtro; vengono visualizzate solo le celle con questo colore di riempimento. In esclusiva con visibleForegroundColor. Deprecato: utilizza visibleBackgroundColorStyle.

visibleBackgroundColorStyle

object (ColorStyle)

Il colore di riempimento dello sfondo in base al quale applicare il filtro; vengono visualizzate solo le celle con questo colore di riempimento. Questo campo si escludono 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)

Il colore di primo piano in base al quale applicare il filtro; vengono visualizzate solo le celle con questo colore in primo piano. In esclusiva con visibleBackgroundColor. Deprecato: utilizza visibleForegroundColorStyle.

visibleForegroundColorStyle

object (ColorStyle)

Il colore di primo piano in base al quale applicare il filtro; vengono visualizzate solo le celle con questo colore in primo piano. Questo campo si escludono a vicenda con visibleBackgroundColor e deve essere impostato su un colore di tipo RGB. Se è impostato anche visibleForegroundColor, questo campo ha la precedenza.

SortSpec

Ordinamento associato a una colonna o riga specifica.

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.
}
Campi
sortOrder

enum (SortOrder)

I dati dell'ordine devono essere ordinati.

foregroundColor
(deprecated)

object (Color)

Il colore di primo piano per l'ordinamento; le celle con questo colore in primo piano sono ordinate in alto. In esclusiva con backgroundColor. Deprecato: utilizza foregroundColorStyle.

foregroundColorStyle

object (ColorStyle)

Il colore di primo piano per l'ordinamento; le celle con questo colore in primo piano sono ordinate in alto. In esclusiva con backgroundColor e deve essere un colore di tipo RGB. Se è impostato anche foregroundColor, questo campo ha la precedenza.

backgroundColor
(deprecated)

object (Color)

Il colore di riempimento dello sfondo in base al quale ordinare; le celle con questo colore di riempimento vengono ordinate in alto. In esclusiva con foregroundColor. Deprecato: 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. In esclusiva con foregroundColor e deve essere un colore di tipo RGB. Se è impostato anche backgroundColor, questo campo ha la precedenza.

Campo di unione reference. Riferimento alla dimensione ordinata. reference può essere solo uno dei seguenti:
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 
{

  // 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 di unione location. La posizione dell'oggetto. Deve essere impostato esattamente un valore. location può essere solo uno dei seguenti:
sheetId

integer

Il foglio in cui si trova. Da impostare 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 è sovrapposto a una griglia.

newSheet

boolean

Se il valore è true, l'oggetto incorporato viene inserito su un nuovo foglio di cui viene scelto l'ID. Si utilizza solo in fase di scrittura.

OverlayPosition

La posizione in cui un oggetto è 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, con cui l'oggetto è sfalsato rispetto alla cella di ancoraggio.

offsetYPixels

integer

L'offset verticale, in pixel, con cui l'oggetto è sfalsato 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 in base zero.

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

integer

Il foglio in cui si trova questa coordinata.

rowIndex

integer

L'indice di riga della coordinata.

columnIndex

integer

L'indice di colonna della coordinata.