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() 注: 日付、時刻、日時型は、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

枠線の幅（ピクセル単位）。非推奨。幅は「style」フィールドで指定します。

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 スプレッドシートの折り返し戦略を表します。この戦略はすべてのプラットフォームでサポートされているわけではなく、段階的に廃止されています。例:

| 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 は次のいずれかになります。
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

この実行が開始される 0 ベースの文字インデックス（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 の場合、[リスト] 条件にプルダウンが表示されます。

DataSourceTable

データソース テーブル。ユーザーは 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)

データソース テーブル用に選択した列。columnSelectionType は SELECTED にする必要があります。
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)

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