- คำขอ HTTP
- พารามิเตอร์เส้นทาง
- พารามิเตอร์การค้นหา
- เนื้อความของคำขอ
- เนื้อหาการตอบกลับ
- ขอบเขตการให้สิทธิ์
- ลองใช้งาน
แสดงผลสเปรดชีตตามรหัสที่ระบุ ผู้โทรต้องระบุรหัสสเปรดชีต
โดยค่าเริ่มต้น จะไม่มีการส่งกลับข้อมูลภายในตารางกริด คุณเพิ่มข้อมูลตารางกริดได้ด้วย 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 |
สเปรดชีตที่จะร้องขอ |
พารามิเตอร์การค้นหา
พารามิเตอร์ | |
---|---|
ranges[] |
ช่วงที่จะเรียกข้อมูลจากสเปรดชีต |
includeGridData |
เป็นจริงหากควรส่งคืนข้อมูลตารางกริด พารามิเตอร์นี้จะไม่มีผล หากตั้งค่ามาสก์ของช่องในคําขอ |
เนื้อหาของคำขอ
เนื้อหาของคำขอต้องว่างเปล่า
เนื้อหาการตอบกลับ
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีอินสแตนซ์ 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
สําหรับข้อมูลเพิ่มเติม โปรดดูคู่มือการให้สิทธิ์