Kolor
Odzwierciedla kolor w przestrzeni kolorów RGBA. Ta reprezentacja została zaprojektowana z myślą o prostości w przeliczaniu na różne kolory w różnych językach, a nie tylko pod kątem kompatybilności. Na przykład pola tej reprezentacji można trywizować do konstruktora java.awt.Color
w Javie; można je też podawać do metody +colorWithRed:green:blue:alpha
UIColor w systemie iOS. Niewielką ilość można łatwo sformatować w ramach CSS rgba()
w kodzie CSS.
Na tej stronie nie ma informacji o absolutnej przestrzeni kolorów, która powinna być używana do interpretacji wartości RGB, na przykład sRGB, Adobe RGB, DCI-P3 i BT.2020. Domyślnie aplikacje powinny przyjąć przestrzeń kolorów sRGB.
Jeśli trzeba ustalić równość kolorów, implementacje dwóch kolorów należy traktować jako równoważne, chyba że wszystkie ich wartości czerwone, zielone, niebieskie 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
|
Czerwony kolor w postaci wartości z przedziału [0, 1]. |
green
|
Zielony kolor w wartościach z przedziału [0, 1]. |
blue
|
Niebieski kolor w wartościach z przedziału [0, 1]. |
alpha
|
Odsetek tego koloru, który należy zastosować w pikselu. Oznacza to, że końcowy kolor piksela jest określany za pomocą równania:
Oznacza to, że wartość 1,0 odpowiada jednolitemu kolorowi, a wartość 0,0 odpowiada całkowicie przezroczystemu kolorowi. Korzysta on z kodu towarzyszącego, a nie z prostego skalarnego skalarnego, dzięki czemu można odróżnić wartość domyślną od ustawionej. Jeśli ten warunek zostanie pominięty, obiekt koloru jest renderowany jako jednolity kolor (tak jakby wartość alfa wynosiła 1,0). |
Styl koloru
Wartość koloru.
Zapis JSON |
---|
{ // Union field |
Pola | |
---|---|
Pole sumy: kind . Rodzaj wartości koloru.
kind może być tylko jedną z tych wartości:
|
|
rgbColor
|
Kolor RGB. Wartość |
themeColor
|
Kolor motywu. |
Rodzaj koloru motywu
Typy kolorów motywu.
SpreadsheetProperties
zawiera SpreadsheetTheme
, który definiuje mapowanie kolorów tego motywu na konkretne kolory.
Wartości w polu enum | |
---|---|
THEME_COLOR_TYPE_UNSPECIFIED
|
Nieokreślony kolor motywu |
TEXT
|
Odzwierciedla kolor głównego tekstu |
BACKGROUND
|
Odzwierciedla kolor głównego tła |
ACCENT1
|
Odzwierciedla pierwszy kolor uzupełniający |
ACCENT2
|
Odzwierciedla drugi kolor uzupełniający |
ACCENT3
|
Odzwierciedla trzeci kolor uzupełniający |
ACCENT4
|
Odzwierciedla 4. akcent |
ACCENT5
|
Odzwierciedla piąty kolor uzupełniający |
ACCENT6
|
Odzwierciedla szósty kolor uzupełniający |
LINK
|
Odzwierciedla kolor używany do hiperlinków |
Wyrównaj w poziomie
Wyrównanie tekstu w komórce w poziomie.
Wartości w polu enum | |
---|---|
HORIZONTAL_ALIGN_UNSPECIFIED
|
Wyrównanie w poziomie nie jest określone. Nie używaj tej funkcji. |
LEFT
|
Tekst jest wyraźnie wyrównany do lewej krawędzi komórki. |
CENTER
|
Tekst jest wyśrodkowany na środku komórki. |
RIGHT
|
Tekst jest wyraźnie wyrównany do prawej strony komórki. |
Format tekstu
Format uruchomienia 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. Wycofano: użyj właściwości |
foregroundColorStyle
|
Kolor pierwszego planu tekstu. Jeśli ustawiona jest też wartość |
fontFamily
|
Rodzina czcionek. |
fontSize
|
Rozmiar czcionki. |
bold
|
Wartość „prawda”, jeśli tekst jest pogrubiony. |
italic
|
Wartość prawda jest wpisana kursywą. |
strikethrough
|
Wartość „prawda”, jeśli tekst jest przekreślony. |
underline
|
Wartość „prawda”, jeśli tekst jest podkreślony. |
link
|
Miejsce docelowe linku do tekstu (jeśli występuje). Jeśli skonfigurujesz pole linku w |
Link
Zewnętrzny lub lokalny plik referencyjny.
Zapis JSON |
---|
{ // Union field |
Pola | |
---|---|
Pole sumy: destination . Miejsce docelowe linku.
destination może być tylko jedną z tych wartości:
|
|
uri
|
Identyfikator linku. |
Kolumna DataSource
Kolumna w źródle danych.
Zapis JSON |
---|
{
"reference": {
object (
|
Pola | |
---|---|
reference
|
Odwołanie do kolumny. |
formula
|
Wzór obliczonej kolumny. |
Odniesienie do kolumny DataSource
Unikalny identyfikator, który odwołuje się do kolumny źródła danych.
Zapis JSON |
---|
{ "name": string } |
Pola | |
---|---|
name
|
Wyświetlana nazwa kolumny. Powinna być niepowtarzalna w źródle danych. |
Stan wykonania danych
Stan wykonania danych.
Tworzone jest źródło danych w celu synchronizacji obiektu źródła danych z najnowszymi danymi z DataSource
. Zazwyczaj jest to zadanie uruchomione w tle, możesz sprawdzić jego state
, aby określić, czy wykonanie zostało ukończone
Istnieje kilka scenariuszy, w których może zostać uruchomione dane:
-
Adding a data source
tworzy powiązany arkusz źródła danych oraz wykonania danych, by zsynchronizować je ze źródłem danych. -
Updating a data source
tworzy uruchomienie danych, aby odświeżyć powiązany arkusz źródła danych. -
Możesz wysłać
refresh request
, aby jednoznacznie odświeżyć jeden lub więcej obiektów źródła danych.
Zapis JSON |
---|
{ "state": enum ( |
Pola | |
---|---|
state
|
Stan wykonania danych. |
errorCode
|
Kod błędu. |
errorMessage
|
Komunikat o błędzie (może być pusty). |
lastRefreshTime
|
Pobiera czas ostatniego odświeżenia danych. |
Stan wykonywania danych
Lista stanów wykonania danych.
Wartości w polu enum | |
---|---|
DATA_EXECUTION_STATE_UNSPECIFIED
|
Wartość domyślna, nie używać. |
NOT_STARTED
|
Nie rozpoczęto wykonywania danych. |
RUNNING
|
Rozpoczęto wykonywanie danych. |
SUCCEEDED
|
Wykonanie danych zostało zakończone. |
FAILED
|
Wykonanie danych zakończyło się z błędami. |
Kod błędu wykonania danych
Lista kodów błędów dotyczących wykonywania danych.
Wartości w polu enum | |
---|---|
DATA_EXECUTION_ERROR_CODE_UNSPECIFIED
|
Wartość domyślna, nie używać. |
TIMED_OUT
|
Upłynął czas wykonywania danych. |
TOO_MANY_ROWS
|
Wykonanie danych zwraca więcej wierszy niż limit. |
TOO_MANY_COLUMNS
|
Wykonanie danych zwraca więcej kolumn, niż wynosi limit. |
TOO_MANY_CELLS
|
Wykonanie danych zwraca więcej komórek niż dozwolony limit. |
ENGINE
|
Odczytawany jest błąd z mechanizmu wykonywania danych backendu (np. BigQuery). Szczegóły znajdziesz na stronie errorMessage .
|
PARAMETER_INVALID
|
Co najmniej 1 z podanych parametrów źródła danych jest nieprawidłowy. |
UNSUPPORTED_DATA_TYPE
|
Wykonanie danych zwraca nieobsługiwany typ danych. |
DUPLICATE_COLUMN_NAMES
|
Wykonanie danych zwraca zduplikowane nazwy kolumn lub aliasy. |
INTERRUPTED
|
Wykonywanie danych jest przerywane. Odśwież później. |
CONCURRENT_QUERY
|
Trwa wykonywanie danych. Nie można ich odświeżyć, dopóki się nie zakończy. |
OTHER
|
Inne błędy. |
TOO_MANY_CHARS_PER_CELL
|
Wykonanie danych zwraca wartości, które przekraczają maksymalną liczbę znaków dozwoloną 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 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 obiekcie RefreshDataSourceRequest .
|
OBJECT_SPEC_INVALID
|
Specyfikacja obiektu źródła danych jest nieprawidłowa. |
Wartość rozszerzona
Rodzaje wartości w komórce arkusza kalkulacyjnego.
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 być tylko jedną z tych wartości:
|
|
numberValue
|
Reprezentuje podwójną wartość. Uwaga: daty, godziny i daty są podane w formacie |
stringValue
|
Reprezentuje wartość ciągu. Nie podaje się wiodących pojedynczych cudzysłowów. Jeśli na przykład użytkownik wpisze w interfejsie wartość |
boolValue
|
Reprezentuje wartość logiczną. |
formulaValue
|
Reprezentuje formułę. |
errorValue
|
Reprezentuje błąd. To pole jest tylko do odczytu. |
Wartość błędu
Błąd w komórce.
Zapis JSON |
---|
{
"type": enum (
|
Pola | |
---|---|
type
|
Typ błędu. |
message
|
Komunikat z dodatkowymi informacjami o błędzie (w ustawieniach regionalnych arkusza kalkulacyjnego). |
Typ błędu
Typ błędu.
Wartości w polu enum | |
---|---|
ERROR_TYPE_UNSPECIFIED
|
Nie używaj tego typu błędu. |
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... .
|
Wartość logiczna
Warunek, który może zostać uznany za prawdziwy lub fałsz. Wartości logiczne są używane przez formatowanie warunkowe, weryfikację 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 |
Typ warunku
Typ warunku.
Wartości w polu enum | |
---|---|
CONDITION_TYPE_UNSPECIFIED
|
Wartość domyślna – nie używaj. |
NUMBER_GREATER
|
Wartość w komórce musi być większa niż wartość warunku. Obsługiwane przez weryfikację danych, formatowanie warunkowe i filtry. Wymaga pojedynczego obiektu ConditionValue .
|
NUMBER_GREATER_THAN_EQ
|
Wartość w komórce musi być większa od wartości warunku lub jej równa. Obsługiwane przez weryfikację danych, formatowanie warunkowe i filtry. Wymaga pojedynczego obiektu ConditionValue .
|
NUMBER_LESS
|
Wartość w komórce musi być mniejsza niż wartość warunku. Obsługiwane przez weryfikację danych, formatowanie warunkowe i filtry. Wymaga pojedynczego obiektu ConditionValue .
|
NUMBER_LESS_THAN_EQ
|
Wartość w komórce musi być mniejsza od wartości warunku lub jej równa. Obsługiwane przez weryfikację danych, formatowanie warunkowe i filtry. Wymaga pojedynczego obiektu ConditionValue .
|
NUMBER_EQ
|
Wartość w komórce musi być równa wartości warunku. Obsługiwane przez weryfikację danych, formatowanie warunkowe i filtry. Wymagana jest tylko jedna właściwość ConditionValue na potrzeby sprawdzania poprawności danych, formatowania warunkowego i filtrów dla obiektów niebędących źródłem danych oraz co najmniej 1 element ConditionValue na potrzeby filtrów obiektów źródła danych.
|
NUMBER_NOT_EQ
|
Wartość w komórce nie może być równa wartości warunku. Obsługiwane przez weryfikację danych, formatowanie warunkowe i filtry. Wymagana jest tylko jedna właściwość ConditionValue na potrzeby sprawdzania poprawności danych, formatowania warunkowego i filtrów dla obiektów niebędących źródłem danych oraz co najmniej 1 element ConditionValue na potrzeby filtrów obiektów źródła danych.
|
NUMBER_BETWEEN
|
Wartość w komórce musi mieścić się w zakresie dwóch warunków warunku. Obsługiwane przez weryfikację danych, formatowanie warunkowe i filtry. Wymaga dokładnie 2 elementów ConditionValues .
|
NUMBER_NOT_BETWEEN
|
Wartość w komórce nie może zawierać się między dwoma wartościami warunku. Obsługiwane przez weryfikację danych, formatowanie warunkowe i filtry. Wymaga dokładnie 2 elementów ConditionValues .
|
TEXT_CONTAINS
|
Wartość w komórce musi zawierać wartość warunku. Obsługiwane przez weryfikację danych, formatowanie warunkowe i filtry. Wymaga pojedynczego obiektu ConditionValue .
|
TEXT_NOT_CONTAINS
|
Wartość w komórce nie może zawierać wartości warunku. Obsługiwane przez weryfikację danych, formatowanie warunkowe i filtry. Wymaga pojedynczego obiektu ConditionValue .
|
TEXT_STARTS_WITH
|
Wartość w komórce musi zaczynać się od wartości warunku. Obsługiwane przez formatowanie warunkowe i filtry. Wymaga pojedynczego obiektu ConditionValue .
|
TEXT_ENDS_WITH
|
Wartość w komórce musi kończyć się wartością warunku. Obsługiwane przez formatowanie warunkowe i filtry. Wymaga pojedynczego obiektu ConditionValue .
|
TEXT_EQ
|
Wartość w komórce musi być dokładnie taka sama jak wartość warunku. Obsługiwane przez weryfikację danych, formatowanie warunkowe i filtry. Wymagana jest tylko jedna właściwość ConditionValue na potrzeby sprawdzania poprawności danych, formatowania warunkowego i filtrów dla obiektów niebędących źródłem danych oraz co najmniej 1 element ConditionValue na potrzeby filtrów obiektów źródła danych.
|
TEXT_IS_EMAIL
|
Wartość w komórce musi być prawidłowym adresem e-mail. Obsługiwane przez weryfikację danych. Nie wymaga ConditionValues .
|
TEXT_IS_URL
|
Wartość w komórce musi być prawidłowym adresem URL. Obsługiwane przez weryfikację danych. Nie wymaga ConditionValues .
|
DATE_EQ
|
Wartość w komórce musi być tego samego dnia co wartość warunku. Obsługiwane przez weryfikację danych, formatowanie warunkowe i filtry. Wymagana jest tylko jedna właściwość ConditionValue na potrzeby sprawdzania poprawności danych, formatowania warunkowego i filtrów dla obiektów niebędących źródłem danych oraz co najmniej 1 element ConditionValue na potrzeby filtrów obiektów źródła danych.
|
DATE_BEFORE
|
Wartość w komórce musi być wcześniejsza niż data w warunku. Obsługiwane przez weryfikację danych, formatowanie warunkowe i filtry. Wymaga pojedynczego obiektu ConditionValue , które może być typu relative date .
|
DATE_AFTER
|
Wartość w komórce musi być późniejsza od wartości warunku. Obsługiwane przez weryfikację danych, formatowanie warunkowe i filtry. Wymaga pojedynczego obiektu ConditionValue , które może być typu relative date .
|
DATE_ON_OR_BEFORE
|
Wartość w komórce musi być wcześniejsza niż data wartości warunku. Obsługiwane przez weryfikację danych. Wymaga pojedynczego obiektu ConditionValue , które może być typu relative date .
|
DATE_ON_OR_AFTER
|
Wartość w komórce musi być wcześniejsza niż data wartości warunku. Obsługiwane przez weryfikację danych. Wymaga pojedynczego obiektu ConditionValue , które może być typu relative date .
|
DATE_BETWEEN
|
Wartość w komórce musi mieścić się w zakresie dat dwóch warunków warunku. Obsługiwane przez weryfikację danych. Wymaga dokładnie 2 elementów ConditionValues .
|
DATE_NOT_BETWEEN
|
Wartość w komórce musi mieścić się w zakresie dat dwóch warunków warunku. Obsługiwane przez weryfikację danych. Wymaga dokładnie 2 elementów ConditionValues .
|
DATE_IS_VALID
|
Wartość w komórce musi być datą. Obsługiwane przez weryfikację danych. Nie wymaga ConditionValues .
|
ONE_OF_RANGE
|
Wartość w komórce musi znajdować się w siatce z zakresu wartości warunku. Obsługiwane przez weryfikację danych. Wymaga pojedynczego atrybutu ConditionValue , a wartość musi być prawidłowym zakresem w notacji A1.
|
ONE_OF_LIST
|
Wartość w komórce musi znajdować się na liście wartości warunków. Obsługiwane przez weryfikację danych. Obsługuje dowolną liczbę elementów condition values , po jednym na element na liście. Wartości nie obsługują formuł.
|
BLANK
|
Wartość w komórce musi być pusta. Obsługiwane przez formatowanie warunkowe i filtry. Nie wymaga ConditionValues .
|
NOT_BLANK
|
Wartość w komórce 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 weryfikację danych, formatowanie warunkowe i filtry. Nieobsługiwane przez filtry arkusza źródła danych. Wymaga pojedynczego obiektu ConditionValue .
|
BOOLEAN
|
Wartością w komórce musi być wartość TRUE/FALSE lub wartość na liście wartości warunku. Obsługiwane przez weryfikację danych. Renderowanie jako pole wyboru komórki. Obsługuje wartość zero, 1 lub 2 ConditionValues . Brak wartości oznacza, że komórka musi mieć wartość TRUE (prawda) lub FALSE (fałsz). TRUE wyrenderuje się jako zaznaczone, a FALSE – jako niezaznaczone. Jedna wartość oznacza, że komórka będzie renderowana jako zaznaczona, jeśli zawiera tę wartość, lub odznaczy ją, gdy będzie pusta. Dwie wartości wskazują, że komórka będzie renderowana jako zaznaczona, jeśli będzie zawierać pierwszą wartość, lub odznaczona, gdy będzie zawierać drugą wartość. Na przykład wartość ["Tak","Nie"] oznacza, że komórka, w której pole ma wartość „Tak”, zostanie wyrenderowana, a jeśli pole ma wartość „Nie”, zostanie odznaczone.
|
TEXT_NOT_EQ
|
Wartość w komórce nie może być dokładnie wartością warunku. Obsługiwane przez filtry obiektów źródła danych. Wymagany jest co najmniej 1 element ConditionValue .
|
DATE_NOT_EQ
|
Wartość w komórce nie może być dokładnie wartością warunku. Obsługiwane przez filtry obiektów źródła danych. Wymagany jest co najmniej 1 element ConditionValue .
|
FILTER_EXPRESSION
|
Wartość w komórce musi być zgodna z określonym wzorcem. Wymaga pojedynczego obiektu ConditionValue .
|
Wartość warunku
Wartość warunku.
Zapis JSON |
---|
{ // Union field |
Pola | |
---|---|
Pole sumy: value . Wartość warunku musi być określona.
value może być tylko jedną z tych wartości:
|
|
relativeDate
|
Data względna (na podstawie bieżącej daty). Obowiązuje tylko wtedy, gdy Weryfikacja dat względnych nie jest obsługiwana. Są obsługiwane tylko w przypadku formatowania warunkowego i filtrów warunkowych. |
userEnteredValue
|
Wartość oparta na warunku. Wartość jest analizowana, jakby użytkownik wpisał komórkę. Formuły są obsługiwane (muszą zaczynać się od |
Data względna
Określa sposób oceny warunku daty.
Wartości w polu enum | |
---|---|
RELATIVE_DATE_UNSPECIFIED
|
Wartość domyślna, nie używać. |
PAST_YEAR
|
Wartość przypada rok wcześniej. |
PAST_MONTH
|
Wartość przypada miesiąc wcześniej niż dzisiaj. |
PAST_WEEK
|
Wartość przypada tydzień wcześniej, |
YESTERDAY
|
Wartość wynosi wczoraj. |
TODAY
|
Wartość jest dzisiejsza. |
TOMORROW
|
Wartość jest jutro. |
Zakres siatki
Zakres na arkuszu. Wszystkie indeksy są zerowe. Indeksy są w połowie otwarte, tj. indeks uwzględniany i końcowy jest wyłączny ([startIndex, endIndex). Brak indeksów oznacza, że zakres po tej stronie jest nieograniczony.
Jeśli na przykład "Sheet1"
to identyfikator arkusza 123456:
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 zawsze być mniejsza niż wartość indeksu końcowego lub jej równa. Jeśli indeks początkowy jest równy indeksu końcowego, 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, w którym znajduje się ten zakres. |
startRowIndex
|
Wiersz początkowy (włącznie z) zakresu lub nieustawiony, jeśli nie jest ograniczony. |
endRowIndex
|
Wiersz końcowy (wyłączny) zakresu lub nieustawiony, jeśli nie jest ograniczony. |
startColumnIndex
|
Początek kolumny (włącznie z zakresem) lub nieustawiona, jeśli zakres nie jest ograniczony. |
endColumnIndex
|
Kolumna końcowa (wyłączna) zakresu lub nieustawiona, jeśli nie jest ograniczona. |
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. |
Specyfikacja filtra
Kryteria filtrowania powiązane z określoną kolumną.
Zapis JSON |
---|
{ "filterCriteria": { object ( |
Pola | |
---|---|
filterCriteria
|
Kryteria dotyczące kolumny. |
Pole sumy: reference . Odniesienie do filtrowanej kolumny.
reference może być tylko jedną z tych wartości:
|
|
columnIndex
|
Indeks kolumny opartej na zerach. |
dataSourceColumnReference
|
Odwołanie do kolumny źródła danych. |
Kryteria filtra
Kryteria wyświetlania/ukrywania wierszy w widoku filtra lub widoku filtra.
Zapis JSON |
---|
{ "hiddenValues": [ string ], "condition": { object ( |
Pola | |
---|---|
condition
|
Warunek, który musi być spełniony, aby wartości były wyświetlane. (Nie zastępuje to |
visibleBackgroundColor
|
Kolor tła tła, według którego mają być filtrowane. Wyświetlane są tylko komórki z tym kolorem wypełnienia. Wzajemnie wyłączna z |
visibleBackgroundColorStyle
|
Kolor tła tła, według którego mają być filtrowane. Wyświetlane są tylko komórki z tym kolorem wypełnienia. Pole to różni się od pozostałych pól |
visibleForegroundColor
|
Kolor pierwszego planu, według którego mają być filtrowane. Wyświetlane są tylko komórki z tym kolorem na pierwszym planie. Wzajemnie wyłączna z |
visibleForegroundColorStyle
|
Kolor pierwszego planu, według którego mają być filtrowane. Wyświetlane są tylko komórki z tym kolorem na pierwszym planie. Pole to różni się od pozostałych pól |
Specyfikacja sortowania
Kolejność sortowania powiązana z określoną kolumną lub wierszem.
Zapis JSON |
---|
{ "sortOrder": enum ( |
Pola | |
---|---|
sortOrder
|
Dane dotyczące zamówienia powinny zostać posortowane. |
foregroundColor
|
Kolor pierwszego planu, który ma zostać posortowany. Komórki z tym kolorem są sortowane na górze. Wzajemnie wyłączna z |
foregroundColorStyle
|
Kolor pierwszego planu, który ma zostać posortowany. Komórki z tym kolorem są sortowane na górze. Musi się wzajemnie wykluczać na |
backgroundColor
|
Kolor wypełnienia tła, według którego należy sortować. Komórki z tym kolorem są sortowane na górze. Wzajemnie wyłączna z |
backgroundColorStyle
|
Kolor wypełnienia tła, według którego należy sortować. Komórki z tym kolorem są sortowane na górze. Musi się wzajemnie wykluczać na |
Pole sumy: reference . Odwołanie do posortowanego wymiaru.
reference może być tylko jedną z tych wartości:
|
|
dimensionIndex
|
Wymiar, do którego należy zastosować sortowanie. |
dataSourceColumnReference
|
Odwołanie do kolumny źródła danych. |
Pozycja obiektu umieszczonego
Pozycja umieszczonego obiektu, takiego jak wykres.
Zapis JSON |
---|
{ // Union field |
Pola | |
---|---|
Pole sumy: location . Lokalizacja obiektu. Musisz podać dokładnie 1 wartość.
location może być tylko jedną z tych wartości:
|
|
sheetId
|
Arkusz, w którym się znajduje. Ustaw tylko wtedy, gdy osadzony obiekt znajduje się we własnym arkuszu. Wartość nie może być liczbą ujemną. |
overlayPosition
|
Pozycja, na której obiekt został nałożony na siatkę. |
newSheet
|
Jeśli wartość to prawda, osadzony obiekt jest umieszczany w nowym arkuszu, którego identyfikator został wybrany za Ciebie. Używany tylko podczas pisania. |
Pozycja nakładki
Lokalizacja, w której nałożony jest obiekt na siatkę.
Zapis JSON |
---|
{
"anchorCell": {
object (
|
Pola | |
---|---|
anchorCell
|
Komórka, do której jest zakotwiczony obiekt. |
offsetXPixels
|
Przesunięcie w poziomie w pikselach, które powoduje przesunięcie obiektu od komórki zakotwiczenia. |
offsetYPixels
|
Przesunięcie pionowe (w pikselach) odsunięte od komórki od kotwicy. |
widthPixels
|
Szerokość obiektu w pikselach. Wartość domyślna to 600. |
heightPixels
|
Wysokość obiektu w pikselach. Wartość domyślna to 371. |
Koordynator linii
Współrzędna w arkuszu. Wszystkie indeksy są zerowe.
Zapis JSON |
---|
{ "sheetId": integer, "rowIndex": integer, "columnIndex": integer } |
Pola | |
---|---|
sheetId
|
Arkusz, na którym znajduje się współrzędna. |
rowIndex
|
Indeks wiersza współrzędnej. |
columnIndex
|
Indeks kolumny współrzędnej. |