Requests

Anfragen

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)
  }
  // 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 Eigenschaften von Dimensionen.

updateNamedRange

object (UpdateNamedRangeRequest)

Aktualisiert einen benannten Bereich.

repeatCell

object (RepeatCellRequest)

Wiederholt eine einzelne Zelle über einen Bereich hinweg.

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)

Es werden automatisch weitere Daten auf Basis vorhandener Daten eingetragen.

cutPaste

object (CutPasteRequest)

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

copyPaste

object (CopyPasteRequest)

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

mergeCells

object (MergeCellsRequest)

Führt Zellen zusammen.

unmergeCells

object (UnmergeCellsRequest)

Heben Sie den Zellenverbund auf.

updateBorders

object (UpdateBordersRequest)

Aktualisiert die Rahmen in einem Zellenbereich.

updateCells

object (UpdateCellsRequest)

Aktualisiert viele Zellen gleichzeitig.

addFilterView

object (AddFilterViewRequest)

Fügt eine Filteransicht hinzu.

appendCells

object (AppendCellsRequest)

Hängt Zellen an, die nach der letzten Zeile mit Daten in einem Tabellenblatt enthalten sind.

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 in einem Tabellenblatt eingebettetes Objekt (z. B. ein Diagramm oder Bild).

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)

Findet und ersetzt Vorkommen eines Texts 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 Position in einem Tabellenblatt.

updateEmbeddedObjectPosition

object (UpdateEmbeddedObjectPositionRequest)

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

pasteData

object (PasteDataRequest)

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

textToColumns

object (TextToColumnsRequest)

Konvertiert eine Textspalte in viele Textspalten.

updateFilterView

object (UpdateFilterViewRequest)

Aktualisiert die Eigenschaften einer Filteransicht.

deleteRange

object (DeleteRangeRequest)

Löscht einen Zellenbereich aus einem Tabellenblatt, wobei die verbleibenden Zellen verschoben werden.

appendDimension

object (AppendDimensionRequest)

Hängt 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 einfachen 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 basierend auf dem 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 Bandbereich

addBanding

object (AddBandingRequest)

Fügt einen neuen Bandbereich hinzu

deleteBanding

object (DeleteBandingRequest)

Entfernt einen Bereich mit Streifen

createDeveloperMetadata

object (CreateDeveloperMetadataRequest)

Erstellt neue Entwicklermetadaten

updateDeveloperMetadata

object (UpdateDeveloperMetadataRequest)

Aktualisiert einen vorhandenen Entwicklermetadateneintrag

deleteDeveloperMetadata

object (DeleteDeveloperMetadataRequest)

Löscht Entwicklermetadaten

randomizeRange

object (RandomizeRangeRequest)

Geht die Reihenfolge der Zeilen in einem Bereich nach dem Zufallsprinzip an.

addDimensionGroup

object (AddDimensionGroupRequest)

Erstellt eine Gruppe innerhalb des angegebenen Bereichs.

deleteDimensionGroup

object (DeleteDimensionGroupRequest)

Löscht eine Gruppe im angegebenen Bereich.

updateDimensionGroup

object (UpdateDimensionGroupRequest)

Aktualisiert den Status der angegebenen Gruppe.

trimWhitespace

object (TrimWhitespaceRequest)

Passt Leerzeichen aus Leerzeichen (z. B. Leerzeichen, Tabulatoren oder Zeilenumbrüche) an.

deleteDuplicates

object (DeleteDuplicatesRequest)

Entfernt Zeilen mit doppelten Werten in bestimmten Spalten eines Zellenbereichs.

updateEmbeddedObjectBorder

object (UpdateEmbeddedObjectBorderRequest)

Aktualisiert den Rahmen eines eingebetteten Objekts.

addSlicer

object (AddSlicerRequest)

Fügt einen Datenschnitt hinzu.

updateSlicerSpec

object (UpdateSlicerSpecRequest)

Aktualisiert die Spezifikationen eines Datenschnitts.

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 zugehörige Datenbankobjekte.

cancelDataSourceRefresh

object (CancelDataSourceRefreshRequest)

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

UpdateSpreadsheetPropertiesRequest

Aktualisiert die Eigenschaften 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. Die Stammeigenschaften sind impliziert und dürfen nicht angegeben werden. Eine einzelne "*" kann als Abkürzung für das Auflisten aller Felder verwendet werden.

UpdateSheetPropertiesRequest

Aktualisiert die Eigenschaften 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. Die Stamm-properties ist impliziert und sollte nicht angegeben werden. Eine einzelne "*" kann als Abkürzung für das Auflisten aller Felder verwendet werden.

UpdateDimensionPropertiesRequest

Aktualisiert Attribute von Dimensionen innerhalb des angegebenen Bereichs.

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. Die Stamm-properties ist impliziert und sollte nicht angegeben werden. Eine einzelne "*" kann als Abkürzung für das Auflisten 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 Zeilen oder Spalten, die aktualisiert werden sollen.

dataSourceSheetRange

object (DataSourceSheetDimensionRange)

Die Spalten in einem Datenquellenblatt, 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 Datenquellenblatts, in dem sich der Bereich befindet.

columnReferences[]

object (DataSourceColumnReference)

Die Spalten im Tabellenblatt „Datenquelle“.

UpdateNamedRangeRequest

Aktualisiert 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. Die Stamm-namedRange ist impliziert und sollte nicht angegeben werden. Eine einzelne "*" kann als Abkürzung für das Auflisten aller Felder verwendet werden.

RepeatCellRequest

Aktualisiert alle Zellen im Bereich auf die Werte im jeweiligen Cell-Objekt. Nur die im Feld fields aufgeführten Felder werden aktualisiert. Alle anderen Felder bleiben unverändert.

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

Wenn die Bereiche der Formel statisch bleiben sollen, verwenden Sie den Indikator $. Verwenden Sie beispielsweise die Formel =$A$1, um zu verhindern, dass sowohl die Zeile als auch die Spalte erhöht wird.

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

object (GridRange)

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. Die Stamm-cell ist impliziert und sollte nicht angegeben werden. Eine einzelne "*" kann als Abkürzung für das Auflisten 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 keines festgelegt ist, wird eine ID nach dem Zufallsprinzip generiert. (Die ID eines bereits vorhandenen Bereichs darf nicht angegeben werden.)

DeleteNamedRangeRequest

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

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

string

Die ID des benannten Bereichs, der gelöscht werden soll.

AddSheetRequest

Fügt ein neues Tabellenblatt hinzu. Wenn ein Tabellenblatt bei einem bestimmten Index hinzugefügt wird, werden die Indexe aller nachfolgenden Tabellenblätter erhöht. Wenn Sie eine Objekttabelle 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 keines festgelegt ist, wird eine ID nach dem Zufallsprinzip generiert. (Die ID eines bereits vorhandenen Tabellenblatts darf nicht angegeben werden.)

DeleteSheetRequest

Löscht das angeforderte Tabellenblatt.

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

integer

Die ID des Tabellenblatts, das gelöscht werden soll.

Wenn es sich um ein Tabellenblatt vom Typ DATA_SOURCE handelt, wird auch das zugehörige DataSource gelöscht.

AutoFillRequest

Je nach vorhandener Daten werden mehr 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 „alternativen“ Reihe generiert werden sollen. Das unterscheidet sich je nach Typ und Menge der Quelldaten.

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

object (GridRange)

Bereich, der automatisch ausgefüllt werden soll. Dadurch wird der Bereich untersucht und der Standort, für den Daten vorliegen, erkannt. Die Daten werden automatisch für den Rest des Bereichs eingetragen.

sourceAndDestination

object (SourceAndDestination)

Die Quell- und Zielgebiete, die automatisch ausgefüllt werden sollen. Dadurch wird explizit die Quelle der Autofill-Funktion und die Bereiche aufgeführt, in denen diese Daten erweitert werden sollen.

SourceAndDestination

Eine Kombination aus einem Quellbereich und der Erweiterung der Quelle.

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

object (GridRange)

Der Speicherort der Daten, die als Quelle der AutoFill-Funktion verwendet werden sollen.

dimension

enum (Dimension)

Die Dimension, in die die Daten eingetragen werden sollen.

fillLength

integer

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

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)

Koordinate oben links, in die die Daten eingefügt werden sollen

pasteType

enum (PasteType)

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

PasteType

Welche Art von Daten eingefügt werden sollen

Enums
PASTE_NORMAL Werte, Formeln, Formate und Zusammenführungen einfügen.
PASTE_VALUES Fügen Sie die Werte NUR ohne Formate, Formeln oder Zusammenführungen ein.
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 aus der Quelle in das Ziel.

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

object (GridRange)

Der Quellbereich, der kopiert werden soll.

destination

object (GridRange)

Ort zum Einfügen. Wenn der Bereich eine Spanne umfasst, die 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 die gesamten Quelldaten kopiert (über das Ende des Zielbereichs hinaus).

pasteType

enum (PasteType)

Welche Art von Daten eingefügt werden sollen.

pasteOrientation

enum (PasteOrientation)

Wie diese Daten beim Einfügen ausgerichtet werden sollen.

PasteOrientation

Wie ein Einfügevorgang ausgeführt werden soll.

Enums
NORMAL Fügen Sie sie normal ein.
TRANSPOSE Transponiert einfügen, wobei alle Zeilen zu Spalten werden und umgekehrt.

MergeCellsRequest

Führt alle Zellen im Bereich zusammen.

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

object (GridRange)

Zellenbereich, der verbunden werden soll

mergeType

enum (MergeType)

Gibt an, wie Zellen verbunden werden sollen.

MergeType

Die Art der zu erstellenden Zusammenführung.

Enums
MERGE_ALL Einzelnen Zellenverbund aus dem Bereich erstellen
MERGE_COLUMNS Zusammenführung für jede Spalte im Bereich erstellen
MERGE_ROWS Zusammenführung für jede Zeile im Bereich erstellen

UnmergeCellsRequest

Hebt die Verbindung von Zellen 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, wird die Verbindung aufgehoben. Der Bereich darf sich nicht teilweise über eine Zusammenführung erstrecken.

UpdateBordersRequest

Aktualisiert die Grenzen eines Bereichs. Wenn in der Anfrage kein Feld festgelegt ist, bleibt der Rahmen unverändert, beispielsweise bei zwei nachfolgenden UpdateBordersRequests:

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

Das würde dazu führen, dass A1:A5 einen Rahmen von { top: RED, bottom: WHITE, left: BLUE } hätte. 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)

Bereich, dessen Rahmen aktualisiert werden sollen

top

object (Border)

Der Rahmen, der oben im Bereich platziert werden soll.

bottom

object (Border)

Rahmen, der am unteren Ende des Bereichs platziert werden soll.

left

object (Border)

Der Rand, der links neben dem Bereich platziert werden soll.

right

object (Border)

Der Rahmen, der rechts neben dem Bereich platziert werden soll.

innerHorizontal

object (Border)

Der horizontale Rahmen, der innerhalb des Bereichs platziert werden soll.

innerVertical

object (Border)

Der vertikale Rahmen, der innerhalb des Bereichs platziert 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 die CellData. „row.values.“ sollte nicht angegeben werden. Eine einzelne "*" kann als Abkürzung für das Auflisten 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)

Koordinate, an der mit dem Schreiben von Daten begonnen werden soll. Es kann eine beliebige Anzahl von Zeilen und Spalten geschrieben werden (einschließlich einer unterschiedlichen Anzahl von Spalten pro Zeile).

range

object (GridRange)

Bereich, in den Daten geschrieben werden sollen.

Wenn die Daten in den Zeilen nicht den gesamten angeforderten Bereich abdecken, werden die Felder gelöscht, die den in fields festgelegten Werten entsprechen.

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 keines festgelegt ist, wird eine ID nach dem Zufallsprinzip generiert. (Die ID eines bereits vorhandenen Filters kann nicht angegeben werden.)

AppendCellsRequest

Fügt nach der letzten Zeile mit Daten in einem Tabellenblatt neue Zellen hinzu. Falls erforderlich, werden in das Tabellenblatt neue Zeilen eingefügt.

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

integer

Tabellen-ID, an die die Daten angehängt werden sollen

rows[]

object (RowData)

Die Daten, die angefügt werden sollen.

fields

string (FieldMask format)

Die Felder von CellData, die aktualisiert werden sollen. Es muss mindestens ein Feld angegeben werden. Der Stamm ist die CellData. „row.values.“ sollte nicht angegeben werden. Eine einzelne "*" kann als Abkürzung für das Auflisten aller Felder verwendet werden.

ClearBasicFilterRequest

Löscht den einfachen Filter, falls vorhanden.

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

integer

Die Tabellen-ID, auf der der Basisfilter gelöscht werden soll.

DeleteDimensionRequest

Löscht die Abmessungen aus dem Tabellenblatt.

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

object (DimensionRange)

Die Abmessungen, 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 eingebetteten 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 zu duplizierenden Filters.

DuplicateSheetRequest

Dupliziert den Inhalt eines Tabellenblatts.

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

integer

Das Tabellenblatt, das dupliziert werden soll.

Wenn die Quelltabelle den Typ DATA_SOURCE hat, wird auch die unterstützende DataSource dupliziert und mit der neuen Kopie des Tabellenblatts verknüpft. Es wird keine Datenausführung ausgelöst. Die Rasterdaten dieses Tabellenblatts werden ebenfalls kopiert, sind aber erst verfügbar, nachdem die Batchanfrage abgeschlossen wurde.

insertSheetIndex

integer

Der nullbasierte Index, in den das neue Tabellenblatt eingefügt werden soll. Der Index aller Tabellenblätter wird danach erhöht.

newSheetId

integer

Falls festgelegt, die ID des neuen Tabellenblatts. Wenn nichts festgelegt ist, wird eine ID ausgewählt. Falls festgelegt, darf die ID nicht mit vorhandenen Tabellen-IDs in Konflikt stehen. Wenn festgelegt, darf sie 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

Findet und ersetzt Daten in Zellen in einem Bereich, einem Tabellenblatt oder in 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

Wert, der gesucht werden soll.

replacement

string

Der Wert, der als Ersatz verwendet werden soll.

matchCase

boolean

„True“, wenn bei der Suche zwischen Groß- und Kleinschreibung unterschieden wird.

matchEntireCell

boolean

Dieser Wert ist „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 die Ersetzung 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 "Google Docs" hat, würde die Suche nach "o.* (.*)" mit dem Ersetzen von "$1 Rocks" den Inhalt der Zellen in "GSheets Rocks" bzw. "GDocs Rocks" ändern.

includeFormulas

boolean

Dieser Wert ist „True“, wenn die Suche Zellen mit Formeln enthalten soll. Falsch, um Zellen mit Formeln zu überspringen.

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

object (GridRange)

Bereich, in dem gesucht oder ersetzt werden soll

sheetId

integer

Das Tabellenblatt, in dem gesucht werden soll.

allSheets

boolean

„True“, um in allen Tabellenblättern zu suchen/zu ersetzen.

InsertDimensionRequest

Fügt Zeilen oder Spalten in ein Tabellenblatt bei 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 aus den Dimensionen vor oder nach den neu eingefügten Dimensionen erweitert werden sollen. „True“ für die Übernahme aus den vorherigen Dimensionen (in diesem Fall muss der Startindex größer als 0 sein) und „false“ für die Übernahme von den Dimensionen danach.

Wenn beispielsweise Zeilenindex 0 einen roten Hintergrund und Zeilenindex 1 einen grünen Hintergrund hat, kann beim Einfügen von 2 Zeilen bei 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. Ist inheritFromBefore auf „false“ gesetzt, 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, wobei die vorhandenen Zellen nach oben oder unten verschoben werden.

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

object (GridRange)

Bereich, in den neue Zellen eingefügt werden sollen

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 dafür, wohin die Quelldaten verschoben werden sollen, basierend auf den Koordinaten, bevor die Quelldaten aus dem Raster entfernt werden. Je nach Dimension werden vorhandene Daten nach unten oder rechts verschoben, um Platz für die verschobenen Dimensionen zu schaffen. Die Quelldimensionen werden aus dem Raster entfernt, sodass die Daten möglicherweise in einem anderen Index als angegeben angezeigt werden.

Beispiel: Bei einem A1..A5 von 0, 1, 2, 3, 4 und wenn "1" und "2" zwischen "3" und "4" verschoben werden sollen, wäre 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. Verschieben oder Ändern der Größe eines Diagramms oder Bildes)

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

integer

Die ID des zu verschiebenden Objekts.

newPosition

object (EmbeddedObjectPosition)

Eine explizite Position, in die das eingebettete Objekt verschoben werden soll. Wird newPosition.sheetId festgelegt, wird ein neues Tabellenblatt mit dieser ID erstellt. Ist newPosition.newSheet auf „true“ gesetzt, wird eine neue Tabelle 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. Die Stamm-newPosition.overlayPosition ist impliziert und sollte nicht angegeben werden. Eine einzelne "*" kann als Abkürzung für das Auflisten aller Felder verwendet werden.

PasteDataRequest

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

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 das Einfügen der Daten beginnen soll.

data

string

Die einzufügenden Daten.

type

enum (PasteType)

Gibt an, wie die Daten eingefügt werden sollen.

Union-Feld kind. Wie die Daten interpretiert werden, 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 basierend auf einem Trennzeichen in den einzelnen Zellen 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 auf CUSTOM gesetzt ist.

delimiterType

enum (DelimiterType)

Der zu verwendende Trennzeichentyp.

DelimiterType

Das Trennzeichen, nach dem 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. Die Stamm-filter ist impliziert und sollte nicht angegeben werden. Eine einzelne "*" kann als Abkürzung für das Auflisten aller Felder verwendet werden.

DeleteRangeRequest

Löscht einen Zellenbereich, sodass andere Zellen in den gelöschten Bereich verschoben werden.

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

object (GridRange)

Zellenbereich, der gelöscht werden soll

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. Bei 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, an das 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 Zeilen oder Spalten, die angefügt werden sollen.

AddConditionalFormatRuleRequest

Fügt eine neue Regel für die bedingte Formatierung beim angegebenen Index 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, in den die Regel eingefügt werden soll.

UpdateConditionalFormatRuleRequest

Aktualisiert eine Regel für die bedingte Formatierung am angegebenen Index oder verschiebt eine Regel zur bedingten Formatierung in 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 mit der Regel, die verschoben werden soll. Erforderlich, wenn newIndex festgelegt ist. Andernfalls wird er nicht verwendet.

Union-Feld instruction. Die Art des Updates, das stattfinden soll. Für instruction ist nur einer der folgenden Werte zulässig:
rule

object (ConditionalFormatRule)

Regel, die die Regel beim angegebenen Index ersetzen soll.

newIndex

integer

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

DeleteConditionalFormatRuleRequest

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

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

integer

Der nullbasierte Index der Regel, die gelöscht werden soll.

sheetId

integer

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

SortRangeRequest

Sortiert Daten in Zeilen anhand einer Sortierreihenfolge pro Spalte.

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

object (GridRange)

Bereich, der sortiert werden soll

sortSpecs[]

object (SortSpec)

Die Sortierreihenfolge pro Spalte. Spätere Spezifikationen werden verwendet, wenn die Werte in den vorherigen Spezifikationen identisch sind.

SetDataValidationRequest

Legt eine Datenvalidierungsregel für jede Zelle im Bereich fest. Wenn Sie die Validierung in einem bestimmten Bereich löschen möchten, rufen Sie dies auf, ohne dass eine Regel angegeben ist.

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

object (GridRange)

Der Bereich, für den die Datenvalidierungsregel gelten soll.

rule

object (DataValidationRule)

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

SetBasicFilterRequest

Legt den einfachen Filter für ein Tabellenblatt 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 keines festgelegt ist, wird eine ID nach dem Zufallsprinzip generiert. (Die ID eines bereits vorhandenen Bereichs darf nicht angegeben werden.)

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. Die Stamm-protectedRange ist impliziert und sollte nicht angegeben werden. Eine einzelne "*" kann als Abkürzung für das Auflisten 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 basierend auf dem 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 Abmessungen, deren Größe automatisch angepasst werden soll.

dataSourceSheetDimensions

object (DataSourceSheetDimensionRange)

Die Größe eines Datenquellenblatts wird automatisch angepasst.

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 keines festgelegt ist, wird eine ID nach dem Zufallsprinzip generiert. (Die ID eines eingebetteten Objekts, das bereits vorhanden ist, darf nicht angegeben werden.)

UpdateChartSpecRequest

Aktualisiert die Spezifikationen eines Diagramms. (Dadurch wird kein Diagramm verschoben oder in seiner Größe verändert. Wenn Sie ein Diagramm verschieben oder seine Größe ändern 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 Spezifikation, die auf das Diagramm angewendet werden soll.

UpdateBandingRequest

Aktualisiert die Eigenschaften des angegebenen Bandbereichs.

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

object (BandedRange)

Der Bereich mit Band, 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. Die Stamm-bandedRange ist impliziert und sollte nicht angegeben werden. Eine einzelne "*" kann als Abkürzung für das Auflisten aller Felder verwendet werden.

AddBandingRequest

Fügt der Tabelle einen neuen Band-Bereich hinzu.

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

object (BandedRange)

Der hinzuzufügende Band. Das Feld bandedRangeId ist optional. Wenn keines festgelegt ist, wird eine ID nach dem Zufallsprinzip generiert. (Die ID eines bereits vorhandenen Bereichs darf nicht angegeben werden.)

DeleteBandingRequest

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

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

integer

Die ID des zu löschenden Bandbereichs.

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 der Attribute von Entwicklermetadaten. Aktualisiert die Attribute der von den Filtern ausgewählten Entwicklermetadaten auf die Werte, die in der Ressource DeveloperMetadata bereitgestellt werden. Aufrufer müssen im Parameter „fields“ die zu aktualisierenden Attribute sowie mindestens eine DataFilter angeben, die mit den zu aktualisierenden Metadaten übereinstimmt.

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

object (DataFilter)

Die Filter, die den zu aktualisierenden Entwicklermetadateneinträgen entsprechen.

developerMetadata

object (DeveloperMetadata)

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

fields

string (FieldMask format)

Die Felder, die aktualisiert werden sollen. Es muss mindestens ein Feld angegeben werden. Die Stamm-developerMetadata ist impliziert und sollte nicht angegeben werden. Eine einzelne "*" kann als Abkürzung für das Auflisten aller Felder verwendet werden.

DeleteDeveloperMetadataRequest

Ein Antrag zum Löschen von Entwicklermetadaten.

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

object (DataFilter)

Der Datenfilter, der die Kriterien beschreibt, nach denen ausgewählt wird, welcher Entwickler-Metadateneintrag gelöscht wird.

RandomizeRangeRequest

Geht die Reihenfolge der Zeilen in einem Bereich nach dem Zufallsprinzip an.

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

object (GridRange)

Bereich, der randomisiert werden soll.

AddDimensionGroupRequest

Erstellt eine Gruppe innerhalb des angegebenen Bereichs.

Wenn der angeforderte Bereich eine Obermenge des Bereichs einer vorhandenen Gruppe G ist, erhöht sich die Tiefe von G und diese neue Gruppe G' hat die Tiefe dieser Gruppe. Eine Gruppe [C:D, Tiefe 1] + [B:E] führt beispielsweise 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, wird die Tiefe der neuen Gruppe G' um eins größer als die Tiefe von G. Eine Gruppe [B:E, Tiefe 1] + [C:D] führt beispielsweise zu den Gruppen [B:E, Tiefe 1] und [C:D, Tiefe 2]. Wenn der angeforderte Bereich vor dem Bereich einer vorhandenen Gruppe G beginnt oder danach beginnt und danach endet, wird der Bereich der vorhandenen Gruppe G zur Gesamtheit der Bereiche. Die neue Gruppe G' hat eine Tiefe von eins, die größer als die Tiefe von G ist, und der Bereich als Schnittpunkt der Bereiche. Zum Beispiel führt eine Gruppe [B:D, Tiefe 1] + [C:E] zu den Gruppen [B:E, Tiefe 1] und [C:D, Tiefe 2].

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

object (DimensionRange)

Bereich, in dem eine Gruppe erstellt werden soll.

DeleteDimensionGroupRequest

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

Angenommen, das Blatt hat eine Tiefe-1-Gruppe über B:E und eine Tiefe-2-Gruppe über C:D. Wenn Sie eine Gruppe über D:E löschen, bleibt das Tabellenblatt mit einer Gruppe für Tiefe 1 über B:D und einer Gruppe für 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 werden aktualisiert.

fields

string (FieldMask format)

Die Felder, die aktualisiert werden sollen. Es muss mindestens ein Feld angegeben werden. Die Stamm-dimensionGroup ist impliziert und sollte nicht angegeben werden. Eine einzelne "*" kann als Abkürzung für das Auflisten aller Felder verwendet werden.

TrimWhitespaceRequest

Passt Leerzeichen (z. B. Leerzeichen, Tabulatoren oder Zeilenumbrüche) in jeder Zelle im angegebenen Bereich an. Mit dieser Anfrage werden alle Leerzeichen am Anfang und Ende des Texts jeder Zelle entfernt und alle Untersequenzen verbleibenden Leerzeichen auf ein einzelnes Leerzeichen reduziert. Wenn der resultierende, geschnittene 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)

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, aber mit unterschiedlicher Groß- und Kleinschreibung, Formatierung oder Formeln werden als Duplikate betrachtet.

Bei dieser Anfrage werden auch doppelte Zeilen entfernt, die aus der Ansicht ausgeblendet wurden (z. B. aufgrund eines Filters). Beim Entfernen von Duplikaten wird das erste Vorkommen jedes doppelten Zeilenscans von oben nach unten im resultierenden Bereich gehalten. Inhalte außerhalb des angegebenen Bereichs werden nicht entfernt und Zeilen, die als Duplikate betrachtet werden, müssen im Bereich nicht nebeneinander liegen.

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

object (GridRange)

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 die Eigenschaft Rahmen eines eingebetteten Objekts.

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

integer

Die ID des eingebetteten Objekts, das aktualisiert werden soll.

border

object (EmbeddedObjectBorder)

Der Rahmen für das eingebettete Objekt.

fields

string (FieldMask format)

Die Felder, die aktualisiert werden sollen. Es muss mindestens ein Feld angegeben werden. Die Stamm-border ist impliziert und sollte nicht angegeben werden. Eine einzelne "*" kann als Abkürzung für das Auflisten aller Felder verwendet werden.

AddSlicerRequest

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

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

object (Slicer)

Der Datenschnitt, der der Tabelle hinzugefügt werden soll, einschließlich seiner Position. Das Feld slicerId ist optional. Wenn keines festgelegt ist, wird eine ID nach dem Zufallsprinzip generiert. (Die ID eines bereits vorhandenen Datenschnitts darf nicht angegeben werden.)

UpdateSlicerSpecRequest

Aktualisiert die Spezifikationen eines Datenschnitts. Dadurch wird ein Datenschnitt weder verschoben noch seine Größe verändert. Wenn Sie einen Datenschnitt verschieben oder seine Größe ändern möchten, verwenden Sie UpdateEmbeddedObjectPositionRequest.

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

integer

Die ID des zu aktualisierenden Datenschnitts.

spec

object (SlicerSpec)

Die Spezifikation, die auf den Datenschnitt angewendet werden soll.

fields

string (FieldMask format)

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

AddDataSourceRequest

Fügt eine Datenquelle hinzu. Nachdem die Datenquelle hinzugefügt wurde, wird ein verknüpftes Tabellenblatt DATA_SOURCE erstellt und eine Ausführung ausgelöst, um das Tabellenblatt zu aktualisieren, um Daten aus der Datenquelle zu lesen. Die Anfrage erfordert einen zusätzlichen bigquery.readonly-OAuth-Bereich.

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

object (DataSource)

Die Datenquelle, die hinzugefügt werden soll.

UpdateDataSourceRequest

Aktualisiert eine Datenquelle. Nachdem die Datenquelle aktualisiert wurde, wird eine Ausführung ausgelöst, um das zugehörige Tabellenblatt DATA_SOURCE zu aktualisieren, um Daten aus der aktualisierten Datenquelle zu lesen. Die Anfrage erfordert einen zusätzlichen bigquery.readonly-OAuth-Bereich.

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

object (DataSource)

Die Datenquelle, die aktualisiert werden soll.

fields

string (FieldMask format)

Die Felder, die aktualisiert werden sollen. Es muss mindestens ein Feld angegeben werden. Die Stamm-dataSource ist impliziert und sollte nicht angegeben werden. Eine einzelne "*" kann als Abkürzung für das Auflisten aller Felder verwendet werden.

DeleteDataSourceRequest

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

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

string

ID der zu löschenden Datenquelle.

RefreshDataSourceRequest

Aktualisiert ein oder mehrere Datenquellenobjekte in der Tabelle anhand der angegebenen Verweise. Die Anfrage erfordert einen zusätzlichen bigquery.readonly-OAuth-Bereich.

Wenn in einem Batch mehrere Aktualisierungsanfragen auf dieselben Datenquellenobjekte verweisen, wird nur die letzte Aktualisierungsanfrage verarbeitet. Alle Anfragen erhalten dann 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

Die Datenquellenobjekte werden unabhängig vom aktuellen Status aktualisiert. Wenn die Richtlinie nicht konfiguriert ist und ein referenziertes Datenquellenobjekt einen Fehler hatte, 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 DataSource. Wenn dieses Flag angegeben ist, werden alle verknüpften Datenquellenobjekte für die Datenquelle aktualisiert.

isAll

boolean

Aktualisiert alle vorhandenen Datenquellenobjekte in der Tabelle.

DataSourceObjectReferences

Eine Liste mit Referenzen auf Datenquellenobjekte.

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

object (DataSourceObjectReference)

Die Verweise.

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 Datenquellendiagramm

dataSourceTableAnchorCell

object (GridCoordinate)

Verweise auf ein DataSourceTable, das in der Zelle verankert ist.

dataSourcePivotTableAnchorCell

object (GridCoordinate)

Verweise auf eine Datenquelle PivotTable, die in der Zelle verankert ist.

dataSourceFormulaCell

object (GridCoordinate)

Verweist auf eine Zelle, die DataSourceFormula enthält.

CancelDataSourceRefreshRequest

Bricht eine oder mehrere Aktualisierungen der Datenquellenobjekte in der Tabelle durch die angegebenen Verweise ab.

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 abgebrochen 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 DataSource. Wenn dieses Flag angegeben ist, werden alle Aktualisierungen der zugehörigen Datenquellenobjekte für diese Datenquelle abgebrochen.

isAll

boolean

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