Method: spreadsheets.get

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

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

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

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

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

พารามิเตอร์
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

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