Google สไลด์ API ช่วยให้คุณสร้างและแก้ไขทรัพยากร PageElement
ได้ ซึ่งรวมถึงกล่องข้อความ รูปภาพ ตาราง รูปร่างพื้นฐาน เส้น และวิดีโอที่ฝัง ตัวอย่างในหน้านี้แสดงการดำเนินการขององค์ประกอบหน้าเว็บทั่วไปโดยใช้เมธอด presentations.batchUpdate
ตัวอย่างต่อไปนี้ใช้ตัวแปรต่อไปนี้
- PRESENTATION_ID - ระบุตำแหน่งที่คุณแจ้งรหัสงานนำเสนอ คุณจะดึงค่าของรหัสนี้จาก URL งานนำเสนอได้
- PAGE_ID - ระบุตำแหน่งที่คุณระบุรหัสออบเจ็กต์หน้าเว็บ คุณดึงค่าของส่วนนี้จาก URL หรือโดยใช้คำขออ่าน API ก็ได้
- PAGE_ELEMENT_ID - ระบุตำแหน่งที่คุณระบุรหัสออบเจ็กต์องค์ประกอบของหน้าเว็บ โดยอาจระบุรหัสนี้สำหรับองค์ประกอบที่คุณสร้าง (โดยมีข้อจำกัดบางอย่าง) หรืออนุญาตให้สไลด์ 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 pt สำหรับทั้ง 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 ของ Corsiva
- ขีดเส้นใต้ข้อความ
คำขอที่นี่ใช้มาสก์ของช่องเพื่อคงคุณสมบัติของรูปแบบข้อความที่ไม่มีการเปลี่ยนแปลง (เช่น สีพื้นหลัง ลิงก์ หรือออฟเซ็ตพื้นฐาน) การใช้ฟิลด์มาสก์ยังช่วยปรับปรุงประสิทธิภาพด้วย
ต่อไปนี้เป็นโปรโตคอลคำขอเพื่อจัดรูปแบบข้อความในรูปร่างหรือกล่องข้อความ
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 } } ] }