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)

ข้อมูลที่อ่านแล้วหรือต้องเขียน นี่คืออาร์เรย์ของอาร์เรย์ ซึ่งเป็นอาร์เรย์ภายนอกที่แสดงข้อมูลทั้งหมด และอาร์เรย์ภายในแต่ละอาร์เรย์แสดงมิติข้อมูลหลัก แต่ละรายการในอาร์เรย์ภายในจะสอดคล้องกับเซลล์เดียว

สำหรับเอาต์พุต จะไม่รวมแถวและคอลัมน์ต่อท้ายที่ว่างเปล่า

ประเภทค่าที่รองรับสำหรับอินพุต ได้แก่ bool, string และ double ระบบจะข้ามค่า Null หากต้องการตั้งค่าเซลล์ให้เป็นค่าว่าง ให้ตั้งค่าสตริงเป็นสตริงว่างเปล่า

วิธีการ

append

เพิ่มค่าต่อท้ายสเปรดชีต

batchClear

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

batchClearByDataFilter

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

batchGet

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

batchGetByDataFilter

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

batchUpdate

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

batchUpdateByDataFilter

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

clear

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

get

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

update

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