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

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