Requests

Yêu cầu

Một loại nội dung cập nhật duy nhất để áp dụng cho bảng tính.

Biểu diễn dưới dạng JSON 
{

  "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)
  },
  "addTable": {
    object (AddTableRequest)
  },
  "updateTable": {
    object (UpdateTableRequest)
  },
  "deleteTable": {
    object (DeleteTableRequest)
  },
  "insertComment": {
    object (InsertCommentRequest)
  },
  "addCommentReply": {
    object (AddCommentReplyRequest)
  },
  "updateCommentPost": {
    object (UpdateCommentPostRequest)
  },
  "deleteComment": {
    object (DeleteCommentRequest)
  },
  "deleteCommentReply": {
    object (DeleteCommentReplyRequest)
  }
}
Trường
Loại bản cập nhật. Bạn phải điền đúng một trường. Sau đây là danh sách các trường loại trừ lẫn nhau. Tối đa một trong các trường sẽ được đặt trong phản hồi:
updateSpreadsheetProperties

object (UpdateSpreadsheetPropertiesRequest)

Cập nhật các thuộc tính của bảng tính.

updateSheetProperties

object (UpdateSheetPropertiesRequest)

Cập nhật các thuộc tính của trang tính.

updateDimensionProperties

object (UpdateDimensionPropertiesRequest)

Cập nhật các thuộc tính của phương diện.

updateNamedRange

object (UpdateNamedRangeRequest)

Cập nhật một dải ô được đặt tên.

repeatCell

object (RepeatCellRequest)

Lặp lại một ô duy nhất trên một dải ô.

addNamedRange

object (AddNamedRangeRequest)

Thêm một dải ô được đặt tên.

deleteNamedRange

object (DeleteNamedRangeRequest)

Xoá một dải ô được đặt tên.

addSheet

object (AddSheetRequest)

Thêm một trang tính.

deleteSheet

object (DeleteSheetRequest)

Xoá một trang tính.

autoFill

object (AutoFillRequest)

Tự động điền thêm dữ liệu dựa trên dữ liệu hiện có.

cutPaste

object (CutPasteRequest)

Cắt dữ liệu từ một khu vực và dán vào một khu vực khác.

copyPaste

object (CopyPasteRequest)

Sao chép dữ liệu từ một vùng và dán vào một vùng khác.

mergeCells

object (MergeCellsRequest)

Hợp nhất các ô với nhau.

unmergeCells

object (UnmergeCellsRequest)

Huỷ hợp nhất các ô đã hợp nhất.

updateBorders

object (UpdateBordersRequest)

Cập nhật đường viền trong một dải ô.

updateCells

object (UpdateCellsRequest)

Cập nhật nhiều ô cùng một lúc.

addFilterView

object (AddFilterViewRequest)

Thêm một chế độ xem bộ lọc.

appendCells

object (AppendCellsRequest)

Thêm các ô sau hàng dữ liệu cuối cùng trong một trang tính.

clearBasicFilter

object (ClearBasicFilterRequest)

Xoá bộ lọc cơ bản trên một trang tính.

deleteDimension

object (DeleteDimensionRequest)

Xoá hàng hoặc cột trong một trang tính.

deleteEmbeddedObject

object (DeleteEmbeddedObjectRequest)

Xoá một đối tượng được nhúng (ví dụ: biểu đồ, hình ảnh) trong trang tính.

deleteFilterView

object (DeleteFilterViewRequest)

Xoá một chế độ xem bộ lọc khỏi trang tính.

duplicateFilterView

object (DuplicateFilterViewRequest)

Nhân bản một chế độ xem bộ lọc.

duplicateSheet

object (DuplicateSheetRequest)

Sao chép một trang tính.

findReplace

object (FindReplaceRequest)

Tìm và thay thế các trường hợp xuất hiện của một văn bản bằng văn bản khác.

insertDimension

object (InsertDimensionRequest)

Chèn hàng hoặc cột mới vào trang tính.

insertRange

object (InsertRangeRequest)

Chèn các ô mới vào một trang tính, di chuyển các ô hiện có.

moveDimension

object (MoveDimensionRequest)

Di chuyển hàng hoặc cột đến một vị trí khác trong trang tính.

updateEmbeddedObjectPosition

object (UpdateEmbeddedObjectPositionRequest)

Cập nhật vị trí của một đối tượng được nhúng (ví dụ: biểu đồ, hình ảnh).

pasteData

object (PasteDataRequest)

Dán dữ liệu (HTML hoặc được phân cách) vào một trang tính.

textToColumns

object (TextToColumnsRequest)

Chuyển đổi một cột văn bản thành nhiều cột văn bản.

updateFilterView

object (UpdateFilterViewRequest)

Cập nhật các thuộc tính của một chế độ xem bộ lọc.

deleteRange

object (DeleteRangeRequest)

Xoá một dải ô khỏi trang tính, đồng thời di chuyển các ô còn lại.

appendDimension

object (AppendDimensionRequest)

Thêm các phương diện vào cuối trang tính.

addConditionalFormatRule

object (AddConditionalFormatRuleRequest)

Thêm một quy tắc định dạng có điều kiện mới.

updateConditionalFormatRule

object (UpdateConditionalFormatRuleRequest)

Cập nhật một quy tắc định dạng có điều kiện hiện có.

deleteConditionalFormatRule

object (DeleteConditionalFormatRuleRequest)

Xoá một quy tắc định dạng có điều kiện hiện có.

sortRange

object (SortRangeRequest)

Sắp xếp dữ liệu trong một dải ô.

setDataValidation

object (SetDataValidationRequest)

Đặt quy tắc xác thực dữ liệu cho một hoặc nhiều ô.

setBasicFilter

object (SetBasicFilterRequest)

Đặt bộ lọc cơ bản trên trang tính.

addProtectedRange

object (AddProtectedRangeRequest)

Thêm một dải ô được bảo vệ.

updateProtectedRange

object (UpdateProtectedRangeRequest)

Cập nhật một dải ô được bảo vệ.

deleteProtectedRange

object (DeleteProtectedRangeRequest)

Xoá một dải ô được bảo vệ.

autoResizeDimensions

object (AutoResizeDimensionsRequest)

Tự động đổi kích thước một hoặc nhiều phương diện dựa trên nội dung của các ô trong phương diện đó.

addChart

object (AddChartRequest)

Thêm biểu đồ.

updateChartSpec

object (UpdateChartSpecRequest)

Cập nhật các thông số kỹ thuật của biểu đồ.

updateBanding

object (UpdateBandingRequest)

Cập nhật dải ô có màu xen kẽ

addBanding

object (AddBandingRequest)

Thêm một dải ô có màu mới

deleteBanding

object (DeleteBandingRequest)

Xoá dải ô có đường viền

createDeveloperMetadata

object (CreateDeveloperMetadataRequest)

Tạo siêu dữ liệu mới cho nhà phát triển

updateDeveloperMetadata

object (UpdateDeveloperMetadataRequest)

Cập nhật một mục siêu dữ liệu hiện có của nhà phát triển

deleteDeveloperMetadata

object (DeleteDeveloperMetadataRequest)

Xoá siêu dữ liệu của nhà phát triển

randomizeRange

object (RandomizeRangeRequest)

Sắp xếp ngẫu nhiên thứ tự của các hàng trong một dải ô.

addDimensionGroup

object (AddDimensionGroupRequest)

Tạo một nhóm trong phạm vi đã chỉ định.

deleteDimensionGroup

object (DeleteDimensionGroupRequest)

Xoá một nhóm trong phạm vi được chỉ định.

updateDimensionGroup

object (UpdateDimensionGroupRequest)

Cập nhật trạng thái của nhóm được chỉ định.

trimWhitespace

object (TrimWhitespaceRequest)

Cắt bỏ khoảng trắng (chẳng hạn như dấu cách, dấu tab hoặc dòng mới) trong các ô.

deleteDuplicates

object (DeleteDuplicatesRequest)

Xoá các hàng chứa giá trị trùng lặp trong các cột được chỉ định của một dải ô.

updateEmbeddedObjectBorder

object (UpdateEmbeddedObjectBorderRequest)

Cập nhật đường viền của một đối tượng được nhúng.

addSlicer

object (AddSlicerRequest)

Thêm bộ cắt.

updateSlicerSpec

object (UpdateSlicerSpecRequest)

Cập nhật các thông số kỹ thuật của bộ cắt.

addDataSource

object (AddDataSourceRequest)

Thêm một nguồn dữ liệu.

updateDataSource

object (UpdateDataSourceRequest)

Cập nhật một nguồn dữ liệu.

deleteDataSource

object (DeleteDataSourceRequest)

Xoá một nguồn dữ liệu.

refreshDataSource

object (RefreshDataSourceRequest)

Làm mới một hoặc nhiều nguồn dữ liệu và các đối tượng cơ sở dữ liệu được liên kết.

cancelDataSourceRefresh

object (CancelDataSourceRefreshRequest)

Huỷ làm mới một hoặc nhiều nguồn dữ liệu và các đối tượng dbobject được liên kết.

addTable

object (AddTableRequest)

Thêm bảng.

updateTable

object (UpdateTableRequest)

Cập nhật bảng.

deleteTable

object (DeleteTableRequest)

Yêu cầu xoá một bảng.

insertComment

object (InsertCommentRequest)

Chèn một CommentThread vào bảng tính.

addCommentReply

object (AddCommentReplyRequest)

Thêm câu trả lời cho CommentThread.

updateCommentPost

object (UpdateCommentPostRequest)

Cập nhật một bài đăng hiện có (bài đăng đầu tiên hoặc câu trả lời) của một CommentThread.

deleteComment

object (DeleteCommentRequest)

Xoá một CommentThread.

deleteCommentReply

object (DeleteCommentReplyRequest)

Xoá một câu trả lời Post khỏi CommentThread

Kết thúc các trường loại trừ lẫn nhau.

UpdateSpreadsheetPropertiesRequest

Cập nhật các thuộc tính của bảng tính.

Biểu diễn dưới dạng JSON 
{
  "properties": {
    object (SpreadsheetProperties)
  },
  "fields": string
}
Trường
properties

object (SpreadsheetProperties)

Các thuộc tính cần cập nhật.

fields

string (FieldMask format)

Các trường cần được cập nhật. Bạn phải chỉ định ít nhất một trường. "properties" gốc được ngầm hiểu và không được chỉ định. Bạn có thể dùng một "*" làm ký hiệu viết tắt để liệt kê mọi trường.

UpdateSheetPropertiesRequest

Cập nhật các thuộc tính của trang tính bằng sheetId được chỉ định.

Biểu diễn dưới dạng JSON 
{
  "properties": {
    object (SheetProperties)
  },
  "fields": string
}
Trường
properties

object (SheetProperties)

Các thuộc tính cần cập nhật.

fields

string (FieldMask format)

Các trường cần được cập nhật. Bạn phải chỉ định ít nhất một trường. properties gốc được ngầm hiểu và không được chỉ định. Bạn có thể dùng một "*" làm ký hiệu viết tắt để liệt kê mọi trường.

UpdateDimensionPropertiesRequest

Cập nhật các thuộc tính của phương diện trong phạm vi được chỉ định.

Biểu diễn dưới dạng JSON 
{
  "properties": {
    object (DimensionProperties)
  },
  "fields": string,

  "range": {
    object (DimensionRange)
  },
  "dataSourceSheetRange": {
    object (DataSourceSheetDimensionRange)
  }
}
Trường
properties

object (DimensionProperties)

Các thuộc tính cần cập nhật.

fields

string (FieldMask format)

Các trường cần được cập nhật. Bạn phải chỉ định ít nhất một trường. properties gốc được ngầm hiểu và không được chỉ định. Bạn có thể dùng một "*" làm ký hiệu viết tắt để liệt kê mọi trường.

Phạm vi phương diện. Sau đây là danh sách các trường loại trừ lẫn nhau. Tối đa một trong các trường sẽ được đặt trong phản hồi:
range

object (DimensionRange)

Các hàng hoặc cột cần cập nhật.

dataSourceSheetRange

object (DataSourceSheetDimensionRange)

Các cột trên trang tính nguồn dữ liệu cần cập nhật.

Kết thúc các trường loại trừ lẫn nhau.

DataSourceSheetDimensionRange

Một dải ô dọc theo một phương diện duy nhất trên một trang tính DATA_SOURCE.

Biểu diễn dưới dạng JSON 
{
  "sheetId": integer,
  "columnReferences": [
    {
      object (DataSourceColumnReference)
    }
  ]
}
Trường
sheetId

integer

Mã nhận dạng của trang tính nguồn dữ liệu mà dải ô nằm trên đó.

columnReferences[]

object (DataSourceColumnReference)

Các cột trên trang tính nguồn dữ liệu.

UpdateNamedRangeRequest

Cập nhật các thuộc tính của dải ô được đặt tên bằng namedRangeId đã chỉ định.

Biểu diễn dưới dạng JSON 
{
  "namedRange": {
    object (NamedRange)
  },
  "fields": string
}
Trường
namedRange

object (NamedRange)

Dải ô được đặt tên cần cập nhật bằng các thuộc tính mới.

fields

string (FieldMask format)

Các trường cần được cập nhật. Bạn phải chỉ định ít nhất một trường. namedRange gốc được ngầm hiểu và không được chỉ định. Bạn có thể dùng một "*" làm ký hiệu viết tắt để liệt kê mọi trường.

RepeatCellRequest

Cập nhật tất cả các ô trong dải ô thành các giá trị trong đối tượng Ô đã cho. Chỉ những trường được liệt kê trong trường fields mới được cập nhật; các trường khác không thay đổi.

Nếu bạn viết một ô bằng công thức, các dải ô của công thức sẽ tự động tăng cho từng trường trong dải ô. Ví dụ: nếu ghi một ô bằng công thức =A1 vào dải ô B2:C4, thì B2 sẽ là =A1, B3 sẽ là =A2, B4 sẽ là =A3, C2 sẽ là =B1, C3 sẽ là =B2, C4 sẽ là =B3.

Để giữ cho các dải ô trong công thức ở trạng thái tĩnh, hãy sử dụng chỉ báo $. Ví dụ: sử dụng công thức =$A$1 để ngăn cả hàng và cột tăng.

Biểu diễn dưới dạng JSON 
{
  "range": {
    object (GridRange)
  },
  "cell": {
    object (CellData)
  },
  "fields": string
}
Trường
range

object (GridRange)

Dải ô cần lặp lại ô.

cell

object (CellData)

Dữ liệu cần ghi.

fields

string (FieldMask format)

Các trường cần được cập nhật. Bạn phải chỉ định ít nhất một trường. cell gốc được ngầm hiểu và không được chỉ định. Bạn có thể dùng một "*" làm ký hiệu viết tắt để liệt kê mọi trường.

AddNamedRangeRequest

Thêm một dải ô được đặt tên vào bảng tính.

Biểu diễn dưới dạng JSON 
{
  "namedRange": {
    object (NamedRange)
  }
}
Trường
namedRange

object (NamedRange)

Dải ô được đặt tên cần thêm. Trường namedRangeId là không bắt buộc; nếu bạn không đặt trường này, hệ thống sẽ tạo ngẫu nhiên một mã nhận dạng. (Bạn sẽ gặp lỗi nếu chỉ định mã nhận dạng của một dải ô đã tồn tại.)

DeleteNamedRangeRequest

Xoá dải ô được đặt tên có mã nhận dạng đã cho khỏi bảng tính.

Biểu diễn dưới dạng JSON 
{
  "namedRangeId": string
}
Trường
namedRangeId

string

Mã của dải ô được đặt tên cần xoá.

AddSheetRequest

Thêm một trang tính mới. Khi một trang tính được thêm vào một chỉ mục nhất định, chỉ mục của tất cả các trang tính tiếp theo sẽ tăng lên. Để thêm một trang tính đối tượng, hãy dùng AddChartRequest thay vì chỉ định EmbeddedObjectPosition.sheetId hoặc EmbeddedObjectPosition.newSheet.

Biểu diễn dưới dạng JSON 
{
  "properties": {
    object (SheetProperties)
  }
}
Trường
properties

object (SheetProperties)

Các thuộc tính mà trang tính mới phải có. Tất cả các thuộc tính đều không bắt buộc. Trường sheetId là không bắt buộc; nếu bạn không đặt trường này, hệ thống sẽ tạo ngẫu nhiên một mã nhận dạng. (Bạn không được chỉ định mã của một trang tính đã tồn tại.)

DeleteSheetRequest

Xoá trang tính được yêu cầu.

Biểu diễn dưới dạng JSON 
{
  "sheetId": integer
}
Trường
sheetId

integer

Mã nhận dạng của trang tính cần xoá.

Nếu trang tính thuộc loại DATA_SOURCE, thì DataSource được liên kết cũng sẽ bị xoá.

AutoFillRequest

Điền thêm dữ liệu dựa trên dữ liệu hiện có.

Biểu diễn dưới dạng JSON 
{
  "useAlternateSeries": boolean,

  "range": {
    object (GridRange)
  },
  "sourceAndDestination": {
    object (SourceAndDestination)
  }
}
Trường
useAlternateSeries

boolean

True nếu chúng ta nên tạo dữ liệu bằng chuỗi "thay thế". Điều này khác nhau tuỳ thuộc vào loại và số lượng dữ liệu nguồn.

Khu vực cần tự động điền. Sau đây là danh sách các trường loại trừ lẫn nhau. Tối đa một trong các trường sẽ được đặt trong phản hồi:
range

object (GridRange)

Dải ô cần tự động điền. Thao tác này sẽ kiểm tra phạm vi và phát hiện vị trí có dữ liệu, sau đó tự động điền dữ liệu đó vào phần còn lại của phạm vi.

sourceAndDestination

object (SourceAndDestination)

Vùng nguồn và vùng đích để tự động điền. Điều này liệt kê rõ ràng nguồn của tính năng tự động điền và nơi mở rộng dữ liệu đó.

Kết thúc các trường loại trừ lẫn nhau.

SourceAndDestination

Sự kết hợp giữa một dải nguồn và cách mở rộng nguồn đó.

Biểu diễn dưới dạng JSON 
{
  "source": {
    object (GridRange)
  },
  "dimension": enum (Dimension),
  "fillLength": integer
}
Trường
source

object (GridRange)

Vị trí của dữ liệu sẽ dùng làm nguồn cho tính năng tự động điền.

dimension

enum (Dimension)

Phương diện mà dữ liệu sẽ được điền vào.

fillLength

integer

Số lượng hàng hoặc cột mà dữ liệu sẽ được điền vào. Số dương sẽ mở rộng ra ngoài hàng cuối cùng hoặc cột cuối cùng của nguồn. Các số âm sẽ mở rộng trước hàng đầu tiên hoặc cột đầu tiên của nguồn.

CutPasteRequest

Di chuyển dữ liệu từ nguồn sang đích.

Biểu diễn dưới dạng JSON 
{
  "source": {
    object (GridRange)
  },
  "destination": {
    object (GridCoordinate)
  },
  "pasteType": enum (PasteType)
}
Trường
source

object (GridRange)

Dữ liệu nguồn cần cắt.

destination

object (GridCoordinate)

Toạ độ trên cùng bên trái nơi dữ liệu sẽ được dán.

pasteType

enum (PasteType)

Loại dữ liệu cần dán. Tất cả dữ liệu nguồn sẽ bị cắt, bất kể nội dung được dán là gì.

PasteType

Bạn nên dán loại dữ liệu nào.

Enum
PASTE_NORMAL Dán giá trị, công thức, định dạng và nội dung hợp nhất.
PASTE_VALUES CHỈ dán các giá trị mà không dán định dạng, công thức hoặc nội dung hợp nhất.
PASTE_FORMAT Chỉ dán định dạng, không bao gồm quy tắc xác thực dữ liệu.
PASTE_NO_BORDERS Tương tự như PASTE_NORMAL nhưng không có đường viền.
PASTE_FORMULA Chỉ dán công thức.
PASTE_DATA_VALIDATION Chỉ dán quy tắc xác thực dữ liệu.
PASTE_CONDITIONAL_FORMATTING Chỉ dán quy tắc định dạng có điều kiện.

CopyPasteRequest

Sao chép dữ liệu từ nguồn sang đích.

Biểu diễn dưới dạng JSON 
{
  "source": {
    object (GridRange)
  },
  "destination": {
    object (GridRange)
  },
  "pasteType": enum (PasteType),
  "pasteOrientation": enum (PasteOrientation)
}
Trường
source

object (GridRange)

Dải ô nguồn cần sao chép.

destination

object (GridRange)

Vị trí để dán. Nếu dải ô bao phủ một khoảng là bội số của chiều cao hoặc chiều rộng của nguồn, thì dữ liệu sẽ được lặp lại để điền vào dải ô đích. Nếu phạm vi nhỏ hơn phạm vi nguồn, toàn bộ dữ liệu nguồn vẫn sẽ được sao chép (vượt quá cuối phạm vi đích).

pasteType

enum (PasteType)

Loại dữ liệu cần dán.

pasteOrientation

enum (PasteOrientation)

Hướng của dữ liệu khi dán.

PasteOrientation

Cách thực hiện thao tác dán.

Enum
NORMAL Dán như bình thường.
TRANSPOSE Dán chuyển vị, trong đó tất cả các hàng trở thành cột và ngược lại.

MergeCellsRequest

Hợp nhất tất cả các ô trong dải ô.

Biểu diễn dưới dạng JSON 
{
  "range": {
    object (GridRange)
  },
  "mergeType": enum (MergeType)
}
Trường
range

object (GridRange)

Dải ô cần hợp nhất.

mergeType

enum (MergeType)

Cách hợp nhất các ô.

MergeType

Loại thao tác hợp nhất cần tạo.

Enum
MERGE_ALL Tạo một lần hợp nhất từ dải ô
MERGE_COLUMNS Tạo một thao tác hợp nhất cho từng cột trong dải ô
MERGE_ROWS Tạo một thao tác hợp nhất cho mỗi hàng trong dải ô

UnmergeCellsRequest

Huỷ hợp nhất các ô trong dải ô đã cho.

Biểu diễn dưới dạng JSON 
{
  "range": {
    object (GridRange)
  }
}
Trường
range

object (GridRange)

Dải ô mà tất cả các ô trong đó cần được tách ra. Nếu dải ô trải dài trên nhiều ô đã hợp nhất, thì tất cả các ô đó sẽ được tách. Dải ô không được trải dài một phần trên bất kỳ ô nào được hợp nhất.

UpdateBordersRequest

Cập nhật đường viền của một dải ô. Nếu bạn không đặt một trường trong yêu cầu, tức là đường viền vẫn giữ nguyên. Ví dụ: với 2 UpdateBordersRequest tiếp theo:

  1. phạm vi: A1:A5 { top: RED, bottom: WHITE }
  2. phạm vi: A1:A5 { left: BLUE }

Điều đó sẽ khiến A1:A5 có đường viền là { top: RED, bottom: WHITE, left: BLUE }. Nếu bạn muốn xoá một đường viền, hãy đặt kiểu một cách rõ ràng thành NONE.

Biểu diễn dưới dạng JSON 
{
  "range": {
    object (GridRange)
  },
  "top": {
    object (Border)
  },
  "bottom": {
    object (Border)
  },
  "left": {
    object (Border)
  },
  "right": {
    object (Border)
  },
  "innerHorizontal": {
    object (Border)
  },
  "innerVertical": {
    object (Border)
  }
}
Trường
range

object (GridRange)

Dải ô có đường viền cần được cập nhật.

top

object (Border)

Đường viền cần đặt ở đầu dải ô.

bottom

object (Border)

Đường viền cần đặt ở cuối dải ô.

left

object (Border)

Đường viền đặt ở bên trái của dải ô.

right

object (Border)

Đường viền cần đặt ở bên phải của dải ô.

innerHorizontal

object (Border)

Đường viền ngang cần đặt trong dải ô.

innerVertical

object (Border)

Đường viền dọc cần đặt trong dải ô.

UpdateCellsRequest

Cập nhật tất cả các ô trong một dải ô bằng dữ liệu mới.

Biểu diễn dưới dạng JSON 
{
  "rows": [
    {
      object (RowData)
    }
  ],
  "fields": string,

  "start": {
    object (GridCoordinate)
  },
  "range": {
    object (GridRange)
  }
}
Trường
rows[]

object (RowData)

Dữ liệu cần ghi.

fields

string (FieldMask format)

Các trường của CellData cần được cập nhật. Bạn phải chỉ định ít nhất một trường. Thư mục gốc là CellData; bạn không nên chỉ định "row.values". Bạn có thể dùng một "*" làm ký hiệu viết tắt để liệt kê mọi trường.

Bạn nên ghi dữ liệu vị trí. Bạn phải đặt đúng một giá trị. Sau đây là danh sách các trường loại trừ lẫn nhau. Tối đa một trong các trường sẽ được đặt trong phản hồi:
start

object (GridCoordinate)

Toạ độ để bắt đầu ghi dữ liệu. Bạn có thể ghi bất kỳ số lượng hàng và cột nào (kể cả số lượng cột khác nhau trên mỗi hàng).

range

object (GridRange)

Dải ô cần ghi dữ liệu vào.

Nếu dữ liệu trong các hàng không bao phủ toàn bộ dải ô được yêu cầu, thì các trường khớp với những trường được đặt trong fields sẽ bị xoá.

Kết thúc các trường loại trừ lẫn nhau.

AddFilterViewRequest

Thêm một chế độ xem bộ lọc.

Biểu diễn dưới dạng JSON 
{
  "filter": {
    object (FilterView)
  }
}
Trường
filter

object (FilterView)

Bộ lọc cần thêm. Trường filterViewId là không bắt buộc. Nếu bạn chưa đặt mã nhận dạng, hệ thống sẽ tạo ngẫu nhiên một mã nhận dạng. (Bạn không được chỉ định mã nhận dạng của một bộ lọc đã tồn tại.)

AppendCellsRequest

Thêm các ô mới sau hàng cuối cùng có dữ liệu trong một trang tính, chèn các hàng mới vào trang tính nếu cần.

Biểu diễn dưới dạng JSON 
{
  "sheetId": integer,
  "rows": [
    {
      object (RowData)
    }
  ],
  "fields": string,

  "tableId": string
}
Trường
sheetId

integer

Mã trang tính để thêm dữ liệu vào.

rows[]

object (RowData)

Dữ liệu cần nối.

fields

string (FieldMask format)

Các trường của CellData cần được cập nhật. Bạn phải chỉ định ít nhất một trường. Thư mục gốc là CellData; bạn không nên chỉ định "row.values". Bạn có thể dùng một "*" làm ký hiệu viết tắt để liệt kê mọi trường.

Bạn nên ghi dữ liệu vị trí. Sau đây là danh sách các trường loại trừ lẫn nhau. Tối đa một trong các trường sẽ được đặt trong phản hồi:
tableId

string

Mã nhận dạng của bảng cần thêm dữ liệu vào. Dữ liệu sẽ chỉ được thêm vào nội dung bảng.

Trường này cũng được ưu tiên hơn trường sheetId.

Kết thúc các trường loại trừ lẫn nhau.

ClearBasicFilterRequest

Xoá bộ lọc cơ bản, nếu có trên trang tính.

Biểu diễn dưới dạng JSON 
{
  "sheetId": integer
}
Trường
sheetId

integer

Mã trang tính mà bạn cần xoá bộ lọc cơ bản.

DeleteDimensionRequest

Xoá các phương diện khỏi trang tính.

Biểu diễn dưới dạng JSON 
{
  "range": {
    object (DimensionRange)
  }
}
Trường
range

object (DimensionRange)

Các phương diện cần xoá khỏi trang tính.

DeleteEmbeddedObjectRequest

Xoá đối tượng được nhúng có mã nhận dạng đã cho.

Biểu diễn dưới dạng JSON 
{
  "objectId": integer
}
Trường
objectId

integer

Mã nhận dạng của đối tượng được nhúng cần xoá.

DeleteFilterViewRequest

Xoá một chế độ xem bộ lọc cụ thể.

Biểu diễn dưới dạng JSON 
{
  "filterId": integer
}
Trường
filterId

integer

Mã nhận dạng của bộ lọc cần xoá.

DuplicateFilterViewRequest

Nhân bản một chế độ xem bộ lọc cụ thể.

Biểu diễn dưới dạng JSON 
{
  "filterId": integer
}
Trường
filterId

integer

Mã nhận dạng của bộ lọc đang được sao chép.

DuplicateSheetRequest

Sao chép nội dung của một trang tính.

Biểu diễn dưới dạng JSON 
{
  "sourceSheetId": integer,
  "insertSheetIndex": integer,
  "newSheetId": integer,
  "newSheetName": string
}
Trường
sourceSheetId

integer

Trang tính cần sao chép.

Nếu trang tính nguồn thuộc loại DATA_SOURCE, thì DataSource hỗ trợ của trang tính đó cũng được sao chép và liên kết với bản sao mới của trang tính. Không có hoạt động thực thi dữ liệu nào được kích hoạt, dữ liệu lưới của trang tính này cũng được sao chép nhưng chỉ có sẵn sau khi yêu cầu hàng loạt hoàn tất.

insertSheetIndex

integer

Chỉ mục bắt đầu từ 0 nơi trang tính mới sẽ được chèn vào. Chỉ mục của tất cả các trang tính sau trang tính này sẽ tăng lên.

newSheetId

integer

Nếu được đặt, thì đây là mã nhận dạng của trang tính mới. Nếu bạn chưa đặt, hệ thống sẽ chọn một mã nhận dạng. Nếu được đặt, mã nhận dạng không được xung đột với bất kỳ mã nhận dạng trang tính hiện có nào. Nếu được đặt, giá trị này phải là số không âm.

newSheetName

string

Tên của trang tính mới. Nếu bạn không nhập tên, hệ thống sẽ chọn một tên mới cho bạn.

FindReplaceRequest

Tìm và thay thế dữ liệu trong các ô trên một dải ô, trang tính hoặc tất cả các trang tính.

Biểu diễn dưới dạng JSON 
{
  "find": string,
  "replacement": string,
  "matchCase": boolean,
  "matchEntireCell": boolean,
  "searchByRegex": boolean,
  "includeFormulas": boolean,

  "range": {
    object (GridRange)
  },
  "sheetId": integer,
  "allSheets": boolean
}
Trường
find

string

Giá trị cần tìm kiếm.

replacement

string

Giá trị dùng để thay thế.

matchCase

boolean

Đúng nếu cụm từ tìm kiếm có phân biệt chữ hoa chữ thường.

matchEntireCell

boolean

Đúng nếu giá trị tìm kiếm phải khớp với toàn bộ ô.

searchByRegex

boolean

Đúng nếu giá trị tìm kiếm là một biểu thức chính quy. Biểu thức chính quy và nội dung thay thế phải tuân theo các quy tắc biểu thức chính quy của Java tại https://docs.oracle.com/javase/8/docs/api/java/util/regex/Pattern.html. Chuỗi thay thế được phép tham chiếu đến các nhóm chụp. Ví dụ: nếu một ô có nội dung "Google Sheets" và một ô khác có nội dung "Google Docs", thì việc tìm kiếm "o.* (.*)" và thay thế bằng "$1 Rocks" sẽ thay đổi nội dung của các ô thành "GSheets Rocks" và "GDocs Rocks" tương ứng.

includeFormulas

boolean

True nếu nội dung tìm kiếm phải bao gồm các ô có công thức. False để bỏ qua các ô có công thức.

Phạm vi tìm/thay thế – bạn chỉ được phép đặt một phạm vi. Sau đây là danh sách các trường loại trừ lẫn nhau. Tối đa một trong các trường sẽ được đặt trong phản hồi:
range

object (GridRange)

Dải ô cần tìm/thay thế.

sheetId

integer

Trang tính cần tìm/thay thế.

allSheets

boolean

True để tìm/thay thế trên tất cả các trang tính.

Kết thúc các trường loại trừ lẫn nhau.

InsertDimensionRequest

Chèn hàng hoặc cột vào một chỉ mục cụ thể trong trang tính.

Biểu diễn dưới dạng JSON 
{
  "range": {
    object (DimensionRange)
  },
  "inheritFromBefore": boolean
}
Trường
range

object (DimensionRange)

Phương diện cần chèn. Cả chỉ mục bắt đầu và chỉ mục kết thúc đều phải được giới hạn.

inheritFromBefore

boolean

Có nên mở rộng các thuộc tính phương diện từ các phương diện trước hoặc sau phương diện mới được chèn hay không. True để kế thừa từ các phương diện trước đó (trong trường hợp này, chỉ mục bắt đầu phải lớn hơn 0) và false để kế thừa từ các phương diện sau đó.

Ví dụ: nếu chỉ mục hàng 0 có nền màu đỏ và chỉ mục hàng 1 có nền màu xanh lục, thì việc chèn 2 hàng tại chỉ mục 1 có thể kế thừa nền màu xanh lục hoặc màu đỏ. Nếu inheritFromBefore là true, thì 2 hàng mới sẽ có màu đỏ (vì hàng trước điểm chèn có màu đỏ), còn nếu inheritFromBefore là false, thì 2 hàng mới sẽ có màu xanh lục (vì hàng sau điểm chèn có màu xanh lục).

InsertRangeRequest

Chèn các ô vào một dải ô, di chuyển các ô hiện có sang phải hoặc xuống dưới.

Biểu diễn dưới dạng JSON 
{
  "range": {
    object (GridRange)
  },
  "shiftDimension": enum (Dimension)
}
Trường
range

object (GridRange)

Dải ô để chèn các ô mới vào. Phạm vi bị giới hạn trong ranh giới của trang tính hiện tại.

shiftDimension

enum (Dimension)

Phương diện sẽ được chuyển khi chèn các ô. Nếu bạn chọn ROWS, các ô hiện có sẽ được chuyển xuống dưới. Nếu COLUMNS, các ô hiện có sẽ được di chuyển sang phải.

MoveDimensionRequest

Di chuyển một hoặc nhiều hàng hoặc cột.

Biểu diễn dưới dạng JSON 
{
  "source": {
    object (DimensionRange)
  },
  "destinationIndex": integer
}
Trường
source

object (DimensionRange)

Phương diện nguồn cần di chuyển.

destinationIndex

integer

Chỉ mục bắt đầu từ 0 của vị trí cần di chuyển dữ liệu nguồn đến, dựa trên các toạ độ trước khi dữ liệu nguồn bị xoá khỏi lưới. Dữ liệu hiện có sẽ được chuyển xuống dưới hoặc sang phải (tuỳ thuộc vào phương diện) để nhường chỗ cho các phương diện được di chuyển. Các phương diện nguồn sẽ bị xoá khỏi lưới, nên dữ liệu có thể nằm ở một chỉ mục khác với chỉ mục được chỉ định.

Ví dụ: cho A1..A5 của 0, 1, 2, 3, 4 và muốn di chuyển "1" và "2" đến giữa "3" và "4", nguồn sẽ là ROWS [1..3) và chỉ mục đích đến sẽ là "4" (chỉ mục dựa trên 0 của hàng 5). Kết quả cuối cùng sẽ là A1..A5 trên 0, 3, 1, 2, 4.

UpdateEmbeddedObjectPositionRequest

Cập nhật vị trí của một đối tượng được nhúng (chẳng hạn như di chuyển hoặc đổi kích thước biểu đồ hoặc hình ảnh).

Biểu diễn dưới dạng JSON 
{
  "objectId": integer,
  "newPosition": {
    object (EmbeddedObjectPosition)
  },
  "fields": string
}
Trường
objectId

integer

Mã nhận dạng của đối tượng cần di chuyển.

newPosition

object (EmbeddedObjectPosition)

Một vị trí cụ thể để di chuyển đối tượng được nhúng đến. Nếu bạn đặt newPosition.sheetId, một trang tính mới có mã nhận dạng đó sẽ được tạo. Nếu newPosition.newSheet được đặt thành true, một trang tính mới sẽ được tạo bằng một mã nhận dạng được chọn cho bạn.

fields

string (FieldMask format)

Các trường của OverlayPosition cần được cập nhật khi đặt một vị trí mới. Chỉ được dùng nếu bạn đặt newPosition.overlayPosition. Trong trường hợp đó, bạn phải chỉ định ít nhất một trường. newPosition.overlayPosition gốc được ngầm hiểu và không được chỉ định. Bạn có thể dùng một "*" làm ký hiệu viết tắt để liệt kê mọi trường.

PasteDataRequest

Chèn dữ liệu vào bảng tính, bắt đầu từ toạ độ được chỉ định.

Biểu diễn dưới dạng JSON 
{
  "coordinate": {
    object (GridCoordinate)
  },
  "data": string,
  "type": enum (PasteType),

  "delimiter": string,
  "html": boolean
}
Trường
coordinate

object (GridCoordinate)

Toạ độ mà dữ liệu sẽ bắt đầu được chèn.

data

string

Dữ liệu cần chèn.

type

enum (PasteType)

Cách dán dữ liệu.

Cách diễn giải dữ liệu, bạn phải đặt chính xác một giá trị. Sau đây là danh sách các trường loại trừ lẫn nhau. Tối đa một trong các trường sẽ được đặt trong phản hồi:
delimiter

string

Dấu phân cách trong dữ liệu.

html

boolean

True nếu dữ liệu là HTML.

Kết thúc các trường loại trừ lẫn nhau.

TextToColumnsRequest

Chia một cột văn bản thành nhiều cột dựa trên dấu phân cách trong mỗi ô.

Biểu diễn dưới dạng JSON 
{
  "source": {
    object (GridRange)
  },
  "delimiter": string,
  "delimiterType": enum (DelimiterType)
}
Trường
source

object (GridRange)

Dải ô dữ liệu nguồn. Dải ô này phải trải dài đúng một cột.

delimiter

string

Dấu phân cách cần sử dụng. Chỉ được dùng nếu delimiterType là CUSTOM.

delimiterType

enum (DelimiterType)

Loại dấu phân cách cần sử dụng.

DelimiterType

Dấu phân cách để phân tách.

Enum
DELIMITER_TYPE_UNSPECIFIED Giá trị mặc định. Bạn không được sử dụng giá trị này.
COMMA ","
SEMICOLON ";"
PERIOD "."
SPACE " "
CUSTOM Giá trị tuỳ chỉnh như được xác định trong dấu phân cách.
AUTODETECT Tự động phát hiện các cột.

UpdateFilterViewRequest

Cập nhật các thuộc tính của chế độ xem bộ lọc.

Biểu diễn dưới dạng JSON 
{
  "filter": {
    object (FilterView)
  },
  "fields": string
}
Trường
filter

object (FilterView)

Các thuộc tính mới của chế độ xem bộ lọc.

fields

string (FieldMask format)

Các trường cần được cập nhật. Bạn phải chỉ định ít nhất một trường. filter gốc được ngầm hiểu và không được chỉ định. Bạn có thể dùng một "*" làm ký hiệu viết tắt để liệt kê mọi trường.

DeleteRangeRequest

Xoá một dải ô, di chuyển các ô khác vào vùng đã xoá.

Biểu diễn dưới dạng JSON 
{
  "range": {
    object (GridRange)
  },
  "shiftDimension": enum (Dimension)
}
Trường
range

object (GridRange)

Dải ô cần xoá.

shiftDimension

enum (Dimension)

Phương diện mà các ô đã xoá sẽ được thay thế. Nếu bạn chọn ROWS, các ô hiện có sẽ được chuyển lên trên để thay thế các ô đã xoá. Nếu bạn chọn COLUMNS, các ô hiện có sẽ được chuyển sang trái để thay thế các ô đã xoá.

AppendDimensionRequest

Thêm hàng hoặc cột vào cuối trang tính.

Biểu diễn dưới dạng JSON 
{
  "sheetId": integer,
  "dimension": enum (Dimension),
  "length": integer
}
Trường
sheetId

integer

Trang tính cần thêm hàng hoặc cột.

dimension

enum (Dimension)

Có nên nối các hàng hoặc cột hay không.

length

integer

Số lượng hàng hoặc cột cần thêm.

AddConditionalFormatRuleRequest

Thêm một quy tắc định dạng có điều kiện mới tại chỉ mục đã cho. Tất cả chỉ mục của các quy tắc tiếp theo đều được tăng lên.

Biểu diễn dưới dạng JSON 
{
  "rule": {
    object (ConditionalFormatRule)
  },
  "index": integer
}
Trường
rule

object (ConditionalFormatRule)

Quy tắc cần thêm.

index

integer

Chỉ mục bắt đầu từ 0, nơi quy tắc sẽ được chèn vào.

UpdateConditionalFormatRuleRequest

Cập nhật quy tắc định dạng có điều kiện tại chỉ mục đã cho hoặc di chuyển quy tắc định dạng có điều kiện sang một chỉ mục khác.

Biểu diễn dưới dạng JSON 
{
  "index": integer,
  "sheetId": integer,

  "rule": {
    object (ConditionalFormatRule)
  },
  "newIndex": integer
}
Trường
index

integer

Chỉ mục bắt đầu từ 0 của quy tắc cần được thay thế hoặc di chuyển.

sheetId

integer

Trang tính của quy tắc cần di chuyển. Bắt buộc nếu bạn đặt newIndex, nếu không thì không dùng.

Loại bản cập nhật sẽ diễn ra. Sau đây là danh sách các trường loại trừ lẫn nhau. Tối đa một trong các trường sẽ được đặt trong phản hồi:
rule

object (ConditionalFormatRule)

Quy tắc sẽ thay thế quy tắc tại chỉ mục đã cho.

newIndex

integer

Chỉ mục mới dựa trên 0 mà quy tắc sẽ kết thúc.

Kết thúc các trường loại trừ lẫn nhau.

DeleteConditionalFormatRuleRequest

Xoá một quy tắc định dạng có điều kiện tại chỉ mục đã cho. Tất cả chỉ mục của các quy tắc tiếp theo đều giảm đi.

Biểu diễn dưới dạng JSON 
{
  "index": integer,
  "sheetId": integer
}
Trường
index

integer

Chỉ mục bắt đầu từ 0 của quy tắc cần xoá.

sheetId

integer

Trang tính mà quy tắc đang bị xoá.

SortRangeRequest

Sắp xếp dữ liệu trong các hàng dựa trên thứ tự sắp xếp theo cột.

Biểu diễn dưới dạng JSON 
{
  "range": {
    object (GridRange)
  },
  "sortSpecs": [
    {
      object (SortSpec)
    }
  ]
}
Trường
range

object (GridRange)

Dải ô cần sắp xếp.

sortSpecs[]

object (SortSpec)

Thứ tự sắp xếp cho mỗi cột. Các quy cách sau này được sử dụng khi các giá trị bằng nhau trong các quy cách trước đó.

SetDataValidationRequest

Đặt quy tắc xác thực dữ liệu cho mọi ô trong dải ô. Để xoá quá trình xác thực trong một dải ô, hãy gọi hàm này mà không chỉ định quy tắc nào.

Biểu diễn dưới dạng JSON 
{
  "range": {
    object (GridRange)
  },
  "rule": {
    object (DataValidationRule)
  },
  "filteredRowsIncluded": boolean
}
Trường
range

object (GridRange)

Phạm vi mà quy tắc xác thực dữ liệu sẽ áp dụng.

rule

object (DataValidationRule)

Quy tắc xác thực dữ liệu cần đặt trên mỗi ô trong dải ô hoặc để trống để xoá xác thực dữ liệu trong dải ô.

filteredRowsIncluded

boolean

Không bắt buộc. Nếu đúng, quy tắc xác thực dữ liệu cũng sẽ được áp dụng cho các hàng được lọc.

SetBasicFilterRequest

Đặt bộ lọc cơ bản được liên kết với một trang tính.

Biểu diễn dưới dạng JSON 
{
  "filter": {
    object (BasicFilter)
  }
}
Trường
filter

object (BasicFilter)

Bộ lọc cần đặt.

AddProtectedRangeRequest

Thêm một dải ô được bảo vệ mới.

Biểu diễn dưới dạng JSON 
{
  "protectedRange": {
    object (ProtectedRange)
  }
}
Trường
protectedRange

object (ProtectedRange)

Dải ô được bảo vệ cần thêm. Trường protectedRangeId là không bắt buộc; nếu bạn không đặt trường này, hệ thống sẽ tạo ngẫu nhiên một mã nhận dạng. (Bạn sẽ gặp lỗi nếu chỉ định mã nhận dạng của một dải ô đã tồn tại.)

UpdateProtectedRangeRequest

Cập nhật một dải ô được bảo vệ hiện có bằng protectedRangeId đã chỉ định.

Biểu diễn dưới dạng JSON 
{
  "protectedRange": {
    object (ProtectedRange)
  },
  "fields": string
}
Trường
protectedRange

object (ProtectedRange)

Dải ô được bảo vệ cần cập nhật bằng các thuộc tính mới.

fields

string (FieldMask format)

Các trường cần được cập nhật. Bạn phải chỉ định ít nhất một trường. protectedRange gốc được ngầm hiểu và không được chỉ định. Bạn có thể dùng một "*" làm ký hiệu viết tắt để liệt kê mọi trường.

DeleteProtectedRangeRequest

Xoá dải ô được bảo vệ có mã nhận dạng đã cho.

Biểu diễn dưới dạng JSON 
{
  "protectedRangeId": integer
}
Trường
protectedRangeId

integer

Mã nhận dạng của dải ô được bảo vệ cần xoá.

AutoResizeDimensionsRequest

Tự động đổi kích thước một hoặc nhiều phương diện dựa trên nội dung của các ô trong phương diện đó.

Biểu diễn dưới dạng JSON 
{

  "dimensions": {
    object (DimensionRange)
  },
  "dataSourceSheetDimensions": {
    object (DataSourceSheetDimensionRange)
  }
}
Trường
Phạm vi phương diện. Sau đây là danh sách các trường loại trừ lẫn nhau. Tối đa một trong các trường sẽ được đặt trong phản hồi:
dimensions

object (DimensionRange)

Kích thước cần tự động điều chỉnh.

dataSourceSheetDimensions

object (DataSourceSheetDimensionRange)

Các phương diện trên trang nguồn dữ liệu sẽ tự động đổi kích thước.

Kết thúc các trường loại trừ lẫn nhau.

AddChartRequest

Thêm biểu đồ vào một trang tính trong bảng tính.

Biểu diễn dưới dạng JSON 
{
  "chart": {
    object (EmbeddedChart)
  }
}
Trường
chart

object (EmbeddedChart)

Biểu đồ cần được thêm vào bảng tính, bao gồm cả vị trí cần đặt biểu đồ. Trường chartId là không bắt buộc; nếu bạn không đặt trường này, hệ thống sẽ tạo ngẫu nhiên một mã nhận dạng. (Bạn không được chỉ định mã nhận dạng của một đối tượng được nhúng đã tồn tại.)

UpdateChartSpecRequest

Cập nhật các thông số kỹ thuật của biểu đồ. (Thao tác này không di chuyển hoặc đổi kích thước biểu đồ. Để di chuyển hoặc đổi kích thước biểu đồ, hãy dùng UpdateEmbeddedObjectPositionRequest.)

Biểu diễn dưới dạng JSON 
{
  "chartId": integer,
  "spec": {
    object (ChartSpec)
  }
}
Trường
chartId

integer

Mã nhận dạng của biểu đồ cần cập nhật.

spec

object (ChartSpec)

Quy cách cần áp dụng cho biểu đồ.

UpdateBandingRequest

Cập nhật các thuộc tính của dải có phân đoạn được cung cấp.

Biểu diễn dưới dạng JSON 
{
  "bandedRange": {
    object (BandedRange)
  },
  "fields": string
}
Trường
bandedRange

object (BandedRange)

Dải ô được đánh dấu cần cập nhật bằng các thuộc tính mới.

fields

string (FieldMask format)

Các trường cần được cập nhật. Bạn phải chỉ định ít nhất một trường. bandedRange gốc được ngầm hiểu và không được chỉ định. Bạn có thể dùng một "*" làm ký hiệu viết tắt để liệt kê mọi trường.

AddBandingRequest

Thêm một dải ô có màu xen kẽ mới vào bảng tính.

Biểu diễn dưới dạng JSON 
{
  "bandedRange": {
    object (BandedRange)
  }
}
Trường
bandedRange

object (BandedRange)

Dải ô có màu xen kẽ cần thêm. Trường bandedRangeId là không bắt buộc; nếu bạn không đặt trường này, hệ thống sẽ tạo ngẫu nhiên một mã nhận dạng. (Bạn sẽ gặp lỗi nếu chỉ định mã nhận dạng của một dải ô đã tồn tại.)

DeleteBandingRequest

Xoá dải ô có màu có mã nhận dạng đã cho khỏi bảng tính.

Biểu diễn dưới dạng JSON 
{
  "bandedRangeId": integer
}
Trường
bandedRangeId

integer

Mã nhận dạng của dải có bậc cần xoá.

CreateDeveloperMetadataRequest

Yêu cầu tạo siêu dữ liệu nhà phát triển.

Biểu diễn dưới dạng JSON 
{
  "developerMetadata": {
    object (DeveloperMetadata)
  }
}
Trường
developerMetadata

object (DeveloperMetadata)

Siêu dữ liệu nhà phát triển cần tạo.

UpdateDeveloperMetadataRequest

Yêu cầu cập nhật các thuộc tính của siêu dữ liệu nhà phát triển. Cập nhật các thuộc tính của siêu dữ liệu nhà phát triển do bộ lọc chọn thành các giá trị được cung cấp trong tài nguyên DeveloperMetadata. Người gọi phải chỉ định những thuộc tính mà họ muốn cập nhật trong tham số fields, cũng như chỉ định ít nhất một DataFilter khớp với siêu dữ liệu mà họ muốn cập nhật.

Biểu diễn dưới dạng JSON 
{
  "dataFilters": [
    {
      object (DataFilter)
    }
  ],
  "developerMetadata": {
    object (DeveloperMetadata)
  },
  "fields": string
}
Trường
dataFilters[]

object (DataFilter)

Các bộ lọc khớp với mục siêu dữ liệu của nhà phát triển cần cập nhật.

developerMetadata

object (DeveloperMetadata)

Giá trị mà tất cả siêu dữ liệu khớp với bộ lọc dữ liệu sẽ được cập nhật.

fields

string (FieldMask format)

Các trường cần được cập nhật. Bạn phải chỉ định ít nhất một trường. developerMetadata gốc được ngầm hiểu và không được chỉ định. Bạn có thể dùng một "*" làm ký hiệu viết tắt để liệt kê mọi trường.

DeleteDeveloperMetadataRequest

Yêu cầu xoá siêu dữ liệu nhà phát triển.

Biểu diễn dưới dạng JSON 
{
  "dataFilter": {
    object (DataFilter)
  }
}
Trường
dataFilter

object (DataFilter)

Bộ lọc dữ liệu mô tả tiêu chí dùng để chọn mục siêu dữ liệu nhà phát triển cần xoá.

RandomizeRangeRequest

Sắp xếp ngẫu nhiên thứ tự của các hàng trong một dải ô.

Biểu diễn dưới dạng JSON 
{
  "range": {
    object (GridRange)
  }
}
Trường
range

object (GridRange)

Dải ô cần chọn ngẫu nhiên.

AddDimensionGroupRequest

Tạo một nhóm trong phạm vi đã chỉ định.

Nếu phạm vi được yêu cầu là một tập hợp siêu cấp của phạm vi của một nhóm hiện có G, thì độ sâu của G sẽ tăng lên và nhóm mới G' này có độ sâu của nhóm đó. Ví dụ: nhóm [C:D, depth 1] + [B:E] sẽ tạo ra các nhóm [B:E, depth 1] và [C:D, depth 2]. Nếu phạm vi được yêu cầu là một tập hợp con của phạm vi của một nhóm hiện có G, thì độ sâu của nhóm mới G' sẽ lớn hơn độ sâu của G một đơn vị. Ví dụ: nhóm [B:E, độ sâu 1] + [C:D] sẽ tạo ra các nhóm [B:E, độ sâu 1] và [C:D, độ sâu 2]. Nếu phạm vi được yêu cầu bắt đầu trước và kết thúc trong, hoặc bắt đầu trong và kết thúc sau phạm vi của một nhóm hiện có G, thì phạm vi của nhóm hiện có G sẽ trở thành hợp của các phạm vi, còn nhóm mới G' có độ sâu lớn hơn độ sâu của G và phạm vi là giao của các phạm vi. Ví dụ: nhóm [B:D, độ sâu 1] + [C:E] sẽ tạo ra các nhóm [B:E, độ sâu 1] và [C:D, độ sâu 2].

Biểu diễn dưới dạng JSON 
{
  "range": {
    object (DimensionRange)
  }
}
Trường
range

object (DimensionRange)

Phạm vi tạo nhóm.

DeleteDimensionGroupRequest

Xoá một nhóm trong dải ô được chỉ định bằng cách giảm độ sâu của các phương diện trong dải ô đó.

Ví dụ: giả sử trang tính có một nhóm cấp 1 trên B:E và một nhóm cấp 2 trên C:D. Việc xoá một nhóm trên D:E sẽ khiến trang tính có một nhóm cấp độ 1 trên B:D và một nhóm cấp độ 2 trên C:C.

Biểu diễn dưới dạng JSON 
{
  "range": {
    object (DimensionRange)
  }
}
Trường
range

object (DimensionRange)

Dải ô của nhóm cần xoá.

UpdateDimensionGroupRequest

Cập nhật trạng thái của nhóm được chỉ định.

Biểu diễn dưới dạng JSON 
{
  "dimensionGroup": {
    object (DimensionGroup)
  },
  "fields": string
}
Trường
dimensionGroup

object (DimensionGroup)

Nhóm cần cập nhật trạng thái. Phạm vi và độ sâu của nhóm phải chỉ định một nhóm hợp lệ trên trang tính và tất cả các trường khác đều được cập nhật.

fields

string (FieldMask format)

Các trường cần được cập nhật. Bạn phải chỉ định ít nhất một trường. dimensionGroup gốc được ngầm hiểu và không được chỉ định. Bạn có thể dùng một "*" làm ký hiệu viết tắt để liệt kê mọi trường.

TrimWhitespaceRequest

Cắt bỏ khoảng trắng (chẳng hạn như dấu cách, dấu tab hoặc dòng mới) trong mọi ô thuộc dải ô được chỉ định. Yêu cầu này sẽ xoá tất cả khoảng trắng ở đầu và cuối văn bản của mỗi ô, đồng thời giảm mọi chuỗi ký tự khoảng trắng còn lại thành một khoảng trắng duy nhất. Nếu văn bản được cắt bớt bắt đầu bằng ký tự "+" hoặc "=", thì văn bản đó vẫn là giá trị chuỗi và không được diễn giải là công thức.

Biểu diễn dưới dạng JSON 
{
  "range": {
    object (GridRange)
  }
}
Trường
range

object (GridRange)

Dải ô có các ô cần cắt bớt.

DeleteDuplicatesRequest

Xoá những hàng trong dải ô này có chứa các giá trị trong các cột được chỉ định trùng lặp với các giá trị trong bất kỳ hàng nào trước đó. Những hàng có giá trị giống nhau nhưng khác nhau về chữ hoa, định dạng hoặc công thức được coi là hàng trùng lặp.

Yêu cầu này cũng xoá các hàng trùng lặp bị ẩn khỏi chế độ xem (ví dụ: do bộ lọc). Khi xoá các hàng trùng lặp, phiên bản đầu tiên của mỗi hàng trùng lặp được quét từ trên xuống dưới sẽ được giữ lại trong dải ô kết quả. Nội dung nằm ngoài phạm vi được chỉ định sẽ không bị xoá và các hàng được coi là trùng lặp không nhất thiết phải nằm cạnh nhau trong phạm vi.

Biểu diễn dưới dạng JSON 
{
  "range": {
    object (GridRange)
  },
  "comparisonColumns": [
    {
      object (DimensionRange)
    }
  ]
}
Trường
range

object (GridRange)

Dải ô cần xoá các hàng trùng lặp.

comparisonColumns[]

object (DimensionRange)

Các cột trong dải ô cần phân tích để tìm giá trị trùng lặp. Nếu bạn không chọn cột nào, thì tất cả các cột sẽ được phân tích để tìm dữ liệu trùng lặp.

UpdateEmbeddedObjectBorderRequest

Cập nhật thuộc tính đường viền của một đối tượng được nhúng.

Biểu diễn dưới dạng JSON 
{
  "objectId": integer,
  "border": {
    object (EmbeddedObjectBorder)
  },
  "fields": string
}
Trường
objectId

integer

Mã nhận dạng của đối tượng được nhúng cần cập nhật.

border

object (EmbeddedObjectBorder)

Đường viền áp dụng cho đối tượng được nhúng.

fields

string (FieldMask format)

Các trường cần được cập nhật. Bạn phải chỉ định ít nhất một trường. border gốc được ngầm hiểu và không được chỉ định. Bạn có thể dùng một "*" làm ký hiệu viết tắt để liệt kê mọi trường.

AddSlicerRequest

Thêm một bộ cắt vào một trang tính trong bảng tính.

Biểu diễn dưới dạng JSON 
{
  "slicer": {
    object (Slicer)
  }
}
Trường
slicer

object (Slicer)

Bộ cắt cần được thêm vào bảng tính, bao gồm cả vị trí cần đặt bộ cắt. Trường slicerId là không bắt buộc; nếu bạn không đặt trường này, hệ thống sẽ tạo ngẫu nhiên một mã nhận dạng. (Bạn không được chỉ định mã nhận dạng của một bộ cắt đã tồn tại.)

UpdateSlicerSpecRequest

Cập nhật các thông số kỹ thuật của bộ cắt. (Thao tác này không di chuyển hoặc đổi kích thước bộ cắt. Để di chuyển hoặc đổi kích thước một bộ cắt, hãy dùng UpdateEmbeddedObjectPositionRequest.

Biểu diễn dưới dạng JSON 
{
  "slicerId": integer,
  "spec": {
    object (SlicerSpec)
  },
  "fields": string
}
Trường
slicerId

integer

Mã nhận dạng của bộ cắt cần cập nhật.

spec

object (SlicerSpec)

Quy cách để áp dụng cho bộ cắt.

fields

string (FieldMask format)

Các trường cần được cập nhật. Bạn phải chỉ định ít nhất một trường. SlicerSpec gốc được ngầm hiểu và không được chỉ định. Bạn có thể dùng một "*" làm ký hiệu viết tắt để liệt kê mọi trường.

AddDataSourceRequest

Thêm một nguồn dữ liệu. Sau khi bạn thêm thành công nguồn dữ liệu, một trang tính DATA_SOURCE được liên kết sẽ được tạo và một lệnh thực thi sẽ được kích hoạt để làm mới trang tính nhằm đọc dữ liệu từ nguồn dữ liệu.

Yêu cầu này cần có thêm một bigquery.readonly phạm vi OAuth nếu bạn đang thêm một nguồn dữ liệu BigQuery.

Biểu diễn dưới dạng JSON 
{
  "dataSource": {
    object (DataSource)
  }
}
Trường
dataSource

object (DataSource)

Nguồn dữ liệu cần thêm.

UpdateDataSourceRequest

Cập nhật một nguồn dữ liệu. Sau khi nguồn dữ liệu được cập nhật thành công, một quy trình thực thi sẽ được kích hoạt để làm mới trang tính DATA_SOURCE được liên kết nhằm đọc dữ liệu từ nguồn dữ liệu đã cập nhật.

Yêu cầu này cần có một phạm vi OAuth bổ sung nếu bạn đang cập nhật nguồn dữ liệu BigQuery.bigquery.readonly

Biểu diễn dưới dạng JSON 
{
  "dataSource": {
    object (DataSource)
  },
  "fields": string
}
Trường
dataSource

object (DataSource)

Nguồn dữ liệu cần cập nhật.

fields

string (FieldMask format)

Các trường cần được cập nhật. Bạn phải chỉ định ít nhất một trường. dataSource gốc được ngầm hiểu và không được chỉ định. Bạn có thể dùng một "*" làm ký hiệu viết tắt để liệt kê mọi trường.

DeleteDataSourceRequest

Xoá một nguồn dữ liệu. Yêu cầu này cũng sẽ xoá trang tính nguồn dữ liệu được liên kết và huỷ liên kết tất cả các đối tượng nguồn dữ liệu được liên kết.

Biểu diễn dưới dạng JSON 
{
  "dataSourceId": string
}
Trường
dataSourceId

string

Mã của nguồn dữ liệu cần xoá.

RefreshDataSourceRequest

Làm mới một hoặc nhiều đối tượng nguồn dữ liệu trong bảng tính theo các giá trị tham chiếu đã chỉ định.

Yêu cầu này cần có một phạm vi OAuth bigquery.readonly bổ sung nếu bạn đang làm mới một nguồn dữ liệu BigQuery.

Nếu có nhiều yêu cầu làm mới tham chiếu đến cùng một đối tượng nguồn dữ liệu trong một lô, thì chỉ yêu cầu làm mới cuối cùng được xử lý và tất cả các yêu cầu đó sẽ có cùng một phản hồi tương ứng.

Biểu diễn dưới dạng JSON 
{
  "force": boolean,

  "references": {
    object (DataSourceObjectReferences)
  },
  "dataSourceId": string,
  "isAll": boolean
}
Trường
force

boolean

Làm mới các đối tượng nguồn dữ liệu bất kể trạng thái hiện tại. Nếu bạn không đặt và một đối tượng nguồn dữ liệu được tham chiếu ở trạng thái lỗi, thì quá trình làm mới sẽ thất bại ngay lập tức.

Chỉ định nội dung cần làm mới. Sau đây là danh sách các trường loại trừ lẫn nhau. Tối đa một trong các trường sẽ được đặt trong phản hồi:
references

object (DataSourceObjectReferences)

Tham chiếu đến các đối tượng nguồn dữ liệu cần làm mới.

dataSourceId

string

Tham chiếu đến DataSource. Nếu được chỉ định, thao tác này sẽ làm mới tất cả các đối tượng nguồn dữ liệu được liên kết cho nguồn dữ liệu.

isAll

boolean

Làm mới tất cả các đối tượng nguồn dữ liệu hiện có trong bảng tính.

Kết thúc các trường loại trừ lẫn nhau.

DataSourceObjectReferences

Một danh sách các tham chiếu đến các đối tượng nguồn dữ liệu.

Biểu diễn dưới dạng JSON 
{
  "references": [
    {
      object (DataSourceObjectReference)
    }
  ]
}
Trường
references[]

object (DataSourceObjectReference)

Tài liệu tham khảo.

CancelDataSourceRefreshRequest

Huỷ một hoặc nhiều lần làm mới các đối tượng nguồn dữ liệu trong bảng tính theo các giá trị tham chiếu được chỉ định.

Yêu cầu này cần có một phạm vi OAuth bổ sung bigquery.readonly nếu bạn đang huỷ thao tác làm mới trên một nguồn dữ liệu BigQuery.

Biểu diễn dưới dạng JSON 
{

  "references": {
    object (DataSourceObjectReferences)
  },
  "dataSourceId": string,
  "isAll": boolean
}
Trường
Chỉ định nội dung cần huỷ. Sau đây là danh sách các trường loại trừ lẫn nhau. Tối đa một trong các trường sẽ được đặt trong phản hồi:
references

object (DataSourceObjectReferences)

Tham chiếu đến các đối tượng nguồn dữ liệu cần huỷ làm mới.

dataSourceId

string

Tham chiếu đến DataSource. Nếu được chỉ định, sẽ huỷ tất cả các hoạt động làm mới đối tượng nguồn dữ liệu được liên kết cho nguồn dữ liệu này.

isAll

boolean

Huỷ tất cả các lần làm mới đối tượng nguồn dữ liệu hiện có cho tất cả nguồn dữ liệu trong bảng tính.

Kết thúc các trường loại trừ lẫn nhau.

AddTableRequest

Thêm một bảng mới vào bảng tính.

Biểu diễn dưới dạng JSON 
{
  "table": {
    object (Table)
  }
}
Trường
table

object (Table)

Bắt buộc. Bảng cần thêm.

UpdateTableRequest

Cập nhật một bảng trong bảng tính.

Biểu diễn dưới dạng JSON 
{
  "table": {
    object (Table)
  },
  "fields": string
}
Trường
table

object (Table)

Bắt buộc. Bảng cần cập nhật.

fields

string (FieldMask format)

Bắt buộc. Các trường cần được cập nhật. Bạn phải chỉ định ít nhất một trường. table gốc được ngầm hiểu và không được chỉ định. Bạn có thể dùng một "*" làm ký hiệu viết tắt để liệt kê mọi trường.

DeleteTableRequest

Xoá bảng có mã nhận dạng đã cho khỏi bảng tính.

Biểu diễn dưới dạng JSON 
{
  "tableId": string
}
Trường
tableId

string

Mã của bảng cần xoá.

InsertCommentRequest

Chèn một CommentThread vào bảng tính.

Biểu diễn dưới dạng JSON 
{
  "content": string,
  "assigneeEmailAddress": string,

  "coordinate": {
    object (GridCoordinate)
  }
}
Trường
content

string

Văn bản của bình luận ở dạng văn bản thuần tuý.

Nội dung văn bản này sẽ được xử lý tương tự như các bình luận được tạo trong trình chỉnh sửa Trang tính. Thẻ này sẽ có các hành vi tương tự đối với việc định dạng, thông báo, v.v.

Bạn không được để trống trường này và không được vượt quá 2048 đơn vị mã UTF-8.

assigneeEmailAddress

string

Không bắt buộc. Địa chỉ email của người được giao bình luận.

Để trống nếu bạn không muốn chỉ định bình luận.

Không được vượt quá 2048 đơn vị mã UTF-8.

Vị trí trong trang tính được liên kết với bình luận này. Sau đây là danh sách các trường loại trừ lẫn nhau. Tối đa một trong các trường sẽ được đặt trong phản hồi:
coordinate

object (GridCoordinate)

Biểu tượng GridCoordinate trong trang tính được liên kết với nhận xét này.

Kết thúc các trường loại trừ lẫn nhau.

AddCommentReplyRequest

Chèn một câu trả lời Post vào CommentThread.

Biểu diễn dưới dạng JSON 
{
  "commentId": string,
  "post": {
    object (Post)
  }
}
Trường
commentId

string

Mã nhận dạng của CommentThread để thêm câu trả lời.

post

object (Post)

Post đại diện cho câu trả lời.

UpdateCommentPostRequest

Cập nhật Post trong CommentThread.

Trả về lỗi 400 yêu cầu không hợp lệ nếu:

  • Người dùng yêu cầu không phải là tác giả của bài đăng.
Biểu diễn dưới dạng JSON 
{
  "commentId": string,
  "postId": string,
  "content": string
}
Trường
commentId

string

Mã nhận dạng của CommentThread mà bài đăng thuộc về.

postId

string

Mã của bài đăng đang được cập nhật.

content

string

Văn bản mới của bình luận, ở dạng văn bản thuần tuý.

Nội dung văn bản này sẽ được xử lý tương tự như các bình luận được tạo trong trình chỉnh sửa Trang tính. Thẻ này sẽ có các hành vi tương tự đối với việc định dạng, thông báo, v.v.

Bạn không được để trống trường này và không được vượt quá 2048 đơn vị mã UTF-8.

DeleteCommentRequest

Xoá một CommentThread.

Trả về lỗi 400 yêu cầu không hợp lệ nếu người dùng yêu cầu không phải là tác giả của headPost.

Biểu diễn dưới dạng JSON 
{
  "commentId": string
}
Trường
commentId

string

Mã nhận dạng của CommentThread đang bị xoá.

DeleteCommentReplyRequest

Xoá câu trả lời Post khỏi CommentThread.

Trả về lỗi 400 yêu cầu không hợp lệ nếu:

  • Người dùng yêu cầu không phải là tác giả của bài đăng.

  • Bài đăng trả lời có chứa comment action.

  • Bài đăng trả lời chứa một assignee.

Biểu diễn dưới dạng JSON 
{
  "commentId": string,
  "postId": string
}
Trường
commentId

string

Mã nhận dạng của CommentThread mà bài đăng thuộc về.

postId

string

Mã nhận dạng của câu trả lời Post đang bị xoá.