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

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

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

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

สเปรดชีต

ออบเจ็กต์หลักใน Google ชีต Sheets อาจมีได้หลายรายการ โดยแต่ละรายการจะมี Structured Data อยู่ใน 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 แถวแรกของชีต 1
  • Sheet1!A:A หมายถึงเซลล์ทั้งหมดในคอลัมน์แรกของชีต 1
  • Sheet1!1:2 หมายถึงเซลล์ทั้งหมดใน 2 แถวแรกของชีต 1
  • Sheet1!A5:A หมายถึงเซลล์ทั้งหมดในคอลัมน์แรกของชีต 1 ตั้งแต่แถวที่ 5 เป็นต้นไป
  • A1:B2 หมายถึงเซลล์ทั้งหมดในแถวและคอลัมน์ 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 อย่างไรก็ตาม หากมีช่วงที่มีชื่อชื่อ "ชีต 1" ชีต 1 จะอ้างอิงถึงช่วงที่มีชื่อ และ 'Sheet1' จะอ้างอิงถึงชีต
รูปแบบ R1C1
ไวยากรณ์ที่ใช้กำหนดเซลล์หรือช่วงของเซลล์ด้วยสตริงที่มีชื่อชีต รวมถึงพิกัดเซลล์เริ่มต้นและสิ้นสุดโดยใช้หมายเลขแถวและหมายเลขคอลัมน์ วิธีการนี้ไม่ค่อยพบบ่อยเท่ากับการเขียน A1 แต่อาจมีประโยชน์เมื่ออ้างอิงช่วงของเซลล์ที่สัมพันธ์กับตําแหน่งของเซลล์หนึ่งๆ

แสดงตัวอย่าง

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