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