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입니다. PagePageElement에서 사용하는 객체 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인 경우에만 설정됩니다.

페이지 유형

페이지 유형입니다.

열거형
SLIDE 슬라이드 페이지입니다.
MASTER 마스터 슬라이드 페이지.
LAYOUT 레이아웃 페이지
NOTES 메모 페이지.
NOTES_MASTER 메모 마스터 페이지

페이지 요소

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

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)
  }
  // End of list of possible types for union field element_kind.
}
필드
objectId

string

이 페이지 요소의 객체 ID입니다. google.apps.slides.v1.Pagegoogle.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에서 삽입된 연결된 차트 연결 해제된 차트는 이미지로 표시됩니다.

그룹

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

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

object (PageElement)

그룹의 요소 모음입니다. 그룹의 최소 크기는 2입니다.

WordArt

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

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

string

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

슬라이드 속성

pageType 슬라이드가 있는 페이지에만 관련된 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입니다.

레이아웃 속성

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

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

string

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

name

string

레이아웃의 이름입니다.

displayName

string

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

메모 속성

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

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

string

해당 슬라이드의 발표자 노트가 포함된 이 노트 페이지에 있는 도형의 객체 ID입니다. 메모 페이지에 실제 도형이 항상 존재하는 것은 아닙니다. 이 객체 ID를 사용하여 텍스트를 삽입하면 자동으로 도형이 만들어집니다. 이 경우 실제 도형은 객체 ID가 다를 수 있습니다. presentations.get 또는 pages.get 작업은 항상 최신 객체 ID를 반환합니다.

마스터속성

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

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

string

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

페이지 속성

Page의 속성

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

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

object (PageBackgroundFill)

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

colorScheme

object (ColorScheme)

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

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

페이지 배경 채우기

페이지 배경 채우기

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)

사진을 늘려서 채울 수 있습니다.

늘린 사진

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

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

string

contentUrl 읽기:

기본 수명이 30분인 사진의 URL입니다. 이 URL에는 요청자의 계정으로 태그가 지정됩니다. URL이 있는 사람은 원래 요청자로서 효과적으로 사진에 액세스합니다. 프레젠테이션의 공유 설정이 변경되면 사진에 액세스할 수 없게 됩니다.

contentUrl 작성:

삽입 시 한 번 사진을 가져와서 프레젠테이션에 표시하기 위해 사본을 저장합니다. 사진 크기는 50MB 미만이고 25메가픽셀을 초과할 수 없으며 PNG, JPEG 또는 GIF 형식 중 하나여야 합니다.

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

size

object (Size)

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

색 구성표

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

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

object (ThemeColorPair)

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

테마 색상 쌍

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

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

enum (ThemeColorType)

테마 색상 유형입니다.

color

object (RgbColor)

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

방법

get

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

getThumbnail

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