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