Requests

Anfrage

Eine einzelne Art von Aktualisierung, die auf eine Tabelle angewendet werden soll.

JSON-Darstellung
{

  // Union field kind can be only one of the following:
  "updateSpreadsheetProperties": {
    object (UpdateSpreadsheetPropertiesRequest)
  },
  "updateSheetProperties": {
    object (UpdateSheetPropertiesRequest)
  },
  "updateDimensionProperties": {
    object (UpdateDimensionPropertiesRequest)
  },
  "updateNamedRange": {
    object (UpdateNamedRangeRequest)
  },
  "repeatCell": {
    object (RepeatCellRequest)
  },
  "addNamedRange": {
    object (AddNamedRangeRequest)
  },
  "deleteNamedRange": {
    object (DeleteNamedRangeRequest)
  },
  "addSheet": {
    object (AddSheetRequest)
  },
  "deleteSheet": {
    object (DeleteSheetRequest)
  },
  "autoFill": {
    object (AutoFillRequest)
  },
  "cutPaste": {
    object (CutPasteRequest)
  },
  "copyPaste": {
    object (CopyPasteRequest)
  },
  "mergeCells": {
    object (MergeCellsRequest)
  },
  "unmergeCells": {
    object (UnmergeCellsRequest)
  },
  "updateBorders": {
    object (UpdateBordersRequest)
  },
  "updateCells": {
    object (UpdateCellsRequest)
  },
  "addFilterView": {
    object (AddFilterViewRequest)
  },
  "appendCells": {
    object (AppendCellsRequest)
  },
  "clearBasicFilter": {
    object (ClearBasicFilterRequest)
  },
  "deleteDimension": {
    object (DeleteDimensionRequest)
  },
  "deleteEmbeddedObject": {
    object (DeleteEmbeddedObjectRequest)
  },
  "deleteFilterView": {
    object (DeleteFilterViewRequest)
  },
  "duplicateFilterView": {
    object (DuplicateFilterViewRequest)
  },
  "duplicateSheet": {
    object (DuplicateSheetRequest)
  },
  "findReplace": {
    object (FindReplaceRequest)
  },
  "insertDimension": {
    object (InsertDimensionRequest)
  },
  "insertRange": {
    object (InsertRangeRequest)
  },
  "moveDimension": {
    object (MoveDimensionRequest)
  },
  "updateEmbeddedObjectPosition": {
    object (UpdateEmbeddedObjectPositionRequest)
  },
  "pasteData": {
    object (PasteDataRequest)
  },
  "textToColumns": {
    object (TextToColumnsRequest)
  },
  "updateFilterView": {
    object (UpdateFilterViewRequest)
  },
  "deleteRange": {
    object (DeleteRangeRequest)
  },
  "appendDimension": {
    object (AppendDimensionRequest)
  },
  "addConditionalFormatRule": {
    object (AddConditionalFormatRuleRequest)
  },
  "updateConditionalFormatRule": {
    object (UpdateConditionalFormatRuleRequest)
  },
  "deleteConditionalFormatRule": {
    object (DeleteConditionalFormatRuleRequest)
  },
  "sortRange": {
    object (SortRangeRequest)
  },
  "setDataValidation": {
    object (SetDataValidationRequest)
  },
  "setBasicFilter": {
    object (SetBasicFilterRequest)
  },
  "addProtectedRange": {
    object (AddProtectedRangeRequest)
  },
  "updateProtectedRange": {
    object (UpdateProtectedRangeRequest)
  },
  "deleteProtectedRange": {
    object (DeleteProtectedRangeRequest)
  },
  "autoResizeDimensions": {
    object (AutoResizeDimensionsRequest)
  },
  "addChart": {
    object (AddChartRequest)
  },
  "updateChartSpec": {
    object (UpdateChartSpecRequest)
  },
  "updateBanding": {
    object (UpdateBandingRequest)
  },
  "addBanding": {
    object (AddBandingRequest)
  },
  "deleteBanding": {
    object (DeleteBandingRequest)
  },
  "createDeveloperMetadata": {
    object (CreateDeveloperMetadataRequest)
  },
  "updateDeveloperMetadata": {
    object (UpdateDeveloperMetadataRequest)
  },
  "deleteDeveloperMetadata": {
    object (DeleteDeveloperMetadataRequest)
  },
  "randomizeRange": {
    object (RandomizeRangeRequest)
  },
  "addDimensionGroup": {
    object (AddDimensionGroupRequest)
  },
  "deleteDimensionGroup": {
    object (DeleteDimensionGroupRequest)
  },
  "updateDimensionGroup": {
    object (UpdateDimensionGroupRequest)
  },
  "trimWhitespace": {
    object (TrimWhitespaceRequest)
  },
  "deleteDuplicates": {
    object (DeleteDuplicatesRequest)
  },
  "updateEmbeddedObjectBorder": {
    object (UpdateEmbeddedObjectBorderRequest)
  },
  "addSlicer": {
    object (AddSlicerRequest)
  },
  "updateSlicerSpec": {
    object (UpdateSlicerSpecRequest)
  },
  "addDataSource": {
    object (AddDataSourceRequest)
  },
  "updateDataSource": {
    object (UpdateDataSourceRequest)
  },
  "deleteDataSource": {
    object (DeleteDataSourceRequest)
  },
  "refreshDataSource": {
    object (RefreshDataSourceRequest)
  },
  "cancelDataSourceRefresh": {
    object (CancelDataSourceRefreshRequest)
  },
  "addTable": {
    object (AddTableRequest)
  },
  "updateTable": {
    object (UpdateTableRequest)
  },
  "deleteTable": {
    object (DeleteTableRequest)
  }
  // End of list of possible types for union field kind.
}
Felder
Union-Feld kind. Die Art des Updates. Es ist genau ein Feld erforderlich. Für kind ist nur einer der folgenden Werte zulässig:
updateSpreadsheetProperties

object (UpdateSpreadsheetPropertiesRequest)

Aktualisiert die Eigenschaften der Tabelle.

updateSheetProperties

object (UpdateSheetPropertiesRequest)

Aktualisiert die Eigenschaften eines Tabellenblatts.

updateDimensionProperties

object (UpdateDimensionPropertiesRequest)

Aktualisiert die Attribute von Dimensionen.

updateNamedRange

object (UpdateNamedRangeRequest)

Aktualisiert einen benannten Bereich.

repeatCell

object (RepeatCellRequest)

Wiederholt eine einzelne Zelle in einem Bereich.

addNamedRange

object (AddNamedRangeRequest)

Fügt einen benannten Bereich hinzu.

deleteNamedRange

object (DeleteNamedRangeRequest)

Löscht einen benannten Bereich.

addSheet

object (AddSheetRequest)

Fügt ein Tabellenblatt hinzu.

deleteSheet

object (DeleteSheetRequest)

Löscht ein Tabellenblatt.

autoFill

object (AutoFillRequest)

Füllt automatisch mehr Daten auf Grundlage vorhandener Daten ein.

cutPaste

object (CutPasteRequest)

Schneidet Daten aus einem Bereich aus und fügt sie in einen anderen ein.

copyPaste

object (CopyPasteRequest)

Kopiert Daten aus einem Bereich und fügt sie in einen anderen ein.

mergeCells

object (MergeCellsRequest)

Zellen werden zusammengeführt.

unmergeCells

object (UnmergeCellsRequest)

Hebt den Zellenverbund auf.

updateBorders

object (UpdateBordersRequest)

Aktualisiert die Rahmenlinien in einem Zellbereich.

updateCells

object (UpdateCellsRequest)

Aktualisiert viele Zellen gleichzeitig.

addFilterView

object (AddFilterViewRequest)

Fügt eine Filteransicht hinzu.

appendCells

object (AppendCellsRequest)

Fügt Zellen nach der letzten Zeile mit Daten in einem Tabellenblatt an.

clearBasicFilter

object (ClearBasicFilterRequest)

Entfernt den einfachen Filter aus einem Tabellenblatt.

deleteDimension

object (DeleteDimensionRequest)

Löscht Zeilen oder Spalten in einem Tabellenblatt.

deleteEmbeddedObject

object (DeleteEmbeddedObjectRequest)

Löscht ein eingebettetes Objekt (z. B. Diagramm oder Bild) in einem Tabellenblatt.

deleteFilterView

object (DeleteFilterViewRequest)

Löscht eine Filteransicht aus einem Tabellenblatt.

duplicateFilterView

object (DuplicateFilterViewRequest)

Dupliziert eine Filteransicht.

duplicateSheet

object (DuplicateSheetRequest)

Dupliziert ein Tabellenblatt.

findReplace

object (FindReplaceRequest)

Sucht nach Vorkommen von Text und ersetzt sie durch anderen Text.

insertDimension

object (InsertDimensionRequest)

Fügt neue Zeilen oder Spalten in ein Tabellenblatt ein.

insertRange

object (InsertRangeRequest)

Fügt neue Zellen in ein Tabellenblatt ein und verschiebt die vorhandenen Zellen.

moveDimension

object (MoveDimensionRequest)

Verschiebt Zeilen oder Spalten an eine andere Stelle in einem Tabellenblatt.

updateEmbeddedObjectPosition

object (UpdateEmbeddedObjectPositionRequest)

Aktualisiert die Position eines eingebetteten Objekts (z.B. Diagramm, Bild).

pasteData

object (PasteDataRequest)

Fügt Daten (HTML oder getrennt) in ein Tabellenblatt ein.

textToColumns

object (TextToColumnsRequest)

Wandelt eine Textspalte in mehrere Textspalten um.

updateFilterView

object (UpdateFilterViewRequest)

Aktualisiert die Attribute einer Filteransicht.

deleteRange

object (DeleteRangeRequest)

Löscht einen Zellenbereich aus einem Tabellenblatt und verschiebt die verbleibenden Zellen.

appendDimension

object (AppendDimensionRequest)

Fügt Dimensionen am Ende eines Tabellenblatts an.

addConditionalFormatRule

object (AddConditionalFormatRuleRequest)

Fügt eine neue Regel für die bedingte Formatierung hinzu.

updateConditionalFormatRule

object (UpdateConditionalFormatRuleRequest)

Aktualisiert eine vorhandene Regel für die bedingte Formatierung.

deleteConditionalFormatRule

object (DeleteConditionalFormatRuleRequest)

Löscht eine vorhandene Regel für die bedingte Formatierung.

sortRange

object (SortRangeRequest)

Sortiert Daten in einem Bereich.

setDataValidation

object (SetDataValidationRequest)

Legt die Datenvalidierung für eine oder mehrere Zellen fest.

setBasicFilter

object (SetBasicFilterRequest)

Legt den grundlegenden Filter für ein Tabellenblatt fest.

addProtectedRange

object (AddProtectedRangeRequest)

Fügt einen geschützten Bereich hinzu.

updateProtectedRange

object (UpdateProtectedRangeRequest)

Aktualisiert einen geschützten Bereich.

deleteProtectedRange

object (DeleteProtectedRangeRequest)

Löscht einen geschützten Bereich.

autoResizeDimensions

object (AutoResizeDimensionsRequest)

Die Größe einer oder mehrerer Dimensionen wird automatisch an den Inhalt der Zellen in dieser Dimension angepasst.

addChart

object (AddChartRequest)

Fügt ein Diagramm hinzu.

updateChartSpec

object (UpdateChartSpecRequest)

Aktualisiert die Spezifikationen eines Diagramms.

updateBanding

object (UpdateBandingRequest)

Aktualisiert einen Bereich mit Klassen

addBanding

object (AddBandingRequest)

Fügt einen neuen Bereich mit Bändern hinzu

deleteBanding

object (DeleteBandingRequest)

Entfernt einen Bereich mit Banding

createDeveloperMetadata

object (CreateDeveloperMetadataRequest)

Neue Entwicklermetadaten erstellen

updateDeveloperMetadata

object (UpdateDeveloperMetadataRequest)

Aktualisiert einen vorhandenen Entwicklermetadateneintrag.

deleteDeveloperMetadata

object (DeleteDeveloperMetadataRequest)

Entwicklermetadaten löschen

randomizeRange

object (RandomizeRangeRequest)

Randomisiert die Reihenfolge der Zeilen in einem Bereich.

addDimensionGroup

object (AddDimensionGroupRequest)

Erstellt eine Gruppe für den angegebenen Bereich.

deleteDimensionGroup

object (DeleteDimensionGroupRequest)

Löscht eine Gruppe im angegebenen Bereich.

updateDimensionGroup

object (UpdateDimensionGroupRequest)

Aktualisiert den Status der angegebenen Gruppe.

trimWhitespace

object (TrimWhitespaceRequest)

Entfernt Leerzeichen (z. B. Leerzeichen, Tabulatoren oder Zeilenumbrüche) aus Zellen.

deleteDuplicates

object (DeleteDuplicatesRequest)

Entfernt Zeilen, die doppelte Werte in angegebenen Spalten eines Zellbereichs enthalten.

updateEmbeddedObjectBorder

object (UpdateEmbeddedObjectBorderRequest)

Aktualisiert den Rahmen eines eingebetteten Objekts.

addSlicer

object (AddSlicerRequest)

Fügt einen Datenschnitt hinzu.

updateSlicerSpec

object (UpdateSlicerSpecRequest)

Aktualisiert die Spezifikationen eines Slicers.

addDataSource

object (AddDataSourceRequest)

Fügt eine Datenquelle hinzu.

updateDataSource

object (UpdateDataSourceRequest)

Aktualisiert eine Datenquelle.

deleteDataSource

object (DeleteDataSourceRequest)

Löscht eine Datenquelle.

refreshDataSource

object (RefreshDataSourceRequest)

Aktualisiert eine oder mehrere Datenquellen und die zugehörigen Datenbankobjekte.

cancelDataSourceRefresh

object (CancelDataSourceRefreshRequest)

Bricht Aktualisierungen einer oder mehrerer Datenquellen und der zugehörigen Datenbankobjekte ab.

addTable

object (AddTableRequest)

Fügt eine Tabelle hinzu.

updateTable

object (UpdateTableRequest)

Aktualisiert eine Tabelle.

deleteTable

object (DeleteTableRequest)

Eine Anfrage zum Löschen einer Tabelle.

UpdateSpreadsheetPropertiesRequest

Aktualisiert die Attribute einer Tabelle.

JSON-Darstellung
{
  "properties": {
    object (SpreadsheetProperties)
  },
  "fields": string
}
Felder
properties

object (SpreadsheetProperties)

Die zu aktualisierenden Attribute.

fields

string (FieldMask format)

Die Felder, die aktualisiert werden sollen. Es muss mindestens ein Feld angegeben werden. Der Stamm „properties“ ist impliziert und sollte nicht angegeben werden. Ein einzelnes "*" kann als Kurzform für die Auflistung aller Felder verwendet werden.

UpdateSheetPropertiesRequest

Aktualisiert die Attribute des Tabellenblatts mit der angegebenen sheetId.

JSON-Darstellung
{
  "properties": {
    object (SheetProperties)
  },
  "fields": string
}
Felder
properties

object (SheetProperties)

Die zu aktualisierenden Attribute.

fields

string (FieldMask format)

Die Felder, die aktualisiert werden sollen. Es muss mindestens ein Feld angegeben werden. Der Stamm properties ist impliziert und sollte nicht angegeben werden. Ein einzelnes "*" kann als Kurzform für die Auflistung aller Felder verwendet werden.

UpdateDimensionPropertiesRequest

Aktualisiert die Attribute von Dimensionen im angegebenen Bereich.

JSON-Darstellung
{
  "properties": {
    object (DimensionProperties)
  },
  "fields": string,

  // Union field dimension_range can be only one of the following:
  "range": {
    object (DimensionRange)
  },
  "dataSourceSheetRange": {
    object (DataSourceSheetDimensionRange)
  }
  // End of list of possible types for union field dimension_range.
}
Felder
properties

object (DimensionProperties)

Zu aktualisierende Attribute.

fields

string (FieldMask format)

Die Felder, die aktualisiert werden sollen. Es muss mindestens ein Feld angegeben werden. Der Stamm properties ist impliziert und sollte nicht angegeben werden. Ein einzelnes "*" kann als Kurzform für die Auflistung aller Felder verwendet werden.

Union-Feld dimension_range. Der Dimensionsbereich. Für dimension_range ist nur einer der folgenden Werte zulässig:
range

object (DimensionRange)

Die zu aktualisierenden Zeilen oder Spalten.

dataSourceSheetRange

object (DataSourceSheetDimensionRange)

Die Spalten im Datenquellen-Tabellenblatt, die aktualisiert werden sollen.

DataSourceSheetDimensionRange

Ein Bereich entlang einer einzelnen Dimension auf einem DATA_SOURCE-Tabellenblatt.

JSON-Darstellung
{
  "sheetId": integer,
  "columnReferences": [
    {
      object (DataSourceColumnReference)
    }
  ]
}
Felder
sheetId

integer

Die ID des Datenquellen-Tabellenblatts, in dem sich der Bereich befindet.

columnReferences[]

object (DataSourceColumnReference)

Die Spalten im Datenquellenblatt.

UpdateNamedRangeRequest

Aktualisiert die Attribute des benannten Bereichs mit dem angegebenen namedRangeId.

JSON-Darstellung
{
  "namedRange": {
    object (NamedRange)
  },
  "fields": string
}
Felder
namedRange

object (NamedRange)

Der benannte Bereich, der mit den neuen Eigenschaften aktualisiert werden soll.

fields

string (FieldMask format)

Die Felder, die aktualisiert werden sollen. Es muss mindestens ein Feld angegeben werden. Der Stamm namedRange ist impliziert und sollte nicht angegeben werden. Ein einzelnes "*" kann als Kurzform für die Auflistung aller Felder verwendet werden.

RepeatCellRequest

Aktualisiert alle Zellen im Bereich mit den Werten im angegebenen Cell-Objekt. Nur die Felder, die im Feld fields aufgeführt sind, werden aktualisiert. Andere bleiben unverändert.

Wenn Sie eine Zelle mit einer Formel schreiben, werden die Bereiche der Formel für jedes Feld im Bereich automatisch inkrementiert. Wenn Sie beispielsweise eine Zelle mit der Formel =A1 in den Bereich B2:C4 schreiben, wäre B2 =A1, B3 =A2, B4 =A3, C2 =B1, C3 =B2 und C4 =B3.

Wenn Sie die Bereiche der Formel statisch halten möchten, verwenden Sie den Indikator $. Verwenden Sie beispielsweise die Formel =$A$1, um zu verhindern, dass sowohl die Zeile als auch die Spalte inkrementiert werden.

JSON-Darstellung
{
  "range": {
    object (GridRange)
  },
  "cell": {
    object (CellData)
  },
  "fields": string
}
Felder
range

object (GridRange)

Der Bereich, in dem die Zelle wiederholt werden soll.

cell

object (CellData)

Die zu schreibenden Daten.

fields

string (FieldMask format)

Die Felder, die aktualisiert werden sollen. Es muss mindestens ein Feld angegeben werden. Der Stamm cell ist impliziert und sollte nicht angegeben werden. Ein einzelnes "*" kann als Kurzform für die Auflistung aller Felder verwendet werden.

AddNamedRangeRequest

Fügt der Tabelle einen benannten Bereich hinzu.

JSON-Darstellung
{
  "namedRange": {
    object (NamedRange)
  }
}
Felder
namedRange

object (NamedRange)

Der hinzuzufügende benannte Bereich. Das Feld namedRangeId ist optional. Wenn keine ID festgelegt ist, wird eine zufällig generiert. Es ist ein Fehler, die ID eines Bereichs anzugeben, der bereits vorhanden ist.

DeleteNamedRangeRequest

Entfernt den benannten Bereich mit der angegebenen ID aus der Tabelle.

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

string

Die ID des zu löschenden benannten Bereichs.

AddSheetRequest

Fügt ein neues Tabellenblatt hinzu. Wenn ein Tab an einem bestimmten Index hinzugefügt wird, werden die Indexe aller nachfolgenden Tabs erhöht. Wenn Sie ein Objektblatt hinzufügen möchten, verwenden Sie stattdessen AddChartRequest und geben Sie EmbeddedObjectPosition.sheetId oder EmbeddedObjectPosition.newSheet an.

JSON-Darstellung
{
  "properties": {
    object (SheetProperties)
  }
}
Felder
properties

object (SheetProperties)

Die Eigenschaften, die das neue Tabellenblatt haben soll. Alle Attribute sind optional. Das Feld sheetId ist optional. Wenn keine ID festgelegt ist, wird eine zufällig generiert. (Es ist ein Fehler, die ID eines bereits vorhandenen Tabellenblatts anzugeben.)

DeleteSheetRequest

Löscht das angeforderte Tabellenblatt.

JSON-Darstellung
{
  "sheetId": integer
}
Felder
sheetId

integer

Die ID des zu löschenden Tabellenblatts.

Wenn das Tabellenblatt vom Typ DATA_SOURCE ist, wird auch das zugehörige DataSource gelöscht.

AutoFillRequest

Es werden mehr Daten auf Grundlage vorhandener Daten ergänzt.

JSON-Darstellung
{
  "useAlternateSeries": boolean,

  // Union field area can be only one of the following:
  "range": {
    object (GridRange)
  },
  "sourceAndDestination": {
    object (SourceAndDestination)
  }
  // End of list of possible types for union field area.
}
Felder
useAlternateSeries

boolean

„True“, wenn Daten mit der „alternate“-Serie generiert werden sollen. Das hängt vom Typ und der Menge der Quelldaten ab.

Union-Feld area. Der Bereich, der automatisch ausgefüllt werden soll. Für area ist nur einer der folgenden Werte zulässig:
range

object (GridRange)

Der Bereich, der automatisch ausgefüllt werden soll. Der Bereich wird untersucht und der Ort mit Daten wird erkannt. Diese Daten werden dann automatisch in den Rest des Bereichs eingefügt.

sourceAndDestination

object (SourceAndDestination)

Die Quell- und Zielbereiche für das automatische Ausfüllen. Hier wird die Quelle der automatischen Vervollständigung und der Ort, an dem die Daten erweitert werden sollen, explizit aufgeführt.

SourceAndDestination

Eine Kombination aus einem Quellbereich und der Art und Weise, wie diese Quelle erweitert werden soll.

JSON-Darstellung
{
  "source": {
    object (GridRange)
  },
  "dimension": enum (Dimension),
  "fillLength": integer
}
Felder
source

object (GridRange)

Der Speicherort der Daten, die als Quelle für die automatische Vervollständigung verwendet werden sollen.

dimension

enum (Dimension)

Die Dimension, in die Daten eingefügt werden sollen.

fillLength

integer

Die Anzahl der Zeilen oder Spalten, in die Daten eingefügt werden sollen. Positive Zahlen werden über die letzte Zeile oder Spalte der Quelle hinaus erweitert. Negative Zahlen werden vor der ersten Zeile oder Spalte der Quelle eingefügt.

CutPasteRequest

Verschiebt Daten von der Quelle zum Ziel.

JSON-Darstellung
{
  "source": {
    object (GridRange)
  },
  "destination": {
    object (GridCoordinate)
  },
  "pasteType": enum (PasteType)
}
Felder
source

object (GridRange)

Die Quelldaten, die ausgeschnitten werden sollen.

destination

object (GridCoordinate)

Die Koordinate oben links, an der die Daten eingefügt werden sollen.

pasteType

enum (PasteType)

Welche Art von Daten eingefügt werden soll. Alle Quelldaten werden ausgeschnitten, unabhängig davon, was eingefügt wird.

PasteType

Welche Art von Daten eingefügt werden soll.

Enums
PASTE_NORMAL Werte, Formeln, Formate und Zusammenführungen einfügen
PASTE_VALUES Fügen Sie NUR die Werte ein, ohne Formate, Formeln oder Zusammenführungen.
PASTE_FORMAT Fügen Sie nur das Format und die Datenvalidierung ein.
PASTE_NO_BORDERS Wie PASTE_NORMAL aber ohne Rahmen.
PASTE_FORMULA Fügen Sie nur die Formeln ein.
PASTE_DATA_VALIDATION Fügen Sie nur die Datenvalidierung ein.
PASTE_CONDITIONAL_FORMATTING Fügen Sie nur die Regeln für die bedingte Formatierung ein.

CopyPasteRequest

Kopiert Daten von der Quelle zum Ziel.

JSON-Darstellung
{
  "source": {
    object (GridRange)
  },
  "destination": {
    object (GridRange)
  },
  "pasteType": enum (PasteType),
  "pasteOrientation": enum (PasteOrientation)
}
Felder
source

object (GridRange)

Der zu kopierende Quellbereich.

destination

object (GridRange)

Der Ort, an dem der Text eingefügt werden soll. Wenn der Bereich einen Bereich abdeckt, der ein Vielfaches der Höhe oder Breite der Quelle ist, werden die Daten wiederholt, um den Zielbereich auszufüllen. Wenn der Bereich kleiner als der Quellbereich ist, werden trotzdem alle Quelldaten kopiert (über das Ende des Zielbereichs hinaus).

pasteType

enum (PasteType)

Welche Art von Daten eingefügt werden soll.

pasteOrientation

enum (PasteOrientation)

Wie die Daten beim Einfügen ausgerichtet werden sollen.

PasteOrientation

So sollte ein Einfügevorgang ausgeführt werden.

Enums
NORMAL Fügen Sie den Text wie gewohnt ein.
TRANSPOSE Fügen Sie die Daten transponiert ein, sodass alle Zeilen zu Spalten und umgekehrt werden.

MergeCellsRequest

Führt alle Zellen im Bereich zusammen.

JSON-Darstellung
{
  "range": {
    object (GridRange)
  },
  "mergeType": enum (MergeType)
}
Felder
range

object (GridRange)

Der Zellenbereich, der zusammengeführt werden soll.

mergeType

enum (MergeType)

Wie die Zellen zusammengeführt werden sollen.

MergeType

Der Typ der Zusammenführung, die erstellt werden soll.

Enums
MERGE_ALL Einzelne Zusammenführung aus dem Bereich erstellen
MERGE_COLUMNS Für jede Spalte im Bereich eine Zusammenführung erstellen
MERGE_ROWS Für jede Zeile im Bereich wird ein Merge erstellt.

UnmergeCellsRequest

Hebt den Zellenverbund im angegebenen Bereich auf.

JSON-Darstellung
{
  "range": {
    object (GridRange)
  }
}
Felder
range

object (GridRange)

Der Bereich, in dem die Verbindung aller Zellen aufgehoben werden soll. Wenn der Bereich mehrere Zusammenführungen umfasst, werden alle aufgehoben. Der Bereich darf sich nicht teilweise über einen Zellenverbund erstrecken.

UpdateBordersRequest

Aktualisiert die Rahmenlinien eines Bereichs. Wenn ein Feld in der Anfrage nicht festgelegt ist, bleibt der Rahmen unverändert. Beispiel:

  1. range: A1:A5 { top: RED, bottom: WHITE }
  2. range: A1:A5 { left: BLUE }

Das würde dazu führen, dass A1:A5 Rahmen von { top: RED, bottom: WHITE, left: BLUE } haben. Wenn Sie einen Rahmen entfernen möchten, legen Sie den Stil explizit auf NONE fest.

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

object (GridRange)

Der Bereich, dessen Grenzen aktualisiert werden sollen.

top

object (Border)

Die Grenze, die oben im Bereich platziert werden soll.

bottom

object (Border)

Der Rahmen, der unten im Bereich platziert werden soll.

left

object (Border)

Die Grenze, die links vom Bereich platziert werden soll.

right

object (Border)

Die Rahmenlinie, die rechts vom Bereich platziert werden soll.

innerHorizontal

object (Border)

Die horizontale Grenze, die in den Bereich eingefügt werden soll.

innerVertical

object (Border)

Die vertikale Grenze, die in den Bereich aufgenommen werden soll.

UpdateCellsRequest

Aktualisiert alle Zellen in einem Bereich mit neuen Daten.

JSON-Darstellung
{
  "rows": [
    {
      object (RowData)
    }
  ],
  "fields": string,

  // Union field area can be only one of the following:
  "start": {
    object (GridCoordinate)
  },
  "range": {
    object (GridRange)
  }
  // End of list of possible types for union field area.
}
Felder
rows[]

object (RowData)

Die zu schreibenden Daten.

fields

string (FieldMask format)

Die Felder von „CellData“, die aktualisiert werden sollen. Es muss mindestens ein Feld angegeben werden. Der Stamm ist CellData. „row.values.“ sollte nicht angegeben werden. Ein einzelnes "*" kann als Kurzform für die Auflistung aller Felder verwendet werden.

Union-Feld area. Die Standortdaten sollten geschrieben werden. Es muss genau ein Wert festgelegt werden. Für area ist nur einer der folgenden Werte zulässig:
start

object (GridCoordinate)

Die Koordinate, an der mit dem Schreiben von Daten begonnen werden soll. Es können beliebig viele Zeilen und Spalten geschrieben werden, auch eine unterschiedliche Anzahl von Spalten pro Zeile.

range

object (GridRange)

Der Bereich, in den Daten geschrieben werden sollen.

Wenn die Daten in den Zeilen nicht den gesamten angeforderten Bereich abdecken, werden die Felder, die mit den in fields festgelegten Feldern übereinstimmen, gelöscht.

AddFilterViewRequest

Fügt eine Filteransicht hinzu.

JSON-Darstellung
{
  "filter": {
    object (FilterView)
  }
}
Felder
filter

object (FilterView)

Der hinzuzufügende Filter. Das Feld filterViewId ist optional. Wenn keine festgelegt ist, wird eine ID zufällig generiert. Es ist ein Fehler, die ID eines bereits vorhandenen Filters anzugeben.

AppendCellsRequest

Fügt nach der letzten Zeile mit Daten in einem Tabellenblatt neue Zellen hinzu und fügt bei Bedarf neue Zeilen in das Tabellenblatt ein.

JSON-Darstellung
{
  "sheetId": integer,
  "rows": [
    {
      object (RowData)
    }
  ],
  "fields": string,

  // Union field area can be only one of the following:
  "tableId": string
  // End of list of possible types for union field area.
}
Felder
sheetId

integer

Die Tabellenblatt-ID, an die die Daten angehängt werden sollen.

rows[]

object (RowData)

Die anzuhängenden Daten.

fields

string (FieldMask format)

Die Felder von „CellData“, die aktualisiert werden sollen. Es muss mindestens ein Feld angegeben werden. Der Stamm ist CellData. „row.values.“ sollte nicht angegeben werden. Ein einzelnes "*" kann als Kurzform für die Auflistung aller Felder verwendet werden.

Union-Feld area. Die Standortdaten sollten geschrieben werden. Für area ist nur einer der folgenden Werte zulässig:
tableId

string

Die ID der Tabelle, an die Daten angehängt werden sollen. Die Daten werden nur an den Tabellenkörper angehängt.

Dieses Feld hat auch Vorrang vor dem Feld sheetId.

ClearBasicFilterRequest

Löscht den einfachen Filter, sofern er im Tabellenblatt vorhanden ist.

JSON-Darstellung
{
  "sheetId": integer
}
Felder
sheetId

integer

Die Tabellenblatt-ID, für die der einfachen Filter gelöscht werden soll.

DeleteDimensionRequest

Löscht die Dimensionen aus dem Tabellenblatt.

JSON-Darstellung
{
  "range": {
    object (DimensionRange)
  }
}
Felder
range

object (DimensionRange)

Die Dimensionen, die aus dem Tabellenblatt gelöscht werden sollen.

DeleteEmbeddedObjectRequest

Löscht das eingebettete Objekt mit der angegebenen ID.

JSON-Darstellung
{
  "objectId": integer
}
Felder
objectId

integer

Die ID des einzubettenden Objekts, das gelöscht werden soll.

DeleteFilterViewRequest

Löscht eine bestimmte Filteransicht.

JSON-Darstellung
{
  "filterId": integer
}
Felder
filterId

integer

Die ID des zu löschenden Filters.

DuplicateFilterViewRequest

Dupliziert eine bestimmte Filteransicht.

JSON-Darstellung
{
  "filterId": integer
}
Felder
filterId

integer

Die ID des Filters, der dupliziert wird.

DuplicateSheetRequest

Dupliziert den Inhalt eines Tabellenblatts.

JSON-Darstellung
{
  "sourceSheetId": integer,
  "insertSheetIndex": integer,
  "newSheetId": integer,
  "newSheetName": string
}
Felder
sourceSheetId

integer

Das zu duplizierende Tabellenblatt.

Wenn das Quelltabellenblatt vom Typ DATA_SOURCE ist, wird auch die zugrunde liegende DataSource dupliziert und der neuen Kopie des Tabellenblatts zugeordnet. Es wird keine Datenausführung ausgelöst. Die Tabellendaten dieses Blatts werden ebenfalls kopiert, sind aber erst nach Abschluss der Batchanfrage verfügbar.

insertSheetIndex

integer

Der nullbasierte Index, an dem das neue Tabellenblatt eingefügt werden soll. Der Index aller nachfolgenden Tabellenblätter wird erhöht.

newSheetId

integer

Wenn festgelegt, die ID des neuen Tabellenblatts. Wenn nicht festgelegt, wird eine ID ausgewählt. Falls festgelegt, darf die ID nicht mit einer vorhandenen Tabellenblatt-ID in Konflikt stehen. Wenn der Wert festgelegt ist, darf er nicht negativ sein.

newSheetName

string

Der Name des neuen Tabellenblatts. Wenn das Feld leer ist, wird ein neuer Name für Sie ausgewählt.

FindReplaceRequest

Sucht und ersetzt Daten in Zellen in einem Bereich, einem Tabellenblatt oder allen Tabellenblättern.

JSON-Darstellung
{
  "find": string,
  "replacement": string,
  "matchCase": boolean,
  "matchEntireCell": boolean,
  "searchByRegex": boolean,
  "includeFormulas": boolean,

  // Union field scope can be only one of the following:
  "range": {
    object (GridRange)
  },
  "sheetId": integer,
  "allSheets": boolean
  // End of list of possible types for union field scope.
}
Felder
find

string

Der Wert, nach dem gesucht werden soll.

replacement

string

Der Wert, der als Ersatz verwendet werden soll.

matchCase

boolean

„True“, wenn bei der Suche die Groß-/Kleinschreibung beachtet wird.

matchEntireCell

boolean

„True“, wenn der Suchwert mit der gesamten Zelle übereinstimmen soll.

searchByRegex

boolean

„True“, wenn der Suchwert ein regulärer Ausdruck ist. Der reguläre Ausdruck und der Ersatz sollten den Java-RegEx-Regeln unter https://docs.oracle.com/javase/8/docs/api/java/util/regex/Pattern.html entsprechen. Der Ersatzstring darf auf Erfassungsgruppen verweisen. Wenn eine Zelle beispielsweise den Inhalt "Google Sheets" und eine andere den Inhalt "Google Docs" hat, wird bei der Suche nach "o.* (.*)" mit einem Ersetzen durch "$1 Rocks" der Inhalt der Zellen in "GSheets Rocks" und "GDocs Rocks" geändert.

includeFormulas

boolean

„True“, wenn die Suche Zellen mit Formeln umfassen soll. „Falsch“, um Zellen mit Formeln zu überspringen.

Union-Feld scope. Der Bereich, in dem gesucht und ersetzt werden soll. Es muss genau einer festgelegt sein. Für scope ist nur einer der folgenden Werte zulässig:
range

object (GridRange)

Der Bereich, in dem gesucht und ersetzt werden soll.

sheetId

integer

Das Tabellenblatt, in dem gesucht und ersetzt werden soll.

allSheets

boolean

„True“, um alle Tabellenblätter zu durchsuchen/zu ersetzen.

InsertDimensionRequest

Fügt Zeilen oder Spalten in ein Tabellenblatt an einem bestimmten Index ein.

JSON-Darstellung
{
  "range": {
    object (DimensionRange)
  },
  "inheritFromBefore": boolean
}
Felder
range

object (DimensionRange)

Die einzufügenden Dimensionen. Sowohl der Start- als auch der Endindex müssen begrenzt sein.

inheritFromBefore

boolean

Gibt an, ob die Dimensionseigenschaften von den Dimensionen vor oder nach den neu eingefügten Dimensionen übernommen werden sollen. „Wahr“, um die Dimensionen davor zu übernehmen (in diesem Fall muss der Startindex größer als 0 sein), und „Falsch“, um die Dimensionen danach zu übernehmen.

Wenn beispielsweise Zeilenindex 0 einen roten Hintergrund und Zeilenindex 1 einen grünen Hintergrund hat, können die beiden eingefügten Zeilen bei Index 1 entweder den grünen oder den roten Hintergrund übernehmen. Wenn inheritFromBefore wahr ist, sind die beiden neuen Zeilen rot, da die Zeile vor dem Einfügepunkt rot war. Wenn inheritFromBefore falsch ist, sind die beiden neuen Zeilen grün, da die Zeile nach dem Einfügepunkt grün war.

InsertRangeRequest

Fügt Zellen in einen Bereich ein und verschiebt die vorhandenen Zellen nach rechts oder unten.

JSON-Darstellung
{
  "range": {
    object (GridRange)
  },
  "shiftDimension": enum (Dimension)
}
Felder
range

object (GridRange)

Der Bereich, in den neue Zellen eingefügt werden sollen. Der Bereich ist auf die aktuellen Tabellenblattgrenzen beschränkt.

shiftDimension

enum (Dimension)

Die Dimension, die beim Einfügen von Zellen verschoben wird. Wenn ROWS, werden vorhandene Zellen nach unten verschoben. Wenn COLUMNS, werden vorhandene Zellen nach rechts verschoben.

MoveDimensionRequest

Verschiebt eine oder mehrere Zeilen oder Spalten.

JSON-Darstellung
{
  "source": {
    object (DimensionRange)
  },
  "destinationIndex": integer
}
Felder
source

object (DimensionRange)

Die Quelldimensionen, die verschoben werden sollen.

destinationIndex

integer

Der nullbasierte Startindex, an den die Quelldaten verschoben werden sollen, basierend auf den Koordinaten bevor die Quelldaten aus dem Raster entfernt werden. Vorhandene Daten werden nach unten oder rechts verschoben (je nach Dimension), um Platz für die verschobenen Dimensionen zu schaffen. Die Quelldimensionen werden aus dem Raster entfernt. Die Daten können also an einem anderen Index als angegeben landen.

Wenn Sie beispielsweise A1..A5 von 0, 1, 2, 3, 4 verschieben möchten und "1" und "2" zwischen "3" und "4" verschoben werden sollen, ist die Quelle ROWS [1..3) und der Zielindex "4" (der nullbasierte Index von Zeile 5). Das Endergebnis wäre A1..A5 von 0, 3, 1, 2, 4.

UpdateEmbeddedObjectPositionRequest

Die Position eines eingebetteten Objekts aktualisieren, z. B. ein Diagramm oder Bild verschieben oder seine Größe ändern.

JSON-Darstellung
{
  "objectId": integer,
  "newPosition": {
    object (EmbeddedObjectPosition)
  },
  "fields": string
}
Felder
objectId

integer

Die ID des zu verschiebenden Objekts.

newPosition

object (EmbeddedObjectPosition)

Eine explizite Position, an die das eingebettete Objekt verschoben werden soll. Wenn newPosition.sheetId festgelegt ist, wird ein neues Tabellenblatt mit dieser ID erstellt. Wenn newPosition.newSheet auf „true“ gesetzt ist, wird ein neues Tabellenblatt mit einer automatisch ausgewählten ID erstellt.

fields

string (FieldMask format)

Die Felder von OverlayPosition , die beim Festlegen einer neuen Position aktualisiert werden sollen. Wird nur verwendet, wenn newPosition.overlayPosition festgelegt ist. In diesem Fall muss mindestens ein Feld angegeben werden. Der Stamm newPosition.overlayPosition ist impliziert und sollte nicht angegeben werden. Ein einzelnes "*" kann als Kurzform für die Auflistung aller Felder verwendet werden.

PasteDataRequest

Fügt Daten in die Tabelle ein, beginnend mit der angegebenen Koordinate.

JSON-Darstellung
{
  "coordinate": {
    object (GridCoordinate)
  },
  "data": string,
  "type": enum (PasteType),

  // Union field kind can be only one of the following:
  "delimiter": string,
  "html": boolean
  // End of list of possible types for union field kind.
}
Felder
coordinate

object (GridCoordinate)

Die Koordinate, an der die Daten eingefügt werden sollen.

data

string

Die einzufügenden Daten.

type

enum (PasteType)

So werden die Daten eingefügt.

Union-Feld kind. Um die Daten zu interpretieren, muss genau ein Wert festgelegt werden. Für kind ist nur einer der folgenden Werte zulässig:
delimiter

string

Das Trennzeichen in den Daten.

html

boolean

„True“, wenn die Daten HTML sind.

TextToColumnsRequest

Teilt eine Textspalte anhand eines Trennzeichens in jeder Zelle in mehrere Spalten auf.

JSON-Darstellung
{
  "source": {
    object (GridRange)
  },
  "delimiter": string,
  "delimiterType": enum (DelimiterType)
}
Felder
source

object (GridRange)

Der Quelldatenbereich. Sie muss genau eine Spalte umfassen.

delimiter

string

Das zu verwendende Trennzeichen. Wird nur verwendet, wenn „delimiterType“ CUSTOM ist.

delimiterType

enum (DelimiterType)

Der zu verwendende Trennzeichen-Typ.

DelimiterType

Das Trennzeichen, anhand dessen aufgeteilt werden soll.

Enums
DELIMITER_TYPE_UNSPECIFIED Standardwert. Dieser Wert darf nicht verwendet werden.
COMMA „,“
SEMICOLON ";"
PERIOD „.“
SPACE " "
CUSTOM Ein benutzerdefinierter Wert, wie im Trennzeichen definiert.
AUTODETECT Spalten automatisch erkennen

UpdateFilterViewRequest

Aktualisiert die Attribute der Filteransicht.

JSON-Darstellung
{
  "filter": {
    object (FilterView)
  },
  "fields": string
}
Felder
filter

object (FilterView)

Die neuen Eigenschaften der Filteransicht.

fields

string (FieldMask format)

Die Felder, die aktualisiert werden sollen. Es muss mindestens ein Feld angegeben werden. Der Stamm filter ist impliziert und sollte nicht angegeben werden. Ein einzelnes "*" kann als Kurzform für die Auflistung aller Felder verwendet werden.

DeleteRangeRequest

Löscht einen Zellbereich und verschiebt andere Zellen in den gelöschten Bereich.

JSON-Darstellung
{
  "range": {
    object (GridRange)
  },
  "shiftDimension": enum (Dimension)
}
Felder
range

object (GridRange)

Der zu löschende Zellenbereich.

shiftDimension

enum (Dimension)

Die Dimension, durch die gelöschte Zellen ersetzt werden. Wenn ROWS, werden vorhandene Zellen nach oben verschoben, um die gelöschten Zellen zu ersetzen. Wenn COLUMNS, werden vorhandene Zellen nach links verschoben, um die gelöschten Zellen zu ersetzen.

AppendDimensionRequest

Fügt Zeilen oder Spalten am Ende eines Tabellenblatts an.

JSON-Darstellung
{
  "sheetId": integer,
  "dimension": enum (Dimension),
  "length": integer
}
Felder
sheetId

integer

Die Tabelle, an die Zeilen oder Spalten angehängt werden sollen.

dimension

enum (Dimension)

Gibt an, ob Zeilen oder Spalten angehängt werden sollen.

length

integer

Die Anzahl der anzuhängenden Zeilen oder Spalten.

AddConditionalFormatRuleRequest

Fügt am angegebenen Index eine neue Regel für die bedingte Formatierung hinzu. Die Indexe aller nachfolgenden Regeln werden erhöht.

JSON-Darstellung
{
  "rule": {
    object (ConditionalFormatRule)
  },
  "index": integer
}
Felder
rule

object (ConditionalFormatRule)

Die hinzuzufügende Regel.

index

integer

Der nullbasierte Index, an dem die Regel eingefügt werden soll.

UpdateConditionalFormatRuleRequest

Aktualisiert eine Regel für die bedingte Formatierung am angegebenen Index oder verschiebt eine Regel für die bedingte Formatierung an einen anderen Index.

JSON-Darstellung
{
  "index": integer,
  "sheetId": integer,

  // Union field instruction can be only one of the following:
  "rule": {
    object (ConditionalFormatRule)
  },
  "newIndex": integer
  // End of list of possible types for union field instruction.
}
Felder
index

integer

Der nullbasierte Index der Regel, die ersetzt oder verschoben werden soll.

sheetId

integer

Das Tabellenblatt der Regel, die verschoben werden soll. Erforderlich, wenn newIndex festgelegt ist. Andernfalls wird es nicht verwendet.

Union-Feld instruction. Die Art der Aktualisierung, die erfolgen soll. Für instruction ist nur einer der folgenden Werte zulässig:
rule

object (ConditionalFormatRule)

Die Regel, die die Regel am angegebenen Index ersetzen soll.

newIndex

integer

Der nullbasierte neue Index, an dem die Regel enden soll.

DeleteConditionalFormatRuleRequest

Löscht eine Regel für die bedingte Formatierung am angegebenen Index. Die Indexe aller nachfolgenden Regeln werden dekrementiert.

JSON-Darstellung
{
  "index": integer,
  "sheetId": integer
}
Felder
index

integer

Der nullbasierte Index der zu löschenden Regel.

sheetId

integer

Das Tabellenblatt, aus dem die Regel gelöscht wird.

SortRangeRequest

Sortiert Daten in Zeilen basierend auf einer Sortierreihenfolge pro Spalte.

JSON-Darstellung
{
  "range": {
    object (GridRange)
  },
  "sortSpecs": [
    {
      object (SortSpec)
    }
  ]
}
Felder
range

object (GridRange)

Der Bereich, der sortiert werden soll.

sortSpecs[]

object (SortSpec)

Die Sortierreihenfolge pro Spalte. Spätere Spezifikationen werden verwendet, wenn die Werte in den früheren Spezifikationen gleich sind.

SetDataValidationRequest

Legt für jede Zelle im Bereich eine Datenvalidierungsregel fest. Wenn Sie die Validierung in einem Bereich aufheben möchten, rufen Sie diese Funktion ohne Angabe einer Regel auf.

JSON-Darstellung
{
  "range": {
    object (GridRange)
  },
  "rule": {
    object (DataValidationRule)
  },
  "filteredRowsIncluded": boolean
}
Felder
range

object (GridRange)

Der Bereich, auf den die Datenvalidierungsregel angewendet werden soll.

rule

object (DataValidationRule)

Die Datenvalidierungsregel, die für jede Zelle im Bereich festgelegt werden soll, oder leer, um die Datenvalidierung im Bereich zu löschen.

filteredRowsIncluded

boolean

Optional. Bei „true“ wird die Datenvalidierungsregel auch auf die gefilterten Zeilen angewendet.

SetBasicFilterRequest

Legt den einem Tabellenblatt zugeordneten einfachen Filter fest.

JSON-Darstellung
{
  "filter": {
    object (BasicFilter)
  }
}
Felder
filter

object (BasicFilter)

Der festzulegende Filter.

AddProtectedRangeRequest

Fügt einen neuen geschützten Bereich hinzu.

JSON-Darstellung
{
  "protectedRange": {
    object (ProtectedRange)
  }
}
Felder
protectedRange

object (ProtectedRange)

Der hinzuzufügende geschützte Bereich. Das Feld protectedRangeId ist optional. Wenn keine ID festgelegt ist, wird eine zufällig generiert. Es ist ein Fehler, die ID eines Bereichs anzugeben, der bereits vorhanden ist.

UpdateProtectedRangeRequest

Aktualisiert einen vorhandenen geschützten Bereich mit dem angegebenen protectedRangeId.

JSON-Darstellung
{
  "protectedRange": {
    object (ProtectedRange)
  },
  "fields": string
}
Felder
protectedRange

object (ProtectedRange)

Der geschützte Bereich, der mit den neuen Eigenschaften aktualisiert werden soll.

fields

string (FieldMask format)

Die Felder, die aktualisiert werden sollen. Es muss mindestens ein Feld angegeben werden. Der Stamm protectedRange ist impliziert und sollte nicht angegeben werden. Ein einzelnes "*" kann als Kurzform für die Auflistung aller Felder verwendet werden.

DeleteProtectedRangeRequest

Löscht den geschützten Bereich mit der angegebenen ID.

JSON-Darstellung
{
  "protectedRangeId": integer
}
Felder
protectedRangeId

integer

Die ID des geschützten Bereichs, der gelöscht werden soll.

AutoResizeDimensionsRequest

Die Größe einer oder mehrerer Dimensionen wird automatisch an den Inhalt der Zellen in dieser Dimension angepasst.

JSON-Darstellung
{

  // Union field dimension_range can be only one of the following:
  "dimensions": {
    object (DimensionRange)
  },
  "dataSourceSheetDimensions": {
    object (DataSourceSheetDimensionRange)
  }
  // End of list of possible types for union field dimension_range.
}
Felder
Union-Feld dimension_range. Der Dimensionsbereich. Für dimension_range ist nur einer der folgenden Werte zulässig:
dimensions

object (DimensionRange)

Die Dimensionen, die automatisch angepasst werden sollen.

dataSourceSheetDimensions

object (DataSourceSheetDimensionRange)

Die Dimensionen in einem Datenquellenblatt, deren Größe automatisch angepasst werden soll.

AddChartRequest

Fügt einem Tabellenblatt in der Tabelle ein Diagramm hinzu.

JSON-Darstellung
{
  "chart": {
    object (EmbeddedChart)
  }
}
Felder
chart

object (EmbeddedChart)

Das Diagramm, das der Tabelle hinzugefügt werden soll, einschließlich der Position, an der es platziert werden soll. Das Feld chartId ist optional. Wenn keine ID festgelegt ist, wird eine zufällig generiert. Es ist ein Fehler, die ID eines eingebetteten Objekts anzugeben, das bereits vorhanden ist.

UpdateChartSpecRequest

Aktualisiert die Spezifikationen eines Diagramms. Das Diagramm wird dadurch nicht verschoben oder in der Größe angepasst. Um ein Diagramm zu verschieben oder seine Größe anzupassen, verwenden Sie UpdateEmbeddedObjectPositionRequest.

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

integer

Die ID des zu aktualisierenden Diagramms.

spec

object (ChartSpec)

Die auf das Diagramm anzuwendende Spezifikation.

UpdateBandingRequest

Aktualisiert die Eigenschaften des angegebenen Bereichs.

JSON-Darstellung
{
  "bandedRange": {
    object (BandedRange)
  },
  "fields": string
}
Felder
bandedRange

object (BandedRange)

Der Bereich, der mit den neuen Eigenschaften aktualisiert werden soll.

fields

string (FieldMask format)

Die Felder, die aktualisiert werden sollen. Es muss mindestens ein Feld angegeben werden. Der Stamm bandedRange ist impliziert und sollte nicht angegeben werden. Ein einzelnes "*" kann als Kurzform für die Auflistung aller Felder verwendet werden.

AddBandingRequest

Fügt der Tabelle einen neuen Bereich mit unterschiedlichen Farben hinzu.

JSON-Darstellung
{
  "bandedRange": {
    object (BandedRange)
  }
}
Felder
bandedRange

object (BandedRange)

Der hinzuzufügende Bereich mit unterschiedlichen Farben. Das Feld bandedRangeId ist optional. Wenn keine ID festgelegt ist, wird eine zufällig generiert. Es ist ein Fehler, die ID eines Bereichs anzugeben, der bereits vorhanden ist.

DeleteBandingRequest

Entfernt den Bereich mit den angegebenen Klassen aus der Tabelle.

JSON-Darstellung
{
  "bandedRangeId": integer
}
Felder
bandedRangeId

integer

Die ID des zu löschenden Bereichs.

CreateDeveloperMetadataRequest

Eine Anfrage zum Erstellen von Entwicklermetadaten.

JSON-Darstellung
{
  "developerMetadata": {
    object (DeveloperMetadata)
  }
}
Felder
developerMetadata

object (DeveloperMetadata)

Die zu erstellenden Entwicklermetadaten.

UpdateDeveloperMetadataRequest

Ein Request zum Aktualisieren von Attributen von Entwicklermetadaten. Aktualisiert die Eigenschaften der Entwicklermetadaten, die durch die Filter ausgewählt wurden, auf die Werte, die in der DeveloperMetadata-Ressource angegeben sind. Anrufer müssen die Eigenschaften, die sie aktualisieren möchten, im Parameter „fields“ angeben und mindestens eine DataFilter angeben, die den Metadaten entspricht, die sie aktualisieren möchten.

JSON-Darstellung
{
  "dataFilters": [
    {
      object (DataFilter)
    }
  ],
  "developerMetadata": {
    object (DeveloperMetadata)
  },
  "fields": string
}
Felder
dataFilters[]

object (DataFilter)

Die Filter, die mit den zu aktualisierenden Einträgen für Entwicklermetadaten übereinstimmen.

developerMetadata

object (DeveloperMetadata)

Der Wert, auf den alle Metadaten aktualisiert werden, die den Datenfiltern entsprechen.

fields

string (FieldMask format)

Die Felder, die aktualisiert werden sollen. Es muss mindestens ein Feld angegeben werden. Der Stamm developerMetadata ist impliziert und sollte nicht angegeben werden. Ein einzelnes "*" kann als Kurzform für die Auflistung aller Felder verwendet werden.

DeleteDeveloperMetadataRequest

Ein Request zum Löschen von Entwicklermetadaten.

JSON-Darstellung
{
  "dataFilter": {
    object (DataFilter)
  }
}
Felder
dataFilter

object (DataFilter)

Der Datenfilter, der die Kriterien zum Auswählen des zu löschenden Entwicklermetadateneintrags beschreibt.

RandomizeRangeRequest

Randomisiert die Reihenfolge der Zeilen in einem Bereich.

JSON-Darstellung
{
  "range": {
    object (GridRange)
  }
}
Felder
range

object (GridRange)

Der Bereich, der randomisiert werden soll.

AddDimensionGroupRequest

Erstellt eine Gruppe für den angegebenen Bereich.

Wenn der angeforderte Bereich eine Obermenge des Bereichs einer vorhandenen Gruppe G ist, wird die Tiefe von G erhöht und diese neue Gruppe G' hat die Tiefe dieser Gruppe. Beispiel: Eine Gruppe [C:D, Tiefe 1] + [B:E] führt zu den Gruppen [B:E, Tiefe 1] und [C:D, Tiefe 2]. Wenn der angeforderte Bereich eine Teilmenge des Bereichs einer vorhandenen Gruppe G ist, ist die Tiefe der neuen Gruppe G' um eins größer als die Tiefe von G. Beispiel: Eine Gruppe [B:E, Tiefe 1] + [C:D] führt zu den Gruppen [B:E, Tiefe 1] und [C:D, Tiefe 2]. Wenn der angeforderte Bereich vor dem Bereich einer vorhandenen Gruppe G beginnt und innerhalb dieses Bereichs endet oder innerhalb des Bereichs von G beginnt und nach diesem Bereich endet, wird der Bereich der vorhandenen Gruppe G zur Vereinigung der Bereiche. Die neue Gruppe G' hat eine Tiefe, die um eins größer ist als die Tiefe von G, und einen Bereich, der dem Schnittpunkt der Bereiche entspricht. Beispiel: Eine Gruppe [B:D, Tiefe 1] + [C:E] führt zu den Gruppen [B:E, Tiefe 1] und [C:D, Tiefe 2].

JSON-Darstellung
{
  "range": {
    object (DimensionRange)
  }
}
Felder
range

object (DimensionRange)

Der Bereich, über den eine Gruppe erstellt werden soll.

DeleteDimensionGroupRequest

Löscht eine Gruppe über den angegebenen Bereich, indem die Tiefe der Dimensionen im Bereich verringert wird.

Angenommen, das Tabellenblatt enthält eine Gruppe der Tiefe 1 für B:E und eine Gruppe der Tiefe 2 für C:D. Wenn Sie eine Gruppe über D:E löschen, enthält das Tabellenblatt eine Gruppe mit Tiefe 1 über B:D und eine Gruppe mit Tiefe 2 über C:C.

JSON-Darstellung
{
  "range": {
    object (DimensionRange)
  }
}
Felder
range

object (DimensionRange)

Der Bereich der zu löschenden Gruppe.

UpdateDimensionGroupRequest

Aktualisiert den Status der angegebenen Gruppe.

JSON-Darstellung
{
  "dimensionGroup": {
    object (DimensionGroup)
  },
  "fields": string
}
Felder
dimensionGroup

object (DimensionGroup)

Die Gruppe, deren Status aktualisiert werden soll. Der Bereich und die Tiefe der Gruppe sollten eine gültige Gruppe im Tabellenblatt angeben und alle anderen Felder sollten aktualisiert werden.

fields

string (FieldMask format)

Die Felder, die aktualisiert werden sollen. Es muss mindestens ein Feld angegeben werden. Der Stamm dimensionGroup ist impliziert und sollte nicht angegeben werden. Ein einzelnes "*" kann als Kurzform für die Auflistung aller Felder verwendet werden.

TrimWhitespaceRequest

Entfernt Leerräume (z. B. Leerzeichen, Tabulatoren oder Zeilenumbrüche) in jeder Zelle im angegebenen Bereich. Bei dieser Anfrage werden alle Leerzeichen am Anfang und Ende des Texts jeder Zelle entfernt und alle verbleibenden Leerzeichenfolgen auf ein einzelnes Leerzeichen reduziert. Wenn der resultierende gekürzte Text mit einem „+“- oder „=“-Zeichen beginnt, bleibt der Text ein Stringwert und wird nicht als Formel interpretiert.

JSON-Darstellung
{
  "range": {
    object (GridRange)
  }
}
Felder
range

object (GridRange)

Der Bereich, dessen Zellen gekürzt werden sollen.

DeleteDuplicatesRequest

Entfernt Zeilen in diesem Bereich, die Werte in den angegebenen Spalten enthalten, die Duplikate von Werten in einer vorherigen Zeile sind. Zeilen mit identischen Werten und unterschiedlicher Groß- und Kleinschreibung, Formatierung oder unterschiedlichen Formeln gelten ebenfalls als Duplikate.

Bei dieser Anfrage werden auch doppelte Zeilen entfernt, die ausgeblendet sind (z. B. aufgrund eines Filters). Beim Entfernen von Duplikaten wird die erste Instanz jeder doppelten Zeile, die von oben nach unten gescannt wird, im resultierenden Bereich beibehalten. Inhalte außerhalb des angegebenen Bereichs werden nicht entfernt. Zeilen, die als Duplikate gelten, müssen im Bereich nicht nebeneinander liegen.

JSON-Darstellung
{
  "range": {
    object (GridRange)
  },
  "comparisonColumns": [
    {
      object (DimensionRange)
    }
  ]
}
Felder
range

object (GridRange)

Der Bereich, aus dem doppelte Zeilen entfernt werden sollen.

comparisonColumns[]

object (DimensionRange)

Die Spalten im Bereich, die auf doppelte Werte analysiert werden sollen. Wenn keine Spalten ausgewählt sind, werden alle Spalten auf Duplikate analysiert.

UpdateEmbeddedObjectBorderRequest

Aktualisiert das Attribut „Rahmen“ eines eingebetteten Objekts.

JSON-Darstellung
{
  "objectId": integer,
  "border": {
    object (EmbeddedObjectBorder)
  },
  "fields": string
}
Felder
objectId

integer

Die ID des einzubettenden Objekts, das aktualisiert werden soll.

border

object (EmbeddedObjectBorder)

Der Rahmen, der für das eingebettete Objekt gilt.

fields

string (FieldMask format)

Die Felder, die aktualisiert werden sollen. Es muss mindestens ein Feld angegeben werden. Der Stamm border ist impliziert und sollte nicht angegeben werden. Ein einzelnes "*" kann als Kurzform für die Auflistung aller Felder verwendet werden.

AddSlicerRequest

Fügt einem Tabellenblatt in der Tabelle einen Slicer hinzu.

JSON-Darstellung
{
  "slicer": {
    object (Slicer)
  }
}
Felder
slicer

object (Slicer)

Der Slicer, der der Tabelle hinzugefügt werden soll, einschließlich der Position, an der er platziert werden soll. Das Feld slicerId ist optional. Wenn keine ID festgelegt ist, wird eine zufällig generiert. Es ist ein Fehler, die ID eines bereits vorhandenen Slicers anzugeben.

UpdateSlicerSpecRequest

Aktualisiert die Spezifikationen eines Slicers. Dadurch wird ein Slicer nicht verschoben oder in der Größe angepasst. Verwenden Sie UpdateEmbeddedObjectPositionRequest, um einen Slicer zu verschieben oder seine Größe anzupassen.

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

integer

Die ID des zu aktualisierenden Slicers.

spec

object (SlicerSpec)

Die auf den Slicer anzuwendende Spezifikation.

fields

string (FieldMask format)

Die Felder, die aktualisiert werden sollen. Es muss mindestens ein Feld angegeben werden. Der Stamm SlicerSpec ist impliziert und sollte nicht angegeben werden. Ein einzelnes „*“ kann als Kurzform für die Auflistung aller Felder verwendet werden.

AddDataSourceRequest

Fügt eine Datenquelle hinzu. Nachdem die Datenquelle erfolgreich hinzugefügt wurde, wird ein zugehöriges DATA_SOURCE-Tabellenblatt erstellt und eine Ausführung ausgelöst, um das Tabellenblatt zu aktualisieren und Daten aus der Datenquelle zu lesen.

Für die Anfrage ist ein zusätzlicher bigquery.readonly-OAuth-Bereich erforderlich, wenn Sie eine BigQuery-Datenquelle hinzufügen.

JSON-Darstellung
{
  "dataSource": {
    object (DataSource)
  }
}
Felder
dataSource

object (DataSource)

Die hinzuzufügende Datenquelle.

UpdateDataSourceRequest

Aktualisiert eine Datenquelle. Nachdem die Datenquelle erfolgreich aktualisiert wurde, wird eine Ausführung ausgelöst, um das zugehörige DATA_SOURCE-Tabellenblatt zu aktualisieren und Daten aus der aktualisierten Datenquelle zu lesen.

Für die Anfrage ist ein zusätzlicher bigquery.readonly-OAuth-Bereich erforderlich, wenn Sie eine BigQuery-Datenquelle aktualisieren.

JSON-Darstellung
{
  "dataSource": {
    object (DataSource)
  },
  "fields": string
}
Felder
dataSource

object (DataSource)

Die zu aktualisierende Datenquelle.

fields

string (FieldMask format)

Die Felder, die aktualisiert werden sollen. Es muss mindestens ein Feld angegeben werden. Der Stamm dataSource ist impliziert und sollte nicht angegeben werden. Ein einzelnes "*" kann als Kurzform für die Auflistung aller Felder verwendet werden.

DeleteDataSourceRequest

Löscht eine Datenquelle. Durch die Anfrage wird auch das zugehörige Datenquellenblatt gelöscht und die Verknüpfung aller zugehörigen Datenquellenobjekte aufgehoben.

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

string

Die ID der zu löschenden Datenquelle.

RefreshDataSourceRequest

Aktualisiert ein oder mehrere Datenquellenobjekte in der Tabelle anhand der angegebenen Referenzen.

Für die Anfrage ist ein zusätzlicher bigquery.readonly-OAuth-Bereich erforderlich, wenn Sie eine BigQuery-Datenquelle aktualisieren.

Wenn in einem Batch mehrere Aktualisierungsanfragen auf dieselben Datenquellenobjekte verweisen, wird nur die letzte Aktualisierungsanfrage verarbeitet und alle Anfragen haben dieselbe Antwort.

JSON-Darstellung
{
  "force": boolean,

  // Union field target can be only one of the following:
  "references": {
    object (DataSourceObjectReferences)
  },
  "dataSourceId": string,
  "isAll": boolean
  // End of list of possible types for union field target.
}
Felder
force

boolean

Aktualisiert die Datenquellenobjekte unabhängig vom aktuellen Status. Wenn dieser Wert nicht festgelegt ist und für ein referenziertes Datenquellenobjekt ein Fehlerstatus vorlag, schlägt die Aktualisierung sofort fehl.

Union-Feld target. Gibt an, was aktualisiert werden soll. Für target ist nur einer der folgenden Werte zulässig:
references

object (DataSourceObjectReferences)

Verweise auf Datenquellenobjekte, die aktualisiert werden sollen.

dataSourceId

string

Verweis auf eine DataSource. Falls angegeben, werden alle zugehörigen Datenquellenobjekte für die Datenquelle aktualisiert.

isAll

boolean

Alle vorhandenen Datenquellenobjekte in der Tabelle werden aktualisiert.

DataSourceObjectReferences

Eine Liste mit Verweisen auf Datenquellenobjekte.

JSON-Darstellung
{
  "references": [
    {
      object (DataSourceObjectReference)
    }
  ]
}
Felder
references[]

object (DataSourceObjectReference)

Die Referenzen.

DataSourceObjectReference

Verweis auf ein Datenquellenobjekt.

JSON-Darstellung
{

  // Union field value can be only one of the following:
  "sheetId": string,
  "chartId": integer,
  "dataSourceTableAnchorCell": {
    object (GridCoordinate)
  },
  "dataSourcePivotTableAnchorCell": {
    object (GridCoordinate)
  },
  "dataSourceFormulaCell": {
    object (GridCoordinate)
  }
  // End of list of possible types for union field value.
}
Felder
Union-Feld value. Der Referenztyp. Für value ist nur einer der folgenden Werte zulässig:
sheetId

string

Verweise auf ein DATA_SOURCE-Tabellenblatt.

chartId

integer

Verweise auf ein Diagramm für eine Datenquelle.

dataSourceTableAnchorCell

object (GridCoordinate)

Verweise auf eine DataSourceTable, die in der Zelle verankert sind.

dataSourcePivotTableAnchorCell

object (GridCoordinate)

Verweise auf eine Datenquelle PivotTable in der Zelle verankert.

dataSourceFormulaCell

object (GridCoordinate)

Verweise auf eine Zelle, die DataSourceFormula enthält.

CancelDataSourceRefreshRequest

Bricht eine oder mehrere Aktualisierungen von Datenquellenobjekten in der Tabelle anhand der angegebenen Referenzen ab.

Für die Anfrage ist ein zusätzlicher bigquery.readonly-OAuth-Bereich erforderlich, wenn Sie eine Aktualisierung für eine BigQuery-Datenquelle abbrechen.

JSON-Darstellung
{

  // Union field target can be only one of the following:
  "references": {
    object (DataSourceObjectReferences)
  },
  "dataSourceId": string,
  "isAll": boolean
  // End of list of possible types for union field target.
}
Felder
Union-Feld target. Gibt an, was storniert werden soll. Für target ist nur einer der folgenden Werte zulässig:
references

object (DataSourceObjectReferences)

Verweise auf Datenquellenobjekte, deren Aktualisierungen abgebrochen werden sollen.

dataSourceId

string

Verweis auf eine DataSource. Falls angegeben, werden alle zugehörigen Aktualisierungen von Datenquellenobjekten für diese Datenquelle abgebrochen.

isAll

boolean

Bricht alle vorhandenen Aktualisierungen von Datenquellenobjekten für alle Datenquellen in der Tabelle ab.

AddTableRequest

Fügt der Tabelle eine neue Tabelle hinzu.

JSON-Darstellung
{
  "table": {
    object (Table)
  }
}
Felder
table

object (Table)

Erforderlich. Die hinzuzufügende Tabelle.

UpdateTableRequest

Aktualisiert eine Tabelle in der Tabelle.

JSON-Darstellung
{
  "table": {
    object (Table)
  },
  "fields": string
}
Felder
table

object (Table)

Erforderlich. Die zu aktualisierende Tabelle.

fields

string (FieldMask format)

Erforderlich. Die Felder, die aktualisiert werden sollen. Es muss mindestens ein Feld angegeben werden. Der Stamm table ist impliziert und sollte nicht angegeben werden. Ein einzelnes "*" kann als Kurzform für die Auflistung aller Felder verwendet werden.

DeleteTableRequest

Entfernt die Tabelle mit der angegebenen ID aus der Tabelle.

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

string

Die ID der zu löschenden Tabelle.