Other

Farbe

Ermöglicht die Darstellung einer Farbe im RGBA-Farbraum. Diese Darstellung ist kompakt und soll die Umwandlung in und aus Farbdarstellungen in verschiedenen Sprachen vereinfachen. Die Felder dieser Darstellung können beispielsweise ganz einfach dem Konstruktor von java.awt.Color in Java oder der +colorWithRed:green:blue:alpha-Methode von UIColor in iOS übergeben werden. Mit nur ein wenig Aufwand lässt sich daraus auch ein CSS-rgba()-String in JavaScript erstellen.

Diese Referenzseite enthält keine Informationen zum absoluten Farbraum, der zur Interpretation des RGB-Werts verwendet werden sollte, z. B. sRGB, Adobe RGB, DCI-P3 und BT.2020. Anwendungen sollten standardmäßig den Farbraum sRGB verwenden.

Wenn entschieden werden muss, ob zwei Farben gleich sind, behandeln Implementierungen, sofern nicht anders dokumentiert, zwei Farben als gleich, wenn sich alle Rot-, Grün-, Blau- und Alphawerte jeweils um höchstens 1e-5 unterscheiden.

Beispiel (Java): 

 import com.google.type.Color;

 // ...
 public static java.awt.Color fromProto(Color protocolor) {
   float alpha = protocolor.hasAlpha()
       ? protocolor.getAlpha().getValue()
       : 1.0;

   return new java.awt.Color(
       protocolor.getRed(),
       protocolor.getGreen(),
       protocolor.getBlue(),
       alpha);
 }

 public static Color toProto(java.awt.Color color) {
   float red = (float) color.getRed();
   float green = (float) color.getGreen();
   float blue = (float) color.getBlue();
   float denominator = 255.0;
   Color.Builder resultBuilder =
       Color
           .newBuilder()
           .setRed(red / denominator)
           .setGreen(green / denominator)
           .setBlue(blue / denominator);
   int alpha = color.getAlpha();
   if (alpha != 255) {
     result.setAlpha(
         FloatValue
             .newBuilder()
             .setValue(((float) alpha) / denominator)
             .build());
   }
   return resultBuilder.build();
 }
 // ...

Beispiel (iOS/Obj-C): 

 // ...
 static UIColor* fromProto(Color* protocolor) {
    float red = [protocolor red];
    float green = [protocolor green];
    float blue = [protocolor blue];
    FloatValue* alpha_wrapper = [protocolor alpha];
    float alpha = 1.0;
    if (alpha_wrapper != nil) {
      alpha = [alpha_wrapper value];
    }
    return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
 }

 static Color* toProto(UIColor* color) {
     CGFloat red, green, blue, alpha;
     if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
       return nil;
     }
     Color* result = [[Color alloc] init];
     [result setRed:red];
     [result setGreen:green];
     [result setBlue:blue];
     if (alpha <= 0.9999) {
       [result setAlpha:floatWrapperWithValue(alpha)];
     }
     [result autorelease];
     return result;
}
// ...

Beispiel (JavaScript): 

// ...

var protoToCssColor = function(rgbColor) {
   var redFrac = rgbColor.red || 0.0;
   var greenFrac = rgbColor.green || 0.0;
   var blueFrac = rgbColor.blue || 0.0;
   var red = Math.floor(redFrac * 255);
   var green = Math.floor(greenFrac * 255);
   var blue = Math.floor(blueFrac * 255);

   if (!('alpha' in rgbColor)) {
      return rgbToCssColor(red, green, blue);
   }

   var alphaFrac = rgbColor.alpha.value || 0.0;
   var rgbParams = [red, green, blue].join(',');
   return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
};

var rgbToCssColor = function(red, green, blue) {
  var rgbNumber = new Number((red << 16) | (green << 8) | blue);
  var hexString = rgbNumber.toString(16);
  var missingZeros = 6 - hexString.length;
  var resultBuilder = ['#'];
  for (var i = 0; i < missingZeros; i++) {
     resultBuilder.push('0');
  }
  resultBuilder.push(hexString);
  return resultBuilder.join('');
};

// ...
JSON-Darstellung 
{
  "red": number,
  "green": number,
  "blue": number,
  "alpha": number
}
Felder
red

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. Wenn nicht angegeben, wird das Farbobjekt als Volltonfarbe dargestellt (als ob für den Alphawert explizit 1,0 angegeben worden wäre).

ColorStyle

Ein Farbwert.

JSON-Darstellung 
{

  // Union field 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. kind darf nur einen der folgenden Werte haben:
rgbColor

object (Color)

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

themeColor

enum (ThemeColorType)

Designfarbe

ThemeColorType

Farbtypen des Designs

SpreadsheetProperties enthält eine SpreadsheetTheme, mit der diese Farbtypen des Designs konkreten Farben zugeordnet werden.

Enums
THEME_COLOR_TYPE_UNSPECIFIED Keine Designfarbe angegeben
TEXT Stellt die primäre Textfarbe dar
BACKGROUND Stellt die primäre Hintergrundfarbe dar
ACCENT1 Steht für die erste Akzentfarbe
ACCENT2 Stellt die zweite Akzentfarbe dar
ACCENT3 Stellt die dritte Akzentfarbe dar
ACCENT4 Stellt die vierte Akzentfarbe dar
ACCENT5 Steht für die fünfte Akzentfarbe
ACCENT6 Stellt die sechste Akzentfarbe dar

HorizontalAlign

Die horizontale Ausrichtung von Text in einer Zelle.

Enums
HORIZONTAL_ALIGN_UNSPECIFIED Die horizontale Ausrichtung ist nicht angegeben. Verwenden Sie diese Option nicht.
LEFT Der Text ist explizit linksbündig ausgerichtet.
CENTER Der Text ist explizit auf die Mitte der Zelle ausgerichtet.
RIGHT Der Text ist explizit rechts von der Zelle ausgerichtet.

TextFormat

Das Format eines Textblocks in einer Zelle. Fehlende Werte geben an, dass das Feld nicht angegeben ist.

JSON-Darstellung 
{
  "foregroundColor": {
    object (Color)
  },
  "foregroundColorStyle": {
    object (ColorStyle)
  },
  "fontFamily": string,
  "fontSize": integer,
  "bold": boolean,
  "italic": boolean,
  "strikethrough": boolean,
  "underline": boolean,
  "link": {
    object (Link)
  }
}
Felder
foregroundColor
(deprecated)

object (Color)

Die Vordergrundfarbe des Textes. Verworfen: Verwenden Sie stattdessen foregroundColorStyle.

foregroundColorStyle

object (ColorStyle)

Die Vordergrundfarbe des Textes. Wenn foregroundColor ebenfalls festgelegt ist, hat dieses Feld Vorrang.

fontFamily

string

Die Schriftfamilie.

fontSize

integer

Die Schriftgröße.

bold

boolean

„Wahr“, wenn der Text fett formatiert 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

Spalte in einer Datenquelle.

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

object (DataSourceColumnReference)

Der Spaltenbezug.

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. Er muss innerhalb einer Datenquelle eindeutig sein.

DataExecutionStatus

Der Ausführungsstatus der Daten.

Eine Datenausführung wird erstellt, um ein Datenquellenobjekt mit den neuesten Daten aus einem DataSource zu synchronisieren. Normalerweise wird es im Hintergrund ausgeführt. Sie können anhand des Status state prüfen, ob eine Ausführung abgeschlossen ist.

Es gibt mehrere Szenarien, in denen eine Datenausführung ausgelöst wird:

  • Adding a data source erstellt eine zugehörige Datenquelle und eine Datenausführung, um die Daten aus der Datenquelle mit dem Tabellenblatt zu synchronisieren.
  • 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 (DataExecutionState),
  "errorCode": enum (DataExecutionErrorCode),
  "errorMessage": string,
  "lastRefreshTime": string
}
Felder
state

enum (DataExecutionState)

Der Status der Datenausführung.

errorCode

enum (DataExecutionErrorCode)

Den Fehlercode.

errorMessage

string

Die Fehlermeldung. Diese ist möglicherweise leer.

lastRefreshTime

string (Timestamp format)

Gibt an, wann die Daten zuletzt erfolgreich aktualisiert wurden.

DataExecutionState

Eine Aufzählung der Status der Datenausführung.

Enums
DATA_EXECUTION_STATE_UNSPECIFIED Standardwert, nicht verwenden
NOT_STARTED Die Datenausführung wurde nicht gestartet.
RUNNING Die Datenausführung wurde gestartet und ist aktiv.
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 für die Datenausführung.

Enums
DATA_EXECUTION_ERROR_CODE_UNSPECIFIED Standardwert, nicht verwenden.
TIMED_OUT Zeitüberschreitung bei der Datenausführung.
TOO_MANY_ROWS Bei der Datenausführung werden mehr Zeilen zurückgegeben als das Limit.
TOO_MANY_COLUMNS Beim Ausführen der Daten werden mehr Spalten als das Limit zurückgegeben.
TOO_MANY_CELLS Beim Ausführen der Daten werden mehr Zellen als das Limit zurückgegeben.
ENGINE Fehler wird von der Back-End-Daten-Ausführungs-Engine (z.B. BigQuery) empfangen. Weitere Informationen finden Sie unter errorMessage.
PARAMETER_INVALID 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 wurden doppelte Spaltennamen oder Aliasse zurückgegeben.
INTERRUPTED Die Datenausführung wird unterbrochen. Bitte aktualisieren Sie die Seite später.
CONCURRENT_QUERY Die Daten werden gerade ausgeführt und können erst aktualisiert werden, wenn sie abgeschlossen ist.
OTHER Andere Fehler
TOO_MANY_CHARS_PER_CELL Beim Ausführen der Daten werden Werte zurückgegeben, die die maximal zulässige Anzahl an Zeichen in einer einzelnen Zelle überschreiten.
DATA_NOT_FOUND Die Datenbank, auf die von der Datenquelle verwiesen wird, wurde nicht gefunden. */
PERMISSION_DENIED Der Nutzer hat keinen Zugriff auf die Datenbank, auf die in der Datenquelle verwiesen wird.
MISSING_COLUMN_ALIAS Beim Ausführen der Daten werden Spalten mit fehlenden Aliassen zurückgegeben.
OBJECT_NOT_FOUND Das Datenquellenobjekt ist nicht vorhanden.
OBJECT_IN_ERROR_STATE Das Datenquellenobjekt befindet sich derzeit im Fehlerstatus. Wenn Sie eine Aktualisierung erzwingen möchten, legen Sie force in RefreshDataSourceRequest fest.
OBJECT_SPEC_INVALID Die Datenquellenobjektspezifikation ist ungültig.
DATA_EXECUTION_CANCELLED Die Datenausführung wurde abgebrochen.

ExtendedValue

Die Arten von Werten, die eine Zelle in einer Tabelle haben kann.

JSON-Darstellung 
{

  // Union field 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 Typ des Werts in einer Zelle. Wenn kein Feld festgelegt ist, enthält die Zelle keine Daten. value darf nur einen der folgenden Werte haben:
numberValue

number

Stellt einen Double-Wert dar. Hinweis: Datumsangaben, Uhrzeiten und Datumsangaben mit Uhrzeit werden als Doppeltzahlen im Format SERIAL_NUMBER dargestellt.

stringValue

string

Stellt einen Stringwert dar. Anführende einfache Anführungszeichen sind nicht enthalten. Wenn der Nutzer beispielsweise '123 in die Benutzeroberfläche eingibt, 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

Ein Fehler in einer Zelle.

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

enum (ErrorType)

Die Art des Fehlers.

message

string

Eine Nachricht mit weiteren Informationen zum Fehler (in der Sprache der Tabelle).

ErrorType

Die Art des Fehlers.

Enums
ERROR_TYPE_UNSPECIFIED Der Standardfehlertyp, sollte nicht verwendet werden.
ERROR Entspricht dem Fehler #ERROR!.
NULL_VALUE Entspricht dem Fehler #NULL!.
DIVIDE_BY_ZERO Entspricht dem Fehler #DIV/0.
VALUE Entspricht dem Fehler #VALUE!.
REF Entspricht dem Fehler #REF!.
NAME Entspricht dem Fehler #NAME?.
NUM Entspricht dem Fehler #NUM!.
N_A Entspricht dem Fehler #N/A.
LOADING Entspricht dem Status Loading....

BooleanCondition

Eine Bedingung, die als „wahr“ oder „falsch“ ausgewertet werden kann. BoolescheBedingungen 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 Standardwert, nicht verwenden.
NUMBER_GREATER Der Wert der Zelle muss größer als der Wert der Bedingung sein. Unterstützt durch Datenvalidierung, bedingte Formatierung und Filter. Erfordert eine einzelne ConditionValue.
NUMBER_GREATER_THAN_EQ Der Wert der Zelle muss größer oder gleich dem Wert der Bedingung sein. Unterstützt durch Datenvalidierung, bedingte Formatierung und Filter. Erfordert eine einzelne ConditionValue.
NUMBER_LESS Der Wert der Zelle muss kleiner als der Wert der Bedingung sein. Unterstützt durch Datenvalidierung, bedingte Formatierung und Filter. Erfordert eine einzelne ConditionValue.
NUMBER_LESS_THAN_EQ Der Wert der Zelle muss kleiner oder gleich dem Wert der Bedingung sein. Unterstützt durch Datenvalidierung, bedingte Formatierung und Filter. Erfordert eine einzelne ConditionValue.
NUMBER_EQ Der Wert der Zelle muss mit dem Wert der Bedingung übereinstimmen. Unterstützt durch Datenvalidierung, bedingte Formatierung und Filter. Für die Datenvalidierung, die bedingte Formatierung und Filter auf Objekten, die keine Datenquellen sind, ist ein einzelnes ConditionValue erforderlich. Für Filter auf Datenquellenobjekten ist mindestens ein ConditionValue erforderlich.
NUMBER_NOT_EQ Der Wert der Zelle darf nicht dem Wert der Bedingung entsprechen. Unterstützt durch Datenvalidierung, bedingte Formatierung und Filter. Für die Datenvalidierung, die bedingte Formatierung und Filter auf Objekten, die keine Datenquellen sind, ist ein einzelnes ConditionValue erforderlich. Für Filter auf Datenquellenobjekten ist mindestens ein ConditionValue erforderlich.
NUMBER_BETWEEN Der Wert der Zelle muss zwischen den beiden Bedingungswerten liegen. Unterstützt durch Datenvalidierung, bedingte Formatierung und Filter. 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. Es sind genau zwei ConditionValues erforderlich.
TEXT_CONTAINS Der Wert der Zelle muss den Wert der Bedingung enthalten. Unterstützt durch Datenvalidierung, bedingte Formatierung und Filter. Erfordert eine einzelne ConditionValue.
TEXT_NOT_CONTAINS Der Wert der Zelle darf nicht den Wert der Bedingung enthalten. Unterstützt durch Datenvalidierung, bedingte Formatierung und Filter. Erfordert eine einzelne ConditionValue.
TEXT_STARTS_WITH Der Wert der Zelle muss mit dem Wert der Bedingung beginnen. Unterstützt durch bedingte Formatierung und Filter. Erfordert eine einzelne ConditionValue.
TEXT_ENDS_WITH Der Wert der Zelle muss mit dem Wert der Bedingung enden. Unterstützt durch bedingte Formatierung und Filter. Erfordert eine einzelne ConditionValue.
TEXT_EQ Der Wert der Zelle muss genau mit dem Wert der Bedingung übereinstimmen. Unterstützt durch Datenvalidierung, bedingte Formatierung und Filter. Für die Datenvalidierung, die bedingte Formatierung und Filter auf Objekten, die keine Datenquellen sind, ist ein einzelnes ConditionValue erforderlich. Für Filter auf Datenquellenobjekten ist mindestens ein ConditionValue erforderlich.
TEXT_IS_EMAIL Der Wert der Zelle muss eine gültige E-Mail-Adresse sein. Unterstützt durch Datenvalidierung. Erfordert keine ConditionValues.
TEXT_IS_URL Der Wert der Zelle muss eine gültige URL sein. Unterstützt durch Datenvalidierung. Erfordert keine ConditionValues.
DATE_EQ Der Wert der Zelle muss mit dem Wert der Bedingung übereinstimmen. Unterstützt durch Datenvalidierung, bedingte Formatierung und Filter. Für die Datenvalidierung, die bedingte Formatierung und Filter auf Objekten, die keine Datenquellen sind, ist ein einzelnes ConditionValue erforderlich. Für Filter auf Datenquellenobjekten ist mindestens ein ConditionValue erforderlich.
DATE_BEFORE Der Wert der Zelle muss vor dem Datum des Werts der Bedingung liegen. Unterstützt durch Datenvalidierung, bedingte Formatierung und Filter. Erfordert eine einzelne ConditionValue, die ein relative date sein kann.
DATE_AFTER Der Wert der Zelle muss nach dem Datum des Werts der Bedingung liegen. Unterstützt durch Datenvalidierung, bedingte Formatierung und Filter. Erfordert eine einzelne ConditionValue, die ein relative date sein kann.
DATE_ON_OR_BEFORE Der Wert der Zelle muss vor oder am Datum des Werts der Bedingung liegen. Unterstützt durch Datenvalidierung. Erfordert eine einzelne ConditionValue, die eine relative date sein kann.
DATE_ON_OR_AFTER Der Wert der Zelle muss dem Datum des Bedingungswerts entsprechen oder danach liegen. Unterstützt durch Datenvalidierung. Erfordert eine einzelne ConditionValue, die eine relative date sein kann.
DATE_BETWEEN Der Wert der Zelle muss zwischen den beiden Datumsangaben liegen. Unterstützt durch Datenvalidierung. Es sind genau zwei ConditionValues erforderlich.
DATE_NOT_BETWEEN Der Wert der Zelle muss außerhalb der beiden Datumswerte liegen. Unterstützt durch Datenvalidierung. 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. Es ist nur ein einzelnes ConditionValue zulässig und der Wert muss ein gültiger Bereich in A1-Notation sein.
ONE_OF_LIST Der Wert der Zelle muss in der Liste der Bedingungswerte enthalten sein. Unterstützt durch Datenvalidierung. Unterstützt eine beliebige Anzahl von condition values, eine pro Element in der Liste. Formeln werden in den Werten nicht unterstützt.
BLANK Der Wert der Zelle muss leer sein. Unterstützt durch bedingte Formatierung und Filter. Erfordert kein ConditionValues.
NOT_BLANK Der Wert der Zelle darf nicht leer sein. Unterstützt durch bedingte Formatierung und Filter. Erfordert kein ConditionValues.
CUSTOM_FORMULA Die Formel der Bedingung muss als wahr ausgewertet werden. Unterstützt durch Datenvalidierung, bedingte Formatierung und Filter. Wird von Tabellenfiltern für Datenquellen nicht unterstützt. Erfordert eine einzelne ConditionValue.
BOOLEAN Der Wert der Zelle muss WAHR/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. Wenn keine Werte angegeben sind, muss die Zelle TRUE oder FALSE enthalten. TRUE wird als angeklickt und FALSE als nicht angeklickt dargestellt. Ein Wert gibt an, dass die Zelle als überprüft gerendert wird, wenn sie diesen Wert enthält, und deaktiviert, wenn sie leer ist. Zwei Werte geben an, dass die Zelle angeklickt dargestellt wird, wenn sie den ersten Wert enthält, und nicht angeklickt, wenn sie den zweiten Wert enthält. Beispiel: [„Ja“, „Nein“] gibt an, 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 darf nicht genau mit dem Wert der Bedingung übereinstimmen. Unterstützt durch Filter für Datenquellenobjekte. Es ist mindestens ein ConditionValue erforderlich.
DATE_NOT_EQ Der Wert der Zelle darf nicht genau mit dem Wert der Bedingung übereinstimmen. Unterstützt durch Filter für Datenquellenobjekte. Es ist mindestens ein ConditionValue erforderlich.
FILTER_EXPRESSION Der Wert der Zelle muss dem angegebenen Muster entsprechen. Erfordert eine einzelne ConditionValue.

ConditionValue

Der Wert der Bedingung.

JSON-Darstellung 
{

  // Union field 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 einer festgelegt werden. Für value ist nur einer der folgenden Werte zulässig:
relativeDate

enum (RelativeDate)

Ein relatives Datum (basierend auf dem aktuellen Datum). Gültig nur, wenn type DATE_BEFORE, DATE_AFTER, DATE_ON_OR_BEFORE oder DATE_ON_OR_AFTER ist.

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

userEnteredValue

string

Ein Wert, auf dem die Bedingung basiert. Der Wert wird so analysiert, als hätte der Nutzer ihn in eine Zelle eingegeben. Formeln werden unterstützt und müssen mit einem = oder einem „+“ beginnen.

RelativeDate

Hiermit wird festgelegt, wie eine Datumsbedingung ausgewertet wird.

Enums
RELATIVE_DATE_UNSPECIFIED Standardwert, nicht verwenden
PAST_YEAR Der Wert entspricht dem Datum vor einem Jahr.
PAST_MONTH Der Wert bezieht sich auf einen Monat vor dem heutigen Tag.
PAST_WEEK Der Wert bezieht sich auf eine Woche vor dem heutigen Tag.
YESTERDAY Der Wert ist „gestern“.
TODAY Der Wert ist „heute“.
TOMORROW Der Wert ist morgen.

GridRange

Einen Bereich in einer Tabelle. Alle Indexe beginnen bei null. Die Indexe sind halboffen, d.h. der Startindex ist einschließend und der Endindex ist ausschließend: [startIndex, endIndex]. Fehlende Indexe weisen darauf hin, dass der Bereich auf dieser Seite nicht begrenzt ist.

Wenn "Sheet1" beispielsweise die Tabellenblatt-ID 123456 hat, 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 darf nicht größer sein als der Endindex. Wenn der Startindex mit dem Endindex übereinstimmt, ist der Bereich leer. Leere Bereiche sind in der Regel nicht aussagekräftig und werden in der Benutzeroberfläche normalerweise als #REF! dargestellt.

JSON-Darstellung 
{
  "sheetId": integer,
  "startRowIndex": integer,
  "endRowIndex": integer,
  "startColumnIndex": integer,
  "endColumnIndex": integer
}
Felder
sheetId

integer

Das Tabellenblatt, in dem sich der Bereich befindet.

startRowIndex

integer

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

endRowIndex

integer

Die Endzeile (exklusiv) des Bereichs oder nicht festgelegt, wenn er nicht begrenzt ist.

startColumnIndex

integer

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

endColumnIndex

integer

Die Endspalte (exklusiv) des Bereichs oder nicht festgelegt, wenn der Bereich nicht begrenzt ist.

SortOrder

Eine Sortierreihenfolge.

Enums
SORT_ORDER_UNSPECIFIED Standardwert, nicht verwenden.
ASCENDING Sortieren Sie die Spalte aufsteigend.
DESCENDING Sortieren Sie die Daten absteigend.

FilterSpec

Die Filterkriterien, die mit einer bestimmten Spalte verknüpft 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. reference darf nur einen der folgenden Werte haben:
columnIndex

integer

Der nullbasierte Spaltenindex.

dataSourceColumnReference

object (DataSourceColumnReference)

Verweis auf eine Datenquellenspalte.

FilterCriteria

Kriterien zum Ein-/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 sollten.

condition

object (BooleanCondition)

Eine Bedingung, die erfüllt sein muss, damit Werte angezeigt werden. hiddenValues wird dadurch nicht überschrieben. Wenn dort ein Wert aufgeführt ist, wird er weiterhin ausgeblendet.

visibleBackgroundColor
(deprecated)

object (Color)

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

visibleBackgroundColorStyle

object (ColorStyle)

Die Hintergrundfüllungsfarbe, 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)

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

visibleForegroundColorStyle

object (ColorStyle)

Die Vordergrundfarbe, nach der gefiltert werden soll. Es werden nur Zellen mit dieser Vordergrundfarbe angezeigt. Dieses Feld und visibleBackgroundColor schließen sich gegenseitig aus und müssen auf eine RGB-Farbe festgelegt werden. Wenn visibleForegroundColor ebenfalls festgelegt ist, hat dieses Feld Vorrang.

SortSpec

Eine Sortierreihenfolge, die mit einer bestimmten Spalte oder Zeile verknüpft 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)

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

foregroundColorStyle

object (ColorStyle)

Die Vordergrundfarbe, nach der sortiert werden soll. Zellen mit dieser Vordergrundfarbe werden nach oben sortiert. Ist mit backgroundColor nicht kompatibel 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 gegenseitig mit foregroundColor aus. Verworfen: Verwenden Sie stattdessen backgroundColorStyle.

backgroundColorStyle

object (ColorStyle)

Die Hintergrundfüllungsfarbe, nach der sortiert werden soll. Zellen mit dieser Füllungsfarbe werden an den Anfang sortiert. Ist mit foregroundColor nicht kompatibel und muss eine RGB-Farbe sein. Wenn auch backgroundColor festgelegt ist, hat dieses Feld Vorrang.

Union-Feld reference. Verweis auf die sortierte Dimension. reference darf nur einen der folgenden Werte haben:
dimensionIndex

integer

Die Dimension, auf die die Sortierung angewendet werden soll.

dataSourceColumnReference

object (DataSourceColumnReference)

Verweis auf eine Datenquellenspalte.

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 Standort des Objekts. Es muss genau ein Wert festgelegt werden. Für location ist nur einer der folgenden Werte zulässig:
sheetId

integer

Das Tabellenblatt, in dem sich die Funktion befindet. Wird nur festgelegt, wenn sich das eingebettete Objekt auf einem eigenen Tabellenblatt befindet. Darf nicht negativ sein.

overlayPosition

object (OverlayPosition)

Die Position, an der das Objekt auf einem Raster überlagert wird.

newSheet

boolean

Bei Einstellung auf „true“ wird das eingebettete Objekt auf einem neuen Tabellenblatt abgelegt, dessen ID für Sie ausgewählt wird. Wird nur beim Schreiben verwendet.

OverlayPosition

Die Position eines Objekts wird auf einem Raster eingeblendet.

JSON-Darstellung 
{
  "anchorCell": {
    object (GridCoordinate)
  },
  "offsetXPixels": integer,
  "offsetYPixels": integer,
  "widthPixels": integer,
  "heightPixels": integer
}
Felder
anchorCell

object (GridCoordinate)

Die Zelle, an der das Objekt verankert ist.

offsetXPixels

integer

Der horizontale Abstand in Pixeln, um den das Objekt von der Ankerzelle versetzt ist.

offsetYPixels

integer

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

widthPixels

integer

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

heightPixels

integer

Die Höhe des Objekts in Pixeln. Standardmäßig ist 371 festgelegt.

GridCoordinate

Eine Koordinate in einer Tabelle. Alle Indexe beginnen bei null.

JSON-Darstellung 
{
  "sheetId": integer,
  "rowIndex": integer,
  "columnIndex": integer
}
Felder
sheetId

integer

Das Tabellenblatt, auf dem sich diese Koordinate befindet.

rowIndex

integer

Der Zeilenindex der Koordinate.

columnIndex

integer

Der Spaltenindex der Koordinate.