Farbe
Ermöglicht die Darstellung einer Farbe im RGBA-Farbraum. Diese Darstellung ist für eine einfache Umwandlung von Farbdarstellungen in verschiedenen Sprachen in kompakte Form konzipiert. Die Felder dieser Darstellung können beispielsweise ganz einfach an den Konstruktor von java.awt.Color
in Java übergeben werden. Sie lassen sich auch ganz einfach an die Methode +colorWithRed:green:blue:alpha
der UI-Farbe in iOS übergeben. Mit nur wenig Aufwand können sie in JavaScript ganz einfach in einen CSS-String rgba()
formatiert werden.
Diese Referenzseite enthält keine Informationen zum absoluten Farbraum, der zur Interpretation des RGB-Werts verwendet werden soll (z. B. sRGB, Adobe RGB, DCI-P3 und BT.2020). Standardmäßig sollte in Anwendungen der sRGB-Farbraum angenommen werden.
Wenn die Farbgleichheit entschieden werden muss, behandeln Implementierungen, sofern nicht anders angegeben, zwei Farben als gleich, wenn sich alle ihre roten, grünen, blauen und Alphawerte höchstens um 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 kein Wert angegeben, wird dieses Farbobjekt als Volltonfarbe gerendert, als ob der Alphawert explizit den Wert 1,0 erhalten hätte. |
Farbstil
Ein Farbwert
JSON-Darstellung |
---|
{ // Union field |
Felder | |
---|---|
Union-Feld kind . Die Art des Farbwerts.
kind darf nur einer der folgenden Werte sein:
|
|
rgbColor
|
RGB-Farbe Der Wert |
themeColor
|
Designfarbe. |
DesignFarbtyp
Designfarbtypen
SpreadsheetProperties
enthält einen SpreadsheetTheme
, der eine Zuordnung dieser Designfarbtypen zu Betonfarben definiert.
Enums | |
---|---|
THEME_COLOR_TYPE_UNSPECIFIED
|
Nicht angegebene Designfarbe |
TEXT
|
Die Farbe des Haupttexts |
BACKGROUND
|
Die primäre Hintergrundfarbe |
ACCENT1
|
Die erste Akzentfarbe |
ACCENT2
|
Die zweite Akzentfarbe |
ACCENT3
|
Stellt die dritte Akzentfarbe dar |
ACCENT4
|
Stellt die vierte Akzentfarbe dar |
ACCENT5
|
Stellt die fünfte Akzentfarbe dar |
ACCENT6
|
Die sechste Akzentfarbe |
LINK
|
Die Farbe, die für Hyperlinks verwendet werden soll |
Horizontale Ausrichtung
Horizontale Ausrichtung des Textes in einer Zelle.
Enums | |
---|---|
HORIZONTAL_ALIGN_UNSPECIFIED
|
Die horizontale Ausrichtung ist nicht angegeben. Verwende dieses Attribut nicht. |
LEFT
|
Der Text ist explizit linksbündig ausgerichtet. |
CENTER
|
Der Text wird explizit auf die Mitte der Zelle ausgerichtet. |
RIGHT
|
Der Text wird explizit rechts von der Zelle ausgerichtet. |
Textformat
Das Format einer Textausführung 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 Sie |
foregroundColorStyle
|
Die Vordergrundfarbe des Textes. Wenn auch |
fontFamily
|
Die Schriftfamilie. |
fontSize
|
Die Größe der Schriftart. |
bold
|
„true“, wenn der Text fett formatiert ist. |
italic
|
„true“, wenn der Text kursiv dargestellt wird |
strikethrough
|
Dieser Wert ist „True“, wenn der Text durchgestrichen ist. |
underline
|
„true“, wenn der Text unterstrichen ist |
link
|
Der Link-Ziel des Textes, falls vorhanden. Wenn Sie das Linkfeld in einer |
Link
Eine externe oder lokale Referenz.
JSON-Darstellung |
---|
{ // Union field |
Felder | |
---|---|
Union-Feld destination . Das Ziel des Links.
destination darf nur einer der folgenden Werte sein:
|
|
uri
|
Die Link-ID. |
Datenquellenspalte
Eine Spalte in einer Datenquelle.
JSON-Darstellung |
---|
{
"reference": {
object (
|
Felder | |
---|---|
reference
|
Spaltenreferenz |
formula
|
Die Formel der berechneten Spalte. |
Referenz der Datenquellenspalte
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. |
Status der Ausführung
Der Status der Datenausführung.
Eine Datenausführung wird erstellt, um ein Datenquellenobjekt mit den neuesten Daten aus einer DataSource
zu synchronisieren. Normalerweise ist die 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 ein zugehöriges Datenquellenblatt und eine Datenausführung für die Synchronisierung der Daten aus der Datenquelle mit dem Tabellenblatt. -
Updating a data source
erstellt eine Datenausführung, um das verknüpfte Datenquellenblatt 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
|
Fehlercode |
errorMessage
|
Die Fehlermeldung, die möglicherweise leer ist. |
lastRefreshTime
|
Ruft die Zeit ab, zu der die Daten zuletzt aktualisiert wurden. |
DataExecutionState (Datenausführungsstatus)
Eine Aufzählung der Datenausführungsstatus.
Enums | |
---|---|
DATA_EXECUTION_STATE_UNSPECIFIED
|
Standardwert, nicht verwenden. |
NOT_STARTED
|
Die Datenausführung hat nicht begonnen. |
RUNNING
|
Die Datenausführung hat begonnen und wird ausgeführt. |
SUCCEEDED
|
Die Datenausführung wurde erfolgreich abgeschlossen. |
FAILED
|
Die Datenausführung wurde mit Fehlern abgeschlossen. |
DataExecutionErrorCode
Eine Aufzählung des Fehlers beim Ausführen der Daten.
Enums | |
---|---|
DATA_EXECUTION_ERROR_CODE_UNSPECIFIED
|
Standardwert, nicht verwenden. |
TIMED_OUT
|
Zeitüberschreitung bei der Datenausführung. |
TOO_MANY_ROWS
|
Die Datenausführung gibt mehr Zeilen zurück als das Limit überschreitet. |
TOO_MANY_COLUMNS
|
Die Datenausführung gibt mehr Spalten zurück als das Limit überschreitet. |
TOO_MANY_CELLS
|
Bei der Datenausführung werden mehr Zellen zurückgegeben als das Limit erreicht ist. |
ENGINE
|
Die Fehlermeldung wird von der Back-End-Datenausführungs-Engine gesendet (z.B. BigQuery). Weitere Informationen finden Sie unter errorMessage .
|
PARAMETER_INVALID
|
Mindestens einer der angegebenen Parameter der Datenquelle ist ungültig. |
UNSUPPORTED_DATA_TYPE
|
Die Datenausführung gibt einen nicht unterstützten Datentyp zurück. |
DUPLICATE_COLUMN_NAMES
|
Beim Ausführen der Daten werden doppelte Spaltennamen oder Aliasse zurückgegeben. |
INTERRUPTED
|
Die Datenausführung wurde unterbrochen. Bitte aktualisieren Sie die Seite später. |
CONCURRENT_QUERY
|
Die Datenausführung läuft gerade und kann erst aktualisiert werden, wenn sie abgeschlossen ist. |
OTHER
|
Sonstige Fehler. |
TOO_MANY_CHARS_PER_CELL
|
Die Datenausführung gibt Werte zurück, die die maximal in einer einzelnen Zelle zulässigen Zeichen ü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 die Datenquelle verweist. |
MISSING_COLUMN_ALIAS
|
Die Datenausführung gibt Spalten mit fehlenden Aliassen zurück. |
OBJECT_NOT_FOUND
|
Das Datenquellenobjekt ist nicht vorhanden. |
OBJECT_IN_ERROR_STATE
|
Das Datenquellenobjekt hat derzeit einen Fehlerstatus. Wenn Sie die Aktualisierung erzwingen möchten, legen Sie in RefreshDataSourceRequest force fest.
|
OBJECT_SPEC_INVALID
|
Die Spezifikation des Datenquellenobjekts ist ungültig. |
Erweiterter Wert
Die Arten von Werten, die eine Zelle in einer Tabelle haben kann.
JSON-Darstellung |
---|
{ // Union field |
Felder | |
---|---|
Union-Feld value . Der Typ des Werts in einer Zelle. Wenn kein Feld festgelegt ist, enthält die Zelle keine Daten.
value darf nur einer der folgenden Werte sein:
|
|
numberValue
|
Ein Doppelwert. Hinweis: „Date“, „Time“ und „DateTimes“ werden als Doppelwerte im Format |
stringValue
|
Ein Stringwert Führende einfache Anführungszeichen sind nicht enthalten. Wenn der Nutzer beispielsweise |
boolValue
|
Ein boolescher Wert. |
formulaValue
|
Eine Formel. |
errorValue
|
Fehler. Dieses Feld ist schreibgeschützt. |
Fehlerwert
Fehler in der 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. Bitte nicht verwenden. |
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... .
|
Boolesche Bedingung
Eine Bedingung, die als „true“ oder „false“ ausgewertet werden kann. Boolesche Bedingungen werden von der bedingten Formatierung, der Datenvalidierung und den Kriterien in Filtern verwendet.
JSON-Darstellung |
---|
{ "type": enum ( |
Felder | |
---|---|
type
|
Der Bedingungstyp. |
values[]
|
Die Werte des Zustands. Die Anzahl der unterstützten Werte hängt von der |
Bedingungstyp
Der Bedingungstyp.
Enums | |
---|---|
CONDITION_TYPE_UNSPECIFIED
|
Der Standardwert, nicht verwenden. |
NUMBER_GREATER
|
Der Wert der Zelle muss größer als der Wert der Bedingung sein. Wird durch die Datenvalidierung, bedingte Formatierung und Filter unterstützt. Erfordert einen einzelnen ConditionValue .
|
NUMBER_GREATER_THAN_EQ
|
Der Wert der Zelle muss größer oder gleich dem Wert der Bedingung sein. Wird durch die Datenvalidierung, bedingte Formatierung und Filter unterstützt. Erfordert einen einzelnen ConditionValue .
|
NUMBER_LESS
|
Der Wert der Zelle muss kleiner als der Wert der Bedingung sein. Wird durch die Datenvalidierung, bedingte Formatierung und Filter unterstützt. Erfordert einen einzelnen ConditionValue .
|
NUMBER_LESS_THAN_EQ
|
Der Wert der Zelle muss kleiner oder gleich dem Wert der Bedingung sein. Wird durch die Datenvalidierung, bedingte Formatierung und Filter unterstützt. Erfordert einen einzelnen ConditionValue .
|
NUMBER_EQ
|
Der Wert der Zelle muss dem Wert der Bedingung entsprechen. Wird durch die Datenvalidierung, bedingte Formatierung und Filter unterstützt. Erfordert ein einzelnes ConditionValue für Datenvalidierung, bedingte Formatierung und Filter für Objekte, die nicht aus der Datenquelle stammen, und mindestens ein ConditionValue -Objekt für Filter von Datenquellenobjekten.
|
NUMBER_NOT_EQ
|
Der Wert der Zelle darf nicht mit dem Wert der Bedingung übereinstimmen. Wird durch die Datenvalidierung, bedingte Formatierung und Filter unterstützt. Erfordert ein einzelnes ConditionValue für Datenvalidierung, bedingte Formatierung und Filter für Objekte, die nicht aus der Datenquelle stammen, und mindestens ein ConditionValue -Objekt für Filter von Datenquellenobjekten.
|
NUMBER_BETWEEN
|
Der Wert der Zelle muss zwischen den beiden Bedingungswerten liegen. Wird durch die Datenvalidierung, bedingte Formatierung und Filter unterstützt. Erfordert genau zwei ConditionValues .
|
NUMBER_NOT_BETWEEN
|
Der Wert der Zelle darf nicht zwischen den beiden Bedingungswerten liegen. Wird durch die Datenvalidierung, bedingte Formatierung und Filter unterstützt. Erfordert genau zwei ConditionValues .
|
TEXT_CONTAINS
|
Der Wert der Zelle muss den Wert der Bedingung enthalten. Wird durch die Datenvalidierung, bedingte Formatierung und Filter unterstützt. Erfordert einen einzelnen ConditionValue .
|
TEXT_NOT_CONTAINS
|
Der Wert der Zelle darf nicht den Wert der Bedingung enthalten. Wird durch die Datenvalidierung, bedingte Formatierung und Filter unterstützt. Erfordert einen einzelnen ConditionValue .
|
TEXT_STARTS_WITH
|
Der Wert der Zelle muss mit dem Wert der Bedingung beginnen. Wird durch die bedingte Formatierung und Filter unterstützt Erfordert einen einzelnen ConditionValue .
|
TEXT_ENDS_WITH
|
Der Wert der Zelle muss mit dem Wert der Bedingung enden. Wird durch die bedingte Formatierung und Filter unterstützt Erfordert einen einzelnen ConditionValue .
|
TEXT_EQ
|
Der Wert in der Zelle muss genau dem Wert in der Bedingung entsprechen. Wird durch die Datenvalidierung, bedingte Formatierung und Filter unterstützt. Erfordert ein einzelnes ConditionValue für Datenvalidierung, bedingte Formatierung und Filter für Objekte, die nicht aus der Datenquelle stammen, und mindestens ein ConditionValue -Objekt für Filter von Datenquellenobjekten.
|
TEXT_IS_EMAIL
|
Der Wert der Zelle muss eine gültige E-Mail-Adresse sein. Dies wird von der Datenvalidierung unterstützt. Erfordert keine ConditionValues .
|
TEXT_IS_URL
|
Der Wert der Zelle muss eine gültige URL sein. Dies wird von der Datenvalidierung unterstützt. Erfordert keine ConditionValues .
|
DATE_EQ
|
Der Wert in der Zelle muss mit dem Wert in der Bedingung identisch sein. Wird durch die Datenvalidierung, bedingte Formatierung und Filter unterstützt. Erfordert ein einzelnes ConditionValue für Datenvalidierung, bedingte Formatierung und Filter für Objekte, die nicht aus der Datenquelle stammen, und mindestens ein ConditionValue -Objekt für Filter von Datenquellenobjekten.
|
DATE_BEFORE
|
Der Wert der Zelle muss vor dem Datum des Bedingungswerts liegen. Wird durch die Datenvalidierung, bedingte Formatierung und Filter unterstützt. Erfordert einen einzelnen ConditionValue , der ein relative date sein kann.
|
DATE_AFTER
|
Der Wert der Zelle muss nach dem Wert der Bedingung liegen. Wird durch die Datenvalidierung, bedingte Formatierung und Filter unterstützt. Erfordert einen einzelnen ConditionValue , der ein relative date sein kann.
|
DATE_ON_OR_BEFORE
|
Der Wert der Zelle muss dem Datum des Bedingungswerts entsprechen oder davor liegen. Dies wird von der Datenvalidierung unterstützt. Erfordert einen einzelnen ConditionValue , der ein relative date sein kann.
|
DATE_ON_OR_AFTER
|
Der Wert der Zelle muss dem Datum des Bedingungswerts entsprechen oder danach liegen. Dies wird von der Datenvalidierung unterstützt. Erfordert einen einzelnen ConditionValue , der ein relative date sein kann.
|
DATE_BETWEEN
|
Der Wert der Zelle muss zwischen den Datumsangaben der beiden Bedingungswerte liegen. Dies wird von der Datenvalidierung unterstützt. Erfordert genau zwei ConditionValues .
|
DATE_NOT_BETWEEN
|
Der Wert der Zelle muss außerhalb des Datums der beiden Bedingungswerte liegen. Dies wird von der Datenvalidierung unterstützt. Erfordert genau zwei ConditionValues .
|
DATE_IS_VALID
|
Der Wert in der Zelle muss ein Datum sein. Dies wird von der Datenvalidierung unterstützt. Erfordert keine ConditionValues .
|
ONE_OF_RANGE
|
Der Wert der Zelle muss im Raster im Bereich des Bedingungswerts aufgeführt werden. Dies wird von der Datenvalidierung unterstützt. Erfordert eine einzelne ConditionValue 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. Dies wird von der Datenvalidierung unterstützt. Unterstützt eine beliebige Anzahl von condition values -Werten, eine pro Element in der Liste. Formeln werden in den Werten nicht unterstützt.
|
BLANK
|
Der Wert in der Zelle muss leer sein. Wird durch die bedingte Formatierung und Filter unterstützt Erfordert keine ConditionValues .
|
NOT_BLANK
|
Der Wert in der Zelle darf nicht leer sein. Wird durch die bedingte Formatierung und Filter unterstützt Erfordert keine ConditionValues .
|
CUSTOM_FORMULA
|
Die Formel der Bedingung muss als „true“ ausgewertet werden. Wird durch die Datenvalidierung, bedingte Formatierung und Filter unterstützt. Wird in Filtern in Datenquellentabellen nicht unterstützt. Erfordert einen einzelnen ConditionValue .
|
BOOLEAN
|
Der Wert der Zelle muss WAHR/FALSCH oder in der Liste der Bedingungswerte stehen. Dies wird von der Datenvalidierung unterstützt. Wird als Kästchen für Zellen gerendert. Unterstützt null, eine oder zwei ConditionValues . Keine Werte bedeuten, dass die Zelle WAHR oder FALSCH sein muss, wobei WAHR als aktiviert dargestellt wird und FALSCH, wenn kein Häkchen gesetzt ist. Ein Wert bedeutet, dass die Zelle als aktiviert gerendert wird, wenn sie diesen Wert enthält, und deaktiviert, wenn sie leer ist. Zwei Werte bedeuten, dass die Zelle als aktiviert markiert wird, wenn sie den ersten Wert enthält, und deaktiviert, wenn sie den zweiten Wert enthält. [„Ja“,„Nein“] gibt beispielsweise an, dass die Zelle ein Kästchen rendert, wenn es den Wert „Ja“ hat, und kein Häkchen, wenn es den Wert „Nein“ hat.
|
TEXT_NOT_EQ
|
Der Wert in der Zelle muss genau mit dem Wert in der Bedingung übereinstimmen. Wird von Filtern für Datenquellenobjekte unterstützt. Erfordert mindestens eine ConditionValue .
|
DATE_NOT_EQ
|
Der Wert in der Zelle muss genau mit dem Wert in der Bedingung übereinstimmen. Wird von Filtern für Datenquellenobjekte unterstützt. Erfordert mindestens eine ConditionValue .
|
FILTER_EXPRESSION
|
Der Wert der Zelle muss dem angegebenen Muster entsprechen. Erfordert einen einzelnen ConditionValue .
|
Bedingungswert
Der Wert der Bedingung.
JSON-Darstellung |
---|
{ // Union field |
Felder | |
---|---|
Union-Feld value . Der Wert der Bedingung, es muss genau ein Wert festgelegt werden.
value darf nur einer der folgenden Werte sein:
|
|
relativeDate
|
Ein relatives Datum (basierend auf dem aktuellen Datum). Nur gültig, wenn Relative Daten werden bei der Datenvalidierung nicht unterstützt. Sie werden nur bei der bedingten Formatierung und bedingten Filtern unterstützt. |
userEnteredValue
|
Ein Wert, auf dem die Bedingung basiert. Der Wert wird so geparst, als ob der Nutzer in eine Zelle eingegeben hätte. Formeln werden unterstützt und müssen mit einem |
RelativeDate
Steuert, wie eine Bedingung vom Typ „Datum“ ausgewertet wird.
Enums | |
---|---|
RELATIVE_DATE_UNSPECIFIED
|
Standardwert, nicht verwenden. |
PAST_YEAR
|
Der Wert liegt ein Jahr vor dem heutigen Tag. |
PAST_MONTH
|
Der Wert liegt einen Monat vor dem heutigen Tag. |
PAST_WEEK
|
Der Wert liegt eine Woche vor dem heutigen Tag. |
YESTERDAY
|
Der Wert ist gestern. |
TODAY
|
Der Wert ist heute. |
TOMORROW
|
Der Wert ist morgen. |
Rasterbereich
Ein Bereich auf einem Tabellenblatt. Alle Indexe sind nullbasiert. Indexe sind halb offen, d.h., der Startindex ist inklusiv und der Endindex ist exklusiv – [startIndex, endIndex. Fehlende Indexe geben 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 dem Endindex entspricht, ist der Bereich leer. Leere Bereiche sind normalerweise nicht aussagekräftig und werden in der Regel als #REF!
gerendert.
JSON-Darstellung |
---|
{ "sheetId": integer, "startRowIndex": integer, "endRowIndex": integer, "startColumnIndex": integer, "endColumnIndex": integer } |
Felder | |
---|---|
sheetId
|
Das Tabellenblatt, in dem dieser Bereich angezeigt wird. |
startRowIndex
|
Die Startzeile (einschließlich) des Bereichs oder nicht festgelegt, wenn sie nicht begrenzt ist. |
endRowIndex
|
Die Endzeile (exklusiv) des Bereichs oder nicht festgelegt, wenn sie nicht begrenzt ist. |
startColumnIndex
|
Die Startspalte (einschließlich) des Bereichs oder nicht festgelegt, wenn sie nicht begrenzt ist. |
endColumnIndex
|
Die Endspalte (exklusiv) des Bereichs oder nicht festgelegt, wenn sie nicht begrenzt ist. |
SortOrder
Eine Sortierreihenfolge.
Enums | |
---|---|
SORT_ORDER_UNSPECIFIED
|
Standardwert, nicht verwenden. |
ASCENDING
|
Aufsteigend sortieren. |
DESCENDING
|
Absteigend sortieren. |
Filterspezifikation
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 einer der folgenden Werte sein:
|
|
columnIndex
|
Der nullbasierte Spaltenindex. |
dataSourceColumnReference
|
Verweist auf eine Datenquellenspalte. |
Filterkriterien
Kriterien zum Anzeigen/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. Sich gegenseitig mit |
visibleBackgroundColorStyle
|
Die Füllfarbe des Hintergrunds, nach der gefiltert werden soll. Es werden nur Zellen mit dieser Füllfarbe angezeigt. Dieses Feld und |
visibleForegroundColor
|
Die Farbe für den Vordergrund, nach der gefiltert werden soll. Es werden nur Zellen mit dieser Farbe im Vordergrund angezeigt. Sich gegenseitig mit |
visibleForegroundColorStyle
|
Die Farbe für den Vordergrund, nach der gefiltert werden soll. Es werden nur Zellen mit dieser Farbe im Vordergrund angezeigt. Dieses Feld und |
Sortierung
Eine Sortierreihenfolge, die mit einer bestimmten Spalte oder Zeile verknüpft ist.
JSON-Darstellung |
---|
{ "sortOrder": enum ( |
Felder | |
---|---|
sortOrder
|
Die Bestelldaten sollten sortiert werden. |
foregroundColor
|
Die Farbe für den Vordergrund, nach der sortiert werden soll. Zellen mit dieser Farbe im Vordergrund werden oben sortiert. Sich gegenseitig mit |
foregroundColorStyle
|
Die Farbe für den Vordergrund, nach der sortiert werden soll. Zellen mit dieser Farbe im Vordergrund 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. Sich gegenseitig 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 . Verweist auf die sortierte Dimension.
reference darf nur einer der folgenden Werte sein:
|
|
dimensionIndex
|
Die Dimension, auf die die Sortierung angewendet werden soll |
dataSourceColumnReference
|
Verweist auf eine Datenquellenspalte. |
Eingebettete Objektposition
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.
location darf nur einer der folgenden Werte sein:
|
|
sheetId
|
Das Tabellenblatt, in dem diese Option aktiviert ist. Legen Sie diese Einstellung nur fest, wenn sich das eingebettete Objekt in einem eigenen Tabellenblatt befindet. Darf nicht negativ sein. |
overlayPosition
|
Die Position, an der das Objekt über einem Raster liegt. |
newSheet
|
Bei „true“ wird das eingebettete Objekt auf einem neuen Tabellenblatt gespeichert, dessen ID für Sie ausgewählt wird. Wird nur beim Schreiben verwendet. |
Overlay-Position
Die Position, an der ein Objekt über einem Raster liegt.
JSON-Darstellung |
---|
{
"anchorCell": {
object (
|
Felder | |
---|---|
anchorCell
|
Die Zelle, in der das Objekt verankert ist. |
offsetXPixels
|
Der horizontale Abstand in Pixeln, in dem das Objekt von der Ankerzelle entfernt ist. |
offsetYPixels
|
Der vertikale Offset des Objekts in Pixeln, in dem das Objekt von der Ankerzelle entfernt ist. |
widthPixels
|
Die Breite des Objekts in Pixeln Der Standardwert ist 600. |
heightPixels
|
Höhe des Objekts in Pixeln Der Standardwert ist 371. |
Rasterkoordinaten
Eine Koordinate in einem Tabellenblatt Alle Indexe sind nullbasiert.
JSON-Darstellung |
---|
{ "sheetId": integer, "rowIndex": integer, "columnIndex": integer } |
Felder | |
---|---|
sheetId
|
Das Tabellenblatt, in dem diese Koordinaten angezeigt werden. |
rowIndex
|
Der Zeilenindex der Koordinate. |
columnIndex
|
Spaltenindex der Koordinate |