REST Resource: presentations.pages

리소스: 페이지

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

JSON 표현 
{
  "objectId": string,
  "pageType": enum (PageType),
  "pageElements": [
    {
      object (PageElement)
    }
  ],
  "revisionId": string,
  "pageProperties": {
    object (PageProperties)
  },

  // Union field properties can be only one of the following:
  "slideProperties": {
    object (SlideProperties)
  },
  "layoutProperties": {
    object (LayoutProperties)
  },
  "notesProperties": {
    object (NotesProperties)
  },
  "masterProperties": {
    object (MasterProperties)
  }
  // End of list of possible types for union field properties.
}
필드
objectId

string

이 페이지의 객체 ID입니다. Page 및 PageElement에서 사용하는 객체 ID는 동일한 네임스페이스를 공유합니다.
pageType

enum (PageType)

페이지 유형입니다.
pageElements[]

object (PageElement)

페이지에 렌더링된 페이지 요소입니다.
revisionId

string

출력 전용입니다. 프레젠테이션의 버전 ID입니다. 업데이트 요청에서 마지막 읽기 작업 이후 프레젠테이션 버전이 변경되지 않았음을 어설션하는 데 사용할 수 있습니다. 사용자가 프레젠테이션에 대한 수정 액세스 권한이 있는 경우에만 채워집니다.

버전 ID는 순차 번호가 아닌 불투명 문자열입니다. 버전 ID의 형식은 시간이 지남에 따라 변경될 수 있습니다. 반환된 버전 ID는 반환 후 24시간 동안만 유효하며 사용자 간에 공유할 수 없습니다. 호출 간에 버전 ID가 변경되지 않으면 프레젠테이션이 변경되지 않은 것입니다. 반대로 변경된 ID (동일한 프레젠테이션 및 사용자)는 대개 프레젠테이션이 업데이트되었음을 의미합니다. 하지만 ID 형식 변경과 같은 내부 요인으로 인해 ID가 변경될 수도 있습니다.
pageProperties

object (PageProperties)

페이지의 속성입니다.
통합 필드 properties. 각 페이지 유형에 맞는 속성입니다. 마스터에는 추가 속성이 필요하지 않습니다. properties은 다음 중 하나여야 합니다.
slideProperties

object (SlideProperties)

슬라이드별 속성 pageType = SLIDE인 경우에만 설정합니다.
layoutProperties

object (LayoutProperties)

레이아웃별 속성 pageType = LAYOUT인 경우에만 설정됩니다.
notesProperties

object (NotesProperties)

특정 속성에 관한 메모입니다. pageType = NOTES인 경우에만 설정합니다.
masterProperties

object (MasterProperties)

특정 속성 마스터 pageType = MASTER인 경우에만 설정합니다.

PageType

페이지의 유형입니다.

열거형
SLIDE 슬라이드 페이지
MASTER 마스터 슬라이드 페이지
LAYOUT 레이아웃 페이지
NOTES 메모 페이지
NOTES_MASTER 슬라이드 노트 마스터 페이지

PageElement

페이지에 렌더링된 시각적 요소입니다.

JSON 표현 
{
  "objectId": string,
  "size": {
    object (Size)
  },
  "transform": {
    object (AffineTransform)
  },
  "title": string,
  "description": string,

  // Union field element_kind can be only one of the following:
  "elementGroup": {
    object (Group)
  },
  "shape": {
    object (Shape)
  },
  "image": {
    object (Image)
  },
  "video": {
    object (Video)
  },
  "line": {
    object (Line)
  },
  "table": {
    object (Table)
  },
  "wordArt": {
    object (WordArt)
  },
  "sheetsChart": {
    object (SheetsChart)
  },
  "speakerSpotlight": {
    object (SpeakerSpotlight)
  }
  // End of list of possible types for union field element_kind.
}
필드
objectId

string

이 페이지 요소의 개체 ID입니다. google.apps.slides.v1.Page 및 google.apps.slides.v1.PageElement에서 사용하는 객체 ID는 동일한 네임스페이스를 공유합니다.
size

object (Size)

페이지 요소의 크기입니다.
transform

object (AffineTransform)

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

페이지 요소의 시각적 모양은 절대 변환에 따라 결정됩니다. 절대 변환을 계산하려면 페이지 요소의 변환을 모든 상위 그룹의 변환과 사전 연결합니다. 페이지 요소가 그룹에 속하지 않으면 절대 변환은 이 필드의 값과 동일합니다.

새로 생성된 Group의 초기 변환은 항상 ID 변환입니다.
title

string

페이지 요소의 제목입니다. 설명과 결합하여 대체 텍스트를 표시합니다.

이 필드는 Group 요소에 지원되지 않습니다.
description

string

페이지 요소에 대한 설명입니다. 제목과 결합하여 대체 텍스트를 표시합니다.

이 필드는 Group 요소에 지원되지 않습니다.
통합 필드 element_kind. 이 PageElement가 나타내는 요소의 종류입니다. 각 메시지에는 해당 유형의 페이지 요소에만 해당하는 속성이 포함됩니다. element_kind은 다음 중 하나여야 합니다.
elementGroup

object (Group)

단일 단위로 결합된 페이지 요소 모음입니다.
shape

object (Shape)

일반 셰이프.
image

object (Image)

이미지 페이지 요소입니다.
video

object (Video)

동영상 페이지 요소
line

object (Line)

줄 페이지 요소
table

object (Table)

테이블 페이지 요소입니다.
wordArt

object (WordArt)

워드아트 페이지 요소입니다.
sheetsChart

object (SheetsChart)

Google Sheets에서 삽입된 연결된 차트입니다. 연결 해제된 차트는 이미지로 표시됩니다.
speakerSpotlight

object (SpeakerSpotlight)

발표자 스포트라이트

그룹

PageElements의 조인된 컬렉션을 나타내는 PageElement 종류입니다.

JSON 표현 
{
  "children": [
    {
      object (PageElement)
    }
  ]
}
필드
children[]

object (PageElement)

그룹의 요소 컬렉션입니다. 그룹의 최소 크기는 2입니다.

WordArt

워드 아트를 나타내는 PageElement 종류입니다.

JSON 표현 
{
  "renderedText": string
}
필드
renderedText

string

워드 아트로 렌더링된 텍스트입니다.

SpeakerSpotlight

발표자 스포트라이트를 나타내는 PageElement 종류입니다.

JSON 표현 
{
  "speakerSpotlightProperties": {
    object (SpeakerSpotlightProperties)
  }
}
필드
speakerSpotlightProperties

object (SpeakerSpotlightProperties)

발표자 스포트라이트의 속성입니다.

SpeakerSpotlightProperties

SpeakerSpotlight의 속성입니다.

JSON 표현 
{
  "outline": {
    object (Outline)
  },
  "shadow": {
    object (Shadow)
  }
}
필드
outline

object (Outline)

발표자 스포트라이트의 윤곽선 설정하지 않으면 윤곽선이 없습니다.
shadow

object (Shadow)

발표자 스포트라이트의 그림자 설정하지 않으면 그림자가 없습니다.

SlideProperties

pageType SLIDE가 있는 페이지에만 관련된 Page의 속성입니다.

JSON 표현 
{
  "layoutObjectId": string,
  "masterObjectId": string,
  "notesPage": {
    object (Page)
  },
  "isSkipped": boolean
}
필드
layoutObjectId

string

이 슬라이드의 기반이 되는 레이아웃의 객체 ID입니다. 이 속성은 읽기 전용입니다.
masterObjectId

string

이 슬라이드의 기반이 되는 마스터의 객체 ID입니다. 이 속성은 읽기 전용입니다.
notesPage

object (Page)

이 슬라이드와 연결된 메모 페이지입니다. 스피커 메모가 포함된 슬라이드를 인쇄하거나 내보낼 때 메모 페이지의 시각적 모양을 정의합니다. 메모 페이지는 notes master에서 속성을 상속합니다. 노트 페이지에 있는 BODY 유형의 자리표시자 도형에는 이 슬라이드의 발표자 노트가 포함됩니다. 이 도형의 ID는 speakerNotesObjectId 필드로 식별됩니다. 노트 페이지는 발표자 노트 도형의 텍스트 콘텐츠와 스타일을 제외하고 읽기 전용입니다. 이 속성은 읽기 전용입니다.
isSkipped

boolean

프레젠테이션 모드에서 슬라이드를 건너뛸지 여부를 나타냅니다. 기본값은 false입니다.

LayoutProperties

Page의 속성은 pageType이 LAYOUT인 페이지에만 관련이 있습니다.

JSON 표현 
{
  "masterObjectId": string,
  "name": string,
  "displayName": string
}
필드
masterObjectId

string

이 레이아웃의 기반이 되는 마스터의 객체 ID입니다.
name

string

레이아웃의 이름입니다.
displayName

string

사람이 읽을 수 있는 레이아웃 이름입니다.

NotesProperties

pageType NOTES가 있는 페이지에만 관련된 Page의 속성

JSON 표현 
{
  "speakerNotesObjectId": string
}
필드
speakerNotesObjectId

string

해당 슬라이드의 발표자 노트를 포함하는 이 메모 페이지의 도형의 객체 ID입니다. 실제 도형이 메모 페이지에 표시되지 않을 수도 있습니다. 이 객체 ID를 사용하여 텍스트를 삽입하면 도형이 자동으로 생성됩니다. 이 경우 실제 도형에는 다른 객체 ID가 있을 수 있습니다. presentations.get 또는 pages.get 작업은 항상 최신 객체 ID를 반환합니다.

MasterProperties

pageType이 MASTER인 페이지에만 관련된 Page의 속성입니다.

JSON 표현 
{
  "displayName": string
}
필드
displayName

string

사람이 읽을 수 있는 마스터 이름입니다.

PageProperties

Page의 속성입니다.

페이지는 상위 페이지의 속성을 상속합니다. 페이지 유형에 따라 계층 구조는 SlideProperties 또는 LayoutProperties에 정의됩니다.

JSON 표현 
{
  "pageBackgroundFill": {
    object (PageBackgroundFill)
  },
  "colorScheme": {
    object (ColorScheme)
  }
}
필드
pageBackgroundFill

object (PageBackgroundFill)

페이지의 배경 채우기입니다. 설정하지 않으면 배경 채우기는 상위 페이지(있는 경우)에서 상속됩니다. 페이지에 상위 요소가 없으면 배경 채우기는 기본적으로 Slides 편집기의 해당 채우기로 설정됩니다.
colorScheme

object (ColorScheme)

페이지의 색 구성표입니다. 설정하지 않으면 상위 페이지에서 색 구성표가 상속됩니다. 페이지에 상위 요소가 없는 경우 색 구성표는 Slides 편집기의 기본값과 일치하는 기본 Slides 색 구성표를 사용합니다.

처음 12개의 ThemeColorType의 구체적인 색상만 수정할 수 있습니다. 또한 Master 페이지의 색 구성표만 업데이트할 수 있습니다. 이 필드를 업데이트하려면 처음 12개의 ThemeColorTypes와 구체적인 색상의 매핑이 포함된 색 구성표를 제공해야 합니다. 나머지 ThemeColorTypes의 색상은 무시됩니다.

PageBackgroundFill

페이지 배경 채우기

JSON 표현 
{
  "propertyState": enum (PropertyState),

  // Union field kind can be only one of the following:
  "solidFill": {
    object (SolidFill)
  },
  "stretchedPictureFill": {
    object (StretchedPictureFill)
  }
  // End of list of possible types for union field kind.
}
필드
propertyState

enum (PropertyState)

배경 채우기 속성 상태입니다.

페이지의 채우기를 업데이트하면 동일한 요청에 다른 값이 지정되지 않는 한 이 필드가 암시적으로 RENDERED로 업데이트됩니다. 페이지에 채우기가 없도록 하려면 이 필드를 NOT_RENDERED로 설정합니다. 이 경우 동일한 요청에 설정된 다른 모든 필드 필드는 무시됩니다.
통합 필드 kind. 배경 채우기 유형입니다. kind은 다음 중 하나여야 합니다.
solidFill

object (SolidFill)

단색 채우기
stretchedPictureFill

object (StretchedPictureFill)

늘어난 사진 채움

StretchedPictureFill

늘어난 사진 채우기 페이지 또는 페이지 요소가 지정된 사진으로 완전히 채워집니다. 사진이 컨테이너에 맞게 늘어납니다.

JSON 표현 
{
  "contentUrl": string,
  "size": {
    object (Size)
  }
}
필드
contentUrl

string

contentUrl 읽기:

기본 기간이 30분인 사진의 URL입니다. 이 URL에는 요청자의 계정으로 태그가 지정됩니다. URL이 있는 사람은 누구나 원래 요청자로서 사진에 효과적으로 액세스합니다. 프레젠테이션의 공유 설정이 변경되면 사진에 대한 액세스 권한이 상실될 수 있습니다.

contentUrl 작성:

사진은 삽입 시 한 번 가져오고 사본은 프레젠테이션 내부에 표시되도록 저장됩니다. 사진은 크기가 50MB 미만이어야 하며 25메가픽셀을 초과할 수 없으며 PNG, JPEG, GIF 형식 중 하나여야 합니다.

제공된 URL의 길이는 최대 2KB입니다.
size

object (Size)

사진 채우기의 원래 크기입니다. 이 필드는 읽기 전용입니다.

ColorScheme

페이지의 사전 정의된 색상 팔레트입니다.

JSON 표현 
{
  "colors": [
    {
      object (ThemeColorPair)
    }
  ]
}
필드
colors[]

object (ThemeColorPair)

ThemeColorType 및 해당하는 구체적인 색상 쌍입니다.

ThemeColorPair

테마 색상 유형을 이를 나타내는 구체적인 색상으로 매핑하는 쌍입니다.

JSON 표현 
{
  "type": enum (ThemeColorType),
  "color": {
    object (RgbColor)
  }
}
필드
type

enum (ThemeColorType)

테마 색상의 유형입니다.
color

object (RgbColor)

위의 테마 색상 유형에 해당하는 구체적인 색상입니다.

메서드

get

 프레젠테이션에서 지정된 페이지의 최신 버전을 가져옵니다.

getThumbnail

 프레젠테이션에 지정된 페이지의 최신 버전 썸네일을 생성하고 썸네일 이미지에 대한 URL을 반환합니다.