แนะนำตัว

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 รายการ โดยแต่ละรายการจะระบุคำขอประเภทเดียวที่จะดำเนินการ คำขอมีหลายประเภท ต่อไปนี้เป็นรายละเอียดเกี่ยวกับประเภทคำขอที่จัดกลุ่มเป็นหมวดหมู่ต่างๆ

การทำงานกับสไลด์ CreateSlideRequest
UpdateSlidesPositionRequest
DuplicateObjectRequest
UpdatePagePropertiesRequest
DeleteObjectRequest
การทำงานกับองค์ประกอบของหน้า CreateShapeRequest
CreateLineRequest
UpdatePageElementTransformRequest
UpdateShapePropertiesRequest
DuplicateObjectRequest
DeleteObjectRequest
การทำงานกับตาราง: CreateTableRequest
InsertTableRowsRequest
InsertTableColumnsRequest
DeleteTableRowRequest
DeleteTableColumnRequest
UpdateTableRowPropertiesRequest
UpdateTableColumnPropertiesRequest
UpdateTableBorderPropertiesRequest
UpdateTableCellPropertiesRequest
MergeTableCellsRequest
UnmergeTableCellsRequest
DeleteObjectRequest
การดำเนินการกับแผนภูมิ CreateSheetsChartRequest
RefreshSheetsChartRequest
ReplaceAllShapesWithSheetsChartRequest
DeleteObjectRequest
การทำงานกับรูปภาพและวิดีโอ CreateImageRequest
CreateVideoRequest
UpdateImagePropertiesRequest
UpdateVideoPropertiesRequest
ReplaceAllShapesWithImageRequest
DuplicateObjectRequest
DeleteObjectRequest
การทำงานกับข้อความ InsertTextRequest
DeleteTextRequest
ReplaceAllTextRequest
CreateParagraphBulletsRequest
DeleteParagraphBulletsRequest
UpdateTextStyleRequest
UpdateParagraphStyleRequest

เมธอด batchUpdate จะแสดงผลเนื้อหาการตอบกลับ ซึ่งมีการตอบกลับสำหรับแต่ละคำขอ แต่ละการตอบกลับจะใช้ดัชนีเดียวกับคำขอที่เกี่ยวข้อง สำหรับคำขอที่ไม่มีการตอบกลับที่เกี่ยวข้อง การตอบกลับในดัชนีนั้นจะว่างเปล่า โดยปกติแล้วคำขอ Create ต่างๆ จะมีการตอบกลับ เพื่อให้คุณทราบรหัสของออบเจ็กต์ที่เพิ่มใหม่

การใช้งานรหัสออบเจ็กต์

งานนำเสนอใน Slides API ประกอบด้วยหน้าและองค์ประกอบของหน้า ออบเจ็กต์เหล่านี้มีสตริงรหัสออบเจ็กต์ที่ไม่ซ้ำกันในงานนำเสนอ

การระบุรหัสออบเจ็กต์เมื่อสร้าง

เมื่อสร้างหน้าหรือองค์ประกอบของหน้าโดยใช้เมธอด batchUpdate คุณจะระบุรหัสออบเจ็กต์สำหรับออบเจ็กต์ใหม่หรือไม่ก็ได้ วิธีนี้ช่วยให้คุณสร้างออบเจ็กต์และแก้ไขออบเจ็กต์ดังกล่าวภายในคำขอ BatchUpdate เดียวกันได้ ซึ่งจะลดจำนวนการเรียกใช้ Slides API และลดการใช้งานโควต้า

ในกรณีส่วนใหญ่ เราขอแนะนำให้สร้างรหัสออบเจ็กต์แบบสุ่ม เช่น หากคุณใช้ Java การใช้ java.util.UUID.randomUUID().toString() ก็น่าจะทำงานได้ดี

เมื่อแอปพลิเคชันต้องการติดตามออบเจ็กต์ในระยะเวลาที่ยาวนานขึ้น อย่าใช้รหัสออบเจ็กต์เนื่องจากอาจมีการเปลี่ยนแปลง ดูรายละเอียดเพิ่มเติมได้ที่ส่วนต่อไปนี้

การติดตามวัตถุโดยไม่ใช้รหัสวัตถุ

เมื่อคุณส่งคําขอ Slides API รหัสออบเจ็กต์จะยังคงอยู่ตามปกติ (ข้อยกเว้นต่างๆ จะระบุอยู่ในเอกสารอ้างอิงของวิธีการ) การทำสำเนาทั้งงานนำเสนอด้วย Drive API จะเก็บรหัสออบเจ็กต์ไว้ด้วย

แต่คุณจะอ้างอิงรหัสออบเจ็กต์ที่ไม่มีการเปลี่ยนแปลงหลังจากมีการเปลี่ยนแปลงงานนำเสนอใน UI ของสไลด์ไม่ได้ เช่น หากมีคนใช้ UI ของสไลด์เพื่อคัดลอกและวางองค์ประกอบของหน้า แล้วลบองค์ประกอบเดิมออก องค์ประกอบของหน้าจะมีรหัสที่ไม่ซ้ำกันรหัสใหม่ และรหัสที่คุณให้ไว้ผ่านทาง API ก่อนหน้านี้จะหายไป ด้วยเหตุนี้ เราไม่แนะนำให้เก็บรหัสออบเจ็กต์ไว้ในพื้นที่เก็บข้อมูลของแอปพลิเคชัน คุณควรหาวัตถุในงานนำเสนอตามเนื้อหาข้อความหรือข้อความแสดงแทน

โดยปกติแล้วงานนำเสนอที่สร้างขึ้นใหม่จะใช้ชุดรหัสที่สอดคล้องกันสำหรับสไลด์เริ่มต้น ต้นฉบับ และกล่องข้อความ รหัสเหล่านี้อาจมีการเปลี่ยนแปลงเมื่อเวลาผ่านไป เราจึงไม่แนะนำให้คุณพึ่งพาฟีเจอร์นี้ ให้ค้นหาองค์ประกอบที่คุณต้องการแก้ไขโดยใช้ออบเจ็กต์งานนำเสนอที่เรียกใช้โดยการเรียก create() หรือ get() แทน