Requests

Yêu cầu

Một loại nội dung cập nhật được áp dụng cho 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)
  }
  // End of list of possible types for union field kind.
}
Các trường
Trường nhóm kind. Loại nội dung cập nhật. Chỉ có đúng một trường là bắt buộc. kind chỉ có thể là một trong những loại sau đây:
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 thuộc tính của thứ nguyê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 ô trên một dải ô.

addNamedRange

object (AddNamedRangeRequest)

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

deleteNamedRange

object (DeleteNamedRangeRequest)

Xóa một dải ô được đặt tên.

addSheet

object (AddSheetRequest)

Thêm một trang tính.

deleteSheet

object (DeleteSheetRequest)

Xóa một trang tính.

autoFill

object (AutoFillRequest)

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

cutPaste

object (CutPasteRequest)

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

copyPaste

object (CopyPasteRequest)

Sao chép dữ liệu từ một khu vực rồi 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)

Hủy 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 ô sau hàng cuối cùng có dữ liệu trong trang tính.

clearBasicFilter

object (ClearBasicFilterRequest)

Xóa bộ lọc cơ bản trên một trang tính.

deleteDimension

object (DeleteDimensionRequest)

Xóa hàng hoặc cột trong một trang tính.

deleteEmbeddedObject

object (DeleteEmbeddedObjectRequest)

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

deleteFilterView

object (DeleteFilterViewRequest)

Xóa chế độ xem bộ lọc khỏi trang tính.

duplicateFilterView

object (DuplicateFilterViewRequest)

Sao y chế độ xem bộ lọc.

duplicateSheet

object (DuplicateSheetRequest)

Nhân bản 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 ô 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 đố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 tá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 thuộc tính của chế độ xem bộ lọc.

deleteRange

object (DeleteRangeRequest)

Xóa một dải ô khỏi trang tính, di chuyển các ô còn lại.

appendDimension

object (AppendDimensionRequest)

Thêm tham số 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)

Xóa 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 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 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 thứ nguyên dựa trên nội dung của các ô trong thứ nguyên đó.

addChart

object (AddChartRequest)

Thêm biểu đồ.

updateChartSpec

object (UpdateChartSpecRequest)

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

updateBanding

object (UpdateBandingRequest)

Cập nhật dải theo dải

addBanding

object (AddBandingRequest)

Thêm dải ô mới

deleteBanding

object (DeleteBandingRequest)

Loại bỏ dải

createDeveloperMetadata

object (CreateDeveloperMetadataRequest)

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

updateDeveloperMetadata

object (UpdateDeveloperMetadataRequest)

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

deleteDeveloperMetadata

object (DeleteDeveloperMetadataRequest)

Xóa siêu dữ liệu 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 dải ô được chỉ định.

deleteDimensionGroup

object (DeleteDimensionGroupRequest)

Xóa một nhóm trên dải ô đượ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ỏ các ô trong khoảng trắng (chẳng hạn như dấu cách, thẻ hoặc các dòng mới).

deleteDuplicates

object (DeleteDuplicatesRequest)

Xóa các hàng chứa giá trị trùng lặp trong các cột được chỉ định của 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 bộ cắt.

updateSlicerSpec

object (UpdateSlicerSpecRequest)

Cập nhật thông số của bộ 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)

Xóa 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.

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

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
}
Các 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. Phải chỉ định ít nhất một trường. Các "thuộc tính" gốc là ngụ ý và không được chỉ định. Bạn có thể sử dụng một "*" để viết tắt khi liệt kê mọi trường.

UpdateSheetPropertiesRequest

Cập nhật các thuộc tính của trang tính với sheetId được chỉ định.

Biểu diễn dưới dạng JSON 
{
  "properties": {
    object (SheetProperties)
  },
  "fields": string
}
Các 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. Phải chỉ định ít nhất một trường. Gốc properties là ngụ ý và không nên chỉ định. Bạn có thể sử dụng một "*" để viết tắt khi liệt kê mọi trường.

Cập nhật, thứ nguyên, thuộc tính

Cập nhật thuộc tính của các thứ nguyên trong phạm vi được 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.
}
Các trường
properties

object (DimensionProperties)

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. Phải chỉ định ít nhất một trường. Gốc properties là ngụ ý và không nên chỉ định. Bạn có thể sử dụng một "*" để viết tắt khi liệt kê mọi trường.

Trường nhóm dimension_range. Phạm vi thứ nguyên. dimension_range chỉ có thể là một trong những loại sau đây:
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 thứ nguyê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)
    }
  ]
}
Các trường
sheetId

integer

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

columnReferences[]

object (DataSourceColumnReference)

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

Cập nhậtNameNamedRangeRequest

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
}
Các trường
namedRange

object (NamedRange)

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

fields

string (FieldMask format)

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

Yêu cầu Lặp

Cập nhật tất cả các ô trong dải ô thành các giá trị trong đối tượng Ô đã cho. Chỉ có các trường trong trường fields được cập nhật. Các trường khác sẽ không thay đổi.

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

Để duy trì tĩnh dải ô của công thức, hãy dùng chỉ báo $. Ví dụ: sử dụng công thức =$A$1 để ngăn cả hàng và cột không tăng lên.

Biểu diễn dưới dạng JSON 
{
  "range": {
    object (GridRange)
  },
  "cell": {
    object (CellData)
  },
  "fields": string
}
Các 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 cập nhật. Phải chỉ định ít nhất một trường. Gốc cell là ngụ ý và không nên chỉ định. Bạn có thể sử dụng một "*" để viết tắt khi 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)
  }
}
Các trường
namedRange

object (NamedRange)

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

Xóa tên yêu cầu

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

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

string

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

Yêu cầu trang tính

Thêm trang tính mới. Khi một trang tính được thêm vào chỉ mục đã cho, tất cả chỉ mục của trang tính tiếp theo sẽ tăng lên. Để thêm một trang tính đố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)
  }
}
Các 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 là tùy chọn. Trường sheetId là trường không bắt buộc. Nếu bạn không thiết lập thì hệ thống sẽ tạo mã nhận dạng ngẫu nhiên. (Lỗi khi chỉ định ID của trang tính đã tồn tại).

Xóa yêu cầu trang tính

Xóa trang tính được yêu cầu.

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

integer

Mã của trang tính cần xoá.

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

Yêu cầu tự động điền

Điền thêm dữ liệu dựa vào 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.
}
Các trường
useAlternateSeries

boolean

Đúng nếu chúng tôi tạo dữ liệu với chuỗi "thay thế". Điều này sẽ khác nhau dựa trên loại và lượng dữ liệu nguồn.

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

object (GridRange)

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

sourceAndDestination

object (SourceAndDestination)

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

Nguồn và đích

Kết hợp 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
}
Các trường
source

object (GridRange)

Vị trí của dữ liệu để dùng làm nguồn của 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ố hàng hoặc cột mà dữ liệu sẽ được điền vào. Số dương vượt 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.

Yêu cầu cắt dán

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)
}
Các 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á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ể dữ liệu nào được dán.

Loại dán

Loại dữ liệu nào sẽ được dán.

Enum
PASTE_NORMAL Dán các giá trị, công thức, định dạng và hợp nhất.
PASTE_VALUES CHỈ dán các giá trị mà không có định dạng, công thức hoặc hợp nhất.
PASTE_FORMAT Chỉ dán định dạng và 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 quy tắc định dạng có điều kiện.

Sao chép yêu cầu dán

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

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

object (GridRange)

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

destination

object (GridRange)

Vị trí để dán vào. Nếu dải ô bao gồm một span 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 dải ô nhỏ hơn dải ô nguồn, toàn bộ dữ liệu nguồn sẽ vẫn được sao chép (vượt quá dải ô cuối đích).

pasteType

enum (PasteType)

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

pasteOrientation

enum (PasteOrientation)

Bạn phải định hướng dữ liệu đó như thế nào khi dán.

Dán định hướng

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

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

Yêu cầu hợp nhất

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)
}
Các trường
range

object (GridRange)

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

mergeType

enum (MergeType)

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

Kiểu hợp nhất

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

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

Hủy hợp nhất yêu cầu

Hủy hợp nhất các ô trong dải ô đã cho.

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

object (GridRange)

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

Yêu cầu cập nhật biên giới

Cập nhật đường viền của dải ô. Nếu một trường không được đặt trong yêu cầu, điều đó có nghĩa là đường viền sẽ 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 rõ ràng là 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)
  }
}
Các trường
range

object (GridRange)

Dải ô mà bạn muốn cập nhật đường viền.

top

object (Border)

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

bottom

object (Border)

Đường viền nằm ở cuối dải ô.

left

object (Border)

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

right

object (Border)

Đường viền nằm ở bên phải của dải ô.

innerHorizontal

object (Border)

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

innerVertical

object (Border)

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

Cập nhậtCellsRequest

Cập nhật tất cả các ô trong một dải ô có 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.
}
Các 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. Phải chỉ định ít nhất một trường. Gốc là CellData; không nên chỉ định 'row.values.'. Bạn có thể sử dụng một "*" để viết tắt khi liệt kê mọi trường.

Trường nhóm area. Dữ liệu vị trí phải được ghi. Phải đặt chính xác một giá trị. area chỉ có thể là một trong những loại sau đây:
start

object (GridCoordinate)

Toạ độ để bắt đầu ghi dữ liệu. Hệ thống có thể viết số lượng hàng và cột (bao gồm cả số cột trên mỗi hàng).

range

object (GridRange)

Dải ô để ghi dữ liệu vào.

Nếu dữ liệu trong các hàng không bao gồm toàn bộ dải ô yêu cầu, các trường khớp với trường đã đặt trong fields sẽ bị xóa.

Thêm yêu cầu bộ lọc chế độ xem

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

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

object (FilterView)

Bộ lọc để thêm. Trường filterViewId là trường không bắt buộc. Nếu bạn không thiết lập thì hệ thống sẽ tạo mã nhận dạng ngẫu nhiên. (Đây là lỗi khi chỉ định ID của bộ lọc đã tồn tại.)

Yêu cầu phụ

Thêm các ô mới sau hàng cuối cùng có dữ liệu trong trang tính, chèn 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
}
Các trường
sheetId

integer

Mã trang tính cần thêm dữ liệu.

rows[]

object (RowData)

Dữ liệu cần thêm vào.

fields

string (FieldMask format)

Các trường của CellData cần được cập nhật. Phải chỉ định ít nhất một trường. Gốc là CellData; không nên chỉ định 'row.values.'. Bạn có thể sử dụng một "*" để viết tắt khi liệt kê mọi trường.

Xóa cơ bản

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

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

integer

Mã trang tính mà bạn muốn xóa bộ lọc cơ bản.

Xóa yêu cầu thứ nguyên

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

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

object (DimensionRange)

Các tham số cần xóa khỏi trang tính.

Xóa đối tượng đã nhúng

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

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

integer

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

Xóa Yêu cầu Bộ lọc

Xóa chế độ xem bộ lọc cụ thể.

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

integer

Mã của bộ lọc cần xóa.

Yêu cầu bộ lọc chế độ xem trùng lặp

Sao y chế độ xem bộ lọc cụ thể.

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

integer

ID của bộ lọc được sao chép.

Yêu cầu trang tính trùng lặp

Nhân bản nội dung của trang tính.

Biểu diễn dưới dạng JSON 
{
  "sourceSheetId": integer,
  "insertSheetIndex": integer,
  "newSheetId": integer,
  "newSheetName": string
}
Các 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, dữ liệu sao lưu của trang tính DataSource cũng sẽ được sao chép và liên kết với bản sao mới của trang tính này. Không kích hoạt thực thi dữ liệu nào, 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 số 0 mà trang tính mới cần được chèn vào. Chỉ mục của tất cả các trang tính sau khi tăng đều.

newSheetId

integer

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

newSheetName

string

Tên của trang tính mới. Nếu để trống, tên mới sẽ được chọn cho bạn.

Tìm yêu cầu thay thế

Tìm và thay thế dữ liệu trong các ô trong 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.
}
Các trường
find

string

Giá trị để tìm kiếm.

replacement

string

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

matchCase

boolean

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

matchEntireCell

boolean

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

searchByRegex

boolean

Đúng nếu giá trị tìm là regex. Biểu thức chính quy và quy tắc thay thế phải tuân theo các quy tắc regex 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 nhóm thu thập. Ví dụ: nếu một ô có nội dung "Google Sheets" và một ô khác có "Google Docs", thì việc tìm kiếm "o.* (.*)" bằng một giá trị thay thế "$1 Rocks" sẽ thay đổi nội dung của các ô đó thành "GSheets Rocks" và "GDocs Rocks".

includeFormulas

boolean

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

Trường nhóm scope. Phạm vi để tìm/thay thế -- một và chỉ một phải được đặt. scope chỉ có thể là một trong những loại sau đây:
range

object (GridRange)

Dải ô để tìm/thay thế.

sheetId

integer

Trang tính để tìm/thay thế.

allSheets

boolean

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

Chèn yêu cầu

Chèn hàng hoặc cột vào 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
}
Các trường
range

object (DimensionRange)

Kích thước cần chèn. Cả chỉ mục bắt đầu và kết thúc phải được ràng buộc.

inheritFromBefore

boolean

Liệu bạn nên mở rộng thuộc tính thứ nguyên từ các thứ nguyên trước hay sau các thứ nguyên mới được chèn. Đúng để kế thừa các tham số 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 tham số sau đó.

Ví dụ: nếu chỉ mục hàng 0 có nền đỏ và chỉ mục hàng 1 có nền xanh lục, thì việc chèn 2 hàng tại chỉ mục 1 có thể kế thừa nền xanh lá cây hoặc đỏ. Nếu inheritFromBefore là đúng, 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à sai, 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).

Chèn yêu cầu

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

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

object (GridRange)

Dải ô để chèn ô mới.

shiftDimension

enum (Dimension)

Thứ nguyên sẽ được thay đổi khi chèn ô. Nếu ROWS, các ô hiện có sẽ được chuyển xuống dưới. Nếu COLUMNS, các ô hiện có sẽ được dịch chuyển sang phải.

Yêu cầu di chuyển thứ nguyên

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
}
Các trường
source

object (DimensionRange)

Các thứ nguyên nguồn cần di chuyển.

destinationIndex

integer

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

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

Cập nhật EmbeddedObjectPositionPositionRequest

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

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

integer

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

newPosition

object (EmbeddedObjectPosition)

Vị trí rõ ràng để di chuyển đối tượng nhúng. 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 bằng mã nhận dạng và sẽ tự chọn cho bạn.

fields

string (FieldMask format)

Các trường của OverlayPosition sẽ đượ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 đó, bạn phải chỉ định ít nhất một trường. Gốc newPosition.overlayPosition là ngụ ý và không nên chỉ định. Bạn có thể sử dụng một "*" để viết tắt khi liệt kê mọi trường.

Dán dữ liệu yêu cầu

Chèn dữ liệu vào bảng tính bắt đầu từ tọa độ đượ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.
}
Các trường
coordinate

object (GridCoordinate)

Tọa độ mà tại đó dữ liệu sẽ bắt đầu được chèn vào.

data

string

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

type

enum (PasteType)

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

Trường nhóm kind. Cách diễn giải dữ liệu phải đặt chính xác một giá trị. kind chỉ có thể là một trong những loại sau đây:
delimiter

string

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

html

boolean

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

Yêu cầu cột văn bản

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

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

object (GridRange)

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

delimiter

string

Dấu tách để sử dụng. Chỉ được sử dụng nếu SeparatorType là CUSTOM.

delimiterType

enum (DelimiterType)

Loại dấu phân tách được sử dụng.

Loại dấu tách

Dấu phân tách để 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 Giá trị tùy chỉnh như được xác định trong dấu tách.
AUTODETECT Tự động phát hiện cột.

Cập nhật

Cập nhật 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
}
Các trường
filter

object (FilterView)

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. Phải chỉ định ít nhất một trường. Gốc filter là ngụ ý và không nên chỉ định. Bạn có thể sử dụng một "*" để viết tắt khi liệt kê mọi trường.

Xóa phạm vi yêu cầu

Xóa một dải ô, di chuyển các ô khác vào vùng đã xóa.

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

object (GridRange)

Dải ô cần xóa.

shiftDimension

enum (Dimension)

Thứ nguyên mà từ đó các ô đã xóa sẽ được thay thế bằng. Nếu ROWS, các ô hiện tại sẽ được chuyển lên trên để thay thế các ô đã xóa. Nếu COLUMNS, các ô hiện có sẽ được chuyển sang trái để thay thế các ô đã xóa.

Yêu cầu phụ thứ nguyên

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
}
Các trường
sheetId

integer

Trang tính để thêm hàng hoặc cột vào.

dimension

enum (Dimension)

Xác định xem có nên thêm hàng hoặc cột hay không.

length

integer

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

Thêm điều kiện định dạng yêu cầu

Thêm 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
}
Các trường
rule

object (ConditionalFormatRule)

Quy tắc để thêm.

index

integer

Chỉ mục số 0 mà quy tắc sẽ được chèn vào.

Cập nhậtConditionConditionFormatRuleRequest

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 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.
}
Các trường
index

integer

Chỉ mục không gốc của quy tắc sẽ đượ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ì sẽ không được sử dụng.

Trường nhóm 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 đây:
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.

Xóa điều kiện định dạng yêu cầu

Xóa 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
}
Các trường
index

integer

Chỉ mục không gốc của quy tắc sẽ bị xóa.

sheetId

integer

Trang tính có quy tắc đang bị xóa.

Yêu cầu Sắp xếp

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

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

object (GridRange)

Dải ô để sắp xếp.

sortSpecs[]

object (SortSpec)

Thứ tự sắp xếp mỗi cột. Thông số sau được sử dụng khi các giá trị bằng nhau trong thông số kỹ thuật trước đó.

Đặt yêu cầu xác thực dữ liệu

Đặt quy tắc xác thực dữ liệu cho mọi ô trong dải ô. Để xóa 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.

Biểu diễn dưới dạng JSON 
{
  "range": {
    object (GridRange)
  },
  "rule": {
    object (DataValidationRule)
  }
}
Các trường
range

object (GridRange)

Dải ô 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 sẽ được thiết lập trên mỗi ô trong dải ô hoặc để trống nếu bạn muốn xác thực dữ liệu trong dải ô.

Yêu cầu bộ lọc cơ bản

Đặ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)
  }
}
Các 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)
  }
}
Các trường
protectedRange

object (ProtectedRange)

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

UpdateProtectedRangeRequest

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

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

object (ProtectedRange)

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

fields

string (FieldMask format)

Các trường cần được cập nhật. Phải chỉ định ít nhất một trường. Gốc protectedRange là ngụ ý và không nên chỉ định. Bạn có thể sử dụng một "*" để viết tắt khi 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
}
Các trường
protectedRangeId

integer

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

Tự đổi kích thước yêu cầu

Tự động đổi kích thước một hoặc nhiều thứ nguyên dựa trên nội dung của các ô trong thứ nguyê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.
}
Các trường
Trường nhóm dimension_range. Phạm vi thứ nguyên. dimension_range chỉ có thể là một trong những loại sau đây:
dimensions

object (DimensionRange)

Các thứ nguyên sẽ 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.

Yêu cầu thêm biểu đồ

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

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

object (EmbeddedChart)

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

UpdateChartSpecRequest

Cập nhật thông số 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 sử dụng UpdateEmbeddedObjectPositionRequest.)

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

integer

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

spec

object (ChartSpec)

Nội dung đặc tả áp dụng cho biểu đồ.

Bản cập nhật yêu cầu cấm

Cập nhật các thuộc tính của dải theo dải cung cấp.

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

object (BandedRange)

Dải ô để cập nhật các thuộc tính mới.

fields

string (FieldMask format)

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

Yêu cầu thêm cấm

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

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

object (BandedRange)

Dải ô cần thêm. Trường bandedRangeId là trường không bắt buộc. Nếu bạn không thiết lập thì hệ thống sẽ tạo mã nhận dạng ngẫu nhiên. (Lỗi khi chỉ định ID của dải ô đã tồn tại).

Xóa yêu cầu cấm

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
}
Các trường
bandedRangeId

integer

Mã của dải ô cần xoá.

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

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)
  }
}
Các 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 mà các 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à chúng muốn cập nhật trong tham số trường, cũng như phải chỉ định ít nhất một DataFilter khớp với siêu dữ liệu mà chúng muốn cập nhật.

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

object (DataFilter)

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

developerMetadata

object (DeveloperMetadata)

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

fields

string (FieldMask format)

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

Xóa yêu cầu siêu dữ liệu nhà phát triển

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

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

object (DataFilter)

Bộ lọc dữ liệu mô tả các tiêu chí được sử dụng để chọn mục siêu dữ liệu nhà phát triển cần xóa.

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)
  }
}
Các trường
range

object (GridRange)

Dải ô để sắp xếp ngẫu nhiên.

Yêu cầu nhóm thứ nguyên

Tạo một nhóm trên dải ô được chỉ định.

Nếu phạm vi được yêu cầu là tập mẹ của phạm vi của nhóm G hiện có, thì chiều 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ụ: một nhóm [C:D, depth 1] + [B: E] dẫn đến nhóm [B: E, depth 1] và [C: D, depth 2]. Nếu phạm vi được yêu cầu là tập hợp con của phạm vi của nhóm G hiện có thì độ sâu của nhóm G mới sẽ lớn hơn độ sâu của G. Ví dụ: một nhóm [B: E, độ sâu 1] + [C: D] dẫn đến 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 sau và kết thúc sau, phạm vi của nhóm G hiện có thì phạm vi của nhóm G hiện có sẽ trở thành hợp nhất các phạm vi và nhóm G'mới có độ sâu một lớn hơn độ sâu của G và phạm vi là giao điểm của các phạm vi. Ví dụ: một nhóm [B: D, độ sâu 1] + [C: E] dẫn đến 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)
  }
}
Các trường
range

object (DimensionRange)

Dải ô để tạo nhóm.

Xóa yêu cầu nhóm thứ nguyên

Xóa một nhóm trong phạm vi được chỉ định bằng cách giảm độ sâu của thứ nguyên trong dải ô.

Ví dụ: giả sử trang tính có một nhóm độ sâu-1 thay vì B:E và một nhóm độ sâu-2 thay vì C:D. Khi xóa một nhóm trên D:E, bạn sẽ có một nhóm có độ sâu-1 theo B:D và một nhóm độ sâu 2 thay vì độ C.

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

object (DimensionRange)

Dải ô của nhóm sẽ xóa.

Cập nhật yêu cầu nhóm thứ nguyên

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
}
Các trường
dimensionGroup

object (DimensionGroup)

Nhóm có trạng thái phải được cập nhật. Phạm vi và chiều 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 đã cập nhật.

fields

string (FieldMask format)

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

Yêu cầu khoảng trắng

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

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

object (GridRange)

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

Yêu cầu xóa trùng lặp

Xóa các hàng trong dải ô này có chứa giá trị trong các cột được chỉ định là bản sao của các giá trị trong bất kỳ hàng nào trước đó. Các hàng có giá trị giống nhau nhưng các chữ cái, đị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 xóa các hàng trùng lặp bị ẩn khỏi chế độ xem (ví dụ: do một bộ lọc). Khi xóa các bản sao, bản sao đầu tiên của từng bản sao hàng từ trên xuống dưới được giữ lại trong phạm vi kết quả. Nội dung nằm ngoài phạm vi được chỉ định sẽ không bị xóa và các hàng được coi là trùng lặp không cần 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)
    }
  ]
}
Các trường
range

object (GridRange)

Dải ô để loại bỏ các hàng trùng lặp.

comparisonColumns[]

object (DimensionRange)

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

Cập nhật

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
}
Các 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 nhúng.

fields

string (FieldMask format)

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

Yêu cầu AddSlicer

Thêm 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)
  }
}
Các trường
slicer

object (Slicer)

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

Cập nhậtSlicerSpecRequest

Cập nhật thông số 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 bộ cắt, hãy sử dụng UpdateEmbeddedObjectPositionRequest.

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

integer

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

spec

object (SlicerSpec)

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

fields

string (FieldMask format)

Các trường cần được cập nhật. Phải chỉ định ít nhất một trường. Gốc SlicerSpec là ngụ ý và không nên chỉ định. Có thể sử dụng một "*"` làm tên viết tắt để liệt kê mọi trường.

Yêu cầu AddDataSource

Thêm nguồn dữ liệu. Sau khi thêm nguồn dữ liệu thành công, một trang tính DATA_SOURCE liên kết sẽ được tạo và quy trình thực thi sẽ được kích hoạt để làm mới trang tính để đọc dữ liệu từ nguồn dữ liệu đó. Yêu cầu này yêu cầu thêm phạm vi OAuth bigquery.readonly.

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

object (DataSource)

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

Yêu cầu UpdateDataSource

Cập nhật nguồn dữ liệu. Sau khi cập nhật thành công nguồn dữ liệu, hệ thống sẽ kích hoạt quá trình thực thi để 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.

Biểu diễn dưới dạng JSON 
{
  "dataSource": {
    object (DataSource)
  },
  "fields": string
}
Các 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. Phải chỉ định ít nhất một trường. Gốc dataSource là ngụ ý và không nên chỉ định. Bạn có thể sử dụng một "*" để viết tắt khi liệt kê mọi trường.

Xóa yêu cầu nguồn dữ liệu

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

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

string

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

Làm mới nguồn yêu cầu nguồn dữ liệu

Làm mới một hoặc nhiều đối tượng nguồn dữ liệu trong bảng tính bằng các tệp đối chiếu đã chỉ định. Yêu cầu này yêu cầu thêm phạm vi OAuth bigquery.readonly.

Nếu có nhiều yêu cầu làm mới tham chiếu cùng một đối tượng nguồn dữ liệu trong một lô, thì chỉ có 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 cho phù hợp.

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.
}
Các 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 chính sách này và một đối tượng nguồn dữ liệu 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 nhóm target. Chỉ định nội dung sẽ làm mới. target chỉ có thể là một trong những loại sau đây:
references

object (DataSourceObjectReferences)

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

dataSourceId

string

Tham chiếu đến một DataSource. Nếu được chỉ định, hãy 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ả các đối tượng nguồn dữ liệu hiện có trong bảng tính.

Tham chiếu dữ liệu nguồn dữ liệu

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

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

object (DataSourceObjectReference)

Tham chiếu.

Tham chiếu nguồn dữ liệu

Tham chiếu đến một đối tượng nguồn dữ liệu.

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

  // Union field value can be only one of the following:
  "sheetId": string,
  "chartId": integer,
  "dataSourceTableAnchorCell": {
    object (GridCoordinate)
  },
  "dataSourcePivotTableAnchorCell": {
    object (GridCoordinate)
  },
  "dataSourceFormulaCell": {
    object (GridCoordinate)
  }
  // End of list of possible types for union field value.
}
Các trường
Trường nhóm value. Loại tham chiếu. value chỉ có thể là một trong những loại sau đây:
sheetId

string

Tham chiếu đến trang tính DATA_SOURCE.

chartId

integer

Tham chiếu đến biểu đồ nguồn dữ liệu.

dataSourceTableAnchorCell

object (GridCoordinate)

Tham chiếu đến một DataSourceTable được neo tại ô.

dataSourcePivotTableAnchorCell

object (GridCoordinate)

Tham chiếu đến một nguồn dữ liệu PivotTable neo vào ô.

dataSourceFormulaCell

object (GridCoordinate)

Tham chiếu đến một ô có chứa DataSourceFormula.