Other

Farbe

Ermöglicht die Darstellung einer Farbe im RGBA-Farbraum. Diese Darstellung ist auf die einfache Konvertierung in und aus Farbdarstellungen in verschiedenen Sprachen statt auf Kompaktheit ausgelegt. Die Felder dieser Darstellung können beispielsweise einfach dem Konstruktor von java.awt.Color in Java; kann auch einfach dem UIColor-Tool +colorWithRed:green:blue:alpha in iOS verwenden: und kann mit wenig Aufwand in ein CSS-Format rgba() in JavaScript verwenden.

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

Wenn die Farbgleichheit beschlossen werden muss, werden Implementierungen, sofern nicht anders angegeben, zwei Farben als gleich behandelt, wenn sich alle ihre Rot-, Grün-, Blau- und Alpha-Werte um höchstens 1e-5

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 keine Angabe gemacht wird, wird dieses Farbobjekt als Volltonfarbe gerendert, so als ob dem Alphawert explizit der Wert 1,0 zugewiesen worden wäre.

ColorStyle

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 kann nur einer der folgenden Werte sein:
rgbColor

object (Color)

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

themeColor

enum (ThemeColorType)

Designfarbe.

ThemeColorType

Farbtypen der Designs.

SpreadsheetProperties enthält SpreadsheetTheme definiert eine Zuordnung dieser Farbtypen zu Betonfarben.

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

HorizontalAlign

Die horizontale Ausrichtung von Text in einer Zelle.

Enums
HORIZONTAL_ALIGN_UNSPECIFIED Die horizontale Ausrichtung ist nicht angegeben. Nicht verwenden.
LEFT Der Text ist explizit links von der Zelle ausgerichtet.
CENTER Der Text ist explizit an der Mitte der Zelle ausgerichtet.
RIGHT Der Text ist explizit rechts von der Zelle ausgerichtet.

TextFormat

Das Format einer Laufschrift 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 foregroundColorStyle

foregroundColorStyle

object (ColorStyle)

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

fontFamily

string

Die Schriftfamilie.

fontSize

integer

Die Größe der Schriftart.

bold

boolean

„True“, wenn der Text fett ist.

italic

boolean

"True", wenn der Text kursiv ist.

strikethrough

boolean

„True“, wenn der Text durchgestrichen ist.

underline

boolean

Wahr, wenn der Text unterstrichen ist.

DataSourceColumn

Spalte in einer Datenquelle.

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

object (DataSourceColumnReference)

Die Spaltenreferenz.

formula

string

Die Formel der berechneten Spalte.

DataSourceColumnReference

Eine eindeutige Kennung, die auf eine Datenquellenspalte verweist.

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

string

Der Anzeigename der Spalte. Er 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 Normalerweise wird sie im Hintergrund ausgeführt. state um festzustellen, 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, um die Daten aus der Datenquelle mit der Tabelle 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 ein oder mehrere Datenquellenobjekte explizit 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. Diese ist möglicherweise leer.

lastRefreshTime

string (Timestamp format)

Ruft den Zeitpunkt der letzten Aktualisierung der Daten ab.

DataExecutionState

Eine Aufzählung der Datenausführungsstatus.

Enums
DATA_EXECUTION_STATE_UNSPECIFIED Standardwert, nicht verwenden.
NOT_STARTED Die Datenausführung wurde nicht gestartet.
RUNNING Die Datenausführung wurde gestartet und wird ausgeführt.
CANCELLING Die Datenausführung wird gerade abgebrochen.
SUCCEEDED Die Datenausführung wurde abgeschlossen.
FAILED Die Datenausführung wurde mit Fehlern abgeschlossen.

DataExecutionErrorCode

Eine Aufzählung von Datenausführungsfehlercode.

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 Bei der Datenausführung werden mehr Spalten als das Limit zurückgegeben.
TOO_MANY_CELLS Bei der Datenausführung werden mehr Zellen zurückgegeben, als das Limit erlaubt.
ENGINE Der Fehler wird von der Back-End-Datenausführungs-Engine (z.B. BigQuery) empfangen. Prüfen 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 werden doppelte Spaltennamen oder Aliasse zurückgegeben.
INTERRUPTED Die Datenausführung wird unterbrochen. Bitte aktualisiere die Seite später.
CONCURRENT_QUERY Die Daten werden gerade ausgeführt und können erst aktualisiert werden, wenn sie abgeschlossen ist.
OTHER Sonstige Fehler.
TOO_MANY_CHARS_PER_CELL Beim Ausführen der Daten werden Werte zurückgegeben, die die in einer einzelnen Zelle zulässige Zeichenbeschränkung überschreiten.
DATA_NOT_FOUND Die Datenbank, auf die in der Datenquelle verwiesen wird, wurde nicht gefunden. */
PERMISSION_DENIED Der Nutzer hat keinen Zugriff auf die Datenbank, auf die in der Datenquelle verwiesen wird.
MISSING_COLUMN_ALIAS 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. Um eine Aktualisierung zu erzwingen, legen Sie force in RefreshDataSourceRequest.
OBJECT_SPEC_INVALID Die Objektspezifikation der Datenquelle ist ungültig.
DATA_EXECUTION_CANCELLED Die Datenausführung wurde abgebrochen.

ExtendedValue

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

JSON-Darstellung
{

  // Union field value can be only one of the following:
  "numberValue": number,
  "stringValue": string,
  "boolValue": boolean,
  "formulaValue": string,
  "errorValue": {
    object (ErrorValue)
  }
  // End of list of possible types for union field value.
}
Felder
Union-Feld value Der Typ des Werts in einer Zelle. Ist kein Feld festgelegt, enthält die Zelle keine Daten. value kann nur einer der folgenden Werte sein:
numberValue

number

Stellt einen Double-Wert dar. Hinweis: Datum, Uhrzeit und Datum/Uhrzeit werden in SERIAL_NUMBER Format.

stringValue

string

Stellt einen Stringwert dar. Vorangestellte einfache Anführungszeichen werden nicht berücksichtigt. Wenn der Nutzer beispielsweise '123 angezeigt wird, wird dies als stringValue von "123"

boolValue

boolean

Stellt einen booleschen Wert dar.

formulaValue

string

Stellt eine Formel dar.

errorValue

object (ErrorValue)

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

ErrorValue

Fehler in einer Zelle.

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

enum (ErrorType)

Die Art des Fehlers.

message

string

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

ErrorType

Die Art des Fehlers.

Enums
ERROR_TYPE_UNSPECIFIED Nicht den standardmäßigen Fehlertyp verwenden.
ERROR Entspricht dem #ERROR! Fehler.
NULL_VALUE Entspricht dem #NULL! Fehler.
DIVIDE_BY_ZERO Entspricht dem #DIV/0 Fehler.
VALUE Entspricht dem #VALUE! Fehler.
REF Entspricht dem #REF! Fehler.
NAME Entspricht dem #NAME? Fehler.
NUM Entspricht dem #NUM! Fehler.
N_A Entspricht dem #N/A Fehler.
LOADING Entspricht dem Loading... Bundesstaat.

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)

Die Art der Bedingung.

values[]

object (ConditionValue)

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

ConditionType

Die Art 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 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 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 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 ConditionValue
NUMBER_EQ Der Wert der Zelle muss dem Wert der Bedingung entsprechen. Unterstützt durch Datenvalidierung, bedingte Formatierung und Filter. Erfordert eine ConditionValue für Datenvalidierung, bedingte Formatierung und Filter für Nicht-Datenquellenobjekte und mindestens eines ConditionValue für Filter für Datenquellenobjekte.
NUMBER_NOT_EQ Der Wert der Zelle darf nicht dem Wert der Bedingung entsprechen. Unterstützt durch Datenvalidierung, bedingte Formatierung und Filter. Erfordert eine ConditionValue für Datenvalidierung, bedingte Formatierung und Filter für Nicht-Datenquellenobjekte und mindestens eines 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. 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. Erfordert genau zwei ConditionValues
TEXT_CONTAINS Der Wert der Zelle muss den Wert der Bedingung enthalten. Unterstützt durch Datenvalidierung, bedingte Formatierung und Filter. Erfordert eine 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 ConditionValue
TEXT_STARTS_WITH Der Wert der Zelle muss mit dem Wert der Bedingung beginnen. Unterstützt durch bedingte Formatierung und Filter. Erfordert eine ConditionValue
TEXT_ENDS_WITH Der Wert der Zelle muss mit dem Wert der Bedingung enden. Unterstützt durch bedingte Formatierung und Filter. Erfordert eine ConditionValue
TEXT_EQ Der Wert der Zelle muss genau mit dem Wert der Bedingung übereinstimmen. Unterstützt durch Datenvalidierung, bedingte Formatierung und Filter. Erfordert eine ConditionValue für Datenvalidierung, bedingte Formatierung und Filter für Nicht-Datenquellenobjekte und mindestens eines ConditionValue für Filter für Datenquellenobjekte.
TEXT_IS_EMAIL Der Wert der Zelle muss eine gültige E-Mail-Adresse sein. Unterstützt durch Datenvalidierung. Erfordert keine ConditionValues
TEXT_IS_URL Der Wert der Zelle muss eine gültige URL sein. Unterstützt durch Datenvalidierung. Erfordert keine ConditionValues
DATE_EQ Der Wert in der Zelle muss mit dem Datum der Bedingung übereinstimmen. Unterstützt durch Datenvalidierung, bedingte Formatierung und Filter. Erfordert eine ConditionValue für Datenvalidierung, bedingte Formatierung und Filter für Nicht-Datenquellenobjekte und mindestens eines ConditionValue für Filter für Datenquellenobjekte.
DATE_BEFORE Der Wert in der Zelle muss vor dem Datum des Bedingungswerts liegen. Unterstützt durch Datenvalidierung, bedingte Formatierung und Filter. Erfordert eine ConditionValue kann das ein relative date.
DATE_AFTER Der Wert in der Zelle muss nach dem Datum des Bedingungswerts liegen. Unterstützt durch Datenvalidierung, bedingte Formatierung und Filter. Erfordert eine ConditionValue kann das ein relative date.
DATE_ON_OR_BEFORE Der Wert der Zelle muss dem Datum des Bedingungswerts entsprechen oder davor liegen. Unterstützt durch Datenvalidierung. Erfordert eine ConditionValue kann das ein relative date.
DATE_ON_OR_AFTER Der Wert der Zelle muss dem Datum des Bedingungswerts entsprechen oder danach liegen. Unterstützt durch Datenvalidierung. Erfordert eine ConditionValue kann das ein relative date.
DATE_BETWEEN Der Wert der Zelle muss zwischen den Datumsangaben der beiden Bedingungswerte liegen. Unterstützt durch Datenvalidierung. Erfordert genau zwei ConditionValues
DATE_NOT_BETWEEN Der Wert der Zelle muss außerhalb der Datumsangaben der beiden Bedingungswerte liegen. Unterstützt durch Datenvalidierung. Erfordert genau zwei ConditionValues
DATE_IS_VALID Der Wert der Zelle muss ein Datum sein. Unterstützt durch Datenvalidierung. Erfordert keine ConditionValues
ONE_OF_RANGE Der Wert der Zelle muss im Raster im Bereich des Bedingungswerts aufgeführt sein. Unterstützt durch Datenvalidierung. Erfordert eine ConditionValue und der Wert muss ein gültiger Bereich in A1-Schreibweise sein.
ONE_OF_LIST Der Wert der Zelle muss in der Liste der Bedingungswerte enthalten sein. Unterstützt durch Datenvalidierung. Unterstützt beliebig viele 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 keine ConditionValues
NOT_BLANK Der Wert der Zelle darf nicht leer sein. Unterstützt durch bedingte Formatierung und Filter. Erfordert keine ConditionValues
CUSTOM_FORMULA Die Formel der Bedingung muss als wahr ausgewertet werden. Unterstützt durch Datenvalidierung, bedingte Formatierung und Filter. Wird bei Filtern in Datenquellentabellen nicht unterstützt. Erfordert eine 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 Keine Werte bedeutet, dass die Zelle WAHR oder FALSCH sein muss, wobei WAHR als aktiviert und FALSCH als ungeprüft gerendert wird. 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 als aktiviert gerendert wird, wenn sie den ersten Wert enthält, und als deaktiviert, wenn sie den zweiten Wert enthält. Beispiel: [„Ja“, „Nein“] bedeutet, dass die Zelle ein Häkchen rendert, wenn sie den Wert „Ja“ hat. und ein deaktiviertes Kontrollkästchen, wenn es den Wert „Nein“ hat.
TEXT_NOT_EQ Der Wert der Zelle darf nicht der Wert der Bedingung sein. Unterstützt durch Filter für Datenquellenobjekte. Benötigt mindestens eine ConditionValue
DATE_NOT_EQ Der Wert der Zelle darf nicht der Wert der Bedingung sein. Unterstützt durch Filter für Datenquellenobjekte. Benötigt mindestens eine ConditionValue
FILTER_EXPRESSION Der Wert der Zelle muss dem angegebenen Muster entsprechen. Erfordert eine 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 ein Wert festgelegt werden. value kann nur einer der folgenden Werte sein:
relativeDate

enum (RelativeDate)

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

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

userEnteredValue

string

Wert, auf dem die Bedingung basiert. Der Wert wird so geparst, als ob der Benutzer eine Eingabe in eine Zelle eingegeben hätte. Formeln werden unterstützt (und müssen mit einem = oder „+“).

RelativeDate

Steuert, wie eine Datumsbedingung ausgewertet wird.

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

GridRange

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

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

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

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

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

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

Sheet1 == sheetId: 123456

Der Startindex muss immer kleiner oder gleich dem Endindex sein. Wenn der Startindex mit dem Endindex übereinstimmt, ist der Bereich leer. Leere Bereiche sind normalerweise nicht aussagekräftig und werden in der Benutzeroberfläche #REF!

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, falls unbegrenzt.

endRowIndex

integer

Die Endzeile (ausschließlich) des Bereichs oder nicht festgelegt, falls unbegrenzt.

startColumnIndex

integer

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

endColumnIndex

integer

Die Endspalte (ausschließlich) des Bereichs oder nicht festgelegt, falls unbegrenzt.

SortOrder

Eine Sortierreihenfolge.

Enums
SORT_ORDER_UNSPECIFIED Standardwert, nicht verwenden.
ASCENDING Sortieren Sie aufsteigend.
DESCENDING Sortierung absteigend.

FilterSpec

Die mit einer bestimmten Spalte verknüpften Filterkriterien.

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 kann nur einer der folgenden Werte sein:
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. (Dies hat keine hiddenValues -- Wenn hier ein Wert aufgeführt ist, bleibt er dennoch ausgeblendet.

visibleBackgroundColor
(deprecated)

object (Color)

Die Füllfarbe des Hintergrunds, nach der gefiltert werden soll: werden nur Zellen mit dieser Füllfarbe angezeigt. Gegenseitig ausschließen mit visibleForegroundColor Eingestellt: Verwenden visibleBackgroundColorStyle

visibleBackgroundColorStyle

object (ColorStyle)

Die Füllfarbe des Hintergrunds, nach der gefiltert werden soll: werden nur Zellen mit dieser Füllfarbe angezeigt. Dieses Feld schließt sich gegenseitig aus mit visibleForegroundColor und muss auf eine RGB-Farbe festgelegt werden. Wenn visibleBackgroundColor festgelegt ist, hat dieses Feld Vorrang.

visibleForegroundColor
(deprecated)

object (Color)

Vordergrundfarbe, nach der gefiltert werden soll; werden nur Zellen mit dieser Vordergrundfarbe angezeigt. Gegenseitig ausschließen mit visibleBackgroundColor Eingestellt: Verwenden visibleForegroundColorStyle

visibleForegroundColorStyle

object (ColorStyle)

Vordergrundfarbe, nach der gefiltert werden soll; werden nur Zellen mit dieser Vordergrundfarbe angezeigt. Dieses Feld schließt sich gegenseitig aus mit visibleBackgroundColor und muss auf eine RGB-Farbe festgelegt werden. Wenn 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 Reihenfolgedaten sollten sortiert werden.

foregroundColor
(deprecated)

object (Color)

Vordergrundfarbe, nach der sortiert werden soll mit dieser Vordergrundfarbe werden oben angezeigt. Gegenseitig ausschließen mit backgroundColor Eingestellt: Verwenden foregroundColorStyle

foregroundColorStyle

object (ColorStyle)

Vordergrundfarbe, nach der sortiert werden soll mit dieser Vordergrundfarbe werden oben sortiert. Gegenseitig ausschließen mit backgroundColor und muss eine RGB-Farbe sein. Wenn foregroundColor festgelegt ist, hat dieses Feld Vorrang.

backgroundColor
(deprecated)

object (Color)

Die Füllfarbe des Hintergrunds, nach der sortiert werden soll: werden die Zellen mit dieser Füllfarbe oben sortiert. Gegenseitig ausschließen mit foregroundColor Eingestellt: Verwenden backgroundColorStyle

backgroundColorStyle

object (ColorStyle)

Die Füllfarbe des Hintergrunds, nach der sortiert werden soll: werden die Zellen mit dieser Füllfarbe oben sortiert. Gegenseitig ausschließen mit foregroundColor und muss eine RGB-Farbe sein. Wenn backgroundColor festgelegt ist, hat dieses Feld Vorrang.

Union-Feld reference Verweis auf die sortierte Dimension. reference kann nur einer der folgenden Werte sein:
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 Die Position des Objekts. Es muss genau ein Wert festgelegt werden. location kann nur einer der folgenden Werte sein:
sheetId

integer

Das Tabellenblatt, auf dem sich die Datei 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 einem Raster gelegt wird.

newSheet

boolean

Bei „true“ wird das eingebettete Objekt in ein neues Tabellenblatt eingefügt, dessen ID für Sie ausgewählt wird. Wird nur beim Schreiben verwendet.

OverlayPosition

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

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

object (GridCoordinate)

Zelle, an der das Objekt verankert ist

offsetXPixels

integer

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

offsetYPixels

integer

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

widthPixels

integer

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

heightPixels

integer

Die Höhe des Objekts in Pixeln. Die Standardeinstellung ist 371.

GridCoordinate

Eine Koordinate in einem Tabellenblatt. Alle Indexe sind nullbasiert.

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

integer

Das Tabellenblatt, auf dem sich diese Koordinate befindet.

rowIndex

integer

Der Zeilenindex der Koordinate.

columnIndex

integer

Der Spaltenindex der Koordinate.