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

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