- Tài nguyên: Bảng tính
- SpreadsheetProperties (Thuộc tính bảng tính)
- RecalculationInterval
- CellFormat
- NumberFormat (Định dạng số)
- NumberFormatType
- Màu
- ColorStyle
- ThemeColorType
- Đường viền
- Đường viền
- Kiểu
- Khoảng đệm
- HorizontalAlign
- VerticalAlign
- WrapStrategy
- TextDirection
- TextFormat (Định dạng văn bản)
- Đường liên kết
- HyperlinkDisplayType
- TextRotation (Xoay trong văn bản)
- IterativeCalculationSettings
- SpreadsheetTheme (Giao diện bảng tính)
- ThemeColorPair
- Trang tính
- SheetProperties
- SheetType
- GridProperties
- DataSourceSheetProperties
- DataSourceColumn
- DataSourceColumnReference
- DataExecutionStatus
- DataExecutionState
- DataExecutionErrorCode
- GridData
- RowData
- CellData
- ExtendedValue
- ErrorValue
- ErrorType
- TextFormatRun
- DataValidationRule
- BooleanCondition
- ConditionType
- ConditionValue
- RelativeDate
- PivotTable
- GridRange
- PivotGroup
- PivotGroupValueMetadata
- SortOrder
- PivotGroupSortValueBucket
- PivotGroupRule
- ManualRule
- ManualRuleGroup
- HistogramRule
- DateTimeRule
- DateTimeRuleType
- PivotGroupLimit
- PivotFilterCriteria
- PivotFilterSpec
- PivotValue
- PivotValueSummarizeFunction
- PivotValueCalculatedDisplayType
- PivotValueLayout
- DataSourceTable
- DataSourceTableColumnSelectionType
- FilterSpec
- FilterCriteria
- SortSpec (Sắp xếp thông số kỹ thuật)
- DataSourceFormula
- DimensionProperties
- ConditionalFormatRule
- BooleanRule
- GradientRule
- InterpolationPoint
- InterpolationPointType
- FilterView
- ProtectedRange
- Người chỉnh sửa
- BasicFilter
- EmbeddedChart (Biểu đồ nhúng)
- ChartSpec
- TextPosition
- DataSourceChartProperties
- BasicChartSpec
- BasicChartType
- BasicChartLegendPosition
- BasicChartAxis
- BasicChartAxisPosition
- ChartAxisViewWindowOptions
- ViewWindowMode
- BasicChartDomain
- ChartData
- ChartSourceRange
- ChartGroupRule
- ChartDateTimeRule
- ChartDateTimeRuleType
- ChartHistogramRule
- ChartAggregateType
- BasicChartSeries
- LineStyle (Kiểu đường kẻ)
- LineDashType
- DataLabel (Nhãn dữ liệu)
- DataLabelType
- DataLabelPlacement
- PointStyle
- PointShape
- BasicSeriesDataPointStyleOverride
- BasicChartStackedType
- BasicChartCompareMode
- PieChartSpec
- PieChartLegendPosition
- BubbleChartSpec
- BubbleChartLegendPosition
- CandlestickChartSpec
- CandlestickDomain
- CandlestickData
- CandlestickSeries
- OrgChartSpec
- OrgChartNodeSize
- HistogramChartSpec
- HistogramSeries
- HistogramChartLegendPosition
- WaterfallChartSpec
- WaterfallChartDomain
- WaterfallChartSeries
- WaterfallChartColumnStyle
- WaterfallChartCustomSubtotal
- WaterfallChartStackedType
- TreemapChartSpec
- TreemapChartColorScale
- ScorecardChartSpec
- KeyValueFormat
- BaselineValueFormat
- ComparisonType
- ChartNumberFormatSource
- ChartCustomNumberFormatOptions
- ChartHiddenDimensionStrategy
- EmbeddedObjectPosition
- OverlayPosition (Vị trí lớp phủ)
- GridCoordinate
- EmbeddedObjectBorder
- BandedRange
- BandingProperties
- DimensionGroup
- Bộ cắt
- SlicerSpec
- NamedRange
- DataSource
- DataSourceSpec
- BigQueryDataSourceSpec
- BigQueryQuerySpec
- BigQueryTableSpec
- DataSourceParameter
- DataSourceRefreshSchedule
- DataSourceRefreshScope
- DataSourceRefreshDailySchedule
- TimeOfDay
- DataSourceRefreshWeeklySchedule
- DayOfWeek
- 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 ( |
Trường | |
---|---|
spreadsheetId |
Mã của bảng tính. Trường này chỉ để đọc. |
properties |
Thuộc tính tổng thể của một bảng tính. |
sheets[] |
Các trang tính là một phần của bảng tính. |
namedRanges[] |
Các dải ô được đặt tên được xác định trong một bảng tính. |
spreadsheetUrl |
URL của bảng tính. Trường này chỉ để đọc. |
developerMetadata[] |
Siêu dữ liệu dành cho nhà phát triển liên kết với một 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ỉ có đầu ra. Danh sách lịch làm mới nguồn dữ liệu. |
SpreadsheetProperties
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 ( |
Trường | |
---|---|
title |
Tiêu đề của 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ả ngôn ngữ đều được hỗ trợ. |
autoRecalc |
Khoảng thời gian chờ trước khi tính toán lại hàm biến động. |
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 tròn có được giải quyết hay không bằng phép tính lặp lại. 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 giao diện cho bảng tính. |
importFunctionsExternalUrlAccessAllowed |
Liệu có cho phép truy cập URL bên ngoài đối với hàm nhập hình ảnh và hàm nhập hay không. Chỉ đọc khi đúng. Khi giá trị là false, bạn có thể đặt thành true. |
RecalculationInterval
Bảng liệt kê các tuỳ chọn khoảng thời gian tính toán lại có thể có.
Enum | |
---|---|
RECALCULATION_INTERVAL_UNSPECIFIED |
Giá trị mặc định. Không được sử dụng giá trị này. |
ON_CHANGE |
Hàm biến động được cập nhật mỗi khi có thay đổi. |
MINUTE |
Hàm biến động được cập nhật mỗi khi có thay đổi và mỗi phút. |
HOUR |
Hàm biến động được cập nhật mỗi giờ và theo từng thay đổi. |
IterativeCalculationSettings
Các chế độ cài đặt để kiểm soát cách giải quyết các phần phụ thuộc tuần hoàn bằng phép tính lặp lại.
Biểu diễn dưới dạng JSON |
---|
{ "maxIterations": integer, "convergenceThreshold": number } |
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 sẽ 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 chênh lệch nhỏ hơn giá trị ngưỡng này, thì vòng tính toán sẽ dừng lại. |
SpreadsheetTheme
Biểu thị giao diện bảng tính
Biểu diễn dưới dạng JSON |
---|
{
"primaryFontFamily": string,
"themeColors": [
{
object ( |
Trường | |
---|---|
primaryFontFamily |
Tên của bộ phông chữ chính. |
themeColors[] |
Cặp màu cho giao diện của 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. |
ThemeColorPair
Một cặp ánh xạ một kiểu màu giao diện bảng tính với màu cụ thể mà nó đại diện.
Biểu diễn dưới dạng JSON |
---|
{ "colorType": enum ( |
Trường | |
---|---|
colorType |
Loại màu giao diện của bảng tính. |
color |
Màu cụ thể tương ứng với loại màu giao diện. |
NamedRange
Một dải ô được đặt tên.
Biểu diễn dưới dạng JSON |
---|
{
"namedRangeId": string,
"name": string,
"range": {
object ( |
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 ô mà giá trị này đại diện. |
DataSource
Thông tin về 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 ( |
Trường | |
---|---|
dataSourceId |
Mã nhận dạng duy nhất trong phạm vi bảng tính giúp xác định nguồn dữ liệu. Ví dụ: 1080547365. |
spec |
|
calculatedColumns[] |
Tất cả các cột đã được tính trong nguồn dữ liệu. |
sheetId |
Mã của Khi tạo nguồn dữ liệu, một trang tính |
DataSourceSpec
Trường này cho biết thông tin chi tiết của nguồn dữ liệu. Ví dụ: đối với BigQuery, thuộc tính này chỉ định thông tin về nguồn BigQuery.
Biểu diễn dưới dạng JSON |
---|
{ "parameters": [ { object ( |
Trường | |
---|---|
parameters[] |
Các tham số của nguồn dữ liệu, được dùng khi truy vấn nguồn dữ liệu. |
Trường hợp 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 trạng thái sau: |
|
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 |
Trường | |
---|---|
projectId |
Mã của một dự án trên Google Cloud có hỗ trợ BigQuery và có liên kết với một tài khoản thanh toán. Đối với mọi truy vấn được thực thi dựa trên nguồn dữ liệu, dự án sẽ bị tính phí. |
Trường hợp spec . Thông số kỹ thuật thực tế. spec chỉ có thể là một trong những trạng thái sau: |
|
querySpec |
|
tableSpec |
|
BigQueryQuerySpec
Chỉ định một truy vấn BigQuery tuỳ chỉnh.
Biểu diễn dưới dạng JSON |
---|
{ "rawQuery": string } |
Trường | |
---|---|
rawQuery |
Chuỗi truy vấn thô. |
BigQueryTableSpec
Chỉ định một đị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 } |
Trường | |
---|---|
tableProjectId |
Mã của dự án BigQuery chứa bảng. Nếu không được chỉ định, |
tableId |
Mã bảng BigQuery. |
datasetId |
Mã tập dữ liệu BigQuery. |
DataSourceParameter
Một tham số trong truy vấn của nguồn dữ liệu. Tham số cho phép người dùng chuyển các giá trị từ bảng tính vào truy vấn.
Biểu diễn dưới dạng JSON |
---|
{ // Union field |
Trường | |
---|---|
Trường hợp identifier . Giá trị nhận dạng thông số. identifier chỉ có thể là một trong những trạng thái sau: |
|
name |
Tham số được đặt tên. Phải là giá trị nhận dạng hợp lệ của |
Trường hợp value . Giá trị thông số. value chỉ có thể là một trong những trạng thái sau: |
|
namedRangeId |
Mã nhận dạng của |
range |
Dải ô chứa giá trị của tham số. Kích thước phải là 1x1. |
DataSourceRefreshSchedule
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 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 trong khoảng 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 ( |
Trường | |
---|---|
enabled |
"True" nếu lịch làm mới được bật hoặc "false" nếu không bật. |
refreshScope |
Phạm vi của quá trình làm mới. Giá trị phải là |
nextRun |
Chỉ có đầu ra. Khoảng thời gian của lần chạy tiếp theo. |
Trường hợp schedule_config . Cấu hình lịch biểu schedule_config chỉ có thể là một trong những cấu hình 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. |
DataSourceRefreshScope
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 quan trong bảng tính. |
DataSourceRefreshDailySchedule
Lịch biểu để làm mới dữ liệu mỗi ngày trong một khoảng thời gian nhất định.
Biểu diễn dưới dạng JSON |
---|
{
"startTime": {
object ( |
Trường | |
---|---|
startTime |
Thời gian bắt đầu của một khoảng thời gian theo đó quá trình làm mới nguồn dữ liệu được lên lịch. Chỉ sử dụng |
TimeOfDay
Đại diện cho 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. 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 } |
Trường | |
---|---|
hours |
Giờ trong ngày ở định dạng 24 giờ. Nên nằm trong khoảng từ 0 đến 23. API có thể chọn cho phép giá trị "24:00:00" cho các tình huống như thời gian đóng cửa doanh nghiệp. |
minutes |
Phút trong giờ trong ngày. Giá trị phải nằm trong khoảng từ 0 đến 59. |
seconds |
Số giây trong phút của thời gian. Thông thường phải từ 0 đến 59. API có thể cho phép giá trị 60 nếu cho phép giây nhuận. |
nanos |
Phân số giây tính bằng nano giây. Giá trị phải nằm trong khoảng từ 0 đến 999.999.999. |
DataSourceRefreshWeeklySchedule
Lịch biểu hằng tuần để làm mới dữ liệu vào 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 ( |
Trường | |
---|---|
startTime |
Thời gian bắt đầu của một khoảng thời gian theo đó quá trình 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. Bạn phải chỉ định ít nhất một ngày. |
DayOfWeek
Đại diện cho 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 |
DataSourceRefreshMonthlySchedule
Lịch biểu hằng tháng cho việc làm mới dữ liệu vào 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 ( |
Trường | |
---|---|
startTime |
Thời gian bắt đầu của một khoảng thời gian theo đó quá trình 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, lập bản đồ từ ngày 1 đến ngày 28. Bạn phải chỉ định ít nhất một ngày. |
Khoảng thời gian
Đại diện cho một khoảng thời gian, được mã hoá dưới dạng thời điểm bắt đầu là dấu thời gian (bao gồm cả thời gian này) và thời điểm kết thúc là dấu thời gian (độc quyền).
Điểm bắt đầu phải nhỏ hơn hoặc bằng kết thúc. Khi thời gian bắt đầu bằng với thời gian kết thúc, khoảng thời gian này sẽ trống (không khớp với thời gian). Khi bạn không chỉ định cả thời điểm bắt đầu và kết thúc, khoảng thời gian sẽ khớp với bất kỳ thời điểm nào.
Biểu diễn dưới dạng JSON |
---|
{ "startTime": string, "endTime": string } |
Trường | |
---|---|
startTime |
Không bắt buộc. Bắt đầu khoảng thời gian bao gồm. 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 hoặc sau thời điểm bắt đầu. |
endTime |
Không bắt buộc. Cuối khoảng thời gian không có giá trị kết thúc. Nếu được chỉ định, một Dấu thời gian khớp với khoảng thời gian này sẽ phải ở trước khi 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 một bảng tính, trả về bảng tính mới tạo. |
|
Trả về bảng tính tại mã nhận dạng cho trước. |
|
Trả về bảng tính tại mã nhận dạng cho trước. |