行動數據
特定儲存格的相關資料。
JSON 表示法 |
---|
{ "userEnteredValue": { object ( |
欄位 | |
---|---|
userEnteredValue
|
使用者輸入的儲存格值,例如:
|
effectiveValue
|
儲存格的有效值。如果是內含公式的儲存格,這就是計算值。如果是有常值的儲存格,這與 userEnteredValue 相同。這是唯讀欄位。 |
formattedValue
|
儲存格的格式化值。此為向使用者顯示的值。這是唯讀欄位。 |
userEnteredFormat
|
使用者輸入的儲存格格式。 編寫時,新格式會與現有格式合併。 |
effectiveFormat
|
儲存格目前使用的格式。這包括套用任何條件式格式設定的結果,如果儲存格包含公式,計算結果的數字格式就會發生。如果預設格式是預設格式,系統就不會撰寫有效格式。這是唯讀欄位。 |
hyperlink
|
這個儲存格的超連結 (如果有的話)。如果儲存格含有多個超連結,這個欄位就會空白。這是唯讀欄位。如要設定,請在 |
note
|
儲存格中的任何附註。 |
textFormatRuns[]
|
將 RTF 格式套用至儲存格的子區段。執行作業僅適用於使用者輸入的字串,不適用於公式、布林值或數字。執行作業的屬性會從文字中的特定索引開始,直到下次執行為止。執行作業會繼承儲存格的屬性,除非明確進行變更。
編寫時,新的執行作業會覆寫所有先前執行的內容。編寫新的 |
dataValidation
|
儲存格中的資料驗證規則 (如果有的話)。 寫入時,新的資料驗證規則將覆寫所有先前的規則。 |
pivotTable
|
錨定於此儲存格的資料透視表。資料透視表本身的大小,是根據資料、分組、篩選器、值等動態計算。只有資料透視表的左上角儲存格包含資料透視表的定義,其他儲存格的 |
dataSourceTable
|
錨定於這個儲存格的資料來源表。資料來源資料表的大小會根據設定而動態計算。只有資料來源表格的第一個儲存格包含資料來源資料表定義。其他儲存格的資料來源則是 |
dataSourceFormula
|
僅供輸出。儲存格上的資料來源公式相關資訊。如果 |
儲存格格式
儲存格的格式。
JSON 表示法 |
---|
{ "numberFormat": { object ( |
欄位 | |
---|---|
numberFormat
|
這個格式會說明系統應如何呈現數值值。 |
backgroundColor
|
儲存格的背景顏色。已淘汰:使用 |
backgroundColorStyle
|
儲存格的背景顏色。如果同時設定了 |
borders
|
儲存格邊框。 |
padding
|
儲存格邊框間距。 |
horizontalAlignment
|
儲存格中值的水平對齊。 |
verticalAlignment
|
儲存格中的垂直對齊方式。 |
wrapStrategy
|
儲存格中值的換行策略。 |
textDirection
|
儲存格中的文字方向。 |
textFormat
|
儲存格中的文字格式 (除非在格式執行作業遭到覆寫)。在這裡設定儲存格層級連結會清除儲存格現有的連結。在 |
hyperlinkDisplayType
|
如果確實存在,則應該如何在儲存格中顯示超連結。 |
textRotation
|
已為儲存格中的文字套用旋轉設定。 |
數字格式
儲存格的數字格式。
JSON 表示法 |
---|
{
"type": enum (
|
欄位 | |
---|---|
type
|
數字格式的類型。寫入時,必須設定這個欄位。 |
pattern
|
用於格式設定的模式字串。如未設定,系統會依使用者的語言代碼套用預設模式。如要進一步瞭解支援的模式,請參閱日期和數字格式指南。 |
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 ( |
欄位 | |
---|---|
top
|
儲存格頂端框線。 |
bottom
|
儲存格底部框線。 |
left
|
儲存格左側框線。 |
right
|
儲存格右側框線。 |
框線
儲存格周圍的邊框。
JSON 表示法 |
---|
{ "style": enum ( |
欄位 | |
---|---|
style
|
框線的樣式。 |
width
|
框線的寬度 (以像素為單位)。已淘汰;寬度取決於「樣式」欄位。 |
color
|
框線的顏色。已淘汰:使用 |
colorStyle
|
框線的顏色。如果同時設定了 |
樣式
框線的樣式。
列舉 | |
---|---|
STYLE_UNSPECIFIED
|
未指定樣式。請勿使用。 |
DOTTED
|
加上框線。 |
DASHED
|
框線為虛線。 |
SOLID
|
框線是細實線。 |
SOLID_MEDIUM
|
框線是中實線。 |
SOLID_THICK
|
框線是粗實線。 |
NONE
|
無邊框。只有在更新邊框採用以清除邊框時才能使用。 |
DOUBLE
|
框線是兩條實線。 |
邊框間距
儲存格周圍的邊框間距 (以像素為單位)。更新邊框間距時,必須指定每個欄位。
JSON 表示法 |
---|
{ "top": integer, "right": integer, "bottom": integer, "left": integer } |
欄位 | |
---|---|
top
|
儲存格頂端邊框間距。 |
right
|
儲存格右側邊框間距。 |
bottom
|
儲存格底部邊框間距。 |
left
|
儲存格左側邊框間距。 |
VerticalAlign
儲存格文字的垂直對齊方式。
列舉 | |
---|---|
VERTICAL_ALIGN_UNSPECIFIED
|
未指定垂直對齊。請勿使用。 |
TOP
|
文字與儲存格頂端明確對齊。 |
MIDDLE
|
文字與儲存格中央對齊。 |
BOTTOM
|
文字與儲存格底部明確對齊。 |
WrapStrategy
如何在儲存格中換行。
列舉 | |
---|---|
WRAP_STRATEGY_UNSPECIFIED
|
預設值,不使用。 |
OVERFLOW_CELL
|
只要儲存格的長度超過儲存格寬度,系統就會在下一個儲存格中寫入對應的行,但前提是該儲存格為空白。如果下一個儲存格不是空白,行為就會與
|
LEGACY_WRAP
|
這項包裝策略代表舊版 Google 試算表換行策略,系統會將長度超過特定單字 (而不是換行) 換掉的字詞。這項策略適用於所有平台,而且會遭到淘汰。範例:
|
CLIP
|
長度超過儲存格寬度的行會遭到裁剪。除非使用者手動插入新行,否則系統不會將文字換行到下一行。範例:
|
WRAP
|
長度超過字元的字詞會換行字元,而非裁剪。範例:
|
文字方向
儲存格文字方向。
列舉 | |
---|---|
TEXT_DIRECTION_UNSPECIFIED
|
未指定文字方向。請勿使用。 |
LEFT_TO_RIGHT
|
使用者是由左到右的文字方向。 |
RIGHT_TO_LEFT
|
由右到左的文字方向是由使用者設定。 |
HyperlinkDisplayType
是否明確顯示超連結。如未指定,則超連結。
列舉 | |
---|---|
HYPERLINK_DISPLAY_TYPE_UNSPECIFIED
|
預設值:轉譯超連結。請勿使用。 |
LINKED
|
應明確顯示超連結。 |
PLAIN_TEXT
|
請勿顯示超連結。 |
文字旋轉
將文字旋轉至儲存格中的文字。
JSON 表示法 |
---|
{ // Union field |
欄位 | |
---|---|
聯集欄位 type 。旋轉、垂直或的角度。type 只能是下列其中一個值: |
|
angle
|
標準螢幕方向和所需螢幕方向之間的角度。測量單位為度數。有效值介於 -90 和 90 之間。正角為圓角,負數會朝下角度。 注意:如果是 LTR 文字方向正向角,逆時針方向,RTL 則順時針方向 |
vertical
|
若為 true,文字會從上至下讀取,但個別字元的螢幕方向不會改變。例如:
|
TextFormatRun
文字格式的執行作業。這項執行作業的格式將持續執行,直到下次執行開始時。更新時,必須設定所有欄位。
JSON 表示法 |
---|
{
"startIndex": integer,
"format": {
object (
|
欄位 | |
---|---|
startIndex
|
這項執行作業開始時的零個字元索引,格式為 UTF-16 程式碼單元。 |
format
|
這項執行作業的格式。缺少的值會沿用儲存格的格式。 |
DataValidationRule
資料驗證規則。
JSON 表示法 |
---|
{
"condition": {
object (
|
欄位 | |
---|---|
condition
|
儲存格資料必須符合的條件。 |
inputMessage
|
將資料加入儲存格時,要向使用者顯示的訊息。 |
strict
|
如果無效資料應遭到拒絕,則為 True。 |
showCustomUi
|
如果 UI 會根據條件類型自訂。如果為 true,「清單」條件會顯示下拉式選單。 |
DataSourceTable
資料來源資料表,可讓使用者從 DataSource
將靜態資料表匯入試算表。這在試算表編輯器中也稱為「擷取」。
JSON 表示法 |
---|
{ "dataSourceId": string, "columnSelectionType": enum ( |
欄位 | |
---|---|
dataSourceId
|
資料來源表格的資料來源 ID。 |
columnSelectionType
|
可選取資料來源資料表的資料欄類型。這個變數預設為 |
columns[]
|
為資料來源資料表選取的欄。 |
filterSpecs[]
|
資料來源表格中的篩選器規格。 |
sortSpecs[]
|
排序資料來源表格中的規格。資料來源表格的結果會根據排序規格排序。 |
rowLimit
|
要傳回的資料列數量上限。如果未設定,系統會套用預設限制。如需預設和最大上限,請參閱試算表編輯器。 |
dataExecutionStatus
|
僅供輸出。資料執行狀態。 |
DataSourceTableColumnSelectionType
資料來源表格欄的選取類型。
列舉 | |
---|---|
DATA_SOURCE_TABLE_COLUMN_SELECTION_TYPE_UNSPECIFIED
|
不使用預設的欄選取類型。 |
SELECTED
|
選取 columns 欄位指定的資料欄。 |
SYNC_ALL
|
同步處理資料來源中所有目前和未來的欄。 設定後,資料來源資料表會在重新整理時擷取資料來源中的所有資料欄。 |
DataSourceFormula
資料來源公式。
JSON 表示法 |
---|
{
"dataSourceId": string,
"dataExecutionStatus": {
object (
|
欄位 | |
---|---|
dataSourceId
|
與公式相關聯的資料來源 ID。 |
dataExecutionStatus
|
僅供輸出。資料執行狀態。 |