Class Presentation

งานนำเสนอ

งานนำเสนอ

วิธีการ

วิธีการประเภทการแสดงผลรายละเอียดแบบย่อ
addEditor(emailAddress)Presentationเพิ่มผู้ใช้ที่ระบุไปยังรายชื่อเอดิเตอร์ของ Presentation
addEditor(user)Presentationเพิ่มผู้ใช้ที่ระบุไปยังรายชื่อเอดิเตอร์ของ Presentation
addEditors(emailAddresses)Presentationเพิ่มอาร์เรย์ของผู้ใช้ที่ระบุในรายชื่อเครื่องมือแก้ไขสำหรับ Presentation
addViewer(emailAddress)Presentationเพิ่มผู้ใช้ที่ระบุลงในรายการผู้ชมสำหรับ Presentation
addViewer(user)Presentationเพิ่มผู้ใช้ที่ระบุลงในรายการผู้ชมสำหรับ Presentation
addViewers(emailAddresses)Presentationเพิ่มอาร์เรย์ของผู้ใช้ที่ระบุในรายชื่อผู้ดูสำหรับ Presentation
appendSlide()Slideเพิ่มสไลด์ต่อท้ายงานนำเสนอโดยใช้เลย์เอาต์ที่กำหนดไว้ล่วงหน้า PredefinedLayout.BLANK โดยอิงตามต้นฉบับปัจจุบัน
appendSlide(layout)Slideเพิ่มสไลด์ต่อท้ายงานนำเสนอโดยใช้เลย์เอาต์ที่ระบุตามต้นฉบับปัจจุบัน
appendSlide(predefinedLayout)Slideเพิ่มสไลด์ต่อท้ายงานนำเสนอโดยใช้เลย์เอาต์ที่กำหนดไว้ล่วงหน้าที่ระบุโดยอิงตามต้นฉบับปัจจุบัน
appendSlide(slide)Slideเพิ่มสำเนาของ Slide ที่ให้ไว้ต่อท้ายงานนำเสนอ
appendSlide(slide, linkingMode)Slideเพิ่มสำเนาของ Slide ที่ให้ไว้จากงานนำเสนอต้นทางต่อท้ายงานนำเสนอปัจจุบัน และตั้งค่าลิงก์สไลด์ตามที่ SlideLinkingMode ระบุไว้
getEditors()User[]รับรายชื่อเอดิเตอร์สำหรับ Presentation นี้
getId()Stringรับตัวระบุที่ไม่ซ้ำกันของงานนำเสนอ
getLayouts()Layout[]รับเลย์เอาต์ในงานนำเสนอ
getMasters()Master[]รับต้นฉบับในงานนำเสนอ
getName()Stringเรียกชื่องานนำเสนอ
getNotesMaster()NotesMasterรับต้นแบบโน้ตของงานนำเสนอ
getNotesPageHeight()Numberรับความสูงของหน้าสำหรับต้นฉบับโน้ตและหน้าโน้ตในงานนำเสนอเป็นจุด
getNotesPageWidth()Numberรับความกว้างของหน้าของโฆษณาหลักและหน้าโน้ตในงานนำเสนอเป็นจุด
getPageElementById(id)PageElementแสดงผล PageElement ด้วยรหัสที่ระบุ หรือ null หากไม่มี
getPageHeight()Numberรับความสูงของหน้าสไลด์ เลย์เอาต์ และเอกสารต้นฉบับในงานนำเสนอเป็นจุด
getPageWidth()Numberรับความกว้างของหน้าของสไลด์ เลย์เอาต์ และโฆษณาหลักในงานนำเสนอเป็นจุด
getSelection()Selectionรับการเลือกของผู้ใช้ในงานนำเสนอที่ใช้งานอยู่
getSlideById(id)Slideแสดงผล Slide ด้วยรหัสที่ระบุ หรือ null หากไม่มี
getSlides()Slide[]ดึงสไลด์ในงานนำเสนอ
getUrl()Stringเรียก URL เพื่อเข้าถึงงานนำเสนอนี้
getViewers()User[]รับรายชื่อผู้ดูและผู้แสดงความคิดเห็นสำหรับ Presentation นี้
insertSlide(insertionIndex)Slideแทรกสไลด์ที่ดัชนีที่ระบุในงานนำเสนอโดยใช้การออกแบบที่กำหนดไว้ล่วงหน้า PredefinedLayout.BLANK โดยอิงตามต้นฉบับปัจจุบัน
insertSlide(insertionIndex, layout)Slideแทรกสไลด์ที่ดัชนีที่ระบุในงานนำเสนอโดยใช้เลย์เอาต์ที่ระบุตามต้นฉบับปัจจุบัน
insertSlide(insertionIndex, predefinedLayout)Slideแทรกสไลด์ที่ดัชนีที่ระบุในงานนำเสนอโดยใช้เลย์เอาต์ที่กำหนดไว้ล่วงหน้าตามต้นฉบับปัจจุบัน
insertSlide(insertionIndex, slide)Slideแทรกสำเนาของ Slide ที่ให้ไว้ที่ดัชนีที่ระบุในงานนำเสนอ
insertSlide(insertionIndex, slide, linkingMode)Slideแทรกสำเนาของ Slide ที่มีให้จากงานนำเสนอต้นทางลงในดัชนีที่ระบุในงานนำเสนอปัจจุบัน และตั้งค่าลิงก์สไลด์ตามที่ SlideLinkingMode ระบุไว้
removeEditor(emailAddress)Presentationนำผู้ใช้ที่ระบุออกจากรายชื่อเอดิเตอร์ของ Presentation
removeEditor(user)Presentationนำผู้ใช้ที่ระบุออกจากรายชื่อเอดิเตอร์ของ Presentation
removeViewer(emailAddress)Presentationนำผู้ใช้ที่ระบุออกจากรายชื่อผู้ดูและผู้แสดงความคิดเห็นสำหรับ Presentation
removeViewer(user)Presentationนำผู้ใช้ที่ระบุออกจากรายชื่อผู้ดูและผู้แสดงความคิดเห็นสำหรับ Presentation
replaceAllText(findText, replaceText)Integerแทนที่ทุกอินสแตนซ์ของการค้นหาข้อความที่ตรงกับการค้นหาด้วยการแทนที่ข้อความ
replaceAllText(findText, replaceText, matchCase)Integerแทนที่ทุกอินสแตนซ์ของการค้นหาข้อความที่ตรงกับการค้นหาด้วยการแทนที่ข้อความ
saveAndClose()voidบันทึก Presentation ปัจจุบัน
setName(name)voidตั้งชื่องานนำเสนอ

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

addEditor(emailAddress)

เพิ่มผู้ใช้ที่ระบุไปยังรายชื่อเอดิเตอร์ของ Presentation หากผู้ใช้อยู่ในรายการผู้ดูอยู่แล้ว วิธีนี้จะโปรโมตผู้ใช้ออกจากรายการผู้ดู

พารามิเตอร์

ชื่อTypeคำอธิบาย
emailAddressStringอีเมลของผู้ใช้ที่จะเพิ่ม

รีเทิร์น

Presentation — Presentation นี้สำหรับการทำเชน

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

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

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

addEditor(user)

เพิ่มผู้ใช้ที่ระบุไปยังรายชื่อเอดิเตอร์ของ Presentation หากผู้ใช้อยู่ในรายการผู้ดูอยู่แล้ว วิธีนี้จะโปรโมตผู้ใช้ออกจากรายการผู้ดู

พารามิเตอร์

ชื่อTypeคำอธิบาย
userUserตัวแทนของผู้ใช้ที่จะเพิ่ม

รีเทิร์น

Presentation — Presentation นี้สำหรับการทำเชน

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

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

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

addEditors(emailAddresses)

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

พารามิเตอร์

ชื่อTypeคำอธิบาย
emailAddressesString[]อาร์เรย์อีเมลของผู้ใช้ที่จะเพิ่ม

รีเทิร์น

Presentation — Presentation นี้สำหรับการทำเชน

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

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

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

addViewer(emailAddress)

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

พารามิเตอร์

ชื่อTypeคำอธิบาย
emailAddressStringอีเมลของผู้ใช้ที่จะเพิ่ม

รีเทิร์น

Presentation — Presentation นี้สำหรับการทำเชน

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

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

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

addViewer(user)

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

พารามิเตอร์

ชื่อTypeคำอธิบาย
userUserตัวแทนของผู้ใช้ที่จะเพิ่ม

รีเทิร์น

Presentation — Presentation นี้สำหรับการทำเชน

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

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

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

addViewers(emailAddresses)

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

พารามิเตอร์

ชื่อTypeคำอธิบาย
emailAddressesString[]อาร์เรย์อีเมลของผู้ใช้ที่จะเพิ่ม

รีเทิร์น

Presentation — Presentation นี้สำหรับการทำเชน

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

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

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

appendSlide()

เพิ่มสไลด์ต่อท้ายงานนำเสนอโดยใช้เลย์เอาต์ที่กำหนดไว้ล่วงหน้า PredefinedLayout.BLANK โดยอิงตามต้นฉบับปัจจุบัน ต้นฉบับปัจจุบันเป็นหนึ่งในค่าต่อไปนี้

  • ต้นแบบของสไลด์สุดท้ายปัจจุบัน
  • ต้นแบบแรกในงานนำเสนอ ถ้าไม่มีสไลด์

รีเทิร์น

Slide — สไลด์ใหม่ที่ต่อท้าย

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

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

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

appendSlide(layout)

เพิ่มสไลด์ต่อท้ายงานนำเสนอโดยใช้เลย์เอาต์ที่ระบุตามต้นฉบับปัจจุบัน ต้นฉบับปัจจุบันเป็นหนึ่งในค่าต่อไปนี้

  • ต้นแบบของสไลด์สุดท้ายปัจจุบัน
  • ต้นแบบแรกในงานนำเสนอ ถ้าไม่มีสไลด์

พารามิเตอร์

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

รีเทิร์น

Slide — สไลด์ใหม่ที่ต่อท้าย

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

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

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

appendSlide(predefinedLayout)

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

  • ต้นแบบของสไลด์สุดท้ายปัจจุบัน
  • ต้นแบบแรกในงานนำเสนอ ถ้าไม่มีสไลด์

พารามิเตอร์

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

รีเทิร์น

Slide — สไลด์ใหม่ที่ต่อท้าย

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

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

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

appendSlide(slide)

เพิ่มสำเนาของ Slide ที่ให้ไว้ต่อท้ายงานนำเสนอ

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

// Copy a slide from another presentation and appends it.
var otherPresentation = SlidesApp.openById('presentationId');
var currentPresentation = SlidesApp.getActivePresentation();
var slide = otherPresentation.getSlides()[0];
currentPresentation.appendSlide(slide);

พารามิเตอร์

ชื่อTypeคำอธิบาย
slideSlideสไลด์ที่จะคัดลอกและต่อท้าย

รีเทิร์น

Slide — สไลด์ใหม่ที่ต่อท้าย

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

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

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

appendSlide(slide, linkingMode)

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

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

หากโหมดลิงก์คือ SlideLinkingMode.LINKED ระบบจะอัปเดตสไลด์ที่ต่อท้ายให้ตรงกับสไลด์แหล่งที่มาที่ให้ไว้เมื่อมีการเรียกใช้ Slide.refreshSlide() ผู้ทำงานร่วมกันคนอื่นๆ จะเห็นลิงก์ไปยังสไลด์แหล่งที่มา ใช้ SlideLinkingMode.LINKED กับสไลด์ต้นฉบับจากงานนำเสนอปัจจุบันไม่ได้ 

// Copy a slide from another presentation, then append and link it.
var sourcePresentation = SlidesApp.openById('presentationId');
var currentPresentation = SlidesApp.getActivePresentation();
var slide = sourcePresentation.getSlides()[0];
var appendedSlide = currentPresentation.appendSlide(slide, SlidesApp.SlideLinkingMode.LINKED);

พารามิเตอร์

ชื่อTypeคำอธิบาย
slideSlideสไลด์ที่จะคัดลอก ต่อท้าย และลิงก์
linkingModeSlideLinkingModeโหมดลิงก์ที่จะใช้

รีเทิร์น

Slide — สไลด์ใหม่

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

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

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

getEditors()

รับรายชื่อเอดิเตอร์สำหรับ Presentation นี้

รีเทิร์น

User[] — อาร์เรย์ของผู้ใช้ที่มีสิทธิ์แก้ไข

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

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

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

getId()

รับตัวระบุที่ไม่ซ้ำกันของงานนำเสนอ รหัสงานนำเสนอใช้กับ SlidesApp.openById() เพื่อเปิดอินสแตนซ์งานนำเสนอที่ต้องการ

รีเทิร์น

String — รหัสของงานนำเสนอนี้

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

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

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

getLayouts()

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

รีเทิร์น

Layout[] — รายการเลย์เอาต์ในงานนำเสนอนี้

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

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

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

getMasters()

รับต้นฉบับในงานนำเสนอ

รีเทิร์น

Master[] — รายชื่อต้นฉบับในงานนำเสนอนี้

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

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

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

getName()

เรียกชื่องานนำเสนอ

รีเทิร์น

String — ชื่อของงานนำเสนอนี้

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

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

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

getNotesMaster()

รับต้นแบบโน้ตของงานนำเสนอ

รีเทิร์น

NotesMaster — ต้นแบบโน้ตของงานนำเสนอ

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

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

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

getNotesPageHeight()

รับความสูงของหน้าสำหรับต้นฉบับโน้ตและหน้าโน้ตในงานนำเสนอเป็นจุด ทั้งหมดมีความสูงเท่ากัน

รีเทิร์น

Number — ความสูงของหน้าโน้ตในหน่วยคะแนน

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

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

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

getNotesPageWidth()

รับความกว้างของหน้าของโฆษณาหลักและหน้าโน้ตในงานนำเสนอเป็นจุด ทุกหน้ามีความกว้างเท่ากัน

รีเทิร์น

Number — ความกว้างของหน้าโน้ตในหน่วยคะแนน

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

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

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

getPageElementById(id)

แสดงผล PageElement ด้วยรหัสที่ระบุ หรือ null หากไม่มี

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

getPageHeight()

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

รีเทิร์น

Number — ความสูงของหน้าเป็นคะแนน

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

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

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

getPageWidth()

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

รีเทิร์น

Number — ความกว้างของหน้าในหน่วยคะแนน

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

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

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

getSelection()

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

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

// Gets the current active page that is selected in the active presentation.
var selection = SlidesApp.getActivePresentation().getSelection();
var currentPage = selection.getCurrentPage();

รีเทิร์น

Selection — การนำเสนอตัวเลือกของผู้ใช้ หรือ null หากสคริปต์ไม่ได้ผูกกับงานนำเสนอหรือไม่มีการเลือกผู้ใช้ที่ถูกต้อง

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

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

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

getSlideById(id)

แสดงผล Slide ด้วยรหัสที่ระบุ หรือ null หากไม่มี

พารามิเตอร์

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

รีเทิร์น

Slide — สไลด์ที่มีรหัสที่ระบุ

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

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

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

getSlides()

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

รีเทิร์น

Slide[] — รายการสไลด์ในงานนำเสนอนี้

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

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

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

getUrl()

เรียก URL เพื่อเข้าถึงงานนำเสนอนี้ 

var presentation = SlidesApp.getActivePresentation();

// Send out the link to open the presentation.
MailApp.sendEmail("<email-address>", presentation.getName(), presentation.getUrl());

รีเทิร์น

String — URL สำหรับเข้าถึงงานนำเสนอปัจจุบัน

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

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

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

getViewers()

รับรายชื่อผู้ดูและผู้แสดงความคิดเห็นสำหรับ Presentation นี้

รีเทิร์น

User[] — อาร์เรย์ของผู้ใช้ที่มีสิทธิ์ดูหรือแสดงความคิดเห็น

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

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

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

insertSlide(insertionIndex)

แทรกสไลด์ที่ดัชนีที่ระบุในงานนำเสนอโดยใช้การออกแบบที่กำหนดไว้ล่วงหน้า PredefinedLayout.BLANK โดยอิงตามต้นฉบับปัจจุบัน ต้นฉบับปัจจุบันเป็นหนึ่งในค่าต่อไปนี้

  • ต้นแบบของสไลด์ก่อนหน้า
  • ต้นแบบของสไลด์แรก หากดัชนีการแทรกเป็น 0
  • ต้นแบบแรกในงานนำเสนอ ถ้าไม่มีสไลด์

พารามิเตอร์

ชื่อTypeคำอธิบาย
insertionIndexIntegerดัชนีฐาน 0 ซึ่งระบุตำแหน่งที่จะแทรกสไลด์

รีเทิร์น

Slide — สไลด์ใหม่ที่แทรก

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

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

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

insertSlide(insertionIndex, layout)

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

  • ต้นแบบของสไลด์ก่อนหน้า
  • ต้นแบบของสไลด์แรก หากดัชนีการแทรกเป็น 0
  • ต้นแบบแรกในงานนำเสนอ ถ้าไม่มีสไลด์

พารามิเตอร์

ชื่อTypeคำอธิบาย
insertionIndexIntegerดัชนีฐาน 0 ซึ่งระบุตำแหน่งที่จะแทรกสไลด์
layoutLayoutเลย์เอาต์ที่จะใช้กับสไลด์ใหม่ ซึ่งควรแสดงอยู่ในต้นฉบับปัจจุบัน

รีเทิร์น

Slide — สไลด์ใหม่ที่แทรก

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

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

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

insertSlide(insertionIndex, predefinedLayout)

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

  • ต้นแบบของสไลด์ก่อนหน้า
  • ต้นแบบของสไลด์แรก หากดัชนีการแทรกเป็น 0
  • ต้นแบบแรกในงานนำเสนอ ถ้าไม่มีสไลด์

พารามิเตอร์

ชื่อTypeคำอธิบาย
insertionIndexIntegerดัชนีฐาน 0 ซึ่งระบุตำแหน่งที่จะแทรกสไลด์
predefinedLayoutPredefinedLayoutเลย์เอาต์ที่กำหนดไว้ล่วงหน้าที่จะใช้กับสไลด์ใหม่ ซึ่งควรแสดงในต้นฉบับปัจจุบัน

รีเทิร์น

Slide — สไลด์ใหม่ที่แทรก

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

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

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

insertSlide(insertionIndex, slide)

แทรกสำเนาของ Slide ที่ให้ไว้ที่ดัชนีที่ระบุในงานนำเสนอ

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

// Copy a slide from another presentation and inserts it.
var otherPresentation = SlidesApp.openById('presentationId');
var currentPresentation = SlidesApp.getActivePresentation();
var slide = otherPresentation.getSlides()[0];
var insertionIndex = 1;
currentPresentation.insertSlide(insertionIndex, slide);

พารามิเตอร์

ชื่อTypeคำอธิบาย
insertionIndexIntegerดัชนีฐาน 0 ซึ่งระบุตำแหน่งที่จะแทรกสไลด์
slideSlideสไลด์ที่จะคัดลอกและแทรก

รีเทิร์น

Slide — สไลด์ใหม่ที่แทรก

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

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

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

insertSlide(insertionIndex, slide, linkingMode)

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

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

หากโหมดลิงก์คือ SlideLinkingMode.LINKED ระบบจะอัปเดตสไลด์ที่แทรกให้ตรงกับสไลด์แหล่งที่มาที่ให้มาเมื่อมีการเรียกใช้ Slide.refreshSlide() ผู้ทำงานร่วมกันคนอื่นๆ จะเห็นลิงก์ไปยังสไลด์แหล่งที่มา ใช้ SlideLinkingMode.LINKED กับสไลด์ต้นฉบับจากงานนำเสนอปัจจุบันไม่ได้ 

// Copy a slide from another presentation, then insert and link it.
var sourcePresentation = SlidesApp.openById('presentationId');
var currentPresentation = SlidesApp.getActivePresentation();
var slide = sourcePresentation.getSlides()[0];
var insertionIndex = 1;
var insertedSlide =
    currentPresentation.insertSlide(
    insertionIndex, slide, SlidesApp.SlideLinkingMode.LINKED);

พารามิเตอร์

ชื่อTypeคำอธิบาย
insertionIndexIntegerดัชนีฐาน 0 ซึ่งระบุตำแหน่งที่จะแทรกสไลด์
slideSlideสไลด์ที่จะคัดลอกและแทรก
linkingModeSlideLinkingModeโหมดลิงก์ที่จะใช้

รีเทิร์น

Slide — สไลด์ใหม่

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

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

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

removeEditor(emailAddress)

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

สำหรับไฟล์ในไดรฟ์ การดำเนินการนี้จะนำผู้ใช้ออกจากรายชื่อผู้ดูด้วย

พารามิเตอร์

ชื่อTypeคำอธิบาย
emailAddressStringอีเมลของผู้ใช้ที่จะนำออก

รีเทิร์น

Presentation — Presentation นี้สำหรับการทำเชน

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

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

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

removeEditor(user)

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

สำหรับไฟล์ในไดรฟ์ การดำเนินการนี้จะนำผู้ใช้ออกจากรายชื่อผู้ดูด้วย

พารามิเตอร์

ชื่อTypeคำอธิบาย
userUserตัวแทนของผู้ใช้ที่จะนำออก

รีเทิร์น

Presentation — Presentation นี้สำหรับการทำเชน

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

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

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

removeViewer(emailAddress)

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

สำหรับไฟล์ในไดรฟ์ การดำเนินการนี้จะนำผู้ใช้ออกจากรายการเอดิเตอร์ด้วย

พารามิเตอร์

ชื่อTypeคำอธิบาย
emailAddressStringอีเมลของผู้ใช้ที่จะนำออก

รีเทิร์น

Presentation — Presentation นี้สำหรับการทำเชน

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

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

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

removeViewer(user)

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

สำหรับไฟล์ในไดรฟ์ การดำเนินการนี้จะนำผู้ใช้ออกจากรายการเอดิเตอร์ด้วย

พารามิเตอร์

ชื่อTypeคำอธิบาย
userUserตัวแทนของผู้ใช้ที่จะนำออก

รีเทิร์น

Presentation — Presentation นี้สำหรับการทำเชน

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

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

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

replaceAllText(findText, replaceText)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

replaceAllText(findText, replaceText, matchCase)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

saveAndClose()

บันทึก Presentation ปัจจุบัน ทำให้การอัปเดตที่รอดำเนินการมีการล้างและนำไปใช้

ระบบจะเรียกใช้เมธอด saveAndClose() โดยอัตโนมัติเมื่อสิ้นสุดการเรียกใช้สคริปต์สำหรับ Presentation ที่เปิดแต่ละรายการ แม้ว่าการเรียกใช้สคริปต์จะสิ้นสุดลงโดยมีข้อผิดพลาดก็ตาม

แก้ไข Presentation ที่ปิดไปแล้วไม่ได้ ใช้วิธีใดวิธีหนึ่งใน SlidesApp เพื่อเปิดงานนำเสนอที่ระบุขึ้นมาใหม่เพื่อแก้ไข

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

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

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

setName(name)

ตั้งชื่องานนำเสนอ

พารามิเตอร์

ชื่อTypeคำอธิบาย
nameStringชื่อที่จะตั้งให้กับงานนำเสนอนี้

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

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

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