Method: spreadsheets.get

แสดงผลสเปรดชีตที่มีรหัสที่ระบุ ผู้เรียกต้องระบุรหัสสเปรดชีต

โดยค่าเริ่มต้น ระบบจะไม่แสดงข้อมูลภายในตารางกริด คุณรวมข้อมูลตารางกริดได้ 2 วิธีดังนี้

  • ระบุ มาสก์ฟิลด์ที่แสดงรายการฟิลด์ที่ต้องการโดยใช้พารามิเตอร์ URL fields ใน HTTP

  • ตั้งค่าพารามิเตอร์ includeGridData URL เป็น "จริง" หากตั้งค่ามาสก์ฟิลด์ไว้ ระบบจะไม่สนใจพารามิเตอร์ includeGridData

สําหรับสเปรดชีตขนาดใหญ่ แนวทางปฏิบัติแนะนําคือดึงเฉพาะช่องสเปรดชีตที่ต้องการ

หากต้องการดึงข้อมูลสเปรดชีตชุดย่อยเท่านั้น ให้ใช้พารามิเตอร์ของ URL ranges ระบุช่วงโดยใช้รูปแบบ A1 คุณสามารถกําหนดเซลล์เดียว (เช่น A1) หรือหลายเซลล์ (เช่น A1:D5) นอกจากนี้ คุณยังรับเซลล์จากชีตอื่นๆ ภายในสเปรดชีตเดียวกัน (เช่น Sheet2!A1:C4) หรือดึงข้อมูลหลายช่วงพร้อมกันได้ด้วย (เช่น ?ranges=A1:D5&ranges=Sheet2!A1:C4) การจํากัดช่วงจะแสดงเฉพาะส่วนของสเปรดชีตที่ตัดกับช่วงที่คุณขอ

คำขอ HTTP

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

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

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

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

string

สเปรดชีตที่จะขอ

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

พารามิเตอร์
ranges[]

string

ช่วงที่จะนำข้อมูลจากสเปรดชีต
includeGridData

boolean

จริงหากต้องการให้แสดงข้อมูลตารางกริด ระบบจะละเว้นพารามิเตอร์นี้หากมีการตั้งค่ามาสก์ช่องในคําขอ
excludeTablesInBandedRanges

boolean

จริงหากต้องการยกเว้นตารางในแถบ เท็จหากไม่ได้ตั้งค่า

เนื้อความของคำขอ

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

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

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

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

ต้องใช้ขอบเขต 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

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