CellData
ข้อมูลเกี่ยวกับเซลล์ที่ต้องการ
การแสดง JSON |
---|
{ "userEnteredValue": { object ( |
ช่อง | |
---|---|
userEnteredValue
|
ค่าที่ผู้ใช้ป้อนในเซลล์ เช่น
|
effectiveValue
|
ค่าที่มีผลของเซลล์ สำหรับเซลล์ที่มีสูตร ค่านี้จะเป็นค่าที่คำนวณ สำหรับเซลล์ที่มีลิเทอรัล ค่านี้จะเหมือนกับ userEnteredValue ช่องนี้เป็นแบบอ่านอย่างเดียว |
formattedValue
|
ค่าที่จัดรูปแบบของเซลล์ ค่านี้คือค่าตามที่แสดงให้ผู้ใช้เห็น ช่องนี้เป็นแบบอ่านอย่างเดียว |
userEnteredFormat
|
รูปแบบที่ผู้ใช้ป้อนในเซลล์ เมื่อเขียน รูปแบบใหม่จะรวมเข้ากับรูปแบบที่มีอยู่ |
effectiveFormat
|
รูปแบบที่มีประสิทธิภาพที่เซลล์ใช้ ซึ่งรวมถึงผลลัพธ์ของการใช้การจัดรูปแบบตามเงื่อนไข และถ้าเซลล์มีสูตร ก็จะใช้รูปแบบตัวเลขที่คำนวณได้ หากรูปแบบที่มีประสิทธิภาพเป็นรูปแบบเริ่มต้น จะไม่มีการเขียนรูปแบบที่มีประสิทธิภาพ ช่องนี้เป็นแบบอ่านอย่างเดียว |
hyperlink
|
ไฮเปอร์ลิงก์ที่เซลล์นี้จะชี้ไป หากมี หากเซลล์มีไฮเปอร์ลิงก์หลายรายการ ช่องนี้จะว่างเปล่า ช่องนี้เป็นแบบอ่านอย่างเดียว หากต้องการตั้งค่า ให้ใช้
|
note
|
หมายเหตุใดๆ ในเซลล์ |
textFormatRuns[]
|
การเรียกใช้ Rich Text ที่ใช้กับส่วนย่อยของเซลล์ การเรียกใช้จะใช้ได้กับสตริงที่ผู้ใช้ป้อนเท่านั้น ไม่ใช่สูตร บูล หรือหมายเลข คุณสมบัติของการเรียกใช้จะเริ่มต้นที่ดัชนีที่ระบุในข้อความ และดำเนินการต่อไปจนกระทั่งถึงการเรียกใช้ครั้งถัดไป การเรียกใช้จะรับค่าคุณสมบัติของเซลล์ เว้นแต่จะมีการเปลี่ยนแปลงอย่างชัดเจน
เมื่อเขียน การเรียกใช้ใหม่จะเขียนทับการเรียกใช้ก่อนหน้า เมื่อเขียน
|
dataValidation
|
กฎการตรวจสอบข้อมูลในเซลล์ หากมี ขณะเขียน กฎการตรวจสอบข้อมูลใหม่จะเขียนทับกฎใดก็ตามก่อนหน้านี้ |
pivotTable
|
ตาราง Pivot ที่ตรึงอยู่ที่เซลล์นี้ ขนาดของตาราง Pivot จะคำนวณแบบไดนามิกตามข้อมูล การจัดกลุ่ม ตัวกรอง ค่า ฯลฯ เฉพาะเซลล์ด้านบนซ้ายของตาราง Pivot เท่านั้นที่มีคำจำกัดความของตาราง Pivot เซลล์อื่นจะมีค่าที่คำนวณได้ของผลลัพธ์ของ Pivot ในเซลล์
|
dataSourceTable
|
ตารางแหล่งข้อมูลที่ตรึงอยู่ที่เซลล์นี้ ขนาดของตารางแหล่งข้อมูลจะคำนวณแบบไดนามิกตามการกำหนดค่า เฉพาะเซลล์แรกของตารางแหล่งข้อมูลเท่านั้นที่มีคำจำกัดความของตารางแหล่งข้อมูล เซลล์อื่นจะมีค่าที่แสดงของตารางแหล่งข้อมูลผลลัพธ์ใน
|
dataSourceFormula
|
เอาต์พุตเท่านั้น ข้อมูลเกี่ยวกับสูตรแหล่งข้อมูลในเซลล์ ช่องนี้จะมีการตั้งค่าหาก
|
CellFormat
รูปแบบของเซลล์
การแสดง JSON |
---|
{ "numberFormat": { object ( |
ช่อง | |
---|---|
numberFormat
|
รูปแบบที่อธิบายวิธีแสดงค่าตัวเลขต่อผู้ใช้ |
backgroundColor
|
สีพื้นหลังของเซลล์ เลิกใช้งานแล้ว: ใช้
|
backgroundColorStyle
|
สีพื้นหลังของเซลล์ ถ้า
|
borders
|
เส้นขอบของเซลล์ |
padding
|
ระยะห่างจากขอบของเซลล์ |
horizontalAlignment
|
การจัดแนวแนวนอนของค่าในเซลล์ |
verticalAlignment
|
การจัดแนวตามแนวตั้งของค่าในเซลล์ |
wrapStrategy
|
กลยุทธ์การรวมสำหรับค่าในเซลล์ |
textDirection
|
ทิศทางของข้อความในเซลล์ |
textFormat
|
รูปแบบของข้อความในเซลล์ (เว้นแต่จะมีการลบล้างโดยการเรียกใช้รูปแบบ) การตั้งค่าลิงก์ระดับเซลล์ที่นี่จะล้างลิงก์ที่มีอยู่ของเซลล์ การตั้งค่าฟิลด์ลิงก์ใน
|
hyperlinkDisplayType
|
หากมี ไฮเปอร์ลิงก์ควรแสดงในเซลล์อย่างไร |
textRotation
|
ใช้การหมุนกับข้อความในเซลล์ |
NumberFormat
รูปแบบตัวเลขของเซลล์
การแสดง JSON |
---|
{
"type": enum (
|
ช่อง | |
---|---|
type
|
ประเภทของรูปแบบตัวเลข ขณะเขียน ต้องตั้งค่าฟิลด์นี้ |
pattern
|
สตริงรูปแบบที่ใช้สำหรับการจัดรูปแบบ หากไม่ได้ตั้งค่า ระบบจะใช้รูปแบบเริ่มต้นตามภาษาของผู้ใช้ (หากจำเป็น) สำหรับประเภทที่ระบุ โปรดดู คู่มือรูปแบบวันที่และตัวเลข เพื่อดูข้อมูลเพิ่มเติมเกี่ยวกับรูปแบบที่รองรับ |
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 ( |
ช่อง | |
---|---|
top
|
เส้นขอบด้านบนของเซลล์ |
bottom
|
เส้นขอบด้านล่างของเซลล์ |
left
|
เส้นขอบด้านซ้ายของเซลล์ |
right
|
เส้นขอบด้านขวาของเซลล์ |
บอร์เดอร์
เส้นขอบภายในเซลล์
การแสดง JSON |
---|
{ "style": enum ( |
ช่อง | |
---|---|
style
|
รูปแบบของเส้นขอบ |
width
|
ความกว้างของเส้นขอบในหน่วยพิกเซล เลิกใช้งาน; ความกว้างจะกำหนดโดย "สไตล์" ด้วย |
color
|
สีของเส้นขอบ เลิกใช้งานแล้ว: ใช้
|
colorStyle
|
สีของเส้นขอบ ถ้า
|
รูปแบบ
รูปแบบของเส้นขอบ
Enum | |
---|---|
STYLE_UNSPECIFIED
|
ไม่ได้ระบุรูปแบบ อย่าใช้รายการนี้ |
DOTTED
|
เส้นขอบเป็นเส้นประ |
DASHED
|
เส้นขอบเป็นเส้นประ |
SOLID
|
เส้นขอบเป็นเส้นทึบบาง |
SOLID_MEDIUM
|
เส้นขอบเป็นเส้นทึบปานกลาง |
SOLID_THICK
|
เส้นขอบเป็นเส้นทึบหนา |
NONE
|
ไม่มีเส้นขอบ ใช้เมื่ออัปเดตเส้นขอบเท่านั้นเพื่อลบเส้นขอบ |
DOUBLE
|
เส้นขอบเป็นเส้นทึบ 2 เส้น |
Padding
ปริมาณระยะห่างจากขอบรอบเซลล์ในหน่วยพิกเซล เมื่ออัปเดตระยะห่างจากขอบ ต้องระบุทุกฟิลด์
การแสดง JSON |
---|
{ "top": integer, "right": integer, "bottom": integer, "left": integer } |
ช่อง | |
---|---|
top
|
ระยะห่างจากขอบด้านบนของเซลล์ |
right
|
ระยะห่างจากขอบด้านขวาของเซลล์ |
bottom
|
ระยะห่างจากขอบด้านล่างของเซลล์ |
left
|
ระยะห่างจากขอบด้านซ้ายของเซลล์ |
VerticalAlign
การจัดข้อความแนวตั้งในเซลล์
Enum | |
---|---|
VERTICAL_ALIGN_UNSPECIFIED
|
ไม่ได้ระบุการจัดข้อความแนวตั้ง อย่าใช้รายการนี้ |
TOP
|
มีการจัดข้อความไว้ด้านบนของเซลล์อย่างชัดเจน |
MIDDLE
|
มีการจัดข้อความไว้ตรงกลางเซลล์อย่างชัดเจน |
BOTTOM
|
ระบบจะจัดข้อความไว้ที่ด้านล่างของเซลล์อย่างชัดเจน |
WrapStrategy
วิธีตัดข้อความในเซลล์
Enum | |
---|---|
WRAP_STRATEGY_UNSPECIFIED
|
โดยค่าเริ่มต้น โปรดอย่านำไปใช้ |
OVERFLOW_CELL
|
ระบบจะเขียนบรรทัดที่ยาวกว่าความกว้างของเซลล์ไว้ในเซลล์ถัดไป ตราบใดที่เซลล์นั้นว่างเปล่า หากเซลล์ถัดไปไม่ว่างเปล่า ฟังก์ชันจะมีลักษณะเหมือน
|
LEGACY_WRAP
|
กลยุทธ์การรวมนี้แสดงถึงกลยุทธ์การรวม Google ชีตแบบเก่าซึ่งคำที่ยาวกว่าบรรทัดจะถูกตัดออกแทนการตัดให้สั้นลง ระบบไม่รองรับกลยุทธ์นี้ในบางแพลตฟอร์มและเรากำลังจะเลิกใช้กลยุทธ์นี้ ตัวอย่าง
|
CLIP
|
ระบบจะตัดเส้นที่ยาวกว่าความกว้างของเซลล์ออก ข้อความจะไม่ตัดไปไว้ในบรรทัดถัดไป เว้นแต่ผู้ใช้ได้แทรกบรรทัดใหม่ด้วยตนเอง ตัวอย่าง
|
WRAP
|
คำที่ยาวกว่าบรรทัดจะถูกล้อมรอบในระดับอักขระแทนที่จะตัดให้สั้นลง ตัวอย่าง
|
TextDirection
ทิศทางของข้อความในเซลล์
Enum | |
---|---|
TEXT_DIRECTION_UNSPECIFIED
|
ไม่ได้ระบุทิศทางของข้อความ อย่าใช้รายการนี้ |
LEFT_TO_RIGHT
|
ผู้ใช้ตั้งค่าทิศทางข้อความจากซ้ายไปขวา |
RIGHT_TO_LEFT
|
ผู้ใช้ตั้งค่าทิศทางข้อความจากขวาไปซ้าย |
HyperlinkDisplayType
ระบุว่าจะแสดงไฮเปอร์ลิงก์อย่างชัดแจ้งหรือไม่ หากไม่ได้ระบุ ระบบจะลิงก์ไฮเปอร์ลิงก์
Enum | |
---|---|
HYPERLINK_DISPLAY_TYPE_UNSPECIFIED
|
ค่าเริ่มต้น: ไฮเปอร์ลิงก์จะแสดงผล อย่าใช้รายการนี้ |
LINKED
|
ไฮเปอร์ลิงก์ควรแสดงอย่างชัดเจน |
PLAIN_TEXT
|
ไม่ควรแสดงผลไฮเปอร์ลิงก์ |
TextRotation
ใช้การหมุนกับข้อความในเซลล์
การแสดง JSON |
---|
{ // Union field |
ช่อง | |
---|---|
ฟิลด์ Union
type ประเภทของการหมุน แนวตั้ง หรือมุม
type
ต้องเป็นอย่างใดอย่างหนึ่งต่อไปนี้
|
|
angle
|
มุมระหว่างการวางแนวมาตรฐานและการวางแนวที่ต้องการ วัดเป็นองศา ค่าที่ใช้ได้จะอยู่ระหว่าง -90 ถึง 90 มุมบวกจะมุมขึ้น ด้านลบจะมุมลง หมายเหตุ: สำหรับทิศทางข้อความ LTR มุมบวกในทิศทางทวนเข็มนาฬิกา ส่วน RTL จะอยู่ในทิศทางตามเข็มนาฬิกา |
vertical
|
หากจริง ข้อความจะอ่านจากบนลงล่าง แต่การวางแนวของอักขระแต่ละตัวจะไม่เปลี่ยนแปลง เช่น
|
TextFormatRun
การเรียกใช้รูปแบบข้อความ รูปแบบของการเรียกใช้นี้จะดำเนินต่อไปจนถึงดัชนีเริ่มต้นของการเรียกใช้ครั้งถัดไป ต้องตั้งค่าทุกช่องขณะอัปเดต
การแสดง JSON |
---|
{
"startIndex": integer,
"format": {
object (
|
ช่อง | |
---|---|
startIndex
|
ดัชนีอักขระแบบ 0 ที่การเรียกใช้นี้เริ่มต้นในหน่วยโค้ด UTF-16 |
format
|
รูปแบบของการเรียกใช้นี้ ค่าที่ไม่มีอยู่จะรับค่ารูปแบบของเซลล์ |
DataValidationRule
กฎการตรวจสอบข้อมูล
การแสดง JSON |
---|
{
"condition": {
object (
|
ช่อง | |
---|---|
condition
|
เงื่อนไขที่ข้อมูลในเซลล์ต้องตรงกัน |
inputMessage
|
ข้อความที่จะแสดงให้ผู้ใช้เห็นเมื่อเพิ่มข้อมูลในเซลล์ |
strict
|
เป็นจริงหากข้อมูลที่ไม่ถูกต้องควรถูกปฏิเสธ |
showCustomUi
|
เป็นจริงหากควรปรับแต่ง UI ตามประเภทของเงื่อนไข หากเป็นจริง "แสดงรายการ" เงื่อนไขจะแสดงเมนูแบบเลื่อนลง |
DataSourceTable
ตารางแหล่งข้อมูลที่ช่วยให้ผู้ใช้นําเข้าตารางข้อมูลแบบคงที่จาก
DataSource
ลงในชีต วิธีนี้เรียกอีกอย่างว่า "การแตกข้อมูล" ในเครื่องมือแก้ไขชีต
การแสดง JSON |
---|
{ "dataSourceId": string, "columnSelectionType": enum ( |
ช่อง | |
---|---|
dataSourceId
|
รหัสของแหล่งข้อมูลที่เชื่อมโยงกับตารางแหล่งข้อมูล |
columnSelectionType
|
ประเภทสำหรับเลือกคอลัมน์สําหรับตารางแหล่งข้อมูล ค่าเริ่มต้นคือ
|
columns[]
|
คอลัมน์ที่เลือกให้กับตารางแหล่งข้อมูล
|
filterSpecs[]
|
ข้อกำหนดตัวกรองในตารางแหล่งข้อมูล |
sortSpecs[]
|
จัดเรียงข้อกำหนดในตารางแหล่งข้อมูล ผลลัพธ์ของตารางแหล่งข้อมูลจะได้รับการจัดเรียงตามข้อกำหนดในการจัดเรียงตามลำดับ |
rowLimit
|
จำนวนแถวสูงสุดที่จะแสดง หากไม่ได้ตั้งค่า ระบบจะใช้ขีดจำกัดเริ่มต้น โปรดดูขีดจำกัดเริ่มต้นและขีดจำกัดสูงสุดจากเครื่องมือแก้ไขชีต |
dataExecutionStatus
|
เอาต์พุตเท่านั้น สถานะการดำเนินการกับข้อมูล |
DataSourceTableColumnSelectionType
ประเภทการเลือกคอลัมน์ในตารางแหล่งข้อมูล
Enum | |
---|---|
DATA_SOURCE_TABLE_COLUMN_SELECTION_TYPE_UNSPECIFIED
|
ประเภทการเลือกคอลัมน์เริ่มต้น อย่าใช้ |
SELECTED
|
เลือกคอลัมน์ที่ระบุโดย
columns
ด้วย
|
SYNC_ALL
|
ซิงค์คอลัมน์ในปัจจุบันและอนาคตทั้งหมดในแหล่งข้อมูล หากมีการตั้งค่า ตารางแหล่งข้อมูลจะดึงคอลัมน์ทั้งหมดในแหล่งข้อมูลในขณะที่รีเฟรช |
DataSourceFormula
สูตรแหล่งข้อมูล
การแสดง JSON |
---|
{
"dataSourceId": string,
"dataExecutionStatus": {
object (
|
ช่อง | |
---|---|
dataSourceId
|
รหัสแหล่งข้อมูลที่เชื่อมโยงกับสูตร |
dataExecutionStatus
|
เอาต์พุตเท่านั้น สถานะการดำเนินการกับข้อมูล |