Class NotesPage

참고페이지

프레젠테이션의 메모 페이지

이러한 페이지에는 슬라이드의 발표자 노트를 포함한 도형을 비롯하여, 프레젠테이션 참고 자료 콘텐츠가 있습니다. 슬라이드마다 해당하는 슬라이드 노트가 한 개씩 있습니다. 발표자 노트 도형에 있는 텍스트만 수정할 수 있습니다.

메서드

메서드반환 유형간략한 설명
getGroups()Group[]페이지의 Group 객체 목록을 반환합니다.
getImages()Image[]페이지의 Image 객체 목록을 반환합니다.
getLines()Line[]페이지의 Line 객체 목록을 반환합니다.
getObjectId()String페이지의 고유 ID를 가져옵니다.
getPageElementById(id)PageElement지정된 ID가 있는 페이지의 PageElement를 반환하거나, 페이지에 ID가 없는 경우 null을 반환합니다.
getPageElements()PageElement[]페이지에 렌더링된 PageElement 객체 목록을 반환합니다.
getPlaceholder(placeholderType)PageElement일치하는 자리표시자가 없는 경우 지정된 PlaceholderType 또는 null의 자리표시자 PageElement 객체를 반환합니다.
getPlaceholder(placeholderType, placeholderIndex)PageElement지정된 PlaceholderType의 자리표시자 PageElement 객체와 자리표시자 색인을 반환하거나 자리표시자가 없는 경우 null을 반환합니다.
getPlaceholders()PageElement[]페이지의 자리표시자 PageElement 객체 목록을 반환합니다.
getShapes()Shape[]페이지의 Shape 객체 목록을 반환합니다.
getSheetsCharts()SheetsChart[]페이지의 SheetsChart 객체 목록을 반환합니다.
getSpeakerNotesShape()Shape페이지에서 발표자 노트를 포함하는 도형을 가져옵니다.
getTables()Table[]페이지의 Table 객체 목록을 반환합니다.
getVideos()Video[]페이지의 Video 객체 목록을 반환합니다.
getWordArts()WordArt[]페이지의 WordArt 객체 목록을 반환합니다.
replaceAllText(findText, replaceText)Integer찾을 텍스트와 일치하는 텍스트의 모든 인스턴스를 대체 텍스트로 바꿉니다.
replaceAllText(findText, replaceText, matchCase)Integer찾을 텍스트와 일치하는 텍스트의 모든 인스턴스를 대체 텍스트로 바꿉니다.

자세한 문서

getGroups()

페이지의 Group 객체 목록을 반환합니다.

리턴

Group[]

승인

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

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

getImages()

페이지의 Image 객체 목록을 반환합니다.

리턴

Image[]

승인

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

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

getLines()

페이지의 Line 객체 목록을 반환합니다.

리턴

Line[]

승인

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

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

getObjectId()

페이지의 고유 ID를 가져옵니다. 페이지 및 페이지 요소에서 사용하는 객체 ID는 동일한 네임스페이스를 공유합니다.

리턴

String

승인

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

  • 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

getPageElements()

페이지에 렌더링된 PageElement 객체 목록을 반환합니다.

리턴

PageElement[]

승인

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

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

getPlaceholder(placeholderType)

일치하는 자리표시자가 없는 경우 지정된 PlaceholderType 또는 null의 자리표시자 PageElement 객체를 반환합니다.

동일한 유형의 자리표시자가 여러 개인 경우 최소 자리표시자 색인이 있는 자리표시자를 반환합니다. 색인이 동일한 일치하는 자리표시자가 여러 개인 경우 페이지의 페이지 요소 컬렉션에서 첫 번째 자리표시자를 반환합니다. 

const slide = SlidesApp.getActivePresentation().getSlides()[0];
const placeholder = slide.getPlaceholder(
    SlidesApp.PlaceholderType.CENTERED_TITLE,
);

매개변수

이름유형설명
placeholderTypePlaceholderType

리턴

PageElement

승인

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

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

getPlaceholder(placeholderType, placeholderIndex)

지정된 PlaceholderType의 자리표시자 PageElement 객체와 자리표시자 색인을 반환하거나 자리표시자가 없는 경우 null을 반환합니다.

유형과 색인이 동일한 자리표시자가 여러 개 있는 경우 페이지의 페이지 요소 컬렉션에서 첫 번째 자리표시자를 반환합니다. 

const slide = SlidesApp.getActivePresentation().getSlides()[0];
const placeholder = slide.getPlaceholder(
    SlidesApp.PlaceholderType.CENTERED_TITLE,
    0,
);

매개변수

이름유형설명
placeholderTypePlaceholderType
placeholderIndexInteger

리턴

PageElement

승인

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

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

getPlaceholders()

페이지의 자리표시자 PageElement 객체 목록을 반환합니다. 

const master = SlidesApp.getActivePresentation().getMasters()[0];
Logger.log(
    `Number of placeholders in the master: ${master.getPlaceholders().length}`,
);

리턴

PageElement[]

승인

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

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

getShapes()

페이지의 Shape 객체 목록을 반환합니다.

리턴

Shape[]

승인

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

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

getSheetsCharts()

페이지의 SheetsChart 객체 목록을 반환합니다.

리턴

SheetsChart[]

승인

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

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

getSpeakerNotesShape()

페이지에서 발표자 노트를 포함하는 도형을 가져옵니다.

리턴

Shape

승인

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

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

getTables()

페이지의 Table 객체 목록을 반환합니다.

리턴

Table[]

승인

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

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

getVideos()

페이지의 Video 객체 목록을 반환합니다.

리턴

Video[]

승인

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

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

getWordArts()

페이지의 WordArt 객체 목록을 반환합니다.

리턴

WordArt[]

승인

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

  • 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