- คำขอ HTTP
- พารามิเตอร์เส้นทาง
- พารามิเตอร์การค้นหา
- เนื้อความของคำขอ
- เนื้อหาการตอบกลับ
- ขอบเขตการให้สิทธิ์
- InsertDataOption
- ลองใช้งาน
เพิ่มค่าต่อท้ายสเปรดชีต ระบบจะใช้ช่วงอินพุตเพื่อค้นหาข้อมูลที่มีอยู่และหา "ตาราง" ภายในช่วงนั้น ระบบจะเพิ่มค่าต่อท้ายแถวถัดไปของตาราง โดยเริ่มจากคอลัมน์แรกของตาราง ดูคำแนะนำและโค้ดตัวอย่างเพื่อดูรายละเอียดเฉพาะเกี่ยวกับวิธีตรวจหาตารางและเพิ่มข้อมูลต่อท้าย
ผู้โทรต้องระบุรหัสสเปรดชีต ช่วง และ valueInputOption
valueInputOption
จะควบคุมวิธีการเพิ่มข้อมูลอินพุตลงในชีตเท่านั้น (แบบคอลัมน์หรือแถว) โดยไม่ส่งผลต่อเซลล์ใดที่จะเริ่มเขียนข้อมูล
คำขอ HTTP
POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values/{range}:append
URL ใช้ไวยากรณ์การแปลง gRPC
พารามิเตอร์เส้นทาง
พารามิเตอร์ | |
---|---|
spreadsheetId |
รหัสของสเปรดชีตที่จะอัปเดต |
range |
สัญกรณ์ A1 ของช่วงเพื่อค้นหาตารางข้อมูลแบบตรรกะ ระบบจะเพิ่มค่าต่อท้ายแถวสุดท้ายของตาราง |
พารามิเตอร์การค้นหา
พารามิเตอร์ | |
---|---|
valueInputOption |
วิธีตีความข้อมูลอินพุต |
insertDataOption |
วิธีแทรกข้อมูลอินพุต |
includeValuesInResponse |
กำหนดว่าการตอบกลับการอัปเดตควรรวมค่าของเซลล์ที่เพิ่มต่อท้ายหรือไม่ โดยค่าเริ่มต้น คำตอบจะไม่รวมค่าที่อัปเดต |
responseValueRenderOption |
กำหนดว่าควรแสดงผลค่าในคำตอบอย่างไร ตัวเลือกการแสดงผลเริ่มต้นคือ |
responseDateTimeRenderOption |
กำหนดวิธีแสดงผลวันที่ เวลา และระยะเวลาในการตอบกลับ ระบบจะละเว้นค่านี้หาก |
เนื้อหาของคำขอ
เนื้อความของคำขอมีอินสแตนซ์ของ ValueRange
เนื้อหาการตอบกลับ
คำตอบเมื่ออัปเดตช่วงของค่าในสเปรดชีต
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้
การแสดง JSON |
---|
{
"spreadsheetId": string,
"tableRange": string,
"updates": {
object ( |
ช่อง | |
---|---|
spreadsheetId |
สเปรดชีตที่ใช้การอัปเดต |
tableRange |
ช่วง (ในรูปแบบ A1) ของตารางที่มีการต่อท้ายค่า (ก่อนที่จะมีการเพิ่มค่า) เว้นว่างไว้หากไม่พบตาราง |
updates |
ข้อมูลเกี่ยวกับการอัปเดตที่นำไปใช้ |
ขอบเขตการให้สิทธิ์
ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/spreadsheets
สำหรับข้อมูลเพิ่มเติม โปรดดูที่คู่มือการให้สิทธิ์
InsertDataOption
กำหนดว่าข้อมูลที่มีอยู่จะเปลี่ยนแปลงอย่างไรเมื่อมีการป้อนข้อมูลใหม่
Enum | |
---|---|
OVERWRITE |
ข้อมูลใหม่จะเขียนทับข้อมูลที่มีอยู่ในพื้นที่ที่เขียนขึ้น (หมายเหตุ: การเพิ่มข้อมูลต่อท้ายชีตจะเป็นการแทรกแถวหรือคอลัมน์ใหม่เพื่อให้เขียนข้อมูลได้) |
INSERT_ROWS |
ระบบจะแทรกแถวสำหรับข้อมูลใหม่ |