นอกเหนือจากข้อมูลค่าที่อยู่ในเซลล์แล้ว สเปรดชีตยังมี ข้อมูลประเภทอื่นๆ อีกมากมาย เช่น
- มิติข้อมูล
- รูปแบบและเส้นขอบของเซลล์
- ช่วงที่ตั้งชื่อแล้ว
- ช่วงที่ป้องกันไว้
- การจัดรูปแบบตามเงื่อนไข
ข้อมูลเหล่านี้เป็นข้อมูลหลายประเภทที่ควบคุมลักษณะและการทำงานของสเปรดชีต เมธอด spreadsheets.batchUpdate ช่วยให้คุณอัปเดตรายละเอียดสเปรดชีตเหล่านี้ได้ ระบบจะจัดกลุ่มการเปลี่ยนแปลงเป็นชุดเพื่อให้หากคำขอหนึ่งรายการไม่สำเร็จ ระบบจะไม่เขียนการเปลี่ยนแปลงอื่นๆ (ซึ่งอาจขึ้นอยู่กับคำขอแรก)
หน้านี้อธิบายพื้นฐานของการใช้
spreadsheets.batchUpdate
เมธอด หากต้องการอ่านและเขียนข้อมูลค่าของเซลล์ คุณยังใช้ทรัพยากร
spreadsheets.values
ที่อธิบายไว้ใน
อ่านและเขียนค่าของเซลล์ได้ด้วย
หมวดหมู่ของการดำเนินการ
การดำเนินการเฉพาะที่ spreadsheets.batchUpdate รองรับสามารถจัดกลุ่มได้เป็นหมวดหมู่กว้างๆ ดังนี้
| หมวดหมู่ | คำอธิบาย |
|---|---|
| เพิ่ม (และ ทำซ้ำ) | เพิ่มออบเจ็กต์ใหม่ (บางครั้งอิงตามออบเจ็กต์เก่า เช่น ในคำขอทำซ้ำ) |
| อัปเดต (และ ตั้งค่า) | อัปเดตพร็อพเพอร์ตี้บางอย่างของออบเจ็กต์ โดยปกติแล้วจะปล่อยให้พร็อพเพอร์ตี้เก่าไม่เปลี่ยนแปลง (ในขณะที่คำขอตั้งค่าจะเขียนทับข้อมูลก่อนหน้า) |
| ลบ | นำออบเจ็กต์ออก |
เราจะใช้หมวดหมู่เหล่านี้ในส่วนถัดไปเพื่ออธิบายลักษณะการทำงานของการดำเนินการที่เฉพาะเจาะจง
การอัปเดตเป็นกลุ่ม
เมธอด spreadsheets.batchUpdate ทำงานโดยรับออบเจ็กต์คำขออย่างน้อย 1 รายการ
Request
ซึ่งแต่ละรายการจะระบุคำขอประเภทเดียวที่จะดำเนินการ คำขอมีหลายประเภท ต่อไปนี้คือรายละเอียดประเภทคำขอที่จัดกลุ่มเป็นหมวดหมู่ต่างๆ
นอกจากนี้ยังมีคำขอเพิ่มเติมบางรายการที่จำลองการดำเนินการของผู้ใช้เพื่อจัดการข้อมูล ดังนี้
- AutoFillRequest
- CutPasteRequest
- CopyPasteRequest
- FindReplaceRequest
- PasteDataRequest
- TextToColumnsRequest
- SortRangeRequest
จำกัดสูงสุด
ดูข้อมูลเพิ่มเติมเกี่ยวกับขีดจำกัดของเซลล์และแถวใน Google ชีตได้ที่ ไฟล์ที่เก็บไว้ใน Google ไดรฟ์
ฟิลด์มาสก์
คำขอ "อัปเดต" หลายรายการต้องใช้ฟิลด์มาสก์ ซึ่งเป็นรายการฟิลด์ที่คั่นด้วยคอมมาเพื่ออัปเดตเฉพาะบางฟิลด์ในออบเจ็กต์โดยไม่เปลี่ยนแปลงฟิลด์อื่นๆ ระบบจะถือว่าฟิลด์มาสก์ * เป็นตัวแทนและเป็นคำย่อสำหรับการระบุทุกฟิลด์ในข้อความ (ซึ่งหมายความว่าฟิลด์อาจกลับไปเป็นสถานะเริ่มต้นหากคุณไม่ได้ระบุค่าสำหรับฟิลด์นั้นในคำขอ)
ดูข้อมูลเพิ่มเติมเกี่ยวกับฟิลด์มาสก์ได้ที่ ใช้ฟิลด์
มาสก์
ตัวอย่างต่อไปนี้ใช้
UpdateSpreadsheetPropertiesRequest
เพื่ออัปเดตเฉพาะชื่อของสเปรดชีต
คำขอ
POST .../v4/spreadsheets/spreadsheetId:batchUpdate
เนื้อหาคำขอ
{
"requests": [{
"updateSpreadsheetProperties": {
"properties": {"title": "TITLE"},
"fields": "title"
}
}]
}
แทนที่ TITLE ด้วยชื่อใหม่ของสเปรดชีต
คำตอบ
เมื่ออัปเดตสเปรดชีต คำขอบางประเภทอาจแสดงผลการตอบกลับ ระบบจะแสดงผลการตอบกลับเหล่านี้ในอาร์เรย์ โดยการตอบกลับแต่ละรายการจะอยู่ในดัชนีเดียวกับคำขอที่เกี่ยวข้อง คำขอบางรายการไม่มีการตอบกลับ และการตอบกลับสำหรับคำขอเหล่านั้นจะว่างเปล่า
โดยปกติแล้ว คำขอ "เพิ่ม" จะมีการตอบกลับที่แสดงผลข้อมูล เช่น รหัสของออบเจ็กต์ที่เพิ่ม ดูรายการการตอบกลับที่รองรับได้ที่ การตอบกลับ
ตัวอย่าง
ตัวอย่างโค้ดต่อไปนี้จะดำเนินการดังนี้
- อัปเดตชื่อของสเปรดชีตโดยใช้ตัวแปร
title - ค้นหาและแทนที่ค่าของเซลล์ในสเปรดชีตโดยใช้ตัวแปร
findและreplacement