Other

Farbe

Ermöglicht die Darstellung einer Farbe im RGBA-Farbraum. Diese Darstellung ist für eine einfache Umwandlung von Farbdarstellungen in verschiedenen Sprachen in kompakte Form konzipiert. Die Felder dieser Darstellung können beispielsweise ganz einfach an den Konstruktor von java.awt.Color in Java übergeben werden. Sie lassen sich auch ganz einfach an die Methode +colorWithRed:green:blue:alpha der UI-Farbe in iOS übergeben. Mit nur wenig Aufwand können sie in JavaScript ganz einfach in einen CSS-String rgba() formatiert werden.

Diese Referenzseite enthält keine Informationen zum absoluten Farbraum, der zur Interpretation des RGB-Werts verwendet werden soll (z. B. sRGB, Adobe RGB, DCI-P3 und BT.2020). Standardmäßig sollte in Anwendungen der sRGB-Farbraum angenommen werden.

Wenn die Farbgleichheit entschieden werden muss, behandeln Implementierungen, sofern nicht anders angegeben, zwei Farben als gleich, wenn sich alle ihre roten, grünen, blauen und Alphawerte höchstens um 1e-5 unterscheiden.

Beispiel (Java): 

 import com.google.type.Color;

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

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

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

Beispiel (iOS/Obj-C): 

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

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

Beispiel (JavaScript): 

// ...

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

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

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

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

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

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 kein Wert angegeben, wird dieses Farbobjekt als Volltonfarbe gerendert, als ob der Alphawert explizit den Wert 1,0 erhalten hätte.

Farbstil

Ein Farbwert

JSON-Darstellung 
{

  // Union field 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 einer der folgenden Werte sein:
rgbColor

object (Color)

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

themeColor

enum (ThemeColorType)

Designfarbe.

DesignFarbtyp

Designfarbtypen

SpreadsheetProperties enthält einen SpreadsheetTheme, der eine Zuordnung dieser Designfarbtypen zu Betonfarben definiert.

Enums
THEME_COLOR_TYPE_UNSPECIFIED Nicht angegebene Designfarbe
TEXT Die Farbe des Haupttexts
BACKGROUND Die primäre Hintergrundfarbe
ACCENT1 Die erste Akzentfarbe
ACCENT2 Die zweite Akzentfarbe
ACCENT3 Stellt die dritte Akzentfarbe dar
ACCENT4 Stellt die vierte Akzentfarbe dar
ACCENT5 Stellt die fünfte Akzentfarbe dar
ACCENT6 Die sechste Akzentfarbe

Horizontale Ausrichtung

Horizontale Ausrichtung des Textes in einer Zelle.

Enums
HORIZONTAL_ALIGN_UNSPECIFIED Die horizontale Ausrichtung ist nicht angegeben. Verwende dieses Attribut nicht.
LEFT Der Text ist explizit linksbündig ausgerichtet.
CENTER Der Text wird explizit auf die Mitte der Zelle ausgerichtet.
RIGHT Der Text wird explizit rechts von der Zelle ausgerichtet.

Textformat

Das Format einer Textausführung in einer Zelle. Fehlende Werte weisen darauf hin, dass das Feld nicht angegeben ist.

JSON-Darstellung 
{
  "foregroundColor": {
    object (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. Eingestellt: Verwenden Sie foregroundColorStyle.

foregroundColorStyle

object (ColorStyle)

Die Vordergrundfarbe des Textes. Wenn auch foregroundColor festgelegt wird, hat dieses Feld Vorrang.

fontFamily

string

Die Schriftfamilie.

fontSize

integer

Die Größe der Schriftart.

bold

boolean

„true“, wenn der Text fett formatiert ist.

italic

boolean

„true“, wenn der Text kursiv dargestellt wird

strikethrough

boolean

Dieser Wert ist „True“, wenn der Text durchgestrichen ist.

underline

boolean

„true“, wenn der Text unterstrichen ist

Datenquellenspalte

Eine Spalte in einer Datenquelle.

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

object (DataSourceColumnReference)

Spaltenreferenz

formula

string

Die Formel der berechneten Spalte.

Referenz der Datenquellenspalte

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.

Status der Ausführung

Der Status der Datenausführung.

Eine Datenausführung wird erstellt, um ein Datenquellenobjekt mit den neuesten Daten aus einer DataSource zu synchronisieren. Normalerweise ist die Ausführung im Hintergrund geplant. Anhand der state können Sie feststellen, ob eine Ausführung abgeschlossen ist.

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

  • Adding a data source erstellt ein zugehöriges Datenquellenblatt und eine Datenausführung für die Synchronisierung der Daten aus der Datenquelle mit dem Tabellenblatt.
  • Updating a data source erstellt eine Datenausführung, um das verknüpfte Datenquellenblatt auf ähnliche Weise zu aktualisieren.
  • Sie können refresh request senden, um ein oder mehrere Datenquellenobjekte explizit zu aktualisieren.
JSON-Darstellung 
{
  "state": enum (DataExecutionState),
  "errorCode": enum (DataExecutionErrorCode),
  "errorMessage": string,
  "lastRefreshTime": string
}
Felder
state

enum (DataExecutionState)

Der Status der Datenausführung.

errorCode

enum (DataExecutionErrorCode)

Fehlercode

errorMessage

string

Die Fehlermeldung, die möglicherweise leer ist.

lastRefreshTime

string (Timestamp format)

Ruft die Zeit ab, zu der die Daten zuletzt aktualisiert wurden.

DataExecutionState (Datenausführungsstatus)

Eine Aufzählung der Datenausführungsstatus.

Enums
DATA_EXECUTION_STATE_UNSPECIFIED Standardwert, nicht verwenden.
NOT_STARTED Die Datenausführung hat nicht begonnen.
RUNNING Die Datenausführung hat begonnen und wird ausgeführt.
SUCCEEDED Die Datenausführung wurde erfolgreich abgeschlossen.
FAILED Die Datenausführung wurde mit Fehlern abgeschlossen.

DataExecutionErrorCode

Eine Aufzählung des Fehlers beim Ausführen der Daten.

Enums
DATA_EXECUTION_ERROR_CODE_UNSPECIFIED Standardwert, nicht verwenden.
TIMED_OUT Zeitüberschreitung bei der Datenausführung.
TOO_MANY_ROWS Die Datenausführung gibt mehr Zeilen zurück als das Limit überschreitet.
TOO_MANY_COLUMNS Die Datenausführung gibt mehr Spalten zurück als das Limit überschreitet.
TOO_MANY_CELLS Bei der Datenausführung werden mehr Zellen zurückgegeben als das Limit erreicht ist.
ENGINE Die Fehlermeldung wird von der Back-End-Datenausführungs-Engine gesendet (z.B. BigQuery). Weitere Informationen finden Sie unter errorMessage.
PARAMETER_INVALID Mindestens einer der angegebenen Parameter der Datenquelle ist ungültig.
UNSUPPORTED_DATA_TYPE Die Datenausführung gibt einen nicht unterstützten Datentyp zurück.
DUPLICATE_COLUMN_NAMES Beim Ausführen der Daten werden doppelte Spaltennamen oder Aliasse zurückgegeben.
INTERRUPTED Die Datenausführung wurde unterbrochen. Bitte aktualisieren Sie die Seite später.
CONCURRENT_QUERY Die Datenausführung läuft gerade und kann erst aktualisiert werden, wenn sie abgeschlossen ist.
OTHER Sonstige Fehler.
TOO_MANY_CHARS_PER_CELL Die Datenausführung gibt Werte zurück, die die maximal in einer einzelnen Zelle zulässigen Zeichen überschreiten.
DATA_NOT_FOUND Die Datenbank, auf die von der Datenquelle verwiesen wird, wurde nicht gefunden. */
PERMISSION_DENIED Der Nutzer hat keinen Zugriff auf die Datenbank, auf die die Datenquelle verweist.
MISSING_COLUMN_ALIAS Die Datenausführung gibt Spalten mit fehlenden Aliassen zurück.
OBJECT_NOT_FOUND Das Datenquellenobjekt ist nicht vorhanden.
OBJECT_IN_ERROR_STATE Das Datenquellenobjekt hat derzeit einen Fehlerstatus. Wenn Sie die Aktualisierung erzwingen möchten, legen Sie in RefreshDataSourceRequest force fest.
OBJECT_SPEC_INVALID Die Spezifikation des Datenquellenobjekts ist ungültig.

Erweiterter Wert

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

JSON-Darstellung 
{

  // Union field 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 einer der folgenden Werte sein:
numberValue

number

Ein Doppelwert. Hinweis: „Date“, „Time“ und „DateTimes“ werden als Doppelwerte im Format SERIAL_NUMBER dargestellt.

stringValue

string

Ein Stringwert Führende einfache Anführungszeichen sind nicht enthalten. Wenn der Nutzer beispielsweise '123 in die UI eingegeben hat, wird dies als stringValue von "123" dargestellt.

boolValue

boolean

Ein boolescher Wert.

formulaValue

string

Eine Formel.

errorValue

object (ErrorValue)

Fehler. Dieses Feld ist schreibgeschützt.

Fehlerwert

Fehler in der 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. Bitte nicht verwenden.
ERROR Entspricht dem Fehler #ERROR!.
NULL_VALUE Entspricht dem Fehler #NULL!.
DIVIDE_BY_ZERO Entspricht dem Fehler #DIV/0.
VALUE Entspricht dem Fehler #VALUE!.
REF Entspricht dem Fehler #REF!.
NAME Entspricht dem Fehler #NAME?.
NUM Entspricht dem Fehler #NUM!.
N_A Entspricht dem Fehler #N/A.
LOADING Entspricht dem Status Loading....

Boolesche Bedingung

Eine Bedingung, die als „true“ oder „false“ ausgewertet werden kann. Boolesche Bedingungen werden von der bedingten Formatierung, der Datenvalidierung und den Kriterien in Filtern verwendet.

JSON-Darstellung 
{
  "type": enum (ConditionType),
  "values": [
    {
      object (ConditionValue)
    }
  ]
}
Felder
type

enum (ConditionType)

Der Bedingungstyp.

values[]

object (ConditionValue)

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

Bedingungstyp

Der Bedingungstyp.

Enums
CONDITION_TYPE_UNSPECIFIED Der Standardwert, nicht verwenden.
NUMBER_GREATER Der Wert der Zelle muss größer als der Wert der Bedingung sein. Wird durch die Datenvalidierung, bedingte Formatierung und Filter unterstützt. Erfordert einen einzelnen ConditionValue.
NUMBER_GREATER_THAN_EQ Der Wert der Zelle muss größer oder gleich dem Wert der Bedingung sein. Wird durch die Datenvalidierung, bedingte Formatierung und Filter unterstützt. Erfordert einen einzelnen ConditionValue.
NUMBER_LESS Der Wert der Zelle muss kleiner als der Wert der Bedingung sein. Wird durch die Datenvalidierung, bedingte Formatierung und Filter unterstützt. Erfordert einen einzelnen ConditionValue.
NUMBER_LESS_THAN_EQ Der Wert der Zelle muss kleiner oder gleich dem Wert der Bedingung sein. Wird durch die Datenvalidierung, bedingte Formatierung und Filter unterstützt. Erfordert einen einzelnen ConditionValue.
NUMBER_EQ Der Wert der Zelle muss dem Wert der Bedingung entsprechen. Wird durch die Datenvalidierung, bedingte Formatierung und Filter unterstützt. Erfordert ein einzelnes ConditionValue für Datenvalidierung, bedingte Formatierung und Filter für Objekte, die nicht aus der Datenquelle stammen, und mindestens ein ConditionValue-Objekt für Filter von Datenquellenobjekten.
NUMBER_NOT_EQ Der Wert der Zelle darf nicht mit dem Wert der Bedingung übereinstimmen. Wird durch die Datenvalidierung, bedingte Formatierung und Filter unterstützt. Erfordert ein einzelnes ConditionValue für Datenvalidierung, bedingte Formatierung und Filter für Objekte, die nicht aus der Datenquelle stammen, und mindestens ein ConditionValue-Objekt für Filter von Datenquellenobjekten.
NUMBER_BETWEEN Der Wert der Zelle muss zwischen den beiden Bedingungswerten liegen. Wird durch die Datenvalidierung, bedingte Formatierung und Filter unterstützt. Erfordert genau zwei ConditionValues.
NUMBER_NOT_BETWEEN Der Wert der Zelle darf nicht zwischen den beiden Bedingungswerten liegen. Wird durch die Datenvalidierung, bedingte Formatierung und Filter unterstützt. Erfordert genau zwei ConditionValues.
TEXT_CONTAINS Der Wert der Zelle muss den Wert der Bedingung enthalten. Wird durch die Datenvalidierung, bedingte Formatierung und Filter unterstützt. Erfordert einen einzelnen ConditionValue.
TEXT_NOT_CONTAINS Der Wert der Zelle darf nicht den Wert der Bedingung enthalten. Wird durch die Datenvalidierung, bedingte Formatierung und Filter unterstützt. Erfordert einen einzelnen ConditionValue.
TEXT_STARTS_WITH Der Wert der Zelle muss mit dem Wert der Bedingung beginnen. Wird durch die bedingte Formatierung und Filter unterstützt Erfordert einen einzelnen ConditionValue.
TEXT_ENDS_WITH Der Wert der Zelle muss mit dem Wert der Bedingung enden. Wird durch die bedingte Formatierung und Filter unterstützt Erfordert einen einzelnen ConditionValue.
TEXT_EQ Der Wert in der Zelle muss genau dem Wert in der Bedingung entsprechen. Wird durch die Datenvalidierung, bedingte Formatierung und Filter unterstützt. Erfordert ein einzelnes ConditionValue für Datenvalidierung, bedingte Formatierung und Filter für Objekte, die nicht aus der Datenquelle stammen, und mindestens ein ConditionValue-Objekt für Filter von Datenquellenobjekten.
TEXT_IS_EMAIL Der Wert der Zelle muss eine gültige E-Mail-Adresse sein. Dies wird von der Datenvalidierung unterstützt. Erfordert keine ConditionValues.
TEXT_IS_URL Der Wert der Zelle muss eine gültige URL sein. Dies wird von der Datenvalidierung unterstützt. Erfordert keine ConditionValues.
DATE_EQ Der Wert in der Zelle muss mit dem Wert in der Bedingung identisch sein. Wird durch die Datenvalidierung, bedingte Formatierung und Filter unterstützt. Erfordert ein einzelnes ConditionValue für Datenvalidierung, bedingte Formatierung und Filter für Objekte, die nicht aus der Datenquelle stammen, und mindestens ein ConditionValue-Objekt für Filter von Datenquellenobjekten.
DATE_BEFORE Der Wert der Zelle muss vor dem Datum des Bedingungswerts liegen. Wird durch die Datenvalidierung, bedingte Formatierung und Filter unterstützt. Erfordert einen einzelnen ConditionValue, der ein relative date sein kann.
DATE_AFTER Der Wert der Zelle muss nach dem Wert der Bedingung liegen. Wird durch die Datenvalidierung, bedingte Formatierung und Filter unterstützt. Erfordert einen einzelnen ConditionValue, der ein relative date sein kann.
DATE_ON_OR_BEFORE Der Wert der Zelle muss dem Datum des Bedingungswerts entsprechen oder davor liegen. Dies wird von der Datenvalidierung unterstützt. Erfordert einen einzelnen ConditionValue, der ein relative date sein kann.
DATE_ON_OR_AFTER Der Wert der Zelle muss dem Datum des Bedingungswerts entsprechen oder danach liegen. Dies wird von der Datenvalidierung unterstützt. Erfordert einen einzelnen ConditionValue, der ein relative date sein kann.
DATE_BETWEEN Der Wert der Zelle muss zwischen den Datumsangaben der beiden Bedingungswerte liegen. Dies wird von der Datenvalidierung unterstützt. Erfordert genau zwei ConditionValues.
DATE_NOT_BETWEEN Der Wert der Zelle muss außerhalb des Datums der beiden Bedingungswerte liegen. Dies wird von der Datenvalidierung unterstützt. Erfordert genau zwei ConditionValues.
DATE_IS_VALID Der Wert in der Zelle muss ein Datum sein. Dies wird von der Datenvalidierung unterstützt. Erfordert keine ConditionValues.
ONE_OF_RANGE Der Wert der Zelle muss im Raster im Bereich des Bedingungswerts aufgeführt werden. Dies wird von der Datenvalidierung unterstützt. Erfordert eine einzelne ConditionValue und der Wert muss ein gültiger Bereich in A1-Notation sein.
ONE_OF_LIST Der Wert der Zelle muss in der Liste der Bedingungswerte enthalten sein. Dies wird von der Datenvalidierung unterstützt. Unterstützt eine beliebige Anzahl von condition values-Werten, eine pro Element in der Liste. Formeln werden in den Werten nicht unterstützt.
BLANK Der Wert in der Zelle muss leer sein. Wird durch die bedingte Formatierung und Filter unterstützt Erfordert keine ConditionValues.
NOT_BLANK Der Wert in der Zelle darf nicht leer sein. Wird durch die bedingte Formatierung und Filter unterstützt Erfordert keine ConditionValues.
CUSTOM_FORMULA Die Formel der Bedingung muss als „true“ ausgewertet werden. Wird durch die Datenvalidierung, bedingte Formatierung und Filter unterstützt. Wird in Filtern in Datenquellentabellen nicht unterstützt. Erfordert einen einzelnen ConditionValue.
BOOLEAN Der Wert der Zelle muss WAHR/FALSCH oder in der Liste der Bedingungswerte stehen. Dies wird von der Datenvalidierung unterstützt. Wird als Kästchen für Zellen gerendert. Unterstützt null, eine oder zwei ConditionValues. Keine Werte bedeuten, dass die Zelle WAHR oder FALSCH sein muss, wobei WAHR als aktiviert dargestellt wird und FALSCH, wenn kein Häkchen gesetzt ist. Ein Wert bedeutet, dass die Zelle als aktiviert gerendert wird, wenn sie diesen Wert enthält, und deaktiviert, wenn sie leer ist. Zwei Werte bedeuten, dass die Zelle als aktiviert markiert wird, wenn sie den ersten Wert enthält, und deaktiviert, wenn sie den zweiten Wert enthält. [„Ja“,„Nein“] gibt beispielsweise an, dass die Zelle ein Kästchen rendert, wenn es den Wert „Ja“ hat, und kein Häkchen, wenn es den Wert „Nein“ hat.
TEXT_NOT_EQ Der Wert in der Zelle muss genau mit dem Wert in der Bedingung übereinstimmen. Wird von Filtern für Datenquellenobjekte unterstützt. Erfordert mindestens eine ConditionValue.
DATE_NOT_EQ Der Wert in der Zelle muss genau mit dem Wert in der Bedingung übereinstimmen. Wird von Filtern für Datenquellenobjekte unterstützt. Erfordert mindestens eine ConditionValue.
FILTER_EXPRESSION Der Wert der Zelle muss dem angegebenen Muster entsprechen. Erfordert einen einzelnen ConditionValue.

Bedingungswert

Der Wert der Bedingung.

JSON-Darstellung 
{

  // Union field 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 ein Wert festgelegt werden. value darf nur einer der folgenden Werte sein:
relativeDate

enum (RelativeDate)

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

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

userEnteredValue

string

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

RelativeDate

Steuert, wie eine Bedingung vom Typ „Datum“ ausgewertet wird.

Enums
RELATIVE_DATE_UNSPECIFIED Standardwert, nicht verwenden.
PAST_YEAR Der Wert liegt ein Jahr vor dem heutigen Tag.
PAST_MONTH Der Wert liegt einen Monat vor dem heutigen Tag.
PAST_WEEK Der Wert liegt eine Woche vor dem heutigen Tag.
YESTERDAY Der Wert ist gestern.
TODAY Der Wert ist heute.
TOMORROW Der Wert ist morgen.

Rasterbereich

Ein Bereich auf einem Tabellenblatt. Alle Indexe sind nullbasiert. Indexe sind halb offen, d.h., der Startindex ist inklusiv und der Endindex ist exklusiv – [startIndex, endIndex. Fehlende Indexe geben an, dass der Bereich auf dieser Seite unbegrenzt ist.

Wenn "Sheet1" beispielsweise die Tabellenblatt-ID 123456 ist, dann gilt:

Sheet1!A1:A1 == sheetId: 123456, startRowIndex: 0, endRowIndex: 1, startColumnIndex: 0, endColumnIndex: 1

Sheet1!A3:B4 == sheetId: 123456, startRowIndex: 2, endRowIndex: 4, startColumnIndex: 0, endColumnIndex: 2

Sheet1!A:B == sheetId: 123456, startColumnIndex: 0, endColumnIndex: 2

Sheet1!A5:B == sheetId: 123456, startRowIndex: 4, startColumnIndex: 0, endColumnIndex: 2

Sheet1 == sheetId: 123456

Der Startindex muss immer kleiner oder gleich dem Endindex sein. Wenn der Startindex dem Endindex entspricht, ist der Bereich leer. Leere Bereiche sind normalerweise nicht aussagekräftig und werden in der Regel als #REF! gerendert.

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

integer

Das Tabellenblatt, in dem dieser Bereich angezeigt wird.

startRowIndex

integer

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

endRowIndex

integer

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

startColumnIndex

integer

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

endColumnIndex

integer

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

SortOrder

Eine Sortierreihenfolge.

Enums
SORT_ORDER_UNSPECIFIED Standardwert, nicht verwenden.
ASCENDING Aufsteigend sortieren.
DESCENDING Absteigend sortieren.

Filterspezifikation

Die Filterkriterien, die mit einer bestimmten Spalte verknüpft sind.

JSON-Darstellung 
{
  "filterCriteria": {
    object (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 einer der folgenden Werte sein:
columnIndex

integer

Der nullbasierte Spaltenindex.

dataSourceColumnReference

object (DataSourceColumnReference)

Verweist auf eine Datenquellenspalte.

Filterkriterien

Kriterien zum Anzeigen/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 dort ein Wert aufgeführt ist, wird 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. Sich gegenseitig mit visibleForegroundColor ausschließen. 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 und visibleForegroundColor schließen sich gegenseitig aus und müssen auf eine RGB-Farbe festgelegt werden. Wenn auch visibleBackgroundColor festgelegt wird, hat dieses Feld Vorrang.

visibleForegroundColor
(deprecated)

object (Color)

Die Farbe für den Vordergrund, nach der gefiltert werden soll. Es werden nur Zellen mit dieser Farbe im Vordergrund angezeigt. Sich gegenseitig mit visibleBackgroundColor ausschließen. Eingestellt: Verwenden Sie visibleForegroundColorStyle.

visibleForegroundColorStyle

object (ColorStyle)

Die Farbe für den Vordergrund, nach der gefiltert werden soll. Es werden nur Zellen mit dieser Farbe im Vordergrund angezeigt. Dieses Feld und visibleBackgroundColor schließen sich gegenseitig aus und müssen auf eine RGB-Farbe festgelegt werden. Wenn auch visibleForegroundColor festgelegt wird, hat dieses Feld Vorrang.

Sortierung

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

foregroundColor
(deprecated)

object (Color)

Die Farbe für den Vordergrund, nach der sortiert werden soll. Zellen mit dieser Farbe im Vordergrund werden oben sortiert. Sich gegenseitig mit backgroundColor ausschließen. Eingestellt: Verwenden Sie foregroundColorStyle.

foregroundColorStyle

object (ColorStyle)

Die Farbe für den Vordergrund, nach der sortiert werden soll. Zellen mit dieser Farbe im Vordergrund werden oben sortiert. Schließt sich mit backgroundColor gegenseitig aus und muss eine RGB-Farbe sein. Wenn auch foregroundColor festgelegt wird, 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. Sich gegenseitig mit foregroundColor ausschließen. 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 wird, hat dieses Feld Vorrang.

Union-Feld reference. Verweist auf die sortierte Dimension. reference darf nur einer der folgenden Werte sein:
dimensionIndex

integer

Die Dimension, auf die die Sortierung angewendet werden soll

dataSourceColumnReference

object (DataSourceColumnReference)

Verweist auf eine Datenquellenspalte.

Eingebettete Objektposition

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. location darf nur einer der folgenden Werte sein:
sheetId

integer

Das Tabellenblatt, in dem diese Option aktiviert ist. Legen Sie diese Einstellung nur fest, wenn sich das eingebettete Objekt in einem eigenen Tabellenblatt befindet. Darf nicht negativ sein.

overlayPosition

object (OverlayPosition)

Die Position, an der das Objekt über einem Raster liegt.

newSheet

boolean

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

Overlay-Position

Die Position, an der ein Objekt über einem Raster liegt.

JSON-Darstellung 
{
  "anchorCell": {
    object (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 Abstand in Pixeln, in dem das Objekt von der Ankerzelle entfernt ist.

offsetYPixels

integer

Der vertikale Offset des Objekts in Pixeln, in dem das Objekt von der Ankerzelle entfernt ist.

widthPixels

integer

Die Breite des Objekts in Pixeln Der Standardwert ist 600.

heightPixels

integer

Höhe des Objekts in Pixeln Der Standardwert ist 371.

Rasterkoordinaten

Eine Koordinate in einem Tabellenblatt Alle Indexe sind nullbasiert.

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

integer

Das Tabellenblatt, in dem diese Koordinaten angezeigt werden.

rowIndex

integer

Der Zeilenindex der Koordinate.

columnIndex

integer

Spaltenindex der Koordinate