Class Presentation

프레젠테이션

프레젠테이션

메서드

메서드반환 유형간략한 설명
addEditor(emailAddress)Presentation지정된 사용자를 Presentation의 편집자 목록에 추가합니다.
addEditor(user)Presentation지정된 사용자를 Presentation의 편집자 목록에 추가합니다.
addEditors(emailAddresses)PresentationPresentation의 편집자 목록에 지정된 사용자 배열을 추가합니다.
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지정된 ID의 PageElement를 반환하거나, 없는 경우 null을 반환합니다.
getPageHeight()Number프레젠테이션의 슬라이드, 레이아웃, 마스터의 페이지 높이를 포인트 단위로 가져옵니다.
getPageWidth()Number프레젠테이션의 슬라이드, 레이아웃, 마스터의 페이지 너비를 포인트로 가져옵니다.
getSelection()Selection|null활성 프레젠테이션에서 사용자의 선택을 가져옵니다.
getSlideById(id)Slide|null지정된 ID의 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)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를 반환하거나, 없는 경우 null을 반환합니다.

매개변수

이름유형설명
idString가져오는 페이지 요소의 ID입니다.

리턴

PageElement|null - 지정된 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 - 사용자의 선택을 나타냅니다. 스크립트가 프레젠테이션에 바인딩되지 않았거나 유효한 사용자 선택이 없는 경우 null입니다.

승인

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

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

getSlideById(id)

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

매개변수

이름유형설명
idString가져올 슬라이드의 ID입니다.

리턴

Slide|null - 지정된 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 사전 정의된 레이아웃을 사용하여 프레젠테이션의 지정된 색인에 슬라이드를 삽입합니다. 현재 마스터는 다음 중 하나입니다.

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

매개변수

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

리턴

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

승인

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

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

insertSlide(insertionIndex, layout)

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

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

매개변수

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

리턴

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

승인

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

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

insertSlide(insertionIndex, predefinedLayout)

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

  • 이전 슬라이드의 마스터입니다.
  • insertionIndex가 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의 열기 메서드 중 하나를 사용하여 수정할 프레젠테이션을 다시 엽니다.

승인

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

  • 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