นอกเหนือจากข้อมูลค่าที่อยู่ในเซลล์แล้ว สเปรดชีตยังมีข้อมูลประเภทอื่นๆ อีกมากมาย เช่น
- ขนาด
- รูปแบบและเส้นขอบของเซลล์
- ช่วงที่ตั้งชื่อ
- ช่วงที่ป้องกันไว้
- การจัดรูปแบบตามเงื่อนไข
ข้อมูลเหล่านี้เป็นเพียงข้อมูลบางส่วนในจำนวนมากมายที่ควบคุมลักษณะที่ปรากฏและการดำเนินการของสเปรดชีต เมธอด spreadsheets.batchUpdate
ช่วยให้คุณอัปเดตรายละเอียดสเปรดชีตเหล่านี้ได้ ระบบจะจัดกลุ่มการเปลี่ยนแปลงเป็นกลุ่มเพื่อให้หากคำขอรายการใดรายการหนึ่งไม่สำเร็จ ระบบจะไม่เขียนการเปลี่ยนแปลงอื่นๆ (ที่อาจเกี่ยวข้อง)
หน้านี้อธิบายพื้นฐานของการใช้วิธี spreadsheets.batchUpdate
หากต้องการอ่านและเขียนข้อมูลค่าเซลล์ คุณก็ใช้แหล่งข้อมูลใน spreadsheets.values
ที่อธิบายไว้ในอ่านและเขียนค่าเซลล์ได้เช่นกัน
หมวดหมู่ของการดำเนินการ
การดำเนินการบางอย่างที่ spreadsheets.batchUpdate
รองรับสามารถแบ่งออกเป็นหมวดหมู่กว้างๆ ต่อไปนี้
หมวดหมู่ | คำอธิบาย |
---|---|
เพิ่ม (และทำซ้ำ) | เพิ่มออบเจ็กต์ใหม่ (บางครั้งจะอิงตามออบเจ็กต์เก่า เช่น คำขอที่ซ้ำกัน) |
อัปเดต (และตั้งค่า) | อัปเดตพร็อพเพอร์ตี้บางอย่างของออบเจ็กต์ โดยปกติจะปล่อยพร็อพเพอร์ตี้เก่าไว้ (ในขณะที่คำขอ Set จะเขียนทับข้อมูลก่อนหน้า) |
ลบ | นำวัตถุออก |
ระบบจะใช้หมวดหมู่เหล่านี้ในส่วนถัดไปเพื่ออธิบายลักษณะการทํางานของการดำเนินการที่เฉพาะเจาะจง
การดำเนินการอัปเดตเป็นกลุ่ม
เมธอด spreadsheets.batchUpdate
จะทํางานโดยรับออบเจ็กต์ Request อย่างน้อย 1 รายการ โดยแต่ละรายการจะระบุคําขอประเภทเดียวที่จะดําเนินการ คำขอมีหลายประเภท รายละเอียดเกี่ยวกับประเภทคำขอที่จัดกลุ่มเป็นหมวดหมู่ต่างๆ มีดังนี้
นอกจากนี้ยังมีคำขอเพิ่มเติมที่เลียนแบบการดําเนินการของผู้ใช้เพื่อจัดการข้อมูล
- 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