Class Slide

สไลด์

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

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

เมธอด

วิธีการประเภทการแสดงผลรายละเอียดแบบย่อ
duplicate()Slideทำสำเนาสไลด์
getBackground()PageBackgroundรับพื้นหลังของหน้าเว็บ
getColorScheme()ColorSchemeรับ ColorScheme ที่เชื่อมโยงกับหน้าเว็บ
getGroups()Group[]แสดงผลรายการออบเจ็กต์ Group ในหน้าเว็บ
getImages()Image[]แสดงผลรายการออบเจ็กต์ Image ในหน้าเว็บ
getLayout()Layout|nullรับเลย์เอาต์ที่สไลด์อิงตาม หรือ null หากสไลด์ไม่ได้อิงตามเลย์เอาต์
getLines()Line[]แสดงผลรายการออบเจ็กต์ Line ในหน้าเว็บ
getNotesPage()NotesPageแสดงหน้าหมายเหตุที่เชื่อมโยงกับสไลด์
getObjectId()Stringรับรหัสที่ไม่ซ้ำกันสำหรับหน้าเว็บ
getPageElementById(id)PageElement|nullแสดง PageElement ในหน้าที่มีรหัสที่ระบุ หรือ null หากไม่มี
getPageElements()PageElement[]แสดงผลรายการออบเจ็กต์ PageElement ที่แสดงในหน้าเว็บ
getPageType()PageTypeรับประเภทของหน้าเว็บ
getPlaceholder(placeholderType)PageElement|nullแสดงออบเจ็กต์ตัวยึดตำแหน่ง PageElement สำหรับ PlaceholderType หรือ null ที่ระบุ หากไม่มีตัวยึดตำแหน่งที่ตรงกัน
getPlaceholder(placeholderType, placeholderIndex)PageElement|nullแสดงผลออบเจ็กต์ตัวยึดตำแหน่ง 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|null

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

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

พารามิเตอร์

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

รีเทิร์น

PageElement|null — องค์ประกอบหน้าเว็บที่มีรหัสที่ระบุ

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

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

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

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

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

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

พารามิเตอร์

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

isSkipped()

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

รีเทิร์น

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

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

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

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

move(index)

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
indexIntegerดัชนีที่ควรย้ายสไลด์ไปตามการจัดเรียงสไลด์ ก่อนการย้าย ดัชนีควรอยู่ระหว่าง 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)

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

พารามิเตอร์

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

setSkipped(isSkipped)

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

พารามิเตอร์

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

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

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

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

ยกเลิกการลิงก์ 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