REST Resource: presentations.pages

리소스: 페이지

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

JSON 표현 
{
  "objectId": string,
  "pageType": enum (PageType),
  "pageElements": [
    {
      object (PageElement)
    }
  ],
  "revisionId": string,
  "pageProperties": {
    object (PageProperties)
  },
  "commentAnchors": [
    {
      object (CommentAnchor)
    }
  ],
  "comments": [
    {
      object (CommentThread)
    }
  ],
  "commentsViewMode": enum (CommentsViewMode),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "slideProperties": {
    object (SlideProperties)
  },
  "layoutProperties": {
    object (LayoutProperties)
  },
  "notesProperties": {
    object (NotesProperties)
  },
  "masterProperties": {
    object (MasterProperties)
  }
  // End of mutually exclusive fields.
}
필드
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)

페이지의 속성입니다.
commentAnchors[]

object (CommentAnchor)

출력 전용입니다. 페이지에 있는 댓글 앵커입니다.

comments[]

object (CommentThread)

출력 전용입니다. 페이지와 연결된 댓글 대화목록입니다. commentsViewMode이 채워진 GetPageRequest를 통해 페이지를 가져온 경우에만 채워집니다. 그렇지 않으면 GetPresentationRequest를 통해 Presentation에 댓글이 반환됩니다.

commentsViewMode

enum (CommentsViewMode)

출력 전용입니다. 페이지에 적용된 댓글 보기 모드입니다. commentsViewMode이 채워진 GetPageRequest를 통해 페이지를 가져온 경우에만 채워집니다.

각 페이지 유형에 고유한 속성입니다. 마스터에는 추가 속성이 필요하지 않습니다. 다음은 상호 배타적인 필드 목록입니다. 응답에는 다음 필드 중 최대 하나가 설정됩니다.
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,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "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 mutually exclusive fields.
}
필드
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 요소에 지원되지 않습니다.
이 PageElement가 나타내는 요소의 종류입니다. 각 메시지에는 해당 종류의 페이지 요소에 고유한 속성이 포함됩니다. 다음은 상호 배타적인 필드 목록입니다. 응답에는 다음 필드 중 최대 하나가 설정됩니다.
elementGroup

object (Group)

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

object (Shape)

일반적인 모양입니다.
image

object (Image)

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

object (Video)

동영상 페이지 요소입니다.
line

object (Line)

선 페이지 요소입니다.
table

object (Table)

표 페이지 요소입니다.
wordArt

object (WordArt)

Word Art 페이지 요소입니다.
sheetsChart

object (SheetsChart)

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

object (SpeakerSpotlight)

발표자 스포트라이트
상호 배타적 필드의 끝입니다.

그룹

결합된 PageElement 컬렉션을 나타내는 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),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "solidFill": {
    object (SolidFill)
  },
  "stretchedPictureFill": {
    object (StretchedPictureFill)
  }
  // End of mutually exclusive fields.
}
필드
propertyState

enum (PropertyState)

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

페이지의 게재를 업데이트하면 동일한 요청에 다른 값이 지정되지 않는 한 이 필드가 RENDERED로 암시적으로 업데이트됩니다. 페이지에 광고를 게재하지 않으려면 이 필드를 NOT_RENDERED로 설정하세요. 이 경우 동일한 요청에서 설정된 다른 모든 채우기 필드는 무시됩니다.
배경 채우기의 종류입니다. 다음은 상호 배타적인 필드 목록입니다. 응답에는 다음 필드 중 최대 하나가 설정됩니다.
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)

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

CommentAnchor

동일한 anchorId를 통해 CommentThread에 고정된 Page의 모든 위치 목록을 포함합니다. 여러 개의 별도 앵커가 Page 내에서 또는 여러 페이지에 걸쳐 동일한 위치를 참조할 수 있습니다.

JSON 표현 
{
  "anchorId": string,
  "objectAnchors": [
    {
      object (ObjectAnchor)
    }
  ]
}
필드
anchorId

string

출력 전용입니다. 댓글 앵커의 고유 ID입니다.
objectAnchors[]

object (ObjectAnchor)

출력 전용입니다. 앵커 ID를 참조하는 페이지 내의 모든 객체 ID 기반 위치입니다.

ObjectAnchor

Page 또는 PageElement과 같은 Slides 객체에 연결된 댓글 앵커 데이터를 나타냅니다.

JSON 표현 
{
  "objectId": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "shapeTextAnchors": {
    object (ShapeTextAnchors)
  },
  "tableCellAnchors": {
    object (TableCellAnchors)
  }
  // End of mutually exclusive fields.
}
필드
objectId

string

출력 전용입니다. 댓글 대화목록이 고정된 페이지 또는 페이지 요소입니다.
출력 전용입니다. 댓글 대화목록이 고정된 페이지 요소 내의 텍스트 범위입니다. 댓글 앵커가 요소 내 텍스트 범위가 아닌 전체 페이지 또는 페이지 요소인 경우 비어 있습니다. 다음은 상호 배타적인 필드 목록입니다. 응답에는 다음 필드 중 최대 하나가 설정됩니다.
shapeTextAnchors

object (ShapeTextAnchors)

모양의 [text][google.apps.slides.v1.Shape.TextContent]에 텍스트 범위가 고정된 Shapes에 대해 채워집니다.
tableCellAnchors

object (TableCellAnchors)

하나 이상의 표 셀에 있는 텍스트 범위에 고정된 댓글이 있는 Tables에 대해 채워집니다.
상호 배타적 필드의 끝입니다.

ShapeTextAnchors

댓글 앵커로 덮인 도형 내의 텍스트 범위를 나타냅니다.

JSON 표현 
{
  "ranges": [
    {
      object (TextRange)
    }
  ]
}
필드
ranges[]

object (TextRange)

댓글 앵커로 표시된 텍스트 범위 목록입니다.

TextRange

모양 또는 표 셀의 text 내에서 연속된 텍스트 범위를 지정합니다.

JSON 표현 
{
  "startIndex": integer,
  "endIndex": integer
}
필드
startIndex

integer

시작 범위의 0부터 시작하는 색인입니다. 이 필드는 범위가 제한되지 않는 향후 사용 사례를 수용하기 위해 Int32Value입니다.
endIndex

integer

범위의 끝에 있는 0부터 시작하는 색인입니다. 이 필드는 범위가 제한되지 않는 향후 사용 사례를 수용하기 위해 Int32Value입니다.

TableCellAnchors

댓글 앵커로 덮인 표 내의 표 셀 범위를 나타냅니다.

JSON 표현 
{
  "cellRanges": [
    {
      object (TableCellTextRanges)
    }
  ]
}
필드
cellRanges[]

object (TableCellTextRanges)

표에서 앵커로 텍스트가 가려진 표의 모든 표 셀 목록입니다.

TableCellTextRanges

댓글 앵커로 덮인 표 셀 내의 텍스트 범위를 나타냅니다.

JSON 표현 
{
  "cellLocation": {
    object (TableCellLocation)
  },
  "ranges": [
    {
      object (TextRange)
    }
  ]
}
필드
cellLocation

object (TableCellLocation)

표 셀의 위치입니다.
ranges[]

object (TextRange)

이 셀의 앵커로 처리되는 모든 텍스트 범위의 목록입니다.

메서드

get

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

getThumbnail

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