Sheets

แผ่นงาน

แผ่นงานในสเปรดชีต

การแสดง JSON 
{
  "properties": {
    object (SheetProperties)
  },
  "data": [
    {
      object (GridData)
    }
  ],
  "merges": [
    {
      object (GridRange)
    }
  ],
  "conditionalFormats": [
    {
      object (ConditionalFormatRule)
    }
  ],
  "filterViews": [
    {
      object (FilterView)
    }
  ],
  "protectedRanges": [
    {
      object (ProtectedRange)
    }
  ],
  "basicFilter": {
    object (BasicFilter)
  },
  "charts": [
    {
      object (EmbeddedChart)
    }
  ],
  "bandedRanges": [
    {
      object (BandedRange)
    }
  ],
  "developerMetadata": [
    {
      object (DeveloperMetadata)
    }
  ],
  "rowGroups": [
    {
      object (DimensionGroup)
    }
  ],
  "columnGroups": [
    {
      object (DimensionGroup)
    }
  ],
  "slicers": [
    {
      object (Slicer)
    }
  ]
}
ช่อง
properties

object (SheetProperties)

คุณสมบัติของแผ่นงาน

data[]

object (GridData)

ข้อมูลในตารางกริด หากเป็นตารางกริด

จํานวนออบเจ็กต์ GridData ที่ส่งคืนจะขึ้นอยู่กับจํานวนช่วงที่ขอในชีตนี้ เช่น หากค่านี้แสดง Sheet1 และส่งคําขอสเปรดชีตด้วยช่วง Sheet1!A1:C10 และ Sheet1!D15:E20 GridData แรกจะมี startRow / startColumn ของ 0 startRow 14startColumn 3

สําหรับชีต DATA_SOURCE คุณจะขอช่วงที่ต้องการไม่ได้ GridData มีค่าทั้งหมด

merges[]

object (GridRange)

ช่วงที่จะรวมกัน

conditionalFormats[]

object (ConditionalFormatRule)

กฎการจัดรูปแบบตามเงื่อนไขในชีตนี้

filterViews[]

object (FilterView)

มุมมองตัวกรองในชีตนี้

protectedRanges[]

object (ProtectedRange)

ช่วงที่ป้องกันในแผ่นงานนี้

basicFilter

object (BasicFilter)

ตัวกรองในชีตนี้ หากมี

charts[]

object (EmbeddedChart)

ข้อกําหนดของทุกแผนภูมิในชีตนี้

bandedRanges[]

object (BandedRange)

ช่วงสี (แบบสลับสี) ในชีตนี้

developerMetadata[]

object (DeveloperMetadata)

ข้อมูลเมตาของนักพัฒนาซอฟต์แวร์ที่เชื่อมโยงกับชีต

rowGroups[]

object (DimensionGroup)

กลุ่มแถวทั้งหมดในแผ่นงานนี้ ซึ่งเรียงลําดับโดยการเพิ่มดัชนีเริ่มต้นของช่วง จากนั้นจึงเพิ่มความลึกของกลุ่ม

columnGroups[]

object (DimensionGroup)

กลุ่มคอลัมน์ทั้งหมดในชีตนี้ โดยจะเรียงลําดับโดยการเพิ่มดัชนีเริ่มต้นของช่วง ตามด้วยความลึกของกลุ่ม

slicers[]

object (Slicer)

ตัวควบคุมตัวกรองในชีตนี้

คุณสมบัติของแผ่นงาน

คุณสมบัติของแผ่นงาน

การแสดง JSON 
{
  "sheetId": integer,
  "title": string,
  "index": integer,
  "sheetType": enum (SheetType),
  "gridProperties": {
    object (GridProperties)
  },
  "hidden": boolean,
  "tabColor": {
    object (Color)
  },
  "tabColorStyle": {
    object (ColorStyle)
  },
  "rightToLeft": boolean,
  "dataSourceSheetProperties": {
    object (DataSourceSheetProperties)
  }
}
ช่อง
sheetId

integer

รหัสของแผ่นงาน ต้องไม่เป็นจํานวนที่เป็นลบ ฟิลด์นี้ไม่สามารถเปลี่ยนแปลงเมื่อตั้งค่าได้

title

string

ชื่อของแผ่นงาน

index

integer

ดัชนีของแผ่นงานภายในสเปรดชีต เมื่อเพิ่มหรืออัปเดตคุณสมบัติของแผ่นงาน ถ้าช่องนี้ถูกยกเว้น แผ่นงานนั้นจะถูกเพิ่มหรือถูกย้ายไปยังส่วนท้ายของรายการแผ่นงาน เมื่ออัปเดตดัชนีแผ่นงานหรือแทรกแผ่นงาน ระบบจะพิจารณาการเคลื่อนไหวในดัชนี "ก่อนการย้าย" เช่น หากมี 3 แผ่นงาน (S1, S2, S3) เพื่อย้าย S1 ก่อน S2 ดัชนีจะต้องตั้งค่าเป็น 2 ระบบจะไม่สนใจคําขออัปเดตดัชนีแผ่นงาน หากดัชนีที่ขอนั้นตรงกับดัชนีปัจจุบันของแผ่นงาน หรือหากดัชนีใหม่ที่ขอนั้นเท่ากับดัชนีแผ่นงานปัจจุบัน + 1

sheetType

enum (SheetType)

ประเภทของแผ่นงาน ค่าเริ่มต้นคือ GRID ฟิลด์นี้ไม่สามารถเปลี่ยนแปลงเมื่อตั้งค่าได้

gridProperties

object (GridProperties)

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

หากชีตนี้เป็นชีต DATA_SOURCE ช่องนี้จะมีเอาต์พุตเท่านั้น แต่มีพร็อพเพอร์ตี้ที่แสดงวิธีการแสดงผลชีตแหล่งข้อมูลใน UI เช่น rowCount

hidden

boolean

จริง หากซ่อนแผ่นงานไว้ใน UI เป็นเท็จ หากมองเห็นได้

tabColor
(deprecated)

object (Color)

สีของแท็บใน UI เลิกใช้งานแล้ว: ใช้ tabColorStyle

tabColorStyle

object (ColorStyle)

สีของแท็บใน UI หากมีการตั้งค่า tabColor ด้วย ช่องนี้จะมีความสําคัญเหนือกว่า

rightToLeft

boolean

เป็นจริงถ้าแผ่นงานเป็นแผ่น RTL แทนที่จะเป็นแผ่นงาน LTR

dataSourceSheetProperties

object (DataSourceSheetProperties)

เอาต์พุตเท่านั้น หากมี ช่องดังกล่าวจะมีคุณสมบัติเฉพาะสําหรับชีต DATA_SOURCE

ประเภทแผ่นงาน

ชนิดของแผ่นงาน

Enum
SHEET_TYPE_UNSPECIFIED ค่าเริ่มต้น ไม่ใช้
GRID แผ่นงานเป็นตาราง
OBJECT แผ่นงานไม่มีตารางและมีวัตถุ เช่น แผนภูมิหรือรูปภาพ
DATA_SOURCE แผ่นงานเชื่อมต่อกับ DataSource ภายนอกและแสดงตัวอย่างข้อมูล

คุณสมบัติตารางกริด

คุณสมบัติของตาราง

การแสดง JSON 
{
  "rowCount": integer,
  "columnCount": integer,
  "frozenRowCount": integer,
  "frozenColumnCount": integer,
  "hideGridlines": boolean,
  "rowGroupControlAfter": boolean,
  "columnGroupControlAfter": boolean
}
ช่อง
rowCount

integer

จํานวนแถวในตาราง

columnCount

integer

จํานวนคอลัมน์ในตารางกริด

frozenRowCount

integer

จํานวนแถวที่ตรึงอยู่ในตารางกริด

frozenColumnCount

integer

จํานวนคอลัมน์ที่ตรึงอยู่ในตารางกริด

hideGridlines

boolean

เป็นจริงถ้าตารางกริดไม่แสดงเส้นตารางใน UI

rowGroupControlAfter

boolean

เป็นจริงถ้าปุ่มสลับการควบคุมการจัดกลุ่มแถวปรากฏหลังจากกลุ่ม

columnGroupControlAfter

boolean

เป็นจริงถ้าปุ่มสลับการควบคุมการจัดกลุ่มคอลัมน์ปรากฏหลังกลุ่ม

คุณสมบัติของแผ่นงานแหล่งข้อมูล

พร็อพเพอร์ตี้เพิ่มเติมของแผ่นงาน DATA_SOURCE

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

string

รหัสของ DataSource แผ่นงานที่เชื่อมต่ออยู่

columns[]

object (DataSourceColumn)

คอลัมน์ที่แสดงในชีตจะสอดคล้องกับค่าใน RowData

dataExecutionStatus

object (DataExecutionStatus)

สถานะการเรียกใช้ข้อมูล

ข้อมูลตารางกริด

ข้อมูลในตาราง รวมถึงข้อมูลเมตาเกี่ยวกับมิติข้อมูล

การแสดง JSON 
{
  "startRow": integer,
  "startColumn": integer,
  "rowData": [
    {
      object (RowData)
    }
  ],
  "rowMetadata": [
    {
      object (DimensionProperties)
    }
  ],
  "columnMetadata": [
    {
      object (DimensionProperties)
    }
  ]
}
ช่อง
startRow

integer

แถวแรกที่ GridData อ้างถึง จะใช้เลขศูนย์

startColumn

integer

คอลัมน์แรกที่ GridData อ้างถึง ต้องเป็นเลขศูนย์

rowData[]

object (RowData)

ข้อมูลในตาราง 1 รายการต่อแถว โดยเริ่มจากแถวใน startRow ค่าใน RowData จะสอดคล้องกับคอลัมน์โดยเริ่มจาก startColumn

rowMetadata[]

object (DimensionProperties)

ข้อมูลเมตาเกี่ยวกับแถวที่ขอในตารางกริด โดยเริ่มจากแถวใน startRow

columnMetadata[]

object (DimensionProperties)

ข้อมูลเมตาเกี่ยวกับคอลัมน์ที่ขอในตารางกริด โดยเริ่มจากคอลัมน์ใน startColumn

ข้อมูลแถว

ข้อมูลเกี่ยวกับแต่ละเซลล์ในแถว

การแสดง JSON 
{
  "values": [
    {
      object (CellData)
    }
  ]
}
ช่อง
values[]

object (CellData)

ค่าในแถว หนึ่งค่าต่อคอลัมน์

มิติข้อมูล

พร็อพเพอร์ตี้เกี่ยวกับมิติข้อมูล

การแสดง JSON 
{
  "hiddenByFilter": boolean,
  "hiddenByUser": boolean,
  "pixelSize": integer,
  "developerMetadata": [
    {
      object (DeveloperMetadata)
    }
  ],
  "dataSourceColumnReference": {
    object (DataSourceColumnReference)
  }
}
ช่อง
hiddenByFilter

boolean

จริงหากกําลังกรองมิติข้อมูลนี้ ช่องนี้เป็นแบบอ่านอย่างเดียว

hiddenByUser

boolean

เป็นจริงหากมิติข้อมูลนี้ถูกซ่อนไว้อย่างชัดเจน

pixelSize

integer

ความสูง (หากแถว) หรือความกว้าง (หากคอลัมน์) ของมิติข้อมูลเป็นพิกเซล

developerMetadata[]

object (DeveloperMetadata)

ข้อมูลเมตาของนักพัฒนาซอฟต์แวร์ที่เชื่อมโยงกับแถวหรือคอลัมน์เดียว

dataSourceColumnReference

object (DataSourceColumnReference)

เอาต์พุตเท่านั้น หากตั้งค่าไว้ จะเป็นคอลัมน์ในชีตแหล่งข้อมูล

กฎเกี่ยวกับรูปแบบ

กฎที่อธิบายรูปแบบตามเงื่อนไข

การแสดง JSON 
{
  "ranges": [
    {
      object (GridRange)
    }
  ],

  // Union field rule can be only one of the following:
  "booleanRule": {
    object (BooleanRule)
  },
  "gradientRule": {
    object (GradientRule)
  }
  // End of list of possible types for union field rule.
}
ช่อง
ranges[]

object (GridRange)

ช่วงที่จัดรูปแบบหากเงื่อนไขเป็นจริง ช่วงทั้งหมดต้องอยู่ในตารางกริดเดียวกัน

ช่อง Union rule กฎที่ควบคุมรูปแบบตามเงื่อนไขนี้ จะต้องตั้งค่ารูปแบบเดียว rule ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
booleanRule

object (BooleanRule)

การจัดรูปแบบจะ "เปิด" หรือ "ปิด" ตามกฎ

gradientRule

object (GradientRule)

การจัดรูปแบบจะแตกต่างกันไปตามการไล่ระดับสีในกฎ

กฎบูลีน

กฎที่อาจ (หรือ) อาจไม่ตรงกัน ขึ้นอยู่กับเงื่อนไข

การแสดง JSON 
{
  "condition": {
    object (BooleanCondition)
  },
  "format": {
    object (CellFormat)
  }
}
ช่อง
condition

object (BooleanCondition)

เงื่อนไขของกฎ หากเงื่อนไขประเมินค่าเป็น "จริง" ระบบจะใช้รูปแบบ

format

object (CellFormat)

รูปแบบที่จะใช้ การจัดรูปแบบตามเงื่อนไขใช้ได้กับการจัดรูปแบบชุดย่อยเท่านั้น: bold, italic, strikethrough, foreground color และ background color

ไล่ระดับกฎ

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

การแสดง JSON 
{
  "minpoint": {
    object (InterpolationPoint)
  },
  "midpoint": {
    object (InterpolationPoint)
  },
  "maxpoint": {
    object (InterpolationPoint)
  }
}
ช่อง
minpoint

object (InterpolationPoint)

จุดเริ่มต้นการประมาณ

midpoint

object (InterpolationPoint)

จุดตรวจกลาง (ไม่บังคับ)

maxpoint

object (InterpolationPoint)

จุดระหว่างการอ้างอิงสุดท้าย

จุดระหว่างจุดตัด

จุดตรวจจุดเดียวบนรูปแบบตามเงื่อนไขการไล่สี ซึ่งจะปักหมุดสเกลของการไล่ระดับสีตามสี ประเภท และค่าที่เลือก

การแสดง JSON 
{
  "color": {
    object (Color)
  },
  "colorStyle": {
    object (ColorStyle)
  },
  "type": enum (InterpolationPointType),
  "value": string
}
ช่อง
color
(deprecated)

object (Color)

สีของจุดระหว่างการประมาณนี้ควรใช้ เลิกใช้งานแล้ว: ใช้ colorStyle

colorStyle

object (ColorStyle)

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

type

enum (InterpolationPointType)

วิธีตีความค่า

value

string

ค่าที่จุดระหว่างการประมาณนี้ใช้ อาจเป็นสูตร ไม่ได้ใช้งานหาก type คือ MIN หรือ MAX

จุดระหว่างจุดเขียน

ชนิดจุดตรวจ

Enum
INTERPOLATION_POINT_TYPE_UNSPECIFIED ค่าเริ่มต้น ไม่ใช้
MIN จุดประมาณค่าจะใช้ค่าต่ําสุดในเซลล์ในช่วงของรูปแบบตามเงื่อนไข
MAX จุดประมาณค่าใช้ค่าสูงสุดในเซลล์ในช่วงของรูปแบบตามเงื่อนไข
NUMBER จุดประมาณค่าจะใช้ค่าของ InterpolationPoint.value
PERCENT

จุดระหว่างการทดสอบคือเปอร์เซ็นต์ที่ระบุเหนือเซลล์ทั้งหมดในช่วงของรูปแบบตามเงื่อนไข ซึ่งเท่ากับ NUMBER หากค่าคือ =(MAX(FLATTEN(range)) * (value / 100)) + (MIN(FLATTEN(range)) * (1 - (value / 100))) (ระบบไม่สนใจข้อผิดพลาดในช่วงเมื่อแยกข้อมูล)

PERCENTILE จุดระหว่างการทดสอบคือเปอร์เซ็นไทล์ที่ระบุเหนือเซลล์ทั้งหมดในช่วงของรูปแบบตามเงื่อนไข ซึ่งเท่ากับ NUMBER หากค่าคือ =PERCENTILE(FLATTEN(range), value / 100) (ระบบไม่สนใจข้อผิดพลาดในช่วงเมื่อแยกข้อมูล)

มุมมองตัวกรอง

มุมมองตัวกรอง

การแสดง JSON 
{
  "filterViewId": integer,
  "title": string,
  "range": {
    object (GridRange)
  },
  "namedRangeId": string,
  "sortSpecs": [
    {
      object (SortSpec)
    }
  ],
  "criteria": {
    integer: {
      object (FilterCriteria)
    },
    ...
  },
  "filterSpecs": [
    {
      object (FilterSpec)
    }
  ]
}
ช่อง
filterViewId

integer

รหัสของมุมมองตัวกรอง

title

string

ชื่อของมุมมองตัวกรอง

range

object (GridRange)

ช่วงมุมมองตัวกรองนี้ครอบคลุม

เมื่อเขียน ระบบอาจตั้งค่า range หรือ namedRangeId เพียงรายการเดียว

namedRangeId

string

ช่วงที่มีชื่อซึ่งมุมมองตัวกรองนี้รองรับ หากมี

เมื่อเขียน ระบบอาจตั้งค่า range หรือ namedRangeId เพียงรายการเดียว

sortSpecs[]

object (SortSpec)

ลําดับการจัดเรียงต่อคอลัมน์ ระบบจะใช้ข้อกําหนดในภายหลังเมื่อค่าเท่ากันในข้อกําหนดก่อนหน้านี้

criteria
(deprecated)

map (key: integer, value: object ( FilterCriteria))

เกณฑ์ในการแสดง/การซ่อนค่าต่อคอลัมน์ คีย์ของแผนที่คือดัชนีคอลัมน์ และค่าคือเกณฑ์ของคอลัมน์นั้น

ช่องนี้จะเลิกใช้งานเพื่อใช้ filterSpecs แทน

filterSpecs[]

object (FilterSpec)

เกณฑ์ตัวกรองสําหรับการแสดง/การซ่อนค่าต่อคอลัมน์

ทั้ง criteria และ filterSpecs จะเติมข้อมูลในคําตอบ หากมีการระบุทั้ง 2 ช่องในคําขอการอัปเดต ช่องนี้จะมีความสําคัญเหนือกว่า

ช่วงที่ป้องกันไว้

ช่วงที่ป้องกันไว้

การแสดง JSON 
{
  "protectedRangeId": integer,
  "range": {
    object (GridRange)
  },
  "namedRangeId": string,
  "description": string,
  "warningOnly": boolean,
  "requestingUserCanEdit": boolean,
  "unprotectedRanges": [
    {
      object (GridRange)
    }
  ],
  "editors": {
    object (Editors)
  }
}
ช่อง
protectedRangeId

integer

รหัสของช่วงที่ป้องกัน ช่องนี้เป็นแบบอ่านอย่างเดียว

range

object (GridRange)

ช่วงที่ได้รับการป้องกัน ช่วงอาจไม่มีขอบเขตอย่างสมบูรณ์ ซึ่งในกรณีนี้จะถือว่าเป็นแผ่นงานที่ได้รับการป้องกัน

เมื่อเขียน ระบบอาจตั้งค่า range หรือ namedRangeId เพียงรายการเดียว

namedRangeId

string

ช่วงที่ตั้งชื่อแล้วจะได้รับการปกป้องในช่วงนี้ (ถ้ามี)

เมื่อเขียน ระบบอาจตั้งค่า range หรือ namedRangeId เพียงรายการเดียว

description

string

คําอธิบายของช่วงที่ได้รับการป้องกันนี้

warningOnly

boolean

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

เมื่อเขียน หากช่องนี้เป็นจริง ระบบจะไม่สนใจ editors นอกจากนี้ หากช่องนี้เปลี่ยนจาก "จริง" เป็น "เท็จ" และไม่ได้ตั้งช่อง editors (หรือไม่รวมในมาสก์ของช่อง) ระบบจะตั้งค่าให้ผู้แก้ไขเป็นเอดิเตอร์ทั้งหมดในเอกสาร

requestingUserCanEdit

boolean

เป็นจริงถ้าผู้ใช้ที่ขอช่วงที่มีการป้องกันนี้สามารถแก้ไขพื้นที่ที่ได้รับการป้องกัน ช่องนี้เป็นแบบอ่านอย่างเดียว

unprotectedRanges[]

object (GridRange)

รายการช่วงที่ป้องกันภายในแผ่นงานที่มีการป้องกัน แผ่นงานไม่ได้รับการป้องกันเฉพาะในแผ่นงานที่มีการป้องกันเท่านั้น

editors

object (Editors)

ผู้ใช้และกลุ่มที่มีสิทธิ์แก้ไขช่วงที่ได้รับการป้องกัน ช่องนี้จะปรากฏต่อผู้ใช้ที่มีสิทธิ์ในการแก้ไขช่วงที่มีการป้องกันและเอกสารเท่านั้น การปกป้อง warningOnly ไม่รองรับการป้องกัน

เครื่องมือแก้ไข

เครื่องมือแก้ไขของช่วงที่ป้องกันไว้

การแสดง JSON 
{
  "users": [
    string
  ],
  "groups": [
    string
  ],
  "domainUsersCanEdit": boolean
}
ช่อง
users[]

string

อีเมลของผู้ใช้ที่มีสิทธิ์แก้ไขช่วงที่ได้รับการป้องกัน

groups[]

string

อีเมลของกลุ่มที่มีสิทธิ์แก้ไขช่วงที่ได้รับการป้องกัน

domainUsersCanEdit

boolean

เป็นจริงถ้าทุกคนในโดเมนของโดเมนมีสิทธิ์แก้ไขช่วงที่ได้รับการป้องกัน การป้องกันโดเมนรองรับเฉพาะเอกสารภายในโดเมนเท่านั้น

ตัวกรองพื้นฐาน

ตัวกรองเริ่มต้นที่เชื่อมโยงกับชีต

การแสดง JSON 
{
  "range": {
    object (GridRange)
  },
  "sortSpecs": [
    {
      object (SortSpec)
    }
  ],
  "criteria": {
    integer: {
      object (FilterCriteria)
    },
    ...
  },
  "filterSpecs": [
    {
      object (FilterSpec)
    }
  ]
}
ช่อง
range

object (GridRange)

ช่วงตัวกรอง

sortSpecs[]

object (SortSpec)

ลําดับการจัดเรียงต่อคอลัมน์ ระบบจะใช้ข้อกําหนดในภายหลังเมื่อค่าเท่ากันในข้อกําหนดก่อนหน้านี้

criteria
(deprecated)

map (key: integer, value: object ( FilterCriteria))

เกณฑ์ในการแสดง/การซ่อนค่าต่อคอลัมน์ คีย์ของแผนที่คือดัชนีคอลัมน์ และค่าคือเกณฑ์ของคอลัมน์นั้น

ช่องนี้จะเลิกใช้งานเพื่อใช้ filterSpecs แทน

filterSpecs[]

object (FilterSpec)

เกณฑ์ตัวกรองต่อคอลัมน์

ทั้ง criteria และ filterSpecs จะเติมข้อมูลในคําตอบ หากมีการระบุทั้ง 2 ช่องในคําขอการอัปเดต ช่องนี้จะมีความสําคัญเหนือกว่า

ช่วงความถี่

ช่วงสีแบบแถบ (สีสลับ) ในแผ่นงาน

การแสดง JSON 
{
  "bandedRangeId": integer,
  "range": {
    object (GridRange)
  },
  "rowProperties": {
    object (BandingProperties)
  },
  "columnProperties": {
    object (BandingProperties)
  }
}
ช่อง
bandedRangeId

integer

รหัสของช่วงสี

range

object (GridRange)

ช่วงที่ใช้คุณสมบัติเหล่านี้

rowProperties

object (BandingProperties)

คุณสมบัติสําหรับย่านความถี่ คุณสมบัติเหล่านี้จะมีผลแบบแถวต่อแถวในทุกแถวในช่วง ต้องระบุ rowProperties หรือ columnProperties อย่างน้อย 1 รายการ

columnProperties

object (BandingProperties)

คุณสมบัติของแถบคอลัมน์ คุณสมบัติเหล่านี้จะใช้กับแต่ละคอลัมน์ทั่วทั้งคอลัมน์ในช่วงนี้ ต้องระบุ rowProperties หรือ columnProperties อย่างน้อย 1 รายการ

คุณสมบัติแถบ

พร็อพเพอร์ตี้ที่อ้างอิงมิติข้อมูลเดียว (ทั้งแถวหรือคอลัมน์) หากตั้งค่าทั้ง BandedRange.row_properties และ BandedRange.column_properties ระบบจะใช้สีเติมกับเซลล์ตามกฎต่อไปนี้

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

การแสดง JSON 
{
  "headerColor": {
    object (Color)
  },
  "headerColorStyle": {
    object (ColorStyle)
  },
  "firstBandColor": {
    object (Color)
  },
  "firstBandColorStyle": {
    object (ColorStyle)
  },
  "secondBandColor": {
    object (Color)
  },
  "secondBandColorStyle": {
    object (ColorStyle)
  },
  "footerColor": {
    object (Color)
  },
  "footerColorStyle": {
    object (ColorStyle)
  }
}
ช่อง
headerColor
(deprecated)

object (Color)

สีของแถวหรือคอลัมน์แรก หากตั้งค่าช่องนี้ แถวหรือคอลัมน์แรกจะเติมด้วยสีนี้และสีที่สลับกันระหว่าง firstBandColor ถึง secondBandColor เริ่มจากแถวหรือคอลัมน์ที่ 2 มิเช่นนั้น แถวหรือคอลัมน์แรกจะมีสี firstBandColor และให้สีเปลี่ยนไปตามปกติ เลิกใช้งานแล้ว: ใช้ headerColorStyle

headerColorStyle

object (ColorStyle)

สีของแถวหรือคอลัมน์แรก หากตั้งค่าช่องนี้ แถวหรือคอลัมน์แรกจะเติมด้วยสีนี้และสีที่สลับกันระหว่าง firstBandColor ถึง secondBandColor เริ่มจากแถวหรือคอลัมน์ที่ 2 มิเช่นนั้น แถวหรือคอลัมน์แรกจะมีสี firstBandColor และให้สีเปลี่ยนไปตามปกติ หากมีการตั้งค่า headerColor ด้วย ช่องนี้จะมีความสําคัญเหนือกว่า

firstBandColor
(deprecated)

object (Color)

สีแรกที่สลับสี (จําเป็น) เลิกใช้งานแล้ว: ใช้ firstBandColorStyle

firstBandColorStyle

object (ColorStyle)

สีแรกที่สลับสี (ต้องระบุ) หากมีการตั้งค่า firstBandColor ไว้ด้วย ช่องนี้จะมีลําดับความสําคัญเหนือกว่า

secondBandColor
(deprecated)

object (Color)

สีที่สองที่สลับกัน (จําเป็น) เลิกใช้งานแล้ว: ใช้ secondBandColorStyle

secondBandColorStyle

object (ColorStyle)

สีที่สองที่สลับกัน (ต้องระบุ) หากมีการตั้งค่า secondBandColor ไว้ด้วย ช่องนี้จะมีลําดับความสําคัญเหนือกว่า

footerColor
(deprecated)

object (Color)

สีของแถวหรือคอลัมน์สุดท้าย หากไม่ได้ตั้งค่าช่องนี้ ระบบจะเติมแถวหรือคอลัมน์สุดท้ายด้วย firstBandColor หรือ secondBandColor ทั้งนี้ขึ้นอยู่กับสีของแถวหรือคอลัมน์ก่อนหน้า เลิกใช้งานแล้ว: ใช้ footerColorStyle

footerColorStyle

object (ColorStyle)

สีของแถวหรือคอลัมน์สุดท้าย หากไม่ได้ตั้งค่าช่องนี้ ระบบจะเติมแถวหรือคอลัมน์สุดท้ายด้วย firstBandColor หรือ secondBandColor ทั้งนี้ขึ้นอยู่กับสีของแถวหรือคอลัมน์ก่อนหน้า หากมีการตั้งค่า footerColor ด้วย ช่องนี้จะมีความสําคัญเหนือกว่า

กลุ่มมิติข้อมูล

กลุ่มตามช่วงแถวหรือคอลัมน์ในแผ่นงาน ซึ่งอาจมีหรืออยู่ในกลุ่มอื่นได้ คุณสามารถยุบหรือขยายกลุ่มเป็นหน่วยในแผ่นงานได้

การแสดง JSON 
{
  "range": {
    object (DimensionRange)
  },
  "depth": integer,
  "collapsed": boolean
}
ช่อง
range

object (DimensionRange)

ช่วงที่มีกลุ่มนี้

depth

integer

ความลึกของกลุ่มซึ่งแสดงจํานวนกลุ่มที่มีช่วงทั้งหมดที่ประกอบด้วยช่วงของกลุ่มนี้

collapsed

boolean

ช่องนี้เป็นจริงเมื่อยุบกลุ่มนี้ กลุ่มที่ยุบจะยังคงยุบอยู่หากกลุ่มที่ทับซ้อนกันมีความลึกน้อยกว่า

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

ตัวควบคุมตัวกรอง

ตัวควบคุมตัวกรองในแผ่นงาน

การแสดง JSON 
{
  "slicerId": integer,
  "spec": {
    object (SlicerSpec)
  },
  "position": {
    object (EmbeddedObjectPosition)
  }
}
ช่อง
slicerId

integer

รหัสของตัวควบคุมตัวกรอง

spec

object (SlicerSpec)

ข้อกําหนดของตัวควบคุมตัวกรอง

position

object (EmbeddedObjectPosition)

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

ตัวควบคุมตัวกรอง

ข้อกําหนดของตัวควบคุมตัวกรอง

การแสดง JSON 
{
  "dataRange": {
    object (GridRange)
  },
  "filterCriteria": {
    object (FilterCriteria)
  },
  "columnIndex": integer,
  "applyToPivotTables": boolean,
  "title": string,
  "textFormat": {
    object (TextFormat)
  },
  "backgroundColor": {
    object (Color)
  },
  "backgroundColorStyle": {
    object (ColorStyle)
  },
  "horizontalAlignment": enum (HorizontalAlign)
}
ช่อง
dataRange

object (GridRange)

ช่วงข้อมูลของตัวควบคุมตัวกรอง

filterCriteria

object (FilterCriteria)

เกณฑ์การกรองของตัวควบคุมตัวกรอง

columnIndex

integer

ดัชนีคอลัมน์ในตารางข้อมูลที่ใช้ตัวกรอง

applyToPivotTables

boolean

เป็นจริงถ้าตัวกรองควรนําไปใช้กับตาราง Pivot หากไม่ได้ตั้งค่าไว้ ค่าเริ่มต้นจะเป็น True

title

string

ชื่อของตัวควบคุมตัวกรอง

textFormat

object (TextFormat)

รูปแบบข้อความของชื่อในตัวควบคุมตัวกรอง ไม่สนับสนุนฟิลด์ของลิงก์

backgroundColor
(deprecated)

object (Color)

สีพื้นหลังของตัวควบคุมตัวกรอง เลิกใช้งานแล้ว: ใช้ backgroundColorStyle

backgroundColorStyle

object (ColorStyle)

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

horizontalAlignment

enum (HorizontalAlign)

การจัดแนวแนวนอนของชื่อในตัวควบคุมตัวกรอง หากไม่ได้ระบุไว้ ระบบจะใช้ LEFT เป็นค่าเริ่มต้น