Other

Kolor

Reprezentuje kolor w przestrzeni kolorów RGBA. Ta reprezentacja została zaprojektowana w celu ułatwienia konwersji na reprezentacje kolorów i z nich w różnych językach, a nie na potrzeby kompresji. Na przykład pola tej reprezentacji można ł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ż sformatować w postać ciągu rgba() w języku JavaScript.

Na tej stronie referencyjnej nie ma informacji o bezwzględnej przestrzeni kolorów, która powinna być wykorzystywana do interpretacji wartości RGB, np. sRGB, Adobe RGB, DCI-P3 i BT.2020. Domyślnie aplikacje powinny przyjąć przestrzeń kolorów 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 wszystkie ich wartości czerwonego, zielonego, niebieskiego i alfa różnią się co 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 przedziału [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 jednolitym kolorowi, a wartość 0,0 – kolorowi całkowicie przezroczystemu. 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 go pominiesz, 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.

SpreadsheetProperties zawiera SpreadsheetTheme, który określa mapowanie rodzajów kolorów motywu na kolory konkretne.

Wartości w polu enum
THEME_COLOR_TYPE_UNSPECIFIED Nieokreślony kolor motywu
TEXT Reprezentuje podstawowy kolor tekstu.
BACKGROUND Reprezentuje główny 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

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 zostanie wyrównany do lewej krawędzi komórki.
CENTER Tekst jest wyraźnie wyrównany do środka komórki.
RIGHT Tekst jest wyraźnie wyrównany po prawej stronie komórki.

TextFormat

Format serii tekstu w komórce. Wartości nieobecne oznaczają, ż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. 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

Prawda, jeśli tekst jest pogrubiony.

italic

boolean

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

strikethrough

boolean

Prawda, jeśli tekst jest przekreślony.

underline

boolean

Prawda, jeśli tekst jest podkreślony.

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 odwołujący się do kolumny źródła danych.

Zapis JSON 
{
  "name": string
}
Pola
name

string

Wyświetlana nazwa kolumny. Powinien być niepowtarzalny w obrębie źródła danych.

DataExecutionStatus

Stan wykonania danych.

Tworzone jest wykonanie danych, aby zsynchronizować obiekt źródła danych z najnowszymi danymi z DataSource. Zwykle jest ono zaplanowane w tle. Możesz sprawdzić state, aby dowiedzieć się, czy wykonanie się zakończy

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.
  • Funkcja Updating a data source tworzy wykonanie transmisji danych, aby w podobny sposób odświeżyć powiązany arkusz źródła danych.
  • Możesz wysłać prośbęrefresh request, aby wyraźnie 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, który może być pusty.

lastRefreshTime

string (Timestamp format)

Pobiera czas ostatniego pomyślnego odświeżenia danych.

DataExecutionState

Lista 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 Nie uruchomiono zapytania do bazy danych.
RUNNING Zapytanie do bazy danych zostało uruchomione i wciąż jest wykonywane.
CANCELLING Anuluję wykonanie zapytania do bazy danych.
SUCCEEDED Wykonywanie danych zostało zakończone.
FAILED Wykonywanie 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, nie używaj.
TIMED_OUT Przekroczono limit czasu wykonywania zapytania.
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). Szczegóły znajdziesz na stronie errorMessage.
PARAMETER_INVALID Co najmniej jeden z podanych parametrów źródła danych jest nieprawidłowy.
UNSUPPORTED_DATA_TYPE Zapytanie do bazy danych zwraca nieobsługiwany typ danych.
DUPLICATE_COLUMN_NAMES Zapytanie do bazy danych zwraca zduplikowane nazwy kolumn lub aliasy.
INTERRUPTED Generowanie 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 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 sumy value. 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ść podwójnej precyzji. Uwaga: daty, godziny i daty/godziny są reprezentowane jako liczby podwójnie dokładne w formacie SERIAL_NUMBER.

stringValue

string

Reprezentuje wartość tekstową. Pojedyncze cudzysłowy na początku nie są uwzględniane. Jeśli na przykład użytkownik wpisał w interfejsie użytkownika '123, zostanie to odzwierciedlone jako stringValue z wartością "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 ustawieniach regionalnych 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 Jest to odpowiednik błędu #DIV/0.
VALUE Odpowiada błędowi#VALUE!.
REF Jest to odpowiednik błędu #REF!.
NAME Jest to odpowiednik błędu #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 BooleanCondition są używane przez formatowanie warunkowe, sprawdzanie poprawności 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 mogą mieć wartość 0, a 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 pojedynczego ConditionValue.
NUMBER_LESS Wartość komórki musi być mniejsza niż wartość warunku. Obsługiwane przez sprawdzanie poprawności danych, formatowanie warunkowe i filtry. Wymaga jednego ConditionValue.
NUMBER_LESS_THAN_EQ Wartość komórki musi być mniejsza od wartości warunku lub jej równa. Obsługiwane przez sprawdzanie poprawności danych, formatowanie warunkowe i filtry. Wymaga pojedynczego ConditionValue.
NUMBER_EQ Wartość komórki musi być równa wartości warunku. Obsługiwane przez sprawdzanie poprawności danych, formatowanie warunkowe i filtry. Wymaga jednego obiektu ConditionValue do sprawdzania poprawności danych, formatowania warunkowego i filtrów w przypadku obiektów niebędących źródłem danych oraz co najmniej jednego ConditionValue do filtrów obiektów źródła 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 ConditionValue do sprawdzania poprawności danych, formatowania warunkowego i filtrów w obiektach innych niż źródło danych oraz co najmniej jednego 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 pojedynczego ConditionValue.
TEXT_NOT_CONTAINS Wartość komórki nie może zawierać wartości warunku. Obsługiwane przez sprawdzanie poprawności danych, formatowanie warunkowe i filtry. Wymaga 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 obiektu ConditionValue do sprawdzania poprawności danych, formatowania warunkowego i filtrów w przypadku obiektów niebędących źródłem danych oraz co najmniej jednego ConditionValue do filtrów obiektów źródła 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ć tą samą datą co wartość warunku. Obsługiwane przez sprawdzanie poprawności danych, formatowanie warunkowe i filtry. Wymaga jednego obiektu ConditionValue do sprawdzania poprawności danych, formatowania warunkowego i filtrów w obiektach innych niż źródło danych oraz co najmniej jednego obiektu ConditionValue do filtrów w obiektach źródła danych.
DATE_BEFORE Wartość komórki musi być wcześniejsza niż data wartości warunku. Obsługiwane przez sprawdzanie poprawności danych, formatowanie warunkowe i filtry. Wymaga jednego ConditionValue, który może być relative date.
DATE_AFTER Wartość komórki musi być późniejsza niż wartość warunku. Funkcja jest obsługiwana 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 elementów 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 elementów ConditionValues.
DATE_IS_VALID Wartością komórki musi być data. 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 parametru ConditionValue, a wartość musi być prawidłowym zakresem w notacji A1.
ONE_OF_LIST Wartość komórki musi znajdować się na liście wartości warunku. Obsługiwane przez sprawdzanie poprawności danych. Obsługuje dowolną liczbę 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ść oznacza, że komórka będzie renderowana jako zaznaczona, jeśli zawiera daną wartość, i odznaczona, jeśli będzie 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 dokładnie różnić się od wartości warunku. Obsługiwane przez filtry w obiektach ź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 opiera się warunek. Wartość jest analizowana tak, jakby użytkownik wpisał ją w komórce. Formuły są obsługiwane (i muszą zaczynać się od = lub „+”).

RelativeDate

Określa sposób oceny warunku daty.

Wartości w polu enum
RELATIVE_DATE_UNSPECIFIED Wartość domyślna, nie używaj.
PAST_YEAR Ta wartość przypada o rok wcześniej.
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 dzisiejsza wartość.
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 indeks końcowy jest 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ą zwykle renderowane w interfejsie użytkownika 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) zakresu lub nie ustawiony, jeśli zakres jest nieograniczony.

endRowIndex

integer

Wiersz końcowy (z wyłączeniem) zakresu lub nieustawiony, jeśli jest nieograniczony.

startColumnIndex

integer

Kolumna początkowa (włącznie) zakresu lub nieustawiona, jeśli jest nieograniczona.

endColumnIndex

integer

Kolumna końcowa (wyłącznie) zakresu lub nieskonfigurowana, jeśli zakres jest nieograniczony.

SortOrder

porządek sortowania,

Wartości w polu enum
SORT_ORDER_UNSPECIFIED Wartość domyślna – nie używaj jej.
ASCENDING Sortowanie rosnące.
DESCENDING Sortowanie malejąco.

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. reference może mieć 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 lub ukrywania wierszy w filtrze lub widoku filtra.

Zapis JSON 
{
  "hiddenValues": [
    string
  ],
  "condition": {
    object (BooleanCondition)
  },
  "visibleBackgroundColor": {
    object (Color)
  },
  "visibleBackgroundColorStyle": {
    object (ColorStyle)
  },
  "visibleForegroundColor": {
    object (Color)
  },
  "visibleForegroundColorStyle": {
    object (ColorStyle)
  }
}
Pola
hiddenValues[]

string

Wartości, które powinny być ukryte.

condition

object (BooleanCondition)

Warunek, który musi być spełniony, aby wartości były wyświetlane. (nie zastąpi ona wartości w parametrze hiddenValues – jeśli jest tam podana, nadal będzie ukryta).

visibleBackgroundColor
(deprecated)

object (Color)

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 filtrować. Widoczne 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 skonfigurowano również visibleBackgroundColor, to pole ma pierwszeństwo.

visibleForegroundColor
(deprecated)

object (Color)

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)

Kolor pierwszego planu, według którego odbywa się sortowanie. Komórki z tym kolorem są posortowane na górę. Wzajemnie wyklucza się z: 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. Wyłącza się wzajemnie z backgroundColor i musi być kolorem typu RGB. Jeśli ustawiona jest też zasada foregroundColor, to ona ma pierwszeństwo.

backgroundColor
(deprecated)

object (Color)

Kolor wypełnienia tła, według którego mają być sortowane komórki. Komórki o tym kolorze wypełnienia są sortowane na górze. Wzajemnie się wykluczają z opcją foregroundColor. Wycofane: użyj właściwości backgroundColorStyle.

backgroundColorStyle

object (ColorStyle)

Kolor wypełnienia tła, według którego mają być sortowane komórki. Komórki o tym kolorze wypełnienia są sortowane na górze. Wyłącza się wzajemnie z foregroundColor i musi być kolorem typu RGB. Jeśli ustawiona jest też zasada backgroundColor, to pole ma pierwszeństwo.

Pole uniireference. Odniesienie do sortowanego wymiaru. referencemoże być tylko jedną z tych wartości:
dimensionIndex

integer

Wymiar, którego ma dotyczyć 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 sumy location. Lokalizacja obiektu. Musisz ustawić 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 nałożony na siatkę.

newSheet

boolean

Jeśli ma wartość Prawda, umieszczony obiekt jest umieszczany na nowym arkuszu, którego identyfikator zostanie wybrany automatycznie. Jest używany tylko podczas pisania.

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

Odsunięcie obiektu w pionie (w pikselach), po którym obiekt jest odsunięty od komórki zakotwiczenia.

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.