- คำขอ HTTP
- พารามิเตอร์เส้นทาง
- พารามิเตอร์การค้นหา
- เนื้อความของคำขอ
- เนื้อหาการตอบกลับ
- ขอบเขตการให้สิทธิ์
- InsertDataOption
- ลองใช้งาน
เพิ่มค่าต่อท้ายสเปรดชีต ช่วงอินพุตนี้ใช้เพื่อค้นหาข้อมูลที่มีอยู่และค้นหา "ตาราง" ภายในช่วงดังกล่าว ระบบจะเพิ่มค่าไว้ในแถวถัดไปของตาราง โดยเริ่มจากคอลัมน์แรกของตาราง ดูรายละเอียดเกี่ยวกับวิธีตรวจหาตารางและผนวกข้อมูลได้ที่คู่มือและโค้ดตัวอย่าง
ผู้โทรต้องระบุรหัสสเปรดชีต ช่วง และvalueInputOption
valueInputOption
จะควบคุมเฉพาะวิธีเพิ่มข้อมูลลงในชีตเท่านั้น (ขึ้นอยู่กับคอลัมน์หรือแถว) โดยไม่มีผลกระทบต่อเซลล์ที่เริ่มเขียนข้อมูล
คำขอ HTTP
POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values/{range}:append
URL ใช้ไวยากรณ์ gRPC Transcoding
พารามิเตอร์เส้นทาง
พารามิเตอร์ | |
---|---|
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
สําหรับข้อมูลเพิ่มเติม โปรดดูคู่มือการให้สิทธิ์
ตัวเลือกการแทรกข้อมูล
กําหนดวิธีเปลี่ยนแปลงข้อมูลที่มีอยู่เมื่อมีการป้อนข้อมูลใหม่
Enum | |
---|---|
OVERWRITE |
ข้อมูลใหม่จะแทนที่ข้อมูลที่มีอยู่ในพื้นที่ที่เขียน (หมายเหตุ: การเพิ่มข้อมูลไว้ที่ท้ายแผ่นงานจะยังคงแทรกแถวหรือคอลัมน์ใหม่เพื่อให้สามารถเขียนข้อมูลได้) |
INSERT_ROWS |
ระบบจะแทรกแถวเพื่อดึงข้อมูลใหม่ |