Google สไลด์ API ช่วยให้คุณสร้างและแก้ไขงานนำเสนอใน Google สไลด์ได้
แอปสามารถทำงานร่วมกับ Google สไลด์ 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-_]+)
หากคุณคุ้นเคยกับ API ไดรฟ์แล้ว presentationId จะสอดคล้องกับรหัสของทรัพยากรไฟล์
ระบบจะระบุหน้าและองค์ประกอบของหน้าตามรหัสออบเจ็กต์
Pages
Google สไลด์มีหน้าประเภทต่อไปนี้
| ปริญญาโท | ต้นฉบับสไลด์จะกำหนดรูปแบบข้อความ พื้นหลัง และองค์ประกอบของหน้าเว็บเริ่มต้นที่ปรากฏในสไลด์ทั้งหมดที่ใช้ต้นฉบับนี้ คุณควรเพิ่มองค์ประกอบของหน้าที่ต้องปรากฏบนสไลด์ทั้งหมดลงในต้นแบบ งานนำเสนอส่วนใหญ่มีต้นฉบับ 1 รายการ แต่บางรายการอาจมีหลายรายการหรือไม่มีเลย |
| เลย์เอาต์ | เลย์เอาต์ทำหน้าที่เป็นเทมเพลตสำหรับวิธีจัดเรียงองค์ประกอบต่างๆ ของหน้าโดยค่าเริ่มต้นในสไลด์โดยใช้เลย์เอาต์ แต่ละเลย์เอาต์จะเชื่อมโยงกับโฆษณาหลัก 1 รายการ |
| สไลด์ | หน้าเหล่านี้มีเนื้อหาที่คุณกำลังนำเสนอต่อผู้ชม สไลด์ส่วนใหญ่อิงมาจากต้นแบบและการออกแบบ คุณระบุเลย์เอาต์ที่จะใช้สำหรับแต่ละสไลด์ได้เมื่อสร้างขึ้น |
| Notes | หน้าเหล่านี้มีเนื้อหาสำหรับเอกสารประกอบการบรรยาย รวมถึงรูปร่างที่มีบันทึกของผู้บรรยายในสไลด์ แต่ละสไลด์จะมีหน้าหมายเหตุที่เกี่ยวข้อง 1 หน้า คุณใช้ Slides API เพื่อแก้ไขได้เฉพาะข้อความในรูปร่างบันทึกของผู้บรรยาย |
| ต้นฉบับโน้ต | ต้นฉบับโน้ตจะกำหนดรูปแบบข้อความและองค์ประกอบเริ่มต้นของหน้าโน้ตทั้งหมด ต้นฉบับของ Notes เป็นแบบอ่านอย่างเดียวใน Slides API |
องค์ประกอบของหน้า
องค์ประกอบของหน้าคือองค์ประกอบด้านภาพที่วางอยู่ในหน้า API แสดงเอลิเมนต์หน้าเว็บหลายประเภท ดังนี้
| กลุ่ม | ชุดขององค์ประกอบของหน้าเว็บที่จัดว่าเป็นหน่วยแต่ละหน่วย ซึ่งสามารถย้าย ปรับขนาด และหมุนเวียนได้พร้อมกัน |
| รูปร่าง | วัตถุที่ดูธรรมดา เช่น สี่เหลี่ยมผืนผ้า วงรี และกล่องข้อความ รูปร่างอาจมีข้อความได้ จึงเป็นองค์ประกอบที่พบบ่อยที่สุดของหน้าในการสร้างสไลด์ |
| รูปภาพ | นําเข้ากราฟิกไปยังสไลด์แล้ว |
| วิดีโอ | นําเข้าวิดีโอไปยังสไลด์แล้ว |
| บรรทัด | เส้นภาพ เส้นโค้ง หรือเส้นเชื่อม |
| ตาราง | ตารางกริดของเนื้อหา |
| WordArt | องค์ประกอบข้อความที่มองเห็นซึ่งทํางานคล้ายกับรูปร่างมากขึ้น |
| SheetsChart | นำเข้าแผนภูมิจาก Google ชีตไปยังสไลด์แล้ว |
การอัปเดตเป็นกลุ่ม
เมธอด batchUpdate ช่วยให้คุณอัปเดตงานนำเสนอได้หลายแง่มุม ระบบจะจัดกลุ่มการเปลี่ยนแปลงเป็นกลุ่มๆ เพื่อที่หากคำขอหนึ่งล้มเหลว ก็จะไม่มีการเขียนการเปลี่ยนแปลงอื่นๆ (ที่อาจขึ้นอยู่กับ) อีกต่อไป
เมธอด batchUpdate ทำงานโดยรับออบเจ็กต์ Request อย่างน้อย 1 รายการ โดยแต่ละออบเจ็กต์ระบุคำขอประเภทเดียวที่จะดำเนินการ มีคำขอหลายประเภท รายละเอียดของคำขอประเภทต่างๆ
ซึ่งแบ่งออกเป็นหมวดหมู่ต่างๆ มีดังนี้
เมธอด batchUpdate จะแสดงเนื้อหาการตอบกลับ ซึ่งมีการตอบกลับสำหรับแต่ละคำขอ การตอบกลับแต่ละรายการใช้ดัชนีเดียวกันกับคำขอที่เกี่ยวข้อง สำหรับคำขอที่ไม่มีการตอบกลับที่เกี่ยวข้อง การตอบกลับในดัชนีนั้นจะว่างเปล่า โดยปกติคำขอ Create ต่างๆ จะมีการตอบกลับ คุณจึงทราบรหัสของออบเจ็กต์ที่เพิ่มเข้ามาใหม่
การทำงานกับรหัสออบเจ็กต์
งานนำเสนอใน Slides API ประกอบด้วยหน้าและองค์ประกอบของหน้า ออบเจ็กต์เหล่านี้มีสตริงรหัสออบเจ็กต์ที่ไม่ซ้ำกันภายในงานนำเสนอ
การระบุรหัสออบเจ็กต์เมื่อสร้าง
เมื่อสร้างหน้าหรือองค์ประกอบหน้าโดยใช้เมธอด batchUpdate คุณจะระบุรหัสออบเจ็กต์สำหรับออบเจ็กต์ใหม่หรือไม่ก็ได้ วิธีนี้ช่วยให้คุณสร้างออบเจ็กต์และแก้ไขออบเจ็กต์ภายในคำขอ groupUpdate เดียวกันได้ ทำให้ลดจำนวนการเรียกไปยัง Slides API ให้เหลือน้อยที่สุดและลดการใช้โควต้า
เราขอแนะนำให้สร้างรหัสออบเจ็กต์แบบสุ่มในกรณีส่วนใหญ่ ตัวอย่างเช่น หากคุณใช้ Java อยู่ java.util.UUID.randomUUID().toString() ควรจะทำงานได้เป็นอย่างดี
เมื่อแอปพลิเคชันของคุณต้องการติดตามออบเจ็กต์ในระยะเวลาที่นานขึ้น อย่าพึ่งพารหัสออบเจ็กต์เนื่องจากอาจมีการเปลี่ยนแปลง ดูรายละเอียดเพิ่มเติมในส่วนต่อไปนี้
ติดตามวัตถุโดยไม่ใช้รหัสวัตถุ
เมื่อคุณส่งคำขอ API สไลด์ รหัสออบเจ็กต์จะยังคงอยู่ตามปกติ (ระบุข้อยกเว้นไว้ในเอกสารอ้างอิงของเมธอด) การทำสำเนางานนำเสนอทั้งหมดด้วย Drive API จะเก็บรักษารหัสออบเจ็กต์ไว้ด้วย
แต่คุณจะพึ่งพารหัสออบเจ็กต์ที่ไม่มีการเปลี่ยนแปลงหลังจากมีการเปลี่ยนแปลงงานนำเสนอใน UI ของสไลด์ไม่ได้ เช่น หากมีคนใช้ UI ของสไลด์เพื่อคัดลอกและวางองค์ประกอบของหน้า แล้วลบองค์ประกอบเดิมออกไป ในตอนนี้องค์ประกอบหน้าก็จะมีรหัสที่ไม่ซ้ำกันรหัสใหม่ และรหัสที่คุณให้ไว้ผ่าน API ก่อนหน้านี้จะหายไป เราจึงไม่แนะนำให้คุณจัดเก็บรหัสออบเจ็กต์ในพื้นที่เก็บข้อมูลของแอปพลิเคชัน คุณควรค้นหาออบเจ็กต์ในงานนำเสนอ จากเนื้อหาข้อความหรือข้อความแสดงแทน
โดยปกติงานนำเสนอที่สร้างใหม่จะใช้ชุดรหัสที่สอดคล้องกันสำหรับสไลด์เริ่มต้น ต้นฉบับ และกล่องข้อความ รหัสเหล่านี้อาจมีการเปลี่ยนแปลงเมื่อเวลาผ่านไป เราจึงไม่แนะนำให้คุณใช้ฟีเจอร์นี้ ให้ค้นหาองค์ประกอบที่คุณต้องการแก้ไขโดยใช้ออบเจ็กต์การนำเสนอที่แสดงผลโดยการเรียก create() หรือ get() แทน