ภาพรวมของ Google Sheets API

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 เซลล์แรกใน 2 แถวบนสุดของ Sheet1
  • Sheet1!A:A หมายถึงเซลล์ทั้งหมดในคอลัมน์แรกของ Sheet1
  • Sheet1!1:2 จะหมายถึงเซลล์ทั้งหมดใน 2 แถวแรกของ Sheet1
  • Sheet1!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 เซลล์แรกใน 2 แถวบนสุดของ Sheet1
  • R1C1:R2C2 หมายถึง 2 เซลล์แรกใน 2 แถวบนสุดของชีตแรกที่มองเห็น
  • Sheet1!R[3]C[1] หมายถึงเซลล์ที่อยู่ด้านล่าง 3 แถว และ 1 คอลัมน์ทางด้านขวาของเซลล์ปัจจุบัน
ช่วงที่ตั้งชื่อแล้ว

เซลล์หรือช่วงของเซลล์ที่กำหนดไว้โดยใช้ชื่อที่กำหนดเองเพื่อลดความซับซ้อน อ้างอิงตลอดแอปพลิเคชัน ต ทรัพยากรของFilterView แสดงช่วงที่ตั้งชื่อแล้ว

ช่วงที่ป้องกันไว้

เซลล์หรือช่วงของเซลล์ที่กำหนดซึ่งแก้ไขไม่ได้ ต ทรัพยากร ProtectedRange แสดงช่วงที่ป้องกันไว้

ขั้นตอนถัดไป

  • เพื่อเรียนรู้เกี่ยวกับการพัฒนาซอฟต์แวร์ด้วย Google Workspace API ซึ่งรวมถึงการจัดการ การตรวจสอบสิทธิ์และการให้สิทธิ์อ้างอิงถึง พัฒนาบน Google Workspace

  • หากต้องการดูวิธีกำหนดค่าและเรียกใช้แอป Sheets API อย่างง่าย โปรดอ่าน ภาพรวมคู่มือเริ่มใช้งานฉบับย่อ