Method: presentations.create

요청에 제공된 제목을 사용하여 빈 프레젠테이션을 만듭니다. presentationId가 제공되면 새 프레젠테이션의 ID로 사용됩니다. 그렇지 않으면 새 ID가 생성됩니다. 제공된 콘텐츠를 포함하여 요청의 다른 필드는 무시됩니다. 만든 프레젠테이션을 반환합니다.

HTTP 요청

POST https://slides.googleapis.com/v1/presentations

URL은 gRPC 트랜스코딩 구문을 사용합니다.

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현
{
  "presentationId": string,
  "pageSize": {
    object (Size)
  },
  "slides": [
    {
      object (Page)
    }
  ],
  "title": string,
  "masters": [
    {
      object (Page)
    }
  ],
  "layouts": [
    {
      object (Page)
    }
  ],
  "locale": string,
  "revisionId": string,
  "notesMaster": {
    object (Page)
  }
}
입력란
presentationId

string

프레젠테이션의 ID입니다.

pageSize

object (Size)

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

slides[]

object (Page)

프레젠테이션의 슬라이드입니다. 슬라이드는 슬라이드 레이아웃에서 속성을 상속합니다.

title

string

프레젠테이션의 제목입니다.

masters[]

object (Page)

프레젠테이션의 슬라이드 마스터입니다. 슬라이드 마스터에는 레이아웃 집합에 대한 모든 일반 페이지 요소와 공통 속성이 포함되어 있습니다. 다음과 같은 세 가지 용도로 사용됩니다.

  • 마스터의 자리표시자 도형은 해당 마스터를 사용하는 페이지에 있는 모든 자리표시자 도형의 기본 텍스트 스타일 및 도형 속성을 포함합니다.
  • 마스터 페이지 속성은 레이아웃에 상속되는 일반적인 페이지 속성을 정의합니다.
  • 마스터 슬라이드의 다른 모든 도형은 레이아웃에 관계없이 해당 마스터를 사용하는 모든 슬라이드에 표시됩니다.
layouts[]

object (Page)

프레젠테이션의 레이아웃 레이아웃은 해당 레이아웃에서 상속된 슬라이드에서 콘텐츠를 정렬하고 스타일을 지정하는 방식을 결정하는 템플릿입니다.

locale

string

프레젠테이션의 언어로, IETF BCP 47 언어 태그 형식입니다.

revisionId

string

출력 전용입니다. 프레젠테이션의 버전 ID입니다. 마지막 읽기 작업 이후 프레젠테이션 버전이 변경되지 않았음을 어설션하는 업데이트 요청에 사용할 수 있습니다. 사용자가 프레젠테이션에 대한 수정 액세스 권한이 있는 경우에만 채워집니다.

버전 ID는 순차 번호가 아니라 모호한 문자열입니다. 버전 ID의 형식은 시간이 지남에 따라 변경될 수 있으므로 불투명하게 처리해야 합니다. 반환된 버전 ID는 반환된 후 24시간 동안만 유효하며 사용자 간에 공유할 수 없습니다. 통화 간에 버전 ID가 변경되지 않으면 프레젠테이션이 변경되지 않은 것입니다. 반대로, 변경된 ID (동일한 프레젠테이션 및 사용자)는 일반적으로 프레젠테이션이 업데이트되었음을 의미합니다. 그러나 ID 형식 변경과 같은 내부 요인으로 인해 ID가 변경되었을 수도 있습니다.

notesMaster

object (Page)

프레젠테이션의 메모 마스터입니다. 다음과 같은 세 가지 목적이 있습니다.

  • 메모 마스터의 자리표시자 도형에는 notes pages에 있는 모든 자리표시자 도형의 기본 텍스트 스타일 및 도형 속성이 포함되어 있습니다. 특히 SLIDE_IMAGE 자리표시자 도형에는 슬라이드 썸네일이, BODY 자리표시자 도형에는 발표자 노트가 포함됩니다.
  • 메모 마스터 페이지 속성은 모든 notes pages에 상속되는 공통 페이지 속성을 정의합니다.
  • 메모 마스터에 있는 다른 도형은 모든 notes pages에 표시됩니다.

메모 마스터는 읽기 전용입니다.

응답 본문

성공한 경우 응답 본문에 새로 생성된 Presentation의 인스턴스가 포함됩니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/presentations

자세한 내용은 승인 가이드를 참조하세요.