Other

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

number

Der Rotanteil der Farbe als Wert im Intervall [0, 1].

green

number

Der Grünanteil der Farbe als Wert im Intervall [0, 1].

blue

number

Der Blauanteil der Farbe als Wert im Intervall [0, 1].

alpha

number

Der Anteil dieser Farbe, der auf den Pixel angewendet werden soll. Die endgültige Pixelfarbe wird durch folgende Gleichung definiert:

pixel color = alpha * (this color) + (1.0 - alpha) * (background color)

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 kind can be only one of the following:
  "rgbColor": {
    object (Color)
  },
  "themeColor": enum (ThemeColorType)
  // End of list of possible types for union field kind.
}
Felder
Union-Feld kind. Die Art des Farbwerts. Für kind ist nur einer der folgenden Werte zulässig:
rgbColor

object (Color)

RGB-Farbe. Der Wert alpha im Objekt Color wird generell nicht unterstützt.

themeColor

enum (ThemeColorType)

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

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 (Color)
  },
  "foregroundColorStyle": {
    object (ColorStyle)
  },
  "fontFamily": string,
  "fontSize": integer,
  "bold": boolean,
  "italic": boolean,
  "strikethrough": boolean,
  "underline": boolean,
  "link": {
    object (Link)
  }
}
Felder
foregroundColor
(deprecated)

object (Color)

Vordergrundfarbe des Texts Eingestellt: Verwenden Sie foregroundColorStyle.

foregroundColorStyle

object (ColorStyle)

Vordergrundfarbe des Texts Wenn auch foregroundColor festgelegt ist, hat dieses Feld Vorrang.

fontFamily

string

Die Schriftfamilie.

fontSize

integer

Die Größe der Schriftart.

bold

boolean

„True“, wenn der Text fett ist.

italic

boolean

„True“, wenn der Text kursiv ist.

strikethrough

boolean

„True“, wenn der Text durchgestrichen ist.

underline

boolean

„True“, wenn der Text unterstrichen ist.

DataSourceColumn

Eine Spalte in einer Datenquelle.

JSON-Darstellung 
{
  "reference": {
    object (DataSourceColumnReference)
  },
  "formula": string
}
Felder
reference

object (DataSourceColumnReference)

Die Spaltenreferenz.

formula

string

Die Formel der berechneten Spalte.

DataSourceColumnReference

Eine eindeutige Kennung, die auf eine Datenquellenspalte verweist.

JSON-Darstellung 
{
  "name": string
}
Felder
name

string

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 (DataExecutionState),
  "errorCode": enum (DataExecutionErrorCode),
  "errorMessage": string,
  "lastRefreshTime": string
}
Felder
state

enum (DataExecutionState)

Der Status der Datenausführung.

errorCode

enum (DataExecutionErrorCode)

Der Fehlercode.

errorMessage

string

Die Fehlermeldung, die möglicherweise leer ist.

lastRefreshTime

string (Timestamp format)

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 value can be only one of the following:
  "numberValue": number,
  "stringValue": string,
  "boolValue": boolean,
  "formulaValue": string,
  "errorValue": {
    object (ErrorValue)
  }
  // End of list of possible types for union field value.
}
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

number

Stellt einen Double-Wert dar. Hinweis: Datum, Uhrzeit und DateTimes werden als Doubles im Format SERIAL_NUMBER dargestellt.

stringValue

string

Stellt einen Stringwert dar. Vorangestellte einfache Anführungszeichen werden nicht berücksichtigt. Wenn der Nutzer beispielsweise '123 in die Benutzeroberfläche eingegeben hat, wird dies als stringValue von "123" dargestellt.

boolValue

boolean

Stellt einen booleschen Wert dar.

formulaValue

string

Stellt eine Formel dar.

errorValue

object (ErrorValue)

Stellt einen Fehler dar. Dieses Feld ist schreibgeschützt.

ErrorValue

Fehler in einer Zelle.

JSON-Darstellung 
{
  "type": enum (ErrorType),
  "message": string
}
Felder
type

enum (ErrorType)

Die Art des Fehlers.

message

string

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 (ConditionType),
  "values": [
    {
      object (ConditionValue)
    }
  ]
}
Felder
type

enum (ConditionType)

Der Typ der Bedingung.

values[]

object (ConditionValue)

Die Werte der Bedingung. Die Anzahl der unterstützten Werte hängt von condition type ab. Einige unterstützen Nullwerte, andere einen oder zwei Werte und ConditionType.ONE_OF_LIST unterstützt eine beliebige Anzahl von Werten.

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 value can be only one of the following:
  "relativeDate": enum (RelativeDate),
  "userEnteredValue": string
  // End of list of possible types for union field value.
}
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

enum (RelativeDate)

Ein relatives Datum (basierend auf dem aktuellen Datum). Nur gültig, wenn type den Wert DATE_BEFORE, DATE_AFTER, DATE_ON_OR_BEFORE oder DATE_ON_OR_AFTER hat.

Relative Datumsangaben werden bei der Datenvalidierung nicht unterstützt. Sie werden nur bei bedingter Formatierung und bedingten Filtern unterstützt.

userEnteredValue

string

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 = oder Pluszeichen beginnen).

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

integer

Das Tabellenblatt, auf dem sich dieser Bereich befindet.

startRowIndex

integer

Die Startzeile (einschließlich) des Bereichs oder ist nicht festgelegt, wenn sie unbegrenzt ist.

endRowIndex

integer

Die Endzeile (exklusive) des Bereichs oder nicht festgelegt, wenn unbegrenzt.

startColumnIndex

integer

Die Startspalte (einschließlich) des Bereichs oder ist nicht festgelegt, wenn sie unbegrenzt ist.

endColumnIndex

integer

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 (FilterCriteria)
  },

  // Union field reference can be only one of the following:
  "columnIndex": integer,
  "dataSourceColumnReference": {
    object (DataSourceColumnReference)
  }
  // End of list of possible types for union field reference.
}
Felder
filterCriteria

object (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

integer

Der nullbasierte Spaltenindex.

dataSourceColumnReference

object (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 (BooleanCondition)
  },
  "visibleBackgroundColor": {
    object (Color)
  },
  "visibleBackgroundColorStyle": {
    object (ColorStyle)
  },
  "visibleForegroundColor": {
    object (Color)
  },
  "visibleForegroundColorStyle": {
    object (ColorStyle)
  }
}
Felder
hiddenValues[]

string

Werte, die ausgeblendet werden sollen.

condition

object (BooleanCondition)

Eine Bedingung, die erfüllt sein muss, damit Werte angezeigt werden. (hiddenValues wird dadurch nicht überschrieben – wenn ein Wert dort aufgeführt ist, ist er dennoch ausgeblendet.)

visibleBackgroundColor
(deprecated)

object (Color)

Die Füllfarbe des Hintergrunds, nach der gefiltert werden soll. Es werden nur Zellen mit dieser Füllfarbe angezeigt. Schließt sich mit visibleForegroundColor gegenseitig aus. Eingestellt: Verwenden Sie visibleBackgroundColorStyle.

visibleBackgroundColorStyle

object (ColorStyle)

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 gegenseitig aus und muss auf eine RGB-Farbe festgelegt werden. Wenn auch visibleBackgroundColor festgelegt ist, hat dieses Feld Vorrang.

visibleForegroundColor
(deprecated)

object (Color)

Vordergrundfarbe, nach der gefiltert werden soll. Es werden nur Zellen mit dieser Farbe angezeigt. Schließt sich mit visibleBackgroundColor gegenseitig aus. Eingestellt: Verwenden Sie visibleForegroundColorStyle.

visibleForegroundColorStyle

object (ColorStyle)

Vordergrundfarbe, nach der gefiltert werden soll. Es werden nur Zellen mit dieser Farbe angezeigt. Dieses Feld schließt sich mit visibleBackgroundColor gegenseitig aus und muss auf eine RGB-Farbe festgelegt werden. Wenn auch visibleForegroundColor festgelegt ist, hat dieses Feld Vorrang.

SortSpec

Eine Sortierreihenfolge, die einer bestimmten Spalte oder Zeile zugeordnet ist.

JSON-Darstellung 
{
  "sortOrder": enum (SortOrder),
  "foregroundColor": {
    object (Color)
  },
  "foregroundColorStyle": {
    object (ColorStyle)
  },
  "backgroundColor": {
    object (Color)
  },
  "backgroundColorStyle": {
    object (ColorStyle)
  },

  // Union field reference can be only one of the following:
  "dimensionIndex": integer,
  "dataSourceColumnReference": {
    object (DataSourceColumnReference)
  }
  // End of list of possible types for union field reference.
}
Felder
sortOrder

enum (SortOrder)

Die Bestelldaten sollten sortiert sein.

foregroundColor
(deprecated)

object (Color)

Vordergrundfarbe, nach der sortiert werden soll. Zellen mit dieser Vordergrundfarbe werden oben sortiert. Schließt sich mit backgroundColor gegenseitig aus. Eingestellt: Verwenden Sie foregroundColorStyle.

foregroundColorStyle

object (ColorStyle)

Vordergrundfarbe, nach der sortiert werden soll. Zellen mit dieser Vordergrundfarbe werden oben sortiert. Schließt sich mit backgroundColor gegenseitig aus und muss eine RGB-Farbe sein. Wenn auch foregroundColor festgelegt ist, hat dieses Feld Vorrang.

backgroundColor
(deprecated)

object (Color)

Die Füllfarbe des Hintergrunds, nach der sortiert werden soll. Zellen mit dieser Füllfarbe werden oben sortiert. Schließt sich mit foregroundColor gegenseitig aus. Eingestellt: Verwenden Sie backgroundColorStyle.

backgroundColorStyle

object (ColorStyle)

Die Füllfarbe des Hintergrunds, nach der sortiert werden soll. Zellen mit dieser Füllfarbe werden oben sortiert. Schließt sich mit foregroundColor gegenseitig aus und muss eine RGB-Farbe sein. Wenn auch backgroundColor festgelegt ist, hat dieses Feld Vorrang.

Union-Feld reference. Verweis auf die sortierte Dimension. Für reference ist nur einer der folgenden Werte zulässig:
dimensionIndex

integer

Die Dimension, auf die die Sortierung angewendet werden soll.

dataSourceColumnReference

object (DataSourceColumnReference)

Verweis auf eine Spalte in der Datenquelle.

EmbeddedObjectPosition

Die Position eines eingebetteten Objekts, z. B. eines Diagramms.

JSON-Darstellung 
{

  // Union field location can be only one of the following:
  "sheetId": integer,
  "overlayPosition": {
    object (OverlayPosition)
  },
  "newSheet": boolean
  // End of list of possible types for union field location.
}
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

integer

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

object (OverlayPosition)

Die Position, an der das Objekt das Raster überlagert.

newSheet

boolean

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 (GridCoordinate)
  },
  "offsetXPixels": integer,
  "offsetYPixels": integer,
  "widthPixels": integer,
  "heightPixels": integer
}
Felder
anchorCell

object (GridCoordinate)

Die Zelle, in der das Objekt verankert ist

offsetXPixels

integer

Der horizontale Versatz in Pixeln, um den das Objekt von der Ankerzelle entfernt ist.

offsetYPixels

integer

Der vertikale Abstand in Pixeln, um den das Objekt von der Ankerzelle entfernt ist.

widthPixels

integer

Die Breite des Objekts in Pixeln. Die Standardeinstellung ist 600.

heightPixels

integer

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

integer

Das Tabellenblatt, auf dem sich diese Koordinate befindet.

rowIndex

integer

Der Zeilenindex der Koordinate.

columnIndex

integer

Der Spaltenindex der Koordinate.