REST Resource: spreadsheets.values
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน
บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ
ทรัพยากร: ValueRange
ข้อมูลภายในช่วงของสเปรดชีต
| การแสดง JSON |
{
"range": string,
"majorDimension": enum (Dimension),
"values": [
array
]
} |
| ช่อง |
range |
string
ช่วงของค่าที่ครอบคลุมในรูปแบบการเขียน A1 สำหรับเอาต์พุต ช่วงนี้จะระบุช่วงทั้งหมดที่ขอ แม้ว่าค่าจะไม่รวมแถวและคอลัมน์ต่อท้ายก็ตาม เมื่อเพิ่มค่าต่อท้าย ช่องนี้จะแสดงช่วงที่จะค้นหาตาราง หลังจากนั้นระบบจะเพิ่มค่าต่อท้าย
|
majorDimension |
enum (Dimension)
มิติข้อมูลหลักของค่า สำหรับเอาต์พุต หากข้อมูลสเปรดชีตคือ A1=1,B1=2,A2=3,B2=4 การขอ range=A1:B2,majorDimension=ROWS จะแสดงผลเป็น [[1,2],[3,4]] ส่วนการขอ range=A1:B2,majorDimension=COLUMNS จะแสดงผลเป็น [[1,3],[2,4]] สําหรับอินพุต หากมี range=A1:B2,majorDimension=ROWS [[1,2],[3,4]] จะตั้งค่า A1=1,B1=2,A2=3,B2=4 เมื่อใช้ range=A1:B2,majorDimension=COLUMNS [[1,2],[3,4]] จะตั้งค่า A1=1,B1=3,A2=2,B2=4 เมื่อเขียน หากไม่ได้ตั้งค่าช่องนี้ ระบบจะใช้ ROWS เป็นค่าเริ่มต้น
|
values[] |
array (ListValue format)
ข้อมูลที่อ่านหรือจะเขียน อาร์เรย์นี้เป็นอาร์เรย์ของอาร์เรย์ โดยอาร์เรย์ด้านนอกแสดงข้อมูลทั้งหมด และอาร์เรย์ด้านในแต่ละรายการแสดงมิติข้อมูลหลัก แต่ละรายการในอาร์เรย์ภายในจะสอดคล้องกับ 1 เซลล์ สำหรับเอาต์พุต ระบบจะไม่รวมแถวและคอลัมน์ว่างที่อยู่ท้าย สำหรับอินพุต ประเภทค่าที่รองรับ ได้แก่ bool, string และ double ระบบจะข้ามค่า Null หากต้องการตั้งค่าเซลล์เป็นค่าว่าง ให้ตั้งค่าสตริงเป็นสตริงว่าง
|
เมธอด |
|
|
ต่อท้ายค่าในสเปรดชีต |
|
|
ล้างช่วงค่าอย่างน้อย 1 ช่วงออกจากสเปรดชีต |
|
|
ล้างช่วงค่าอย่างน้อย 1 ช่วงออกจากสเปรดชีต |
|
|
แสดงผลช่วงค่าอย่างน้อย 1 ช่วงจากสเปรดชีต |
|
|
แสดงผลช่วงของค่าอย่างน้อย 1 ช่วงซึ่งตรงกับตัวกรองข้อมูลที่ระบุ |
|
|
ตั้งค่าในช่วงอย่างน้อย 1 ช่วงของสเปรดชีต |
|
|
ตั้งค่าในช่วงอย่างน้อย 1 ช่วงของสเปรดชีต |
|
|
ล้างค่าออกจากสเปรดชีต |
|
|
แสดงผลช่วงค่าจากสเปรดชีต |
|
|
ตั้งค่าในช่วงของสเปรดชีต |
เนื้อหาของหน้าเว็บนี้ได้รับอนุญาตภายใต้ใบอนุญาตที่ต้องระบุที่มาของครีเอทีฟคอมมอนส์ 4.0 และตัวอย่างโค้ดได้รับอนุญาตภายใต้ใบอนุญาต Apache 2.0 เว้นแต่จะระบุไว้เป็นอย่างอื่น โปรดดูรายละเอียดที่นโยบายเว็บไซต์ Google Developers Java เป็นเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2025-03-22 UTC
[null,null,["อัปเดตล่าสุด 2025-03-22 UTC"],[],[],null,["# REST Resource: spreadsheets.values\n\n- [Resource: ValueRange](#ValueRange)\n - [JSON representation](#ValueRange.SCHEMA_REPRESENTATION)\n- [Methods](#METHODS_SUMMARY)\n\nResource: ValueRange\n--------------------\n\nData within a range of the spreadsheet.\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"range\": string, \"majorDimension\": enum (/workspace/sheets/api/reference/rest/v4/Dimension), \"values\": [ array ] } ``` |\n\n| Fields ||\n|------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `range` | `string` The range the values cover, in [A1 notation](https://developers.google.com/workspace/sheets/api/guides/concepts#cell). For output, this range indicates the entire requested range, even though the values will exclude trailing rows and columns. When appending values, this field represents the range to search for a table, after which values will be appended. |\n| `majorDimension` | `enum (`[Dimension](/workspace/sheets/api/reference/rest/v4/Dimension)`)` The major dimension of the values. For output, if the spreadsheet data is: `A1=1,B1=2,A2=3,B2=4`, then requesting `range=A1:B2,majorDimension=ROWS` will return `[[1,2],[3,4]]`, whereas requesting `range=A1:B2,majorDimension=COLUMNS` will return `[[1,3],[2,4]]`. For input, with `range=A1:B2,majorDimension=ROWS` then `[[1,2],[3,4]]` will set `A1=1,B1=2,A2=3,B2=4`. With `range=A1:B2,majorDimension=COLUMNS` then `[[1,2],[3,4]]` will set `A1=1,B1=3,A2=2,B2=4`. When writing, if this field is not set, it defaults to ROWS. |\n| `values[]` | `array (`[ListValue](https://protobuf.dev/reference/protobuf/google.protobuf/#list-value)` format)` The data that was read or to be written. This is an array of arrays, the outer array representing all the data and each inner array representing a major dimension. Each item in the inner array corresponds with one cell. For output, empty trailing rows and columns will not be included. For input, supported value types are: bool, string, and double. Null values will be skipped. To set a cell to an empty value, set the string value to an empty string. |\n\n| Methods ------- ||\n|--------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------|\n| ### [append](/workspace/sheets/api/reference/rest/v4/spreadsheets.values/append) | Appends values to a spreadsheet. |\n| ### [batchClear](/workspace/sheets/api/reference/rest/v4/spreadsheets.values/batchClear) | Clears one or more ranges of values from a spreadsheet. |\n| ### [batchClearByDataFilter](/workspace/sheets/api/reference/rest/v4/spreadsheets.values/batchClearByDataFilter) | Clears one or more ranges of values from a spreadsheet. |\n| ### [batchGet](/workspace/sheets/api/reference/rest/v4/spreadsheets.values/batchGet) | Returns one or more ranges of values from a spreadsheet. |\n| ### [batchGetByDataFilter](/workspace/sheets/api/reference/rest/v4/spreadsheets.values/batchGetByDataFilter) | Returns one or more ranges of values that match the specified data filters. |\n| ### [batchUpdate](/workspace/sheets/api/reference/rest/v4/spreadsheets.values/batchUpdate) | Sets values in one or more ranges of a spreadsheet. |\n| ### [batchUpdateByDataFilter](/workspace/sheets/api/reference/rest/v4/spreadsheets.values/batchUpdateByDataFilter) | Sets values in one or more ranges of a spreadsheet. |\n| ### [clear](/workspace/sheets/api/reference/rest/v4/spreadsheets.values/clear) | Clears values from a spreadsheet. |\n| ### [get](/workspace/sheets/api/reference/rest/v4/spreadsheets.values/get) | Returns a range of values from a spreadsheet. |\n| ### [update](/workspace/sheets/api/reference/rest/v4/spreadsheets.values/update) | Sets values in a range of a spreadsheet. |"]]
