Class NotesPage

NotesPage

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

이 페이지에는 슬라이드의 발표자 노트가 포함된 도형을 비롯한 프레젠테이션 핸드아웃의 콘텐츠가 포함되어 있습니다. 각 슬라이드에는 해당하는 메모 페이지가 하나씩 있습니다. 발표자 메모 도형의 텍스트만 수정할 수 있습니다.

메서드

메서드반환 유형간략한 설명
getGroups()Group[]페이지의 Group 객체 목록을 반환합니다.
getImages()Image[]페이지의 Image 객체 목록을 반환합니다.
getLines()Line[]페이지의 Line 객체 목록을 반환합니다.
getObjectId()String페이지의 고유 ID를 가져옵니다.
getPageElementById(id)PageElement|null지정된 ID가 있는 페이지의 PageElement을 반환하거나, 없는 경우 null을 반환합니다.
getPageElements()PageElement[]페이지에 렌더링된 PageElement 객체 목록을 반환합니다.
getPlaceholder(placeholderType)PageElement|null일치하는 자리표시자가 없는 경우 지정된 PlaceholderType 또는 null의 자리표시자 PageElement 객체를 반환합니다.
getPlaceholder(placeholderType, placeholderIndex)PageElement|null지정된 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을 반환하거나, 없는 경우 null을 반환합니다.

매개변수

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

리턴

PageElement|null - 지정된 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|null

승인

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

  • 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|null

승인

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

  • 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