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

ความกว้างของเส้นขอบในหน่วยพิกเซล เลิกใช้งาน; ความกว้างจะกำหนดโดย "สไตล์" ด้วย

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

| 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.
}
ช่อง
ฟิลด์ Union 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)

เอาต์พุตเท่านั้น สถานะการดำเนินการกับข้อมูล