Sheets

シート

スプレッドシートのシート。

JSON 表現
{
  "properties": {
    object (SheetProperties)
  },
  "data": [
    {
      object (GridData)
    }
  ],
  "merges": [
    {
      object (GridRange)
    }
  ],
  "conditionalFormats": [
    {
      object (ConditionalFormatRule)
    }
  ],
  "filterViews": [
    {
      object (FilterView)
    }
  ],
  "protectedRanges": [
    {
      object (ProtectedRange)
    }
  ],
  "basicFilter": {
    object (BasicFilter)
  },
  "charts": [
    {
      object (EmbeddedChart)
    }
  ],
  "bandedRanges": [
    {
      object (BandedRange)
    }
  ],
  "developerMetadata": [
    {
      object (DeveloperMetadata)
    }
  ],
  "rowGroups": [
    {
      object (DimensionGroup)
    }
  ],
  "columnGroups": [
    {
      object (DimensionGroup)
    }
  ],
  "slicers": [
    {
      object (Slicer)
    }
  ],
  "tables": [
    {
      object (Table)
    }
  ]
}
フィールド
properties

object (SheetProperties)

シートのプロパティ。

data[]

object (GridData)

グリッド内のデータ(グリッドシートの場合)。

返される GridData オブジェクトの数は、このシートでリクエストされた範囲の数によって異なります。たとえば、これが Sheet1 を表しており、スプレッドシートが Sheet1!A1:C10Sheet1!D15:E20 の範囲でリクエストされた場合、最初の GridData の startRow / startColumn0 になり、2 番目の GridData の startRow 14(ゼロベースの行 15)と startColumn 3(ゼロベースの列 D)になります。

DATA_SOURCE シートの場合、特定の範囲をリクエストすることはできません。GridData にはすべての値が含まれます。

merges[]

object (GridRange)

マージされる範囲。

conditionalFormats[]

object (ConditionalFormatRule)

このシートの条件付き書式ルール。

filterViews[]

object (FilterView)

このシートのフィルタ表示。

protectedRanges[]

object (ProtectedRange)

このシートの保護されている範囲。

basicFilter

object (BasicFilter)

このシートのフィルタ(存在する場合)。

charts[]

object (EmbeddedChart)

このシートのすべてのグラフの仕様。

bandedRanges[]

object (BandedRange)

このシートの帯状(交互の色)の範囲。

developerMetadata[]

object (DeveloperMetadata)

シートに関連付けられたデベロッパー メタデータ。

rowGroups[]

object (DimensionGroup)

このシートのすべての行グループ。範囲の開始インデックスの昇順、次にグループの深さの順に並べ替えられます。

columnGroups[]

object (DimensionGroup)

このシートのすべての列グループ。範囲の開始インデックスの昇順、次にグループの深さの順に並べ替えられます。

slicers[]

object (Slicer)

このシートのスライサー。

tables[]

object (Table)

このシートのテーブル。

SheetProperties

シートのプロパティ。

JSON 表現
{
  "sheetId": integer,
  "title": string,
  "index": integer,
  "sheetType": enum (SheetType),
  "gridProperties": {
    object (GridProperties)
  },
  "hidden": boolean,
  "tabColor": {
    object (Color)
  },
  "tabColorStyle": {
    object (ColorStyle)
  },
  "rightToLeft": boolean,
  "dataSourceSheetProperties": {
    object (DataSourceSheetProperties)
  }
}
フィールド
sheetId

integer

シートの ID。負の値は使用できません。このフィールドは、一度設定すると変更できません。

title

string

シートの名前。

index

integer

スプレッドシート内のシートのインデックス。シートのプロパティを追加または更新するときに、このフィールドが除外されている場合、シートはシートリストの末尾に追加または移動されます。シートのインデックスを更新したり、シートを挿入したりする場合、移動は「移動前」のインデックスで考慮されます。たとえば、3 つのシート(S1、S2、S3)があり、S1 を S2 の前に移動するには、インデックスを 2 に設定する必要があります。リクエストされたインデックスがシートの現在のインデックスと同じ場合、またはリクエストされた新しいインデックスが現在のシートのインデックス + 1 と等しい場合、シートのインデックス更新リクエストは無視されます。

sheetType

enum (SheetType)

シートのタイプ。デフォルトは GRID です。このフィールドは、一度設定すると変更できません。

gridProperties

object (GridProperties)

このシートがグリッドの場合のシートの追加プロパティ。(シートがグラフや画像を含むオブジェクト シートの場合、このフィールドは存在しません)。書き込み時に、グリッド以外のシートにグリッド プロパティを設定するとエラーになります。

このシートが DATA_SOURCE シートの場合、このフィールドは出力専用ですが、データソース シートが UI でどのようにレンダリングされるかを反映するプロパティ(rowCount など)が含まれます。

hidden

boolean

シートが UI で非表示になっている場合は true、表示されている場合は false。

tabColor
(deprecated)

object (Color)

UI のタブの色。非推奨: tabColorStyle を使用します。

tabColorStyle

object (ColorStyle)

UI のタブの色。tabColor も設定されている場合、このフィールドが優先されます。

rightToLeft

boolean

シートが LTR シートではなく RTL シートの場合は true。

dataSourceSheetProperties

object (DataSourceSheetProperties)

出力専用。存在する場合、このフィールドには DATA_SOURCE シート固有のプロパティが含まれます。

SheetType

シートの種類。

列挙型
SHEET_TYPE_UNSPECIFIED デフォルト値。使用しないでください。
GRID シートはグリッドです。
OBJECT シートにグリッドがなく、代わりにグラフや画像などのオブジェクトがある。
DATA_SOURCE シートが外部の DataSource に接続され、データのプレビューが表示されます。

GridProperties

グリッドのプロパティ。

JSON 表現
{
  "rowCount": integer,
  "columnCount": integer,
  "frozenRowCount": integer,
  "frozenColumnCount": integer,
  "hideGridlines": boolean,
  "rowGroupControlAfter": boolean,
  "columnGroupControlAfter": boolean
}
フィールド
rowCount

integer

グリッド内の行数。

columnCount

integer

グリッド内の列数。

frozenRowCount

integer

グリッドで固定されている行数。

frozenColumnCount

integer

グリッドで固定されている列の数。

hideGridlines

boolean

UI でグリッド線が表示されていない場合は true。

rowGroupControlAfter

boolean

行グループ化コントロールの切り替えをグループの後に表示する場合は true。

columnGroupControlAfter

boolean

グループの後に列グループ化コントロールの切り替えが表示される場合は true。

DataSourceSheetProperties

DATA_SOURCE シートの追加プロパティ。

JSON 表現
{
  "dataSourceId": string,
  "columns": [
    {
      object (DataSourceColumn)
    }
  ],
  "dataExecutionStatus": {
    object (DataExecutionStatus)
  }
}
フィールド
dataSourceId

string

シートが接続されている DataSource の ID。

columns[]

object (DataSourceColumn)

シートに表示される列。RowData の値に対応しています。

dataExecutionStatus

object (DataExecutionStatus)

データの実行ステータス。

GridData

グリッド内のデータと、ディメンションに関するメタデータ。

JSON 表現
{
  "startRow": integer,
  "startColumn": integer,
  "rowData": [
    {
      object (RowData)
    }
  ],
  "rowMetadata": [
    {
      object (DimensionProperties)
    }
  ],
  "columnMetadata": [
    {
      object (DimensionProperties)
    }
  ]
}
フィールド
startRow

integer

この GridData が参照する最初の行(ゼロベース)。

startColumn

integer

この GridData が参照する最初の列(ゼロベース)。

rowData[]

object (RowData)

グリッド内のデータ。行ごとに 1 つのエントリ。startRow の行から始まります。RowData の値は、startColumn から始まる列に対応します。

rowMetadata[]

object (DimensionProperties)

グリッド内のリクエストされた行に関するメタデータ。startRow の行から始まります。

columnMetadata[]

object (DimensionProperties)

グリッド内のリクエストされた列に関するメタデータ。startColumn の列から始まります。

RowData

行内の各セルに関するデータ。

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

object (CellData)

行の値(列ごとに 1 つ)。

DimensionProperties

ディメンションに関するプロパティ。

JSON 表現
{
  "hiddenByFilter": boolean,
  "hiddenByUser": boolean,
  "pixelSize": integer,
  "developerMetadata": [
    {
      object (DeveloperMetadata)
    }
  ],
  "dataSourceColumnReference": {
    object (DataSourceColumnReference)
  }
}
フィールド
hiddenByFilter

boolean

このディメンションがフィルタされている場合は true。このフィールドは読み取り専用です。

hiddenByUser

boolean

このディメンションが明示的に非表示になっている場合は true。

pixelSize

integer

ディメンションの高さ(行の場合)または幅(列の場合)(ピクセル単位)。

developerMetadata[]

object (DeveloperMetadata)

単一行または単一列に関連付けられたデベロッパー メタデータ。

dataSourceColumnReference

object (DataSourceColumnReference)

出力専用。設定されている場合、これはデータソース シートの列です。

ConditionalFormatRule

条件付き書式を記述するルール。

JSON 表現
{
  "ranges": [
    {
      object (GridRange)
    }
  ],

  // Union field rule can be only one of the following:
  "booleanRule": {
    object (BooleanRule)
  },
  "gradientRule": {
    object (GradientRule)
  }
  // End of list of possible types for union field rule.
}
フィールド
ranges[]

object (GridRange)

条件が true の場合に書式設定される範囲。すべての範囲が同じグリッド上にある必要があります。

共用体フィールド rule。この条件付き書式を制御するルール。1 つだけ設定する必要があります。rule は次のいずれかになります。
booleanRule

object (BooleanRule)

ルールに従って、フォーマットが「オン」または「オフ」になります。

gradientRule

object (GradientRule)

書式設定は、ルールのグラデーションによって異なります。

BooleanRule

条件に応じて一致する場合と一致しない場合があるルール。

JSON 表現
{
  "condition": {
    object (BooleanCondition)
  },
  "format": {
    object (CellFormat)
  }
}
フィールド
condition

object (BooleanCondition)

ルールの条件。条件が true と評価された場合、形式が適用されます。

format

object (CellFormat)

適用する形式。条件付き書式では、bolditalicstrikethroughforeground colorbackground color の一部の書式のみを適用できます。

GradientRule

リストされた補間ポイントに基づいて、グラデーション カラースケール形式を適用するルール。セルの形式は、補間ポイントの値と比較したコンテンツに基づいて変化します。

JSON 表現
{
  "minpoint": {
    object (InterpolationPoint)
  },
  "midpoint": {
    object (InterpolationPoint)
  },
  "maxpoint": {
    object (InterpolationPoint)
  }
}
フィールド
minpoint

object (InterpolationPoint)

補間の開始点。

midpoint

object (InterpolationPoint)

中間補間ポイント(省略可)。

maxpoint

object (InterpolationPoint)

最終的な補間ポイント。

InterpolationPoint

グラデーションの条件付き書式における単一の補間ポイント。これらは、選択した色、タイプ、値に応じてグラデーション カラースケールを固定します。

JSON 表現
{
  "color": {
    object (Color)
  },
  "colorStyle": {
    object (ColorStyle)
  },
  "type": enum (InterpolationPointType),
  "value": string
}
フィールド
color
(deprecated)

object (Color)

この補間ポイントで使用する色。非推奨: colorStyle を使用します。

colorStyle

object (ColorStyle)

この補間ポイントで使用する色。color も設定されている場合、このフィールドが優先されます。

type

enum (InterpolationPointType)

値の解釈方法。

value

string

この補間ポイントが使用する値。数式の場合もあります。typeMIN または MAX の場合は使用されません。

InterpolationPointType

補間ポイントの種類。

列挙型
INTERPOLATION_POINT_TYPE_UNSPECIFIED デフォルト値。使用しないでください。
MIN 補間ポイントでは、条件付き書式の範囲内のセルの最小値が使用されます。
MAX 補間ポイントでは、条件付き書式の範囲内のセルで最大値が使用されます。
NUMBER 補間ポイントは InterpolationPoint.value の値をそのまま使用します。
PERCENT

補間ポイントは、条件付き書式の範囲内のすべてのセルに対する指定された割合です。値が =(MAX(FLATTEN(range)) * (value / 100)) + (MIN(FLATTEN(range)) * (1 - (value / 100))) の場合、これは NUMBER と同等です(範囲内のエラーはフラット化時に無視されます)。

PERCENTILE 補間ポイントは、条件付き書式の範囲内のすべてのセルに対する指定されたパーセンタイルです。値が =PERCENTILE(FLATTEN(range), value / 100) の場合、これは NUMBER と同等です(範囲内のエラーはフラット化時に無視されます)。

FilterView

フィルタ表示。詳細については、フィルタを使用してデータの可視性を管理するをご覧ください。

JSON 表現
{
  "filterViewId": integer,
  "title": string,
  "range": {
    object (GridRange)
  },
  "namedRangeId": string,
  "tableId": string,
  "sortSpecs": [
    {
      object (SortSpec)
    }
  ],
  "criteria": {
    integer: {
      object (FilterCriteria)
    },
    ...
  },
  "filterSpecs": [
    {
      object (FilterSpec)
    }
  ]
}
フィールド
filterViewId

integer

フィルタ ビューの ID。

title

string

フィルタ ビューの名前。

range

object (GridRange)

このフィルタ表示が対象とする範囲。

書き込み時に設定できるのは、rangenamedRangeIdtableId のいずれか 1 つのみです。

namedRangeId

string

このフィルタ表示の基盤となる名前付き範囲(存在する場合)。

書き込み時に設定できるのは、rangenamedRangeIdtableId のいずれか 1 つのみです。

tableId

string

このフィルタビューがサポートするテーブル(存在する場合)。

書き込み時に設定できるのは、rangenamedRangeIdtableId のいずれか 1 つのみです。

sortSpecs[]

object (SortSpec)

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

criteria
(deprecated)

map (key: integer, value: object ( FilterCriteria))

列ごとに値を表示/非表示にする条件。マップのキーは列インデックスで、値はその列の条件です。

このフィールドは非推奨になりました。代わりに filterSpecs を使用してください。

filterSpecs[]

object (FilterSpec)

列ごとに値を表示または非表示にするためのフィルタ条件。

criteriafilterSpecs の両方がレスポンスに設定されます。更新リクエストで両方のフィールドが指定されている場合、このフィールドが優先されます。

ProtectedRange

保護されている範囲。

JSON 表現
{
  "protectedRangeId": integer,
  "range": {
    object (GridRange)
  },
  "namedRangeId": string,
  "tableId": string,
  "description": string,
  "warningOnly": boolean,
  "requestingUserCanEdit": boolean,
  "unprotectedRanges": [
    {
      object (GridRange)
    }
  ],
  "editors": {
    object (Editors)
  }
}
フィールド
protectedRangeId

integer

保護されている範囲の ID。このフィールドは読み取り専用です。

range

object (GridRange)

保護されている範囲。範囲が完全に制限されていない場合、保護されたシートと見なされます。

書き込み時に、rangenamedRangeIdtableId のいずれか 1 つのみを設定できます。

namedRangeId

string

この保護された範囲の基盤となる名前付き範囲(存在する場合)。

書き込み時に、rangenamedRangeIdtableId のいずれか 1 つのみを設定できます。

tableId

string

この保護された範囲がサポートするテーブル(存在する場合)。

書き込み時に、rangenamedRangeIdtableId のいずれか 1 つのみを設定できます。

description

string

この保護された範囲の説明。

warningOnly

boolean

この保護された範囲を編集するときに警告が表示される場合は true。警告ベースの保護では、保護された範囲のデータをすべてのユーザーが編集できますが、編集時に警告が表示され、編集の確認が求められます。

書き込み時: このフィールドが true の場合、editors は無視されます。また、このフィールドが true から false に変更され、editors フィールドが設定されていない(フィールド マスクに含まれていない)場合、編集者はドキュメント内のすべての編集者に設定されます。

requestingUserCanEdit

boolean

この保護された範囲をリクエストしたユーザーが保護された領域を編集できる場合は true。このフィールドは読み取り専用です。

unprotectedRanges[]

object (GridRange)

保護されたシート内の保護されていない範囲のリスト。保護されていない範囲は、保護されたシートでのみサポートされます。

editors

object (Editors)

保護された範囲に対する編集アクセス権を持つユーザーとグループ。このフィールドは、保護された範囲とドキュメントに対する編集権限を持つユーザーにのみ表示されます。エディタは warningOnly 保護ではサポートされていません。

編集者

保護されている範囲の編集者。

JSON 表現
{
  "users": [
    string
  ],
  "groups": [
    string
  ],
  "domainUsersCanEdit": boolean
}
フィールド
users[]

string

保護された範囲に対する編集権限を持つユーザーのメールアドレス。

groups[]

string

保護された範囲に対する編集権限を持つグループのメールアドレス。

domainUsersCanEdit

boolean

ドキュメントのドメイン内のユーザーが保護された範囲の編集権限を持っている場合は true。ドメイン保護は、ドメイン内のドキュメントでのみサポートされます。

BasicFilter

シートに関連付けられたデフォルトのフィルタ。詳細については、フィルタを使用してデータの可視性を管理するをご覧ください。

JSON 表現
{
  "range": {
    object (GridRange)
  },
  "tableId": string,
  "sortSpecs": [
    {
      object (SortSpec)
    }
  ],
  "criteria": {
    integer: {
      object (FilterCriteria)
    },
    ...
  },
  "filterSpecs": [
    {
      object (FilterSpec)
    }
  ]
}
フィールド
range

object (GridRange)

フィルタがカバーする範囲。

tableId

string

このフィルタがサポートするテーブル(存在する場合)。書き込み時に設定できるのは、range または tableId のいずれか 1 つのみです。

sortSpecs[]

object (SortSpec)

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

criteria
(deprecated)

map (key: integer, value: object ( FilterCriteria))

列ごとに値を表示/非表示にする条件。マップのキーは列インデックスで、値はその列の条件です。

このフィールドは非推奨になりました。代わりに filterSpecs を使用してください。

filterSpecs[]

object (FilterSpec)

列ごとのフィルタ条件。

criteriafilterSpecs の両方がレスポンスに設定されます。更新リクエストで両方のフィールドが指定されている場合、このフィールドが優先されます。

BandedRange

シートの帯状(交互の背景色)の範囲。

JSON 表現
{
  "bandedRangeId": integer,
  "bandedRangeReference": string,
  "range": {
    object (GridRange)
  },
  "rowProperties": {
    object (BandingProperties)
  },
  "columnProperties": {
    object (BandingProperties)
  }
}
フィールド
bandedRangeId

integer

帯域範囲の ID。設定されていない場合は、bandedRangeReference を参照してください。

bandedRangeReference

string

出力専用。帯域範囲の参照。bandedRangeId でサポートされていない ID を特定するために使用されます。

range

object (GridRange)

これらのプロパティが適用される範囲。

rowProperties

object (BandingProperties)

行バンドのプロパティ。これらのプロパティは、範囲内のすべての行に 1 行ずつ適用されます。rowProperties または columnProperties の少なくとも 1 つを指定する必要があります。

columnProperties

object (BandingProperties)

列バンドのプロパティ。これらのプロパティは、範囲内のすべての列に列ごとに適用されます。rowProperties または columnProperties の少なくとも 1 つを指定する必要があります。

BandingProperties

単一のディメンション(行または列)を参照するプロパティ。BandedRange.row_propertiesBandedRange.column_properties の両方が設定されている場合、次のルールに従ってセルに塗りつぶし色が適用されます。

たとえば、1 行目の色は 1 列目の色よりも優先されますが、1 列目の色は 2 行目の色よりも優先されます。同様に、左上のセルでは行ヘッダーが列ヘッダーよりも優先されますが、行ヘッダーが設定されていない場合は、列ヘッダーが最初の行の色よりも優先されます。

JSON 表現
{
  "headerColor": {
    object (Color)
  },
  "headerColorStyle": {
    object (ColorStyle)
  },
  "firstBandColor": {
    object (Color)
  },
  "firstBandColorStyle": {
    object (ColorStyle)
  },
  "secondBandColor": {
    object (Color)
  },
  "secondBandColorStyle": {
    object (ColorStyle)
  },
  "footerColor": {
    object (Color)
  },
  "footerColorStyle": {
    object (ColorStyle)
  }
}
フィールド
headerColor
(deprecated)

object (Color)

1 行目または 1 列目の色。このフィールドが設定されている場合、最初の行または列はこの色で塗りつぶされ、2 番目の行または列から firstBandColorsecondBandColor の色が交互に表示されます。それ以外の場合は、最初の行または列が firstBandColor で塗りつぶされ、通常どおりに色が交互に適用されます。非推奨: headerColorStyle を使用します。

headerColorStyle

object (ColorStyle)

1 行目または 1 列目の色。このフィールドが設定されている場合、最初の行または列はこの色で塗りつぶされ、2 番目の行または列から firstBandColorsecondBandColor の色が交互に表示されます。それ以外の場合は、最初の行または列が firstBandColor で塗りつぶされ、通常どおりに色が交互に適用されます。headerColor も設定されている場合、このフィールドが優先されます。

firstBandColor
(deprecated)

object (Color)

交互に表示される最初の色。(必須)非推奨: firstBandColorStyle を使用します。

firstBandColorStyle

object (ColorStyle)

交互に表示される最初の色。(必須)firstBandColor も設定されている場合、このフィールドが優先されます。

secondBandColor
(deprecated)

object (Color)

交互になっている 2 つ目の色。(必須)非推奨: secondBandColorStyle を使用します。

secondBandColorStyle

object (ColorStyle)

交互になっている 2 つ目の色。(必須)secondBandColor も設定されている場合、このフィールドが優先されます。

footerColor
(deprecated)

object (Color)

最後の行または列の色。このフィールドが設定されていない場合、最後の行または列は、前の行または列の色に応じて firstBandColor または secondBandColor で塗りつぶされます。非推奨: footerColorStyle を使用します。

footerColorStyle

object (ColorStyle)

最後の行または列の色。このフィールドが設定されていない場合、最後の行または列は、前の行または列の色に応じて firstBandColor または secondBandColor で塗りつぶされます。footerColor も設定されている場合、このフィールドが優先されます。

DimensionGroup

シートの行または列の範囲のグループ。他のグループを含めることも、他のグループに含まれることもできます。シート上でグループを単位として折りたたんだり展開したりできます。

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

object (DimensionRange)

このグループが存在する範囲。

depth

integer

グループの深さ。このグループの範囲を完全に含む範囲を持つグループの数を示します。

collapsed

boolean

このグループが折りたたまれている場合、このフィールドは true になります。重複するグループがより浅い深度で展開されても、折りたたまれたグループは折りたたまれたままになります。

このグループ プロパティとは別にディメンションの可視性を変更できるため、値が true であっても、グループ内のすべてのディメンションが非表示になるわけではありません。ただし、このプロパティが更新されると、このフィールドが true の場合は、その中のすべてのディメンションが非表示に設定され、このフィールドが false の場合は、表示に設定されます。

スライサー

シート内のスライサー。

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

integer

スライサーの ID。

spec

object (SlicerSpec)

スライサーの仕様。

position

object (EmbeddedObjectPosition)

スライサーの位置。スライサーは既存のシートにのみ配置できます。また、スライサーの幅と高さは、許可された範囲内に収まるように自動的に調整できます。

SlicerSpec

スライサーの仕様。

JSON 表現
{
  "dataRange": {
    object (GridRange)
  },
  "filterCriteria": {
    object (FilterCriteria)
  },
  "columnIndex": integer,
  "applyToPivotTables": boolean,
  "title": string,
  "textFormat": {
    object (TextFormat)
  },
  "backgroundColor": {
    object (Color)
  },
  "backgroundColorStyle": {
    object (ColorStyle)
  },
  "horizontalAlignment": enum (HorizontalAlign)
}
フィールド
dataRange

object (GridRange)

スライサーのデータ範囲。

filterCriteria

object (FilterCriteria)

スライサーのフィルタリング条件。

columnIndex

integer

フィルタが適用されるデータテーブルの 0 から始まる列インデックス。

applyToPivotTables

boolean

フィルタをピボット テーブルに適用する場合は true。設定されていない場合、デフォルトで True になります。

title

string

スライサーのタイトル。

textFormat

object (TextFormat)

スライサーのタイトルのテキスト形式。リンク フィールドはサポートされていません。

backgroundColor
(deprecated)

object (Color)

スライサーの背景色。非推奨: backgroundColorStyle を使用します。

backgroundColorStyle

object (ColorStyle)

スライサーの背景色。backgroundColor も設定されている場合、このフィールドが優先されます。

horizontalAlignment

enum (HorizontalAlign)

スライサーのタイトルの水平方向の配置。指定しない場合のデフォルトは LEFT です。

テーブル。

JSON 表現
{
  "tableId": string,
  "name": string,
  "range": {
    object (GridRange)
  },
  "rowsProperties": {
    object (TableRowsProperties)
  },
  "columnProperties": [
    {
      object (TableColumnProperties)
    }
  ]
}
フィールド
tableId

string

テーブルの ID。

name

string

テーブル名。これは、同じスプレッドシート内のすべてのテーブルで一意です。

range

object (GridRange)

テーブル範囲。

rowsProperties

object (TableRowsProperties)

テーブル行のプロパティ。

columnProperties[]

object (TableColumnProperties)

テーブル列のプロパティ。

TableRowsProperties

テーブル行のプロパティ。

JSON 表現
{
  "headerColorStyle": {
    object (ColorStyle)
  },
  "firstBandColorStyle": {
    object (ColorStyle)
  },
  "secondBandColorStyle": {
    object (ColorStyle)
  },
  "footerColorStyle": {
    object (ColorStyle)
  }
}
フィールド
headerColorStyle

object (ColorStyle)

ヘッダー行の色。このフィールドが設定されている場合、ヘッダー行は指定された色で塗りつぶされます。それ以外の場合、ヘッダー行はデフォルトの色で塗りつぶされます。

firstBandColorStyle

object (ColorStyle)

交互に表示される最初の色。このフィールドが設定されている場合、最初の帯状の行は指定された色で塗りつぶされます。それ以外の場合、最初の帯状の行はデフォルトの色で塗りつぶされます。

secondBandColorStyle

object (ColorStyle)

交互になっている 2 つ目の色。このフィールドが設定されている場合、2 番目の帯状の行は指定された色で塗りつぶされます。それ以外の場合、2 番目の帯状の行はデフォルトの色で塗りつぶされます。

footerColorStyle

object (ColorStyle)

最終行の色。このフィールドが設定されていない場合、フッターは追加されず、最後の行は前の行の色に応じて firstBandColorStyle または secondBandColorStyle で塗りつぶされます。フッターのない既存のテーブルにフッターを追加すると、範囲が 1 行拡大されます。フッターを含む既存のテーブルを更新してフッターを削除すると、範囲が 1 行縮小されます。

TableColumnProperties

テーブルの列。

JSON 表現
{
  "columnIndex": integer,
  "columnName": string,
  "columnType": enum (ColumnType),
  "dataValidationRule": {
    object (TableColumnDataValidationRule)
  }
}
フィールド
columnIndex

integer

0 ベースの列インデックス。このインデックスはテーブル内の位置を基準としており、シート内の列インデックスと同じであるとは限りません。

columnName

string

列の名前。

columnType

enum (ColumnType)

列の型。

dataValidationRule

object (TableColumnDataValidationRule)

列のデータ入力規則。プルダウンの列タイプにのみ設定されます。

ColumnType

テーブル内の特定の列の列タイプ。

列挙型
COLUMN_TYPE_UNSPECIFIED 列の型が指定されていません。
DOUBLE 数値の列タイプ。
CURRENCY 通貨列の型。
PERCENT パーセントの列タイプ。
DATE 日付の列タイプ。
TIME 時間列の型。
DATE_TIME 日付と時刻の列タイプ。
TEXT テキスト列の型。
BOOLEAN ブール値の列タイプ。
DROPDOWN プルダウンの列タイプ。
FILES_CHIP ファイルチップの列タイプ
PEOPLE_CHIP ユーザーチップの列タイプ
FINANCE_CHIP ファイナンス チップの列タイプ
PLACE_CHIP 場所チップの列タイプ
RATINGS_CHIP 評価チップの列タイプ

TableColumnDataValidationRule

テーブルの列のデータ入力規則。

JSON 表現
{
  "condition": {
    object (BooleanCondition)
  }
}
フィールド
condition

object (BooleanCondition)

セル内のデータが満たす必要のある条件。[BooleanCondition.type] が ONE_OF_LIST の場合にのみ有効です。