Farbe
Ermöglicht die Darstellung einer Farbe im RGBA-Farbraum. Diese Darstellung wurde entwickelt, um die Konvertierung zu und von Farbdarstellungen in verschiedenen Sprachen vor Kompaktheitsgrad zu vereinfachen. Die Felder dieser Darstellung lassen sich beispielsweise dem Konstruktor von java.awt.Color
in Java ganz einfach zur Verfügung stellen. Sie können sie aber auch ganz einfach an die Methode +colorWithRed:green:blue:alpha
von UIColor in iOS übergeben. Außerdem lässt sie sich mit nur wenig Arbeit in JavaScript als CSS-String rgba()
formatieren.
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. Standardmäßig sollte für Anwendungen der sRGB-Farbraum verwendet werden.
Wenn eine Farbgleichheit entschieden werden muss, behandeln Implementierungen, sofern nicht anders angegeben, zwei Farben gleich, wenn sich alle Rot-, Grün-, Blau- und Alpha-Werte 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. Wird dieses Farbobjekt weggelassen, wird es als Vollfarbe dargestellt, so als ob dem Alphawert explizit der Wert 1,0 gegeben worden wäre. |
ColorStyle
Ein Farbwert.
JSON-Darstellung |
---|
{ // Union field |
Felder | |
---|---|
Union-Feld kind . Die Art des Farbwerts.
Für kind ist nur einer der folgenden Werte zulässig:
|
|
rgbColor
|
RGB-Farbe. Der Wert |
themeColor
|
Designfarbe. |
ThemeColorType
Farbtypen des Designs.
SpreadsheetProperties
enthalten einen SpreadsheetTheme
, mit dem eine Zuordnung dieser Designfarbtypen zu Betonfarben definiert wird.
Enums | |
---|---|
THEME_COLOR_TYPE_UNSPECIFIED
|
Nicht angegebene Designfarbe |
TEXT
|
Stellt die primäre Textfarbe dar |
BACKGROUND
|
Stellt die primäre Hintergrundfarbe dar |
ACCENT1
|
Steht für die erste Akzentfarbe |
ACCENT2
|
Steht für die zweite Akzentfarbe |
ACCENT3
|
Steht für die dritte Akzentfarbe |
ACCENT4
|
Steht für die vierte Akzentfarbe |
ACCENT5
|
Steht für die fünfte Akzentfarbe |
ACCENT6
|
Steht für die sechste Akzentfarbe |
LINK
|
Stellt die für Hyperlinks zu verwendende Farbe dar. |
HorizontalAlign
Horizontale Ausrichtung von Text in einer Zelle.
Enums | |
---|---|
HORIZONTAL_ALIGN_UNSPECIFIED
|
Die horizontale Ausrichtung ist nicht angegeben. Verwenden Sie dieses Attribut nicht. |
LEFT
|
Der Text wird explizit links an der Zelle ausgerichtet. |
CENTER
|
Der Text ist explizit an der Mitte der Zelle ausgerichtet. |
RIGHT
|
Der Text wird explizit rechts an der Zelle ausgerichtet. |
TextFormat
Das Format einer Textausführung in einer Zelle. Wenn Werte fehlen, wurde das Feld nicht festgelegt.
JSON-Darstellung |
---|
{ "foregroundColor": { object ( |
Felder | |
---|---|
foregroundColor
|
Vordergrundfarbe des Texts Eingestellt: Verwenden Sie |
foregroundColorStyle
|
Vordergrundfarbe des Texts Wenn auch |
fontFamily
|
Die Schriftfamilie. |
fontSize
|
Die Größe der Schriftart. |
bold
|
„True“, wenn der Text fett 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 Textes, falls vorhanden. Wenn Sie das Verknüpfungsfeld in einem |
Link
Eine externe oder lokale Referenz.
JSON-Darstellung |
---|
{ // Union field |
Felder | |
---|---|
Union-Feld destination . Das Ziel des Links.
Für destination ist nur einer der folgenden Werte zulässig:
|
|
uri
|
Die Link-ID. |
DataSourceColumn
Eine Spalte in einer Datenquelle.
JSON-Darstellung |
---|
{
"reference": {
object (
|
Felder | |
---|---|
reference
|
Die Spaltenreferenz. |
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. Sie darf innerhalb einer Datenquelle nur einmal vorkommen. |
DataExecutionStatus
Status der Datenausführung.
Es wird eine Datenausführung erstellt, um ein Datenquellenobjekt mit den neuesten Daten aus einer DataSource
zu synchronisieren. In der Regel ist eine Ausführung im Hintergrund geplant. Anhand der state
können Sie feststellen, ob eine Ausführung abgeschlossen ist
Es gibt mehrere Szenarien, in denen eine Datenausführung ausgelöst wird:
-
Adding a data source
erstellt eine verknüpfte Datenquellentabelle sowie eine Datenausführung, um die Daten aus der Datenquelle mit dem Tabellenblatt zu synchronisieren. -
Updating a data source
erstellt eine Datenausführung, um die verknüpfte Datenquellentabelle 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
|
Der Fehlercode. |
errorMessage
|
Die Fehlermeldung, die möglicherweise leer ist. |
lastRefreshTime
|
Ruft die Uhrzeit ab, zu der die Daten zuletzt erfolgreich aktualisiert wurden. |
DataExecutionState
Eine Aufzählung der Datenausführungsstatus.
Enums | |
---|---|
DATA_EXECUTION_STATE_UNSPECIFIED
|
Standardwert, nicht verwenden. |
NOT_STARTED
|
Die Datenausführung wurde nicht gestartet. |
RUNNING
|
Die Datenausführung hat begonnen und wird ausgeführt. |
CANCELLING
|
Die Datenausführung wird gerade abgebrochen. |
SUCCEEDED
|
Die Datenausführung wurde erfolgreich abgeschlossen. |
FAILED
|
Die Datenausführung wurde mit Fehlern abgeschlossen. |
DataExecutionErrorCode
Eine Aufzählung von Fehlercodes bei der Datenausführung.
Enums | |
---|---|
DATA_EXECUTION_ERROR_CODE_UNSPECIFIED
|
Standardwert, nicht verwenden. |
TIMED_OUT
|
Zeitüberschreitung beim Ausführen der Daten. |
TOO_MANY_ROWS
|
Die Datenausführung gibt mehr Zeilen zurück, als das Limit erlaubt. |
TOO_MANY_COLUMNS
|
Bei der Datenausführung werden mehr Spalten zurückgegeben als das Limit. |
TOO_MANY_CELLS
|
Die Datenausführung gibt mehr Zellen zurück, als das Limit erlaubt. |
ENGINE
|
Der Fehler wird von der Back-End-Datenausführungs-Engine (z.B. BigQuery) empfangen. Weitere Informationen finden Sie unter errorMessage .
|
PARAMETER_INVALID
|
Mindestens einer der angegebenen Datenquellenparameter ist ungültig. |
UNSUPPORTED_DATA_TYPE
|
Die Datenausführung gibt einen nicht unterstützten Datentyp zurück. |
DUPLICATE_COLUMN_NAMES
|
Die Datenausführung gibt doppelte Spaltennamen oder Aliasse zurück. |
INTERRUPTED
|
Die Datenausführung wird unterbrochen. Bitte aktualisieren Sie die Seite später. |
CONCURRENT_QUERY
|
Die Datenausführung läuft. Sie können erst aktualisiert werden, wenn sie abgeschlossen sind. |
OTHER
|
Sonstige Fehler. |
TOO_MANY_CHARS_PER_CELL
|
Bei der Datenausführung werden Werte zurückgegeben, die die in einer einzelnen Zelle maximal zulässige Anzahl von Zeichen überschreiten. |
DATA_NOT_FOUND
|
Die Datenbank, auf die in 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
|
Die Datenausführung gibt Spalten mit fehlenden Aliasen zurück. |
OBJECT_NOT_FOUND
|
Das Datenquellenobjekt ist nicht vorhanden. |
OBJECT_IN_ERROR_STATE
|
Das Datenquellenobjekt weist derzeit einen Fehlerstatus auf. Wenn Sie die Aktualisierung erzwingen möchten, legen Sie force in RefreshDataSourceRequest fest.
|
OBJECT_SPEC_INVALID
|
Die Objektspezifikation der Datenquelle ist ungültig. |
DATA_EXECUTION_CANCELLED
|
Die Datenausführung wurde abgebrochen. |
ExtendedValue
Die Arten von Werten, die eine Zelle in einer Tabellenkalkulation 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.
Für value ist nur einer der folgenden Werte zulässig:
|
|
numberValue
|
Stellt einen Double-Wert dar. Hinweis: Datum, Uhrzeit und DateTimes werden als Doubles im Format |
stringValue
|
Stellt einen Stringwert dar. Vorangestellte einfache Anführungszeichen werden nicht berücksichtigt. 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
Fehler in einer Zelle.
JSON-Darstellung |
---|
{
"type": enum (
|
Felder | |
---|---|
type
|
Die Art des Fehlers. |
message
|
Eine Meldung mit weiteren Informationen zum Fehler (in der Sprache der Tabelle). |
ErrorType
Die Art des Fehlers.
Enums | |
---|---|
ERROR_TYPE_UNSPECIFIED
|
Verwenden Sie diesen Standardfehlertyp nicht. |
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 von Datenvalidierung, bedingter Formatierung und Filtern. Erfordert einen einzelnen ConditionValue .
|
NUMBER_GREATER_THAN_EQ
|
Der Wert der Zelle muss größer oder gleich dem Wert der Bedingung sein. Unterstützt von Datenvalidierung, bedingter Formatierung und Filtern. Erfordert einen einzelnen ConditionValue .
|
NUMBER_LESS
|
Der Wert der Zelle muss kleiner als der Wert der Bedingung sein. Unterstützt von Datenvalidierung, bedingter Formatierung und Filtern. Erfordert einen einzelnen ConditionValue .
|
NUMBER_LESS_THAN_EQ
|
Der Wert der Zelle muss kleiner oder gleich dem Wert der Bedingung sein. Unterstützt von Datenvalidierung, bedingter Formatierung und Filtern. Erfordert einen einzelnen ConditionValue .
|
NUMBER_EQ
|
Der Wert der Zelle muss dem Wert der Bedingung entsprechen. Unterstützt von Datenvalidierung, bedingter Formatierung und Filtern. Erfordert ein einzelnes ConditionValue -Objekt für die Datenvalidierung, die bedingte Formatierung und Filter für Nicht-Datenquellenobjekte sowie mindestens eine ConditionValue für Filter für Datenquellenobjekte.
|
NUMBER_NOT_EQ
|
Der Wert der Zelle darf nicht mit dem Wert der Bedingung übereinstimmen. Unterstützt von Datenvalidierung, bedingter Formatierung und Filtern. Erfordert ein einzelnes ConditionValue -Objekt für die Datenvalidierung, die bedingte Formatierung und Filter für Nicht-Datenquellenobjekte sowie mindestens eine ConditionValue für Filter für Datenquellenobjekte.
|
NUMBER_BETWEEN
|
Der Wert der Zelle muss zwischen den beiden Bedingungswerten liegen. Unterstützt von Datenvalidierung, bedingter Formatierung und Filtern. Erfordert genau zwei ConditionValues .
|
NUMBER_NOT_BETWEEN
|
Der Wert der Zelle darf nicht zwischen den beiden Bedingungswerten liegen. Unterstützt von Datenvalidierung, bedingter Formatierung und Filtern. Erfordert genau zwei ConditionValues .
|
TEXT_CONTAINS
|
Der Wert der Zelle muss den Wert der Bedingung enthalten. Unterstützt von Datenvalidierung, bedingter Formatierung und Filtern. Erfordert einen einzelnen ConditionValue .
|
TEXT_NOT_CONTAINS
|
Der Wert der Zelle darf den Wert der Bedingung nicht enthalten. Unterstützt von Datenvalidierung, bedingter Formatierung und Filtern. Erfordert einen einzelnen ConditionValue .
|
TEXT_STARTS_WITH
|
Der Wert der Zelle muss mit dem Wert der Bedingung beginnen. Unterstützt von bedingter Formatierung und Filtern. Erfordert einen einzelnen ConditionValue .
|
TEXT_ENDS_WITH
|
Der Wert der Zelle muss mit dem Wert der Bedingung enden. Unterstützt von bedingter Formatierung und Filtern. Erfordert einen einzelnen ConditionValue .
|
TEXT_EQ
|
Der Wert der Zelle muss genau dem Wert der Bedingung entsprechen. Unterstützt von Datenvalidierung, bedingter Formatierung und Filtern. Erfordert ein einzelnes ConditionValue -Objekt für die Datenvalidierung, die bedingte Formatierung und Filter für Nicht-Datenquellenobjekte sowie mindestens eine ConditionValue für Filter für Datenquellenobjekte.
|
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 dasselbe Datum wie der Wert der Bedingung sein. Unterstützt von Datenvalidierung, bedingter Formatierung und Filtern. Erfordert ein einzelnes ConditionValue -Objekt für die Datenvalidierung, die bedingte Formatierung und Filter für Nicht-Datenquellenobjekte sowie mindestens eine ConditionValue für Filter für Datenquellenobjekte.
|
DATE_BEFORE
|
Der Wert der Zelle muss vor dem Datum des Bedingungswerts liegen. Unterstützt von Datenvalidierung, bedingter Formatierung und Filtern. Erfordert ein einzelnes ConditionValue -Objekt, das ein relative date sein kann.
|
DATE_AFTER
|
Der Wert der Zelle muss nach dem Datum des Bedingungswerts liegen. Unterstützt von Datenvalidierung, bedingter Formatierung und Filtern. Erfordert ein einzelnes ConditionValue -Objekt, das ein relative date sein kann.
|
DATE_ON_OR_BEFORE
|
Der Wert der Zelle muss dem Datum des Bedingungswerts entsprechen oder davor liegen. Unterstützt durch Datenvalidierung. Erfordert ein einzelnes ConditionValue -Objekt, das ein relative date sein kann.
|
DATE_ON_OR_AFTER
|
Der Wert der Zelle muss am oder nach dem Datum des Bedingungswerts liegen. Unterstützt durch Datenvalidierung. Erfordert ein einzelnes ConditionValue -Objekt, das ein relative date sein kann.
|
DATE_BETWEEN
|
Der Wert der Zelle muss zwischen den Datumsangaben für die beiden Bedingungswerte liegen. Unterstützt durch Datenvalidierung. Erfordert genau zwei ConditionValues .
|
DATE_NOT_BETWEEN
|
Der Wert der Zelle muss außerhalb der Datumsangaben für die beiden Bedingungswerte liegen. Unterstützt durch Datenvalidierung. Erfordert genau zwei ConditionValues .
|
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. Erfordert einen einzelnen ConditionValue . 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 , jeweils einer pro Eintrag in der Liste. Formeln werden in den Werten nicht unterstützt.
|
BLANK
|
Der Wert der Zelle muss leer sein. Unterstützt von bedingter Formatierung und Filtern. Erfordert keine ConditionValues .
|
NOT_BLANK
|
Der Wert der Zelle darf nicht leer sein. Unterstützt von bedingter Formatierung und Filtern. Erfordert keine ConditionValues .
|
CUSTOM_FORMULA
|
Die Formel der Bedingung muss als „true“ ausgewertet werden. Unterstützt von Datenvalidierung, bedingter Formatierung und Filtern. Wird von Filtern für Datenquellentabellen nicht unterstützt. Erfordert einen einzelnen ConditionValue .
|
BOOLEAN
|
Der Wert der Zelle muss WAHR/FALSCH sein oder in der Liste der Bedingungswerte enthalten sein. Unterstützt durch Datenvalidierung. Wird als Zellenkästchen gerendert. Unterstützt null, ein oder zwei ConditionValues . Kein Wert bedeutet, dass die Zelle WAHR oder FALSCH sein muss, wobei WAHR als aktiviert und FALSCH als deaktiviert gerendert wird. Ein Wert gibt an, dass die Zelle als aktiviert gerendert wird, wenn sie diesen Wert enthält, und deaktiviert, wenn sie leer ist. Zwei Werte zeigen an, dass die Zelle als aktiviert gerendert wird, wenn sie den ersten Wert enthält, und dann deaktiviert wird, wenn sie den zweiten Wert enthält. [„Ja“, „Nein“] bedeutet beispielsweise, dass die Zelle ein aktiviertes Kästchen rendert, wenn sie den Wert „Ja“ hat, und ein deaktiviertes Kästchen, wenn sie den Wert „Nein“ hat.
|
TEXT_NOT_EQ
|
Der Wert der Zelle muss genau nicht dem Wert der Bedingung entsprechen. Unterstützt von Filtern für Datenquellenobjekte. Erfordert mindestens einen ConditionValue .
|
DATE_NOT_EQ
|
Der Wert der Zelle muss genau nicht dem Wert der Bedingung entsprechen. Unterstützt von Filtern für Datenquellenobjekte. Erfordert mindestens einen ConditionValue .
|
FILTER_EXPRESSION
|
Der Wert der Zelle muss dem angegebenen Muster folgen. Erfordert einen einzelnen ConditionValue .
|
ConditionValue
Der Wert der Bedingung.
JSON-Darstellung |
---|
{ // Union field |
Felder | |
---|---|
Union-Feld value . Der Wert der Bedingung. Es muss genau eins festgelegt werden.
Für value ist nur einer der folgenden Werte zulässig:
|
|
relativeDate
|
Ein relatives Datum (basierend auf dem aktuellen Datum). Nur gültig, wenn Relative Datumsangaben werden bei der Datenvalidierung nicht unterstützt. Sie werden nur bei bedingter Formatierung und bedingten Filtern unterstützt. |
userEnteredValue
|
Ein Wert, auf dem die Bedingung basiert. Der Wert wird so geparst, als hätte der Nutzer Text in eine Zelle eingegeben. Formeln werden unterstützt (und müssen mit einem |
RelativeDate
Steuert, wie eine Datumsbedingung ausgewertet wird.
Enums | |
---|---|
RELATIVE_DATE_UNSPECIFIED
|
Standardwert, nicht verwenden. |
PAST_YEAR
|
Der Wert liegt ein Jahr vor heute. |
PAST_MONTH
|
Der Wert liegt einen Monat vor heute. |
PAST_WEEK
|
Der Wert liegt eine Woche vor heute. |
YESTERDAY
|
Der Wert ist gestern. |
TODAY
|
Der Wert ist „Heute“. |
TOMORROW
|
Der Wert ist morgen. |
GridRange
Ein Bereich auf einem Tabellenblatt. Alle Indexe sind nullbasiert. Indizes sind halb offen, d.h., der Startindex ist einschließlich und der Endindex exklusiv - [startIndex, endIndex). Fehlende Indexe zeigen an, dass der Bereich auf dieser Seite unbegrenzt ist.
Wenn "Sheet1"
beispielsweise die Tabellenblatt-ID 123456 ist, dann 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 muss immer kleiner oder gleich dem Endindex sein. Wenn der Startindex mit dem Endindex übereinstimmt, ist der Bereich leer. Leere Bereiche sind normalerweise nicht aussagekräftig und werden in der UI normalerweise als #REF!
gerendert.
JSON-Darstellung |
---|
{ "sheetId": integer, "startRowIndex": integer, "endRowIndex": integer, "startColumnIndex": integer, "endColumnIndex": integer } |
Felder | |
---|---|
sheetId
|
Das Tabellenblatt, auf dem sich dieser Bereich befindet. |
startRowIndex
|
Die Startzeile (einschließlich) des Bereichs oder ist nicht festgelegt, wenn sie unbegrenzt ist. |
endRowIndex
|
Die Endzeile (exklusive) des Bereichs oder nicht festgelegt, wenn unbegrenzt. |
startColumnIndex
|
Die Startspalte (einschließlich) des Bereichs oder ist nicht festgelegt, wenn sie unbegrenzt ist. |
endColumnIndex
|
Die Endspalte (exklusiv) des Bereichs oder nicht festgelegt, wenn sie unbegrenzt ist. |
SortOrder
Eine Sortierreihenfolge.
Enums | |
---|---|
SORT_ORDER_UNSPECIFIED
|
Standardwert, nicht verwenden. |
ASCENDING
|
Aufsteigend sortieren. |
DESCENDING
|
Absteigend sortieren. |
FilterSpec
Die Filterkriterien, die einer bestimmten Spalte zugeordnet sind.
JSON-Darstellung |
---|
{ "filterCriteria": { object ( |
Felder | |
---|---|
filterCriteria
|
Die Kriterien für die Spalte. |
Union-Feld reference . Verweis auf die gefilterte Spalte.
Für reference ist nur einer der folgenden Werte zulässig:
|
|
columnIndex
|
Der nullbasierte Spaltenindex. |
dataSourceColumnReference
|
Verweis auf eine Spalte in der Datenquelle. |
FilterCriteria
Kriterien zum Ein- oder Ausblenden von Zeilen in einer Filter- oder Filteransicht.
JSON-Darstellung |
---|
{ "hiddenValues": [ string ], "condition": { object ( |
Felder | |
---|---|
condition
|
Eine Bedingung, die erfüllt sein muss, damit Werte angezeigt werden. ( |
visibleBackgroundColor
|
Die Füllfarbe des Hintergrunds, nach der gefiltert werden soll. Es werden nur Zellen mit dieser Füllfarbe angezeigt. Schließt sich mit |
visibleBackgroundColorStyle
|
Die Füllfarbe des Hintergrunds, nach der gefiltert werden soll. Es werden nur Zellen mit dieser Füllfarbe angezeigt. Dieses Feld schließt sich mit |
visibleForegroundColor
|
Vordergrundfarbe, nach der gefiltert werden soll. Es werden nur Zellen mit dieser Farbe angezeigt. Schließt sich mit |
visibleForegroundColorStyle
|
Vordergrundfarbe, nach der gefiltert werden soll. Es werden nur Zellen mit dieser Farbe angezeigt. Dieses Feld schließt sich mit |
SortSpec
Eine Sortierreihenfolge, die einer bestimmten Spalte oder Zeile zugeordnet ist.
JSON-Darstellung |
---|
{ "sortOrder": enum ( |
Felder | |
---|---|
sortOrder
|
Die Bestelldaten sollten sortiert sein. |
foregroundColor
|
Vordergrundfarbe, nach der sortiert werden soll. Zellen mit dieser Vordergrundfarbe werden oben sortiert. Schließt sich mit |
foregroundColorStyle
|
Vordergrundfarbe, nach der sortiert werden soll. Zellen mit dieser Vordergrundfarbe werden oben sortiert. Schließt sich mit |
backgroundColor
|
Die Füllfarbe des Hintergrunds, nach der sortiert werden soll. Zellen mit dieser Füllfarbe werden oben sortiert. Schließt sich mit |
backgroundColorStyle
|
Die Füllfarbe des Hintergrunds, nach der sortiert werden soll. Zellen mit dieser Füllfarbe werden oben sortiert. Schließt sich mit |
Union-Feld reference . Verweis auf die sortierte Dimension.
Für reference ist nur einer der folgenden Werte zulässig:
|
|
dimensionIndex
|
Die Dimension, auf die die Sortierung angewendet werden soll. |
dataSourceColumnReference
|
Verweis auf eine Spalte in der Datenquelle. |
EmbeddedObjectPosition
Die Position eines eingebetteten Objekts, z. B. eines Diagramms.
JSON-Darstellung |
---|
{ // Union field |
Felder | |
---|---|
Union-Feld location . Der Speicherort des Objekts. Es muss genau ein Wert festgelegt werden.
Für location ist nur einer der folgenden Werte zulässig:
|
|
sheetId
|
Das Tabellenblatt, auf dem sich die Nachricht 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 das Raster überlagert. |
newSheet
|
Bei „true“ wird das eingebettete Objekt auf ein neues Tabellenblatt eingefügt, dessen ID für Sie ausgewählt wird. Wird nur beim Schreiben verwendet. |
OverlayPosition
Die Position, an der ein Objekt auf einem Raster liegt.
JSON-Darstellung |
---|
{
"anchorCell": {
object (
|
Felder | |
---|---|
anchorCell
|
Die Zelle, in der das Objekt verankert ist |
offsetXPixels
|
Der horizontale Versatz in Pixeln, um den das Objekt von der Ankerzelle entfernt ist. |
offsetYPixels
|
Der vertikale Abstand in Pixeln, um den das Objekt von der Ankerzelle entfernt ist. |
widthPixels
|
Die Breite des Objekts in Pixeln. Die Standardeinstellung ist 600. |
heightPixels
|
Die Höhe des Objekts in Pixeln. Die Standardeinstellung ist 371. |
GridCoordinate
Eine Koordinate in einem Tabellenblatt. Alle Indexe sind nullbasiert.
JSON-Darstellung |
---|
{ "sheetId": integer, "rowIndex": integer, "columnIndex": integer } |
Felder | |
---|---|
sheetId
|
Das Tabellenblatt, auf dem sich diese Koordinate befindet. |
rowIndex
|
Der Zeilenindex der Koordinate. |
columnIndex
|
Der Spaltenindex der Koordinate. |