Method: spreadsheets.values.get

แสดงผลช่วงค่าจากสเปรดชีต ผู้โทรต้องระบุรหัสสเปรดชีตและช่วง

คำขอ HTTP

GET https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values/{range}

URL ใช้ไวยากรณ์การแปลง gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์
spreadsheetId

string

รหัสของสเปรดชีตที่จะดึงข้อมูล
range

string

รูปแบบ A1 หรือรูปแบบ R1C1 ของช่วงที่จะดึงค่า

พารามิเตอร์การค้นหา

พารามิเตอร์
majorDimension

enum (Dimension)

มิติข้อมูลหลักที่ผลลัพธ์ควรใช้

ตัวอย่างเช่น หากข้อมูลสเปรดชีตในชีต 1 คือ A1=1,B1=2,A2=3,B2=4 การขอ range=Sheet1!A1:B2?majorDimension=ROWS จะแสดงผลเป็น [[1,2],[3,4]] ส่วนการขอ range=Sheet1!A1:B2?majorDimension=COLUMNS จะแสดงผลเป็น [[1,3],[2,4]]
valueRenderOption

enum (ValueRenderOption)

วิธีที่ควรแสดงค่าในเอาต์พุต ตัวเลือกการแสดงผลเริ่มต้นคือ FORMATTED_VALUE
dateTimeRenderOption

enum (DateTimeRenderOption)

วิธีที่ควรแสดงวันที่ เวลา และระยะเวลาในเอาต์พุต ระบบจะละเว้นค่านี้หาก valueRenderOption เป็น FORMATTED_VALUE ตัวเลือกการแสดงผล dateTime เริ่มต้นคือ SERIAL_NUMBER

เนื้อหาของคำขอ

เนื้อหาของคำขอต้องว่างเปล่า

เนื้อหาการตอบกลับ

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีอินสแตนซ์ ValueRange

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/spreadsheets
  • https://www.googleapis.com/auth/spreadsheets.readonly

ดูข้อมูลเพิ่มเติมได้ที่คู่มือการให้สิทธิ์