Google Sheets API เป็นอินเทอร์เฟซ RESTful ที่ให้คุณอ่านและแก้ไขข้อมูลของสเปรดชีต การใช้งาน API นี้ที่พบบ่อยที่สุดได้แก่งานต่อไปนี้
- สร้างสเปรดชีต
- อ่านและเขียนค่าเซลล์ในสเปรดชีต
- อัปเดตการจัดรูปแบบสเปรดชีต
- จัดการชีตที่เชื่อมต่อ
ด้านล่างนี้เป็นรายการคำศัพท์ทั่วไปที่ใช้ใน Sheets API
- สเปรดชีต
ออบเจ็กต์หลักใน Google ชีตที่มีหลายชีต โดยแต่ละชีตมีข้อมูลที่มีโครงสร้างอยู่ในเซลล์ ทรัพยากรสเปรดชีตจะแทนสเปรดชีตทุกรายการและมีค่า
spreadsheetId
ที่ไม่ซ้ำกัน ได้แก่ ตัวอักษร ตัวเลข ขีดกลาง หรือขีดล่าง คุณจะพบรหัสของสเปรดชีตใน URL ของ Google ชีตดังนี้https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0
- ชีต
หน้าหรือแท็บภายในสเปรดชีต ทรัพยากรของชีตแสดงถึงแต่ละชีต รวมถึงมีชื่อและค่าตัวเลข
sheetId
ที่ไม่ซ้ำกัน คุณสามารถดูรหัสชีตได้ใน URL ของ Google ชีตโดยทำดังนี้https://docs.google.com/spreadsheets/d/aBC-123_xYz/edit#gid=sheetId
- เซลล์
ช่องข้อความหรือข้อมูลแต่ละช่องภายในชีต เซลล์จะจัดเรียงเป็นแถวและคอลัมน์ และสามารถจัดกลุ่มเป็นช่วงของเซลล์ได้ ทรัพยากร CellData แสดงถึงแต่ละเซลล์ แต่ไม่มีค่ารหัสที่ไม่ซ้ำกัน แต่จะเป็นพิกัดของแถว และคอลัมน์แทนเซลล์
- หมายเหตุ A1
ไวยากรณ์ที่ใช้กำหนดเซลล์หรือช่วงของเซลล์ด้วยสตริงที่มีชื่อชีต รวมถึงพิกัดเซลล์เริ่มต้นและสิ้นสุดโดยใช้ตัวอักษรประจำคอลัมน์และหมายเลขแถว วิธีนี้เป็นวิธีที่ใช้กันมากที่สุดและมีประโยชน์ เมื่ออ้างอิงช่วงเซลล์แบบสัมบูรณ์
แสดงตัวอย่าง
Sheet1!A1:B2
คือเซลล์ 2 เซลล์แรกใน Sheet1 2 แถวบนสุดSheet1!A:A
คือเซลล์ทั้งหมดในคอลัมน์แรกของ Sheet1Sheet1!1:2
คือเซลล์ทั้งหมดใน 2 แถวแรกของ Sheet1Sheet1!A5:A
หมายถึงทุกเซลล์ของคอลัมน์แรกของชีต 1 ตั้งแต่แถว 5 เป็นต้นไปA1:B2
คือเซลล์ 2 เซลล์แรกใน 2 แถวบนสุดของชีตแรกที่มองเห็นได้Sheet1
คือเซลล์ทั้งหมดใน Sheet1'My Custom Sheet'!A:A
คือเซลล์ทั้งหมดในคอลัมน์แรกของชีตชื่อ "ชีตที่กำหนดเองของฉัน" ต้องมีเครื่องหมายคำพูดเดี่ยวสำหรับชื่อแผ่นงานที่มีการเว้นวรรค สัญลักษณ์พิเศษ หรือชุดตัวอักษรและตัวเลข'My Custom Sheet'
อ้างอิงถึงเซลล์ทั้งหมดใน "ชีตที่กำหนดเองของฉัน"
เคล็ดลับ: หากเป็นไปได้ ให้ใช้ชื่อที่ไม่ซ้ำกันสำหรับออบเจ็กต์ภายในสเปรดชีต ตัวอย่างเช่น A1 หมายถึงเซลล์ A1 ในชีตแรกที่ปรากฏ ในขณะที่ "A1" หมายถึงเซลล์ทั้งหมดในชีตชื่อ A1 ในทำนองเดียวกัน Sheet1 จะหมายถึงเซลล์ทั้งหมดใน Sheet1 แต่หากมีช่วงที่ตั้งชื่อแล้วที่มีชื่อว่า "Sheet1" Sheet1 จะหมายถึงช่วงที่ตั้งชื่อแล้ว ขณะที่ "Sheet1" จะหมายถึงชีต
- หมายเหตุ R1C1
ไวยากรณ์ที่ใช้กำหนดเซลล์หรือช่วงของเซลล์ด้วยสตริงที่มีชื่อชีต รวมถึงพิกัดเซลล์เริ่มต้นและสิ้นสุดโดยใช้หมายเลขแถวและหมายเลขคอลัมน์ วิธีนี้พบน้อยกว่ารูปแบบ A1 แต่อาจมีประโยชน์เมื่ออ้างอิงช่วงของเซลล์ที่สัมพันธ์กับตำแหน่งของเซลล์ที่ระบุ
แสดงตัวอย่าง
Sheet1!R1C1:R2C2
คือเซลล์ 2 เซลล์แรกใน Sheet1 2 แถวบนสุดR1C1:R2C2
คือเซลล์ 2 เซลล์แรกใน 2 แถวบนสุดของชีตแรกที่มองเห็นได้Sheet1!R[3]C[1]
คือเซลล์ที่มี 3 แถวด้านล่างและ 1 คอลัมน์ทางด้านขวาของเซลล์ปัจจุบัน
- ช่วงที่ตั้งชื่อแล้ว
เซลล์หรือช่วงของเซลล์ที่กำหนดโดยใช้ชื่อที่กำหนดเองเพื่อลดความซับซ้อนของการอ้างอิงในแอปพลิเคชัน ทรัพยากรของFilterView จะแสดงช่วงที่ตั้งชื่อไว้
- ช่วงที่ป้องกันไว้
เซลล์หรือช่วงของเซลล์ที่กำหนดไว้ซึ่งปรับเปลี่ยนไม่ได้ ทรัพยากร ProtectedRange แสดงถึงช่วงที่ได้รับการป้องกัน
ขั้นตอนถัดไป
หากต้องการดูข้อมูลเกี่ยวกับการพัฒนาด้วย Google Workspace API รวมถึงการจัดการการตรวจสอบสิทธิ์และการให้สิทธิ์ โปรดดูหัวข้อพัฒนาบน Google Workspace
หากต้องการดูวิธีกำหนดค่าและเรียกใช้แอป Sheets API แบบง่าย โปรดอ่านภาพรวมของคู่มือเริ่มใช้งานฉบับย่อ