Other

Kolor

Reprezentuje kolor w przestrzeni kolorów RGBA. Ta reprezentacja ma na celu uproszczenie procesu konwersji i zmiany kolorów w różnych językach, a nie ich kompaktowości. Na przykład pola tej reprezentacji można w prosty sposób przekazać do konstruktora java.awt.Color w języku Java; można ją też trywialnie przekazywać do interfejsu UIColor +colorWithRed:green:blue:alpha w systemie iOS. a przy niewielkim nakładzie pracy można go łatwo sformatować do formatu CSS rgba() w JavaScripcie.

Na tej stronie referencyjnej nie ma informacji o bezwzględnej przestrzeni kolorów, która powinna być wykorzystywana do interpretacji wartości RGB, np. sRGB, Adobe RGB, DCI-P3 i BT.2020. Domyślnie aplikacje powinny przyjąć przestrzeń kolorów sRGB.

Gdy należy ustalić równość kolorów, implementacje (o ile nie udokumentowano inaczej) traktuje 2 kolory jako równe, jeśli wszystkie ich wartości czerwonego, zielonego, niebieskiego i alfa różnią się co najmniej o maksymalnie 1e-5

Przykład (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();
 }
 // ...

Przykład (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;
}
// ...

Przykład (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('');
};

// ...
Zapis JSON
{
  "red": number,
  "green": number,
  "blue": number,
  "alpha": number
}
Pola
red

number

Ilość czerwonego koloru jako wartość z przedziału [0, 1].

green

number

Ilość zielonego koloru jako wartość przedziału [0, 1].

blue

number

Ilość niebieskiego koloru jako wartość z przedziału [0, 1].

alpha

number

Część tego koloru, która powinna zostać zastosowana do piksela. Oznacza to, że końcowy kolor w pikselach jest określony za pomocą tego równania:

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

Oznacza to, że wartość 1,0 odpowiada jednolitym kolorowi, a wartość 0,0 – kolorowi całkowicie przezroczystemu. Wykorzystuje komunikat opakowany, a nie prosty zmiennoprzecinkowy element skalarny, dzięki czemu można odróżnić wartość domyślną od nieskonfigurowanej wartości. Pominięcie tego obiektu koloru powoduje, że jest on renderowany jako jednolity kolor (jak gdyby wartość alfa miała jawnie 1,0).

ColorStyle

Wartość koloru.

Zapis 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.
}
Pola
Pole sumy kind Rodzaj wartości koloru. kind może być tylko jednym z tych elementów:
rgbColor

object (Color)

Kolor RGB. alpha w Color Obiekt nie jest ogólnie obsługiwany.

themeColor

enum (ThemeColorType)

Kolor motywu.

ThemeColorType

Typy kolorów motywu.

SpreadsheetProperties zawiera SpreadsheetTheme który definiuje mapowanie rodzajów kolorów w motywie na konkretne kolory.

Wartości w polu enum
THEME_COLOR_TYPE_UNSPECIFIED Nieokreślony kolor motywu
TEXT Reprezentuje podstawowy kolor tekstu
BACKGROUND Reprezentuje główny kolor tła
ACCENT1 Reprezentuje pierwszy kolor uzupełniający
ACCENT2 Reprezentuje drugi kolor uzupełniający
ACCENT3 Reprezentuje trzeci kolor uzupełniający
ACCENT4 Reprezentuje czwarty kolor uzupełniający
ACCENT5 Reprezentuje piąty kolor uzupełniający
ACCENT6 Reprezentuje szósty kolor uzupełniający

HorizontalAlign

Wyrównanie tekstu w poziomie w komórce.

Wartości w polu enum
HORIZONTAL_ALIGN_UNSPECIFIED Wyrównanie w poziomie nie zostało określone. Nie używaj tej opcji.
LEFT Tekst zostanie wyrównany do lewej krawędzi komórki.
CENTER Tekst jest wyrównany do środka komórki.
RIGHT Tekst jest wyrównany do prawej krawędzi komórki.

TextFormat

Format serii tekstu w komórce. Wartości nieobecne oznaczają, że pole nie zostało określone.

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

object (Color)

Kolor pierwszego planu tekstu. Wycofane: użyj foregroundColorStyle

foregroundColorStyle

object (ColorStyle)

Kolor pierwszego planu tekstu. Jeśli foregroundColor jest ustawiona, to pole ma pierwszeństwo.

fontFamily

string

Rodzina czcionek.

fontSize

integer

Rozmiar czcionki.

bold

boolean

Prawda, jeśli tekst jest pogrubiony.

italic

boolean

Prawda, jeśli tekst jest pisany kursywą.

strikethrough

boolean

Prawda, jeśli tekst jest przekreślony.

underline

boolean

Prawda, jeśli tekst jest podkreślony.

DataSourceColumn

Kolumna w źródle danych.

Zapis JSON
{
  "reference": {
    object (DataSourceColumnReference)
  },
  "formula": string
}
Pola
reference

object (DataSourceColumnReference)

Odwołanie do kolumny.

formula

string

Formuła obliczonej kolumny.

DataSourceColumnReference

Unikalny identyfikator odwołujący się do kolumny źródła danych.

Zapis JSON
{
  "name": string
}
Pola
name

string

Wyświetlana nazwa kolumny. Powinien być niepowtarzalny w obrębie źródła danych.

DataExecutionStatus

Stan wykonania danych.

Utworzenie zapytania do bazy danych w celu zsynchronizowania obiektu źródła danych z najnowszymi danymi z DataSource która jest zwykle uruchomiona w tle, możesz sprawdzić jej wydajność state czy wykonanie zapytania się zakończy

Istnieje kilka scenariuszy uruchomienia zapytania do bazy danych:

  • Adding a data source tworzy powiązany arkusz źródła danych, a także wykonanie danych, aby zsynchronizować dane ze źródła danych z arkuszem.
  • Updating a data source tworzy zapytanie do bazy danych, aby w podobny sposób odświeżyć powiązany arkusz źródła danych.
  • Możesz wysłać refresh request jawnego odświeżenia jednego lub wielu obiektów źródła danych.
Zapis JSON
{
  "state": enum (DataExecutionState),
  "errorCode": enum (DataExecutionErrorCode),
  "errorMessage": string,
  "lastRefreshTime": string
}
Pola
state

enum (DataExecutionState)

Stan wykonania danych.

errorCode

enum (DataExecutionErrorCode)

Kod błędu.

errorMessage

string

Komunikat o błędzie, który może być pusty.

lastRefreshTime

string (Timestamp format)

Pobiera czas ostatniego odświeżenia danych.

DataExecutionState

Lista stanów wykonania danych.

Wartości w polu enum
DATA_EXECUTION_STATE_UNSPECIFIED Wartość domyślna, nie używaj.
NOT_STARTED Nie uruchomiono zapytania do bazy danych.
RUNNING Zapytanie do bazy danych zostało uruchomione i trwa.
CANCELLING Anuluję wykonanie zapytania do bazy danych.
SUCCEEDED Zapytanie do bazy danych zostało ukończone.
FAILED Zapytanie do bazy danych zostało ukończone z błędami.

DataExecutionErrorCode

Lista kodów błędu wykonania kodu danych.

Wartości w polu enum
DATA_EXECUTION_ERROR_CODE_UNSPECIFIED Wartość domyślna, nie używaj.
TIMED_OUT Przekroczono limit czasu wykonywania zapytania do bazy danych.
TOO_MANY_ROWS Zapytanie do bazy danych zwróci więcej wierszy niż wynosi limit.
TOO_MANY_COLUMNS Zapytanie do bazy danych zwraca więcej kolumn, niż wynosi limit.
TOO_MANY_CELLS Zapytanie do bazy danych zwróci więcej komórek, niż wynosi limit.
ENGINE Odebrano błąd z mechanizmu wykonywania danych backendu (np. BigQuery). Sprawdź errorMessage .
PARAMETER_INVALID Co najmniej jeden z podanych parametrów źródła danych jest nieprawidłowy.
UNSUPPORTED_DATA_TYPE Zapytanie do bazy danych zwraca nieobsługiwany typ danych.
DUPLICATE_COLUMN_NAMES Zapytanie do bazy danych zwróci zduplikowane nazwy kolumn lub aliasy.
INTERRUPTED Generowanie danych zostało przerwane. Odśwież później.
CONCURRENT_QUERY Trwa wykonywanie działania dotyczącego danych i nie można go odświeżyć, dopóki się nie zakończy.
OTHER Inne błędy.
TOO_MANY_CHARS_PER_CELL Zapytanie do bazy danych zwraca wartości, które przekraczają maksymalną liczbę znaków dozwoloną w pojedynczej komórce.
DATA_NOT_FOUND Nie znaleziono bazy danych, do której odwołuje się źródło danych. */
PERMISSION_DENIED Użytkownik nie ma dostępu do bazy danych, do której odwołuje się źródło danych.
MISSING_COLUMN_ALIAS Zapytanie do bazy danych zwróci kolumny bez aliasów.
OBJECT_NOT_FOUND Obiekt źródła danych nie istnieje.
OBJECT_IN_ERROR_STATE Obiekt źródła danych jest obecnie w stanie błędu. Aby wymusić odświeżenie, ustaw force cale RefreshDataSourceRequest
OBJECT_SPEC_INVALID Specyfikacja obiektu źródła danych jest nieprawidłowa.
DATA_EXECUTION_CANCELLED Zapytanie do bazy danych zostało anulowane.

ExtendedValue

Rodzaje wartości, jakie może mieć komórka w arkuszu kalkulacyjnym.

Zapis 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.
}
Pola
Pole sumy value Typ wartości w komórce. Jeśli nie ustawiono żadnego pola, komórka nie zawiera danych. value może być tylko jednym z tych elementów:
numberValue

number

Reprezentuje wartość podwójnej precyzji. Uwaga: daty, godziny i daty i godziny są wyświetlane jako liczby zmiennoprzecinkowe w SERIAL_NUMBER .

stringValue

string

Reprezentuje wartość ciągu znaków. Pojedyncze cudzysłowy na początku nie są uwzględniane. Jeśli na przykład użytkownik wpisał '123 do interfejsu użytkownika, stringValue z "123"

boolValue

boolean

Reprezentuje wartość logiczną.

formulaValue

string

Reprezentuje formułę.

errorValue

object (ErrorValue)

Przedstawia błąd. To pole jest tylko do odczytu.

ErrorValue

Błąd w komórce.

Zapis JSON
{
  "type": enum (ErrorType),
  "message": string
}
Pola
type

enum (ErrorType)

Typ błędu.

message

string

Komunikat z dodatkowymi informacjami o błędzie (w ustawieniach regionalnych arkusza kalkulacyjnego).

ErrorType

Typ błędu.

Wartości w polu enum
ERROR_TYPE_UNSPECIFIED Domyślny typ błędu – nie używaj tego.
ERROR Odpowiada #ERROR! .
NULL_VALUE Odpowiada #NULL! .
DIVIDE_BY_ZERO Odpowiada #DIV/0 .
VALUE Odpowiada #VALUE! .
REF Odpowiada #REF! .
NAME Odpowiada #NAME? .
NUM Odpowiada #NUM! .
N_A Odpowiada #N/A .
LOADING Odpowiada Loading... stanu.

BooleanCondition

Warunek, który może przyjmować wartość prawda lub fałsz. Warunki BooleanCondition są używane przez formatowanie warunkowe, sprawdzanie poprawności danych i kryteria w filtrach.

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

enum (ConditionType)

Typ warunku.

values[]

object (ConditionValue)

Wartości warunku. Liczba obsługiwanych wartości zależy od condition type Niektóre mogą mieć wartość zerową, a inne 1 lub 2 wartości, ConditionType.ONE_OF_LIST obsługuje dowolną liczbę wartości.

ConditionType

Typ warunku.

Wartości w polu enum
CONDITION_TYPE_UNSPECIFIED Wartość domyślna – nie używaj.
NUMBER_GREATER Wartość komórki musi być większa niż wartość warunku. Funkcja jest obsługiwana przez sprawdzanie poprawności danych, formatowanie warunkowe i filtry. Wymaga jednej ConditionValue
NUMBER_GREATER_THAN_EQ Wartość komórki musi być większa od wartości warunku lub jej równa. Funkcja jest obsługiwana przez sprawdzanie poprawności danych, formatowanie warunkowe i filtry. Wymaga jednej ConditionValue
NUMBER_LESS Wartość komórki musi być mniejsza od wartości warunku. Funkcja jest obsługiwana przez sprawdzanie poprawności danych, formatowanie warunkowe i filtry. Wymaga jednej ConditionValue
NUMBER_LESS_THAN_EQ Wartość komórki musi być mniejsza od wartości warunku lub jej równa. Funkcja jest obsługiwana przez sprawdzanie poprawności danych, formatowanie warunkowe i filtry. Wymaga jednej ConditionValue
NUMBER_EQ Wartość komórki musi być równa wartości warunku. Funkcja jest obsługiwana przez sprawdzanie poprawności danych, formatowanie warunkowe i filtry. Wymaga jednej ConditionValue do sprawdzania poprawności danych, formatowania warunkowego oraz filtrów na obiektach niebędących źródłem danych i w co najmniej jednym ConditionValue do filtrów obiektów źródła danych.
NUMBER_NOT_EQ Wartość komórki nie może być równa wartości warunku. Funkcja jest obsługiwana przez sprawdzanie poprawności danych, formatowanie warunkowe i filtry. Wymaga jednej ConditionValue do sprawdzania poprawności danych, formatowania warunkowego oraz filtrów na obiektach niebędących źródłem danych i w co najmniej jednym ConditionValue do filtrów obiektów źródła danych.
NUMBER_BETWEEN Wartość komórki musi się mieścić między tymi 2 warunkami. Funkcja jest obsługiwana przez sprawdzanie poprawności danych, formatowanie warunkowe i filtry. Wymaga dokładnie 2 ConditionValues
NUMBER_NOT_BETWEEN Wartość komórki nie może należeć do zakresu 2 warunków. Funkcja jest obsługiwana przez sprawdzanie poprawności danych, formatowanie warunkowe i filtry. Wymaga dokładnie 2 ConditionValues
TEXT_CONTAINS Wartość komórki musi zawierać wartość warunku. Funkcja jest obsługiwana przez sprawdzanie poprawności danych, formatowanie warunkowe i filtry. Wymaga jednej ConditionValue
TEXT_NOT_CONTAINS Wartość komórki nie może zawierać wartości warunku. Funkcja jest obsługiwana przez sprawdzanie poprawności danych, formatowanie warunkowe i filtry. Wymaga jednej ConditionValue
TEXT_STARTS_WITH Wartość komórki musi zaczynać się od wartości warunku. Obsługiwane przez formatowanie warunkowe i filtry. Wymaga jednej ConditionValue
TEXT_ENDS_WITH Wartość komórki musi kończyć się wartością warunku. Obsługiwane przez formatowanie warunkowe i filtry. Wymaga jednej ConditionValue
TEXT_EQ Wartość komórki musi być dokładnie taką samą wartością warunku. Funkcja jest obsługiwana przez sprawdzanie poprawności danych, formatowanie warunkowe i filtry. Wymaga jednej ConditionValue do sprawdzania poprawności danych, formatowania warunkowego oraz filtrów na obiektach niebędących źródłem danych i w co najmniej jednym ConditionValue do filtrów obiektów źródła danych.
TEXT_IS_EMAIL Wartością komórki musi być prawidłowy adres e-mail. Obsługiwane przez funkcję sprawdzania poprawności danych. Nie wymaga ConditionValues
TEXT_IS_URL Wartość komórki musi być prawidłowym adresem URL. Obsługiwane przez funkcję sprawdzania poprawności danych. Nie wymaga ConditionValues
DATE_EQ Wartość komórki musi być tą samą datą co wartość warunku. Funkcja jest obsługiwana przez sprawdzanie poprawności danych, formatowanie warunkowe i filtry. Wymaga jednej ConditionValue do sprawdzania poprawności danych, formatowania warunkowego oraz filtrów na obiektach niebędących źródłem danych i w co najmniej jednym ConditionValue do filtrów obiektów źródła danych.
DATE_BEFORE Wartość komórki musi być wcześniejsza niż data wartości warunku. Funkcja jest obsługiwana przez sprawdzanie poprawności danych, formatowanie warunkowe i filtry. Wymaga jednej ConditionValue który może być relative date
DATE_AFTER Wartość komórki musi być późniejsza niż data wartości warunku. Funkcja jest obsługiwana przez sprawdzanie poprawności danych, formatowanie warunkowe i filtry. Wymaga jednej ConditionValue który może być relative date
DATE_ON_OR_BEFORE Wartość komórki musi przypadać przed datą wartości warunku. Obsługiwane przez funkcję sprawdzania poprawności danych. Wymaga jednej ConditionValue który może być relative date
DATE_ON_OR_AFTER Wartość komórki musi przypadać w dniu wartości warunku lub później. Obsługiwane przez funkcję sprawdzania poprawności danych. Wymaga jednej ConditionValue który może być relative date
DATE_BETWEEN Wartość komórki musi znajdować się między datami dwóch wartości warunku. Obsługiwane przez funkcję sprawdzania poprawności danych. Wymaga dokładnie 2 ConditionValues
DATE_NOT_BETWEEN Wartość komórki musi wykraczać poza daty dwóch wartości warunku. Obsługiwane przez funkcję sprawdzania poprawności danych. Wymaga dokładnie 2 ConditionValues
DATE_IS_VALID Wartością komórki musi być data. Obsługiwane przez funkcję sprawdzania poprawności danych. Nie wymaga ConditionValues
ONE_OF_RANGE Wartość komórki musi być wymieniona w siatce w zakresie wartości warunku. Obsługiwane przez funkcję sprawdzania poprawności danych. Wymaga jednej ConditionValue, a wartość musi być prawidłowym zakresem w notacji A1.
ONE_OF_LIST Wartość komórki musi znajdować się na liście wartości warunku. Obsługiwane przez funkcję sprawdzania poprawności danych. Obsługuje dowolną liczbę condition values, po 1 na element na liście. Formuły nie są obsługiwane w wartościach.
BLANK Wartość komórki musi być pusta. Obsługiwane przez formatowanie warunkowe i filtry. Nie wymaga ConditionValues
NOT_BLANK Wartość komórki nie może być pusta. Obsługiwane przez formatowanie warunkowe i filtry. Nie wymaga ConditionValues
CUSTOM_FORMULA Formuła warunku musi mieć wartość prawda. Funkcja jest obsługiwana przez sprawdzanie poprawności danych, formatowanie warunkowe i filtry. Nieobsługiwane przez filtry arkusza źródła danych. Wymaga jednej ConditionValue
BOOLEAN Komórka musi zawierać wartość TRUE/FALSE lub musi znajdować się na liście wartości warunku. Obsługiwane przez funkcję sprawdzania poprawności danych. Renderuje jako pole wyboru komórki. Może mieć wartość 0, 1 lub 2 ConditionValues Brak wartości wskazuje, że komórka musi mieć wartość TRUE lub FALSE, gdzie wartość TRUE (prawda) jest renderowana jako zaznaczona, a wartość FALSE (fałsz) jest wyświetlana jako odznaczona. Jedna wartość oznacza, że komórka będzie renderowana jako zaznaczona, jeśli zawiera daną wartość, i odznaczona, jeśli będzie pusta. Dwie wartości oznaczają, że komórka będzie renderowana jako zaznaczona, jeśli zawiera pierwszą wartość, i odznaczona, jeśli zawiera drugą. Na przykład [„Tak”, „Nie”] oznacza, że w komórce wyświetli się zaznaczone pole, jeśli ma ona wartość „Tak”. i niezaznaczone pole o wartości „Nie”.
TEXT_NOT_EQ Wartość komórki musi dokładnie różnić się od wartości warunku. Obsługiwane przez filtry obiektów źródła danych. Wymaga co najmniej jednej ConditionValue
DATE_NOT_EQ Wartość komórki musi dokładnie różnić się od wartości warunku. Obsługiwane przez filtry obiektów źródła danych. Wymaga co najmniej jednej ConditionValue
FILTER_EXPRESSION Wartość komórki musi być zgodna z określonym wzorcem. Wymaga jednej ConditionValue

ConditionValue

Wartość warunku.

Zapis 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.
}
Pola
Pole sumy value Wartość warunku. Musisz ustawić dokładnie jeden z nich. value może być tylko jednym z tych elementów:
relativeDate

enum (RelativeDate)

Data względna (na podstawie bieżącej daty). Prawidłowy tylko wtedy, gdy parametr type to DATE_BEFORE, DATE_AFTER, DATE_ON_OR_BEFORE lub DATE_ON_OR_AFTER.

Daty względne nie są obsługiwane podczas sprawdzania poprawności danych. Są one obsługiwane tylko w przypadku formatowania warunkowego i filtrów warunkowych.

userEnteredValue

string

Wartość, na której opiera się warunek. Wartość jest analizowana tak, jakby użytkownik wpisał ją w komórce. Formuły są obsługiwane (i muszą zaczynać się od = lub „+”).

RelativeDate

Kontroluje sposób oceny warunku związanego z datą.

Wartości w polu enum
RELATIVE_DATE_UNSPECIFIED Wartość domyślna, nie używaj.
PAST_YEAR Ta wartość przypada o rok wcześniej.
PAST_MONTH Ta wartość przypada przed dzisiejszą datą.
PAST_WEEK Ta wartość jest sprzed tygodnia.
YESTERDAY Wartość to wczoraj.
TODAY Wartość to dzisiejsza wartość.
TOMORROW Wartość to jutro.

GridRange

Zakres w arkuszu. Wartość wszystkich indeksów jest liczona od zera. Indeksy są w połowie otwarte, tzn. indeks początkowy jest uwzględniany, a indeks końcowy jest wyłączny ([startIndex, endIndex). Brak indeksów oznacza, że po tej stronie zakres jest nieograniczony.

Na przykład, jeśli "Sheet1" to identyfikator arkusza 123456, a następnie:

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

Wartość indeksu początkowego musi być zawsze mniejsza od indeksu końcowego lub jej równa. Jeśli indeks początkowy jest równy indeksowi końcowemu, zakres jest pusty. Puste zakresy zwykle nie mają znaczenia i są zazwyczaj renderowane w interfejsie jako #REF!

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

integer

Arkusz, w którym znajduje się ten zakres.

startRowIndex

integer

Wiersz początkowy (włącznie) zakresu lub nieustawiony, jeśli jest nieograniczony.

endRowIndex

integer

Wiersz końcowy (z wyłączeniem) zakresu lub nieustawiony, jeśli jest nieograniczony.

startColumnIndex

integer

Kolumna początkowa (włącznie) zakresu lub nieustawiona, jeśli jest nieograniczona.

endColumnIndex

integer

Kolumna końcowa zakresu (bez ograniczeń) lub nieustawiona, jeśli jest nieograniczona.

SortOrder

porządek sortowania,

Wartości w polu enum
SORT_ORDER_UNSPECIFIED Wartość domyślna – nie używaj jej.
ASCENDING Sortuj rosnąco.
DESCENDING Sortuj malejąco.

FilterSpec

Kryteria filtrowania powiązane z konkretną kolumną.

Zapis 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.
}
Pola
filterCriteria

object (FilterCriteria)

Kryteria kolumny.

Pole sumy reference Odwołanie do przefiltrowanej kolumny. reference może być tylko jednym z tych elementów:
columnIndex

integer

Indeks kolumny liczony od zera.

dataSourceColumnReference

object (DataSourceColumnReference)

Odwołanie do kolumny źródła danych.

FilterCriteria

Kryteria wyświetlania lub ukrywania wierszy w filtrze lub widoku filtra.

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

string

Wartości, które powinny być ukryte.

condition

object (BooleanCondition)

Warunek, który musi być spełniony, aby wyświetlały się wartości. (To nie zastępuje wartości hiddenValues -- jeśli jakaś wartość jest tam wymieniona, nadal będzie ukryta).

visibleBackgroundColor
(deprecated)

object (Color)

Kolor wypełnienia tła, według którego filtrować. wyświetlane są tylko komórki z tym kolorem wypełnienia. Wzajemnie wyklucza się z visibleForegroundColor Wycofane: użyj visibleBackgroundColorStyle

visibleBackgroundColorStyle

object (ColorStyle)

Kolor wypełnienia tła, według którego filtrować. wyświetlane są tylko komórki z tym kolorem wypełnienia. To pole wyklucza się wzajemnie z: visibleForegroundColor i musi być ustawiony na kolor typu RGB. Jeśli visibleBackgroundColor jest ustawiona, to pole ma pierwszeństwo.

visibleForegroundColor
(deprecated)

object (Color)

Kolor pierwszego planu, według którego filtrowane są: wyświetlane są tylko komórki w tym kolorze pierwszego planu. Wzajemnie wyklucza się z visibleBackgroundColor Wycofane: użyj visibleForegroundColorStyle

visibleForegroundColorStyle

object (ColorStyle)

Kolor pierwszego planu, według którego filtrowane są: wyświetlane są tylko komórki w tym kolorze pierwszego planu. To pole wyklucza się wzajemnie z: visibleBackgroundColor i musi być ustawiony na kolor typu RGB. Jeśli visibleForegroundColor jest ustawiona, to pole ma pierwszeństwo.

SortSpec

Kolejność sortowania powiązana z określoną kolumną lub wierszem.

Zapis 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.
}
Pola
sortOrder

enum (SortOrder)

Dane o zamówieniu należy posortować.

foregroundColor
(deprecated)

object (Color)

Kolor pierwszego planu, według którego odbywa się sortowanie. komórki o tym kolorze pierwszego planu są posortowane na górze. Wzajemnie wyklucza się z backgroundColor Wycofane: użyj foregroundColorStyle

foregroundColorStyle

object (ColorStyle)

Kolor pierwszego planu, według którego odbywa się sortowanie. komórki o tym kolorze pierwszego planu są posortowane na górze. Wzajemnie wyklucza się z backgroundColor i musi być kolorem typu RGB. Jeśli foregroundColor jest ustawiona, to pole ma pierwszeństwo.

backgroundColor
(deprecated)

object (Color)

Kolor wypełnienia tła; komórki z tym kolorem wypełnienia są posortowane na górze. Wzajemnie wyklucza się z foregroundColor Wycofane: użyj backgroundColorStyle

backgroundColorStyle

object (ColorStyle)

Kolor wypełnienia tła; komórki z tym kolorem wypełnienia są posortowane na górze. Wzajemnie wyklucza się z foregroundColor i musi być kolorem typu RGB. Jeśli backgroundColor jest ustawiona, to pole ma pierwszeństwo.

Pole sumy reference Odniesienie do sortowanego wymiaru. reference może być tylko jednym z tych elementów:
dimensionIndex

integer

Wymiar, którego ma dotyczyć sortowanie.

dataSourceColumnReference

object (DataSourceColumnReference)

Odwołanie do kolumny źródła danych.

EmbeddedObjectPosition

Pozycja umieszczonego obiektu, np. wykresu.

Zapis 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.
}
Pola
Pole sumy location Lokalizacja obiektu. Musisz ustawić dokładnie jedną wartość. location może być tylko jednym z tych elementów:
sheetId

integer

Arkusz, w którym znajduje się ten element. Ustaw tylko wtedy, gdy umieszczony obiekt znajduje się w osobnym arkuszu. Wartość musi być nieujemna.

overlayPosition

object (OverlayPosition)

Pozycja, w której obiekt jest nałożony na siatkę.

newSheet

boolean

Jeśli ma wartość true (prawda), umieszczony obiekt zostanie umieszczony w nowym arkuszu, którego identyfikator zostanie wybrany za Ciebie. Używany tylko podczas pisania.

OverlayPosition

Lokalizacja, w której obiekt jest nałożony na siatkę.

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

object (GridCoordinate)

Komórka, z którą zakotwiczony jest obiekt.

offsetXPixels

integer

Przesunięcie w poziomie (w pikselach), po którym obiekt jest odsunięty od komórki zakotwiczenia.

offsetYPixels

integer

Odsunięcie obiektu w pionie (w pikselach), po którym obiekt jest odsunięty od komórki zakotwiczenia.

widthPixels

integer

Szerokość obiektu w pikselach. Domyślna wartość to 600.

heightPixels

integer

Wysokość obiektu w pikselach. Domyślna wartość to 371.

GridCoordinate

Współrzędna w arkuszu. Wartość wszystkich indeksów jest liczona od zera.

Zapis JSON
{
  "sheetId": integer,
  "rowIndex": integer,
  "columnIndex": integer
}
Pola
sheetId

integer

Arkusz, w którym znajduje się ta współrzędna.

rowIndex

integer

Indeks wiersza danej współrzędnej.

columnIndex

integer

Indeks kolumny danej współrzędnej.