REST Resource: spreadsheets

Ressource: Tabelle

Ressource, die eine Tabelle darstellt.

JSON-Darstellung 
{
  "spreadsheetId": string,
  "properties": {
    object (SpreadsheetProperties)
  },
  "sheets": [
    {
      object (Sheet)
    }
  ],
  "namedRanges": [
    {
      object (NamedRange)
    }
  ],
  "spreadsheetUrl": string,
  "developerMetadata": [
    {
      object (DeveloperMetadata)
    }
  ],
  "dataSources": [
    {
      object (DataSource)
    }
  ],
  "dataSourceSchedules": [
    {
      object (DataSourceRefreshSchedule)
    }
  ]
}
Felder
spreadsheetId

string

Die ID der Tabelle. Dieses Feld ist schreibgeschützt.
properties

object (SpreadsheetProperties)

Allgemeine Eigenschaften einer Tabelle.
sheets[]

object (Sheet)

Die Tabellenblätter einer Tabelle.
namedRanges[]

object (NamedRange)

Die in einer Tabelle definierten benannten Bereiche.
spreadsheetUrl

string

Die URL der Tabelle. Dieses Feld ist schreibgeschützt.
developerMetadata[]

object (DeveloperMetadata)

Die Entwicklermetadaten, die mit einer Tabelle verknüpft sind.
dataSources[]

object (DataSource)

Eine Liste der externen Datenquellen, die mit der Tabelle verknüpft sind.
dataSourceSchedules[]

object (DataSourceRefreshSchedule)

Nur Ausgabe. Eine Liste der Zeitpläne für die Aktualisierung von Datenquellen.

SpreadsheetProperties

Eigenschaften einer Tabelle.

JSON-Darstellung 
{
  "title": string,
  "locale": string,
  "autoRecalc": enum (RecalculationInterval),
  "timeZone": string,
  "defaultFormat": {
    object (CellFormat)
  },
  "iterativeCalculationSettings": {
    object (IterativeCalculationSettings)
  },
  "spreadsheetTheme": {
    object (SpreadsheetTheme)
  },
  "importFunctionsExternalUrlAccessAllowed": boolean
}
Felder
title

string

Der Titel der Tabelle.
locale

string

Das Gebietsschema der Tabelle in einem der folgenden Formate:

  • einen ISO 639-1-Sprachcode wie en

  • einen ISO 639-2-Sprachcode wie fil, falls kein 639-1-Code vorhanden ist

  • eine Kombination aus dem ISO-Sprachcode und dem Ländercode, z. B. en_US

Hinweis: Bei der Aktualisierung dieses Felds werden nicht alle Sprachen und Länder unterstützt.
autoRecalc

enum (RecalculationInterval)

Die Wartezeit, bevor volatile Funktionen neu berechnet werden.
timeZone

string

Die Zeitzone der Tabelle im CLDR-Format, z. B. America/New_York. Wenn die Zeitzone nicht erkannt wird, kann es sich um eine benutzerdefinierte Zeitzone wie GMT-07:00 handeln.
defaultFormat

object (CellFormat)

Das Standardformat aller Zellen in der Tabelle. CellData.effectiveFormat wird nicht festgelegt, wenn das Format der Zelle mit diesem Standardformat übereinstimmt. Dieses Feld ist schreibgeschützt.
iterativeCalculationSettings

object (IterativeCalculationSettings)

Hiermit wird festgelegt, ob und wie sich Zirkelbezüge durch iterative Berechnung auflösen lassen. Wenn dieses Feld fehlt, führen Rückwärtsverweise zu Berechnungsfehlern.
spreadsheetTheme

object (SpreadsheetTheme)

Design, das auf die Tabelle angewendet wurde.
importFunctionsExternalUrlAccessAllowed

boolean

Gibt an, ob der Zugriff auf externe URLs für Bild- und Importfunktionen zulässig ist. Nur lesbar, wenn „wahr“ festgelegt ist. Wenn der Wert „false“ ist, können Sie ihn auf „true“ setzen. Dieser Wert wird umgangen und gibt immer „wahr“ zurück, wenn der Administrator die Zulassungsliste aktiviert hat.

RecalculationInterval

Eine Aufzählung der möglichen Optionen für das Neuberechnungsintervall.

Enums
RECALCULATION_INTERVAL_UNSPECIFIED Standardwert. Dieser Wert darf nicht verwendet werden.
ON_CHANGE Veränderliche Funktionen werden bei jeder Änderung aktualisiert.
MINUTE Veränderliche Funktionen werden bei jeder Änderung und jede Minute aktualisiert.
HOUR Veränderliche Funktionen werden bei jeder Änderung und stündlich aktualisiert.

CellFormat

Das Format einer Zelle.

JSON-Darstellung 
{
  "numberFormat": {
    object (NumberFormat)
  },
  "backgroundColor": {
    object (Color)
  },
  "backgroundColorStyle": {
    object (ColorStyle)
  },
  "borders": {
    object (Borders)
  },
  "padding": {
    object (Padding)
  },
  "horizontalAlignment": enum (HorizontalAlign),
  "verticalAlignment": enum (VerticalAlign),
  "wrapStrategy": enum (WrapStrategy),
  "textDirection": enum (TextDirection),
  "textFormat": {
    object (TextFormat)
  },
  "hyperlinkDisplayType": enum (HyperlinkDisplayType),
  "textRotation": {
    object (TextRotation)
  }
}
Felder
numberFormat

object (NumberFormat)

Ein Format, das beschreibt, wie Zahlenwerte dem Nutzer dargestellt werden sollen.
backgroundColor
(deprecated)

object (Color)

Die Hintergrundfarbe der Zelle. Verworfen: Verwenden Sie backgroundColorStyle.
backgroundColorStyle

object (ColorStyle)

Die Hintergrundfarbe der Zelle. Wenn auch backgroundColor festgelegt ist, hat dieses Feld Vorrang.
borders

object (Borders)

Die Ränder der Zelle.
padding

object (Padding)

Der Abstand der Zelle.
horizontalAlignment

enum (HorizontalAlign)

Die horizontale Ausrichtung des Werts in der Zelle.
verticalAlignment

enum (VerticalAlign)

Die vertikale Ausrichtung des Werts in der Zelle.
wrapStrategy

enum (WrapStrategy)

Die Umbruchstrategie für den Wert in der Zelle.
textDirection

enum (TextDirection)

Die Textrichtung in der Zelle.
textFormat

object (TextFormat)

Das Format des Texts in der Zelle, sofern es nicht durch einen Formatierungslauf überschrieben wird. Wenn Sie hier eine Verknüpfung auf Zellenebene festlegen, werden die vorhandenen Verknüpfungen der Zelle gelöscht. Das Link-Feld in einer TextFormatRun hat Vorrang vor der Verknüpfung auf Zellenebene.
textRotation

object (TextRotation)

Die Drehung, die auf den Text in der Zelle angewendet wird.

NumberFormat

Das Zahlenformat einer Zelle.

JSON-Darstellung 
{
  "type": enum (NumberFormatType),
  "pattern": string
}
Felder
type

enum (NumberFormatType)

Der Typ des Zahlenformats. Dieses Feld muss beim Schreiben festgelegt sein.
pattern

string

Musterstring, der für die Formatierung verwendet wird. Wenn das Muster nicht festgelegt ist, wird bei Bedarf für den jeweiligen Typ ein Standardmuster verwendet, das auf der Sprache des Nutzers basiert. Weitere Informationen zu den unterstützten Mustern finden Sie im Leitfaden zu Datums- und Zahlenformaten.

NumberFormatType

Das Zahlenformat der Zelle. In dieser Dokumentation wird davon ausgegangen, dass das Gebietsschema „en_US“ ist. Das tatsächliche Format hängt jedoch vom Gebietsschema der Tabelle ab.

Enums
NUMBER_FORMAT_TYPE_UNSPECIFIED Das Zahlenformat ist nicht angegeben und basiert auf dem Inhalt der Zelle. Verwenden Sie diesen Parameter nicht explizit.
TEXT Textformatierung, z. B. 1000.12
NUMBER Zahlenformatierung, z. B. 1,000.12
PERCENT Prozentformat, z. B. 10.12%
CURRENCY Währungsformatierung, z. B. $1,000.12
DATE Datumsformatierung, z. B. 9/26/2008
TIME Zeitformat, z. B. 3:59:00 PM
DATE_TIME Datums- und Uhrzeitformat, z. B. 9/26/08 15:59:00
SCIENTIFIC Wissenschaftliche Zahlenformatierung, z. B. 1.01E+03

Farbe

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

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

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

Beispiel (Java):

 import com.google.type.Color;

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

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

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

Beispiel (iOS/Obj-C):

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

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

Beispiel (JavaScript):

// ...

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

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

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

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

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

number

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

number

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

number

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

number

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

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

Der Wert 1,0 entspricht einer soliden Farbdarstellung, während die Farbe bei einem Wert von 0,0 vollständig transparent ist. Dabei wird anstelle eines einfachen Float-Skalarwerts eine Wrapper-Nachricht verwendet, sodass zwischen einem Standardwert und dem zurückgesetzten Wert unterschieden werden kann. Wenn nicht angegeben, wird das Farbobjekt als Volltonfarbe dargestellt (als ob für den Alphawert explizit 1,0 angegeben worden wäre).

ColorStyle

Ein Farbwert.

JSON-Darstellung 
{

  // Union field kind can be only one of the following:
  "rgbColor": {
    object (Color)
  },
  "themeColor": enum (ThemeColorType)
  // End of list of possible types for union field kind.
}
Felder
Union-Feld kind. Die Art des Farbwerts. 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 Farbtypen zu konkreten Farben definiert.

Enums
THEME_COLOR_TYPE_UNSPECIFIED Keine Designfarbe angegeben
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

Rahmen

Die Ränder der Zelle.

JSON-Darstellung 
{
  "top": {
    object (Border)
  },
  "bottom": {
    object (Border)
  },
  "left": {
    object (Border)
  },
  "right": {
    object (Border)
  }
}
Felder
top

object (Border)

Oberer Rahmen der Zelle.
bottom

object (Border)

Unterer Rahmen der Zelle.
left

object (Border)

Der linke Rahmen der Zelle.
right

object (Border)

Der rechte Rahmen der Zelle.

Rahmen

Ein Rahmen um eine Zelle.

JSON-Darstellung 
{
  "style": enum (Style),
  "width": integer,
  "color": {
    object (Color)
  },
  "colorStyle": {
    object (ColorStyle)
  }
}
Felder
style

enum (Style)

Der Stil des Rahmens.
width
(deprecated)

integer

Die Breite des Rahmens in Pixeln. Dieses Feld wird nicht mehr unterstützt. Die Breite wird durch das Feld „style“ bestimmt.
color
(deprecated)

object (Color)

Die Farbe des Rahmens. Verworfen: Verwenden Sie colorStyle.
colorStyle

object (ColorStyle)

Die Farbe des Rahmens. Wenn auch color festgelegt ist, hat dieses Feld Vorrang.

Stil

Der Stil eines Rahmens.

Enums
STYLE_UNSPECIFIED Der Stil ist nicht angegeben. Verwenden Sie diese Option nicht.
DOTTED Der Rahmen ist gepunktet.
DASHED Der Rahmen ist gepunktet.
SOLID Der Rahmen ist eine dünne durchgehende Linie.
SOLID_MEDIUM Der Rahmen ist eine durchgehende Linie mittlerer Stärke.
SOLID_THICK Der Rahmen ist eine dicke durchgehende Linie.
NONE Ohne Rahmen. Wird nur beim Aktualisieren eines Rahmens verwendet, um ihn zu löschen.
DOUBLE Die Grenze besteht aus zwei durchgezogenen Linien.

Abstand

Der Abstand um die Zelle herum in Pixeln. Beim Aktualisieren des Paddings muss jedes Feld angegeben werden.

JSON-Darstellung 
{
  "top": integer,
  "right": integer,
  "bottom": integer,
  "left": integer
}
Felder
top

integer

Der obere Abstand der Zelle.
right

integer

Der rechte Textabstand der Zelle.
bottom

integer

Der Abstand unten in der Zelle.
left

integer

Der linke Abstand der Zelle.

HorizontalAlign

Die horizontale Ausrichtung von Text in einer Zelle.

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

VerticalAlign

Die vertikale Ausrichtung von Text in einer Zelle.

Enums
VERTICAL_ALIGN_UNSPECIFIED Die vertikale Ausrichtung ist nicht angegeben. Verwenden Sie diese Option nicht.
TOP Der Text ist explizit oben in der Zelle ausgerichtet.
MIDDLE Der Text ist explizit mittig in der Zelle ausgerichtet.
BOTTOM Der Text ist explizit am unteren Rand der Zelle ausgerichtet.

WrapStrategy

Text in einer Zelle umbrechen

Enums
WRAP_STRATEGY_UNSPECIFIED Der Standardwert, nicht verwenden.
OVERFLOW_CELL

Zeilen, die länger als die Zellenbreite sind, werden in die nächste Zelle geschrieben, sofern diese leer ist. Wenn die nächste Zelle nicht leer ist, verhält sich das Element genauso wie CLIP. Der Text wird nie umgebrochen, es sei denn, der Nutzer fügt manuell eine neue Zeile ein. Beispiel:

| First sentence. |
| Manual newline that is very long. <- Text continues into next cell
| Next newline.   |
LEGACY_WRAP

Diese Umbruchstrategie entspricht der alten Umbruchstrategie in Google Tabellen, bei der Wörter, die länger als eine Zeile sind, abgeschnitten werden, anstatt umgebrochen zu werden. Diese Strategie wird nicht auf allen Plattformen unterstützt und eingestellt. Beispiel:

| Cell has a |
| loooooooooo| <- Word is clipped.
| word.      |
CLIP

Zeilen, die länger als die Zellenbreite sind, werden abgeschnitten. Der Text wird nie umgebrochen, es sei denn, der Nutzer fügt manuell eine neue Zeile ein. Beispiel:

| First sentence. |
| Manual newline t| <- Text is clipped
| Next newline.   |
WRAP

Wörter, die länger als eine Zeile sind, werden auf Zeichenebene umgebrochen und nicht abgeschnitten. Beispiel:

| Cell has a |
| loooooooooo| <- Word is broken.
| ong word.  |

TextDirection

Die Textrichtung in einer Zelle.

Enums
TEXT_DIRECTION_UNSPECIFIED Die Textrichtung ist nicht angegeben. Verwenden Sie diese Option nicht.
LEFT_TO_RIGHT Die Textrichtung wurde vom Nutzer auf „von links nach rechts“ festgelegt.
RIGHT_TO_LEFT Die Textrichtung wurde vom Nutzer auf „linksläufig“ festgelegt.

TextFormat

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

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

object (Color)

Die Vordergrundfarbe des 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 Schriftgröße.
bold

boolean

„True“, wenn der Text fett formatiert ist.
italic

boolean

„True“, wenn der Text kursiv ist.
strikethrough

boolean

„True“, wenn der Text durchgestrichen ist.
underline

boolean

„True“, wenn der Text unterstrichen ist.

HyperlinkDisplayType

Gibt an, ob ein Hyperlink explizit gerendert werden soll. Wenn keine Angabe erfolgt, ist der Hyperlink verknüpft.

Enums
LINKED Ein Hyperlink muss explizit gerendert werden.
PLAIN_TEXT Ein Hyperlink sollte nicht gerendert werden.

TextRotation

Die Drehung, die auf Text in einer Zelle angewendet wird.

JSON-Darstellung 
{

  // Union field type can be only one of the following:
  "angle": integer,
  "vertical": boolean
  // End of list of possible types for union field type.
}
Felder
Union-Feld type. Die Art der Drehung, vertikal oder schräg. Für type ist nur einer der folgenden Werte zulässig:
angle

integer

Der Winkel zwischen der Standardausrichtung und der gewünschten Ausrichtung. Gemessen in Grad. Gültige Werte liegen zwischen -90 und 90. Positive Winkel sind nach oben gerichtet, negative nach unten.

Hinweis: Bei einer linksläufigen Textrichtung sind positive Winkel gegen den Uhrzeigersinn, bei einer rechtsläufigen Textrichtung im Uhrzeigersinn.
vertical

boolean

Wenn „wahr“ festgelegt ist, wird der Text von oben nach unten gelesen, die Ausrichtung der einzelnen Zeichen bleibt jedoch unverändert. Beispiel:

| V |
| e |
| r |
| t |
| i |
| c |
| a |
| l |

IterativeCalculationSettings

Einstellungen, mit denen Sie festlegen können, wie Zirkelbezüge durch iterative Berechnungen aufgelöst werden.

JSON-Darstellung 
{
  "maxIterations": integer,
  "convergenceThreshold": number
}
Felder
maxIterations

integer

Wenn die iterative Berechnung aktiviert ist, die maximale Anzahl der durchzuführenden Berechnungsrunden.
convergenceThreshold

number

Wenn die iterative Berechnung aktiviert ist und sich aufeinanderfolgende Ergebnisse um weniger als diesen Grenzwert unterscheiden, werden die Berechnungsrunden beendet.

SpreadsheetTheme

Stellt das Tabellendesign dar

JSON-Darstellung 
{
  "primaryFontFamily": string,
  "themeColors": [
    {
      object (ThemeColorPair)
    }
  ]
}
Felder
primaryFontFamily

string

Name der primären Schriftfamilie.
themeColors[]

object (ThemeColorPair)

Die Farbpaare des Tabellendesigns. Zum Aktualisieren müssen Sie alle Farbpaare des Designs angeben.

ThemeColorPair

Ein Paar, das einen Tabellen-Farbtyp der Farbe zuordnet, die er darstellt.

JSON-Darstellung 
{
  "colorType": enum (ThemeColorType),
  "color": {
    object (ColorStyle)
  }
}
Felder
colorType

enum (ThemeColorType)

Der Typ der Tabellenthemenfarbe.
color

object (ColorStyle)

Die Farbe, die dem Farbtyp des Designs entspricht.

Google-Tabelle

Ein Tabellenblatt in einer Tabellenkalkulation.

JSON-Darstellung 
{
  "properties": {
    object (SheetProperties)
  },
  "data": [
    {
      object (GridData)
    }
  ],
  "merges": [
    {
      object (GridRange)
    }
  ],
  "conditionalFormats": [
    {
      object (ConditionalFormatRule)
    }
  ],
  "filterViews": [
    {
      object (FilterView)
    }
  ],
  "protectedRanges": [
    {
      object (ProtectedRange)
    }
  ],
  "basicFilter": {
    object (BasicFilter)
  },
  "charts": [
    {
      object (EmbeddedChart)
    }
  ],
  "bandedRanges": [
    {
      object (BandedRange)
    }
  ],
  "developerMetadata": [
    {
      object (DeveloperMetadata)
    }
  ],
  "rowGroups": [
    {
      object (DimensionGroup)
    }
  ],
  "columnGroups": [
    {
      object (DimensionGroup)
    }
  ],
  "slicers": [
    {
      object (Slicer)
    }
  ],
  "tables": [
    {
      object (Table)
    }
  ]
}
Felder
properties

object (SheetProperties)

Die Eigenschaften des Tabellenblatts.
data[]

object (GridData)

Daten im Raster, wenn es sich um ein Rasterblatt handelt.

Die Anzahl der zurückgegebenen GridData-Objekte hängt von der Anzahl der auf diesem Tabellenblatt angeforderten Bereiche ab. Wenn dies beispielsweise Sheet1 darstellt und die Tabelle mit den Bereichen Sheet1!A1:C10 und Sheet1!D15:E20 angefordert wurde, hat die erste GridData-Instanz 0 als startRow/startColumn, während die zweite startRow 14 (Zeile 15, Zählung ab null) und startColumn 3 (Spalte D, Zählung ab null) hat.

Bei einer DATA_SOURCE-Liste können Sie keinen bestimmten Bereich anfordern, da die GridData alle Werte enthält.
merges[]

object (GridRange)

Die zusammengeführten Bereiche.
conditionalFormats[]

object (ConditionalFormatRule)

Die Regeln für die bedingte Formatierung in diesem Tabellenblatt.
filterViews[]

object (FilterView)

Die Filteransichten in diesem Tabellenblatt.
protectedRanges[]

object (ProtectedRange)

Die geschützten Bereiche in diesem Tabellenblatt.
basicFilter

object (BasicFilter)

Der Filter auf diesem Tabellenblatt, falls vorhanden.
charts[]

object (EmbeddedChart)

Die Spezifikationen für jedes Diagramm auf diesem Tabellenblatt.
bandedRanges[]

object (BandedRange)

Die Bereiche mit Streifen (abwechselnde Farben) in dieser Tabelle.
developerMetadata[]

object (DeveloperMetadata)

Die mit einem Tabellenblatt verknüpften Entwicklermetadaten.
rowGroups[]

object (DimensionGroup)

Alle Zeilengruppen auf diesem Tabellenblatt, sortiert nach steigendem Startindex des Bereichs und dann nach Gruppentiefe.
columnGroups[]

object (DimensionGroup)

Alle Spaltengruppen auf diesem Blatt, sortiert nach steigendem Startindex des Bereichs und dann nach Gruppentiefe.
slicers[]

object (Slicer)

Die Segmentierungsoptionen auf diesem Tabellenblatt.
tables[]

object (Table)

Die Tabellen auf diesem Tabellenblatt.

SheetProperties

Eigenschaften eines Tabellenblatts

JSON-Darstellung 
{
  "sheetId": integer,
  "title": string,
  "index": integer,
  "sheetType": enum (SheetType),
  "gridProperties": {
    object (GridProperties)
  },
  "hidden": boolean,
  "tabColor": {
    object (Color)
  },
  "tabColorStyle": {
    object (ColorStyle)
  },
  "rightToLeft": boolean,
  "dataSourceSheetProperties": {
    object (DataSourceSheetProperties)
  }
}
Felder
sheetId

integer

Die ID des Tabellenblatts. Darf nicht negativ sein. Dieses Feld kann nach der Festlegung nicht mehr geändert werden.
title

string

Der Name des Tabellenblatts.
index

integer

Der Index des Tabellenblatts in der Tabelle. Wenn Sie Tabelleneigenschaften hinzufügen oder aktualisieren und dieses Feld ausschließen, wird das Tabellenblatt ans Ende der Tabellenliste verschoben oder hinzugefügt. Wenn Sie Tabellenindexe aktualisieren oder Tabellen einfügen, wird die Verschiebung in den Indexen „vor dem Verschieben“ berücksichtigt. Wenn es beispielsweise drei Tabellen (Tabelle 1, Tabelle 2, Tabelle 3) gibt, muss der Index auf 2 gesetzt werden, um Tabelle 1 vor Tabelle 2 zu verschieben. Eine Anfrage zum Aktualisieren des Tabellenindexes wird ignoriert, wenn der angeforderte Index mit dem aktuellen Index der Tabelle identisch ist oder wenn der angeforderte neue Index dem aktuellen Tabellenindex + 1 entspricht.
sheetType

enum (SheetType)

Der Typ des Tabellenblatts. Die Standardeinstellung ist GRID. Dieses Feld kann nach der Festlegung nicht mehr geändert werden.
gridProperties

object (GridProperties)

Zusätzliche Eigenschaften des Tabellenblatts, wenn es sich um ein Raster handelt. Wenn es sich bei dem Tabellenblatt um ein Objektblatt mit einem Diagramm oder Bild handelt, ist dieses Feld nicht vorhanden. Beim Schreiben ist es ein Fehler, Rastereigenschaften auf Blättern ohne Raster festzulegen.

Wenn es sich bei dieser Tabelle um eine DATA_SOURCE-Tabelle handelt, wird dieses Feld nur ausgegeben, enthält aber die Eigenschaften, die festlegen, wie eine Datenquellentabelle in der Benutzeroberfläche gerendert wird, z.B. rowCount.
hidden

boolean

„True“, wenn das Tabellenblatt in der Benutzeroberfläche ausgeblendet ist, „False“, wenn es sichtbar ist.
tabColor
(deprecated)

object (Color)

Die Farbe des Tabs in der Benutzeroberfläche. Verworfen: Verwenden Sie tabColorStyle.
tabColorStyle

object (ColorStyle)

Die Farbe des Tabs in der Benutzeroberfläche. Wenn auch tabColor festgelegt ist, hat dieses Feld Vorrang.
rightToLeft

boolean

„True“, wenn es sich bei dem Tabellenblatt um ein RTL-Tabellenblatt handelt.
dataSourceSheetProperties

object (DataSourceSheetProperties)

Nur Ausgabe. Falls vorhanden, enthält das Feld DATA_SOURCE-spezifische Eigenschaften.

SheetType

Die Art des Tabellenblatts.

Enums
SHEET_TYPE_UNSPECIFIED Standardwert, nicht verwenden
GRID Das Tabellenblatt ist ein Raster.
OBJECT Die Tabelle enthält kein Raster, sondern ein Objekt wie ein Diagramm oder ein Bild.
DATA_SOURCE Das Tabellenblatt wird mit einer externen DataSource verbunden und zeigt eine Datenvorschau an.

GridProperties

Eigenschaften eines Rasters.

JSON-Darstellung 
{
  "rowCount": integer,
  "columnCount": integer,
  "frozenRowCount": integer,
  "frozenColumnCount": integer,
  "hideGridlines": boolean,
  "rowGroupControlAfter": boolean,
  "columnGroupControlAfter": boolean
}
Felder
rowCount

integer

Die Anzahl der Zeilen im Raster.
columnCount

integer

Die Anzahl der Spalten im Raster.
frozenRowCount

integer

Die Anzahl der Zeilen, die im Raster fixiert sind.
frozenColumnCount

integer

Die Anzahl der Spalten, die im Raster fixiert sind.
hideGridlines

boolean

„True“, wenn für das Raster keine Rasterlinien in der Benutzeroberfläche angezeigt werden.
rowGroupControlAfter

boolean

„Wahr“, wenn die Ein/Aus-Schaltfläche für die Zeilengruppierung nach der Gruppe angezeigt wird.
columnGroupControlAfter

boolean

„Wahr“, wenn die Ein/Aus-Schaltfläche für die Spaltengruppierung nach der Gruppe angezeigt wird.

DataSourceSheetProperties

Zusätzliche Eigenschaften einer DATA_SOURCE-Liste.

JSON-Darstellung 
{
  "dataSourceId": string,
  "columns": [
    {
      object (DataSourceColumn)
    }
  ],
  "dataExecutionStatus": {
    object (DataExecutionStatus)
  }
}
Felder
dataSourceId

string

ID des DataSource, mit dem das Tabellenblatt verknüpft ist.
columns[]

object (DataSourceColumn)

Die Spalten auf dem Tabellenblatt, die den Werten in RowData entsprechen.
dataExecutionStatus

object (DataExecutionStatus)

Der Ausführungsstatus der Daten.

DataSourceColumn

Eine Spalte in einer Datenquelle.

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

object (DataSourceColumnReference)

Der Spaltenbezug.
formula

string

Die Formel der berechneten Spalte.

DataSourceColumnReference

Eine eindeutige Kennung, die auf eine Datenquellenspalte verweist.

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

string

Der Anzeigename der Spalte. Er muss innerhalb einer Datenquelle eindeutig sein.

DataExecutionStatus

Der Ausführungsstatus der Daten.

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

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

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

enum (DataExecutionState)

Der Status der Datenausführung.
errorCode

enum (DataExecutionErrorCode)

Den Fehlercode.
errorMessage

string

Die Fehlermeldung, die leer sein kann.
lastRefreshTime

string (Timestamp format)

Gibt an, wann die Daten zuletzt erfolgreich aktualisiert wurden.

DataExecutionState

Eine Aufzählung der Status der Datenausführung.

Enums
DATA_EXECUTION_STATE_UNSPECIFIED Standardwert, nicht verwenden
NOT_STARTED Die Datenausführung wurde noch nicht gestartet.
RUNNING Die Datenausführung wurde gestartet und ist aktiv.
CANCELLING Die Datenausführung wird derzeit abgebrochen.
SUCCEEDED Die Datenausführung wurde erfolgreich abgeschlossen.
FAILED Die Datenausführung wurde mit Fehlern abgeschlossen.

DataExecutionErrorCode

Eine Aufzählung von Fehlercodes für die Datenausführung.

Enums
DATA_EXECUTION_ERROR_CODE_UNSPECIFIED Standardwert, nicht verwenden
TIMED_OUT Zeitüberschreitung bei der Datenausführung.
TOO_MANY_ROWS Beim Ausführen der Daten 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 Fehler wird von der Back-End-Daten-Ausführungs-Engine (z.B. BigQuery) empfangen. Weitere Informationen finden Sie unter errorMessage.
PARAMETER_INVALID Einer oder mehrere der angegebenen Parameter der Datenquelle 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 wurden doppelte Spaltennamen oder Aliasse zurückgegeben.
INTERRUPTED Die Datenausführung wird unterbrochen. Bitte aktualisieren Sie die Seite später.
CONCURRENT_QUERY Die Datenausführung ist derzeit in Bearbeitung 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, setzen Sie force in RefreshDataSourceRequest.
OBJECT_SPEC_INVALID Die Datenquellenobjektspezifikation ist ungültig.
DATA_EXECUTION_CANCELLED Die Datenausführung wurde abgebrochen.

GridData

Daten im Raster sowie Metadaten zu den Dimensionen.

JSON-Darstellung 
{
  "startRow": integer,
  "startColumn": integer,
  "rowData": [
    {
      object (RowData)
    }
  ],
  "rowMetadata": [
    {
      object (DimensionProperties)
    }
  ],
  "columnMetadata": [
    {
      object (DimensionProperties)
    }
  ]
}
Felder
startRow

integer

Die erste Zeile, auf die sich diese GridData beziehen, beginnend bei null.
startColumn

integer

Die erste Spalte, auf die sich diese GridData beziehen, beginnend mit null.
rowData[]

object (RowData)

Die Daten im Raster, ein Eintrag pro Zeile, beginnend mit der Zeile in startRow. Die Werte in „RowData“ entsprechen den Spalten ab startColumn.
rowMetadata[]

object (DimensionProperties)

Metadaten zu den angeforderten Zeilen im Raster, beginnend mit der Zeile in startRow.
columnMetadata[]

object (DimensionProperties)

Metadaten zu den angeforderten Spalten im Raster, beginnend mit der Spalte in startColumn.

RowData

Daten zu jeder Zelle in einer Zeile.

JSON-Darstellung 
{
  "values": [
    {
      object (CellData)
    }
  ]
}
Felder
values[]

object (CellData)

Die Werte in der Zeile, einer pro Spalte.

CellData

Daten zu einer bestimmten Zelle.

JSON-Darstellung 
{
  "userEnteredValue": {
    object (ExtendedValue)
  },
  "effectiveValue": {
    object (ExtendedValue)
  },
  "formattedValue": string,
  "userEnteredFormat": {
    object (CellFormat)
  },
  "effectiveFormat": {
    object (CellFormat)
  },
  "hyperlink": string,
  "note": string,
  "textFormatRuns": [
    {
      object (TextFormatRun)
    }
  ],
  "dataValidation": {
    object (DataValidationRule)
  },
  "pivotTable": {
    object (PivotTable)
  },
  "dataSourceTable": {
    object (DataSourceTable)
  },
  "dataSourceFormula": {
    object (DataSourceFormula)
  }
}
Felder
userEnteredValue

object (ExtendedValue)

Der Wert, den der Nutzer in die Zelle eingegeben hat, z. B. 1234, 'Hello' oder =NOW() Hinweis: Datumsangaben, Uhrzeiten und Datumsangaben/Uhrzeiten werden im serial number-Format als Doppelwerte dargestellt.
effectiveValue

object (ExtendedValue)

Der effektive Wert der Zelle. Bei Zellen mit Formeln ist dies der berechnete Wert. Bei Zellen mit Literalen ist dies mit dem von Nutzern eingegebenen Wert identisch. Dieses Feld ist schreibgeschützt.
formattedValue

string

Der formatierte Wert der Zelle. Das ist der Wert, der dem Nutzer angezeigt wird. Dieses Feld ist schreibgeschützt.
userEnteredFormat

object (CellFormat)

Das Format, das der Nutzer für die Zelle eingegeben hat.

Beim Schreiben wird das neue Format mit dem vorhandenen Format zusammengeführt.
effectiveFormat

object (CellFormat)

Das effektive Format, das in der Zelle verwendet wird. Dazu gehören die Ergebnisse der bedingten Formatierung und, falls die Zelle eine Formel enthält, das berechnete Zahlenformat. Wenn das effektive Format das Standardformat ist, wird es nicht geschrieben. Dieses Feld ist schreibgeschützt.
note

string

Alle Notizen in der Zelle.
textFormatRuns[]

object (TextFormatRun)

Abschnitte mit Rich-Text, die auf Teilbereiche der Zelle angewendet werden. Durchläufe sind nur für von Nutzern eingegebene Strings gültig, nicht für Formeln, Boolesche Werte oder Zahlen. Die Eigenschaften eines Laufs beginnen an einem bestimmten Index im Text und dauern bis zum nächsten Lauf. Läufe übernehmen die Eigenschaften der Zelle, sofern nicht explizit etwas anderes festgelegt wird.

Beim Schreiben werden alle vorherigen Ausführungen durch die neuen Ausführungen überschrieben. Wenn Sie eine neue userEnteredValue schreiben, werden vorherige Ausführungen gelöscht.
dataValidation

object (DataValidationRule)

Eine ggf. vorhandene Datenvalidierungsregel für die Zelle.

Beim Schreiben wird die neue Regel zur Datenvalidierung über jede vorherige Regel geschrieben.
pivotTable

object (PivotTable)

Eine an dieser Zelle verankerte Pivot-Tabelle. Die Größe der Pivot-Tabelle selbst wird dynamisch basierend auf den Daten, der Gruppierung, den Filtern, den Werten usw. berechnet. Nur die Zelle links oben in der Pivot-Tabelle enthält die Definition der Pivot-Tabelle. Die anderen Zellen enthalten die berechneten Werte der Ergebnisse der Pivot-Tabelle in ihren effectiveValue-Feldern.
dataSourceTable

object (DataSourceTable)

Eine an dieser Zelle verankerte Datenquellentabelle. Die Größe der Datenquellentabelle selbst wird dynamisch anhand ihrer Konfiguration berechnet. Nur die erste Zelle der Datenquellentabelle enthält die Definition der Datenquellentabelle. Die anderen Zellen enthalten die Anzeigewerte der Datenquelle in den effectiveValue-Feldern.
dataSourceFormula

object (DataSourceFormula)

Nur Ausgabe. Informationen zu einer Datenquellenformel in der Zelle. Das Feld wird festgelegt, wenn userEnteredValue eine Formel ist, die auf ein DATA_SOURCE-Tabellenblatt verweist, z.B. =SUM(DataSheet!Column).

ExtendedValue

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

JSON-Darstellung 
{

  // Union field value can be only one of the following:
  "numberValue": number,
  "stringValue": string,
  "boolValue": boolean,
  "formulaValue": string,
  "errorValue": {
    object (ErrorValue)
  }
  // End of list of possible types for union field value.
}
Felder
Union-Feld value. Der Werttyp in einer Zelle. Wenn kein Feld festgelegt ist, enthält die Zelle keine Daten. Für value ist nur einer der folgenden Werte zulässig:
numberValue

number

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

string

Stellt einen Stringwert dar. Anführende einfache Anführungszeichen sind nicht enthalten. Wenn der Nutzer beispielsweise '123 in die Benutzeroberfläche eingibt, wird dies als stringValue von "123" dargestellt.
boolValue

boolean

Stellt einen booleschen Wert dar.
formulaValue

string

Stellt eine Formel dar.
errorValue

object (ErrorValue)

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

ErrorValue

Ein Fehler in einer Zelle.

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

enum (ErrorType)

Die Art des Fehlers.
message

string

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

ErrorType

Die Art des Fehlers.

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

TextFormatRun

Ein Lauf eines Textformats. Das Format dieses Laufs wird bis zum Startindex des nächsten Laufs fortgesetzt. Beim Aktualisieren müssen alle Felder festgelegt werden.

JSON-Darstellung 
{
  "startIndex": integer,
  "format": {
    object (TextFormat)
  }
}
Felder
startIndex

integer

Der nullbasierte Zeichenindex, an dem diese Ausführung beginnt, in UTF-16-Codeeinheiten.
format

object (TextFormat)

Das Format dieses Laufs. Fehlende Werte übernehmen das Format der Zelle.

DataValidationRule

Eine Datenvalidierungsregel.

JSON-Darstellung 
{
  "condition": {
    object (BooleanCondition)
  },
  "inputMessage": string,
  "strict": boolean,
  "showCustomUi": boolean
}
Felder
condition

object (BooleanCondition)

Die Bedingung, die die Daten in der Zelle erfüllen müssen.
inputMessage

string

Eine Nachricht, die dem Nutzer angezeigt wird, wenn er Daten in die Zelle einfügt.
strict

boolean

„Wahr“, wenn ungültige Daten abgelehnt werden sollen.
showCustomUi

boolean

„Wahr“, wenn die Benutzeroberfläche je nach Art der Bedingung angepasst werden soll. Wenn „wahr“ festgelegt ist, wird für „Liste“-Bedingungen ein Drop-down-Menü angezeigt.

BooleanCondition

Eine Bedingung, die als „wahr“ oder „falsch“ ausgewertet werden kann. Boolesche Bedingungen werden für die bedingte Formatierung, die Datenvalidierung und die Kriterien in Filtern verwendet.

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

enum (ConditionType)

Der Typ der Bedingung.
values[]

object (ConditionValue)

Die Werte der Bedingung. Die Anzahl der unterstützten Werte hängt von condition type ab. Einige unterstützen Nullwerte, andere einen oder zwei Werte und ConditionType.ONE_OF_LIST 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, bedingte Formatierung und Filter auf Objekten, die keine Datenquellen sind, und mindestens ein ConditionValue für Filter auf Datenquellenobjekten.
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, bedingte Formatierung und Filter auf Objekten, die keine Datenquellen sind, und mindestens ein ConditionValue für Filter auf Datenquellenobjekten.
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 nicht den Wert der Bedingung enthalten. Unterstützt durch Datenvalidierung, bedingte Formatierung und Filter. Erfordert eine einzelne ConditionValue.
TEXT_STARTS_WITH Der Wert der Zelle muss mit dem Wert der Bedingung beginnen. Unterstützt durch bedingte Formatierung und Filter. Erfordert eine einzelne ConditionValue.
TEXT_ENDS_WITH Der Wert der Zelle muss mit dem Wert der Bedingung enden. Unterstützt durch bedingte Formatierung und Filter. Erfordert eine einzelne ConditionValue.
TEXT_EQ Der Wert der Zelle muss genau mit dem Wert der Bedingung übereinstimmen. Unterstützt durch Datenvalidierung, bedingte Formatierung und Filter. Erfordert ein einzelnes ConditionValue für die Datenvalidierung, bedingte Formatierung und Filter auf Objekten, die keine Datenquellen sind, und mindestens ein ConditionValue für Filter auf Datenquellenobjekten.
TEXT_IS_EMAIL Der Wert der Zelle muss eine gültige E-Mail-Adresse sein. Unterstützt durch Datenvalidierung. Erfordert keine ConditionValues.
TEXT_IS_URL Der Wert der Zelle muss eine gültige URL sein. Unterstützt durch Datenvalidierung. Erfordert keine ConditionValues.
DATE_EQ Der Wert der Zelle muss mit dem Wert der Bedingung übereinstimmen. Unterstützt durch Datenvalidierung, bedingte Formatierung und Filter. Erfordert ein einzelnes ConditionValue für die Datenvalidierung, bedingte Formatierung und Filter auf Objekten, die keine Datenquellen sind, und mindestens ein ConditionValue für Filter auf Datenquellenobjekten.
DATE_BEFORE Der Wert der Zelle muss vor dem Datum des Werts der Bedingung liegen. Unterstützt durch Datenvalidierung, bedingte Formatierung und Filter. Erfordert eine einzelne ConditionValue, die auch eine relative date sein kann.
DATE_AFTER Der Wert der Zelle muss nach dem Datum des Werts der Bedingung liegen. Unterstützt durch Datenvalidierung, bedingte Formatierung und Filter. Erfordert eine einzelne ConditionValue, die auch eine relative date sein kann.
DATE_ON_OR_BEFORE Der Wert der Zelle muss vor oder am Datum des Werts der Bedingung liegen. Unterstützt durch Datenvalidierung. Erfordert eine einzelne ConditionValue, die auch eine relative date sein kann.
DATE_ON_OR_AFTER Der Wert der Zelle muss auf oder nach dem Datum des Werts der Bedingung liegen. Unterstützt durch Datenvalidierung. Erfordert eine einzelne ConditionValue, die auch eine relative date sein kann.
DATE_BETWEEN Der Wert der Zelle muss zwischen den beiden Datumsangaben liegen. Unterstützt durch Datenvalidierung. Es sind genau zwei ConditionValues erforderlich.
DATE_NOT_BETWEEN Der Wert der Zelle muss außerhalb der beiden Datumswerte liegen. Unterstützt durch Datenvalidierung. Es sind genau zwei ConditionValues erforderlich.
DATE_IS_VALID Der Wert der Zelle muss ein Datum sein. Unterstützt durch Datenvalidierung. Erfordert keine ConditionValues.
ONE_OF_RANGE Der Wert der Zelle muss im Raster im Bereich des Bedingungswerts aufgeführt sein. Unterstützt durch Datenvalidierung. Es ist nur ein einzelnes ConditionValue zulässig und der Wert muss ein gültiger Bereich in A1-Notation sein.
ONE_OF_LIST Der Wert der Zelle muss in der Liste der Bedingungswerte enthalten sein. Unterstützt durch Datenvalidierung. Unterstützt eine beliebige Anzahl von condition values, eine pro Element in der Liste. Formeln werden in den Werten nicht unterstützt.
BLANK Der Wert der Zelle muss leer sein. Unterstützt durch bedingte Formatierung und Filter. Erfordert 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 von Tabellenfiltern für Datenquellen nicht unterstützt. Erfordert eine einzelne ConditionValue.
BOOLEAN Der Wert der Zelle muss WAHR/FALSE sein oder in der Liste der Bedingungswerte enthalten sein. Unterstützt durch Datenvalidierung. Wird als Kästchen in einer Zelle gerendert. Unterstützt null, ein oder zwei ConditionValues. Wenn keine Werte angegeben sind, muss die Zelle TRUE oder FALSE enthalten. TRUE wird als angeklickt und FALSE als nicht angeklickt dargestellt. Ein Wert gibt an, dass die Zelle angeklickt dargestellt wird, wenn sie diesen Wert enthält, und nicht angeklickt, wenn sie leer ist. Zwei Werte geben an, dass die Zelle angeklickt dargestellt wird, wenn sie den ersten Wert enthält, und nicht angeklickt, wenn sie den zweiten Wert enthält. Mit [„Ja“, „Nein“] wird beispielsweise angegeben, dass in der Zelle ein Häkchen angezeigt wird, wenn der Wert „Ja“ ist, und ein leeres Kästchen, wenn der Wert „Nein“ ist.
TEXT_NOT_EQ Der Wert der Zelle darf nicht genau mit dem Wert der Bedingung übereinstimmen. Wird von Filtern auf Datenquellenobjekten unterstützt. Es ist mindestens ein ConditionValue erforderlich.
DATE_NOT_EQ Der Wert der Zelle darf nicht genau mit dem Wert der Bedingung übereinstimmen. Wird von Filtern auf Datenquellenobjekten unterstützt. Es ist mindestens ein ConditionValue erforderlich.
FILTER_EXPRESSION Der Wert der Zelle muss dem angegebenen Muster entsprechen. Erfordert eine einzelne ConditionValue.

ConditionValue

Der Wert der Bedingung.

JSON-Darstellung 
{

  // Union field value can be only one of the following:
  "relativeDate": enum (RelativeDate),
  "userEnteredValue": string
  // End of list of possible types for union field value.
}
Felder
Union-Feld value. Der Wert der Bedingung. Es muss genau einer festgelegt werden. Für value ist nur einer der folgenden Werte zulässig:
relativeDate

enum (RelativeDate)

Ein relatives Datum (basierend auf dem aktuellen Datum). Nur gültig, 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 = oder „+“ beginnen.

RelativeDate

Hiermit wird festgelegt, wie eine Datumsbedingung ausgewertet wird.

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

PivotTable

Eine Pivot-Tabelle.

JSON-Darstellung 
{
  "rows": [
    {
      object (PivotGroup)
    }
  ],
  "columns": [
    {
      object (PivotGroup)
    }
  ],
  "criteria": {
    integer: {
      object (PivotFilterCriteria)
    },
    ...
  },
  "filterSpecs": [
    {
      object (PivotFilterSpec)
    }
  ],
  "values": [
    {
      object (PivotValue)
    }
  ],
  "valueLayout": enum (PivotValueLayout),
  "dataExecutionStatus": {
    object (DataExecutionStatus)
  },

  // Union field source_data can be only one of the following:
  "source": {
    object (GridRange)
  },
  "dataSourceId": string
  // End of list of possible types for union field source_data.
}
Felder
rows[]

object (PivotGroup)

Jede Zeilengruppierung in der Pivot-Tabelle.
columns[]

object (PivotGroup)

Jede Spaltengruppierung in der Pivot-Tabelle.
criteria
(deprecated)

map (key: integer, value: object (PivotFilterCriteria))

Optionale Zuordnung von Filtern pro Offset der Quellspalte.

Die Filter werden angewendet, bevor Daten in der Pivot-Tabelle zusammengefasst werden. Der Schlüssel der Zuordnung ist der Spaltenoffset des Quellbereichs, den Sie filtern möchten, und der Wert sind die Kriterien für diese Spalte.

Wenn die Quelle beispielsweise C10:E15 ist, enthält der Schlüssel 0 den Filter für die Spalte C, während der Schlüssel 1 für die Spalte D gilt.

Dieses Feld wird zugunsten von filterSpecs eingestellt.
filterSpecs[]

object (PivotFilterSpec)

Die Filter, die auf die Quellspalten angewendet wurden, bevor Daten für die Pivot-Tabelle aggregiert wurden.

Sowohl criteria als auch filterSpecs werden in Antworten eingefügt. Wenn beide Felder in einer Aktualisierungsanfrage angegeben sind, hat dieses Feld Vorrang.
values[]

object (PivotValue)

Eine Liste der Werte, die in die Pivot-Tabelle aufgenommen werden sollen.
valueLayout

enum (PivotValueLayout)

Ob die Werte horizontal (als Spalten) oder vertikal (als Zeilen) aufgelistet werden sollen.
dataExecutionStatus

object (DataExecutionStatus)

Nur Ausgabe. Der Status der Datenausführung für Datenquellen-Pivot-Tabellen.
Union-Feld source_data. Die Quelle der Pivot-Tabellendaten. Für source_data ist nur einer der folgenden Werte zulässig:
source

object (GridRange)

Der Bereich, aus dem die Pivot-Tabelle Daten liest.
dataSourceId

string

Die ID der Datenquelle, aus der die Pivot-Tabelle Daten liest.

GridRange

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

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

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

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

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

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

Sheet1 == sheetId: 123456

Der Startindex darf nicht größer sein als der Endindex. Wenn der Startindex mit dem Endindex übereinstimmt, ist der Bereich leer. Leere Bereiche sind in der Regel nicht aussagekräftig und werden in der Benutzeroberfläche normalerweise als #REF! dargestellt.

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

integer

Das Tabellenblatt, in dem sich der Bereich befindet.
startRowIndex

integer

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

integer

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

integer

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

integer

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

PivotGroup

Eine einzelne Gruppierung (Zeile oder Spalte) in einer Pivot-Tabelle.

JSON-Darstellung 
{
  "showTotals": boolean,
  "valueMetadata": [
    {
      object (PivotGroupValueMetadata)
    }
  ],
  "sortOrder": enum (SortOrder),
  "valueBucket": {
    object (PivotGroupSortValueBucket)
  },
  "repeatHeadings": boolean,
  "label": string,
  "groupRule": {
    object (PivotGroupRule)
  },
  "groupLimit": {
    object (PivotGroupLimit)
  },

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

boolean

„Wahr“, wenn die Pivot-Tabelle die Gesamtwerte für diese Gruppierung enthalten soll.
valueMetadata[]

object (PivotGroupValueMetadata)

Metadaten zu Werten in der Gruppierung.
sortOrder

enum (SortOrder)

Die Reihenfolge, in der die Werte in dieser Gruppe sortiert werden sollen.
valueBucket

object (PivotGroupSortValueBucket)

Der Bucket der gegenüberliegenden Pivot-Gruppe, nach dem sortiert werden soll. Wenn keine Angabe erfolgt, erfolgt die Sortierung alphabetisch nach den Werten dieser Gruppe.
repeatHeadings

boolean

„Wahr“, wenn die Überschriften in dieser Pivot-Gruppe wiederholt werden sollen. Diese Option ist nur für Zeilengruppierungen gültig und wird für Spalten ignoriert.

Standardmäßig minimieren wir die Wiederholung von Überschriften, indem wir Überschriften höherer Ebene nicht anzeigen, wenn sie identisch sind. Obwohl die dritte Zeile unten beispielsweise „Q1 März“ entspricht, wird „Q1“ nicht angezeigt, da sie mit den vorherigen Zeilen übereinstimmt. Wenn Sie „repeatHeadings“ auf „true“ setzen, wird „Q1“ für „Feb“ und „Mar“ wiederholt.

+--------------+
| Q1     | Jan |
|        | Feb |
|        | Mar |
+--------+-----+
| Q1 Total     |
+--------------+
label

string

Die Labels für die Zeilen-/Spaltengruppen, die angepasst werden können. In der folgenden Pivot-Tabelle lautet das Zeilenlabel beispielsweise Region (kann in State umbenannt werden) und das Spaltenlabel Product (kann in Item umbenannt werden). Pivot-Tabellen, die vor Dezember 2017 erstellt wurden, haben keine Kopfzeilenlabels. Wenn Sie einer vorhandenen Pivot-Tabelle Kopfzeilenlabels hinzufügen möchten, löschen Sie die vorhandene Pivot-Tabelle und erstellen Sie dann eine neue Pivot-Tabelle mit denselben Parametern.

+--------------+---------+-------+
| SUM of Units | Product |       |
| Region       | Pen     | Paper |
+--------------+---------+-------+
| New York     |     345 |    98 |
| Oregon       |     234 |   123 |
| Tennessee    |     531 |   415 |
+--------------+---------+-------+
| Grand Total  |    1110 |   636 |
+--------------+---------+-------+
groupRule

object (PivotGroupRule)

Die Gruppenregel, die auf diese Zeilen-/Spaltengruppe angewendet werden soll.
groupLimit

object (PivotGroupLimit)

Die maximale Anzahl von Zeilen oder Spalten, die auf diese Pivot-Gruppe angewendet werden soll.
Union-Feld source. Die Datenquelle der Pivot-Gruppe. Für source ist nur einer der folgenden Werte zulässig:
sourceColumnOffset

integer

Der Spaltenoffset des Quellbereichs, auf dem diese Gruppierung basiert.

Wenn die Quelle beispielsweise C10:E15 ist, bedeutet ein sourceColumnOffset von 0, dass sich diese Gruppe auf Spalte C bezieht, während der Offset 1 auf Spalte D verweist.
dataSourceColumnReference

object (DataSourceColumnReference)

Der Verweis auf die Datenquellenspalte, auf der diese Gruppierung basiert.

PivotGroupValueMetadata

Metadaten zu einem Wert in einer Pivot-Gruppierung.

JSON-Darstellung 
{
  "value": {
    object (ExtendedValue)
  },
  "collapsed": boolean
}
Felder
value

object (ExtendedValue)

Der berechnete Wert, dem die Metadaten entsprechen. Hinweis: formulaValue ist ungültig, da die Werte berechnet werden.
collapsed

boolean

„True“, wenn die Daten, die dem Wert entsprechen, minimiert sind.

SortOrder

Eine Sortierreihenfolge.

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

PivotGroupSortValueBucket

Informationen dazu, welche Werte in einer Pivot-Gruppe zum Sortieren verwendet werden sollen.

JSON-Darstellung 
{
  "valuesIndex": integer,
  "buckets": [
    {
      object (ExtendedValue)
    }
  ]
}
Felder
valuesIndex

integer

Der Offset in der Liste PivotTable.values, nach dem die Werte in dieser Gruppierung sortiert werden sollen.
buckets[]

object (ExtendedValue)

Bestimmt den Bucket, aus dem Werte für die Sortierung ausgewählt werden.

In einer Pivot-Tabelle mit einer Zeilengruppe und zwei Spaltengruppen können beispielsweise bis zu zwei Werte in der Zeilengruppe aufgeführt werden. Der erste Wert entspricht einem Wert in der ersten Spaltengruppe und der zweite Wert einem Wert in der zweiten Spaltengruppe. Wenn keine Werte aufgeführt sind, sollte die Zeile nach dem Gesamtwert über die Spaltengruppen sortiert werden. Wenn nur ein Wert aufgeführt ist, entspricht dies der Verwendung des Gesamtwerts dieses Buckets.

PivotGroupRule

Eine optionale Einstellung für PivotGroup, mit der Buckets für die Werte in der Quelldatenspalte definiert werden, anstatt jeden einzelnen Wert aufzuschlüsseln. Pro Spalte in den Quelldaten kann nur eine PivotGroup mit einer Gruppenregel hinzugefügt werden. Sie können jedoch jeder Spalte sowohl eine PivotGroup mit einer Regel als auch eine PivotGroup ohne Regel hinzufügen.

JSON-Darstellung 
{

  // Union field rule can be only one of the following:
  "manualRule": {
    object (ManualRule)
  },
  "histogramRule": {
    object (HistogramRule)
  },
  "dateTimeRule": {
    object (DateTimeRule)
  }
  // End of list of possible types for union field rule.
}
Felder
Union-Feld rule. Die Regel, die auf die PivotGroup angewendet werden soll. Für rule ist nur einer der folgenden Werte zulässig:
manualRule

object (ManualRule)

Ein ManualRule.
histogramRule

object (HistogramRule)

Ein HistogramRule.
dateTimeRule

object (DateTimeRule)

Ein DateTimeRule.

ManualRule

Hiermit können Sie die Werte in einer Quelldatenspalte manuell in Bucket mit von Ihnen gewählten Namen organisieren. Beispiel: Eine Pivot-Tabelle, in der die Bevölkerung nach Bundesstaat zusammengefasst wird:

+-------+-------------------+
| State | SUM of Population |
+-------+-------------------+
| AK    |               0.7 |
| AL    |               4.8 |
| AR    |               2.9 |
...
+-------+-------------------+

kann in eine Pivot-Tabelle umgewandelt werden, in der die Bevölkerung nach Zeitzone zusammengefasst wird. Dazu muss einer manuellen Gruppenregel eine Liste von Gruppen (z. B. groupName = 'Central', items = ['AL', 'AR', 'IA', ...]) zugewiesen werden. Ein ähnlicher Effekt kann auch erzielt werden, indem Sie den Quelldaten eine Zeitzonenspalte hinzufügen und die Pivot-Tabelle anpassen.

+-----------+-------------------+
| Time Zone | SUM of Population |
+-----------+-------------------+
| Central   |             106.3 |
| Eastern   |             151.9 |
| Mountain  |              17.4 |
...
+-----------+-------------------+
JSON-Darstellung 
{
  "groups": [
    {
      object (ManualRuleGroup)
    }
  ]
}
Felder
groups[]

object (ManualRuleGroup)

Die Liste der Gruppennamen und die entsprechenden Elemente aus den Quelldaten, die den einzelnen Gruppennamen zugeordnet sind.

ManualRuleGroup

Ein Gruppenname und eine Liste der Elemente aus den Quelldaten, die in die Gruppe mit diesem Namen aufgenommen werden sollen.

JSON-Darstellung 
{
  "groupName": {
    object (ExtendedValue)
  },
  "items": [
    {
      object (ExtendedValue)
    }
  ]
}
Felder
groupName

object (ExtendedValue)

Der Gruppenname, der ein String sein muss. Jede Gruppe in einer bestimmten ManualRule muss einen eindeutigen Gruppennamen haben.
items[]

object (ExtendedValue)

Die Elemente in den Quelldaten, die in diese Gruppe aufgenommen werden sollen. Jedes Element kann ein String, eine Zahl oder ein boolescher Wert sein. Elemente können in einer bestimmten ManualRule höchstens in einer Gruppe erscheinen. Elemente, die in keiner Gruppe enthalten sind, werden einzeln angezeigt.

HistogramRule

Hiermit können Sie die numerischen Werte in einer Quelldatenspalte in Bins mit konstanter Größe organisieren. Alle Werte von HistogramRule.start bis HistogramRule.end werden in Gruppen mit der Größe HistogramRule.interval eingeteilt. Außerdem werden alle Werte unter HistogramRule.start in eine Gruppe und alle Werte über HistogramRule.end in eine andere Gruppe eingeordnet. Nur HistogramRule.interval ist erforderlich. Wenn sowohl HistogramRule.start als auch HistogramRule.end angegeben sind, muss HistogramRule.start kleiner als HistogramRule.end sein. Beispiel: Eine Pivot-Tabelle mit dem durchschnittlichen Kaufbetrag nach Alter mit mehr als 50 Zeilen:

+-----+-------------------+
| Age | AVERAGE of Amount |
+-----+-------------------+
| 16  |            $27.13 |
| 17  |             $5.24 |
| 18  |            $20.15 |
...
+-----+-------------------+

kann in eine Pivot-Tabelle wie die unten gezeigte umgewandelt werden, indem eine Histogrammgruppenregel mit einer HistogramRule.start von 25, einer HistogramRule.interval von 20 und einer HistogramRule.end von 65 angewendet wird.

+-------------+-------------------+
| Grouped Age | AVERAGE of Amount |
+-------------+-------------------+
| < 25        |            $19.34 |
| 25-45       |            $31.43 |
| 45-65       |            $35.87 |
| > 65        |            $27.55 |
+-------------+-------------------+
| Grand Total |            $29.12 |
+-------------+-------------------+
JSON-Darstellung 
{
  "interval": number,
  "start": number,
  "end": number
}
Felder
interval

number

Die Größe der erstellten Buckets. Muss positiv sein.
start

number

Der Mindestwert, bei dem Elemente in Buckets mit konstanter Größe eingeordnet werden. Werte unter dem Startwert werden in einem einzigen Bucket zusammengefasst. Dieses Feld ist optional.
end

number

Der Maximalwert, bei dem Elemente in Buckets mit konstanter Größe eingeordnet werden. Werte über dem Endwert werden in einem einzigen Bucket zusammengefasst. Dieses Feld ist optional.

DateTimeRule

Hiermit können Sie die Datums-/Uhrzeitwerte in einer Quelldatenspalte anhand ausgewählter Teile ihrer Datums- oder Uhrzeitwerte in Bucket sortieren. Angenommen, Sie haben eine Pivot-Tabelle mit Verkaufstransaktionen nach Datum:

+----------+--------------+
| Date     | SUM of Sales |
+----------+--------------+
| 1/1/2017 |      $621.14 |
| 2/3/2017 |      $708.84 |
| 5/8/2017 |      $326.84 |
...
+----------+--------------+

Wenn Sie eine Datums-/Uhrzeitgruppenregel mit YEAR_MONTH als DateTimeRuleType anwenden, erhalten Sie die folgende Pivot-Tabelle.

+--------------+--------------+
| Grouped Date | SUM of Sales |
+--------------+--------------+
| 2017-Jan     |   $53,731.78 |
| 2017-Feb     |   $83,475.32 |
| 2017-Mar     |   $94,385.05 |
...
+--------------+--------------+
JSON-Darstellung 
{
  "type": enum (DateTimeRuleType)
}
Felder
type

enum (DateTimeRuleType)

Der Typ der Datum/Uhrzeit-Gruppierung, der angewendet werden soll.

DateTimeRuleType

Die verfügbaren Typen von Gruppierungsregeln für Datum und Uhrzeit. In dieser Dokumentation wird davon ausgegangen, dass die Sprache der Tabelle „en-US“ ist. Für einige Regeltypen wird jedoch die Sprache der Tabelle für die tatsächliche Darstellung der Datumsangaben und Uhrzeiten verwendet.

Enums
DATE_TIME_RULE_TYPE_UNSPECIFIED Der Standardtyp, nicht verwenden.
SECOND Datumsangaben nach Sekunden von 0 bis 59 gruppieren.
MINUTE Datumsangaben nach Minuten gruppieren, von 0 bis 59.
HOUR Gruppieren Sie Datumsangaben nach Stunden im 24-Stunden-Format von 0 bis 23.
HOUR_MINUTE Gruppieren Sie Datumsangaben nach Stunde und Minute im 24-Stunden-System, z. B. 19:45.
HOUR_MINUTE_AMPM Gruppieren Sie Datumsangaben nach Stunde und Minute im 12-Stunden-Format, z. B. 19:45 Uhr. Die Angabe von „Vormittags“ und „Nachmittags“ wird basierend auf dem Gebietsschema der Tabelle übersetzt.
DAY_OF_WEEK Datumsangaben nach Wochentag gruppieren, z. B. Sonntag Die Wochentage werden basierend auf dem Gebietsschema der Tabelle übersetzt.
DAY_OF_YEAR Datumsangaben nach dem Tag des Jahres gruppieren, von 1 bis 366. Beachten Sie, dass Datumsangaben nach dem 29. Februar in Schaltjahren in andere Kategorien fallen als in Nicht-Schaltjahren.
DAY_OF_MONTH Gruppieren Sie Datumsangaben nach dem Tag des Monats (1 bis 31).
DAY_MONTH Gruppieren Sie Datumsangaben nach Tag und Monat, z. B. 22-Nov. Der Monat wird basierend auf dem Gebietsschema der Tabelle übersetzt.
MONTH Gruppieren Sie die Datumsangaben nach Monat, z. B. November. Der Monat wird basierend auf dem Gebietsschema der Tabelle übersetzt.
QUARTER Gruppieren Sie die Daten nach Quartal, z. B. Q1 (Januar bis März).
YEAR Gruppieren Sie Datumsangaben nach Jahr, z. B. 2008.
YEAR_MONTH Gruppieren Sie Datumsangaben nach Jahr und Monat, z. B. 2008-Nov. Der Monat wird basierend auf dem Gebietsschema der Tabelle übersetzt.
YEAR_QUARTER Gruppieren Sie die Daten nach Jahr und Quartal, z. B. 2008 Q4.
YEAR_MONTH_DAY Gruppieren Sie Datumsangaben nach Jahr, Monat und Tag, z. B. 22.11.2008.

PivotGroupLimit

Die maximale Anzahl von Zeilen oder Spalten in der Pivot-Gruppe.

JSON-Darstellung 
{
  "countLimit": integer,
  "applyOrder": integer
}
Felder
countLimit

integer

Die maximale Anzahl.
applyOrder

integer

Die Reihenfolge, in der das Gruppenlimit auf die Pivot-Tabelle angewendet wird.

Die Limits für Pivot-Gruppen werden von der niedrigeren zur höheren Ordnungszahl angewendet. Bestellnummern werden auf aufeinanderfolgende Ganzzahlen von 0 normalisiert.

Bei Schreibanfragen müssen alle Grenzwerte für Pivot-Gruppen in diesem Feld mit einer eindeutigen Zahl festgelegt sein, damit die anwendbaren Reihenfolgen vollständig angepasst werden können. Andernfalls wird die Reihenfolge durch den Index in der Liste PivotTable.rows und dann in der Liste PivotTable.columns bestimmt.

PivotFilterCriteria

Kriterien für das Ein-/Ausblenden von Zeilen in einer Pivot-Tabelle.

JSON-Darstellung 
{
  "visibleValues": [
    string
  ],
  "condition": {
    object (BooleanCondition)
  },
  "visibleByDefault": boolean
}
Felder
visibleValues[]

string

Werte, die enthalten sein sollten. Nicht hier aufgeführte Werte werden ausgeschlossen.
condition

object (BooleanCondition)

Eine Bedingung, die erfüllt sein muss, damit Werte angezeigt werden. visibleValues überschreibt dies nicht. Selbst wenn ein Wert dort aufgeführt ist, wird er ausgeblendet, wenn er die Bedingung nicht erfüllt.

Bedingungswerte, die sich auf Bereiche in A1-Notation beziehen, werden relativ zum Blatt der Pivot-Tabelle ausgewertet. Verweise werden absolut behandelt und nicht in die gesamte Pivot-Tabelle kopiert. Ein Bedingungswert von =A1 in „Pivot-Tabelle 1“ wird beispielsweise als 'Pivot Table 1'!$A$1 behandelt.

Auf die Quelldaten der Pivot-Tabelle kann über den Namen der Spaltenüberschrift verwiesen werden. Wenn die Quelldaten beispielsweise die Spalten „Umsatz“ und „Kosten“ enthalten und auf die Spalte „Umsatz“ eine Bedingung vom Typ NUMBER_GREATER und mit dem Wert =Cost angewendet wird, werden nur Spalten berücksichtigt, in denen „Umsatz“ > „Kosten“ ist.
visibleByDefault

boolean

Ob Werte standardmäßig sichtbar sind. Wenn diese Option aktiviert ist, werden die visibleValues ignoriert und alle Werte angezeigt, die condition (falls angegeben) erfüllen. Wenn „falsch“ festgelegt ist, werden Werte angezeigt, die sowohl in visibleValues enthalten sind als auch condition erfüllen.

PivotFilterSpec

Die Filterkriterien für die Pivot-Tabelle, die mit einem bestimmten Offset der Quellspalte verknüpft sind.

JSON-Darstellung 
{
  "filterCriteria": {
    object (PivotFilterCriteria)
  },

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

object (PivotFilterCriteria)

Die Kriterien für die Spalte.
Union-Feld source. Die Quellspalte, auf die dieser Filter angewendet wird. Für source ist nur einer der folgenden Werte zulässig:
columnOffsetIndex

integer

Der nullbasierte Spaltenoffset des Quellbereichs.
dataSourceColumnReference

object (DataSourceColumnReference)

Der Verweis auf die Datenquellenspalte.

PivotValue

Die Definition, wie ein Wert in einer Pivot-Tabelle berechnet werden soll.

JSON-Darstellung 
{
  "summarizeFunction": enum (PivotValueSummarizeFunction),
  "name": string,
  "calculatedDisplayType": enum (PivotValueCalculatedDisplayType),

  // Union field value can be only one of the following:
  "sourceColumnOffset": integer,
  "formula": string,
  "dataSourceColumnReference": {
    object (DataSourceColumnReference)
  }
  // End of list of possible types for union field value.
}
Felder
summarizeFunction

enum (PivotValueSummarizeFunction)

Eine Funktion, mit der der Wert zusammengefasst wird. Wenn formula festgelegt ist, sind nur die Werte SUM und CUSTOM zulässig. Wenn sourceColumnOffset festgelegt ist, wird CUSTOM nicht unterstützt.
name

string

Ein Name, der für den Wert verwendet werden soll.
calculatedDisplayType

enum (PivotValueCalculatedDisplayType)

Wenn diese Option angegeben ist, werden Pivot-Werte als Ergebnis einer Berechnung mit einem anderen Pivot-Wert angezeigt. Wenn Sie beispielsweise „PERCENT_OF_GRAND_TOTAL“ als „calculatedDisplayType“ angeben, werden alle Pivot-Werte als Prozentsatz des Gesamtwerts angezeigt. Im Editor von Google Tabellen wird dies im Wertbereich einer Pivot-Tabelle als „Als anzeigen“ bezeichnet.
Union-Feld value. Die Daten, die für die Werte in der Pivot-Tabelle verwendet werden sollen. Es muss genau ein Wert festgelegt werden. Für value ist nur einer der folgenden Werte zulässig:
sourceColumnOffset

integer

Der Spaltenoffset des Quellbereichs, aus dem dieser Wert gelesen wird.

Wenn die Quelle beispielsweise C10:E15 ist, bedeutet ein sourceColumnOffset von 0, dass sich dieser Wert auf Spalte C bezieht, während der Offset 1 sich auf Spalte D bezieht.
formula

string

Eine benutzerdefinierte Formel zur Berechnung des Werts. Die Formel muss mit dem Zeichen = beginnen.
dataSourceColumnReference

object (DataSourceColumnReference)

Der Verweis auf die Datenquellenspalte, aus der dieser Wert gelesen wird.

PivotValueSummarizeFunction

Eine Funktion zum Zusammenfassen eines Pivot-Werts.

Enums
PIVOT_STANDARD_VALUE_FUNCTION_UNSPECIFIED Standardeinstellung, nicht verwenden.
SUM Entspricht der Funktion SUM.
COUNTA Entspricht der Funktion COUNTA.
COUNT Entspricht der Funktion COUNT.
COUNTUNIQUE Entspricht der Funktion COUNTUNIQUE.
AVERAGE Entspricht der Funktion AVERAGE.
MAX Entspricht der Funktion MAX.
MIN Entspricht der Funktion MIN.
MEDIAN Entspricht der Funktion MEDIAN.
PRODUCT Entspricht der Funktion PRODUCT.
STDEV Entspricht der Funktion STDEV.
STDEVP Entspricht der Funktion STDEVP.
VAR Entspricht der Funktion VAR.
VARP Entspricht der Funktion VARP.
CUSTOM Gibt an, dass die Formel unverändert verwendet werden soll. Nur gültig, wenn PivotValue.formula festgelegt wurde.
NONE Gibt an, dass der Wert bereits zusammengefasst wurde und die Zusammenfassungsfunktion nicht explizit angegeben ist. Wird für Pivot-Tabellen der Looker-Datenquelle verwendet, in denen der Wert bereits zusammengefasst ist.

PivotValueCalculatedDisplayType

Die möglichen Berechnungsmethoden für Pivot-Werte.

Enums
PIVOT_VALUE_CALCULATED_DISPLAY_TYPE_UNSPECIFIED Standardwert, nicht verwenden
PERCENT_OF_ROW_TOTAL Die Pivot-Werte werden als Prozentsatz der Zeilengesamtwerte angezeigt.
PERCENT_OF_COLUMN_TOTAL Die Pivot-Werte werden als Prozentsatz der Werte der Spaltensumme angezeigt.
PERCENT_OF_GRAND_TOTAL Die Pivot-Werte werden als Prozentsatz der Werte der Gesamtsumme angezeigt.

PivotValueLayout

Das Layout der Pivot-Werte.

Enums
HORIZONTAL Die Werte werden horizontal (als Spalten) angeordnet.
VERTICAL Die Werte werden vertikal (als Zeilen) angeordnet.

DataSourceTable

Eine Datenquellentabelle, mit der Nutzer eine statische Datentabelle aus der DataSource in Google Tabellen importieren können. Im Editor von Google Tabellen wird dies auch als „Extrahieren“ bezeichnet.

JSON-Darstellung 
{
  "dataSourceId": string,
  "columnSelectionType": enum (DataSourceTableColumnSelectionType),
  "columns": [
    {
      object (DataSourceColumnReference)
    }
  ],
  "filterSpecs": [
    {
      object (FilterSpec)
    }
  ],
  "sortSpecs": [
    {
      object (SortSpec)
    }
  ],
  "rowLimit": integer,
  "dataExecutionStatus": {
    object (DataExecutionStatus)
  }
}
Felder
dataSourceId

string

Die ID der Datenquelle, der die Datenquellentabelle zugeordnet ist.
columnSelectionType

enum (DataSourceTableColumnSelectionType)

Der Typ, mit dem Spalten für die Datenquellentabelle ausgewählt werden. Die Standardeinstellung ist SELECTED.
columns[]

object (DataSourceColumnReference)

Spalten, die für die Datenquellentabelle ausgewählt wurden. Der columnSelectionType muss SELECTED lauten.
filterSpecs[]

object (FilterSpec)

Filtern Sie die Spezifikationen in der Tabelle der Datenquelle.
sortSpecs[]

object (SortSpec)

Sortierungsspezifikationen in der Datenquellentabelle Das Ergebnis der Datenquellentabelle wird anhand der Sortierungsspezifikationen sortiert.
rowLimit

integer

Die maximale Anzahl der zurückzugebenden Zeilen. Wenn keine Angabe erfolgt, wird ein Standardlimit angewendet. Die Standard- und Maximalwerte finden Sie im Tabelleneditor.
dataExecutionStatus

object (DataExecutionStatus)

Nur Ausgabe. Der Ausführungsstatus der Daten.

DataSourceTableColumnSelectionType

Die Auswahltypen für Spalten in der Datenquellentabelle.

Enums
DATA_SOURCE_TABLE_COLUMN_SELECTION_TYPE_UNSPECIFIED Der Standardtyp für die Spaltenauswahl. Nicht verwenden.
SELECTED Wählen Sie die Spalten aus, die durch das Feld columns angegeben sind.
SYNC_ALL

Alle aktuellen und zukünftigen Spalten in der Datenquelle synchronisieren

Wenn diese Option festgelegt ist, werden bei der Aktualisierung alle Spalten in der Datenquelle abgerufen.

FilterSpec

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

JSON-Darstellung 
{
  "filterCriteria": {
    object (FilterCriteria)
  },

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

object (FilterCriteria)

Die Kriterien für die Spalte.
Union-Feld reference. Verweis auf die gefilterte Spalte. 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 für das Ein-/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 erfüllt sein muss, damit Werte angezeigt werden. hiddenValues wird dadurch nicht überschrieben. Wenn dort ein Wert aufgeführt ist, wird er weiterhin ausgeblendet.
visibleBackgroundColor
(deprecated)

object (Color)

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

object (ColorStyle)

Die Hintergrundfüllungsfarbe, 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 mit einer bestimmten Spalte oder Zeile verknüpft ist.

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

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

enum (SortOrder)

Die Bestelldaten sollten sortiert sein.
foregroundColor
(deprecated)

object (Color)

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

object (ColorStyle)

Die Vordergrundfarbe, nach der sortiert werden soll. Zellen mit dieser Vordergrundfarbe werden nach oben sortiert. Ist mit backgroundColor nicht kompatibel und muss eine RGB-Farbe sein. Wenn auch foregroundColor festgelegt ist, hat dieses Feld Vorrang.
backgroundColor
(deprecated)

object (Color)

Die Hintergrundfüllungsfarbe, nach der sortiert werden soll. Zellen mit dieser Füllungsfarbe werden nach oben sortiert. Schließt sich mit foregroundColor gegenseitig aus. Verworfen: Verwenden Sie backgroundColorStyle.
backgroundColorStyle

object (ColorStyle)

Die Hintergrundfüllungsfarbe, nach der sortiert werden soll. Zellen mit dieser Füllungsfarbe werden nach oben sortiert. Ist mit foregroundColor nicht kompatibel und muss eine RGB-Farbe sein. Wenn auch backgroundColor festgelegt ist, hat dieses Feld Vorrang.
Union-Feld reference. Verweis auf die sortierte Dimension. 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.

DataSourceFormula

Eine Datenquellenformel.

JSON-Darstellung 
{
  "dataSourceId": string,
  "dataExecutionStatus": {
    object (DataExecutionStatus)
  }
}
Felder
dataSourceId

string

Die ID der Datenquelle, der die Formel zugewiesen ist.
dataExecutionStatus

object (DataExecutionStatus)

Nur Ausgabe. Der Ausführungsstatus der Daten.

DimensionProperties

Eigenschaften einer Dimension.

JSON-Darstellung 
{
  "hiddenByFilter": boolean,
  "hiddenByUser": boolean,
  "pixelSize": integer,
  "developerMetadata": [
    {
      object (DeveloperMetadata)
    }
  ],
  "dataSourceColumnReference": {
    object (DataSourceColumnReference)
  }
}
Felder
hiddenByFilter

boolean

„True“, wenn diese Dimension gefiltert wird. Dieses Feld ist schreibgeschützt.
hiddenByUser

boolean

„Wahr“, wenn diese Dimension explizit ausgeblendet ist.
pixelSize

integer

Die Höhe (bei einer Zeile) oder Breite (bei einer Spalte) der Dimension in Pixeln.
developerMetadata[]

object (DeveloperMetadata)

Die Entwicklermetadaten, die mit einer einzelnen Zeile oder Spalte verknüpft sind.
dataSourceColumnReference

object (DataSourceColumnReference)

Nur Ausgabe. Wenn diese Option festgelegt ist, bezieht sich der Wert auf eine Spalte in einem Datenquellenblatt.

ConditionalFormatRule

Eine Regel, die eine bedingte Formatierung beschreibt.

JSON-Darstellung 
{
  "ranges": [
    {
      object (GridRange)
    }
  ],

  // Union field rule can be only one of the following:
  "booleanRule": {
    object (BooleanRule)
  },
  "gradientRule": {
    object (GradientRule)
  }
  // End of list of possible types for union field rule.
}
Felder
ranges[]

object (GridRange)

Die Bereiche, die formatiert werden, wenn die Bedingung wahr ist. Alle Bereiche müssen sich im selben Raster befinden.
Union-Feld rule. Für diese bedingte Formatierung muss genau eine Regel festgelegt werden. Für rule ist nur einer der folgenden Werte zulässig:
booleanRule

object (BooleanRule)

Die Formatierung ist gemäß der Regel entweder „an“ oder „aus“.
gradientRule

object (GradientRule)

Die Formatierung variiert je nach Farbverlauf in der Regel.

BooleanRule

Eine Regel, die je nach Bedingung übereinstimmen kann oder nicht.

JSON-Darstellung 
{
  "condition": {
    object (BooleanCondition)
  },
  "format": {
    object (CellFormat)
  }
}
Felder
condition

object (BooleanCondition)

Die Bedingung der Regel. Wenn die Bedingung als wahr ausgewertet wird, wird das Format angewendet.
format

object (CellFormat)

Das anzuwendende Format. Bei der bedingten Formatierung kann nur ein Teil der Formatierung angewendet werden: bold, italic, strikethrough, foreground color und background color.

GradientRule

Eine Regel, die ein Farbverlaufsformat auf der Grundlage der aufgeführten Interpolationspunkte anwendet. Das Format einer Zelle hängt vom Inhalt im Vergleich zu den Werten der Interpolationspunkte ab.

JSON-Darstellung 
{
  "minpoint": {
    object (InterpolationPoint)
  },
  "midpoint": {
    object (InterpolationPoint)
  },
  "maxpoint": {
    object (InterpolationPoint)
  }
}
Felder
minpoint

object (InterpolationPoint)

Der Startpunkt der Interpolation.
midpoint

object (InterpolationPoint)

Optionaler Interpolationspunkt in der Mitte.
maxpoint

object (InterpolationPoint)

Der letzte Interpolationspunkt.

InterpolationPoint

Ein einzelner Interpolationspunkt in einem bedingten Farbverlaufsformat. Damit wird die Farbskala des Farbverlaufs entsprechend der ausgewählten Farbe, dem Typ und dem Wert angepinnt.

JSON-Darstellung 
{
  "color": {
    object (Color)
  },
  "colorStyle": {
    object (ColorStyle)
  },
  "type": enum (InterpolationPointType),
  "value": string
}
Felder
color
(deprecated)

object (Color)

Die Farbe, die für diesen Interpolationspunkt verwendet werden soll. Verworfen: Verwenden Sie colorStyle.
colorStyle

object (ColorStyle)

Die Farbe, die für diesen Interpolationspunkt verwendet werden soll. Wenn auch color festgelegt ist, hat dieses Feld Vorrang.
type

enum (InterpolationPointType)

Wie der Wert interpretiert werden soll.
value

string

Der Wert, der für diesen Interpolationspunkt verwendet wird. Kann eine Formel sein. Nicht verwendet, wenn type MIN oder MAX ist.

InterpolationPointType

Die Art des Interpolationspunkts.

Enums
INTERPOLATION_POINT_TYPE_UNSPECIFIED Der Standardwert, nicht verwenden.
MIN Für den Interpolationspunkt wird der Mindestwert in den Zellen im Bereich des bedingten Formats verwendet.
MAX Für den Interpolationspunkt wird der Maximalwert in den Zellen im Bereich des bedingten Formats verwendet.
NUMBER Für den Interpolationspunkt wird genau der Wert in InterpolationPoint.value verwendet.
PERCENT

Der Interpolationspunkt ist der angegebene Prozentsatz für alle Zellen im Bereich des bedingten Formats. Das entspricht NUMBER, wenn der Wert =(MAX(FLATTEN(range)) * (value / 100)) + (MIN(FLATTEN(range)) * (1 - (value / 100))) war. Fehler im Bereich werden beim Zusammenführen ignoriert.
PERCENTILE Der Interpolationspunkt ist das angegebene Perzentil aller Zellen im Bereich des bedingten Formats. Das entspricht NUMBER, wenn der Wert =PERCENTILE(FLATTEN(range), value / 100) war. Fehler im Bereich werden beim Zusammenführen ignoriert.

FilterView

Filteransicht

JSON-Darstellung 
{
  "filterViewId": integer,
  "title": string,
  "range": {
    object (GridRange)
  },
  "namedRangeId": string,
  "tableId": string,
  "sortSpecs": [
    {
      object (SortSpec)
    }
  ],
  "criteria": {
    integer: {
      object (FilterCriteria)
    },
    ...
  },
  "filterSpecs": [
    {
      object (FilterSpec)
    }
  ]
}
Felder
filterViewId

integer

Die ID der Filteransicht.
title

string

Der Name der Filteransicht.
range

object (GridRange)

Der Bereich, den diese Filteransicht abdeckt.

Beim Schreiben kann nur eines von range, namedRangeId oder tableId festgelegt werden.
namedRangeId

string

Der benannte Bereich, auf dem diese Filteransicht basiert, falls zutreffend.

Beim Schreiben kann nur eines von range, namedRangeId oder tableId festgelegt werden.
tableId

string

Die Tabelle, auf der diese Filteransicht basiert (falls vorhanden).

Beim Schreiben kann nur eines von range, namedRangeId oder tableId festgelegt werden.
sortSpecs[]

object (SortSpec)

Die Sortierreihenfolge pro Spalte. Spätere Spezifikationen werden verwendet, wenn die Werte in den früheren Spezifikationen übereinstimmen.
criteria
(deprecated)

map (key: integer, value: object (FilterCriteria))

Die Kriterien für das Ein-/Ausblenden von Werten pro Spalte. Der Schlüssel der Zuordnung ist der Spaltenindex und der Wert sind die Kriterien für diese Spalte.

Dieses Feld wird zugunsten von filterSpecs eingestellt.
filterSpecs[]

object (FilterSpec)

Die Filterkriterien für das Ein-/Ausblenden von Werten pro Spalte.

Sowohl criteria als auch filterSpecs werden in Antworten eingefügt. Wenn beide Felder in einer Aktualisierungsanfrage angegeben sind, hat dieses Feld Vorrang.

ProtectedRange

Ein geschützter Bereich.

JSON-Darstellung 
{
  "protectedRangeId": integer,
  "range": {
    object (GridRange)
  },
  "namedRangeId": string,
  "tableId": string,
  "description": string,
  "warningOnly": boolean,
  "requestingUserCanEdit": boolean,
  "unprotectedRanges": [
    {
      object (GridRange)
    }
  ],
  "editors": {
    object (Editors)
  }
}
Felder
protectedRangeId

integer

Die ID des geschützten Bereichs. Dieses Feld ist schreibgeschützt.
range

object (GridRange)

Der geschützte Bereich. Der Bereich kann auch vollständig unbegrenzt sein. In diesem Fall wird das Tabellenblatt als geschützt betrachtet.

Beim Schreiben kann nur eines von range, namedRangeId oder tableId festgelegt werden.
namedRangeId

string

Der benannte Bereich, auf dem dieser geschützte Bereich basiert, falls zutreffend.

Beim Schreiben kann nur eines von range, namedRangeId oder tableId festgelegt werden.
tableId

string

Die Tabelle, auf der dieser geschützte Bereich basiert, falls zutreffend.

Beim Schreiben kann nur eines von range, namedRangeId oder tableId festgelegt werden.
description

string

Die Beschreibung dieses geschützten Bereichs.
warningOnly

boolean

„Wahr“, wenn bei der Bearbeitung dieses geschützten Bereichs eine Warnung angezeigt wird. Beim warnungsbasierten Schutz können alle Nutzer Daten im geschützten Bereich bearbeiten. Bei der Bearbeitung wird jedoch eine Warnung angezeigt, in der der Nutzer aufgefordert wird, die Änderung zu bestätigen.

Beim Schreiben: Wenn dieses Feld wahr ist, werden editors ignoriert. Wenn dieses Feld von „wahr“ zu „falsch“ geändert wird und das Feld editors nicht festgelegt oder nicht in der Feldmaske enthalten ist, werden alle Bearbeiter im Dokument als Bearbeiter festgelegt.
requestingUserCanEdit

boolean

„True“, wenn der Nutzer, der diesen geschützten Bereich angefordert hat, ihn bearbeiten kann. Dieses Feld ist schreibgeschützt.
unprotectedRanges[]

object (GridRange)

Liste der ungeschützten Bereiche in einem geschützten Tabellenblatt. Ungeschützte Bereiche werden nur in geschützten Tabellenblättern unterstützt.
editors

object (Editors)

Die Nutzer und Gruppen mit Bearbeitungszugriff auf den geschützten Bereich. Dieses Feld ist nur für Nutzer mit Bearbeitungszugriff auf den geschützten Bereich und das Dokument sichtbar. Bearbeiter werden bei warningOnly-geschützten Dokumenten nicht unterstützt.

Bearbeiter

Die Mitbearbeiter eines geschützten Bereichs.

JSON-Darstellung 
{
  "users": [
    string
  ],
  "groups": [
    string
  ],
  "domainUsersCanEdit": boolean
}
Felder
users[]

string

Die E-Mail-Adressen der Nutzer mit Bearbeitungszugriff auf den geschützten Bereich.
groups[]

string

Die E-Mail-Adressen von Gruppen mit Bearbeitungszugriff auf den geschützten Bereich.
domainUsersCanEdit

boolean

„Wahr“, wenn alle Nutzer in der Domain des Dokuments Bearbeitungszugriff auf den geschützten Bereich haben. Der Domainschutz wird nur für Dokumente innerhalb einer Domain unterstützt.

BasicFilter

Der Standardfilter, der mit einem Tabellenblatt verknüpft ist.

JSON-Darstellung 
{
  "range": {
    object (GridRange)
  },
  "tableId": string,
  "sortSpecs": [
    {
      object (SortSpec)
    }
  ],
  "criteria": {
    integer: {
      object (FilterCriteria)
    },
    ...
  },
  "filterSpecs": [
    {
      object (FilterSpec)
    }
  ]
}
Felder
range

object (GridRange)

Der Bereich, den der Filter abdeckt.
tableId

string

Die Tabelle, auf der dieser Filter basiert, falls zutreffend. Beim Schreiben kann nur eines von range oder tableId festgelegt werden.
sortSpecs[]

object (SortSpec)

Die Sortierreihenfolge pro Spalte. Spätere Spezifikationen werden verwendet, wenn die Werte in den früheren Spezifikationen übereinstimmen.
criteria
(deprecated)

map (key: integer, value: object (FilterCriteria))

Die Kriterien für das Ein-/Ausblenden von Werten pro Spalte. Der Schlüssel der Zuordnung ist der Spaltenindex und der Wert sind die Kriterien für diese Spalte.

Dieses Feld wird zugunsten von filterSpecs eingestellt.
filterSpecs[]

object (FilterSpec)

Die Filterkriterien pro Spalte.

Sowohl criteria als auch filterSpecs werden in Antworten eingefügt. Wenn beide Felder in einer Aktualisierungsanfrage angegeben sind, hat dieses Feld Vorrang.

EmbeddedChart

Ein Diagramm, das in ein Tabellenblatt eingebettet ist.

JSON-Darstellung 
{
  "chartId": integer,
  "spec": {
    object (ChartSpec)
  },
  "position": {
    object (EmbeddedObjectPosition)
  },
  "border": {
    object (EmbeddedObjectBorder)
  }
}
Felder
chartId

integer

Die ID des Diagramms.
spec

object (ChartSpec)

Die Spezifikation des Diagramms.
position

object (EmbeddedObjectPosition)

Die Position des Diagramms.
border

object (EmbeddedObjectBorder)

Der Rahmen des Diagramms.

ChartSpec

Die Spezifikationen eines Diagramms.

JSON-Darstellung 
{
  "title": string,
  "altText": string,
  "titleTextFormat": {
    object (TextFormat)
  },
  "titleTextPosition": {
    object (TextPosition)
  },
  "subtitle": string,
  "subtitleTextFormat": {
    object (TextFormat)
  },
  "subtitleTextPosition": {
    object (TextPosition)
  },
  "fontName": string,
  "maximized": boolean,
  "backgroundColor": {
    object (Color)
  },
  "backgroundColorStyle": {
    object (ColorStyle)
  },
  "dataSourceChartProperties": {
    object (DataSourceChartProperties)
  },
  "filterSpecs": [
    {
      object (FilterSpec)
    }
  ],
  "sortSpecs": [
    {
      object (SortSpec)
    }
  ],
  "hiddenDimensionStrategy": enum (ChartHiddenDimensionStrategy),

  // Union field chart can be only one of the following:
  "basicChart": {
    object (BasicChartSpec)
  },
  "pieChart": {
    object (PieChartSpec)
  },
  "bubbleChart": {
    object (BubbleChartSpec)
  },
  "candlestickChart": {
    object (CandlestickChartSpec)
  },
  "orgChart": {
    object (OrgChartSpec)
  },
  "histogramChart": {
    object (HistogramChartSpec)
  },
  "waterfallChart": {
    object (WaterfallChartSpec)
  },
  "treemapChart": {
    object (TreemapChartSpec)
  },
  "scorecardChart": {
    object (ScorecardChartSpec)
  }
  // End of list of possible types for union field chart.
}
Felder
title

string

Der Titel des Diagramms.
altText

string

Der alternative Text, der das Diagramm beschreibt. Dies wird häufig für die Barrierefreiheit verwendet.
titleTextFormat

object (TextFormat)

Das Format des Titeltexts. Durchgestrichene, unterstrichene und verlinkte Textelemente werden nicht unterstützt.
titleTextPosition

object (TextPosition)

Die Position des Titeltexts. Dieses Feld ist optional.
subtitle

string

Der Untertitel des Diagramms.
subtitleTextFormat

object (TextFormat)

Das Format des Untertiteltexts. Durchgestrichene, unterstrichene und verlinkte Textelemente werden nicht unterstützt.
subtitleTextPosition

object (TextPosition)

Die Position des Untertiteltexts. Dieses Feld ist optional.
fontName

string

Der Name der Schriftart, die standardmäßig für den gesamten Diagrammtext verwendet wird (z.B. Titel, Achsenbeschriftungen, Legende). Wenn für einen bestimmten Teil des Diagramms eine Schriftart angegeben wird, wird dieser Schriftartenname überschrieben.
maximized

boolean

„True“, damit ein Diagramm den gesamten Bereich, in dem es gerendert wird, mit minimalem Abstand ausfüllt. „False“, um das Standard-Padding zu verwenden. (Nicht für Geo- und Organigramm-Diagramme.)
backgroundColor
(deprecated)

object (Color)

Die Hintergrundfarbe des gesamten Diagramms. Gilt nicht für Organisationsdiagramme. Verworfen: Verwenden Sie backgroundColorStyle.
backgroundColorStyle

object (ColorStyle)

Die Hintergrundfarbe des gesamten Diagramms. Gilt nicht für Organisationsdiagramme. Wenn auch backgroundColor festgelegt ist, hat dieses Feld Vorrang.
dataSourceChartProperties

object (DataSourceChartProperties)

Falls vorhanden, enthält das Feld diagrammspezifische Eigenschaften der Datenquelle.
filterSpecs[]

object (FilterSpec)

Die Filter, die auf die Quelldaten des Diagramms angewendet wurden. Nur für Datenquellendiagramme unterstützt.
sortSpecs[]

object (SortSpec)

Die Reihenfolge, nach der die Diagrammdaten sortiert werden sollen. Es wird nur eine einzige Sortiervorgabe unterstützt. Nur für Datenquellendiagramme unterstützt.
hiddenDimensionStrategy

enum (ChartHiddenDimensionStrategy)

Bestimmt, wie ausgeblendete Zeilen oder Spalten in Diagrammen verwendet werden.
Union-Feld chart. Gemäß der spezifischen Diagrammspezifikation muss genau ein Wert festgelegt werden. Für chart ist nur einer der folgenden Werte zulässig:
basicChart

object (BasicChartSpec)

Eine grundlegende Diagrammspezifikation kann eine von vielen Arten von Diagrammen sein. Eine Liste aller unterstützten Diagramme finden Sie unter BasicChartType.
pieChart

object (PieChartSpec)

Eine Tortendiagrammspezifikation.
bubbleChart

object (BubbleChartSpec)

Eine Blasendiagrammspezifikation.
candlestickChart

object (CandlestickChartSpec)

Eine Kerzendiagrammspezifikation.
orgChart

object (OrgChartSpec)

Eine Organisationsstrukturspezifikation.
histogramChart

object (HistogramChartSpec)

Eine Histogrammdarstellung.
waterfallChart

object (WaterfallChartSpec)

Eine Wasserfalldiagrammspezifikation.
treemapChart

object (TreemapChartSpec)

Eine Strukturkartenspezifikation.
scorecardChart

object (ScorecardChartSpec)

Eine Kurzübersichtsdiagrammspezifikation.

TextPosition

Positionierungseinstellungen für Text.

JSON-Darstellung 
{
  "horizontalAlignment": enum (HorizontalAlign)
}
Felder
horizontalAlignment

enum (HorizontalAlign)

Einstellung für die horizontale Ausrichtung des Texts.

DataSourceChartProperties

Eigenschaften eines Diagramms für Datenquellen

JSON-Darstellung 
{
  "dataSourceId": string,
  "dataExecutionStatus": {
    object (DataExecutionStatus)
  }
}
Felder
dataSourceId

string

Die ID der Datenquelle, mit der das Diagramm verknüpft ist.
dataExecutionStatus

object (DataExecutionStatus)

Nur Ausgabe. Der Ausführungsstatus der Daten.

BasicChartSpec

Die Spezifikation für ein einfaches Diagramm. Eine Liste der unterstützten Diagramme finden Sie unter BasicChartType.

JSON-Darstellung 
{
  "chartType": enum (BasicChartType),
  "legendPosition": enum (BasicChartLegendPosition),
  "axis": [
    {
      object (BasicChartAxis)
    }
  ],
  "domains": [
    {
      object (BasicChartDomain)
    }
  ],
  "series": [
    {
      object (BasicChartSeries)
    }
  ],
  "headerCount": integer,
  "threeDimensional": boolean,
  "interpolateNulls": boolean,
  "stackedType": enum (BasicChartStackedType),
  "lineSmoothing": boolean,
  "compareMode": enum (BasicChartCompareMode),
  "totalDataLabel": {
    object (DataLabel)
  }
}
Felder
chartType

enum (BasicChartType)

Der Diagrammtyp.
legendPosition

enum (BasicChartLegendPosition)

Die Position der Diagrammlegende.
axis[]

object (BasicChartAxis)

Die Achse im Diagramm.
domains[]

object (BasicChartDomain)

Die Datendomain, die dargestellt wird. Es wird nur eine einzige Domain unterstützt.
series[]

object (BasicChartSeries)

Die Daten, die in diesem Diagramm dargestellt werden.
headerCount

integer

Die Anzahl der Zeilen oder Spalten in den Daten, die als „Überschriften“ dienen. Wenn Sie diese Option nicht festlegen, wird in Google Tabellen anhand der Daten geschätzt, wie viele Zeilen Überschriften sind.

Hinweis: Mit BasicChartAxis.title können Sie den aus den Kopfzeilenwerten abgeleiteten Achsentitel überschreiben.
threeDimensional

boolean

„True“ (Wahr), um das Diagramm als 3D-Diagramm darzustellen. Gilt für Balken- und Säulendiagramme.
interpolateNulls

boolean

Wenn einige Werte in einer Reihe fehlen, können im Diagramm Lücken auftreten (z. B. fehlen Liniensegmente in einem Liniendiagramm). Wenn Sie diese Lücken schließen möchten, setzen Sie diesen Wert auf „wahr“. Gilt für Linien-, Flächen- und Kombinationsdiagramme.
stackedType

enum (BasicChartStackedType)

Der gestapelte Diagrammtyp für Diagramme, die vertikales Stapeln unterstützen. Gilt für Flächen-, Balken-, Säulen-, Kombinations- und Stufen-Flächendiagramme.
lineSmoothing

boolean

Gibt an, ob alle Linien standardmäßig glatt oder gerade gerendert werden sollen. Gilt für Liniendiagramme.
compareMode

enum (BasicChartCompareMode)

Das Verhalten von Kurzinfos und Datenhervorhebungen beim Bewegen des Mauszeigers auf Daten und Diagrammbereiche.
totalDataLabel

object (DataLabel)

Hiermit wird festgelegt, ob in gestapelten Diagrammen zusätzliche Datenlabels angezeigt werden, die die Summe aller gestapelten Werte für jeden Wert entlang der Domainachse darstellen. Diese Datenlabels können nur festgelegt werden, wenn chartType eine der folgenden Optionen ist: AREA, BAR, COLUMN, COMBO oder STEPPED_AREA und stackedType entweder STACKED oder PERCENT_STACKED. Bei COMBO wird dies außerdem nur unterstützt, wenn es nur einen Typ von stapelbaren Reihen type gibt oder ein Typ mehr Reihen als die anderen hat und jeder der anderen Typen nicht mehr als eine Reihe hat. Wenn ein Diagramm beispielsweise zwei gestapelte Balkenreihen und eine Flächenreihe enthält, werden die Labels für die Gesamtdaten unterstützt. Wenn das Diagramm drei Balkenreihen und zwei Flächenreihen enthält, sind Summenlabels nicht zulässig. Auf der totalDataLabel können weder CUSTOM noch placement festgelegt werden.

BasicChartType

So soll das Diagramm visualisiert werden.

Enums
BASIC_CHART_TYPE_UNSPECIFIED Standardwert, nicht verwenden
BAR Ein Balkendiagramm.
LINE Ein Liniendiagramm.
AREA Ein Flächendiagramm.
COLUMN Ein Säulendiagramm.
SCATTER Ein Streudiagramm.
COMBO Ein Kombinationsdiagramm.
STEPPED_AREA Ein Stufen-Flächendiagramm.

BasicChartLegendPosition

Wo die Legende des Diagramms platziert werden soll.

Enums
BASIC_CHART_LEGEND_POSITION_UNSPECIFIED Standardwert, nicht verwenden
BOTTOM_LEGEND Die Legende wird unten im Diagramm gerendert.
LEFT_LEGEND Die Legende wird links im Diagramm angezeigt.
RIGHT_LEGEND Die Legende wird rechts neben dem Diagramm gerendert.
TOP_LEGEND Die Legende wird oben im Diagramm angezeigt.
NO_LEGEND Es wird keine Legende gerendert.

BasicChartAxis

Eine Achse des Diagramms. Ein Diagramm darf nicht mehr als eine Achse pro axis position haben.

JSON-Darstellung 
{
  "position": enum (BasicChartAxisPosition),
  "title": string,
  "format": {
    object (TextFormat)
  },
  "titleTextPosition": {
    object (TextPosition)
  },
  "viewWindowOptions": {
    object (ChartAxisViewWindowOptions)
  }
}
Felder
position

enum (BasicChartAxisPosition)

Die Position dieser Achse.
title

string

Der Titel dieser Achse. Wenn diese Option festgelegt ist, werden alle Titel überschrieben, die aus den Überschriften der Daten abgeleitet wurden.
format

object (TextFormat)

Das Format des Titels. Nur gültig, wenn die Achse nicht mit der Domain verknüpft ist. Das Link-Feld wird nicht unterstützt.
titleTextPosition

object (TextPosition)

Die Textposition des Achsentitels.
viewWindowOptions

object (ChartAxisViewWindowOptions)

Die Optionen für das Ansichtsfenster für diese Achse.

BasicChartAxisPosition

Die Position einer Diagrammachse.

Enums
BASIC_CHART_AXIS_POSITION_UNSPECIFIED Standardwert, nicht verwenden
BOTTOM_AXIS Die Achse, die unten in einem Diagramm dargestellt wird. Bei den meisten Diagrammen ist dies die Standard-Hauptachse. Bei Balkendiagrammen ist dies eine Nebenachse.
LEFT_AXIS Die Achse, die links in einem Diagramm dargestellt wird. Bei den meisten Diagrammen ist dies eine Nebenachse. Bei Balkendiagrammen ist dies die standardmäßige Hauptachse.
RIGHT_AXIS Die Achse, die rechts in einem Diagramm dargestellt wird. Bei den meisten Diagrammen ist dies eine Nebenachse. Bei Balkendiagrammen ist dies eine ungewöhnliche Hauptachse.

ChartAxisViewWindowOptions

Die Optionen, die ein „Ansichtsfenster“ für ein Diagramm definieren (z. B. die sichtbaren Werte auf einer Achse).

JSON-Darstellung 
{
  "viewWindowMin": number,
  "viewWindowMax": number,
  "viewWindowMode": enum (ViewWindowMode)
}
Felder
viewWindowMin

number

Der Mindestwert, der in diesem Ansichtsfenster angezeigt werden soll. Wenn dieser Wert nicht festgelegt ist, wird automatisch ein geeigneter Mindestwert für die Daten ermittelt.
viewWindowMax

number

Der maximale numerische Wert, der in diesem Ansichtsfenster angezeigt werden soll. Wenn dieser Wert nicht festgelegt ist, wird automatisch ein Maximumwert ermittelt, der für die Daten geeignet ist.
viewWindowMode

enum (ViewWindowMode)

Der Modus des Ansichtsfensters.

ViewWindowMode

Der Modus des Ansichtsfensters. Hier wird festgelegt, wie die Mindest- und Höchstwerte des Ansichtsfensters behandelt werden.

Enums
DEFAULT_VIEW_WINDOW_MODE Der Standardfenstermodus für die Ansicht, der im Google Tabellen-Editor für diesen Diagrammtyp verwendet wird. In den meisten Fällen entspricht der Standardmodus, falls festgelegt, PRETTY.
VIEW_WINDOW_MODE_UNSUPPORTED Nicht verwenden. Der derzeit festgelegte Modus wird von der API nicht unterstützt.
EXPLICIT Befolgt genau die Mindest- und Höchstwerte, sofern angegeben. Wenn kein Wert angegeben ist, wird der Wert PRETTY verwendet.
PRETTY Wählt ein Minimum und Maximum aus, das das Diagramm gut aussehen lässt. In diesem Modus werden sowohl „min“ als auch „max“ ignoriert.

BasicChartDomain

Die Domain eines Diagramms. Wenn Sie beispielsweise Aktienkurse im Zeitverlauf darstellen, ist dies das Datum.

JSON-Darstellung 
{
  "domain": {
    object (ChartData)
  },
  "reversed": boolean
}
Felder
domain

object (ChartData)

Die Daten der Domain. Wenn Sie beispielsweise Aktienkurse im Zeitverlauf darstellen, sind dies die Daten, die die Datumsangaben repräsentieren.
reversed

boolean

„Wahr“, um die Reihenfolge der Domainwerte (horizontale Achse) umzukehren.

ChartData

Die Daten in einer Domain oder Reihe.

JSON-Darstellung 
{
  "groupRule": {
    object (ChartGroupRule)
  },
  "aggregateType": enum (ChartAggregateType),

  // Union field type can be only one of the following:
  "sourceRange": {
    object (ChartSourceRange)
  },
  "columnReference": {
    object (DataSourceColumnReference)
  }
  // End of list of possible types for union field type.
}
Felder
groupRule

object (ChartGroupRule)

Die Regel, nach der die Daten gruppiert werden, wenn die ChartData die Domain eines Datenquellendiagramms unterstützt. Nur für Datenquellendiagramme unterstützt.
aggregateType

enum (ChartAggregateType)

Der Aggregationstyp für die Reihe eines Diagramms mit Datenquelle. Nur für Datenquellendiagramme unterstützt.
Union-Feld type. Für den Datentyp muss genau ein Wert festgelegt werden. Für type ist nur einer der folgenden Werte zulässig:
sourceRange

object (ChartSourceRange)

Die Quellbereiche der Daten.
columnReference

object (DataSourceColumnReference)

Der Verweis auf die Datenquellenspalte, aus der die Daten gelesen werden.

ChartSourceRange

Quellbereiche für ein Diagramm.

JSON-Darstellung 
{
  "sources": [
    {
      object (GridRange)
    }
  ]
}
Felder
sources[]

object (GridRange)

Die Datenbereiche für eine Reihe oder Domain. Genau eine Dimension muss eine Länge von 1 haben und alle Quellen in der Liste müssen dieselbe Dimension mit einer Länge von 1 haben. Die Domain (falls vorhanden) und alle Reihen müssen dieselbe Anzahl von Quellbereichen haben. Wenn Sie mehrere Quellbereiche verwenden, müssen die Quellbereiche bei einem bestimmten Offset in der Domain und in der Reihe geordnet und zusammenhängend sein.

Beispiele für gültige Konfigurationen:

domain sources: A1:A5
series1 sources: B1:B5
series2 sources: D6:D10

domain sources: A1:A5, C10:C12
series1 sources: B1:B5, D10:D12
series2 sources: C1:C5, E10:E12

ChartGroupRule

Eine optionale Einstellung für die ChartData der Domain eines Datenquellendiagramms, mit der Buckets für die Werte in der Domain definiert werden, anstatt jeden einzelnen Wert aufzuschlüsseln.

Wenn Sie beispielsweise ein Datenquellendiagramm erstellen, können Sie für die Domain eine Histogrammregel angeben (sie sollte nur numerische Werte enthalten), um die Werte in Buckets zu gruppieren. Alle Werte einer Diagrammreihe, die in denselben Bucket fallen, werden basierend auf dem aggregateType aggregiert.

JSON-Darstellung 
{

  // Union field rule can be only one of the following:
  "dateTimeRule": {
    object (ChartDateTimeRule)
  },
  "histogramRule": {
    object (ChartHistogramRule)
  }
  // End of list of possible types for union field rule.
}
Felder
Union-Feld rule. Die Regel, die auf die ChartData angewendet werden soll. Für rule ist nur einer der folgenden Werte zulässig:
dateTimeRule

object (ChartDateTimeRule)

Ein ChartDateTimeRule.
histogramRule

object (ChartHistogramRule)

Ein ChartHistogramRule

ChartDateTimeRule

Hiermit können Sie die Datums-/Uhrzeitwerte in einer Quelldatenspalte anhand ausgewählter Teile ihrer Datums- oder Uhrzeitwerte in Bucket sortieren.

JSON-Darstellung 
{
  "type": enum (ChartDateTimeRuleType)
}
Felder
type

enum (ChartDateTimeRuleType)

Der Typ der Datum/Uhrzeit-Gruppierung, der angewendet werden soll.

ChartDateTimeRuleType

Die verfügbaren Typen von Gruppierungsregeln für Datum und Uhrzeit.

Enums
CHART_DATE_TIME_RULE_TYPE_UNSPECIFIED Der Standardtyp, nicht verwenden.
SECOND Datumsangaben nach Sekunden von 0 bis 59 gruppieren.
MINUTE Datumsangaben nach Minuten gruppieren, von 0 bis 59.
HOUR Gruppieren Sie Datumsangaben nach Stunden im 24-Stunden-Format von 0 bis 23.
HOUR_MINUTE Gruppieren Sie Datumsangaben nach Stunde und Minute im 24-Stunden-System, z. B. 19:45.
HOUR_MINUTE_AMPM Gruppieren Sie Datumsangaben nach Stunde und Minute im 12-Stunden-Format, z. B. 19:45 Uhr. Die Angabe von „Vormittags“ und „Nachmittags“ wird basierend auf dem Gebietsschema der Tabelle übersetzt.
DAY_OF_WEEK Datumsangaben nach Wochentag gruppieren, z. B. Sonntag Die Wochentage werden basierend auf dem Gebietsschema der Tabelle übersetzt.
DAY_OF_YEAR Datumsangaben nach dem Tag des Jahres gruppieren, von 1 bis 366. Beachten Sie, dass Datumsangaben nach dem 29. Februar in Schaltjahren in andere Kategorien fallen als in Nicht-Schaltjahren.
DAY_OF_MONTH Gruppieren Sie Datumsangaben nach dem Tag des Monats (1 bis 31).
DAY_MONTH Gruppieren Sie Datumsangaben nach Tag und Monat, z. B. 22-Nov. Der Monat wird basierend auf dem Gebietsschema der Tabelle übersetzt.
MONTH Gruppieren Sie die Datumsangaben nach Monat, z. B. November. Der Monat wird basierend auf dem Gebietsschema der Tabelle übersetzt.
QUARTER Gruppieren Sie die Daten nach Quartal, z. B. Q1 (Januar bis März).
YEAR Gruppieren Sie Datumsangaben nach Jahr, z. B. 2008.
YEAR_MONTH Gruppieren Sie Datumsangaben nach Jahr und Monat, z. B. 2008-Nov. Der Monat wird basierend auf dem Gebietsschema der Tabelle übersetzt.
YEAR_QUARTER Gruppieren Sie die Daten nach Jahr und Quartal, z. B. 2008 Q4.
YEAR_MONTH_DAY Gruppieren Sie Datumsangaben nach Jahr, Monat und Tag, z. B. 22.11.2008.

ChartHistogramRule

Hiermit können Sie numerische Werte in einer Quelldatenspalte in Bins mit konstanter Größe organisieren.

JSON-Darstellung 
{
  "minValue": number,
  "maxValue": number,
  "intervalSize": number
}
Felder
minValue

number

Der Mindestwert, ab dem Elemente in Bucket eingeteilt werden. Werte, die unter dem Mindestwert liegen, werden in einem einzelnen Bucket zusammengefasst. Wird er weggelassen, wird er durch den Mindestartikelwert bestimmt.
maxValue

number

Der maximale Wert, bei dem Elemente in Bucket eingeteilt werden. Werte, die über dem Höchstwert liegen, werden in einem einzigen Bucket zusammengefasst. Wird dieser Wert weggelassen, wird er durch den maximalen Artikelwert bestimmt.
intervalSize

number

Die Größe der erstellten Buckets. Muss positiv sein.

ChartAggregateType

Der Aggregationstyp für Diagrammreihen.

Enums
CHART_AGGREGATE_TYPE_UNSPECIFIED Standardwert, nicht verwenden
AVERAGE Aggregatfunktion „Durchschnitt“.
COUNT Aggregatfunktion „Anzahl“
MAX Maximale Aggregatfunktion.
MEDIAN Median-Aggregatfunktion.
MIN Mindestaggregatfunktion.
SUM Aggregatfunktion „Summe“.

BasicChartSeries

Eine einzelne Datenreihe in einem Diagramm. Wenn Sie beispielsweise Aktienkurse im Zeitverlauf darstellen, können mehrere Reihen vorhanden sein, eine für den „Öffnungspreis“, den „Höchstpreis“, den „Tiefstpreis“ und den „Schlusskurs“.

JSON-Darstellung 
{
  "series": {
    object (ChartData)
  },
  "targetAxis": enum (BasicChartAxisPosition),
  "type": enum (BasicChartType),
  "lineStyle": {
    object (LineStyle)
  },
  "dataLabel": {
    object (DataLabel)
  },
  "color": {
    object (Color)
  },
  "colorStyle": {
    object (ColorStyle)
  },
  "pointStyle": {
    object (PointStyle)
  },
  "styleOverrides": [
    {
      object (BasicSeriesDataPointStyleOverride)
    }
  ]
}
Felder
series

object (ChartData)

Die Daten, die in dieser Diagrammreihe visualisiert werden.
targetAxis

enum (BasicChartAxisPosition)

Die Nebenachse, die den Wertebereich für diese Reihe angibt. Wenn Sie beispielsweise Aktien im Zeitverlauf darstellen, sollten Sie die Reihe „Volumen“ rechts und die Preise links anpinnen, da das Handelsvolumen eine andere Skala als die Preise hat. Es ist ein Fehler, eine Achse anzugeben, die keine gültige Nebenachse für die type des Diagramms ist.
type

enum (BasicChartType)

Der Typ dieser Reihe. Nur gültig, wenn chartType COMBO ist. Je nach Typ wird die Zeitreihe unterschiedlich visualisiert. Es werden nur LINE, AREA und COLUMN unterstützt.
lineStyle

object (LineStyle)

Der Linienstil dieser Reihe. Nur gültig, wenn chartType AREA, LINE oder SCATTER ist. COMBO-Diagramme werden auch unterstützt, wenn series chart type den Wert AREA oder LINE hat.
dataLabel

object (DataLabel)

Informationen zu den Datenlabels für diese Reihe.
color
(deprecated)

object (Color)

Die Farbe für Elemente (z. B. Balken, Linien und Punkte), die mit dieser Reihe verknüpft sind. Wenn das Feld leer ist, wird eine Standardfarbe verwendet. Verworfen: Verwenden Sie colorStyle.
colorStyle

object (ColorStyle)

Die Farbe für Elemente (z. B. Balken, Linien und Punkte), die mit dieser Reihe verknüpft sind. Wenn das Feld leer ist, wird eine Standardfarbe verwendet. Wenn auch color festgelegt ist, hat dieses Feld Vorrang.
pointStyle

object (PointStyle)

Der Stil für Punkte, die mit dieser Reihe verknüpft sind. Nur gültig, wenn chartType AREA, LINE oder SCATTER ist. COMBO-Diagramme werden auch unterstützt, wenn series chart type den Wert AREA, LINE oder SCATTER hat. Wenn das Feld leer ist, wird ein Standardpunktstil verwendet.
styleOverrides[]

object (BasicSeriesDataPointStyleOverride)

Einstellungen für Stilüberschreibungen für Datenpunkte der Reihe.

LineStyle

Eigenschaften, die den Stil einer Linie beschreiben.

JSON-Darstellung 
{
  "width": integer,
  "type": enum (LineDashType)
}
Felder
width

integer

Die Linienstärke in Pixeln.
type

enum (LineDashType)

Der Strichtyp der Linie.

LineDashType

Der Strichtyp einer Linie.

Enums
LINE_DASH_TYPE_UNSPECIFIED Standardwert, nicht verwenden
INVISIBLE Kein Bindestrichtyp, was einer unsichtbaren Linie entspricht.
CUSTOM Ein benutzerdefinierter Strich für eine Linie. Das Ändern des genauen benutzerdefinierten Bindestrichstils wird derzeit nicht unterstützt.
SOLID Eine durchgehende Linie.
DOTTED Eine gestrichelte Linie.
MEDIUM_DASHED Eine gepunktete Linie, bei der die Punkte eine mittlere Länge haben.
MEDIUM_DASHED_DOTTED Eine Linie, die abwechselnd aus einem mittellangen Bindestrich und einem Punkt besteht.
LONG_DASHED Eine gestrichelte Linie, bei der die Striche eine „lange“ Länge haben.
LONG_DASHED_DOTTED Eine Linie, die zwischen einem langen Bindestrich und einem Punkt wechselt.

DataLabel

Einstellungen für einen Satz von Datenlabels. Datenlabels sind Anmerkungen, die neben einer Datenmenge angezeigt werden, z. B. neben den Punkten in einem Liniendiagramm. Sie liefern zusätzliche Informationen dazu, was die Daten darstellen, z. B. eine Textdarstellung des Werts hinter diesem Punkt im Diagramm.

JSON-Darstellung 
{
  "type": enum (DataLabelType),
  "textFormat": {
    object (TextFormat)
  },
  "placement": enum (DataLabelPlacement),
  "customLabelData": {
    object (ChartData)
  }
}
Felder
type

enum (DataLabelType)

Der Typ des Datenlabels.
textFormat

object (TextFormat)

Das für das Datenlabel verwendete Textformat. Das Link-Feld wird nicht unterstützt.
placement

enum (DataLabelPlacement)

Die Platzierung des Datenlabels im Verhältnis zu den beschrifteten Daten.
customLabelData

object (ChartData)

Daten, die für benutzerdefinierte Labels verwendet werden sollen. Wird nur verwendet, wenn type auf CUSTOM gesetzt ist. Diese Daten müssen dieselbe Länge wie die Reihe oder das andere Element haben, auf das dieses Datenlabel angewendet wird. Wenn die Reihe in mehrere Quellbereiche aufgeteilt ist, müssen diese Quelldaten aus der nächsten Spalte in den Quelldaten stammen. Wenn die Reihe beispielsweise B2:B4, E6:E8 ist,müssen diese Daten aus C2:C4,F6:F8 stammen.

DataLabelType

Der Typ eines Datenlabels.

Enums
DATA_LABEL_TYPE_UNSPECIFIED Der Datenlabeltyp ist nicht angegeben und wird je nach Kontext des Datenlabels im Diagramm interpretiert.
NONE Das Datenlabel wird nicht angezeigt.
DATA Das Datenlabel wird mit Werten aus den Reihendaten angezeigt.
CUSTOM Das Datenlabel wird mit Werten aus einer benutzerdefinierten Datenquelle angezeigt, die durch customLabelData gekennzeichnet ist.

DataLabelPlacement

Die Platzierung eines Datenlabels im Verhältnis zu den beschrifteten Daten.

Enums
DATA_LABEL_PLACEMENT_UNSPECIFIED Die Positionierung wird automatisch vom Renderer bestimmt.
CENTER Sie können die Grafik sowohl horizontal als auch vertikal in einem Balken oder einer Spalte zentrieren.
LEFT Links neben einem Datenpunkt.
RIGHT Rechts neben einem Datenpunkt.
ABOVE Über einem Datenpunkt.
BELOW Unter einem Datenpunkt.
INSIDE_END Am Ende eines Balkens oder einer Säule (oben bei positiven, unten bei negativen Werten).
INSIDE_BASE Innerhalb einer Leiste oder Säule an der Basis.
OUTSIDE_END Außerhalb eines Balkens oder einer Säule am Ende.

PointStyle

Der Stil eines Punkts im Diagramm.

JSON-Darstellung 
{
  "size": number,
  "shape": enum (PointShape)
}
Felder
size

number

Die Punktgröße. Wenn das Feld leer ist, wird eine Standardgröße verwendet.
shape

enum (PointShape)

Die Punktform. Wenn das Feld leer ist oder keine Angabe gemacht wird, wird eine Standardform verwendet.

PointShape

Die Form eines Punkts.

Enums
POINT_SHAPE_UNSPECIFIED Standardwert.
CIRCLE Eine kreisförmige Form.
DIAMOND Rautenform.
HEXAGON Sechseckform
PENTAGON Fünfeck
SQUARE Eine quadratische Form.
STAR Eine Sternform.
TRIANGLE Dreiecksform
X_MARK Ein X

BasicSeriesDataPointStyleOverride

Einstellungen für die Stilüberschreibung für einen einzelnen Datenpunkt der Reihe.

JSON-Darstellung 
{
  "index": integer,
  "color": {
    object (Color)
  },
  "colorStyle": {
    object (ColorStyle)
  },
  "pointStyle": {
    object (PointStyle)
  }
}
Felder
index

integer

Der nullbasierte Index des Datenpunkts der Reihe.
color
(deprecated)

object (Color)

Farbe des Datenpunkts der Reihe. Wenn das Feld leer ist, wird der Standardwert der Reihe verwendet. Verworfen: Verwenden Sie colorStyle.
colorStyle

object (ColorStyle)

Farbe des Datenpunkts der Reihe. Wenn das Feld leer ist, wird der Standardwert der Reihe verwendet. Wenn auch color festgelegt ist, hat dieses Feld Vorrang.
pointStyle

object (PointStyle)

Punktstil des Datenpunkts der Reihe. Nur gültig, wenn chartType AREA, LINE oder SCATTER ist. COMBO-Diagramme werden auch unterstützt, wenn series chart type den Wert AREA, LINE oder SCATTER hat. Wenn das Feld leer ist, wird der Standardwert der Reihe verwendet.

BasicChartStackedType

Bei gestapelten Diagrammen werden Werte für Bereiche (vertikale Achse) nicht von der horizontalen Achse aus, sondern übereinander dargestellt. Die beiden Werte 20 und 80 würden beispielsweise von 0 aus gezeichnet, wobei 80 80 Einheiten von der horizontalen Achse entfernt ist. Wenn sie gestapelt wären, würde „80“ von „20“ gerendert, was 100 Einheiten von der horizontalen Achse entfernt wäre.

Enums
BASIC_CHART_STACKED_TYPE_UNSPECIFIED Standardwert, nicht verwenden
NOT_STACKED Reihen werden nicht gestapelt.
STACKED Die Werte der Reihe werden gestapelt. Jeder Wert wird vertikal ab dem oberen Bereich des darunter liegenden Werts gerendert.
PERCENT_STACKED Vertikale Stapel werden so gedehnt, dass sie bis zum oberen Rand des Diagramms reichen. Die Werte werden als Prozentsätze voneinander dargestellt.

BasicChartCompareMode

Der Vergleichsmodustyp, der das Verhalten von Tooltips und Datenmarkierungen beschreibt, wenn der Mauszeiger auf Daten und den Diagrammbereich bewegt wird.

Enums
BASIC_CHART_COMPARE_MODE_UNSPECIFIED Standardwert, nicht verwenden
DATUM Nur das fokussierte Datenelement wird hervorgehoben und in der Kurzinfo angezeigt.
CATEGORY Alle Datenelemente mit derselben Kategorie (z.B. Domainwert) werden hervorgehoben und in der Kurzinfo angezeigt.

PieChartSpec

Ein Kreisdiagramm.

JSON-Darstellung 
{
  "legendPosition": enum (PieChartLegendPosition),
  "domain": {
    object (ChartData)
  },
  "series": {
    object (ChartData)
  },
  "threeDimensional": boolean,
  "pieHole": number
}
Felder
legendPosition

enum (PieChartLegendPosition)

Hier wird festgelegt, wo die Legende des Kreisdiagramms gezeichnet werden soll.
domain

object (ChartData)

Die Daten, die die Domain des Kreisdiagramms abdecken.
series

object (ChartData)

Die Daten, die die einzige Reihe des Kreisdiagramms abdecken.
threeDimensional

boolean

„True“, wenn der Kreis dreidimensional ist.
pieHole

number

Die Größe des Lochs im Kreisdiagramm.

PieChartLegendPosition

Wo die Legende des Diagramms platziert werden soll.

Enums
PIE_CHART_LEGEND_POSITION_UNSPECIFIED Standardwert, nicht verwenden
BOTTOM_LEGEND Die Legende wird unten im Diagramm gerendert.
LEFT_LEGEND Die Legende wird links im Diagramm angezeigt.
RIGHT_LEGEND Die Legende wird rechts neben dem Diagramm gerendert.
TOP_LEGEND Die Legende wird oben im Diagramm angezeigt.
NO_LEGEND Es wird keine Legende gerendert.
LABELED_LEGEND Jeder Tortenstück ist ein Label zugeordnet.

BubbleChartSpec

Ein Blasendiagramm.

JSON-Darstellung 
{
  "legendPosition": enum (BubbleChartLegendPosition),
  "bubbleLabels": {
    object (ChartData)
  },
  "domain": {
    object (ChartData)
  },
  "series": {
    object (ChartData)
  },
  "groupIds": {
    object (ChartData)
  },
  "bubbleSizes": {
    object (ChartData)
  },
  "bubbleOpacity": number,
  "bubbleBorderColor": {
    object (Color)
  },
  "bubbleBorderColorStyle": {
    object (ColorStyle)
  },
  "bubbleMaxRadiusSize": integer,
  "bubbleMinRadiusSize": integer,
  "bubbleTextStyle": {
    object (TextFormat)
  }
}
Felder
legendPosition

enum (BubbleChartLegendPosition)

Wo die Legende des Diagramms gezeichnet werden soll.
bubbleLabels

object (ChartData)

Die Daten mit den Blasenlabels. Sie müssen nicht eindeutig sein.
domain

object (ChartData)

Die Daten mit den X‑Werten der Blasen. Anhand dieser Werte werden die Blasen im Diagramm horizontal positioniert.
series

object (ChartData)

Die Daten mit den Y-Werten der Blasen. Anhand dieser Werte werden die Blasen im Diagramm vertikal positioniert.
groupIds

object (ChartData)

Die Daten mit den Bubble-Gruppen-IDs. Alle Blasen mit derselben Gruppen-ID werden in derselben Farbe dargestellt. Wenn bubbleSizes angegeben ist, muss auch dieses Feld angegeben werden. Es kann aber leere Werte enthalten. Dieses Feld ist optional.
bubbleSizes

object (ChartData)

Die Daten mit den Blasengrößen. Mithilfe der Blasengrößen werden die Blasen relativ zueinander in unterschiedlichen Größen dargestellt. Wenn angegeben, muss auch groupIds angegeben werden. Dieses Feld ist optional.
bubbleOpacity

number

Die Deckkraft der Blasen zwischen 0 und 1,0. 0 bedeutet vollständig transparent und 1 vollständig undurchsichtig.
bubbleBorderColor
(deprecated)

object (Color)

Die Farbe des Blasenrahmens. Verworfen: Verwenden Sie bubbleBorderColorStyle.
bubbleBorderColorStyle

object (ColorStyle)

Die Farbe des Blasenrahmens. Wenn auch bubbleBorderColor festgelegt ist, hat dieses Feld Vorrang.
bubbleMaxRadiusSize

integer

Der maximale Radius der Blasen in Pixeln. Falls angegeben, muss das Feld einen positiven Wert haben.
bubbleMinRadiusSize

integer

Der minimale Radius der Blasen in Pixeln. Wenn ein Wert angegeben ist, muss er positiv sein.
bubbleTextStyle

object (TextFormat)

Das Format des Texts in den Blasen. Durchgestrichene, unterstrichene und verlinkte Textelemente werden nicht unterstützt.

BubbleChartLegendPosition

Wo die Legende des Diagramms platziert werden soll.

Enums
BUBBLE_CHART_LEGEND_POSITION_UNSPECIFIED Standardwert, nicht verwenden
BOTTOM_LEGEND Die Legende wird unten im Diagramm gerendert.
LEFT_LEGEND Die Legende wird links im Diagramm angezeigt.
RIGHT_LEGEND Die Legende wird rechts neben dem Diagramm gerendert.
TOP_LEGEND Die Legende wird oben im Diagramm angezeigt.
NO_LEGEND Es wird keine Legende gerendert.
INSIDE_LEGEND Die Legende wird im Diagrammbereich gerendert.

CandlestickChartSpec

Ein Kerzendiagramm.

JSON-Darstellung 
{
  "domain": {
    object (CandlestickDomain)
  },
  "data": [
    {
      object (CandlestickData)
    }
  ]
}
Felder
domain

object (CandlestickDomain)

Die Daten der Domain (horizontale Achse) für das Kerzendiagramm. Stringdaten werden als diskrete Labels behandelt, andere Daten als kontinuierliche Werte.
data[]

object (CandlestickData)

Die Daten des Kerzendiagramms. Es wird nur eine CandlestickData-Datei unterstützt.

CandlestickDomain

Die Domain eines Kerzendiagramms.

JSON-Darstellung 
{
  "data": {
    object (ChartData)
  },
  "reversed": boolean
}
Felder
data

object (ChartData)

Die Daten der CandlestickDomain.
reversed

boolean

„Wahr“, um die Reihenfolge der Domainwerte (horizontale Achse) umzukehren.

CandlestickData

Die Daten des Kerzendiagramms, die jeweils die Tiefst-, Eröffnungs-, Schluss- und Höchstwerte einer Reihe enthalten.

JSON-Darstellung 
{
  "lowSeries": {
    object (CandlestickSeries)
  },
  "openSeries": {
    object (CandlestickSeries)
  },
  "closeSeries": {
    object (CandlestickSeries)
  },
  "highSeries": {
    object (CandlestickSeries)
  }
}
Felder
lowSeries

object (CandlestickSeries)

Die Bereichsdaten (vertikale Achse) für den Tiefst-/Mindestwert für jede Kerze. Dies ist das untere Ende der Mittellinie der Kerze.
openSeries

object (CandlestickSeries)

Die Bereichsdaten (vertikale Achse) für den Eröffnungs-/Startwert jeder Kerze. Dies ist der untere Teil des Kerzenkörpers. Ist der Wert niedriger als der Schlusswert, wird die Kerze gefüllt. Andernfalls ist die Kerze hohl.
closeSeries

object (CandlestickSeries)

Die Bereichsdaten (vertikale Achse) für den Schluss-/Endwert jeder Kerze. Dies ist der obere Teil des Kerzenkörpers. Ist der Wert höher als der Eröffnungswert, wird die Kerze gefüllt. Andernfalls ist die Kerze hohl.
highSeries

object (CandlestickSeries)

Die Werte für den Höchstwert (vertikale Achse) für jede Kerze. Er begrenzt den "Docht" (die Mittellinie der Kerze) nach oben.

CandlestickSeries

Die Reihe von CandlestickData.

JSON-Darstellung 
{
  "data": {
    object (ChartData)
  }
}
Felder
data

object (ChartData)

Die Daten der Kerzendiagrammreihe.

OrgChartSpec

Ein Organigramm. Für Organigramme ist eine eindeutige Gruppe von Labels in labels erforderlich. Optional können auch parentLabels und tooltips verwendet werden. parentLabels enthalten für jeden Knoten das Label, das den übergeordneten Knoten identifiziert. tooltips enthalten für jeden Knoten eine optionale Kurzinfo.

Wenn Sie beispielsweise eine Organisationsstruktur mit Alice als CEO, Bob als Präsident (unterstellt Alice) und Cathy als Vertriebsleiterin (ebenfalls unterstellt Alice) beschreiben möchten, muss labels „Alice“, „Bob“ und „Cathy“ enthalten, parentLabels „“ und „Alice“ und „Alice“ und tooltips „CEO“, „Präsident“ und „Vertriebsleiterin“.

JSON-Darstellung 
{
  "nodeSize": enum (OrgChartNodeSize),
  "nodeColor": {
    object (Color)
  },
  "nodeColorStyle": {
    object (ColorStyle)
  },
  "selectedNodeColor": {
    object (Color)
  },
  "selectedNodeColorStyle": {
    object (ColorStyle)
  },
  "labels": {
    object (ChartData)
  },
  "parentLabels": {
    object (ChartData)
  },
  "tooltips": {
    object (ChartData)
  }
}
Felder
nodeSize

enum (OrgChartNodeSize)

Die Größe der Organigrammknoten.
nodeColor
(deprecated)

object (Color)

Die Farbe der Organigrammknoten. Verworfen: Verwenden Sie nodeColorStyle.
nodeColorStyle

object (ColorStyle)

Die Farbe der Organigrammknoten. Wenn auch nodeColor festgelegt ist, hat dieses Feld Vorrang.
selectedNodeColor
(deprecated)

object (Color)

Die Farbe der ausgewählten Organigrammknoten. Verworfen: Verwenden Sie selectedNodeColorStyle.
selectedNodeColorStyle

object (ColorStyle)

Die Farbe der ausgewählten Organigrammknoten. Wenn auch selectedNodeColor festgelegt ist, hat dieses Feld Vorrang.
labels

object (ChartData)

Die Daten mit den Labels für alle Knoten im Diagramm. Labels müssen eindeutig sein.
parentLabels

object (ChartData)

Die Daten mit dem Label des übergeordneten Elements für den entsprechenden Knoten. Ein leerer Wert gibt an, dass der Knoten kein übergeordnetes Element hat und sich auf oberster Ebene befindet. Dieses Feld ist optional.
tooltips

object (ChartData)

Die Daten, die die Kurzinfo für den entsprechenden Knoten enthalten. Wenn der Wert leer ist, wird für den Knoten keine Kurzinfo angezeigt. Dieses Feld ist optional.

OrgChartNodeSize

Die Größe der Organigrammknoten.

Enums
ORG_CHART_LABEL_SIZE_UNSPECIFIED Standardwert, nicht verwenden
SMALL Die Größe des kleinen Organigrammknotens.
MEDIUM Die mittlere Größe von Organigrammknoten.
LARGE Die Größe des großen Organigrammknotens.

HistogramChartSpec

Ein Histogramm. In einem Histogramm werden Datenelemente in Bins gruppiert und jeder Bin als Spalte gestapelter Elemente dargestellt. Mit Histogrammen wird die Verteilung eines Datensatzes dargestellt. Jede Spalte mit Elementen steht für einen Bereich, in den diese Elemente fallen. Die Anzahl der Bins kann automatisch ausgewählt oder explizit angegeben werden.

JSON-Darstellung 
{
  "series": [
    {
      object (HistogramSeries)
    }
  ],
  "legendPosition": enum (HistogramChartLegendPosition),
  "showItemDividers": boolean,
  "bucketSize": number,
  "outlierPercentile": number
}
Felder
series[]

object (HistogramSeries)

Die Reihe für ein Histogramm kann entweder eine einzelne Reihe von Werten sein, die in Buckets eingeteilt werden sollen, oder mehrere Reihen mit derselben Länge, die den Namen der Reihe gefolgt von den Werten enthalten, die für diese Reihe in Buckets eingeteilt werden sollen.
legendPosition

enum (HistogramChartLegendPosition)

Die Position der Diagrammlegende.
showItemDividers

boolean

Ob zwischen den Elementen in jeder Spalte horizontale Trennlinien angezeigt werden sollen.
bucketSize

number

Standardmäßig wird die Bucket-Größe (der Wertebereich, der in einer einzelnen Spalte gestapelt wird) automatisch ausgewählt. Sie kann hier jedoch überschrieben werden. Beispiel: Eine Bucket-Größe von 1,5 ergibt Buckets von 0–1,5, 1,5–3,0 usw. Sie darf nicht negativ sein. Dieses Feld ist optional.
outlierPercentile

number

Mit dem Percentil für Ausreißer wird dafür gesorgt, dass Ausreißer die Berechnung der Bucket-Größen nicht negativ beeinflussen. Wenn Sie beispielsweise ein Ausreißer-Perzentil von 0,05 festlegen, werden bei der Berechnung von Buckets die oberen und unteren 5% der Werte berücksichtigt. Die Werte sind weiterhin im Diagramm enthalten, werden aber dem ersten oder letzten Bucket hinzugefügt, anstatt eigenen Buckets. Muss zwischen 0,0 und 0,5 liegen.

HistogramSeries

Eine Histogrammreihe mit der Reihenfarbe und den Daten.

JSON-Darstellung 
{
  "barColor": {
    object (Color)
  },
  "barColorStyle": {
    object (ColorStyle)
  },
  "data": {
    object (ChartData)
  }
}
Felder
barColor
(deprecated)

object (Color)

Die Farbe der Spalte, die diese Reihe in jedem Bucket darstellt. Dieses Feld ist optional. Verworfen: Verwenden Sie barColorStyle.
barColorStyle

object (ColorStyle)

Die Farbe der Spalte, die diese Reihe in jedem Bucket darstellt. Dieses Feld ist optional. Wenn auch barColor festgelegt ist, hat dieses Feld Vorrang.
data

object (ChartData)

Die Daten für diese Histogrammreihe.

HistogramChartLegendPosition

Wo die Legende des Diagramms platziert werden soll.

Enums
HISTOGRAM_CHART_LEGEND_POSITION_UNSPECIFIED Standardwert, nicht verwenden
BOTTOM_LEGEND Die Legende wird unten im Diagramm gerendert.
LEFT_LEGEND Die Legende wird links im Diagramm angezeigt.
RIGHT_LEGEND Die Legende wird rechts neben dem Diagramm gerendert.
TOP_LEGEND Die Legende wird oben im Diagramm angezeigt.
NO_LEGEND Es wird keine Legende gerendert.
INSIDE_LEGEND Die Legende wird im Diagrammbereich gerendert.

WaterfallChartSpec

Ein Wasserfalldiagramm.

JSON-Darstellung 
{
  "domain": {
    object (WaterfallChartDomain)
  },
  "series": [
    {
      object (WaterfallChartSeries)
    }
  ],
  "stackedType": enum (WaterfallChartStackedType),
  "firstValueIsTotal": boolean,
  "hideConnectorLines": boolean,
  "connectorLineStyle": {
    object (LineStyle)
  },
  "totalDataLabel": {
    object (DataLabel)
  }
}
Felder
domain

object (WaterfallChartDomain)

Die Domaindaten (horizontale Achse) für das Wasserfalldiagramm.
series[]

object (WaterfallChartSeries)

Die Daten, die in diesem Wasserfalldiagramm dargestellt werden.
stackedType

enum (WaterfallChartStackedType)

Der gestapelte Typ.
firstValueIsTotal

boolean

„Wahr“, wenn der erste Wert als Gesamtwert interpretiert werden soll.
hideConnectorLines

boolean

„True“, um Verbindungslinien zwischen Spalten auszublenden.
connectorLineStyle

object (LineStyle)

Der Linienstil für die Verbindungslinien.
totalDataLabel

object (DataLabel)

Hiermit wird festgelegt, ob in gestapelten Diagrammen zusätzliche Datenlabels angezeigt werden, die die Summe aller gestapelten Werte für jeden Wert entlang der Domainachse darstellen. stackedType muss STACKED sein und weder CUSTOM noch placement können für totalDataLabel festgelegt werden.

WaterfallChartDomain

Die Domain eines Wasserfalldiagramms.

JSON-Darstellung 
{
  "data": {
    object (ChartData)
  },
  "reversed": boolean
}
Felder
data

object (ChartData)

Die Daten der Variablen „WaterfallChartDomain“.
reversed

boolean

„Wahr“, um die Reihenfolge der Domainwerte (horizontale Achse) umzukehren.

WaterfallChartSeries

Eine einzelne Datenreihe für ein Wasserfalldiagramm.

JSON-Darstellung 
{
  "data": {
    object (ChartData)
  },
  "positiveColumnsStyle": {
    object (WaterfallChartColumnStyle)
  },
  "negativeColumnsStyle": {
    object (WaterfallChartColumnStyle)
  },
  "subtotalColumnsStyle": {
    object (WaterfallChartColumnStyle)
  },
  "hideTrailingSubtotal": boolean,
  "customSubtotals": [
    {
      object (WaterfallChartCustomSubtotal)
    }
  ],
  "dataLabel": {
    object (DataLabel)
  }
}
Felder
data

object (ChartData)

Die Daten, die in dieser Reihe visualisiert werden.
positiveColumnsStyle

object (WaterfallChartColumnStyle)

Stile für alle Spalten in dieser Reihe mit positiven Werten.
negativeColumnsStyle

object (WaterfallChartColumnStyle)

Stile für alle Spalten in dieser Reihe mit negativen Werten.
subtotalColumnsStyle

object (WaterfallChartColumnStyle)

Stile für alle Zwischensummenspalten in dieser Reihe.
hideTrailingSubtotal

boolean

„True“, um die Zwischensummenspalte am Ende der Reihe auszublenden. Standardmäßig wird am Ende jeder Reihe eine Zwischensummenspalte angezeigt. Wenn Sie dieses Feld auf „wahr“ setzen, wird die Zwischensummenspalte für diese Reihe ausgeblendet.
customSubtotals[]

object (WaterfallChartCustomSubtotal)

Benutzerdefinierte Zwischensummenspalten, die in dieser Reihe angezeigt werden. Die Reihenfolge, in der Zwischensummen definiert werden, spielt keine Rolle. Für jeden Datenpunkt kann nur eine Zwischensumme definiert werden.
dataLabel

object (DataLabel)

Informationen zu den Datenlabels für diese Reihe.

WaterfallChartColumnStyle

Stile für eine Spalte in einem Wasserfalldiagramm.

JSON-Darstellung 
{
  "label": string,
  "color": {
    object (Color)
  },
  "colorStyle": {
    object (ColorStyle)
  }
}
Felder
label

string

Das Label der Legende der Spalte.
color
(deprecated)

object (Color)

Die Farbe der Spalte. Verworfen: Verwenden Sie colorStyle.
colorStyle

object (ColorStyle)

Die Farbe der Spalte. Wenn auch color festgelegt ist, hat dieses Feld Vorrang.

WaterfallChartCustomSubtotal

Eine benutzerdefinierte Zwischensummenspalte für eine Reihe im Wasserfalldiagramm.

JSON-Darstellung 
{
  "subtotalIndex": integer,
  "label": string,
  "dataIsSubtotal": boolean
}
Felder
subtotalIndex

integer

Der nullbasierte Index eines Datenpunkts innerhalb der Reihe. Wenn dataIsSubtotal „wahr“ ist, ist der Datenpunkt an diesem Index die Zwischensumme. Andernfalls wird die Zwischensumme nach dem Datenpunkt mit diesem Index angezeigt. Eine Reihe kann mehrere Zwischensummen an beliebigen Indizes haben. Zwischensummen haben jedoch keinen Einfluss auf die Indizes der Datenpunkte. Wenn eine Reihe beispielsweise drei Datenpunkte hat, sind ihre Indizes immer 0, 1 und 2, unabhängig davon, wie viele Zwischensummen es in der Reihe gibt oder mit welchen Datenpunkten sie verknüpft sind.
label

string

Ein Label für die Zwischensummenspalte.
dataIsSubtotal

boolean

„Wahr“, wenn der Datenpunkt bei subtotalIndex die Zwischensumme ist. Wenn „false“ festgelegt ist, wird die Zwischensumme berechnet und nach dem Datenpunkt angezeigt.

WaterfallChartStackedType

Optionen für gestapelte Diagramme vom Typ „Wasserfalldiagramm“.

Enums
WATERFALL_STACKED_TYPE_UNSPECIFIED Standardwert, nicht verwenden
STACKED Werte mit demselben Wert für die Domain (horizontale Achse) werden vertikal gestapelt.
SEQUENTIAL Die Reihen werden entlang der horizontalen Achse verteilt.

TreemapChartSpec

Ein Strukturkartendiagramm.

JSON-Darstellung 
{
  "labels": {
    object (ChartData)
  },
  "parentLabels": {
    object (ChartData)
  },
  "sizeData": {
    object (ChartData)
  },
  "colorData": {
    object (ChartData)
  },
  "textFormat": {
    object (TextFormat)
  },
  "levels": integer,
  "hintedLevels": integer,
  "minValue": number,
  "maxValue": number,
  "headerColor": {
    object (Color)
  },
  "headerColorStyle": {
    object (ColorStyle)
  },
  "colorScale": {
    object (TreemapChartColorScale)
  },
  "hideTooltips": boolean
}
Felder
labels

object (ChartData)

Die Daten, die die Zellenlabels der Treemap enthalten.
parentLabels

object (ChartData)

Die Daten, die die übergeordneten Labels der Treemap-Zellen enthalten.
sizeData

object (ChartData)

Die Daten, die die Größe der einzelnen Strukturkartendatenzellen bestimmen. Diese Daten sollten numerisch sein. Zellen, die nicht numerische oder fehlende Daten enthalten, werden nicht gerendert. Wenn colorData nicht angegeben ist, werden diese Daten auch zum Festlegen der Hintergrundfarben von Datenzellen verwendet.
colorData

object (ChartData)

Die Daten, die die Hintergrundfarbe der einzelnen Treemap-Datenzellen bestimmen. Dieses Feld ist optional. Wenn keine Angabe erfolgt, wird sizeData verwendet, um Hintergrundfarben zu bestimmen. Wenn Sie einen Wert angeben, müssen die Daten numerisch sein. Mit colorScale wird festgelegt, wie die Werte in diesen Daten den Hintergrundfarben von Datenzellen zugeordnet werden.
textFormat

object (TextFormat)

Das Textformat für alle Labels im Diagramm. Das Link-Feld wird nicht unterstützt.
levels

integer

Die Anzahl der Datenebenen, die im Strukturkartendiagramm angezeigt werden sollen. Diese Ebenen sind interaktiv und werden mit ihren Labels angezeigt. Wenn keine Angabe gemacht wird, ist der Standardwert 2.
hintedLevels

integer

Die Anzahl der zusätzlichen Datenebenen, die zusätzlich zu den beschrifteten Ebenen im Strukturkartendiagramm angezeigt werden sollen. Diese Ebenen sind nicht interaktiv und werden ohne Labels angezeigt. Wenn keine Angabe gemacht wird, ist der Standardwert 0.
minValue

number

Der niedrigste mögliche Datenwert. Zellen mit Werten, die unter diesem Wert liegen, haben dieselbe Farbe wie Zellen mit diesem Wert. Wenn keine Angabe erfolgt, wird standardmäßig der tatsächliche Mindestwert aus colorData oder der Mindestwert aus sizeData verwendet, wenn colorData nicht angegeben ist.
maxValue

number

Der höchstmögliche Datenwert. Zellen mit Werten, die über diesem Wert liegen, haben dieselbe Farbe wie Zellen mit diesem Wert. Wenn Sie keinen Wert angeben, wird standardmäßig der tatsächliche Höchstwert aus colorData oder der Höchstwert aus sizeData verwendet, wenn colorData nicht angegeben ist.
headerColor
(deprecated)

object (Color)

Die Hintergrundfarbe für Kopfzeilenzellen. Verworfen: Verwenden Sie headerColorStyle.
headerColorStyle

object (ColorStyle)

Die Hintergrundfarbe für Kopfzeilenzellen. Wenn auch headerColor festgelegt ist, hat dieses Feld Vorrang.
colorScale

object (TreemapChartColorScale)

Die Farbskala für Datenzellen im Treemap-Diagramm. Datenzellen werden Farben basierend auf ihren Farbwerten zugewiesen. Diese Farbwerte stammen aus colorData oder aus sizeData, wenn colorData nicht angegeben ist. Zellen mit Farbwerten, die kleiner oder gleich minValue sind, haben minValueColor als Hintergrundfarbe. Zellen mit Farbwerten, die größer oder gleich maxValue sind, haben maxValueColor als Hintergrundfarbe. Zellen mit Farbwerten zwischen minValue und maxValue haben Hintergrundfarben in einem Farbverlauf zwischen minValueColor und maxValueColor, wobei midValueColor der Mittelpunkt des Farbverlaufs ist. Zellen mit fehlenden oder nicht numerischen Farbwerten haben die Hintergrundfarbe noDataColor.
hideTooltips

boolean

„True“, um Kurzinfos auszublenden.

TreemapChartColorScale

Eine Farbskala für ein Treemap-Diagramm.

JSON-Darstellung 
{
  "minValueColor": {
    object (Color)
  },
  "minValueColorStyle": {
    object (ColorStyle)
  },
  "midValueColor": {
    object (Color)
  },
  "midValueColorStyle": {
    object (ColorStyle)
  },
  "maxValueColor": {
    object (Color)
  },
  "maxValueColorStyle": {
    object (ColorStyle)
  },
  "noDataColor": {
    object (Color)
  },
  "noDataColorStyle": {
    object (ColorStyle)
  }
}
Felder
minValueColor
(deprecated)

object (Color)

Die Hintergrundfarbe für Zellen mit einem Farbwert, der kleiner oder gleich minValue ist. Wenn keine Angabe erfolgt, wird standardmäßig #dc3912 verwendet. Verworfen: Verwenden Sie minValueColorStyle.
minValueColorStyle

object (ColorStyle)

Die Hintergrundfarbe für Zellen mit einem Farbwert, der kleiner oder gleich minValue ist. Wenn keine Angabe erfolgt, wird standardmäßig #dc3912 verwendet. Wenn auch minValueColor festgelegt ist, hat dieses Feld Vorrang.
midValueColor
(deprecated)

object (Color)

Die Hintergrundfarbe für Zellen mit einem Farbwert, der genau zwischen minValue und maxValue liegt. Wenn keine Angabe erfolgt, ist der Standardwert #efe6dc. Verworfen: Verwenden Sie midValueColorStyle.
midValueColorStyle

object (ColorStyle)

Die Hintergrundfarbe für Zellen mit einem Farbwert, der genau zwischen minValue und maxValue liegt. Wenn keine Angabe erfolgt, ist der Standardwert #efe6dc. Wenn auch midValueColor festgelegt ist, hat dieses Feld Vorrang.
maxValueColor
(deprecated)

object (Color)

Die Hintergrundfarbe für Zellen mit einem Farbwert, der größer oder gleich maxValue ist. Wenn keine Angabe gemacht wird, ist der Standardwert #109618. Verworfen: Verwenden Sie maxValueColorStyle.
maxValueColorStyle

object (ColorStyle)

Die Hintergrundfarbe für Zellen mit einem Farbwert, der größer oder gleich maxValue ist. Wenn keine Angabe gemacht wird, ist der Standardwert #109618. Wenn auch maxValueColor festgelegt ist, hat dieses Feld Vorrang.
noDataColor
(deprecated)

object (Color)

Die Hintergrundfarbe für Zellen, denen keine Farbdaten zugewiesen sind. Wenn keine Angabe erfolgt, wird standardmäßig #000000 verwendet. Verworfen: Verwenden Sie noDataColorStyle.
noDataColorStyle

object (ColorStyle)

Die Hintergrundfarbe für Zellen, denen keine Farbdaten zugewiesen sind. Wenn keine Angabe erfolgt, wird standardmäßig #000000 verwendet. Wenn auch noDataColor festgelegt ist, hat dieses Feld Vorrang.

ScorecardChartSpec

Ein Übersichtsdiagramm. Mithilfe von Kurzübersichtsdiagrammen können Sie in der Tabelle wichtige Leistungskennzahlen (Key Performance Indicators, KPIs) hervorheben. In einem Kurzübersichtsdiagramm können beispielsweise der Gesamtumsatz, die durchschnittlichen Kosten oder der meistverkaufte Artikel dargestellt werden. Sie können einen einzelnen Datenwert angeben oder einen Datenbereich aggregieren. Die prozentuale oder absolute Abweichung von einem Basiswert kann hervorgehoben werden, z. B. Änderungen im Zeitverlauf.

JSON-Darstellung 
{
  "keyValueData": {
    object (ChartData)
  },
  "baselineValueData": {
    object (ChartData)
  },
  "aggregateType": enum (ChartAggregateType),
  "keyValueFormat": {
    object (KeyValueFormat)
  },
  "baselineValueFormat": {
    object (BaselineValueFormat)
  },
  "scaleFactor": number,
  "numberFormatSource": enum (ChartNumberFormatSource),
  "customFormatOptions": {
    object (ChartCustomNumberFormatOptions)
  }
}
Felder
keyValueData

object (ChartData)

Die Daten für den Wert des Kurzübersichtsschlüssels.
baselineValueData

object (ChartData)

Die Daten für den Ausgangswert der Kurzübersicht. Dieses Feld ist optional.
aggregateType

enum (ChartAggregateType)

Der Aggregationstyp für Diagrammdaten für Schlüssel- und Basislinien im Übersichtsdiagramm. Dieses Feld wird für Datenquellendiagramme nicht unterstützt. Verwenden Sie stattdessen das Feld ChartData.aggregateType der keyValueData oder baselineValueData für Diagramme mit Datenquellen. Dieses Feld ist optional.
keyValueFormat

object (KeyValueFormat)

Formatierungsoptionen für den Schlüsselwert.
baselineValueFormat

object (BaselineValueFormat)

Formatierungsoptionen für den Referenzwert. Dieses Feld ist nur erforderlich, wenn baselineValueData angegeben ist.
scaleFactor

number

Wert, mit dem der Kurzl für die Kurzübersicht und der Basiswert skaliert werden. Mit einem Faktor von 10 können Sie beispielsweise alle Werte im Diagramm durch 10 teilen. Dieses Feld ist optional.
numberFormatSource

enum (ChartNumberFormatSource)

Die Quelle für das Zahlenformat, das im Kurzübersichtsdiagramm verwendet wird. Dieses Feld ist optional.
customFormatOptions

object (ChartCustomNumberFormatOptions)

Benutzerdefinierte Formatierungsoptionen für numerische Schlüssel-/Ausgangswertwerte im Übersichtsdiagramm. Dieses Feld wird nur verwendet, wenn numberFormatSource auf CUSTOM gesetzt ist. Dieses Feld ist optional.

KeyValueFormat

Formatierungsoptionen für den Schlüsselwert.

JSON-Darstellung 
{
  "textFormat": {
    object (TextFormat)
  },
  "position": {
    object (TextPosition)
  }
}
Felder
textFormat

object (TextFormat)

Optionen für die Textformatierung des Schlüsselwerts. Das Link-Feld wird nicht unterstützt.
position

object (TextPosition)

Gibt die horizontale Textposition des Schlüsselwerts an. Dieses Feld ist optional. Wenn keine Angabe erfolgt, wird die Standardpositionierung verwendet.

BaselineValueFormat

Formatierungsoptionen für den Referenzwert.

JSON-Darstellung 
{
  "comparisonType": enum (ComparisonType),
  "textFormat": {
    object (TextFormat)
  },
  "position": {
    object (TextPosition)
  },
  "description": string,
  "positiveColor": {
    object (Color)
  },
  "positiveColorStyle": {
    object (ColorStyle)
  },
  "negativeColor": {
    object (Color)
  },
  "negativeColorStyle": {
    object (ColorStyle)
  }
}
Felder
comparisonType

enum (ComparisonType)

Der Vergleichstyp des Schlüsselwerts mit dem Referenzwert.
textFormat

object (TextFormat)

Optionen für die Textformatierung des Referenzwerts. Das Link-Feld wird nicht unterstützt.
position

object (TextPosition)

Gibt die horizontale Textposition des Referenzwerts an. Dieses Feld ist optional. Wenn keine Angabe erfolgt, wird die Standardpositionierung verwendet.
description

string

Beschreibung, die nach dem Ausgangswert angehängt wird. Dieses Feld ist optional.
positiveColor
(deprecated)

object (Color)

Farbe, die verwendet wird, wenn der Vergleichswert eine positive Änderung für den Schlüsselwert darstellt. Dieses Feld ist optional. Verworfen: Verwenden Sie positiveColorStyle.
positiveColorStyle

object (ColorStyle)

Farbe, die verwendet wird, wenn der Vergleichswert eine positive Änderung für den Schlüsselwert darstellt. Dieses Feld ist optional. Wenn auch positiveColor festgelegt ist, hat dieses Feld Vorrang.
negativeColor
(deprecated)

object (Color)

Farbe, die verwendet werden soll, wenn der Vergleichswert eine negative Änderung für den Schlüsselwert darstellt. Dieses Feld ist optional. Verworfen: Verwenden Sie negativeColorStyle.
negativeColorStyle

object (ColorStyle)

Farbe, die verwendet werden soll, wenn der Vergleichswert eine negative Änderung für den Schlüsselwert darstellt. Dieses Feld ist optional. Wenn auch negativeColor festgelegt ist, hat dieses Feld Vorrang.

ComparisonType

Der Vergleichstyp des Schlüsselwerts mit dem Referenzwert.

Enums
COMPARISON_TYPE_UNDEFINED Standardwert, nicht verwenden
ABSOLUTE_DIFFERENCE Verwenden Sie die absolute Differenz zwischen dem Schlüssel und dem Basiswert.
PERCENTAGE_DIFFERENCE Verwenden Sie die prozentuale Differenz zwischen dem Schlüssel- und dem Basiswert.

ChartNumberFormatSource

Die Optionen für die Quellen der Zahlenformatierung für Diagrammattribute.

Enums
CHART_NUMBER_FORMAT_SOURCE_UNDEFINED Standardwert, nicht verwenden
FROM_DATA Zahlenformatierung von Daten übernehmen
CUSTOM Wenden Sie die benutzerdefinierte Formatierung gemäß ChartCustomNumberFormatOptions an.

ChartCustomNumberFormatOptions

Benutzerdefinierte Optionen für die Zahlenformatierung von Diagrammattributen.

JSON-Darstellung 
{
  "prefix": string,
  "suffix": string
}
Felder
prefix

string

Benutzerdefiniertes Präfix, das dem Diagrammattribut vorangestellt werden soll. Dieses Feld ist optional.
suffix

string

Benutzerdefiniertes Suffix, das dem Diagrammattribut angehängt werden soll. Dieses Feld ist optional.

ChartHiddenDimensionStrategy

Bestimmt, wie in Diagrammen mit ausgeblendeten Quellzeilen umgegangen werden soll. Zu den ausgeblendeten Zeilen gehören sowohl manuell ausgeblendete als auch durch einen Filter ausgeblendete Zeilen.

Enums
CHART_HIDDEN_DIMENSION_STRATEGY_UNSPECIFIED Standardwert, nicht verwenden
SKIP_HIDDEN_ROWS_AND_COLUMNS Ausgeblendete Zeilen und Spalten werden in Diagrammen übersprungen.
SKIP_HIDDEN_ROWS In Diagrammen werden nur ausgeblendete Zeilen übersprungen.
SKIP_HIDDEN_COLUMNS In Diagrammen werden nur ausgeblendete Spalten übersprungen.
SHOW_ALL Ausgeblendete Zeilen oder Spalten werden in Diagrammen nicht übersprungen.

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

integer

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

object (OverlayPosition)

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

boolean

Wenn „wahr“ festgelegt ist, wird das eingebettete Objekt auf einem neuen Tabellenblatt platziert, dessen ID automatisch ausgewählt wird. Wird nur beim Schreiben verwendet.

OverlayPosition

Die Position eines Objekts wird auf einem Raster eingeblendet.

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

object (GridCoordinate)

Die Zelle, an der das Objekt verankert ist.
offsetXPixels

integer

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

integer

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

integer

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

integer

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

GridCoordinate

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

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

integer

Das Tabellenblatt, in dem sich diese Koordinate befindet.
rowIndex

integer

Der Zeilenindex der Koordinate.
columnIndex

integer

Der Spaltenindex der Koordinate.

EmbeddedObjectBorder

Ein Rahmen um ein eingebettetes Objekt.

JSON-Darstellung 
{
  "color": {
    object (Color)
  },
  "colorStyle": {
    object (ColorStyle)
  }
}
Felder
color
(deprecated)

object (Color)

Die Farbe des Rahmens. Verworfen: Verwenden Sie colorStyle.
colorStyle

object (ColorStyle)

Die Farbe des Rahmens. Wenn auch color festgelegt ist, hat dieses Feld Vorrang.

BandedRange

Ein Streifenbereich (mit abwechselnden Farben) in einem Tabellenblatt.

JSON-Darstellung 
{
  "bandedRangeId": integer,
  "range": {
    object (GridRange)
  },
  "rowProperties": {
    object (BandingProperties)
  },
  "columnProperties": {
    object (BandingProperties)
  }
}
Felder
bandedRangeId

integer

Die ID des Bereichs mit Farbbändern.
range

object (GridRange)

Der Bereich, in dem diese Properties angewendet werden.
rowProperties

object (BandingProperties)

Eigenschaften für Zeilenbänder. Diese Eigenschaften werden zeilenweise auf alle Zeilen im Bereich angewendet. Es muss mindestens rowProperties oder columnProperties angegeben werden.
columnProperties

object (BandingProperties)

Eigenschaften für Spaltenbänder. Diese Eigenschaften werden spaltenweise auf alle Spalten im Bereich angewendet. Es muss mindestens rowProperties oder columnProperties angegeben werden.

BandingProperties

Eigenschaften, die sich auf eine einzelne Dimension beziehen (entweder Zeile oder Spalte) Wenn sowohl BandedRange.row_properties als auch BandedRange.column_properties festgelegt sind, werden die Füllfarben gemäß den folgenden Regeln auf Zellen angewendet:

Die Farbe der ersten Zeile hat beispielsweise Vorrang vor der Farbe der ersten Spalte, die Farbe der ersten Spalte hat jedoch Vorrang vor der Farbe der zweiten Zeile. Ebenso hat die Zeilenüberschrift Vorrang vor der Spaltenüberschrift in der Zelle links oben. Die Spaltenüberschrift hat jedoch Vorrang vor der Farbe der ersten Zeile, wenn die Zeilenüberschrift nicht festgelegt ist.

JSON-Darstellung 
{
  "headerColor": {
    object (Color)
  },
  "headerColorStyle": {
    object (ColorStyle)
  },
  "firstBandColor": {
    object (Color)
  },
  "firstBandColorStyle": {
    object (ColorStyle)
  },
  "secondBandColor": {
    object (Color)
  },
  "secondBandColorStyle": {
    object (ColorStyle)
  },
  "footerColor": {
    object (Color)
  },
  "footerColorStyle": {
    object (ColorStyle)
  }
}
Felder
headerColor
(deprecated)

object (Color)

Die Farbe der ersten Zeile oder Spalte. Wenn dieses Feld festgelegt ist, wird die erste Zeile oder Spalte mit dieser Farbe gefüllt. Ab der zweiten Zeile oder Spalte wechseln die Farben zwischen firstBandColor und secondBandColor. Andernfalls wird die erste Zeile oder Spalte mit firstBandColor gefüllt und die Farben wechseln wie gewohnt. Verworfen: Verwenden Sie headerColorStyle.
headerColorStyle

object (ColorStyle)

Die Farbe der ersten Zeile oder Spalte. Wenn dieses Feld festgelegt ist, wird die erste Zeile oder Spalte mit dieser Farbe gefüllt. Ab der zweiten Zeile oder Spalte wechseln die Farben zwischen firstBandColor und secondBandColor. Andernfalls wird die erste Zeile oder Spalte mit firstBandColor gefüllt und die Farben wechseln wie gewohnt. Wenn auch headerColor festgelegt ist, hat dieses Feld Vorrang.
firstBandColor
(deprecated)

object (Color)

Die erste Farbe, die abwechselnd verwendet wird. (Erforderlich) Verworfen: Verwenden Sie firstBandColorStyle.
firstBandColorStyle

object (ColorStyle)

Die erste abwechselnde Farbe. (Erforderlich) Wenn auch firstBandColor festgelegt ist, hat dieses Feld Vorrang.
secondBandColor
(deprecated)

object (Color)

Die zweite abwechselnde Farbe. (Erforderlich) Verworfen: Verwenden Sie secondBandColorStyle.
secondBandColorStyle

object (ColorStyle)

Die zweite abwechselnde Farbe. (Erforderlich) Wenn auch secondBandColor festgelegt ist, hat dieses Feld Vorrang.
footerColor
(deprecated)

object (Color)

Die Farbe der letzten Zeile oder Spalte. Wenn dieses Feld nicht festgelegt ist, wird die letzte Zeile oder Spalte je nach Farbe der vorherigen Zeile oder Spalte mit firstBandColor oder secondBandColor gefüllt. Verworfen: Verwenden Sie footerColorStyle.
footerColorStyle

object (ColorStyle)

Die Farbe der letzten Zeile oder Spalte. Wenn dieses Feld nicht festgelegt ist, wird die letzte Zeile oder Spalte je nach Farbe der vorherigen Zeile oder Spalte mit firstBandColor oder secondBandColor gefüllt. Wenn auch footerColor festgelegt ist, hat dieses Feld Vorrang.

DimensionGroup

Eine Gruppe über ein Zeilen- oder Spaltenintervall auf einem Tabellenblatt, die andere Gruppen enthalten kann oder von anderen Gruppen enthalten wird. Eine Gruppe kann auf dem Tabellenblatt als Einheit minimiert oder maximiert werden.

JSON-Darstellung 
{
  "range": {
    object (DimensionRange)
  },
  "depth": integer,
  "collapsed": boolean
}
Felder
range

object (DimensionRange)

Der Bereich, in dem diese Gruppe vorhanden ist.
depth

integer

Die Tiefe der Gruppe, d. h. wie viele Gruppen einen Bereich haben, der den Bereich dieser Gruppe vollständig enthält.
collapsed

boolean

Dieses Feld ist „wahr“, wenn diese Gruppe minimiert ist. Eine minimierte Gruppe bleibt minimiert, wenn eine überlappende Gruppe mit geringerer Tiefe maximiert wird.

Ein wahrer Wert bedeutet nicht, dass alle Dimensionen innerhalb der Gruppe ausgeblendet sind, da sich die Sichtbarkeit einer Dimension unabhängig von dieser Gruppeneigenschaft ändern kann. Wenn diese Property jedoch aktualisiert wird, werden alle darin enthaltenen Dimensionen ausgeblendet, wenn dieses Feld den Wert „wahr“ hat, oder sichtbar, wenn es den Wert „falsch“ hat.

Datenschnitt

In einer Tabelle

JSON-Darstellung 
{
  "slicerId": integer,
  "spec": {
    object (SlicerSpec)
  },
  "position": {
    object (EmbeddedObjectPosition)
  }
}
Felder
slicerId

integer

Die ID des Sprengschnitts.
spec

object (SlicerSpec)

Die Spezifikation des Slicers.
position

object (EmbeddedObjectPosition)

Die Position des Slicings. Hinweis: Der Sliver kann nur auf einer vorhandenen Tabelle platziert werden. Außerdem können Breite und Höhe des Slicings automatisch angepasst werden, damit sie innerhalb der zulässigen Limits bleiben.

SlicerSpec

Die Spezifikationen eines Slicing-Tools.

JSON-Darstellung 
{
  "dataRange": {
    object (GridRange)
  },
  "filterCriteria": {
    object (FilterCriteria)
  },
  "columnIndex": integer,
  "applyToPivotTables": boolean,
  "title": string,
  "textFormat": {
    object (TextFormat)
  },
  "backgroundColor": {
    object (Color)
  },
  "backgroundColorStyle": {
    object (ColorStyle)
  },
  "horizontalAlignment": enum (HorizontalAlign)
}
Felder
dataRange

object (GridRange)

Der Datenbereich des Sliciers.
filterCriteria

object (FilterCriteria)

Die Filterkriterien des Sprengschnitts.
columnIndex

integer

Der nullbasierte Spaltenindex in der Datentabelle, auf die der Filter angewendet wird.
applyToPivotTables

boolean

„Wahr“, wenn der Filter auf Pivot-Tabellen angewendet werden soll. Enthält standardmäßig den Wert True, wenn nichts anderes festgelegt wird.
title

string

Der Titel des Sliciers.
textFormat

object (TextFormat)

Das Textformat des Titels im Sliver. Das Link-Feld wird nicht unterstützt.
backgroundColor
(deprecated)

object (Color)

Die Hintergrundfarbe des Sprengschnitts. Verworfen: Verwenden Sie backgroundColorStyle.
backgroundColorStyle

object (ColorStyle)

Die Hintergrundfarbe des Sprengschnitts. Wenn auch backgroundColor festgelegt ist, hat dieses Feld Vorrang.
horizontalAlignment

enum (HorizontalAlign)

Die horizontale Ausrichtung des Titels im Sliver. Wenn nicht angegeben, lautet der Standardwert LEFT.

Tabelle

Eine Tabelle.

JSON-Darstellung 
{
  "tableId": string,
  "name": string,
  "range": {
    object (GridRange)
  },
  "rowsProperties": {
    object (TableRowsProperties)
  },
  "columnProperties": [
    {
      object (TableColumnProperties)
    }
  ]
}
Felder
tableId

string

Die ID der Tabelle.
name

string

Der Tabellenname. Dieser Wert ist für alle Tabellen in derselben Tabelle eindeutig.
range

object (GridRange)

Der Tabellenbereich.
rowsProperties

object (TableRowsProperties)

Die Eigenschaften der Tabellenzeilen.
columnProperties[]

object (TableColumnProperties)

Die Eigenschaften der Tabellenspalten.

TableRowsProperties

Die Eigenschaften der Tabellenzeile.

JSON-Darstellung 
{
  "headerColorStyle": {
    object (ColorStyle)
  },
  "firstBandColorStyle": {
    object (ColorStyle)
  },
  "secondBandColorStyle": {
    object (ColorStyle)
  },
  "footerColorStyle": {
    object (ColorStyle)
  }
}
Felder
headerColorStyle

object (ColorStyle)

Die Farbe der Kopfzeile. Wenn dieses Feld festgelegt ist, wird die Kopfzeile mit der angegebenen Farbe ausgefüllt. Andernfalls wird die Kopfzeile mit einer Standardfarbe gefüllt.
firstBandColorStyle

object (ColorStyle)

Die erste abwechselnde Farbe. Wenn dieses Feld festgelegt ist, wird die erste Streifenzeile mit der angegebenen Farbe gefüllt. Andernfalls wird die erste Streifenzeile mit einer Standardfarbe gefüllt.
secondBandColorStyle

object (ColorStyle)

Die zweite abwechselnde Farbe. Wenn dieses Feld festgelegt ist, wird die zweite Streifenzeile mit der angegebenen Farbe ausgefüllt. Andernfalls wird die zweite farblich hervorgehobene Zeile mit einer Standardfarbe gefüllt.
footerColorStyle

object (ColorStyle)

Die Farbe der letzten Zeile. Wenn dieses Feld nicht festgelegt ist, wird keine Fußzeile hinzugefügt. Die letzte Zeile wird je nach Farbe der vorherigen Zeile mit firstBandColorStyle oder secondBandColorStyle ausgefüllt. Wenn Sie eine vorhandene Tabelle ohne Fußzeile mit einer Fußzeile aktualisieren, wird der Bereich um eine Zeile erweitert. Wenn Sie eine vorhandene Tabelle mit einer Fußzeile aktualisieren oder eine Fußzeile entfernen, wird der Bereich um eine Zeile verkleinert.

TableColumnProperties

Die Tabellenspalte.

JSON-Darstellung 
{
  "columnIndex": integer,
  "columnName": string,
  "columnType": enum (ColumnType),
  "dataValidationRule": {
    object (TableColumnDataValidationRule)
  }
}
Felder
columnIndex

integer

Der nullbasierte Spaltenindex. Dieser Index ist relativ zu seiner Position in der Tabelle und muss nicht mit dem Spaltenindex im Tabellenblatt übereinstimmen.
columnName

string

Der Name der Spalte,
columnType

enum (ColumnType)

Der Spaltentyp.
dataValidationRule

object (TableColumnDataValidationRule)

Die Regel für die Datenvalidierung der Spalte. Nur für den Spaltentyp „Drop-down-Menü“ festgelegt.

ColumnType

Der Spaltentyp einer bestimmten Spalte in einer Tabelle.

Enums
COLUMN_TYPE_UNSPECIFIED Ein nicht angegebener Spaltentyp.
DOUBLE Der Spaltentyp „Zahl“.
CURRENCY Der Spaltentyp „Währung“.
PERCENT Der Spaltentyp „Prozent“.
DATE Der Spaltentyp „Datum“.
TIME Der Typ der Zeitspalte.
DATE_TIME Der Spaltentyp „Datum/Uhrzeit“.
TEXT Der Typ der Textspalte.
BOOLEAN Der boolesche Spaltentyp.
DROPDOWN Der Typ der Drop-down-Liste.
FILES_CHIP Der Spaltentyp „Datei-Chip“
PEOPLE_CHIP Der Spaltentyp „Personen-Chip“
FINANCE_CHIP Der Spaltentyp „Finanzen-Chip“
PLACE_CHIP Der Spaltentyp „Orts-Chip“
RATINGS_CHIP Der Spaltentyp „Bewertungs-Chip“

TableColumnDataValidationRule

Eine Regel zur Datenvalidierung für eine Spalte in einer Tabelle.

JSON-Darstellung 
{
  "condition": {
    object (BooleanCondition)
  }
}
Felder
condition

object (BooleanCondition)

Die Bedingung, die die Daten in der Zelle erfüllen müssen. Nur gültig, wenn [BooleanCondition.type] ONE_OF_LIST ist.

NamedRange

Einen benannten Bereich.

JSON-Darstellung 
{
  "namedRangeId": string,
  "name": string,
  "range": {
    object (GridRange)
  }
}
Felder
namedRangeId

string

Die ID des benannten Bereichs.
name

string

Der Name des benannten Bereichs.
range

object (GridRange)

Der Bereich, den dies darstellt.

DataSource

Informationen zu einer externen Datenquelle in der Tabelle.

JSON-Darstellung 
{
  "dataSourceId": string,
  "spec": {
    object (DataSourceSpec)
  },
  "calculatedColumns": [
    {
      object (DataSourceColumn)
    }
  ],
  "sheetId": integer
}
Felder
dataSourceId

string

Die eindeutige ID auf Tabellenebene, die die Datenquelle identifiziert. Beispiel: 1080547365.
spec

object (DataSourceSpec)

Die DataSourceSpec für die Datenquelle, die mit dieser Tabelle verknüpft ist.
calculatedColumns[]

object (DataSourceColumn)

Alle berechneten Spalten in der Datenquelle.
sheetId

integer

Die ID der Sheet, die mit der Datenquelle verbunden ist. Das Feld kann nach der Festlegung nicht mehr geändert werden.

Wenn Sie eine Datenquelle erstellen, wird auch ein zugehöriges DATA_SOURCE-Tabelle erstellt. Wenn das Feld nicht angegeben wird, wird die ID des erstellten Tabellenblatts zufällig generiert.

DataSourceSpec

Hier werden die Details der Datenquelle angegeben. Bei BigQuery werden hier beispielsweise Informationen zur BigQuery-Quelle angegeben.

JSON-Darstellung 
{
  "parameters": [
    {
      object (DataSourceParameter)
    }
  ],

  // Union field spec can be only one of the following:
  "bigQuery": {
    object (BigQueryDataSourceSpec)
  },
  "looker": {
    object (LookerDataSourceSpec)
  }
  // End of list of possible types for union field spec.
}
Felder
parameters[]

object (DataSourceParameter)

Die Parameter der Datenquelle, die bei der Abfrage der Datenquelle verwendet werden.
Union-Feld spec. Die tatsächliche Spezifikation pro Datenquellentyp. Für spec ist nur einer der folgenden Werte zulässig:
bigQuery

object (BigQueryDataSourceSpec)

Ein BigQueryDataSourceSpec.
looker

object (LookerDataSourceSpec)

[LookerDatasourceSpec][]

BigQueryDataSourceSpec

Die Angabe einer BigQuery-Datenquelle, die mit einem Tabellenblatt verbunden ist.

JSON-Darstellung 
{
  "projectId": string,

  // Union field spec can be only one of the following:
  "querySpec": {
    object (BigQueryQuerySpec)
  },
  "tableSpec": {
    object (BigQueryTableSpec)
  }
  // End of list of possible types for union field spec.
}
Felder
projectId

string

Die ID eines BigQuery-kompatiblen Google Cloud-Projekts mit einem verknüpften Abrechnungskonto. Alle Abfragen, die an der Datenquelle ausgeführt werden, werden dem Projekt in Rechnung gestellt.
Union-Feld spec. Die tatsächliche Spezifikation. Für spec ist nur einer der folgenden Werte zulässig:
querySpec

object (BigQueryQuerySpec)

Ein BigQueryQuerySpec.
tableSpec

object (BigQueryTableSpec)

Ein BigQueryTableSpec.

BigQueryQuerySpec

Hier wird eine benutzerdefinierte BigQuery-Abfrage angegeben.

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

string

Der Rohabfragestring.

BigQueryTableSpec

Gibt eine BigQuery-Tabellendefinition an. Es sind nur native Tabellen zulässig.

JSON-Darstellung 
{
  "tableProjectId": string,
  "tableId": string,
  "datasetId": string
}
Felder
tableProjectId

string

Die ID eines BigQuery-Projekts, zu dem die Tabelle gehört. Wenn nichts angegeben wurde, wird von einem projectId ausgegangen.
tableId

string

Die BigQuery-Tabellen-ID.
datasetId

string

Die BigQuery-Dataset-ID.

LookerDataSourceSpec

Die Spezifikation einer Looker-Datenquelle.

JSON-Darstellung 
{
  "instanceUri": string,
  "model": string,
  "explore": string
}
Felder
instanceUri

string

URL der Looker-Instanz
model

string

Name eines Looker-Modells.
explore

string

Name eines Looker-Modell-Explores.

DataSourceParameter

Ein Parameter in der Abfrage einer Datenquelle. Über den Parameter können Nutzer Werte aus der Tabelle in eine Abfrage übergeben.

JSON-Darstellung 
{

  // Union field identifier can be only one of the following:
  "name": string
  // End of list of possible types for union field identifier.

  // Union field value can be only one of the following:
  "namedRangeId": string,
  "range": {
    object (GridRange)
  }
  // End of list of possible types for union field value.
}
Felder
Union-Feld identifier. Die Parameter-ID. Für identifier ist nur einer der folgenden Werte zulässig:
name

string

Benannter Parameter. Muss eine gültige Kennung für die DataSource sein, die sie unterstützt. Beispiel: BigQuery-ID
Union-Feld value. Der Parameterwert. Für value ist nur einer der folgenden Werte zulässig:
namedRangeId

string

ID eines NamedRange. Die Größe muss 1 × 1 sein.
range

object (GridRange)

Ein Bereich, der den Wert des Parameters enthält. Die Größe muss 1 × 1 sein.

DataSourceRefreshSchedule

Zeitplan für die Aktualisierung der Datenquelle.

Datenquellen in der Tabelle werden innerhalb eines bestimmten Zeitraums aktualisiert. Sie können die Startzeit festlegen, indem Sie im Editor von Google Tabellen auf die Schaltfläche „Geplante Aktualisierung“ klicken. Das Intervall ist jedoch auf 4 Stunden festgelegt. Wenn Sie beispielsweise eine Startzeit von 8:00 Uhr angeben, erfolgt die Aktualisierung jeden Tag zwischen 8:00 und 12:00 Uhr.

JSON-Darstellung 
{
  "enabled": boolean,
  "refreshScope": enum (DataSourceRefreshScope),
  "nextRun": {
    object (Interval)
  },

  // Union field schedule_config can be only one of the following:
  "dailySchedule": {
    object (DataSourceRefreshDailySchedule)
  },
  "weeklySchedule": {
    object (DataSourceRefreshWeeklySchedule)
  },
  "monthlySchedule": {
    object (DataSourceRefreshMonthlySchedule)
  }
  // End of list of possible types for union field schedule_config.
}
Felder
enabled

boolean

„True“, wenn der Aktualisierungszeitplan aktiviert ist, andernfalls „false“.
refreshScope

enum (DataSourceRefreshScope)

Der Umfang der Aktualisierung. Muss ALL_DATA_SOURCES lauten.
nextRun

object (Interval)

Nur Ausgabe. Das Zeitintervall der nächsten Ausführung.
Union-Feld schedule_config. Für Zeitplankonfigurationen schedule_config ist nur einer der folgenden Werte zulässig:
dailySchedule

object (DataSourceRefreshDailySchedule)

Tägliche Aktualisierung
weeklySchedule

object (DataSourceRefreshWeeklySchedule)

Zeitplan für die wöchentliche Aktualisierung.
monthlySchedule

object (DataSourceRefreshMonthlySchedule)

Monatlicher Aktualisierungszeitplan.

DataSourceRefreshScope

Aktualisierungsbereiche der Datenquelle

Enums
DATA_SOURCE_REFRESH_SCOPE_UNSPECIFIED Standardwert, nicht verwenden
ALL_DATA_SOURCES Alle Datenquellen und die zugehörigen Datenquellenobjekte in der Tabelle werden aktualisiert.

DataSourceRefreshDailySchedule

Ein Zeitplan für die tägliche Aktualisierung von Daten in einem bestimmten Intervall.

JSON-Darstellung 
{
  "startTime": {
    object (TimeOfDay)
  }
}
Felder
startTime

object (TimeOfDay)

Die Startzeit eines Zeitintervalls, in dem eine Datenquellenaktualisierung geplant ist. Es wird nur der Teil hours verwendet. Die Größe des Zeitintervalls entspricht standardmäßig der im Editor von Google Tabellen.

TimeOfDay

Stellt eine Tageszeit dar. Das Datum und die Zeitzone sind entweder nicht relevant oder werden an anderer Stelle angegeben. Eine API kann Schaltsekunden zulassen. Vergleichbare Typen sind google.type.Date und google.protobuf.Timestamp.

JSON-Darstellung 
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
Felder
hours

integer

Stunden eines Tages im 24-Stunden-Format. Muss größer oder gleich 0 und in der Regel kleiner oder gleich 23 sein. Eine API kann den Wert "24:00:00" für Szenarien wie Geschäftsschlusszeit zulassen.
minutes

integer

Minuten einer Stunde. Muss größer oder gleich 0 und kleiner oder gleich 59 sein.
seconds

integer

Sekunden einer Minute. Muss größer oder gleich 0 und normalerweise kleiner oder gleich 59 sein. Eine API kann den Wert 60 zulassen, wenn sie Schaltsekunden zulässt.
nanos

integer

Sekundenbruchteile in Nanosekunden. Muss größer oder gleich 0 und kleiner oder gleich 999.999.999 sein.

DataSourceRefreshWeeklySchedule

Ein wöchentlicher Zeitplan für die Aktualisierung von Daten an bestimmten Tagen in einem bestimmten Zeitraum.

JSON-Darstellung 
{
  "startTime": {
    object (TimeOfDay)
  },
  "daysOfWeek": [
    enum (DayOfWeek)
  ]
}
Felder
startTime

object (TimeOfDay)

Die Startzeit eines Zeitintervalls, in dem eine Datenquellenaktualisierung geplant ist. Es wird nur der Teil hours verwendet. Die Größe des Zeitintervalls entspricht standardmäßig der im Editor von Google Tabellen.
daysOfWeek[]

enum (DayOfWeek)

Die Wochentage, an denen die Daten aktualisiert werden sollen. Es muss mindestens ein Tag angegeben werden.

DayOfWeek

Steht für einen Wochentag.

Enums
DAY_OF_WEEK_UNSPECIFIED Der Wochentag ist nicht angegeben.
MONDAY Montag
TUESDAY Dienstag
WEDNESDAY Mittwoch
THURSDAY Donnerstag
FRIDAY Freitag
SATURDAY Samstag
SUNDAY Sonntag

DataSourceRefreshMonthlySchedule

Ein monatlicher Zeitplan für die Aktualisierung von Daten an bestimmten Tagen des Monats in einem bestimmten Zeitintervall.

JSON-Darstellung 
{
  "startTime": {
    object (TimeOfDay)
  },
  "daysOfMonth": [
    integer
  ]
}
Felder
startTime

object (TimeOfDay)

Die Startzeit eines Zeitintervalls, in dem eine Datenquellenaktualisierung geplant ist. Es wird nur der Teil hours verwendet. Die Größe des Zeitintervalls entspricht standardmäßig der im Editor von Google Tabellen.
daysOfMonth[]

integer

Tage des Monats, an denen die Daten aktualisiert werden sollen. Es werden nur die Werte 1 bis 28 unterstützt, die dem 1. bis 28. Tag entsprechen. Es muss mindestens ein Tag angegeben werden.

Intervall

Stellt ein Zeitintervall dar, codiert als Zeitstempel-Beginn (inklusive) und Zeitstempel-Ende (exklusiv).

Der Anfang muss kleiner oder gleich dem Ende sein. Wenn Start und Ende identisch sind, ist das Intervall leer (entspricht keiner Zeit). Wenn weder Start noch Ende angegeben sind, entspricht das Intervall jeder beliebigen Zeit.

JSON-Darstellung 
{
  "startTime": string,
  "endTime": string
}
Felder
startTime

string (Timestamp format)

Optional. Beginn des Intervalls, inklusiv.

Falls angegeben, muss ein Zeitstempel, der zu diesem Intervall passt, mit dem Start übereinstimmen oder nach diesem liegen.
endTime

string (Timestamp format)

Optional. Ausgeschlossenes Ende des Intervalls.

Falls angegeben, muss ein Zeitstempel, der diesem Intervall entspricht, vor dem Ende liegen.

Methoden

batchUpdate

 Wendet eine oder mehrere Aktualisierungen auf die Tabelle an.

create

 Erstellt eine Tabelle und gibt die neu erstellte Tabelle zurück.

get

 Gibt die Tabelle mit der angegebenen ID zurück.

getByDataFilter

 Gibt die Tabelle mit der angegebenen ID zurück.