Slides API를 효과적으로 사용하려면 프레젠테이션의 아키텍처 및 구성요소 및 상호작용 영향을 줍니다. 이 페이지에서는 이러한 주제:
- 프레젠테이션 구성요소의 개념 모델
- API가 이러한 구성요소를 나타내는 방법
- 구성요소의 스타일 지정 속성
이 게시물과 다른 개념 개요를 읽으면 안내 가이드, 참조 문서 문서, 레시피 샘플을 참고하세요.
프레젠테이션, 페이지, 페이지 요소
Google Slides에서 가장 바깥쪽에 있는 컨테이너 요소는 프레젠테이션입니다. 이것은 Google Drive에 저장하고 다른 사용자와 공유할 수 있는 단위입니다.
각 프레젠테이션에는 다양한 유형의 페이지가 포함됩니다. 한 가지 페이지 유형은 슬라이드: 사용자가 웹사이트에서 프레젠테이션이 화면에서 렌더링되는 시점을 확인하고 오가며 전환할 수 있습니다.
각 페이지에는 여러 페이지 요소가 포함되어 있으며, 콘텐츠를 표시할 수 있습니다.
슬라이드 외에도 디자인을 적용할 수 있는 다른 페이지 유형이 있습니다. 일관성 있는 모양을 만들 수 있습니다. 이러한 기타 페이지 유형은 마스터와 레이아웃이며, 이들의 속성에 따라 슬라이드가 표시되는 방식이 결정됩니다. 다음과 같이 렌더링됩니다.
마스터 — 마스터 페이지는 두 가지 용도로 사용됩니다. 마스터의 자리표시자 에는 프레젠테이션 전체에서 사용되는 텍스트 스타일의 기본값이 포함됩니다. 이 마스터 슬라이드의 배경 및 기타 도형이 기본 도형을 구성함 해당 마스터를 기반으로 하는 모든 슬라이드의 배경이 됩니다. 제품 목록 광고 아래에 슬라이드에 표시하려면 마스터에 배치합니다.
레이아웃 — 레이아웃 템플릿은 각 유형에 따라 콘텐츠가 정렬되는 방식을 결정합니다. 표시됩니다. 모든 제목 슬라이드를 특정 방식으로 보이게 하려면 예를 들어 제목 레이아웃 템플릿을 수정할 수 있습니다.
페이지에는 메모 페이지와 메모 마스터라는 두 가지 유형이 더 있습니다. 주로 스피커 노트로 작업하는 경우에 적합합니다.
API 표현 유형 및 구조
이 섹션에서는 앞서 설명한 것처럼 Google Slides 개념에 Slides API로 표현됩니다.
다음 다이어그램은 프레젠테이션, 페이지 및 시스템 간의 관계를 Slides API에서 페이지 요소를 유형으로 사용할 수 있습니다.
다음 섹션에서는 이러한 유형이 JSON에서 어떻게 표현되는지 보여줍니다.
프레젠테이션
프레젠테이션에는 수 속성 수, 속성 수 및 그 안에 있는 페이지가 포함되어 있습니다.
{
"presentationId": string,
"pageSize": { object(Size) },
"slides": [ { object(Page) } ],
"title": string,
"masters": [ { object(Page) } ],
"layouts": [ { object(Page) } ],
"notesMaster": object(Page),
"locale": string,
}
Pages
페이지에는 속성을 사용하고, 그 안에 있는 페이지 요소를 포함합니다.
{
"objectId": string,
"pageType": enum(PageType),
"pageElements": [ { object(PageElement) } ],
"pageProperties": { object(PageProperties) },
// Union field properties can be only one of the following:
"slideProperties": { object(SlideProperties) },
"layoutProperties": { object(LayoutProperties) },
"notesProperties": { object(NotesProperties) },
// End of list of possible types for union field properties.
}
페이지 요소
페이지 요소 페이지에 배치되는 시각적 구성요소입니다. API의 페이지 요소 에는 다양한 속성이 포함되어 있으며, 여기에는 페이지 요소의 종류:
{
"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.
}
union 필드에 정의된 것처럼 여러 종류의 페이지 요소가 있습니다.
위 정의에서 element_kind입니다. 이러한 종류의 페이지 요소는
다음 표에 설명되어 있습니다.
| 요소 종류 | 설명 |
|---|---|
| 그룹 | 개별 단위로 취급되는 페이지 요소의 집합입니다. 함께 이동하고, 크기를 조정하고, 회전할 수 있습니다. |
| 도형 | 직사각형, 타원, 텍스트 상자와 같은 일반적인 시각적 객체입니다. 도형은 텍스트를 포함할 수 있으므로 슬라이드를 만드는 데 가장 일반적인 페이지 요소입니다. |
| 이미지 | Slides로 가져온 그래픽 |
| 동영상 | Slides로 가져온 동영상 |
| 선 | 시각적 선, 곡선 또는 연결선입니다. |
| 표 | 콘텐츠 그리드 |
| WordArt | 도형처럼 동작하는 시각적 텍스트 요소입니다. |
| SheetsChart | Google Sheets에서 Slides로 가져온 차트 |
페이지 및 페이지 요소 속성
Slides API를 사용하면 페이지와 페이지의 모양을 읽고 업데이트할 수 있습니다. 만들 수 있습니다. 다양한 페이지 요소 지원 페이지 요소가 렌더링되는 방식을 제어하는 다양한 속성입니다.
각 페이지 요소 종류에는 상응하는 속성 요소와 속성이 있습니다. 예를 들면 다음과 같습니다.
- 페이지 요소 유형인 Shape가 있습니다.
- 속성 필드는 shapeProperties임
- 이러한 속성 업데이트 요청은 UpdateShapePropertiesRequest입니다.
각 페이지 요소에 대해 동일한 요소/속성/업데이트 요청 집합이 존재합니다. 유형: Image/imageProperties/UpdateImageProperties, 등등.
페이지를 읽을 때 속성 속성이 있을 때마다 element; 값을 변경하려면 일치하는 요청 유형과 함께 batchUpdate의 페이로드 메서드를 사용하여 프레젠테이션에서 이러한 값을 변경할 수 있습니다.
속성 종류
여러 종류의 객체에 공통적으로 존재하는 몇 가지 속성은 Slides API에서 확인할 수 있습니다.
| 속성 | 설명 |
|---|---|
| 색상 | Slides API에서 색상은 RGB 값 또는 테마 색상 참조일 수 있습니다. 테마 색상은 이름 (예: 'DARK1')으로 참조되며 페이지의 색 구성표를 사용하여 RGB 값에 매핑할 수 있습니다. 이 색 구성표는 일반적으로 Slides 편집기에서 프레젠테이션의 테마를 변경할 때 업데이트됩니다. |
| 채우기 | 채우기는 객체 내부의 빈 공간 렌더링을 나타냅니다. Slides에서 가장 일반적으로 지원되는 채우기는 객체의 내부가 단색으로 채워지는 단색 채우기입니다. 채우기는 페이지 배경에도 사용할 수 있습니다. |
| 윤곽선 | 윤곽선은 페이지 요소를 둘러싸는 선 집합을 나타냅니다. 선의 색상은 채우기로 제어할 수 있습니다. 호출자는 윤곽선의 너비와 대시 스타일을 조정할 수도 있습니다. |
| 그림자 | 그림자는 물체가 드리우는 물리적 그림자를 모방하기 위한 시각 효과를 나타냅니다. 현재 Slides API에서 그림자는 읽기 전용입니다. |
속성 업데이트
속성을 업데이트하려면 해당하는
요청 Update...Properties개
batchUpdate
호출(예: 도형의 경우 UpdateShapeProperties) 이러한 요청은
전체 속성 메시지를 수락하고
필드 마스크를 사용하여
속성 메시지가 업데이트되어야 합니다.
속성 상속
페이지 또는 페이지 요소는 상위 객체에서 속성을 상속할 수 있습니다. 정의하는 속성과 해당 속성을 포함한 최종 시각적 모양을 결정합니다.
- 페이지 속성 — 페이지는 상속되지 않은 속성을 상속합니다. 기반으로 하지만 그 기반이 되는 레이아웃이나 마스터에 정의되어 있습니다.
- 도형 속성 - 도형을 자리표시자로 표시하여 도형을 페이지의 상위 레이아웃에서 다른 자리표시자 도형을 명시적으로 참조하는 경우 또는 마스터)이 있어야 합니다.
이러한 개념에 대해서는 다음 단락에서 자세히 설명합니다.
페이지 속성 상속
슬라이드, 레이아웃 및 마스터의 구조는 상속 계층을 정의함 프레젠테이션 내: 슬라이드는 레이아웃에서 상속되고 레이아웃은 레이아웃에서 상속됩니다. 있습니다. 슬라이드의 상위 레이아웃 및 마스터는 슬라이드의 slideProperties 필드를 확인합니다.
페이지는 배경과 같은 속성을 상속할 수 있음 및 색 구성표를 가져올 수 있습니다. 속성을 상속하기 위해 하위 페이지는 단순히 해당 속성의 값을 PageProperties 메시지가 표시됩니다. '재정의'하지 않음 값이 같으면 페이지는 상속된 값입니다.
다음 다이어그램은 레이아웃에서 속성을 상속하는 슬라이드를 보여줍니다. 마스터에서 상속됩니다.
슬라이드를 렌더링하는 데 사용되는 속성은 슬라이드에서 정의한 속성과 상속되는 리소스입니다 이 예에서 슬라이드 1을 렌더링하는 데 사용된 결정된 값은 다음과 같습니다.
- 속성 A는 '빨간색'입니다.
- 속성 B는 '주황색'입니다.
도형 속성 상속
도형은 채우기, 윤곽선 또는 그림자와 같은 속성을
있습니다. 도형은 다음의 경우 자리표시자입니다.
Shape.placeholder
필드가 설정됩니다 하위 자리표시자의 Shape.placeholder.parentObjectId 필드
상위 자리표시자를 식별합니다. 기준표를 바탕으로 새 슬라이드를 만들면
새 슬라이드에서 해당 레이아웃의 모든 자리표시자가 하위 도형으로 표시됩니다.
마찬가지로 마스터 페이지의 자리표시자는 레이아웃의 상위 요소 역할을 할 수 있습니다.
자리 표시자.
이 상속 계층 구조를 정의하면 하위 페이지는 해당 값을 ShapeProperties 메시지가 표시됩니다. 상위 요소가 정의한 값을 재정의하지 않으면 하위 도형이 상속된 값을 허용합니다.
다음 다이어그램은 세 가지 유형 간의 속성 상속을 보여줍니다. 슬라이드, 레이아웃, 마스터에 포함된 자리표시자:
자리표시자 도형을 렌더링하는 데 사용되는 속성은 정의하는 것으로 시작합니다 이 예에서 이러한 도형은 다음과 같습니다.
- 자리표시자1: propertyA는 'Yellow'로, propertyB는 'Green'으로 렌더링됩니다.
- 자리표시자 2: propertyA는 'Yellow'로, propertyB는 'Purple'로 렌더링됩니다.
- Placeholder3: propertyA는 'Yellow'로, propertyB는 'Purple'로 렌더링됩니다.
도형은 상위 요소를 가질 수 있는 유일한 페이지 요소 유형입니다. 다른 유형, 이미지, 표, 차트 등은 자리표시자가 될 수 없으며 부모님
"숨기기" PropertyState를 사용하는 속성
PropertyState
열거는 도형의 속성이 실제로 렌더링에 사용되는지 여부를 제어합니다.
또는 값이 하위 도형의 상속에만 사용되는지 확인합니다. 숙박 시설
도형을 렌더링할 때 속성 상태 NOT_RENDERED가 사용되지 않습니다.
페이지의 해당 속성 상태가 RENDERED인 하위 요소
이 속성을 상속할 수 있습니다.
다음 다이어그램은 세 가지 유형 간의 속성 상속을 보여줍니다. PropertyState 필드를 조작하는 자리표시자:
도형 속성의 렌더링은 PropertyState 필드의 영향을 받을 수 있습니다. 이 예에서 이러한 도형에 대해 결정된 값은 다음과 같습니다.
- 자리표시자1: propertyA가 'Red'로 렌더링됩니다.
- 자리표시자 2: propertyA가 렌더링되지 않습니다. 윤곽선 속성인 경우 Placeholder2에는 윤곽선이 없습니다.
- 자리표시자 3: propertyA가 렌더링되지 않습니다.
이 예측값의 가능한 값은
PropertyState
열거형: INHERIT 속성 상태는 속성 상태를 나타냅니다.
자체가 상속되며 상위의 값을 사용해야 합니다. 도형이 없는 도형
상위 요소의 속성 상태는 INHERIT일 수 없습니다.