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