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