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