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

Google ชีต 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 แสดงถึงช่วงที่มีการป้องกัน

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