Other

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

number

Czerwony kolor w postaci wartości z przedziału [0, 1].

green

number

Zielony kolor w wartościach z przedziału [0, 1].

blue

number

Niebieski kolor w wartościach z przedziału [0, 1].

alpha

number

Odsetek tego koloru, który należy zastosować w pikselu. Oznacza to, że końcowy kolor piksela jest określany za pomocą równania:

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

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 kind can be only one of the following:
  "rgbColor": {
    object (Color)
  },
  "themeColor": enum (ThemeColorType)
  // End of list of possible types for union field kind.
}
Pola
Pole sumy: kind. Rodzaj wartości koloru. kind może być tylko jedną z tych wartości:
rgbColor

object (Color)

Kolor RGB. Wartość alpha w obiekcie Color nie jest zwykle obsługiwana.

themeColor

enum (ThemeColorType)

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

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 (Color)
  },
  "foregroundColorStyle": {
    object (ColorStyle)
  },
  "fontFamily": string,
  "fontSize": integer,
  "bold": boolean,
  "italic": boolean,
  "strikethrough": boolean,
  "underline": boolean,
  "link": {
    object (Link)
  }
}
Pola
foregroundColor
(deprecated)

object (Color)

Kolor pierwszego planu tekstu. Wycofano: użyj właściwości foregroundColorStyle.

foregroundColorStyle

object (ColorStyle)

Kolor pierwszego planu tekstu. Jeśli ustawiona jest też wartość 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 jest wpisana kursywą.

strikethrough

boolean

Wartość „prawda”, jeśli tekst jest przekreślony.

underline

boolean

Wartość „prawda”, jeśli tekst jest podkreślony.

Kolumna DataSource

Kolumna w źródle danych.

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

object (DataSourceColumnReference)

Odwołanie do kolumny.

formula

string

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

string

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 (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 (może być pusty).

lastRefreshTime

string (Timestamp format)

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 value can be only one of the following:
  "numberValue": number,
  "stringValue": string,
  "boolValue": boolean,
  "formulaValue": string,
  "errorValue": {
    object (ErrorValue)
  }
  // End of list of possible types for union field value.
}
Pola
Pole sumy: value. Typ wartości w komórce. Jeśli nie ustawisz żadnego pola, komórka nie będzie zawierać danych. value może być tylko jedną z tych wartości:
numberValue

number

Reprezentuje podwójną wartość. Uwaga: daty, godziny i daty są podane w formacie SERIAL_NUMBER.

stringValue

string

Reprezentuje wartość ciągu. Nie podaje się wiodących pojedynczych cudzysłowów. Jeśli na przykład użytkownik wpisze w interfejsie wartość '123, w postaci stringValue pojawi się wartość "123".

boolValue

boolean

Reprezentuje wartość logiczną.

formulaValue

string

Reprezentuje formułę.

errorValue

object (ErrorValue)

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

Wartość błędu

Błąd w komórce.

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

enum (ErrorType)

Typ błędu.

message

string

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

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 (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ść zerową, inne – jedną lub dwie, a ConditionType.ONE_OF_LIST obsługuje dowolną liczbę wartości.

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 value can be only one of the following:
  "relativeDate": enum (RelativeDate),
  "userEnteredValue": string
  // End of list of possible types for union field value.
}
Pola
Pole sumy: value. Wartość warunku musi być określona. value może być tylko jedną z tych wartości:
relativeDate

enum (RelativeDate)

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

Weryfikacja dat względnych nie jest obsługiwana. Są obsługiwane tylko w przypadku formatowania warunkowego i filtrów warunkowych.

userEnteredValue

string

Wartość oparta na warunku. Wartość jest analizowana, jakby użytkownik wpisał komórkę. Formuły są obsługiwane (muszą zaczynać się od = lub „+”).

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

integer

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

startRowIndex

integer

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

endRowIndex

integer

Wiersz końcowy (wyłączny) zakresu lub nieustawiony, jeśli nie jest ograniczony.

startColumnIndex

integer

Początek kolumny (włącznie z zakresem) lub nieustawiona, jeśli zakres nie jest ograniczony.

endColumnIndex

integer

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 (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 dotyczące kolumny.

Pole sumy: reference. Odniesienie do filtrowanej kolumny. reference może być tylko jedną z tych wartości:
columnIndex

integer

Indeks kolumny opartej na zerach.

dataSourceColumnReference

object (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 (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ępuje to hiddenValues, jeśli wartość znajduje się na tej liście, jest nadal ukryta).

visibleBackgroundColor
(deprecated)

object (Color)

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 visibleForegroundColor. Wycofano: użyj właściwości visibleBackgroundColorStyle.

visibleBackgroundColorStyle

object (ColorStyle)

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 i musi być kolorem RGB. Jeśli ustawiona jest też wartość visibleBackgroundColor, to pole ma pierwszeństwo.

visibleForegroundColor
(deprecated)

object (Color)

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 visibleBackgroundColor. Wycofano: użyj właściwości visibleForegroundColorStyle.

visibleForegroundColorStyle

object (ColorStyle)

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 visibleBackgroundColor i musi być kolorem RGB. Jeśli ustawiona jest też wartość visibleForegroundColor, to pole ma pierwszeństwo.

Specyfikacja sortowania

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

Zapis JSON
{
  "sortOrder": enum (SortOrder),
  "foregroundColor": {
    object (Color)
  },
  "foregroundColorStyle": {
    object (ColorStyle)
  },
  "backgroundColor": {
    object (Color)
  },
  "backgroundColorStyle": {
    object (ColorStyle)
  },

  // Union field reference can be only one of the following:
  "dimensionIndex": integer,
  "dataSourceColumnReference": {
    object (DataSourceColumnReference)
  }
  // End of list of possible types for union field reference.
}
Pola
sortOrder

enum (SortOrder)

Dane dotyczące zamówienia powinny zostać posortowane.

foregroundColor
(deprecated)

object (Color)

Kolor pierwszego planu, który ma zostać posortowany. Komórki z tym kolorem są sortowane na górze. Wzajemnie wyłączna z backgroundColor. Wycofano: użyj właściwości foregroundColorStyle.

foregroundColorStyle

object (ColorStyle)

Kolor pierwszego planu, który ma zostać posortowany. Komórki z tym kolorem są sortowane na górze. Musi się wzajemnie wykluczać na backgroundColor i musi być kolorem RGB. Jeśli ustawiona jest też wartość foregroundColor, to pole ma pierwszeństwo.

backgroundColor
(deprecated)

object (Color)

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 foregroundColor. Wycofano: użyj właściwości backgroundColorStyle.

backgroundColorStyle

object (ColorStyle)

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 foregroundColor i musi być kolorem RGB. Jeśli ustawiona jest też wartość backgroundColor, to pole ma pierwszeństwo.

Pole sumy: reference. Odwołanie do posortowanego wymiaru. reference może być tylko jedną z tych wartości:
dimensionIndex

integer

Wymiar, do którego należy zastosować sortowanie.

dataSourceColumnReference

object (DataSourceColumnReference)

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

Pozycja obiektu umieszczonego

Pozycja umieszczonego obiektu, takiego jak wykres.

Zapis JSON
{

  // Union field location can be only one of the following:
  "sheetId": integer,
  "overlayPosition": {
    object (OverlayPosition)
  },
  "newSheet": boolean
  // End of list of possible types for union field location.
}
Pola
Pole sumy: location. Lokalizacja obiektu. Musisz podać dokładnie 1 wartość. location może być tylko jedną z tych wartości:
sheetId

integer

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

object (OverlayPosition)

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

newSheet

boolean

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 (GridCoordinate)
  },
  "offsetXPixels": integer,
  "offsetYPixels": integer,
  "widthPixels": integer,
  "heightPixels": integer
}
Pola
anchorCell

object (GridCoordinate)

Komórka, do której jest zakotwiczony obiekt.

offsetXPixels

integer

Przesunięcie w poziomie w pikselach, które powoduje przesunięcie obiektu od komórki zakotwiczenia.

offsetYPixels

integer

Przesunięcie pionowe (w pikselach) odsunięte od komórki od kotwicy.

widthPixels

integer

Szerokość obiektu w pikselach. Wartość domyślna to 600.

heightPixels

integer

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

integer

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

rowIndex

integer

Indeks wiersza współrzędnej.

columnIndex

integer

Indeks kolumny współrzędnej.