Class Slide

Slide

プレゼンテーション内のスライド。

これらのページには、視聴者に提示するコンテンツが含まれています。ほとんどのスライドは、マスターとレイアウトに基づいています。スライドの作成時に、各スライドで使用するレイアウトを指定できます。

メソッド

メソッド戻り値の型概要
duplicate()Slideスライドのコピーを作成します。
getBackground()PageBackgroundページの背景を取得します。
getColorScheme()ColorSchemeページに関連付けられている ColorScheme を取得します。
getGroups()Group[]ページ上の Group オブジェクトのリストを返します。
getImages()Image[]ページ上の Image オブジェクトのリストを返します。
getLayout()Layout|nullスライドの基になるレイアウトを取得します。スライドがレイアウトに基づいていない場合は null を返します。
getLines()Line[]ページ上の Line オブジェクトのリストを返します。
getNotesPage()NotesPageスライドに関連付けられたノートページを返します。
getObjectId()Stringページの一意の ID を取得します。
getPageElementById(id)PageElement|null指定された ID のページの PageElement を返します。存在しない場合は null を返します。
getPageElements()PageElement[]ページにレンダリングされた PageElement オブジェクトのリストを返します。
getPageType()PageTypeページの種類を取得します。
getPlaceholder(placeholderType)PageElement|null指定された PlaceholderType または null のプレースホルダ PageElement オブジェクトを返します。一致するプレースホルダがない場合は、プレースホルダ PageElement オブジェクトを返します。
getPlaceholder(placeholderType, placeholderIndex)PageElement|null指定された PlaceholderType とプレースホルダ インデックスのプレースホルダ PageElement オブジェクトを返します。プレースホルダが存在しない場合は null を返します。
getPlaceholders()PageElement[]ページ内のプレースホルダ PageElement オブジェクトのリストを返します。
getShapes()Shape[]ページ上の Shape オブジェクトのリストを返します。
getSheetsCharts()SheetsChart[]ページ上の SheetsChart オブジェクトのリストを返します。
getSlideLinkingMode()SlideLinkingModeスライドが別のスライドにリンクされているかどうかを示す SlideLinkingMode を返します。
getSourcePresentationId()Stringスライドがリンクされていない場合は、ソース Presentation ID または null を返します。
getSourceSlideObjectId()Stringスライドがリンクされていない場合は、ソース スライドの ID または null を返します。
getTables()Table[]ページ上の Table オブジェクトのリストを返します。
getVideos()Video[]ページ上の Video オブジェクトのリストを返します。
getWordArts()WordArt[]ページ上の WordArt オブジェクトのリストを返します。
group(pageElements)Group指定されたすべてのページ要素をグループ化します。
insertGroup(group)Group指定された Group のコピーをページに挿入します。
insertImage(blobSource)Image指定された画像 BLOB からのデフォルト サイズで、ページの左上に画像を挿入します。
insertImage(blobSource, left, top, width, height)Image指定された画像 blob から、指定された位置とサイズでページに画像を挿入します。
insertImage(image)Image指定された Image のコピーをページに挿入します。
insertImage(imageUrl)Image指定された URL から、デフォルトのサイズの画像をページの左上に挿入します。
insertImage(imageUrl, left, top, width, height)Image指定された URL から、指定された位置とサイズでページに画像を挿入します。
insertLine(line)Line指定された Line のコピーをページに挿入します。
insertLine(lineCategory, startConnectionSite, endConnectionSite)Line2 つの connection sites を結ぶ線をページに挿入します。
insertLine(lineCategory, startLeft, startTop, endLeft, endTop)Lineページに線を挿入します。
insertPageElement(pageElement)PageElement指定された PageElement のコピーをページに挿入します。
insertShape(shape)Shape指定された Shape のコピーをページに挿入します。
insertShape(shapeType)Shapeページに図形を挿入します。
insertShape(shapeType, left, top, width, height)Shapeページに図形を挿入します。
insertSheetsChart(sourceChart)SheetsChartGoogle スプレッドシートのグラフをページに挿入します。
insertSheetsChart(sourceChart, left, top, width, height)SheetsChart指定された位置とサイズで、Google スプレッドシートのグラフをページに挿入します。
insertSheetsChart(sheetsChart)SheetsChart指定された SheetsChart のコピーをページに挿入します。
insertSheetsChartAsImage(sourceChart)ImageGoogle スプレッドシートのグラフをページの Image として挿入します。
insertSheetsChartAsImage(sourceChart, left, top, width, height)Image指定された位置とサイズで、Google スプレッドシートのグラフをページの Image として挿入します。
insertTable(numRows, numColumns)Tableページに表を挿入します。
insertTable(numRows, numColumns, left, top, width, height)Table指定された位置とサイズでページに表を挿入します。
insertTable(table)Table指定された Table のコピーをページに挿入します。
insertTextBox(text)Shape指定された文字列を含むテキスト ボックス Shape をページに挿入します。
insertTextBox(text, left, top, width, height)Shape指定された文字列を含むテキスト ボックス Shape をページに挿入します。
insertVideo(videoUrl)Videoデフォルトのサイズで、ページの左上隅に動画を挿入します。
insertVideo(videoUrl, left, top, width, height)Video指定された位置とサイズでページに動画を挿入します。
insertVideo(video)Video指定された Video のコピーをページに挿入します。
insertWordArt(wordArt)WordArt指定された WordArt のコピーをページに挿入します。
isSkipped()Booleanプレゼンテーション モードでスライドがスキップされるかどうかを返します。
move(index)voidスライドを指定されたインデックスに移動します。
refreshSlide()voidリンクされた元のスライドに加えられた変更を反映するようにスライドを更新します。
remove()voidページを削除します。
replaceAllText(findText, replaceText)Integer検索テキストに一致するテキストのすべてのインスタンスを置換テキストに置き換えます。
replaceAllText(findText, replaceText, matchCase)Integer検索テキストに一致するテキストのすべてのインスタンスを置換テキストに置き換えます。
selectAsCurrentPage()voidアクティブなプレゼンテーションで Page を current page selection として選択し、以前の選択を削除します。
setSkipped(isSkipped)voidプレゼンテーション モードでスライドをスキップするかどうかを設定します。
unlink()void現在の Slide と元のスライドのリンクを解除します。

詳細なドキュメント

duplicate()

スライドを複製します。

複製されたスライドは、元のスライドの直後に作成されます。

戻る

Slide - 複製されたスライド。

承認

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

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

getBackground()

ページの背景を取得します。

戻る

PageBackground - ページの背景。

承認

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

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

getColorScheme()

ページに関連付けられている ColorScheme を取得します。

戻る

ColorScheme - ページのカラーパターン。

承認

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

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

getGroups()

ページ上の Group オブジェクトのリストを返します。

戻る

Group[]

承認

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

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

getImages()

ページ上の Image オブジェクトのリストを返します。

戻る

Image[]

承認

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

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

getLayout()

スライドの基になるレイアウトを取得します。スライドがレイアウトに基づいていない場合は null を返します。

戻る

Layout|null

承認

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

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

getLines()

ページ上の Line オブジェクトのリストを返します。

戻る

Line[]

承認

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

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

getNotesPage()

スライドに関連付けられたノートページを返します。

戻る

NotesPage

承認

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

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

getObjectId()

ページの一意の ID を取得します。ページとページ要素で使用されるオブジェクト ID は、同じ名前空間を共有します。

戻る

String

承認

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

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

getPageElementById(id)

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

パラメータ

名前型説明
idString取得するページ要素の ID。

戻る

PageElement|null - 指定された ID を持つページ要素。

承認

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

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

getPageElements()

ページにレンダリングされた PageElement オブジェクトのリストを返します。

戻る

PageElement[]

承認

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

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

getPageType()

ページの種類を取得します。

戻る

PageType - ページの種類。

承認

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

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

getPlaceholder(placeholderType)

一致するプレースホルダがない場合は、指定された PlaceholderType または null のプレースホルダ PageElement オブジェクトを返します。

同じ型のプレースホルダが複数ある場合は、プレースホルダ インデックスが最小のものが返されます。同じインデックスを持つ一致するプレースホルダが複数ある場合は、ページのページ要素コレクションから最初のプレースホルダを返します。

const slide = SlidesApp.getActivePresentation().getSlides()[0];
const placeholder = slide.getPlaceholder(
    SlidesApp.PlaceholderType.CENTERED_TITLE,
);

パラメータ

名前型説明
placeholderTypePlaceholderType

戻る

PageElement|null

承認

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

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

getPlaceholder(placeholderType, placeholderIndex)

指定された PlaceholderType とプレースホルダ インデックスのプレースホルダ PageElement オブジェクトを返します。プレースホルダが存在しない場合は null を返します。

同じタイプとインデックスのプレースホルダが複数ある場合は、ページのページ要素コレクションから最初のプレースホルダを返します。

const slide = SlidesApp.getActivePresentation().getSlides()[0];
const placeholder = slide.getPlaceholder(
    SlidesApp.PlaceholderType.CENTERED_TITLE,
    0,
);

パラメータ

名前型説明
placeholderTypePlaceholderType
placeholderIndexInteger

戻る

PageElement|null

承認

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

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

getPlaceholders()

ページ内のプレースホルダ PageElement オブジェクトのリストを返します。

const master = SlidesApp.getActivePresentation().getMasters()[0];
Logger.log(
    `Number of placeholders in the master: ${master.getPlaceholders().length}`,
);

戻る

PageElement[]

承認

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

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

getShapes()

ページ上の Shape オブジェクトのリストを返します。

戻る

Shape[]

承認

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

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

getSheetsCharts()

ページ上の SheetsChart オブジェクトのリストを返します。

戻る

SheetsChart[]

承認

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

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

getSlideLinkingMode()

スライドが別のスライドにリンクされているかどうかを示す SlideLinkingMode を返します。

戻る

SlideLinkingMode - スライドのリンクモード。

承認

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

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

getSourcePresentationId()

スライドがリンクされていない場合は、ソース Presentation ID または null を返します。

スライドにソース Presentation ID があるのは、別のプレゼンテーション内のスライドにリンクされている場合のみです。

戻る

String - ソース プレゼンテーション ID または null。

承認

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

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

getSourceSlideObjectId()

スライドがリンクされていない場合は、ソース スライドの ID または null を返します。

スライドにソース スライド ID があるのは、別のプレゼンテーション内のスライドにリンクされている場合のみです。

戻る

String - ソース スライド ID または null。

承認

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

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

getTables()

ページ上の Table オブジェクトのリストを返します。

戻る

Table[]

承認

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

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

getVideos()

ページ上の Video オブジェクトのリストを返します。

戻る

Video[]

承認

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

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

getWordArts()

ページ上の WordArt オブジェクトのリストを返します。

戻る

WordArt[]

承認

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

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

group(pageElements)

指定されたすべてのページ要素をグループ化します。

同じページに、別のグループにまだ含まれていないページ要素が 2 つ以上ある必要があります。Videos、Tables、placeholder Shapes などの一部のページ要素はグループ化できません。

パラメータ

名前型説明
pageElementsPageElement[]グループ化する要素。

戻る

Group - 新しいグループ。

承認

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

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

insertGroup(group)

指定された Group のコピーをページに挿入します。

このページに挿入された要素の位置は、それぞれのページでのソース要素の位置から決定されます。

指定された要素が現在のプレゼンテーション内でコピーされるプレースホルダである場合、マスターページまたはレイアウト ページから継承されたプロパティは、挿入された要素にも継承されます。

指定された要素が別のプレゼンテーションからコピーされたプレースホルダである場合、マスターページまたはレイアウト ページから継承されたプロパティが、コピー元のプレゼンテーションから要素にコピーされます。

// Copy a group between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const group = otherPresentationSlide.getGroups()[0];
currentPresentationSlide.insertGroup(
    group);  // Also available for Layout, Master, and Page.

パラメータ

名前型説明
groupGroupコピーして挿入するグループ。

戻る

Group - 挿入されたグループ。

承認

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

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

insertImage(blobSource)

指定された画像 BLOB からのデフォルト サイズで、ページの左上隅に画像を挿入します。

画像を挿入すると、BlobSource から画像が 1 回取得され、プレゼンテーション内に表示するためのコピーが保存されます。画像のサイズは 50 MB 未満、2,500 万ピクセル以下で、PNG、JPEG、GIF のいずれかの形式である必要があります。

const slide = SlidesApp.getActivePresentation().getSlides()[0];
// Get the Drive image file with the given ID.
const image = DriveApp.getFileById('123abc');
slide.insertImage(image);

パラメータ

名前型説明
blobSourceBlobSource画像データ。

戻る

Image - 挿入された画像。

承認

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

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

insertImage(blobSource, left, top, width, height)

指定された画像 blob から、指定された位置とサイズでページに画像を挿入します。

画像は、挿入時に指定された BlobSource から一度だけ取得され、プレゼンテーション内に表示するためにコピーが保存されます。画像のサイズは 50 MB 未満、2,500 万ピクセル以下で、PNG、JPEG、GIF のいずれかの形式である必要があります。

画像のアスペクト比を維持するため、画像は指定されたサイズに合わせて拡大縮小され、中央に配置されます。

const slide = SlidesApp.getActivePresentation().getSlides()[0];
// Get the Drive image file with the given ID.
const image = DriveApp.getFileById('123abc');
const position = {
  left: 0,
  top: 0
};
const size = {
  width: 300,
  height: 100
};
slide.insertImage(image, position.left, position.top, size.width, size.height);

パラメータ

名前型説明
blobSourceBlobSource画像データ。
leftNumberページの左上隅から測定した、画像の水平位置（ポイント単位）。
topNumberページの左上隅から測定した、画像の垂直方向の位置（ポイント単位）。
widthNumber画像の幅（ポイント単位）。
heightNumber画像の高さ（ポイント単位）。

戻る

Image - 挿入された画像。

承認

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

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

insertImage(image)

指定された Image のコピーをページに挿入します。

このページに挿入された画像の配置は、それぞれのページでのソース画像の配置によって決まります。

指定された画像が現在のプレゼンテーション内からコピーされたプレースホルダである場合、マスターページまたはレイアウト ページから継承されたプロパティも、挿入された画像に継承されます。

提供された画像が別のプレゼンテーションからコピーされたプレースホルダである場合、マスターページまたはレイアウト ページから継承されたプロパティが、ソース プレゼンテーションから画像にコピーされます。コピーしたプレースホルダ画像が空の場合、コピー先のプレゼンテーションには何も挿入されません。

// Copy an image between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const image = otherPresentationSlide.getImages[0];
currentPresentationSlide.insertImage(image);

パラメータ

名前型説明
imageImageコピーして挿入する画像。

戻る

Image - 挿入された画像。

承認

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

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

insertImage(imageUrl)

指定された URL から、デフォルトのサイズの画像をページの左上に挿入します。

画像を挿入すると、URL から画像が 1 回取得され、プレゼンテーション内で表示するためにコピーが保存されます。画像は 50 MB 未満で、25 メガピクセルを超えてはなりません。また、PNG、JPEG、GIF のいずれかの形式である必要があります。

指定された URL は一般公開されており、2 KB 以下である必要があります。URL 自体は画像とともに保存され、Image.getSourceUrl() を介して公開されます。

パラメータ

名前型説明
imageUrlString画像 URL。

戻る

Image - 挿入された画像。

承認

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

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

insertImage(imageUrl, left, top, width, height)

指定された URL から、指定された位置とサイズでページに画像を挿入します。

画像を挿入すると、URL から画像が 1 回取得され、プレゼンテーション内で表示するためにコピーが保存されます。画像は 50 MB 未満で、25 メガピクセルを超えてはなりません。また、PNG、JPEG、GIF のいずれかの形式である必要があります。

指定された URL は一般公開されており、2 KB 以下である必要があります。URL 自体は画像とともに保存され、Image.getSourceUrl() を介して公開されます。

画像のアスペクト比を維持するため、画像は指定されたサイズに合わせて拡大縮小され、中央に配置されます。

パラメータ

名前型説明
imageUrlString画像 URL。
leftNumberページの左上隅から測定した、画像の水平位置（ポイント単位）。
topNumberページの左上隅から測定した、画像の垂直方向の位置（ポイント単位）。
widthNumber画像の幅（ポイント単位）。
heightNumber画像の高さ（ポイント単位）。

戻る

Image - 挿入された画像。

承認

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

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

insertLine(line)

指定された Line のコピーをページに挿入します。

このページに挿入された要素の位置は、それぞれのページでのソース要素の位置から決定されます。

指定された要素が現在のプレゼンテーション内でコピーされるプレースホルダである場合、マスターページまたはレイアウト ページから継承されたプロパティは、挿入された要素にも継承されます。

指定された要素が別のプレゼンテーションからコピーされたプレースホルダである場合、マスターページまたはレイアウト ページから継承されたプロパティが、コピー元のプレゼンテーションから要素にコピーされます。

// Copy a line between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const line = otherPresentationSlide.getLines[0];
currentPresentationSlide.insertLine(line);

パラメータ

名前型説明
lineLineコピーして挿入する行。

戻る

Line - 挿入された行。

承認

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

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

insertLine(lineCategory, startConnectionSite, endConnectionSite)

2 つの connection sites を結ぶ線をページに挿入します。このページには、2 つの接続サイトが表示されます。

// Insert a line in the first slide of the presentation connecting two shapes.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
const shape1 = slide.insertShape(SlidesApp.ShapeType.RECTANGLE);
const shape2 = slide.insertShape(SlidesApp.ShapeType.CLOUD);
slide.insertLine(
    SlidesApp.LineCategory.BENT,
    shape1.getConnectionSites()[0],
    shape2.getConnectionSites()[1],
);

パラメータ

名前型説明
lineCategoryLineCategory挿入する行のカテゴリ。
startConnectionSiteConnectionSite線の始点を接続する接続サイト。
endConnectionSiteConnectionSite線の端を接続する接続サイト。

戻る

Line - 挿入された行。

承認

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

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

insertLine(lineCategory, startLeft, startTop, endLeft, endTop)

ページに線を挿入します。

// Insert a line in the first slide of the presentation.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
const startPoint = {
  left: 10,
  top: 10
};
const endPoint = {
  left: 40,
  top: 40
};
slide.insertLine(
    SlidesApp.LineCategory.STRAIGHT,
    startPoint.left,
    startPoint.top,
    endPoint.left,
    endPoint.top,
);

パラメータ

名前型説明
lineCategoryLineCategory挿入する行のカテゴリ。
startLeftNumberページの左上隅からのポイント単位で測定された、線の開始点の水平位置。
startTopNumberページの左上隅からのポイント単位で測定された、線の開始点の垂直方向の位置。
endLeftNumberページの左上隅からのポイント単位で測定された、線の終点の水平位置。
endTopNumberページの左上隅からのポイント単位で測定された、線の終点の垂直位置。

戻る

Line - 挿入された行。

承認

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

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

insertPageElement(pageElement)

指定された PageElement のコピーをページに挿入します。

このページに挿入された要素の位置は、それぞれのページでのソース要素の位置から決定されます。

指定された要素が現在のプレゼンテーション内でコピーされるプレースホルダである場合、マスターページまたはレイアウト ページから継承されたプロパティは、挿入された要素にも継承されます。

指定された要素が別のプレゼンテーションからコピーされたプレースホルダである場合、マスターページまたはレイアウト ページから継承されたプロパティが、コピー元のプレゼンテーションから要素にコピーされます。

// Copy a page element between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const pageElement = otherPresentationSlide.getPageElements()[0];

// Also available for Layout, Master, and Page.
currentPresentationSlide.insertPageElement(pageElement);

パラメータ

名前型説明
pageElementPageElementコピーして挿入するページ要素。

戻る

PageElement - 挿入されたページ要素。

承認

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

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

insertShape(shape)

指定された Shape のコピーをページに挿入します。

このページに挿入された要素の位置は、それぞれのページでのソース要素の位置から決定されます。

指定された要素が現在のプレゼンテーション内でコピーされるプレースホルダである場合、マスターページまたはレイアウト ページから継承されたプロパティは、挿入された要素にも継承されます。

指定された要素が別のプレゼンテーションからコピーされたプレースホルダである場合、マスターページまたはレイアウト ページから継承されたプロパティが、コピー元のプレゼンテーションから要素にコピーされます。

// Copy a shape between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const shape = otherPresentationSlide.getShapes[0];
currentPresentationSlide.insertShape(
    shape);  // Also available for Layout, Master, and Page.

パラメータ

名前型説明
shapeShapeコピーして挿入する図形。

戻る

Shape - 挿入された図形。

承認

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

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

insertShape(shapeType)

ページに図形を挿入します。

図形は、デフォルトのサイズでページの左上隅に挿入されます。

// Insert a shape in the first slide of the presentation.
const slide = SlidesApp.getActivePresentation().getSlides()[0];

// Also available for Layout, Master, and Page.
slide.insertShape(SlidesApp.ShapeType.RECTANGLE);

パラメータ

名前型説明
shapeTypeShapeType挿入する図形のタイプ。

戻る

Shape - 挿入された図形。

承認

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

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

insertShape(shapeType, left, top, width, height)

ページに図形を挿入します。

パラメータ

名前型説明
shapeTypeShapeType挿入する図形のタイプ。
leftNumberページの左上隅を基準とする、シェイプの水平位置。
topNumberページの左上隅を基準とした、シェイプの垂直方向の位置。
widthNumberシェイプの幅。
heightNumberシェイプの高さ。

戻る

Shape - 挿入された図形。

承認

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

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

insertSheetsChart(sourceChart)

ページに Google スプレッドシートのグラフを挿入します。

グラフは、デフォルトのサイズでページの左上隅に挿入されます。

挿入したグラフは、更新可能なソースの Google スプレッドシートのグラフにリンクされています。他の共同編集者には、元のスプレッドシートへのリンクが表示されます。

const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
const chart = sheet.getCharts()[0];
// Insert the spreadsheet chart in the first slide.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.insertSheetsChart(chart);

パラメータ

名前型説明
sourceChartEmbeddedChartページに挿入するスプレッドシートのグラフ。

戻る

SheetsChart - ページに挿入されたグラフ。

承認

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

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

insertSheetsChart(sourceChart, left, top, width, height)

指定された位置とサイズで、Google スプレッドシートのグラフをページに挿入します。

グラフのアスペクト比を維持するため、グラフは指定されたサイズに合わせて拡大縮小され、中央に配置されます。

挿入したグラフは、更新可能なソースの Google スプレッドシートのグラフにリンクされています。他の共同編集者には、元のスプレッドシートへのリンクが表示されます。

const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
const chart = sheet.getCharts()[0];
// Insert the spreadsheet chart in the first slide.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
const position = {
  left: 0,
  top: 0
};
const size = {
  width: 200,
  height: 200
};

// Also available for Layout, Master, and Page.
slide.insertSheetsChart(
    chart,
    position.left,
    position.top,
    size.width,
    size.height,
);

パラメータ

名前型説明
sourceChartEmbeddedChartページに挿入するスプレッドシートのグラフ。
leftNumberページの左上隅から測定した、グラフの水平位置（ポイント単位）。
topNumberページの左上隅から測定した、グラフの垂直位置（ポイント単位）。
widthNumberグラフの幅（ポイント単位）。
heightNumberグラフの高さ（ポイント単位）。

戻る

SheetsChart - ページに挿入されたグラフ。

承認

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

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

insertSheetsChart(sheetsChart)

指定された SheetsChart のコピーをページに挿入します。

このページに挿入された要素の位置は、それぞれのページでのソース要素の位置から決定されます。

指定された要素が現在のプレゼンテーション内でコピーされるプレースホルダである場合、マスターページまたはレイアウト ページから継承されたプロパティは、挿入された要素にも継承されます。

指定された要素が別のプレゼンテーションからコピーされたプレースホルダである場合、マスターページまたはレイアウト ページから継承されたプロパティが、コピー元のプレゼンテーションから要素にコピーされます。

// Copy a sheets chart between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const sheetsChart = otherPresentationSlide.getSheetsCharts[0];

// Also available for Layout, Master, and Page.
currentPresentationSlide.insertSheetsChart(sheetsChart);

パラメータ

名前型説明
sheetsChartSheetsChartコピーして挿入するシートのグラフ。

戻る

SheetsChart - 挿入されたシートのグラフ。

承認

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

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

insertSheetsChartAsImage(sourceChart)

Google スプレッドシートのグラフをページの Image として挿入します。

グラフの画像が、デフォルトのサイズでページの左上隅に挿入されます。

挿入したグラフの画像は、元の Google スプレッドシートのグラフにリンクされていません。

const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
const chart = sheet.getCharts()[0];
// Insert the spreadsheet chart in the first slide.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.insertSheetsChartAsImage(
    chart);  // Also available for Layout, Master, and Page.

パラメータ

名前型説明
sourceChartEmbeddedChartページに挿入するスプレッドシートのグラフ。

戻る

Image - ページに挿入されたグラフの画像。

承認

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

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

insertSheetsChartAsImage(sourceChart, left, top, width, height)

指定された位置とサイズで、Google スプレッドシートのグラフをページの Image として挿入します。

グラフ画像のアスペクト比を維持するため、画像は指定されたサイズに合わせて拡大縮小され、中央に配置されます。

挿入したグラフの画像は、元の Google スプレッドシートのグラフにリンクされていません。

const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
const chart = sheet.getCharts()[0];
// Insert the spreadsheet chart in the first slide.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
const position = {
  left: 0,
  top: 0
};
const size = {
  width: 200,
  height: 200
};

// Also available for Layout, Master, and Page.
slide.insertSheetsChartAsImage(
    chart,
    position.left,
    position.right,
    size.width,
    size.height,
);

パラメータ

名前型説明
sourceChartEmbeddedChartページに挿入するスプレッドシートのグラフ。
leftNumberページの左上隅から測定した、グラフの水平位置（ポイント単位）。
topNumberページの左上隅から測定した、グラフの垂直位置（ポイント単位）。
widthNumberグラフの幅（ポイント単位）。
heightNumberグラフの高さ（ポイント単位）。

戻る

Image - ページに挿入されたグラフの画像。

承認

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

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

insertTable(numRows, numColumns)

ページに表を挿入します。

テーブルは、デフォルトのサイズでページの中央に配置され、行と列が均等に配置されます。

パラメータ

名前型説明
numRowsIntegerテーブル内の行数。
numColumnsIntegerテーブル内の列数。

戻る

Table - 挿入されたテーブル。

承認

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

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

insertTable(numRows, numColumns, left, top, width, height)

指定された位置とサイズでページにテーブルを挿入します。

作成した表の行と列が均等に配置されます。

パラメータ

名前型説明
numRowsIntegerテーブル内の行数。
numColumnsIntegerテーブル内の列数。
leftNumberページの左上隅から測定した、表の水平方向の位置。
topNumberページの左上隅から測定した、表の垂直方向の位置。
widthNumberテーブルの幅。
heightNumberテーブルの最小の高さ。レンダリングされたテーブルの実際の高さは、テキストのフォントサイズなどの要因によって異なります。

戻る

Table - 挿入されたテーブル。

承認

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

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

insertTable(table)

指定された Table のコピーをページに挿入します。

このページに挿入された要素の位置は、それぞれのページでのソース要素の位置から決定されます。

指定された要素が現在のプレゼンテーション内でコピーされるプレースホルダである場合、マスターページまたはレイアウト ページから継承されたプロパティは、挿入された要素にも継承されます。

指定された要素が別のプレゼンテーションからコピーされたプレースホルダである場合、マスターページまたはレイアウト ページから継承されたプロパティが、コピー元のプレゼンテーションから要素にコピーされます。

// Copy a table between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const table = otherPresentationSlide.getTables[0];
currentPresentationSlide.insertTable(
    table);  // Also available for Layout, Master, and Page.

パラメータ

名前型説明
tableTableコピーして挿入するテーブル。

戻る

Table - 挿入されたテーブル。

承認

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

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

insertTextBox(text)

指定された文字列を含むテキスト ボックス Shape をページに挿入します。

テキスト ボックスの図形が、ページの左上隅にデフォルトのサイズで挿入されます。 

// Insert text box with "Hello" on the first slide of presentation.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.insertTextBox('Hello');  // Also available for Layout, Master, and Page.

パラメータ

名前型説明
textStringテキスト ボックスの図形に含める文字列。

戻る

Shape - 挿入されたテキスト ボックスの図形。

承認

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

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

insertTextBox(text, left, top, width, height)

指定された文字列を含むテキスト ボックス Shape をページに挿入します。

// Insert text box with "Hello" on the first slide of presentation. This text
// box is a square with a length of 10 points on each side.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.insertTextBox(
    'Hello', 0, 0, 10, 10);  // Also available for Layout, Master, and Page.

パラメータ

名前型説明
textStringテキスト ボックスの図形に含める文字列。
leftNumberテキスト ボックスの水平位置。ページの左上隅を基準として測定されます。
topNumberテキスト ボックスの垂直位置。ページの左上隅を基準として測定されます。
widthNumberテキスト ボックスの図形の幅。
heightNumberテキスト ボックスの図形の高さ。

戻る

Shape - 挿入されたテキスト ボックスの図形。

承認

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

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

insertVideo(videoUrl)

ページの左上隅にデフォルトのサイズの動画を挿入します。

現在サポートされているのは YouTube 動画のみです。

パラメータ

名前型説明
videoUrlString挿入する動画の URL。

戻る

Video - 挿入された動画。

承認

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

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

insertVideo(videoUrl, left, top, width, height)

指定された位置とサイズでページに動画を挿入します。

現在サポートされているのは YouTube 動画のみです。

パラメータ

名前型説明
videoUrlString挿入する動画の URL。
leftNumberページの左上隅から測定した、動画の水平位置（ポイント単位）。
topNumberページの左上隅を基準とする、動画の垂直方向の位置（ポイント単位）。
widthNumber動画の幅（ポイント単位）。
heightNumber動画の高さ（ポイント単位）。

戻る

Video - 挿入された動画。

承認

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

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

insertVideo(video)

指定された Video のコピーをページに挿入します。

このページに挿入された要素の位置は、それぞれのページでのソース要素の位置から決定されます。

指定された要素が現在のプレゼンテーション内でコピーされるプレースホルダである場合、マスターページまたはレイアウト ページから継承されたプロパティは、挿入された要素にも継承されます。

指定された要素が別のプレゼンテーションからコピーされたプレースホルダである場合、マスターページまたはレイアウト ページから継承されたプロパティが、コピー元のプレゼンテーションから要素にコピーされます。

// Copy a video between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const video = otherPresentationSlide.getVideos[0];
currentPresentationSlide.insertVideo(
    video);  // Also available for Layout, Master, and Page.

パラメータ

名前型説明
videoVideoコピーして挿入する動画。

戻る

Video - 挿入された動画。

承認

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

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

insertWordArt(wordArt)

指定された WordArt のコピーをページに挿入します。

このページに挿入された要素の位置は、それぞれのページでのソース要素の位置から決定されます。

指定された要素が現在のプレゼンテーション内でコピーされるプレースホルダである場合、マスターページまたはレイアウト ページから継承されたプロパティは、挿入された要素にも継承されます。

指定された要素が別のプレゼンテーションからコピーされたプレースホルダである場合、マスターページまたはレイアウト ページから継承されたプロパティが、コピー元のプレゼンテーションから要素にコピーされます。

// Copy a word art between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const wordArt = otherPresentationSlide.getWordArts[0];

// Also available for Layout, Master, and Page.
currentPresentationSlide.insertWordArt(wordArt);

パラメータ

名前型説明
wordArtWordArtコピーして挿入するグループ。

戻る

WordArt - 挿入されたワードアート。

承認

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

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

isSkipped()

プレゼンテーション モードでスライドがスキップされるかどうかを返します。

戻る

Boolean - プレゼンテーション モードでスライドがスキップされた場合は True。

承認

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

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

move(index)

スライドを指定されたインデックスに移動します。

パラメータ

名前型説明
indexInteger移動前のスライドの配置に基づいて、スライドの移動先のインデックス。インデックスは、0 ～プレゼンテーションのスライド数（指定した値を含む）の範囲で指定してください。

承認

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

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

refreshSlide()

リンクされた元のスライドに加えられた変更を反映するようにスライドを更新します。このスライドがリンクされていない場合は、変更を行わずに戻ります。

refreshSlide メソッドは、リンクされたソース スライドの対応するマスター ページとレイアウト ページがスライドのプレゼンテーションにまだ存在しない場合、それらをコピーします。すでに存在する場合は、ソースに加えられた変更を反映するように更新されます。

const currentPresentation = SlidesApp.getActivePresentation();
const sourcePresentation = SlidesApp.openById('sourcePresentationId');
const sourceSlide = sourcePresentation.getSlides()[0];
const linkedSlide = currentPresentation.append(
    sourceSlide,
    SlidesApp.SlideLinkingMode.LINKED,
);

sourceSlide.insertText(
    'hello world');  // Only the source slide has the text box.

linkedSlide.refreshSlide();  // The linked slide now has the text box.

例外

Error - ソース プレゼンテーションへの読み取りアクセス権がなくなった場合。

承認

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

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

remove()

ページを削除します。

承認

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

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

replaceAllText(findText, replaceText)

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

パラメータ

名前型説明
findTextString検索するテキスト。
replaceTextString一致したテキストを置き換えるテキスト。

戻る

Integer - 変更された発生回数

承認

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

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

replaceAllText(findText, replaceText, matchCase)

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

パラメータ

名前型説明
findTextString検索するテキスト。
replaceTextString一致したテキストを置き換えるテキスト。
matchCaseBooleantrue の場合、検索では大文字と小文字が区別されます。false の場合、検索では大文字と小文字が区別されません。

戻る

Integer - 変更された発生回数

承認

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

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

selectAsCurrentPage()

アクティブなプレゼンテーションで Page を current page selection として選択し、以前の選択を削除します。

スクリプトがプレゼンテーションにバインドされている場合にのみ、スクリプトを実行しているユーザーの選択にアクセスできます。

// Select the first slide as the current page selection and replace any previous
// selection.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.selectAsCurrentPage();  // Also available for Layout, Master, and Page.

承認

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

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

setSkipped(isSkipped)

プレゼンテーション モードでスライドをスキップするかどうかを設定します。

パラメータ

名前型説明
isSkippedBooleanTrue: プレゼンテーション モードでスライドをスキップします。

承認

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

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

現在の Slide と元のスライドのリンクを解除します。このスライドがリンクされていない場合は、変更を行わずに戻ります。

const currentPresentation = SlidesApp.getActivePresentation();
const sourcePresentation = SlidesApp.openById('sourcePresentationId');
const sourceSlide = sourcePresentation.getSlides()[0];
const linkedSlide = currentPresentation.append(
    sourceSlide,
    SlidesApp.SlideLinkingMode.LINKED,
);

linkedSlide.unlink();

linkedSlide.getSourcePresentationId();  // returns null
linkedSlide.getSourceSlideObjectId();   // returns null
linkedSlide
    .getSlideLinkingMode();  // returns SlidesApp.SlideLinkingMode.NOT_LINKED

承認

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

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