Class Layout

เลย์เอาต์

เลย์เอาต์ในงานนำเสนอ

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

เมธอด

วิธีการประเภทการแสดงผลรายละเอียดแบบย่อ
getBackground()PageBackgroundรับพื้นหลังของหน้า
getColorScheme()ColorSchemeรับ ColorScheme ที่เชื่อมโยงกับหน้าเว็บ
getGroups()Group[]แสดงรายการ Group วัตถุในหน้า
getImages()Image[]แสดงรายการ Image วัตถุในหน้า
getLayoutName()Stringรับชื่อเลย์เอาต์
getLines()Line[]แสดงรายการ Line วัตถุในหน้า
getMaster()Masterรับต้นฉบับที่เลย์เอาต์ใช้
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 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 ที่ระบุไว้ในหน้า
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

getLayoutName()

รับชื่อเลย์เอาต์

รีเทิร์น

String

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

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

getMaster()

รับต้นฉบับที่เลย์เอาต์ใช้

รีเทิร์น

Master

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

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
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 ที่ระบุ หากไม่มีตัวยึดตําแหน่งตรงกัน

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

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

พารามิเตอร์

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

รีเทิร์น

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,
);

พารามิเตอร์

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

รีเทิร์น

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

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 จะจัดกลุ่มไม่ได้

พารามิเตอร์

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

รีเทิร์น

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.

พารามิเตอร์

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

รีเทิร์น

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
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

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

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
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.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const image = otherPresentationSlide.getImages[0];
currentPresentationSlide.insertImage(image);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
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()

พารามิเตอร์

ชื่อประเภทคำอธิบาย
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()

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
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.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const line = otherPresentationSlide.getLines[0];
currentPresentationSlide.insertLine(line);

พารามิเตอร์

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

รีเทิร์น

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],
);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
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.
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,
);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
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.
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);

พารามิเตอร์

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

รีเทิร์น

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.

พารามิเตอร์

ชื่อประเภทคำอธิบาย
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.
const slide = SlidesApp.getActivePresentation().getSlides()[0];

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

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

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

พารามิเตอร์

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

รีเทิร์น

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

พารามิเตอร์

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

รีเทิร์น

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,
);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
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.
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);

พารามิเตอร์

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

รีเทิร์น

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.

พารามิเตอร์

ชื่อประเภทคำอธิบาย
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 ชีต ต้นทาง 

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,
);

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

insertTable(numRows, numColumns)

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

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

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

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

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
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.
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.

พารามิเตอร์

ชื่อประเภทคำอธิบาย
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.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.insertTextBox('Hello');  // Also available for Layout, Master, and Page.

พารามิเตอร์

ชื่อประเภทคำอธิบาย
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.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.insertTextBox(
    'Hello', 0, 0, 10, 10);  // Also available for Layout, Master, and Page.

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

insertVideo(videoUrl)

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

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

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

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

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
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.
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.

พารามิเตอร์

ชื่อประเภทคำอธิบาย
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.
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);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
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)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

replaceAllText(findText, replaceText, matchCase)

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
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.
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