- คำขอ HTTP
- พารามิเตอร์เส้นทาง
- พารามิเตอร์การค้นหา
- เนื้อความของคำขอ
- เนื้อหาการตอบกลับ
- ขอบเขตการให้สิทธิ์
- ลองใช้งาน
แสดงผลช่วงค่าจากสเปรดชีตอย่างน้อย 1 ช่วง ผู้เรียกใช้ต้องระบุรหัสสเปรดชีตและช่วงอย่างน้อย 1 ช่วง
คำขอ HTTP
GET https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchGet
URL ใช้ไวยากรณ์การแปลง gRPC
พารามิเตอร์เส้นทาง
พารามิเตอร์ | |
---|---|
spreadsheetId |
รหัสของสเปรดชีตที่จะดึงข้อมูล |
พารามิเตอร์การค้นหา
พารามิเตอร์ | |
---|---|
ranges[] |
รูปแบบ A1 หรือ R1C1 ของช่วงที่จะดึงค่ามา |
majorDimension |
มิติข้อมูลหลักที่ผลลัพธ์ควรใช้ เช่น หากข้อมูลสเปรดชีตคือ |
valueRenderOption |
ลักษณะการแสดงค่าในเอาต์พุต ตัวเลือกการแสดงผลเริ่มต้นคือ |
dateTimeRenderOption |
วิธีการแสดงวันที่ เวลา และระยะเวลาในเอาต์พุต ระบบจะไม่สนใจโค้ดนี้หาก |
เนื้อหาของคำขอ
เนื้อหาของคำขอต้องว่างเปล่า
เนื้อหาการตอบกลับ
คำตอบเมื่อเรียกช่วงค่ามากกว่า 1 ช่วงในสเปรดชีต
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้
การแสดง JSON |
---|
{
"spreadsheetId": string,
"valueRanges": [
{
object ( |
ช่อง | |
---|---|
spreadsheetId |
รหัสของสเปรดชีตที่มีการดึงข้อมูล |
valueRanges[] |
ค่าที่ขอ ลำดับของ ValueRanges จะเหมือนกับลำดับของช่วงที่ขอ |
ขอบเขตการให้สิทธิ์
ต้องใช้ขอบเขต OAuth อย่างใดอย่างหนึ่งต่อไปนี้
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/spreadsheets
https://www.googleapis.com/auth/spreadsheets.readonly
โปรดดูข้อมูลเพิ่มเติมที่คู่มือการให้สิทธิ์