프레젠테이션의 슬라이드입니다.
이 페이지에는 시청자에게 발표하는 콘텐츠가 포함되어 있습니다. 대부분의 슬라이드는 마스터와 레이아웃을 기반으로 합니다. 각 슬라이드를 만들 때 사용할 레이아웃을 지정할 수 있습니다.
방법
자세한 문서
duplicate()
getBackground()
페이지의 배경을 가져옵니다.
Return 키
PageBackground
: 페이지의 배경입니다.
승인
이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getColorScheme()
페이지와 연결된 ColorScheme
를 가져옵니다.
Return 키
ColorScheme
: 페이지의 색 구성표입니다.
승인
이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getGroups()
getImages()
getLayout()
getLines()
getNotesPage()
getObjectId()
페이지의 고유 ID를 가져옵니다. 페이지 및 페이지 요소에서 사용하는 객체 ID는 동일한 네임스페이스를 공유합니다.
Return 키
String
승인
이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getPageElementById(id)
지정된 ID가 있는 페이지에서 PageElement
를 반환하거나 없는 경우 null
를 반환합니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
id | String | 검색되는 페이지 요소의 ID입니다. |
Return 키
PageElement
: 지정된 ID가 있는 페이지 요소입니다.
승인
이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getPageElements()
페이지에서 렌더링된 PageElement
객체 목록을 반환합니다.
Return 키
승인
이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getPageType()
getPlaceholder(placeholderType)
일치하는 자리표시자가 없으면 지정된 PlaceholderType
또는 null
의 자리표시자 PageElement
객체를 반환합니다.
동일한 유형의 자리표시자가 여러 개 있는 경우 최소한의 자리표시자 색인이 있는 자리표시자가 반환됩니다. 색인이 동일한 일치하는 자리표시자가 여러 개 있는 경우 페이지의 페이지 요소 컬렉션에서 첫 번째 자리표시자를 반환합니다.
var slide = SlidesApp.getActivePresentation().getSlides()[0]; var placeholder = slide.getPlaceholder(SlidesApp.PlaceholderType.CENTERED_TITLE);
매개변수
이름 | 유형 | 설명 |
---|---|---|
placeholderType | PlaceholderType |
Return 키
승인
이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인이 필요합니다.
-
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);
매개변수
이름 | 유형 | 설명 |
---|---|---|
placeholderType | PlaceholderType | |
placeholderIndex | Integer |
Return 키
승인
이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인이 필요합니다.
-
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);
Return 키
승인
이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getShapes()
getSheetsCharts()
페이지의 SheetsChart
객체 목록을 반환합니다.
Return 키
승인
이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getSlideLinkingMode()
슬라이드가 다른 슬라이드에 연결되어 있는지 나타내는 SlideLinkingMode
를 반환합니다.
Return 키
SlideLinkingMode
- 슬라이드 연결 모드입니다.
승인
이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getSourcePresentationId()
슬라이드가 연결되지 않은 경우 원본 Presentation
ID 또는 null
를 반환합니다.
슬라이드가 다른 프레젠테이션 내의 슬라이드에 연결된 경우에만 소스 Presentation
ID가 있습니다.
Return 키
String
: 원본 프레젠테이션 ID 또는 null
입니다.
승인
이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getSourceSlideObjectId()
원본 슬라이드 ID를 반환하거나 슬라이드가 연결되지 않은 경우 null
를 반환합니다.
슬라이드는 다른 프레젠테이션 내의 슬라이드에 연결된 경우에만 원본 슬라이드 ID가 있습니다.
Return 키
String
: 원본 슬라이드 ID 또는 null
입니다.
승인
이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getTables()
getVideos()
getWordArts()
group(pageElements)
지정된 모든 페이지 요소를 그룹화합니다.
같은 페이지에 이미 다른 그룹에 없는 페이지 요소가 2개 이상 있어야 합니다. Videos
, Tables
, placeholder Shapes
등 일부 페이지 요소는 그룹화할 수 없습니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
pageElements | PageElement[] | 그룹화할 요소. |
Return 키
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.
매개변수
이름 | 유형 | 설명 |
---|---|---|
group | Group | 복사하여 삽입할 그룹입니다. |
Return 키
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);
매개변수
이름 | 유형 | 설명 |
---|---|---|
blobSource | BlobSource | 이미지 데이터입니다. |
Return 키
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);
매개변수
이름 | 유형 | 설명 |
---|---|---|
blobSource | BlobSource | 이미지 데이터입니다. |
left | Number | 페이지의 왼쪽 상단에서 측정한 이미지의 가로 위치입니다. |
top | Number | 페이지의 왼쪽 상단에서 측정한 이미지의 세로 위치입니다. |
width | Number | 이미지의 너비(포인트)입니다. |
height | Number | 이미지의 높이(포인트)입니다. |
Return 키
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);
매개변수
이름 | 유형 | 설명 |
---|---|---|
image | Image | 복사하여 삽입할 이미지입니다. |
Return 키
Image
- 삽입된 이미지입니다.
승인
이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertImage(imageUrl)
제공된 URL의 기본 크기를 사용하여 페이지의 왼쪽 상단에 이미지를 삽입합니다.
이미지를 삽입하면 URL에서 한 번 가져오며 프레젠테이션 내에 표시되도록 사본이 저장됩니다. 이미지 크기는 50MB 미만이고 25메가픽셀을 초과할 수 없으며 PNG, JPEG 또는 GIF 형식이어야 합니다.
제공된 URL은 공개적으로 액세스할 수 있어야 하며 2KB 이하여야 합니다. URL 자체는 이미지와 함께 저장되고 Image.getSourceUrl()
를 통해 노출됩니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
imageUrl | String | 이미지 URL입니다. |
Return 키
Image
- 삽입된 이미지입니다.
승인
이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertImage(imageUrl, left, top, width, height)
제공된 위치와 제공된 위치 및 크기가 포함된 이미지를 페이지에 삽입합니다.
이미지를 삽입하면 URL에서 한 번 가져오며 프레젠테이션 내에 표시되도록 사본이 저장됩니다. 이미지 크기는 50MB 미만이고 25메가픽셀을 초과할 수 없으며 PNG, JPEG 또는 GIF 형식이어야 합니다.
제공된 URL은 공개적으로 액세스할 수 있어야 하며 2KB 이하여야 합니다. URL 자체는 이미지와 함께 저장되고 Image.getSourceUrl()
를 통해 노출됩니다.
이미지의 가로세로 비율을 유지하기 위해 이미지 크기가 조정되고 제공된 크기를 기준으로 중심이 설정됩니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
imageUrl | String | 이미지 URL입니다. |
left | Number | 페이지의 왼쪽 상단에서 측정한 이미지의 가로 위치입니다. |
top | Number | 페이지의 왼쪽 상단에서 측정한 이미지의 세로 위치입니다. |
width | Number | 이미지의 너비(포인트)입니다. |
height | Number | 이미지의 높이(포인트)입니다. |
Return 키
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);
매개변수
이름 | 유형 | 설명 |
---|---|---|
line | Line | 복사하여 삽입할 행입니다. |
Return 키
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]);
매개변수
이름 | 유형 | 설명 |
---|---|---|
lineCategory | LineCategory | 삽입할 선의 카테고리입니다. |
startConnectionSite | ConnectionSite | 라인의 시작을 연결할 연결 사이트입니다. |
endConnectionSite | ConnectionSite | 라인의 끝을 연결할 연결 사이트입니다. |
Return 키
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);
매개변수
이름 | 유형 | 설명 |
---|---|---|
lineCategory | LineCategory | 삽입할 선의 카테고리입니다. |
startLeft | Number | 페이지 왼쪽 상단에서 포인트로 측정된 선 시작 지점의 가로 위치입니다. |
startTop | Number | 페이지 왼쪽 상단 모서리에서부터 측정한 지점의 선 시작점의 세로 위치입니다. |
endLeft | Number | 페이지 왼쪽 상단에서 점 단위로 측정한 선 끝 지점의 가로 위치입니다. |
endTop | Number | 선 왼쪽 끝에 있는 점을 기준으로 측정한 선 끝의 세로 위치입니다. |
Return 키
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);
매개변수
이름 | 유형 | 설명 |
---|---|---|
pageElement | PageElement | 복사하여 삽입할 페이지 요소입니다. |
Return 키
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.
매개변수
이름 | 유형 | 설명 |
---|---|---|
shape | Shape | 복사하여 삽입할 도형 |
Return 키
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);
매개변수
이름 | 유형 | 설명 |
---|---|---|
shapeType | ShapeType | 삽입할 도형 유형입니다. |
Return 키
Shape
- 삽입된 도형
승인
이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertShape(shapeType, left, top, width, height)
페이지에 도형을 삽입합니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
shapeType | ShapeType | 삽입할 도형 유형입니다. |
left | Number | 페이지의 왼쪽 상단에서 측정한 도형의 가로 위치입니다. |
top | Number | 도형의 세로 위치로, 페이지 왼쪽 상단에서 측정됩니다. |
width | Number | 도형의 너비 |
height | Number | 셰이프의 높이입니다. |
Return 키
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);
매개변수
이름 | 유형 | 설명 |
---|---|---|
sourceChart | EmbeddedChart | 페이지에 삽입할 스프레드시트의 차트입니다. |
Return 키
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);
매개변수
이름 | 유형 | 설명 |
---|---|---|
sourceChart | EmbeddedChart | 페이지에 삽입할 스프레드시트의 차트입니다. |
left | Number | 페이지의 왼쪽 상단에서 측정한 차트의 가로 위치입니다. |
top | Number | 페이지의 왼쪽 상단에서 측정한 포인트의 차트 세로 위치입니다. |
width | Number | 포인트의 차트의 너비입니다. |
height | Number | 차트의 높이입니다. |
Return 키
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);
매개변수
이름 | 유형 | 설명 |
---|---|---|
sheetsChart | SheetsChart | 복사하여 삽입할 시트 차트입니다. |
Return 키
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.
매개변수
이름 | 유형 | 설명 |
---|---|---|
sourceChart | EmbeddedChart | 페이지에 삽입할 스프레드시트의 차트입니다. |
Return 키
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);
매개변수
이름 | 유형 | 설명 |
---|---|---|
sourceChart | EmbeddedChart | 페이지에 삽입할 스프레드시트의 차트입니다. |
left | Number | 페이지의 왼쪽 상단에서 측정한 차트의 가로 위치입니다. |
top | Number | 페이지의 왼쪽 상단에서 측정한 포인트의 차트 세로 위치입니다. |
width | Number | 포인트의 차트의 너비입니다. |
height | Number | 차트의 높이입니다. |
Return 키
Image
- 페이지에 삽입된 차트의 이미지입니다.
승인
이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertTable(numRows, numColumns)
페이지에 표를 삽입합니다.
표의 중심은 기본 크기이고 균등하게 분산된 행과 열로 이루어집니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
numRows | Integer | 테이블의 행 수입니다. |
numColumns | Integer | 테이블의 열 수입니다. |
Return 키
Table
— 삽입된 테이블입니다.
승인
이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertTable(numRows, numColumns, left, top, width, height)
제공된 위치와 크기가 있는 표를 페이지에 삽입합니다.
생성된 테이블에 행과 열이 균등하게 분산됩니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
numRows | Integer | 테이블의 행 수입니다. |
numColumns | Integer | 테이블의 열 수입니다. |
left | Number | 페이지의 왼쪽 상단에서 측정된 테이블의 가로 위치입니다. |
top | Number | 페이지의 왼쪽 상단에서 측정한 표의 세로 위치입니다. |
width | Number | 표의 너비입니다. |
height | Number | 테이블의 최소 높이입니다. 렌더링된 테이블의 실제 높이는 텍스트 글꼴 크기와 같은 요소에 따라 달라집니다. |
Return 키
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.
매개변수
이름 | 유형 | 설명 |
---|---|---|
table | Table | 복사하여 삽입할 테이블입니다. |
Return 키
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.
매개변수
이름 | 유형 | 설명 |
---|---|---|
text | String | 텍스트 상자 도형에 포함되어야 하는 문자열입니다. |
Return 키
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.
매개변수
이름 | 유형 | 설명 |
---|---|---|
text | String | 텍스트 상자 도형에 포함되어야 하는 문자열입니다. |
left | Number | 페이지의 왼쪽 상단에서 측정된 텍스트 상자 도형의 가로 위치입니다. |
top | Number | 페이지의 왼쪽 상단에서 측정된 텍스트 상자 도형의 세로 위치입니다. |
width | Number | 텍스트 상자 도형의 너비입니다. |
height | Number | 텍스트 상자 도형의 높이입니다. |
Return 키
Shape
- 삽입된 텍스트 상자 도형입니다.
승인
이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertVideo(videoUrl)
insertVideo(videoUrl, left, top, width, height)
지정된 위치 및 크기로 동영상을 페이지에 삽입합니다.
현재 YouTube 동영상만 지원됩니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
videoUrl | String | 삽입할 동영상의 URL입니다. |
left | Number | 페이지의 왼쪽 상단에서 측정된 동영상의 가로 위치입니다. |
top | Number | 동영상의 세로 위치로, 페이지의 왼쪽 상단에서 측정됩니다. |
width | Number | 동영상의 너비(포인트)입니다. |
height | Number | 동영상의 높이입니다. |
Return 키
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.
매개변수
이름 | 유형 | 설명 |
---|---|---|
video | Video | 복사하여 삽입할 동영상입니다. |
Return 키
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);
매개변수
이름 | 유형 | 설명 |
---|---|---|
wordArt | WordArt | 복사하여 삽입할 그룹입니다. |
Return 키
WordArt
- 삽입된 워드아트입니다.
승인
이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
isSkipped()
프레젠테이션 모드에서 슬라이드를 건너뛸지 여부를 반환합니다.
Return 키
Boolean
: 프레젠테이션 모드에서 슬라이드를 건너뛴 경우 True
입니다.
승인
이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
move(index)
슬라이드를 지정된 색인으로 이동합니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
index | Integer | 이동 전의 슬라이드 정렬을 기반으로 슬라이드를 이동해야 하는 색인입니다. 색인은 0과 프레젠테이션의 슬라이드 수 사이여야 합니다. |
승인
이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
refreshSlide()
연결된 소스 슬라이드의 변경사항을 반영하도록 슬라이드를 새로고침합니다. 이 슬라이드가 연결되어 있지 않으면 변경하지 않고 반환합니다.
refreshSlide
메서드는 연결된 소스 슬라이드의 해당 마스터 및 레이아웃 페이지를 슬라이드의 프레젠테이션에 복사합니다(아직 없는 경우). 이미 존재하는 경우 소스에 적용된 변경사항을 반영하도록 업데이트됩니다.
var currentPresentation = SlidesApp.getActivePresentation(); var sourcePresentation = SlidesApp.openById('sourcePresentationId'); var sourceSlide = sourcePresentation.getSlides()[0]; var linkedSlide = currentPresentation.append(sourceSlide, SlidesApp.SlideLinkingMode.LINKED); sourceSlide.insertText('hello world'); // Only the source slide has the text box. linkedSlide.refreshSlide(); // The linked slide now has the text box.
생성 값
Error
: 원본 프레젠테이션에 대한 읽기 액세스를 더 이상 사용할 수 없는 경우
승인
이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인이 필요합니다.
-
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)
찾기 텍스트와 일치하는 모든 텍스트를 찾기 텍스트로 바꿉니다. 검색 시 대소문자를 구분하지 않습니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
findText | String | 찾을 텍스트입니다. |
replaceText | String | 일치하는 텍스트를 대체할 텍스트입니다. |
Return 키
Integer
— 변경된 항목 수
승인
이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replaceAllText(findText, replaceText, matchCase)
찾기 텍스트와 일치하는 모든 텍스트를 찾기 텍스트로 바꿉니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
findText | String | 찾을 텍스트입니다. |
replaceText | String | 일치하는 텍스트를 대체할 텍스트입니다. |
matchCase | Boolean | true 이면 대소문자를 구분합니다. false 이면 대소문자를 구분하지 않습니다. |
Return 키
Integer
— 변경된 항목 수
승인
이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
selectAsCurrentPage()
활성 프레젠테이션의 Page
를 current 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
setSkipped(isSkipped)
프레젠테이션 모드에서 슬라이드를 건너뛸지 여부를 설정합니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
isSkipped | Boolean | True : 프레젠테이션 모드에서 슬라이드를 건너뜁니다. |
승인
이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
unlink()
현재 슬라이드에서 Slide
연결을 해제합니다. 이 슬라이드가 연결되지 않은 경우 아무것도 변경하지 않고 반환됩니다.
var currentPresentation = SlidesApp.getActivePresentation(); var sourcePresentation = SlidesApp.openById('sourcePresentationId'); var sourceSlide = sourcePresentation.getSlides()[0]; var linkedSlide = currentPresentation.append(sourceSlide, SlidesApp.SlideLinkingMode.LINKED); linkedSlide.unlink(); linkedSlide.getSourcePresentationId(); // returns null linkedSlide.getSourceSlideObjectId(); // returns null linkedSlide.getSlideLinkingMode(); // returns SlidesApp.SlideLinkingMode.NOT_LINKED
승인
이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations