แสดงผลสเปรดชีตตามรหัสที่ระบุ ผู้โทรต้องระบุรหัสสเปรดชีต
วิธีนี้จะแตกต่างจากสเปรดชีดตรงที่ช่วยให้คุณเลือกข้อมูลชุดย่อยที่จะส่งคืนโดยระบุพารามิเตอร์ dataFilters
ระบุ DataFilters
ได้หลายรายการ การระบุตัวกรองข้อมูลอย่างน้อย 1 รายการจะแสดงส่วนของสเปรดชีตที่ตัดกับช่วงที่ตรงกับตัวกรองใดก็ได้
โดยค่าเริ่มต้น จะไม่มีการส่งกลับข้อมูลภายในตารางกริด คุณสามารถรวมข้อมูลตารางกริดได้ด้วยวิธีใดวิธีหนึ่งจาก 2 วิธีนี้
ระบุมาสก์ของช่องที่แสดงรายการช่องที่คุณต้องการโดยใช้พารามิเตอร์ URL
fields
ใน HTTPตั้งค่าพารามิเตอร์
includeGridData
เป็น true หากมีการตั้งค่ามาสก์ของช่อง ระบบจะไม่สนใจพารามิเตอร์includeGridData
สําหรับสเปรดชีตขนาดใหญ่ แนวทางปฏิบัติที่ดีที่สุดคือการดึงข้อมูลเฉพาะช่องสเปรดชีตที่ต้องการ
คำขอ HTTP
POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}:getByDataFilter
URL ใช้ไวยากรณ์ gRPC Transcoding
พารามิเตอร์เส้นทาง
พารามิเตอร์ | |
---|---|
spreadsheetId |
สเปรดชีตที่จะร้องขอ |
เนื้อหาของคำขอ
เนื้อหาของคําขอมีข้อมูลที่มีโครงสร้างต่อไปนี้
การแสดง JSON |
---|
{
"dataFilters": [
{
object ( |
ช่อง | |
---|---|
dataFilters[] |
|
includeGridData |
เป็นจริงหากควรส่งคืนข้อมูลตารางกริด พารามิเตอร์นี้จะไม่มีผล หากตั้งค่ามาสก์ของช่องในคําขอ |
เนื้อหาการตอบกลับ
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีอินสแตนซ์ Spreadsheet
ขอบเขตการให้สิทธิ์
ต้องการขอบเขต OAuth อย่างใดอย่างหนึ่งต่อไปนี้
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/spreadsheets
สําหรับข้อมูลเพิ่มเติม โปรดดูคู่มือการให้สิทธิ์