リクエストで提供されたタイトルを使用して、空のプレゼンテーションを作成します。presentationId
を指定すると、新しいプレゼンテーションの ID として使用されます。それ以外の場合は、新しい ID が生成されます。指定されたコンテンツなど、リクエストの他のフィールドは無視されます。作成されたプレゼンテーションを返します。
HTTP リクエスト
POST https://slides.googleapis.com/v1/presentations
この URL は gRPC Transcoding 構文を使用します。
リクエストの本文
リクエストの本文には、次の構造のデータが含まれます。
JSON 表現 |
---|
{ "presentationId": string, "pageSize": { object ( |
フィールド | |
---|---|
presentationId |
プレゼンテーションの ID。 |
pageSize |
プレゼンテーションのページのサイズ。 |
slides[] |
プレゼンテーションのスライド。スライドは、スライド レイアウトからプロパティを継承します。 |
title |
プレゼンテーションのタイトル。 |
masters[] |
プレゼンテーションでスライドを使いこなす。スライド マスターには、すべての共通のページ要素と、一連のレイアウトに共通するプロパティが含まれます。これらには、次の 3 つの目的があります。
|
layouts[] |
プレゼンテーションのレイアウト。レイアウトとは、そのレイアウトを継承するスライド上で、コンテンツがどのように配置およびスタイル設定されるかを決定するテンプレートです。 |
locale |
プレゼンテーションの言語 / 地域。IETF BCP 47 言語タグで指定します。 |
revisionId |
出力専用。プレゼンテーションのリビジョン ID。最後の読み取りオペレーションからプレゼンテーションのリビジョンが変更されていないことをアサートするために、更新リクエストで使用できます。ユーザーがプレゼンテーションの編集権限を持っている場合にのみ入力されます。 リビジョン ID は連続した数値ではなく、曖昧な文字列です。リビジョン ID の形式は時間の経過とともに変更される可能性があるため、不透明に扱う必要があります。返されたリビジョン ID の有効期間は 24 時間のみ保証され、ユーザー間で共有することはできません。呼び出し間でリビジョン ID が変更されていない場合、プレゼンテーションは変更されていません。逆に、(プレゼンテーションとユーザーが同じであれば)ID が変更された場合は、通常、プレゼンテーションが更新されたことを意味します。ただし、ID の形式の変更などの内部要因が原因で ID が変更される場合もあります。 |
notesMaster |
プレゼンテーションのメモマスター。これには、次の 3 つの目的があります。
メモマスターは読み取り専用です。 |
レスポンスの本文
成功した場合、レスポンスの本文には、新しく作成された Presentation
のインスタンスが含まれます。
認可スコープ
次の OAuth スコープのいずれかが必要です。
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/presentations
詳細については、承認ガイドをご覧ください。