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