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)
  },
  "chipRuns": [
    {
      object (ChipRun)
    }
  ]
}
フィールド
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) など）を参照する数式である場合、このフィールドが設定されます。
chipRuns[]

object (ChipRun)

省略可。セルのサブセクションに適用されるチップの実行。実行のプロパティは、テキスト内の特定のインデックスから始まり、次の実行まで続きます。

読み取り時には、チップありとチップなしのすべてのランが含まれます。チップなしの実行では、Chip は空になります。

書き込み時には、チップが付いたランのみが含まれます。チップを含むランは長さが 1 で、ユーザーが入力したテキストでは「@」プレースホルダ記号で表されます。新しい実行は、以前の実行を上書きします。新しい userEnteredValue を書き込むと、以前の実行が消去されます。

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

行よりも長い単語は、切り捨てられるのではなく、文字単位で折り返されます。例:

| 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)

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

ChipRun

チップの製造ロット。チップは、次の実行の開始インデックスまで続行します。

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

integer

必須。この実行が開始される 0 ベースの文字インデックス（UTF-16 コード単位）。
chip

object (Chip)

省略可。この実行のチップ。

チップ

スマートチップ。

JSON 表現 
{

  // Union field properties can be only one of the following:
  "personProperties": {
    object (PersonProperties)
  },
  "richLinkProperties": {
    object (RichLinkProperties)
  }
  // End of list of possible types for union field properties.
}
フィールド
共用体フィールド properties。チップのプロパティ。properties は次のいずれかになります。
personProperties

object (PersonProperties)

リンクされた人物のプロパティ。

PersonProperties

リンクされた人物に固有のプロパティ。

JSON 表現 
{
  "email": string,
  "displayFormat": enum (DisplayFormat)
}
フィールド
email

string

必須。このユーザーに関連付けられているメールアドレス。このフィールドは常に存在します。

displayFormat

enum (DisplayFormat)

省略可。ユーザーチップの表示形式。設定されていない場合は、デフォルトの表示形式が使用されます。

DisplayFormat

利用可能な場合、優先される表示形式。

列挙型
DISPLAY_FORMAT_UNSPECIFIED デフォルト値。使用しないでください。
DEFAULT デフォルトの表示形式。
LAST_NAME_COMMA_FIRST_NAME 姓と名の表示形式。
EMAIL メールの表示形式。

RichLinkProperties

Google リソース（ドライブ内のファイル、YouTube 動画、マップの住所、カレンダーの予定など）へのリンクのプロパティ。チップとして書き込めるのは、ドライブ ファイルのみです。他のリッチリンク タイプはすべて読み取り専用です。

書き込み時の URI は 2,000 バイトを超えないようにしてください。

注: ドライブ ファイル チップを書き込むには、drive.file、drive.readonly、drive のいずれかの OAuth スコープが必要です。

JSON 表現 
{
  "uri": string,
  "mimeType": string
}
フィールド
uri

string

必須。リンクの URI。これは常に存在します。
mimeType

string

出力専用。リンクの MIME タイプ（ドライブ内のファイルの場合など）。