- ทรัพยากร: สเปรดชีต
- SpreadsheetProperties
- RecalculationInterval
- CellFormat
- NumberFormat
- NumberFormatType
- สี
- ColorStyle
- ThemeColorType
- พรมแดน
- เส้นขอบ
- สไตล์
- ระยะห่างจากขอบ
- HorizontalAlign
- VerticalAlign
- WrapStrategy
- TextDirection
- TextFormat
- ลิงก์
- HyperlinkDisplayType
- TextRotation
- IterativeCalculationSettings
- SpreadsheetTheme
- ThemeColorPair
- ชีต
- 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
- DataSourceFormula
- DimensionProperties
- ConditionalFormatRule
- BooleanRule
- GradientRule
- InterpolationPoint
- InterpolationPointType
- FilterView
- ProtectedRange
- เอดิเตอร์
- BasicFilter
- EmbeddedChart
- ChartSpec
- TextPosition
- DataSourceChartProperties
- BasicChartSpec
- BasicChartType
- BasicChartLegendPosition
- BasicChartAxis
- BasicChartAxisPosition
- ChartAxisViewWindowOptions
- ViewWindowMode
- BasicChartDomain
- ChartData
- ChartSourceRange
- ChartGroupRule
- ChartDateTimeRule
- ChartDateTimeRuleType
- ChartHistogramRule
- ChartAggregateType
- BasicChartSeries
- LineStyle
- LineDashType
- DataLabel
- 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
- GridCoordinate
- EmbeddedObjectBorder ของ
- BandedRange
- BandingProperties
- DimensionGroup
- ตัวควบคุมตัวกรอง
- SlicerSpec
- NamedRange
- DataSource
- DataSourceSpec
- BigQueryDataSourceSpec
- BigQueryQuerySpec
- BigQueryTableSpec
- DataSourceParameter
- DataSourceRefreshSchedule
- DataSourceRefreshScope
- DataSourceRefreshDailySchedule
- TimeOfDay
- DataSourceRefreshWeeklySchedule
- DayOfWeek
- DataSourceRefreshMonthlySchedule
- ช่วงเวลา
- เมธอด
ทรัพยากร: สเปรดชีต
ทรัพยากรที่แสดงถึงสเปรดชีต
การแสดง JSON |
---|
{ "spreadsheetId": string, "properties": { object ( |
ช่อง | |
---|---|
spreadsheetId |
รหัสของสเปรดชีต ช่องนี้เป็นแบบอ่านอย่างเดียว |
properties |
พร็อพเพอร์ตี้โดยรวมของสเปรดชีต |
sheets[] |
ชีตที่เป็นส่วนหนึ่งของสเปรดชีต |
namedRanges[] |
ช่วงที่ตั้งชื่อแล้วที่กำหนดในสเปรดชีต |
spreadsheetUrl |
URL ของสเปรดชีต ช่องนี้เป็นแบบอ่านอย่างเดียว |
developerMetadata[] |
ข้อมูลเมตาของนักพัฒนาซอฟต์แวร์ที่เชื่อมโยงกับสเปรดชีต |
dataSources[] |
รายการแหล่งข้อมูลภายนอกที่เชื่อมต่อกับสเปรดชีต |
dataSourceSchedules[] |
เอาต์พุตเท่านั้น รายการกำหนดเวลารีเฟรชแหล่งข้อมูล |
SpreadsheetProperties
คุณสมบัติของสเปรดชีต
การแสดง JSON |
---|
{ "title": string, "locale": string, "autoRecalc": enum ( |
ช่อง | |
---|---|
title |
ชื่อสเปรดชีต |
locale |
ภาษาของสเปรดชีตในรูปแบบใดรูปแบบหนึ่งต่อไปนี้
หมายเหตุ: เมื่ออัปเดตฟิลด์นี้ ระบบจะสนับสนุนภาษา/ภาษาบางภาษาเท่านั้น |
autoRecalc |
ระยะเวลาที่ต้องรอก่อนจะคำนวณฟังก์ชันที่มีความผันผวนอีกครั้ง |
timeZone |
เขตเวลาของสเปรดชีตในรูปแบบ CLDR เช่น |
defaultFormat |
รูปแบบเริ่มต้นของทุกเซลล์ในสเปรดชีต ระบบจะไม่ตั้งค่า |
iterativeCalculationSettings |
กำหนดว่าจะใช้การคำนวณแบบวนซ้ำหรือไม่และจะใช้วิธีแก้การอ้างอิงแบบวนรอบหรือไม่ หากไม่มีข้อมูลช่องนี้ หมายความว่าการอ้างอิงแบบวนรอบส่งผลให้เกิดข้อผิดพลาดในการคำนวณ |
spreadsheetTheme |
ใช้ธีมกับสเปรดชีตแล้ว |
importFunctionsExternalUrlAccessAllowed |
จะอนุญาตให้เข้าถึง URL ภายนอกสำหรับฟังก์ชันรูปภาพและการนำเข้าหรือไม่ อ่านเมื่อเป็นจริงเท่านั้น เมื่อเป็นเท็จ คุณสามารถตั้งค่าเป็น "จริง" |
RecalculationInterval
การแจกแจงตัวเลือกช่วงการคำนวณใหม่ที่เป็นไปได้
Enum | |
---|---|
RECALCULATION_INTERVAL_UNSPECIFIED |
ค่าเริ่มต้น ต้องไม่ใช้ค่านี้ |
ON_CHANGE |
ระบบจะอัปเดตฟังก์ชันที่มีความผันผวนทุกครั้งที่มีการเปลี่ยนแปลง |
MINUTE |
ระบบจะอัปเดตฟังก์ชันที่ผันผวนทุกครั้งที่มีการเปลี่ยนแปลงและทุกนาที |
HOUR |
ฟังก์ชันที่มีความผันผวนจะได้รับการอัปเดตในทุกการเปลี่ยนแปลงและทุกชั่วโมง |
IterativeCalculationSettings
การตั้งค่าเพื่อควบคุมวิธีการแก้ไขทรัพยากร Dependency แบบวนซ้ำ
การแสดง JSON |
---|
{ "maxIterations": integer, "convergenceThreshold": number } |
ช่อง | |
---|---|
maxIterations |
เมื่อเปิดใช้การคำนวณแบบวนซ้ำ จำนวนรอบการคำนวณสูงสุดที่จะดำเนินการได้ |
convergenceThreshold |
เมื่อเปิดใช้การคำนวณแบบวนซ้ำและผลลัพธ์ที่ตามมามีความแตกต่างน้อยกว่าค่าเกณฑ์นี้ รอบการคำนวณจะหยุดลง |
SpreadsheetTheme
แสดงธีมของสเปรดชีต
การแสดง JSON |
---|
{
"primaryFontFamily": string,
"themeColors": [
{
object ( |
ช่อง | |
---|---|
primaryFontFamily |
ชื่อของชุดแบบอักษรหลัก |
themeColors[] |
คู่สีธีมสเปรดชีต คุณต้องระบุคู่สีธีมทั้งหมดเพื่ออัปเดต |
ThemeColorPair
คู่การจับคู่ประเภทสีธีมของสเปรดชีตกับสีคอนกรีตที่แสดง
การแสดง JSON |
---|
{ "colorType": enum ( |
ช่อง | |
---|---|
colorType |
ประเภทสีธีมของสเปรดชีต |
color |
สีคอนกรีตที่สอดคล้องกับประเภทสีธีม |
NamedRange
ช่วงที่ตั้งชื่อแล้ว
การแสดง JSON |
---|
{
"namedRangeId": string,
"name": string,
"range": {
object ( |
ช่อง | |
---|---|
namedRangeId |
รหัสของช่วงที่ตั้งชื่อแล้ว |
name |
ชื่อของช่วงที่ตั้งชื่อแล้ว |
range |
ช่วงที่แสดง |
DataSource
ข้อมูลเกี่ยวกับแหล่งข้อมูลภายนอกในสเปรดชีต
การแสดง JSON |
---|
{ "dataSourceId": string, "spec": { object ( |
ช่อง | |
---|---|
dataSourceId |
รหัสที่ไม่ซ้ำกันระดับสเปรดชีตซึ่งระบุแหล่งข้อมูล ตัวอย่าง: 1080547365 |
spec |
|
calculatedColumns[] |
คอลัมน์ที่คำนวณแล้วทั้งหมดในแหล่งข้อมูล |
sheetId |
รหัสของ เมื่อสร้างแหล่งข้อมูล ระบบจะสร้างชีต |
DataSourceSpec
ค่านี้ระบุรายละเอียดของแหล่งข้อมูล ตัวอย่างเช่น สำหรับ BigQuery การตั้งค่านี้จะระบุข้อมูลเกี่ยวกับแหล่งที่มาของ BigQuery
การแสดง JSON |
---|
{ "parameters": [ { object ( |
ช่อง | |
---|---|
parameters[] |
พารามิเตอร์ของแหล่งข้อมูล ซึ่งจะใช้เมื่อค้นหาแหล่งข้อมูล |
ฟิลด์สหภาพ spec ข้อกำหนดจริงตามประเภทแหล่งข้อมูล spec ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น |
|
bigQuery |
|
BigQueryDataSourceSpec
ข้อกําหนดของแหล่งข้อมูล BigQuery ที่เชื่อมต่อกับชีต
การแสดง JSON |
---|
{ "projectId": string, // Union field |
ช่อง | |
---|---|
projectId |
รหัสของโปรเจ็กต์ Google Cloud ที่เปิดใช้ BigQuery โดยมีบัญชีสำหรับการเรียกเก็บเงินแนบอยู่ ระบบจะเรียกเก็บเงินจากโปรเจ็กต์สำหรับการค้นหาที่ดำเนินการกับแหล่งข้อมูล |
ฟิลด์สหภาพ spec ข้อกำหนดจริง spec ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น |
|
querySpec |
|
tableSpec |
|
BigQueryQuerySpec
ระบุการค้นหา BigQuery ที่กําหนดเอง
การแสดง JSON |
---|
{ "rawQuery": string } |
ช่อง | |
---|---|
rawQuery |
สตริงคำค้นหาดิบ |
BigQueryTableSpec
ระบุคำจำกัดความของตาราง BigQuery อนุญาตเฉพาะตารางเนทีฟเท่านั้น
การแสดง JSON |
---|
{ "tableProjectId": string, "tableId": string, "datasetId": string } |
ช่อง | |
---|---|
tableProjectId |
รหัสโปรเจ็กต์ BigQuery ที่มีตาราง หากไม่ได้ระบุไว้ ระบบจะถือว่าเป็น |
tableId |
รหัสตาราง BigQuery |
datasetId |
รหัสชุดข้อมูล BigQuery |
DataSourceParameter
พารามิเตอร์ในการค้นหาของแหล่งข้อมูล พารามิเตอร์นี้ช่วยให้ผู้ใช้ส่งค่าจากสเปรดชีตไปยังการค้นหาได้
การแสดง JSON |
---|
{ // Union field |
ช่อง | |
---|---|
ฟิลด์สหภาพ identifier ตัวระบุพารามิเตอร์ identifier ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น |
|
name |
พารามิเตอร์ที่มีชื่อ ต้องเป็นตัวระบุที่ถูกต้องสำหรับ |
ฟิลด์สหภาพ value ค่าพารามิเตอร์ value ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น |
|
namedRangeId |
รหัสของ |
range |
ช่วงที่มีค่าของพารามิเตอร์ ต้องมีขนาด 1x1 |
DataSourceRefreshSchedule
กำหนดเวลารีเฟรชแหล่งข้อมูล
ระบบจะรีเฟรชแหล่งข้อมูลในสเปรดชีตภายในช่วงเวลาหนึ่ง คุณระบุเวลาเริ่มต้นได้โดยคลิกปุ่มรีเฟรชตามกำหนดเวลาในเครื่องมือแก้ไขชีต แต่ระยะเวลาดังกล่าวจะกำหนดไว้ที่ 4 ชั่วโมง ตัวอย่างเช่น ถ้าคุณระบุเวลาเริ่มต้นเป็น 8:00 น. การรีเฟรชจะเกิดขึ้นระหว่างเวลา 8:00 น. ถึง 12:00 น. ของทุกวัน
การแสดง JSON |
---|
{ "enabled": boolean, "refreshScope": enum ( |
ช่อง | |
---|---|
enabled |
"จริง" หากเปิดใช้กำหนดการรีเฟรช หรือ "เท็จ" หากไม่เปิดใช้ |
refreshScope |
ขอบเขตของการรีเฟรช ต้องเป็น |
nextRun |
เอาต์พุตเท่านั้น ช่วงเวลาของการเรียกใช้ครั้งถัดไป |
ฟิลด์สหภาพ schedule_config การกําหนดค่ากําหนดการ schedule_config เป็นได้อย่างใดอย่างหนึ่งต่อไปนี้เท่านั้น |
|
dailySchedule |
กำหนดการรีเฟรชรายวัน |
weeklySchedule |
กำหนดการรีเฟรชรายสัปดาห์ |
monthlySchedule |
กำหนดการรีเฟรชรายเดือน |
DataSourceRefreshScope
ขอบเขตการรีเฟรชแหล่งข้อมูล
Enum | |
---|---|
DATA_SOURCE_REFRESH_SCOPE_UNSPECIFIED |
ค่าเริ่มต้น อย่าใช้ |
ALL_DATA_SOURCES |
รีเฟรชแหล่งข้อมูลทั้งหมดและออบเจ็กต์แหล่งข้อมูลที่เชื่อมโยงในสเปรดชีต |
DataSourceRefreshDailySchedule
กำหนดการสำหรับรีเฟรชข้อมูลทุกวันในช่วงเวลาที่กำหนด
การแสดง JSON |
---|
{
"startTime": {
object ( |
ช่อง | |
---|---|
startTime |
เวลาเริ่มต้นของช่วงเวลาที่กำหนดเวลารีเฟรชแหล่งข้อมูล เพราะใช้เพียง |
TimeOfDay
แสดงเวลาของวัน วันที่และเขตเวลาไม่มีนัยสำคัญหรือระบุไว้ในที่อื่น API อาจเลือกอนุญาตวินาทีอธิกสุรทิน ประเภทที่เกี่ยวข้องได้แก่ google.type.Date
และ google.protobuf.Timestamp
การแสดง JSON |
---|
{ "hours": integer, "minutes": integer, "seconds": integer, "nanos": integer } |
ช่อง | |
---|---|
hours |
ชั่วโมงของวันในรูปแบบ 24 ชั่วโมง ควรอยู่ระหว่าง 0 ถึง 23 API อาจเลือกอนุญาตให้ใช้ค่า "24:00:00" สำหรับสถานการณ์ต่างๆ เช่น เวลาปิดทำการของธุรกิจ |
minutes |
นาทีในชั่วโมงของวัน ต้องอยู่ระหว่าง 0 ถึง 59 |
seconds |
วินาทีของนาทีของเวลา ปกติต้องอยู่ระหว่าง 0 ถึง 59 API อาจอนุญาตค่า 60 หากอนุญาตให้ใช้วินาทีอธิกสุรทิน |
nanos |
เศษส่วนของวินาทีในนาโนวินาที ต้องอยู่ระหว่าง 0 ถึง 999,999,999 |
DataSourceRefreshWeeklySchedule
กำหนดเวลารายสัปดาห์สำหรับการรีเฟรชข้อมูลในวันที่ระบุในช่วงเวลาที่กำหนด
การแสดง JSON |
---|
{ "startTime": { object ( |
ช่อง | |
---|---|
startTime |
เวลาเริ่มต้นของช่วงเวลาที่กำหนดเวลารีเฟรชแหล่งข้อมูล เพราะใช้เพียง |
daysOfWeek[] |
วันในสัปดาห์ที่จะรีเฟรช ต้องระบุอย่างน้อย 1 วัน |
DayOfWeek
แสดงวันของสัปดาห์
Enum | |
---|---|
DAY_OF_WEEK_UNSPECIFIED |
ไม่ได้ระบุวันของสัปดาห์ |
MONDAY |
วันจันทร์ |
TUESDAY |
วันอังคาร |
WEDNESDAY |
วันพุธ |
THURSDAY |
พฤหัสบดี |
FRIDAY |
วันศุกร์ |
SATURDAY |
เสาร์ |
SUNDAY |
วันอาทิตย์ |
DataSourceRefreshMonthlySchedule
กําหนดการรายเดือนสําหรับรีเฟรชข้อมูลในวันที่กําหนดในเดือนในระยะเวลาที่กําหนด
การแสดง JSON |
---|
{
"startTime": {
object ( |
ช่อง | |
---|---|
startTime |
เวลาเริ่มต้นของช่วงเวลาที่กำหนดเวลารีเฟรชแหล่งข้อมูล เพราะใช้เพียง |
daysOfMonth[] |
วันที่ของเดือนที่จะรีเฟรช รองรับเฉพาะวันที่ 1-28 โดยแมปเป็นวันที่ 1 ถึงวันที่ 28 ต้องระบุอย่างน้อย 1 วัน |
ช่วงเวลา
แสดงช่วงเวลาที่เข้ารหัสเป็นการเริ่มต้นการประทับเวลา (รวม) และสิ้นสุดการประทับเวลา (ไม่รวม)
จุดเริ่มต้นต้องน้อยกว่าหรือเท่ากับจุดสิ้นสุด เมื่อเริ่มต้นเท่ากับสิ้นสุด ช่วงเวลาจะว่างเปล่า (ไม่ตรงเวลา) เมื่อไม่ได้ระบุทั้งจุดเริ่มต้นและจุดสิ้นสุด ช่วงเวลาจะจับคู่กันได้ทุกเมื่อ
การแสดง JSON |
---|
{ "startTime": string, "endTime": string } |
ช่อง | |
---|---|
startTime |
ไม่บังคับ ช่วงเริ่มต้นแบบรวม หากระบุไว้ การประทับเวลาที่ตรงกับช่วงเวลานี้จะต้องเป็นรายการเดียวกันหรือหลังจากวันที่เริ่มต้น |
endTime |
ไม่บังคับ ช่วงสิ้นสุดสุดพิเศษ หากระบุไว้ การประทับเวลาที่ตรงกับช่วงเวลานี้จะต้องอยู่ก่อนเวลาสิ้นสุด |
วิธีการ |
|
---|---|
|
ใช้การอัปเดตกับสเปรดชีตอย่างน้อย 1 รายการ |
|
สร้างสเปรดชีตโดยแสดงผลสเปรดชีตที่สร้างขึ้นใหม่ |
|
แสดงสเปรดชีตตามรหัสที่ระบุ |
|
แสดงสเปรดชีตตามรหัสที่ระบุ |