Farbe
Ermöglicht die Darstellung einer Farbe im RGBA-Farbraum. Diese Darstellung ist auf die einfache Konvertierung in und aus Farbdarstellungen in verschiedenen Sprachen statt auf Kompaktheit ausgelegt. Die Felder dieser Darstellung können beispielsweise einfach dem Konstruktor von
java.awt.Color
in Java; kann auch einfach dem UIColor-Tool
+colorWithRed:green:blue:alpha
in iOS verwenden: und kann mit wenig Aufwand in ein CSS-Format
rgba()
in JavaScript verwenden.
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 in Anwendungen der sRGB-Farbraum verwendet werden.
Wenn die Farbgleichheit beschlossen werden muss, werden Implementierungen, sofern nicht anders angegeben, zwei Farben als gleich behandelt, wenn sich alle ihre Rot-, Grün-, Blau- und Alpha-Werte um höchstens
1e-5
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 keine Angabe gemacht wird, wird dieses Farbobjekt als Volltonfarbe gerendert, so als ob dem Alphawert explizit der Wert 1,0 zugewiesen worden wäre. |
ColorStyle
Farbwert.
JSON-Darstellung |
---|
{ // Union field |
Felder | |
---|---|
Union-Feld
kind Die Art des Farbwerts.
kind
kann nur einer der folgenden Werte sein:
|
|
rgbColor
|
RGB-Farbe. Die
|
themeColor
|
Designfarbe. |
ThemeColorType
Farbtypen der Designs.
SpreadsheetProperties
enthält
SpreadsheetTheme
definiert eine Zuordnung dieser Farbtypen
zu Betonfarben.
Enums | |
---|---|
THEME_COLOR_TYPE_UNSPECIFIED
|
Designfarbe nicht angegeben |
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
|
Die vierte Akzentfarbe |
ACCENT5
|
Steht für die fünfte Akzentfarbe |
ACCENT6
|
Steht für die sechste Akzentfarbe |
LINK
|
Die Farbe, die für Hyperlinks verwendet werden soll |
HorizontalAlign
Die horizontale Ausrichtung von Text in einer Zelle.
Enums | |
---|---|
HORIZONTAL_ALIGN_UNSPECIFIED
|
Die horizontale Ausrichtung ist nicht angegeben. Nicht verwenden. |
LEFT
|
Der Text ist explizit links von der Zelle ausgerichtet. |
CENTER
|
Der Text ist explizit an der Mitte der Zelle ausgerichtet. |
RIGHT
|
Der Text ist explizit rechts von der Zelle ausgerichtet. |
TextFormat
Das Format einer Laufschrift in einer Zelle. Fehlende Werte weisen darauf hin, dass das Feld nicht angegeben ist.
JSON-Darstellung |
---|
{ "foregroundColor": { object ( |
Felder | |
---|---|
foregroundColor
|
Die Vordergrundfarbe des Textes. Eingestellt: Verwenden
|
foregroundColorStyle
|
Die Vordergrundfarbe des Textes. Wenn
|
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
|
Wahr, wenn der Text unterstrichen ist. |
link
|
Das Linkziel des Textes, falls vorhanden. Das Link-Feld in einem
|
Link
Eine externe oder lokale Referenz.
JSON-Darstellung |
---|
{ // Union field |
Felder | |
---|---|
Union-Feld
destination Das Linkziel.
destination
kann nur einer der folgenden Werte sein:
|
|
uri
|
Die Link-ID. |
DataSourceColumn
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. Er muss innerhalb einer Datenquelle eindeutig sein. |
DataExecutionStatus
Der Status der Datenausführung.
Eine Datenausführung wird erstellt, um ein Datenquellenobjekt mit den neuesten Daten aus einem
DataSource
Normalerweise wird sie im Hintergrund ausgeführt.
state
um festzustellen, ob eine Ausführung abgeschlossen ist,
Es gibt mehrere Szenarien, in denen eine Datenausführung ausgelöst wird:
-
Adding a data source
erstellt ein zugehöriges Datenquellenblatt und eine Datenausführung, um die Daten aus der Datenquelle mit der Tabelle zu synchronisieren. -
Updating a data source
erstellt eine Datenausführung, um das zugehörige Datenquellenblatt auf ähnliche Weise zu aktualisieren. -
Sie können
refresh request
ein oder mehrere Datenquellenobjekte explizit aktualisieren.
JSON-Darstellung |
---|
{ "state": enum ( |
Felder | |
---|---|
state
|
Der Status der Datenausführung. |
errorCode
|
Der Fehlercode. |
errorMessage
|
Die Fehlermeldung. Diese ist möglicherweise leer. |
lastRefreshTime
|
Ruft den Zeitpunkt der letzten Aktualisierung der Daten ab. |
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 wurde gestartet und wird ausgeführt. |
CANCELLING
|
Die Datenausführung wird gerade abgebrochen. |
SUCCEEDED
|
Die Datenausführung wurde abgeschlossen. |
FAILED
|
Die Datenausführung wurde mit Fehlern abgeschlossen. |
DataExecutionErrorCode
Eine Aufzählung von Datenausführungsfehlercode.
Enums | |
---|---|
DATA_EXECUTION_ERROR_CODE_UNSPECIFIED
|
Standardwert, nicht verwenden. |
TIMED_OUT
|
Zeitüberschreitung bei der Datenausführung. |
TOO_MANY_ROWS
|
Bei der Datenausführung werden mehr Zeilen zurückgegeben als das Limit. |
TOO_MANY_COLUMNS
|
Bei der Datenausführung werden mehr Spalten als das Limit zurückgegeben. |
TOO_MANY_CELLS
|
Bei der Datenausführung werden mehr Zellen zurückgegeben, als das Limit erlaubt. |
ENGINE
|
Der Fehler wird von der Back-End-Datenausführungs-Engine (z.B. BigQuery) empfangen. Prüfen
errorMessage
.
|
PARAMETER_INVALID
|
Mindestens einer der angegebenen Datenquellenparameter ist 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 werden doppelte Spaltennamen oder Aliasse zurückgegeben. |
INTERRUPTED
|
Die Datenausführung wird unterbrochen. Bitte aktualisiere die Seite später. |
CONCURRENT_QUERY
|
Die Daten werden gerade ausgeführt und können erst aktualisiert werden, wenn sie abgeschlossen ist. |
OTHER
|
Sonstige Fehler. |
TOO_MANY_CHARS_PER_CELL
|
Beim Ausführen der Daten werden Werte zurückgegeben, die die in einer einzelnen Zelle zulässige Zeichenbeschränkung ü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
|
Beim Ausführen der Daten werden Spalten mit fehlenden Aliassen zurückgegeben. |
OBJECT_NOT_FOUND
|
Das Datenquellenobjekt ist nicht vorhanden. |
OBJECT_IN_ERROR_STATE
|
Das Datenquellenobjekt befindet sich derzeit im Fehlerstatus. Um eine Aktualisierung zu erzwingen, legen Sie
force
in
RefreshDataSourceRequest .
|
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 Typ des Werts in einer Zelle. Ist kein Feld festgelegt, enthält die Zelle keine Daten.
value
kann nur einer der folgenden Werte sein:
|
|
numberValue
|
Stellt einen Double-Wert dar. Hinweis: Datum, Uhrzeit und Datum/Uhrzeit werden in
|
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
|
Nicht den standardmäßigen Fehlertyp verwenden. |
ERROR
|
Entspricht dem
#ERROR!
Fehler.
|
NULL_VALUE
|
Entspricht dem
#NULL!
Fehler.
|
DIVIDE_BY_ZERO
|
Entspricht dem
#DIV/0
Fehler.
|
VALUE
|
Entspricht dem
#VALUE!
Fehler.
|
REF
|
Entspricht dem
#REF!
Fehler.
|
NAME
|
Entspricht dem
#NAME?
Fehler.
|
NUM
|
Entspricht dem
#NUM!
Fehler.
|
N_A
|
Entspricht dem
#N/A
Fehler.
|
LOADING
|
Entspricht dem
Loading...
Bundesstaat.
|
BooleanCondition
Eine Bedingung, die als wahr oder falsch ausgewertet werden kann. BoolescheBedingungen werden für die bedingte Formatierung, die Datenvalidierung und die Kriterien in Filtern verwendet.
JSON-Darstellung |
---|
{ "type": enum ( |
Felder | |
---|---|
type
|
Die Art der Bedingung. |
values[]
|
Die Werte der Bedingung. Die Anzahl der unterstützten Werte hängt vom
|
ConditionType
Die Art der Bedingung.
Enums | |
---|---|
CONDITION_TYPE_UNSPECIFIED
|
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
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
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
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
ConditionValue
|
NUMBER_EQ
|
Der Wert der Zelle muss dem Wert der Bedingung entsprechen. Unterstützt durch Datenvalidierung, bedingte Formatierung und Filter. Erfordert eine
ConditionValue
für Datenvalidierung, bedingte Formatierung und Filter für Nicht-Datenquellenobjekte und mindestens eines
ConditionValue
für Filter für Datenquellenobjekte.
|
NUMBER_NOT_EQ
|
Der Wert der Zelle darf nicht dem Wert der Bedingung entsprechen. Unterstützt durch Datenvalidierung, bedingte Formatierung und Filter. Erfordert eine
ConditionValue
für Datenvalidierung, bedingte Formatierung und Filter für Nicht-Datenquellenobjekte und mindestens eines
ConditionValue
für Filter für Datenquellenobjekte.
|
NUMBER_BETWEEN
|
Der Wert der Zelle muss zwischen den beiden Bedingungswerten liegen. Unterstützt durch Datenvalidierung, bedingte Formatierung und Filter. Erfordert genau zwei
ConditionValues
|
NUMBER_NOT_BETWEEN
|
Der Wert der Zelle darf nicht zwischen den beiden Bedingungswerten liegen. Unterstützt durch Datenvalidierung, bedingte Formatierung und Filter. Erfordert genau zwei
ConditionValues
|
TEXT_CONTAINS
|
Der Wert der Zelle muss den Wert der Bedingung enthalten. Unterstützt durch Datenvalidierung, bedingte Formatierung und Filter. Erfordert eine
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
ConditionValue
|
TEXT_STARTS_WITH
|
Der Wert der Zelle muss mit dem Wert der Bedingung beginnen. Unterstützt durch bedingte Formatierung und Filter. Erfordert eine
ConditionValue
|
TEXT_ENDS_WITH
|
Der Wert der Zelle muss mit dem Wert der Bedingung enden. Unterstützt durch bedingte Formatierung und Filter. Erfordert eine
ConditionValue
|
TEXT_EQ
|
Der Wert der Zelle muss genau mit dem Wert der Bedingung übereinstimmen. Unterstützt durch Datenvalidierung, bedingte Formatierung und Filter. Erfordert eine
ConditionValue
für Datenvalidierung, bedingte Formatierung und Filter für Nicht-Datenquellenobjekte und mindestens eines
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 in der Zelle muss mit dem Datum der Bedingung übereinstimmen. Unterstützt durch Datenvalidierung, bedingte Formatierung und Filter. Erfordert eine
ConditionValue
für Datenvalidierung, bedingte Formatierung und Filter für Nicht-Datenquellenobjekte und mindestens eines
ConditionValue
für Filter für Datenquellenobjekte.
|
DATE_BEFORE
|
Der Wert in der Zelle muss vor dem Datum des Bedingungswerts liegen. Unterstützt durch Datenvalidierung, bedingte Formatierung und Filter. Erfordert eine
ConditionValue
kann das ein
relative date .
|
DATE_AFTER
|
Der Wert in der Zelle muss nach dem Datum des Bedingungswerts liegen. Unterstützt durch Datenvalidierung, bedingte Formatierung und Filter. Erfordert eine
ConditionValue
kann das ein
relative date .
|
DATE_ON_OR_BEFORE
|
Der Wert der Zelle muss dem Datum des Bedingungswerts entsprechen oder davor liegen. Unterstützt durch Datenvalidierung. Erfordert eine
ConditionValue
kann das ein
relative date .
|
DATE_ON_OR_AFTER
|
Der Wert der Zelle muss dem Datum des Bedingungswerts entsprechen oder danach liegen. Unterstützt durch Datenvalidierung. Erfordert eine
ConditionValue
kann das ein
relative date .
|
DATE_BETWEEN
|
Der Wert der Zelle muss zwischen den Datumsangaben der beiden Bedingungswerte liegen. Unterstützt durch Datenvalidierung. Erfordert genau zwei
ConditionValues
|
DATE_NOT_BETWEEN
|
Der Wert der Zelle muss außerhalb der Datumsangaben der 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 eine
ConditionValue und der Wert muss ein gültiger Bereich in A1-Schreibweise sein.
|
ONE_OF_LIST
|
Der Wert der Zelle muss in der Liste der Bedingungswerte enthalten sein. Unterstützt durch Datenvalidierung. Unterstützt beliebig viele
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 bei Filtern in Datenquellentabellen nicht unterstützt. Erfordert eine
ConditionValue
|
BOOLEAN
|
Der Wert der Zelle muss WAHR/FALSCH sein oder in der Liste der Bedingungswerte enthalten sein. Unterstützt durch Datenvalidierung. Wird als Kästchen für Zellen gerendert. Unterstützt null, eins oder zwei
ConditionValues Keine Werte bedeutet, dass die Zelle WAHR oder FALSCH sein muss, wobei WAHR als aktiviert und FALSCH als ungeprüft gerendert wird. Ein Wert gibt an, dass die Zelle als überprüft gerendert wird, wenn sie diesen Wert enthält, und deaktiviert, wenn sie leer ist. Zwei Werte geben an, dass die Zelle als aktiviert gerendert wird, wenn sie den ersten Wert enthält, und als deaktiviert, wenn sie den zweiten Wert enthält. Beispiel: [„Ja“, „Nein“] bedeutet, dass die Zelle ein Häkchen rendert, wenn sie den Wert „Ja“ hat. und ein deaktiviertes Kontrollkästchen, wenn es den Wert „Nein“ hat.
|
TEXT_NOT_EQ
|
Der Wert der Zelle darf nicht der Wert der Bedingung sein. Unterstützt durch Filter für Datenquellenobjekte. Benötigt mindestens eine
ConditionValue
|
DATE_NOT_EQ
|
Der Wert der Zelle darf nicht der Wert der Bedingung sein. Unterstützt durch Filter für Datenquellenobjekte. Benötigt mindestens eine
ConditionValue
|
FILTER_EXPRESSION
|
Der Wert der Zelle muss dem angegebenen Muster entsprechen. Erfordert eine
ConditionValue
|
ConditionValue
Der Wert der Bedingung.
JSON-Darstellung |
---|
{ // Union field |
Felder | |
---|---|
Union-Feld
value Der Wert der Bedingung. Es muss genau ein Wert festgelegt werden.
value
kann nur einer der folgenden Werte sein:
|
|
relativeDate
|
Ein relatives Datum (basierend auf dem aktuellen Datum). Nur gültig, wenn der
Relative Datumsangaben werden bei der Datenvalidierung nicht unterstützt. Sie werden nur bei bedingter Formatierung und bedingten Filtern unterstützt. |
userEnteredValue
|
Wert, auf dem die Bedingung basiert. Der Wert wird so geparst, als ob der Benutzer eine Eingabe in eine Zelle eingegeben hätte. 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 lautet 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 inklusive und der Endindex ist exklusiv – [startIndex, endIndex). Fehlende Indexe weisen darauf hin, dass der Bereich auf dieser Seite unbegrenzt ist.
Wenn beispielsweise
"Sheet1"
die Tabellenblatt-ID 123456 lautet, dann:
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 Benutzeroberfläche
#REF!
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 nicht festgelegt, falls unbegrenzt. |
endRowIndex
|
Die Endzeile (ausschließlich) des Bereichs oder nicht festgelegt, falls unbegrenzt. |
startColumnIndex
|
Die Startspalte (einschließlich) des Bereichs oder nicht festgelegt, wenn sie unbegrenzt ist. |
endColumnIndex
|
Die Endspalte (ausschließlich) des Bereichs oder nicht festgelegt, falls unbegrenzt. |
SortOrder
Eine Sortierreihenfolge.
Enums | |
---|---|
SORT_ORDER_UNSPECIFIED
|
Standardwert, nicht verwenden. |
ASCENDING
|
Sortieren Sie aufsteigend. |
DESCENDING
|
Sortierung absteigend. |
FilterSpec
Die mit einer bestimmten Spalte verknüpften Filterkriterien.
JSON-Darstellung |
---|
{ "filterCriteria": { object ( |
Felder | |
---|---|
filterCriteria
|
Die Kriterien für die Spalte. |
Union-Feld
reference Verweis auf die gefilterte Spalte.
reference
kann nur einer der folgenden Werte sein:
|
|
columnIndex
|
Der nullbasierte Spaltenindex. |
dataSourceColumnReference
|
Verweis auf eine Datenquellenspalte. |
FilterCriteria
Kriterien zum Ein-/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. (Dies hat keine
|
visibleBackgroundColor
|
Die Füllfarbe des Hintergrunds, nach der gefiltert werden soll: werden nur Zellen mit dieser Füllfarbe angezeigt. Gegenseitig ausschließen mit
|
visibleBackgroundColorStyle
|
Die Füllfarbe des Hintergrunds, nach der gefiltert werden soll: werden nur Zellen mit dieser Füllfarbe angezeigt. Dieses Feld schließt sich gegenseitig aus mit
|
visibleForegroundColor
|
Vordergrundfarbe, nach der gefiltert werden soll; werden nur Zellen mit dieser Vordergrundfarbe angezeigt. Gegenseitig ausschließen mit
|
visibleForegroundColorStyle
|
Vordergrundfarbe, nach der gefiltert werden soll; werden nur Zellen mit dieser Vordergrundfarbe angezeigt. Dieses Feld schließt sich gegenseitig aus mit
|
SortSpec
Eine Sortierreihenfolge, die einer bestimmten Spalte oder Zeile zugeordnet ist.
JSON-Darstellung |
---|
{ "sortOrder": enum ( |
Felder | |
---|---|
sortOrder
|
Die Reihenfolgedaten sollten sortiert werden. |
foregroundColor
|
Vordergrundfarbe, nach der sortiert werden soll mit dieser Vordergrundfarbe werden
oben angezeigt. Gegenseitig ausschließen mit
|
foregroundColorStyle
|
Vordergrundfarbe, nach der sortiert werden soll mit dieser Vordergrundfarbe werden oben
sortiert. Gegenseitig ausschließen mit
|
backgroundColor
|
Die Füllfarbe des Hintergrunds, nach der sortiert werden soll: werden die Zellen mit dieser Füllfarbe
oben sortiert. Gegenseitig ausschließen mit
|
backgroundColorStyle
|
Die Füllfarbe des Hintergrunds, nach der sortiert werden soll: werden die Zellen mit dieser Füllfarbe
oben sortiert. Gegenseitig ausschließen mit
|
Union-Feld
reference Verweis auf die sortierte Dimension.
reference
kann nur einer der folgenden Werte sein:
|
|
dimensionIndex
|
Die Dimension, auf die die Sortierung angewendet werden soll. |
dataSourceColumnReference
|
Verweis auf eine Datenquellenspalte. |
EmbeddedObjectPosition
Die Position eines eingebetteten Objekts, z. B. eines Diagramms.
JSON-Darstellung |
---|
{ // Union field |
Felder | |
---|---|
Union-Feld
location Die Position des Objekts. Es muss genau ein Wert festgelegt werden.
location
kann nur einer der folgenden Werte sein:
|
|
sheetId
|
Das Tabellenblatt, auf dem sich die Datei 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 über einem Raster gelegt wird. |
newSheet
|
Bei „true“ wird das eingebettete Objekt in 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 über einem Raster liegt.
JSON-Darstellung |
---|
{
"anchorCell": {
object (
|
Felder | |
---|---|
anchorCell
|
Zelle, an der das Objekt verankert ist |
offsetXPixels
|
Der horizontale Versatz in Pixeln, um den das Objekt von der Ankerzelle entfernt ist. |
offsetYPixels
|
Der vertikale Versatz 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. |