Kolor
Reprezentuje kolor w przestrzeni kolorów RGBA. Ta reprezentacja została zaprojektowana z myślą o ułatwieniu konwersji wyświetlania i reprezentacji kolorów w różnych językach ze względu na złożoność. Pola tej reprezentacji można na przykład łatwo przekazać do konstruktora java.awt.Color
w języku Java, a także w prosty sposób udostępnić je w metodzie +colorWithRed:green:blue:alpha
interfejsu UIColor w iOS oraz za pomocą niewielkiej pracy można je łatwo sformatować w ciągu CSS rgba()
w JavaScript.
Na tej stronie referencyjnej nie ma informacji o bezwzględnej przestrzeni kolorów, która powinna być używana do interpretacji wartości RGB (np. sRGB, Adobe RGB, DCI-P3 i BT.2020). Domyślnie aplikacje powinny zakładać przestrzeń kolorów sRGB.
Gdy trzeba określić równość kolorów, implementacje (o ile nie udokumentowano inaczej), traktuj 2 kolory jako równe, jeśli wszystkie ich wartości czerwonego, zielonego, niebieskiego i alfa różnią się 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
|
Ilość czerwieni w kolorze jako wartość przedziału [0, 1]. |
green
|
Ilość zieleni w kolorze jako wartość przedziału [0–1]. |
blue
|
Ilość koloru niebieskiego jako wartość przedziału [0, 1]. |
alpha
|
Odsetek tego koloru, jaki ma zostać zastosowany do piksela. Oznacza to, że ostateczny kolor w pikselach jest określany przez równanie:
Oznacza to, że wartość 1,0 odpowiada jednolitego koloru, a 0,0 – całkowicie przezroczystemu. Wykorzystuje komunikat otoki, a nie prostą wartość skalarną zmiennoprzecinkową, dzięki czemu można odróżnić wartość domyślną od wartości nieskonfigurowanej. Jeśli zostanie pominięty, obiekt koloru będzie renderowany jako jednolity kolor (tak jakby wartość alfa otrzymała jawną wartość 1,0). |
ColorStyle
Wartość koloru.
Zapis JSON |
---|
{ // Union field |
Pola | |
---|---|
Pole sumy kind . Rodzaj wartości koloru.
kind może mieć tylko jedną z tych wartości:
|
|
rgbColor
|
Kolor RGB. Wartość |
themeColor
|
Kolor motywu. |
ThemeColorType
Typy kolorów motywu.
SpreadsheetProperties
zawierają atrybut SpreadsheetTheme
, który określa 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 podstawowy 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
|
Oznacza czwarty kolor uzupełniający |
ACCENT5
|
Reprezentuje piąty kolor uzupełniający |
ACCENT6
|
Reprezentuje szósty kolor uzupełniający |
LINK
|
Reprezentuje kolor hiperlinków |
HorizontalAlign
Wyrównanie tekstu w poziomie w komórce.
Wartości w polu enum | |
---|---|
HORIZONTAL_ALIGN_UNSPECIFIED
|
Nie określono wyrównania w poziomie. Nie używaj go. |
LEFT
|
Tekst zostanie wyrównany do lewej krawędzi komórki. |
CENTER
|
tekst zostanie wyrównany do środka komórki; |
RIGHT
|
tekst jest wyrównany do prawej strony 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 ( |
Pola | |
---|---|
foregroundColor
|
Kolor pierwszego planu tekstu. Wycofane: użyj właściwości |
foregroundColorStyle
|
Kolor pierwszego planu tekstu. Jeśli pole |
fontFamily
|
Rodzina czcionek. |
fontSize
|
Rozmiar czcionki. |
bold
|
Prawda, jeśli tekst jest pogrubiony. |
italic
|
Prawda, jeśli tekst jest napisany kursywą. |
strikethrough
|
Prawda, jeśli tekst jest przekreślony. |
underline
|
Prawda, jeśli tekst jest podkreślony. |
link
|
Miejsce docelowe linku (jeśli występuje). Ustawienie pola linku w |
Link
Zewnętrzny lub lokalny plik referencyjny.
Zapis JSON |
---|
{ // Union field |
Pola | |
---|---|
Pole sumy destination . Miejsce docelowe linku.
destination może mieć tylko jedną z tych wartości:
|
|
uri
|
Identyfikator linku. |
DataSourceColumn
Kolumna w źródle danych.
Zapis JSON |
---|
{
"reference": {
object (
|
Pola | |
---|---|
reference
|
Odwołanie do kolumny. |
formula
|
Formuła obliczonej kolumny. |
DataSourceColumnReference
Unikalny identyfikator, który odwołuje się do kolumny źródła danych.
Zapis JSON |
---|
{ "name": string } |
Pola | |
---|---|
name
|
Wyświetlana nazwa kolumny. Powinien być niepowtarzalny w obrębie źródła danych. |
DataExecutionStatus
Stan wykonania danych.
Tworzone jest wykonanie w celu zsynchronizowania obiektu źródła danych z najnowszymi danymi z DataSource
. Zwykle jest uruchamiane w tle. Możesz sprawdzić jego state
, aby określić, czy wykonanie zostało ukończone
Istnieje kilka scenariuszy, w których uruchamiane jest wykonanie kodu:
-
Adding a data source
tworzy powiązany arkusz źródła danych oraz wykonuje wykonanie danych, aby zsynchronizować dane ze źródła danych z arkuszem. -
Updating a data source
tworzy wykonanie danych, aby w podobny sposób odświeżyć powiązany arkusz źródła danych. -
Możesz wysłać
refresh request
, aby jawnie odświeżyć jeden lub wiele obiektów źródła danych.
Zapis JSON |
---|
{ "state": enum ( |
Pola | |
---|---|
state
|
Stan wykonania danych. |
errorCode
|
Kod błędu. |
errorMessage
|
Komunikat o błędzie, który może być pusty. |
lastRefreshTime
|
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żywać. |
NOT_STARTED
|
Wykonywanie danych nie rozpoczęło się. |
RUNNING
|
Wykonywanie danych zostało rozpoczęte. |
CANCELLING
|
Anuluję wykonanie działania do danych. |
SUCCEEDED
|
Zakończono wykonywanie zapytania. |
FAILED
|
Wykonywanie danych zostało ukończone z błędami. |
DataExecutionErrorCode
Wyliczenie kodu błędu wykonywania danych.
Wartości w polu enum | |
---|---|
DATA_EXECUTION_ERROR_CODE_UNSPECIFIED
|
Wartość domyślna, nie używać. |
TIMED_OUT
|
Przekroczono limit czasu wykonywania danych. |
TOO_MANY_ROWS
|
Wykonanie danych zwróci więcej wierszy niż wynosi limit. |
TOO_MANY_COLUMNS
|
Wykonanie danych zwróci więcej kolumn, niż wynosi limit. |
TOO_MANY_CELLS
|
Wykonanie danych zwróci więcej komórek niż wynosi limit. |
ENGINE
|
Odebrano błąd z backendu backendu (np. BigQuery). Szczegóły znajdziesz tutaj: errorMessage .
|
PARAMETER_INVALID
|
Co najmniej jeden z podanych parametrów źródła danych jest nieprawidłowy. |
UNSUPPORTED_DATA_TYPE
|
Wykonanie danych zwróci nieobsługiwany typ danych. |
DUPLICATE_COLUMN_NAMES
|
Wykonanie zapytania zwróci zduplikowane nazwy kolumn lub aliasy. |
INTERRUPTED
|
Wykonywanie danych zostało przerwane. Odśwież później. |
CONCURRENT_QUERY
|
Trwa wykonywanie wykonywania danych i nie można go odświeżyć, dopóki się nie zakończy. |
OTHER
|
Inne błędy. |
TOO_MANY_CHARS_PER_CELL
|
Wykonanie zapytania zwraca wartości przekraczające 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
|
Wykonanie danych zwróci 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 zapytania dotyczącego danych zostało anulowane. |
ExtendedValue
Rodzaje wartości, które może zawierać komórka w arkuszu kalkulacyjnym.
Zapis JSON |
---|
{ // Union field |
Pola | |
---|---|
Pole sumy value . Typ wartości w komórce. Jeśli nie ustawisz żadnego pola, komórka nie będzie zawierać danych.
value może mieć tylko jedną z tych wartości:
|
|
numberValue
|
Reprezentuje wartość podwójnej precyzji. Uwaga: daty, godziny i daty są podawane w formacie |
stringValue
|
Reprezentuje wartość w postaci ciągu znaków. Apostrofy wiodące nie są uwzględniane. Jeśli na przykład użytkownik wpisze w interfejsie |
boolValue
|
Reprezentuje wartość logiczną. |
formulaValue
|
Reprezentuje formułę. |
errorValue
|
Oznacza błąd. To pole jest tylko do odczytu. |
ErrorValue
Błąd w komórce.
Zapis JSON |
---|
{
"type": enum (
|
Pola | |
---|---|
type
|
typ błędu. |
message
|
komunikat 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 to błądowi #ERROR! .
|
NULL_VALUE
|
Odpowiada to błądowi #NULL! .
|
DIVIDE_BY_ZERO
|
Odpowiada to błądowi #DIV/0 .
|
VALUE
|
Odpowiada to błądowi #VALUE! .
|
REF
|
Odpowiada to błądowi #REF! .
|
NAME
|
Odpowiada to błądowi #NAME? .
|
NUM
|
Odpowiada to błądowi #NUM! .
|
N_A
|
Odpowiada to błądowi #N/A .
|
LOADING
|
Odpowiada stanowi Loading... .
|
BooleanCondition
Warunek, którego wartość może przynosić wartość prawda lub fałsz. Parametry logiczne są używane przez formatowanie warunkowe, sprawdzanie poprawności danych i kryteria w filtrach.
Zapis JSON |
---|
{ "type": enum ( |
Pola | |
---|---|
type
|
Typ warunku. |
values[]
|
Wartości warunku. Liczba obsługiwanych wartości zależy od |
ConditionType
Typ warunku.
Wartości w polu enum | |
---|---|
CONDITION_TYPE_UNSPECIFIED
|
Wartość domyślna, nie używać. |
NUMBER_GREATER
|
Wartość komórki musi być większa od wartości warunku. Funkcja ta jest obsługiwana przez sprawdzanie poprawności danych, formatowanie warunkowe i filtry. Wymaga jednego ConditionValue .
|
NUMBER_GREATER_THAN_EQ
|
Wartość komórki musi być równa wartości warunku lub od niej większa. Funkcja ta jest obsługiwana przez sprawdzanie poprawności danych, formatowanie warunkowe i filtry. Wymaga jednego ConditionValue .
|
NUMBER_LESS
|
Wartość komórki musi być mniejsza od wartości warunku. Funkcja ta jest obsługiwana przez sprawdzanie poprawności danych, formatowanie warunkowe i filtry. Wymaga jednego ConditionValue .
|
NUMBER_LESS_THAN_EQ
|
Wartość komórki nie może być większa od wartości warunku. Funkcja ta jest obsługiwana przez sprawdzanie poprawności danych, formatowanie warunkowe i filtry. Wymaga jednego ConditionValue .
|
NUMBER_EQ
|
Wartość komórki musi być równa wartości warunku. Funkcja ta jest obsługiwana przez sprawdzanie poprawności danych, formatowanie warunkowe i filtry. Wymaga jednego parametru ConditionValue na potrzeby weryfikacji danych, formatowania warunkowego i filtrów dotyczących obiektów niebędących źródłem danych oraz co najmniej 1 elementu ConditionValue w przypadku filtrów obiektów źródła danych.
|
NUMBER_NOT_EQ
|
Wartość komórki nie może być równa wartości warunku. Funkcja ta jest obsługiwana przez sprawdzanie poprawności danych, formatowanie warunkowe i filtry. Wymaga jednego parametru ConditionValue na potrzeby weryfikacji danych, formatowania warunkowego i filtrów dotyczących obiektów niebędących źródłem danych oraz co najmniej 1 elementu ConditionValue w przypadku filtrów obiektów źródła danych.
|
NUMBER_BETWEEN
|
Wartość komórki musi znajdować się między 2 wartościami warunku. Funkcja ta jest obsługiwana przez sprawdzanie poprawności danych, formatowanie warunkowe i filtry. Wymaga dokładnie 2 elementów ConditionValues .
|
NUMBER_NOT_BETWEEN
|
Wartość komórki nie może znajdować się między 2 wartościami warunku. Funkcja ta jest obsługiwana przez sprawdzanie poprawności danych, formatowanie warunkowe i filtry. Wymaga dokładnie 2 elementów ConditionValues .
|
TEXT_CONTAINS
|
Wartość komórki musi zawierać wartość warunku. Funkcja ta jest obsługiwana 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. Funkcja ta jest obsługiwana 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. Funkcja ta jest obsługiwana przez sprawdzanie poprawności danych, formatowanie warunkowe i filtry. Wymaga jednego parametru ConditionValue na potrzeby weryfikacji danych, formatowania warunkowego i filtrów dotyczących obiektów niebędących źródłem danych oraz co najmniej 1 elementu ConditionValue w przypadku filtrów obiektów ź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 data warunku. Funkcja ta jest obsługiwana przez sprawdzanie poprawności danych, formatowanie warunkowe i filtry. Wymaga jednego parametru ConditionValue na potrzeby weryfikacji danych, formatowania warunkowego i filtrów dotyczących obiektów niebędących źródłem danych oraz co najmniej 1 elementu ConditionValue w przypadku filtrów obiektów źródła danych.
|
DATE_BEFORE
|
Wartość komórki musi być wcześniejsza niż data wartości warunku. Funkcja ta jest obsługiwana przez sprawdzanie poprawności danych, formatowanie warunkowe i filtry. Wymaga jednego typu ConditionValue , który może być wartością relative date .
|
DATE_AFTER
|
Wartość komórki musi być późniejsza niż data wartości warunku. Funkcja ta jest obsługiwana przez sprawdzanie poprawności danych, formatowanie warunkowe i filtry. Wymaga jednego typu ConditionValue , który może być wartością relative date .
|
DATE_ON_OR_BEFORE
|
Wartość komórki nie może być wcześniejsza niż data wartości warunku. Obsługiwane przez sprawdzanie poprawności danych. Wymaga jednego typu ConditionValue , który może być wartością relative date .
|
DATE_ON_OR_AFTER
|
Wartość komórki nie może być wcześniejsza niż data wartości warunku. Obsługiwane przez sprawdzanie poprawności danych. Wymaga jednego typu ConditionValue , który może być wartością relative date .
|
DATE_BETWEEN
|
Wartość komórki musi znajdować się między datami dwóch wartości warunku. Obsługiwane przez sprawdzanie poprawności danych. Wymaga dokładnie 2 elementów ConditionValues .
|
DATE_NOT_BETWEEN
|
Wartość komórki nie może wykraczać poza daty dwóch wartości warunku. Obsługiwane przez sprawdzanie poprawności danych. Wymaga dokładnie 2 elementów 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 znajdować się w siatce w zakresie wartości warunku. Obsługiwane przez sprawdzanie poprawności danych. Wymaga pojedynczego parametru ConditionValue , a wartość musi być prawidłowym zakresem w notacji A1.
|
ONE_OF_LIST
|
Wartość komórki musi się znajdować na liście wartości warunku. Obsługiwane przez sprawdzanie poprawności danych. Obsługuje dowolną liczbę właściwości condition values , po jednej na 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 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 ta jest obsługiwana przez sprawdzanie poprawności danych, formatowanie warunkowe i filtry. Nieobsługiwane przez filtry arkuszy źródła danych. Wymaga jednego ConditionValue .
|
BOOLEAN
|
Wartość komórki musi mieć wartość TRUE (prawda) lub FALSE (fałsz) 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 (prawda) lub FALSE (fałsz). Wartość TRUE (PRAWDA) renderuje się jako zaznaczona, a wartość FALSE (FAŁSZ) jako odznaczona. Jedna wartość wskazuje, że komórka, która zawiera tę wartość, jest wyrenderowana jako zaznaczona. Jeśli jest pusta, ta komórka jest odznaczona. Dwie wartości wskazują, że komórka zawierająca pierwszą wartość będzie wyrenderowana jako zaznaczona, a jeśli druga wartość będzie zawierać drugą, zostanie odznaczona. Na przykład ["Tak", "Nie"] oznacza, że komórka wyrenderuje zaznaczone pole, jeśli ma wartość „Tak”, i pole odznaczone, jeśli ma wartość „Nie”.
|
TEXT_NOT_EQ
|
Wartość komórki nie może dokładnie odpowiadać wartości warunku. Obsługiwane przez filtry obiektów źródła danych. Wymaga co najmniej 1 elementu ConditionValue .
|
DATE_NOT_EQ
|
Wartość komórki nie może dokładnie odpowiadać wartości warunku. Obsługiwane przez filtry obiektów źródła danych. Wymaga co najmniej 1 elementu ConditionValue .
|
FILTER_EXPRESSION
|
Wartość komórki musi być zgodna z określonym wzorcem. Wymaga jednego ConditionValue .
|
ConditionValue
Wartość warunku.
Zapis JSON |
---|
{ // Union field |
Pola | |
---|---|
Pole sumy value . Musisz ustawić dokładnie jedną wartość warunku.
value może mieć tylko jedną z tych wartości:
|
|
relativeDate
|
Data względna (na podstawie bieżącej daty). Obowiązuje tylko wtedy, gdy Sprawdzanie poprawności danych nie obsługuje dat względnych. Są one obsługiwane tylko w przypadku formatowania warunkowego i filtrów warunkowych. |
userEnteredValue
|
Wartość, na podstawie której określony jest warunek. Wartość jest analizowana tak, jakby użytkownik wpisał tekst do komórki. Formuły są obsługiwane (muszą się zaczynać od |
RelativeDate
Określa sposób oceny warunku daty.
Wartości w polu enum | |
---|---|
RELATIVE_DATE_UNSPECIFIED
|
Wartość domyślna, nie używać. |
PAST_YEAR
|
Wartość to rok wcześniej niż dzisiaj. |
PAST_MONTH
|
Wartość to miesiąc przed dzisiejszą datą. |
PAST_WEEK
|
Wartość to tydzień przed dzisiejszą datą. |
YESTERDAY
|
Wartość to wczoraj. |
TODAY
|
Wartość to bieżąca wartość. |
TOMORROW
|
Wartość to jutro. |
GridRange
Zakres w arkuszu. Wszystkie indeksy są liczone od zera. Indeksy są w połowie otwarte, tzn. indeks początkowy jest włącznie, a indeks końcowy jest wyłączny – [startIndex, endIndex). Brakujące indeksy wskazują, że zakres po tej stronie jest nieograniczony.
Jeśli np. "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
Wartość indeksu początkowego musi być zawsze mniejsza od indeksu końcowego lub jej równa. Jeśli indeks początkowy jest taki sam jak indeks końcowy, zakres jest pusty. Puste zakresy zwykle nie mają znaczenia i zwykle są renderowane w interfejsie jako #REF!
.
Zapis JSON |
---|
{ "sheetId": integer, "startRowIndex": integer, "endRowIndex": integer, "startColumnIndex": integer, "endColumnIndex": integer } |
Pola | |
---|---|
sheetId
|
Arkusz, na którym znajduje się ten zakres. |
startRowIndex
|
Wiersz początkowy (włącznie z tym zakresem) zakresu. Jeśli nie jest ograniczony, nie jest ustawiony. |
endRowIndex
|
Wiersz końcowy (wyłącznie) zakresu lub nieustawiony, jeśli jest nieograniczony. |
startColumnIndex
|
Kolumna początkowa zakresu (włącznie z tym zakresem) lub nieustawiona, jeśli jest nieograniczona. |
endColumnIndex
|
Kolumna końcowa zakresu (wyłączona) lub nieustawiona, jeśli jest nieograniczona. |
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 filtrowania powiązane z konkretną kolumną.
Zapis JSON |
---|
{ "filterCriteria": { object ( |
Pola | |
---|---|
filterCriteria
|
Kryteria kolumny. |
Pole sumy reference . Odwołanie do filtrowanej kolumny.
reference może mieć tylko jedną z tych wartości:
|
|
columnIndex
|
Indeks kolumny liczony od zera. |
dataSourceColumnReference
|
Odwołanie do kolumny źródła danych. |
FilterCriteria
Kryteria wyświetlania/ukrywania wierszy w widoku filtra lub filtra.
Zapis JSON |
---|
{ "hiddenValues": [ string ], "condition": { object ( |
Pola | |
---|---|
condition
|
Warunek, który musi zostać spełniony, aby wartości zostały wyświetlone. (Nie zastępuje to elementu |
visibleBackgroundColor
|
Kolor wypełnienia tła, według którego chcesz filtrować. Wyświetlane są tylko komórki z tym kolorem wypełnienia. Wzajemnie w: |
visibleBackgroundColorStyle
|
Kolor wypełnienia tła, według którego chcesz filtrować. Wyświetlane są tylko komórki z tym kolorem wypełnienia. To pole wzajemnie się wyklucza z |
visibleForegroundColor
|
Kolor pierwszego planu, według którego chcesz filtrować. Wyświetlane są tylko komórki z tym kolorem. Wzajemnie w: |
visibleForegroundColorStyle
|
Kolor pierwszego planu, według którego chcesz filtrować. Wyświetlane są tylko komórki z tym kolorem. To pole wzajemnie się wyklucza z |
SortSpec
Porządek sortowania powiązany z określoną kolumną lub wierszem.
Zapis JSON |
---|
{ "sortOrder": enum ( |
Pola | |
---|---|
sortOrder
|
Dane dotyczące kolejności powinny zostać posortowane. |
foregroundColor
|
Kolor pierwszego planu, według którego następuje sortowanie. Komórki z tym kolorem są sortowane na górę. Wzajemnie w: |
foregroundColorStyle
|
Kolor pierwszego planu, według którego następuje sortowanie. Komórki z tym kolorem są sortowane na górę. Wzajemnie wyklucza się z |
backgroundColor
|
Kolor wypełnienia tła, według którego następuje sortowanie. Komórki z tym kolorem wypełnienia są sortowane na górze. Wzajemnie w: |
backgroundColorStyle
|
Kolor wypełnienia tła, według którego następuje sortowanie. Komórki z tym kolorem wypełnienia są sortowane na górze. Wzajemnie wyklucza się z |
Pole sumy reference . Odniesienie do posortowanego wymiaru.
reference może mieć tylko jedną z tych wartości:
|
|
dimensionIndex
|
Wymiar, do którego należy zastosować sortowanie. |
dataSourceColumnReference
|
Odwołanie do kolumny źródła danych. |
EmbeddedObjectPosition
Pozycja umieszczonego obiektu, np. wykresu.
Zapis JSON |
---|
{ // Union field |
Pola | |
---|---|
Pole sumy location . Lokalizacja obiektu. Musisz ustawić dokładnie jedną wartość.
location może mieć tylko jedną z tych wartości:
|
|
sheetId
|
Ten arkusz znajduje się w tym arkuszu. Ustaw tylko wtedy, gdy osadzony obiekt znajduje się w osobnym arkuszu. Wartość nie może być liczbą ujemną. |
overlayPosition
|
Pozycja, w której obiekt jest nakładany na siatkę. |
newSheet
|
Jeśli ma wartość true (prawda), osadzony obiekt zostanie umieszczony w nowym arkuszu, którego identyfikator zostanie wybrany za Ciebie. Używana tylko podczas pisania. |
OverlayPosition
Lokalizacja obiektu nałożonego na siatkę.
Zapis JSON |
---|
{
"anchorCell": {
object (
|
Pola | |
---|---|
anchorCell
|
Komórka, do której obiekt jest zakotwiczony. |
offsetXPixels
|
Przesunięcie w poziomie od komórki zakotwiczonej (w pikselach). |
offsetYPixels
|
Przesunięcie obiektu w pionie (w pikselach) od komórki zakotwiczenia. |
widthPixels
|
Szerokość obiektu w pikselach. Domyślna wartość to 600. |
heightPixels
|
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
|
Arkusz, w którym znajduje się ta współrzędna. |
rowIndex
|
Indeks wiersza współrzędnych. |
columnIndex
|
Indeks kolumny współrzędnych. |