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)

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

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

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

วิธีการ

append

 เพิ่มค่าลงในสเปรดชีต

batchClear

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

batchClearByDataFilter

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

batchGet

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

batchGetByDataFilter

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

batchUpdate

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

batchUpdateByDataFilter

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

clear

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

get

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

update

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