Method: spreadsheets.values.update

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

คำขอ HTTP

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

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

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

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

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