Other

Kolor

Reprezentuje kolor w przestrzeni kolorów RGBA. Ta reprezentacja została zaprojektowana tak, aby ułatwić konwersję na reprezentacje kolorów i z nich w różnych językach, a nie na potrzeby kompresji. Pola tej reprezentacji można na przykład łatwo przekazać konstruktorowi java.awt.Color w języku Java, a także metodzie +colorWithRed:green:blue:alpha w obiekcie UIColor w iOS. Przy odrobinie pracy można je też łatwo sformatować do postaci ciągu rgba() w języku JavaScript.

Ta strona informacyjna nie zawiera informacji o bezwzględnej przestrzeni kolorów, której należy użyć do interpretacji wartości RGB, np. sRGB, Adobe RGB, DCI-P3 i BT.2020. Domyślnie aplikacje powinny zakładać przestrzeń barw sRGB.

Gdy trzeba określić, czy dwa kolory są sobie równe, implementacje, o ile nie określono inaczej, traktują je jako równe, jeśli ich wartości czerwonego, zielonego, niebieskiego i alfa różnią się od siebie najwyżej o 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 / Objective-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 w kolorze jako wartość z zakresu [0, 1].
green	number Ilość zieleni w kolorze jako wartość z zakresu [0, 1].
blue	number Ilość niebieskiego w kolorze jako wartość z zakresu [0, 1].
alpha	number Ułamek tego koloru, który powinien zostać zastosowany do piksela. Oznacza to, że ostateczny kolor piksela jest określany za pomocą tej zależności: 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. Zamiast prostego wektora liczby zmiennoprzecinkowej używa ona komunikatu opakowania, aby można było odróżnić wartość domyślną od wartości nieskonfigurowanej. Jeśli zostanie pominięty, obiekt koloru zostanie wyrenderowany jako jednolity kolor (jak gdyby 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 uniikind. Rodzaj wartości koloru. kindmoże być 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.

SpreadsheetPropertieszawierają SpreadsheetTheme, który definiuje 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 podstawowy kolor tekstu.
BACKGROUND	Reprezentuje podstawowy kolor tła.
ACCENT1	Reprezentuje pierwszy kolor uzupełniający.
ACCENT2	Reprezentuje drugi kolor akcentu
ACCENT3	Reprezentuje trzeci kolor akcentu
ACCENT4	Reprezentuje czwarty kolor akcentu
ACCENT5	Piąty kolor uzupełniający
ACCENT6	Reprezentuje szósty kolor uzupełniający
LINK	Reprezentuje kolor używany do hiperlinków.

HorizontalAlign

Wyrównanie tekstu w poziomie w komórce.

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

TextFormat

Format ciągu tekstu w komórce. Brak wartości oznacza, ż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) Ten element został wycofany. Kolor pierwszego planu tekstu. Wycofane: 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ść „prawda”, jeśli tekst jest pochylony.
strikethrough	boolean Wartość Prawda, jeśli tekst jest przekreślony.
underline	boolean Wartość „prawda”, jeśli tekst jest podkreślony.
link	object (Link) Link do strony docelowej tekstu (jeśli istnieje). Ustawienie pola linku w prośbie TextFormatRun spowoduje usunięcie dotychczasowych linków komórki lub linku ustawionego na poziomie komórki w tym samym żądaniu. Gdy ustawisz link, kolor tekstu na pierwszym planie zostanie ustawiony jako domyślny kolor linku, a tekst zostanie podkreślony. Jeśli te pola zostaną zmienione w tym samym żądaniu, zostaną użyte zamiast domyślnych wartości linku.

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 uniidestination. Miejsce docelowe linku. destinationmoże być 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. Powinna być niepowtarzalna w źródle danych.

DataExecutionStatus

Stan wykonania danych.

Tworzone jest wykonanie danych, aby zsynchronizować obiekt źródła danych z najnowszymi danymi z DataSource. Zwykle jest zaplanowany do działania w tle. Możesz sprawdzić jego stanstate, aby dowiedzieć się, czy jego wykonanie zostało zakończone.

Wykonanie danych może zostać uruchomione w kilku sytuacjach:

• Adding a data sourcetworzy powiązany arkusz źródła danych oraz wykonanie danych, aby zsynchronizować dane ze źródła danych z arkuszem.
• Updating a data sourcetworzy wykonanie danych, aby odświeżyć powiązany arkusz źródła danych w podobny sposób.
• Możesz wysłać prośbęrefresh request, aby wyraźnie odświeżyć co najmniej jeden 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 pomyślnego odświeżenia danych.

DataExecutionState

Wyliczenie stanów wykonania danych.

Wartości w polu enum
DATA_EXECUTION_STATE_UNSPECIFIED	Wartość domyślna, której nie należy używać.
NOT_STARTED	Wykonanie danych nie zostało rozpoczęte.
RUNNING	Zapytanie do bazy danych zostało uruchomione i wciąż jest wykonywane.
CANCELLING	Anulowanie wykonania danych.
SUCCEEDED	Wykonywanie danych zostało zakończone.
FAILED	Uruchamianie zapytania zostało zakończone z błędami.

DataExecutionErrorCode

Wyliczenie kodów błędów wykonania danych.

Wartości w polu enum
DATA_EXECUTION_ERROR_CODE_UNSPECIFIED	Wartość domyślna, której nie należy używać.
TIMED_OUT	Upłynął limit czasu wykonywania zapytania do bazy danych.
TOO_MANY_ROWS	Zapytanie do bazy danych zwraca więcej wierszy niż wynosi limit.
TOO_MANY_COLUMNS	Zapytanie do bazy danych zwraca więcej kolumn niż dozwolona liczba.
TOO_MANY_CELLS	Zapytanie do bazy danych zwraca więcej komórek niż wynosi limit.
ENGINE	Błąd jest odbierany z backendowego silnika wykonywania danych (np. BigQuery). Więcej informacji znajdziesz w wiadomości wysłanej na adres errorMessage.
PARAMETER_INVALID	Jeden lub kilka podanych parametrów źródła danych jest nieprawidłowe.
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	Przetwarzanie danych zostało przerwane. Odśwież stronę później.
CONCURRENT_QUERY	Przetwarzanie danych jest obecnie w toku i nie można go odświeżyć, dopóki nie zostanie ukoń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 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 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żanie, ustaw parametr 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, 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 uniivalue. Typ wartości w komórce. Jeśli żadne pole nie jest ustawione, komórka nie zawiera danych. valuemoże być tylko jedną z tych wartości:
numberValue	number Reprezentuje wartość typu double. Uwaga: daty, godziny i daty/godziny są reprezentowane jako liczby podwójnie zmienne w formacie SERIAL_NUMBER.
stringValue	string Reprezentuje wartość tekstową. Nie uwzględnia się cudzysłowów pojedynczych na początku. Jeśli na przykład użytkownik wpisze '123 w interfejsie, zostanie to przedstawione jako stringValue z "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 komunikat z dodatkowymi informacjami o błędzie (w regionie ustawień 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 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 stanowiLoading....

BooleanCondition

Warunek, który może zwracać wartość prawda lub fałsz. Warunki logiczne są używane przez formatowanie warunkowe, walidację 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 z nich obsługują 0 wartości, inne 1 lub 2 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, której nie należy używać.
NUMBER_GREATER	Wartość komórki musi być większa niż wartość warunku. Obsługiwane przez sprawdzanie poprawności danych, formatowanie warunkowe i filtry. Wymaga jednego 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 jednego ConditionValue.
NUMBER_LESS	Wartość komórki musi być mniejsza niż wartość warunku. Obsługiwane przez sprawdzanie poprawności danych, formatowanie warunkowe i filtry. Wymaga jednego ConditionValue.
NUMBER_LESS_THAN_EQ	Wartość komórki musi być równa lub mniejsza od wartości warunku. Obsługiwane przez sprawdzanie poprawności danych, formatowanie warunkowe i filtry. Wymaga jednego 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 jednego elementu ConditionValue do sprawdzania poprawności danych, formatowania warunkowego i filtrów w obiektach innych niż źródła danych oraz co najmniej jednego elementu ConditionValue do filtrów w obiektach źródeł danych.
NUMBER_NOT_EQ	Wartość komórki nie może być równa wartości warunku. Obsługiwane przez sprawdzanie poprawności danych, formatowanie warunkowe i filtry. Wymaga jednego elementu ConditionValue do sprawdzania poprawności danych, formatowania warunkowego i filtrów w obiektach innych niż źródła danych oraz co najmniej jednego elementu ConditionValue do filtrów w obiektach źródeł danych.
NUMBER_BETWEEN	Wartość komórki musi mieścić się między 2 wartościami warunków. 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 znajdować się między 2 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 jednego 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 jednego ConditionValue.
TEXT_STARTS_WITH	Wartość komórki musi zaczynać się od wartości warunku. Obsługiwane przez formatowanie warunkowe i filtry. Wymaga jednego ConditionValue.
TEXT_ENDS_WITH	Wartość komórki musi kończyć się wartością warunku. Obsługiwane przez formatowanie warunkowe i filtry. Wymaga jednego 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 jednego elementu ConditionValue do sprawdzania poprawności danych, formatowania warunkowego i filtrów w obiektach innych niż źródła danych oraz co najmniej jednego elementu ConditionValue do filtrów w obiektach źródeł danych.
TEXT_IS_EMAIL	Wartością komórki musi być prawidłowy adres e-mail. Obsługiwane przez sprawdzanie poprawności danych. Nie wymaga żadnych uprawnień.ConditionValues
TEXT_IS_URL	Wartość komórki musi być prawidłowym adresem URL. Obsługiwane przez sprawdzanie poprawności danych. Nie wymaga żadnych uprawnień.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 jednego elementu ConditionValue do sprawdzania poprawności danych, formatowania warunkowego i filtrów w obiektach innych niż źródła danych oraz co najmniej jednego elementu ConditionValue do filtrów w obiektach źródeł danych.
DATE_BEFORE	Wartość komórki musi być wcześniejsza od wartości warunku. Obsługiwane przez sprawdzanie poprawności danych, formatowanie warunkowe i filtry. Wymaga jednego ConditionValue, który może być relative date.
DATE_AFTER	Wartość komórki musi być późniejsza niż data warunku. Obsługiwane przez sprawdzanie poprawności danych, formatowanie warunkowe i filtry. Wymaga jednego ConditionValue, który może być relative date.
DATE_ON_OR_BEFORE	Wartość komórki musi być równa wartości daty warunku lub wcześniejsza. Obsługiwane przez sprawdzanie poprawności danych. Wymaga jednego ConditionValue, który może być 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 jednego ConditionValue, który może być relative date.
DATE_BETWEEN	Wartość komórki musi znajdować się między datami dwóch wartości warunków. Obsługiwane przez sprawdzanie poprawności danych. Wymaga dokładnie 2 ConditionValues.
DATE_NOT_BETWEEN	Wartość komórki musi znajdować się poza zakresem dat 2 wartości warunków. 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 żadnych uprawnień.ConditionValues
ONE_OF_RANGE	Wartość komórki musi być podana w siatce w zakresie wartości warunku. Obsługiwane przez sprawdzanie poprawności danych. Wymaga jednego argumentu 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 warunków. Obsługiwane przez sprawdzanie poprawności danych. Obsługuje dowolną liczbę elementów condition values, po jednym na każdy element na liście. W wartościach nie można stosować formuł.
BLANK	Wartość komórki musi być pusta. Obsługiwane przez formatowanie warunkowe i filtry. Nie wymaga żadnych uprawnień.ConditionValues
NOT_BLANK	Wartość komórki nie może być pusta. Obsługiwane przez formatowanie warunkowe i filtry. Nie wymaga żadnych uprawnień.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 arkuszy źródeł danych. Wymaga jednego ConditionValue.
BOOLEAN	Wartość komórki musi być TRUE/FALSE lub na liście wartości warunków. Obsługiwane przez sprawdzanie poprawności danych. Renderuje jako pole wyboru komórki. Obsługuje 0, 1 lub 2 ConditionValues. Brak wartości oznacza, że komórka musi być TRUE lub FALSE, gdzie TRUE jest zaznaczone, a FALSE nie jest zaznaczone. Jedna wartość wskazuje, że komórka będzie renderowana jako zaznaczona, gdy zawiera tę wartość, i niezaznaczona, gdy jest pusta. 2 wartości wskazują, że komórka będzie renderowana jako zaznaczona, gdy zawiera pierwszą wartość, i niezaznaczona, gdy zawiera drugą wartość. Na przykład ["Tak","Nie"] oznacza, że komórka wyświetli zaznaczone pole wyboru, gdy ma wartość „Tak”, a niezaznaczone pole wyboru, gdy ma wartość „Nie”.
TEXT_NOT_EQ	Wartość komórki musi być dokładnie inna niż wartość warunku. Obsługiwane przez filtry w przypadku obiektów źródeł danych. Wymaga co najmniej 1 elementuConditionValue.
DATE_NOT_EQ	Wartość komórki musi być dokładnie inna niż wartość warunku. Obsługiwane przez filtry w przypadku obiektów źródeł danych. Wymaga co najmniej 1 elementuConditionValue.
FILTER_EXPRESSION	Wartość komórki musi być zgodna z określonym wzorcem. Wymaga jednego 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 uniivalue. Wartość warunku, musi być ustawiona dokładnie raz. valuemoże być tylko jedną z tych wartości:
relativeDate	enum (RelativeDate) Data względna (na podstawie bieżącej daty). Obowiązuje tylko wtedy, gdy wartość parametru type to 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 jest oparty warunek. Wartość jest analizowana tak, jakby użytkownik wpisał ją w komórce. Obsługiwane są formuły (muszą się zaczynać od =lub „+”).

RelativeDate

Określa sposób oceny warunku daty.

Wartości w polu enum
RELATIVE_DATE_UNSPECIFIED	Wartość domyślna, której nie należy używać.
PAST_YEAR	Wartość jest obliczana na podstawie danych z roku poprzedzającego bieżący.
PAST_MONTH	Wartość jest równa wartości z miesiąca poprzedzającego bieżący.
PAST_WEEK	Wartość dotyczy 1 tygodnia wstecz.
YESTERDAY	Wartość to wczoraj.
TODAY	Wartość to dziś.
TOMORROW	Wartość to jutro.

GridRange

Zakres w arkuszu. Wszystkie indeksy są liczone od 0. Indeksy są półotwarte, czyli indeks początkowy jest włącznie, a końcowy – wyłącznie ([startIndex, endIndex]). Brakujące indeksy wskazują, że zakres jest nieograniczony po tej stronie.

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ą wyświetlane w interfejsie jako #REF!.

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

Pola
sheetId	integer Arkusz, na którym znajduje się zakres.
startRowIndex	integer Wiersz początkowy (włącznie) zakresu lub nieustawiony, jeśli zakres jest nieograniczony.
endRowIndex	integer Wiersz końcowy (nie wliczany) zakresu lub nie ustawiony, jeśli zakres jest nieograniczony.
startColumnIndex	integer Kolumna początkowa (włącznie) zakresu lub nie ustawiona, jeśli zakres jest nieograniczony.
endColumnIndex	integer Kolumna końcowa (wyłącznie) zakresu lub nieskonfigurowana, jeśli zakres jest nieograniczony.

SortOrder

kolejność sortowania,

Wartości w polu enum
SORT_ORDER_UNSPECIFIED	Wartość domyślna, której nie należy używać.
ASCENDING	Sortowanie rosnące.
DESCENDING	Sortowanie w kolejności malejącej.

FilterSpec

Kryteria filtra 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 uniireference. Odwołanie do filtrowanej kolumny. referencemoże być tylko jedną z tych wartości:
columnIndex	integer Indeks kolumny liczony od 0.
dataSourceColumnReference	object (DataSourceColumnReference) Odwołanie do kolumny źródła danych.

FilterCriteria

Kryteria wyświetlania/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 wartości były wyświetlane. (nie zastąpi to wartości w parametrze hiddenValues – jeśli jest tam podana jakaś wartość, nadal będzie ona 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 się wykluczają z opcją visibleForegroundColor. Wycofane: 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 jest wzajemnie wykluczające się 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 chcesz filtrować; wyświetlane są tylko komórki z tym kolorem pierwszego planu. Wzajemnie się wykluczają z opcją visibleBackgroundColor. Wycofane: użyj visibleForegroundColorStyle.
visibleForegroundColorStyle	object (ColorStyle) Kolor pierwszego planu, według którego chcesz filtrować; wyświetlane są tylko komórki z tym kolorem pierwszego planu. To pole jest wzajemnie wykluczające się 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 mają być sortowane komórki. Komórki o tym kolorze pierwszego planu zostaną umieszczone na górze. Wzajemnie się wykluczają z opcją backgroundColor. Wycofane: użyj foregroundColorStyle.
foregroundColorStyle	object (ColorStyle) Kolor pierwszego planu, według którego mają być sortowane komórki. Komórki o tym kolorze pierwszego planu zostaną umieszczone na górze. Musi być wykluczony z opcją backgroundColor i musi być kolorem 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 nastąpić sortowanie. Komórki o tym kolorze wypełnienia są sortowane na górze. Wzajemnie się wykluczają z opcją foregroundColor. Wycofane: użyj backgroundColorStyle.
backgroundColorStyle	object (ColorStyle) Kolor wypełnienia tła, według którego ma nastąpić sortowanie. Komórki o tym kolorze wypełnienia są sortowane na górze. Musi być wykluczony z opcją foregroundColor i musi być kolorem typu RGB. Jeśli ustawiona jest też zasada backgroundColor, to pole ma pierwszeństwo.
Pole uniireference. Odwołanie do posortowanego wymiaru. referencemoże być tylko jedną z tych wartości:
dimensionIndex	integer Wymiar, do którego ma zostać zastosowana sortowanie.
dataSourceColumnReference	object (DataSourceColumnReference) Odwołanie do kolumny źródła danych.

EmbeddedObjectPosition

Pozycja osadzonego 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 uniilocation. Lokalizacja obiektu. Musisz podać dokładnie jedną wartość. locationmoże być tylko jedną z tych wartości:
sheetId	integer Arkusz, na którym się znajduje. Ustaw tylko wtedy, gdy osadzony obiekt znajduje się na osobnej karcie. Musi być nieujemna.
overlayPosition	object (OverlayPosition) Pozycja, w której obiekt jest nakładany na siatkę.
newSheet	boolean Jeśli ma wartość Prawda, umieszczony obiekt jest umieszczany na nowym arkuszu, którego identyfikator zostanie wybrany automatycznie. Używany tylko w języku pisanym.

OverlayPosition

Lokalizacja obiektu nałożona 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 przesunięcie (w pikselach) obiektu od komórki kotwicznej.
offsetYPixels	integer Pionowe przesunięcie obiektu względem komórki kotwicznej 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 0.

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

Pola
sheetId	integer Arkusz, na którym znajduje się ta współrzędna.
rowIndex	integer Indeks wiersza współrzędnej.
columnIndex	integer Indeks kolumny współrzędnej.