Cells

モバイルデータ通信

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

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 形式の double として表されます。

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)

出力のみ。データの実行ステータス。