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