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)
    }
  ]
}
フィールド
properties

object (SheetProperties)

シートのプロパティ。

data[]

object (GridData)

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

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

1 つの 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)

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

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

アプリケーションの ID DataSource スプレッドシートが接続されています。

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 は次のいずれか 1 つのみを指定できます。
booleanRule

object (BooleanRule)

形式は「オン」か「オフ」ルールに従って作成されます。

gradientRule

object (GradientRule)

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

BooleanRule

条件によって、一致する場合と一致しないルールがあります。

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

object (BooleanCondition)

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

format

object (CellFormat)

適用する形式。条件付き書式では、書式のサブセットのみを適用できます。 bold, italic, strikethrough, foreground color および background 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

この補間ポイントで使用される値。数式を指定できます。次の場合は使用されない type MIN または MAX

InterpolationPointType

補間ポイントの種類。

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

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

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

FilterView

フィルタ表示。

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

integer

フィルタビューの ID。

title

string

フィルタ表示の名前。

range

object (GridRange)

このフィルタ表示がカバーする範囲です。

記述するときは、次のいずれか 1 つだけを range または namedRangeId 設定できます。

namedRangeId

string

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

記述するときは、次のいずれか 1 つだけを range または namedRangeId 設定できます。

sortSpecs[]

object (SortSpec)

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

criteria
(deprecated)

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

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

このフィールドのサポートは終了し、 filterSpecs

filterSpecs[]

object (FilterSpec)

列の値を表示/非表示にするためのフィルタ条件。

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

ProtectedRange

保護されている範囲。

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

integer

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

range

object (GridRange)

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

記述するときは、次のいずれか 1 つだけを range または namedRangeId 設定できます。

namedRangeId

string

この保護されている範囲の基になる名前付き範囲(存在する場合)。

記述するときは、次のいずれか 1 つだけを range または namedRangeId 設定できます。

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)
  },
  "sortSpecs": [
    {
      object (SortSpec)
    }
  ],
  "criteria": {
    integer: {
      object (FilterCriteria)
    },
    ...
  },
  "filterSpecs": [
    {
      object (FilterSpec)
    }
  ]
}
フィールド
range

object (GridRange)

フィルタの対象となる範囲。

sortSpecs[]

object (SortSpec)

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

criteria
(deprecated)

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

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

このフィールドのサポートは終了し、 filterSpecs

filterSpecs[]

object (FilterSpec)

列あたりのフィルタ条件。

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

BandedRange

シート内の縞模様(交互の背景色)の範囲。

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

integer

バンド付き範囲の ID。

range

object (GridRange)

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

rowProperties

object (BandingProperties)

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

columnProperties

object (BandingProperties)

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

BandingProperties

単一のディメンション(行または列)を参照するプロパティ。両方が BandedRange.row_properties および BandedRange.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)

最初の行または列の色。このフィールドが設定されている場合、最初の行または列はこの色で塗りつぶされ、色が交互に表示されます firstBandColor および secondBandColor 最初の行または列から値を抽出できますそれ以外の場合は、最初の行または列に firstBandColor 色は通常どおり交互に変化します非推奨: 使用 headerColorStyle

headerColorStyle

object (ColorStyle)

最初の行または列の色。このフィールドが設定されている場合、最初の行または列はこの色で塗りつぶされ、色が交互に表示されます。 firstBandColor および secondBandColor 最初の行または列から値を抽出できますそれ以外の場合は、最初の行または列に firstBandColor 色は通常どおり交互に変化します条件 headerColor 設定されている場合は、このフィールドが優先されます。

firstBandColor
(deprecated)

object (Color)

交互になる 1 つ目の色です。(必須)非推奨: 使用 firstBandColorStyle

firstBandColorStyle

object (ColorStyle)

交互になる 1 つ目の色です。(必須)次の場合 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

シート上の行または列の間隔を区切るグループ。他のグループに含めることも、他のグループに含めることもできます。グループは、シート上で 1 つのユニットとして折りたたんだり展開したりできます。

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

object (DimensionRange)

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

depth

integer

グループの深度。このグループの範囲全体を含む範囲を持つグループの数を表します。

collapsed

boolean

このフィールドは、このグループが折りたたまれている場合に true になります。浅い階層で重複するグループを展開すると、閉じたグループは閉じたままになります。

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

スライサー

シート内のスライサー。

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