Method: presentations.create

リクエストで指定されたタイトルを使用して、空白のプレゼンテーションを作成します。presentationId が指定されている場合は、新しいプレゼンテーションの ID として使用されます。それ以外の場合は、新しい ID が生成されます。リクエスト内の他のフィールド（指定されたコンテンツを含む）は無視されます。作成されたプレゼンテーションを返します。

HTTP リクエスト

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

この URL は gRPC Transcoding 構文を使用します。

リクエストの本文

リクエストの本文には、次の構造のデータが含まれます。

JSON 表現 
{
  "presentationId": string,
  "pageSize": {
    object (Size)
  },
  "slides": [
    {
      object (Page)
    }
  ],
  "title": string,
  "masters": [
    {
      object (Page)
    }
  ],
  "layouts": [
    {
      object (Page)
    }
  ],
  "locale": string,
  "revisionId": string,
  "notesMaster": {
    object (Page)
  },
  "comments": [
    {
      object (CommentThread)
    }
  ],
  "commentsViewMode": enum (CommentsViewMode)
}
フィールド
presentationId

string

プレゼンテーションの ID。
pageSize

object (Size)

プレゼンテーションのページのサイズ。
slides[]

object (Page)

プレゼンテーションのスライド。スライドはスライド レイアウトからプロパティを継承します。
title

string

プレゼンテーションのタイトル。
masters[]

object (Page)

プレゼンテーションのスライド マスター。スライド マスターには、すべての共通ページ要素と、一連のレイアウトの共通プロパティが含まれています。これらには次の 3 つの目的があります。

  • マスターのプレースホルダ図形には、そのマスターを使用するページのすべてのプレースホルダ図形のデフォルトのテキスト スタイルと図形のプロパティが含まれます。
  • マスター ページのプロパティは、レイアウトによって継承される共通のページ プロパティを定義します。
  • マスター スライド上の他の図形は、レイアウトに関係なく、そのマスターを使用するすべてのスライドに表示されます。
layouts[]

object (Page)

プレゼンテーションのレイアウト。レイアウトは、そのレイアウトを継承するスライドでコンテンツがどのように配置され、スタイル設定されるかを決定するテンプレートです。
locale

string

プレゼンテーションの言語 / 地域（IETF BCP 47 言語タグ）。
revisionId

string

出力専用。プレゼンテーションのリビジョン ID。更新リクエストで使用して、前回の読み取りオペレーション以降にプレゼンテーションのリビジョンが変更されていないことをアサートできます。ユーザーがプレゼンテーションの編集権限を持っている場合にのみ入力されます。

リビジョン ID は連番ではなく、曖昧な文字列です。リビジョン ID の形式は今後変更される可能性があるため、不透明として扱う必要があります。返されたリビジョン ID は、返されてから 24 時間のみ有効であることが保証されており、ユーザー間で共有することはできません。呼び出し間でリビジョン ID が変更されていない場合、プレゼンテーションは変更されていません。逆に、ID が変更された場合（同じプレゼンテーションとユーザーの場合）、通常はプレゼンテーションが更新されたことを意味します。ただし、ID の変更は、ID 形式の変更などの内部要因による場合もあります。
notesMaster

object (Page)

プレゼンテーションのノート マスター。これには次の 3 つの目的があります。

  • ノート マスターのプレースホルダ図形には、notes pages のすべてのプレースホルダ図形のデフォルトのテキスト スタイルと図形のプロパティが含まれます。具体的には、SLIDE_IMAGE プレースホルダの図形にはスライドのサムネイルが含まれ、BODY プレースホルダの図形には発表者のメモが含まれます。
  • ノート マスター ページのプロパティは、すべての notes pages に継承される共通のページ プロパティを定義します。
  • ノート マスターの他の図形は、すべての notes pages に表示されます。

ノート マスターは読み取り専用です。
comments[]

object (CommentThread)

出力専用。プレゼンテーションに関連付けられたコメント スレッド。
commentsViewMode

enum (CommentsViewMode)

出力専用。プレゼンテーションに適用されているコメント表示モード。

レスポンスの本文

成功した場合、レスポンスの本文には、新しく作成された Presentation のインスタンスが含まれます。

認可スコープ

次の OAuth スコープのいずれかが必要です。

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

詳しくは、承認ガイドをご覧ください。