CellData
ข้อมูลเกี่ยวกับเซลล์ที่เฉพาะเจาะจง
| การแสดง JSON |
|---|
{ "userEnteredValue": { object ( |
| ช่อง | |
|---|---|
userEnteredValue
|
ค่าที่ผู้ใช้ป้อนในเซลล์ เช่น
|
effectiveValue
|
ค่าที่มีผลของเซลล์ สำหรับเซลล์ที่มีสูตร ค่านี้จะเป็นค่าที่คำนวณแล้ว สำหรับเซลล์ที่มีค่าคงที่ ค่านี้จะเหมือนกับ userEnteredValue ช่องนี้เป็นแบบอ่านอย่างเดียว |
formattedValue
|
ค่าที่จัดรูปแบบของเซลล์ นี่คือค่าที่แสดงต่อผู้ใช้ ช่องนี้เป็นแบบอ่านอย่างเดียว |
userEnteredFormat
|
รูปแบบที่ผู้ใช้ป้อนสำหรับเซลล์ เมื่อเขียน ระบบจะผสานรูปแบบใหม่กับรูปแบบที่มีอยู่ |
effectiveFormat
|
รูปแบบที่มีประสิทธิภาพซึ่งเซลล์ใช้ ซึ่งรวมถึงผลลัพธ์ของการใช้การจัดรูปแบบตามเงื่อนไข และหากเซลล์มีสูตร ก็จะรวมถึงรูปแบบตัวเลขที่คำนวณแล้วด้วย หากรูปแบบที่มีผลเป็นรูปแบบเริ่มต้น ระบบจะไม่เขียนรูปแบบที่มีผล ช่องนี้เป็นแบบอ่านอย่างเดียว |
hyperlink
|
ไฮเปอร์ลิงก์ที่เซลล์นี้ชี้ไป หากมี หากเซลล์มีไฮเปอร์ลิงก์หลายรายการ ฟิลด์นี้จะว่างเปล่า ช่องนี้เป็นแบบอ่านอย่างเดียว หากต้องการตั้งค่า ให้ใช้สูตร
|
note
|
หมายเหตุใดๆ ในเซลล์ |
textFormatRuns[]
|
การเรียกใช้ Rich Text ที่ใช้กับส่วนย่อยของเซลล์ ฟังก์ชันนี้ใช้ได้กับสตริงที่ผู้ใช้ป้อนเท่านั้น ไม่ใช่สูตร บูลีน หรือตัวเลข พร็อพเพอร์ตี้ของการเรียกใช้จะเริ่มต้นที่ดัชนีที่เฉพาะเจาะจงในข้อความและดำเนินการต่อไปจนกว่าจะถึงการเรียกใช้ถัดไป โดยการทำงานจะรับค่าคุณสมบัติของเซลล์มาใช้ เว้นแต่จะมีการเปลี่ยนแปลงอย่างชัดเจน
เมื่อเขียน ระบบจะเขียนทับการเรียกใช้ก่อนหน้าด้วยการเรียกใช้ใหม่ เมื่อเขียน
|
dataValidation
|
กฎการตรวจสอบข้อมูลในเซลล์ (หากมี) เมื่อเขียน กฎการตรวจสอบข้อมูลใหม่จะเขียนทับกฎก่อนหน้า |
pivotTable
|
ตาราง Pivot ที่ยึดไว้ที่เซลล์นี้ ระบบจะคำนวณขนาดของตาราง Pivot เองแบบไดนามิกตามข้อมูล การจัดกลุ่ม ตัวกรอง ค่า ฯลฯ ของตาราง มีเพียงเซลล์ด้านบนซ้ายของตาราง Pivot เท่านั้นที่มีคำจำกัดความของตาราง Pivot ส่วนเซลล์อื่นๆ จะมีค่าที่คำนวณแล้วของผลลัพธ์ของ Pivot ในฟิลด์
|
dataSourceTable
|
ตารางแหล่งข้อมูลที่ยึดไว้ที่เซลล์นี้ ระบบจะคำนวณขนาดของตารางแหล่งข้อมูลแบบไดนามิกตามการกำหนดค่า เฉพาะเซลล์แรกของตารางแหล่งข้อมูลเท่านั้นที่มีคำจำกัดความของตารางแหล่งข้อมูล ส่วนเซลล์อื่นๆ จะมีค่าที่แสดงของผลลัพธ์ตารางแหล่งข้อมูลในฟิลด์ |
dataSourceFormula
|
เอาต์พุตเท่านั้น ข้อมูลเกี่ยวกับสูตรแหล่งข้อมูลในเซลล์ ระบบจะตั้งค่าฟิลด์นี้หาก
|
chipRuns[]
|
ไม่บังคับ การเรียกใช้ชิปที่ใช้กับส่วนย่อยของเซลล์ พร็อพเพอร์ตี้ของการเรียกใช้จะเริ่มต้นที่ดัชนีที่เฉพาะเจาะจงในข้อความและดำเนินการต่อไปจนกว่าจะถึงการเรียกใช้ถัดไป
เมื่ออ่าน ระบบจะรวมการวิ่งทั้งหมดที่ติดชิปและไม่ได้ติดชิป การวิ่งที่ไม่ได้ติดชิปจะมี
เมื่อเขียน จะรวมเฉพาะการวิ่งที่มีชิปเท่านั้น การเรียกใช้ที่มีชิปมีความยาว 1 และแสดงในข้อความที่ผู้ใช้ป้อนโดยใช้สัญลักษณ์ตัวยึดตำแหน่ง "@" การเรียกใช้ใหม่จะเขียนทับการเรียกใช้ก่อนหน้า การเขียนใหม่
|
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
|
ความกว้างของเส้นขอบในหน่วยพิกเซล เลิกใช้งานแล้ว ความกว้างจะกำหนดโดยช่อง "style" |
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 ชีตแบบเดิม ซึ่งจะตัดคำที่ยาวกว่า 1 บรรทัดแทนที่จะแบ่งคำ กลยุทธ์นี้ไม่รองรับในบางแพลตฟอร์มและกำลังจะเลิกใช้ ตัวอย่าง |
CLIP
|
บรรทัดที่ยาวกว่าความกว้างของเซลล์จะถูกตัดออก ข้อความจะไม่ขึ้นบรรทัดใหม่ เว้นแต่ผู้ใช้จะแทรกบรรทัดใหม่ด้วยตนเอง ตัวอย่าง |
WRAP
|
คำที่ยาวกว่า 1 บรรทัดจะมีการตัดคำที่ระดับอักขระแทนที่จะตัดคำ ตัวอย่าง |
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
|
เอาต์พุตเท่านั้น สถานะการเรียกใช้ข้อมูล |
ChipRun
การทำงานของชิป ชิปจะแสดงต่อไปจนกว่าจะถึงดัชนีเริ่มต้นของการเรียกใช้ครั้งถัดไป
| การแสดง JSON |
|---|
{
"startIndex": integer,
"chip": {
object ( |
| ช่อง | |
|---|---|
startIndex
|
ต้องระบุ ดัชนีอักขระที่อิงตาม 0 ซึ่งการเรียกใช้นี้เริ่มต้นในหน่วยรหัส UTF-16 |
chip
|
ไม่บังคับ ชิปของการวิ่งนี้ |
ชิป
ชิปอัจฉริยะ
| การแสดง JSON |
|---|
{ // Union field |
| ช่อง | |
|---|---|
ฟิลด์ Union
properties คุณสมบัติของชิป
properties
ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
|
|
personProperties
|
พร็อพเพอร์ตี้ของบุคคลที่ลิงก์ |
richLinkProperties
|
คุณสมบัติของลิงก์สมบูรณ์ |
PersonProperties
พร็อพเพอร์ตี้เฉพาะของบุคคลที่ลิงก์
| การแสดง JSON |
|---|
{
"email": string,
"displayFormat": enum ( |
| ช่อง | |
|---|---|
email
|
ต้องระบุ อีเมลที่ลิงก์กับบุคคลนี้ ฟิลด์นี้จะแสดงเสมอ |
displayFormat
|
ไม่บังคับ รูปแบบการแสดงชิปบุคคล หากไม่ได้ตั้งค่า ระบบจะใช้รูปแบบการแสดงผลเริ่มต้น |
DisplayFormat
รูปแบบการแสดงผลที่ต้องการเมื่อพร้อมใช้งาน
| Enum | |
|---|---|
DISPLAY_FORMAT_UNSPECIFIED
|
ค่าเริ่มต้น ไม่ต้องใช้ |
DEFAULT
|
รูปแบบการแสดงผลเริ่มต้น |
LAST_NAME_COMMA_FIRST_NAME
|
รูปแบบการแสดงชื่อและนามสกุล |
EMAIL
|
รูปแบบการแสดงอีเมล |
RichLinkProperties
พร็อพเพอร์ตี้ของลิงก์ไปยังแหล่งข้อมูลของ Google (เช่น ไฟล์ในไดรฟ์, วิดีโอ YouTube, ที่อยู่ใน Maps หรือกิจกรรมในปฏิทิน) เขียนไฟล์ไดรฟ์เป็นชิปได้เท่านั้น ส่วนลิงก์ริชมีเดียประเภทอื่นๆ ทั้งหมดจะอ่านได้อย่างเดียว
URI ต้องมีขนาดไม่เกิน 2,000 ไบต์เมื่อเขียน
หมายเหตุ: การเขียนชิปไฟล์ในไดรฟ์ต้องมีขอบเขต OAuth อย่างน้อย 1 รายการต่อไปนี้
drive.file
drive.readonly หรือ
drive
| การแสดง JSON |
|---|
{ "uri": string, "mimeType": string } |
| ช่อง | |
|---|---|
uri
|
ต้องระบุ URI ของลิงก์ This is always present. |
mimeType
|
เอาต์พุตเท่านั้น ประเภท MIME ของลิงก์ หากมี (เช่น เมื่อเป็นไฟล์ในไดรฟ์) |