Google สไลด์ API ช่วยให้คุณสามารถสร้างและแก้ไขทรัพยากร PageElement
ซึ่งรวมถึงกล่องข้อความ รูปภาพ ตาราง รูปร่างพื้นฐาน เส้น และวิดีโอที่ฝัง ตัวอย่างในหน้านี้แสดงการดำเนินการทั่วไปขององค์ประกอบของหน้าโดยใช้เมธอด presentations.batchUpdate
ตัวอย่างเหล่านี้ใช้ตัวแปรต่อไปนี้
- PRESENTATION_ID - ระบุตำแหน่งที่คุณให้รหัสงานนำเสนอ คุณจะเรียกดูค่าสำหรับรหัสนี้ได้จาก URL ของงานนำเสนอ
- PAGE_ID - ระบุตำแหน่งที่คุณระบุรหัสออบเจ็กต์หน้าเว็บ คุณดึงค่าสำหรับค่านี้จาก URL หรือโดยใช้คำขออ่าน API ก็ได้
- PAGE_ELEMENT_ID - ระบุตำแหน่งที่คุณระบุรหัสออบเจ็กต์องค์ประกอบของหน้า คุณสามารถระบุรหัสนี้สำหรับองค์ประกอบที่สร้างขึ้น (โดยมีข้อจำกัดบางอย่าง) หรืออนุญาตให้ Slides API สร้างรหัสดังกล่าวโดยอัตโนมัติ คุณจะดึงข้อมูลรหัสองค์ประกอบได้ผ่านคำขออ่าน API
ตัวอย่างเหล่านี้จะแสดงเป็นคำขอ HTTP ให้ใช้ภาษาเป็นกลาง หากต้องการดูวิธีใช้การอัปเดตเป็นกลุ่มในภาษาต่างๆ โดยใช้ไลบรารีของไคลเอ็นต์ Google API โปรดดูคำแนะนำต่อไปนี้
เพิ่มรายการสัญลักษณ์หัวข้อย่อยในกล่องข้อความ
ตัวอย่างโค้ด presentations.batchUpdate
ต่อไปนี้แสดงวิธีใช้วิธี InsertTextRequest
เพื่อแทรกข้อความลงในช่องข้อความว่างเปล่าที่PAGE_ELEMENT_IDระบุไว้ จากนั้นตัวอย่างจะใช้เมธอด CreateParagraphBulletsRequest
เพื่อแปลงข้อความในกล่องข้อความทั้งหมดเป็นรายการสัญลักษณ์หัวข้อย่อย รายการต่างๆ ในรายการคั่นด้วยอักขระ \n
ตัว ส่วนการเยื้องจะควบคุมด้วยอักขระ \t
ตัว
ต่อไปนี้เป็นโปรโตคอลคำขอเพื่อสร้างงานนำเสนอ
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "insertText": { "objectId": PAGE_ELEMENT_ID, "text": "My List\n\tItem 1\n\t\tItem 2\n\t\t\tItem 3", "insertionIndex": 0 }, "createParagraphBullets": { "objectId": PAGE_ELEMENT_ID, "bulletPreset": "BULLET_ARROW_DIAMOND_DISC", "textRange": { "type": "ALL" } } } ] }
คำขอนี้สามารถสร้างรายการสัญลักษณ์หัวข้อย่อยที่มีลักษณะดังนี้
เพิ่มรูปร่างในสไลด์
ตัวอย่างโค้ด
presentations.batchUpdate
ต่อไปนี้จะแสดงวิธีใช้
CreateShapeRequest
เพื่อเพิ่มรูปร่างคลื่นลงในสไลด์ที่ PAGE_ID ระบุไว้
คำขอนี้จะระบุประเภทของรูปร่าง จากนั้นจะปรับขนาดและจัดตำแหน่งรูปร่างในสไลด์ จากนั้นจะใช้เมธอด InsertTextRequest
เพื่อเพิ่มข้อความลงในรูปร่างนั้น คําขอตั้งค่ารหัสของบรรทัดเป็น PAGE_ELEMENT_ID
ต่อไปนี้เป็นโปรโตคอลคำขอเพื่อเพิ่มรูปร่างในสไลด์
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "createShape": { "objectId": PAGE_ELEMENT_ID, "elementProperties": { "pageObjectId": PAGE_ID, "size": { "width": { "magnitude": 3000000, "unit": "EMU" }, "height": { "magnitude": 3000000, "unit": "EMU" } }, "transform": { "scaleX": 0.6807, "scaleY": 0.4585, "translateX": 6583050, "translateY": 1673950, "unit": "EMU" } }, "shapeType": "WAVE" } }, { "insertText": { "objectId": PAGE_ELEMENT_ID, "text": "My Wave Shape", "insertionIndex": 0 } } ] }
เพิ่มวิดีโอลงในสไลด์
ตัวอย่างโค้ด
presentations.batchUpdate
ต่อไปนี้จะแสดงวิธีใช้เมธอด CreateVideoRequest
เพื่อฝังวิดีโอลงในสไลด์ที่ PAGE_ID ระบุไว้
คำขอนี้จะปรับสัดส่วนและจัดตำแหน่งวิดีโอในสไลด์ รวมทั้งกำหนดรหัสของวิดีโอเป็น PAGE_ELEMENT_ID ตัวระบุที่ไม่ซ้ำกันของวิดีโอต้นฉบับตั้งค่าเป็น VIDEO_ID เช่น วิดีโอ YouTube ที่ https://www.youtube.com/watch?v=7U3axjORYZ0
มีรหัส 7U3axjORYZ0
ต่อไปนี้เป็นโปรโตคอลคำขอเพื่อเพิ่มวิดีโอในสไลด์
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "createVideo": { "objectId": PAGE_ELEMENT_ID, "elementProperties": { "pageObjectId": PAGE_ID, "size": { "width": { "magnitude": 12000, "unit": "EMU" }, "height": { "magnitude": 9000, "unit": "EMU" } }, "transform": { "scaleX": 381, "scaleY": 381, "translateX": 152400, "translateY": 152400, "unit": "EMU" } }, "source": "YOUTUBE", "id": VIDEO_ID } } ] }
คัดลอกและแก้ไของค์ประกอบ
ตัวอย่างโค้ด presentations.batchUpdate
ต่อไปนี้จะแสดงวิธีใช้เมธอด DuplicateObjectRequest
เพื่อปรับรูปร่างที่มีอยู่ (ระบุโดย PAGE_ELEMENT_ID) และทำสำเนา (ระบุโดยCOPY_ELEMENT_ID)
จากนั้นคำขอที่ตามมาจะทำการเปลี่ยนแปลงต่อไปนี้กับออบเจ็กต์ที่ซ้ำกัน
- ตั้งค่าสีพื้นหลังเป็นสีธีม
LIGHT2
- เลื่อนสำเนาหน้าเว็บลง (จากตำแหน่งของรูปร่างเดิม)
- ตั้งค่าแบบอักษรข้อความเป็นจอร์เจีย 18 พอยต์
- แก้ไขข้อความอ่าน "My Shape Copy"
คำขอที่นี่ใช้มาสก์ของช่องเพื่อรักษาคุณสมบัติของรูปร่างที่ไม่มีการเปลี่ยนแปลง (เช่น รูปแบบโครงร่าง) การใช้ฟิลด์มาสก์ยังช่วยปรับปรุงประสิทธิภาพได้เช่นกัน
สำหรับข้อมูลเพิ่มเติมเกี่ยวกับการคัดลอกสไลด์ โปรดดูตัวอย่างคัดลอกสไลด์
โปรโตคอลคำขอสำหรับคัดลอกและแก้ไของค์ประกอบมีดังนี้
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "duplicateObject": { "objectId": PAGE_ELEMENT_ID, "objectIds": { PAGE_ELEMENT_ID: COPY_ELEMENT_ID } } }, { "updateShapeProperties": { "objectId": COPY_ELEMENT_ID, "fields": "shapeBackgroundFill.solidFill.color", "shapeProperties": { "shapeBackgroundFill": { "solidFill": { "color": { "themeColor": "LIGHT2" } } } } } }, { "updatePageElementTransform": { "objectId": COPY_ELEMENT_ID, "applyMode": "RELATIVE", "transform": { "scaleX": 1, "scaleY": 1, "translateX": 0, "translateY": 1250000, "unit": "EMU" } } }, { "updateTextStyle": { "objectId": COPY_ELEMENT_ID, "fields": "fontFamily,fontSize", "textRange": { "type": "ALL" }, "style": { "fontFamily": "Georgia", "fontSize": { "magnitude": 18, "unit": "PT" } } } }, { "deleteText": { "objectId": COPY_ELEMENT_ID, "textRange": { "type": "ALL" } } }, { "insertText": { "objectId": COPY_ELEMENT_ID, "text": "My Shape Copy", "insertionIndex": 0 } } ] }
ต่อไปนี้คือลักษณะของรูปร่างและสำเนาของรูปร่างหลังจากการอัปเดต
แก้ไขโครงร่างรูปภาพหรือวิดีโอ
ตัวอย่างโค้ด presentations.batchUpdate
ต่อไปนี้จะแสดงวิธีใช้เมธอด UpdateImagePropertiesRequest
ในการอัปเดตลักษณะที่ปรากฏของโครงร่างของรูปภาพที่ระบุโดย IMAGE_ELEMENT_ID นอกจากนี้ยังใช้วิธีการ UpdateVideoPropertiesRequest
เพื่ออัปเดตลักษณะที่ปรากฏของโครงร่างของวิดีโอแบบฝังที่ VIDEO_ELEMENT_ID ระบุไว้อีกด้วย
คำขอทำการเปลี่ยนแปลงต่อไปนี้กับออบเจ็กต์
- ตั้งค่าสีขอบรูปภาพเป็นสีธีม
ACCENT5
แบบโปร่งใสบางส่วน - ตั้งค่าสีโครงร่างวิดีโอเป็นสีธีม
ACCENT1
โดยไม่มีความโปร่งใส - ตั้งค่าน้ำหนักของโครงร่างให้เป็น 3 คะแนนสำหรับทั้ง 2 แบบ
- ตั้งค่ารูปแบบโครงร่างรูปภาพเป็น
SOLID
- ตั้งค่ารูปแบบโครงร่างวิดีโอเป็น
DASH_DOT
ทั้งเมธอด UpdateImagePropertiesRequest
และเมธอด UpdateVideoPropertiesRequest
จะเปลี่ยนได้เฉพาะลักษณะที่ปรากฏของโครงร่างรูปภาพและวิดีโอเท่านั้น ส่วนพร็อพเพอร์ตี้อื่นๆ ทั้งหมดเป็นแบบอ่านอย่างเดียว คำขอในที่นี้ใช้มาสก์ของช่องเพื่อระบุว่าควรเปลี่ยนเฉพาะโครงร่างเท่านั้นเพื่อปกป้องโค้ดจากการเปลี่ยนแปลง API ในอนาคต การใช้มาสก์ฟิลด์ยังช่วยปรับปรุงประสิทธิภาพได้เช่นกัน
ต่อไปนี้เป็นโปรโตคอลคำขอสำหรับแก้ไขโครงร่างรูปภาพหรือวิดีโอ
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "updateImageProperties": { "objectId": IMAGE_ELEMENT_ID, "fields": "outline", "imageProperties": { "outline": { "dashStyle": "SOLID", "outlineFill": { "solidFill": { "alpha": 0.8, "color": { "themeColor": "ACCENT5" } } }, "weight": { "magnitude": 3, "unit": "PT" } } } } }, { "updateVideoProperties": { "objectId": VIDEO_ELEMENT_ID, "fields": "outline", "videoProperties": { "outline": { "dashStyle": "DASH_DOT", "outlineFill": { "solidFill": { "alpha": 0.8, "color": { "themeColor": "ACCENT1" } } }, "weight": { "magnitude": 3, "unit": "PT" } } } } } ] }
รูปภาพและวิดีโอแบบฝังอาจมีลักษณะดังนี้หลังจากการอัปเดต
แก้ไขโครงร่างของรูปร่าง
ตัวอย่างโค้ด presentations.batchUpdate
ต่อไปนี้จะแสดงวิธีใช้เมธอด UpdateShapePropertiesRequest
เพื่อปรับรูปร่างที่มีอยู่ (ระบุโดย PAGE_ELEMENT_ID) และอัปเดตลักษณะที่ปรากฏของโครงร่าง
คำขอทำการเปลี่ยนแปลงต่อไปนี้กับออบเจ็กต์
- ตั้งค่าสีโครงร่างเป็นสีธีม
ACCENT5
แบบโปร่งใสบางส่วน - ตั้งค่าน้ำหนักของโครงร่างเป็น 3 คะแนน
- ตั้งค่ารูปแบบโครงร่างเป็น
LONG_DASH
คำขอที่นี่ใช้มาสก์ของช่องเพื่อรักษาคุณสมบัติของรูปร่างที่ไม่มีการเปลี่ยนแปลง (เช่น สีเติมรูปร่าง) การใช้ฟิลด์มาสก์ยังช่วยปรับปรุงประสิทธิภาพได้เช่นกัน
ต่อไปนี้เป็นโปรโตคอลคำขอสำหรับแก้ไขโครงร่างของรูปร่าง
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "updateShapeProperties": { "objectId": PAGE_ELEMENT_ID, "fields": "outline", "shapeProperties": { "outline": { "dashStyle": "LONG_DASH", "outlineFill": { "solidFill": { "alpha": 0.6, "color": { "themeColor": "ACCENT5" } } }, "weight": { "magnitude": 3, "unit": "PT" } } } } } ] }
หลังจากอัปเดตแล้ว รูปร่างอาจมีหน้าตาดังนี้
จัดรูปแบบข้อความในรูปร่างหรือกล่องข้อความ
ตัวอย่างโค้ด presentations.batchUpdate
ต่อไปนี้จะแสดงวิธีใช้เมธอด UpdateTextStyleRequest
เพื่อปรับรูปร่างที่มีอยู่ (ระบุโดย PAGE_ELEMENT_ID) และอัปเดตลักษณะที่ปรากฏของข้อความ
คำขอทำการเปลี่ยนแปลงต่อไปนี้กับออบเจ็กต์
- ตั้งค่าสีข้อความเป็นสีธีม
ACCENT5
- ตั้งค่าแบบอักษรให้เป็นตัวหนาและตัวเอียงขนาด 18 pt
- ขีดเส้นใต้ข้อความ
คำขอที่นี่ใช้มาสก์ของช่องเพื่อรักษาคุณสมบัติของรูปแบบข้อความที่ไม่มีการเปลี่ยนแปลง (เช่น สีพื้นหลัง ลิงก์ หรือออฟเซ็ตพื้นฐาน) การใช้มาสก์ฟิลด์ยังช่วยปรับปรุงประสิทธิภาพได้เช่นกัน
ต่อไปนี้เป็นโปรโตคอลคำขอในการจัดรูปแบบข้อความในรูปร่างหรือกล่องข้อความ
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "updateTextStyle": { "objectId": PAGE_ELEMENT_ID, "fields": "foregroundColor,bold,italic,fontFamily,fontSize,underline", "style": { "foregroundColor": { "opaqueColor": { "themeColor": "ACCENT5" } }, "bold": true, "italic": true, "underline": true, "fontFamily": "Corsiva", "fontSize": { "magnitude": 18, "unit": "PT" } }, "textRange": { "type": "ALL" } } } ] }
ข้อความรูปร่างอาจมีลักษณะดังนี้หลังจากการอัปเดต
นำเข้าแผนภูมิจาก Google ชีต
ตัวอย่างโค้ด presentations.batchUpdate
ต่อไปนี้จะแสดงวิธีใช้ CreateSheetsChartRequest
เพื่อนำเข้าแผนภูมิจากชีตและวางไว้ในสไลด์ที่PAGE_IDระบุไว้
คำขอต้องใช้รหัสสเปรดชีต (ซึ่งระบุโดย SPREADSHEET_ID) และรหัสแผนภูมิสเปรดชีต (ซึ่งระบุโดย SPREADSHEET_CHART_ID) รหัสแผนภูมิภายในงานนำเสนอของสไลด์จะระบุโดย PRESENTATION_CHART_ID
คำขอยังตั้งค่า LinkingMode
ของแผนภูมิสไลด์เป็น LINKED
เพื่อให้คุณอัปเดตแผนภูมิที่ฝังได้หากมีการอัปเดตแผนภูมิในสเปรดชีตต้นฉบับ
ต่อไปนี้เป็นโปรโตคอลคำขอนำเข้าแผนภูมิจากชีต
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "createSheetsChart": { "objectId": PRESENTATION_CHART_ID, "spreadsheetId": SPREADSHEET_ID, "chartId": SPREADSHEET_CHART_ID, "linkingMode": "LINKED", "elementProperties": { "pageObjectId": PAGE_ID, "size": { "width": { "magnitude": 4000000, "unit": "EMU" }, "height": { "magnitude": 4000000, "unit": "EMU" } }, "transform": { "scaleX": 1, "scaleY": 1, "translateX": 100000, "translateY": 100000, "unit": "EMU" } } } ] }
รีเฟรชแผนภูมิจากชีต
ตัวอย่างโค้ด presentations.batchUpdate
ต่อไปนี้จะแสดงวิธีใช้วิธี RefreshSheetsChartRequest
เพื่อรีเฟรชแผนภูมิที่ลิงก์ในงานนำเสนอ โดยแทนที่ด้วยแผนภูมิเวอร์ชันล่าสุดจากสเปรดชีตต้นทางของชีต คำขอต้องใช้รหัสแผนภูมิภายในงานนำเสนอสไลด์ (ระบุโดย PRESENTATION_CHART_ID)
ต่อไปนี้เป็นโปรโตคอลคำขอรีเฟรชแผนภูมิจากชีต
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "refreshSheetsChart": { "objectId": PRESENTATION_CHART_ID } } ] }