Cells

object (ExtendedValue)

使用者在儲存格中輸入的值，例如：1234、'Hello' 或 =NOW() 注意：日期、時間和日期時間會以 serial number 格式表示為雙精度。

object (ExtendedValue)

儲存格的有效值。如果是內含公式的儲存格，則為計算值。對於含有文字常量的儲存格，這與 userEnteredValue 相同。此欄位為唯讀欄位。

string

儲存格經過格式化的值。這是向使用者顯示的值。此欄位為唯讀欄位。

object (CellFormat)

使用者為儲存格輸入的格式。

寫入時，新格式會與現有格式合併。

object (CellFormat)

儲存格使用的有效格式。包括套用任何條件式格式設定的結果，以及儲存格含有公式時的計算數字格式。如果有效格式是預設格式，系統就不會寫入有效格式。此欄位為唯讀欄位。

string

這個儲存格所指向的超連結 (如果有)。如果儲存格包含多個超連結，這個欄位會留空。這是唯讀欄位。如要設定此值，請在 userEnteredValue.formulaValue 欄位中使用 =HYPERLINK 公式。您也可以透過 userEnteredFormat.textFormat 欄位設定單元格層級連結。或者，您也可以在跨越整個儲存格的 textFormatRun.format.link 欄位中設定超連結。

string

儲存格上的任何註解。

object (TextFormatRun)

套用至儲存格子區段的 RTF 格式文字。執行作業只適用於使用者輸入的字串，不適用於公式、布林值或數字。一個執行單元屬性會從文字中的特定索引開始，一直持續到下一個執行單元。除非明確變更，否則執行作業會繼承儲存格屬性。

寫入時，新執行作業會覆寫先前的執行作業。寫入新的 userEnteredValue 時，系統會刪除先前的執行作業。

object (DataValidationRule)

儲存格上的資料驗證規則 (如果有)。

寫入時，新資料驗證規則會覆寫先前的任何規則。

object (PivotTable)

錨定在這個儲存格中的資料透視表。資料透視表的大小會根據資料、分組、篩選器、值等動態計算。只有資料透視表的左上方儲存格含有資料透視表定義。其他儲存格會在其 effectiveValue 欄位中，包含資料透視表結果的計算值。

object (DataSourceTable)

錨定在這個儲存格的資料來源表格。資料來源表本身的大小會根據其設定動態計算。只有資料來源工作表的第一個儲存格包含資料來源工作表定義。其他儲存格則會包含資料來源表格結果的顯示值，並顯示在 effectiveValue 欄位中。

object (DataSourceFormula)

僅供輸出。資料格式中的資料來源公式相關資訊。如果 userEnteredValue 是參照某些 DATA_SOURCE 工作表的公式 (例如 =SUM(DataSheet!Column))，系統就會設定此欄位。

object (ChipRun)

(選用步驟) 方塊的執行作業已套用至儲存格子區段。一個 run 的屬性會從文字中的特定索引開始，一直持續到下一個 run。

讀取時，系統會納入所有有標記和無標記的執行階段。未標記的執行階段會顯示空白的 Chip。

寫入時，系統只會納入含有方塊的跑道。包含方塊的執行階段長度為 1，在使用者輸入的文字中以「@」預留位置符號表示。新的執行作業會覆寫先前的執行作業。寫入新的 userEnteredValue 會清除先前的執行作業。

object (NumberFormat)

說明如何向使用者呈現數值的格式。

object (Color)

儲存格的背景顏色。已淘汰：請改用 backgroundColorStyle。

object (ColorStyle)

儲存格的背景顏色。如果同時設定了 backgroundColor，這個欄位的優先順序會高於 backgroundColor。

object (Borders)

儲存格的邊框。

object (Padding)

儲存格的邊框間距。

enum (HorizontalAlign)

儲存格中值的水平對齊方式。

enum (VerticalAlign)

儲存格中值的垂直對齊方式。

enum (WrapStrategy)

儲存格中值的包裝策略。

enum (TextDirection)

儲存格中文字的方向。

object (TextFormat)

儲存格中的文字格式 (除非已由格式執行作業覆寫)。在此設定儲存格層級連結時，系統會清除儲存格現有的連結。在 TextFormatRun 中設定連結欄位時，其優先順序高於單元格層級連結。

enum (HyperlinkDisplayType)

如果有，則應如何在儲存格中顯示超連結。

object (TextRotation)

套用至儲存格文字的旋轉角度。

enum (NumberFormatType)

數字格式的類型。寫入時，必須設定這個欄位。

string

用於格式設定的模式字串。如果未設定，系統會根據使用者的語言代碼，為指定類型使用必要的預設模式。如要進一步瞭解支援的模式，請參閱日期和數字格式指南。

object (Border)

儲存格的上框線。

object (Border)

儲存格的底部邊框。

object (Border)

儲存格左框線。

object (Border)

儲存格的右框線。

enum (Style)

邊框的樣式。

integer

邊框的寬度，以像素為單位。已淘汰；寬度由「style」欄位決定。

object (Color)

邊框的顏色。已淘汰：請改用 colorStyle。

object (ColorStyle)

邊框的顏色。如果同時設定了 color，這個欄位的優先順序會高於 color。

integer

儲存格頂端的邊距。

integer

儲存格右邊的邊距。

integer

儲存格底部邊距。

integer

儲存格左邊的邊框間距。

integer

標準方向和所需方向之間的角度。以度為單位。有效值介於 -90 和 90 之間。正角度向上，負角度向下。

注意：對於從左到右的文字方向，正角度為逆時針方向，而對於從右到左的文字方向，正角度則為順時針方向。

boolean

如果為 true，文字會從上到下顯示，但個別字元的方向不會改變。例如：

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

integer

以 UTF-16 碼元表示的，此執行作業的起始位置 (以 0 為基底的字元索引)。

object (TextFormat)

這次執行作業的格式。缺少值會繼承儲存格的格式。

object (BooleanCondition)

儲存格中資料必須相符的條件。

string

在使用者將資料新增至儲存格時顯示的訊息。

boolean

如果應拒絕無效資料，則為 True。

boolean

如果應根據條件類型自訂 UI，則為「是」。如果為 true，則「清單」條件會顯示下拉式選單。

string

資料來源表所關聯的資料來源 ID。

enum (DataSourceTableColumnSelectionType)

用於選取資料來源資料表資料欄的類型。預設值為 SELECTED。

object (DataSourceColumnReference)

為資料來源表格選取的資料欄。columnSelectionType 必須為 SELECTED。

object (FilterSpec)

資料來源表中的篩選器規格。

object (SortSpec)

資料來源表中的排序規格。資料來源表格的結果會依照排序規格依序排序。

integer

要傳回的資料列數量上限。如果未設定，系統會套用預設限制。如要瞭解預設和最大限制，請參閱 Google 試算表編輯器。

object (DataExecutionStatus)

僅供輸出。資料執行狀態。

string

公式相關聯的資料來源 ID。

object (DataExecutionStatus)

僅供輸出。資料執行狀態。

integer

必要欄位。以 UTF-16 碼元表示的，此執行作業的起始位置 (以 0 為基底的字元索引)。

object (Chip)

(選用步驟) 這個執行作業的晶片。

object (PersonProperties)

已連結人員的屬性。

object (RichLinkProperties)

多媒體連結的屬性。

string

必要欄位。與此使用者連結的電子郵件地址。這個欄位一律會出現。

enum (DisplayFormat)

(選用步驟) 人員方塊的顯示格式。如未設定，系統會使用預設的顯示格式。

string

必要欄位。連結的 URI。這個值一律會存在。

string

僅供輸出。連結的 MIME 類型 (如果有)，例如 Google 雲端硬碟中的檔案。