Requests

リクエスト

スプレッドシートに適用する更新の単一の種類。

JSON 表現
{

  // Union field kind can be only one of the following:
  "updateSpreadsheetProperties": {
    object (UpdateSpreadsheetPropertiesRequest)
  },
  "updateSheetProperties": {
    object (UpdateSheetPropertiesRequest)
  },
  "updateDimensionProperties": {
    object (UpdateDimensionPropertiesRequest)
  },
  "updateNamedRange": {
    object (UpdateNamedRangeRequest)
  },
  "repeatCell": {
    object (RepeatCellRequest)
  },
  "addNamedRange": {
    object (AddNamedRangeRequest)
  },
  "deleteNamedRange": {
    object (DeleteNamedRangeRequest)
  },
  "addSheet": {
    object (AddSheetRequest)
  },
  "deleteSheet": {
    object (DeleteSheetRequest)
  },
  "autoFill": {
    object (AutoFillRequest)
  },
  "cutPaste": {
    object (CutPasteRequest)
  },
  "copyPaste": {
    object (CopyPasteRequest)
  },
  "mergeCells": {
    object (MergeCellsRequest)
  },
  "unmergeCells": {
    object (UnmergeCellsRequest)
  },
  "updateBorders": {
    object (UpdateBordersRequest)
  },
  "updateCells": {
    object (UpdateCellsRequest)
  },
  "addFilterView": {
    object (AddFilterViewRequest)
  },
  "appendCells": {
    object (AppendCellsRequest)
  },
  "clearBasicFilter": {
    object (ClearBasicFilterRequest)
  },
  "deleteDimension": {
    object (DeleteDimensionRequest)
  },
  "deleteEmbeddedObject": {
    object (DeleteEmbeddedObjectRequest)
  },
  "deleteFilterView": {
    object (DeleteFilterViewRequest)
  },
  "duplicateFilterView": {
    object (DuplicateFilterViewRequest)
  },
  "duplicateSheet": {
    object (DuplicateSheetRequest)
  },
  "findReplace": {
    object (FindReplaceRequest)
  },
  "insertDimension": {
    object (InsertDimensionRequest)
  },
  "insertRange": {
    object (InsertRangeRequest)
  },
  "moveDimension": {
    object (MoveDimensionRequest)
  },
  "updateEmbeddedObjectPosition": {
    object (UpdateEmbeddedObjectPositionRequest)
  },
  "pasteData": {
    object (PasteDataRequest)
  },
  "textToColumns": {
    object (TextToColumnsRequest)
  },
  "updateFilterView": {
    object (UpdateFilterViewRequest)
  },
  "deleteRange": {
    object (DeleteRangeRequest)
  },
  "appendDimension": {
    object (AppendDimensionRequest)
  },
  "addConditionalFormatRule": {
    object (AddConditionalFormatRuleRequest)
  },
  "updateConditionalFormatRule": {
    object (UpdateConditionalFormatRuleRequest)
  },
  "deleteConditionalFormatRule": {
    object (DeleteConditionalFormatRuleRequest)
  },
  "sortRange": {
    object (SortRangeRequest)
  },
  "setDataValidation": {
    object (SetDataValidationRequest)
  },
  "setBasicFilter": {
    object (SetBasicFilterRequest)
  },
  "addProtectedRange": {
    object (AddProtectedRangeRequest)
  },
  "updateProtectedRange": {
    object (UpdateProtectedRangeRequest)
  },
  "deleteProtectedRange": {
    object (DeleteProtectedRangeRequest)
  },
  "autoResizeDimensions": {
    object (AutoResizeDimensionsRequest)
  },
  "addChart": {
    object (AddChartRequest)
  },
  "updateChartSpec": {
    object (UpdateChartSpecRequest)
  },
  "updateBanding": {
    object (UpdateBandingRequest)
  },
  "addBanding": {
    object (AddBandingRequest)
  },
  "deleteBanding": {
    object (DeleteBandingRequest)
  },
  "createDeveloperMetadata": {
    object (CreateDeveloperMetadataRequest)
  },
  "updateDeveloperMetadata": {
    object (UpdateDeveloperMetadataRequest)
  },
  "deleteDeveloperMetadata": {
    object (DeleteDeveloperMetadataRequest)
  },
  "randomizeRange": {
    object (RandomizeRangeRequest)
  },
  "addDimensionGroup": {
    object (AddDimensionGroupRequest)
  },
  "deleteDimensionGroup": {
    object (DeleteDimensionGroupRequest)
  },
  "updateDimensionGroup": {
    object (UpdateDimensionGroupRequest)
  },
  "trimWhitespace": {
    object (TrimWhitespaceRequest)
  },
  "deleteDuplicates": {
    object (DeleteDuplicatesRequest)
  },
  "updateEmbeddedObjectBorder": {
    object (UpdateEmbeddedObjectBorderRequest)
  },
  "addSlicer": {
    object (AddSlicerRequest)
  },
  "updateSlicerSpec": {
    object (UpdateSlicerSpecRequest)
  },
  "addDataSource": {
    object (AddDataSourceRequest)
  },
  "updateDataSource": {
    object (UpdateDataSourceRequest)
  },
  "deleteDataSource": {
    object (DeleteDataSourceRequest)
  },
  "refreshDataSource": {
    object (RefreshDataSourceRequest)
  },
  "cancelDataSourceRefresh": {
    object (CancelDataSourceRefreshRequest)
  },
  "addTable": {
    object (AddTableRequest)
  },
  "updateTable": {
    object (UpdateTableRequest)
  },
  "deleteTable": {
    object (DeleteTableRequest)
  }
  // End of list of possible types for union field kind.
}
フィールド
共用体フィールド kind。更新の種類。フィールドは 1 つだけ必要です。kind は次のいずれかになります。
updateSpreadsheetProperties

object (UpdateSpreadsheetPropertiesRequest)

スプレッドシートのプロパティを更新します。

updateSheetProperties

object (UpdateSheetPropertiesRequest)

シートのプロパティを更新します。

updateDimensionProperties

object (UpdateDimensionPropertiesRequest)

ディメンションのプロパティを更新します。

updateNamedRange

object (UpdateNamedRangeRequest)

名前付き範囲を更新します。

repeatCell

object (RepeatCellRequest)

範囲全体に 1 つのセルを繰り返します。

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)

データを(HTML または区切り文字付き)シートに貼り付けます。

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)

1 つ以上のセルのデータ入力規則を設定します。

setBasicFilter

object (SetBasicFilterRequest)

シートの基本フィルタを設定します。

addProtectedRange

object (AddProtectedRangeRequest)

保護されている範囲を追加します。

updateProtectedRange

object (UpdateProtectedRangeRequest)

保護されている範囲を更新します。

deleteProtectedRange

object (DeleteProtectedRangeRequest)

保護されている範囲を削除します。

autoResizeDimensions

object (AutoResizeDimensionsRequest)

1 つ以上のディメンションのサイズを、そのディメンションのセルの内容に基づいて自動的に変更します。

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)

1 つ以上のデータソースと関連する dbobject を更新します。

cancelDataSourceRefresh

object (CancelDataSourceRefreshRequest)

1 つ以上のデータソースと関連する dbobject の更新をキャンセルします。

addTable

object (AddTableRequest)

テーブルを追加します。

updateTable

object (UpdateTableRequest)

テーブルを更新します。

deleteTable

object (DeleteTableRequest)

テーブルの削除リクエスト。

UpdateSpreadsheetPropertiesRequest

スプレッドシートのプロパティを更新します。

JSON 表現
{
  "properties": {
    object (SpreadsheetProperties)
  },
  "fields": string
}
フィールド
properties

object (SpreadsheetProperties)

更新するプロパティ。

fields

string (FieldMask format)

更新するフィールド。少なくとも 1 つのフィールドを指定する必要があります。ルートの「properties」は暗黙的に指定されるため、指定しないでください。1 つの "*" は、すべてのフィールドをリストする省略形として使用できます。

UpdateSheetPropertiesRequest

指定された sheetId を使用してシートのプロパティを更新します。

JSON 表現
{
  "properties": {
    object (SheetProperties)
  },
  "fields": string
}
フィールド
properties

object (SheetProperties)

更新するプロパティ。

fields

string (FieldMask format)

更新するフィールド。少なくとも 1 つのフィールドを指定する必要があります。ルート properties は暗黙的に指定されるため、指定しないでください。1 つの "*" は、すべてのフィールドをリストする省略形として使用できます。

UpdateDimensionPropertiesRequest

指定された範囲内のディメンションのプロパティを更新します。

JSON 表現
{
  "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.
}
フィールド
properties

object (DimensionProperties)

更新するプロパティ。

fields

string (FieldMask format)

更新するフィールド。少なくとも 1 つのフィールドを指定する必要があります。ルート properties は暗黙的に指定されるため、指定しないでください。1 つの "*" は、すべてのフィールドをリストする省略形として使用できます。

共用体フィールド dimension_range。ディメンションの範囲。dimension_range は次のいずれかになります。
range

object (DimensionRange)

更新する行または列。

dataSourceSheetRange

object (DataSourceSheetDimensionRange)

更新するデータソース シートの列。

DataSourceSheetDimensionRange

DATA_SOURCE シートの単一のディメンションに沿った範囲。

JSON 表現
{
  "sheetId": integer,
  "columnReferences": [
    {
      object (DataSourceColumnReference)
    }
  ]
}
フィールド
sheetId

integer

範囲が設定されているデータソース シートの ID。

columnReferences[]

object (DataSourceColumnReference)

データソース シートの列。

UpdateNamedRangeRequest

指定された namedRangeId を使用して、名前付き範囲のプロパティを更新します。

JSON 表現
{
  "namedRange": {
    object (NamedRange)
  },
  "fields": string
}
フィールド
namedRange

object (NamedRange)

新しいプロパティで更新する名前付き範囲。

fields

string (FieldMask format)

更新するフィールド。少なくとも 1 つのフィールドを指定する必要があります。ルート namedRange は暗黙的に指定されるため、指定しないでください。1 つの "*" は、すべてのフィールドをリストする省略形として使用できます。

RepeatCellRequest

範囲内のすべてのセルを、指定された Cell オブジェクトの値に更新します。fields フィールドにリストされているフィールドのみが更新され、他のフィールドは変更されません。

数式を含むセルを書き込む場合、数式の範囲は範囲内の各フィールドに対して自動的にインクリメントされます。たとえば、数式 =A1 を含むセルを範囲 B2:C4 に書き込む場合、B2 は =A1、B3 は =A2、B4 は =A3、C2 は =B1、C3 は =B2、C4 は =B3 になります。

数式の範囲を静的にするには、$ インジケーターを使用します。たとえば、=$A$1 という数式を使用すると、行と列の両方が増分されなくなります。

JSON 表現
{
  "range": {
    object (GridRange)
  },
  "cell": {
    object (CellData)
  },
  "fields": string
}
フィールド
range

object (GridRange)

セルを繰り返す範囲。

cell

object (CellData)

書き込むデータ。

fields

string (FieldMask format)

更新するフィールド。少なくとも 1 つのフィールドを指定する必要があります。ルート cell は暗黙的に指定されるため、指定しないでください。1 つの "*" は、すべてのフィールドをリストする省略形として使用できます。

AddNamedRangeRequest

スプレッドシートに名前付き範囲を追加します。

JSON 表現
{
  "namedRange": {
    object (NamedRange)
  }
}
フィールド
namedRange

object (NamedRange)

追加する名前付き範囲。namedRangeId フィールドは省略可能です。設定されていない場合、ID はランダムに生成されます。(すでに存在する範囲の ID を指定するとエラーになります)。

DeleteNamedRangeRequest

指定された ID の名前付き範囲をスプレッドシートから削除します。

JSON 表現
{
  "namedRangeId": string
}
フィールド
namedRangeId

string

削除する名前付き範囲の ID。

AddSheetRequest

新しいシートを追加します。シートが特定のインデックスに追加されると、それ以降のすべてのシートのインデックスが増加します。オブジェクト シートを追加するには、代わりに AddChartRequest を使用して、EmbeddedObjectPosition.sheetId または EmbeddedObjectPosition.newSheet を指定します。

JSON 表現
{
  "properties": {
    object (SheetProperties)
  }
}
フィールド
properties

object (SheetProperties)

新しいシートに設定するプロパティ。プロパティはすべて省略可能です。sheetId フィールドは省略可能です。設定されていない場合、ID はランダムに生成されます。(すでに存在するシートの ID を指定するとエラーになります)。

DeleteSheetRequest

リクエストされたシートを削除します。

JSON 表現
{
  "sheetId": integer
}
フィールド
sheetId

integer

削除するシートの ID。

シートが DATA_SOURCE 型の場合、関連付けられた DataSource も削除されます。

AutoFillRequest

既存のデータに基づいて、より多くのデータを入力します。

JSON 表現
{
  "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.
}
フィールド
useAlternateSeries

boolean

「alternate」シリーズでデータを生成する場合は true。これは、ソースデータの種類と量によって異なります。

共用体フィールド area。自動入力する領域。 area は次のいずれかになります。
range

object (GridRange)

自動入力する範囲。範囲が調べられ、データがある場所が検出され、そのデータが範囲の残りの部分に自動的に入力されます。

sourceAndDestination

object (SourceAndDestination)

自動入力する送信元と宛先のエリア。これにより、自動入力のソースと、そのデータを拡張する場所が明示的にリストされます。

SourceAndDestination

ソース範囲と、そのソースを拡張する方法の組み合わせ。

JSON 表現
{
  "source": {
    object (GridRange)
  },
  "dimension": enum (Dimension),
  "fillLength": integer
}
フィールド
source

object (GridRange)

自動入力のソースとして使用するデータの場所。

dimension

enum (Dimension)

データを入力するディメンション。

fillLength

integer

データを入力する行数または列数。正の数値は、ソースの最後の行または最後の列を超えて拡張されます。負の数は、ソースの最初の行または最初の列の前に展開されます。

CutPasteRequest

移行元から移行先にデータを移動します。

JSON 表現
{
  "source": {
    object (GridRange)
  },
  "destination": {
    object (GridCoordinate)
  },
  "pasteType": enum (PasteType)
}
フィールド
source

object (GridRange)

切り取るソースデータ。

destination

object (GridCoordinate)

データの貼り付け先の左上隅の座標。

pasteType

enum (PasteType)

貼り付けるデータの種類。貼り付けた内容に関係なく、ソースデータはすべて切り取られます。

PasteType

貼り付けるデータの種類。

列挙型
PASTE_NORMAL 値、数式、形式、結合を貼り付けます。
PASTE_VALUES 書式、数式、結合なしで値のみを貼り付けます。
PASTE_FORMAT 書式とデータの入力規則のみを貼り付けます。
PASTE_NO_BORDERS PASTE_NORMAL のように、ただし枠線なし。
PASTE_FORMULA 数式のみを貼り付けます。
PASTE_DATA_VALIDATION データの入力規則のみを貼り付けます。
PASTE_CONDITIONAL_FORMATTING 条件付き書式ルールのみを貼り付けます。

CopyPasteRequest

移行元から移行先にデータをコピーします。

JSON 表現
{
  "source": {
    object (GridRange)
  },
  "destination": {
    object (GridRange)
  },
  "pasteType": enum (PasteType),
  "pasteOrientation": enum (PasteOrientation)
}
フィールド
source

object (GridRange)

コピーするソース範囲。

destination

object (GridRange)

貼り付け先の場所。範囲がソースの高さまたは幅の倍数であるスパンをカバーしている場合、データは宛先範囲を埋めるために繰り返されます。範囲がソース範囲より小さい場合でも、ソースデータ全体がコピーされます(宛先範囲の末尾を超えてコピーされます)。

pasteType

enum (PasteType)

貼り付けるデータの種類。

pasteOrientation

enum (PasteOrientation)

貼り付け時にデータをどのように配置するか。

PasteOrientation

貼り付け操作の実行方法。

列挙型
NORMAL 通常どおり貼り付けます。
TRANSPOSE 行と列を入れ替えて貼り付けます。

MergeCellsRequest

範囲内のすべてのセルを結合します。

JSON 表現
{
  "range": {
    object (GridRange)
  },
  "mergeType": enum (MergeType)
}
フィールド
range

object (GridRange)

結合するセルの範囲。

mergeType

enum (MergeType)

セルの結合方法。

MergeType

作成するマージのタイプ。

列挙型
MERGE_ALL 範囲から単一のマージを作成します。
MERGE_COLUMNS 範囲内の各列のマージを作成します。
MERGE_ROWS 範囲内の各行に結合を作成します。

UnmergeCellsRequest

指定された範囲内のセルの結合を解除します。

JSON 表現
{
  "range": {
    object (GridRange)
  }
}
フィールド
range

object (GridRange)

すべてのセルを結合解除する範囲。範囲が複数の結合にまたがる場合は、すべて結合が解除されます。範囲は、結合の一部にまたがってはなりません。

UpdateBordersRequest

範囲の枠線を更新します。リクエストでフィールドが設定されていない場合、境界線はそのままになります。たとえば、2 つの連続する UpdateBordersRequest を使用すると、次のようになります。

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

その結果、A1:A5 の境界線は { top: RED, bottom: WHITE, left: BLUE } になります。枠線を消去する場合は、スタイルを明示的に NONE に設定します。

JSON 表現
{
  "range": {
    object (GridRange)
  },
  "top": {
    object (Border)
  },
  "bottom": {
    object (Border)
  },
  "left": {
    object (Border)
  },
  "right": {
    object (Border)
  },
  "innerHorizontal": {
    object (Border)
  },
  "innerVertical": {
    object (Border)
  }
}
フィールド
range

object (GridRange)

枠線を更新する範囲。

top

object (Border)

範囲の上部に配置する枠線。

bottom

object (Border)

範囲の下部に配置する枠線。

left

object (Border)

範囲の左側に配置する枠線。

right

object (Border)

範囲の右側に配置する枠線。

innerHorizontal

object (Border)

範囲内に配置する水平方向の境界線。

innerVertical

object (Border)

範囲内に配置する垂直境界線。

UpdateCellsRequest

範囲内のすべてのセルを新しいデータで更新します。

JSON 表現
{
  "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.
}
フィールド
rows[]

object (RowData)

書き込むデータ。

fields

string (FieldMask format)

更新する CellData のフィールド。少なくとも 1 つのフィールドを指定する必要があります。ルートは CellData です。'row.values.' は指定しないでください。1 つの "*" は、すべてのフィールドをリストする省略形として使用できます。

共用体フィールド area。位置情報が書き込まれます。値を 1 つだけ設定する必要があります。area は次のいずれかになります。
start

object (GridCoordinate)

データの書き込みを開始する座標。任意の数の行と列(行ごとに異なる数の列を含む)を書き込むことができます。

range

object (GridRange)

データを書き込む範囲。

行のデータがリクエストされた範囲全体をカバーしていない場合、fields で設定されたフィールドと一致するフィールドがクリアされます。

AddFilterViewRequest

フィルタ表示を追加します。

JSON 表現
{
  "filter": {
    object (FilterView)
  }
}
フィールド
filter

object (FilterView)

追加するフィルタ。filterViewId フィールドは省略可能です。設定されていない場合は、ID がランダムに生成されます。(すでに存在するフィルタの ID を指定するとエラーになります)。

AppendCellsRequest

シートのデータがある最後の行の後に新しいセルを追加します。必要に応じて、シートに新しい行を挿入します。

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

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

integer

データを追加するシートの ID。

rows[]

object (RowData)

追加するデータ。

fields

string (FieldMask format)

更新する CellData のフィールド。少なくとも 1 つのフィールドを指定する必要があります。ルートは CellData です。'row.values.' は指定しないでください。1 つの "*" は、すべてのフィールドをリストする省略形として使用できます。

共用体フィールド area。位置情報を書き込む必要があります。area は次のいずれかになります。
tableId

string

データを追加するテーブルの ID。データはテーブル本体にのみ追加されます。

このフィールドは sheetId フィールドよりも優先されます。

ClearBasicFilterRequest

シートに基本フィルタが存在する場合、そのフィルタをクリアします。

JSON 表現
{
  "sheetId": integer
}
フィールド
sheetId

integer

基本フィルタをクリアするシートの ID。

DeleteDimensionRequest

シートからディメンションを削除します。

JSON 表現
{
  "range": {
    object (DimensionRange)
  }
}
フィールド
range

object (DimensionRange)

シートから削除するディメンション。

DeleteEmbeddedObjectRequest

指定された ID の埋め込みオブジェクトを削除します。

JSON 表現
{
  "objectId": integer
}
フィールド
objectId

integer

削除する埋め込みオブジェクトの ID。

DeleteFilterViewRequest

特定のフィルタ ビューを削除します。

JSON 表現
{
  "filterId": integer
}
フィールド
filterId

integer

削除するフィルタの ID。

DuplicateFilterViewRequest

特定のフィルタ表示を複製します。

JSON 表現
{
  "filterId": integer
}
フィールド
filterId

integer

複製されるフィルタの ID。

DuplicateSheetRequest

シートの内容を複製します。

JSON 表現
{
  "sourceSheetId": integer,
  "insertSheetIndex": integer,
  "newSheetId": integer,
  "newSheetName": string
}
フィールド
sourceSheetId

integer

複製するシート。

ソースシートが DATA_SOURCE 型の場合、そのバッキング DataSource も複製され、シートの新しいコピーに関連付けられます。データ実行はトリガーされません。このシートのグリッドデータもコピーされますが、バッチ リクエストが完了した後にのみ使用できます。

insertSheetIndex

integer

新しいシートを挿入する 0 から始まるインデックス。これ以降のすべてのシートのインデックスが増加します。

newSheetId

integer

設定されている場合、新しいシートの ID。設定しない場合、ID が選択されます。設定する場合、ID は既存のシート ID と競合しないようにする必要があります。設定する場合は、負の値にすることはできません。

newSheetName

string

新しいシートの名前。空の場合、新しい名前が自動的に選択されます。

FindReplaceRequest

範囲、シート、またはすべてのシートのセル内のデータを検索して置き換えます。

JSON 表現
{
  "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.
}
フィールド
find

string

検索する値。

replacement

string

置換に使用する値。

matchCase

boolean

検索で大文字と小文字が区別される場合は true。

matchEntireCell

boolean

検索値がセル全体と一致する必要がある場合は true。

searchByRegex

boolean

検索値が正規表現の場合は true。正規表現と置換は、https://docs.oracle.com/javase/8/docs/api/java/util/regex/Pattern.html の Java 正規表現ルールに従う必要があります。置換文字列はキャプチャ グループを参照できます。たとえば、あるセルに "Google Sheets" が含まれ、別のセルに "Google Docs" が含まれている場合、"o.* (.*)" を検索して "$1 Rocks" に置き換えると、セルの内容はそれぞれ "GSheets Rocks""GDocs Rocks" に変更されます。

includeFormulas

boolean

検索に数式を含むセルを含める場合は true。数式を含むセルをスキップする場合は False。

共用体フィールド scope。検索と置換を行う範囲。1 つだけ設定する必要があります。scope は次のいずれかになります。
range

object (GridRange)

検索と置換を行う範囲。

sheetId

integer

検索と置換を行うシート。

allSheets

boolean

すべてのシートで検索/置換を行う場合は True。

InsertDimensionRequest

シートの特定のインデックスに行または列を挿入します。

JSON 表現
{
  "range": {
    object (DimensionRange)
  },
  "inheritFromBefore": boolean
}
フィールド
range

object (DimensionRange)

挿入するディメンション。開始インデックスと終了インデックスの両方が境界内にある必要があります。

inheritFromBefore

boolean

ディメンション プロパティを、新しく挿入されたディメンションの前後のディメンションのどちらから拡張するか。前のディメンションから継承する場合は true(この場合、開始インデックスは 0 より大きい必要があります)、後のディメンションから継承する場合は false。

たとえば、行インデックス 0 の背景が赤で、行インデックス 1 の背景が緑の場合、インデックス 1 に 2 行を挿入すると、緑または赤の背景が継承されます。inheritFromBefore が true の場合、2 つの新しい行は赤になります(挿入ポイントの前の行が赤だったため)。inheritFromBefore が false の場合、2 つの新しい行は緑になります(挿入ポイントの後の行が緑だったため)。

InsertRangeRequest

範囲にセルを挿入し、既存のセルを右または下に移動します。

JSON 表現
{
  "range": {
    object (GridRange)
  },
  "shiftDimension": enum (Dimension)
}
フィールド
range

object (GridRange)

新しいセルを挿入する範囲。範囲は現在のシートの境界内に制限されます。

shiftDimension

enum (Dimension)

セルを挿入するときにシフトされるディメンション。ROWS の場合、既存のセルは下に移動します。COLUMNS の場合、既存のセルは右に移動します。

MoveDimensionRequest

1 つ以上の行または列を移動します。

JSON 表現
{
  "source": {
    object (DimensionRange)
  },
  "destinationIndex": integer
}
フィールド
source

object (DimensionRange)

移動するソース ディメンション。

destinationIndex

integer

ソースデータを移動する先の 0 ベースの開始インデックス。ソースデータがグリッドから削除される前の座標に基づきます。既存のデータは、移動したディメンションのスペースを確保するために、下または右(ディメンションによって異なります)に移動します。ソース ディメンションはグリッドから削除されるため、データは指定されたインデックスとは異なるインデックスに格納される可能性があります。

たとえば、0, 1, 2, 3, 4A1..A5 があり、"1""2""3""4" の間に移動する場合、ソースは ROWS [1..3)、宛先インデックスは "4"(5 行目の 0 ベースのインデックス)になります。最終的な結果は、0, 3, 1, 2, 4A1..A5 になります。

UpdateEmbeddedObjectPositionRequest

埋め込みオブジェクトの位置を更新します(グラフや画像の移動やサイズ変更など)。

JSON 表現
{
  "objectId": integer,
  "newPosition": {
    object (EmbeddedObjectPosition)
  },
  "fields": string
}
フィールド
objectId

integer

移動するオブジェクトの ID。

newPosition

object (EmbeddedObjectPosition)

埋め込みオブジェクトの移動先の明示的な位置。newPosition.sheetId が設定されている場合は、その ID の新しいシートが作成されます。newPosition.newSheet が true に設定されている場合、自動的に選択された ID を持つ新しいシートが作成されます。

fields

string (FieldMask format)

新しい位置を設定するときに更新する必要がある OverlayPosition のフィールド。newPosition.overlayPosition が設定されている場合にのみ使用されます。この場合、少なくとも 1 つのフィールドを指定する必要があります。ルート newPosition.overlayPosition は暗黙的に指定されるため、指定しないでください。1 つの "*" は、すべてのフィールドをリストする省略形として使用できます。

PasteDataRequest

指定した座標から始まるスプレッドシートにデータを挿入します。

JSON 表現
{
  "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.
}
フィールド
coordinate

object (GridCoordinate)

データの挿入を開始する座標。

data

string

挿入するデータ。

type

enum (PasteType)

データの貼り付け方法。

共用体フィールド kind。データの解釈方法。1 つの値のみを設定する必要があります。kind は次のいずれかになります。
delimiter

string

データ内の区切り文字。

html

boolean

データが HTML の場合は true。

TextToColumnsRequest

各セルの区切り文字に基づいて、テキストの列を複数の列に分割します。

JSON 表現
{
  "source": {
    object (GridRange)
  },
  "delimiter": string,
  "delimiterType": enum (DelimiterType)
}
フィールド
source

object (GridRange)

ソースデータの範囲。これは 1 列にまたがる必要があります。

delimiter

string

使用する区切り文字。delimiterType が CUSTOM の場合にのみ使用されます。

delimiterType

enum (DelimiterType)

使用する区切り文字のタイプ。

DelimiterType

分割する区切り文字。

列挙型
DELIMITER_TYPE_UNSPECIFIED デフォルト値。この値は使用しないでください。
COMMA ","
SEMICOLON ";"
PERIOD "."
SPACE " "
CUSTOM 区切り文字で定義されたカスタム値。
AUTODETECT 列を自動的に検出します。

UpdateFilterViewRequest

フィルタ ビューのプロパティを更新します。

JSON 表現
{
  "filter": {
    object (FilterView)
  },
  "fields": string
}
フィールド
filter

object (FilterView)

フィルタ表示の新しいプロパティ。

fields

string (FieldMask format)

更新するフィールド。少なくとも 1 つのフィールドを指定する必要があります。ルート filter は暗黙的に指定されるため、指定しないでください。1 つの "*" は、すべてのフィールドをリストする省略形として使用できます。

DeleteRangeRequest

セルの範囲を削除し、他のセルを削除された領域に移動します。

JSON 表現
{
  "range": {
    object (GridRange)
  },
  "shiftDimension": enum (Dimension)
}
フィールド
range

object (GridRange)

削除するセルの範囲。

shiftDimension

enum (Dimension)

削除されたセルを置き換えるディメンション。ROWS の場合、既存のセルが上に移動して、削除されたセルが置き換えられます。COLUMNS の場合、既存のセルが左に移動して、削除されたセルが置き換えられます。

AppendDimensionRequest

シートの末尾に行または列を追加します。

JSON 表現
{
  "sheetId": integer,
  "dimension": enum (Dimension),
  "length": integer
}
フィールド
sheetId

integer

行または列を追加するシート。

dimension

enum (Dimension)

行または列を追加するかどうかを指定します。

length

integer

追加する行または列の数。

AddConditionalFormatRuleRequest

指定されたインデックスに新しい条件付き書式ルールを追加します。後続のルールのインデックスはすべてインクリメントされます。

JSON 表現
{
  "rule": {
    object (ConditionalFormatRule)
  },
  "index": integer
}
フィールド
rule

object (ConditionalFormatRule)

追加するルール。

index

integer

ルールを挿入する 0 から始まるインデックス。

UpdateConditionalFormatRuleRequest

指定されたインデックスにある条件付き書式ルールを更新するか、条件付き書式ルールを別のインデックスに移動します。

JSON 表現
{
  "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.
}
フィールド
index

integer

置き換えるか移動するルールの 0 から始まるインデックス。

sheetId

integer

移動するルールのシート。newIndex が設定されている場合は必須。それ以外の場合は使用されません。

共用体フィールド instruction。実行される更新の種類。instruction は次のいずれかになります。
rule

object (ConditionalFormatRule)

指定されたインデックスのルールを置き換えるルール。

newIndex

integer

ルールの新しいインデックス(ゼロベース)。

DeleteConditionalFormatRuleRequest

指定されたインデックスにある条件付き書式ルールを削除します。後続のルールのインデックスはすべて減分されます。

JSON 表現
{
  "index": integer,
  "sheetId": integer
}
フィールド
index

integer

削除するルールのゼロベースのインデックス。

sheetId

integer

ルールが削除されるシート。

SortRangeRequest

列ごとの並べ替え順序に基づいて、行のデータを並べ替えます。

JSON 表現
{
  "range": {
    object (GridRange)
  },
  "sortSpecs": [
    {
      object (SortSpec)
    }
  ]
}
フィールド
range

object (GridRange)

並べ替える範囲。

sortSpecs[]

object (SortSpec)

列ごとの並べ替え順序。以前の仕様で値が等しい場合は、後の仕様が使用されます。

SetDataValidationRequest

範囲内のすべてのセルにデータ入力規則を設定します。範囲内の検証をクリアするには、ルールを指定せずにこの関数を呼び出します。

JSON 表現
{
  "range": {
    object (GridRange)
  },
  "rule": {
    object (DataValidationRule)
  },
  "filteredRowsIncluded": boolean
}
フィールド
range

object (GridRange)

データの入力規則を適用する範囲。

rule

object (DataValidationRule)

範囲内の各セルに設定するデータ入力規則。範囲内のデータ入力規則をクリアする場合は空にします。

filteredRowsIncluded

boolean

省略可。true の場合、データの入力規則はフィルタされた行にも適用されます。

SetBasicFilterRequest

シートに関連付けられた基本フィルタを設定します。

JSON 表現
{
  "filter": {
    object (BasicFilter)
  }
}
フィールド
filter

object (BasicFilter)

設定するフィルタ。

AddProtectedRangeRequest

新しい保護範囲を追加します。

JSON 表現
{
  "protectedRange": {
    object (ProtectedRange)
  }
}
フィールド
protectedRange

object (ProtectedRange)

追加する保護範囲。protectedRangeId フィールドは省略可能です。設定されていない場合、ID はランダムに生成されます。(すでに存在する範囲の ID を指定するとエラーになります)。

UpdateProtectedRangeRequest

指定された protectedRangeId で既存の保護範囲を更新します。

JSON 表現
{
  "protectedRange": {
    object (ProtectedRange)
  },
  "fields": string
}
フィールド
protectedRange

object (ProtectedRange)

新しいプロパティで更新する保護された範囲。

fields

string (FieldMask format)

更新するフィールド。少なくとも 1 つのフィールドを指定する必要があります。ルート protectedRange は暗黙的に指定されるため、指定しないでください。1 つの "*" は、すべてのフィールドをリストする省略形として使用できます。

DeleteProtectedRangeRequest

指定された ID の保護された範囲を削除します。

JSON 表現
{
  "protectedRangeId": integer
}
フィールド
protectedRangeId

integer

削除する保護された範囲の ID。

AutoResizeDimensionsRequest

1 つ以上のディメンションのサイズを、そのディメンションのセルの内容に基づいて自動的に変更します。

JSON 表現
{

  // 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.
}
フィールド
共用体フィールド dimension_range。ディメンションの範囲。dimension_range は次のいずれかになります。
dimensions

object (DimensionRange)

自動的にサイズ変更するディメンション。

dataSourceSheetDimensions

object (DataSourceSheetDimensionRange)

データソース シートのディメンションを自動的にサイズ変更します。

AddChartRequest

スプレッドシートのシートにグラフを追加します。

JSON 表現
{
  "chart": {
    object (EmbeddedChart)
  }
}
フィールド
chart

object (EmbeddedChart)

スプレッドシートに追加するグラフ。配置する位置も指定します。chartId フィールドは省略可能です。設定されていない場合、ID はランダムに生成されます。(すでに存在する埋め込みオブジェクトの ID を指定するとエラーになります)。

UpdateChartSpecRequest

グラフの仕様を更新します。(グラフの移動やサイズ変更は行われません。グラフを移動またはサイズ変更するには、UpdateEmbeddedObjectPositionRequest を使用します。

JSON 表現
{
  "chartId": integer,
  "spec": {
    object (ChartSpec)
  }
}
フィールド
chartId

integer

更新するグラフの ID。

spec

object (ChartSpec)

グラフに適用する仕様。

UpdateBandingRequest

指定された帯域範囲のプロパティを更新します。

JSON 表現
{
  "bandedRange": {
    object (BandedRange)
  },
  "fields": string
}
フィールド
bandedRange

object (BandedRange)

新しいプロパティで更新する帯域範囲。

fields

string (FieldMask format)

更新するフィールド。少なくとも 1 つのフィールドを指定する必要があります。ルート bandedRange は暗黙的に指定されるため、指定しないでください。1 つの "*" は、すべてのフィールドをリストする省略形として使用できます。

AddBandingRequest

スプレッドシートに新しい帯域範囲を追加します。

JSON 表現
{
  "bandedRange": {
    object (BandedRange)
  }
}
フィールド
bandedRange

object (BandedRange)

追加する帯域範囲。bandedRangeId フィールドは省略可能です。設定されていない場合、ID はランダムに生成されます。(すでに存在する範囲の ID を指定するとエラーになります)。

DeleteBandingRequest

指定された ID の帯域範囲をスプレッドシートから削除します。

JSON 表現
{
  "bandedRangeId": integer
}
フィールド
bandedRangeId

integer

削除する帯域範囲の ID。

CreateDeveloperMetadataRequest

デベロッパー メタデータを作成するためのリクエスト。

JSON 表現
{
  "developerMetadata": {
    object (DeveloperMetadata)
  }
}
フィールド
developerMetadata

object (DeveloperMetadata)

作成するデベロッパー メタデータ。

UpdateDeveloperMetadataRequest

デベロッパー メタデータのプロパティを更新するリクエスト。フィルタで選択されたデベロッパー メタデータのプロパティを、DeveloperMetadata リソースで指定された値に更新します。呼び出し元は、更新するプロパティを fields パラメータで指定し、更新するメタデータに一致する DataFilter を 1 つ以上指定する必要があります。

JSON 表現
{
  "dataFilters": [
    {
      object (DataFilter)
    }
  ],
  "developerMetadata": {
    object (DeveloperMetadata)
  },
  "fields": string
}
フィールド
dataFilters[]

object (DataFilter)

更新するデベロッパー メタデータ エントリに一致するフィルタ。

developerMetadata

object (DeveloperMetadata)

データフィルタで一致したすべてのメタデータの値が更新されます。

fields

string (FieldMask format)

更新するフィールド。少なくとも 1 つのフィールドを指定する必要があります。ルート developerMetadata は暗黙的に指定されるため、指定しないでください。1 つの "*" は、すべてのフィールドをリストする省略形として使用できます。

DeleteDeveloperMetadataRequest

デベロッパー メタデータを削除するリクエスト。

JSON 表現
{
  "dataFilter": {
    object (DataFilter)
  }
}
フィールド
dataFilter

object (DataFilter)

削除するデベロッパー メタデータ エントリを選択するために使用される条件を記述するデータフィルタ。

RandomizeRangeRequest

範囲内の行の順序をランダム化します。

JSON 表現
{
  "range": {
    object (GridRange)
  }
}
フィールド
range

object (GridRange)

ランダム化する範囲。

AddDimensionGroupRequest

指定された範囲にグループを作成します。

リクエストされた範囲が既存のグループ G の範囲のスーパーセットである場合、G の深さがインクリメントされ、この新しいグループ G' はそのグループの深さを持ちます。たとえば、グループ [C:D, 深さ 1] + [B:E] は、グループ [B:E, 深さ 1] と [C:D, 深さ 2] になります。リクエストされた範囲が既存のグループ G の範囲のサブセットである場合、新しいグループ G' の深さは G の深さより 1 つ大きくなります。たとえば、グループ [B:E, 深さ 1] + [C:D] は、グループ [B:E, 深さ 1] と [C:D, 深さ 2] になります。リクエストされた範囲が既存のグループ G の範囲の前に始まり、その範囲内で終わる場合、またはその範囲内で始まり、その範囲の後に終わる場合、既存のグループ G の範囲は範囲の和集合になり、新しいグループ G' の深さは G の深さよりも 1 大きく、範囲は範囲の積集合になります。たとえば、グループ [B:D, 深さ 1] + [C:E] は、グループ [B:E, 深さ 1] と [C:D, 深さ 2] になります。

JSON 表現
{
  "range": {
    object (DimensionRange)
  }
}
フィールド
range

object (DimensionRange)

グループを作成する範囲。

DeleteDimensionGroupRequest

指定された範囲のグループを削除します。範囲内のディメンションの深さを減らします。

たとえば、シートに B:E の深さ 1 のグループと C:D の深さ 2 のグループがあるとします。D:E のグループを削除すると、シートには B:D の深さ 1 のグループと C:C の深さ 2 のグループが残ります。

JSON 表現
{
  "range": {
    object (DimensionRange)
  }
}
フィールド
range

object (DimensionRange)

削除するグループの範囲。

UpdateDimensionGroupRequest

指定されたグループの状態を更新します。

JSON 表現
{
  "dimensionGroup": {
    object (DimensionGroup)
  },
  "fields": string
}
フィールド
dimensionGroup

object (DimensionGroup)

状態を更新するグループ。グループの範囲と深さでシート上の有効なグループを指定し、他のすべてのフィールドを更新する必要があります。

fields

string (FieldMask format)

更新するフィールド。少なくとも 1 つのフィールドを指定する必要があります。ルート dimensionGroup は暗黙的に指定されるため、指定しないでください。1 つの "*" は、すべてのフィールドをリストする省略形として使用できます。

TrimWhitespaceRequest

指定した範囲内のすべてのセルの空白文字(スペース、タブ、改行など)を削除します。このリクエストは、各セルのテキストの先頭と末尾にあるすべての空白を削除し、残りの空白文字の連続を 1 つのスペースに減らします。トリミング後のテキストが「+」または「=」で始まる場合、テキストは文字列値として残り、数式として解釈されません。

JSON 表現
{
  "range": {
    object (GridRange)
  }
}
フィールド
range

object (GridRange)

セルをトリミングする範囲。

DeleteDuplicatesRequest

この範囲内で、指定された列の値が前の行の値と重複している行を削除します。行内の大文字、小文字、書式、数式などが異なる場合でも、値自体が同じであれば重複と見なされます。

このリクエストでは、ビューから非表示になっている重複する行(フィルタなどによる)も削除されます。重複を削除する場合、上から下に向かってスキャンしたときに最初に見つかった重複行のインスタンスが結果の範囲に残されます。指定した範囲外のコンテンツは削除されません。また、重複とみなされる行は、範囲内で隣接している必要はありません。

JSON 表現
{
  "range": {
    object (GridRange)
  },
  "comparisonColumns": [
    {
      object (DimensionRange)
    }
  ]
}
フィールド
range

object (GridRange)

重複する行を削除する範囲。

comparisonColumns[]

object (DimensionRange)

重複値を分析する範囲内の列。列が選択されていない場合は、すべての列で重複が分析されます。

UpdateEmbeddedObjectBorderRequest

埋め込みオブジェクトの境界プロパティを更新します。

JSON 表現
{
  "objectId": integer,
  "border": {
    object (EmbeddedObjectBorder)
  },
  "fields": string
}
フィールド
objectId

integer

更新する埋め込みオブジェクトの ID。

border

object (EmbeddedObjectBorder)

埋め込みオブジェクトに適用される枠線。

fields

string (FieldMask format)

更新するフィールド。少なくとも 1 つのフィールドを指定する必要があります。ルート border は暗黙的に指定されるため、指定しないでください。1 つの "*" は、すべてのフィールドをリストする省略形として使用できます。

AddSlicerRequest

スプレッドシートのシートにスライサーを追加します。

JSON 表現
{
  "slicer": {
    object (Slicer)
  }
}
フィールド
slicer

object (Slicer)

スプレッドシートに追加するスライサー。配置する位置も指定します。slicerId フィールドは省略可能です。設定されていない場合、ID はランダムに生成されます。(すでに存在するスライサーの ID を指定するとエラーになります)。

UpdateSlicerSpecRequest

スライサーの仕様を更新します。(スライサーの移動やサイズ変更は行われません。スライサーを移動またはサイズ変更するには、UpdateEmbeddedObjectPositionRequest を使用します。

JSON 表現
{
  "slicerId": integer,
  "spec": {
    object (SlicerSpec)
  },
  "fields": string
}
フィールド
slicerId

integer

更新するスライサーの ID。

spec

object (SlicerSpec)

スライサーに適用する仕様。

fields

string (FieldMask format)

更新するフィールド。少なくとも 1 つのフィールドを指定する必要があります。ルート SlicerSpec は暗黙的に指定されるため、指定しないでください。すべてのフィールドをリストする短縮形として、単一の「*」を使用できます。

AddDataSourceRequest

データソースを追加します。データソースが正常に追加されると、関連する DATA_SOURCE シートが作成され、シートを更新してデータソースからデータを読み取る実行がトリガーされます。

BigQuery データソースを追加する場合は、リクエストに追加の bigquery.readonly OAuth スコープが必要です。

JSON 表現
{
  "dataSource": {
    object (DataSource)
  }
}
フィールド
dataSource

object (DataSource)

追加するデータソース。

UpdateDataSourceRequest

データソースを更新します。データソースが正常に更新されると、関連付けられた DATA_SOURCE シートを更新して、更新されたデータソースからデータを読み取る実行がトリガーされます。

BigQuery データソースを更新する場合は、リクエストに追加の bigquery.readonly OAuth スコープが必要です。

JSON 表現
{
  "dataSource": {
    object (DataSource)
  },
  "fields": string
}
フィールド
dataSource

object (DataSource)

更新するデータソース。

fields

string (FieldMask format)

更新するフィールド。少なくとも 1 つのフィールドを指定する必要があります。ルート dataSource は暗黙的に指定されるため、指定しないでください。1 つの "*" は、すべてのフィールドをリストする省略形として使用できます。

DeleteDataSourceRequest

データソースを削除します。リクエストは、関連付けられたデータソース シートも削除し、関連付けられたすべてのデータソース オブジェクトのリンクを解除します。

JSON 表現
{
  "dataSourceId": string
}
フィールド
dataSourceId

string

削除するデータソースの ID。

RefreshDataSourceRequest

指定された参照によって、スプレッドシート内の 1 つまたは複数のデータソース オブジェクトを更新します。

BigQuery データソースを更新する場合は、リクエストに追加の bigquery.readonly OAuth スコープが必要です。

1 つのバッチで同じデータソース オブジェクトを参照する複数の更新リクエストがある場合、最後の更新リクエストのみが処理され、それらのリクエストはすべて同じレスポンスになります。

JSON 表現
{
  "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.
}
フィールド
force

boolean

現在の状態に関係なく、データソース オブジェクトを更新します。設定されておらず、参照されたデータソース オブジェクトがエラー状態にある場合、更新はすぐに失敗します。

共用体フィールド target。更新する内容を指定します。target は次のいずれかになります。
references

object (DataSourceObjectReferences)

更新するデータソース オブジェクトへの参照。

dataSourceId

string

DataSource への参照。指定すると、データソースに関連付けられているすべてのデータソース オブジェクトが更新されます。

isAll

boolean

スプレッドシート内の既存のデータソース オブジェクトをすべて更新します。

DataSourceObjectReferences

データソース オブジェクトへの参照のリスト。

JSON 表現
{
  "references": [
    {
      object (DataSourceObjectReference)
    }
  ]
}
フィールド
references[]

object (DataSourceObjectReference)

参照。

DataSourceObjectReference

データソース オブジェクトへの参照。

JSON 表現
{

  // 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.
}
フィールド
共用体フィールド value。参照タイプ。value は次のいずれかになります。
sheetId

string

DATA_SOURCE シートへの参照。

chartId

integer

データソース グラフへの参照。

dataSourceTableAnchorCell

object (GridCoordinate)

セルにアンカー設定された DataSourceTable への参照。

dataSourcePivotTableAnchorCell

object (GridCoordinate)

セルにアンカー設定されたデータソースへの参照。 PivotTable

dataSourceFormulaCell

object (GridCoordinate)

DataSourceFormula を含むセルへの参照。

CancelDataSourceRefreshRequest

指定された参照によって、スプレッドシート内のデータソース オブジェクトの 1 つまたは複数の更新をキャンセルします。

BigQuery データソースの更新をキャンセルする場合は、リクエストに追加の bigquery.readonly OAuth スコープが必要です。

JSON 表現
{

  // 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.
}
フィールド
共用体フィールド target。キャンセルするものを指定します。target は次のいずれかになります。
references

object (DataSourceObjectReferences)

更新をキャンセルするデータソース オブジェクトへの参照。

dataSourceId

string

DataSource への参照。指定されている場合、このデータソースに関連付けられているすべてのデータソース オブジェクトの更新をキャンセルします。

isAll

boolean

スプレッドシート内のすべてのデータソースについて、既存のデータソース オブジェクトの更新をすべてキャンセルします。

AddTableRequest

スプレッドシートに新しいテーブルを追加します。

JSON 表現
{
  "table": {
    object (Table)
  }
}
フィールド
table

object (Table)

必須。追加するテーブル。

UpdateTableRequest

スプレッドシートのテーブルを更新します。

JSON 表現
{
  "table": {
    object (Table)
  },
  "fields": string
}
フィールド
table

object (Table)

必須。更新するテーブル。

fields

string (FieldMask format)

必須。更新するフィールド。少なくとも 1 つのフィールドを指定する必要があります。ルート table は暗黙的に指定されるため、指定しないでください。1 つの "*" は、すべてのフィールドをリストする省略形として使用できます。

DeleteTableRequest

指定された ID のテーブルをスプレッドシートから削除します。

JSON 表現
{
  "tableId": string
}
フィールド
tableId

string

削除するテーブルの ID。