Method: spreadsheets.values.batchGetByDataFilter

แสดงผลช่วงค่าอย่างน้อย 1 ช่วงที่ตรงกับตัวกรองข้อมูลที่ระบุ ดูข้อมูลเพิ่มเติมได้ที่อ่าน เขียน และค้นหาข้อมูลเมตา

ผู้โทรต้องระบุรหัสสเปรดชีตและ DataFilters อย่างน้อย 1 รายการ ระบบจะแสดงผลช่วงที่ตรงกับตัวกรองข้อมูลใดๆ ในคำขอ

คำขอ HTTP

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

URL ใช้ไวยากรณ์การแปลงรหัส gRPC

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

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

string

รหัสของสเปรดชีตที่จะดึงข้อมูล

เนื้อความของคำขอ

เนื้อหาของคำขอมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON 
{
  "dataFilters": [
    {
      object (DataFilter)
    }
  ],
  "majorDimension": enum (Dimension),
  "valueRenderOption": enum (ValueRenderOption),
  "dateTimeRenderOption": enum (DateTimeRenderOption)
}
ช่อง
dataFilters[]

object (DataFilter)

ตัวกรองข้อมูลที่ใช้ในการจับคู่ช่วงของค่าที่จะดึงข้อมูล ช่วงที่ตรงกับตัวกรองข้อมูลที่ระบุจะรวมอยู่ในคำตอบ
majorDimension

enum (Dimension)

มิติข้อมูลหลักที่ผลลัพธ์ควรใช้

เช่น หากข้อมูลสเปรดชีตคือ A1=1,B1=2,A2=3,B2=4 คำขอที่เลือกช่วงนั้นและตั้งค่า majorDimension=ROWS จะแสดงผล [[1,2],[3,4]] ในขณะที่คำขอที่ตั้งค่า majorDimension=COLUMNS จะแสดงผล [[1,3],[2,4]]
valueRenderOption

enum (ValueRenderOption)

วิธีแสดงค่าในเอาต์พุต ตัวเลือกการแสดงผลเริ่มต้นคือ FORMATTED_VALUE
dateTimeRenderOption

enum (DateTimeRenderOption)

วิธีแสดงวันที่ เวลา และระยะเวลาในเอาต์พุต ระบบจะละเว้นพารามิเตอร์นี้หาก valueRenderOption เป็น FORMATTED_VALUE ตัวเลือกการแสดงผล dateTime เริ่มต้นคือ SERIAL_NUMBER

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

การตอบกลับเมื่อดึงค่ามากกว่า 1 ช่วงในสเปรดชีตที่เลือกโดย DataFilters

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON 
{
  "spreadsheetId": string,
  "valueRanges": [
    {
      object (MatchedValueRange)
    }
  ]
}
ช่อง
spreadsheetId

string

รหัสของสเปรดชีตที่ดึงข้อมูลมา
valueRanges[]

object (MatchedValueRange)

ค่าที่ขอพร้อมรายการตัวกรองข้อมูลที่ตรงกัน

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

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

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

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

MatchedValueRange

ช่วงค่าที่ตัวกรองข้อมูลอย่างน้อย 1 รายการจับคู่

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

object (ValueRange)

ค่าที่ DataFilter ตรงกัน
dataFilters[]

object (DataFilter)

DataFilters จากคำขอที่ตรงกับช่วงของค่า