Class Master

หลัก

ต้นแบบในงานนำเสนอ

ต้นฉบับประกอบด้วยองค์ประกอบของหน้าทั่วไปทั้งหมดและคุณสมบัติทั่วไปสำหรับชุดเลย์เอาต์ โดยมีจุดประสงค์ 3 ข้อ ได้แก่

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

วิธีการ

วิธีการประเภทการแสดงผลรายละเอียดแบบย่อ
getBackground()PageBackgroundรับพื้นหลังของหน้า
getColorScheme()ColorSchemeรับ ColorScheme ที่เชื่อมโยงกับเพจ
getGroups()Group[]แสดงรายการออบเจ็กต์ Group รายการในหน้าเว็บ
getImages()Image[]แสดงรายการออบเจ็กต์ Image รายการในหน้าเว็บ
getLayouts()Layout[]รับเลย์เอาต์ของต้นแบบนี้
getLines()Line[]แสดงรายการออบเจ็กต์ Line รายการในหน้าเว็บ
getObjectId()Stringรับรหัสที่ไม่ซ้ำกันสำหรับหน้านั้น
getPageElementById(id)PageElementแสดง PageElement ในหน้าเว็บที่มีรหัสที่ระบุ หรือ null หากไม่มี
getPageElements()PageElement[]แสดงรายการออบเจ็กต์ PageElement รายการที่แสดงผลในหน้า
getPageType()PageTypeรับประเภทของหน้าเว็บ
getPlaceholder(placeholderType)PageElementแสดงผลออบเจ็กต์ PageElement ของตัวยึดตำแหน่งสำหรับ PlaceholderType หรือ null ที่ระบุ หากไม่มีตัวยึดตำแหน่งที่ตรงกัน
getPlaceholder(placeholderType, placeholderIndex)PageElementแสดงผลออบเจ็กต์ PageElement ของตัวยึดตำแหน่งสำหรับ PlaceholderType ที่ระบุและดัชนีตัวยึดตำแหน่ง หรือ null หากไม่มีตัวยึดตำแหน่ง
getPlaceholders()PageElement[]แสดงผลรายการออบเจ็กต์ PageElement ของตัวยึดตำแหน่งในหน้าเว็บ
getShapes()Shape[]แสดงรายการออบเจ็กต์ Shape รายการในหน้าเว็บ
getSheetsCharts()SheetsChart[]แสดงรายการออบเจ็กต์ SheetsChart รายการในหน้าเว็บ
getTables()Table[]แสดงรายการออบเจ็กต์ Table รายการในหน้าเว็บ
getVideos()Video[]แสดงรายการออบเจ็กต์ Video รายการในหน้าเว็บ
getWordArts()WordArt[]แสดงรายการออบเจ็กต์ WordArt รายการในหน้าเว็บ
group(pageElements)Groupจัดกลุ่มองค์ประกอบของหน้าที่ระบุทั้งหมด
insertGroup(group)Groupแทรกสำเนาของ Group ที่ให้ไว้ในหน้า
insertImage(blobSource)Imageแทรกรูปภาพที่มุมซ้ายบนของหน้าโดยใช้ขนาดเริ่มต้นจาก BLOB รูปภาพที่ระบุ
insertImage(blobSource, left, top, width, height)Imageแทรกรูปภาพในหน้าเว็บด้วยตำแหน่งและขนาดที่ให้ไว้จาก BLOB รูปภาพที่ระบุ
insertImage(image)Imageแทรกสำเนาของ Image ที่ให้ไว้ในหน้า
insertImage(imageUrl)Imageแทรกรูปภาพที่มุมซ้ายบนของหน้าโดยใช้ขนาดเริ่มต้นจาก URL ที่ให้ไว้
insertImage(imageUrl, left, top, width, height)Imageแทรกรูปภาพในหน้าเว็บด้วยตำแหน่งและขนาดที่ให้ไว้จาก URL ที่ให้ไว้
insertLine(line)Lineแทรกสำเนาของ Line ที่ให้ไว้ในหน้า
insertLine(lineCategory, startConnectionSite, endConnectionSite)Lineแทรกบรรทัดบนหน้าเว็บที่เชื่อมต่อ connection sites สองเส้น
insertLine(lineCategory, startLeft, startTop, endLeft, endTop)Lineแทรกบรรทัดในหน้าเว็บ
insertPageElement(pageElement)PageElementแทรกสำเนาของ PageElement ที่ให้ไว้ในหน้า
insertShape(shape)Shapeแทรกสำเนาของ Shape ที่ให้ไว้ในหน้า
insertShape(shapeType)Shapeแทรกรูปร่างในหน้าเว็บ
insertShape(shapeType, left, top, width, height)Shapeแทรกรูปร่างในหน้าเว็บ
insertSheetsChart(sourceChart)SheetsChartแทรกแผนภูมิ Google ชีตในหน้า
insertSheetsChart(sourceChart, left, top, width, height)SheetsChartแทรกแผนภูมิของ Google ชีตลงในหน้าเว็บตามตําแหน่งและขนาดที่ระบุ
insertSheetsChart(sheetsChart)SheetsChartแทรกสำเนาของ SheetsChart ที่ให้ไว้ในหน้า
insertSheetsChartAsImage(sourceChart)Imageแทรกแผนภูมิ Google ชีตเป็น Image ในหน้าเว็บ
insertSheetsChartAsImage(sourceChart, left, top, width, height)Imageแทรกแผนภูมิของ Google ชีตเป็น Image ในหน้าเว็บโดยมีตำแหน่งและขนาดที่ระบุไว้
insertTable(numRows, numColumns)Tableแทรกตารางในหน้านี้
insertTable(numRows, numColumns, left, top, width, height)Tableแทรกตารางในหน้าด้วยตำแหน่งและขนาดที่ให้ไว้
insertTable(table)Tableแทรกสำเนาของ Table ที่ให้ไว้ในหน้า
insertTextBox(text)Shapeแทรกกล่องข้อความ Shape ที่มีสตริงที่ระบุบนหน้าเว็บ
insertTextBox(text, left, top, width, height)Shapeแทรกกล่องข้อความ Shape ที่มีสตริงที่ระบุบนหน้าเว็บ
insertVideo(videoUrl)Videoแทรกวิดีโอที่มุมซ้ายบนของหน้าโดยใช้ขนาดเริ่มต้น
insertVideo(videoUrl, left, top, width, height)Videoแทรกวิดีโอในหน้าเว็บด้วยตำแหน่งและขนาดที่ให้ไว้
insertVideo(video)Videoแทรกสำเนาของ Video ที่ให้ไว้ในหน้า
insertWordArt(wordArt)WordArtแทรกสำเนาของ WordArt ที่ให้ไว้ในหน้า
remove()voidนำหน้าออก
replaceAllText(findText, replaceText)Integerแทนที่ทุกอินสแตนซ์ของการค้นหาข้อความที่ตรงกับการค้นหาด้วยการแทนที่ข้อความ
replaceAllText(findText, replaceText, matchCase)Integerแทนที่ทุกอินสแตนซ์ของการค้นหาข้อความที่ตรงกับการค้นหาด้วยการแทนที่ข้อความ
selectAsCurrentPage()voidเลือก Page ในงานนำเสนอที่ใช้งานอยู่เป็น current page selection และนำการเลือกก่อนหน้านี้ออก

เอกสารประกอบโดยละเอียด

getBackground()

รับพื้นหลังของหน้า

รีเทิร์น

PageBackground — พื้นหลังของหน้า

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getColorScheme()

รับ ColorScheme ที่เชื่อมโยงกับเพจ

รีเทิร์น

ColorScheme — รูปแบบสีของหน้าเว็บ

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getGroups()

แสดงรายการออบเจ็กต์ Group รายการในหน้าเว็บ

รีเทิร์น

Group[]

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getImages()

แสดงรายการออบเจ็กต์ Image รายการในหน้าเว็บ

รีเทิร์น

Image[]

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getLayouts()

รับเลย์เอาต์ของต้นแบบนี้

รีเทิร์น

Layout[]

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getLines()

แสดงรายการออบเจ็กต์ Line รายการในหน้าเว็บ

รีเทิร์น

Line[]

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getObjectId()

รับรหัสที่ไม่ซ้ำกันสำหรับหน้านั้น รหัสออบเจ็กต์ที่ใช้โดยหน้าเว็บและองค์ประกอบของหน้าใช้เนมสเปซเดียวกัน

รีเทิร์น

String

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getPageElementById(id)

แสดง PageElement ในหน้าเว็บที่มีรหัสที่ระบุ หรือ null หากไม่มี

พารามิเตอร์

ชื่อTypeคำอธิบาย
idStringรหัสขององค์ประกอบหน้าเว็บที่กำลังดึงข้อมูล

รีเทิร์น

PageElement — องค์ประกอบของหน้าที่มีรหัสที่กำหนด

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getPageElements()

แสดงรายการออบเจ็กต์ PageElement รายการที่แสดงผลในหน้า

รีเทิร์น

PageElement[]

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getPageType()

รับประเภทของหน้าเว็บ

รีเทิร์น

PageType — ประเภทหน้าเว็บ

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getPlaceholder(placeholderType)

แสดงผลออบเจ็กต์ PageElement ของตัวยึดตำแหน่งสำหรับ PlaceholderType หรือ null ที่ระบุ หากไม่มีตัวยึดตำแหน่งที่ตรงกัน

หากมีตัวยึดตำแหน่งหลายรายการที่มีประเภทเดียวกัน ระบบจะแสดงตัวยึดตำแหน่งที่มีดัชนีตัวยึดตำแหน่งน้อยที่สุด หากมีตัวยึดตำแหน่งหลายตัวที่ตรงกันซึ่งมีดัชนีเดียวกัน ก็จะแสดงตัวยึดตำแหน่งแรกจากคอลเล็กชันองค์ประกอบของหน้า 

var slide = SlidesApp.getActivePresentation().getSlides()[0];
var placeholder = slide.getPlaceholder(SlidesApp.PlaceholderType.CENTERED_TITLE);

พารามิเตอร์

ชื่อTypeคำอธิบาย
placeholderTypePlaceholderType

รีเทิร์น

PageElement

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getPlaceholder(placeholderType, placeholderIndex)

แสดงผลออบเจ็กต์ PageElement ของตัวยึดตำแหน่งสำหรับ PlaceholderType ที่ระบุและดัชนีตัวยึดตำแหน่ง หรือ null หากไม่มีตัวยึดตำแหน่ง

หากมีตัวยึดตำแหน่งหลายรายการที่มีประเภทและดัชนีเดียวกัน ระบบจะแสดงตัวยึดตำแหน่งแรกจากคอลเล็กชันองค์ประกอบของหน้าเว็บ 

var slide = SlidesApp.getActivePresentation().getSlides()[0];
var placeholder = slide.getPlaceholder(SlidesApp.PlaceholderType.CENTERED_TITLE, 0);

พารามิเตอร์

ชื่อTypeคำอธิบาย
placeholderTypePlaceholderType
placeholderIndexInteger

รีเทิร์น

PageElement

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getPlaceholders()

แสดงผลรายการออบเจ็กต์ PageElement ของตัวยึดตำแหน่งในหน้าเว็บ 

var master = SlidesApp.getActivePresentation().getMasters()[0];
Logger.log('Number of placeholders in the master: ' + master.getPlaceholders().length);

รีเทิร์น

PageElement[]

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getShapes()

แสดงรายการออบเจ็กต์ Shape รายการในหน้าเว็บ

รีเทิร์น

Shape[]

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getSheetsCharts()

แสดงรายการออบเจ็กต์ SheetsChart รายการในหน้าเว็บ

รีเทิร์น

SheetsChart[]

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getTables()

แสดงรายการออบเจ็กต์ Table รายการในหน้าเว็บ

รีเทิร์น

Table[]

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getVideos()

แสดงรายการออบเจ็กต์ Video รายการในหน้าเว็บ

รีเทิร์น

Video[]

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getWordArts()

แสดงรายการออบเจ็กต์ WordArt รายการในหน้าเว็บ

รีเทิร์น

WordArt[]

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

group(pageElements)

จัดกลุ่มองค์ประกอบของหน้าที่ระบุทั้งหมด

ในหน้าเดียวกันควรมีองค์ประกอบของหน้าอย่างน้อย 2 รายการที่ไม่ได้อยู่ในกลุ่มอื่น ระบบจัดกลุ่มองค์ประกอบบางอย่างของหน้าไม่ได้ เช่น Videos, Tables และ placeholder Shapes

พารามิเตอร์

ชื่อTypeคำอธิบาย
pageElementsPageElement[]องค์ประกอบที่จะจัดกลุ่มเข้าด้วยกัน

รีเทิร์น

Group — กลุ่มใหม่

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertGroup(group)

แทรกสำเนาของ Group ที่ให้ไว้ในหน้า

ตำแหน่งขององค์ประกอบที่แทรกในหน้านี้จะกำหนดจากตำแหน่งขององค์ประกอบแหล่งที่มาในหน้าที่เกี่ยวข้อง

หากองค์ประกอบที่มีให้เป็นตัวยึดตำแหน่งที่คัดลอกมาจากภายในงานนำเสนอปัจจุบัน พร็อพเพอร์ตี้ที่รับช่วงมาจากหน้าหลักหรือหน้าเลย์เอาต์ก็จะรับค่ามาจากองค์ประกอบที่แทรกด้วย

หากองค์ประกอบที่ให้ไว้เป็นตัวยึดตำแหน่งที่คัดลอกมาจากงานนำเสนออื่น ระบบจะคัดลอกพร็อพเพอร์ตี้ที่รับช่วงมาจากหน้าหลักหรือหน้าเลย์เอาต์จะคัดลอกไปยังองค์ประกอบจากงานนำเสนอต้นทาง 

// Copy a group between presentations.
var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0];
var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0];
var group = otherPresentationSlide.getGroups()[0];
currentPresentationSlide.insertGroup(group); // Also available for Layout, Master, and Page.

พารามิเตอร์

ชื่อTypeคำอธิบาย
groupGroupกลุ่มที่จะคัดลอกและแทรก

รีเทิร์น

Group — กลุ่มที่แทรก

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertImage(blobSource)

แทรกรูปภาพที่มุมซ้ายบนของหน้าโดยใช้ขนาดเริ่มต้นจาก BLOB รูปภาพที่ระบุ

การแทรกรูปภาพจะดึงข้อมูลจาก BlobSource 1 ครั้งและจะจัดเก็บสำเนาเพื่อแสดงภายในงานนำเสนอ รูปภาพต้องมีขนาดน้อยกว่า 50 MB ห้ามเกิน 25 เมกะพิกเซล และต้องอยู่ในรูปแบบ PNG, JPEG หรือ GIF อย่างใดอย่างหนึ่ง 

var slide = SlidesApp.getActivePresentation().getSlides()[0];
// Get the Drive image file with the given ID.
var image = DriveApp.getFileById(fileId);
slide.insertImage(image);

พารามิเตอร์

ชื่อTypeคำอธิบาย
blobSourceBlobSourceข้อมูลรูปภาพ

รีเทิร์น

Image — รูปภาพที่แทรก

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertImage(blobSource, left, top, width, height)

แทรกรูปภาพในหน้าเว็บด้วยตำแหน่งและขนาดที่ให้ไว้จาก BLOB รูปภาพที่ระบุ

ระบบจะดึงข้อมูลรูปภาพจาก BlobSource ที่ให้ไว้ 1 ครั้ง ณ เวลาที่แทรก และระบบจะจัดเก็บสำเนาไว้เพื่อแสดงภายในงานนำเสนอ รูปภาพต้องมีขนาดน้อยกว่า 50 MB ความละเอียดไม่เกิน 25 เมกะพิกเซล และต้องอยู่ในรูปแบบ PNG, JPEG หรือ GIF อย่างใดอย่างหนึ่ง

ในการรักษาอัตราส่วนของรูปภาพ ระบบจะปรับขนาดรูปภาพและจัดกึ่งกลางตามขนาดที่ระบุ 

var slide = SlidesApp.getActivePresentation().getSlides()[0];
// Get the Drive image file with the given ID.
var image = DriveApp.getFileById(fileId);
var position = {left: 0, top: 0};
var size = {width: 300, height: 100};
slide.insertImage(image, position.left, position.top, size.width, size.height);

พารามิเตอร์

ชื่อTypeคำอธิบาย
blobSourceBlobSourceข้อมูลรูปภาพ
leftNumberตำแหน่งแนวนอนของรูปภาพเป็นจุดซึ่งวัดจากมุมซ้ายบนของหน้า
topNumberตำแหน่งแนวตั้งของรูปภาพเป็นจุดซึ่งวัดจากมุมซ้ายบนของหน้า
widthNumberความกว้างของรูปภาพเป็นจุด
heightNumberความสูงของรูปภาพเป็นจุด

รีเทิร์น

Image — รูปภาพที่แทรก

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertImage(image)

แทรกสำเนาของ Image ที่ให้ไว้ในหน้า

ตำแหน่งของรูปภาพที่แทรกในหน้านี้จะพิจารณาจากตำแหน่งของรูปภาพต้นฉบับในหน้าที่เกี่ยวข้อง

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

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

// Copy an image between presentations.
var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0];
var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0];
var image = otherPresentationSlide.getImages[0];
currentPresentationSlide.insertImage(image);

พารามิเตอร์

ชื่อTypeคำอธิบาย
imageImageรูปภาพที่จะคัดลอกและแทรก

รีเทิร์น

Image — รูปภาพที่แทรก

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertImage(imageUrl)

แทรกรูปภาพที่มุมซ้ายบนของหน้าโดยใช้ขนาดเริ่มต้นจาก URL ที่ให้ไว้

การแทรกรูปภาพจะดึงข้อมูลจาก URL เพียงครั้งเดียวและจะเก็บสำเนาไว้เพื่อแสดงในงานนำเสนอ รูปภาพต้องมีขนาดน้อยกว่า 50 MB และต้องไม่เกิน 25 เมกะพิกเซล และต้องอยู่ในรูปแบบ PNG, JPEG หรือ GIF อย่างใดอย่างหนึ่ง

URL ที่ระบุต้องเข้าถึงได้แบบสาธารณะและมีขนาดไม่เกิน 2 KB ระบบจะบันทึก URL ไว้กับรูปภาพและแสดงผ่าน Image.getSourceUrl()

พารามิเตอร์

ชื่อTypeคำอธิบาย
imageUrlStringURL รูปภาพ

รีเทิร์น

Image — รูปภาพที่แทรก

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertImage(imageUrl, left, top, width, height)

แทรกรูปภาพในหน้าเว็บด้วยตำแหน่งและขนาดที่ให้ไว้จาก URL ที่ให้ไว้

การแทรกรูปภาพจะดึงข้อมูลจาก URL เพียงครั้งเดียวและจะเก็บสำเนาไว้เพื่อแสดงในงานนำเสนอ รูปภาพต้องมีขนาดน้อยกว่า 50 MB และต้องไม่เกิน 25 เมกะพิกเซล และต้องอยู่ในรูปแบบ PNG, JPEG หรือ GIF อย่างใดอย่างหนึ่ง

URL ที่ระบุต้องเข้าถึงได้แบบสาธารณะและมีขนาดไม่เกิน 2 KB ระบบจะบันทึก URL ไว้กับรูปภาพและแสดงผ่าน Image.getSourceUrl()

ในการรักษาอัตราส่วนของรูปภาพ ระบบจะปรับขนาดรูปภาพและจัดกึ่งกลางตามขนาดที่ระบุ

พารามิเตอร์

ชื่อTypeคำอธิบาย
imageUrlStringURL รูปภาพ
leftNumberตำแหน่งแนวนอนของรูปภาพเป็นจุดซึ่งวัดจากมุมซ้ายบนของหน้า
topNumberตำแหน่งแนวตั้งของรูปภาพเป็นจุดซึ่งวัดจากมุมซ้ายบนของหน้า
widthNumberความกว้างของรูปภาพเป็นจุด
heightNumberความสูงของรูปภาพเป็นจุด

รีเทิร์น

Image — รูปภาพที่แทรก

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertLine(line)

แทรกสำเนาของ Line ที่ให้ไว้ในหน้า

ตำแหน่งขององค์ประกอบที่แทรกในหน้านี้จะกำหนดจากตำแหน่งขององค์ประกอบแหล่งที่มาในหน้าที่เกี่ยวข้อง

หากองค์ประกอบที่มีให้เป็นตัวยึดตำแหน่งที่คัดลอกมาจากภายในงานนำเสนอปัจจุบัน พร็อพเพอร์ตี้ที่รับช่วงมาจากหน้าหลักหรือหน้าเลย์เอาต์ก็จะรับค่ามาจากองค์ประกอบที่แทรกด้วย

หากองค์ประกอบที่ให้ไว้เป็นตัวยึดตำแหน่งที่คัดลอกมาจากงานนำเสนออื่น ระบบจะคัดลอกพร็อพเพอร์ตี้ที่รับช่วงมาจากหน้าหลักหรือหน้าเลย์เอาต์จะคัดลอกไปยังองค์ประกอบจากงานนำเสนอต้นทาง 

// Copy a line between presentations.
var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0];
var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0];
var line = otherPresentationSlide.getLines[0];
currentPresentationSlide.insertLine(line);

พารามิเตอร์

ชื่อTypeคำอธิบาย
lineLineบรรทัดที่จะคัดลอกและแทรก

รีเทิร์น

Line — เส้นที่แทรก

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertLine(lineCategory, startConnectionSite, endConnectionSite)

แทรกบรรทัดบนหน้าเว็บที่เชื่อมต่อ connection sites สองเส้น เว็บไซต์การเชื่อมต่อ 2 เว็บไซต์ต้องอยู่ในหน้านี้ 

// Insert a line in the first slide of the presentation connecting two shapes.
var slide = SlidesApp.getActivePresentation().getSlides()[0];
var shape1 = slide.insertShape(SlidesApp.ShapeType.RECTANGLE);
var shape2 = slide.insertShape(SlidesApp.ShapeType.CLOUD);
slide.insertLine(
    SlidesApp.LineCategory.BENT,
    shape1.getConnectionSites()[0],
    shape2.getConnectionSites()[1]);

พารามิเตอร์

ชื่อTypeคำอธิบาย
lineCategoryLineCategoryหมวดหมู่ของเส้นที่จะแทรก
startConnectionSiteConnectionSiteเว็บไซต์การเชื่อมต่อที่จะเชื่อมต่อจุดเริ่มต้นของเส้น
endConnectionSiteConnectionSiteเว็บไซต์การเชื่อมต่อที่ปลายเส้นเชื่อมต่ออยู่

รีเทิร์น

Line — เส้นที่แทรก

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertLine(lineCategory, startLeft, startTop, endLeft, endTop)

แทรกบรรทัดในหน้าเว็บ 

// Insert a line in the first slide of the presentation.
var slide = SlidesApp.getActivePresentation().getSlides()[0];
var startPoint = {left: 10, top: 10};
var endPoint = {left: 40, top: 40};
slide.insertLine(
    SlidesApp.LineCategory.STRAIGHT,
    startPoint.left,
    startPoint.top,
    endPoint.left,
    endPoint.top);

พารามิเตอร์

ชื่อTypeคำอธิบาย
lineCategoryLineCategoryหมวดหมู่ของเส้นที่จะแทรก
startLeftNumberตำแหน่งแนวนอนของจุดเริ่มต้นของเส้น วัดเป็นจุดจากมุมซ้ายบนของหน้า
startTopNumberตำแหน่งแนวตั้งของจุดเริ่มต้นของเส้น วัดเป็นจุดจากมุมซ้ายบนของหน้า
endLeftNumberตำแหน่งแนวนอนของจุดสิ้นสุดของเส้น วัดเป็นจุดจากมุมซ้ายบนของหน้า
endTopNumberตำแหน่งแนวตั้งของจุดสิ้นสุดของเส้น วัดเป็นจุดจากมุมซ้ายบนของหน้า

รีเทิร์น

Line — เส้นที่แทรก

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertPageElement(pageElement)

แทรกสำเนาของ PageElement ที่ให้ไว้ในหน้า

ตำแหน่งขององค์ประกอบที่แทรกในหน้านี้จะกำหนดจากตำแหน่งขององค์ประกอบแหล่งที่มาในหน้าที่เกี่ยวข้อง

หากองค์ประกอบที่มีให้เป็นตัวยึดตำแหน่งที่คัดลอกมาจากภายในงานนำเสนอปัจจุบัน พร็อพเพอร์ตี้ที่รับช่วงมาจากหน้าหลักหรือหน้าเลย์เอาต์ก็จะรับค่ามาจากองค์ประกอบที่แทรกด้วย

หากองค์ประกอบที่ให้ไว้เป็นตัวยึดตำแหน่งที่คัดลอกมาจากงานนำเสนออื่น ระบบจะคัดลอกพร็อพเพอร์ตี้ที่รับช่วงมาจากหน้าหลักหรือหน้าเลย์เอาต์จะคัดลอกไปยังองค์ประกอบจากงานนำเสนอต้นทาง 

// Copy a page element between presentations.
var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0];
var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0];
var pageElement = otherPresentationSlide.getPageElements()[0];

// Also available for Layout, Master, and Page.
currentPresentationSlide.insertPageElement(pageElement);

พารามิเตอร์

ชื่อTypeคำอธิบาย
pageElementPageElementองค์ประกอบของหน้าที่จะคัดลอกและแทรก

รีเทิร์น

PageElement — องค์ประกอบของหน้าที่แทรก

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertShape(shape)

แทรกสำเนาของ Shape ที่ให้ไว้ในหน้า

ตำแหน่งขององค์ประกอบที่แทรกในหน้านี้จะกำหนดจากตำแหน่งขององค์ประกอบแหล่งที่มาในหน้าที่เกี่ยวข้อง

หากองค์ประกอบที่มีให้เป็นตัวยึดตำแหน่งที่คัดลอกมาจากภายในงานนำเสนอปัจจุบัน พร็อพเพอร์ตี้ที่รับช่วงมาจากหน้าหลักหรือหน้าเลย์เอาต์ก็จะรับค่ามาจากองค์ประกอบที่แทรกด้วย

หากองค์ประกอบที่ให้ไว้เป็นตัวยึดตำแหน่งที่คัดลอกมาจากงานนำเสนออื่น ระบบจะคัดลอกพร็อพเพอร์ตี้ที่รับช่วงมาจากหน้าหลักหรือหน้าเลย์เอาต์จะคัดลอกไปยังองค์ประกอบจากงานนำเสนอต้นทาง 

// Copy a shape between presentations.
var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0];
var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0];
var shape = otherPresentationSlide.getShapes[0];
currentPresentationSlide.insertShape(shape); // Also available for Layout, Master, and Page.

พารามิเตอร์

ชื่อTypeคำอธิบาย
shapeShapeรูปร่างที่จะคัดลอกและแทรก

รีเทิร์น

Shape — รูปร่างที่แทรก

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertShape(shapeType)

แทรกรูปร่างในหน้าเว็บ

ระบบจะแทรกรูปร่างโดยใช้ขนาดเริ่มต้นที่มุมซ้ายบนของหน้า 

// Insert a shape in the first slide of the presentation.
var slide = SlidesApp.getActivePresentation().getSlides()[0];

// Also available for Layout, Master, and Page.
slide.insertShape(SlidesApp.ShapeType.RECTANGLE);

พารามิเตอร์

ชื่อTypeคำอธิบาย
shapeTypeShapeTypeประเภทของรูปร่างที่จะแทรก

รีเทิร์น

Shape — รูปร่างที่แทรก

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertShape(shapeType, left, top, width, height)

แทรกรูปร่างในหน้าเว็บ

พารามิเตอร์

ชื่อTypeคำอธิบาย
shapeTypeShapeTypeประเภทของรูปร่างที่จะแทรก
leftNumberตำแหน่งแนวนอนของรูปร่างซึ่งวัดจากมุมซ้ายบนของหน้า
topNumberตำแหน่งแนวตั้งของรูปร่างซึ่งวัดจากมุมซ้ายบนของหน้า
widthNumberความกว้างของรูปร่าง
heightNumberความสูงของรูปร่าง

รีเทิร์น

Shape — รูปร่างที่แทรก

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertSheetsChart(sourceChart)

แทรกแผนภูมิ Google ชีตในหน้า

ระบบจะแทรกแผนภูมิตามขนาดเริ่มต้นที่มุมซ้ายบนของหน้า

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

var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
var chart = sheet.getCharts()[0];
// Insert the spreadsheet chart in the first slide.
var slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.insertSheetsChart(chart);

พารามิเตอร์

ชื่อTypeคำอธิบาย
sourceChartEmbeddedChartแผนภูมิในสเปรดชีตที่จะแทรกในหน้า

รีเทิร์น

SheetsChart — แผนภูมิที่แทรกไว้ในหน้า

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertSheetsChart(sourceChart, left, top, width, height)

แทรกแผนภูมิของ Google ชีตลงในหน้าเว็บตามตําแหน่งและขนาดที่ระบุ

เพื่อรักษาอัตราส่วนของแผนภูมิ แผนภูมิจะถูกปรับขนาดและจัดกึ่งกลางตามขนาดที่ระบุ

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

var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
var chart = sheet.getCharts()[0];
// Insert the spreadsheet chart in the first slide.
var slide = SlidesApp.getActivePresentation().getSlides()[0];
var position = {left: 0, top: 0};
var size = {width: 200, height: 200};

// Also available for Layout, Master, and Page.
slide.insertSheetsChart(
    chart,
    position.left,
    position.top,
    size.width,
    size.height);

พารามิเตอร์

ชื่อTypeคำอธิบาย
sourceChartEmbeddedChartแผนภูมิในสเปรดชีตที่จะแทรกในหน้า
leftNumberตำแหน่งแนวนอนของแผนภูมิเป็นจุดซึ่งวัดจากมุมซ้ายบนของหน้า
topNumberตำแหน่งแนวตั้งของแผนภูมิเป็นจุดซึ่งวัดจากมุมซ้ายบนของหน้า
widthNumberความกว้างของแผนภูมิเป็นจุด
heightNumberความสูงของแผนภูมิในหน่วยคะแนน

รีเทิร์น

SheetsChart — แผนภูมิที่แทรกไว้ในหน้า

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertSheetsChart(sheetsChart)

แทรกสำเนาของ SheetsChart ที่ให้ไว้ในหน้า

ตำแหน่งขององค์ประกอบที่แทรกในหน้านี้จะกำหนดจากตำแหน่งขององค์ประกอบแหล่งที่มาในหน้าที่เกี่ยวข้อง

หากองค์ประกอบที่มีให้เป็นตัวยึดตำแหน่งที่คัดลอกมาจากภายในงานนำเสนอปัจจุบัน พร็อพเพอร์ตี้ที่รับช่วงมาจากหน้าหลักหรือหน้าเลย์เอาต์ก็จะรับค่ามาจากองค์ประกอบที่แทรกด้วย

หากองค์ประกอบที่ให้ไว้เป็นตัวยึดตำแหน่งที่คัดลอกมาจากงานนำเสนออื่น ระบบจะคัดลอกพร็อพเพอร์ตี้ที่รับช่วงมาจากหน้าหลักหรือหน้าเลย์เอาต์จะคัดลอกไปยังองค์ประกอบจากงานนำเสนอต้นทาง 

// Copy a sheets chart between presentations.
var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0];
var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0];
var sheetsChart = otherPresentationSlide.getSheetsCharts[0];

// Also available for Layout, Master, and Page.
currentPresentationSlide.insertSheetsChart(sheetsChart);

พารามิเตอร์

ชื่อTypeคำอธิบาย
sheetsChartSheetsChartแผนภูมิของชีตที่จะคัดลอกและแทรก

รีเทิร์น

SheetsChart — แผนภูมิชีตที่แทรก

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertSheetsChartAsImage(sourceChart)

แทรกแผนภูมิ Google ชีตเป็น Image ในหน้าเว็บ

ระบบจะแทรกรูปภาพของแผนภูมิด้วยขนาดเริ่มต้นที่มุมซ้ายบนของหน้า

รูปภาพแผนภูมิที่แทรกไม่ได้ลิงก์กับแผนภูมิต้นฉบับใน Google ชีต 

var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
var chart = sheet.getCharts()[0];
// Insert the spreadsheet chart in the first slide.
var slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.insertSheetsChartAsImage(chart); // Also available for Layout, Master, and Page.

พารามิเตอร์

ชื่อTypeคำอธิบาย
sourceChartEmbeddedChartแผนภูมิในสเปรดชีตที่จะแทรกในหน้า

รีเทิร์น

Image — รูปภาพที่แทรกของแผนภูมิในหน้า

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertSheetsChartAsImage(sourceChart, left, top, width, height)

แทรกแผนภูมิของ Google ชีตเป็น Image ในหน้าเว็บโดยมีตำแหน่งและขนาดที่ระบุไว้

ในการรักษาอัตราส่วนของรูปภาพแผนภูมิ ระบบจะปรับขนาดรูปภาพและจัดกึ่งกลางตามขนาดที่ระบุ

รูปภาพที่แทรกของแผนภูมิไม่ได้ลิงก์กับแผนภูมิต้นฉบับใน Google ชีต 

var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
var chart = sheet.getCharts()[0];
// Insert the spreadsheet chart in the first slide.
var slide = SlidesApp.getActivePresentation().getSlides()[0];
var position = {left: 0, top: 0};
var size = {width: 200, height: 200};

// Also available for Layout, Master, and Page.
slide.insertSheetsChartAsImage(
    chart,
    position.left,
    position.right,
    size.width,
    size.height);

พารามิเตอร์

ชื่อTypeคำอธิบาย
sourceChartEmbeddedChartแผนภูมิในสเปรดชีตที่จะแทรกในหน้า
leftNumberตำแหน่งแนวนอนของแผนภูมิเป็นจุดซึ่งวัดจากมุมซ้ายบนของหน้า
topNumberตำแหน่งแนวตั้งของแผนภูมิเป็นจุดซึ่งวัดจากมุมซ้ายบนของหน้า
widthNumberความกว้างของแผนภูมิเป็นจุด
heightNumberความสูงของแผนภูมิในหน่วยคะแนน

รีเทิร์น

Image — รูปภาพที่แทรกของแผนภูมิในหน้า

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertTable(numRows, numColumns)

แทรกตารางในหน้านี้

ตารางจะอยู่ตรงกลางของหน้าที่มีขนาดเริ่มต้น รวมถึงแถวและคอลัมน์ที่กระจายอย่างเท่าๆ กัน

พารามิเตอร์

ชื่อTypeคำอธิบาย
numRowsIntegerจำนวนแถวในตาราง
numColumnsIntegerจำนวนคอลัมน์ในตาราง

รีเทิร์น

Table — ตารางที่แทรก

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertTable(numRows, numColumns, left, top, width, height)

แทรกตารางในหน้าด้วยตำแหน่งและขนาดที่ให้ไว้

แถวและคอลัมน์จะกระจายอย่างเท่าๆ กันในตารางที่สร้างขึ้น

พารามิเตอร์

ชื่อTypeคำอธิบาย
numRowsIntegerจำนวนแถวในตาราง
numColumnsIntegerจำนวนคอลัมน์ในตาราง
leftNumberตำแหน่งแนวนอนของตารางซึ่งวัดจากมุมซ้ายบนของหน้า
topNumberตำแหน่งแนวตั้งของตารางซึ่งวัดจากมุมซ้ายบนของหน้า
widthNumberความกว้างของตาราง
heightNumberความสูงขั้นต่ำของตาราง ความสูงจริงของตารางที่แสดงผลขึ้นอยู่กับปัจจัยต่างๆ เช่น ขนาดตัวอักษรของข้อความ

รีเทิร์น

Table — ตารางที่แทรก

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertTable(table)

แทรกสำเนาของ Table ที่ให้ไว้ในหน้า

ตำแหน่งขององค์ประกอบที่แทรกในหน้านี้จะกำหนดจากตำแหน่งขององค์ประกอบแหล่งที่มาในหน้าที่เกี่ยวข้อง

หากองค์ประกอบที่มีให้เป็นตัวยึดตำแหน่งที่คัดลอกมาจากภายในงานนำเสนอปัจจุบัน พร็อพเพอร์ตี้ที่รับช่วงมาจากหน้าหลักหรือหน้าเลย์เอาต์ก็จะรับค่ามาจากองค์ประกอบที่แทรกด้วย

หากองค์ประกอบที่ให้ไว้เป็นตัวยึดตำแหน่งที่คัดลอกมาจากงานนำเสนออื่น ระบบจะคัดลอกพร็อพเพอร์ตี้ที่รับช่วงมาจากหน้าหลักหรือหน้าเลย์เอาต์จะคัดลอกไปยังองค์ประกอบจากงานนำเสนอต้นทาง 

// Copy a table between presentations.
var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0];
var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0];
var table = otherPresentationSlide.getTables[0];
currentPresentationSlide.insertTable(table); // Also available for Layout, Master, and Page.

พารามิเตอร์

ชื่อTypeคำอธิบาย
tableTableตารางที่จะคัดลอกและแทรก

รีเทิร์น

Table — ตารางที่แทรก

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertTextBox(text)

แทรกกล่องข้อความ Shape ที่มีสตริงที่ระบุบนหน้าเว็บ

รูปร่างของกล่องข้อความจะถูกแทรกตามขนาดเริ่มต้นที่มุมซ้ายบนของหน้า 

// Insert text box with "Hello" on the first slide of presentation.
var slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.insertTextBox('Hello'); // Also available for Layout, Master, and Page.

พารามิเตอร์

ชื่อTypeคำอธิบาย
textStringสตริงที่รูปร่างกล่องข้อความควรมี

รีเทิร์น

Shape — รูปร่างของกล่องข้อความที่แทรก

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertTextBox(text, left, top, width, height)

แทรกกล่องข้อความ Shape ที่มีสตริงที่ระบุบนหน้าเว็บ 

// Insert text box with "Hello" on the first slide of presentation. This text box is a square
// with a length of 10 points on each side.
var slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.insertTextBox('Hello', 0, 0, 10, 10); // Also available for Layout, Master, and Page.

พารามิเตอร์

ชื่อTypeคำอธิบาย
textStringสตริงที่รูปร่างกล่องข้อความควรมี
leftNumberตำแหน่งแนวนอนของรูปร่างกล่องข้อความซึ่งวัดจากมุมซ้ายบนของหน้า
topNumberตำแหน่งแนวตั้งของรูปร่างกล่องข้อความซึ่งวัดจากมุมซ้ายบนของหน้า
widthNumberความกว้างของรูปร่างกล่องข้อความ
heightNumberความสูงของรูปร่างกล่องข้อความ

รีเทิร์น

Shape — รูปร่างของกล่องข้อความที่แทรก

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertVideo(videoUrl)

แทรกวิดีโอที่มุมซ้ายบนของหน้าโดยใช้ขนาดเริ่มต้น

ขณะนี้รองรับเฉพาะวิดีโอ YouTube เท่านั้น

พารามิเตอร์

ชื่อTypeคำอธิบาย
videoUrlStringURL ของวิดีโอที่จะแทรก

รีเทิร์น

Video — วิดีโอที่แทรก

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertVideo(videoUrl, left, top, width, height)

แทรกวิดีโอในหน้าเว็บด้วยตำแหน่งและขนาดที่ให้ไว้

ขณะนี้รองรับเฉพาะวิดีโอ YouTube เท่านั้น

พารามิเตอร์

ชื่อTypeคำอธิบาย
videoUrlStringURL ของวิดีโอที่จะแทรก
leftNumberตำแหน่งแนวนอนของวิดีโอเป็นจุดซึ่งวัดจากมุมซ้ายบนของหน้า
topNumberตำแหน่งแนวตั้งของวิดีโอเป็นจุดซึ่งวัดจากมุมซ้ายบนของหน้า
widthNumberความกว้างของวิดีโอเป็นจุด
heightNumberความสูงของวิดีโอเป็นจุด

รีเทิร์น

Video — วิดีโอที่แทรก

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertVideo(video)

แทรกสำเนาของ Video ที่ให้ไว้ในหน้า

ตำแหน่งขององค์ประกอบที่แทรกในหน้านี้จะกำหนดจากตำแหน่งขององค์ประกอบแหล่งที่มาในหน้าที่เกี่ยวข้อง

หากองค์ประกอบที่มีให้เป็นตัวยึดตำแหน่งที่คัดลอกมาจากภายในงานนำเสนอปัจจุบัน พร็อพเพอร์ตี้ที่รับช่วงมาจากหน้าหลักหรือหน้าเลย์เอาต์ก็จะรับค่ามาจากองค์ประกอบที่แทรกด้วย

หากองค์ประกอบที่ให้ไว้เป็นตัวยึดตำแหน่งที่คัดลอกมาจากงานนำเสนออื่น ระบบจะคัดลอกพร็อพเพอร์ตี้ที่รับช่วงมาจากหน้าหลักหรือหน้าเลย์เอาต์จะคัดลอกไปยังองค์ประกอบจากงานนำเสนอต้นทาง 

// Copy a video between presentations.
var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0];
var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0];
var video = otherPresentationSlide.getVideos[0];
currentPresentationSlide.insertVideo(video); // Also available for Layout, Master, and Page.

พารามิเตอร์

ชื่อTypeคำอธิบาย
videoVideoวิดีโอที่จะคัดลอกและแทรก

รีเทิร์น

Video — วิดีโอที่แทรก

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

insertWordArt(wordArt)

แทรกสำเนาของ WordArt ที่ให้ไว้ในหน้า

ตำแหน่งขององค์ประกอบที่แทรกในหน้านี้จะกำหนดจากตำแหน่งขององค์ประกอบแหล่งที่มาในหน้าที่เกี่ยวข้อง

หากองค์ประกอบที่มีให้เป็นตัวยึดตำแหน่งที่คัดลอกมาจากภายในงานนำเสนอปัจจุบัน พร็อพเพอร์ตี้ที่รับช่วงมาจากหน้าหลักหรือหน้าเลย์เอาต์ก็จะรับค่ามาจากองค์ประกอบที่แทรกด้วย

หากองค์ประกอบที่ให้ไว้เป็นตัวยึดตำแหน่งที่คัดลอกมาจากงานนำเสนออื่น ระบบจะคัดลอกพร็อพเพอร์ตี้ที่รับช่วงมาจากหน้าหลักหรือหน้าเลย์เอาต์จะคัดลอกไปยังองค์ประกอบจากงานนำเสนอต้นทาง 

// Copy a word art between presentations.
var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0];
var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0];
var wordArt = otherPresentationSlide.getWordArts[0];

// Also available for Layout, Master, and Page.
currentPresentationSlide.insertWordArt(wordArt);

พารามิเตอร์

ชื่อTypeคำอธิบาย
wordArtWordArtกลุ่มที่จะคัดลอกและแทรก

รีเทิร์น

WordArt — ข้อความศิลป์ที่แทรกไว้

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

remove()

นำหน้าออก

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

replaceAllText(findText, replaceText)

แทนที่ทุกอินสแตนซ์ของการค้นหาข้อความที่ตรงกับการค้นหาด้วยการแทนที่ข้อความ การค้นหานี้ไม่คำนึงถึงตัวพิมพ์เล็กหรือใหญ่

พารามิเตอร์

ชื่อTypeคำอธิบาย
findTextStringข้อความที่จะค้นหา
replaceTextStringข้อความที่จะแทนที่ข้อความที่ตรงกัน

รีเทิร์น

Integer — จำนวนครั้งที่เปลี่ยนแปลง

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

replaceAllText(findText, replaceText, matchCase)

แทนที่ทุกอินสแตนซ์ของการค้นหาข้อความที่ตรงกับการค้นหาด้วยการแทนที่ข้อความ

พารามิเตอร์

ชื่อTypeคำอธิบาย
findTextStringข้อความที่จะค้นหา
replaceTextStringข้อความที่จะแทนที่ข้อความที่ตรงกัน
matchCaseBooleanหากเป็น true การค้นหาจะคำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ หากเป็น false การค้นหาจะไม่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่

รีเทิร์น

Integer — จำนวนครั้งที่เปลี่ยนแปลง

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

selectAsCurrentPage()

เลือก Page ในงานนำเสนอที่ใช้งานอยู่เป็น current page selection และนำการเลือกก่อนหน้านี้ออก

สคริปต์จะเข้าถึงการเลือกของผู้ใช้ที่เรียกใช้สคริปต์ได้เท่านั้น และในกรณีที่สคริปต์เชื่อมโยงกับงานนำเสนอเท่านั้น 

// Select the first slide as the current page selection and replace any previous selection.
var slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.selectAsCurrentPage(); // Also available for Layout, Master, and Page.

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations