Requests

Anfrage

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

JSON-Darstellung 
{

  "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)
  },
  "insertComment": {
    object (InsertCommentRequest)
  },
  "addCommentReply": {
    object (AddCommentReplyRequest)
  },
  "updateCommentPost": {
    object (UpdateCommentPostRequest)
  },
  "deleteComment": {
    object (DeleteCommentRequest)
  },
  "deleteCommentReply": {
    object (DeleteCommentReplyRequest)
  }
}
Felder
Die Art des Updates. Genau ein Feld ist erforderlich. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
updateSpreadsheetProperties

object (UpdateSpreadsheetPropertiesRequest)

Aktualisiert die Eigenschaften der Tabelle.

updateSheetProperties

object (UpdateSheetPropertiesRequest)

Aktualisiert die Eigenschaften eines Tabellenblatts.

updateDimensionProperties

object (UpdateDimensionPropertiesRequest)

Aktualisiert die Eigenschaften 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 basierend auf vorhandenen 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)

Führt Zellen zusammen.

unmergeCells

object (UnmergeCellsRequest)

Hebt den Verbund von verbundenen Zellen auf.

updateBorders

object (UpdateBordersRequest)

Aktualisiert die Rahmenlinien in einem Zellenbereich.

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)

Löscht den einfachen Filter in einem Tabellenblatt.

deleteDimension

object (DeleteDimensionRequest)

Löscht Zeilen oder Spalten in einem Tabellenblatt.

deleteEmbeddedObject

object (DeleteEmbeddedObjectRequest)

Löscht ein eingebettetes Objekt (z. B. Diagramm, 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 Eigenschaften einer Filteransicht.

deleteRange

object (DeleteRangeRequest)

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

appendDimension

object (AppendDimensionRequest)

Fügt Dimensionen an das 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 Bändern

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 zugehöriger 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.

insertComment

object (InsertCommentRequest)

Fügt ein CommentThread in die Tabelle ein.

addCommentReply

object (AddCommentReplyRequest)

Fügt eine Antwort auf eine CommentThread hinzu.

updateCommentPost

object (UpdateCommentPostRequest)

Aktualisiert einen vorhandenen Beitrag (Hauptbeitrag oder Antwort) einer CommentThread.

deleteComment

object (DeleteCommentRequest)

Löscht eine CommentThread.

deleteCommentReply

object (DeleteCommentReplyRequest)

Löscht eine Antwort Post aus einem CommentThread

Ende der sich gegenseitig ausschließenden Felder.

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 dem 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 Eigenschaften von Dimensionen im angegebenen Bereich.

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

  "range": {
    object (DimensionRange)
  },
  "dataSourceSheetRange": {
    object (DataSourceSheetDimensionRange)
  }
}
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.

Der Dimensionsbereich. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
range

object (DimensionRange)

Die zu aktualisierenden Zeilen oder Spalten.

dataSourceSheetRange

object (DataSourceSheetDimensionRange)

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

Ende der sich gegenseitig ausschließenden Felder.

DataSourceSheetDimensionRange

Ein Bereich entlang einer einzelnen Dimension in 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 Datenquellen-Tabellenblatt.

UpdateNamedRangeRequest

Aktualisiert die Eigenschaften 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 im Feld fields aufgeführten Felder werden aktualisiert. Die anderen bleiben unverändert.

Wenn Sie eine Zelle mit einer Formel schreiben, werden die Bereiche der Formel für jedes Feld im Bereich automatisch erhöht. 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 benannte Bereich, der hinzugefügt werden soll. Das Feld namedRangeId ist optional. Wenn keine ID festgelegt ist, wird eine zufällig generiert. Es ist ein Fehler, die ID eines bereits vorhandenen Bereichs anzugeben.

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 Tabellenblatt an einem bestimmten Index hinzugefügt wird, werden die Indexe aller nachfolgenden Tabellenblätter erhöht. Verwenden Sie stattdessen AddChartRequest und geben Sie EmbeddedObjectPosition.sheetId oder EmbeddedObjectPosition.newSheet an, um ein Objektblatt hinzuzufügen.

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 die zugehörige DataSource gelöscht.

AutoFillRequest

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

JSON-Darstellung 
{
  "useAlternateSeries": boolean,

  "range": {
    object (GridRange)
  },
  "sourceAndDestination": {
    object (SourceAndDestination)
  }
}
Felder
useAlternateSeries

boolean

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

Der Bereich, der automatisch ausgefüllt werden soll. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
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, die automatisch ausgefüllt werden sollen. Hier wird die Quelle der automatischen Vervollständigung und der Ort, an dem die Daten erweitert werden sollen, explizit aufgeführt.

Ende der sich gegenseitig ausschließenden Felder.

SourceAndDestination

Eine Kombination aus einem Quellbereich und der Art und Weise, wie dieser 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 das automatische Ausfüllen 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, Formatierungen und Zusammenführungen einfügen
PASTE_VALUES Fügen Sie NUR die Werte ein, ohne Formate, Formeln oder Zusammenführungen.
PASTE_FORMAT Nur das Format einfügen, ohne Datenvalidierung.
PASTE_NO_BORDERS Wie PASTE_NORMAL – nur ohne Grenzen.
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 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

Wie ein Einfügevorgang ausgeführt werden soll.

Enums
NORMAL Fügen Sie den Text wie gewohnt ein.
TRANSPOSE Einfügen und transponieren: Alle Zeilen werden zu Spalten und umgekehrt.

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 zu erstellenden Zusammenführung.

Enums
MERGE_ALL Einzelnen Merge aus dem Bereich erstellen
MERGE_COLUMNS Für jede Spalte im Bereich eine Zusammenführung erstellen
MERGE_ROWS Für jede Zeile im Bereich eine Zusammenführung erstellen

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 sich der Bereich über mehrere Zusammenführungen erstreckt, werden alle aufgehoben. Der Bereich darf nicht teilweise über einen Merge hinweg verlaufen.

UpdateBordersRequest

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

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

Das würde dazu führen, dass A1:A5 die Rahmen { 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)

Die Rahmenlinie, die unten im Bereich eingefügt 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 Rahmenlinie, 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,

  "start": {
    object (GridCoordinate)
  },
  "range": {
    object (GridRange)
  }
}
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. Die Stammzelle ist „CellData“. „row.values.“ sollte nicht angegeben werden. Ein einzelnes "*" kann als Kurzform für die Auflistung aller Felder verwendet werden.

Die Standortdaten sollten geschrieben werden. Es muss genau ein Wert festgelegt werden. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
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 den in fields festgelegten Feldern entsprechen, gelöscht.

Ende der sich gegenseitig ausschließenden Felder.

AddFilterViewRequest

Fügt eine Filteransicht hinzu.

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

object (FilterView)

Der Filter, der hinzugefügt werden soll. 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,

  "tableId": string
}
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. Die Stammzelle ist „CellData“. „row.values.“ sollte nicht angegeben werden. Ein einzelnes "*" kann als Kurzform für die Auflistung aller Felder verwendet werden.

Die Standortdaten sollten geschrieben werden. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
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.

Ende der sich gegenseitig ausschließenden Felder.

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

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 mit der neuen Kopie des Tabellenblatts verknüpft. 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, muss 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,

  "range": {
    object (GridRange)
  },
  "sheetId": integer,
  "allSheets": boolean
}
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

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

searchByRegex

boolean

„Wahr“, 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 Ersetzungsstring darf auf Erfassungsgruppen verweisen. Wenn eine Zelle beispielsweise den Inhalt "Google Sheets" und eine andere den Inhalt "Google Docs" hat, ändert sich der Inhalt der Zellen durch die Suche nach "o.* (.*)" mit dem Ersetzen durch "$1 Rocks" in "GSheets Rocks" und "GDocs Rocks".

includeFormulas

boolean

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

Der Bereich, in dem gesucht und ersetzt werden soll. Es muss genau einer festgelegt werden. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
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

„Wahr“, um in allen Tabellenblättern zu suchen und zu ersetzen.

Ende der sich gegenseitig ausschließenden Felder.

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 beim Einfügen von zwei Zeilen am Index 1 entweder der grüne oder der rote Hintergrund übernommen werden. Wenn inheritFromBefore auf „true“ gesetzt ist, sind die beiden neuen Zeilen rot, da die Zeile vor dem Einfügepunkt rot war. Wenn inheritFromBefore auf „false“ gesetzt 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 zu verschiebenden Quelldimensionen.

destinationIndex

integer

Der nullbasierte Startindex, an den die Quelldaten verschoben werden sollen, basierend auf den Koordinaten vor dem Entfernen der Quelldaten aus dem Raster. 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 die Werte A1..A5 aus 0, 1, 2, 3, 4 verschieben möchten und "1" und "2" zwischen "3" und "4" liegen 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 ID erstellt, die für Sie ausgewählt wird.

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),

  "delimiter": string,
  "html": boolean
}
Felder
coordinate

object (GridCoordinate)

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

data

string

Die einzufügenden Daten.

type

enum (PasteType)

Wie die Daten eingefügt werden sollen.

Wie die Daten interpretiert werden sollen. Es muss genau ein Wert festgelegt werden. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
delimiter

string

Das Trennzeichen in den Daten.

html

boolean

„True“, wenn die Daten HTML sind.

Ende der sich gegenseitig ausschließenden Felder.

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, das zum Aufteilen verwendet 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 Eigenschaften 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 Zellenbereich 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

Hängt Zeilen oder Spalten an das Ende eines Tabellenblatts an.

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

integer

Das Tabellenblatt, dem 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,

  "rule": {
    object (ConditionalFormatRule)
  },
  "newIndex": integer
}
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 der Parameter nicht verwendet.

Die Art der Aktualisierung, die erfolgen soll. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
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.

Ende der sich gegenseitig ausschließenden Felder.

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. Wenn „true“, wird die Regel zur Datenvalidierung auch auf die gefilterten Zeilen angewendet.

SetBasicFilterRequest

Legt den mit einem Tabellenblatt verknüpften 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 geschützte Bereich, der hinzugefügt werden soll. Das Feld protectedRangeId ist optional. Wenn keine ID festgelegt ist, wird eine zufällig generiert. Es ist ein Fehler, die ID eines bereits vorhandenen Bereichs anzugeben.

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 zu löschenden geschützten Bereichs.

AutoResizeDimensionsRequest

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

JSON-Darstellung 
{

  "dimensions": {
    object (DimensionRange)
  },
  "dataSourceSheetDimensions": {
    object (DataSourceSheetDimensionRange)
  }
}
Felder
Der Dimensionsbereich. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
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.

Ende der sich gegenseitig ausschließenden Felder.

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 bereits vorhandenen eingebetteten Objekts anzugeben.

UpdateChartSpecRequest

Aktualisiert die Spezifikationen eines Diagramms. Das Diagramm wird dadurch nicht verschoben oder in der Größe angepasst. Wenn Sie ein Diagramm verschieben oder seine Größe anpassen möchten, 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 Bereich mit Klassen, der hinzugefügt werden soll. Das Feld bandedRangeId ist optional. Wenn keine ID festgelegt ist, wird eine zufällig generiert. Es ist ein Fehler, die ID eines bereits vorhandenen Bereichs anzugeben.

DeleteBandingRequest

Entfernt den Bereich mit dem angegebenen ID-Wert 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

Eine Anfrage zum Aktualisieren von Attributen der Entwicklermetadaten. Aktualisiert die Eigenschaften der Entwicklermetadaten, die durch die Filter ausgewählt wurden, auf die Werte, die in der DeveloperMetadata-Ressource angegeben sind. Aufrufer müssen die Eigenschaften, die sie aktualisieren möchten, im Parameter „fields“ angeben sowie mindestens einen DataFilter angeben, der 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 Entwicklermetadateneinträgen übereinstimmen.

developerMetadata

object (DeveloperMetadata)

Der Wert, auf den alle Metadaten aktualisiert werden, die mit den Datenfiltern übereinstimmen.

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

Eine Anfrage 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 von G. 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, für den eine Gruppe erstellt werden soll.

DeleteDimensionGroupRequest

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

Angenommen, das Tabellenblatt enthält eine Gruppe der Tiefe 1 für die Spalten B bis E und eine Gruppe der Tiefe 2 für die Spalten C bis 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 die Leerzeichen (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 nachfolgenden Folgen von verbleibenden Leerzeichen 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 in den angegebenen Spalten Werte enthalten, die Duplikate von Werten in einer vorherigen Zeile sind. Zeilen mit identischen Werten, aber unterschiedlichen Schreibweisen, Formatierungen oder Formeln gelten 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 Datenschnitts anzugeben.

UpdateSlicerSpecRequest

Aktualisiert die Spezifikationen eines Slicers. Damit wird kein Slicer verschoben oder in der Größe angepasst. Mit UpdateEmbeddedObjectPositionRequest können Sie einen Datenschnitt verschieben oder seine Größe anpassen.

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

integer

Die ID des zu aktualisierenden Datenschnitts.

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 Datenquelle, die hinzugefügt werden soll.

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 Datenquellen-Tabellenblatt 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 vorhanden sind, die auf dieselben Datenquellenobjekte verweisen, wird nur die letzte Aktualisierungsanfrage verarbeitet. Alle Anfragen haben dann dieselbe Antwort.

JSON-Darstellung 
{
  "force": boolean,

  "references": {
    object (DataSourceObjectReferences)
  },
  "dataSourceId": string,
  "isAll": boolean
}
Felder
force

boolean

Aktualisiert die Datenquellenobjekte unabhängig vom aktuellen Status. Wenn nicht festgelegt und bei einem referenzierten Datenquellenobjekt ein Fehler vorlag, schlägt die Aktualisierung sofort fehl.

Gibt an, was aktualisiert werden soll. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
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

Aktualisiert alle vorhandenen Datenquellenobjekte in der Tabelle.

Ende der sich gegenseitig ausschließenden Felder.

DataSourceObjectReferences

Eine Liste von Verweisen auf Datenquellenobjekte.

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

object (DataSourceObjectReference)

Die Referenzen.

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 
{

  "references": {
    object (DataSourceObjectReferences)
  },
  "dataSourceId": string,
  "isAll": boolean
}
Felder
Gibt an, was storniert werden soll. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
references

object (DataSourceObjectReferences)

Verweise auf Datenquellenobjekte, deren Aktualisierungen abgebrochen werden sollen.

dataSourceId

string

Verweis auf eine DataSource. Wenn 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.

Ende der sich gegenseitig ausschließenden Felder.

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

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

string

Die ID der zu löschenden Tabelle.

InsertCommentRequest

Fügt ein CommentThread in die Tabelle ein.

JSON-Darstellung 
{
  "content": string,
  "assigneeEmailAddress": string,

  "coordinate": {
    object (GridCoordinate)
  }
}
Felder
content

string

Der Text des Kommentars als Nur-Text.

Diese Textinhalte werden ähnlich wie Kommentare behandelt, die im Sheets-Editor erstellt wurden. Die Formatierung und Benachrichtigungen sind ähnlich.

Dieses Feld darf nicht leer sein und darf 2.048 UTF‑8-Codeeinheiten nicht überschreiten.

assigneeEmailAddress

string

Optional. Die E‑Mail-Adresse des Nutzers, dem der Kommentar zugewiesen ist.

Lassen Sie das Feld leer, wenn der Kommentar nicht zugewiesen werden soll.

Darf nicht mehr als 2.048 UTF‑8-Codeeinheiten enthalten.

Die Position im Tabellenblatt, die mit diesem Kommentar verknüpft ist. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
coordinate

object (GridCoordinate)

Die GridCoordinate im Tabellenblatt, das mit diesem Kommentar verknüpft ist.

Ende der sich gegenseitig ausschließenden Felder.

AddCommentReplyRequest

Fügt eine Antwort Post in eine CommentThread ein.

JSON-Darstellung 
{
  "commentId": string,
  "post": {
    object (Post)
  }
}
Felder
commentId

string

Die ID der CommentThread, der die Antwort hinzugefügt werden soll.

post

object (Post)

Die Post, die die Antwort darstellt.

UpdateCommentPostRequest

Aktualisiert ein Post in einem CommentThread.

Gibt einen 400-Fehler („Bad Request“) zurück, wenn:

  • Der anfragende Nutzer ist nicht der Autor des Beitrags.
JSON-Darstellung 
{
  "commentId": string,
  "postId": string,
  "content": string
}
Felder
commentId

string

Die ID des CommentThread, zu dem der Beitrag gehört.

postId

string

Die ID des Beitrags, der aktualisiert wird.

content

string

Der neue Text des Kommentars im Nur-Text-Format.

Diese Textinhalte werden ähnlich wie Kommentare behandelt, die im Sheets-Editor erstellt wurden. Die Formatierung und Benachrichtigungen sind ähnlich.

Dieses Feld darf nicht leer sein und darf 2.048 UTF‑8-Codeeinheiten nicht überschreiten.

DeleteCommentRequest

Löscht eine CommentThread.

Gibt einen 400-Fehler zurück, wenn der anfragende Nutzer nicht der Autor von headPost ist.

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

string

Die ID des CommentThread, der gelöscht wird.

DeleteCommentReplyRequest

Löscht eine Antwort Post aus einem CommentThread.

Gibt einen 400-Fehler („Bad Request“) zurück, wenn:

  • Der anfragende Nutzer ist nicht der Autor des Beitrags.

  • Der Antwortbeitrag enthält ein comment action.

  • Der Antwortbeitrag enthält ein assignee.

JSON-Darstellung 
{
  "commentId": string,
  "postId": string
}
Felder
commentId

string

Die ID des CommentThread, zu dem der Beitrag gehört.

postId

string

Die ID der Antwort Post , die gelöscht wird.