Requests

Yêu cầu

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

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

  // 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 kết hợp kind. Loại nội dung cập nhật. Bạn phải điền đúng một trường. kind chỉ có thể là một trong các trạng thá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 các phương diện các thuộc tính.

updateNamedRange

object (UpdateNamedRangeRequest)

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

repeatCell

object (RepeatCellRequest)

Lặp lại một ô duy nhất trên 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 trang tính.

deleteSheet

object (DeleteSheetRequest)

Xoá một trang tính.

autoFill

object (AutoFillRequest)

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

cutPaste

object (CutPasteRequest)

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

copyPaste

object (CopyPasteRequest)

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

deleteEmbeddedObject

object (DeleteEmbeddedObjectRequest)

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

deleteFilterView

object (DeleteFilterViewRequest)

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

duplicateFilterView

object (DuplicateFilterViewRequest)

Sao chép chế độ xem bộ lọc.

duplicateSheet

object (DuplicateSheetRequest)

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

findReplace

object (FindReplaceRequest)

Tìm và thay thế các lần xuất hiện của văn bản bằng văn bản khác.

insertDimension

object (InsertDimensionRequest)

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

insertRange

object (InsertRangeRequest)

Chèn các ô mới trong 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 đến vị trí khác trong trang tính.

updateEmbeddedObjectPosition

object (UpdateEmbeddedObjectPositionRequest)

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

pasteData

object (PasteDataRequest)

Dán dữ liệu (HTML hoặc được phân 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 các thuộc tính của chế độ xem bộ lọc.

deleteRange

object (DeleteRangeRequest)

Xoá một dải ô khỏi một trang tính, dịch chuyển các ô còn lại.

appendDimension

object (AppendDimensionRequest)

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

addConditionalFormatRule

object (AddConditionalFormatRuleRequest)

Thêm 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á quy tắc định dạng có điều kiện hiện có.

sortRange

object (SortRangeRequest)

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

setDataValidation

object (SetDataValidationRequest)

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

setBasicFilter

object (SetBasicFilterRequest)

Đặt bộ lọc cơ bản trên 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 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 một 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 ô

addBanding

object (AddBandingRequest)

Thêm dải ô mới

deleteBanding

object (DeleteBandingRequest)

Xoá dải ô

createDeveloperMetadata

object (CreateDeveloperMetadataRequest)

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

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)

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

randomizeRange

object (RandomizeRangeRequest)

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

addDimensionGroup

object (AddDimensionGroupRequest)

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

deleteDimensionGroup

object (DeleteDimensionGroupRequest)

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

deleteDuplicates

object (DeleteDuplicatesRequest)

Xóa các hàng có 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 một đối tượng được nhúng.

addSlicer

object (AddSlicerRequest)

Thêm một 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 một nguồn dữ liệu.

deleteDataSource

object (DeleteDataSourceRequest)

Xoá 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 đối tượng db đối tượng được liên kết.

UpdateSpreadsheetPropertiesRequest

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

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

object (SpreadsheetProperties)

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

fields

string (FieldMask format)

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

UpdateSheetPropertiesRequest

Cập nhật các thuộc tính của trang tính bằng sheetId.

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

object (SheetProperties)

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

fields

string (FieldMask format)

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

UpdateDimensionPropertiesRequest

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

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

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

Trường kết hợp dimension_range. Phạm vi phương diện. dimension_range chỉ có thể là một trong các trạng thá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

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

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

integer

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

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 thuộc tính được chỉ định namedRangeId.

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

object (NamedRange)

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

fields

string (FieldMask format)

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

RepeatCellRequest

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

Nếu bạn viết một ô bằng công thức, các dải ô của công thức sẽ tự động tăng dần cho mỗi trường trong dải ô. Ví dụ: nếu viết một ô có công thức =A1 vào dải ô 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.

Để giữ cho dải ô của công thức ở dạng 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 dầ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 cập nhật. Bạn phải chỉ định ít nhất một trường. Gốc cell đã được ngụ ý và không được chỉ định. Một "*" có thể được sử dụng làm cú pháp viết tắt để liệt kê mọi trường.

AddNamedRangeRequest

Thêm 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. Chiến lược phát hành đĩa đơn namedRangeId là trường không bắt buộc; nếu bạn không đặt giá trị nhận dạng, thì một mã nhận dạng sẽ được tạo ngẫu nhiên. (Sẽ xảy ra lỗi khi chỉ định mã nhận dạng của một dải ô đã tồn tại.)

DeleteNamedRangeRequest

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

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

string

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

AddSheetRequest

Thêm trang tính mới. Khi trang tính được thêm vào chỉ mục đã cho, tất cả các trang tính tiếp theo chỉ mục sẽ tăng lên. Để thêm trang tính đối tượng, hãy sử dụng AddChartRequest thay vào đó 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 sẽ có. Tất cả thuộc tính là không bắt buộc. Chiến lược phát hành đĩa đơn sheetId là trường không bắt buộc; nếu bạn không đặt giá trị nhận dạng, thì một mã nhận dạng sẽ được tạo ngẫu nhiên. (Sẽ xảy ra lỗi khi chỉ định mã nhận dạng của một trang tính đã tồn tại.)

DeleteSheetRequest

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

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

integer

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

Nếu trang tính là DATA_SOURCE loại, thứ nguyên được liên kết DataSource 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

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

Trường kết hợp area. Vùng tự động điền. area chỉ có thể là một trong các trạng thá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 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 cần tự động điền. Thao tác này liệt kê rõ nguồn gốc của tính năng tự động điền và nơi mở rộng dữ liệu đó.

SourceAndDestination

Tổ hợp 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 dùng làm nguồn của thông tin tự động điền.

dimension

enum (Dimension)

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

fillLength

integer

Số hàng hoặc cột cần điền dữ liệu. Số dương mở rộng ra ngoài hàng hoặc cột cuối cùng của nguồn. Số âm sẽ mở rộng trước hàng 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 dữ liệu sẽ được dán.

pasteType

enum (PasteType)

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

PasteType

Loại dữ liệu cần 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ần định dạng, công thức hoặc 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 Thích 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 vào đí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í cần dán vào. Nếu phạm vi bao phủ một khoảng là bội số của chiều cao hoặc chiều rộng của nguồn, thì dữ liệu sẽ được lặp lại để điền vào dải ô đích. Nếu dải ô nhỏ hơn dải ô nguồn, thì toàn bộ dữ liệu nguồn sẽ vẫn được sao chép (ngoài dải ô đích đến).

pasteType

enum (PasteType)

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

pasteOrientation

enum (PasteOrientation)

Cách dữ liệu phải được hướng 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 nội dung hoán vị, nơi 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 để tạo.

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

UnmergeCellsRequest

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

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

object (GridRange)

Dải ô mà trong đó tất cả các ô sẽ được hủy hợp nhất. Nếu dải ô trải rộng qua nhiều ô hợp nhất, tất cả sẽ không được hợp nhất. Dải ô không được kéo dài 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 thiết lập trong yêu cầu, đường viền sẽ được 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ẽ dẫn đến việc 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.

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

object (GridRange)

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

top

object (Border)

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

bottom

object (Border)

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

left

object (Border)

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

right

object (Border)

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

innerHorizontal

object (Border)

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

innerVertical

object (Border)

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

UpdateCellsRequest

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

Trường kết hợp 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 các trạng thái sau:
start

object (GridCoordinate)

Toạ độ để bắt đầu ghi dữ liệu. Bạn có thể ghi số lượng hàng và cột bất kỳ (bao gồm cả số lượng cột khác nhau 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 ô được yêu cầu, thì các trường khớp với các hàng đã đặt 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. Chiến lược phát hành đĩa đơn filterViewId là trường không bắt buộc; nếu bạn không đặt giá trị nhận dạng, thì một mã nhận dạng sẽ được tạo ngẫu nhiên. (Sẽ xảy ra lỗi khi chỉ định mã nhận dạng của bộ lọc đã tồn tại.)

AppendCellsRequest

Thêm các ô mới sau hàng cuối cùng bằng dữ liệu trong một 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
}
Trường
sheetId

integer

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

rows[]

object (RowData)

Dữ liệu cần bổ sung.

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. Gốc là CellData; "row.values". không được chỉ định. Một "*" có thể được sử dụng làm cú pháp viết tắ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ã trang tính mà bộ lọc cơ bản sẽ bị xoá.

DeleteDimensionRequest

Xoá 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)

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

DeleteEmbeddedObjectRequest

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

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

integer

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

DeleteFilterViewRequest

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

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

integer

Mã bộ lọc cần xoá.

DuplicateFilterViewRequest

Sao chép 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ã 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 là DATA_SOURCE loại, phương thức sao lưu DataSource 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 sang 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 từ 0 mà bạn sẽ chèn trang tính mới. Chỉ mục của tất cả các trang tính sau đó sẽ tăng lên.

newSheetId

integer

Nếu được đặt, đây là mã nhận dạng 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ã nhận dạng. Nếu được đặt, mã nhận dạng này không được xung đột với mã trang tính hiện có. Nếu đặ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 trống, tên mới sẽ được chọn 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ả 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ị được sử dụng làm giá trị 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 thấy khớp với toàn bộ ô.

searchByRegex

boolean

Đúng nếu giá trị tìm là một biểu thức chính quy. Biểu thức chính quy và biểu thức 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 địa điểm khác có "Google Docs", sau đó tìm kiếm "o.* (.*)" bằng một bản thay thế của "$1 Rocks" sẽ thay đổi nội dung của ô thành "GSheets Rocks""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 kết hợp scope. Phạm vi tìm/thay thế -- phải đặt một và chỉ một. scope chỉ có thể là một trong các trạng thái sau:
range

object (GridRange)

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

sheetId

integer

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

allSheets

boolean

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

InsertDimensionRequest

Chèn các hàng hoặc cột trong 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 bị chặn.

inheritFromBefore

boolean

Liệu 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. "True" để kế thừa từ các phương diện trước (trong trường hợp này, chỉ mục bắt đầu phải lớn hơn 0) và "false" để kế thừa từ các phương diện sau.

Ví dụ: nếu chỉ mục hàng 0 có nền màu đỏ và chỉ mục hàng 1 có nền màu xanh lục, thì việc chèn 2 hàng ở chỉ mục 1 có thể kế thừa nền màu xanh lục hoặc màu đỏ. Nếu inheritFromBefore đúng, hai hàng mới sẽ có màu đỏ (vì hàng trước điểm chèn có màu đỏ), trong khi nếu inheritFromBefore là false, 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 ô vào một dải ô, di chuyển các ô hiện có lên trên hoặc xuống dưới.

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

object (GridRange)

Dải ô để chèn các ô mới vào.

shiftDimension

enum (Dimension)

Phương diện sẽ bị dịch chuyển khi chèn ô. Nếu ROWS, các ô hiện có sẽ được dịch chuyển xuống dưới. Nếu COLUMNS, các ô hiện có sẽ được dịch 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 từ 0 của vị trí di chuyển dữ liệu nguồn đến dựa trên toạ độ trước dữ liệu nguồn sẽ bị xoá khỏi lưới. Dữ liệu hiện có sẽ được dịch chuyển xuống dưới hoặc sang phải (tuỳ thuộc vào phương diện) để nhường chỗ cho các phương diện được di chuyển. Các phương diện nguồn bị xoá khỏi lưới, vì vậy, dữ liệu có thể có một chỉ mục khác với chỉ mục được chỉ định.

Ví dụ: giả sử A1..A5 trong số 0, 1, 2, 3, 4 và muốn chuyển "1""2" đến giữa "3""4", nguồn sẽ là ROWS [1..3) và chỉ mục đích đến sẽ là "4" (chỉ mục gốc của hàng 5). Kết quả cuối cùng sẽ là A1..A5 trong số 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ư biểu đồ hoặc hình ảnh đang di chuyển hoặc đổi kích thước).

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

integer

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

newPosition

object (EmbeddedObjectPosition)

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

fields

string (FieldMask format)

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

PasteDataRequest

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

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

  // 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 vào.

data

string

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

type

enum (PasteType)

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

Trường kết hợp 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 các trạng thá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

Chia một 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)
}
Trường
source

object (GridRange)

Dải ô dữ liệu nguồn. Thuộc tính này phải nằm trong đúng một cột.

delimiter

string

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

delimiterType

enum (DelimiterType)

Loại dấu phân cách 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 như được xác định trong dấu phân tách.
AUTODETECT Tự động phát hiện cột.

UpdateFilterViewRequest

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

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

object (FilterView)

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

fields

string (FieldMask format)

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

DeleteRangeRequest

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

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

object (GridRange)

Dải ô cần xoá.

shiftDimension

enum (Dimension)

Phương diện mà từ đó các ô đã xóa 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á.

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 để thêm hàng hoặc cột vào.

dimension

enum (Dimension)

Liệu các hàng hay cột có cần được thêm vào hay không.

length

integer

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

AddConditionalFormatRuleRequest

Thêm quy tắc định dạng có điều kiện mới vào chỉ mục đã cho. Tất cả các quy tắc tiếp theo chỉ mục sẽ 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 từ 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 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 gốc 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 newIndex được đặt, nếu không thì không được sử dụng.

Trường kết hợp instruction. Kiểu cập nhật sẽ diễn ra. instruction chỉ có thể là một trong các trạng thá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 từ 0 mà quy tắc sẽ kết thúc.

DeleteConditionalFormatRuleRequest

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

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

integer

Chỉ mục gốc 0 của quy tắc cần xoá.

sheetId

integer

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

SortRangeRequest

Sắp xếp dữ liệu trong các hàng dựa trên thứ tự sắp xếp mỗi 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 mỗi cột. Các thông số kỹ thuật sau này được sử dụng khi các giá trị bằng nhau trong các thông số kỹ thuật trước đó.

SetDataValidationRequest

Đặ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 lệnh này mà không có quy tắc nào được chỉ định.

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

object (GridRange)

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

rule

object (DataValidationRule)

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

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 được thêm vào. Chiến lược phát hành đĩa đơn protectedRangeId là trường không bắt buộc; nếu bạn không đặt giá trị nhận dạng, thì một mã nhận dạng sẽ được tạo ngẫu nhiên. (Sẽ xảy ra lỗi khi chỉ định mã nhận dạng 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 dải ô được chỉ định protectedRangeId.

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

DeleteProtectedRangeRequest

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

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

integer

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

AutoResizeDimensionsRequest

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

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

  // 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 kết hợp dimension_range. Phạm vi phương diện. dimension_range chỉ có thể là một trong các trạng thái sau:
dimensions

object (DimensionRange)

Phương diệ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 cần 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í của biểu đồ. Chiến lược phát hành đĩa đơn chartId là trường không bắt buộc; nếu bạn không đặt giá trị nhận dạng, thì một mã nhận dạng sẽ được tạo ngẫu nhiên. (Sẽ xảy ra lỗi khi chỉ định mã nhận dạng của một đối tượng được nhúng đã tồn tại.)

UpdateChartSpecRequest

Cập nhật 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)
  }
}
Trường
chartId

integer

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

spec

object (ChartSpec)

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

UpdateBandingRequest

Cập nhật các thuộc tính của dải ô đã 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ập nhật với các thuộc tính mới.

fields

string (FieldMask format)

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

AddBandingRequest

Thêm 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ần thêm. Chiến lược phát hành đĩa đơn bandedRangeId là trường không bắt buộc; nếu bạn không đặt giá trị nhận dạng, thì một mã nhận dạng sẽ được tạo ngẫu nhiên. (Sẽ xảy ra lỗi khi chỉ định mã nhận dạng của một dải ô đã tồn tại.)

DeleteBandingRequest

Xoá dải ô có 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 mà các bộ lọc đã chọn thành các giá trị được cung cấp trong DeveloperMetadata nguồn. Phương thức gọi phải chỉ định thuộc tính họ muốn cập nhật trong thông số trường, cũng như chỉ định ít nhất một thuộc tính DataFilter khớp với siêu dữ liệu mà họ muốn cập nhật.

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

object (DataFilter)

Các bộ lọc khớp với mục nhập 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ả siêu dữ liệu khớp với bộ lọc dữ liệu sẽ được cập nhật.

fields

string (FieldMask format)

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

DeleteDeveloperMetadataRequest

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

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

object (DataFilter)

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

RandomizeRangeRequest

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

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

object (GridRange)

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

AddDimensionGroupRequest

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

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

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

DeleteDimensionGroupRequest

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

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

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

object (DimensionRange)

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

UpdateDimensionGroupRequest

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

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

object (DimensionGroup)

Nhóm có trạng thái cần đượ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 cập nhật.

fields

string (FieldMask format)

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

TrimWhitespaceRequest

Cắt bỏ khoảng trắng (chẳng hạn như dấu cách, thẻ hoặc dòng mới) ở mọi ô trong dải ô được chỉ định. Yêu cầu này sẽ xoá tất cả khoảng trắng ở phần đầu và cuối văn bản của mỗi ô, đồng thời giảm mọi ký tự tiếp theo gồm các ký tự khoảng trắng còn lại thành một dấu cách. Nếu văn bản được cắt bớt bắt đầu bằng dấu '+' hoặc '=' thì văn bản vẫn là một 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)
  }
}
Trường
range

object (GridRange)

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

DeleteDuplicatesRequest

Xóa các hàng trong dải ô này có 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 kiểu chữ, định dạng hoặc công thức khác nhau đượ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á giá trị trùng lặp, bản sao đầu tiên của mỗi lượt quét hàng trùng lặp từ trên xuống dưới được lưu giữ 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 cần phải nằm cạnh nhau trong dải ô.

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

object (GridRange)

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

comparisonColumns[]

object (DimensionRange)

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

UpdateEmbeddedObjectBorderRequest

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

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

integer

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

border

object (EmbeddedObjectBorder)

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

fields

string (FieldMask format)

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

AddSlicerRequest

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

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

object (Slicer)

Bộ cắt cần được thêm vào bảng tính, bao gồm cả vị trí cần đặt. Chiến lược phát hành đĩa đơn slicerId là trường không bắt buộc; nếu bạn không đặt giá trị nhận dạng, thì một mã nhận dạng sẽ được tạo ngẫu nhiên. (Sẽ xảy ra lỗi khi chỉ định mã nhận dạng của một bộ cắt đã tồn tại.)

UpdateSlicerSpecRequest

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 một 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
}
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. Bạn phải chỉ định ít nhất một trường. Gốc SlicerSpec đã được ngụ ý và không được chỉ định. Bạn có thể dùng một "*" để viết tắt để 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, DATA_SOURCE trang tính được tạo và thực thi đượ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 bổ sung bigquery.readonly Phạm vi OAuth 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 một nguồn dữ liệu. Sau khi cập nhật thành công nguồn dữ liệu, một lượt thực thi sẽ được kích hoạt để làm mới thuộc tính DATA_SOURCE trang tính để đọc dữ liệu từ nguồn dữ liệu đã cập nhật.

Yêu cầu bổ sung bigquery.readonly Phạm vi OAuth 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 cập nhật. Bạn phải chỉ định ít nhất một trường. Gốc dataSource đã được ngụ ý và không được chỉ định. Một "*" có thể được sử dụng làm cú pháp viết tắt để liệt kê mọi trường.

DeleteDataSourceRequest

Xoá nguồn dữ liệu. Yêu cầu này cũng 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
}
Trường
dataSourceId

string

Mã nhận dạng 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 thông tin tham chiếu đã chỉ định.

Yêu cầu bổ sung bigquery.readonly Phạm vi OAuth 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 nhất mới được xử lý và tất cả các yêu cầu đó cũng sẽ nhận được cùng một phản hồi.

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 bạn không đặt chính sách này và một đối tượng nguồn dữ liệu được tham chiếu ở trạng thái lỗi, thì quá trình làm mới sẽ không thành công ngay lập tức.

Trường kết hợp target. Chỉ định nội dung cần làm mới. target chỉ có thể là một trong các trạng thái sau:
references

object (DataSourceObjectReferences)

Thông tin tham chiếu đến đối tượng nguồn dữ liệu cần 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ả đối tượng nguồn dữ liệu hiện có trong bảng tính.

DataSourceObjectReferences

Danh sách tham chiếu đến đố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ệp đối chiếu.

CancelDataSourceRefreshRequest

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

Yêu cầu bổ sung bigquery.readonly Phạm vi OAuth nếu bạn đang huỷ quá trình làm mới trên một 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 kết hợp target. Chỉ định loại dữ liệu cần huỷ. target chỉ có thể là một trong các trạng thái sau:
references

object (DataSourceObjectReferences)

Tham chiếu đến đối tượng nguồn dữ liệu có quá trình làm mới sẽ bị huỷ.

dataSourceId

string

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

isAll

boolean

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