Method: spreadsheets.values.append

เพิ่มค่าต่อท้ายสเปรดชีต ระบบจะใช้ช่วงอินพุตเพื่อค้นหาข้อมูลที่มีอยู่และหา "ตาราง" ภายในช่วงนั้น ระบบจะเพิ่มค่าต่อท้ายแถวถัดไปของตาราง โดยเริ่มจากคอลัมน์แรกของตาราง ดูคำแนะนำและโค้ดตัวอย่างเพื่อดูรายละเอียดเฉพาะเกี่ยวกับวิธีตรวจหาตารางและเพิ่มข้อมูลต่อท้าย

ผู้โทรต้องระบุรหัสสเปรดชีต ช่วง และ valueInputOption valueInputOption จะควบคุมวิธีการเพิ่มข้อมูลอินพุตลงในชีตเท่านั้น (แบบคอลัมน์หรือแถว) โดยไม่ส่งผลต่อเซลล์ใดที่จะเริ่มเขียนข้อมูล

คำขอ HTTP

POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values/{range}:append

URL ใช้ไวยากรณ์การแปลง gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์
spreadsheetId

string

รหัสของสเปรดชีตที่จะอัปเดต

range

string

สัญกรณ์ A1 ของช่วงเพื่อค้นหาตารางข้อมูลแบบตรรกะ ระบบจะเพิ่มค่าต่อท้ายแถวสุดท้ายของตาราง

พารามิเตอร์การค้นหา

พารามิเตอร์
valueInputOption

enum (ValueInputOption)

วิธีตีความข้อมูลอินพุต

insertDataOption

enum (InsertDataOption)

วิธีแทรกข้อมูลอินพุต

includeValuesInResponse

boolean

กำหนดว่าการตอบกลับการอัปเดตควรรวมค่าของเซลล์ที่เพิ่มต่อท้ายหรือไม่ โดยค่าเริ่มต้น คำตอบจะไม่รวมค่าที่อัปเดต

responseValueRenderOption

enum (ValueRenderOption)

กำหนดว่าควรแสดงผลค่าในคำตอบอย่างไร ตัวเลือกการแสดงผลเริ่มต้นคือ FORMATTED_VALUE

responseDateTimeRenderOption

enum (DateTimeRenderOption)

กำหนดวิธีแสดงผลวันที่ เวลา และระยะเวลาในการตอบกลับ ระบบจะละเว้นค่านี้หาก responseValueRenderOption คือ FORMATTED_VALUE ตัวเลือกการแสดงผล dateTime ตามค่าเริ่มต้นคือ SERIAL_NUMBER

เนื้อหาของคำขอ

เนื้อความของคำขอมีอินสแตนซ์ของ ValueRange

เนื้อหาการตอบกลับ

คำตอบเมื่ออัปเดตช่วงของค่าในสเปรดชีต

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON
{
  "spreadsheetId": string,
  "tableRange": string,
  "updates": {
    object (UpdateValuesResponse)
  }
}
ช่อง
spreadsheetId

string

สเปรดชีตที่ใช้การอัปเดต

tableRange

string

ช่วง (ในรูปแบบ A1) ของตารางที่มีการต่อท้ายค่า (ก่อนที่จะมีการเพิ่มค่า) เว้นว่างไว้หากไม่พบตาราง

updates

object (UpdateValuesResponse)

ข้อมูลเกี่ยวกับการอัปเดตที่นำไปใช้

ขอบเขตการให้สิทธิ์

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