Method: spreadsheets.getByDataFilter

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

วิธีนี้จะแตกต่างจากสเปรดชีดตรงที่ช่วยให้คุณเลือกข้อมูลชุดย่อยที่จะส่งคืนโดยระบุพารามิเตอร์ dataFilters ระบุ DataFilters ได้หลายรายการ การระบุตัวกรองข้อมูลอย่างน้อย 1 รายการจะแสดงส่วนของสเปรดชีตที่ตัดกับช่วงที่ตรงกับตัวกรองใดก็ได้

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

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

  • ตั้งค่าพารามิเตอร์ includeGridData เป็น true หากมีการตั้งค่ามาสก์ของช่อง ระบบจะไม่สนใจพารามิเตอร์ includeGridData

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

คำขอ HTTP

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

URL ใช้ไวยากรณ์ gRPC Transcoding

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

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

string

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

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

เนื้อหาของคําขอมีข้อมูลที่มีโครงสร้างต่อไปนี้

การแสดง JSON 
{
  "dataFilters": [
    {
      object (DataFilter)
    }
  ],
  "includeGridData": boolean
}
ช่อง
dataFilters[]

object (DataFilter)

DataFilters ที่ใช้เพื่อเลือกช่วงที่จะดึงข้อมูลจากสเปรดชีต
includeGridData

boolean

เป็นจริงหากควรส่งคืนข้อมูลตารางกริด พารามิเตอร์นี้จะไม่มีผล หากตั้งค่ามาสก์ของช่องในคําขอ

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

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

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

ต้องการขอบเขต OAuth อย่างใดอย่างหนึ่งต่อไปนี้

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/spreadsheets

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