Requests

リクエスト

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

JSON 表現
{

  "updateSpreadsheetProperties": {
    object (UpdateSpreadsheetPropertiesRequest)
  },
  "updateSheetProperties": {
    object (UpdateSheetPropertiesRequest)
  },
  "updateDimensionProperties": {
    object (UpdateDimensionPropertiesRequest)
  },
  "updateNamedRange": {
    object (UpdateNamedRangeRequest)
  },
  "repeatCell": {
    object (RepeatCellRequest)
  },
  "addNamedRange": {
    object (AddNamedRangeRequest)
  },
  "deleteNamedRange": {
    object (DeleteNamedRangeRequest)
  },
  "addSheet": {
    object (AddSheetRequest)
  },
  "deleteSheet": {
    object (DeleteSheetRequest)
  },
  "autoFill": {
    object (AutoFillRequest)
  },
  "cutPaste": {
    object (CutPasteRequest)
  },
  "copyPaste": {
    object (CopyPasteRequest)
  },
  "mergeCells": {
    object (MergeCellsRequest)
  },
  "unmergeCells": {
    object (UnmergeCellsRequest)
  },
  "updateBorders": {
    object (UpdateBordersRequest)
  },
  "updateCells": {
    object (UpdateCellsRequest)
  },
  "addFilterView": {
    object (AddFilterViewRequest)
  },
  "appendCells": {
    object (AppendCellsRequest)
  },
  "clearBasicFilter": {
    object (ClearBasicFilterRequest)
  },
  "deleteDimension": {
    object (DeleteDimensionRequest)
  },
  "deleteEmbeddedObject": {
    object (DeleteEmbeddedObjectRequest)
  },
  "deleteFilterView": {
    object (DeleteFilterViewRequest)
  },
  "duplicateFilterView": {
    object (DuplicateFilterViewRequest)
  },
  "duplicateSheet": {
    object (DuplicateSheetRequest)
  },
  "findReplace": {
    object (FindReplaceRequest)
  },
  "insertDimension": {
    object (InsertDimensionRequest)
  },
  "insertRange": {
    object (InsertRangeRequest)
  },
  "moveDimension": {
    object (MoveDimensionRequest)
  },
  "updateEmbeddedObjectPosition": {
    object (UpdateEmbeddedObjectPositionRequest)
  },
  "pasteData": {
    object (PasteDataRequest)
  },
  "textToColumns": {
    object (TextToColumnsRequest)
  },
  "updateFilterView": {
    object (UpdateFilterViewRequest)
  },
  "deleteRange": {
    object (DeleteRangeRequest)
  },
  "appendDimension": {
    object (AppendDimensionRequest)
  },
  "addConditionalFormatRule": {
    object (AddConditionalFormatRuleRequest)
  },
  "updateConditionalFormatRule": {
    object (UpdateConditionalFormatRuleRequest)
  },
  "deleteConditionalFormatRule": {
    object (DeleteConditionalFormatRuleRequest)
  },
  "sortRange": {
    object (SortRangeRequest)
  },
  "setDataValidation": {
    object (SetDataValidationRequest)
  },
  "setBasicFilter": {
    object (SetBasicFilterRequest)
  },
  "addProtectedRange": {
    object (AddProtectedRangeRequest)
  },
  "updateProtectedRange": {
    object (UpdateProtectedRangeRequest)
  },
  "deleteProtectedRange": {
    object (DeleteProtectedRangeRequest)
  },
  "autoResizeDimensions": {
    object (AutoResizeDimensionsRequest)
  },
  "addChart": {
    object (AddChartRequest)
  },
  "updateChartSpec": {
    object (UpdateChartSpecRequest)
  },
  "updateBanding": {
    object (UpdateBandingRequest)
  },
  "addBanding": {
    object (AddBandingRequest)
  },
  "deleteBanding": {
    object (DeleteBandingRequest)
  },
  "createDeveloperMetadata": {
    object (CreateDeveloperMetadataRequest)
  },
  "updateDeveloperMetadata": {
    object (UpdateDeveloperMetadataRequest)
  },
  "deleteDeveloperMetadata": {
    object (DeleteDeveloperMetadataRequest)
  },
  "randomizeRange": {
    object (RandomizeRangeRequest)
  },
  "addDimensionGroup": {
    object (AddDimensionGroupRequest)
  },
  "deleteDimensionGroup": {
    object (DeleteDimensionGroupRequest)
  },
  "updateDimensionGroup": {
    object (UpdateDimensionGroupRequest)
  },
  "trimWhitespace": {
    object (TrimWhitespaceRequest)
  },
  "deleteDuplicates": {
    object (DeleteDuplicatesRequest)
  },
  "updateEmbeddedObjectBorder": {
    object (UpdateEmbeddedObjectBorderRequest)
  },
  "addSlicer": {
    object (AddSlicerRequest)
  },
  "updateSlicerSpec": {
    object (UpdateSlicerSpecRequest)
  },
  "addDataSource": {
    object (AddDataSourceRequest)
  },
  "updateDataSource": {
    object (UpdateDataSourceRequest)
  },
  "deleteDataSource": {
    object (DeleteDataSourceRequest)
  },
  "refreshDataSource": {
    object (RefreshDataSourceRequest)
  },
  "cancelDataSourceRefresh": {
    object (CancelDataSourceRefreshRequest)
  },
  "addTable": {
    object (AddTableRequest)
  },
  "updateTable": {
    object (UpdateTableRequest)
  },
  "deleteTable": {
    object (DeleteTableRequest)
  },
  "insertComment": {
    object (InsertCommentRequest)
  },
  "addCommentReply": {
    object (AddCommentReplyRequest)
  },
  "updateCommentPost": {
    object (UpdateCommentPostRequest)
  },
  "deleteComment": {
    object (DeleteCommentRequest)
  },
  "deleteCommentReply": {
    object (DeleteCommentReplyRequest)
  }
}
フィールド
更新の種類。フィールドは 1 つだけ必要です。以下は、相互に排他的なフィールドのリストです。レスポンスに設定されるフィールドは、最大 1 つです。
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)

データをシートに貼り付けます(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)

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

insertComment

object (InsertCommentRequest)

スプレッドシートに CommentThread を挿入します。

addCommentReply

object (AddCommentReplyRequest)

CommentThread に返信を追加します。

updateCommentPost

object (UpdateCommentPostRequest)

CommentThread の既存の投稿(ヘッド投稿または返信)を更新します。

deleteComment

object (DeleteCommentRequest)

CommentThread を削除します。

deleteCommentReply

object (DeleteCommentReplyRequest)

CommentThread から返信 Post を削除します。

相互に排他的なフィールドの終了。

UpdateSpreadsheetPropertiesRequest

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

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

object (SpreadsheetProperties)

更新するプロパティ。

fields

string (FieldMask format)

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

UpdateSheetPropertiesRequest

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

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

object (SheetProperties)

更新するプロパティ。

fields

string (FieldMask format)

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

UpdateDimensionPropertiesRequest

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

JSON 表現
{
  "properties": {
    object (DimensionProperties)
  },
  "fields": string,

  "range": {
    object (DimensionRange)
  },
  "dataSourceSheetRange": {
    object (DataSourceSheetDimensionRange)
  }
}
フィールド
properties

object (DimensionProperties)

更新するプロパティ。

fields

string (FieldMask format)

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

ディメンションの範囲。以下は、相互に排他的なフィールドのリストです。レスポンスに設定されるフィールドは、最大 1 つです。
range

object (DimensionRange)

更新する行または列。

dataSourceSheetRange

object (DataSourceSheetDimensionRange)

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

相互に排他的なフィールドの終了。

DataSourceSheetDimensionRange

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

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 は暗黙的に指定されるため、指定しないでください。単一の "*" は、すべてのフィールドを一覧表示する短縮形として使用できます。

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 は暗黙的に指定されるため、指定しないでください。単一の "*" は、すべてのフィールドを一覧表示する短縮形として使用できます。

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,

  "range": {
    object (GridRange)
  },
  "sourceAndDestination": {
    object (SourceAndDestination)
  }
}
フィールド
useAlternateSeries

boolean

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

自動入力する領域。以下は、相互に排他的なフィールドのリストです。レスポンスに設定されるフィールドは、最大 1 つです。
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,

  "start": {
    object (GridCoordinate)
  },
  "range": {
    object (GridRange)
  }
}
フィールド
rows[]

object (RowData)

書き込むデータ。

fields

string (FieldMask format)

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

位置情報が書き込まれます。値を 1 つだけ設定する必要があります。以下は、相互に排他的なフィールドのリストです。レスポンスに設定されるフィールドは、最大 1 つです。
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,

  "tableId": string
}
フィールド
sheetId

integer

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

rows[]

object (RowData)

追加するデータ。

fields

string (FieldMask format)

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

位置情報が書き込まれます。以下は、相互に排他的なフィールドのリストです。レスポンスに設定されるフィールドは、最大 1 つです。
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,

  "range": {
    object (GridRange)
  },
  "sheetId": integer,
  "allSheets": boolean
}
フィールド
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。

検索と置換を行うスコープ。1 つだけ設定する必要があります。以下は、相互に排他的なフィールドのリストです。レスポンスに設定されるフィールドは、最大 1 つです。
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, 4 の A1..A5 があり、"1" と "2" を "3" と "4" の間に移動する場合、ソースは ROWS [1..3)、宛先インデックスは "4"(5 行目のゼロベースのインデックス)になります。最終的な結果は 0, 3, 1, 2, 4 の A1..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 は暗黙的に指定されるため、指定しないでください。単一の "*" は、すべてのフィールドを一覧表示する短縮形として使用できます。

PasteDataRequest

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

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

  "delimiter": string,
  "html": boolean
}
フィールド
coordinate

object (GridCoordinate)

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

data

string

挿入するデータ。

type

enum (PasteType)

データを貼り付ける方法。

データを解釈する方法。正確に 1 つの値を設定する必要があります。以下は、相互に排他的なフィールドのリストです。レスポンスに設定されるフィールドは、最大 1 つです。
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 は暗黙的に指定されるため、指定しないでください。単一の "*" は、すべてのフィールドを一覧表示する短縮形として使用できます。

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,

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

integer

置き換えるか移動するルールのゼロベースのインデックス。

sheetId

integer

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

実行する更新の種類。以下は、相互に排他的なフィールドのリストです。レスポンスに設定されるフィールドは、最大 1 つです。
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 は暗黙的に指定されるため、指定しないでください。単一の "*" は、すべてのフィールドを一覧表示する短縮形として使用できます。

DeleteProtectedRangeRequest

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

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

integer

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

AutoResizeDimensionsRequest

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

JSON 表現
{

  "dimensions": {
    object (DimensionRange)
  },
  "dataSourceSheetDimensions": {
    object (DataSourceSheetDimensionRange)
  }
}
フィールド
ディメンションの範囲。以下は、相互に排他的なフィールドのリストです。レスポンスに設定されるフィールドは、最大 1 つです。
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 は暗黙的に指定されるため、指定しないでください。単一の "*" は、すべてのフィールドを一覧表示する短縮形として使用できます。

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 は暗黙的に指定されるため、指定しないでください。単一の "*" は、すべてのフィールドを一覧表示する短縮形として使用できます。

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, depth 1] + [C:D] は、グループ [B:E, depth 1] と [C:D, depth 2] になります。リクエストされた範囲が既存のグループ G の範囲の前に始まり、その範囲内で終わる場合、またはその範囲内で始まり、その範囲の後に終わる場合、既存のグループ G の範囲は範囲の和集合になり、新しいグループ G' の深さは G の深さより 1 大きく、範囲は範囲の積集合になります。たとえば、グループ [B:D, depth 1] + [C:E] は、グループ [B:E, depth 1] と [C:D, depth 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 は暗黙的に指定されるため、指定しないでください。単一の "*" は、すべてのフィールドを一覧表示する短縮形として使用できます。

TrimWhitespaceRequest

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

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 は暗黙的に指定されるため、指定しないでください。単一の "*" は、すべてのフィールドを一覧表示する短縮形として使用できます。

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 は暗黙的に指定されるため、指定しないでください。単一の "*" は、すべてのフィールドを一覧表示する短縮形として使用できます。

DeleteDataSourceRequest

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

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

string

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

RefreshDataSourceRequest

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

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

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

JSON 表現
{
  "force": boolean,

  "references": {
    object (DataSourceObjectReferences)
  },
  "dataSourceId": string,
  "isAll": boolean
}
フィールド
force

boolean

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

更新する内容を指定します。以下は、相互に排他的なフィールドのリストです。レスポンスに設定されるフィールドは、最大 1 つです。
references

object (DataSourceObjectReferences)

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

dataSourceId

string

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

isAll

boolean

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

相互に排他的なフィールドの終了。

DataSourceObjectReferences

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

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

object (DataSourceObjectReference)

参照。

CancelDataSourceRefreshRequest

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

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

JSON 表現
{

  "references": {
    object (DataSourceObjectReferences)
  },
  "dataSourceId": string,
  "isAll": boolean
}
フィールド
キャンセルする内容を指定します。以下は、相互に排他的なフィールドのリストです。レスポンスに設定されるフィールドは、最大 1 つです。
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 は暗黙的に指定されるため、指定しないでください。単一の "*" は、すべてのフィールドを一覧表示する短縮形として使用できます。

DeleteTableRequest

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

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

string

削除するテーブルの ID。

InsertCommentRequest

スプレッドシートに CommentThread を挿入します。

JSON 表現
{
  "content": string,
  "assigneeEmailAddress": string,

  "coordinate": {
    object (GridCoordinate)
  }
}
フィールド
content

string

コメントのテキスト(書式なしテキスト)。

このテキスト コンテンツは、スプレッドシート エディタで作成されたコメントと同様に処理されます。書式設定や通知などについても同様の動作をします。

このフィールドは空にできず、2, 048 UTF-8 コード単位を超えてはなりません。

assigneeEmailAddress

string

省略可。コメントの割り当て先のメールアドレス。

割り当てられていないコメントの場合は空欄のままにします。

2,048 UTF-8 コード単位を超えてはなりません。

このコメントに関連付けられているシート内の場所。以下は、相互に排他的なフィールドのリストです。レスポンスに設定されるフィールドは、最大 1 つです。
coordinate

object (GridCoordinate)

このコメントに関連付けられているシートの GridCoordinate。

相互に排他的なフィールドの終了。

AddCommentReplyRequest

CommentThread に返信 Post を挿入します。

JSON 表現
{
  "commentId": string,
  "post": {
    object (Post)
  }
}
フィールド
commentId

string

返信を追加する CommentThread の ID。

post

object (Post)

返信を表す Post。

UpdateCommentPostRequest

CommentThread の Post を更新します。

次の場合は、400 不正なリクエスト エラーを返します。

  • リクエストしているユーザーが投稿の作成者ではない。
JSON 表現
{
  "commentId": string,
  "postId": string,
  "content": string
}
フィールド
commentId

string

投稿が属する CommentThread の ID。

postId

string

更新される投稿の ID。

content

string

コメントの新しいテキスト(書式なしテキスト)。

このテキスト コンテンツは、スプレッドシート エディタで作成されたコメントと同様に処理されます。書式設定や通知などについても同様の動作をします。

このフィールドは空にできず、2, 048 UTF-8 コード単位を超えてはなりません。

DeleteCommentRequest

CommentThread を削除します。

リクエストを行ったユーザーが headPost の作成者でない場合は、400 Bad Request エラーを返します。

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

string

削除される CommentThread の ID。

DeleteCommentReplyRequest

CommentThread から返信 Post を削除します。

次の場合は、400 不正なリクエスト エラーを返します。

  • リクエストしているユーザーが投稿の作成者ではありません。

  • 返信投稿には comment action が含まれています。

  • 返信投稿には assignee が含まれています。

JSON 表現
{
  "commentId": string,
  "postId": string
}
フィールド
commentId

string

投稿が属する CommentThread の ID。

postId

string

削除される返信 Post の ID。