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 ข้อมูลกริดแรกจะมี startRow/startColumn ของ 0 ส่วนข้อมูลกริดที่ 2 จะมี startRow 14 (แถวที่ 15 แบบฐาน 0) และ startColumn 3 (คอลัมน์ D แบบฐาน 0)

สำหรับชีต 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)

เครื่องมือแบ่งข้อมูลในชีตนี้

SheetProperties

คุณสมบัติของชีต

การแสดง 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 ชีต

SheetType

ประเภทชีต

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

GridProperties

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

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

จริงหากปุ่มเปิด/ปิดการควบคุมการจัดกลุ่มคอลัมน์แสดงอยู่หลังกลุ่ม

DataSourceSheetProperties

พร็อพเพอร์ตี้เพิ่มเติมของDATA_SOURCEชีต

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

string

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

columns[]

object (DataSourceColumn)

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

dataExecutionStatus

object (DataExecutionStatus)

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

GridData

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

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

integer

แถวแรกที่ GridData นี้หมายถึงค่าฐาน 0

startColumn

integer

คอลัมน์แรกที่ GridData อ้างอิง ซึ่งจะนับจาก 0

rowData[]

object (RowData)

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

rowMetadata[]

object (DimensionProperties)

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

columnMetadata[]

object (DimensionProperties)

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

RowData

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

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

object (CellData)

ค่าในแถว โดยให้มี 1 ค่าต่อคอลัมน์

DimensionProperties

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

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

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

ConditionalFormatRule

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

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

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

ฟิลด์สหภาพ rule กฎที่ควบคุมการจัดรูปแบบตามเงื่อนไขนี้ต้องกำหนดเพียง 1 รายการเท่านั้น rule ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
booleanRule

object (BooleanRule)

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

gradientRule

object (GradientRule)

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

BooleanRule

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

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

object (BooleanCondition)

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

format

object (CellFormat)

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

GradientRule

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

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

object (InterpolationPoint)

จุดเริ่มต้นของการหาค่าเฉลี่ยเชิงเส้น

midpoint

object (InterpolationPoint)

จุดการหาค่าเฉลี่ยระหว่างกลาง (ไม่บังคับ)

maxpoint

object (InterpolationPoint)

จุดสุดท้ายของการประมาณ

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

InterpolationPointType

ประเภทของจุดการหาค่าเฉลี่ยระหว่างจุด

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) (ระบบจะละเว้นข้อผิดพลาดในช่วงเมื่อทำการแบนราบ)

FilterView

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

การแสดง 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 ช่องในคำขออัปเดต ช่องนี้จะมีความสำคัญเหนือกว่า

ProtectedRange

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

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

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

ผู้แก้ไขช่วงที่ป้องกันไว้

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

string

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

groups[]

string

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

domainUsersCanEdit

boolean

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

BasicFilter

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

การแสดง 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 ช่องในคำขออัปเดต ช่องนี้จะมีความสำคัญเหนือกว่า

BandedRange

ช่วงที่มีแถบ (สลับสี) ในชีต

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

BandingProperties

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

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

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

สีที่ 2 ที่สลับกัน (ต้องระบุ) เลิกใช้งานแล้ว: ใช้ secondBandColorStyle

secondBandColorStyle

object (ColorStyle)

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

footerColor
(deprecated)

object (Color)

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

footerColorStyle

object (ColorStyle)

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

DimensionGroup

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

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

object (DimensionRange)

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

depth

integer

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

collapsed

boolean

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

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

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

ตัวแบ่งส่วนในชีต

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

integer

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

spec

object (SlicerSpec)

ข้อกําหนดของเครื่องแบ่ง

position

object (EmbeddedObjectPosition)

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

SlicerSpec

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

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

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

applyToPivotTables

boolean

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

title

string

ชื่อของเครื่องมือแบ่งส่วน

textFormat

object (TextFormat)

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

backgroundColor
(deprecated)

object (Color)

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

backgroundColorStyle

object (ColorStyle)

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

horizontalAlignment

enum (HorizontalAlign)

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