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