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)
  }
}
ช่อง
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)

ส่วนของ Rich Text ที่มีผลกับส่วนย่อยของเซลล์ รันไทม์ใช้ได้กับสตริงที่ผู้ใช้ป้อนเท่านั้น ไม่ใช่สูตร บูลีน หรือตัวเลข พร็อพเพอร์ตี้ของรันไทม์เริ่มต้นที่ดัชนีที่เฉพาะเจาะจงในข้อความและดำเนินต่อไปจนถึงรันไทม์ถัดไป การเรียกใช้จะรับค่าคุณสมบัติของเซลล์ เว้นแต่จะมีการเปลี่ยนแปลงอย่างชัดเจน

เมื่อเขียน การเรียกใช้ใหม่จะเขียนทับการเรียกใช้ก่อนหน้า เมื่อเขียนuserEnteredValueใหม่ ระบบจะลบการเรียกใช้ก่อนหน้า

dataValidation

object (DataValidationRule)

กฎการตรวจสอบข้อมูลในเซลล์ (หากมี)

เมื่อเขียน กฎการตรวจสอบข้อมูลใหม่จะเขียนทับกฎก่อนหน้า

pivotTable

object (PivotTable)

ตาราง Pivot ที่ยึดอยู่ที่เซลล์นี้ ระบบจะคํานวณขนาดของตาราง Pivot แบบไดนามิกตามข้อมูล การจัดกลุ่ม ตัวกรอง ค่า ฯลฯ ของตารางนั้น มีเพียงเซลล์ด้านซ้ายบนของตาราง Pivot เท่านั้นที่มีคําจํากัดความของตาราง Pivot เซลล์อื่นๆ จะมีค่าที่คำนวณแล้วของผลลัพธ์ของตาราง Pivot ในช่องของตน 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 แต่รูปแบบจริงจะขึ้นอยู่กับภาษาของสเปรดชีต

Enum
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 ไว้ด้วย ช่องนี้จะมีลำดับความสำคัญเหนือกว่า

รูปแบบ

รูปแบบของเส้นขอบ

Enum
STYLE_UNSPECIFIED ไม่ได้ระบุรูปแบบ อย่าใช้
DOTTED เส้นขอบเป็นจุดๆ
DASHED เส้นขอบเป็นเส้นประ
SOLID เส้นขอบจะเป็นเส้นทึบบาง
SOLID_MEDIUM เส้นขอบเป็นเส้นทึบปานกลาง
SOLID_THICK เส้นขอบเป็นเส้นทึบหนา
NONE ไม่มีเส้นขอบ ใช้เมื่ออัปเดตเส้นขอบเท่านั้นเพื่อลบเส้นขอบ
DOUBLE เส้นขอบเป็นเส้นทึบ 2 เส้น

Padding

ระยะห่างจากขอบรอบเซลล์ในหน่วยพิกเซล เมื่ออัปเดตการเว้นวรรค ต้องระบุทุกช่อง

การแสดง JSON 
{
  "top": integer,
  "right": integer,
  "bottom": integer,
  "left": integer
}
ช่อง
top

integer

ระยะห่างจากขอบด้านบนของเซลล์

right

integer

ระยะห่างจากขอบด้านขวาของเซลล์

bottom

integer

ระยะห่างจากขอบด้านล่างของเซลล์

left

integer

ระยะห่างจากขอบด้านซ้ายของเซลล์

VerticalAlign

การจัดแนวข้อความในแนวตั้งในเซลล์

Enum
VERTICAL_ALIGN_UNSPECIFIED ไม่ได้ระบุการจัดแนวแนวตั้ง อย่าใช้
TOP ข้อความจะจัดแนวกับด้านบนของเซลล์อย่างชัดเจน
MIDDLE ข้อความจะจัดแนวกับตรงกลางของเซลล์อย่างชัดเจน
BOTTOM ข้อความจะจัดแนวกับด้านล่างของเซลล์อย่างชัดเจน

WrapStrategy

วิธีตัดข้อความในเซลล์

Enum
WRAP_STRATEGY_UNSPECIFIED ค่าเริ่มต้น อย่าใช้
OVERFLOW_CELL

ระบบจะเขียนบรรทัดที่ยาวกว่าความกว้างของเซลล์ในเซลล์ถัดไป ตราบใดที่เซลล์นั้นว่างเปล่า หากเซลล์ถัดไปไม่ว่างเปล่า การดำเนินการนี้จะทำงานเหมือนกับ CLIP ข้อความจะไม่ตัดขึ้นบรรทัดถัดไป เว้นแต่ผู้ใช้จะแทรกบรรทัดใหม่ด้วยตนเอง ตัวอย่าง 

| First sentence. |
| Manual newline that is very long. <- Text continues into next cell
| Next newline.   |
LEGACY_WRAP

กลยุทธ์การขึ้นบรรทัดใหม่นี้แสดงถึงกลยุทธ์การขึ้นบรรทัดใหม่ของ Google ชีตแบบเก่าที่จะตัดคำที่ยาวกว่า 1 บรรทัดแทนการแบ่งคำ แพลตฟอร์มบางแพลตฟอร์มไม่รองรับกลยุทธ์นี้และเรากําลังเลิกใช้งานกลยุทธ์นี้ ตัวอย่าง 

| 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

ทิศทางของข้อความในเซลล์

Enum
TEXT_DIRECTION_UNSPECIFIED ไม่ได้ระบุทิศทางของข้อความ อย่าใช้รายการนี้
LEFT_TO_RIGHT ผู้ใช้ตั้งค่าทิศทางข้อความจากซ้ายไปขวา
RIGHT_TO_LEFT ผู้ใช้เป็นผู้ตั้งค่าทิศทางข้อความจากขวาไปซ้าย

HyperlinkDisplayType

แสดงผลไฮเปอร์ลิงก์อย่างชัดเจนหรือไม่ หากไม่ระบุ ระบบจะลิงก์ไฮเปอร์ลิงก์

Enum
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

หากเป็น "จริง" ข้อความจะอ่านจากบนลงล่าง แต่การวางแนวของอักขระแต่ละตัวจะไม่เปลี่ยนแปลง เช่น 

| 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

จริงหากควรปฏิเสธข้อมูลที่ไม่ถูกต้อง

showCustomUi

boolean

เป็นจริงหากควรปรับแต่ง UI โดยอิงตามประเภทของเงื่อนไข หากเป็น "จริง" เงื่อนไข "รายการ" จะแสดงเมนูแบบเลื่อนลง

DataSourceTable

ตารางแหล่งข้อมูล ซึ่งช่วยให้ผู้ใช้นําเข้าตารางข้อมูลแบบคงที่จาก DataSource ลงในชีตได้ หรือเรียกอีกอย่างว่า "ดึงข้อมูล" ในเครื่องมือแก้ไขชีต

การแสดง JSON 
{
  "dataSourceId": string,
  "columnSelectionType": enum (DataSourceTableColumnSelectionType),
  "columns": [
    {
      object (DataSourceColumnReference)
    }
  ],
  "filterSpecs": [
    {
      object (FilterSpec)
    }
  ],
  "sortSpecs": [
    {
      object (SortSpec)
    }
  ],
  "rowLimit": integer,
  "dataExecutionStatus": {
    object (DataExecutionStatus)
  }
}
ช่อง
dataSourceId

string

รหัสของแหล่งข้อมูลที่เชื่อมโยงกับตารางแหล่งข้อมูล

columnSelectionType

enum (DataSourceTableColumnSelectionType)

ประเภทที่จะเลือกคอลัมน์สําหรับตารางแหล่งข้อมูล ค่าเริ่มต้นคือ SELECTED

columns[]

object (DataSourceColumnReference)

คอลัมน์ที่เลือกสําหรับตารางแหล่งข้อมูล columnSelectionType ต้องมีค่าเป็น SELECTED

filterSpecs[]

object (FilterSpec)

กรองข้อกําหนดในตารางแหล่งข้อมูล

sortSpecs[]

object (SortSpec)

จัดเรียงข้อกําหนดในตารางแหล่งข้อมูล ผลลัพธ์ของตารางแหล่งข้อมูลจะจัดเรียงตามข้อกําหนดการจัดเรียงตามลําดับ

rowLimit

integer

จำนวนแถวสูงสุดที่จะแสดง หากไม่ได้ตั้งค่า ระบบจะใช้ขีดจำกัดเริ่มต้น โปรดดูขีดจำกัดเริ่มต้นและขีดจำกัดสูงสุดจากเครื่องมือแก้ไขชีต

dataExecutionStatus

object (DataExecutionStatus)

เอาต์พุตเท่านั้น สถานะการเรียกใช้ข้อมูล

DataSourceTableColumnSelectionType

ประเภทการเลือกคอลัมน์ตารางแหล่งข้อมูล

Enum
DATA_SOURCE_TABLE_COLUMN_SELECTION_TYPE_UNSPECIFIED ประเภทการเลือกคอลัมน์เริ่มต้น อย่าใช้
SELECTED เลือกคอลัมน์ที่ระบุโดยฟิลด์ columns
SYNC_ALL

ซิงค์คอลัมน์ปัจจุบันและอนาคตทั้งหมดในแหล่งข้อมูล

หากตั้งค่าไว้ ตารางแหล่งข้อมูลจะดึงข้อมูลคอลัมน์ทั้งหมดในแหล่งข้อมูล ณ เวลาที่มีการรีเฟรช

DataSourceFormula

สูตรแหล่งข้อมูล

การแสดง JSON 
{
  "dataSourceId": string,
  "dataExecutionStatus": {
    object (DataExecutionStatus)
  }
}
ช่อง
dataSourceId

string

รหัสของแหล่งข้อมูลที่สูตรเชื่อมโยงอยู่

dataExecutionStatus

object (DataExecutionStatus)

เอาต์พุตเท่านั้น สถานะการเรียกใช้ข้อมูล