Class Page

페이지

프레젠테이션의 페이지입니다.

메서드

메서드반환 유형간략한 설명
asLayout()Layout페이지를 레이아웃으로 반환합니다.
asMaster()Master페이지를 마스터로 반환합니다.
asSlide()Slide페이지를 슬라이드로 반환합니다.
getBackground()PageBackground페이지의 배경을 가져옵니다.
getColorScheme()ColorScheme페이지와 연결된 ColorScheme를 가져옵니다.
getGroups()Group[]페이지의 Group 객체 목록을 반환합니다.
getImages()Image[]페이지의 Image 객체 목록을 반환합니다.
getLines()Line[]페이지의 Line 객체 목록을 반환합니다.
getObjectId()String페이지의 고유 ID를 가져옵니다.
getPageElementById(id)PageElement지정된 ID가 있는 페이지에서 PageElement를 반환하거나 ID가 없는 경우 null를 반환합니다.
getPageElements()PageElement[]페이지에서 렌더링된 PageElement 객체의 목록을 반환합니다.
getPageType()PageType페이지의 유형을 가져옵니다.
getPlaceholder(placeholderType)PageElement지정된 PlaceholderType의 자리표시자 PageElement 객체를 반환합니다. 또는 일치하는 자리표시자가 없으면 null입니다.
getPlaceholder(placeholderType, placeholderIndex)PageElement지정된 PlaceholderType의 자리표시자 PageElement 객체를 반환합니다. 자리표시자 색인 또는 자리표시자가 없는 경우 null.
getPlaceholders()PageElement[]페이지의 자리표시자 PageElement 객체 목록을 반환합니다.
getShapes()Shape[]페이지의 Shape 객체 목록을 반환합니다.
getSheetsCharts()SheetsChart[]페이지의 SheetsChart 객체 목록을 반환합니다.
getTables()Table[]페이지의 Table 객체 목록을 반환합니다.
getVideos()Video[]페이지의 Video 객체 목록을 반환합니다.
getWordArts()WordArt[]페이지의 WordArt 객체 목록을 반환합니다.
group(pageElements)Group지정된 모든 페이지 요소를 그룹화합니다.
insertGroup(group)Group제공된 Group의 사본을 페이지에 삽입합니다.
insertImage(blobSource)Image페이지의 왼쪽 상단에 지정된 크기에서 기본 크기로 이미지를 삽입합니다. 이미지 blob을 참조하세요.
insertImage(blobSource, left, top, width, height)Image지정된 이미지 blob에서 제공된 위치와 크기를 가진 이미지를 페이지에 삽입합니다.
insertImage(image)Image제공된 Image의 사본을 페이지에 삽입합니다.
insertImage(imageUrl)Image제공된 URL의 기본 크기로 페이지의 왼쪽 상단에 이미지를 삽입합니다.
insertImage(imageUrl, left, top, width, height)Image제공된 URL에서 제공된 위치와 크기를 사용하여 페이지에 이미지를 삽입합니다.
insertLine(line)Line제공된 Line의 사본을 페이지에 삽입합니다.
insertLine(lineCategory, startConnectionSite, endConnectionSite)Line페이지에 두 개의 connection sites을 연결하는 선을 삽입합니다.
insertLine(lineCategory, startLeft, startTop, endLeft, endTop)Line페이지에 선을 삽입합니다.
insertPageElement(pageElement)PageElement제공된 PageElement의 사본을 페이지에 삽입합니다.
insertShape(shape)Shape제공된 Shape의 사본을 페이지에 삽입합니다.
insertShape(shapeType)Shape페이지에 도형을 삽입합니다.
insertShape(shapeType, left, top, width, height)Shape페이지에 도형을 삽입합니다.
insertSheetsChart(sourceChart)SheetsChart페이지에 Google Sheets 차트를 삽입합니다.
insertSheetsChart(sourceChart, left, top, width, height)SheetsChart지정된 위치와 크기로 페이지에 Google Sheets 차트를 삽입합니다.
insertSheetsChart(sheetsChart)SheetsChart제공된 SheetsChart의 사본을 페이지에 삽입합니다.
insertSheetsChartAsImage(sourceChart)ImageGoogle Sheets 차트를 페이지에 Image로 삽입합니다.
insertSheetsChartAsImage(sourceChart, left, top, width, height)ImageGoogle Sheets 차트를 지정된 위치와 함께 Image로 페이지에 삽입합니다. 있습니다.
insertTable(numRows, numColumns)Table페이지에 표를 삽입합니다.
insertTable(numRows, numColumns, left, top, width, height)Table페이지에 제공된 위치와 크기의 표를 삽입합니다.
insertTable(table)Table제공된 Table의 사본을 페이지에 삽입합니다.
insertTextBox(text)Shape페이지에 제공된 문자열을 포함하는 텍스트 상자 Shape를 삽입합니다.
insertTextBox(text, left, top, width, height)Shape페이지에 제공된 문자열을 포함하는 텍스트 상자 Shape를 삽입합니다.
insertVideo(videoUrl)Video페이지의 왼쪽 상단에 기본 크기로 동영상을 삽입합니다.
insertVideo(videoUrl, left, top, width, height)Video페이지에 제공된 위치와 크기로 동영상을 삽입합니다.
insertVideo(video)Video제공된 Video의 사본을 페이지에 삽입합니다.
insertWordArt(wordArt)WordArt제공된 WordArt의 사본을 페이지에 삽입합니다.
remove()void페이지를 삭제합니다.
replaceAllText(findText, replaceText)Integer찾기 텍스트와 일치하는 모든 인스턴스를 교체 텍스트로 바꿉니다.
replaceAllText(findText, replaceText, matchCase)Integer찾기 텍스트와 일치하는 모든 인스턴스를 교체 텍스트로 바꿉니다.
selectAsCurrentPage()void활성 프레젠테이션에서 Pagecurrent page selection로 선택하고 이전 선택 항목을 삭제합니다.

자세한 문서

asLayout()

페이지를 레이아웃으로 반환합니다.

리턴

Layout - 페이지 레이아웃입니다.

승인

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

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

asMaster()

페이지를 마스터로 반환합니다.

리턴

Master - 마스터 페이지

승인

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

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

asSlide()

페이지를 슬라이드로 반환합니다.

리턴

Slide - 슬라이드인 페이지입니다.

승인

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

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

getBackground()

페이지의 배경을 가져옵니다.

리턴

PageBackground - 페이지의 배경입니다.

승인

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

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

getColorScheme()

페이지와 연결된 ColorScheme를 가져옵니다.

리턴

ColorScheme - 페이지의 색 구성표입니다.

승인

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

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

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

getPageType()

페이지의 유형을 가져옵니다.

리턴

PageType - 페이지 유형입니다.

승인

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

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

getPlaceholder(placeholderType)

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

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

var slide = SlidesApp.getActivePresentation().getSlides()[0];
var 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.

유형과 색인이 동일한 자리표시자가 여러 개 있는 경우 첫 번째 자리 표시자를 삭제합니다.

var slide = SlidesApp.getActivePresentation().getSlides()[0];
var 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 객체 목록을 반환합니다.

var 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

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

group(pageElements)

지정된 모든 페이지 요소를 그룹화합니다.

같은 페이지에는 아직 다른 페이지에 없는 요소가 2개 이상 있어야 합니다. 그룹 Videos, Tables, placeholder Shapes와 같은 일부 페이지 요소는 그룹화할 수 없습니다.

매개변수

이름유형설명
pageElementsPageElement[]그룹화할 요소입니다.

리턴

Group - 새 그룹입니다.

승인

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

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

insertGroup(group)

제공된 Group의 사본을 페이지에 삽입합니다.

이 페이지에서 삽입된 요소의 위치는 소스 요소의 각 페이지에 게재할 수 있습니다.

제공된 요소가 현재 프레젠테이션 내에서 복사 중인 자리표시자인 경우 마스터 또는 레이아웃 페이지에서 상속되는 속성은 삽입된 요소에서도 상속됩니다.

제공된 요소가 다른 프레젠테이션에서 복사 중인 자리표시자인 경우 마스터 또는 레이아웃 페이지에서 상속된 속성이 소스의 요소로 복사됨 살펴보겠습니다

// Copy a group between presentations.
var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0];
var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0];
var group = otherPresentationSlide.getGroups()[0];
currentPresentationSlide.insertGroup(group); // Also available for Layout, Master, and Page.

매개변수

이름유형설명
groupGroup복사 및 삽입할 그룹입니다.

리턴

Group - 삽입된 그룹입니다.

승인

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

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

insertImage(blobSource)

페이지의 왼쪽 상단에 지정된 크기에서 기본 크기로 이미지를 삽입합니다. 이미지 blob을 참조하세요.

이미지를 삽입하면 BlobSource에서 이미지를 한 번 가져오고 표시할 수 있습니다. 이미지 크기는 50MB 미만이어야 하며 25를 초과할 수 없습니다. 메가픽셀이어야 하며 PNG, JPEG 또는 GIF 형식이어야 합니다.

var slide = SlidesApp.getActivePresentation().getSlides()[0];
// Get the Drive image file with the given ID.
var image = DriveApp.getFileById(fileId);
slide.insertImage(image);

매개변수

이름유형설명
blobSourceBlobSource이미지 데이터입니다.

리턴

Image - 삽입된 이미지입니다.

승인

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

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

insertImage(blobSource, left, top, width, height)

지정된 이미지 blob에서 제공된 위치와 크기를 가진 이미지를 페이지에 삽입합니다.

이미지는 삽입 시점에 제공된 BlobSource에서 한 번 가져와 사본에서 가져옵니다. 프레젠테이션 내부에 표시되도록 저장됩니다. 이미지 크기는 50MB 미만이어야 하며 25메가픽셀을 초과하며 PNG, JPEG 또는 GIF 형식이어야 합니다.

이미지의 가로세로 비율을 유지하기 위해 이 비율에 따라 이미지가 조정되고 중앙에 배치됩니다. 크기를 줄일 수 있습니다.

var slide = SlidesApp.getActivePresentation().getSlides()[0];
// Get the Drive image file with the given ID.
var image = DriveApp.getFileById(fileId);
var position = {left: 0, top: 0};
var size = {width: 300, height: 100};
slide.insertImage(image, position.left, position.top, size.width, size.height);

매개변수

이름유형설명
blobSourceBlobSource이미지 데이터입니다.
leftNumber왼쪽 상단 모서리에서 측정한 이미지의 가로 위치입니다(포인트 단위). 입니다.
topNumber이미지의 왼쪽 상단 모서리에서 측정한 포인트 단위의 세로 위치입니다. 있습니다.
widthNumber이미지의 너비입니다(포인트 단위).
heightNumber이미지의 높이입니다(포인트 단위).

리턴

Image - 삽입된 이미지입니다.

승인

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

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

insertImage(image)

제공된 Image의 사본을 페이지에 삽입합니다.

이 페이지에 삽입된 이미지의 위치는 소스 이미지의 위치에 따라 결정됩니다. 를 참조하세요.

제공된 이미지가 현재 프레젠테이션 내에서 복사 중인 자리표시자인 경우 마스터 또는 레이아웃 페이지에서 상속되는 속성은 삽입된 이미지에서도 상속합니다.

제공된 이미지가 다른 프레젠테이션에서 복사된 자리표시자인 경우 마스터 또는 레이아웃 페이지에서 상속된 속성이 소스에서 이미지로 복사됨 살펴보겠습니다 복사된 자리표시자 이미지가 비어 있으면 대상에 아무것도 삽입되지 않습니다. 살펴보겠습니다

// Copy an image between presentations.
var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0];
var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0];
var image = otherPresentationSlide.getImages[0];
currentPresentationSlide.insertImage(image);

매개변수

이름유형설명
imageImage복사 및 삽입할 이미지입니다.

리턴

Image - 삽입된 이미지입니다.

승인

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

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

insertImage(imageUrl)

제공된 URL의 기본 크기로 페이지의 왼쪽 상단에 이미지를 삽입합니다.

이미지를 삽입하면 URL에서 이미지를 한 번 가져오고 사본은 살펴보겠습니다 이미지는 50MB 미만이어야 하고, 25메가픽셀을 초과할 수 없으며, 선택할 수 있습니다.

제공된 URL은 공개적으로 액세스할 수 있어야 하며 2KB 이하여야 합니다. URL 자체는 Image.getSourceUrl()를 통해 노출됩니다.

매개변수

이름유형설명
imageUrlString이미지 URL입니다.

리턴

Image - 삽입된 이미지입니다.

승인

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

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

insertImage(imageUrl, left, top, width, height)

제공된 URL에서 제공된 위치와 크기를 사용하여 페이지에 이미지를 삽입합니다.

이미지를 삽입하면 URL에서 이미지를 한 번 가져오고 사본은 살펴보겠습니다 이미지는 50MB 미만이어야 하고, 25메가픽셀을 초과할 수 없으며, 선택할 수 있습니다.

제공된 URL은 공개적으로 액세스할 수 있어야 하며 2KB 이하여야 합니다. URL 자체는 Image.getSourceUrl()를 통해 노출됩니다.

이미지의 가로세로 비율을 유지하기 위해 이 비율에 따라 이미지가 조정되고 중앙에 배치됩니다. 크기를 줄일 수 있습니다.

매개변수

이름유형설명
imageUrlString이미지 URL입니다.
leftNumber왼쪽 상단 모서리에서 측정한 이미지의 가로 위치입니다(포인트 단위). 입니다.
topNumber이미지의 왼쪽 상단 모서리에서 측정한 포인트 단위의 세로 위치입니다. 있습니다.
widthNumber이미지의 너비입니다(포인트 단위).
heightNumber이미지의 높이입니다(포인트 단위).

리턴

Image - 삽입된 이미지입니다.

승인

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

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

insertLine(line)

제공된 Line의 사본을 페이지에 삽입합니다.

이 페이지에서 삽입된 요소의 위치는 소스 요소의 각 페이지에 게재할 수 있습니다.

제공된 요소가 현재 프레젠테이션 내에서 복사 중인 자리표시자인 경우 마스터 또는 레이아웃 페이지에서 상속되는 속성은 삽입된 요소에서도 상속됩니다.

제공된 요소가 다른 프레젠테이션에서 복사 중인 자리표시자인 경우 마스터 또는 레이아웃 페이지에서 상속된 속성이 소스의 요소로 복사됨 살펴보겠습니다

// Copy a line between presentations.
var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0];
var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0];
var line = otherPresentationSlide.getLines[0];
currentPresentationSlide.insertLine(line);

매개변수

이름유형설명
lineLine복사 및 삽입할 행입니다.

리턴

Line - 삽입된 선입니다.

승인

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

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

insertLine(lineCategory, startConnectionSite, endConnectionSite)

페이지에 두 개의 connection sites을 연결하는 선을 삽입합니다. 둘 연결 사이트가 이 페이지에 있어야 합니다.

// Insert a line in the first slide of the presentation connecting two shapes.
var slide = SlidesApp.getActivePresentation().getSlides()[0];
var shape1 = slide.insertShape(SlidesApp.ShapeType.RECTANGLE);
var shape2 = slide.insertShape(SlidesApp.ShapeType.CLOUD);
slide.insertLine(
    SlidesApp.LineCategory.BENT,
    shape1.getConnectionSites()[0],
    shape2.getConnectionSites()[1]);

매개변수

이름유형설명
lineCategoryLineCategory삽입할 선의 카테고리입니다.
startConnectionSiteConnectionSite회선의 시작점이 연결될 연결 사이트입니다.
endConnectionSiteConnectionSite회선의 끝이 연결될 연결 사이트입니다.

리턴

Line - 삽입된 선입니다.

승인

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

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

insertLine(lineCategory, startLeft, startTop, endLeft, endTop)

페이지에 선을 삽입합니다.

// Insert a line in the first slide of the presentation.
var slide = SlidesApp.getActivePresentation().getSlides()[0];
var startPoint = {left: 10, top: 10};
var endPoint = {left: 40, top: 40};
slide.insertLine(
    SlidesApp.LineCategory.STRAIGHT,
    startPoint.left,
    startPoint.top,
    endPoint.left,
    endPoint.top);

매개변수

이름유형설명
lineCategoryLineCategory삽입할 선의 카테고리입니다.
startLeftNumber포인트 단위로 측정된 선 시작점의 수평 위치입니다. 을 클릭합니다.
startTopNumber선 시작점의 수직 위치로, 다음에서 점 단위로 측정됩니다. 있습니다.
endLeftNumber선 끝점의 수평 위치로, 다음에서 점 단위로 측정됩니다. 있습니다.
endTopNumber선 끝점의 수직 위치로 페이지의 왼쪽 상단 모서리에서 이미지를 클릭하세요.

리턴

Line - 삽입된 선입니다.

승인

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

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

insertPageElement(pageElement)

제공된 PageElement의 사본을 페이지에 삽입합니다.

이 페이지에서 삽입된 요소의 위치는 소스 요소의 각 페이지에 게재할 수 있습니다.

제공된 요소가 현재 프레젠테이션 내에서 복사 중인 자리표시자인 경우 마스터 또는 레이아웃 페이지에서 상속되는 속성은 삽입된 요소에서도 상속됩니다.

제공된 요소가 다른 프레젠테이션에서 복사 중인 자리표시자인 경우 마스터 또는 레이아웃 페이지에서 상속된 속성이 소스의 요소로 복사됨 살펴보겠습니다

// Copy a page element between presentations.
var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0];
var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0];
var pageElement = otherPresentationSlide.getPageElements()[0];

// Also available for Layout, Master, and Page.
currentPresentationSlide.insertPageElement(pageElement);

매개변수

이름유형설명
pageElementPageElement복사 및 삽입할 페이지 요소입니다.

리턴

PageElement - 삽입된 페이지 요소입니다.

승인

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

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

insertShape(shape)

제공된 Shape의 사본을 페이지에 삽입합니다.

이 페이지에서 삽입된 요소의 위치는 소스 요소의 각 페이지에 게재할 수 있습니다.

제공된 요소가 현재 프레젠테이션 내에서 복사 중인 자리표시자인 경우 마스터 또는 레이아웃 페이지에서 상속되는 속성은 삽입된 요소에서도 상속됩니다.

제공된 요소가 다른 프레젠테이션에서 복사 중인 자리표시자인 경우 마스터 또는 레이아웃 페이지에서 상속된 속성이 소스의 요소로 복사됨 살펴보겠습니다

// Copy a shape between presentations.
var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0];
var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0];
var shape = otherPresentationSlide.getShapes[0];
currentPresentationSlide.insertShape(shape); // Also available for Layout, Master, and Page.

매개변수

이름유형설명
shapeShape복사 및 삽입할 도형입니다.

리턴

Shape - 삽입된 도형입니다.

승인

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

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

insertShape(shapeType)

페이지에 도형을 삽입합니다.

도형은 페이지의 왼쪽 상단에 기본 크기로 삽입됩니다.

// Insert a shape in the first slide of the presentation.
var slide = SlidesApp.getActivePresentation().getSlides()[0];

// Also available for Layout, Master, and Page.
slide.insertShape(SlidesApp.ShapeType.RECTANGLE);

매개변수

이름유형설명
shapeTypeShapeType삽입할 도형의 유형입니다.

리턴

Shape - 삽입된 도형입니다.

승인

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

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

insertShape(shapeType, left, top, width, height)

페이지에 도형을 삽입합니다.

매개변수

이름유형설명
shapeTypeShapeType삽입할 도형의 유형입니다.
leftNumber도형의 수평 위치로, 도형의 왼쪽 상단으로부터 측정됩니다. 있습니다.
topNumber페이지의 왼쪽 상단에서 측정한 도형의 세로 위치입니다.
widthNumber셰이프의 너비입니다.
heightNumber셰이프의 높이입니다.

리턴

Shape - 삽입된 도형입니다.

승인

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

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

insertSheetsChart(sourceChart)

페이지에 Google Sheets 차트를 삽입합니다.

차트는 페이지 왼쪽 상단에 기본 크기로 삽입됩니다.

삽입된 차트는 원본 Google Sheets 차트와 연결되어 이(가) 업데이트되었습니다. 다른 공동작업자는 소스 스프레드시트의 링크를 볼 수 있습니다.

var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
var chart = sheet.getCharts()[0];
// Insert the spreadsheet chart in the first slide.
var slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.insertSheetsChart(chart);

매개변수

이름유형설명
sourceChartEmbeddedChart페이지에 삽입할 스프레드시트의 차트입니다.

리턴

SheetsChart - 페이지에 삽입된 차트입니다.

승인

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

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

insertSheetsChart(sourceChart, left, top, width, height)

지정된 위치와 크기로 페이지에 Google Sheets 차트를 삽입합니다.

차트의 가로세로 비율을 유지하기 위해 차트는 해당 비율에 따라 크기가 조정되고 가운데에 배치됩니다. 크기를 줄일 수 있습니다.

삽입된 차트는 원본 Google Sheets 차트와 연결되어 이(가) 업데이트되었습니다. 다른 공동작업자는 소스 스프레드시트의 링크를 볼 수 있습니다.

var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
var chart = sheet.getCharts()[0];
// Insert the spreadsheet chart in the first slide.
var slide = SlidesApp.getActivePresentation().getSlides()[0];
var position = {left: 0, top: 0};
var size = {width: 200, height: 200};

// Also available for Layout, Master, and Page.
slide.insertSheetsChart(
    chart,
    position.left,
    position.top,
    size.width,
    size.height);

매개변수

이름유형설명
sourceChartEmbeddedChart페이지에 삽입할 스프레드시트의 차트입니다.
leftNumber왼쪽 상단 모서리에서 측정한 차트의 가로 위치입니다(포인트). 입니다.
topNumber차트의 왼쪽 상단으로부터 측정한 차트의 세로 위치입니다(포인트). 있습니다.
widthNumber차트의 너비입니다(포인트).
heightNumber차트의 높이입니다(포인트).

리턴

SheetsChart - 페이지에 삽입된 차트입니다.

승인

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

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

insertSheetsChart(sheetsChart)

제공된 SheetsChart의 사본을 페이지에 삽입합니다.

이 페이지에서 삽입된 요소의 위치는 소스 요소의 각 페이지에 게재할 수 있습니다.

제공된 요소가 현재 프레젠테이션 내에서 복사 중인 자리표시자인 경우 마스터 또는 레이아웃 페이지에서 상속되는 속성은 삽입된 요소에서도 상속됩니다.

제공된 요소가 다른 프레젠테이션에서 복사 중인 자리표시자인 경우 마스터 또는 레이아웃 페이지에서 상속된 속성이 소스의 요소로 복사됨 살펴보겠습니다

// Copy a sheets chart between presentations.
var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0];
var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0];
var sheetsChart = otherPresentationSlide.getSheetsCharts[0];

// Also available for Layout, Master, and Page.
currentPresentationSlide.insertSheetsChart(sheetsChart);

매개변수

이름유형설명
sheetsChartSheetsChart복사 및 삽입할 시트 차트입니다.

리턴

SheetsChart - 삽입된 시트 차트입니다.

승인

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

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

insertSheetsChartAsImage(sourceChart)

Google Sheets 차트를 페이지에 Image로 삽입합니다.

차트의 이미지가 페이지 왼쪽 상단에 기본 크기로 삽입됩니다.

삽입된 차트 이미지가 원본 Google Sheets 차트와 연결되어 있지 않습니다.

var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
var chart = sheet.getCharts()[0];
// Insert the spreadsheet chart in the first slide.
var slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.insertSheetsChartAsImage(chart); // Also available for Layout, Master, and Page.

매개변수

이름유형설명
sourceChartEmbeddedChart페이지에 삽입할 스프레드시트의 차트입니다.

리턴

Image - 페이지에 삽입된 차트 이미지입니다.

승인

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

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

insertSheetsChartAsImage(sourceChart, left, top, width, height)

Google Sheets 차트를 지정된 위치와 함께 Image로 페이지에 삽입합니다. 있습니다.

차트 이미지의 가로세로 비율을 유지하기 위해 이미지는 크기에 맞게 조정됩니다.

삽입된 차트 이미지가 원본 Google Sheets 차트와 연결되어 있지 않습니다.

var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
var chart = sheet.getCharts()[0];
// Insert the spreadsheet chart in the first slide.
var slide = SlidesApp.getActivePresentation().getSlides()[0];
var position = {left: 0, top: 0};
var size = {width: 200, height: 200};

// Also available for Layout, Master, and Page.
slide.insertSheetsChartAsImage(
    chart,
    position.left,
    position.right,
    size.width,
    size.height);

매개변수

이름유형설명
sourceChartEmbeddedChart페이지에 삽입할 스프레드시트의 차트입니다.
leftNumber왼쪽 상단 모서리에서 측정한 차트의 가로 위치입니다(포인트). 입니다.
topNumber차트의 왼쪽 상단으로부터 측정한 차트의 세로 위치입니다(포인트). 있습니다.
widthNumber차트의 너비입니다(포인트).
heightNumber차트의 높이입니다(포인트).

리턴

Image - 페이지에 삽입된 차트 이미지입니다.

승인

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

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

insertTable(numRows, numColumns)

페이지에 표를 삽입합니다.

표는 기본 크기로 페이지 중앙에 배치되며 행과 열이 고르게 분포되어 있습니다.

매개변수

이름유형설명
numRowsInteger테이블의 행 수입니다.
numColumnsInteger테이블의 열 수입니다.

리턴

Table - 삽입된 표입니다.

승인

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

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

insertTable(numRows, numColumns, left, top, width, height)

페이지에 제공된 위치와 크기의 표를 삽입합니다.

생성된 테이블에 행과 열이 균등하게 분산됩니다.

매개변수

이름유형설명
numRowsInteger테이블의 행 수입니다.
numColumnsInteger테이블의 열 수입니다.
leftNumber표의 왼쪽 상단으로부터 측정한 표의 가로 위치입니다. 있습니다.
topNumber표의 세로 위치입니다(페이지 왼쪽 상단 모서리에서 측정).
widthNumber표의 너비입니다.
heightNumber표의 최소 높이입니다. 렌더링된 테이블의 실제 높이는 영향을 줄 수 있습니다.

리턴

Table - 삽입된 표입니다.

승인

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

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

insertTable(table)

제공된 Table의 사본을 페이지에 삽입합니다.

이 페이지에서 삽입된 요소의 위치는 소스 요소의 각 페이지에 게재할 수 있습니다.

제공된 요소가 현재 프레젠테이션 내에서 복사 중인 자리표시자인 경우 마스터 또는 레이아웃 페이지에서 상속되는 속성은 삽입된 요소에서도 상속됩니다.

제공된 요소가 다른 프레젠테이션에서 복사 중인 자리표시자인 경우 마스터 또는 레이아웃 페이지에서 상속된 속성이 소스의 요소로 복사됨 살펴보겠습니다

// Copy a table between presentations.
var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0];
var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0];
var table = otherPresentationSlide.getTables[0];
currentPresentationSlide.insertTable(table); // Also available for Layout, Master, and Page.

매개변수

이름유형설명
tableTable복사 및 삽입할 표입니다.

리턴

Table - 삽입된 표입니다.

승인

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

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

insertTextBox(text)

페이지에 제공된 문자열을 포함하는 텍스트 상자 Shape를 삽입합니다.

페이지 왼쪽 상단에 기본 크기로 텍스트 상자 도형이 삽입됩니다.

// Insert text box with "Hello" on the first slide of presentation.
var slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.insertTextBox('Hello'); // Also available for Layout, Master, and Page.

매개변수

이름유형설명
textString텍스트 상자 도형에 포함되어야 하는 문자열입니다.

리턴

Shape - 삽입된 텍스트 상자 도형입니다.

승인

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

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

insertTextBox(text, left, top, width, height)

페이지에 제공된 문자열을 포함하는 텍스트 상자 Shape를 삽입합니다.

// Insert text box with "Hello" on the first slide of presentation. This text box is a square
// with a length of 10 points on each side.
var slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.insertTextBox('Hello', 0, 0, 10, 10); // Also available for Layout, Master, and Page.

매개변수

이름유형설명
textString텍스트 상자 도형에 포함되어야 하는 문자열입니다.
leftNumber왼쪽 상단 모서리에서 측정한 텍스트 상자 도형의 가로 위치입니다. 입니다.
topNumber왼쪽 상단 모서리에서 측정한 텍스트 상자 도형의 세로 위치입니다. 있습니다.
widthNumber텍스트 상자 도형의 너비입니다.
heightNumber텍스트 상자 도형의 높이입니다.

리턴

Shape - 삽입된 텍스트 상자 도형입니다.

승인

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

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

insertVideo(videoUrl)

페이지의 왼쪽 상단에 기본 크기로 동영상을 삽입합니다.

현재 YouTube 동영상만 지원됩니다.

매개변수

이름유형설명
videoUrlString삽입할 동영상의 URL입니다.

리턴

Video - 삽입된 동영상입니다.

승인

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

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

insertVideo(videoUrl, left, top, width, height)

페이지에 제공된 위치와 크기로 동영상을 삽입합니다.

현재 YouTube 동영상만 지원됩니다.

매개변수

이름유형설명
videoUrlString삽입할 동영상의 URL입니다.
leftNumber왼쪽 상단 모서리에서 측정한 동영상의 가로 위치입니다(포인트). 입니다.
topNumber동영상의 왼쪽 상단 모서리에서 측정한 동영상의 세로 위치(포인트)입니다. 있습니다.
widthNumber동영상의 너비입니다(포인트 단위).
heightNumber동영상의 높이입니다(포인트 단위).

리턴

Video - 삽입된 동영상입니다.

승인

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

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

insertVideo(video)

제공된 Video의 사본을 페이지에 삽입합니다.

이 페이지에서 삽입된 요소의 위치는 소스 요소의 각 페이지에 게재할 수 있습니다.

제공된 요소가 현재 프레젠테이션 내에서 복사 중인 자리표시자인 경우 마스터 또는 레이아웃 페이지에서 상속되는 속성은 삽입된 요소에서도 상속됩니다.

제공된 요소가 다른 프레젠테이션에서 복사 중인 자리표시자인 경우 마스터 또는 레이아웃 페이지에서 상속된 속성이 소스의 요소로 복사됨 살펴보겠습니다

// Copy a video between presentations.
var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0];
var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0];
var video = otherPresentationSlide.getVideos[0];
currentPresentationSlide.insertVideo(video); // Also available for Layout, Master, and Page.

매개변수

이름유형설명
videoVideo복사 및 삽입할 동영상입니다.

리턴

Video - 삽입된 동영상입니다.

승인

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

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

insertWordArt(wordArt)

제공된 WordArt의 사본을 페이지에 삽입합니다.

이 페이지에서 삽입된 요소의 위치는 소스 요소의 각 페이지에 게재할 수 있습니다.

제공된 요소가 현재 프레젠테이션 내에서 복사 중인 자리표시자인 경우 마스터 또는 레이아웃 페이지에서 상속되는 속성은 삽입된 요소에서도 상속됩니다.

제공된 요소가 다른 프레젠테이션에서 복사 중인 자리표시자인 경우 마스터 또는 레이아웃 페이지에서 상속된 속성이 소스의 요소로 복사됨 살펴보겠습니다

// Copy a word art between presentations.
var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0];
var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0];
var wordArt = otherPresentationSlide.getWordArts[0];

// Also available for Layout, Master, and Page.
currentPresentationSlide.insertWordArt(wordArt);

매개변수

이름유형설명
wordArtWordArt복사 및 삽입할 그룹입니다.

리턴

WordArt - 삽입된 워드아트입니다.

승인

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

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

remove()

페이지를 삭제합니다.

승인

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

  • 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

selectAsCurrentPage()

활성 프레젠테이션에서 Pagecurrent page selection로 선택하고 이전 선택 항목을 삭제합니다.

스크립트는 스크립트를 실행하는 사용자의 선택에 액세스할 수 있고 스크립트가 프레젠테이션에 바인딩된 경우

// Select the first slide as the current page selection and replace any previous selection.
var slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.selectAsCurrentPage(); // Also available for Layout, Master, and Page.

승인

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

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