Other

Kolor

Reprezentuje kolor w przestrzeni barw RGBA. Ta reprezentacja została zaprojektowana z myślą o łatwości konwersji na reprezentacje kolorów w różnych językach i z nich, a nie o kompaktowości. Na przykład pola tej reprezentacji można w prosty sposób przekazać do konstruktora java.awt.Colorw języku Java, a także do metody +colorWithRed:green:blue:alphaUIColor w systemie iOS. Po niewielkich modyfikacjach można je też łatwo sformatować w ciąg znaków rgba()CSS w języku JavaScript.

Na tej stronie referencyjnej nie ma informacji o bezwzględnej przestrzeni kolorów, która powinna być używana do interpretowania wartości RGB, np. sRGB, Adobe RGB, DCI-P3 i BT.2020. Domyślnie aplikacje powinny zakładać przestrzeń kolorów sRGB.

Jeśli trzeba określić, czy dwa kolory są równe, implementacje, o ile nie podano inaczej, traktują dwa kolory jako równe, jeśli wszystkie wartości czerwieni, zieleni, niebieskiego i alfa różnią się od siebie 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ść czerwieni w kolorze jako wartość z przedziału [0, 1].
green	number Ilość zieleni w kolorze jako wartość z przedziału [0, 1].
blue	number Ilość niebieskiego w kolorze jako wartość z przedziału [0, 1].
alpha	number Ułamek tego koloru, który ma zostać zastosowany do piksela. Oznacza to, że ostateczny kolor piksela jest określany przez to równanie: pixel color = alpha * (this color) + (1.0 - alpha) * (background color) Oznacza to, że wartość 1,0 odpowiada jednolitemu kolorowi, a wartość 0,0 – całkowicie przezroczystemu kolorowi. Używa to wiadomości opakowującej zamiast prostego skalaru zmiennoprzecinkowego, dzięki czemu można odróżnić wartość domyślną od wartości nieustawionej. Jeśli ten obiekt koloru zostanie pominięty, będzie renderowany jako jednolity kolor (tak jakby wartość alfa miała wartość 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 zbiorczekind. Rodzaj wartości koloru. kind może mieć tylko jedną z tych wartości:
rgbColor	object (Color) kolor RGB, Wartość alpha w obiekcie Color nie jest ogólnie obsługiwana.
themeColor	enum (ThemeColorType) Kolor motywu.

ThemeColorType

Typy kolorów motywu.

SpreadsheetProperties zawiera SpreadsheetTheme określający mapowanie tych typów kolorów motywu na konkretne kolory.

Wartości w polu enum
THEME_COLOR_TYPE_UNSPECIFIED	Nieokreślony kolor motywu
TEXT	Reprezentuje główny kolor tekstu.
BACKGROUND	Reprezentuje główny kolor tła.
ACCENT1	Reprezentuje pierwszy kolor akcentu
ACCENT2	Reprezentuje drugi kolor akcentu.
ACCENT3	Reprezentuje trzeci kolor akcentujący
ACCENT4	Reprezentuje czwarty kolor akcentu.
ACCENT5	Reprezentuje piąty kolor akcentu.
ACCENT6	Reprezentuje szósty kolor akcentu.
LINK	Reprezentuje kolor, który ma być używany w przypadku hiperlinków.

HorizontalAlign

Wyrównanie tekstu w komórce w poziomie.

Wartości w polu enum
HORIZONTAL_ALIGN_UNSPECIFIED	Nie określono wyrównania w poziomie. Nie używaj tej opcji.
LEFT	Tekst jest wyraźnie wyrównany do lewej strony komórki.
CENTER	Tekst jest wyraźnie wyrównany do środka komórki.
RIGHT	Tekst jest wyraźnie wyrównany do prawej strony komórki.

TextFormat

Format fragmentu tekstu w komórce. Brak wartości oznacza, że pole nie jest 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) Ten element został wycofany. Kolor pierwszego planu tekstu. Wycofano: użyj foregroundColorStyle.
foregroundColorStyle	object (ColorStyle) Kolor pierwszego planu tekstu. Jeśli ustawiona jest też zasada foregroundColor, to pole ma pierwszeństwo.
fontFamily	string Rodzina czcionek.
fontSize	integer Rozmiar czcionki.
bold	boolean Wartość „prawda”, jeśli tekst jest pogrubiony.
italic	boolean Wartość true, jeśli tekst jest zapisany kursywą.
strikethrough	boolean Wartość Prawda, jeśli tekst jest przekreślony.
underline	boolean Wartość „prawda”, jeśli tekst jest podkreślony.
link	object (Link) Miejsce docelowe linku w tekście (jeśli istnieje). Ustawienie pola linku w TextFormatRun spowoduje usunięcie istniejących linków w komórce lub linku na poziomie komórki ustawionego w tej samej prośbie. Gdy link jest ustawiony, kolor tekstu jest ustawiany na domyślny kolor linku, a tekst jest podkreślany. Jeśli te pola zostaną zmodyfikowane w tym samym żądaniu, zamiast domyślnych wartości linku zostaną użyte te wartości.

Link

Odwołanie zewnętrzne lub lokalne.

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

Pola
Pole zbiorczedestination. Miejsce docelowe linku. destination może mieć tylko jedną z tych wartości:
uri	string Identyfikator połączenia.

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, który odwołuje się do kolumny źródła danych.

Zapis JSON
{ "name": string }

Pola
name	string Wyświetlana nazwa kolumny. Powinien być niepowtarzalny w źródle danych.

DataExecutionStatus

Stan wykonania danych.

Tworzone jest wykonanie zapytania do bazy danych, aby zsynchronizować obiekt źródła danych z najnowszymi danymi z DataSource. Zwykle jest ona zaplanowana do uruchamiania w tle. Możesz sprawdzić jej state, aby dowiedzieć się, czy została wykonana.

Istnieje kilka scenariuszy, w których wykonanie danych jest uruchamiane:

• Adding a data source tworzy powiązany arkusz źródła danych oraz wykonanie danych, aby zsynchronizować dane ze źródła danych z arkuszem.
• Updating a data source tworzy wykonanie danych, aby podobnie odświeżyć powiązany arkusz źródła danych.
• Możesz wysłać refresh request , aby jawnie odświeżyć co najmniej 1 obiekt ź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

Wyliczenie stanów wykonywania danych.

Wartości w polu enum
DATA_EXECUTION_STATE_UNSPECIFIED	Wartość domyślna, nie używaj.
NOT_STARTED	Wykonanie danych nie zostało rozpoczęte.
RUNNING	Uruchomiono zapytanie do bazy danych.
CANCELLING	Trwa anulowanie wykonania danych.
SUCCEEDED	Wykonanie danych zostało ukończone.
FAILED	Uruchamianie zapytania do bazy danych zostało ukończone z błędami.

DataExecutionErrorCode

Wyliczenie kodu błędu wykonania danych.

Wartości w polu enum
DATA_EXECUTION_ERROR_CODE_UNSPECIFIED	Wartość domyślna, nie używaj.
TIMED_OUT	Upłynął limit czasu wykonywania zapytania do bazy danych.
TOO_MANY_ROWS	Wykonanie danych zwraca więcej wierszy niż wynosi limit.
TOO_MANY_COLUMNS	Zapytanie do bazy danych zwraca więcej kolumn niż limit.
TOO_MANY_CELLS	Zapytanie do bazy danych zwraca więcej komórek niż wynosi limit.
ENGINE	Błąd jest odbierany z silnika wykonawczego danych backendu (np. BigQuery). Szczegółowe informacje znajdziesz w 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 zwraca zduplikowane nazwy kolumn lub aliasy.
INTERRUPTED	Wykonanie danych zostanie przerwane. Odśwież stronę później.
CONCURRENT_QUERY	Obecnie trwa wykonywanie danych. Nie można ich odświeżyć, dopóki nie zostanie zakończone.
OTHER	Inne błędy.
TOO_MANY_CHARS_PER_CELL	Zapytanie do bazy danych zwraca wartości, które przekraczają maksymalną liczbę znaków dozwolonych w jednej 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 zwraca kolumny z brakującymi aliasami.
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 w RefreshDataSourceRequest.
OBJECT_SPEC_INVALID	Specyfikacja obiektu źródła danych jest nieprawidłowa.
DATA_EXECUTION_CANCELLED	Wykonanie danych zostało anulowane.

ExtendedValue

Rodzaje wartości, które mogą znajdować się w komórce arkusza kalkulacyjnego.

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 zbiorczevalue. Rodzaj wartości w komórce. Jeśli żadne pole nie jest ustawione, komórka nie zawiera danych. value może mieć tylko jedną z tych wartości:
numberValue	number Reprezentuje wartość typu double. Uwaga: daty, godziny i daty z godziną są reprezentowane jako liczby zmiennoprzecinkowe podwójnej precyzji w formacie SERIAL_NUMBER.
stringValue	string Reprezentuje wartość ciągu tekstowego. Początkowe pojedyncze cudzysłowy nie są uwzględniane. Jeśli na przykład użytkownik wpisze w interfejsie '123 , zostanie to przedstawione jako a stringValue of "123".
boolValue	boolean Reprezentuje wartość logiczną.
formulaValue	string Reprezentuje formułę.
errorValue	object (ErrorValue) Oznacza 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 Wiadomość z dodatkowymi informacjami o błędzie (w języku arkusza kalkulacyjnego).

ErrorType

Typ błędu.

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

BooleanCondition

Warunek, który może przyjmować wartość „prawda” lub „fałsz”. BooleanConditions są używane w formatowaniu warunkowym, sprawdzaniu poprawności danych i kryteriach filtrów.

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 obsługują wartości zerowe, inne jedną lub dwie wartości, a 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. Obsługiwane przez sprawdzanie poprawności danych, formatowanie warunkowe i filtry. Wymaga pojedynczego ConditionValue.
NUMBER_GREATER_THAN_EQ	Wartość komórki musi być większa lub równa wartości warunku. Obsługiwane przez sprawdzanie poprawności danych, formatowanie warunkowe i filtry. Wymaga pojedynczego ConditionValue.
NUMBER_LESS	Wartość komórki musi być mniejsza niż wartość warunku. Obsługiwane przez sprawdzanie poprawności danych, formatowanie warunkowe i filtry. Wymaga pojedynczego ConditionValue.
NUMBER_LESS_THAN_EQ	Wartość komórki musi być mniejsza lub równa wartości warunku. Obsługiwane przez sprawdzanie poprawności danych, formatowanie warunkowe i filtry. Wymaga pojedynczego ConditionValue.
NUMBER_EQ	Wartość komórki musi być równa wartości warunku. Obsługiwane przez sprawdzanie poprawności danych, formatowanie warunkowe i filtry. Wymaga pojedynczego ConditionValue w przypadku sprawdzania poprawności danych, formatowania warunkowego i filtrów w obiektach innych niż źródła danych oraz co najmniej jednego ConditionValue w przypadku filtrów w obiektach źródła danych.
NUMBER_NOT_EQ	Wartość komórki musi być różna od wartości warunku. Obsługiwane przez sprawdzanie poprawności danych, formatowanie warunkowe i filtry. Wymaga pojedynczego ConditionValue w przypadku sprawdzania poprawności danych, formatowania warunkowego i filtrów w obiektach innych niż źródła danych oraz co najmniej jednego ConditionValue w przypadku filtrów w obiektach źródła danych.
NUMBER_BETWEEN	Wartość komórki musi mieścić się w przedziale między dwiema wartościami warunku. Obsługiwane przez sprawdzanie poprawności danych, formatowanie warunkowe i filtry. Wymaga dokładnie 2 ConditionValues.
NUMBER_NOT_BETWEEN	Wartość komórki nie może mieścić się między wartościami warunków. Obsługiwane przez sprawdzanie poprawności danych, formatowanie warunkowe i filtry. Wymaga dokładnie 2 ConditionValues.
TEXT_CONTAINS	Wartość komórki musi zawierać wartość warunku. Obsługiwane przez sprawdzanie poprawności danych, formatowanie warunkowe i filtry. Wymaga pojedynczego ConditionValue.
TEXT_NOT_CONTAINS	Wartość komórki nie może zawierać wartości warunku. Obsługiwane przez sprawdzanie poprawności danych, formatowanie warunkowe i filtry. Wymaga pojedynczego ConditionValue.
TEXT_STARTS_WITH	Wartość komórki musi zaczynać się od wartości warunku. Obsługiwane przez formatowanie warunkowe i filtry. Wymaga pojedynczego ConditionValue.
TEXT_ENDS_WITH	Wartość komórki musi kończyć się wartością warunku. Obsługiwane przez formatowanie warunkowe i filtry. Wymaga pojedynczego ConditionValue.
TEXT_EQ	Wartość komórki musi być dokładnie taka sama jak wartość warunku. Obsługiwane przez sprawdzanie poprawności danych, formatowanie warunkowe i filtry. Wymaga pojedynczego ConditionValue w przypadku sprawdzania poprawności danych, formatowania warunkowego i filtrów w obiektach innych niż źródła danych oraz co najmniej jednego ConditionValue w przypadku filtrów w obiektach źródła danych.
TEXT_IS_EMAIL	Wartość komórki musi być prawidłowym adresem e-mail. Obsługiwane przez sprawdzanie poprawności danych. Nie wymaga ConditionValues.
TEXT_IS_URL	Wartość komórki musi być prawidłowym adresem URL. Obsługiwane przez sprawdzanie poprawności danych. Nie wymaga ConditionValues.
DATE_EQ	Wartość komórki musi być taka sama jak wartość warunku. Obsługiwane przez sprawdzanie poprawności danych, formatowanie warunkowe i filtry. Wymaga pojedynczego ConditionValue w przypadku sprawdzania poprawności danych, formatowania warunkowego i filtrów w obiektach innych niż źródła danych oraz co najmniej jednego ConditionValue w przypadku filtrów w obiektach źródła danych.
DATE_BEFORE	Wartość komórki musi być wcześniejsza niż data wartości warunku. Obsługiwane przez sprawdzanie poprawności danych, formatowanie warunkowe i filtry. Wymaga pojedynczego elementu ConditionValue, który może być elementem relative date.
DATE_AFTER	Wartość komórki musi być późniejsza niż data wartości warunku. Obsługiwane przez sprawdzanie poprawności danych, formatowanie warunkowe i filtry. Wymaga pojedynczego elementu ConditionValue, który może być elementem relative date.
DATE_ON_OR_BEFORE	Wartość komórki musi przypadać w dniu wartości warunku lub przed nim. Obsługiwane przez sprawdzanie poprawności danych. Wymaga pojedynczego elementu ConditionValue, który może być elementem relative date.
DATE_ON_OR_AFTER	Wartość komórki musi być taka sama jak wartość warunku lub późniejsza. Obsługiwane przez sprawdzanie poprawności danych. Wymaga pojedynczego elementu ConditionValue, który może być elementem relative date.
DATE_BETWEEN	Wartość komórki musi mieścić się w przedziale dat określonym przez wartości dwóch warunków. Obsługiwane przez sprawdzanie poprawności danych. Wymaga dokładnie 2 ConditionValues.
DATE_NOT_BETWEEN	Wartość komórki musi być poza datami dwóch wartości warunku. Obsługiwane przez sprawdzanie poprawności danych. Wymaga dokładnie 2 ConditionValues.
DATE_IS_VALID	Wartość komórki musi być datą. Obsługiwane przez sprawdzanie 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 sprawdzanie poprawności danych. Wymaga pojedynczego 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 sprawdzanie poprawności danych. Obsługuje dowolną liczbę atrybutów condition values, po jednym dla każdego elementu 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 zwracać wartość „prawda”. Obsługiwane przez sprawdzanie poprawności danych, formatowanie warunkowe i filtry. Nie są obsługiwane przez filtry arkusza źródła danych. Wymaga pojedynczego ConditionValue.
BOOLEAN	Wartość komórki musi być wartością logiczną (TRUE/FALSE) lub znajdować się na liście wartości warunku. Obsługiwane przez sprawdzanie poprawności danych. Renderuje jako pole wyboru w komórce. Obsługuje 0, 1 lub 2 ConditionValues. Brak wartości oznacza, że komórka musi mieć wartość TRUE lub FALSE, gdzie TRUE jest renderowane jako zaznaczone, a FALSE jako niezaznaczone. Jedna wartość oznacza, że komórka będzie renderowana jako zaznaczona, gdy zawiera tę wartość, a jako niezaznaczona, gdy jest pusta. Dwie wartości oznaczają, że komórka będzie renderowana jako zaznaczona, gdy zawiera pierwszą wartość, i niezaznaczona, gdy zawiera drugą wartość. Na przykład ["Yes","No"] oznacza, że komórka będzie renderować zaznaczone pole wyboru, gdy ma wartość „Yes”, a niezaznaczone pole wyboru, gdy ma wartość „No”.
TEXT_NOT_EQ	Wartość komórki musi być dokładnie różna od wartości warunku. Obsługiwane przez filtry w obiektach źródła danych. Wymaga co najmniej 1 elementu ConditionValue.
DATE_NOT_EQ	Wartość komórki musi być dokładnie różna od wartości warunku. Obsługiwane przez filtry w obiektach źródła danych. Wymaga co najmniej 1 elementu ConditionValue.
FILTER_EXPRESSION	Wartość komórki musi być zgodna z określonym wzorcem. Wymaga pojedynczego 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 zbiorczevalue. Wartość warunku, musi być ustawiona dokładnie jedna. value może mieć tylko jedną z tych wartości:
relativeDate	enum (RelativeDate) Data względna (na podstawie bieżącej daty). Obowiązuje tylko wtedy, gdy type ma wartość DATE_BEFORE, DATE_AFTER, DATE_ON_OR_BEFORE lub DATE_ON_OR_AFTER. Daty względne nie są obsługiwane w sprawdzaniu poprawności danych. Są one obsługiwane tylko w formatowaniu warunkowym i filtrach 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 znaku = lub „+”).

RelativeDate

Określa sposób oceny warunku daty.

Wartości w polu enum
RELATIVE_DATE_UNSPECIFIED	Wartość domyślna, nie używaj.
PAST_YEAR	Wartość to 1 rok przed dzisiejszą datą.
PAST_MONTH	Wartość to miesiąc przed dzisiejszą datą.
PAST_WEEK	Wartość to tydzień przed dzisiejszą datą.
YESTERDAY	Wartość to wczoraj.
TODAY	Wartość to dzisiaj.
TOMORROW	Wartość to jutro.

GridRange

Zakres w arkuszu. Wszystkie indeksy są liczone od zera. Indeksy są półotwarte, tzn. indeks początkowy jest traktowany włącznie, a indeks końcowy wyłącznie – [startIndex, endIndex). Brakujące indeksy oznaczają, że zakres jest nieograniczony z tej strony.

Jeśli na przykład "Sheet1" to identyfikator arkusza 123456, to:

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

Indeks początkowy musi być zawsze mniejszy niż indeks końcowy lub mu równy. Jeśli indeks początkowy jest równy indeksowi końcowemu, zakres jest pusty. Puste zakresy zwykle nie mają znaczenia i są zwykle 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 Pierwszy wiersz zakresu (włącznie) lub brak ustawienia, jeśli zakres jest nieograniczony.
endRowIndex	integer Wiersz końcowy zakresu (wyłącznie) lub brak wartości, jeśli zakres jest nieograniczony.
startColumnIndex	integer Kolumna początkowa zakresu (włącznie) lub nieustawiona, jeśli zakres jest nieograniczony.
endColumnIndex	integer Kolumna końcowa zakresu (wyłącznie) lub brak wartości, jeśli zakres jest nieograniczony.

SortOrder

kolejność 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 filtra powiązane z określoną 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 zbiorczereference. Odwołanie do filtrowanej kolumny. reference może mieć tylko jedną z tych wartości:
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 mają być ukryte.
condition	object (BooleanCondition) Warunek, który musi być true, aby wyświetlić wartości. (Nie zastępuje to parametru hiddenValues – jeśli wartość jest tam wymieniona, nadal będzie ukryta).
visibleBackgroundColor (deprecated)	object (Color) Ten element został wycofany. Kolor wypełnienia tła, według którego chcesz filtrować; wyświetlane są tylko komórki z tym kolorem wypełnienia. Wzajemnie wykluczające się z atrybutem visibleForegroundColor. Wycofano: użyj visibleBackgroundColorStyle.
visibleBackgroundColorStyle	object (ColorStyle) Kolor wypełnienia tła, według którego chcesz filtrować; wyświetlane są tylko komórki z tym kolorem wypełnienia. To pole wyklucza się wzajemnie z polem visibleForegroundColor i musi być ustawione na kolor typu RGB. Jeśli ustawiona jest też zasada visibleBackgroundColor, to pole ma pierwszeństwo.
visibleForegroundColor (deprecated)	object (Color) Ten element został wycofany. Kolor pierwszego planu, według którego ma być filtrowana tabela. Wyświetlane są tylko komórki z tym kolorem pierwszego planu. Wzajemnie wykluczające się z atrybutem visibleBackgroundColor. Wycofano: użyj visibleForegroundColorStyle.
visibleForegroundColorStyle	object (ColorStyle) Kolor pierwszego planu, według którego ma być filtrowana tabela. Wyświetlane są tylko komórki z tym kolorem pierwszego planu. To pole wyklucza się wzajemnie z polem visibleBackgroundColor i musi być ustawione na kolor typu RGB. Jeśli ustawiona jest też zasada visibleForegroundColor, to pole ma pierwszeństwo.

SortSpec

Kolejność sortowania powiązana z konkretną 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 zamówienia powinny być posortowane.
foregroundColor (deprecated)	object (Color) Ten element został wycofany. Kolor pierwszego planu, według którego ma być sortowana zawartość; komórki z tym kolorem pierwszego planu są sortowane na górze. Wzajemnie wykluczające się z atrybutem backgroundColor. Wycofano: użyj foregroundColorStyle.
foregroundColorStyle	object (ColorStyle) Kolor pierwszego planu, według którego ma być sortowana zawartość; komórki z tym kolorem pierwszego planu są sortowane na górze. Wzajemnie wykluczające się z backgroundColor. Musi to być kolor typu RGB. Jeśli ustawiona jest też zasada foregroundColor, to pole ma pierwszeństwo.
backgroundColor (deprecated)	object (Color) Ten element został wycofany. Kolor wypełnienia tła, według którego ma być wykonane sortowanie. Komórki z tym kolorem wypełnienia są sortowane na górze. Wzajemnie wykluczające się z atrybutem foregroundColor. Wycofano: użyj backgroundColorStyle.
backgroundColorStyle	object (ColorStyle) Kolor wypełnienia tła, według którego ma być wykonane sortowanie. Komórki z tym kolorem wypełnienia są sortowane na górze. Wzajemnie wykluczające się z foregroundColor. Musi to być kolor typu RGB. Jeśli ustawiona jest też zasada backgroundColor, to pole ma pierwszeństwo.
Pole zbiorczereference. Odwołanie do posortowanego wymiaru. reference może mieć tylko jedną z tych wartości:
dimensionIndex	integer Wymiar, do którego ma być zastosowane sortowanie.
dataSourceColumnReference	object (DataSourceColumnReference) Odwołanie do kolumny źródła danych.

EmbeddedObjectPosition

Pozycja obiektu osadzonego, 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 zbiorczelocation. Lokalizacja obiektu. Musisz ustawić dokładnie jedną wartość. location może mieć tylko jedną z tych wartości:
sheetId	integer arkusz, w którym znajduje się ten element; Ustawiany tylko wtedy, gdy osadzony obiekt znajduje się w osobnym arkuszu. Wartość musi być nieujemna.
overlayPosition	object (OverlayPosition) Pozycja, w której obiekt jest nakładany na siatkę.
newSheet	boolean Jeśli ta opcja jest zaznaczona, umieszczony obiekt zostanie umieszczony w nowym arkuszu, którego identyfikator zostanie wybrany automatycznie. Używana tylko podczas pisania.

OverlayPosition

Miejsce, w którym obiekt jest nakładany na siatkę.

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

Pola
anchorCell	object (GridCoordinate) Komórka, do której jest zakotwiczony obiekt.
offsetXPixels	integer Poziome odsunięcie obiektu od komórki zakotwiczenia (w pikselach).
offsetYPixels	integer Pionowe przesunięcie obiektu względem komórki zakotwiczenia (w pikselach).
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. Wszystkie indeksy są liczone od zera.

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

Pola
sheetId	integer Arkusz, w którym znajduje się ten współrzędny.
rowIndex	integer Indeks wiersza współrzędnej.
columnIndex	integer Indeks kolumny współrzędnej.