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