Google Slides API를 사용하여 Google 프레젠테이션을 만들고 수정할 수 있습니다.
앱을 Google Slides API와 통합하여 멋진 슬라이드 자료를 만들 수 있습니다. 자동으로 수집됩니다. 예를 들어 데이터베이스의 고객 세부정보를 사용하고 이를 미리 디자인된 데이터와 결합 완성된 프레젠테이션을 만들기 위한 템플릿 및 선택한 구성 옵션 훨씬 빠르게 만들 수 있습니다.
API 개요
presentations 컬렉션은 메서드를 사용하면 프레젠테이션 내에서 요소를 가져오고 업데이트할 수 있습니다.
대부분의 Slides API 작업은 아마도 Slides API를 사용하여 여러 가지 방법이 있습니다. 이 작업은 batchUpdate 메서드가 포함되어 있습니다. 이 메서드는 요청 객체를 사용하면 다음과 같은 작업을 할 수 있습니다.
- 슬라이드 만들기
- 슬라이드에 도형, 표 등의 요소 추가
- 텍스트 삽입, 변경 및 삭제
- 요소에 변환 적용
- 슬라이드 순서 변경
자세한 내용은 일괄 업데이트를 참고하세요. 시작 가이드 보기 를 참조하세요.
프레젠테이션의 구조
Slides API의 프레젠테이션은 페이지가 포함된 페이지로 구성됩니다. 요소
프레젠테이션의 ID는 URL에서 가져올 수 있습니다.
https://docs.google.com/presentation/d/presentationId/edit
프레젠테이션 ID는 문자, 숫자 및 일부 특수문자를 포함하는 문자열입니다. 있습니다. 다음 정규 표현식을 사용하여 Google Sheets URL의 프레젠테이션 ID:
/presentation/d/([a-zA-Z0-9-_]+)
Drive API에 익숙하다면 presentationId은
파일의 ID입니다.
리소스도 제공합니다
페이지와 페이지 요소는 객체 ID로 식별됩니다.
Pages
Google Slides의 페이지는 다음과 같습니다.
| 석사 | 슬라이드 마스터는 기본 텍스트 스타일, 배경 및 페이지를 정의합니다. 이 마스터를 사용하는 모든 슬라이드에 표시되는 요소입니다. 페이지(Page) 모든 슬라이드에 표시되어야 하는 요소는 마스터에 추가되어야 합니다. 대부분 프레젠테이션에는 한 개의 마스터가 있지만 일부 프레젠테이션은 많거나 없을 수 있습니다. |
| 레이아웃 | 레이아웃은 페이지 요소가 어떤 순서로 정렬될지에 대한 템플릿 역할을 하며, 기본적으로 레이아웃을 사용합니다. 각 레이아웃은 있습니다. |
| Slides | 이 페이지에는 잠재고객에게 제시하는 콘텐츠가 포함되어 있습니다. 대부분의 슬라이드는 마스터와 레이아웃을 기반으로 합니다. 특정 포드가 슬라이드가 만들어질 때 각 슬라이드에 사용할 레이아웃입니다. |
| 참고 | 이 페이지에는 슬라이드의 발표자 노트를 포함하는 도형입니다. 슬라이드마다 확인할 수 있습니다. 발표자 노트 도형에 있는 텍스트만 Slides API로 수정됩니다. |
| 메모 마스터 | 메모 마스터는 모든 메모의 기본 텍스트 스타일과 페이지 요소를 정의합니다. 메모 페이지 슬라이드 노트 마스터는 Slides API에서 읽기 전용입니다. |
페이지 요소
페이지 요소는 페이지에 배치되는 시각적 구성요소입니다. API 다음과 같은 여러 종류의 페이지 요소를 노출합니다.
| 그룹 | 개별 단위로 취급되는 페이지 요소의 집합입니다. 사용자는 할 수 있습니다. 이동, 크기 조정 및 회전할 수 있습니다. |
| 도형 | 직사각형, 타원, 텍스트 상자와 같은 일반적인 시각적 객체입니다. 도형은 텍스트를 포함할 수 있으므로 가장 일반적으로 만들 수 있는 페이지 요소입니다. 있습니다. |
| 이미지 | Slides로 가져온 그래픽 |
| 동영상 | Slides로 가져온 동영상 |
| 선 | 시각적 선, 곡선 또는 연결선입니다. |
| 표 | 콘텐츠 그리드 |
| WordArt | 도형처럼 동작하는 시각적 텍스트 요소입니다. |
| SheetsChart | Google Sheets에서 Slides로 가져온 차트 |
일괄 업데이트
batchUpdate 메서드 를 사용하면 프레젠테이션의 여러 측면을 업데이트할 수 있습니다. 변경사항은 다음에 그룹화됩니다. 한 요청이 실패하면 다른 요청은 종속되지 않도록 (잠재적으로 종속된) 배치 변경사항을 기록합니다
batchUpdate 메서드는 하나 이상의
요청
각 객체는 수행할 단일 종류의 요청을 지정합니다. 현재
다양한 종류의 요청이 있습니다. 아래는 요청 유형, 입찰 요청 유형,
여러 카테고리로 그룹화할 수 있습니다
batchUpdate 메서드는 응답 본문을 반환합니다.
여기에는
응답
확인할 수 있습니다 각 응답은
request; 적용 가능한 응답이 없는 요청의 경우 해당 색인의 응답
은 비어 있습니다. 다양한 Create 요청에는 일반적으로 응답이 있으므로
새로 추가된 객체의 ID를 알고 있다는 의미입니다.
객체 ID 작업
Slides API의 프레젠테이션은 페이지와 페이지 요소로 구성됩니다. 이러한 객체에는 객체 내에서 고유한 객체 ID 문자열이 포함됩니다. 살펴보겠습니다
생성 시 객체 ID 지정
다음을 사용하여 페이지 또는 페이지 요소를 만들 때 batchUpdate 메서드가 포함되어 있으면 는 선택적으로 새 객체에 대한 객체 ID를 지정할 수 있습니다. 이렇게 하면 객체를 업데이트하고 동일한 batchUpdate 요청 내에서 수정하여 할당량 사용을 줄여줍니다.
대부분의 경우 임의의 객체 ID를 생성하는 것이 좋습니다. 예를 들어
Java를 사용하는 경우 java.util.UUID.randomUUID().toString()가 잘 작동합니다.
애플리케이션이 20분의 1에 가까운 기간에 걸쳐 객체를 변경될 수 있으므로 객체 ID에 의존하지 마세요. 다음을 참고하세요. 섹션을 참조하세요.
객체 ID를 사용하지 않고 객체 추적
Slides API 요청을 실행할 때 일반적으로 객체 ID가 보존됩니다. (모두 예외는 메서드의 참조 문서에 설명되어 있습니다.) 이 Drive API를 사용하여 전체 프레젠테이션의 사본도 객체 ID를 보존합니다.
하지만 프리젠테이션 후에 객체 ID가 변경되지 않는다고 해서 Slides UI에서 변경됩니다. 예를 들어 누군가가 페이지 요소를 복사하여 붙여넣은 다음 원본 페이지 요소를 삭제하는 UI 에 새 고유 ID가 부여되고 이전에 API를 통해 제공한 ID가 는 삭제됩니다. 따라서 객체 ID를 스토리지 용량을 늘릴 수도 있습니다 대신, 프레젠테이션에서 객체를 찾으려면 대체 텍스트를 생성합니다.
새로 만든 프레젠테이션에서는 일반적으로 기본 프레젠테이션에 일관된 ID 집합을 사용합니다. 슬라이드, 마스터, 텍스트 상자 같은 여러 개의 레이어가 있습니다 이 ID는 시간이 지남에 따라 변경될 수 있으므로 따라서 이 기능에 의존하지 않는 것이 좋습니다. 대신 에 대한 호출로 반환된 프레젠테이션 객체를 사용하여 수정할 create() 또는 get().