API ของ Google สไลด์ช่วยให้คุณสร้างและแก้ไขงานนำเสนอ Google สไลด์ได้
แอปต่างๆ สามารถผสานการทำงานร่วมกับ Google สไลด์ API เพื่อสร้างชุดสไลด์ที่สวยงามได้โดยอัตโนมัติจากข้อมูลที่ได้จากผู้ใช้และระบบ เช่น คุณสามารถใช้รายละเอียดของลูกค้าจากฐานข้อมูลและรวมกับเทมเพลตที่ออกแบบไว้ล่วงหน้าและตัวเลือกการกำหนดค่าที่เลือกไว้เพื่อสร้างงานนำเสนอที่เสร็จแล้ว โดยใช้เพียงส่วนน้อยที่ต้องใช้ในการสร้างงานนำเสนอด้วยตนเอง
ภาพรวมของ API
คอลเล็กชันงานนำเสนอมีวิธีให้คุณรับและอัปเดตองค์ประกอบภายในงานนำเสนอ
งานส่วนใหญ่ที่คุณทำกับ Slides API อาจเป็นการสร้างและอัปเดตงานนำเสนอ โดยใช้เมธอด batchUpdate โดยวิธีนี้จะใช้รายการออบเจ็กต์คำขอที่ให้คุณทำสิ่งต่างๆ เช่น
- สร้างสไลด์
- เพิ่มองค์ประกอบในสไลด์ เช่น รูปร่างหรือตาราง
- แทรก เปลี่ยน และนําข้อความออก
- ใช้การเปลี่ยนรูปแบบกับองค์ประกอบ
- เปลี่ยนลำดับของสไลด์
ดูรายละเอียดเพิ่มเติมในการอัปเดตเป็นกลุ่ม โปรดดูคู่มือเริ่มต้นใช้งานสำหรับตัวอย่างแบบง่ายๆ ตั้งแต่ต้นจนจบของวิธีใช้ API
โครงสร้างของงานนำเสนอ
งานนำเสนอใน Slides API ประกอบด้วยหน้าต่างๆ ซึ่งมีองค์ประกอบของหน้า
รหัสของงานนำเสนอสามารถดึงมาจาก URL:
https://docs.google.com/presentation/d/presentationId/edit
รหัสงานนำเสนอเป็นสตริงที่ประกอบด้วยตัวอักษร ตัวเลข และสัญลักษณ์พิเศษบางตัว คุณใช้นิพจน์ทั่วไปต่อไปนี้เพื่อดึงรหัสงานนำเสนอจาก URL ของ Google ชีตได้
/presentation/d/([a-zA-Z0-9-_]+)
หากคุณคุ้นเคยกับ Drive API แล้ว presentationId
จะสอดคล้องกับรหัสของทรัพยากร File
หน้าและองค์ประกอบของหน้าได้รับการระบุโดยรหัสออบเจ็กต์
Pages
Google สไลด์มีหน้าประเภทต่อไปนี้
ปริญญาโท | สไลด์โฆษณาหลักจะกำหนดรูปแบบข้อความ พื้นหลัง และองค์ประกอบของหน้าเริ่มต้นที่ปรากฏในสไลด์ทั้งหมดที่ใช้ต้นฉบับนี้ ควรเพิ่มองค์ประกอบของหน้าที่ต้องปรากฏบนสไลด์ทั้งหมดลงในต้นฉบับ งานนำเสนอส่วนใหญ่มีต้นแบบ 1 รายการ แต่บางงานนำเสนออาจมีหลายรายการหรือไม่มีเลย |
เลย์เอาต์ | เลย์เอาต์ทำหน้าที่เป็นเทมเพลตสำหรับการจัดเรียงองค์ประกอบของหน้าโดยค่าเริ่มต้นในสไลด์โดยใช้เลย์เอาต์ แต่ละเลย์เอาต์จะเชื่อมโยงกับต้นฉบับ 1 รายการ |
สไลด์ | หน้าเหล่านี้มีเนื้อหาที่คุณกำลังนำเสนอต่อผู้ชม สไลด์ส่วนใหญ่จะใช้ต้นฉบับและเลย์เอาต์ คุณระบุได้ว่าจะใช้เลย์เอาต์ใดสำหรับแต่ละสไลด์เมื่อสร้างสไลด์ดังกล่าว |
Notes | หน้าเหล่านี้มีเนื้อหาสำหรับเอกสารประกอบการบรรยาย รวมถึงรูปร่างที่มีบันทึกของผู้บรรยายของสไลด์ สไลด์แต่ละรายการจะมีหน้าโน้ตที่เกี่ยวข้อง 1 หน้า คุณจะแก้ไขได้เฉพาะข้อความในรูปร่างบันทึกของผู้บรรยายเท่านั้นด้วย Slides API |
ต้นแบบโน้ต | ต้นฉบับของโน้ตจะกำหนดรูปแบบข้อความและองค์ประกอบของหน้าเริ่มต้นสำหรับหน้าโน้ตทั้งหมด ต้นฉบับของโน้ตเป็นแบบอ่านอย่างเดียวใน Slides API |
องค์ประกอบของหน้า
องค์ประกอบของหน้าคือองค์ประกอบภาพที่วางไว้ในหน้าต่างๆ API จะมีองค์ประกอบของหน้าเว็บหลายประเภท เช่น
กลุ่ม | ชุดส่วนประกอบของหน้าเว็บที่ถือเป็นหน่วยโฆษณาแต่ละหน่วย โดยอุปกรณ์ดังกล่าวจะย้าย ปรับขนาด และหมุนไปพร้อมกันได้ |
รูปร่าง | วัตถุที่มองเห็นง่าย เช่น สี่เหลี่ยมผืนผ้า วงรี และกล่องข้อความ รูปร่างสามารถใส่ข้อความได้ จึงเป็นองค์ประกอบที่ใช้บ่อยที่สุดของหน้าในการสร้างสไลด์ |
รูปภาพ | กราฟิกที่นำเข้าไปยังสไลด์ |
วิดีโอ | วิดีโอที่นำเข้าไปยังสไลด์ |
บรรทัด | เส้นภาพ เส้นโค้ง หรือเส้นเชื่อม |
ตาราง | ตารางกริดของเนื้อหา |
WordArt | องค์ประกอบของข้อความที่มองเห็น ซึ่งจะมีลักษณะคล้ายกับรูปร่างมากกว่า |
SheetsChart | แผนภูมิที่นำเข้าจาก Google ชีตไปยังสไลด์ |
การอัปเดตเป็นกลุ่ม
เมธอด batchUpdate ให้คุณอัปเดตงานนำเสนอในหลายๆ ด้าน การเปลี่ยนแปลงจะได้รับการจัดกลุ่มเป็นกลุ่มๆ เพื่อที่ว่าหากคำขอหนึ่งล้มเหลว จะไม่มีการเขียนการเปลี่ยนแปลงอื่นๆ (อาจต้องอาศัย)
เมธอด batchUpdate
ทำงานโดยนำออบเจ็กต์คำขออย่างน้อย 1 รายการ โดยแต่ละรายการจะระบุคำขอประเภทเดียวที่จะดำเนินการ คำขอมีหลายประเภท ต่อไปนี้เป็นรายละเอียดเกี่ยวกับประเภทคำขอที่จัดกลุ่มเป็นหมวดหมู่ต่างๆ
เมธอด batchUpdate
จะแสดงผลเนื้อหาการตอบกลับ ซึ่งมีการตอบกลับสำหรับแต่ละคำขอ แต่ละการตอบกลับจะใช้ดัชนีเดียวกับคำขอที่เกี่ยวข้อง สำหรับคำขอที่ไม่มีการตอบกลับที่เกี่ยวข้อง การตอบกลับในดัชนีนั้นจะว่างเปล่า โดยปกติแล้วคำขอ Create
ต่างๆ จะมีการตอบกลับ เพื่อให้คุณทราบรหัสของออบเจ็กต์ที่เพิ่มใหม่
การใช้งานรหัสออบเจ็กต์
งานนำเสนอใน Slides API ประกอบด้วยหน้าและองค์ประกอบของหน้า ออบเจ็กต์เหล่านี้มีสตริงรหัสออบเจ็กต์ที่ไม่ซ้ำกันในงานนำเสนอ
การระบุรหัสออบเจ็กต์เมื่อสร้าง
เมื่อสร้างหน้าหรือองค์ประกอบของหน้าโดยใช้เมธอด batchUpdate คุณจะระบุรหัสออบเจ็กต์สำหรับออบเจ็กต์ใหม่หรือไม่ก็ได้ วิธีนี้ช่วยให้คุณสร้างออบเจ็กต์และแก้ไขออบเจ็กต์ดังกล่าวภายในคำขอ BatchUpdate เดียวกันได้ ซึ่งจะลดจำนวนการเรียกใช้ Slides API และลดการใช้งานโควต้า
ในกรณีส่วนใหญ่ เราขอแนะนำให้สร้างรหัสออบเจ็กต์แบบสุ่ม เช่น หากคุณใช้ Java การใช้ java.util.UUID.randomUUID().toString()
ก็น่าจะทำงานได้ดี
เมื่อแอปพลิเคชันต้องการติดตามออบเจ็กต์ในระยะเวลาที่ยาวนานขึ้น อย่าใช้รหัสออบเจ็กต์เนื่องจากอาจมีการเปลี่ยนแปลง ดูรายละเอียดเพิ่มเติมได้ที่ส่วนต่อไปนี้
การติดตามวัตถุโดยไม่ใช้รหัสวัตถุ
เมื่อคุณส่งคําขอ Slides API รหัสออบเจ็กต์จะยังคงอยู่ตามปกติ (ข้อยกเว้นต่างๆ จะระบุอยู่ในเอกสารอ้างอิงของวิธีการ) การทำสำเนาทั้งงานนำเสนอด้วย Drive API จะเก็บรหัสออบเจ็กต์ไว้ด้วย
แต่คุณจะอ้างอิงรหัสออบเจ็กต์ที่ไม่มีการเปลี่ยนแปลงหลังจากมีการเปลี่ยนแปลงงานนำเสนอใน UI ของสไลด์ไม่ได้ เช่น หากมีคนใช้ UI ของสไลด์เพื่อคัดลอกและวางองค์ประกอบของหน้า แล้วลบองค์ประกอบเดิมออก องค์ประกอบของหน้าจะมีรหัสที่ไม่ซ้ำกันรหัสใหม่ และรหัสที่คุณให้ไว้ผ่านทาง API ก่อนหน้านี้จะหายไป ด้วยเหตุนี้ เราไม่แนะนำให้เก็บรหัสออบเจ็กต์ไว้ในพื้นที่เก็บข้อมูลของแอปพลิเคชัน คุณควรหาวัตถุในงานนำเสนอตามเนื้อหาข้อความหรือข้อความแสดงแทน
โดยปกติแล้วงานนำเสนอที่สร้างขึ้นใหม่จะใช้ชุดรหัสที่สอดคล้องกันสำหรับสไลด์เริ่มต้น ต้นฉบับ และกล่องข้อความ รหัสเหล่านี้อาจมีการเปลี่ยนแปลงเมื่อเวลาผ่านไป เราจึงไม่แนะนำให้คุณพึ่งพาฟีเจอร์นี้ ให้ค้นหาองค์ประกอบที่คุณต้องการแก้ไขโดยใช้ออบเจ็กต์งานนำเสนอที่เรียกใช้โดยการเรียก create() หรือ get() แทน