Method: spreadsheets.get

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

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

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

  • ตั้งค่าพารามิเตอร์ของ URL includeGridData เป็น "จริง" หากมีการตั้งค่าฟิลด์มาสก์ไว้ ระบบจะไม่สนใจพารามิเตอร์ 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

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

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

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

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

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีอินสแตนซ์ 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

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