Cells

{
  "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)
  }
}

object (ExtendedValue)

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

object (ExtendedValue)

儲存格的有效值。對於含有公式的儲存格，這是計算值。對於含有文字的儲存格，這與 userEnteredValue 相同。這是唯讀欄位。

string

儲存格的格式化值。這是使用者看到的值。這是唯讀欄位。

object (CellFormat)

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

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

object (CellFormat)

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

string

這個儲存格的超連結 (如有)。如果儲存格含有多個超連結，則這個欄位會留空。這是唯讀欄位。如要設定，請使用 =HYPERLINK 加入 userEnteredValue.formulaValue ] 欄位。您也可以在儲存格層級設定儲存格層級連結 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)。

{
  "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)
  }
}

object (NumberFormat)

說明應以何種方式向使用者顯示數字值的格式。

object (Color)

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

object (ColorStyle)

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

object (Borders)

儲存格的框線。

object (Padding)

儲存格的邊框間距。

enum (HorizontalAlign)

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

enum (VerticalAlign)

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

enum (WrapStrategy)

儲存格中值的包裝策略。

enum (TextDirection)

儲存格中的文字方向。

object (TextFormat)

儲存格中的文字格式 (除非是採用格式覆寫)。在這裡設定儲存格層級連結會清除儲存格現有的連結。在 TextFormatRun 的優先順序高於儲存格層級連結。

enum (HyperlinkDisplayType)

超連結在儲存格中的顯示方式 (如果有的話)。

object (TextRotation)

所選文字的旋轉角度會套用至儲存格中的文字。

{
  "type": enum (NumberFormatType),
  "pattern": string
}

enum (NumberFormatType)

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

string

用於格式化的模式字串。如果未設定，系統就會視需要使用根據使用者語言代碼建立的預設模式 (適用於指定類型)。詳情請參閱 日期和數字格式指南 參閱相關文章，進一步瞭解支援的模式。

{
  "top": {
    object (Border)
  },
  "bottom": {
    object (Border)
  },
  "left": {
    object (Border)
  },
  "right": {
    object (Border)
  }
}

object (Border)

儲存格的上框線。

object (Border)

儲存格的下框線。

object (Border)

儲存格的左框線。

object (Border)

儲存格的右側框線。

{
  "style": enum (Style),
  "width": integer,
  "color": {
    object (Color)
  },
  "colorStyle": {
    object (ColorStyle)
  }
}

enum (Style)

邊框的樣式。

integer

邊框的寬度 (以像素為單位)。已淘汰；寬度取決於「樣式」] 欄位。

object (Color)

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

object (ColorStyle)

邊框的顏色。如果 color 也會設定這個欄位，這個欄位的優先順序最高。

{
  "top": integer,
  "right": integer,
  "bottom": integer,
  "left": integer
}

integer

儲存格的上邊框間距。

integer

儲存格的右側邊框間距。

integer

儲存格的底部邊框間距。

integer

儲存格的左側邊框間距。

{

  // Union field type can be only one of the following:
  "angle": integer,
  "vertical": boolean
  // End of list of possible types for union field type.
}

integer

標準方向與所需螢幕方向之間的角度。以度為單位的測量結果。有效值介於 -90 到 90 之間。正角度向上傾斜。

注意：如果 LTR 文字方向正角為逆時針方向，則 RTL 會按順時針方向移動。

boolean

設為 true 時，文字會由上到下顯示，但個別字元的方向則維持不變。例如：

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

{
  "startIndex": integer,
  "format": {
    object (TextFormat)
  }
}

integer

此執行作業從零開始的字元索引，以 UTF-16 程式碼單位表示。

object (TextFormat)

這項執行作業的格式。未提供的值會沿用儲存格的格式。

{
  "condition": {
    object (BooleanCondition)
  },
  "inputMessage": string,
  "strict": boolean,
  "showCustomUi": boolean
}

object (BooleanCondition)

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

string

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

boolean

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

boolean

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

{
  "dataSourceId": string,
  "columnSelectionType": enum (DataSourceTableColumnSelectionType),
  "columns": [
    {
      object (DataSourceColumnReference)
    }
  ],
  "filterSpecs": [
    {
      object (FilterSpec)
    }
  ],
  "sortSpecs": [
    {
      object (SortSpec)
    }
  ],
  "rowLimit": integer,
  "dataExecutionStatus": {
    object (DataExecutionStatus)
  }
}

string

與資料來源資料表相關聯的資料來源 ID。

enum (DataSourceTableColumnSelectionType)

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

object (DataSourceColumnReference)

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

object (FilterSpec)

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

object (SortSpec)

排序資料來源表格中的規格。資料來源表格的結果是按照排序規格排序。

integer

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

object (DataExecutionStatus)

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

{
  "dataSourceId": string,
  "dataExecutionStatus": {
    object (DataExecutionStatus)
  }
}

string

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

object (DataExecutionStatus)

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