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 หากผู้ใช้อยู่ในรายการผู้ชมอยู่แล้ว วิธีการนี้จะเลื่อนผู้ใช้ออกจากรายการผู้ชม

พารามิเตอร์

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

รีเทิร์น

PresentationPresentation นี้สําหรับการต่อเชื่อม

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

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

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

addEditor(user)

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

พารามิเตอร์

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

รีเทิร์น

PresentationPresentation นี้สําหรับการต่อเชื่อม

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

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

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

addEditors(emailAddresses)

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

พารามิเตอร์

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

รีเทิร์น

PresentationPresentation นี้สําหรับการต่อเชื่อม

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

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

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

addViewer(emailAddress)

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

พารามิเตอร์

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

รีเทิร์น

PresentationPresentation นี้สําหรับการต่อเชื่อม

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

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

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

addViewer(user)

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

พารามิเตอร์

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

รีเทิร์น

PresentationPresentation นี้สําหรับการต่อเชื่อม

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

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

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

addViewers(emailAddresses)

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

พารามิเตอร์

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

รีเทิร์น

PresentationPresentation นี้สําหรับการต่อเชื่อม

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

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

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

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

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

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

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

getSlideById(id)

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

พารามิเตอร์

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

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ดัชนีแบบนับจากศูนย์ซึ่งระบุตำแหน่งที่จะแทรกสไลด์

รีเทิร์น

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

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

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

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

insertSlide(insertionIndex, layout)

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

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

insertSlide(insertionIndex, predefinedLayout)

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

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
insertionIndexIntegerดัชนีแบบนับจากศูนย์ซึ่งระบุตำแหน่งที่จะแทรกสไลด์
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ดัชนีแบบนับจากศูนย์ซึ่งระบุตำแหน่งที่จะแทรกสไลด์
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ดัชนีแบบนับจากศูนย์ซึ่งระบุตำแหน่งที่จะแทรกสไลด์
slideSlideสไลด์ที่จะคัดลอกและแทรก
linkingModeSlideLinkingModeโหมดลิงก์ที่จะใช้

รีเทิร์น

Slide — สไลด์ใหม่

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

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

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

removeEditor(emailAddress)

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

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

พารามิเตอร์

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

รีเทิร์น

PresentationPresentation นี้สําหรับการต่อเชื่อม

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

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

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

removeEditor(user)

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

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

พารามิเตอร์

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

รีเทิร์น

PresentationPresentation นี้สําหรับการต่อเชื่อม

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

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

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

removeViewer(emailAddress)

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

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

พารามิเตอร์

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

รีเทิร์น

PresentationPresentation นี้สําหรับการต่อเชื่อม

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

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

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

removeViewer(user)

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

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

พารามิเตอร์

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

รีเทิร์น

PresentationPresentation นี้สําหรับการต่อเชื่อม

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

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