Other

Farbe

Ermöglicht die Darstellung einer Farbe im RGBA-Farbraum. Diese Darstellung ist auf eine einfache Konvertierung in und aus Farbdarstellungen in verschiedenen Sprachen ausgelegt und nicht auf Kompaktheit. Die Felder dieser Darstellung können beispielsweise in Java trivial an den Konstruktor von java.awt.Color übergeben werden. In iOS können sie auch trivial an die Methode +colorWithRed:green:blue:alpha von UIColor übergeben werden. Mit nur wenig Aufwand können sie in JavaScript in einen CSS-rgba()-String formatiert werden.

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 sRGB-Farbraum verwenden.

Wenn entschieden werden muss, ob zwei Farben gleich sind, behandeln Implementierungen, sofern nicht anders dokumentiert, zwei Farben als gleich, wenn sich alle ihre Rot-, Grün-, Blau- und Alphawerte 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 solide Farbe 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. Für kind ist nur einer der folgenden Werte zulässig:
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 enthalten eine SpreadsheetTheme , die eine Zuordnung dieser Designfarbentypen zu konkreten Farben definiert.

Enums
THEME_COLOR_TYPE_UNSPECIFIED Nicht angegebene Designfarbe
TEXT Stellt die primäre Textfarbe dar.
BACKGROUND Stellt die primäre Hintergrundfarbe dar.
ACCENT1 Stellt die erste Akzentfarbe dar
ACCENT2 Stellt die zweite Akzentfarbe dar
ACCENT3 Stellt die dritte Akzentfarbe dar
ACCENT4 Stellt die vierte Akzentfarbe dar
ACCENT5 Stellt die fünfte Akzentfarbe dar
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. Nicht verwenden.
LEFT Der Text wird explizit links in der Zelle ausgerichtet.
CENTER Der Text wird explizit in der Mitte der Zelle ausgerichtet.
RIGHT Der Text wird explizit rechtsbündig ausgerichtet.

TextFormat

Das Format eines Textabschnitts 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 Texts. Verworfen: Verwenden Sie foregroundColorStyle.

foregroundColorStyle

object (ColorStyle)

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

fontFamily

string

Die Schriftfamilie.

fontSize

integer

Die Größe der Schrift.

bold

boolean

„True“, wenn der Text fett formatiert ist.

italic

boolean

„True“, wenn der Text kursiv formatiert 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)

Der Spaltenverweis.

formula

string

Die Formel der berechneten Spalte.

DataSourceColumnReference

Eine eindeutige Kennung, die auf eine Spalte der Datenquelle verweist.

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

string

Der Anzeigename der Spalte. Sie 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 zu synchronisieren. Sie wird in der Regel im Hintergrund ausgeführt. Sie können im state nachsehen, ob die Ausführung abgeschlossen ist.

Es gibt verschiedene Szenarien, in denen die Ausführung von Daten ausgelöst wird:

  • Adding a data source erstellt ein zugehöriges Datenquellenblatt sowie eine Datenausführung, um die Daten aus der Datenquelle mit dem Blatt 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 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)

Gibt den Zeitpunkt zurück, zu dem die Daten zuletzt erfolgreich aktualisiert wurden.

DataExecutionState

Eine Aufzählung von Datenausführungsstatus.

Enums
DATA_EXECUTION_STATE_UNSPECIFIED Standardwert, nicht verwenden.
NOT_STARTED Die Datenausführung wurde noch nicht gestartet.
RUNNING Die Datenausführung wurde gestartet und wird ausgeführt.
CANCELLING Die Datenausführung wird derzeit abgebrochen.
SUCCEEDED Die Datenverarbeitung wurde erfolgreich abgeschlossen.
FAILED Die Ausführung der Daten 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 Ausführung der Datenabfrage.
TOO_MANY_ROWS Bei der Datenausführung werden mehr Zeilen als das Limit zurückgegeben.
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 Der Fehler wird von der Backend-Engine für die Datenausführung (z.B. BigQuery) zurückgegeben. Weitere Informationen finden Sie unter errorMessage.
PARAMETER_INVALID Einer oder mehrere der angegebenen Datenquellenparameter sind 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 aktualisieren Sie die Seite später.
CONCURRENT_QUERY Die Datenausführung läuft derzeit und kann 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 von 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 ohne Alias zurückgegeben.
OBJECT_NOT_FOUND Das Datenquellenobjekt ist nicht vorhanden.
OBJECT_IN_ERROR_STATE Bei dem Datenquellenobjekt liegt derzeit ein Fehler vor. Wenn Sie eine Aktualisierung erzwingen möchten, legen Sie force in RefreshDataSourceRequest fest.
OBJECT_SPEC_INVALID Die Spezifikation des Datenquellenobjekts ist ungültig.
DATA_EXECUTION_CANCELLED Die Datenausführung wurde abgebrochen.

ExtendedValue

Die Arten von Werten, die eine Zelle in einer Tabelle enthalten 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. Für value ist nur einer der folgenden Werte zulässig:
numberValue

number

Stellt einen Double-Wert dar. Hinweis: Datumsangaben, Uhrzeiten und Datums-/Uhrzeitangaben werden als Gleitkommazahlen im SERIAL_NUMBER-Format dargestellt.

stringValue

string

Stellt einen Stringwert dar. Vorangestellte einfache Anführungszeichen sind nicht enthalten. 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

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. 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....

BooleanCondition

Eine Bedingung, die als „true“ oder „false“ ausgewertet werden kann. BooleanConditions 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 ein oder zwei Werte und ConditionType.ONE_OF_LIST 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 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. Erfordert ein einzelnes ConditionValue für die Datenvalidierung, die bedingte Formatierung und Filter für Nicht-Datenquellenobjekte sowie mindestens ein ConditionValue für Filter für Datenquellenobjekte.
NUMBER_NOT_EQ Der Wert der Zelle darf nicht mit dem Wert der Bedingung übereinstimmen. Unterstützt durch Datenvalidierung, bedingte Formatierung und Filter. Erfordert ein einzelnes ConditionValue für die Datenvalidierung, die bedingte Formatierung und Filter für Nicht-Datenquellenobjekte sowie mindestens ein 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. Es sind genau zwei ConditionValues erforderlich.
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 den Wert der Bedingung nicht 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. Wird von bedingter Formatierung und Filtern unterstützt. Erfordert eine einzelne ConditionValue.
TEXT_ENDS_WITH Der Wert der Zelle muss mit dem Wert der Bedingung enden. Wird von bedingter Formatierung und Filtern unterstützt. Erfordert eine einzelne ConditionValue.
TEXT_EQ Der Wert der Zelle muss genau dem Wert der Bedingung entsprechen. Unterstützt durch Datenvalidierung, bedingte Formatierung und Filter. Erfordert ein einzelnes ConditionValue für die Datenvalidierung, die bedingte Formatierung und Filter für Nicht-Datenquellenobjekte sowie mindestens ein ConditionValue für Filter für Datenquellenobjekte.
TEXT_IS_EMAIL Der Wert der Zelle muss eine gültige E‑Mail-Adresse sein. Durch Datenvalidierung unterstützt. Erfordert keine ConditionValues.
TEXT_IS_URL Der Wert der Zelle muss eine gültige URL sein. Durch Datenvalidierung unterstützt. Erfordert keine ConditionValues.
DATE_EQ Der Wert der Zelle muss dasselbe Datum wie der Wert der Bedingung haben. Unterstützt durch Datenvalidierung, bedingte Formatierung und Filter. Erfordert ein einzelnes ConditionValue für die Datenvalidierung, die bedingte Formatierung und Filter für Nicht-Datenquellenobjekte sowie mindestens ein ConditionValue für Filter für Datenquellenobjekte.
DATE_BEFORE Der Wert der Zelle muss vor dem Datum des Werts der Bedingung liegen. Unterstützt durch Datenvalidierung, bedingte Formatierung und Filter. Erfordert einen einzelnen ConditionValue, der 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 einen einzelnen ConditionValue, der ein relative date sein kann.
DATE_ON_OR_BEFORE Der Wert der Zelle muss am oder vor dem Datum des Werts der Bedingung liegen. Durch 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. Durch 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. Durch Datenvalidierung unterstützt. Es sind genau zwei ConditionValues erforderlich.
DATE_NOT_BETWEEN Der Wert der Zelle muss außerhalb der Datumsangaben der beiden Bedingungswerte liegen. Durch Datenvalidierung unterstützt. Es sind genau zwei ConditionValues erforderlich.
DATE_IS_VALID Der Wert der Zelle muss ein Datum sein. Durch Datenvalidierung unterstützt. Erfordert keine ConditionValues.
ONE_OF_RANGE Der Wert der Zelle muss im Bereich des Bedingungswerts im Raster aufgeführt sein. Durch Datenvalidierung unterstützt. Erfordert einen einzelnen 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. Durch Datenvalidierung unterstützt. Unterstützt eine beliebige Anzahl von condition values, eines pro Element in der Liste. Formeln werden in den Werten nicht unterstützt.
BLANK Der Wert der Zelle muss leer sein. Wird von bedingter Formatierung und Filtern unterstützt. Erfordert keine ConditionValues.
NOT_BLANK Der Wert der Zelle darf nicht leer sein. Wird von bedingter Formatierung und Filtern unterstützt. Erfordert keine ConditionValues.
CUSTOM_FORMULA Die Formel der Bedingung muss als „true“ ausgewertet werden. Unterstützt durch Datenvalidierung, bedingte Formatierung und Filter. Wird von Datenquellen-Tabellenblattfiltern nicht unterstützt. Erfordert eine einzelne ConditionValue.
BOOLEAN Der Wert der Zelle muss WAHR/FALSCH oder in der Liste der Bedingungswerte enthalten sein. Durch Datenvalidierung unterstützt. Wird als Kontrollkästchen in einer Zelle gerendert. Unterstützt null, ein oder zwei ConditionValues. Wenn keine Werte angegeben sind, muss die Zelle TRUE oder FALSE sein. TRUE wird als aktiviert und FALSE als deaktiviert gerendert. Ein Wert gibt an, dass die Zelle als ausgewählt gerendert wird, wenn sie diesen Wert enthält, und als nicht ausgewählt, wenn sie leer ist. Zwei Werte geben an, dass die Zelle als ausgewählt gerendert wird, wenn sie den ersten Wert enthält, und als nicht ausgewählt, wenn sie den zweiten Wert enthält. Beispiel: ["Yes","No"] gibt an, dass in der Zelle ein Häkchen angezeigt wird, wenn sie den Wert „Yes“ hat, und kein Häkchen, wenn sie den Wert „No“ hat.
TEXT_NOT_EQ Der Wert der Zelle darf nicht mit dem Wert der Bedingung übereinstimmen. Wird durch Filter für Datenquellenobjekte unterstützt. Erfordert mindestens ein ConditionValue.
DATE_NOT_EQ Der Wert der Zelle darf nicht mit dem Wert der Bedingung übereinstimmen. Wird durch Filter für Datenquellenobjekte unterstützt. Erfordert mindestens ein ConditionValue.
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

Legt fest, wie eine Datumsbedingung ausgewertet wird.

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

GridRange

Ein Bereich in einem Tabellenblatt. Alle Indexe sind nullbasiert. Die Indexe sind halboffen, d.h. der Startindex ist inklusiv und der Endindex ist exklusiv – [startIndex, endIndex). Fehlende Indexe weisen darauf hin, dass der Bereich auf dieser Seite unbegrenzt ist.

Beispiel: Wenn "Sheet1" die Tabellenblatt-ID 123456 ist, gilt Folgendes:

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 gleich dem Endindex ist, ist der Bereich leer. Leere Bereiche sind in der Regel nicht sinnvoll 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, auf dem sich dieser Bereich befindet.

startRowIndex

integer

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

endRowIndex

integer

Die Endzeile (ausschließlich) des Bereichs oder nicht festgelegt, wenn der Bereich unbegrenzt ist.

startColumnIndex

integer

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

endColumnIndex

integer

Die Endspalte (ausschließlich) des Bereichs oder nicht festgelegt, wenn der Bereich 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 Datenquellenspalte.

FilterCriteria

Kriterien zum Ein- oder Ausblenden von Zeilen in einem Filter oder einer 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 true sein muss, damit Werte angezeigt werden. (Dadurch wird hiddenValues nicht überschrieben. Wenn dort ein Wert aufgeführt ist, wird er weiterhin ausgeblendet.)

visibleBackgroundColor
(deprecated)

object (Color)

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

visibleBackgroundColorStyle

object (ColorStyle)

Die Hintergrundfüllfarbe, nach der gefiltert werden soll. Es werden nur Zellen mit dieser Füllfarbe angezeigt. Dieses Feld und visibleForegroundColor schließen sich gegenseitig aus und müssen 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 mit visibleBackgroundColor gegenseitig aus. Verworfen: Verwenden Sie 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 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 werden.

foregroundColor
(deprecated)

object (Color)

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

foregroundColorStyle

object (ColorStyle)

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

backgroundColor
(deprecated)

object (Color)

Die Hintergrundfüllfarbe, nach der sortiert werden soll. Zellen mit dieser Füllfarbe werden an den Anfang der Liste sortiert. Schließt sich mit foregroundColor gegenseitig aus. Verworfen: Verwenden Sie backgroundColorStyle.

backgroundColorStyle

object (ColorStyle)

Die Hintergrundfüllfarbe, nach der sortiert werden soll. Zellen mit dieser Füllfarbe werden an den Anfang der Liste sortiert. Schließt foregroundColor 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 Datenquellenspalte.

EmbeddedObjectPosition

Die Position eines eingebetteten Objekts wie 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 Zelle 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 über ein Raster gelegt wird.

newSheet

boolean

Bei „true“ wird das eingebettete Objekt auf einem neuen Tab platziert, dessen ID automatisch ausgewählt wird. Wird nur beim Schreiben verwendet.

OverlayPosition

Die Position, an der ein Objekt über ein Raster gelegt wird.

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

object (GridCoordinate)

Die Zelle, an die das Objekt verankert ist.

offsetXPixels

integer

Der horizontale Versatz in Pixeln, um den das Objekt von der Ankerzelle versetzt wird.

offsetYPixels

integer

Der vertikale Offset in Pixeln, um den das Objekt von der Ankerzelle versetzt wird.

widthPixels

integer

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

heightPixels

integer

Die Höhe des Objekts in Pixeln. Der Standardwert 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.