Farbe
Ermöglicht die Darstellung einer Farbe im RGBA-Farbraum. Diese Darstellung ist kompakt und soll die Umwandlung in und aus Farbdarstellungen in verschiedenen Sprachen vereinfachen. Die Felder dieser Darstellung können beispielsweise ganz einfach dem Konstruktor von java.awt.Color
in Java oder der +colorWithRed:green:blue:alpha
-Methode von UIColor in iOS übergeben werden. Mit nur ein wenig Aufwand lässt sich daraus auch ein CSS-rgba()
-String in JavaScript erstellen.
Diese Referenzseite enthält keine Informationen zum absoluten Farbraum, der zur Interpretation des RGB-Werts verwendet werden sollte, z. B. sRGB, Adobe RGB, DCI-P3 und BT.2020. Anwendungen sollten standardmäßig den Farbraum sRGB verwenden.
Wenn entschieden werden muss, ob zwei Farben gleich sind, behandeln Implementierungen, sofern nicht anders dokumentiert, zwei Farben als gleich, wenn sich alle Rot-, Grün-, Blau- und Alphawerte jeweils um höchstens 1e-5
unterscheiden.
Beispiel (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();
}
// ...
Beispiel (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;
}
// ...
Beispiel (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('');
};
// ...
JSON-Darstellung |
---|
{ "red": number, "green": number, "blue": number, "alpha": number } |
Felder | |
---|---|
red
|
Der Rotanteil der Farbe als Wert im Intervall [0, 1]. |
green
|
Der Grünanteil der Farbe als Wert im Intervall [0, 1]. |
blue
|
Der Blauanteil der Farbe als Wert im Intervall [0, 1]. |
alpha
|
Der Anteil dieser Farbe, der auf den Pixel angewendet werden soll. Die endgültige Pixelfarbe wird durch folgende Gleichung definiert:
Der Wert 1,0 entspricht einer soliden Farbdarstellung, während die Farbe bei einem Wert von 0,0 vollständig transparent ist. Dabei wird anstelle eines einfachen Float-Skalarwerts eine Wrapper-Nachricht verwendet, sodass zwischen einem Standardwert und dem zurückgesetzten Wert unterschieden werden kann. Wenn nicht angegeben, wird das Farbobjekt als Volltonfarbe dargestellt (als ob für den Alphawert explizit 1,0 angegeben worden wäre). |
ColorStyle
Ein Farbwert.
JSON-Darstellung |
---|
{ // Union field |
Felder | |
---|---|
Union-Feld
kind . Die Art des Farbwerts.
kind darf nur einen der folgenden Werte haben:
|
|
rgbColor
|
RGB-Farbe Der Wert |
themeColor
|
Designfarbe |
ThemeColorType
Farbtypen des Designs
SpreadsheetProperties
enthält eine SpreadsheetTheme
, mit der diese Farbtypen des Designs konkreten Farben zugeordnet werden.
Enums | |
---|---|
THEME_COLOR_TYPE_UNSPECIFIED
|
Keine Designfarbe angegeben |
TEXT
|
Stellt die primäre Textfarbe dar |
BACKGROUND
|
Stellt die primäre Hintergrundfarbe dar |
ACCENT1
|
Stellt die erste Akzentfarbe dar |
ACCENT2
|
Stellt die zweite Akzentfarbe dar |
ACCENT3
|
Stellt die dritte Akzentfarbe dar |
ACCENT4
|
Stellt die vierte Akzentfarbe dar |
ACCENT5
|
Stellt die fünfte Akzentfarbe dar |
ACCENT6
|
Stellt die sechste Akzentfarbe dar |
LINK
|
Die Farbe für Hyperlinks |
HorizontalAlign
Die horizontale Ausrichtung von Text in einer Zelle.
Enums | |
---|---|
HORIZONTAL_ALIGN_UNSPECIFIED
|
Die horizontale Ausrichtung ist nicht angegeben. Verwenden Sie diese Option nicht. |
LEFT
|
Der Text ist explizit linksbündig ausgerichtet. |
CENTER
|
Der Text ist explizit auf die Mitte der Zelle ausgerichtet. |
RIGHT
|
Der Text ist explizit rechts neben der Zelle ausgerichtet. |
TextFormat
Das Format eines Textblocks in einer Zelle. Fehlende Werte geben an, dass das Feld nicht angegeben ist.
JSON-Darstellung |
---|
{ "foregroundColor": { object ( |
Felder | |
---|---|
foregroundColor
|
Die Vordergrundfarbe des Texts. Verworfen: Verwenden Sie stattdessen |
foregroundColorStyle
|
Die Vordergrundfarbe des Texts. Wenn auch |
fontFamily
|
Die Schriftfamilie. |
fontSize
|
Die Schriftgröße. |
bold
|
„True“, wenn der Text fett formatiert ist. |
italic
|
„True“, wenn der Text kursiv ist. |
strikethrough
|
„True“, wenn der Text durchgestrichen ist. |
underline
|
„True“, wenn der Text unterstrichen ist. |
link
|
Das Linkziel des Texts, falls vorhanden. Wenn Sie das Link-Feld in einer |
Link
Eine externe oder lokale Referenz.
JSON-Darstellung |
---|
{ // Union field |
Felder | |
---|---|
Union-Feld
destination . Das Ziel des Links.
destination darf nur einen der folgenden Werte haben:
|
|
uri
|
Die Link-ID. |
DataSourceColumn
Eine Spalte in einer Datenquelle.
JSON-Darstellung |
---|
{
"reference": {
object ( |
Felder | |
---|---|
reference
|
Der Spaltenbezug. |
formula
|
Die Formel der berechneten Spalte. |
DataSourceColumnReference
Eine eindeutige Kennung, die auf eine Datenquellenspalte verweist.
JSON-Darstellung |
---|
{ "name": string } |
Felder | |
---|---|
name
|
Der Anzeigename der Spalte. Er muss innerhalb einer Datenquelle eindeutig sein. |
DataExecutionStatus
Der Ausführungsstatus der Daten.
Eine Datenabfrage wird erstellt, um ein Datenquellenobjekt mit den neuesten Daten aus einer DataSource
zu synchronisieren. Normalerweise wird es im Hintergrund ausgeführt. Sie können anhand des Status state
sehen, ob eine Ausführung abgeschlossen ist.
Es gibt mehrere Szenarien, in denen eine Datenausführung ausgelöst wird:
-
In
Adding a data source
wird eine zugehörige Datenquellentabelle sowie eine Datenausführung erstellt, um die Daten aus der Datenquelle mit der Tabelle zu synchronisieren. -
Updating a data source
wird eine Datenausführung erstellt, um das zugehörige Datenquellentabellenblatt auf ähnliche Weise zu aktualisieren. -
Sie können
refresh request
senden, um ein oder mehrere Datenquellenobjekte explizit zu aktualisieren.
JSON-Darstellung |
---|
{ "state": enum ( |
Felder | |
---|---|
state
|
Der Status der Datenausführung. |
errorCode
|
Den Fehlercode. |
errorMessage
|
Die Fehlermeldung, die leer sein kann. |
lastRefreshTime
|
Gibt an, wann die Daten zuletzt erfolgreich aktualisiert wurden. |
DataExecutionState
Eine Aufzählung der Status der Datenausführung.
Enums | |
---|---|
DATA_EXECUTION_STATE_UNSPECIFIED
|
Standardwert, nicht verwenden |
NOT_STARTED
|
Die Datenausführung wurde noch nicht gestartet. |
RUNNING
|
Die Datenausführung wurde gestartet und ist aktiv. |
CANCELLING
|
Die Datenausführung wird derzeit abgebrochen. |
SUCCEEDED
|
Die Datenausführung wurde erfolgreich abgeschlossen. |
FAILED
|
Die Datenausführung wurde mit Fehlern abgeschlossen. |
DataExecutionErrorCode
Eine Aufzählung von Fehlercodes für die Datenausführung.
Enums | |
---|---|
DATA_EXECUTION_ERROR_CODE_UNSPECIFIED
|
Standardwert, nicht verwenden |
TIMED_OUT
|
Zeitüberschreitung bei der Datenausführung. |
TOO_MANY_ROWS
|
Beim Ausführen der Daten werden mehr Zeilen als das Limit zurückgegeben. |
TOO_MANY_COLUMNS
|
Beim Ausführen der Daten werden mehr Spalten als das Limit zurückgegeben. |
TOO_MANY_CELLS
|
Beim Ausführen der Daten werden mehr Zellen als das Limit zurückgegeben. |
ENGINE
|
Fehler wird von der Back-End-Daten-Ausführungs-Engine (z.B. BigQuery) empfangen. Weitere Informationen finden Sie unter errorMessage .
|
PARAMETER_INVALID
|
Einer oder mehrere der angegebenen Parameter der Datenquelle sind ungültig. |
UNSUPPORTED_DATA_TYPE
|
Beim Ausführen der Daten wird ein nicht unterstützter Datentyp zurückgegeben. |
DUPLICATE_COLUMN_NAMES
|
Beim Ausführen der Daten wurden doppelte Spaltennamen oder Aliasse zurückgegeben. |
INTERRUPTED
|
Die Datenausführung wird unterbrochen. Bitte aktualisieren Sie die Seite später. |
CONCURRENT_QUERY
|
Die Datenausführung ist derzeit in Bearbeitung und kann erst aktualisiert werden, wenn sie abgeschlossen ist. |
OTHER
|
Andere Fehler |
TOO_MANY_CHARS_PER_CELL
|
Die Datenausführung gibt Werte zurück, die die maximal zulässige Anzahl von Zeichen in einer einzelnen Zelle überschreiten. |
DATA_NOT_FOUND
|
Die Datenbank, auf die von der Datenquelle verwiesen wird, wurde nicht gefunden. */ |
PERMISSION_DENIED
|
Der Nutzer hat keinen Zugriff auf die Datenbank, auf die in der Datenquelle verwiesen wird. |
MISSING_COLUMN_ALIAS
|
Beim Ausführen der Daten werden Spalten ohne Alias zurückgegeben. |
OBJECT_NOT_FOUND
|
Das Datenquellenobjekt ist nicht vorhanden. |
OBJECT_IN_ERROR_STATE
|
Bei dem Datenquellenobjekt liegt derzeit ein Fehler vor. Wenn Sie eine Aktualisierung erzwingen möchten, legen Sie force in RefreshDataSourceRequest fest.
|
OBJECT_SPEC_INVALID
|
Die Datenquellenobjektspezifikation ist ungültig. |
DATA_EXECUTION_CANCELLED
|
Die Datenausführung wurde abgebrochen. |
ExtendedValue
Die Arten von Werten, die eine Zelle in einer Tabelle haben kann.
JSON-Darstellung |
---|
{ // Union field |
Felder | |
---|---|
Union-Feld
value . Der Werttyp in einer Zelle. Wenn kein Feld festgelegt ist, enthält die Zelle keine Daten.
value darf nur einen der folgenden Werte haben:
|
|
numberValue
|
Stellt einen Double-Wert dar. Hinweis: Datumsangaben, Uhrzeiten und Datumsangaben mit Uhrzeit werden als Doppelwerte im |
stringValue
|
Stellt einen Stringwert dar. Anführende einfache Anführungszeichen sind nicht enthalten. Wenn der Nutzer beispielsweise |
boolValue
|
Stellt einen booleschen Wert dar. |
formulaValue
|
Stellt eine Formel dar. |
errorValue
|
Stellt einen Fehler dar. Dieses Feld ist schreibgeschützt. |
ErrorValue
Ein Fehler in einer Zelle.
JSON-Darstellung |
---|
{
"type": enum ( |
Felder | |
---|---|
type
|
Die Art des Fehlers. |
message
|
Eine Nachricht mit weiteren Informationen zum Fehler (in der Sprache der Tabelle). |
ErrorType
Die Art des Fehlers.
Enums | |
---|---|
ERROR_TYPE_UNSPECIFIED
|
Der Standardfehlertyp, sollte nicht verwendet werden. |
ERROR
|
Entspricht dem Fehler #ERROR! .
|
NULL_VALUE
|
Entspricht dem Fehler #NULL! .
|
DIVIDE_BY_ZERO
|
Entspricht dem Fehler #DIV/0 .
|
VALUE
|
Entspricht dem Fehler #VALUE! .
|
REF
|
Entspricht dem Fehler #REF! .
|
NAME
|
Entspricht dem Fehler #NAME? .
|
NUM
|
Entspricht dem Fehler #NUM! .
|
N_A
|
Entspricht dem Fehler #N/A .
|
LOADING
|
Entspricht dem Status Loading... .
|
BooleanCondition
Eine Bedingung, die als „wahr“ oder „falsch“ ausgewertet werden kann. Boolesche Bedingungen werden für die bedingte Formatierung, die Datenvalidierung und die Kriterien in Filtern verwendet.
JSON-Darstellung |
---|
{ "type": enum ( |
Felder | |
---|---|
type
|
Der Typ der Bedingung. |
values[]
|
Die Werte der Bedingung. Die Anzahl der unterstützten Werte hängt von |
ConditionType
Der Typ der Bedingung.
Enums | |
---|---|
CONDITION_TYPE_UNSPECIFIED
|
Der Standardwert, nicht verwenden. |
NUMBER_GREATER
|
Der Wert der Zelle muss größer als der Wert der Bedingung sein. Unterstützt durch Datenvalidierung, bedingte Formatierung und Filter. Erfordert eine einzelne ConditionValue .
|
NUMBER_GREATER_THAN_EQ
|
Der Wert der Zelle muss größer oder gleich dem Wert der Bedingung sein. Unterstützt durch Datenvalidierung, bedingte Formatierung und Filter. Erfordert eine einzelne ConditionValue .
|
NUMBER_LESS
|
Der Wert der Zelle muss kleiner als der Wert der Bedingung sein. Unterstützt durch Datenvalidierung, bedingte Formatierung und Filter. Erfordert eine einzelne ConditionValue .
|
NUMBER_LESS_THAN_EQ
|
Der Wert der Zelle muss kleiner oder gleich dem Wert der Bedingung sein. Unterstützt durch Datenvalidierung, bedingte Formatierung und Filter. Erfordert eine einzelne ConditionValue .
|
NUMBER_EQ
|
Der Wert der Zelle muss mit dem Wert der Bedingung übereinstimmen. Unterstützt durch Datenvalidierung, bedingte Formatierung und Filter. Für die Datenvalidierung, die bedingte Formatierung und Filter auf Objekten, die keine Datenquellen sind, ist ein einzelnes ConditionValue erforderlich. Für Filter auf Datenquellenobjekten ist mindestens ein ConditionValue erforderlich.
|
NUMBER_NOT_EQ
|
Der Wert der Zelle darf nicht mit dem Wert der Bedingung übereinstimmen. Unterstützt durch Datenvalidierung, bedingte Formatierung und Filter. Für die Datenvalidierung, die bedingte Formatierung und Filter auf Objekten, die keine Datenquellen sind, ist ein einzelnes ConditionValue erforderlich. Für Filter auf Datenquellenobjekten ist mindestens ein ConditionValue erforderlich.
|
NUMBER_BETWEEN
|
Der Wert der Zelle muss zwischen den beiden Bedingungswerten liegen. Unterstützt durch Datenvalidierung, bedingte Formatierung und Filter. Es sind genau zwei ConditionValues erforderlich.
|
NUMBER_NOT_BETWEEN
|
Der Wert der Zelle darf nicht zwischen den beiden Bedingungswerten liegen. Unterstützt durch Datenvalidierung, bedingte Formatierung und Filter. Es sind genau zwei ConditionValues erforderlich.
|
TEXT_CONTAINS
|
Der Wert der Zelle muss den Wert der Bedingung enthalten. Unterstützt durch Datenvalidierung, bedingte Formatierung und Filter. Erfordert eine einzelne ConditionValue .
|
TEXT_NOT_CONTAINS
|
Der Wert der Zelle darf nicht den Wert der Bedingung enthalten. Unterstützt durch Datenvalidierung, bedingte Formatierung und Filter. Erfordert eine einzelne ConditionValue .
|
TEXT_STARTS_WITH
|
Der Wert der Zelle muss mit dem Wert der Bedingung beginnen. Unterstützt durch bedingte Formatierung und Filter. Erfordert eine einzelne ConditionValue .
|
TEXT_ENDS_WITH
|
Der Wert der Zelle muss mit dem Wert der Bedingung enden. Unterstützt durch bedingte Formatierung und Filter. Erfordert eine einzelne ConditionValue .
|
TEXT_EQ
|
Der Wert der Zelle muss genau mit dem Wert der Bedingung übereinstimmen. Unterstützt durch Datenvalidierung, bedingte Formatierung und Filter. Für die Datenvalidierung, die bedingte Formatierung und Filter auf Objekten, die keine Datenquellen sind, ist ein einzelnes ConditionValue erforderlich. Für Filter auf Datenquellenobjekten ist mindestens ein ConditionValue erforderlich.
|
TEXT_IS_EMAIL
|
Der Wert der Zelle muss eine gültige E-Mail-Adresse sein. Unterstützt durch Datenvalidierung. Erfordert keine ConditionValues .
|
TEXT_IS_URL
|
Der Wert der Zelle muss eine gültige URL sein. Unterstützt durch Datenvalidierung. Erfordert keine ConditionValues .
|
DATE_EQ
|
Der Wert der Zelle muss mit dem Wert der Bedingung übereinstimmen. Unterstützt durch Datenvalidierung, bedingte Formatierung und Filter. Für die Datenvalidierung, die bedingte Formatierung und Filter auf Objekten, die keine Datenquellen sind, ist ein einzelnes ConditionValue erforderlich. Für Filter auf Datenquellenobjekten ist mindestens ein ConditionValue erforderlich.
|
DATE_BEFORE
|
Der Wert der Zelle muss vor dem Datum des Werts der Bedingung liegen. Unterstützt durch Datenvalidierung, bedingte Formatierung und Filter. Erfordert eine einzelne ConditionValue , die eine relative date sein kann.
|
DATE_AFTER
|
Der Wert der Zelle muss nach dem Datum des Werts der Bedingung liegen. Unterstützt durch Datenvalidierung, bedingte Formatierung und Filter. Erfordert eine einzelne ConditionValue , die eine relative date sein kann.
|
DATE_ON_OR_BEFORE
|
Der Wert der Zelle muss vor oder am Datum des Werts der Bedingung liegen. Unterstützt durch Datenvalidierung. Erfordert eine einzelne ConditionValue , die eine relative date sein kann.
|
DATE_ON_OR_AFTER
|
Der Wert der Zelle muss auf oder nach dem Datum des Werts der Bedingung liegen. Unterstützt durch Datenvalidierung. Erfordert eine einzelne ConditionValue , die eine relative date sein kann.
|
DATE_BETWEEN
|
Der Wert der Zelle muss zwischen den beiden Datumsangaben liegen. Unterstützt durch Datenvalidierung. Es sind genau zwei ConditionValues erforderlich.
|
DATE_NOT_BETWEEN
|
Der Wert der Zelle muss außerhalb der beiden Datumswerte liegen. Unterstützt durch Datenvalidierung. Es sind genau zwei ConditionValues erforderlich.
|
DATE_IS_VALID
|
Der Wert der Zelle muss ein Datum sein. Unterstützt durch Datenvalidierung. Erfordert keine ConditionValues .
|
ONE_OF_RANGE
|
Der Wert der Zelle muss im Raster im Bereich des Bedingungswerts aufgeführt sein. Unterstützt durch Datenvalidierung. Es ist nur ein einzelnes ConditionValue zulässig und der Wert muss ein gültiger Bereich in A1-Notation sein.
|
ONE_OF_LIST
|
Der Wert der Zelle muss in der Liste der Bedingungswerte enthalten sein. Unterstützt durch Datenvalidierung. Unterstützt eine beliebige Anzahl von condition values , eine pro Element in der Liste. Formeln werden in den Werten nicht unterstützt.
|
BLANK
|
Der Wert der Zelle muss leer sein. Unterstützt durch bedingte Formatierung und Filter. Erfordert keine ConditionValues .
|
NOT_BLANK
|
Der Wert der Zelle darf nicht leer sein. Unterstützt durch bedingte Formatierung und Filter. Erfordert keine ConditionValues .
|
CUSTOM_FORMULA
|
Die Formel der Bedingung muss als wahr ausgewertet werden. Unterstützt durch Datenvalidierung, bedingte Formatierung und Filter. Wird von Tabellenfiltern für Datenquellen nicht unterstützt. Erfordert eine einzelne ConditionValue .
|
BOOLEAN
|
Der Wert der Zelle muss WAHR/FALSE sein oder in der Liste der Bedingungswerte enthalten sein. Unterstützt durch Datenvalidierung. Wird als Kästchen in einer Zelle gerendert. Unterstützt null, ein oder zwei ConditionValues . Wenn keine Werte angegeben sind, muss die Zelle TRUE oder FALSE enthalten. TRUE wird als angeklickt und FALSE als nicht angeklickt dargestellt. Ein Wert gibt an, dass die Zelle angeklickt dargestellt wird, wenn sie diesen Wert enthält, und nicht angeklickt, wenn sie leer ist. Zwei Werte geben an, dass die Zelle angeklickt dargestellt wird, wenn sie den ersten Wert enthält, und nicht angeklickt, wenn sie den zweiten Wert enthält. Mit [„Ja“, „Nein“] wird beispielsweise angegeben, dass in der Zelle ein Häkchen angezeigt wird, wenn der Wert „Ja“ ist, und ein leeres Kästchen, wenn der Wert „Nein“ ist.
|
TEXT_NOT_EQ
|
Der Wert der Zelle darf nicht genau mit dem Wert der Bedingung übereinstimmen. Wird von Filtern auf Datenquellenobjekten unterstützt. Es ist mindestens ein ConditionValue erforderlich.
|
DATE_NOT_EQ
|
Der Wert der Zelle darf nicht genau mit dem Wert der Bedingung übereinstimmen. Wird von Filtern auf Datenquellenobjekten unterstützt. Es ist mindestens ein ConditionValue erforderlich.
|
FILTER_EXPRESSION
|
Der Wert der Zelle muss dem angegebenen Muster entsprechen. Erfordert eine einzelne ConditionValue .
|
ConditionValue
Der Wert der Bedingung.
JSON-Darstellung |
---|
{ // Union field |
Felder | |
---|---|
Union-Feld
value . Der Wert der Bedingung. Es muss genau einer festgelegt werden.
value darf nur einen der folgenden Werte haben:
|
|
relativeDate
|
Ein relatives Datum (basierend auf dem aktuellen Datum). Gültig nur, wenn Relative Datumsangaben werden bei der Datenvalidierung nicht unterstützt. Sie werden nur in der bedingten Formatierung und in bedingten Filtern unterstützt. |
userEnteredValue
|
Ein Wert, auf dem die Bedingung basiert. Der Wert wird so analysiert, als hätte der Nutzer ihn in eine Zelle eingegeben. Formeln werden unterstützt und müssen mit einem |
RelativeDate
Hiermit wird festgelegt, wie eine Datumsbedingung ausgewertet wird.
Enums | |
---|---|
RELATIVE_DATE_UNSPECIFIED
|
Standardwert, nicht verwenden |
PAST_YEAR
|
Der Wert ist ein Jahr vor dem heutigen Tag. |
PAST_MONTH
|
Der Wert bezieht sich auf einen Monat vor dem heutigen Tag. |
PAST_WEEK
|
Der Wert bezieht sich auf eine Woche vor dem heutigen Tag. |
YESTERDAY
|
Der Wert ist „gestern“. |
TODAY
|
Der Wert ist „heute“. |
TOMORROW
|
Der Wert ist „morgen“. |
GridRange
Einen Bereich in einer Tabelle. Alle Indexe beginnen bei null. Die Indexe sind halboffen, d.h. der Startindex ist einschließend und der Endindex ist ausschließend: [startIndex, endIndex]. Fehlende Indexe weisen darauf hin, dass der Bereich auf dieser Seite nicht begrenzt ist.
Wenn "Sheet1"
beispielsweise die Tabellen-ID 123456 ist, gilt:
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
Der Startindex darf nicht größer sein als der Endindex. Wenn der Startindex mit dem Endindex übereinstimmt, ist der Bereich leer. Leere Bereiche sind in der Regel nicht aussagekräftig und werden in der Benutzeroberfläche normalerweise als #REF!
dargestellt.
JSON-Darstellung |
---|
{ "sheetId": integer, "startRowIndex": integer, "endRowIndex": integer, "startColumnIndex": integer, "endColumnIndex": integer } |
Felder | |
---|---|
sheetId
|
Das Tabellenblatt, in dem sich der Bereich befindet. |
startRowIndex
|
Die Startzeile (einschließlich) des Bereichs oder nicht festgelegt, wenn er unbegrenzt ist. |
endRowIndex
|
Die Endzeile (exklusiv) des Bereichs oder nicht festgelegt, wenn er nicht begrenzt ist. |
startColumnIndex
|
Die Startspalte (einschließlich) des Bereichs oder nicht festgelegt, wenn er nicht begrenzt ist. |
endColumnIndex
|
Die Endspalte (exklusiv) des Bereichs oder nicht festgelegt, wenn der Bereich nicht begrenzt ist. |
SortOrder
Eine Sortierreihenfolge.
Enums | |
---|---|
SORT_ORDER_UNSPECIFIED
|
Standardwert, nicht verwenden |
ASCENDING
|
Sortieren Sie die Spalte aufsteigend. |
DESCENDING
|
Sortieren Sie die Spalte absteigend. |
FilterSpec
Die Filterkriterien, die mit einer bestimmten Spalte verknüpft sind.
JSON-Darstellung |
---|
{ "filterCriteria": { object ( |
Felder | |
---|---|
filterCriteria
|
Die Kriterien für die Spalte. |
Union-Feld
reference . Verweis auf die gefilterte Spalte.
reference darf nur einen der folgenden Werte haben:
|
|
columnIndex
|
Der nullbasierte Spaltenindex. |
dataSourceColumnReference
|
Verweis auf eine Datenquellenspalte. |
FilterCriteria
Kriterien für das Ein-/Ausblenden von Zeilen in einem Filter oder einer Filteransicht.
JSON-Darstellung |
---|
{ "hiddenValues": [ string ], "condition": { object ( |
Felder | |
---|---|
condition
|
Eine Bedingung, die erfüllt sein muss, damit Werte angezeigt werden. |
visibleBackgroundColor
|
Die Hintergrundfüllungsfarbe, nach der gefiltert werden soll. Es werden nur Zellen mit dieser Füllfarbe angezeigt. Schließt sich gegenseitig mit |
visibleBackgroundColorStyle
|
Die Hintergrundfüllungsfarbe, nach der gefiltert werden soll. Es werden nur Zellen mit dieser Füllfarbe angezeigt. Dieses Feld und |
visibleForegroundColor
|
Die Vordergrundfarbe, nach der gefiltert werden soll. Es werden nur Zellen mit dieser Vordergrundfarbe angezeigt. Schließt sich gegenseitig mit |
visibleForegroundColorStyle
|
Die Vordergrundfarbe, nach der gefiltert werden soll. Es werden nur Zellen mit dieser Vordergrundfarbe angezeigt. Dieses Feld und |
SortSpec
Eine Sortierreihenfolge, die mit einer bestimmten Spalte oder Zeile verknüpft ist.
JSON-Darstellung |
---|
{ "sortOrder": enum ( |
Felder | |
---|---|
sortOrder
|
Die Bestelldaten sollten sortiert sein. |
foregroundColor
|
Die Vordergrundfarbe, nach der sortiert werden soll. Zellen mit dieser Vordergrundfarbe werden nach oben sortiert. Schließt sich gegenseitig mit |
foregroundColorStyle
|
Die Vordergrundfarbe, nach der sortiert werden soll. Zellen mit dieser Vordergrundfarbe werden nach oben sortiert. Ist mit |
backgroundColor
|
Die Hintergrundfüllungsfarbe, nach der sortiert werden soll. Zellen mit dieser Füllungsfarbe werden nach oben sortiert. Schließt sich gegenseitig mit |
backgroundColorStyle
|
Die Hintergrundfüllungsfarbe, nach der sortiert werden soll. Zellen mit dieser Füllungsfarbe werden nach oben sortiert. Ist mit |
Union-Feld
reference . Verweis auf die sortierte Dimension.
reference darf nur einen der folgenden Werte haben:
|
|
dimensionIndex
|
Die Dimension, auf die die Sortierung angewendet werden soll. |
dataSourceColumnReference
|
Verweis auf eine Datenquellenspalte. |
EmbeddedObjectPosition
Die Position eines eingebetteten Objekts wie eines Diagramms.
JSON-Darstellung |
---|
{ // Union field |
Felder | |
---|---|
Union-Feld
location . Der Standort des Objekts. Es muss genau ein Wert festgelegt werden.
location darf nur einen der folgenden Werte haben:
|
|
sheetId
|
Das Tabellenblatt, in dem sich die Funktion befindet. Wird nur festgelegt, wenn sich das eingebettete Objekt auf einem eigenen Tabellenblatt befindet. Darf nicht negativ sein. |
overlayPosition
|
Die Position, an der das Objekt auf einem Raster überlagert wird. |
newSheet
|
Wenn „wahr“ festgelegt ist, wird das eingebettete Objekt auf einem neuen Tabellenblatt platziert, dessen ID automatisch ausgewählt wird. Wird nur beim Schreiben verwendet. |
OverlayPosition
Die Position eines Objekts, das auf einem Raster überlagert ist.
JSON-Darstellung |
---|
{
"anchorCell": {
object ( |
Felder | |
---|---|
anchorCell
|
Die Zelle, an der das Objekt verankert ist. |
offsetXPixels
|
Der horizontale Abstand in Pixeln, um den das Objekt von der Ankerzelle versetzt ist. |
offsetYPixels
|
Der vertikale Abstand in Pixeln, um den das Objekt von der Ankerzelle versetzt ist. |
widthPixels
|
Die Breite des Objekts in Pixeln. Die Standardeinstellung ist 600. |
heightPixels
|
Die Höhe des Objekts in Pixeln. Standardmäßig ist 371 festgelegt. |
GridCoordinate
Eine Koordinate in einer Tabelle. Alle Indexe beginnen bei null.
JSON-Darstellung |
---|
{ "sheetId": integer, "rowIndex": integer, "columnIndex": integer } |
Felder | |
---|---|
sheetId
|
Das Tabellenblatt, in dem sich diese Koordinate befindet. |
rowIndex
|
Der Zeilenindex der Koordinate. |
columnIndex
|
Der Spaltenindex der Koordinate. |