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지정된 ID의 PageElement를 반환하거나, ID가 없는 경우 null을 반환합니다.
getPageHeight()Number프레젠테이션의 슬라이드, 레이아웃, 마스터의 페이지 높이를 포인트 단위로 가져옵니다.
getPageWidth()Number프레젠테이션의 슬라이드, 레이아웃, 마스터의 페이지 너비를 포인트 단위로 가져옵니다.
getSelection()Selection활성 프레젠테이션에서 사용자의 선택사항을 가져옵니다.
getSlideById(id)Slide지정된 ID의 Slide를 반환하거나, ID가 없는 경우 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)PresentationPresentation의 편집자 목록에서 지정된 사용자를 삭제합니다.
removeEditor(user)PresentationPresentation의 편집자 목록에서 지정된 사용자를 삭제합니다.
removeViewer(emailAddress)PresentationPresentation의 시청자 및 댓글 작성자 목록에서 지정된 사용자를 삭제합니다.
removeViewer(user)PresentationPresentation의 시청자 및 댓글 작성자 목록에서 지정된 사용자를 삭제합니다.
replaceAllText(findText, replaceText)Integer찾을 텍스트와 일치하는 텍스트의 모든 인스턴스를 대체 텍스트로 바꿉니다.
replaceAllText(findText, replaceText, matchCase)Integer찾을 텍스트와 일치하는 텍스트의 모든 인스턴스를 대체 텍스트로 바꿉니다.
saveAndClose()void현재 Presentation를 저장합니다.
setName(name)void프레젠테이션의 이름 또는 제목을 설정합니다.

자세한 문서

addEditor(emailAddress)

지정된 사용자를 Presentation의 편집자 목록에 추가합니다. 사용자가 이미 시청자 목록에 있는 경우 이 메서드는 사용자를 시청자 목록에서 승격합니다.

매개변수

이름유형설명
emailAddressString추가할 사용자의 이메일 주소입니다.

리턴

Presentation — 체이닝을 위한 이 Presentation

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

addEditor(user)

지정된 사용자를 Presentation의 편집자 목록에 추가합니다. 사용자가 이미 시청자 목록에 있는 경우 이 메서드는 사용자를 시청자 목록에서 승격합니다.

매개변수

이름유형설명
userUser추가할 사용자의 표현입니다.

리턴

Presentation — 체이닝을 위한 이 Presentation

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

addEditors(emailAddresses)

지정된 사용자 배열을 Presentation의 편집자 목록에 추가합니다. 이미 시청자 목록에 있는 사용자는 이 메서드에 의해 시청자 목록에서 승격됩니다.

매개변수

이름유형설명
emailAddressesString[]추가할 사용자의 이메일 주소 배열입니다.

리턴

Presentation — 체이닝을 위한 이 Presentation

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

addViewer(emailAddress)

지정된 사용자를 Presentation의 시청자 목록에 추가합니다. 사용자가 이미 편집자 목록에 있는 경우 이 메서드는 효과가 없습니다.

매개변수

이름유형설명
emailAddressString추가할 사용자의 이메일 주소입니다.

리턴

Presentation — 체이닝을 위한 이 Presentation

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

addViewer(user)

지정된 사용자를 Presentation의 시청자 목록에 추가합니다. 사용자가 이미 편집자 목록에 있는 경우 이 메서드는 효과가 없습니다.

매개변수

이름유형설명
userUser추가할 사용자의 표현입니다.

리턴

Presentation — 체이닝을 위한 이 Presentation

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

addViewers(emailAddresses)

지정된 사용자 배열을 Presentation의 시청자 목록에 추가합니다. 이미 편집자 목록에 있는 사용자에게는 이 메서드가 영향을 미치지 않습니다.

매개변수

이름유형설명
emailAddressesString[]추가할 사용자의 이메일 주소 배열입니다.

리턴

Presentation — 체이닝을 위한 이 Presentation

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

appendSlide()

현재 마스터에 따라 PredefinedLayout.BLANK 사전 정의된 레이아웃을 사용하여 프레젠테이션 끝에 슬라이드를 추가합니다. 현재 마스터는 다음 중 하나입니다.

  • 현재 마지막 슬라이드의 마스터입니다.
  • 슬라이드가 없는 경우 프레젠테이션의 첫 번째 마스터입니다.

리턴

Slide: 추가된 새 슬라이드입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

appendSlide(layout)

현재 마스터에 따라 지정된 레이아웃을 사용하여 프레젠테이션 끝에 슬라이드를 추가합니다. 현재 마스터는 다음 중 하나입니다.

  • 현재 마지막 슬라이드의 마스터입니다.
  • 슬라이드가 없는 경우 프레젠테이션의 첫 번째 마스터입니다.

매개변수

이름유형설명
layoutLayout새 슬라이드에 사용할 레이아웃입니다. 현재 마스터에 있어야 합니다.

리턴

Slide: 추가된 새 슬라이드입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

appendSlide(predefinedLayout)

현재 마스터에 따라 지정된 사전 정의된 레이아웃을 사용하여 프레젠테이션 끝에 슬라이드를 추가합니다. 현재 마스터는 다음 중 하나입니다.

  • 현재 마지막 슬라이드의 마스터입니다.
  • 슬라이드가 없는 경우 프레젠테이션의 첫 번째 마스터입니다.

매개변수

이름유형설명
predefinedLayoutPredefinedLayout새 슬라이드에 사용할 사전 정의된 레이아웃입니다. 현재 마스터에 있어야 합니다.

리턴

Slide: 추가된 새 슬라이드입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

  • 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: 추가된 새 슬라이드입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

  • 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: 새 슬라이드입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

getEditors()

이 Presentation의 편집자 목록을 가져옵니다.

리턴

User[]: 수정 권한이 있는 사용자 배열입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

getId()

프레젠테이션의 고유 식별자를 가져옵니다. 프레젠테이션 ID는 SlidesApp.openById()와 함께 사용하여 특정 프레젠테이션 인스턴스를 엽니다.

리턴

String: 이 프레젠테이션의 ID입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

getLayouts()

프레젠테이션의 레이아웃을 가져옵니다.

리턴

Layout[]: 이 프레젠테이션의 레이아웃 목록입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

getMasters()

프레젠테이션의 마스터 슬라이드를 가져옵니다.

리턴

Master[]: 이 프레젠테이션의 마스터 목록입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

getName()

프레젠테이션의 이름 또는 제목을 가져옵니다.

리턴

String: 이 프레젠테이션의 제목입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

getNotesMaster()

프레젠테이션의 슬라이드 노트 마스터 정보를 가져옵니다.

리턴

NotesMaster: 프레젠테이션의 슬라이드 노트 마스터입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

getNotesPageHeight()

프레젠테이션의 메모 마스터 및 메모 페이지의 페이지 높이를 포인트 단위로 가져옵니다. 페이지 높이는 모두 동일합니다.

리턴

Number: 메모 페이지 높이(단위: 포인트)입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

getNotesPageWidth()

프레젠테이션의 메모 마스터 및 메모 페이지의 페이지 너비를 포인트로 가져옵니다. 모두 페이지 너비가 동일합니다.

리턴

Number: 메모 페이지 너비(포인트)입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

getPageElementById(id)

지정된 ID의 PageElement를 반환하거나, ID가 없는 경우 null을 반환합니다.

매개변수

이름유형설명
idString검색 중인 페이지 요소의 ID입니다.

리턴

PageElement: 지정된 ID가 있는 페이지 요소입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

getPageHeight()

프레젠테이션의 슬라이드, 레이아웃, 마스터의 페이지 높이를 포인트 단위로 가져옵니다. 페이지 높이는 모두 동일합니다.

리턴

Number: 페이지 높이(포인트)입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

getPageWidth()

프레젠테이션의 슬라이드, 레이아웃, 마스터의 페이지 너비를 포인트 단위로 가져옵니다. 모두 페이지 너비가 동일합니다.

리턴

Number: 페이지 너비(포인트)입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

  • 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입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

getSlideById(id)

지정된 ID의 Slide를 반환하거나, ID가 없는 경우 null을 반환합니다.

매개변수

이름유형설명
idString검색 중인 슬라이드의 ID입니다.

리턴

Slide: 지정된 ID가 있는 슬라이드입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

getSlides()

프레젠테이션의 슬라이드를 가져옵니다.

리턴

Slide[]: 이 프레젠테이션의 슬라이드 목록입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

  • 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입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

getViewers()

이 Presentation의 시청자 및 댓글 작성자 목록을 가져옵니다.

리턴

User[]: 보기 또는 댓글 작성 권한이 있는 사용자 배열입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

insertSlide(insertionIndex)

현재 마스터에 따라 PredefinedLayout.BLANK 사전 정의된 레이아웃을 사용하여 프레젠테이션의 지정된 색인에 슬라이드를 삽입합니다. 현재 마스터는 다음 중 하나입니다.

  • 이전 슬라이드의 마스터입니다.
  • 삽입 색인이 0인 경우 첫 번째 슬라이드의 마스터입니다.
  • 슬라이드가 없는 경우 프레젠테이션의 첫 번째 마스터입니다.

매개변수

이름유형설명
insertionIndexInteger슬라이드를 삽입할 위치를 나타내는 0부터 시작하는 색인입니다.

리턴

Slide: 삽입된 새 슬라이드입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

insertSlide(insertionIndex, layout)

현재 마스터에 따라 지정된 레이아웃을 사용하여 프레젠테이션의 지정된 색인에 슬라이드를 삽입합니다. 현재 마스터는 다음 중 하나입니다.

  • 이전 슬라이드의 마스터입니다.
  • 삽입 색인이 0인 경우 첫 번째 슬라이드의 마스터입니다.
  • 슬라이드가 없는 경우 프레젠테이션의 첫 번째 마스터입니다.

매개변수

이름유형설명
insertionIndexInteger슬라이드를 삽입할 위치를 나타내는 0부터 시작하는 색인입니다.
layoutLayout새 슬라이드에 사용할 레이아웃입니다. 현재 마스터에 있어야 합니다.

리턴

Slide: 삽입된 새 슬라이드입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

insertSlide(insertionIndex, predefinedLayout)

현재 마스터에 따라 지정된 사전 정의된 레이아웃을 사용하여 프레젠테이션의 지정된 색인에 슬라이드를 삽입합니다. 현재 마스터는 다음 중 하나입니다.

  • 이전 슬라이드의 마스터입니다.
  • 삽입 색인이 0인 경우 첫 번째 슬라이드의 마스터입니다.
  • 슬라이드가 없는 경우 프레젠테이션의 첫 번째 마스터입니다.

매개변수

이름유형설명
insertionIndexInteger슬라이드를 삽입할 위치를 나타내는 0부터 시작하는 색인입니다.
predefinedLayoutPredefinedLayout새 슬라이드에 사용할 사전 정의된 레이아웃입니다. 현재 마스터에 있어야 합니다.

리턴

Slide: 삽입된 새 슬라이드입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

  • 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: 삽입된 새 슬라이드입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

  • 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: 새 슬라이드입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

removeEditor(emailAddress)

Presentation의 편집자 목록에서 지정된 사용자를 삭제합니다. 이 메서드는 사용자가 일반 액세스 권한이 있는 사용자 클래스에 속하는 경우 Presentation에 액세스하는 것을 차단하지 않습니다. 예를 들어 Presentation가 사용자의 전체 도메인과 공유되거나 Presentation가 사용자가 액세스할 수 있는 공유 드라이브에 있는 경우입니다.

Drive 파일의 경우 이 작업으로 인해 사용자는 보기 권한 사용자 목록에서도 삭제됩니다.

매개변수

이름유형설명
emailAddressString삭제할 사용자의 이메일 주소입니다.

리턴

Presentation — 체이닝을 위한 이 Presentation

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

removeEditor(user)

Presentation의 편집자 목록에서 지정된 사용자를 삭제합니다. 이 메서드는 사용자가 일반 액세스 권한이 있는 사용자 클래스에 속하는 경우 Presentation에 액세스하는 것을 차단하지 않습니다. 예를 들어 Presentation가 사용자의 전체 도메인과 공유되거나 Presentation가 사용자가 액세스할 수 있는 공유 드라이브에 있는 경우입니다.

Drive 파일의 경우 이 작업으로 인해 사용자는 보기 권한 사용자 목록에서도 삭제됩니다.

매개변수

이름유형설명
userUser삭제할 사용자의 표현입니다.

리턴

Presentation — 체이닝을 위한 이 Presentation

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

removeViewer(emailAddress)

Presentation의 시청자 및 댓글 작성자 목록에서 지정된 사용자를 삭제합니다. 이 메서드는 시청자나 댓글 작성자가 아닌 편집자인 경우 영향을 미치지 않습니다. 또한 이 메서드는 사용자가 일반 액세스 권한이 있는 사용자 클래스에 속하는 경우에도 사용자가 Presentation에 액세스하는 것을 차단하지 않습니다. 예를 들어 Presentation가 사용자의 전체 도메인과 공유되거나 Presentation가 사용자가 액세스할 수 있는 공유 드라이브에 있는 경우를 들 수 있습니다.

Drive 파일의 경우 편집자 목록에서도 사용자가 삭제됩니다.

매개변수

이름유형설명
emailAddressString삭제할 사용자의 이메일 주소입니다.

리턴

Presentation: 체이닝을 위한 Presentation입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

removeViewer(user)

Presentation의 시청자 및 댓글 작성자 목록에서 지정된 사용자를 삭제합니다. 이 메서드는 사용자가 보기 권한이 있는 시청자가 아닌 수정 권한이 있는 편집자인 경우 영향을 미치지 않습니다. 또한 이 메서드는 사용자가 일반 액세스 권한이 있는 사용자 클래스에 속하는 경우에도 사용자가 Presentation에 액세스하는 것을 차단하지 않습니다. 예를 들어 Presentation가 사용자의 전체 도메인과 공유되거나 Presentation가 사용자가 액세스할 수 있는 공유 드라이브에 있는 경우를 들 수 있습니다.

Drive 파일의 경우 편집자 목록에서도 사용자가 삭제됩니다.

매개변수

이름유형설명
userUser삭제할 사용자의 표현입니다.

리턴

Presentation: 체이닝을 위한 Presentation입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

replaceAllText(findText, replaceText)

찾을 텍스트와 일치하는 텍스트의 모든 인스턴스를 대체 텍스트로 바꿉니다. 검색 시 대소문자를 구분하지 않습니다.

매개변수

이름유형설명
findTextString찾을 텍스트입니다.
replaceTextString일치하는 텍스트를 대체할 텍스트입니다.

리턴

Integer: 변경된 반복 횟수

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

replaceAllText(findText, replaceText, matchCase)

찾을 텍스트와 일치하는 텍스트의 모든 인스턴스를 대체 텍스트로 바꿉니다.

매개변수

이름유형설명
findTextString찾을 텍스트입니다.
replaceTextString일치하는 텍스트를 대체할 텍스트입니다.
matchCaseBooleantrue인 경우 검색 시 대소문자를 구분하고 false인 경우 검색 시 대소문자를 구분하지 않습니다.

리턴

Integer: 변경된 반복 횟수

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

saveAndClose()

현재 Presentation를 저장합니다. 대기 중인 업데이트가 플러시되고 적용됩니다.

saveAndClose() 메서드는 스크립트 실행이 오류로 종료되더라도 열린 각 Presentation의 스크립트 실행이 끝날 때 자동으로 호출됩니다.

닫힌 Presentation는 수정할 수 없습니다. SlidesApp의 open 메서드 중 하나를 사용하여 수정할 특정 프레젠테이션을 다시 엽니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

setName(name)

프레젠테이션의 이름 또는 제목을 설정합니다.

매개변수

이름유형설명
nameString이 프레젠테이션에 설정할 이름입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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