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