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