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인 경우에만 설정됩니다.

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.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에서 삽입된 연결된 차트입니다. 연결 해제된 차트는 이미지로 표시됩니다.

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