Class Image

이미지

이미지를 나타내는 PageElement입니다.

메서드

메서드반환 유형간략한 설명
alignOnPage(alignmentPosition)Image요소를 페이지에서 지정된 정렬 위치에 정렬합니다.
bringForward()Image페이지에서 페이지 요소를 한 요소씩 앞으로 가져옵니다.
bringToFront()Image페이지 요소를 페이지의 맨 앞으로 가져옵니다.
duplicate()PageElement페이지 요소를 복사합니다.
getAs(contentType)Blob이 객체 내의 데이터를 지정된 콘텐츠 유형으로 변환된 blob으로 반환합니다.
getBlob()Blob이 이미지 내의 데이터를 blob으로 반환합니다.
getBorder()Border이미지의 Border를 반환합니다.
getConnectionSites()ConnectionSite[]페이지 요소의 ConnectionSite 목록을 반환하거나 페이지가 요소에 연결 사이트가 없습니다.
getContentUrl()String이미지의 URL을 가져옵니다.
getDescription()String페이지 요소의 대체 텍스트 설명을 반환합니다.
getHeight()Number요소 높이(포인트, 즉 요소에 회전이 없습니다.
getInherentHeight()Number요소의 고유 높이를 반환합니다(포인트).
getInherentWidth()Number요소의 고유 너비를 포인트 단위로 반환합니다.
getLeft()Number요소의 왼쪽 상단으로부터 측정된 요소의 가로 위치를 포인트 단위로 반환합니다. 페이지에 회전이 없을 때 나타납니다.
getLink()Link링크가 없으면 Link 또는 null를 반환합니다.
getObjectId()String이 객체의 고유 ID를 반환합니다.
getPageElementType()PageElementTypePageElementType enum으로 표시된 페이지 요소의 유형을 반환합니다.
getParentGroup()Group이 페이지 요소가 속한 그룹을 반환하거나 null 요소가 그룹
getParentPage()Page이 페이지 요소가 있는 페이지를 반환합니다.
getParentPlaceholder()PageElement자리표시자의 상위 페이지 요소를 반환합니다.
getPlaceholderIndex()Integer자리표시자 이미지의 색인을 반환합니다.
getPlaceholderType()PlaceholderType이미지의 자리표시자 유형을 반환하거나 도형이 아닌 경우 PlaceholderType.NONE를 반환합니다. 자리 표시자입니다.
getRotation()Number중심을 중심으로 한 요소의 시계 방향 회전 각도를 도 단위로 반환합니다. 여기서 0도입니다. 이는 회전이 없음을 의미합니다.
getSourceUrl()String이미지의 소스 URL을 가져옵니다(있는 경우).
getTitle()String페이지 요소의 대체 텍스트 제목을 반환합니다.
getTop()Number페이지의 왼쪽 상단 모서리에서 측정한 요소의 세로 위치(포인트)를 가져옵니다. 요소에 회전이 없을 때
getTransform()AffineTransform페이지 요소의 변환을 반환합니다.
getWidth()Number요소의 너비를 포인트로 반환합니다. 포인트는 요소의 경계 상자 너비인 요소에 회전이 없습니다.
preconcatenateTransform(transform)Image제공된 변환을 페이지 요소의 기존 변환에 미리 연결합니다.
remove()void페이지 요소를 삭제합니다.
removeLink()voidLink를 삭제합니다.
replace(blobSource)Image이 이미지를 BlobSource 객체로 설명된 이미지로 바꿉니다.
replace(blobSource, crop)Image이 이미지를 Image 객체로 설명된 이미지로 대체합니다. 원하는 경우 자르기도 가능합니다. 조정할 수 있습니다.
replace(imageUrl)Image이 이미지를 제공된 URL에서 다운로드한 다른 이미지로 대체합니다.
replace(imageUrl, crop)Image이 이미지를 제공된 URL에서 다운로드한 다른 이미지로 대체합니다(원하는 경우 자르기). 조정할 수 있습니다.
scaleHeight(ratio)Image지정된 비율로 요소의 높이를 조정합니다.
scaleWidth(ratio)Image지정된 비율로 요소의 너비를 조정합니다.
select()void활성 프레젠테이션에서 PageElement만 선택하고 이전 프레젠테이션은 모두 삭제합니다. 선택합니다.
select(replace)void활성 프레젠테이션에서 PageElement를 선택합니다.
sendBackward()Image페이지에서 페이지 요소를 한 요소씩 뒤로 보냅니다.
sendToBack()Image페이지 요소를 페이지 뒷면으로 보냅니다.
setDescription(description)Image페이지 요소의 대체 텍스트 설명을 설정합니다.
setHeight(height)Image요소의 높이를 포인트로 설정합니다. 포인트는 요소에 회전이 없습니다.
setLeft(left)Image요소의 왼쪽 상단으로부터 측정된 요소의 가로 위치를 포인트 단위로 설정합니다. 페이지에 회전이 없을 때 나타납니다.
setLinkSlide(slideIndex)Link0부터 시작하는 슬라이드 색인을 사용하여 Link를 지정된 Slide로 설정합니다.
setLinkSlide(slide)LinkLink를 지정된 Slide로 설정합니다. 링크는 지정된 슬라이드 ID로 설정됩니다.
setLinkSlide(slidePosition)Link슬라이드의 상대 위치를 사용하여 Link를 지정된 Slide로 설정합니다.
setLinkUrl(url)LinkLink를 비어 있지 않은 지정된 URL 문자열로 설정합니다.
setRotation(angle)Image중심을 중심으로 요소의 시계 방향 회전 각도를 도 단위로 설정합니다.
setTitle(title)Image페이지 요소의 대체 텍스트 제목을 설정합니다.
setTop(top)Image페이지의 왼쪽 상단 모서리에서 측정한 요소의 세로 위치를 포인트 단위로 설정합니다. 요소에 회전이 없을 때
setTransform(transform)Image제공된 변환을 사용하여 페이지 요소의 변환을 설정합니다.
setWidth(width)Image요소의 너비를 포인트로 설정합니다. 포인트는 요소에 회전이 없습니다.

자세한 문서

alignOnPage(alignmentPosition)

요소를 페이지에서 지정된 정렬 위치에 정렬합니다.

매개변수

이름유형설명
alignmentPositionAlignmentPosition페이지에서 이 페이지 요소를 정렬할 위치입니다.

리턴

Image - 체인을 위한 이 페이지 요소입니다.

bringForward()

페이지에서 페이지 요소를 한 요소씩 앞으로 가져옵니다.

페이지 요소는 그룹에 있어서는 안 됩니다.

리턴

Image - 체인을 위한 이 페이지 요소입니다.

승인

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

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

bringToFront()

페이지 요소를 페이지의 맨 앞으로 가져옵니다.

페이지 요소는 그룹에 있어서는 안 됩니다.

리턴

Image - 체인을 위한 이 페이지 요소입니다.

승인

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

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

duplicate()

페이지 요소를 복사합니다.

중복 페이지 요소는 원본과 같은 페이지의 같은 위치에 배치됩니다.

리턴

PageElement - 이 페이지 요소의 새로운 복제본입니다.

승인

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

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

getAs(contentType)

이 객체 내의 데이터를 지정된 콘텐츠 유형으로 변환된 blob으로 반환합니다. 이 메서드는 파일 이름에 적절한 확장자를 추가합니다(예: 'myfile.pdf'). 하지만 파일 이름에서 마지막 마침표 뒤에 오는 부분 (있는 경우)이 기존 교체해야 합니다. 따라서 'ShoppingList.12.25.2014' 위 이름이 아래와 같이 변경됩니다. 'ShoppingList.12.25.pdf'

전환수의 일일 할당량을 보려면 Google '서비스'로 이동합니다. 새로 생성된 Google Workspace 도메인에는 일시적으로 더 엄격한 정책이 적용될 수 있습니다. 할당량도 제공합니다

매개변수

이름유형설명
contentTypeString변환할 MIME 유형입니다. 대부분의 blob에서 'application/pdf'는 다음과 같습니다. 유일하게 유효한 옵션입니다. BMP, GIF, JPEG, PNG 형식의 이미지인 경우 'image/bmp', 'image/gif', 'image/jpeg', 'image/png' 중 어느 것이든 해당됩니다. 유효한지 확인합니다. Google Docs 문서의 경우 'text/markdown'도 유효합니다.

리턴

Blob - blob 형식의 데이터입니다.

getBlob()

이 이미지 내의 데이터를 blob으로 반환합니다.

리턴

Blob - blob인 이미지 데이터입니다.

getBorder()

이미지의 Border를 반환합니다.

리턴

Border - 이미지의 테두리입니다.

승인

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

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

getConnectionSites()

페이지 요소의 ConnectionSite 목록을 반환하거나 페이지가 요소에 연결 사이트가 없습니다.

리턴

ConnectionSite[] - 연결 사이트 목록으로, 이 요소에 연결 사이트가 없는 경우 비어 있을 수 있습니다.

승인

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

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

getContentUrl()

이미지의 URL을 가져옵니다.

이 URL은 요청자의 계정으로 태그가 지정되므로 URL을 효과적으로 알고 있는 사람은 누구나 사용할 수 있습니다. 원래 요청자로 이미지에 액세스합니다. 공유 설정을 변경할 수 있습니다. 반환된 URL은 짧은 기간 후에 만료됩니다.

리턴

String

승인

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

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

getDescription()

페이지 요소의 대체 텍스트 설명을 반환합니다. 설명은 제목과 결합되어 대체 텍스트를 표시하고 읽습니다.

리턴

String - 페이지 요소의 대체 텍스트 설명입니다.

승인

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

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

getHeight()

요소 높이(포인트, 즉 요소에 회전이 없습니다.

이 방법은 일부 페이지 요소와 호환되지 않습니다. 어떤 페이지 요소가 제대로 작동하지 않는지 알아보기 위해 자세한 내용은 크기 및 포지셔닝 제한사항을 참조하세요.

리턴

Number: 페이지 요소의 고유 높이(포인트 단위 또는 페이지 요소가 고유한 높이인 경우 null) 높이는 것이 좋습니다.

승인

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

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

getInherentHeight()

요소의 고유 높이를 반환합니다(포인트).

페이지 요소의 변환은 고유한 크기를 기준으로 합니다. 데이터 레이크에 고유한 크기를 요소의 변환과 함께 사용하여 요소의 최종 시각적 모양을 결정합니다.

리턴

Number: 페이지 요소의 고유 높이(포인트 단위 또는 페이지 요소가 고유한 높이인 경우 null) 높이는 것이 좋습니다.

승인

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

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

getInherentWidth()

요소의 고유 너비를 포인트 단위로 반환합니다.

페이지 요소의 변환은 고유한 크기를 기준으로 합니다. 데이터 레이크에 고유한 크기를 요소의 변환과 함께 사용하여 요소의 최종 시각적 모양을 결정합니다.

리턴

Number: 페이지 요소의 고유한 너비(포인트 또는 페이지 요소가 고유한 너비인 경우 null) 없습니다.

승인

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

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

getLeft()

요소의 왼쪽 상단으로부터 측정된 요소의 가로 위치를 포인트 단위로 반환합니다. 페이지에 회전이 없을 때 나타납니다.

리턴

Number - 페이지 왼쪽 상단 모서리를 기준으로 이 요소의 가로 위치 포인트입니다.

승인

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

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

링크가 없으면 Link 또는 null를 반환합니다. 

var link = shape.getLink();
if (link != null) {
  Logger.log('Shape has a link of type: ' + link.getLinkType());
}

리턴

Link

승인

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

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

getObjectId()

이 객체의 고유 ID를 반환합니다. 페이지 및 페이지 요소에서 사용하는 객체 ID는 네임스페이스가 있습니다

리턴

String - 이 객체의 고유 ID입니다.

승인

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

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

getPageElementType()

PageElementType enum으로 표시된 페이지 요소의 유형을 반환합니다.

리턴

PageElementType - 페이지 요소의 유형입니다.

승인

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

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

getParentGroup()

이 페이지 요소가 속한 그룹을 반환하거나 null 요소가 그룹

리턴

Group: 이 페이지 요소가 속한 그룹 또는 null입니다.

승인

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

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

getParentPage()

이 페이지 요소가 있는 페이지를 반환합니다.

리턴

Page - 이 요소가 있는 페이지입니다.

승인

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

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

getParentPlaceholder()

자리표시자의 상위 페이지 요소를 반환합니다. 이미지가 이미지가 아닌 경우 null를 반환합니다. 자리표시자이거나 상위 요소가 없습니다.

리턴

PageElement - 이 이미지 자리표시자의 상위 페이지 요소 또는 이미지가 아닌 경우 null 선택할 수 있습니다.

승인

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

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

getPlaceholderIndex()

자리표시자 이미지의 색인을 반환합니다. 동일한 페이지에 두 개 이상의 자리표시자 이미지가 있는 경우 유형은 동일하지만 각각 고유한 색인 값이 있습니다. 이미지가 적합하지 않으면 null를 반환합니다. 자리 표시자입니다.

리턴

Integer - 이 이미지의 자리표시자 색인 또는 이미지가 자리표시자가 아닌 경우 null입니다.

승인

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

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

getPlaceholderType()

이미지의 자리표시자 유형을 반환하거나 도형이 아닌 경우 PlaceholderType.NONE를 반환합니다. 자리 표시자입니다.

리턴

PlaceholderType - 이 이미지의 자리표시자 유형입니다.

승인

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

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

getRotation()

중심을 중심으로 한 요소의 시계 방향 회전 각도를 도 단위로 반환합니다. 여기서 0도입니다. 이는 회전이 없음을 의미합니다.

리턴

Number - 0 (0도 이상)에서 360도 (제외) 사이의 회전 각도입니다.

승인

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

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

getSourceUrl()

이미지의 소스 URL을 가져옵니다(있는 경우).

이미지가 URL로 삽입되면 이미지 삽입 중에 제공된 URL을 반환합니다.

리턴

String - 이미지 URL 또는 null(이미지에 소스 URL이 없는 경우)

승인

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

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

getTitle()

페이지 요소의 대체 텍스트 제목을 반환합니다. 제목이 설명과 결합되어 대체 텍스트를 표시하고 읽습니다.

리턴

String - 페이지 요소의 대체 텍스트 제목입니다.

승인

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

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

getTop()

페이지의 왼쪽 상단 모서리에서 측정한 요소의 세로 위치(포인트)를 가져옵니다. 요소에 회전이 없을 때

리턴

Number - 페이지 왼쪽 상단 모서리를 기준으로 이 요소의 세로 위치(포인트)입니다.

승인

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

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

getTransform()

페이지 요소의 변환을 반환합니다.

페이지 요소의 시각적 모양은 절대 변환에 따라 결정됩니다. 받는사람 절대 변환을 계산하고 페이지 요소의 변환을 변환과 사전 연결합니다. 하위 그룹입니다. 페이지 요소가 그룹에 없는 경우 절대 변환은 이 필드의 값과 같아야 합니다.

리턴

AffineTransform - 페이지 요소의 변환입니다.

승인

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

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

getWidth()

요소의 너비를 포인트로 반환합니다. 포인트는 요소의 경계 상자 너비인 요소에 회전이 없습니다.

이 방법은 일부 페이지 요소와 호환되지 않습니다. 어떤 페이지 요소가 제대로 작동하지 않는지 알아보기 위해 자세한 내용은 크기 및 포지셔닝 제한사항을 참조하세요.

리턴

Number: 페이지 요소의 고유한 너비(포인트 또는 페이지 요소가 고유한 너비인 경우 null) 없습니다.

승인

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

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

preconcatenateTransform(transform)

제공된 변환을 페이지 요소의 기존 변환에 미리 연결합니다. 

newTransform = argument * existingTransform

예를 들어 페이지 요소를 왼쪽으로 36포인트 이동하는 방법은 다음과 같습니다. 

element.preconcatenateTransform(SlidesApp.newAffineTransformBuilder()
    .setTranslateX(-36.0)
    .build());

페이지 요소의 변환을 setTransform(transform)로 바꿀 수도 있습니다.

매개변수

이름유형설명
transformAffineTransform이 페이지 요소의 변환에 미리 연결할 변환입니다.

리턴

Image - 체인을 위한 이 페이지 요소입니다.

승인

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

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

remove()

페이지 요소를 삭제합니다.

삭제 작업 후 Group에 페이지 요소가 하나만 있거나 전혀 포함되지 않은 경우 그룹 자체도 삭제됩니다

PageElement 자리표시자가 마스터 또는 레이아웃에서 삭제되면 비어 있는 모든 상속 자리표시자도 삭제됩니다.

승인

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

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

Link를 삭제합니다. 

shape.removeLink();

replace(blobSource)

이 이미지를 BlobSource 객체로 설명된 이미지로 바꿉니다.

이미지를 삽입하면 BlobSource를 한 번 실행하면 사본이 프레젠테이션 내에 표시되도록 저장됩니다. 이미지의 크기는 50MB 미만이어야 하고 25메가픽셀을 초과할 수 없으며 PNG, JPEG, GIF 형식

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

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

매개변수

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

리턴

Image: 대체 후 Image입니다.

승인

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

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

replace(blobSource, crop)

이 이미지를 Image 객체로 설명된 이미지로 대체합니다. 원하는 경우 자르기도 가능합니다. 조정할 수 있습니다.

이미지를 삽입하면 BlobSource를 한 번 실행하면 사본이 프레젠테이션 내에 표시되도록 저장됩니다. 이미지의 크기는 50MB 미만이어야 하고 25메가픽셀을 초과할 수 없으며 PNG, JPEG, GIF 형식 

var image = SlidesApp.getActivePresentation().getSlides()[0].getImages()[0];
// Get the Drive image file with the given ID.
var driveImage = DriveApp.getFileById(fileId);
// Replace and crop the drive image.
image.replace(driveImage, true);

매개변수

이름유형설명
blobSourceBlobSource이미지 데이터입니다.
cropBooleantrue이면 기존 이미지의 크기에 맞게 이미지를 자릅니다. 그렇지 않으면 이미지가 조정되고 중앙에 배치됩니다.

리턴

Image: 대체 후 Image입니다.

승인

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

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

replace(imageUrl)

이 이미지를 제공된 URL에서 다운로드한 다른 이미지로 대체합니다.

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

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

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

매개변수

이름유형설명
imageUrlString이미지를 다운로드할 URL입니다.

리턴

Image: 대체 후 Image입니다.

승인

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

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

replace(imageUrl, crop)

이 이미지를 제공된 URL에서 다운로드한 다른 이미지로 대체합니다(원하는 경우 자르기). 조정할 수 있습니다.

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

제공된 URL은 2KB 이하여야 합니다.

매개변수

이름유형설명
imageUrlString이미지를 다운로드할 URL입니다.
cropBooleantrue이면 기존 이미지의 크기에 맞게 이미지를 자릅니다. 그렇지 않으면 이미지가 조정되고 중앙에 배치됩니다.

리턴

Image: 대체 후 Image입니다.

승인

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

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

scaleHeight(ratio)

지정된 비율로 요소의 높이를 조정합니다. 요소의 높이는 요소의 높이입니다. 경계 상자로 표시됩니다.

이 방법은 일부 페이지 요소와 호환되지 않습니다. 어떤 페이지 요소가 제대로 작동하지 않는지 알아보기 위해 자세한 내용은 크기 및 포지셔닝 제한사항을 참조하세요.

매개변수

이름유형설명
ratioNumber이 페이지 요소의 높이가 조정되는 비율입니다.

리턴

Image - 체인을 위한 이 페이지 요소입니다.

승인

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

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

scaleWidth(ratio)

지정된 비율로 요소의 너비를 조정합니다. 요소의 너비는 요소의 너비입니다. 경계 상자로 표시됩니다.

이 방법은 일부 페이지 요소와 호환되지 않습니다. 어떤 페이지 요소가 제대로 작동하지 않는지 알아보기 위해 자세한 내용은 크기 및 포지셔닝 제한사항을 참조하세요.

매개변수

이름유형설명
ratioNumber이 페이지 요소의 너비를 조정하는 비율입니다.

리턴

Image - 체인을 위한 이 페이지 요소입니다.

승인

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

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

select()

활성 프레젠테이션에서 PageElement만 선택하고 이전 프레젠테이션은 모두 삭제합니다. 선택합니다. 이는 true로 select(replace)를 호출하는 것과 같습니다.

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

이렇게 하면 PageElement의 상위 Page가 current page selection로 설정됩니다. 

var slide = SlidesApp.getActivePresentation().getSlides()[0];
var pageElement = slide.getPageElements()[0];
// Only select this page element and replace any previous selection.
pageElement.select();

승인

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

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

select(replace)

활성 프레젠테이션에서 PageElement를 선택합니다.

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

true를 이 메서드에 전달하여 PageElement만 선택하고 확인할 수 있습니다 이렇게 하면 PageElement의 상위 Page도 current page selection입니다.

여러 PageElement 객체를 선택하려면 false를 전달합니다. PageElement 객체는 동일한 Page에 있어야 합니다.

false를 사용하여 페이지 요소를 선택할 때는 다음 조건을 충족해야 합니다. 매개변수:

  1. PageElement 객체의 상위 Page는 current page selection이어야 합니다.
  2. 여러 Page 객체를 선택해서는 안 됩니다.

이를 위해서는 상위 Page를 선택하는 것이 좋습니다. 먼저 Page.selectAsCurrentPage()를 사용하여 해당 페이지의 페이지 요소를 선택합니다. 

var slide = SlidesApp.getActivePresentation().getSlides()[0];
// First select the slide page, as the current page selection.
slide.selectAsCurrentPage();
// Then select all the page elements in the selected slide page.
var pageElements = slide.getPageElements();
for (var i = 0; i < pageElements.length; i++) {
  pageElements[i].select(false);
}

매개변수

이름유형설명
replaceBooleantrue인 경우 선택이 이전의 모든 선택을 대체합니다. 그렇지 않으면 이전 선택 항목에 추가됩니다.

승인

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

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

sendBackward()

페이지에서 페이지 요소를 한 요소씩 뒤로 보냅니다.

페이지 요소는 그룹에 있어서는 안 됩니다.

리턴

Image - 체인을 위한 이 페이지 요소입니다.

승인

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

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

sendToBack()

페이지 요소를 페이지 뒷면으로 보냅니다.

페이지 요소는 그룹에 있어서는 안 됩니다.

리턴

Image - 체인을 위한 이 페이지 요소입니다.

승인

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

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

setDescription(description)

페이지 요소의 대체 텍스트 설명을 설정합니다.

Group 요소에는 지원되지 않는 메서드입니다. 

// Set the first page element's alt text description to "new alt text description".
var pageElement = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
pageElement.setDescription('new alt text description');
Logger.log(pageElement.getDescription());

매개변수

이름유형설명
descriptionString대체 텍스트 설명을 설정할 문자열입니다.

리턴

Image - 이 페이지 요소입니다.

승인

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

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

setHeight(height)

요소의 높이를 포인트로 설정합니다. 포인트는 요소에 회전이 없습니다.

이 방법은 일부 페이지 요소와 호환되지 않습니다. 어떤 페이지 요소가 제대로 작동하지 않는지 알아보기 위해 자세한 내용은 크기 및 포지셔닝 제한사항을 참조하세요.

매개변수

이름유형설명
heightNumber설정할 페이지 요소의 새로운 높이입니다(포인트 단위).

리턴

Image - 체인을 위한 이 페이지 요소입니다.

승인

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

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

setLeft(left)

요소의 왼쪽 상단으로부터 측정된 요소의 가로 위치를 포인트 단위로 설정합니다. 페이지에 회전이 없을 때 나타납니다.

매개변수

이름유형설명
leftNumber설정할 새 가로 위치(포인트)입니다.

리턴

Image - 체인을 위한 이 페이지 요소입니다.

승인

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

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

setLinkSlide(slideIndex)

0부터 시작하는 슬라이드 색인을 사용하여 Link를 지정된 Slide로 설정합니다. 

// Set a link to the first slide of the presentation.
shape.setLinkSlide(0);

매개변수

이름유형설명
slideIndexInteger0부터 시작하는 슬라이드 색인입니다.

리턴

Link: 설정된 Link

승인

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

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

setLinkSlide(slide)

Link를 지정된 Slide로 설정합니다. 링크는 지정된 슬라이드 ID로 설정됩니다. 

// Set a link to the first slide of the presentation.
var slide = presentation.getSlides()[0];
shape.setLinkSlide(slide);

매개변수

이름유형설명
slideSlide연결할 Slide입니다.

리턴

Link: 설정된 Link

승인

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

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

setLinkSlide(slidePosition)

슬라이드의 상대 위치를 사용하여 Link를 지정된 Slide로 설정합니다. 

// Set a link to the first slide of the presentation.
shape.setLinkSlide(SlideApp.SlidePosition.FIRST_SLIDE);

매개변수

이름유형설명
slidePositionSlidePosition상대 SlidePosition입니다.

리턴

Link: 설정된 Link

승인

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

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

setLinkUrl(url)

Link를 비어 있지 않은 지정된 URL 문자열로 설정합니다. 

// Set a link to the URL.
shape.setLinkUrl("https://slides.google.com");

매개변수

이름유형설명
urlStringURL 문자열입니다.

리턴

Link: 설정된 Link

승인

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

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

setRotation(angle)

중심을 중심으로 요소의 시계 방향 회전 각도를 도 단위로 설정합니다.

이 방법은 일부 페이지 요소와 호환되지 않습니다. 어떤 페이지 요소가 제대로 작동하지 않는지 알아보기 위해 자세한 내용은 크기 및 포지셔닝 제한사항을 참조하세요.

매개변수

이름유형설명
angleNumber설정할 새 시계 방향 회전 각도입니다(단위: 도).

리턴

Image - 체인을 위한 이 페이지 요소입니다.

승인

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

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

setTitle(title)

페이지 요소의 대체 텍스트 제목을 설정합니다.

Group 요소에는 지원되지 않는 메서드입니다. 

// Set the first page element's alt text title to "new alt text title".
var pageElement = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
pageElement.setTitle('new alt text title');
Logger.log(pageElement.getTitle());

매개변수

이름유형설명
titleString대체 텍스트 제목을 설정할 문자열입니다.

리턴

Image - 이 페이지 요소입니다.

승인

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

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

setTop(top)

페이지의 왼쪽 상단 모서리에서 측정한 요소의 세로 위치를 포인트 단위로 설정합니다. 요소에 회전이 없을 때

매개변수

이름유형설명
topNumber설정할 새 세로 위치입니다(단위: 포인트).

리턴

Image - 체인을 위한 이 페이지 요소입니다.

승인

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

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

setTransform(transform)

제공된 변환을 사용하여 페이지 요소의 변환을 설정합니다.

그룹의 변환을 업데이트하면 그룹 내에 있는 페이지 요소의 절대 변환이 해당 그룹의 시각적 모양이 바뀔 수 있습니다.

그룹에 있는 페이지 요소의 변환을 업데이트하면 표시됩니다. 그룹이나 다른 페이지 요소의 변환에는 영향을 주지 않으며 그룹

변환이 페이지 요소의 시각적 모양에 미치는 영향에 대한 자세한 내용은 getTransform()를 참고하세요.

매개변수

이름유형설명
transformAffineTransform이 페이지 요소에 설정된 변환입니다.

리턴

Image - 체이닝을 위한 요소입니다.

승인

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

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

setWidth(width)

요소의 너비를 포인트로 설정합니다. 포인트는 요소에 회전이 없습니다.

이 방법은 일부 페이지 요소와 호환되지 않습니다. 어떤 페이지 요소가 제대로 작동하지 않는지 알아보기 위해 자세한 내용은 크기 및 포지셔닝 제한사항을 참조하세요.

매개변수

이름유형설명
widthNumber설정할 이 페이지 요소의 새 너비입니다(포인트 단위).

리턴

Image - 체인을 위한 이 페이지 요소입니다.

승인

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

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