Cells

CellData

特定のセルに関するデータ。

JSON 表現
{
  "userEnteredValue": {
    object (ExtendedValue)
  },
  "effectiveValue": {
    object (ExtendedValue)
  },
  "formattedValue": string,
  "userEnteredFormat": {
    object (CellFormat)
  },
  "effectiveFormat": {
    object (CellFormat)
  },
  "hyperlink": string,
  "note": string,
  "textFormatRuns": [
    {
      object (TextFormatRun)
    }
  ],
  "dataValidation": {
    object (DataValidationRule)
  },
  "pivotTable": {
    object (PivotTable)
  },
  "dataSourceTable": {
    object (DataSourceTable)
  },
  "dataSourceFormula": {
    object (DataSourceFormula)
  }
}
フィールド
userEnteredValue

object (ExtendedValue)

ユーザーがセルに入力した値。例: 1234, 'Hello'、または =NOW() 注: Dates、Times、DateTimes は、 serial number 使用できます。

effectiveValue

object (ExtendedValue)

セルの有効な値。数式を含むセルの場合、この値は計算された値です。リテラルを含むセルの場合、これは userEnteredValue と同じです。このフィールドは読み取り専用です。

formattedValue

string

セルの書式設定された値。これは、ユーザーに表示される際の値です。このフィールドは読み取り専用です。

userEnteredFormat

object (CellFormat)

ユーザーがセルに入力した書式。

記述時に、新しい書式が既存の書式と結合されます。

effectiveFormat

object (CellFormat)

セルで使用されている有効な形式。これには、条件付き書式を適用した結果や、セルに数式が含まれている場合に計算された数値形式が含まれます。有効な形式がデフォルトの形式である場合、有効な形式は書き込まれません。このフィールドは読み取り専用です。

note

string

セル上のメモ。

textFormatRuns[]

object (TextFormatRun)

セルのサブセクションに適用されるリッチテキストの実行。実行はユーザーが入力した文字列に対してのみ有効で、数式、ブール値、数値に対しては無効です。実行のプロパティは、テキスト内の特定のインデックスから始まり、次の実行まで続きます。明示的に変更しない限り、実行ではセルのプロパティが継承されます。

書き込み時に、新しい実行によって以前の実行が上書きされます。新規メッセージを書くときは、 userEnteredValue、以前の実行は消去されます。

dataValidation

object (DataValidationRule)

セルのデータ入力規則(存在する場合)。

書き込むと、新しいデータ入力規則によって以前の規則が上書きされます。

pivotTable

object (PivotTable)

このセルに固定されたピボット テーブルです。ピボット テーブル自体のサイズは、データ、グループ化、フィルタ、値などに基づいて動的に計算されます。ピボット テーブルの定義は、ピボット テーブルの左上のセルのみに示されます。他のセルには、ピボットの結果の計算値が、 effectiveValue 表示されます。

dataSourceTable

object (DataSourceTable)

このセルに固定されているデータソース テーブル。データソース テーブル自体のサイズは、その構成に基づいて動的に計算されます。データソース テーブルの定義が含まれるのは、データソース テーブルの最初のセルのみです。その他のセルには、データソース テーブルの結果の表示値が effectiveValue 表示されます。

dataSourceFormula

object (DataSourceFormula)

出力専用。セル上のデータソースの数式に関する情報。次の場合、このフィールドが設定されます。 userEnteredValue 参照する数式です。 DATA_SOURCE できます。例: =SUM(DataSheet!Column)

CellFormat

セルの形式。

JSON 表現
{
  "numberFormat": {
    object (NumberFormat)
  },
  "backgroundColor": {
    object (Color)
  },
  "backgroundColorStyle": {
    object (ColorStyle)
  },
  "borders": {
    object (Borders)
  },
  "padding": {
    object (Padding)
  },
  "horizontalAlignment": enum (HorizontalAlign),
  "verticalAlignment": enum (VerticalAlign),
  "wrapStrategy": enum (WrapStrategy),
  "textDirection": enum (TextDirection),
  "textFormat": {
    object (TextFormat)
  },
  "hyperlinkDisplayType": enum (HyperlinkDisplayType),
  "textRotation": {
    object (TextRotation)
  }
}
フィールド
numberFormat

object (NumberFormat)

ユーザーへの数値値の表現方法を記述する形式。

backgroundColor
(deprecated)

object (Color)

セルの背景色。非推奨: 使用 backgroundColorStyle

backgroundColorStyle

object (ColorStyle)

セルの背景色。条件 backgroundColor 設定されている場合は、このフィールドが優先されます。

borders

object (Borders)

セルの枠線。

padding

object (Padding)

セルのパディング。

horizontalAlignment

enum (HorizontalAlign)

セル内の値の水平方向の配置。

verticalAlignment

enum (VerticalAlign)

セル内の値の垂直方向の配置。

wrapStrategy

enum (WrapStrategy)

セル内の値の折り返し方法。

textDirection

enum (TextDirection)

セル内のテキストの向き。

textFormat

object (TextFormat)

セル内のテキストの書式(書式によってオーバーライドされた場合を除く)。ここでセルレベルのリンクを設定すると、セルの既存のリンクが消去されます。リンクフィールドの設定 TextFormatRun セルレベルのリンクよりも優先されます。

textRotation

object (TextRotation)

セル内のテキストに適用される回転。

NumberFormat

セルの数値形式。

JSON 表現
{
  "type": enum (NumberFormatType),
  "pattern": string
}
フィールド
type

enum (NumberFormatType)

数値形式の型。書き込み時は、このフィールドを設定する必要があります。

pattern

string

書式設定に使用されるパターン文字列。設定しない場合、指定されたタイプで必要に応じて、ユーザーの言語 / 地域に基づくデフォルトのパターンが使用されます。詳しくは、 日付と数値の形式に関するガイド をご覧ください。

NumberFormatType

セルの数値形式。このドキュメントでは言語 / 地域を en_US と想定していますが、実際の形式はスプレッドシートの言語 / 地域によって異なります。

列挙型
NUMBER_FORMAT_TYPE_UNSPECIFIED 数値形式は指定されておらず、セルの内容に基づきます。これは明示的に使用しないでください。
TEXT テキストの書式設定。例: 1000.12
NUMBER 数値形式、例: 1,000.12
PERCENT パーセントの形式。例: 10.12%
CURRENCY 通貨の形式(例: $1,000.12
DATE 日付形式(例: 9/26/2008
TIME 時刻の書式設定(例: 3:59:00 PM
DATE_TIME 日時形式(例: 9/26/08 15:59:00
SCIENTIFIC 指数形式(例: 1.01E+03

枠線

セルの枠線。

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

object (Border)

セルの上枠線。

bottom

object (Border)

セルの下枠線。

left

object (Border)

セルの左枠線。

right

object (Border)

セルの右枠線。

枠線

セルの枠線。

JSON 表現
{
  "style": enum (Style),
  "width": integer,
  "color": {
    object (Color)
  },
  "colorStyle": {
    object (ColorStyle)
  }
}
フィールド
style

enum (Style)

枠線のスタイル。

width
(deprecated)

integer

枠線の幅(ピクセル単位)。非推奨、幅は「スタイル」によって表示されます。

color
(deprecated)

object (Color)

枠線の色。非推奨: 使用 colorStyle

colorStyle

object (ColorStyle)

枠線の色。条件 color 設定されている場合は、このフィールドが優先されます。

スタイル

枠線のスタイル。

列挙型
STYLE_UNSPECIFIED スタイルが指定されていません。これは使用しないでください。
DOTTED 枠線は点線で表示されます。
DASHED 枠線は破線で表示されます。
SOLID 枠線は細い実線で表示されます。
SOLID_MEDIUM 枠線は中程度の実線です。
SOLID_THICK 枠線は太い実線で表示されます。
NONE 枠線なし。枠線を消去するために枠線を更新する場合にのみ使用されます。
DOUBLE 枠線は 2 本の実線です。

パディング

セルの周囲のパディング量(ピクセル単位)。パディングを更新するときは、すべてのフィールドを指定する必要があります。

JSON 表現
{
  "top": integer,
  "right": integer,
  "bottom": integer,
  "left": integer
}
フィールド
top

integer

セルの上部のパディング。

right

integer

セルの右側のパディング。

bottom

integer

セルの下のパディング。

left

integer

セルの左側のパディング。

VerticalAlign

セル内のテキストの垂直方向の配置。

列挙型
VERTICAL_ALIGN_UNSPECIFIED 縦方向の配置が指定されていません。これは使用しないでください。
TOP テキストはセルの上部に明示的に配置されます。
MIDDLE テキストはセルの中央に明示的に配置されます。
BOTTOM テキストはセルの下部に明示的に配置されます。

WrapStrategy

セル内のテキストを折り返す方法。

列挙型
WRAP_STRATEGY_UNSPECIFIED デフォルト値。使用しないでください。
OVERFLOW_CELL

セル幅よりも長い行は、そのセルが空である限り、次のセルに書き込まれます。次のセルが空でない場合は、 CLIP。ユーザーが手動で改行を挿入しない限り、テキストが次の行に折り返されることはありません。例:

| First sentence. |
| Manual newline that is very long. <- Text continues into next cell
| Next newline.   |
LEGACY_WRAP

この折り返し戦略は、Google スプレッドシートの従来の折り返し方法を示したもので、1 行より長い単語を折り返すのではなく切り詰めます。この戦略は一部のプラットフォームでサポートされているわけではなく、段階的に廃止されます。例:

| Cell has a |
| loooooooooo| <- Word is clipped.
| word.      |
CLIP

セル幅より長い線は切り詰められます。ユーザーが手動で改行を挿入しない限り、テキストが次の行に折り返されることはありません。例:

| First sentence. |
| Manual newline t| <- Text is clipped
| Next newline.   |
WRAP

1 行より長い単語は、切り詰められるのではなく文字レベルで折り返されます。例:

| Cell has a |
| loooooooooo| <- Word is broken.
| ong word.  |

TextDirection

セル内のテキストの方向。

列挙型
TEXT_DIRECTION_UNSPECIFIED テキストの方向は指定されていません。これは使用しないでください。
LEFT_TO_RIGHT 左から右のテキスト方向はユーザーが設定しました。
RIGHT_TO_LEFT 右から左のテキスト方向はユーザーが設定しました。

HyperlinkDisplayType

ハイパーリンクを明示的にレンダリングするかどうかを指定します。指定しない場合、ハイパーリンクはリンクされます。

列挙型
LINKED ハイパーリンクは明示的にレンダリングする必要があります。
PLAIN_TEXT ハイパーリンクを表示しないでください。

TextRotation

セル内のテキストに適用される回転。

JSON 表現
{

  // Union field type can be only one of the following:
  "angle": integer,
  "vertical": boolean
  // End of list of possible types for union field type.
}
フィールド
共用体フィールド type。回転のタイプ(垂直または角度)。 type は次のいずれか 1 つのみを指定できます。
angle

integer

標準の向きと目的の向きがなす角度。度数で表します。有効な値は -90 ~ 90 です。正の角度は上向き、負の角度は下向きです。

注: LTR テキスト方向の場合、正の角度は反時計回りになりますが、RTL の場合、正の角度は時計回りの方向になります。

vertical

boolean

true の場合、テキストは上から下に読み上げられますが、個々の文字の向きは変わりません。次に例を示します。

| V |
| e |
| r |
| t |
| i |
| c |
| a |
| l |

TextFormatRun

テキスト形式の実行。この実行の形式は、次の実行の開始インデックスまで続きます。更新する場合は、すべてのフィールドを設定する必要があります。

JSON 表現
{
  "startIndex": integer,
  "format": {
    object (TextFormat)
  }
}
フィールド
startIndex

integer

この実行が開始されるゼロベースの文字インデックス(UTF-16 コード単位)。

format

object (TextFormat)

この実行の形式。存在しない値はセルの形式を継承します。

DataValidationRule

データの入力規則。

JSON 表現
{
  "condition": {
    object (BooleanCondition)
  },
  "inputMessage": string,
  "strict": boolean,
  "showCustomUi": boolean
}
フィールド
condition

object (BooleanCondition)

セル内のデータが一致する条件。

inputMessage

string

セルにデータを追加する際にユーザーに表示されるメッセージ。

strict

boolean

無効なデータを拒否する必要がある場合は true に設定します。

showCustomUi

boolean

条件の種類に基づいて UI をカスタマイズする場合は true。true の場合、「List」プルダウンが表示されます

DataSourceTable

データソース テーブル。ユーザーは、BigQuery から静的なデータ テーブルをインポートできます。 DataSource スプレッドシートにインポートします。これは「抽出」とも呼ばれます。。

JSON 表現
{
  "dataSourceId": string,
  "columnSelectionType": enum (DataSourceTableColumnSelectionType),
  "columns": [
    {
      object (DataSourceColumnReference)
    }
  ],
  "filterSpecs": [
    {
      object (FilterSpec)
    }
  ],
  "sortSpecs": [
    {
      object (SortSpec)
    }
  ],
  "rowLimit": integer,
  "dataExecutionStatus": {
    object (DataExecutionStatus)
  }
}
フィールド
dataSourceId

string

データソース テーブルが関連付けられているデータソースの ID。

columnSelectionType

enum (DataSourceTableColumnSelectionType)

データソース テーブルの列を選択する型。デフォルトは SELECTED

columns[]

object (DataSourceColumnReference)

データソース テーブルで選択された列。「 columnSelectionTypeSELECTED

filterSpecs[]

object (FilterSpec)

データソース テーブルのフィルタ仕様。

sortSpecs[]

object (SortSpec)

データソース テーブルの仕様を並べ替える。データソース テーブルの結果は、並べ替えの指定に基づいて順番に並べ替えられます。

rowLimit

integer

返される行の上限。設定しない場合、デフォルトの上限が適用されます。デフォルトと上限については、スプレッドシート エディタをご覧ください。

dataExecutionStatus

object (DataExecutionStatus)

出力専用。データの実行ステータス。

DataSourceTableColumnSelectionType

データソース テーブルの列の選択タイプ。

列挙型
DATA_SOURCE_TABLE_COLUMN_SELECTION_TYPE_UNSPECIFIED デフォルトの列選択タイプです。使用しないでください。
SELECTED 指定した列を選択 columns 表示されます。
SYNC_ALL

データソース内の現在と将来のすべての列を同期します。

設定すると、更新時にデータソース テーブルはデータソース内のすべての列を取得します。

DataSourceFormula

データソースの数式。

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

string

数式が関連付けられているデータソースの ID。

dataExecutionStatus

object (DataExecutionStatus)

出力専用。データの実行ステータス。