Google สไลด์ API ช่วยให้คุณสร้าง ย้าย และลบสไลด์ได้ ตัวอย่าง
หน้านี้จะแสดงการทำงานของสไลด์ทั่วไปโดยใช้
presentations.batchUpdate
ตัวอย่างต่อไปนี้ใช้ตัวแปรต่อไปนี้
- PRESENTATION_ID - ระบุตำแหน่งที่คุณให้บริการ งานนำเสนอ รหัส คุณสามารถ ค้นหาค่าของรหัสนี้จาก URL ของงานนำเสนอ
- PAGE_ID และ PAGE_ID2 - แสดงตำแหน่ง ให้ระบุออบเจ็กต์หน้าเว็บ รหัส คุณสามารถดึงข้อมูล ค่าของข้อมูลนี้จาก URL หรือโดยใช้คำขออ่าน API
ตัวอย่างเหล่านี้จะแสดงเป็นคำขอ HTTP เพื่อเป็นกลางทางภาษา เพื่อเรียนรู้ วิธีนำการอัปเดตแบบกลุ่มไปใช้ในภาษาต่างๆ โดยใช้ Google API ไลบรารีของไคลเอ็นต์ โปรดดูคู่มือต่อไปนี้ สร้าง เลื่อน และเพิ่มรูปร่างและ ข้อความ
คัดลอกสไลด์
ดังต่อไปนี้
presentations.batchUpdate
ตัวอย่างโค้ดจะแสดงวิธีใช้
DuplicateObjectRequest
ในการคัดลอกสไลด์และแทรกไว้หลังต้นฉบับในงานนำเสนอ
สไลด์ต้นฉบับระบุโดย PAGE_ID
คำขอช่วยให้คุณสามารถระบุได้ว่าควรระบุรหัสองค์ประกอบของหน้าบางส่วนหรือทั้งหมด สำเนา (ที่มีบางส่วน ข้อจำกัด [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
) ในงานนำเสนอ
สไลด์ใหม่ได้รับการตั้งค่าให้ใช้เมธอด
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 หมายถึงตำแหน่งที่ควรแทรกสไลด์ โดยอิงตาม
ในคำสั่งซื้อก่อนที่จะทำการย้าย ค่าต้องอยู่ระหว่าง 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" }