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|nullแสดง PageElement ที่มีรหัสที่ระบุ หรือ null หากไม่มี
getPageHeight()Numberรับความสูงของหน้าสไลด์ เลย์เอาต์ และสไลด์ต้นแบบในงานนำเสนอเป็นคะแนน
getPageWidth()Numberรับความกว้างของหน้าสไลด์ เลย์เอาต์ และสไลด์ต้นแบบในงานนำเสนอเป็นจุด
getSelection()Selection|nullรับการเลือกของผู้ใช้ในงานนำเสนอที่ใช้งานอยู่
getSlideById(id)Slide|nullแสดง 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 หากผู้ใช้ อยู่ในรายชื่อผู้ชมอยู่แล้ว วิธีนี้จะเลื่อนผู้ใช้รายดังกล่าวออกจากรายชื่อผู้ชม

พารามิเตอร์

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

รีเทิร์น

Presentation — This Presentation, for chaining.

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

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

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

addEditor(user)

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

พารามิเตอร์

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

รีเทิร์น

Presentation — This Presentation, for chaining.

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

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

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

addEditors(emailAddresses)

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

พารามิเตอร์

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

รีเทิร์น

Presentation — This Presentation, for chaining.

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

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

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

addViewer(emailAddress)

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

พารามิเตอร์

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

รีเทิร์น

Presentation — This Presentation, for chaining.

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

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

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

addViewer(user)

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

พารามิเตอร์

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

รีเทิร์น

Presentation — This Presentation, for chaining.

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

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

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

addViewers(emailAddresses)

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

พารามิเตอร์

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

รีเทิร์น

Presentation — This Presentation, for chaining.

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

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

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

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

appendSlide(predefinedLayout)

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

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

พารามิเตอร์

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
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.
const sourcePresentation = SlidesApp.openById('presentationId');
const currentPresentation = SlidesApp.getActivePresentation();
const slide = sourcePresentation.getSlides()[0];
const appendedSlide = currentPresentation.appendSlide(
    slide,
    SlidesApp.SlideLinkingMode.LINKED,
);

พารามิเตอร์

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

รีเทิร์น

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

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

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

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

getSlideById(id)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

const 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เลย์เอาต์ที่กำหนดไว้ล่วงหน้าตามต้นแบบปัจจุบัน มาสเตอร์ปัจจุบันคือ รายการใดรายการหนึ่งต่อไปนี้

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

insertSlide(insertionIndex, layout)

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

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

insertSlide(insertionIndex, predefinedLayout)

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

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

พารามิเตอร์

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
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.
const sourcePresentation = SlidesApp.openById('presentationId');
const currentPresentation = SlidesApp.getActivePresentation();
const slide = sourcePresentation.getSlides()[0];
const insertionIndex = 1;
const insertedSlide = currentPresentation.insertSlide(
    insertionIndex,
    slide,
    SlidesApp.SlideLinkingMode.LINKED,
);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
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 อยู่ในไดรฟ์ที่แชร์ซึ่งผู้ใช้เข้าถึงได้

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

พารามิเตอร์

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

รีเทิร์น

Presentation — This Presentation, for chaining.

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

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

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

removeEditor(user)

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

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

พารามิเตอร์

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

รีเทิร์น

Presentation — This Presentation, for chaining.

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

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

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

removeViewer(emailAddress)

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

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

พารามิเตอร์

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

รีเทิร์น

Presentation — This Presentation for chaining.

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

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

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

removeViewer(user)

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

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

พารามิเตอร์

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

รีเทิร์น

Presentation — This Presentation for chaining.

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

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

saveAndClose()

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

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

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

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

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

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

setName(name)

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

พารามิเตอร์

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

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

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

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