API ของ Google สไลด์ช่วยให้คุณสร้าง ย้าย และลบสไลด์ได้ ตัวอย่างในหน้านี้จะแสดงการดำเนินการสไลด์ที่พบบ่อยโดยใช้เมธอด presentations.batchUpdate
ตัวอย่างเหล่านี้ใช้ตัวแปรต่อไปนี้
- PRESENTATION_ID - ระบุตำแหน่งที่คุณให้รหัสงานนำเสนอ คุณดูค่าของรหัสนี้ได้จาก URL ของงานนำเสนอ
- PAGE_ID และ PAGE_ID2 - ระบุตำแหน่งที่คุณระบุรหัสออบเจ็กต์หน้าเว็บ คุณดึงค่าสำหรับค่านี้จาก URL หรือใช้คำขออ่าน API ก็ได้
ตัวอย่างเหล่านี้จะแสดงเป็นคำขอ HTTP เพื่อเป็นกลางทางภาษา หากต้องการดูวิธีการอัปเดตแบบกลุ่มในภาษาต่างๆ โดยใช้ไลบรารีของไคลเอ็นต์ Google API โปรดดูคำแนะนำการสร้างสไลด์และเพิ่มรูปร่างและข้อความ
คัดลอกสไลด์
ตัวอย่างโค้ด presentations.batchUpdate
ต่อไปนี้จะแสดงวิธีใช้เมธอด DuplicateObjectRequest
เพื่อคัดลอกสไลด์และแทรกไว้หลังต้นฉบับในงานนำเสนอ
สไลด์ต้นฉบับระบุโดย PAGE_ID
คำขอให้คุณระบุว่าควรระบุรหัสองค์ประกอบของหน้าบางส่วนหรือทั้งหมดไว้ในสำเนาหรือไม่ (โดยมีข้อจำกัดบางประการ) ในตัวอย่างนี้ สไลด์ต้นฉบับมีองค์ประกอบตาราง (ระบุโดย TABLE_ELEMENT_ID) ซึ่งแมปกับตารางใหม่ (ระบุโดย COPY_TABLE_ELEMENT_ID) ในสำเนาสไลด์ (ระบุโดย COPY_PAGE_ID) องค์ประกอบอื่นๆ ทั้งหมดในสำเนาจะได้รับรหัสแบบสุ่ม
ดูข้อมูลเพิ่มเติมเกี่ยวกับการคัดลอก PageElement
ซึ่งรวมถึงกล่องข้อความ รูปภาพ ตาราง รูปร่างพื้นฐาน เส้น และวิดีโอที่ฝัง
ได้จากตัวอย่างคัดลอกและแก้ไของค์ประกอบ
ต่อไปนี้เป็นโปรโตคอลคำขอให้คัดลอกสไลด์
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "duplicateObject": { "objectId": PAGE_ID, "objectIds": { "PAGE_ID": "COPY_PAGE_ID", "TABLE_ELEMENT_ID": "COPY_TABLE_ELEMENT_ID" } } } ] }
สร้างสไลด์
ตัวอย่างโค้ด presentations.batchUpdate
ต่อไปนี้จะแสดงวิธีใช้เมธอด CreateSlideRequest
เพื่อสร้างสไลด์และแทรกเป็นสไลด์ที่ 4 (โดยใช้ insertionIndex
แบบเลข 0) ในงานนำเสนอ
สไลด์ใหม่ได้รับการตั้งค่าให้ใช้ PredefinedLayout
ของ TITLE_AND_TWO_COLUMNS
คุณจะระบุสตริงที่จะใช้เป็น PAGE_ID สำหรับสไลด์ (โดยมีข้อจำกัดบางอย่าง) หรืออนุญาตให้ API สร้าง PAGE_ID ได้โดยละเว้นช่องในคำขอ
ต่อไปนี้เป็นโปรโตคอลคำขอสร้างสไลด์
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "createSlide": { "objectId": "PAGE_ID", "insertionIndex": 3, "slideLayoutReference": { "predefinedLayout": "TITLE_AND_TWO_COLUMNS" } } } ] }
สร้างสไลด์และแก้ไขตัวยึดตำแหน่ง
ตัวอย่างโค้ด presentations.batchUpdate
ต่อไปนี้จะแสดงวิธีใช้เมธอด CreateSlideRequest
เพื่อสร้างสไลด์โดยใช้ PredefinedLayout
ของ TITLE_AND_TWO_COLUMNS
คุณระบุสตริงที่จะใช้เป็น PAGE_ID สำหรับสไลด์ได้ (โดยมีข้อจำกัดบางอย่าง)
placeholderIdMappings
ใช้ Type
ของ TITLE
TITLE_ID จะอ้างอิงรูปร่างตัวยึดตำแหน่งของสไลด์
จึงแก้ไขได้
ต่อไปนี้เป็นโปรโตคอลคำขอสำหรับการสร้างสไลด์และแก้ไขตัวยึดตำแหน่ง
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "createSlide": { "objectId": PAGE_ID, "slideLayoutReference": { "predefinedLayout": "TITLE_AND_TWO_COLUMNS" }, "placeholderIdMappings": [ { "layoutPlaceholder": { "type": "TITLE", "index": 0 }, "objectId": TITLE_ID, }, ], } }, { "insertText": { "objectId": TITLE_ID, "text": "This is my slide title", } }, ] }
ย้ายสไลด์ไปยังตำแหน่งใหม่
ตัวอย่างโค้ด
presentations.batchUpdate
ต่อไปนี้จะแสดงวิธีใช้เมธอด UpdateSlidesPositionRequest
เพื่อนำสไลด์ 2 สไลด์ที่ระบุมาย้ายไปไว้ตอนต้นของงานนำเสนอ โดยรักษาลำดับที่เกี่ยวข้องไว้
ต้องระบุรหัสสไลด์ที่ระบุ (PAGE_ID และ PAGE_ID2)
ตามลำดับงานนำเสนอที่มีอยู่ โดยไม่มีรายการซ้ำกัน insertionIndex
แบบฐานศูนย์หมายถึงตำแหน่งที่ควรแทรกสไลด์ตามลำดับก่อนที่จะย้าย ค่าต้องอยู่ระหว่าง 0 ถึงจำนวนสไลด์ในงานนำเสนอ
ต่อไปนี้เป็นโปรโตคอลคำขอย้ายสไลด์ไปยังตำแหน่งใหม่
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "updateSlidesPosition": { "slideObjectIds": [ PAGE_ID, PAGE_ID2 ], "insertionIndex": 0 } } ] }
ตั้งค่าภาพพื้นหลังของสไลด์
ตัวอย่างโค้ด presentations.batchUpdate
ต่อไปนี้จะแสดงวิธีใช้เมธอด UpdatePagePropertiesRequest
ในการตั้งค่าภาพพื้นหลังของสไลด์ที่ระบุโดย PAGE_ID API จะดึงรูปภาพโดยใช้ IMAGE_URL
ฟิลด์มาสก์ใช้เพื่อระบุว่าควรเปลี่ยนเฉพาะพื้นหลังของสไลด์เพื่อรักษาพร็อพเพอร์ตี้อื่นๆ ไว้ การใช้มาสก์ยังช่วยปรับปรุงประสิทธิภาพด้วย
หรือจะใช้เมธอด UpdatePagePropertiesRequest
เพื่อตั้งค่าพื้นหลังของสไลด์เป็นสีทึบก็ได้
ต่อไปนี้เป็นโปรโตคอลคำขอตั้งค่าภาพพื้นหลังของสไลด์
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "updatePageProperties": { "objectId": PAGE_ID, "pageProperties": { "pageBackgroundFill": { "stretchedPictureFill": { "contentUrl": IMAGE_URL } } }, "fields": "pageBackgroundFill" } } ] }
สร้างภาพขนาดย่อ
คุณสร้างภาพปกเวอร์ชันล่าสุดของหน้าหนึ่งๆ ในงานนำเสนอได้โดยเรียกใช้เมธอด presentations.pages.getThumbnail
ซึ่งจะแสดงภาพขนาดย่อของหน้าเว็บเป็น URL เนื้อหา URL รูปภาพมีอายุการใช้งานเริ่มต้นอยู่ที่ 30 นาที
คุณยังระบุ mimeType
และ thumbnailSize
ที่แสดงผลโดยใช้ช่อง ThumbnailProperties
เป็นพารามิเตอร์การค้นหาได้ด้วย
ตัวอย่างโปรโตคอลคำขอสร้างภาพปกของหน้าเว็บที่ตั้งค่า ThumbnailProperties
ไว้มีดังนี้
GET https://slides.googleapis.com/v1/presentations/PRESENTATION_ID/pages/PAGE_ID/thumbnail?thumbnailProperties.mimeType=PNG&thumbnailProperties.thumbnailSize=MEDIUM
{ "width": 800, "height": 450, "contentUrl": "CONTENT_URL" }