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 หากต้องการตั้งค่าเซลล์เป็นค่าว่าง ให้ตั้งค่าสตริงเป็นสตริงว่าง

เมธอด

append

ต่อท้ายค่าในสเปรดชีต

batchClear

ล้างช่วงค่าอย่างน้อย 1 ช่วงออกจากสเปรดชีต

batchClearByDataFilter

ล้างค่าช่วงตั้งแต่ 1 ช่วงขึ้นไปออกจากสเปรดชีต

batchGet

แสดงผลช่วงค่าอย่างน้อย 1 ช่วงจากสเปรดชีต

batchGetByDataFilter

แสดงผลช่วงของค่าอย่างน้อย 1 ช่วงที่ตรงกับตัวกรองข้อมูลที่ระบุ

batchUpdate

ตั้งค่าในช่วงอย่างน้อย 1 ช่วงของสเปรดชีต

batchUpdateByDataFilter

ตั้งค่าในช่วงของสเปรดชีตอย่างน้อย 1 ช่วง

clear

ล้างค่าออกจากสเปรดชีต

get

แสดงผลช่วงค่าจากสเปรดชีต

update

ตั้งค่าในช่วงของสเปรดชีต