Method: spreadsheets.values.update

ตั้งค่าในช่วงของสเปรดชีต ผู้เรียกใช้ต้องระบุรหัสสเปรดชีต ช่วง และ valueInputOption

คำขอ HTTP

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

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

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

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

string

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

range

string

หมายเหตุ A1 ของค่าที่ต้องอัปเดต

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

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

enum (ValueInputOption)

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

includeValuesInResponse

boolean

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

responseValueRenderOption

enum (ValueRenderOption)

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

responseDateTimeRenderOption

enum (DateTimeRenderOption)

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

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

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

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

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีอินสแตนซ์ UpdateValuesResponse

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

ต้องใช้ขอบเขต OAuth อย่างใดอย่างหนึ่งต่อไปนี้

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/spreadsheets

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