- Tài nguyên: Bảng tính
- Thuộc tính bảng tính
- Khoảng thời gian tính toán lại
- Định dạng ô
- NumberFormat
- NumberFormatType (Số định dạng)
- Màu
- ColorStyle
- ThemeColorType
- Đường viền
- Đường viền
- Kiểu
- Khoảng đệm
- HorizontalCăn
- VerticalAlign
- WrapStrategy
- TextDirection (Hướng văn bản)
- Định dạng văn bản
- Đường liên kết
- Siêu liên kết hiển thị
- Xoay vòng văn bản
- Cài đặt tính toán lặp lại
- Giao diện bảng tính
- ThemeColorPair (Cặp màu giao diện)
- Trang tính
- Tài sản Trang tính
- Loại trang tính
- Thuộc tính lưới
- DataSourceSheetProperties
- DataSourceColumn
- DataSourceColumnReference
- Trạng thái thực thi dữ liệu
- Trạng thái thực thi dữ liệu
- Mã thực thi dữ liệu thực thi
- GridData
- RowData
- Dữ liệu di động
- Giá trị mở rộng
- Giá trị lỗi
- Loại lỗi
- TextFormatRun
- DataValidationRule
- BooleanĐiều kiện
- Điều kiện loại
- Điều kiện
- Ngày tương đối
- Bảng tổng hợp
- GridRange
- PivotGroup
- PivotGroupValueMetadata
- Thứ tự sắp xếp
- PivotGroup SortValue nhóm
- PivotGroupRule
- ManualRule
- ManualRuleGroup
- HistogramRule
- DateTimeRule
- DateTimeRuleType
- PivotGroupLimit
- PivotFiltercriteria
- PivotFilterSpec
- Tổng giá trị
- PivotValueSummaryFunction
- PivotValueCalculatedDisplayType
- PivotValueLayout
- DataSourceTable
- DataSourceTableColumnSelectionType
- FilterSpec
- Bộ tiêu chí lọc
- SortSpec
- Công cụ DataSource
- DimensionProperties
- ConditionFormatRule
- BooleanRule
- GradientRule
- InterpolationPoint
- InterpolationPointType (Loại nội suy)
- FilterView
- ProtectedRange
- Người chỉnh sửa
- Bộ lọc cơ bản
- Biểu đồ được nhúng
- ChartSpec
- TextPosition
- DataSourceChartProperties
- BasicChartSpec
- Loại biểu đồ cơ bản
- BasicChartLegendPosition
- BasicChartAxis
- BasicChartAxisPosition
- ChartAxisViewWindowOptions
- ViewWindowMode
- BasicChartDomain
- Biểu đồ dữ liệu
- ChartSourceRange
- ChartGroupRule
- ChartDateTimeRule
- ChartDateTimeRuleType
- ChartHistogramRule
- ChartAggregateType
- BasicChartSeries
- StyleStyle
- LineDashType
- Nhãn dữ liệu
- DataLabelType
- DataLabelLocation
- PointStyle
- PointShape
- BasicSeriesDataPointStyleOverride
- BasicChartStackedType
- BasicChartCompareMode
- PieChartSpec
- PieChartLegendPosition
- BubbleChartSpec
- BubbleChartLegendPosition
- CandlestickChartSpec
- CandlestickDomain
- Dữ liệu nến
- CandlestickSeries
- OrgChartSpec
- OrgChartNodeSize
- HistogramChartSpec
- HistogramSeries
- HistogramChartLegendPosition
- WaterfallChartSpec
- WaterfallChartDomain
- WaterfallChartSeries
- WaterfallChartColumnStyle
- WaterfallChartCustomSubtotal
- WaterfallChartStackedType
- TreemapChartSpec
- TreemapChartColorScale
- ThẻChartChartSpec
- KeyValueFormat
- BaselineValueFormat
- Loại so sánh
- ChartNumberFormatSource
- ChartCustomNumberFormatOptions
- ChartHiddenDimensionStrategy
- EmbeddedObjectPosition (Đối tượng được nhúng)
- OverlayPosition
- Grid Tọa độ
- EmbeddedObjectBorder
- BandedRange
- BandingProperties
- Nhóm thứ nguyên
- Bộ cắt
- SlicerSpec
- NamedRange
- Nguồn dữ liệu
- DataSourceSpec
- BigQueryDataSourceSpec
- BigQueryQuerySpec
- BigQueryTableSpec
- DataSourceParameter
- DataSourceRefreshSchedule
- DataSourceRefreshScope
- DataSourceRefreshDailySchedule
- Thời gian trong ngày
- DataSourceRefreshWeekSchedule
- Ngày trong tuần
- DataSourceRefreshMonthlySchedule
- Khoảng thời gian
- Phương thức
Tài nguyên: Bảng tính
Tài nguyên đại diện cho một bảng tính.
Biểu diễn dưới dạng JSON |
---|
{ "spreadsheetId": string, "properties": { object ( |
Các trường | |
---|---|
spreadsheetId |
Mã nhận dạng của bảng tính. Đây là trường chỉ đọc. |
properties |
Thuộc tính tổng thể của bảng tính. |
sheets[] |
Các trang tính là một phần của bảng tính. |
namedRanges[] |
Dải ô được đặt tên được xác định trong bảng tính. |
spreadsheetUrl |
Url của bảng tính. Đây là trường chỉ đọc. |
developerMetadata[] |
Siêu dữ liệu nhà phát triển liên kết với bảng tính. |
dataSources[] |
Danh sách các nguồn dữ liệu bên ngoài được kết nối với bảng tính. |
dataSourceSchedules[] |
Chỉ đầu ra. Danh sách lịch làm mới nguồn dữ liệu. |
Thuộc tính bảng tính
Thuộc tính của bảng tính.
Biểu diễn dưới dạng JSON |
---|
{ "title": string, "locale": string, "autoRecalc": enum ( |
Các trường | |
---|---|
title |
Tiêu đề bảng tính. |
locale |
Ngôn ngữ của bảng tính ở một trong các định dạng sau:
Lưu ý: Khi cập nhật trường này, không phải tất cả các ngôn ngữ/ngôn ngữ đều được hỗ trợ. |
autoRecalc |
Khoảng thời gian chờ trước khi các hàm biến động được tính toán lại. |
timeZone |
Múi giờ của bảng tính, ở định dạng CLDR, chẳng hạn như |
defaultFormat |
Định dạng mặc định của tất cả các ô trong bảng tính. |
iterativeCalculationSettings |
Xác định xem liệu các tham chiếu vòng có được phân giải hay không và cách giải quyết bằng tính toán lặp. Thiếu trường này có nghĩa là các tham chiếu vòng tròn dẫn đến lỗi tính toán. |
spreadsheetTheme |
Đã áp dụng chủ đề cho bảng tính. |
Khoảng thời gian tính toán lại
Bảng liệt kê các tuỳ chọn có thể tính toán lại khoảng thời gian.
Enum | |
---|---|
RECALCULATION_INTERVAL_UNSPECIFIED |
Giá trị mặc định. Không được sử dụng giá trị này. |
ON_CHANGE |
Các hàm biến động được cập nhật sau mỗi lần thay đổi. |
MINUTE |
Các hàm biến động được cập nhật theo mỗi thay đổi và mỗi phút. |
HOUR |
Hàm biến động được cập nhật theo từng giờ và mỗi thay đổi. |
Cài đặt tính toán lặp lại
Các chế độ cài đặt để kiểm soát cách phân giải các phần phụ thuộc vòng có tính toán lặp lại.
Biểu diễn dưới dạng JSON |
---|
{ "maxIterations": integer, "convergenceThreshold": number } |
Các trường | |
---|---|
maxIterations |
Khi tính toán lặp lại được bật, số vòng tính toán tối đa cần thực hiện. |
convergenceThreshold |
Khi tính toán lặp lại được bật và các kết quả liên tiếp khác nhau nhỏ hơn giá trị ngưỡng này, các vòng tính toán sẽ dừng lại. |
Chủ đề bảng tính
Đại diện cho chủ đề bảng tính
Biểu diễn dưới dạng JSON |
---|
{
"primaryFontFamily": string,
"themeColors": [
{
object ( |
Các trường | |
---|---|
primaryFontFamily |
Tên của họ phông chữ chính. |
themeColors[] |
Cặp màu giao diện bảng tính. Để cập nhật, bạn phải cung cấp tất cả các cặp màu giao diện. |
Cặp màu giao diện
Một cặp ánh xạ loại màu giao diện bảng tính với màu cụ thể mà bảng tính đại diện.
Biểu diễn dưới dạng JSON |
---|
{ "colorType": enum ( |
Các trường | |
---|---|
colorType |
Loại màu chủ đề bảng tính. |
color |
Màu cụ thể tương ứng với loại màu giao diện. |
Dải ô được đặt tên
Dải ô được đặt tên.
Biểu diễn dưới dạng JSON |
---|
{
"namedRangeId": string,
"name": string,
"range": {
object ( |
Các trường | |
---|---|
namedRangeId |
Mã của dải ô được đặt tên. |
name |
Tên của dải ô được đặt tên. |
range |
Dải ô này đại diện cho. |
Nguồn dữ liệu
Thông tin về một nguồn dữ liệu bên ngoài trong bảng tính.
Biểu diễn dưới dạng JSON |
---|
{ "dataSourceId": string, "spec": { object ( |
Các trường | |
---|---|
dataSourceId |
Mã nhận dạng duy nhất trong phạm vi bảng tính xác định nguồn dữ liệu. Ví dụ: 1080547365. |
spec |
|
calculatedColumns[] |
Tất cả các cột đã tính trong nguồn dữ liệu. |
sheetId |
Mã nhận dạng của Khi tạo nguồn dữ liệu, trang tính |
DataSourceSpec
Thao tác này sẽ chỉ định thông tin chi tiết về nguồn dữ liệu. Ví dụ: đối với BigQuery, thông tin này chỉ định thông tin về nguồn BigQuery.
Biểu diễn dưới dạng JSON |
---|
{ "parameters": [ { object ( |
Các trường | |
---|---|
parameters[] |
Các thông số của nguồn dữ liệu, được sử dụng khi truy vấn nguồn dữ liệu. |
Trường nhóm spec . Thông số kỹ thuật thực tế cho mỗi loại nguồn dữ liệu. spec chỉ có thể là một trong những loại sau đây: |
|
bigQuery |
|
BigQueryDataSourceSpec
Thông số kỹ thuật của nguồn dữ liệu BigQuery được kết nối với một trang tính.
Biểu diễn dưới dạng JSON |
---|
{ "projectId": string, // Union field |
Các trường | |
---|---|
projectId |
Mã của dự án BigQuery hỗ trợ Google Cloud trong tài khoản thanh toán. Đối với mọi truy vấn được thực thi đối với nguồn dữ liệu, dự án sẽ bị tính phí. |
Trường nhóm spec . Thông số kỹ thuật thực tế. spec chỉ có thể là một trong những loại sau đây: |
|
querySpec |
|
tableSpec |
|
BigQueryQuerySpec
Chỉ định truy vấn BigQuery tùy chỉnh.
Biểu diễn dưới dạng JSON |
---|
{ "rawQuery": string } |
Các trường | |
---|---|
rawQuery |
Chuỗi truy vấn thô. |
BigQueryTableSpec
Chỉ định định nghĩa bảng BigQuery. Chỉ cho phép bảng gốc.
Biểu diễn dưới dạng JSON |
---|
{ "tableProjectId": string, "tableId": string, "datasetId": string } |
Các trường | |
---|---|
tableProjectId |
Mã của dự án BigQuery chứa bảng. Nếu bạn không chỉ định thì |
tableId |
Mã bảng BigQuery. |
datasetId |
Mã tập dữ liệu BigQuery. |
Thông số nguồn dữ liệu
Một tham số trong truy vấn của nguồn dữ liệu. Thông số này cho phép người dùng chuyển các giá trị từ bảng tính vào một truy vấn.
Biểu diễn dưới dạng JSON |
---|
{ // Union field |
Các trường | |
---|---|
Trường nhóm identifier . Giá trị nhận dạng thông số. identifier chỉ có thể là một trong những loại sau đây: |
|
name |
Tham số được đặt tên. Phải là giá trị nhận dạng hợp lệ cho |
Trường nhóm value . Giá trị tham số. value chỉ có thể là một trong những loại sau đây: |
|
namedRangeId |
Mã nhận dạng của |
range |
Dải ô chứa giá trị của thông số. Kích thước của tệp phải là 1x1. |
Lịch làm mới dữ liệu
Lên lịch làm mới nguồn dữ liệu.
Các nguồn dữ liệu trong bảng tính được làm mới trong một khoảng thời gian. Bạn có thể chỉ định thời gian bắt đầu bằng cách nhấp vào nút Làm mới theo lịch trong trình chỉnh sửa Trang tính, nhưng khoảng thời gian này cố định là 4 giờ. Ví dụ: nếu bạn chỉ định thời gian bắt đầu là 8 giờ sáng thì quá trình làm mới sẽ diễn ra từ 8 giờ sáng đến 12 giờ đêm mỗi ngày.
Biểu diễn dưới dạng JSON |
---|
{ "enabled": boolean, "refreshScope": enum ( |
Các trường | |
---|---|
enabled |
Đúng nếu lịch làm mới được bật hoặc false nếu ngược lại. |
refreshScope |
Phạm vi làm mới. Phải là |
nextRun |
Chỉ đầu ra. Khoảng thời gian chạy vào lần tiếp theo. |
Trường nhóm schedule_config . Cấu hình lịch biểu schedule_config chỉ có thể là một trong các chế độ sau: |
|
dailySchedule |
Lịch làm mới hàng ngày. |
weeklySchedule |
Lịch làm mới hàng tuần. |
monthlySchedule |
Lịch làm mới hàng tháng. |
Làm mới nguồn dữ liệu
Phạm vi làm mới nguồn dữ liệu.
Enum | |
---|---|
DATA_SOURCE_REFRESH_SCOPE_UNSPECIFIED |
Giá trị mặc định, không sử dụng. |
ALL_DATA_SOURCES |
Làm mới tất cả nguồn dữ liệu và đối tượng nguồn dữ liệu liên kết trong bảng tính. |
Làm mới nguồn dữ liệu hàng ngày
Lịch biểu làm mới dữ liệu hằng ngày trong một khoảng thời gian nhất định.
Biểu diễn dưới dạng JSON |
---|
{
"startTime": {
object ( |
Các trường | |
---|---|
startTime |
Thời gian bắt đầu của khoảng thời gian mà lịch làm mới nguồn dữ liệu được lên lịch. Chỉ sử dụng |
Giờ trong ngày
Thể hiện thời gian trong ngày. Ngày và múi giờ không quan trọng hoặc được chỉ định ở nơi khác. Một API có thể chọn cho phép giây nhuận. Các loại liên quan là google.type.Date
và google.protobuf.Timestamp
.
Biểu diễn dưới dạng JSON |
---|
{ "hours": integer, "minutes": integer, "seconds": integer, "nanos": integer } |
Các trường | |
---|---|
hours |
Giờ trong ngày ở định dạng 24 giờ. Nên từ 0 đến 23. API có thể chọn cho phép giá trị "24:00:00" trong các trường hợp như thời gian đóng cửa của doanh nghiệp. |
minutes |
Số phút trong ngày. Phải từ 0 đến 59. |
seconds |
Giây phút. Thường phải từ 0 đến 59. API có thể cho phép giá trị 60 nếu API cho phép leap-seconds. |
nanos |
Phân số giây tính bằng nano giây. Phải từ 0 đến 999.999.999. |
Lịch biểu làm mới nguồn dữ liệu hàng tuần
Lịch biểu dữ liệu hàng tuần để làm mới các ngày cụ thể trong một khoảng thời gian nhất định.
Biểu diễn dưới dạng JSON |
---|
{ "startTime": { object ( |
Các trường | |
---|---|
startTime |
Thời gian bắt đầu của khoảng thời gian mà lịch làm mới nguồn dữ liệu được lên lịch. Chỉ sử dụng |
daysOfWeek[] |
Ngày trong tuần để làm mới. Phải chỉ định ít nhất một ngày. |
Ngày trong tuần
Thể hiện một ngày trong tuần.
Enum | |
---|---|
DAY_OF_WEEK_UNSPECIFIED |
Chưa xác định ngày trong tuần. |
MONDAY |
Thứ Hai |
TUESDAY |
Thứ Ba |
WEDNESDAY |
Thứ Tư |
THURSDAY |
Thursday (thứ Năm) |
FRIDAY |
Thứ Sáu |
SATURDAY |
Saturday (thứ Bảy) |
SUNDAY |
Chủ Nhật |
Lịch biểu làm mới nguồn dữ liệu hàng tháng
Lịch biểu dữ liệu hằng tháng để làm mới các ngày cụ thể trong tháng trong một khoảng thời gian nhất định.
Biểu diễn dưới dạng JSON |
---|
{
"startTime": {
object ( |
Các trường | |
---|---|
startTime |
Thời gian bắt đầu của khoảng thời gian mà lịch làm mới nguồn dữ liệu được lên lịch. Chỉ sử dụng |
daysOfMonth[] |
Ngày trong tháng để làm mới. Chỉ hỗ trợ 1-28, ánh xạ đến ngày 1 đến ngày 28. Phải chỉ định ít nhất một ngày. |
Khoảng thời gian
Biểu thị một khoảng thời gian, được mã hóa dưới dạng thời điểm bắt đầu Dấu thời gian (bao gồm) và thời điểm kết thúc Dấu thời gian (không bao gồm).
Điểm bắt đầu phải nhỏ hơn hoặc bằng kết thúc. Khi điểm bắt đầu bằng điểm cuối, khoảng thời gian trống (không có thời gian). Khi cả điểm bắt đầu và điểm kết thúc đều không được chỉ định, khoảng thời gian sẽ khớp bất kỳ lúc nào.
Biểu diễn dưới dạng JSON |
---|
{ "startTime": string, "endTime": string } |
Các trường | |
---|---|
startTime |
Không bắt buộc. Bắt đầu bao gồm khoảng thời gian. Nếu được chỉ định, Dấu thời gian khớp với khoảng thời gian này sẽ phải giống nhau hoặc sau thời điểm bắt đầu. |
endTime |
Không bắt buộc. Kết thúc độc quyền của khoảng thời gian. Nếu được chỉ định, Dấu thời gian phù hợp với khoảng thời gian này sẽ phải trước thời gian kết thúc. |
Phương thức |
|
---|---|
|
Áp dụng một hoặc nhiều nội dung cập nhật cho bảng tính. |
|
Tạo bảng tính, trả về bảng tính mới được tạo. |
|
Trả về bảng tính ở mã nhận dạng đã cho. |
|
Trả về bảng tính ở mã nhận dạng đã cho. |