Class Presentation

指定されたユーザーを Presentation の編集者のリストに追加します。ユーザーがすでに視聴者のリストに登録されている場合、このメソッドはユーザーを視聴者のリストから除外します。

パラメータ

戻る

Presentation - チェーン用の Presentation。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

指定されたユーザーを Presentation の編集者のリストに追加します。ユーザーがすでに視聴者のリストに登録されている場合、このメソッドはユーザーを視聴者のリストから除外します。

パラメータ

戻る

Presentation - チェーン用の Presentation。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

指定されたユーザーの配列を Presentation の編集者のリストに追加します。すでに視聴者のリストに登録されているユーザーは、この方法で視聴者のリストから除外されます。

パラメータ

戻る

Presentation - チェーン用の Presentation。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

指定したユーザーを Presentation の視聴者のリストに追加します。ユーザーがすでに編集者のリストに登録されている場合、このメソッドは効果がありません。

パラメータ

戻る

Presentation - チェーン用の Presentation。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

指定したユーザーを Presentation の視聴者のリストに追加します。ユーザーがすでに編集者のリストに登録されている場合、このメソッドは効果がありません。

パラメータ

戻る

Presentation - チェーン用の Presentation。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

指定されたユーザーの配列を Presentation の視聴者のリストに追加します。いずれかのユーザーがすでに編集者のリストに登録されている場合、この方法は適用されません。

パラメータ

戻る

Presentation - チェーン用の Presentation。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

現在のマスターに基づいて PredefinedLayout.BLANK の事前定義済みレイアウトを使用して、プレゼンテーションの末尾にスライドを追加します。現在のマスターは次のいずれかです。

• 現在の最後のスライドのマスター。
• スライドがない場合、プレゼンテーションの最初のマスター。

戻る

Slide - 追加される新しいスライド。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

現在のマスターに基づいて指定したレイアウトを使用して、プレゼンテーションの末尾にスライドを追加します。現在のマスターは次のいずれかです。

• 現在の最後のスライドのマスター。
• スライドがない場合、プレゼンテーションの最初のマスター。

パラメータ

戻る

Slide - 追加される新しいスライド。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

現在のマスターに基づいて指定された事前定義済みレイアウトを使用して、プレゼンテーションの最後にスライドを追加します。現在のマスターは次のいずれかです。

• 現在の最後のスライドのマスター。
• スライドがない場合、プレゼンテーションの最初のマスター。

パラメータ

戻る

Slide - 追加される新しいスライド。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

指定された Slide のコピーをプレゼンテーションの末尾に追加します。

コピーするスライドが別のプレゼンテーションのものである場合、親マスターページとレイアウト ページが、このプレゼンテーションにまだ存在しない場合はコピーされます。

// Copy a slide from another presentation and appends it.
const otherPresentation = SlidesApp.openById('presentationId');
const currentPresentation = SlidesApp.getActivePresentation();
const slide = otherPresentation.getSlides()[0];
currentPresentation.appendSlide(slide);

パラメータ

戻る

Slide - 追加される新しいスライド。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

指定された Slide のコピーをソース プレゼンテーションから現在のプレゼンテーションの末尾に追加し、SlideLinkingMode で指定されたようにスライドリンクを設定します。

コピーするスライドが別のプレゼンテーションのものである場合、親マスターページとレイアウト ページが現在のプレゼンテーションにまだ存在しない場合は、それらもコピーされます。

リンクモードが SlideLinkingMode.LINKED の場合、Slide.refreshSlide() が呼び出されたときに、追加されたスライドを更新して、指定されたソース スライドと一致させることができます。他の共同編集者には、元のスライドへのリンクが表示されます。SlideLinkingMode.LINKED は、現在のプレゼンテーションのソーススライドでは使用できません。

// Copy a slide from another presentation, then append and link it.
const sourcePresentation = SlidesApp.openById('presentationId');
const currentPresentation = SlidesApp.getActivePresentation();
const slide = sourcePresentation.getSlides()[0];
const appendedSlide = currentPresentation.appendSlide(
    slide,
    SlidesApp.SlideLinkingMode.LINKED,
);

パラメータ

戻る

Slide - 新しいスライド。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

この Presentation の編集者のリストを取得します。

戻る

User[] - 編集権限を持つユーザーの配列。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

プレゼンテーションの一意の識別子を取得します。プレゼンテーション ID は、SlidesApp.openById() とともに使用して、特定のプレゼンテーション インスタンスを開くために使用します。

戻る

String - このプレゼンテーションの ID。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

プレゼンテーションのレイアウトを取得します。

戻る

Layout[] - このプレゼンテーションのレイアウトのリスト。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

プレゼンテーションのマスターを取得します。

戻る

Master[] - このプレゼンテーションのマスターのリスト。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

プレゼンテーションの名前またはタイトルを取得します。

戻る

String - このプレゼンテーションのタイトル。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

プレゼンテーションのノートマスターを取得します。

戻る

NotesMaster - プレゼンテーションのノートマスター。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

プレゼンテーションのメモ マスターとメモページのページの高さをポイント単位で取得します。ページの高さはすべて同じです。

戻る

Number - メモページの高さ（ポイント単位）。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

プレゼンテーションのノートマスターとノートページのページ幅をポイント単位で取得します。ページの幅はすべて同じです。

戻る

Number - メモページの幅（ポイント単位）。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

指定された ID の PageElement を返します。存在しない場合は null を返します。

パラメータ

戻る

PageElement - 指定された ID のページ要素。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

プレゼンテーション内のスライド、レイアウト、マスターのページの高さをポイント単位で取得します。ページの高さはすべて同じです。

戻る

Number - ページの高さ（ポイント単位）。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

プレゼンテーション内のスライド、レイアウト、マスターのページ幅をポイント単位で取得します。ページの幅はすべて同じです。

戻る

Number - ページの幅（ポイント）。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

アクティブなプレゼンテーションでユーザーが選択した内容を取得します。スクリプトは、スクリプトを実行しているユーザーの選択にのみアクセスできます。ただし、スクリプトがプレゼンテーションにバインドされている場合に限られます。

返される選択は、現在有効な選択です。スクリプトがプレゼンテーションにさまざまな変更を加えると、選択内容が変換され、変更が反映されます。たとえば、2 つの図形 A と B が選択され、スクリプトで図形 B が削除された場合、返された選択オブジェクトは暗黙的に更新され、図形 A のみが選択されます。

// Gets the current active page that is selected in the active presentation.
const selection = SlidesApp.getActivePresentation().getSelection();
const currentPage = selection.getCurrentPage();

戻る

Selection - ユーザーの選択を表します。スクリプトがプレゼンテーションにバインドされていない場合や、有効なユーザー選択がない場合は null です。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

指定された ID の Slide を返します。存在しない場合は null を返します。

パラメータ

戻る

Slide - 指定された ID のスライド。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

プレゼンテーション内のスライドを取得します。

戻る

Slide[] - このプレゼンテーションのスライドのリスト。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

このプレゼンテーションにアクセスするための URL を取得します。

const presentation = SlidesApp.getActivePresentation();

// Send out the link to open the presentation.
MailApp.sendEmail(
    '<email-address>',
    presentation.getName(),
    presentation.getUrl(),
);

戻る

String - 現在のプレゼンテーションにアクセスするための URL。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

この Presentation の閲覧者とコメント投稿者のリストを取得します。

戻る

User[] - 表示またはコメントの権限を持つユーザーの配列。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

現在のマスターに基づいて PredefinedLayout.BLANK の事前定義済みレイアウトを使用して、プレゼンテーションの指定したインデックスにスライドを挿入します。現在のマスターは次のいずれかです。

• 前のスライドのマスター。
• 挿入インデックスが 0 の場合、最初のスライドのマスター。
• スライドがない場合、プレゼンテーションの最初のマスター。

パラメータ

戻る

Slide - 挿入された新しいスライド。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

現在のマスターに基づいて指定されたレイアウトを使用して、プレゼンテーションの指定されたインデックスにスライドを挿入します。現在のマスターは次のいずれかです。

• 前のスライドのマスター。
• 挿入インデックスが 0 の場合、最初のスライドのマスター。
• スライドがない場合、プレゼンテーションの最初のマスター。

パラメータ

戻る

Slide - 挿入された新しいスライド。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

現在のマスターに基づいて、指定された事前定義済みレイアウトを使用して、プレゼンテーションの指定されたインデックスにスライドを挿入します。現在のマスターは次のいずれかです。

• 前のスライドのマスター。
• 挿入インデックスが 0 の場合、最初のスライドのマスター。
• スライドがない場合、プレゼンテーションの最初のマスター。

パラメータ

戻る

Slide - 挿入された新しいスライド。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

指定されたインデックスに、指定された Slide のコピーを挿入します。

コピーするスライドが別のプレゼンテーションのものである場合、親マスターページとレイアウト ページが、このプレゼンテーションにまだ存在しない場合はコピーされます。

// Copy a slide from another presentation and inserts it.
const otherPresentation = SlidesApp.openById('presentationId');
const currentPresentation = SlidesApp.getActivePresentation();
const slide = otherPresentation.getSlides()[0];
const insertionIndex = 1;
currentPresentation.insertSlide(insertionIndex, slide);

パラメータ

戻る

Slide - 挿入された新しいスライド。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

指定されたインデックスに、ソース プレゼンテーションから指定された Slide のコピーを挿入し、SlideLinkingMode で指定されたようにスライドリンクを設定します。

コピーするスライドが別のプレゼンテーションのものである場合、親マスターページとレイアウト ページが現在のプレゼンテーションにまだ存在しない場合は、それらもコピーされます。

リンクモードが SlideLinkingMode.LINKED の場合、Slide.refreshSlide() が呼び出されると、挿入されたスライドは、指定されたソーススライドと一致するように更新できます。他の共同編集者には、元のスライドへのリンクが表示されます。SlideLinkingMode.LINKED は、現在のプレゼンテーションのソーススライドでは使用できません。

// Copy a slide from another presentation, then insert and link it.
const sourcePresentation = SlidesApp.openById('presentationId');
const currentPresentation = SlidesApp.getActivePresentation();
const slide = sourcePresentation.getSlides()[0];
const insertionIndex = 1;
const insertedSlide = currentPresentation.insertSlide(
    insertionIndex,
    slide,
    SlidesApp.SlideLinkingMode.LINKED,
);

パラメータ

戻る

Slide - 新しいスライド。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

指定されたユーザーを Presentation の編集者のリストから削除します。この方法では、一般アクセス権を持つユーザー クラスに属するユーザーが Presentation にアクセスできないようにはなりません。たとえば、Presentation がユーザーのドメイン全体と共有されている場合や、Presentation がユーザーがアクセスできる共有ドライブにある場合などです。

ドライブ ファイルの場合、この操作により、ユーザーは閲覧者のリストからも削除されます。

パラメータ

戻る

Presentation - チェーン用の Presentation。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

指定されたユーザーを Presentation の編集者のリストから削除します。この方法では、一般アクセス権を持つユーザー クラスに属するユーザーが Presentation にアクセスできないようにはなりません。たとえば、Presentation がユーザーのドメイン全体と共有されている場合や、Presentation がユーザーがアクセスできる共有ドライブにある場合などです。

ドライブ ファイルの場合、この操作により、ユーザーは閲覧者のリストからも削除されます。

パラメータ

戻る

Presentation - チェーン用の Presentation。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

指定したユーザーを Presentation の閲覧者とコメント投稿者のリストから削除します。ユーザーが視聴者やコメント投稿者ではなく編集者である場合、この方法は効果がありません。また、この方法では、一般アクセス権を持つユーザー クラスに属しているユーザーが Presentation にアクセスできないようにはなりません。たとえば、Presentation がユーザーのドメイン全体と共有されている場合や、Presentation がユーザーがアクセスできる共有ドライブにある場合などです。

ドライブ ファイルの場合、この操作により、ユーザーは編集者のリストからも削除されます。

パラメータ

戻る

Presentation - チェーン用の Presentation。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

指定したユーザーを Presentation の閲覧者とコメント投稿者のリストから削除します。ユーザーが閲覧者ではなく編集者である場合、このメソッドは効果がありません。また、この方法では、一般的なアクセス権を持つユーザー クラスに属しているユーザーが Presentation にアクセスできないようにはなりません。たとえば、Presentation がユーザーのドメイン全体と共有されている場合や、Presentation がユーザーがアクセスできる共有ドライブにある場合などです。

ドライブ ファイルの場合、この操作により、ユーザーは編集者のリストからも削除されます。

パラメータ

戻る

Presentation - チェーン用の Presentation。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

検索テキストに一致するテキストをすべて置換テキストに置き換えます。検索では大文字と小文字が区別されません。

パラメータ

戻る

Integer - 変更された出現回数

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

検索テキストに一致するテキストをすべて置換テキストに置き換えます。

パラメータ

戻る

Integer - 変更された出現回数

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

現在の Presentation を保存します。保留中のアップデートがフラッシュされ、適用されます。

スクリプトの実行がエラーで終了した場合でも、saveAndClose() メソッドは、開いている Presentation ごとにスクリプトの実行の終了時に自動的に呼び出されます。

クローズされた Presentation は編集できません。SlidesApp の open メソッドのいずれかを使用して、特定のプレゼンテーションを再び開いて編集します。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations

プレゼンテーションの名前またはタイトルを設定します。

パラメータ

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

• https://www.googleapis.com/auth/presentations.currentonly
• https://www.googleapis.com/auth/presentations