บทนำ

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

การทำงานกับสไลด์ 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 ให้คุณ (ไม่บังคับ) สามารถระบุรหัสออบเจ็กต์สำหรับออบเจ็กต์ใหม่ได้ ซึ่งจะช่วยให้คุณสร้าง ของออบเจ็กต์แล้วแก้ไขภายในคำขอ blockUpdate เดียวกันโดยลดจำนวนหมายเลขให้น้อยที่สุด ของการเรียกไปยัง Slides API และลดการใช้โควต้า

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

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

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

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

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

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