Yêu cầu
Một loại nội dung cập nhật để áp dụng cho bảng tính.
Biểu diễn dưới dạng JSON |
---|
{ // Union field |
Trường | |
---|---|
Trường 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
|
Cập nhật các thuộc tính của bảng tính. |
updateSheetProperties
|
Cập nhật các thuộc tính của trang tính. |
updateDimensionProperties
|
Cập nhật thuộc tính của phương diện. |
updateNamedRange
|
Cập nhật một dải ô được đặt tên. |
repeatCell
|
Lặp lại một ô trên một dải ô. |
addNamedRange
|
Thêm một dải ô được đặt tên. |
deleteNamedRange
|
Xoá một dải ô được đặt tên. |
addSheet
|
Thêm trang tính. |
deleteSheet
|
Xoá một trang tính. |
autoFill
|
Tự động điền thêm dữ liệu dựa trên dữ liệu hiện có. |
cutPaste
|
Cắt dữ liệu từ một vùng và dán dữ liệu đó vào một vùng khác. |
copyPaste
|
Sao chép dữ liệu từ một khu vực rồi dán vào khu vực khác. |
mergeCells
|
Hợp nhất các ô với nhau. |
unmergeCells
|
Hủy hợp nhất các ô đã hợp nhất. |
updateBorders
|
Cập nhật đường viền trong một dải ô. |
updateCells
|
Cập nhật nhiều ô cùng một lúc. |
addFilterView
|
Thêm chế độ xem bộ lọc. |
appendCells
|
Thêm các ô sau hàng cuối cùng có dữ liệu trong trang tính. |
clearBasicFilter
|
Xoá bộ lọc cơ bản trên một trang tính. |
deleteDimension
|
Xoá hàng hoặc cột trong một trang tính. |
deleteEmbeddedObject
|
Xoá một đối tượng được nhúng (ví dụ: biểu đồ, hình ảnh) trong trang tính. |
deleteFilterView
|
Xoá chế độ xem bộ lọc khỏi trang tính. |
duplicateFilterView
|
Sao chép một chế độ xem bộ lọc. |
duplicateSheet
|
Sao chép một trang tính. |
findReplace
|
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
|
Chèn hàng hoặc cột mới vào một trang tính. |
insertRange
|
Chèn các ô mới vào một trang tính, dịch chuyển các ô hiện có. |
moveDimension
|
Di chuyển hàng hoặc cột đến một vị trí khác trong trang tính. |
updateEmbeddedObjectPosition
|
Cập nhật vị trí của một đối tượng được nhúng (ví dụ: biểu đồ, hình ảnh). |
pasteData
|
Dán dữ liệu (HTML hoặc phân cách) vào một trang tính. |
textToColumns
|
Chuyển đổi một cột văn bản thành nhiều cột văn bản. |
updateFilterView
|
Cập nhật các thuộc tính của chế độ xem bộ lọc. |
deleteRange
|
Xoá một dải ô khỏi một trang tính, dịch chuyển các ô còn lại. |
appendDimension
|
Thêm các phương diện vào cuối trang tính. |
addConditionalFormatRule
|
Thêm quy tắc định dạng có điều kiện mới. |
updateConditionalFormatRule
|
Cập nhật quy tắc định dạng có điều kiện hiện có. |
deleteConditionalFormatRule
|
Xoá quy tắc định dạng có điều kiện hiện có. |
sortRange
|
Sắp xếp dữ liệu trong một dải ô. |
setDataValidation
|
Thiết lập phương thức xác thực dữ liệu cho một hoặc nhiều ô. |
setBasicFilter
|
Đặt bộ lọc cơ bản trên một trang tính. |
addProtectedRange
|
Thêm một dải ô được bảo vệ. |
updateProtectedRange
|
Cập nhật một dải ô được bảo vệ. |
deleteProtectedRange
|
Xoá một dải ô được bảo vệ. |
autoResizeDimensions
|
Tự động đổi kích thước một hoặc nhiều phương diện dựa vào nội dung của các ô trong phương diện đó. |
addChart
|
Thêm một biểu đồ. |
updateChartSpec
|
Cập nhật quy cách của biểu đồ. |
updateBanding
|
Cập nhật một dải ô theo dải |
addBanding
|
Thêm dải ô mới |
deleteBanding
|
Xoá dải ô theo dải |
createDeveloperMetadata
|
Tạo siêu dữ liệu dành cho nhà phát triển mới |
updateDeveloperMetadata
|
Cập nhật mục siêu dữ liệu hiện có dành cho nhà phát triển |
deleteDeveloperMetadata
|
Xoá siêu dữ liệu của nhà phát triển |
randomizeRange
|
Sắp xếp ngẫu nhiên thứ tự các hàng trong dải ô. |
addDimensionGroup
|
Tạo một nhóm trên dải ô được chỉ định. |
deleteDimensionGroup
|
Xoá một nhóm trên dải ô được chỉ định. |
updateDimensionGroup
|
Cập nhật trạng thái của nhóm đã chỉ định. |
trimWhitespace
|
Cắt bỏ các ô của khoảng trắng (chẳng hạn như dấu cách, thẻ hoặc dòng mới). |
deleteDuplicates
|
Xoá 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
|
Cập nhật đường viền của một đối tượng đã nhúng. |
addSlicer
|
Thêm một bộ cắt. |
updateSlicerSpec
|
Cập nhật thông số kỹ thuật của một bộ cắt. |
addDataSource
|
Thêm một nguồn dữ liệu. |
updateDataSource
|
Cập nhật một nguồn dữ liệu. |
deleteDataSource
|
Xoá một nguồn dữ liệu. |
refreshDataSource
|
Làm mới một hoặc nhiều nguồn dữ liệu và các đối tượng dbobject được liên kết. |
cancelDataSourceRefresh
|
Huỷ làm mới một hoặc nhiều nguồn dữ liệu và các đối tượng dbobject được liên kết. |
UpdateSpreadsheetPropertiesRequest
Cập nhật các thuộc tính của bảng tính.
Biểu diễn dưới dạng JSON |
---|
{
"properties": {
object (
|
Trường | |
---|---|
properties
|
Các thuộc tính cần cập nhật. |
fields
|
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 nên được chỉ định. Có thể dùng một |
UpdateSheetPropertiesRequest
Cập nhật các thuộc tính của trang tính bằng sheetId
được chỉ định.
Biểu diễn dưới dạng JSON |
---|
{
"properties": {
object (
|
Trường | |
---|---|
properties
|
Các thuộc tính cần cập nhật. |
fields
|
Các trường cần được cập nhật. Bạn phải chỉ định ít nhất một trường. |
UpdateDimensionPropertiesRequest
Cập nhật thuộc tính của các phương diện trong dải ô được chỉ định.
Biểu diễn dưới dạng JSON |
---|
{ "properties": { object ( |
Trường | |
---|---|
properties
|
Các thuộc tính cần cập nhật. |
fields
|
Các trường cần được cập nhật. Bạn phải chỉ định ít nhất một trường. |
Trường 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
|
Các hàng hoặc cột cần cập nhật. |
dataSourceSheetRange
|
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 chiều trên trang tính DATA_SOURCE
.
Biểu diễn dưới dạng JSON |
---|
{
"sheetId": integer,
"columnReferences": [
{
object (
|
Trường | |
---|---|
sheetId
|
Mã của trang tính nguồn dữ liệu mà dải ô đang bật. |
columnReferences[]
|
Các cột trên trang tính nguồn dữ liệu. |
UpdateNamedRangeRequest
Cập nhật các thuộc tính của dải ô được đặt tên bằng namedRangeId
đã chỉ định.
Biểu diễn dưới dạng JSON |
---|
{
"namedRange": {
object (
|
Trường | |
---|---|
namedRange
|
Dải ô được đặt tên để cập nhật các thuộc tính mới. |
fields
|
Các trường cần được cập nhật. Bạn phải chỉ định ít nhất một trường. |
RepeatCellRequest
Cập nhật tất cả các ô trong dải ô thành các giá trị trong đối tượng Ô đã cho. Chỉ những trường được liệt kê trong trường fields
là được cập nhật; các trường khác sẽ không thay đổi.
Nếu bạn viết một ô bằng công thức, thì dải ô của công thức sẽ tự động tăng lên đối với từng trường trong dải ô. Ví dụ: Nếu ghi 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 phạm vi 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 giá.
Biểu diễn dưới dạng JSON |
---|
{ "range": { object ( |
Trường | |
---|---|
range
|
Dải ô để lặp lại ô. |
cell
|
Dữ liệu cần ghi. |
fields
|
Các trường cần được cập nhật. Bạn phải chỉ định ít nhất một 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 (
|
Trường | |
---|---|
namedRange
|
Dải ô được đặt tên cần thêm. Trường |
DeleteNamedRangeRequest
Xoá dải ô được đặt tên có mã nhận dạng cho trước khỏi bảng tính.
Biểu diễn dưới dạng JSON |
---|
{ "namedRangeId": string } |
Trường | |
---|---|
namedRangeId
|
Mã của dải ô được đặt tên cần xoá. |
AddSheetRequest
Thêm trang tính mới. Khi một trang tính được thêm tại một chỉ mục nhất định, tất cả chỉ mục của trang tính tiếp theo sẽ tăng lên. Để thêm 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 (
|
Trường | |
---|---|
properties
|
Các thuộc tính mà trang tính mới cần có. Tất cả cơ sở lưu trú đều không bắt buộc. Trường |
DeleteSheetRequest
Xoá trang tính được yêu cầu.
Biểu diễn dưới dạng JSON |
---|
{ "sheetId": integer } |
Trường | |
---|---|
sheetId
|
Mã của trang tính cần xoá.
Nếu trang tính thuộc loại |
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 |
Trường | |
---|---|
useAlternateSeries
|
"True" nếu chúng ta nên tạo dữ liệu bằng chuỗi "alternate". Điều này sẽ khác nhau tuỳ thuộc vào loại và lượng dữ liệu nguồn. |
Trường hợp area . Khu vực để tự động điền.
area chỉ có thể là một trong các trạng thái sau:
|
|
range
|
Dải ô để tự động điền. Điều này sẽ kiểm tra phạm vi 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
|
Vùng nguồn và vùng đích để tự động điền. Thao tác này sẽ liệt kê rõ ràng nguồn của tính năng tự động điền và nơi cần mở rộng dữ liệu đó. |
SourceAndDestination
Sự kết hợp giữa phạm vi nguồn và cách mở rộng nguồn đó.
Biểu diễn dưới dạng JSON |
---|
{ "source": { object ( |
Trường | |
---|---|
source
|
Vị trí của dữ liệu được dùng làm nguồn của tính năng tự động điền. |
dimension
|
Phương diện mà dữ liệu sẽ được điền vào. |
fillLength
|
Số hàng hoặc cột mà dữ liệu sẽ được điền vào. Số dương mở rộng ra ngoài hàng cuối cùng hoặc cột cuối cùng của nguồn. Số âm sẽ mở rộng trước hàng đầu tiên hoặc cột đầu tiên của nguồn. |
CutPasteRequest
Di chuyển dữ liệu từ nguồn sang đích đến.
Biểu diễn dưới dạng JSON |
---|
{ "source": { object ( |
Trường | |
---|---|
source
|
Dữ liệu nguồn cần cắt. |
destination
|
Toạ độ trên cùng bên trái mà bạn sẽ dán dữ liệu. |
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 nào nên được dán.
Enum | |
---|---|
PASTE_NORMAL
|
Dán giá trị, công thức, định dạng và hợp nhất. |
PASTE_VALUES
|
CHỈ dán các giá trị 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ác công thức. |
PASTE_DATA_VALIDATION
|
Chỉ dán quy trình xác thực dữ liệu. |
PASTE_CONDITIONAL_FORMATTING
|
Chỉ dán quy tắc định dạng có điều kiện. |
CopyPasteRequest
Sao chép dữ liệu từ nguồn sang đích đến.
Biểu diễn dưới dạng JSON |
---|
{ "source": { object ( |
Trường | |
---|---|
source
|
Dải ô nguồn cần sao chép. |
destination
|
Vị trí cần dán vào. Nếu dải ô bao gồm một khoảng là bội số của chiều cao hoặc chiều rộng của nguồn, thì dữ liệu sẽ được lặp lại để điền vào dải ô đích. Nếu phạm vi nhỏ hơn phạm vi nguồn, toàn bộ dữ liệu nguồn sẽ vẫn được sao chép (ngoài phạm vi cuối cùng của phạm vi đích). |
pasteType
|
Loại dữ liệu cần dán. |
pasteOrientation
|
Cách định hướng dữ liệu đó khi dán. |
PasteOrientation
Cách thực hiện thao tác dán.
Enum | |
---|---|
NORMAL
|
Dán như bình thường. |
TRANSPOSE
|
Dán 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. |
MergeCellsRequest
Hợp nhất tất cả các ô trong dải ô.
Biểu diễn dưới dạng JSON |
---|
{ "range": { object ( |
Trường | |
---|---|
range
|
Dải ô cần hợp nhất. |
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 hợp nhất cho từng cột trong dải ô |
MERGE_ROWS
|
Tạo 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 (
|
Trường | |
---|---|
range
|
Dải ô mà trong đó tất cả các ô cần được huỷ hợp nhất. Nếu phạm vi kéo dài qua nhiều phần được 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ỳ phần hợp nhất nào. |
UpdateBordersRequest
Cập nhật đường viền của một dải ô. Nếu một trường không được đặt trong yêu cầu thì đường viền vẫn giữ nguyên. Ví dụ: với 2 UpdateBordersRequest tiếp theo:
-
dải ô: A1:A5
{ top: RED, bottom: WHITE }
-
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 rõ ràng thành NONE
.
Biểu diễn dưới dạng JSON |
---|
{ "range": { object ( |
Trường | |
---|---|
range
|
Dải ô có đường viền cần được cập nhật. |
top
|
Đường viền để đặt ở đầu dải ô. |
bottom
|
Đường viền để đặt ở cuối dải ô. |
left
|
Đường viền để đặt ở bên trái dải ô. |
right
|
Đường viền để đặt ở bên phải dải ô. |
innerHorizontal
|
Đường viền ngang để đặt trong phạm vi. |
innerVertical
|
Đường viền dọc để đặt trong phạm vi. |
UpdateCellsRequest
Cập nhật tất cả các ô trong một dải ô bằng dữ liệu mới.
Biểu diễn dưới dạng JSON |
---|
{ "rows": [ { object ( |
Trường | |
---|---|
rows[]
|
Dữ liệu cần ghi. |
fields
|
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; không nên chỉ định "row.values.". Có thể dùng một |
Trường hợp area . Bạn phải ghi dữ liệu vị trí. 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
|
Toạ độ để bắt đầu ghi dữ liệu. Có thể ghi số hàng và cột bất kỳ (bao gồm số lượng cột khác nhau trong mỗi hàng). |
range
|
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 những trường được đặt trong |
AddFilterViewRequest
Thêm chế độ xem bộ lọc.
Biểu diễn dưới dạng JSON |
---|
{
"filter": {
object (
|
Trường | |
---|---|
filter
|
Bộ lọc cần thêm. Trường |
AppendCellsRequest
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 (
|
Trường | |
---|---|
sheetId
|
Mã trang tính cần thêm dữ liệu vào. |
rows[]
|
Dữ liệu cần nối. |
fields
|
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; không nên chỉ định "row.values.". Có thể dùng một |
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
|
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 (
|
Trường | |
---|---|
range
|
Các phương diện cần xoá khỏi trang tính. |
DeleteEmbeddedObjectRequest
Xoá đối tượng đã nhúng bằng mã nhận dạng đã cho.
Biểu diễn dưới dạng JSON |
---|
{ "objectId": integer } |
Trường | |
---|---|
objectId
|
Mã của đối tượng được nhúng cần xoá. |
DeleteFilterViewRequest
Xoá một chế độ xem bộ lọc cụ thể.
Biểu diễn dưới dạng JSON |
---|
{ "filterId": integer } |
Trường | |
---|---|
filterId
|
Mã của 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
|
Mã của bộ lọc bị trùng lặp. |
DuplicateSheetRequest
Sao chép nội dung của một trang tính.
Biểu diễn dưới dạng JSON |
---|
{ "sourceSheetId": integer, "insertSheetIndex": integer, "newSheetId": integer, "newSheetName": string } |
Trường | |
---|---|
sourceSheetId
|
Trang tính cần sao chép.
Nếu trang tính nguồn thuộc loại |
insertSheetIndex
|
Chỉ mục dựa trên 0 mà trang tính mới sẽ được chèn. Chỉ mục của tất cả các trang tính sau hàm này sẽ tăng lên. |
newSheetId
|
Mã của trang tính mới nếu được đặt. 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ã này không được xung đột với bất kỳ mã trang tính hiện có nào. Nếu được đặt, giá trị này không được là số âm. |
newSheetName
|
Tên của trang tính mới. Nếu để trống, hệ thống sẽ chọn một tên mới cho bạn. |
FindReplaceRequest
Tìm và thay thế dữ liệu trong các ô trên một dải ô, trang tính hoặc tất cả 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 |
Trường | |
---|---|
find
|
Giá trị cần tìm kiếm. |
replacement
|
Giá trị thay thế. |
matchCase
|
Đúng nếu nội dung tìm kiếm có phân biệt chữ hoa chữ thường. |
matchEntireCell
|
Đúng nếu giá trị tìm phải khớp với toàn bộ ô. |
searchByRegex
|
"True" nếu giá trị tìm kiếm là biểu thức chính quy. Biểu thức chính quy và việc thay thế phải tuân theo các quy tắc biểu thức chính quy của Java tại https://docs.oracle.com/javase/8/docs/api/java/util/regex/Pattern.html. Chuỗi thay thế được phép tham chiếu đến các nhóm thu thập. Ví dụ: nếu một ô có nội dung |
includeFormulas
|
Đúng nếu nội dung 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 hợp scope . Phạm vi để tìm/thay thế - một và chỉ một phạm vi phải được đặt.
scope chỉ có thể là một trong các trạng thái sau:
|
|
range
|
Dải ô cần tìm/thay thế. |
sheetId
|
Trang tính cần tìm/thay thế. |
allSheets
|
True để tìm/thay thế trên tất cả các trang tính. |
InsertDimensionRequest
Chèn hàng hoặc cột trong trang tính tại một chỉ mục cụ thể.
Biểu diễn dưới dạng JSON |
---|
{
"range": {
object (
|
Trường | |
---|---|
range
|
Các 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ị giới hạn. |
inheritFromBefore
|
Liệu bạn nên mở rộng thuộc tính phương diện trước hay sau phương diện mới được thêm. "True" để kế thừa từ các phương diện trước đó (trong trường hợp đó, 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 vào chỉ mục 1 có thể kế thừa nền màu xanh lục hoặc màu đỏ. Nếu |
InsertRangeRequest
Chèn các ô vào một dải ô, dịch chuyển các ô hiện có qua lại hoặc xuống dưới.
Biểu diễn dưới dạng JSON |
---|
{ "range": { object ( |
Trường | |
---|---|
range
|
Dải ô để chèn các ô mới vào. |
shiftDimension
|
Kích thước sẽ được dịch chuyển khi chèn ô. Nếu
|
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 (
|
Trường | |
---|---|
source
|
Các phương diện nguồn cần di chuyển. |
destinationIndex
|
Chỉ mục bắt đầu dựa trên 0 cho biết nơi di chuyển dữ liệu nguồn đến, dựa trên toạ độ trước khi dữ liệu nguồn bị xoá khỏi lưới. Dữ liệu hiện có sẽ được dịch chuyển xuống hoặc sang phải (tuỳ thuộc vào phương diện) để có không gian cho các phương diện đã di chuyển. Các phương diện nguồn bị xoá khỏi lưới, do đó, dữ liệu có thể được đưa vào một chỉ mục khác với chỉ mục được chỉ định.
Ví dụ: với |
UpdateEmbeddedObjectPositionRequest
Cập nhật vị trí của đối tượng được nhúng (chẳng hạn như di chuyển hoặc đổi kích thước biểu đồ/hình ảnh).
Biểu diễn dưới dạng JSON |
---|
{
"objectId": integer,
"newPosition": {
object (
|
Trường | |
---|---|
objectId
|
Mã của đối tượng cần di chuyển. |
newPosition
|
Một vị trí rõ ràng để di chuyển đối tượng được nhúng đến. Nếu bạn đặt |
fields
|
Các trường của |
PasteDataRequest
Chèn dữ liệu vào bảng tính bắt đầu tại toạ độ được chỉ định.
Biểu diễn dưới dạng JSON |
---|
{ "coordinate": { object ( |
Trường | |
---|---|
coordinate
|
Toạ độ mà tại đó dữ liệu sẽ bắt đầu được chèn. |
data
|
Dữ liệu cần chèn. |
type
|
Cách dán dữ liệu. |
Trường 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
|
Dấu phân cách trong dữ liệu. |
html
|
Đúng nếu dữ liệu là HTML. |
TextToColumnsRequest
Tách một cột văn bản thành nhiều cột, dựa trên dấu phân cách trong mỗi ô.
Biểu diễn dưới dạng JSON |
---|
{ "source": { object ( |
Trường | |
---|---|
source
|
Dải ô dữ liệu nguồn. Phạm vi này phải bao gồm đúng một cột. |
delimiter
|
Dấu phân cách cần sử dụng. Chỉ được dùng nếu Giá phân cách là |
delimiterType
|
Loại dấu phân cách cần sử dụng. |
DelimiterType
Dấu phân cách cần 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 (
|
Trường | |
---|---|
filter
|
Thuộc tính mới của chế độ xem bộ lọc. |
fields
|
Các trường cần được cập nhật. Bạn phải chỉ định ít nhất một trường. |
DeleteRangeRequest
Xoá một dải ô, chuyển các ô khác vào vùng đã xoá.
Biểu diễn dưới dạng JSON |
---|
{ "range": { object ( |
Trường | |
---|---|
range
|
Dải ô cần xoá. |
shiftDimension
|
Phương diện mà từ đó các ô đã xoá sẽ được thay thế. Nếu
|
AppendDimensionRequest
Thêm hàng hoặc cột vào cuối trang tính.
Biểu diễn dưới dạng JSON |
---|
{
"sheetId": integer,
"dimension": enum (
|
Trường | |
---|---|
sheetId
|
Trang tính cần thêm hàng hoặc cột. |
dimension
|
Xem cần thêm hàng hay cột hay không. |
length
|
Số hàng hoặc cột cần nối. |
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ả chỉ mục của các quy tắc tiếp theo sẽ được tăng lên.
Biểu diễn dưới dạng JSON |
---|
{
"rule": {
object (
|
Trường | |
---|---|
rule
|
Quy tắc cần thêm. |
index
|
Chỉ mục dựa trên 0 mà tại đó quy tắc sẽ được chèn. |
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 |
Trường | |
---|---|
index
|
Chỉ mục dựa trên 0 của quy tắc cần được thay thế hoặc di chuyển. |
sheetId
|
Trang tính quy tắc cần di chuyển. Đây là trường bắt buộc nếu bạn đặt |
Trường hợp instruction . Loại cập nhật nên được tiến hành.
instruction chỉ có thể là một trong các trạng thái sau:
|
|
rule
|
Quy tắc sẽ thay thế quy tắc tại chỉ mục đã cho. |
newIndex
|
Chỉ mục mới dựa trên 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ả chỉ mục của quy tắc tiếp theo đều bị giảm dần.
Biểu diễn dưới dạng JSON |
---|
{ "index": integer, "sheetId": integer } |
Trường | |
---|---|
index
|
Chỉ mục dựa trên 0 của quy tắc sẽ bị xoá. |
sheetId
|
Trang tính chứa quy tắc đang bị xoá. |
SortRangeRequest
Sắp xếp dữ liệu thành 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 ( |
Trường | |
---|---|
range
|
Dải ô cần sắp xếp. |
sortSpecs[]
|
Thứ tự sắp xếp trên mỗi cột. Thông số kỹ thuật sau này được sử dụng khi các giá trị bằng nhau trong 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 ô. Để xoá phương thức xác thực trong một dải ô, hãy gọi lệnh này mà không chỉ định quy tắc nào.
Biểu diễn dưới dạng JSON |
---|
{ "range": { object ( |
Trường | |
---|---|
range
|
Phạm vi mà quy tắc xác thực dữ liệu sẽ áp dụng. |
rule
|
Quy tắc xác thực dữ liệu cần đặt cho mỗi ô trong dải ô hoặc để trống để xoá quy tắc 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 (
|
Trường | |
---|---|
filter
|
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 (
|
Trường | |
---|---|
protectedRange
|
Dải ô được bảo vệ cần được thêm vào. Trường |
UpdateProtectedRangeRequest
Cập nhật một dải ô được bảo vệ hiện có bằng protectedRangeId
được chỉ định.
Biểu diễn dưới dạng JSON |
---|
{
"protectedRange": {
object (
|
Trường | |
---|---|
protectedRange
|
Dải ô được bảo vệ để cập nhật các thuộc tính mới. |
fields
|
Các trường cần được cập nhật. Bạn phải chỉ định ít nhất một trường. |
DeleteProtectedRangeRequest
Xoá dải ô được bảo vệ có mã nhận dạng đã cho.
Biểu diễn dưới dạng JSON |
---|
{ "protectedRangeId": integer } |
Trường | |
---|---|
protectedRangeId
|
Mã của dải ô được bảo vệ cần xoá. |
AutoResizeDimensionsRequest
Tự động đổi kích thước một hoặc nhiều phương diện dựa vào nội dung của các ô trong phương diện đó.
Biểu diễn dưới dạng JSON |
---|
{ // Union field |
Trường | |
---|---|
Trường 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
|
Các phương diện tự động đổi kích thước. |
dataSourceSheetDimensions
|
Các phương diện trên trang tính nguồn dữ liệu để tự động đổi kích thước. |
AddChartRequest
Thêm biểu đồ vào một trang tính trong bảng tính.
Biểu diễn dưới dạng JSON |
---|
{
"chart": {
object (
|
Trường | |
---|---|
chart
|
Biểu đồ cần được thêm vào bảng tính, bao gồm cả vị trí mà biểu đồ sẽ được đặt. Trường |
UpdateChartSpecRequest
Cập nhật quy cách 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 (
|
Trường | |
---|---|
chartId
|
Mã của biểu đồ cần cập nhật. |
spec
|
Thông số kỹ thuật để áp dụng cho biểu đồ. |
UpdateBandingRequest
Cập nhật các thuộc tính của dải ô đã cung cấp.
Biểu diễn dưới dạng JSON |
---|
{
"bandedRange": {
object (
|
Trường | |
---|---|
bandedRange
|
Dải ô theo dải để cập nhật các thuộc tính mới. |
fields
|
Các trường cần được cập nhật. Bạn phải chỉ định ít nhất một trường. |
AddBandingRequest
Thêm một dải ô mới vào bảng tính.
Biểu diễn dưới dạng JSON |
---|
{
"bandedRange": {
object (
|
Trường | |
---|---|
bandedRange
|
Dải ô theo dải cần thêm. Trường |
DeleteBandingRequest
Xoá dải ô có mã nhận dạng cho trước khỏi bảng tính.
Biểu diễn dưới dạng JSON |
---|
{ "bandedRangeId": integer } |
Trường | |
---|---|
bandedRangeId
|
Mã của dải ô có 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 (
|
Trường | |
---|---|
developerMetadata
|
Siêu dữ liệu về nhà phát triể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 dành cho nhà phát triển mà bộ lọc chọn thành các giá trị được cung cấp trong tài nguyên DeveloperMetadata
. Phương thức gọi phải chỉ định các thuộc tính mà họ muốn cập nhật trong thông số trường, cũng như chỉ định ít nhất một DataFilter
khớp với siêu dữ liệu mà họ muốn cập nhật.
Biểu diễn dưới dạng JSON |
---|
{ "dataFilters": [ { object ( |
Trường | |
---|---|
dataFilters[]
|
Các bộ lọc khớp với các mục siêu dữ liệu của nhà phát triển cần cập nhật. |
developerMetadata
|
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
|
Các trường cần được cập nhật. Bạn phải chỉ định ít nhất một trường. |
DeleteDeveloperMetadataRequest
Yêu cầu xoá siêu dữ liệu của nhà phát triển.
Biểu diễn dưới dạng JSON |
---|
{
"dataFilter": {
object (
|
Trường | |
---|---|
dataFilter
|
Bộ lọc dữ liệu mô tả tiêu chí dùng để chọn mục nhập siêu dữ liệu dành cho nhà phát triển cần xoá. |
RandomizeRangeRequest
Sắp xếp ngẫu nhiên thứ tự các hàng trong dải ô.
Biểu diễn dưới dạng JSON |
---|
{
"range": {
object (
|
Trường | |
---|---|
range
|
Dải ô cần sắp xếp ngẫu nhiên. |
AddDimensionGroupRequest
Tạo một nhóm trên dải ô được chỉ định.
Nếu dải ô được yêu cầu là tập mẹ của dải ô của một nhóm G hiện có, thì độ sâu của G sẽ tăng lên và nhóm G mới này sẽ có chiều sâu của nhóm đó. Ví dụ: nhóm [C:D, độ sâu 1] + [B:E] sẽ tạo thành các nhóm [B:E, độ sâu 1] và [C:D, độ sâu 2]. Nếu phạm vi 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 mới G' trở thành một lớn hơn độ sâu của G. Ví dụ: nhóm [B:E, độ sâu 1] + [C:D] sẽ tạo thành các nhóm [B:E, độ sâu 1] và [C:D, độ sâu 2]. Nếu phạm vi yêu cầu bắt đầu trước và kết thúc trong, hoặc bắt đầu trong và kết thúc sau phạm vi của một nhóm 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ủa các dải ô và nhóm mới G' có độ sâu lớn hơn độ sâu của G và phạm vi là giao điểm của các dải ô. Ví dụ: nhóm [B:D, độ sâu 1] + [C:E] sẽ tạo thành các nhóm [B:E, độ sâu 1] và [C:D, độ sâu 2].
Biểu diễn dưới dạng JSON |
---|
{
"range": {
object (
|
Trường | |
---|---|
range
|
Dải ô để tạo một nhóm. |
DeleteDimensionGroupRequest
Xóa một nhóm trên dải ô được chỉ định bằng cách giảm độ sâu của phương diện trong dải ô.
Ví dụ: giả sử trang tính có một nhóm độ sâu 1 trên B:E và một nhóm độ sâu 2 trên C:D. Nếu bạn xoá một nhóm nằm trên D:E, trang tính sẽ có một nhóm chiều sâu 1 nằm trên B:D và một nhóm độ sâu 2 nằm trên C:C.
Biểu diễn dưới dạng JSON |
---|
{
"range": {
object (
|
Trường | |
---|---|
range
|
Dải ô của nhóm cần xoá. |
UpdateDimensionGroupRequest
Cập nhật trạng thái của nhóm đã chỉ định.
Biểu diễn dưới dạng JSON |
---|
{
"dimensionGroup": {
object (
|
Trường | |
---|---|
dimensionGroup
|
Nhóm có trạng thái cần được cập nhật. Phạm vi và độ sâu của nhóm phải chỉ định một nhóm hợp lệ trên trang tính và tất cả các trường khác đều được cập nhật. |
fields
|
Các trường cần được cập nhật. Bạn phải chỉ định ít nhất một 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) trong mỗi ô trong dải ô được chỉ định. Yêu cầu này sẽ xoá tất cả khoảng trắng ở đầu và cuối văn bản của mỗi ô, đồng thời giảm mọi phần tiếp theo của các ký tự khoảng trắng còn lại thành một khoảng trắng. Nếu văn bản được cắt bớt bắt đầu bằng ký tự '+' hoặc '=' thì văn bản vẫn là một giá trị chuỗi và không được hiểu là công thức.
Biểu diễn dưới dạng JSON |
---|
{
"range": {
object (
|
Trường | |
---|---|
range
|
Dải ô có các ô cần cắt bỏ. |
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 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 khác kiểu chữ, định dạng hoặc công thức thì được coi là trùng lặp.
Yêu cầu này cũng xoá các hàng trùng lặp bị ẩn khỏi chế độ xem (ví dụ: do bộ lọc). Khi xoá bản sao, bản sao đầu tiên của mỗi lần quét hàng trùng lặp từ trên xuống sẽ được giữ lại trong dải ô thu được. 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 liền kề nhau trong dải ô.
Biểu diễn dưới dạng JSON |
---|
{ "range": { object ( |
Trường | |
---|---|
range
|
Dải ô cần xoá các hàng trùng lặp. |
comparisonColumns[]
|
Các cột trong dải ô cần phân tích để tìm các 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 nội dung trùng lặp. |
UpdateEmbeddedObjectBorderRequest
Cập nhật thuộc tính đường viền của đối tượng được nhúng.
Biểu diễn dưới dạng JSON |
---|
{
"objectId": integer,
"border": {
object (
|
Trường | |
---|---|
objectId
|
Mã của đối tượng được nhúng cần cập nhật. |
border
|
Đường viền áp dụng cho đối tượng được nhúng. |
fields
|
Các trường cần được cập nhật. Bạn phải chỉ định ít nhất một 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 (
|
Trường | |
---|---|
slicer
|
Bộ cắt cần được thêm vào bảng tính, bao gồm cả vị trí cần đặt bộ cắt. Trường |
UpdateSlicerSpecRequest
Cập nhật thông số kỹ thuật của một 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 (
|
Trường | |
---|---|
slicerId
|
Mã của bộ cắt cần cập nhật. |
spec
|
Thông số kỹ thuật áp dụng cho bộ cắt. |
fields
|
Các trường cần được cập nhật. Bạn phải chỉ định ít nhất một trường. |
AddDataSourceRequest
Thêm một nguồn dữ liệu. Sau khi thêm thành công nguồn dữ liệu, một trang tính DATA_SOURCE
liên kết sẽ được tạo và một lượt thực thi đượ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 cần có thêm một phạm vi OAuth bigquery.readonly
.
Biểu diễn dưới dạng JSON |
---|
{
"dataSource": {
object (
|
Trường | |
---|---|
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 trang tính DATA_SOURCE
được liên kết để đọc dữ liệu từ nguồn dữ liệu đã cập nhật. Yêu cầu này cần có thêm một phạm vi OAuth bigquery.readonly
.
Biểu diễn dưới dạng JSON |
---|
{
"dataSource": {
object (
|
Trường | |
---|---|
dataSource
|
Nguồn dữ liệu cần cập nhật. |
fields
|
Các trường cần được cập nhật. Bạn phải chỉ định ít nhất một trường. |
DeleteDataSourceRequest
Xoá một nguồn dữ liệu. Yêu cầu này cũng sẽ xoá trang tính nguồn dữ liệu được liên kết và huỷ liên kết tất cả đối tượng nguồn dữ liệu được liên kết.
Biểu diễn dưới dạng JSON |
---|
{ "dataSourceId": string } |
Trường | |
---|---|
dataSourceId
|
Mã của nguồn dữ liệu cần xoá. |
RefreshDataSourceRequest
Làm mới một hoặc nhiều đối tượng nguồn dữ liệu trong bảng tính theo các tham chiếu đã chỉ định. Yêu cầu này cần có thêm một phạm vi OAuth bigquery.readonly
.
Nếu có nhiều yêu cầu làm mới tham chiếu đến cùng đối tượng nguồn dữ liệu trong một lô, thì chỉ yêu cầu làm mới gần đây nhất được xử lý và tất cả các yêu cầu đó sẽ có cùng một phản hồi tương ứng.
Biểu diễn dưới dạng JSON |
---|
{ "force": boolean, // Union field |
Trường | |
---|---|
force
|
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 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
|
Tham chiếu đến các đối tượng nguồn dữ liệu cần làm mới. |
dataSourceId
|
Tham chiếu đến một |
isAll
|
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 (
|
Trường | |
---|---|
references[]
|
Tệp đối chiếu. |
DataSourceObjectReference
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 |
Trường | |
---|---|
Trường hợp value . Loại tệp đối chiếu.
value chỉ có thể là một trong các trạng thái sau:
|
|
sheetId
|
Tệp tham chiếu đến trang tính |
chartId
|
Mã tham chiếu đến một biểu đồ nguồn dữ liệu. |
dataSourceTableAnchorCell
|
Tham chiếu đến một |
dataSourcePivotTableAnchorCell
|
Các tham chiếu đến một nguồn dữ liệu |
dataSourceFormulaCell
|
Tham chiếu đến một ô có chứa |
CancelDataSourceRefreshRequest
Huỷ một hoặc nhiều lần làm mới đối tượng nguồn dữ liệu trong bảng tính theo các tệp tham chiếu đã chỉ định.
Biểu diễn dưới dạng JSON |
---|
{ // Union field |
Trường | |
---|---|
Trường hợp target . Chỉ định nội dung cần huỷ.
target chỉ có thể là một trong các trạng thái sau:
|
|
references
|
Mã tham chiếu đến các đối tượng nguồn dữ liệu có các hoạt động làm mới sẽ bị huỷ. |
dataSourceId
|
Tham chiếu đến một |
isAll
|
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. |