Method: spreadsheets.values.append

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

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

คำขอ HTTP

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

URL ใช้ไวยากรณ์ gRPC Transcoding

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

พารามิเตอร์
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

สําหรับข้อมูลเพิ่มเติม โปรดดูคู่มือการให้สิทธิ์

ตัวเลือกการแทรกข้อมูล

กําหนดวิธีเปลี่ยนแปลงข้อมูลที่มีอยู่เมื่อมีการป้อนข้อมูลใหม่

Enum
OVERWRITE ข้อมูลใหม่จะแทนที่ข้อมูลที่มีอยู่ในพื้นที่ที่เขียน (หมายเหตุ: การเพิ่มข้อมูลไว้ที่ท้ายแผ่นงานจะยังคงแทรกแถวหรือคอลัมน์ใหม่เพื่อให้สามารถเขียนข้อมูลได้)
INSERT_ROWS ระบบจะแทรกแถวเพื่อดึงข้อมูลใหม่