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는 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

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