Class Slide

สไลด์

สไลด์ในงานนำเสนอ

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

เมธอด

วิธีการ	ประเภทการแสดงผล	รายละเอียดแบบย่อ
duplicate()	Slide	ทำสำเนาสไลด์
getBackground()	PageBackground	รับพื้นหลังของหน้า
getColorScheme()	ColorScheme	รับ ColorScheme ที่เชื่อมโยงกับหน้าเว็บ
getGroups()	Group[]	แสดงรายการ Group วัตถุในหน้า
getImages()	Image[]	แสดงรายการ Image วัตถุในหน้า
getLayout()	Layout	รับเลย์เอาต์ที่ใช้กับสไลด์หรือ null หากสไลด์ไม่ได้อิงตามเลย์เอาต์
getLines()	Line[]	แสดงรายการ Line วัตถุในหน้า
getNotesPage()	NotesPage	แสดงหน้าโน้ตที่เชื่อมโยงกับสไลด์
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 วัตถุในหน้า
getSlideLinkingMode()	SlideLinkingMode	แสดงผล SlideLinkingMode ซึ่งระบุว่าสไลด์ลิงก์กับสไลด์อื่นหรือไม่
getSourcePresentationId()	String	แสดงรหัส Presentation หรือ null ของแหล่งที่มา หากไม่ได้ลิงก์สไลด์
getSourceSlideObjectId()	String	แสดงรหัสสไลด์ต้นทางหรือ null หากไม่ได้ลิงก์สไลด์
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 2 รายการ
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 ที่ระบุไว้ในหน้า
isSkipped()	Boolean	แสดงผลว่าระบบข้ามสไลด์ในโหมดการนำเสนอหรือไม่
move(index)	void	ย้ายสไลด์ไปยังดัชนีที่ระบุ
refreshSlide()	void	รีเฟรชสไลด์เพื่อให้แสดงการเปลี่ยนแปลงที่ทำกับสไลด์ต้นฉบับที่ลิงก์
remove()	void	นำหน้าเว็บออก
replaceAllText(findText, replaceText)	Integer	แทนที่อินสแตนซ์ทั้งหมดของข้อความที่ตรงกับข้อความค้นหาด้วยข้อความแทนที่
replaceAllText(findText, replaceText, matchCase)	Integer	แทนที่อินสแตนซ์ทั้งหมดของข้อความที่ตรงกับข้อความค้นหาด้วยข้อความแทนที่
selectAsCurrentPage()	void	เลือก Page ในการแสดงผลที่ใช้งานอยู่เป็น current page selection และนำการเลือกก่อนหน้าออก
setSkipped(isSkipped)	void	ตั้งค่าว่าจะข้ามสไลด์ในโหมดการนำเสนอหรือไม่
unlink()	void	ยกเลิกการลิงก์ Slide ปัจจุบันจากสไลด์ต้นทาง

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

duplicate()

ทำสำเนาสไลด์

ระบบจะสร้างสไลด์ที่ซ้ำกันต่อจากสไลด์ต้นฉบับทันที

รีเทิร์น

Slide — สไลด์ที่ทำสำเนา

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

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

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

---

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

---

getLayout()

รับเลย์เอาต์ที่ใช้กับสไลด์หรือ null หากสไลด์ไม่ได้อิงตามเลย์เอาต์

รีเทิร์น

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

---

getNotesPage()

แสดงหน้าโน้ตที่เชื่อมโยงกับสไลด์

รีเทิร์น

NotesPage

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

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 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 หากไม่มี

พารามิเตอร์

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

รีเทิร์น

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 ที่ระบุ หากไม่มีตัวยึดตําแหน่งตรงกัน

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

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
placeholderType	PlaceholderType

รีเทิร์น

PageElement

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

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

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

---

getPlaceholder(placeholderType, placeholderIndex)

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

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

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
placeholderType	PlaceholderType
placeholderIndex	Integer

รีเทิร์น

PageElement

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

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

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

---

getPlaceholders()

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

const 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

---

getSlideLinkingMode()

แสดงผล SlideLinkingMode ซึ่งระบุว่าสไลด์ลิงก์กับสไลด์อื่นหรือไม่

รีเทิร์น

SlideLinkingMode — โหมดการลิงก์สไลด์

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

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

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

---

getSourcePresentationId()

แสดงรหัส Presentation หรือ null ของแหล่งที่มา หากไม่ได้ลิงก์สไลด์

สไลด์จะมีรหัส Presentation ต้นทางก็ต่อเมื่อลิงก์กับสไลด์ภายในงานนำเสนออื่นเท่านั้น

รีเทิร์น

String — รหัสการแสดงผลต้นทางหรือ null

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

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

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

---

getSourceSlideObjectId()

แสดงรหัสสไลด์ต้นทางหรือ null หากไม่ได้ลิงก์สไลด์

สไลด์จะมีรหัสสไลด์ต้นทางก็ต่อเมื่อลิงก์กับสไลด์ภายในงานนำเสนออื่น

รีเทิร์น

String — รหัสสไลด์ต้นทางหรือ null

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

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 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 จะจัดกลุ่มไม่ได้

พารามิเตอร์

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

รีเทิร์น

Group — กลุ่มใหม่

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

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

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

---

insertGroup(group)

แทรกสําเนา Group ที่ระบุไว้ในหน้า

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

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

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

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
group	Group	กลุ่มที่จะคัดลอกและแทรก

รีเทิร์น

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

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

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

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

---

insertImage(blobSource)

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

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

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
blobSource	BlobSource	ข้อมูลรูปภาพ

รีเทิร์น

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

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

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
blobSource	BlobSource	ข้อมูลรูปภาพ
left	Number	ตำแหน่งแนวนอนของรูปภาพเป็นจุด ซึ่งวัดจากมุมซ้ายบนของหน้า
top	Number	ตำแหน่งแนวตั้งของรูปภาพเป็นจุด ซึ่งวัดจากมุมซ้ายบนของหน้า
width	Number	ความกว้างของรูปภาพเป็นจุด
height	Number	ความสูงของรูปภาพเป็นจุด

รีเทิร์น

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

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

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

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

---

insertImage(image)

แทรกสําเนา Image ที่ระบุไว้ในหน้า

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

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

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

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

พารามิเตอร์

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

รีเทิร์น

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()

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
imageUrl	String	URL ของรูปภาพ

รีเทิร์น

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()

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
imageUrl	String	URL ของรูปภาพ
left	Number	ตำแหน่งแนวนอนของรูปภาพเป็นจุด ซึ่งวัดจากมุมซ้ายบนของหน้า
top	Number	ตำแหน่งแนวตั้งของรูปภาพเป็นจุด ซึ่งวัดจากมุมซ้ายบนของหน้า
width	Number	ความกว้างของรูปภาพเป็นจุด
height	Number	ความสูงของรูปภาพเป็นจุด

รีเทิร์น

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

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

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

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

---

insertLine(line)

แทรกสําเนา Line ที่ระบุไว้ในหน้า

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

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

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

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
line	Line	บรรทัดที่คัดลอกและแทรก

รีเทิร์น

Line — บรรทัดที่แทรก

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

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

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

---

insertLine(lineCategory, startConnectionSite, endConnectionSite)

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

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
lineCategory	LineCategory	หมวดหมู่ของบรรทัดที่จะแทรก
startConnectionSite	ConnectionSite	ตำแหน่งการเชื่อมต่อที่จะเชื่อมต่อจุดเริ่มต้นของเส้น
endConnectionSite	ConnectionSite	จุดเชื่อมต่อที่จะต่อปลายสาย

รีเทิร์น

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.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
const startPoint = {
  left: 10,
  top: 10
};
const endPoint = {
  left: 40,
  top: 40
};
slide.insertLine(
    SlidesApp.LineCategory.STRAIGHT,
    startPoint.left,
    startPoint.top,
    endPoint.left,
    endPoint.top,
);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
lineCategory	LineCategory	หมวดหมู่ของบรรทัดที่จะแทรก
startLeft	Number	ตำแหน่งแนวนอนของจุดเริ่มต้นของเส้น ซึ่งวัดเป็นจุดจากมุมซ้ายบนของหน้า
startTop	Number	ตำแหน่งแนวตั้งของจุดเริ่มต้นของเส้น ซึ่งวัดเป็นจุดจากมุมซ้ายบนของหน้า
endLeft	Number	ตำแหน่งแนวนอนของจุดสิ้นสุดของเส้น ซึ่งวัดเป็นจุดจากมุมซ้ายบนของหน้า
endTop	Number	ตำแหน่งแนวตั้งของจุดสิ้นสุดของเส้น ซึ่งวัดเป็นจุดจากมุมซ้ายบนของหน้า

รีเทิร์น

Line — บรรทัดที่แทรก

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

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

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

---

insertPageElement(pageElement)

แทรกสําเนา PageElement ที่ระบุไว้ในหน้า

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

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

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

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

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
pageElement	PageElement	องค์ประกอบหน้าเว็บที่จะคัดลอกและแทรก

รีเทิร์น

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

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

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

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

---

insertShape(shape)

แทรกสําเนา Shape ที่ระบุไว้ในหน้า

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

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

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

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

พารามิเตอร์

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

รีเทิร์น

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.
const slide = SlidesApp.getActivePresentation().getSlides()[0];

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

---

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

แทรกรูปร่างในหน้า

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
shapeType	ShapeType	ประเภทของรูปร่างที่จะแทรก
left	Number	ตำแหน่งแนวนอนของรูปร่าง ซึ่งวัดจากมุมซ้ายบนของหน้า
top	Number	ตำแหน่งแนวตั้งของรูปร่าง ซึ่งวัดจากมุมซ้ายบนของหน้า
width	Number	ความกว้างของรูปร่าง
height	Number	ความสูงของรูปร่าง

รีเทิร์น

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

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

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

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

---

insertSheetsChart(sourceChart)

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

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

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

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

---

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

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

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

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

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

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
sourceChart	EmbeddedChart	แผนภูมิในสเปรดชีตที่จะแทรกในหน้า
left	Number	ตำแหน่งแนวนอนของแผนภูมิเป็นจุด ซึ่งวัดจากมุมซ้ายบนของหน้า
top	Number	ตำแหน่งแนวตั้งของแผนภูมิเป็นจุด ซึ่งวัดจากมุมซ้ายบนของหน้า
width	Number	ความกว้างของแผนภูมิเป็นจุด
height	Number	ความสูงของแผนภูมิเป็นจุด

รีเทิร์น

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

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

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

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

---

insertSheetsChart(sheetsChart)

แทรกสําเนา SheetsChart ที่ระบุไว้ในหน้า

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

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

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

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

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
sheetsChart	SheetsChart	แผนภูมิชีตที่จะคัดลอกและแทรก

รีเทิร์น

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

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

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

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

---

insertSheetsChartAsImage(sourceChart)

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

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

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

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

---

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

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

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

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

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

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
sourceChart	EmbeddedChart	แผนภูมิในสเปรดชีตที่จะแทรกในหน้า
left	Number	ตำแหน่งแนวนอนของแผนภูมิเป็นจุด ซึ่งวัดจากมุมซ้ายบนของหน้า
top	Number	ตำแหน่งแนวตั้งของแผนภูมิเป็นจุด ซึ่งวัดจากมุมซ้ายบนของหน้า
width	Number	ความกว้างของแผนภูมิเป็นจุด
height	Number	ความสูงของแผนภูมิเป็นจุด

รีเทิร์น

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

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

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

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

---

insertTable(numRows, numColumns)

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

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
numRows	Integer	จํานวนแถวในตาราง
numColumns	Integer	จํานวนคอลัมน์ในตาราง

รีเทิร์น

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

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

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

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

---

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

แทรกตารางในหน้าเว็บด้วยตําแหน่งและขนาดที่ระบุ

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
numRows	Integer	จํานวนแถวในตาราง
numColumns	Integer	จํานวนคอลัมน์ในตาราง
left	Number	ตำแหน่งแนวนอนของตาราง ซึ่งวัดจากมุมซ้ายบนของหน้า
top	Number	ตำแหน่งแนวตั้งของตาราง ซึ่งวัดจากมุมซ้ายบนของหน้า
width	Number	ความกว้างของตาราง
height	Number	ความสูงขั้นต่ำของตาราง ความสูงจริงของตารางที่แสดงผลจะขึ้นอยู่กับปัจจัยต่างๆ เช่น ขนาดแบบอักษรของข้อความ

รีเทิร์น

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

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

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

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

---

insertTable(table)

แทรกสําเนา Table ที่ระบุไว้ในหน้า

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

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

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

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
table	Table	ตารางที่จะคัดลอกและแทรก

รีเทิร์น

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.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.insertTextBox('Hello');  // Also available for Layout, Master, and Page.

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
text	String	สตริงที่รูปร่างกล่องข้อความควรมี

รีเทิร์น

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.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.insertTextBox(
    'Hello', 0, 0, 10, 10);  // Also available for Layout, Master, and Page.

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
text	String	สตริงที่รูปร่างกล่องข้อความควรมี
left	Number	ตำแหน่งแนวนอนของรูปร่างกล่องข้อความ ซึ่งวัดจากมุมซ้ายบนของหน้า
top	Number	ตำแหน่งแนวตั้งของรูปร่างกล่องข้อความ ซึ่งวัดจากมุมซ้ายบนของหน้า
width	Number	ความกว้างของรูปร่างกล่องข้อความ
height	Number	ความสูงของรูปร่างกล่องข้อความ

รีเทิร์น

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

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

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

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

---

insertVideo(videoUrl)

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

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
videoUrl	String	URL ของวิดีโอที่จะแทรก

รีเทิร์น

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

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

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

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

---

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

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

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
videoUrl	String	URL ของวิดีโอที่จะแทรก
left	Number	ตำแหน่งแนวนอนของวิดีโอเป็นจุด ซึ่งวัดจากมุมซ้ายบนของหน้า
top	Number	ตำแหน่งแนวตั้งของวิดีโอเป็นจุด ซึ่งวัดจากมุมซ้ายบนของหน้า
width	Number	ความกว้างของวิดีโอเป็นจุด
height	Number	ความสูงของวิดีโอเป็นจุด

รีเทิร์น

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

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

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

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

---

insertVideo(video)

แทรกสําเนา Video ที่ระบุไว้ในหน้า

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

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

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

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
video	Video	วิดีโอที่จะคัดลอกและแทรก

รีเทิร์น

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

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

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

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

---

insertWordArt(wordArt)

แทรกสําเนา WordArt ที่ระบุไว้ในหน้า

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

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

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

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

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
wordArt	WordArt	กลุ่มที่จะคัดลอกและแทรก

รีเทิร์น

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

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

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

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

---

isSkipped()

แสดงผลว่าระบบข้ามสไลด์ในโหมดการนำเสนอหรือไม่

รีเทิร์น

Boolean — True หากระบบข้ามสไลด์ในโหมดการนำเสนอ

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

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

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

---

move(index)

ย้ายสไลด์ไปยังดัชนีที่ระบุ

พารามิเตอร์

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

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

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

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

---

refreshSlide()

รีเฟรชสไลด์เพื่อให้แสดงการเปลี่ยนแปลงที่ทำกับสไลด์ต้นฉบับที่ลิงก์ หากสไลด์นี้ไม่ได้ลิงก์ไว้ ระบบจะแสดงผลโดยไม่มีการทําการเปลี่ยนแปลงใดๆ

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

หมายเหตุ: การรีเฟรชจะเขียนทับการเปลี่ยนแปลงที่ทำกับสไลด์ปัจจุบันเพื่อให้สอดคล้องกับสถานะของสไลด์ต้นฉบับ

const currentPresentation = SlidesApp.getActivePresentation();
const sourcePresentation = SlidesApp.openById('sourcePresentationId');
const sourceSlide = sourcePresentation.getSlides()[0];
const linkedSlide = currentPresentation.append(
    sourceSlide,
    SlidesApp.SlideLinkingMode.LINKED,
);

sourceSlide.insertText(
    'hello world');  // Only the source slide has the text box.

linkedSlide.refreshSlide();  // The linked slide now has the text box.

โยน

Error — หากไม่มีสิทธิ์เข้าถึงแบบอ่านอย่างเดียวในไฟล์นำเสนอต้นฉบับอีกต่อไป

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

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 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)

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
findText	String	ข้อความที่จะค้นหา
replaceText	String	ข้อความที่จะแทนที่ข้อความที่ตรงกัน

รีเทิร์น

Integer — จํานวนครั้งที่เกิดการเปลี่ยนแปลง

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

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

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

---

replaceAllText(findText, replaceText, matchCase)

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
findText	String	ข้อความที่จะค้นหา
replaceText	String	ข้อความที่จะแทนที่ข้อความที่ตรงกัน
matchCase	Boolean	หากเป็น 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.
const 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

---

setSkipped(isSkipped)

ตั้งค่าว่าจะข้ามสไลด์ในโหมดการนำเสนอหรือไม่

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
isSkipped	Boolean	True เพื่อข้ามสไลด์ในโหมดงานนำเสนอ

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

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

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

---

unlink()

ยกเลิกการลิงก์ Slide ปัจจุบันจากสไลด์ต้นทาง หากสไลด์นี้ไม่ได้ลิงก์ไว้ ระบบจะแสดงผลโดยไม่มีการเปลี่ยนแปลง

const currentPresentation = SlidesApp.getActivePresentation();
const sourcePresentation = SlidesApp.openById('sourcePresentationId');
const sourceSlide = sourcePresentation.getSlides()[0];
const linkedSlide = currentPresentation.append(
    sourceSlide,
    SlidesApp.SlideLinkingMode.LINKED,
);

linkedSlide.unlink();

linkedSlide.getSourcePresentationId();  // returns null
linkedSlide.getSourceSlideObjectId();   // returns null
linkedSlide
    .getSlideLinkingMode();  // returns SlidesApp.SlideLinkingMode.NOT_LINKED

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

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

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