ส่วนนี้จะกล่าวถึง Codelab ที่คุณใช้เพื่อทำความคุ้นเคยกับ Google Sheets API นอกจากนี้ยังมีชุดตัวอย่าง "สูตรอาหาร" ที่สาธิตวิธีแปลการดำเนินการที่ต้องการใน Google ชีตเป็นคำขอ API
บ่อยครั้งที่มีวิธีการมากกว่า 1 วิธีในการทำงานหนึ่งๆ ให้เสร็จสมบูรณ์ด้วย API เมื่อคุณตัดสินใจเลือกวิธีทำงานหนึ่งๆ โปรดคำนึงถึงสิ่งต่อไปนี้
- หากต้องการอ่านหรือเขียนค่าเซลล์ คอลเล็กชัน
spreadsheets.values
จะเป็นตัวเลือกที่ดีกว่าคอลเล็กชันspreadsheets
อินเทอร์เฟซเดิมใช้งานได้ง่ายขึ้นสำหรับการดำเนินการอ่าน/เขียนแบบง่าย หากเป็นไปได้ ให้ใช้วิธีแบบกลุ่ม (
spreadsheet.batchUpdate
,spreadsheet.values.batchGet
, และspreadsheet.values.batchUpdate
) เพื่อรวมคำขอหลายรายการไว้ในการเรียกใช้เมธอดเดียว การใช้วิธีแบบกลุ่มเหล่านี้จะช่วยปรับปรุงประสิทธิภาพได้ ดังนี้- ลดโอเวอร์เฮดของ HTTP ของไคลเอ็นต์
- ลดจำนวนการค้นหาที่สร้างขึ้น
- ลดจำนวนการแก้ไขในเอกสาร
- ตรวจสอบว่าการเปลี่ยนแปลงทั้งหมดในกลุ่มมีความสมบูรณ์
สูตรอาหาร
ตัวอย่างที่แสดงในส่วนนี้จะแสดงวิธีแสดงการดำเนินการทั่วไปในชีตเป็นคำขอ Sheets API v4
ตัวอย่างเหล่านี้มาในรูปแบบคำขอ HTTP ควรเป็นกลางทางภาษา หากต้องการดูวิธีใช้โปรโตคอลคำขอชีต API ในบางภาษาโดยใช้ไลบรารีของไคลเอ็นต์ Google API โปรดดูคู่มืออ่านและเขียนค่าของเซลล์และอัปเดตสเปรดชีต
สูตรอาหารในส่วนนี้แบ่งออกเป็นหมวดหมู่ต่อไปนี้
- การอ่านค่าพื้นฐาน - สูตรอาหารที่แสดงวิธีอ่านค่าจากชีต
- การเขียนพื้นฐาน - สูตรอาหารที่แสดงวิธีเขียนค่าลงในชีต
- การจัดรูปแบบพื้นฐาน - สูตรอาหารที่แสดงวิธีเปลี่ยนรูปลักษณ์ของชีตและเซลล์
- แผนภูมิ - สูตรอาหารที่แสดงวิธีสร้างและแก้ไขแผนภูมิในชีต
- การจัดรูปแบบตามเงื่อนไข - สูตรอาหารที่แสดงวิธีเปลี่ยนรูปลักษณ์ของเซลล์ตามเงื่อนไข
- การดำเนินการเกี่ยวกับข้อมูล - สูตรอาหารที่แสดงวิธีสร้าง ย้าย และจัดการข้อมูลในสเปรดชีต
- ช่วงที่ตั้งชื่อและป้องกัน - สูตรอาหารที่แสดงวิธีสร้าง อัปเดต และนำช่วงที่ตั้งชื่อและป้องกันไว้ในสเปรดชีตออก
- ตาราง Pivot - สูตรอาหารที่แสดงวิธีสร้างตาราง Pivot ในชีต
- การดำเนินการเกี่ยวกับแถวและคอลัมน์ - สูตรอาหารที่แสดงวิธีเพิ่ม นำออก และย้ายแถวและคอลัมน์ รวมถึงอัปเดตพร็อพเพอร์ตี้
- การดำเนินการของชีต - สูตรอาหารที่แสดงวิธีสร้าง ล้าง คัดลอก และลบชีต ตลอดจนควบคุมพร็อพเพอร์ตี้ของชีต