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 รายการ |
| สไลด์ | หน้าเหล่านี้มีเนื้อหาที่คุณนำเสนอต่อผู้ชม สไลด์ส่วนใหญ่จะอิงตามสไลด์ต้นแบบและเลย์เอาต์ คุณระบุได้ว่าจะใช้เลย์เอาต์ใด สำหรับแต่ละสไลด์เมื่อสร้าง |
| หมายเหตุ | หน้าเหล่านี้มีเนื้อหาสำหรับเอกสารประกอบการนำเสนอ ซึ่งรวมถึง รูปร่างที่มีหมายเหตุของผู้พูดของสไลด์ สไลด์แต่ละรายการจะมีหน้าหมายเหตุที่เกี่ยวข้อง 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() แทน