REST Resource: spreadsheets

{
  "spreadsheetId": string,
  "properties": {
    object (SpreadsheetProperties)
  },
  "sheets": [
    {
      object (Sheet)
    }
  ],
  "namedRanges": [
    {
      object (NamedRange)
    }
  ],
  "spreadsheetUrl": string,
  "developerMetadata": [
    {
      object (DeveloperMetadata)
    }
  ],
  "dataSources": [
    {
      object (DataSource)
    }
  ],
  "dataSourceSchedules": [
    {
      object (DataSourceRefreshSchedule)
    }
  ]
}

string

รหัสของสเปรดชีต ช่องนี้เป็นแบบอ่านอย่างเดียว

object (SpreadsheetProperties)

พร็อพเพอร์ตี้โดยรวมของสเปรดชีต

object (Sheet)

ชีตที่เป็นส่วนหนึ่งของสเปรดชีต

object (NamedRange)

ช่วงที่ตั้งชื่อแล้วซึ่งกำหนดไว้ในสเปรดชีต

string

URL ของสเปรดชีต ช่องนี้เป็นแบบอ่านอย่างเดียว

object (DeveloperMetadata)

ข้อมูลเมตาของนักพัฒนาซอฟต์แวร์ที่เชื่อมโยงกับสเปรดชีต

object (DataSource)

รายการแหล่งข้อมูลภายนอกที่เชื่อมต่อกับสเปรดชีต

object (DataSourceRefreshSchedule)

เอาต์พุตเท่านั้น รายการกำหนดเวลาการรีเฟรชแหล่งข้อมูล

{
  "title": string,
  "locale": string,
  "autoRecalc": enum (RecalculationInterval),
  "timeZone": string,
  "defaultFormat": {
    object (CellFormat)
  },
  "iterativeCalculationSettings": {
    object (IterativeCalculationSettings)
  },
  "spreadsheetTheme": {
    object (SpreadsheetTheme)
  },
  "importFunctionsExternalUrlAccessAllowed": boolean
}

string

ชื่อของสเปรดชีต

string

ภาษาของสเปรดชีตในรูปแบบใดรูปแบบหนึ่งต่อไปนี้

• รหัสภาษา ISO 639-1 เช่น en

• รหัสภาษา ISO 639-2 เช่น fil หากไม่มีรหัส 639-1

• รหัสภาษา ISO และรหัสประเทศ เช่น en_US

หมายเหตุ: เมื่ออัปเดตช่องนี้ ระบบจะไม่รองรับบางภาษา

enum (RecalculationInterval)

ระยะเวลาที่ต้องรอก่อนที่ฟังก์ชันที่ผันผวนจะคำนวณใหม่

string

เขตเวลาของสเปรดชีตในรูปแบบ CLDR เช่น America/New_York หากไม่รู้จักเขตเวลานี้ อาจเป็นเขตเวลาที่กำหนดเอง เช่น GMT-07:00

object (CellFormat)

รูปแบบเริ่มต้นของเซลล์ทั้งหมดในสเปรดชีต จะไม่มีการกำหนด CellData.effectiveFormat หากรูปแบบของเซลล์เท่ากับรูปแบบเริ่มต้นนี้ ช่องนี้เป็นแบบอ่านอย่างเดียว

object (IterativeCalculationSettings)

ระบุการแก้ปัญหาการอ้างอิงแบบวนรอบด้วยการคำนวณซ้ำหรือไม่และอย่างไร การไม่มีฟิลด์นี้หมายความว่าการอ้างอิงแบบวงกลมจะทำให้เกิดข้อผิดพลาดในการคำนวณ

object (SpreadsheetTheme)

ใช้ธีมกับสเปรดชีตแล้ว

boolean

จะอนุญาตให้เข้าถึง URL ภายนอกสำหรับฟังก์ชันรูปภาพและการนำเข้าหรือไม่ อ่านเมื่อเป็นจริงเท่านั้น เมื่อเป็น "เท็จ" คุณสามารถตั้งเป็น "จริง" ได้

{
  "maxIterations": integer,
  "convergenceThreshold": number
}

integer

เมื่อเปิดใช้การคำนวณซ้ำ จำนวนรอบการคำนวณสูงสุดที่จะดำเนินการ

number

เมื่อเปิดใช้การคำนวณซ้ำและผลลัพธ์ต่อเนื่องแตกต่างกันน้อยกว่าค่าเกณฑ์นี้ รอบการคำนวณจะหยุดลง

{
  "primaryFontFamily": string,
  "themeColors": [
    {
      object (ThemeColorPair)
    }
  ]
}

string

ชื่อของชุดแบบอักษรหลัก

object (ThemeColorPair)

คู่สีธีมสเปรดชีต หากต้องการอัปเดต คุณต้องระบุคู่สีธีมทั้งหมด

{
  "colorType": enum (ThemeColorType),
  "color": {
    object (ColorStyle)
  }
}

enum (ThemeColorType)

ประเภทสีธีมของสเปรดชีต

object (ColorStyle)

สีคอนกรีตที่สอดคล้องกับประเภทสีธีม

{
  "namedRangeId": string,
  "name": string,
  "range": {
    object (GridRange)
  }
}

string

รหัสของช่วงที่ตั้งชื่อแล้ว

string

ชื่อของช่วงที่ตั้งชื่อแล้ว

object (GridRange)

ช่วงที่แสดง

{
  "dataSourceId": string,
  "spec": {
    object (DataSourceSpec)
  },
  "calculatedColumns": [
    {
      object (DataSourceColumn)
    }
  ],
  "sheetId": integer
}

string

รหัสที่ไม่ซ้ำกันในขอบเขตระดับสเปรดชีตที่ระบุแหล่งข้อมูล เช่น 1080547365

object (DataSourceSpec)

DataSourceSpec สำหรับแหล่งข้อมูลที่เชื่อมต่อกับสเปรดชีตนี้

object (DataSourceColumn)

คอลัมน์ที่คำนวณทั้งหมดในแหล่งข้อมูล

integer

รหัสของ Sheet ที่เชื่อมต่อกับแหล่งข้อมูล เมื่อตั้งค่าแล้ว ฟิลด์ดังกล่าวจะไม่สามารถเปลี่ยนแปลงได้

เมื่อสร้างแหล่งข้อมูล ระบบจะสร้างชีต DATA_SOURCE ที่เชื่อมโยงด้วย หากไม่ได้ระบุช่องไว้ ระบบจะสร้างรหัสของชีตที่สร้างขึ้นแบบสุ่ม

{
  "parameters": [
    {
      object (DataSourceParameter)
    }
  ],

  // Union field spec can be only one of the following:
  "bigQuery": {
    object (BigQueryDataSourceSpec)
  },
  "looker": {
    object (LookerDataSourceSpec)
  }
  // End of list of possible types for union field spec.
}

object (DataSourceParameter)

พารามิเตอร์ของแหล่งข้อมูลที่ใช้เมื่อค้นหาแหล่งข้อมูล

object (BigQueryDataSourceSpec)

BigQueryDataSourceSpec

object (LookerDataSourceSpec)

LookerDataSourceSpec

{
  "projectId": string,

  // Union field spec can be only one of the following:
  "querySpec": {
    object (BigQueryQuerySpec)
  },
  "tableSpec": {
    object (BigQueryTableSpec)
  }
  // End of list of possible types for union field spec.
}

string

รหัสของโปรเจ็กต์ Google Cloud ที่เปิดใช้ BigQuery และแนบบัญชีสำหรับการเรียกเก็บเงิน ระบบจะเรียกเก็บเงินจากโปรเจ็กต์สำหรับการค้นหาที่ดำเนินการในแหล่งข้อมูล

object (BigQueryQuerySpec)

BigQueryQuerySpec

object (BigQueryTableSpec)

BigQueryTableSpec

{
  "rawQuery": string
}

string

สตริงคำค้นหาดิบ

{
  "tableProjectId": string,
  "tableId": string,
  "datasetId": string
}

string

รหัสโปรเจ็กต์ BigQuery ที่มีตารางอยู่ หากไม่ได้ระบุไว้ ระบบจะถือว่าใช้ projectId

string

รหัสตาราง BigQuery

string

รหัสชุดข้อมูล BigQuery

{
  "instanceUri": string,
  "model": string,
  "explore": string
}

string

URL อินสแตนซ์ Looker

string

ชื่อโมเดล Looker

string

ชื่อของการสำรวจโมเดล Looker

{

  // Union field identifier can be only one of the following:
  "name": string
  // End of list of possible types for union field identifier.

  // Union field value can be only one of the following:
  "namedRangeId": string,
  "range": {
    object (GridRange)
  }
  // End of list of possible types for union field value.
}

string

พารามิเตอร์ที่มีชื่อ ต้องเป็นตัวระบุที่ถูกต้องสำหรับ DataSource ที่รองรับ เช่น ตัวระบุ BigQuery

string

รหัสของ NamedRange ต้องมีขนาด 1x1

object (GridRange)

ช่วงที่มีค่าของพารามิเตอร์ ต้องมีขนาด 1x1

{
  "enabled": boolean,
  "refreshScope": enum (DataSourceRefreshScope),
  "nextRun": {
    object (Interval)
  },

  // Union field schedule_config can be only one of the following:
  "dailySchedule": {
    object (DataSourceRefreshDailySchedule)
  },
  "weeklySchedule": {
    object (DataSourceRefreshWeeklySchedule)
  },
  "monthlySchedule": {
    object (DataSourceRefreshMonthlySchedule)
  }
  // End of list of possible types for union field schedule_config.
}

boolean

จริง หากเปิดใช้กำหนดการรีเฟรช หรือเป็นเท็จ

enum (DataSourceRefreshScope)

ขอบเขตของการรีเฟรช ต้องเป็น ALL_DATA_SOURCES

object (Interval)

เอาต์พุตเท่านั้น ช่วงเวลาของการเรียกใช้ครั้งถัดไป

object (DataSourceRefreshDailySchedule)

กำหนดเวลาการรีเฟรชรายวัน

object (DataSourceRefreshWeeklySchedule)

กำหนดเวลารีเฟรชรายสัปดาห์

object (DataSourceRefreshMonthlySchedule)

กำหนดเวลาการรีเฟรชรายเดือน

{
  "startTime": {
    object (TimeOfDay)
  }
}

object (TimeOfDay)

เวลาเริ่มต้นของช่วงเวลาที่กําหนดเวลาการรีเฟรชแหล่งข้อมูล ใช้ hours ส่วนเท่านั้น ค่าเริ่มต้นของขนาดช่วงเวลาในเครื่องมือแก้ไขชีต

{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}

integer

ชั่วโมงของวันในรูปแบบ 24 ชั่วโมง ควรอยู่ระหว่าง 0 ถึง 23 API อาจเลือกอนุญาตค่า "24:00:00" สำหรับสถานการณ์ต่างๆ เช่น เวลาปิดทำการ

integer

นาทีต่อชั่วโมง ต้องอยู่ระหว่าง 0 ถึง 59

integer

เวลาเป็นวินาที โดยปกติต้องอยู่ระหว่าง 0 ถึง 59 API อาจอนุญาตให้ใช้ค่า 60 หากอนุญาตให้มีวินาทีอธิกวาร

integer

เศษส่วนของวินาทีในหน่วยนาโนวินาที ต้องมีค่าตั้งแต่ 0 ถึง 999,999,999

{
  "startTime": {
    object (TimeOfDay)
  },
  "daysOfWeek": [
    enum (DayOfWeek)
  ]
}

object (TimeOfDay)

เวลาเริ่มต้นของช่วงเวลาที่กําหนดเวลาการรีเฟรชแหล่งข้อมูล ใช้ hours ส่วนเท่านั้น ค่าเริ่มต้นของขนาดช่วงเวลาในเครื่องมือแก้ไขชีต

enum (DayOfWeek)

วันของสัปดาห์ที่จะรีเฟรช ต้องระบุอย่างน้อย 1 วัน

{
  "startTime": {
    object (TimeOfDay)
  },
  "daysOfMonth": [
    integer
  ]
}

object (TimeOfDay)

เวลาเริ่มต้นของช่วงเวลาที่กําหนดเวลาการรีเฟรชแหล่งข้อมูล ใช้ hours ส่วนเท่านั้น ค่าเริ่มต้นของขนาดช่วงเวลาในเครื่องมือแก้ไขชีต

integer

วันของเดือนที่จะรีเฟรช รองรับหมายเลข 1-28 เท่านั้น โดยจะแมปตั้งแต่วันที่ 1 ถึงวันที่ 28 ต้องระบุอย่างน้อย 1 วัน

{
  "startTime": string,
  "endTime": string
}

string (Timestamp format)

ไม่บังคับ จุดเริ่มต้นของช่วงเวลาแบบรวม

หากระบุไว้ การประทับเวลาที่ตรงกับช่วงเวลานี้จะต้องเป็นรายการเดียวกันหรือหลังจากเวลาเริ่มต้น

string (Timestamp format)

ไม่บังคับ ช่วงสิ้นสุดพิเศษ

หากระบุไว้ การประทับเวลาที่ตรงกับช่วงเวลานี้จะต้องอยู่ก่อนสิ้นสุด