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

Google Sheets API เป็นอินเทอร์เฟซ RESTful ที่ช่วยให้คุณอ่านและแก้ไขข้อมูลของสเปรดชีตได้ Sheets API ช่วยให้คุณทำสิ่งต่อไปนี้ได้

  • สร้างสเปรดชีต
  • อ่านและเขียนค่าในเซลล์ของสเปรดชีต
  • อัปเดตการจัดรูปแบบสเปรดชีต
  • จัดการชีตที่เชื่อมต่อ

ต่อไปนี้คือรายการคำศัพท์ที่ใช้กันโดยทั่วไปในชีต API

สเปรดชีต

ออบเจ็กต์หลักใน Google ชีต โดยอาจมี Sheets หลายรายการ ซึ่งแต่ละรายการ จะมีข้อมูลที่มีโครงสร้างอยู่ใน Cells ออบเจ็กต์ spreadsheets แสดงถึงสเปรดชีต โดยมีspreadsheetId ค่าที่ไม่ซ้ำกัน

รหัสสเปรดชีต
ตัวระบุที่ไม่ซ้ำกันสำหรับสเปรดชีต โดยเป็นสตริงเฉพาะที่มีตัวอักษร ตัวเลข และสัญลักษณ์พิเศษบางอย่างที่อ้างอิงถึงสเปรดชีต และสามารถดึงข้อมูลจาก URL ของสเปรดชีตได้ แม้ว่าชื่อสเปรดชีตจะเปลี่ยนไป แต่รหัสสเปรดชีตจะยังคงเดิม
https://docs.google.com/spreadsheets/d/SPREADSHEET_ID/edit?gid=SHEET_ID#gid=SHEET_ID
ชีต

หน้าหรือแท็บภายในสเปรดชีต แหล่งข้อมูล Sheets แสดงถึงชีต โดยจะมีค่า sheetId ที่เป็นตัวเลขที่ไม่ซ้ำกันและชีต title เป็นส่วนหนึ่งของออบเจ็กต์ SheetProperties

รหัสชีต
ตัวระบุที่ไม่ซ้ำกันสำหรับชีตที่เฉพาะเจาะจงภายในสเปรดชีต ซึ่งเป็นจำนวนเต็มเฉพาะที่มีตัวเลขที่อ้างอิงชีต และสามารถ ได้มาจาก URL ของสเปรดชีต รหัสชีตจะคงที่แม้ว่าชื่อชีตจะมีการเปลี่ยนแปลงก็ตาม ดูตัวอย่างได้ที่รหัสสเปรดชีต
เซลล์

ฟิลด์ข้อความหรือข้อมูลแต่ละรายการภายในชีต เซลล์จะจัดเรียงเป็นแถวและคอลัมน์ และจัดกลุ่มเป็นช่วงของเซลล์ได้ แหล่งข้อมูล Cells แสดงถึงแต่ละเซลล์ แต่ไม่มีค่ารหัสที่ไม่ซ้ำกัน แต่พิกัดแถวและคอลัมน์จะระบุเซลล์แทน

รูปแบบ A1
ไวยากรณ์ที่ใช้ในการกำหนดเซลล์หรือช่วงของเซลล์ด้วยสตริงที่มีชื่อชีต รวมถึงพิกัดของเซลล์เริ่มต้นและสิ้นสุดโดยใช้ตัวอักษรของคอลัมน์และหมายเลขแถว วิธีนี้เป็นวิธีที่ใช้กันมากที่สุดและมีประโยชน์ เมื่ออ้างอิงช่วงเซลล์แบบสัมบูรณ์
  • Sheet1!A1:B2 หมายถึงเซลล์ทั้งหมดใน 2 แถวและ 2 คอลัมน์แรกของชีต 1
  • Sheet1!A:A หมายถึงเซลล์ทั้งหมดในคอลัมน์แรกของชีต 1
  • Sheet1!1:2 หมายถึงเซลล์ทั้งหมดใน 2 แถวแรกของชีต 1
  • Sheet1!A5:A หมายถึงเซลล์ทั้งหมดในคอลัมน์แรกของชีต 1 ตั้งแต่แถว 5 เป็นต้นไป
  • A1:B2 หมายถึงเซลล์ทั้งหมดใน 2 แถวแรกและ 2 คอลัมน์แรกของชีตแรกที่มองเห็น
  • Sheet1 หมายถึงเซลล์ทั้งหมดในชีต1
  • 'Jon's_Data'!A1:D5 หมายถึงเซลล์ทั้งหมดใน 5 แถวแรกและ 4 คอลัมน์แรกของชีตชื่อ "Jon's_Data"
  • 'My Custom Sheet'!A:A หมายถึงเซลล์ทั้งหมดในคอลัมน์แรกของชีตที่ชื่อ "ชีตที่กำหนดเองของฉัน"
  • 'My Custom Sheet' หมายถึงเซลล์ทั้งหมดใน "ชีตที่กำหนดเองของฉัน"

ต้องใช้เครื่องหมายคำพูดเดี่ยวสำหรับชื่อชีตที่มีช่องว่างหรืออักขระพิเศษ

เคล็ดลับ: ใช้ชื่อที่แตกต่างกันสำหรับออบเจ็กต์ในสเปรดชีตเมื่อเป็นไปได้ เช่น A1 (ไม่มีเครื่องหมายคำพูด) หมายถึงเซลล์ A1 ในชีตแรกที่มองเห็น 'A1' หมายถึงชีตที่มีชื่อว่า A1 ในทำนองเดียวกัน Sheet1 จะอ้างอิงถึงชีตที่มีชื่อว่า Sheet1 อย่างไรก็ตาม หากมีช่วงที่ตั้งชื่อว่า "Sheet1" แล้ว Sheet1 จะอ้างอิงถึงช่วงที่ตั้งชื่อ และ 'Sheet1' จะอ้างอิงถึงชีต

รูปแบบ R1C1
ไวยากรณ์ที่ใช้ในการกำหนดเซลล์หรือช่วงของเซลล์ด้วยสตริงที่มีชื่อชีต พร้อมพิกัดเซลล์เริ่มต้นและสิ้นสุดโดยใช้ หมายเลขแถวและหมายเลขคอลัมน์ วิธีนี้พบได้น้อยกว่ารูปแบบ A1 แต่ก็มีประโยชน์เมื่ออ้างอิงช่วงของเซลล์ที่สัมพันธ์กับตำแหน่งของเซลล์ที่กำหนด
  • Sheet1!R1C1:R2C2 หมายถึง 2 เซลล์แรกใน 2 แถวแรกของชีต 1
  • R1C1:R2C2 หมายถึง 2 เซลล์แรกใน 2 แถวแรกของชีตแรกที่มองเห็น
  • Sheet1!R[3]C[1] หมายถึงเซลล์ที่อยู่ 3 แถวด้านล่างและ 1 คอลัมน์ทางขวาของเซลล์ปัจจุบัน
ช่วงที่ตั้งชื่อแล้ว
เซลล์หรือช่วงของเซลล์ที่กำหนดซึ่งมีชื่อที่กำหนดเองเพื่อลดความซับซ้อนของการอ้างอิง ในแอปพลิเคชัน ทรัพยากร A FilterView แสดงถึงช่วงที่มีชื่อ
ช่วงที่ป้องกันไว้
เซลล์หรือช่วงของเซลล์ที่กำหนดไว้ซึ่งแก้ไขไม่ได้ ทรัพยากร A ProtectedRange แสดงช่วงที่ป้องกันไว้