- คำขอ HTTP
- พารามิเตอร์เส้นทาง
- เนื้อความของคำขอ
- เนื้อหาการตอบกลับ
- ขอบเขตการให้สิทธิ์
- MatchedValueRange
- ลองใช้งาน
แสดงผลช่วงของค่าที่ตรงกับตัวกรองข้อมูลที่ระบุอย่างน้อย 1 ช่วง ผู้โทรต้องระบุรหัสสเปรดชีตและ DataFilters
อย่างน้อย 1 รายการ ระบบจะแสดงผลช่วงที่ตรงกับตัวกรองข้อมูลใดก็ตามในคำขอ
คำขอ HTTP
POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchGetByDataFilter
URL ใช้ไวยากรณ์การแปลง gRPC
พารามิเตอร์เส้นทาง
พารามิเตอร์ | |
---|---|
spreadsheetId |
รหัสของสเปรดชีตที่จะดึงข้อมูล |
เนื้อหาของคำขอ
เนื้อหาของคำขอมีข้อมูลซึ่งมีโครงสร้างต่อไปนี้
การแสดง JSON |
---|
{ "dataFilters": [ { object ( |
ช่อง | |
---|---|
dataFilters[] |
ตัวกรองข้อมูลที่ใช้ในการจับคู่ช่วงของค่าที่จะดึง ช่วงที่ตรงกับตัวกรองข้อมูลที่ระบุจะรวมอยู่ในคำตอบ |
majorDimension |
มิติข้อมูลหลักที่ผลลัพธ์ควรใช้ ตัวอย่างเช่น หากข้อมูลสเปรดชีตคือ |
valueRenderOption |
ลักษณะการแสดงค่าในเอาต์พุต ตัวเลือกการแสดงผลเริ่มต้นคือ |
dateTimeRenderOption |
วิธีการแสดงวันที่ เวลา และระยะเวลาในเอาต์พุต ระบบจะไม่สนใจโค้ดนี้หาก |
เนื้อหาการตอบกลับ
คำตอบเมื่อเรียกค่ามากกว่า 1 ช่วงในสเปรดชีตที่ DataFilters
เลือกไว้
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้
การแสดง JSON |
---|
{
"spreadsheetId": string,
"valueRanges": [
{
object ( |
ช่อง | |
---|---|
spreadsheetId |
รหัสของสเปรดชีตที่มีการดึงข้อมูล |
valueRanges[] |
ค่าที่ขอซึ่งมีรายการตัวกรองข้อมูลที่ตรงกัน |
ขอบเขตการให้สิทธิ์
ต้องใช้ขอบเขต 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[] |
|