Other

Colore

Rappresenta un colore nello spazio colore RGBA. Questa rappresentazione è progettata per la semplicità della conversione da e verso le rappresentazioni dei colori in varie lingue rispetto alla compattezza. Ad esempio, i campi di questa rappresentazione possono essere forniti facilmente al costruttore di java.awt.Color in Java; possono anche essere forniti facilmente al metodo +colorWithRed:green:blue:alpha di UIColor in iOS; e, con un po' di lavoro, possono essere facilmente formattati in una stringa CSS rgba() 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 dovrebbero assumere lo spazio colore sRGB.

Quando è necessario decidere l'uguaglianza dei colori, le implementazioni, a meno che non sia documentato diversamente, trattano due colori come uguali se tutti i valori di rosso, verde, blu e alfa differiscono ciascuno per un 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 compreso nell'intervallo [0, 1].

green

number

La quantità di verde nel colore come valore compreso nell'intervallo [0, 1].

blue

number

La quantità di blu nel colore come valore compreso nell'intervallo [0, 1].

alpha

number

La frazione di questo colore da applicare al pixel. In altre parole, il colore del pixel finale è definito dall'equazione:

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

Ciò significa che un valore di 1,0 corrisponde a un colore a tinta unita, mentre un valore di 0,0 corrisponde a un colore completamente trasparente. Viene utilizzato un messaggio wrapper anziché un semplice scalare float in modo da distinguere un valore predefinito dal valore non impostato. Se omesso, questo oggetto di colore viene visualizzato come un colore a tinta unita (come se al valore alfa fosse stato assegnato esplicitamente 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 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 colore del tema.

SpreadsheetProperties contiene un SpreadsheetTheme che definisce una mappatura di questi tipi di colori del tema a colori specifici.

Enum
THEME_COLOR_TYPE_UNSPECIFIED Colore 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 di contrasto
ACCENT3 Rappresenta il terzo colore di contrasto
ACCENT4 Rappresenta il quarto colore di contrasto
ACCENT5 Rappresenta il quinto colore di sfondo
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 utilizzare questa opzione.
LEFT Il testo è allineato esplicitamente a sinistra della cella.
CENTER Il testo è allineato esplicitamente al centro della cella.
RIGHT Il testo è allineato esplicitamente a destra della cella.

TextFormat

Il formato di una serie 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. Funzionalità deprecata: utilizza foregroundColorStyle.

foregroundColorStyle

object (ColorStyle)

Il colore di primo piano del testo. Se è impostato anche il criterio 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 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
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 è pianificato per l'esecuzione in background. Puoi controllare il relativo stato state per sapere se un'esecuzione è stata completata

Esistono diversi scenari in cui viene attivata l'esecuzione di 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 dati per aggiornare il foglio dell'origine dati associato in modo simile.
  • Puoi inviare refresh request per aggiornare esplicitamente uno o più oggetti 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 può 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 da utilizzare.
NOT_STARTED L'esecuzione dei dati non è stata avviata.
RUNNING L'esecuzione dei dati è stata avviata ed è in esecuzione.
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 da utilizzare.
TIMED_OUT L'esecuzione dei dati è scaduta.
TOO_MANY_ROWS L'esecuzione dei dati restituisce più righe del limite.
TOO_MANY_COLUMNS L'esecuzione dei dati restituisce più colonne rispetto 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 maggiori 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 ha restituito nomi o alias di colonna duplicati.
INTERRUPTED L'esecuzione dei dati è stata 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 dell'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ò 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 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:
numberValue

number

Rappresenta un valore doppio. Nota: Date, Time e DateTimes sono rappresentate come doppie nel formato SERIAL_NUMBER.

stringValue

string

Rappresenta un valore di stringa. Le virgolette singole iniziali non sono incluse. Ad esempio, se l'utente digitava '123 nella UI, questo valore sarebbe 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
type

enum (ErrorType)

Il tipo di errore.

message

string

Un messaggio con ulteriori informazioni sull'errore (nella lingua 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. Le condizioni booleane vengono utilizzate dalla formattazione condizionale, dalla convalida dei dati e dai criteri nei 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. 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, da non utilizzare.
NUMBER_GREATER Il valore della cella deve essere maggiore del valore 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 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 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 sugli oggetti non di origine dati e almeno un ConditionValue per i filtri sugli oggetti di origine dati.ConditionValue
NUMBER_NOT_EQ Il valore della cella deve essere diverso dal 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 dell'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 essere esattamente il 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 sugli oggetti non di origine dati e almeno un ConditionValue per i filtri sugli oggetti di origine dati.ConditionValue
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 essere la stessa 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 sugli oggetti non di origine dati e almeno un ConditionValue per i filtri sugli oggetti di origine dati.ConditionValue
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 può 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 può 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 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 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 esterno alle 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 in notazione A1.
ONE_OF_LIST Il valore della cella deve essere nell'elenco dei valori della condizione. Supportato dalla convalida dei dati. Supporta un numero illimitato di condition values, uno per 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 il valore true. Supportato dalla convalida dei dati, dalla formattazione condizionale e dai filtri. Non supportata dai filtri dei fogli dell'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. Rendering come 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 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 non selezionata quando contiene il secondo valore. Ad esempio, ["Sì","No"] indica che la cella mostrerà una casella selezionata quando ha il valore "Sì" e una casella deselezionata quando ha il valore "No".
TEXT_NOT_EQ Il valore della cella non deve essere esattamente uguale al valore della condizione. Supportato dai filtri sugli oggetti dell'origine dati. È necessario almeno un valore per ConditionValue.
DATE_NOT_EQ Il valore della cella non deve essere esattamente uguale al valore della condizione. Supportato da filtri sugli oggetti dell'origine dati. Richiede almeno un ConditionValue.
FILTER_EXPRESSION Il valore della cella deve seguire lo schema 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 unione value. Il valore della condizione, deve essere impostato esattamente uno. value può essere solo uno dei seguenti:
relativeDate

enum (RelativeDate)

Una data relativa (in base alla 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 in una cella. Le formule sono supportate (e devono iniziare con un = o un "+").

RelativeDate

Controlla la modalità di valutazione di una condizione di data.

Enum
RELATIVE_DATE_UNSPECIFIED Valore predefinito, non da 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 è la data odierna.
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 è limitato 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 sempre essere 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 delimitato.

endRowIndex

integer

La riga di fine (esclusa) dell'intervallo oppure non impostata se l'intervallo è illimitato.

startColumnIndex

integer

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

endColumnIndex

integer

La colonna di fine (esclusa) dell'intervallo oppure non impostata se l'intervallo è illimitato.

SortOrder

Un ordinamento.

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

FilterSpec

I criteri del 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 unione reference. Riferimento alla colonna filtrata. reference può essere solo uno dei seguenti:
columnIndex

integer

L'indice della colonna a partire da zero.

dataSourceColumnReference

object (DataSourceColumnReference)

Riferimento a una colonna dell'origine dati.

FilterCriteria

Criteri per mostrare/nascondere le righe in un filtro o in una visualizzazione 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. (questo non ha la precedenza su hiddenValues. Se un valore è elencato lì, rimarrà nascosto).

visibleBackgroundColor
(deprecated)

object (Color)

Il colore di riempimento dello sfondo in base al quale filtrare; vengono mostrate solo le celle con questo colore di riempimento. Si escludono a vicenda con visibleForegroundColor. Deprecato: utilizza visibleBackgroundColorStyle.

visibleBackgroundColorStyle

object (ColorStyle)

Il colore di riempimento dello sfondo in base al quale applicare il filtro. Vengono mostrate solo le celle con questo colore di riempimento. Questo campo è mutuamente esclusivo con visibleForegroundColor e deve essere impostato su un colore di tipo RGB. Se è impostato anche il criterio visibleBackgroundColor, questo campo ha la precedenza.

visibleForegroundColor
(deprecated)

object (Color)

Il colore in primo piano in base al quale applicare il filtro. Vengono mostrate solo le celle con questo colore in primo piano. Si escludono a vicenda con visibleBackgroundColor. Deprecato: utilizza visibleForegroundColorStyle.

visibleForegroundColorStyle

object (ColorStyle)

Il colore in primo piano da utilizzare come filtro; vengono mostrate solo le celle con questo colore in primo piano. Questo campo è mutuamente esclusivo 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 
{
  "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 in base al quale ordinare le celle. Le celle con questo colore di primo piano vengono ordinate in alto. Si escludono a vicenda con backgroundColor. Deprecato: utilizza foregroundColorStyle.

foregroundColorStyle

object (ColorStyle)

Il colore di primo piano in base al quale ordinare le celle. Le celle con questo colore di primo piano vengono ordinate in alto. È mutuamente esclusivo di 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. Le celle con questo colore di riempimento vengono ordinate in alto. Si escludono a vicenda con foregroundColor. Funzionalità deprecata: utilizza backgroundColorStyle.

backgroundColorStyle

object (ColorStyle)

Il colore di riempimento dello sfondo in base al quale ordinare; le celle con questo colore di riempimento sono ordinate nella parte superiore. È mutuamente esclusivo di foregroundColor e deve essere un colore di tipo RGB. Se è impostato anche il criterio backgroundColor, questo campo ha la precedenza.

Campo unione reference. Riferimento alla dimensione ordinata. reference può essere solo uno dei seguenti:
dimensionIndex

integer

La dimensione a cui applicare 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 unione location. La posizione dell'oggetto. È necessario impostare esattamente un valore. location può essere solo uno dei seguenti:
sheetId

integer

Il foglio in cui si trova. Imposta solo se l'oggetto incorporato si trova in un foglio a parte. Deve essere un numero non negativo.

overlayPosition

object (OverlayPosition)

La posizione in cui l'oggetto è sovrapposto a una griglia.

newSheet

boolean

Se impostato su true, l'oggetto incorporato viene inserito in un nuovo foglio di cui viene scelto l'ID. Utilizzato solo durante la 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, dell'offset dell'oggetto rispetto alla cella di ancoraggio.

offsetYPixels

integer

Lo scostamento 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
sheetId

integer

Il foglio in cui si trova questa coordinata.

rowIndex

integer

L'indice riga della coordinata.

columnIndex

integer

L'indice della colonna della coordinata.