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

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

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

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

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