Requests

Yêu cầu

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

Biểu diễn dưới dạng 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.
}
Trường
Trường hợp hợp nhất kind. Loại nội dung cập nhật. Bạn phải liên kết đúng một trường. kind chỉ có thể là một trong những loại sau:
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 một trang tính.

updateDimensionProperties

object (UpdateDimensionPropertiesRequest)

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

updateNamedRange

object (UpdateNamedRangeRequest)

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

repeatCell

object (RepeatCellRequest)

Lặp lại mộ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 dữ liệu đó vào một khu vực khác.

copyPaste

object (CopyPasteRequest)

Sao chép dữ liệu từ một khu vực và dán dữ liệu đó vào một khu vực 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 chế độ xem bộ lọc.

appendCells

object (AppendCellsRequest)

Thêm các ô sau hàng cuối cùng có dữ liệu 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 một trang tính.

deleteFilterView

object (DeleteFilterViewRequest)

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

duplicateFilterView

object (DuplicateFilterViewRequest)

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

duplicateSheet

object (DuplicateSheetRequest)

Tạo bản sao của một trang tính.

findReplace

object (FindReplaceRequest)

Tìm và thay thế các lần xuất hiện của một số 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 một trang tính.

insertRange

object (InsertRangeRequest)

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

moveDimension

object (MoveDimensionRequest)

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

updateEmbeddedObjectPosition

object (UpdateEmbeddedObjectPositionRequest)

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

pasteData

object (PasteDataRequest)

Dán dữ liệu (HTML hoặc dữ liệu đượ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 thành phần hiển thị bộ lọc.

deleteRange

object (DeleteRangeRequest)

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

appendDimension

object (AppendDimensionRequest)

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

addConditionalFormatRule

object (AddConditionalFormatRuleRequest)

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

updateConditionalFormatRule

object (UpdateConditionalFormatRuleRequest)

Cập nhậ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 tính năng 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 một trang tính.

addProtectedRange

object (AddProtectedRangeRequest)

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

updateProtectedRange

object (UpdateProtectedRangeRequest)

Cập nhậ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 thông số kỹ thuật của biểu đồ.

updateBanding

object (UpdateBandingRequest)

Cập nhật dải ô có đường viền

addBanding

object (AddBandingRequest)

Thêm một dải ô mới

deleteBanding

object (DeleteBandingRequest)

Xoá dải ô

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ụ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ác hàng trong một dải ô.

addDimensionGroup

object (AddDimensionGroupRequest)

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

deleteDimensionGroup

object (DeleteDimensionGroupRequest)

Xoá một nhóm trong phạm vi đã 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 trong ô (chẳng hạn như dấu cách, dấu tab hoặc dòng mới).

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 đối tượng được nhúng.

addSlicer

object (AddSlicerRequest)

Thêm một bộ lọc.

updateSlicerSpec

object (UpdateSlicerSpecRequest)

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

addDataSource

object (AddDataSourceRequest)

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

updateDataSource

object (UpdateDataSourceRequest)

Cập nhậ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 db đượ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 dbobject liên quan.

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ập nhật. Bạn phải chỉ định ít nhất một trường. "Thuộc tính" gốc được ngụ ý và không được chỉ định. Bạn có thể dùng mộ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ập nhật. Bạn phải chỉ định ít nhất một trường. properties gốc được ngụ ý và không được chỉ định. Bạn có thể dùng mộ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 đã chỉ định.

Biểu diễn dưới dạng 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.
}
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ập nhật. Bạn phải chỉ định ít nhất một trường. properties gốc được ngụ ý và không được chỉ định. Bạn có thể dùng một "*" để liệt kê mọi trường.

Trường hợp hợp nhất dimension_range. Phạm vi phương diện. dimension_range chỉ có thể là một trong những loại sau:
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.

DataSourceSheetDimensionRange

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

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

integer

Mã của trang tính nguồn dữ liệu chứa dải ô.

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 được 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ập nhật bằng các thuộc tính mới.

fields

string (FieldMask format)

Các trường cần cập nhật. Bạn phải chỉ định ít nhất một trường. namedRange gốc được ngụ ý và không được chỉ định. Bạn có thể dùng mộ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 ô có công thức, thì phạm vi của công thức sẽ tự động tăng lên cho mỗi trường trong phạm vi đó. Ví dụ: nếu bạn viết một ô có 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 dải ô của 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 lên.

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

object (GridRange)

Dải ô để lặp lại ô.

cell

object (CellData)

Dữ liệu cần ghi.

fields

string (FieldMask format)

Các trường cần cập nhật. Bạn phải chỉ định ít nhất một trường. cell gốc được ngụ ý và không được chỉ định. Bạn có thể dùng mộ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 một mã nhận dạng ngẫu nhiên. (Sẽ xảy ra lỗi nếu bạn chỉ định mã 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, tất cả chỉ mục của các trang tính tiếp theo sẽ được tăng lên. Để thêm một trang đối tượng, hãy sử dụng AddChartRequest 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ả 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 một mã nhận dạng ngẫu nhiên. (Sẽ xảy ra lỗi nếu bạn 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ã của trang tính cần xoá.

Nếu trang tính thuộc loại DATA_SOURCE, thì DataSource 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,

  // 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.
}
Trường
useAlternateSeries

boolean

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

Trường hợp hợp nhất area. Khu vực để tự động điền. area chỉ có thể là một trong những loại sau:
range

object (GridRange)

Dải ô cần tự động điền. Thao tác này sẽ kiểm tra dải ô 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 dải ô.

sourceAndDestination

object (SourceAndDestination)

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

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 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 mở rộng ra ngoài hàng cuối cùng hoặc cột cuối cùng của nguồn. Số âm 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 đến đí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 bạn sẽ dán dữ liệu.

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

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

Enum
PASTE_NORMAL Dán giá trị, công thức, định dạng và hợp nhất.
PASTE_VALUES Chỉ dán 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 và quy tắc xác thực dữ liệu.
PASTE_NO_BORDERS Giống 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 các 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 phạm vi bao gồm một khoảng bằng 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 phạm vi đí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 (ngoà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 theo kiểu hoá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 hợp nhất cần tạo.

Enum
MERGE_ALL Tạo một dữ liệu hợp nhất từ dải ô
MERGE_COLUMNS Tạo một hàm hợp nhất cho mỗi cột trong dải ô
MERGE_ROWS Tạo một hàm 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 ô trong đó tất cả các ô sẽ được huỷ hợp nhất. Nếu dải ô trải dài trên nhiều lần hợp nhất, tất cả các lần hợp nhất đó sẽ bị huỷ. Dải ô không được bao phủ một phần bất kỳ ô hợp nhất nào.

UpdateBordersRequest

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

  1. dải ô: A1:A5 { top: RED, bottom: WHITE }
  2. dải ô: 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á đường viền, hãy đặt kiểu thành NONE một cách rõ ràng.

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ần cập nhật đường viền.

top

object (Border)

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

bottom

object (Border)

Đường viề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 để đặt ở bên phải của dải ô.

innerHorizontal

object (Border)

Đường viền ngang để đặt trong phạm vi.

innerVertical

object (Border)

Đường viền dọc để đặt trong phạm vi.

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,

  // 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.
}
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. Phần tử gốc là CellData; bạn không nên chỉ định "row.values". Bạn có thể dùng một "*" để liệt kê mọi trường.

Trường hợp hợp nhất area. Dữ liệu vị trí phải được ghi. Bạn phải đặt đúng một giá trị. area chỉ có thể là một trong những loại sau:
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 (bao gồm 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 gồm toàn bộ phạm vi được yêu cầu, thì các trường khớp với các trường được đặt trong fields sẽ bị xoá.

AddFilterViewRequest

Thêm 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 không đặt trường này, hệ thống sẽ tạo một mã nhận dạng ngẫu nhiên. (Sẽ xảy ra lỗi nếu bạn chỉ định mã 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 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
}
Trường
sheetId

integer

Mã nhận dạng trang tính để nối dữ liệu.

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. Phần tử gốc là CellData; bạn không nên chỉ định "row.values". Bạn có thể dùng một "*" để liệt kê mọi trường.

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ã nhận dạng của trang tính 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ã đã cho.

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

integer

Mã 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ã 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ã của bộ lọc bị trùng lặ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 sao lưu 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ó quá trình 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 mà 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 đó sẽ được tăng lên.

newSheetId

integer

Nếu được đặt, mã nhận dạng của trang tính mới. Nếu bạn không đặ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 nào hiện có. 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 để trống, hệ thống sẽ chọn 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,

  // 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.
}
Trường
find

string

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

replacement

string

Giá trị sẽ được dùng để thay thế.

matchCase

boolean

Đúng nếu nội dung 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 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 quy tắc biểu thức chính quy 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 thu thậ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ới nội dung thay thế là "$1 Rocks" sẽ thay đổi nội dung của các ô thành "GSheets Rocks" và "GDocs Rocks" tương ứng.

includeFormulas

boolean

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

Trường hợp hợp nhất scope. Phạm vi tìm/thay thế – bạn chỉ được đặt một phạm vi. scope chỉ có thể là một trong những loại sau:
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.

InsertDimensionRequest

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

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

Liệu các thuộc tính phương diện có được mở rộng từ các phương diện trước hay sau các phương diện mới được chèn hay không. Đúng để 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à sai để 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 ở 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ì hai 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ì hai 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 hoặc xuống.

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

object (GridRange)

Dải ô để chèn ô mới. Dải ô bị ràng buộc với ranh giới trang tính hiện tại.

shiftDimension

enum (Dimension)

Phương diện sẽ được dịch chuyển khi chèn ô. Nếu ROWS, các ô hiện có sẽ được dịch chuyển xuống. Nếu là 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)

Các phương diện nguồn cần di chuyển.

destinationIndex

integer

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

Ví dụ: với A1..A5 của 0, 1, 2, 3, 4 và muốn di chuyển "1" và "2" vào 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 của 0, 3, 1, 2, 4.

UpdateEmbeddedObjectPositionRequest

Cập nhật vị trí của đố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ã của đối tượng cần di chuyển.

newPosition

object (EmbeddedObjectPosition)

Một vị trí rõ ràng để 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 bạn đặt newPosition.newSheet thành true, một trang tính mới sẽ được tạo với 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 vị trí mới. Chỉ được dùng nếu bạn đặt newPosition.overlayPosition, trong trường hợp này, bạn phải chỉ định ít nhất một trường. newPosition.overlayPosition gốc được ngụ ý và không được chỉ định. Bạn có thể dùng mộ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),

  // Union field kind can be only one of the following:
  "delimiter": string,
  "html": boolean
  // End of list of possible types for union field kind.
}
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.

Trường hợp hợp nhất kind. Cách diễn giải dữ liệu, bạn phải đặt đúng một giá trị. kind chỉ có thể là một trong những loại sau:
delimiter

string

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

html

boolean

Đúng nếu dữ liệu là HTML.

TextToColumnsRequest

Tách 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ữ liệu 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 sẽ sử dụng.

DelimiterType

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

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

UpdateFilterViewRequest

Cập nhật các thuộc tính của thành phần hiển thị 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 thành phần hiển thị bộ lọc.

fields

string (FieldMask format)

Các trường cần cập nhật. Bạn phải chỉ định ít nhất một trường. filter gốc được ngụ ý và không được chỉ định. Bạn có thể dùng mộ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ế bằng. Nếu ROWS, các ô hiện có sẽ được dịch chuyển lên trên để thay thế các ô đã xoá. Nếu COLUMNS, các ô hiện có sẽ được dịch 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 để nối các hàng hoặc cột.

dimension

enum (Dimension)

Liệu có nên thêm hàng hay cột hay không.

length

integer

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

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 dựa trên 0 mà bạn sẽ chèn quy tắc.

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,

  // 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.
}
Trường
index

integer

Chỉ mục dựa trên số 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 sử dụng.

Trường hợp hợp nhất instruction. Loại nội dung cập nhật sẽ diễn ra. instruction chỉ có thể là một trong những loại sau:
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 tại đó.

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 dựa trên số 0 của quy tắc cần xoá.

sheetId

integer

Trang tính chứa 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 từng 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 theo từng cột. Thông số kỹ thuật sau được sử dụng khi các giá trị bằng nhau trong thông số kỹ thuật trước đó.

SetDataValidationRequest

Thiết lập quy tắc xác thực dữ liệu cho mọi ô trong phạm vi. Để xoá tính năng 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 áp dụng quy tắc xác thực dữ liệu.

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á quy tắc 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 đã lọc.

SetBasicFilterRequest

Đặt bộ lọc cơ bản 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 một mã nhận dạng ngẫu nhiên. (Sẽ xảy ra lỗi nếu bạn chỉ định mã của một dải ô đã tồn tại.)

UpdateProtectedRangeRequest

Cập nhật dải ô được bảo vệ hiện có bằng protectedRangeId được 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ập nhật bằng các thuộc tính mới.

fields

string (FieldMask format)

Các trường cần cập nhật. Bạn phải chỉ định ít nhất một trường. protectedRange gốc được ngụ ý và không được chỉ định. Bạn có thể dùng mộ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ã 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 
{

  // 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.
}
Trường
Trường hợp hợp nhất dimension_range. Phạm vi phương diện. dimension_range chỉ có thể là một trong những loại sau:
dimensions

object (DimensionRange)

Phương diện để tự động đổi kích thước.

dataSourceSheetDimensions

object (DataSourceSheetDimensionRange)

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

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í đặ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 một mã nhận dạng ngẫu nhiên. (Lỗi chỉ định mã của một đối tượng nhúng đã tồn tại.)

UpdateChartSpecRequest

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

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

integer

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

spec

object (ChartSpec)

Thông số kỹ thuật để áp dụng cho biểu đồ.

UpdateBandingRequest

Cập nhật các thuộc tính của dải ô đượ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 phân nhóm để 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ập nhật. Bạn phải chỉ định ít nhất một trường. bandedRange gốc được ngụ ý và không được chỉ định. Bạn có thể dùng một "*" để liệt kê mọi trường.

AddBandingRequest

Thêm một dải ô 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ó phân nhóm 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 một mã nhận dạng ngẫu nhiên. (Sẽ xảy ra lỗi nếu bạn chỉ định mã của một dải ô đã tồn tại.)

DeleteBandingRequest

Xoá dải ô 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ã của dải ô 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. Phương thức gọi phải chỉ định các thuộc tính mà họ muốn cập nhật trong tham số trường, 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)

Bộ lọc khớp với các 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ập nhật. Bạn phải chỉ định ít nhất một trường. developerMetadata gốc được ngụ ý và không được chỉ định. Bạn có thể dùng mộ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 của nhà phát triển cần xoá.

RandomizeRangeRequest

Sắp xếp ngẫu nhiên thứ tự 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 tạo ngẫu nhiên.

AddDimensionGroupRequest

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

Nếu dải ô được yêu cầu là tập hợp con của dải ô của một nhóm G hiện có, thì độ sâu của G sẽ tăng lên và nhóm G' mới 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 dải ô được yêu cầu là một tập hợp con của dải ô của một nhóm G hiện có, thì chiều sâu của nhóm G' mới sẽ lớn hơn chiều sâu của G một. Ví dụ: nhóm [B:E, depth 1] + [C:D] sẽ tạo ra các nhóm [B:E, depth 1] và [C:D, depth 2]. Nếu dải ô đượ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 dải ô của một nhóm G hiện có, thì dải ô của nhóm G hiện có sẽ trở thành tập hợp hợp nhất của các dải ô và nhóm mới G' có độ sâu lớn hơn một so với độ sâu của G và dải ô là giao của các dải ô. Ví dụ: nhóm [B:D, depth 1] + [C:E] sẽ tạo ra các nhóm [B:E, depth 1] và [C:D, depth 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 phạm vi đã chỉ định bằng cách giảm chiều sâu của các phương diện trong phạm vi đó.

Ví dụ: giả sử trang tính có một nhóm có độ sâu 1 trên B:E và một nhóm có độ sâu 2 trên C:D. Khi xoá một nhóm trên D:E, trang tính sẽ có một nhóm sâu 1 trên B:D và một nhóm sâu 2 trên C:C.

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

object (DimensionRange)

Phạm vi 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. Dải ô 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ập nhật. Bạn phải chỉ định ít nhất một trường. dimensionGroup gốc được ngụ ý và không được chỉ định. Bạn có thể dùng mộ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 ô trong dải ô đã chỉ định. Yêu cầu này xoá tất cả khoảng trắng ở đầu và cuối văn bản của mỗi ô, đồng thời rút gọn mọi chuỗi con của các ký tự khoảng trắng còn lại thành một khoảng trắng. 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à một giá trị chuỗi và không được diễn giải là một công thức.

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

object (GridRange)

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

DeleteDuplicatesRequest

Xoá các hàng trong dải ô này chứa giá trị trong các cột được chỉ định trùng lặp với giá trị trong bất kỳ hàng nào trước đó. Các hàng có giá trị giống hệt nhau nhưng loại chữ, định dạng hoặc công thức khác nhau thì được coi là 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 bản sao, thực thể đầu tiên của mỗi hàng trùng lặp được quét từ trên xuống sẽ được giữ lại trong dải ô kết quả. Nội dung nằm ngoài dải ô đượ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 liền kề nhau trong dải ô.

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

object (GridRange)

Phạm vi cần xoá các hàng trùng lặp.

comparisonColumns[]

object (DimensionRange)

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

UpdateEmbeddedObjectBorderRequest

Cập nhật thuộc tính đường viền của đố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ã 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ập nhật. Bạn phải chỉ định ít nhất một trường. border gốc được ngụ ý và không được chỉ định. Bạn có thể dùng một "*" để liệt kê mọi trường.

AddSlicerRequest

Thêm một công cụ lọc 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)

Lát cắt cần được thêm vào bảng tính, bao gồm cả vị trí đặt lát 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 một mã nhận dạng ngẫu nhiên. (Sẽ xảy ra lỗi nếu bạn chỉ định mã của một lát cắt đã tồn tại.)

UpdateSlicerSpecRequest

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

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

integer

Mã của công cụ cắt cần cập nhật.

spec

object (SlicerSpec)

Thông số kỹ thuật để áp dụng cho công cụ cắt.

fields

string (FieldMask format)

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

AddDataSourceRequest

Thêm nguồn dữ liệu. Sau khi 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 quá trì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 phạm vi OAuth bigquery.readonly nếu bạn đang thêm 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 nguồn dữ liệu. Sau khi nguồn dữ liệu được cập nhật thành công, một quá trình thực thi sẽ được kích hoạt để làm mới trang tính DATA_SOURCE liên kết để đọc dữ liệu từ nguồn dữ liệu đã cập nhật.

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

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ập nhật. Bạn phải chỉ định ít nhất một trường. dataSource gốc được ngụ ý và không được chỉ định. Bạn có thể dùng mộ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 xoá trang tính nguồn dữ liệu được liên kết và huỷ liên kết tất 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 tệp tham chiếu đã chỉ định.

Yêu cầu này yêu cầu thêm phạm vi OAuth bigquery.readonly nếu bạn đang làm mới 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 gần đây nhất mới đượ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,

  // 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.
}
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 không được đặt và đố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ẽ không thành công ngay lập tức.

Trường hợp hợp nhất target. Chỉ định nội dung cần làm mới. target chỉ có thể là một trong những loại sau:
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, sẽ làm mới tất 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ả đối tượng nguồn dữ liệu hiện có trong bảng tính.

DataSourceObjectReferences

Danh sách 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 đối tượng nguồn dữ liệu trong bảng tính theo các tệp đối chiếu được chỉ định.

Yêu cầu này cần có thêm phạm vi OAuth bigquery.readonly nếu bạn huỷ làm mới trên nguồn dữ liệu BigQuery.

Biểu diễn dưới dạng 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.
}
Trường
Trường hợp hợp nhất target. Chỉ định nội dung cần huỷ. target chỉ có thể là một trong những loại sau:
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 lần 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ả các nguồn dữ liệu trong bảng tính.