- คำขอ 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 |
ระบบจะแทรกแถวสําหรับข้อมูลใหม่ |