Responses

คำตอบ

คำตอบเดียวจากการอัปเดต

การแสดง JSON 
{

  // Union field kind can be only one of the following:
  "addNamedRange": {
    object (AddNamedRangeResponse)
  },
  "addSheet": {
    object (AddSheetResponse)
  },
  "addFilterView": {
    object (AddFilterViewResponse)
  },
  "duplicateFilterView": {
    object (DuplicateFilterViewResponse)
  },
  "duplicateSheet": {
    object (DuplicateSheetResponse)
  },
  "findReplace": {
    object (FindReplaceResponse)
  },
  "updateEmbeddedObjectPosition": {
    object (UpdateEmbeddedObjectPositionResponse)
  },
  "updateConditionalFormatRule": {
    object (UpdateConditionalFormatRuleResponse)
  },
  "deleteConditionalFormatRule": {
    object (DeleteConditionalFormatRuleResponse)
  },
  "addProtectedRange": {
    object (AddProtectedRangeResponse)
  },
  "addChart": {
    object (AddChartResponse)
  },
  "addBanding": {
    object (AddBandingResponse)
  },
  "createDeveloperMetadata": {
    object (CreateDeveloperMetadataResponse)
  },
  "updateDeveloperMetadata": {
    object (UpdateDeveloperMetadataResponse)
  },
  "deleteDeveloperMetadata": {
    object (DeleteDeveloperMetadataResponse)
  },
  "addDimensionGroup": {
    object (AddDimensionGroupResponse)
  },
  "deleteDimensionGroup": {
    object (DeleteDimensionGroupResponse)
  },
  "trimWhitespace": {
    object (TrimWhitespaceResponse)
  },
  "deleteDuplicates": {
    object (DeleteDuplicatesResponse)
  },
  "addSlicer": {
    object (AddSlicerResponse)
  },
  "addDataSource": {
    object (AddDataSourceResponse)
  },
  "updateDataSource": {
    object (UpdateDataSourceResponse)
  },
  "refreshDataSource": {
    object (RefreshDataSourceResponse)
  },
  "cancelDataSourceRefresh": {
    object (CancelDataSourceRefreshResponse)
  }
  // End of list of possible types for union field kind.
}
ช่อง
ฟิลด์ Union kind ประเภทของการตอบ อาจไม่มีการตั้งค่าช่องหากคำขอไม่มีการตอบกลับ kind ต้องเป็นอย่างใดอย่างหนึ่งต่อไปนี้
addNamedRange

object (AddNamedRangeResponse)

การตอบกลับจากการเพิ่มช่วงที่ตั้งชื่อแล้ว

addSheet

object (AddSheetResponse)

การตอบกลับจากการเพิ่มชีต

addFilterView

object (AddFilterViewResponse)

การตอบกลับจากการเพิ่มมุมมองตัวกรอง

duplicateFilterView

object (DuplicateFilterViewResponse)

การตอบกลับไม่ให้ทำซ้ำมุมมองตัวกรอง

duplicateSheet

object (DuplicateSheetResponse)

การตอบกลับจากการทำซ้ำชีต

findReplace

object (FindReplaceResponse)

การตอบกลับจากการดำเนินการค้นหา/แทนที่

updateEmbeddedObjectPosition

object (UpdateEmbeddedObjectPositionResponse)

การตอบกลับจากการอัปเดตตำแหน่งของวัตถุที่ฝัง

updateConditionalFormatRule

object (UpdateConditionalFormatRuleResponse)

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

deleteConditionalFormatRule

object (DeleteConditionalFormatRuleResponse)

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

addProtectedRange

object (AddProtectedRangeResponse)

การตอบกลับจากการเพิ่มช่วงที่ป้องกันไว้

addChart

object (AddChartResponse)

การตอบกลับจากการเพิ่มแผนภูมิ

addBanding

object (AddBandingResponse)

การตอบกลับจากการเพิ่มช่วงที่แบ่งเป็นช่วง

createDeveloperMetadata

object (CreateDeveloperMetadataResponse)

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

updateDeveloperMetadata

object (UpdateDeveloperMetadataResponse)

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

deleteDeveloperMetadata

object (DeleteDeveloperMetadataResponse)

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

addDimensionGroup

object (AddDimensionGroupResponse)

การตอบกลับจากการเพิ่มกลุ่มมิติข้อมูล

deleteDimensionGroup

object (DeleteDimensionGroupResponse)

การตอบกลับจากการลบกลุ่มมิติข้อมูล

trimWhitespace

object (TrimWhitespaceResponse)

การตอบกลับจากการตัดการเว้นวรรค

deleteDuplicates

object (DeleteDuplicatesResponse)

การตอบกลับจากการนำแถวที่มีค่าซ้ำกันออก

addSlicer

object (AddSlicerResponse)

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

addDataSource

object (AddDataSourceResponse)

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

updateDataSource

object (UpdateDataSourceResponse)

การตอบกลับไม่ให้อัปเดตแหล่งข้อมูล

refreshDataSource

object (RefreshDataSourceResponse)

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

cancelDataSourceRefresh

object (CancelDataSourceRefreshResponse)

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

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.
}
ช่อง
ฟิลด์ Union value ประเภทการอ้างอิง value ต้องเป็นอย่างใดอย่างหนึ่งต่อไปนี้
sheetId

string

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

chartId

integer

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

dataSourceTableAnchorCell

object (GridCoordinate)

การอ้างอิงถึง DataSourceTable ซึ่งตรึงอยู่ที่เซลล์

dataSourcePivotTableAnchorCell

object (GridCoordinate)

การอ้างอิงแหล่งข้อมูล PivotTable ซึ่งตรึงอยู่ที่เซลล์

dataSourceFormulaCell

object (GridCoordinate)

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

AddNamedRangeResponse

ผลลัพธ์ของการเพิ่มช่วงที่ตั้งชื่อแล้ว

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

object (NamedRange)

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

AddSheetResponse

ผลของการเพิ่มชีต

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

object (SheetProperties)

คุณสมบัติของชีตที่เพิ่มใหม่

AddFilterViewResponse

ผลลัพธ์จากการเพิ่มมุมมองตัวกรอง

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

object (FilterView)

มุมมองตัวกรองที่เพิ่มเข้ามาใหม่

DuplicateFilterViewResponse

ทำซ้ำผลลัพธ์ของมุมมองตัวกรอง

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

object (FilterView)

ตัวกรองที่สร้างขึ้นใหม่

DuplicateSheetResponse

ผลของการทำซ้ำชีต

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

object (SheetProperties)

คุณสมบัติของแผ่นงานที่ซ้ำกัน

FindReplaceResponse

ผลลัพธ์ของการค้นหา/แทนที่

การแสดง JSON 
{
  "valuesChanged": integer,
  "formulasChanged": integer,
  "rowsChanged": integer,
  "sheetsChanged": integer,
  "occurrencesChanged": integer
}
ช่อง
valuesChanged

integer

จำนวนเซลล์ที่ไม่ได้อยู่ในสูตรมีการเปลี่ยนแปลง

formulasChanged

integer

จำนวนเซลล์สูตรที่เปลี่ยนแปลง

rowsChanged

integer

จำนวนแถวที่เปลี่ยนแปลง

sheetsChanged

integer

เปลี่ยนจำนวนชีตแล้ว

occurrencesChanged

integer

จำนวนครั้งที่เกิด (อาจเป็นหลายครั้งในเซลล์เดียว) มีการเปลี่ยนแปลง ตัวอย่างเช่น หากแทนที่ "e" กับ วันที่ "o" ใน "Google Sheets" จะเป็น "3" เพราะ "Google Sheets" -> "Googlo Shoots"

UpdateEmbeddedObjectPositionResponse

ผลลัพธ์ของการอัปเดตตำแหน่งของวัตถุที่ฝัง

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

object (EmbeddedObjectPosition)

ตำแหน่งใหม่ของวัตถุที่ฝัง

UpdateConditionalFormatRuleResponse

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

การแสดง JSON 
{
  "newRule": {
    object (ConditionalFormatRule)
  },
  "newIndex": integer,

  // Union field old_info can be only one of the following:
  "oldRule": {
    object (ConditionalFormatRule)
  },
  "oldIndex": integer
  // End of list of possible types for union field old_info.
}
ช่อง
newRule

object (ConditionalFormatRule)

กฎใหม่ที่แทนที่กฎเดิม (หากแทนที่) หรือกฎที่ย้ายไป (หากย้าย)

newIndex

integer

ดัชนีของกฎใหม่

ฟิลด์ Union old_info ข้อมูลเกี่ยวกับกฎก่อนหน้า old_info ต้องเป็นอย่างใดอย่างหนึ่งต่อไปนี้
oldRule

object (ConditionalFormatRule)

กฎเก่า (ที่ลบแล้ว) ไม่ได้กำหนดว่ามีการย้ายกฎหรือไม่ (เนื่องจากเป็นกฎเดียวกับ newRule)

oldIndex

integer

ดัชนีเก่าของกฎ ไม่ได้ตั้งค่าหากมีการแทนที่กฎ (เนื่องจากเหมือนกันกับ newIndex)

DeleteConditionalFormatRuleResponse

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

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

object (ConditionalFormatRule)

กฎที่ถูกลบไปแล้ว

AddProtectedRangeResponse

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

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

object (ProtectedRange)

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

AddChartResponse

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

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

object (EmbeddedChart)

แผนภูมิที่เพิ่มใหม่

AddBandingResponse

ผลลัพธ์ของการเพิ่มช่วงที่ตัดเป็นแถบสี

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

object (BandedRange)

ช่วงของแถบสีที่เพิ่ม

CreateDeveloperMetadataResponse

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

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

object (DeveloperMetadata)

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

UpdateDeveloperMetadataResponse

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

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

object (DeveloperMetadata)

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

DeleteDeveloperMetadataResponse

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

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

object (DeveloperMetadata)

ข้อมูลเมตาที่ถูกลบ

AddDimensionGroupResponse

ผลของการเพิ่มกลุ่ม

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

object (DimensionGroup)

กลุ่มทั้งหมดของมิติข้อมูลหลังจากเพิ่มกลุ่มลงในมิติข้อมูลนั้น

DeleteDimensionGroupResponse

ผลจากการลบกลุ่ม

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

object (DimensionGroup)

กลุ่มทั้งหมดของมิติข้อมูลหลังจากลบกลุ่มออกจากมิติข้อมูลนั้น

TrimWhitespaceResponse

ผลลัพธ์ของการตัดช่องว่างในเซลล์

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

integer

จำนวนเซลล์ที่ตัดช่องว่าง

DeleteDuplicatesResponse

ผลของการนำรายการที่ซ้ำกันออกในช่วง

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

integer

นำจำนวนแถวที่ซ้ำกันออกแล้ว

AddSlicerResponse

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

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

object (Slicer)

ตัวควบคุมตัวกรองที่เพิ่มเข้ามาใหม่

AddDataSourceResponse

ผลลัพธ์ของการเพิ่มแหล่งข้อมูล

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

object (DataSource)

แหล่งข้อมูลที่สร้างขึ้น

dataExecutionStatus

object (DataExecutionStatus)

สถานะการดำเนินการกับข้อมูล

UpdateDataSourceResponse

การตอบสนองจากการอัปเดตแหล่งข้อมูล

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

object (DataSource)

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

dataExecutionStatus

object (DataExecutionStatus)

สถานะการดำเนินการกับข้อมูล

RefreshDataSourceResponse

การตอบสนองจากการรีเฟรชออบเจ็กต์แหล่งข้อมูลอย่างน้อย 1 รายการ

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

object (RefreshDataSourceObjectExecutionStatus)

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

RefreshDataSourceObjectExecutionStatus

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

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

object (DataSourceObjectReference)

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

dataExecutionStatus

object (DataExecutionStatus)

สถานะการดำเนินการกับข้อมูล

CancelDataSourceRefreshResponse

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

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

object (CancelDataSourceRefreshStatus)

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

CancelDataSourceRefreshStatus

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

การแสดง JSON 
{
  "reference": {
    object (DataSourceObjectReference)
  },
  "refreshCancellationStatus": {
    object (RefreshCancellationStatus)
  }
}
ช่อง
reference

object (DataSourceObjectReference)

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

refreshCancellationStatus

object (RefreshCancellationStatus)

สถานะการยกเลิก

RefreshCancellationStatus

สถานะการยกเลิกการรีเฟรช

คุณสามารถส่ง cancel request เพื่อยกเลิกการรีเฟรชออบเจ็กต์แหล่งข้อมูล 1 รายการหรือหลายรายการอย่างชัดเจน

การแสดง JSON 
{
  "state": enum (RefreshCancellationState),
  "errorCode": enum (RefreshCancellationErrorCode)
}
ช่อง
state

enum (RefreshCancellationState)

สถานะของการโทรที่จะยกเลิกการรีเฟรชในชีต

errorCode

enum (RefreshCancellationErrorCode)

รหัสข้อผิดพลาด

RefreshCancellationState

การแจงนับสถานะการยกเลิกการรีเฟรช

Enum
REFRESH_CANCELLATION_STATE_UNSPECIFIED ค่าเริ่มต้น อย่านำไปใช้
CANCEL_SUCCEEDED เรียก API ไปยังชีตเพื่อยกเลิกการรีเฟรชสำเร็จแล้ว ซึ่งกรณีนี้ไม่ได้หมายความว่าการยกเลิกนั้นสำเร็จ แต่การโทรดำเนินการสำเร็จแล้ว
CANCEL_FAILED เรียก API ไปยังชีตเพื่อยกเลิกการรีเฟรชไม่สำเร็จ

RefreshCancellationErrorCode

การแจงนับรหัสข้อผิดพลาดของการยกเลิกการรีเฟรช

Enum
REFRESH_CANCELLATION_ERROR_CODE_UNSPECIFIED ค่าเริ่มต้น อย่านำไปใช้
EXECUTION_NOT_FOUND ไม่พบการดำเนินการที่จะยกเลิกในเครื่องมือการค้นหาหรือในชีต
CANCEL_PERMISSION_DENIED ผู้ใช้ไม่มีสิทธิ์ยกเลิกการค้นหา
QUERY_EXECUTION_COMPLETED การดำเนินการค้นหาเสร็จสมบูรณ์แล้ว จึงยกเลิกไม่ได้
CONCURRENT_CANCELLATION มีการยกเลิกรายการอื่นที่อยู่ระหว่างดำเนินการแล้ว
CANCEL_OTHER_ERROR ข้อผิดพลาดอื่นๆ ทั้งหมด