Cells

ข้อมูลมือถือ

ข้อมูลเกี่ยวกับเซลล์ใดเซลล์หนึ่ง

การแสดง 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() หมายเหตุ: วันที่ เวลา และวันที่และเวลาจะแสดงเป็น 2 เท่าของรูปแบบ 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 ในช่อง effectiveValue

dataSourceTable

object (DataSourceTable)

ตารางแหล่งข้อมูลซึ่งตรึงอยู่ที่เซลล์นี้ ขนาดของตารางแหล่งข้อมูลจะมีการคํานวณแบบไดนามิกตามการกําหนดค่าของตารางนั้น เซลล์แรกของตารางแหล่งข้อมูลมีคําจํากัดความตารางแหล่งข้อมูล ส่วนเซลล์อื่นๆ จะมีค่าการแสดงผลของตารางแหล่งข้อมูล ซึ่งจะแสดงในช่อง effectiveValue

dataSourceFormula

object (DataSourceFormula)

เอาต์พุตเท่านั้น ข้อมูลเกี่ยวกับสูตรแหล่งข้อมูลในเซลล์ ช่องนี้จะมีการตั้งค่าหาก userEnteredValue เป็นสูตรที่อ้างถึงแผ่นงาน DATA_SOURCE บางส่วน เช่น =SUM(DataSheet!Column)

รูปแบบเซลล์

รูปแบบของเซลล์

การแสดง 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)

การหมุนที่ใช้กับข้อความในเซลล์

รูปแบบตัวเลข

รูปแบบตัวเลขของเซลล์

การแสดง JSON 
{
  "type": enum (NumberFormatType),
  "pattern": string
}
ช่อง
type

enum (NumberFormatType)

ประเภทของรูปแบบตัวเลข ต้องตั้งค่าฟิลด์นี้เมื่อเขียน

pattern

string

สตริงรูปแบบที่ใช้ในการจัดรูปแบบ หากไม่ได้ตั้งค่าไว้ ระบบจะใช้รูปแบบเริ่มต้นโดยอิงตามสถานที่ของผู้ใช้หากจําเป็นสําหรับประเภทนั้นๆ ดูคําแนะนําเกี่ยวกับรูปแบบวันที่และตัวเลขสําหรับข้อมูลเพิ่มเติมเกี่ยวกับรูปแบบที่รองรับ

ประเภทรูปแบบตัวเลข

รูปแบบตัวเลขของเซลล์ ในเอกสารนี้จะถือว่าภาษาถิ่นเป็น 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 (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

ความกว้างของเส้นขอบ หน่วยเป็นพิกเซล เลิกใช้งาน โดยกําหนดความกว้างโดยช่อง "รูปแบบ"

color
(deprecated)

object (Color)

สีของเส้นขอบ เลิกใช้งานแล้ว: ใช้ colorStyle

colorStyle

object (ColorStyle)

สีของเส้นขอบ หากมีการตั้งค่า color ด้วย ช่องนี้จะมีความสําคัญเหนือกว่า

สไตล์

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

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

ระยะห่างจากขอบ

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

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

integer

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

right

integer

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

bottom

integer

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

left

integer

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

จัดข้อความแนวตั้ง

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

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

กลยุทธ์การตัดข้อความ

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

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 ชีตแบบเดิม โดยการตัดคําที่มีความยาวมากกว่าเส้นจะถูกตัดแทนที่จะหัก แพลตฟอร์มนี้ไม่สนับสนุนกลยุทธ์ประเภทนี้ทั้งหมดที่กําลังจะสิ้นสุดการให้บริการ ตัวอย่าง: 

| 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.  |

ทิศทางข้อความ

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

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

ประเภทการแสดงไฮเปอร์ลิงก์

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

Enum
LINKED ไฮเปอร์ลิงก์ควรจะแสดงผลอย่างชัดเจน
PLAIN_TEXT ไม่ควรแสดงผลไฮเปอร์ลิงก์

การหมุนข้อความ

การหมุนที่ใช้กับข้อความในเซลล์

การแสดง 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.
}
ช่อง
ช่อง Union type ประเภทของการหมุน แนวตั้ง หรือเอียง type ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
angle

integer

มุมระหว่างการวางแนวมาตรฐานและการวางแนวที่ต้องการ วัดเป็นองศา ค่าที่ถูกต้องอยู่ระหว่าง -90 และ 90 มุมบวกจะเป็นมุมชี้ขึ้น มุมลบจะเป็นมุมชี้ลง

หมายเหตุ: สําหรับทิศทางข้อความเชิงบวกของ LTR จะอยู่ในทิศทางทวนเข็มนาฬิกา ส่วนทิศทาง RTL จะอยู่ในทิศทางตามเข็มนาฬิกา

vertical

boolean

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

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

รูปแบบข้อความเรียกใช้

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

การแสดง JSON 
{
  "startIndex": integer,
  "format": {
    object (TextFormat)
  }
}
ช่อง
startIndex

integer

ดัชนีอักขระฐาน 0 ที่การเรียกใช้งานนี้เริ่มขึ้นในหน่วยโค้ด UTF-16

format

object (TextFormat)

รูปแบบของการเรียกใช้นี้ ค่าที่ไม่มีรูปแบบจะรับช่วงต่อรูปแบบของเซลล์

กฎการตรวจสอบข้อมูล

กฎการตรวจสอบข้อมูล

การแสดง JSON 
{
  "condition": {
    object (BooleanCondition)
  },
  "inputMessage": string,
  "strict": boolean,
  "showCustomUi": boolean
}
ช่อง
condition

object (BooleanCondition)

เงื่อนไขที่ข้อมูลในเซลล์ต้องตรงกัน

inputMessage

string

ข้อความที่จะแสดงเมื่อผู้ใช้เพิ่มข้อมูลในเซลล์

strict

boolean

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

showCustomUi

boolean

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

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

ตารางแหล่งข้อมูลที่ช่วยให้ผู้ใช้นําเข้าตารางข้อมูลแบบคงที่จาก 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)

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

ประเภทคอลัมน์ตารางข้อมูลต้นฉบับ

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

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

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

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

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

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

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

string

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

dataExecutionStatus

object (DataExecutionStatus)

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