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