Requests

ส่งคำขอ

การอัปเดตประเภทเดียวที่ใช้กับสเปรดชีต

การแสดง JSON
{

  // Union field kind can be only one of the following:
  "updateSpreadsheetProperties": {
    object (UpdateSpreadsheetPropertiesRequest)
  },
  "updateSheetProperties": {
    object (UpdateSheetPropertiesRequest)
  },
  "updateDimensionProperties": {
    object (UpdateDimensionPropertiesRequest)
  },
  "updateNamedRange": {
    object (UpdateNamedRangeRequest)
  },
  "repeatCell": {
    object (RepeatCellRequest)
  },
  "addNamedRange": {
    object (AddNamedRangeRequest)
  },
  "deleteNamedRange": {
    object (DeleteNamedRangeRequest)
  },
  "addSheet": {
    object (AddSheetRequest)
  },
  "deleteSheet": {
    object (DeleteSheetRequest)
  },
  "autoFill": {
    object (AutoFillRequest)
  },
  "cutPaste": {
    object (CutPasteRequest)
  },
  "copyPaste": {
    object (CopyPasteRequest)
  },
  "mergeCells": {
    object (MergeCellsRequest)
  },
  "unmergeCells": {
    object (UnmergeCellsRequest)
  },
  "updateBorders": {
    object (UpdateBordersRequest)
  },
  "updateCells": {
    object (UpdateCellsRequest)
  },
  "addFilterView": {
    object (AddFilterViewRequest)
  },
  "appendCells": {
    object (AppendCellsRequest)
  },
  "clearBasicFilter": {
    object (ClearBasicFilterRequest)
  },
  "deleteDimension": {
    object (DeleteDimensionRequest)
  },
  "deleteEmbeddedObject": {
    object (DeleteEmbeddedObjectRequest)
  },
  "deleteFilterView": {
    object (DeleteFilterViewRequest)
  },
  "duplicateFilterView": {
    object (DuplicateFilterViewRequest)
  },
  "duplicateSheet": {
    object (DuplicateSheetRequest)
  },
  "findReplace": {
    object (FindReplaceRequest)
  },
  "insertDimension": {
    object (InsertDimensionRequest)
  },
  "insertRange": {
    object (InsertRangeRequest)
  },
  "moveDimension": {
    object (MoveDimensionRequest)
  },
  "updateEmbeddedObjectPosition": {
    object (UpdateEmbeddedObjectPositionRequest)
  },
  "pasteData": {
    object (PasteDataRequest)
  },
  "textToColumns": {
    object (TextToColumnsRequest)
  },
  "updateFilterView": {
    object (UpdateFilterViewRequest)
  },
  "deleteRange": {
    object (DeleteRangeRequest)
  },
  "appendDimension": {
    object (AppendDimensionRequest)
  },
  "addConditionalFormatRule": {
    object (AddConditionalFormatRuleRequest)
  },
  "updateConditionalFormatRule": {
    object (UpdateConditionalFormatRuleRequest)
  },
  "deleteConditionalFormatRule": {
    object (DeleteConditionalFormatRuleRequest)
  },
  "sortRange": {
    object (SortRangeRequest)
  },
  "setDataValidation": {
    object (SetDataValidationRequest)
  },
  "setBasicFilter": {
    object (SetBasicFilterRequest)
  },
  "addProtectedRange": {
    object (AddProtectedRangeRequest)
  },
  "updateProtectedRange": {
    object (UpdateProtectedRangeRequest)
  },
  "deleteProtectedRange": {
    object (DeleteProtectedRangeRequest)
  },
  "autoResizeDimensions": {
    object (AutoResizeDimensionsRequest)
  },
  "addChart": {
    object (AddChartRequest)
  },
  "updateChartSpec": {
    object (UpdateChartSpecRequest)
  },
  "updateBanding": {
    object (UpdateBandingRequest)
  },
  "addBanding": {
    object (AddBandingRequest)
  },
  "deleteBanding": {
    object (DeleteBandingRequest)
  },
  "createDeveloperMetadata": {
    object (CreateDeveloperMetadataRequest)
  },
  "updateDeveloperMetadata": {
    object (UpdateDeveloperMetadataRequest)
  },
  "deleteDeveloperMetadata": {
    object (DeleteDeveloperMetadataRequest)
  },
  "randomizeRange": {
    object (RandomizeRangeRequest)
  },
  "addDimensionGroup": {
    object (AddDimensionGroupRequest)
  },
  "deleteDimensionGroup": {
    object (DeleteDimensionGroupRequest)
  },
  "updateDimensionGroup": {
    object (UpdateDimensionGroupRequest)
  },
  "trimWhitespace": {
    object (TrimWhitespaceRequest)
  },
  "deleteDuplicates": {
    object (DeleteDuplicatesRequest)
  },
  "updateEmbeddedObjectBorder": {
    object (UpdateEmbeddedObjectBorderRequest)
  },
  "addSlicer": {
    object (AddSlicerRequest)
  },
  "updateSlicerSpec": {
    object (UpdateSlicerSpecRequest)
  },
  "addDataSource": {
    object (AddDataSourceRequest)
  },
  "updateDataSource": {
    object (UpdateDataSourceRequest)
  },
  "deleteDataSource": {
    object (DeleteDataSourceRequest)
  },
  "refreshDataSource": {
    object (RefreshDataSourceRequest)
  },
  "cancelDataSourceRefresh": {
    object (CancelDataSourceRefreshRequest)
  }
  // End of list of possible types for union field kind.
}
ช่อง
ช่องการรวม kind ประเภทของการอัปเดต ต้องระบุข้อมูลเพียงช่องเดียว kind ต้องเป็นอย่างใดอย่างหนึ่งต่อไปนี้เท่านั้น
updateSpreadsheetProperties

object (UpdateSpreadsheetPropertiesRequest)

อัปเดตพร็อพเพอร์ตี้ของสเปรดชีต

updateSheetProperties

object (UpdateSheetPropertiesRequest)

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

updateDimensionProperties

object (UpdateDimensionPropertiesRequest)

อัปเดตพร็อพเพอร์ตี้ของมิติข้อมูล

updateNamedRange

object (UpdateNamedRangeRequest)

อัปเดตช่วงที่ตั้งชื่อแล้ว

repeatCell

object (RepeatCellRequest)

ทำซ้ำเซลล์เดียวในช่วง

addNamedRange

object (AddNamedRangeRequest)

เพิ่มช่วงที่ตั้งชื่อแล้ว

deleteNamedRange

object (DeleteNamedRangeRequest)

ลบช่วงที่ตั้งชื่อแล้ว

addSheet

object (AddSheetRequest)

เพิ่มชีต

deleteSheet

object (DeleteSheetRequest)

ลบชีต

autoFill

object (AutoFillRequest)

กรอกข้อมูลเพิ่มเติมโดยอัตโนมัติตามข้อมูลที่มีอยู่

cutPaste

object (CutPasteRequest)

ตัดข้อมูลจากพื้นที่หนึ่งและวางไปยังอีกพื้นที่หนึ่ง

copyPaste

object (CopyPasteRequest)

คัดลอกข้อมูลจากพื้นที่หนึ่งและวางลงในอีกพื้นที่หนึ่ง

mergeCells

object (MergeCellsRequest)

ผสานเซลล์เข้าด้วยกัน

unmergeCells

object (UnmergeCellsRequest)

เลิกผสานเซลล์ที่ผสาน

updateBorders

object (UpdateBordersRequest)

อัปเดตเส้นขอบในช่วงของเซลล์

updateCells

object (UpdateCellsRequest)

อัปเดตหลายเซลล์พร้อมกัน

addFilterView

object (AddFilterViewRequest)

เพิ่มมุมมองตัวกรอง

appendCells

object (AppendCellsRequest)

เพิ่มเซลล์หลังแถวสุดท้ายด้วยข้อมูลในชีต

clearBasicFilter

object (ClearBasicFilterRequest)

ล้างตัวกรองพื้นฐานในชีต

deleteDimension

object (DeleteDimensionRequest)

ลบแถวหรือคอลัมน์ในชีต

deleteEmbeddedObject

object (DeleteEmbeddedObjectRequest)

ลบวัตถุที่ฝัง (เช่น แผนภูมิ รูปภาพ) ในชีต

deleteFilterView

object (DeleteFilterViewRequest)

ลบมุมมองตัวกรองออกจากชีต

duplicateFilterView

object (DuplicateFilterViewRequest)

ทำซ้ำมุมมองตัวกรอง

duplicateSheet

object (DuplicateSheetRequest)

ทำซ้ำชีต

findReplace

object (FindReplaceRequest)

ค้นหาและแทนที่ข้อความบางส่วนที่มีอยู่ด้วยข้อความอื่น

insertDimension

object (InsertDimensionRequest)

แทรกแถวหรือคอลัมน์ใหม่ในชีต

insertRange

object (InsertRangeRequest)

แทรกเซลล์ใหม่ในชีตและเลื่อนเซลล์ที่มีอยู่

moveDimension

object (MoveDimensionRequest)

ย้ายแถวหรือคอลัมน์ไปยังตำแหน่งอื่นในชีต

updateEmbeddedObjectPosition

object (UpdateEmbeddedObjectPositionRequest)

อัปเดตตำแหน่ง (เช่น แผนภูมิ รูปภาพ) ของวัตถุที่ฝัง

pasteData

object (PasteDataRequest)

วางข้อมูล (HTML หรือ Delimited) ลงในชีต

textToColumns

object (TextToColumnsRequest)

แปลงคอลัมน์ข้อความเป็นคอลัมน์ข้อความหลายคอลัมน์

updateFilterView

object (UpdateFilterViewRequest)

อัปเดตพร็อพเพอร์ตี้ของมุมมองตัวกรอง

deleteRange

object (DeleteRangeRequest)

ลบช่วงเซลล์ออกจากชีตและเลื่อนเซลล์ที่เหลือ

appendDimension

object (AppendDimensionRequest)

เพิ่มมิติข้อมูลต่อท้ายชีต

addConditionalFormatRule

object (AddConditionalFormatRuleRequest)

เพิ่มกฎการจัดรูปแบบตามเงื่อนไขใหม่

updateConditionalFormatRule

object (UpdateConditionalFormatRuleRequest)

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

deleteConditionalFormatRule

object (DeleteConditionalFormatRuleRequest)

ลบกฎการจัดรูปแบบตามเงื่อนไขที่มีอยู่

sortRange

object (SortRangeRequest)

จัดเรียงข้อมูลในช่วง

setDataValidation

object (SetDataValidationRequest)

ตั้งค่าการตรวจสอบข้อมูลสำหรับเซลล์อย่างน้อย 1 เซลล์

setBasicFilter

object (SetBasicFilterRequest)

ตั้งค่าตัวกรองพื้นฐานในชีต

addProtectedRange

object (AddProtectedRangeRequest)

เพิ่มช่วงที่มีการป้องกัน

updateProtectedRange

object (UpdateProtectedRangeRequest)

อัปเดตช่วงที่มีการป้องกัน

deleteProtectedRange

object (DeleteProtectedRangeRequest)

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

autoResizeDimensions

object (AutoResizeDimensionsRequest)

ปรับขนาดมิติข้อมูลอย่างน้อย 1 รายการโดยอัตโนมัติตามเนื้อหาของเซลล์ในมิติข้อมูลนั้น

addChart

object (AddChartRequest)

เพิ่มแผนภูมิ

updateChartSpec

object (UpdateChartSpecRequest)

อัปเดตข้อกำหนดของแผนภูมิ

updateBanding

object (UpdateBandingRequest)

อัปเดตช่วงแบบแบนด์

addBanding

object (AddBandingRequest)

เพิ่มช่วงแบบแบนด์ใหม่

deleteBanding

object (DeleteBandingRequest)

นำช่วงแบบแบนด์ออก

createDeveloperMetadata

object (CreateDeveloperMetadataRequest)

สร้างข้อมูลเมตาใหม่สำหรับนักพัฒนาซอฟต์แวร์

updateDeveloperMetadata

object (UpdateDeveloperMetadataRequest)

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

deleteDeveloperMetadata

object (DeleteDeveloperMetadataRequest)

ลบข้อมูลเมตาของนักพัฒนาซอฟต์แวร์

randomizeRange

object (RandomizeRangeRequest)

สุ่มลำดับของแถวในช่วง

addDimensionGroup

object (AddDimensionGroupRequest)

สร้างกลุ่มในช่วงที่ระบุ

deleteDimensionGroup

object (DeleteDimensionGroupRequest)

ลบกลุ่มในช่วงที่ระบุ

updateDimensionGroup

object (UpdateDimensionGroupRequest)

อัปเดตสถานะของกลุ่มที่ระบุ

trimWhitespace

object (TrimWhitespaceRequest)

ตัดเซลล์ของช่องว่าง (เช่น เว้นวรรค แท็บ หรือบรรทัดใหม่)

deleteDuplicates

object (DeleteDuplicatesRequest)

นำแถวที่มีค่าซ้ำกันในคอลัมน์ที่ระบุของช่วงเซลล์ออก

updateEmbeddedObjectBorder

object (UpdateEmbeddedObjectBorderRequest)

อัปเดตเส้นขอบของวัตถุที่ฝัง

addSlicer

object (AddSlicerRequest)

เพิ่มตัวควบคุมตัวกรอง

updateSlicerSpec

object (UpdateSlicerSpecRequest)

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

addDataSource

object (AddDataSourceRequest)

เพิ่มแหล่งข้อมูล

updateDataSource

object (UpdateDataSourceRequest)

อัปเดตแหล่งข้อมูล

deleteDataSource

object (DeleteDataSourceRequest)

ลบแหล่งข้อมูล

refreshDataSource

object (RefreshDataSourceRequest)

รีเฟรชแหล่งข้อมูลอย่างน้อย 1 รายการและ dbobject ที่เกี่ยวข้อง

cancelDataSourceRefresh

object (CancelDataSourceRefreshRequest)

ยกเลิกการรีเฟรชแหล่งข้อมูลอย่างน้อย 1 รายการและ dbobject ที่เกี่ยวข้อง

UpdateSpreadsheetPropertiesRequest

อัปเดตพร็อพเพอร์ตี้ของสเปรดชีต

การแสดง JSON
{
  "properties": {
    object (SpreadsheetProperties)
  },
  "fields": string
}
ช่อง
properties

object (SpreadsheetProperties)

พร็อพเพอร์ตี้ที่จะอัปเดต

fields

string (FieldMask format)

ช่องที่ควรอัปเดต ต้องระบุอย่างน้อย 1 ช่อง มีการระบุโดยนัยและไม่ควรระบุ "พร็อพเพอร์ตี้" รูท คุณใช้ "*" รายการเดียวเป็นค่าแบบสั้นในการแสดงทุกช่องได้

UpdateSheetPropertiesRequest

อัปเดตพร็อพเพอร์ตี้ของชีตด้วย sheetId ที่ระบุ

การแสดง JSON
{
  "properties": {
    object (SheetProperties)
  },
  "fields": string
}
ช่อง
properties

object (SheetProperties)

พร็อพเพอร์ตี้ที่จะอัปเดต

fields

string (FieldMask format)

ช่องที่ควรอัปเดต ต้องระบุอย่างน้อย 1 ช่อง ราก properties เป็นคำโดยนัยและไม่ควรระบุ คุณใช้ "*" รายการเดียวเป็นค่าแบบสั้นในการแสดงทุกช่องได้

UpdateDimensionPropertiesRequest

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

การแสดง JSON
{
  "properties": {
    object (DimensionProperties)
  },
  "fields": string,

  // Union field dimension_range can be only one of the following:
  "range": {
    object (DimensionRange)
  },
  "dataSourceSheetRange": {
    object (DataSourceSheetDimensionRange)
  }
  // End of list of possible types for union field dimension_range.
}
ช่อง
properties

object (DimensionProperties)

พร็อพเพอร์ตี้ที่จะอัปเดต

fields

string (FieldMask format)

ช่องที่ควรอัปเดต ต้องระบุอย่างน้อย 1 ช่อง ราก properties เป็นคำโดยนัยและไม่ควรระบุ คุณใช้ "*" รายการเดียวเป็นค่าแบบสั้นในการแสดงทุกช่องได้

ช่องการรวม dimension_range ช่วงมิติข้อมูล dimension_range ต้องเป็นอย่างใดอย่างหนึ่งต่อไปนี้เท่านั้น
range

object (DimensionRange)

แถวหรือคอลัมน์ที่จะอัปเดต

dataSourceSheetRange

object (DataSourceSheetDimensionRange)

คอลัมน์ในชีตแหล่งข้อมูลที่จะอัปเดต

DataSourceSheetDimensionRange

ช่วงตามมิติข้อมูลเดียวในชีต DATA_SOURCE

การแสดง JSON
{
  "sheetId": integer,
  "columnReferences": [
    {
      object (DataSourceColumnReference)
    }
  ]
}
ช่อง
sheetId

integer

รหัสของชีตแหล่งข้อมูลที่ช่วงดังกล่าวเปิดอยู่

columnReferences[]

object (DataSourceColumnReference)

คอลัมน์ในชีตแหล่งข้อมูล

UpdateNamedRangeRequest

อัปเดตพร็อพเพอร์ตี้ของช่วงที่ตั้งชื่อด้วย namedRangeId ที่ระบุ

การแสดง JSON
{
  "namedRange": {
    object (NamedRange)
  },
  "fields": string
}
ช่อง
namedRange

object (NamedRange)

ช่วงที่ตั้งชื่อแล้วที่จะอัปเดตด้วยพร็อพเพอร์ตี้ใหม่

fields

string (FieldMask format)

ช่องที่ควรอัปเดต ต้องระบุอย่างน้อย 1 ช่อง ราก namedRange เป็นคำโดยนัยและไม่ควรระบุ คุณใช้ "*" รายการเดียวเป็นค่าแบบสั้นในการแสดงทุกช่องได้

RepeatCellRequest

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

หากเขียนเซลล์ด้วยสูตร ช่วงของสูตรจะเพิ่มขึ้นโดยอัตโนมัติสําหรับแต่ละช่องในช่วง เช่น หากเขียนเซลล์ที่มีสูตร =A1 ในช่วง B2:C4, B2 จะเป็น =A1, B3 จะเป็น =A2, B4 จะเป็น =A3, C2 จะเป็น =B1, C3 จะเป็น =B2, C4 จะเป็น =B3

หากต้องการให้ช่วงของสูตรคงที่ ให้ใช้ตัวบ่งชี้ $ เช่น ใช้สูตร =$A$1 เพื่อป้องกันไม่ให้ทั้งแถวและคอลัมน์เพิ่มขึ้น

การแสดง JSON
{
  "range": {
    object (GridRange)
  },
  "cell": {
    object (CellData)
  },
  "fields": string
}
ช่อง
range

object (GridRange)

ช่วงที่จะให้แสดงเซลล์ซ้ำ

cell

object (CellData)

ข้อมูลที่จะเขียน

fields

string (FieldMask format)

ช่องที่ควรอัปเดต ต้องระบุอย่างน้อย 1 ช่อง ราก cell เป็นคำโดยนัยและไม่ควรระบุ คุณใช้ "*" รายการเดียวเป็นค่าแบบสั้นในการแสดงทุกช่องได้

AddNamedRangeRequest

เพิ่มช่วงที่ตั้งชื่อแล้วในสเปรดชีต

การแสดง JSON
{
  "namedRange": {
    object (NamedRange)
  }
}
ช่อง
namedRange

object (NamedRange)

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

DeleteNamedRangeRequest

นำช่วงที่ตั้งชื่อพร้อมรหัสที่กำหนดออกจากสเปรดชีต

การแสดง JSON
{
  "namedRangeId": string
}
ช่อง
namedRangeId

string

รหัสของช่วงที่ตั้งชื่อแล้วที่จะลบ

AddSheetRequest

เพิ่มชีตใหม่ เมื่อเพิ่มชีตที่ดัชนีที่กำหนดแล้ว ดัชนีของชีตที่ตามมาทั้งหมดจะเพิ่มขึ้น หากต้องการเพิ่มชีตออบเจ็กต์ ให้ใช้ AddChartRequest แทนและระบุ EmbeddedObjectPosition.sheetId หรือ EmbeddedObjectPosition.newSheet

การแสดง JSON
{
  "properties": {
    object (SheetProperties)
  }
}
ช่อง
properties

object (SheetProperties)

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

DeleteSheetRequest

ลบชีตที่ขอ

การแสดง JSON
{
  "sheetId": integer
}
ช่อง
sheetId

integer

รหัสของชีตที่จะลบ

หากชีตเป็นประเภท DATA_SOURCE ระบบจะลบ DataSource ที่เชื่อมโยงด้วย

AutoFillRequest

กรอกข้อมูลเพิ่มเติมตามข้อมูลที่มีอยู่

การแสดง JSON
{
  "useAlternateSeries": boolean,

  // Union field area can be only one of the following:
  "range": {
    object (GridRange)
  },
  "sourceAndDestination": {
    object (SourceAndDestination)
  }
  // End of list of possible types for union field area.
}
ช่อง
useAlternateSeries

boolean

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

ช่องการรวม area พื้นที่สำหรับป้อนข้อความอัตโนมัติ area ต้องเป็นอย่างใดอย่างหนึ่งต่อไปนี้เท่านั้น
range

object (GridRange)

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

sourceAndDestination

object (SourceAndDestination)

พื้นที่ต้นทางและปลายทางที่จะป้อนข้อความอัตโนมัติ ซึ่งจะแสดงแหล่งที่มาของการป้อนข้อความอัตโนมัติโดยละเอียด รวมถึงที่ที่จะขยายข้อมูลดังกล่าว

SourceAndDestination

ชุดค่าผสมของช่วงแหล่งที่มาและวิธีขยายแหล่งที่มาดังกล่าว

การแสดง JSON
{
  "source": {
    object (GridRange)
  },
  "dimension": enum (Dimension),
  "fillLength": integer
}
ช่อง
source

object (GridRange)

ตำแหน่งของข้อมูลที่จะใช้เป็นแหล่งที่มาของการป้อนข้อความอัตโนมัติ

dimension

enum (Dimension)

มิติข้อมูลที่ข้อมูลควรกรอก

fillLength

integer

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

CutPasteRequest

ย้ายข้อมูลจากต้นทางไปยังปลายทาง

การแสดง JSON
{
  "source": {
    object (GridRange)
  },
  "destination": {
    object (GridCoordinate)
  },
  "pasteType": enum (PasteType)
}
ช่อง
source

object (GridRange)

ข้อมูลต้นฉบับที่จะตัด

destination

object (GridCoordinate)

พิกัดด้านซ้ายบนที่ควรวางข้อมูล

pasteType

enum (PasteType)

ประเภทข้อมูลที่จะวาง ระบบจะตัดแหล่งข้อมูลทั้งหมด ไม่ว่าจะวางข้อมูลใดก็ตาม

PasteType

ควรวางข้อมูลประเภทใด

Enum
PASTE_NORMAL วางค่า สูตร รูปแบบ และการผสาน
PASTE_VALUES วางค่า โดยไม่มีรูปแบบ สูตร หรือการผสานเท่านั้น
PASTE_FORMAT วางรูปแบบและการตรวจสอบข้อมูลเท่านั้น
PASTE_NO_BORDERS เช่น PASTE_NORMAL แต่ไม่มีเส้นขอบ
PASTE_FORMULA วางเฉพาะสูตร
PASTE_DATA_VALIDATION วางเฉพาะการตรวจสอบข้อมูล
PASTE_CONDITIONAL_FORMATTING วางเฉพาะกฎการจัดรูปแบบตามเงื่อนไข

CopyPasteRequest

คัดลอกข้อมูลจากต้นทางไปยังปลายทาง

การแสดง JSON
{
  "source": {
    object (GridRange)
  },
  "destination": {
    object (GridRange)
  },
  "pasteType": enum (PasteType),
  "pasteOrientation": enum (PasteOrientation)
}
ช่อง
source

object (GridRange)

ช่วงแหล่งที่มาที่จะคัดลอก

destination

object (GridRange)

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

pasteType

enum (PasteType)

ประเภทข้อมูลที่จะวาง

pasteOrientation

enum (PasteOrientation)

วิธีการวางข้อมูลดังกล่าว

PasteOrientation

วิธีที่ควรดำเนินการวาง

Enum
NORMAL วางตามปกติ
TRANSPOSE วางสลับตำแหน่ง โดยแถวทั้งหมดจะกลายเป็นคอลัมน์ หรือกลับกัน

MergeCellsRequest

ผสานเซลล์ทั้งหมดในช่วง

การแสดง JSON
{
  "range": {
    object (GridRange)
  },
  "mergeType": enum (MergeType)
}
ช่อง
range

object (GridRange)

ช่วงของเซลล์ที่จะผสาน

mergeType

enum (MergeType)

วิธีผสานเซลล์

MergeType

ประเภทของการผสานที่จะสร้าง

Enum
MERGE_ALL สร้างการรวมรายการเดียวจากช่วง
MERGE_COLUMNS สร้างการผสานสำหรับแต่ละคอลัมน์ในช่วง
MERGE_ROWS สร้างการผสานสำหรับแต่ละแถวในช่วง

UnmergeCellsRequest

ยกเลิกการผสานเซลล์ในช่วงที่กำหนด

การแสดง JSON
{
  "range": {
    object (GridRange)
  }
}
ช่อง
range

object (GridRange)

ช่วงที่ควรยกเลิกการผสานเซลล์ทั้งหมด หากช่วงครอบคลุมการผสานหลายรายการ ระบบจะยกเลิกการผสานทั้งหมด ช่วงจะต้องไม่ครอบคลุมการผสานใดๆ บางส่วน

UpdateBordersRequest

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

  1. ช่วง: A1:A5 { top: RED, bottom: WHITE }
  2. ช่วง: A1:A5 { left: BLUE }

ซึ่งจะทำให้ A1:A5 มีเส้นขอบเป็น { top: RED, bottom: WHITE, left: BLUE } หากต้องการล้างเส้นขอบ ให้ตั้งค่ารูปแบบเป็น NONE อย่างชัดแจ้ง

การแสดง JSON
{
  "range": {
    object (GridRange)
  },
  "top": {
    object (Border)
  },
  "bottom": {
    object (Border)
  },
  "left": {
    object (Border)
  },
  "right": {
    object (Border)
  },
  "innerHorizontal": {
    object (Border)
  },
  "innerVertical": {
    object (Border)
  }
}
ช่อง
range

object (GridRange)

ช่วงที่จะอัปเดตเส้นขอบ

top

object (Border)

เส้นขอบที่จะวางที่ด้านบนของช่วง

bottom

object (Border)

เส้นขอบที่จะวางที่ด้านล่างของช่วง

left

object (Border)

เส้นขอบที่จะวางไว้ทางด้านซ้ายของช่วง

right

object (Border)

เส้นขอบที่จะวางไว้ทางด้านขวาของช่วง

innerHorizontal

object (Border)

เส้นขอบแนวนอนที่จะใส่ในช่วง

innerVertical

object (Border)

เส้นขอบแนวตั้งที่จะใส่ภายในช่วง

UpdateCellsRequest

อัปเดตเซลล์ทั้งหมดในช่วงด้วยข้อมูลใหม่

การแสดง JSON
{
  "rows": [
    {
      object (RowData)
    }
  ],
  "fields": string,

  // Union field area can be only one of the following:
  "start": {
    object (GridCoordinate)
  },
  "range": {
    object (GridRange)
  }
  // End of list of possible types for union field area.
}
ช่อง
rows[]

object (RowData)

ข้อมูลที่จะเขียน

fields

string (FieldMask format)

ช่องของ CellData ที่ควรอัปเดต ต้องระบุอย่างน้อย 1 ช่อง รูทคือ CellData ไม่ควรระบุ "row.values." คุณใช้ "*" รายการเดียวเป็นค่าแบบสั้นในการแสดงทุกช่องได้

ช่องการรวม area ควรมีการเขียนข้อมูลตำแหน่ง ต้องตั้งค่าเพียงค่าเดียว area ต้องเป็นอย่างใดอย่างหนึ่งต่อไปนี้เท่านั้น
start

object (GridCoordinate)

พิกัดที่จะเริ่มเขียนข้อมูล โดยจะเขียนได้กี่แถวและคอลัมน์ (รวมถึงจํานวนคอลัมน์ต่อแถวไม่เท่ากัน)

range

object (GridRange)

ช่วงที่จะเขียนข้อมูล

หากข้อมูลในแถวไม่ครอบคลุมช่วงที่ขอทั้งหมด ระบบจะล้างช่องที่ตรงกับการตั้งค่าใน fields

AddFilterViewRequest

เพิ่มมุมมองตัวกรอง

การแสดง JSON
{
  "filter": {
    object (FilterView)
  }
}
ช่อง
filter

object (FilterView)

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

AppendCellsRequest

เพิ่มเซลล์ใหม่หลังแถวสุดท้ายด้วยข้อมูลในชีต โดยแทรกแถวใหม่ลงในชีตหากจำเป็น

การแสดง JSON
{
  "sheetId": integer,
  "rows": [
    {
      object (RowData)
    }
  ],
  "fields": string
}
ช่อง
sheetId

integer

รหัสชีตที่จะต่อท้ายข้อมูล

rows[]

object (RowData)

ข้อมูลที่จะต่อท้าย

fields

string (FieldMask format)

ช่องของ CellData ที่ควรอัปเดต ต้องระบุอย่างน้อย 1 ช่อง รูทคือ CellData ไม่ควรระบุ "row.values." คุณใช้ "*" รายการเดียวเป็นค่าแบบสั้นในการแสดงทุกช่องได้

ClearBasicFilterRequest

ล้างตัวกรองพื้นฐาน หากมีในชีต

การแสดง JSON
{
  "sheetId": integer
}
ช่อง
sheetId

integer

รหัสชีตที่ควรล้างตัวกรองพื้นฐาน

DeleteDimensionRequest

ลบมิติข้อมูลออกจากชีต

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

object (DimensionRange)

มิติข้อมูลที่จะลบออกจากชีต

DeleteEmbeddedObjectRequest

ลบออบเจ็กต์ที่ฝังอยู่ที่มีรหัสที่กำหนด

การแสดง JSON
{
  "objectId": integer
}
ช่อง
objectId

integer

รหัสของออบเจ็กต์ที่ฝังที่จะลบ

DeleteFilterViewRequest

ลบมุมมองตัวกรองที่ต้องการ

การแสดง JSON
{
  "filterId": integer
}
ช่อง
filterId

integer

รหัสของตัวกรองที่จะลบ

DuplicateFilterViewRequest

ทำซ้ำมุมมองตัวกรองที่ต้องการ

การแสดง JSON
{
  "filterId": integer
}
ช่อง
filterId

integer

รหัสของตัวกรองที่ทำซ้ำ

DuplicateSheetRequest

ทำซ้ำเนื้อหาของชีต

การแสดง JSON
{
  "sourceSheetId": integer,
  "insertSheetIndex": integer,
  "newSheetId": integer,
  "newSheetName": string
}
ช่อง
sourceSheetId

integer

แผ่นงานที่จะทำซ้ำ

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

insertSheetIndex

integer

ดัชนีฐาน 0 ที่ควรแทรกแผ่นงานใหม่ ระบบจะเพิ่มดัชนีของชีตทั้งหมดหลังจากนี้

newSheetId

integer

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

newSheetName

string

ชื่อของชีตใหม่ หากเว้นว่างไว้ ระบบจะเลือกชื่อใหม่ให้คุณ

FindReplaceRequest

ค้นหาและแทนที่ข้อมูลในเซลล์ในช่วง แผ่นงาน หรือแผ่นงานทั้งหมด

การแสดง JSON
{
  "find": string,
  "replacement": string,
  "matchCase": boolean,
  "matchEntireCell": boolean,
  "searchByRegex": boolean,
  "includeFormulas": boolean,

  // Union field scope can be only one of the following:
  "range": {
    object (GridRange)
  },
  "sheetId": integer,
  "allSheets": boolean
  // End of list of possible types for union field scope.
}
ช่อง
find

string

ค่าที่จะค้นหา

replacement

string

ค่าที่จะใช้แทนที่

matchCase

boolean

เป็นจริงหากการค้นหาคำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่

matchEntireCell

boolean

เป็นจริงหากค่าการค้นหาควรตรงกับทั้งเซลล์

searchByRegex

boolean

เป็นจริงหากค่าการค้นหาเป็นนิพจน์ทั่วไป นิพจน์ทั่วไปและการแทนที่ควรเป็นไปตามกฎนิพจน์ทั่วไปของ Java ที่ https://docs.oracle.com/javase/8/docs/api/java/util/regex/Pattern.html สตริงการแทนที่ช่วยให้อ้างอิงถึงกลุ่มการจับภาพได้ เช่น หากเซลล์หนึ่งมีเนื้อหา "Google Sheets" และอีกเซลล์หนึ่งมีเนื้อหา "Google Docs" การค้นหา "o.* (.*)" ที่มีการแทนที่ "$1 Rocks" จะเปลี่ยนเนื้อหาของเซลล์เป็น "GSheets Rocks" และ "GDocs Rocks" ตามลำดับ

includeFormulas

boolean

เป็นจริงหากการค้นหาควรรวมเซลล์ที่มีสูตร "เท็จ" เพื่อข้ามเซลล์ที่มีสูตร

ช่องการรวม scope ขอบเขตที่จะค้นหา/แทนที่ ต้องกำหนดขอบเขตเดียวเท่านั้น scope ต้องเป็นอย่างใดอย่างหนึ่งต่อไปนี้เท่านั้น
range

object (GridRange)

ช่วงที่จะค้นหา/แทนที่

sheetId

integer

ชีตที่จะค้นหา/แทนที่

allSheets

boolean

ตั้งค่า "จริง" เพื่อหา/แทนที่ชีตทั้งหมด

InsertDimensionRequest

แทรกแถวหรือคอลัมน์ในชีตที่ดัชนีหนึ่งๆ

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

object (DimensionRange)

ขนาดที่จะแทรก ทั้งดัชนีเริ่มต้นและดัชนีสิ้นสุดต้องมีขอบเขต

inheritFromBefore

boolean

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

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

InsertRangeRequest

แทรกเซลล์ในช่วง โดยเลื่อนเซลล์ที่มีอยู่ขึ้นหรือลง

การแสดง JSON
{
  "range": {
    object (GridRange)
  },
  "shiftDimension": enum (Dimension)
}
ช่อง
range

object (GridRange)

ช่วงที่จะแทรกเซลล์ใหม่

shiftDimension

enum (Dimension)

มิติข้อมูลที่จะเลื่อนเมื่อแทรกเซลล์ หาก ROWS เซลล์ที่มีอยู่จะถูกเลื่อนลง หาก COLUMNS เซลล์ที่มีอยู่จะถูกเลื่อนไปทางขวา

MoveDimensionRequest

ย้ายแถวหรือคอลัมน์อย่างน้อย 1 รายการ

การแสดง JSON
{
  "source": {
    object (DimensionRange)
  },
  "destinationIndex": integer
}
ช่อง
source

object (DimensionRange)

มิติข้อมูลแหล่งที่มาที่จะย้าย

destinationIndex

integer

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

ตัวอย่างเช่น หาก A1..A5 เป็น 0, 1, 2, 3, 4 และต้องการย้าย "1" และ "2" ไประหว่าง "3" กับ "4" ต้นทางจะเป็น ROWS [1..3) และดัชนีปลายทางจะเป็น "4" (ดัชนีฐาน 0 ของแถว 5) ผลลัพธ์สุดท้ายจะเป็น A1..A5 จาก 0, 3, 1, 2, 4

UpdateEmbeddedObjectPositionRequest

อัปเดตตำแหน่งของวัตถุที่ฝัง (เช่น การย้ายหรือการปรับขนาดแผนภูมิหรือรูปภาพ)

การแสดง JSON
{
  "objectId": integer,
  "newPosition": {
    object (EmbeddedObjectPosition)
  },
  "fields": string
}
ช่อง
objectId

integer

รหัสของออบเจ็กต์ที่จะย้าย

newPosition

object (EmbeddedObjectPosition)

ตำแหน่งที่ชัดเจนในการย้ายออบเจ็กต์ที่ฝังไป หากตั้งค่า newPosition.sheetId ระบบจะสร้างชีตใหม่ที่มีรหัสดังกล่าว หากตั้งค่า newPosition.newSheet เป็น "จริง" ระบบจะสร้างชีตใหม่พร้อมรหัสที่จะเลือกให้คุณ

fields

string (FieldMask format)

ช่องของ OverlayPosition ที่ควรอัปเดตเมื่อตั้งค่าตำแหน่งใหม่ ใช้เฉพาะเมื่อมีการตั้งค่า newPosition.overlayPosition ซึ่งในกรณีนี้ต้องระบุอย่างน้อย 1 ช่อง ราก newPosition.overlayPosition เป็นคำโดยนัยและไม่ควรระบุ คุณใช้ "*" รายการเดียวเป็นค่าแบบสั้นในการแสดงทุกช่องได้

PasteDataRequest

แทรกข้อมูลลงในสเปรดชีตโดยเริ่มต้นจากพิกัดที่ระบุ

การแสดง JSON
{
  "coordinate": {
    object (GridCoordinate)
  },
  "data": string,
  "type": enum (PasteType),

  // Union field kind can be only one of the following:
  "delimiter": string,
  "html": boolean
  // End of list of possible types for union field kind.
}
ช่อง
coordinate

object (GridCoordinate)

พิกัดที่ควรเริ่มแทรกข้อมูล

data

string

ข้อมูลที่จะแทรก

type

enum (PasteType)

วิธีวางข้อมูล

ช่องการรวม kind วิธีตีความข้อมูล จะต้องตั้งค่าเพียงค่าเดียว kind ต้องเป็นอย่างใดอย่างหนึ่งต่อไปนี้เท่านั้น
delimiter

string

ตัวคั่นในข้อมูล

html

boolean

เป็นจริงหากข้อมูลเป็น HTML

TextToColumnsRequest

แบ่งคอลัมน์ข้อความออกเป็นหลายคอลัมน์ตามตัวคั่นในแต่ละเซลล์

การแสดง JSON
{
  "source": {
    object (GridRange)
  },
  "delimiter": string,
  "delimiterType": enum (DelimiterType)
}
ช่อง
source

object (GridRange)

ช่วงข้อมูลต้นฉบับ ซึ่งต้องครอบคลุมคอลัมน์เดียว

delimiter

string

ตัวคั่นที่จะใช้ ใช้เมื่อ delimiterType เป็น CUSTOM เท่านั้น

delimiterType

enum (DelimiterType)

ประเภทตัวคั่นที่จะใช้

DelimiterType

ตัวคั่นที่จะแยก

Enum
DELIMITER_TYPE_UNSPECIFIED ค่าเริ่มต้น ต้องไม่ใช้ค่านี้
COMMA ","
SEMICOLON ";"
PERIOD "."
SPACE " "
CUSTOM ค่าที่กำหนดเองตามที่กำหนดไว้ในตัวคั่น
AUTODETECT ตรวจหาคอลัมน์อัตโนมัติ

UpdateFilterViewRequest

อัปเดตพร็อพเพอร์ตี้ของมุมมองตัวกรอง

การแสดง JSON
{
  "filter": {
    object (FilterView)
  },
  "fields": string
}
ช่อง
filter

object (FilterView)

พร็อพเพอร์ตี้ใหม่ของมุมมองตัวกรอง

fields

string (FieldMask format)

ช่องที่ควรอัปเดต ต้องระบุอย่างน้อย 1 ช่อง ราก filter เป็นคำโดยนัยและไม่ควรระบุ คุณใช้ "*" รายการเดียวเป็นค่าแบบสั้นในการแสดงทุกช่องได้

DeleteRangeRequest

ลบช่วงของเซลล์ และย้ายเซลล์อื่นไปยังพื้นที่ที่ลบไปแล้ว

การแสดง JSON
{
  "range": {
    object (GridRange)
  },
  "shiftDimension": enum (Dimension)
}
ช่อง
range

object (GridRange)

ช่วงของเซลล์ที่จะลบ

shiftDimension

enum (Dimension)

มิติข้อมูลที่จะแทนที่ด้วยเซลล์ที่ถูกลบ หากเป็น ROWS ระบบจะเลื่อนเซลล์ที่มีอยู่ขึ้นด้านบนเพื่อแทนที่เซลล์ที่ลบแล้ว หาก COLUMNS ระบบจะเลื่อนเซลล์ที่มีอยู่ไปทางซ้ายเพื่อแทนที่เซลล์ที่ลบแล้ว

AppendDimensionRequest

เพิ่มแถวหรือคอลัมน์ต่อท้ายชีต

การแสดง JSON
{
  "sheetId": integer,
  "dimension": enum (Dimension),
  "length": integer
}
ช่อง
sheetId

integer

แผ่นงานที่ต้องการเพิ่มแถวหรือคอลัมน์ต่อท้าย

dimension

enum (Dimension)

ควรเพิ่มแถวหรือคอลัมน์

length

integer

จำนวนแถวหรือคอลัมน์ที่จะต่อท้าย

AddConditionalFormatRuleRequest

เพิ่มกฎการจัดรูปแบบตามเงื่อนไขใหม่ในดัชนีที่กำหนด และระบบจะเพิ่มดัชนีของกฎข้อต่อๆ ไปทั้งหมด

การแสดง JSON
{
  "rule": {
    object (ConditionalFormatRule)
  },
  "index": integer
}
ช่อง
rule

object (ConditionalFormatRule)

กฎที่จะเพิ่ม

index

integer

ดัชนีฐาน 0 ที่ควรแทรกกฎ

UpdateConditionalFormatRuleRequest

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

การแสดง JSON
{
  "index": integer,
  "sheetId": integer,

  // Union field instruction can be only one of the following:
  "rule": {
    object (ConditionalFormatRule)
  },
  "newIndex": integer
  // End of list of possible types for union field instruction.
}
ช่อง
index

integer

ดัชนีฐาน 0 ของกฎที่ควรถูกแทนที่หรือย้าย

sheetId

integer

ชีตของกฎที่จะย้าย ต้องระบุหากตั้งค่า newIndex ไว้ หากไม่ได้ใช้

ช่องการรวม instruction ประเภทของการอัปเดตที่ควรจะเกิดขึ้น instruction ต้องเป็นอย่างใดอย่างหนึ่งต่อไปนี้เท่านั้น
rule

object (ConditionalFormatRule)

กฎที่ควรแทนที่กฎในดัชนีที่ระบุ

newIndex

integer

ดัชนีใหม่ที่อิงตามศูนย์ที่กฎควรสิ้นสุดลง

DeleteConditionalFormatRuleRequest

ลบกฎการจัดรูปแบบตามเงื่อนไขที่ดัชนีที่กำหนด ระบบจะลดดัชนีของกฎข้อต่อๆ ไปทั้งหมด

การแสดง JSON
{
  "index": integer,
  "sheetId": integer
}
ช่อง
index

integer

ดัชนีฐาน 0 ของกฎที่จะถูกลบ

sheetId

integer

แผ่นงานที่มีการลบกฎ

SortRangeRequest

จัดเรียงข้อมูลในแถวตามลำดับการจัดเรียงต่อคอลัมน์

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

object (GridRange)

ช่วงที่จะจัดเรียง

sortSpecs[]

object (SortSpec)

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

SetDataValidationRequest

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

การแสดง JSON
{
  "range": {
    object (GridRange)
  },
  "rule": {
    object (DataValidationRule)
  }
}
ช่อง
range

object (GridRange)

ช่วงที่ควรใช้กฎการตรวจสอบข้อมูล

rule

object (DataValidationRule)

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

SetBasicFilterRequest

ตั้งค่าตัวกรองพื้นฐานที่เชื่อมโยงกับชีต

การแสดง JSON
{
  "filter": {
    object (BasicFilter)
  }
}
ช่อง
filter

object (BasicFilter)

ตัวกรองที่จะตั้งค่า

AddProtectedRangeRequest

เพิ่มช่วงที่มีการป้องกันใหม่

การแสดง JSON
{
  "protectedRange": {
    object (ProtectedRange)
  }
}
ช่อง
protectedRange

object (ProtectedRange)

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

UpdateProtectedRangeRequest

อัปเดตช่วงที่ป้องกันไว้ที่มีอยู่ด้วย protectedRangeId ที่ระบุ

การแสดง JSON
{
  "protectedRange": {
    object (ProtectedRange)
  },
  "fields": string
}
ช่อง
protectedRange

object (ProtectedRange)

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

fields

string (FieldMask format)

ช่องที่ควรอัปเดต ต้องระบุอย่างน้อย 1 ช่อง ราก protectedRange เป็นคำโดยนัยและไม่ควรระบุ คุณใช้ "*" รายการเดียวเป็นค่าแบบสั้นในการแสดงทุกช่องได้

DeleteProtectedRangeRequest

ลบช่วงที่ป้องกันไว้ที่มีรหัสที่ระบุ

การแสดง JSON
{
  "protectedRangeId": integer
}
ช่อง
protectedRangeId

integer

รหัสของช่วงที่ป้องกันไว้ที่จะลบ

AutoResizeDimensionsRequest

ปรับขนาดมิติข้อมูลอย่างน้อย 1 รายการโดยอัตโนมัติตามเนื้อหาของเซลล์ในมิติข้อมูลนั้น

การแสดง JSON
{

  // Union field dimension_range can be only one of the following:
  "dimensions": {
    object (DimensionRange)
  },
  "dataSourceSheetDimensions": {
    object (DataSourceSheetDimensionRange)
  }
  // End of list of possible types for union field dimension_range.
}
ช่อง
ช่องการรวม dimension_range ช่วงมิติข้อมูล dimension_range ต้องเป็นอย่างใดอย่างหนึ่งต่อไปนี้เท่านั้น
dimensions

object (DimensionRange)

ขนาดที่จะปรับขนาดโดยอัตโนมัติ

dataSourceSheetDimensions

object (DataSourceSheetDimensionRange)

มิติข้อมูลในชีตแหล่งข้อมูลที่จะปรับขนาดโดยอัตโนมัติ

AddChartRequest

เพิ่มแผนภูมิลงในชีตในสเปรดชีต

การแสดง JSON
{
  "chart": {
    object (EmbeddedChart)
  }
}
ช่อง
chart

object (EmbeddedChart)

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

UpdateChartSpecRequest

อัปเดตข้อกำหนดของแผนภูมิ (การดำเนินการนี้จะไม่ย้ายหรือปรับขนาดแผนภูมิ หากต้องการย้ายหรือปรับขนาดแผนภูมิ ให้ใช้ UpdateEmbeddedObjectPositionRequest)

การแสดง JSON
{
  "chartId": integer,
  "spec": {
    object (ChartSpec)
  }
}
ช่อง
chartId

integer

รหัสของแผนภูมิที่จะอัปเดต

spec

object (ChartSpec)

ข้อกำหนดที่จะนำไปใช้กับแผนภูมิ

UpdateBandingRequest

อัปเดตคุณสมบัติของช่วงแถบสีที่ระบุ

การแสดง JSON
{
  "bandedRange": {
    object (BandedRange)
  },
  "fields": string
}
ช่อง
bandedRange

object (BandedRange)

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

fields

string (FieldMask format)

ช่องที่ควรอัปเดต ต้องระบุอย่างน้อย 1 ช่อง ราก bandedRange เป็นคำโดยนัยและไม่ควรระบุ คุณใช้ "*" รายการเดียวเป็นค่าแบบสั้นในการแสดงทุกช่องได้

AddBandingRequest

เพิ่มช่วงของช่วงสีใหม่ในสเปรดชีต

การแสดง JSON
{
  "bandedRange": {
    object (BandedRange)
  }
}
ช่อง
bandedRange

object (BandedRange)

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

DeleteBandingRequest

นำช่วงที่จัดกลุ่มไว้ที่มีรหัสที่ระบุออกจากสเปรดชีต

การแสดง JSON
{
  "bandedRangeId": integer
}
ช่อง
bandedRangeId

integer

รหัสของช่วงของช่วงที่จะลบ

CreateDeveloperMetadataRequest

คำขอสร้างข้อมูลเมตาของนักพัฒนาแอป

การแสดง JSON
{
  "developerMetadata": {
    object (DeveloperMetadata)
  }
}
ช่อง
developerMetadata

object (DeveloperMetadata)

ข้อมูลเมตาของนักพัฒนาซอฟต์แวร์ที่จะสร้าง

UpdateDeveloperMetadataRequest

คำขออัปเดตพร็อพเพอร์ตี้ของข้อมูลเมตาของนักพัฒนาแอป อัปเดตพร็อพเพอร์ตี้ของข้อมูลเมตาของนักพัฒนาแอปที่ตัวกรองเลือกเป็นค่าที่ระบุไว้ในทรัพยากร DeveloperMetadata ผู้โทรต้องระบุพร็อพเพอร์ตี้ที่ต้องการอัปเดตในพารามิเตอร์ช่อง รวมทั้งระบุ DataFilter อย่างน้อย 1 รายการที่ตรงกับข้อมูลเมตาที่ต้องการอัปเดต

การแสดง JSON
{
  "dataFilters": [
    {
      object (DataFilter)
    }
  ],
  "developerMetadata": {
    object (DeveloperMetadata)
  },
  "fields": string
}
ช่อง
dataFilters[]

object (DataFilter)

ตัวกรองที่ตรงกับรายการข้อมูลเมตาของนักพัฒนาซอฟต์แวร์ที่จะอัปเดต

developerMetadata

object (DeveloperMetadata)

ค่าที่ระบบจะอัปเดตข้อมูลเมตาทั้งหมดที่ตรงกับตัวกรองข้อมูล

fields

string (FieldMask format)

ช่องที่ควรอัปเดต ต้องระบุอย่างน้อย 1 ช่อง ราก developerMetadata เป็นคำโดยนัยและไม่ควรระบุ คุณใช้ "*" รายการเดียวเป็นค่าแบบสั้นในการแสดงทุกช่องได้

DeleteDeveloperMetadataRequest

คำขอลบข้อมูลเมตาของนักพัฒนาแอป

การแสดง JSON
{
  "dataFilter": {
    object (DataFilter)
  }
}
ช่อง
dataFilter

object (DataFilter)

ตัวกรองข้อมูลที่อธิบายเกณฑ์ที่ใช้เลือกรายการข้อมูลเมตาของนักพัฒนาแอปที่จะลบ

RandomizeRangeRequest

สุ่มลำดับของแถวในช่วง

การแสดง JSON
{
  "range": {
    object (GridRange)
  }
}
ช่อง
range

object (GridRange)

ช่วงที่จะสุ่ม

AddDimensionGroupRequest

สร้างกลุ่มในช่วงที่ระบุ

ถ้าช่วงที่ขอคือชุดพิเศษของช่วงของกลุ่ม G ที่มีอยู่แล้ว ความลึกของ G จะเพิ่มขึ้น และกลุ่มใหม่ G จะมีความลึกของกลุ่มนั้น เช่น กลุ่ม [C:D, deeplink 1] + [B:E] จะให้ผลลัพธ์เป็นกลุ่ม [B:E, deeplink 1] และ [C:D, deeplink 2] ถ้าช่วงที่ขอเป็นชุดย่อยของช่วงของกลุ่ม G ที่มีอยู่ ความลึกของกลุ่ม G ใหม่จะมากกว่าความลึกของ G หนึ่ง เช่น กลุ่ม [B:E, deeplink 1] + [C:D] จะให้ผลลัพธ์เป็นกลุ่ม [B:E, deeplink 1] และ [C:D, deeplink 2] ถ้าช่วงที่ขอเริ่มต้นก่อนและสิ้นสุดภายใน หรือเริ่มต้นภายในและสิ้นสุดหลังจากช่วงของกลุ่ม G ที่มีอยู่ ช่วงของกลุ่ม G ที่มีอยู่จะกลายเป็นการรวมของช่วง และกลุ่มใหม่ G มีความลึกมากกว่าความลึกของ G และช่วงเป็นอินเตอร์เซกชันของช่วง เช่น กลุ่ม [B:D, deeplink 1] + [C:E] จะได้ผลลัพธ์เป็นกลุ่ม [B:E, deeplink 1] และ [C:D, deeplink 2]

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

object (DimensionRange)

ช่วงที่จะสร้างกลุ่ม

DeleteDimensionGroupRequest

ลบกลุ่มในช่วงที่ระบุโดยลดความลึกของมิติข้อมูลในช่วง

ตัวอย่างเช่น สมมติว่าชีตมีกลุ่มความลึก 1 ส่วน B:E และกลุ่มความลึก 2 เกิน C:D การลบกลุ่มใน "D:E" จะทำให้ชีตมีกลุ่มความลึก 1 ส่วน B:D และกลุ่มความลึก 2 อยู่เหนือ C:C

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

object (DimensionRange)

ช่วงของกลุ่มที่จะลบ

UpdateDimensionGroupRequest

อัปเดตสถานะของกลุ่มที่ระบุ

การแสดง JSON
{
  "dimensionGroup": {
    object (DimensionGroup)
  },
  "fields": string
}
ช่อง
dimensionGroup

object (DimensionGroup)

กลุ่มที่ควรอัปเดตสถานะ ช่วงและความลึกของกลุ่มควรระบุกลุ่มที่ถูกต้องในชีตและอัปเดตข้อมูลในช่องอื่นๆ ทั้งหมด

fields

string (FieldMask format)

ช่องที่ควรอัปเดต ต้องระบุอย่างน้อย 1 ช่อง ราก dimensionGroup เป็นคำโดยนัยและไม่ควรระบุ คุณใช้ "*" รายการเดียวเป็นค่าแบบสั้นในการแสดงทุกช่องได้

TrimWhitespaceRequest

ตัดช่องว่าง (เช่น เว้นวรรค แท็บ หรือบรรทัดใหม่) ในทุกเซลล์ในช่วงที่ระบุ คำขอนี้จะนำช่องว่างทั้งหมดออกจากจุดเริ่มต้นและจุดสิ้นสุดของข้อความของแต่ละเซลล์ และลดอักขระช่องว่างที่ตามมาเป็นช่องว่างเดียว หากข้อความที่ตัดแล้วขึ้นต้นด้วยอักขระ '+' หรือ '=' ข้อความจะยังคงเป็นค่าสตริงและระบบจะไม่ตีความว่าเป็นสูตร

การแสดง JSON
{
  "range": {
    object (GridRange)
  }
}
ช่อง
range

object (GridRange)

ช่วงที่เซลล์ที่จะตัด

DeleteDuplicatesRequest

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

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

การแสดง JSON
{
  "range": {
    object (GridRange)
  },
  "comparisonColumns": [
    {
      object (DimensionRange)
    }
  ]
}
ช่อง
range

object (GridRange)

ช่วงที่จะนําแถวที่ซ้ำออก

comparisonColumns[]

object (DimensionRange)

คอลัมน์ในช่วงที่จะวิเคราะห์ค่าที่ซ้ำกัน หากไม่ได้เลือกคอลัมน์ไว้ คอลัมน์ทั้งหมดจะได้รับการวิเคราะห์เพื่อหาคอลัมน์ที่ซ้ำกัน

UpdateEmbeddedObjectBorderRequest

อัปเดตพร็อพเพอร์ตี้เส้นขอบของออบเจ็กต์ที่ฝัง

การแสดง JSON
{
  "objectId": integer,
  "border": {
    object (EmbeddedObjectBorder)
  },
  "fields": string
}
ช่อง
objectId

integer

รหัสของออบเจ็กต์ที่ฝังที่จะอัปเดต

border

object (EmbeddedObjectBorder)

เส้นขอบที่ใช้กับวัตถุที่ฝัง

fields

string (FieldMask format)

ช่องที่ควรอัปเดต ต้องระบุอย่างน้อย 1 ช่อง ราก border เป็นคำโดยนัยและไม่ควรระบุ คุณใช้ "*" รายการเดียวเป็นค่าแบบสั้นในการแสดงทุกช่องได้

AddSlicerRequest

เพิ่มตัวควบคุมตัวกรองลงในชีตในสเปรดชีต

การแสดง JSON
{
  "slicer": {
    object (Slicer)
  }
}
ช่อง
slicer

object (Slicer)

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

UpdateSlicerSpecRequest

อัปเดตข้อกำหนดของตัวควบคุมตัวกรอง (ระบบจะไม่ย้ายหรือปรับขนาดตัวควบคุมตัวกรอง หากต้องการย้ายหรือปรับขนาดตัวควบคุมตัวกรอง ให้ใช้ UpdateEmbeddedObjectPositionRequest

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

integer

รหัสของตัวควบคุมตัวกรองที่จะอัปเดต

spec

object (SlicerSpec)

ข้อกำหนดที่จะใช้กับตัวควบคุมตัวกรอง

fields

string (FieldMask format)

ช่องที่ควรอัปเดต ต้องระบุอย่างน้อย 1 ช่อง ราก SlicerSpec เป็นคำโดยนัยและไม่ควรระบุ ใช้ "*"" เดียวเป็นคำสั้นๆ ในการระบุทุกช่องได้

AddDataSourceRequest

เพิ่มแหล่งข้อมูล หลังจากเพิ่มแหล่งข้อมูลเรียบร้อยแล้ว ระบบจะสร้างชีต DATA_SOURCE ที่เชื่อมโยงและเรียกให้มีการเรียกใช้เพื่อรีเฟรชชีตเพื่ออ่านข้อมูลจากแหล่งข้อมูล คำขอต้องการขอบเขต OAuth bigquery.readonly เพิ่มเติม

การแสดง JSON
{
  "dataSource": {
    object (DataSource)
  }
}
ช่อง
dataSource

object (DataSource)

แหล่งข้อมูลที่จะเพิ่ม

UpdateDataSourceRequest

อัปเดตแหล่งข้อมูล หลังจากอัปเดตแหล่งข้อมูลสำเร็จแล้ว ระบบจะทริกเกอร์การดำเนินการเพื่อรีเฟรชชีต DATA_SOURCE ที่เชื่อมโยงเพื่ออ่านข้อมูลจากแหล่งข้อมูลที่อัปเดตแล้ว คำขอต้องการขอบเขต OAuth bigquery.readonly เพิ่มเติม

การแสดง JSON
{
  "dataSource": {
    object (DataSource)
  },
  "fields": string
}
ช่อง
dataSource

object (DataSource)

แหล่งข้อมูลที่จะอัปเดต

fields

string (FieldMask format)

ช่องที่ควรอัปเดต ต้องระบุอย่างน้อย 1 ช่อง ราก dataSource เป็นคำโดยนัยและไม่ควรระบุ คุณใช้ "*" รายการเดียวเป็นค่าแบบสั้นในการแสดงทุกช่องได้

DeleteDataSourceRequest

ลบแหล่งข้อมูล คำขอจะลบชีตแหล่งข้อมูลที่เกี่ยวข้องและยกเลิกการลิงก์ออบเจ็กต์แหล่งข้อมูลที่เกี่ยวข้องทั้งหมด

การแสดง JSON
{
  "dataSourceId": string
}
ช่อง
dataSourceId

string

รหัสของแหล่งข้อมูลที่จะลบ

RefreshDataSourceRequest

รีเฟรชออบเจ็กต์แหล่งข้อมูลอย่างน้อย 1 รายการในสเปรดชีตโดยใช้การอ้างอิงที่ระบุ คำขอต้องการขอบเขต OAuth bigquery.readonly เพิ่มเติม

หากมีคำขอรีเฟรชหลายรายการที่อ้างอิงออบเจ็กต์แหล่งข้อมูลเดียวกันในกลุ่มเดียว ระบบจะประมวลผลเฉพาะคำขอรีเฟรชล่าสุด และคำขอเหล่านั้นทั้งหมดจะมีการตอบกลับแบบเดียวกัน

การแสดง JSON
{
  "force": boolean,

  // Union field target can be only one of the following:
  "references": {
    object (DataSourceObjectReferences)
  },
  "dataSourceId": string,
  "isAll": boolean
  // End of list of possible types for union field target.
}
ช่อง
force

boolean

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

ช่องการรวม target ระบุสิ่งที่จะรีเฟรช target ต้องเป็นอย่างใดอย่างหนึ่งต่อไปนี้เท่านั้น
references

object (DataSourceObjectReferences)

การอ้างอิงออบเจ็กต์แหล่งข้อมูลเพื่อรีเฟรช

dataSourceId

string

การอ้างอิงถึง DataSource หากระบุไว้ ให้รีเฟรชออบเจ็กต์แหล่งข้อมูลที่เกี่ยวข้องทั้งหมดสำหรับแหล่งข้อมูลนั้น

isAll

boolean

รีเฟรชออบเจ็กต์แหล่งข้อมูลที่มีอยู่ทั้งหมดในสเปรดชีต

DataSourceObjectReferences

รายการการอ้างอิงไปยังออบเจ็กต์แหล่งข้อมูล

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

object (DataSourceObjectReference)

ข้อมูลอ้างอิง

DataSourceObjectReference

การอ้างอิงออบเจ็กต์แหล่งข้อมูล

การแสดง JSON
{

  // Union field value can be only one of the following:
  "sheetId": string,
  "chartId": integer,
  "dataSourceTableAnchorCell": {
    object (GridCoordinate)
  },
  "dataSourcePivotTableAnchorCell": {
    object (GridCoordinate)
  },
  "dataSourceFormulaCell": {
    object (GridCoordinate)
  }
  // End of list of possible types for union field value.
}
ช่อง
ช่องการรวม value ประเภทการอ้างอิง value ต้องเป็นอย่างใดอย่างหนึ่งต่อไปนี้เท่านั้น
sheetId

string

การอ้างอิงชีต DATA_SOURCE

chartId

integer

การอ้างอิงไปยังแผนภูมิแหล่งข้อมูล

dataSourceTableAnchorCell

object (GridCoordinate)

การอ้างอิงไปยัง DataSourceTable ที่ตรึงไว้ในเซลล์

dataSourcePivotTableAnchorCell

object (GridCoordinate)

การอ้างอิงไปยังแหล่งข้อมูล PivotTable ที่ตรึงไว้ในเซลล์

dataSourceFormulaCell

object (GridCoordinate)

การอ้างอิงไปยังเซลล์ที่มี DataSourceFormula

CancelDataSourceRefreshRequest

ยกเลิกการรีเฟรชออบเจ็กต์แหล่งข้อมูลอย่างน้อย 1 รายการในสเปรดชีตตามการอ้างอิงที่ระบุ

การแสดง JSON
{

  // Union field target can be only one of the following:
  "references": {
    object (DataSourceObjectReferences)
  },
  "dataSourceId": string,
  "isAll": boolean
  // End of list of possible types for union field target.
}
ช่อง
ช่องการรวม target ระบุสิ่งที่จะยกเลิก target ต้องเป็นอย่างใดอย่างหนึ่งต่อไปนี้เท่านั้น
references

object (DataSourceObjectReferences)

การอ้างอิงไปยังออบเจ็กต์แหล่งข้อมูลที่มีการยกเลิกการรีเฟรช

dataSourceId

string

การอ้างอิงถึง DataSource หากระบุไว้ จะยกเลิกการรีเฟรชออบเจ็กต์แหล่งข้อมูลที่เกี่ยวข้องทั้งหมดของแหล่งข้อมูลนี้

isAll

boolean

ยกเลิกการรีเฟรชออบเจ็กต์แหล่งข้อมูลที่มีอยู่ทั้งหมดสำหรับแหล่งข้อมูลทั้งหมดในสเปรดชีต