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 = 슬라이드인 경우에만 설정됩니다.
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 슬라이드가 있는 페이지에만 관련된 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

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

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을 반환합니다.