ภาพรวมของ 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 แถวบนสุดของชีต1
  • Sheet1!A:A หมายถึงเซลล์ทั้งหมดในคอลัมน์แรกของชีต1
  • Sheet1!1:2 หมายถึงเซลล์ทั้งหมดใน 2 แถวแรกของชีต1
  • Sheet1!A5:A หมายถึงเซลล์ทั้งหมดของคอลัมน์แรกของชีต 1 ตั้งแต่แถว 5 เป็นต้นไป
  • A1:B2 หมายถึง 2 เซลล์แรกใน 2 แถวบนสุดของชีตแรกที่แสดง
  • Sheet1 หมายถึงเซลล์ทั้งหมดในชีต 1
  • 'My Custom Sheet'!A:A หมายถึงเซลล์ทั้งหมดในคอลัมน์แรกของชีตชื่อ "ชีตที่กําหนดเองของฉัน" จําเป็นต้องมีเครื่องหมายคําพูดแบบเดี่ยวสําหรับชื่อชีตที่มีการเว้นวรรค สัญลักษณ์พิเศษ หรือผสมอักขระที่เป็นตัวอักษรและตัวเลขคละกัน
  • 'My Custom Sheet' หมายถึงเซลล์ทั้งหมดใน "ชีตที่กําหนดเองของฉัน"

เคล็ดลับ: หากเป็นไปได้ ให้ใช้ชื่อที่แตกต่างกันสําหรับออบเจ็กต์ในสเปรดชีต เช่น A1 หมายถึงเซลล์ A1 ในชีตแรกที่เห็น ในขณะที่ "A1" หมายถึงเซลล์ทั้งหมดในชีตชื่อ A1 ในทํานองเดียวกัน Sheet1 หมายถึงเซลล์ทั้งหมดใน Sheet1 อย่างไรก็ตาม หากมีช่วงที่มีชื่อชื่อว่า "Sheet1" แผ่นงานที่ 1 จะอ้างถึงช่วงที่มีชื่อ และ "Sheet1" หมายถึงชีต
รูปแบบ R1C1

ไวยากรณ์ที่ใช้กําหนดเซลล์หรือช่วงของเซลล์ด้วยสตริงที่มีชื่อชีต พร้อมด้วยพิกัดเซลล์เริ่มต้นและจุดสิ้นสุดโดยใช้หมายเลขแถวและหมายเลขคอลัมน์ วิธีนี้พบได้น้อยกว่าหมายเหตุ A1 แต่จะมีประโยชน์เมื่ออ้างอิงช่วงของเซลล์ที่สัมพันธ์กับตําแหน่งของเซลล์ที่ระบุ

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

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

เซลล์ที่กําหนดหรือช่วงของเซลล์ที่มีชื่อที่กําหนดเองเพื่อให้การอ้างอิงทั่วทั้งแอปพลิเคชันง่ายขึ้น ทรัพยากร FilterView แสดงถึงช่วงที่มีชื่อ

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

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

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