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