Class Page

ページ

プレゼンテーション内のページ。

メソッド

メソッド戻り値の型概要
asLayout()Layoutページをレイアウトとして返します。
asMaster()Masterページをマスターとして返します。
asSlide()Slideページをスライドとして返します。
getBackground()PageBackgroundページの背景を取得します。
getColorScheme()ColorSchemeページに関連付けられている ColorScheme を取得します。
getGroups()Group[]ページ上の Group オブジェクトのリストを返します。
getImages()Image[]ページ上の Image オブジェクトのリストを返します。
getLines()Line[]ページ上の Line オブジェクトのリストを返します。
getObjectId()Stringページの一意の ID を取得します。
getPageElementById(id)PageElement指定された ID のページの PageElement を返します。存在しない場合は null を返します。
getPageElements()PageElement[]ページにレンダリングされた PageElement オブジェクトのリストを返します。
getPageType()PageTypeページのタイプを取得します。
getPlaceholder(placeholderType)PageElement指定された PlaceholderType のプレースホルダ PageElement オブジェクトを返します。一致するプレースホルダが存在しない場合は null を返します。
getPlaceholder(placeholderType, placeholderIndex)PageElement指定された PlaceholderType のプレースホルダ PageElement オブジェクトとプレースホルダ インデックスを返します。プレースホルダが存在しない場合は null を返します。
getPlaceholders()PageElement[]ページ内のプレースホルダ PageElement オブジェクトのリストを返します。
getShapes()Shape[]ページ上の Shape オブジェクトのリストを返します。
getSheetsCharts()SheetsChart[]ページ上の SheetsChart オブジェクトのリストを返します。
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 のコピーをページに挿入します。
remove()voidページを削除します。
replaceAllText(findText, replaceText)Integer検索テキストに一致するテキストをすべて置換テキストに置き換えます。
replaceAllText(findText, replaceText, matchCase)Integer検索テキストに一致するテキストをすべて置換テキストに置き換えます。
selectAsCurrentPage()voidアクティブなプレゼンテーションの Page を current page selection として選択し、以前の選択をすべて削除します。

詳細なドキュメント

asLayout()

ページをレイアウトとして返します。

戻る

Layout - レイアウトとしてのページ。

承認

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

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

asMaster()

ページをマスターとして返します。

戻る

Master - マスターとしてのページ。

承認

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

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

asSlide()

ページをスライドとして返します。

戻る

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

getLines()

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

戻る

Line[]

承認

このメソッドを使用するスクリプトには、次のスコープの 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 - 指定された 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 のプレースホルダ PageElement オブジェクトを返します。一致するプレースホルダが存在しない場合は null を返します。

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

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

パラメータ

名前型説明
placeholderTypePlaceholderType

戻る

PageElement

承認

このメソッドを使用するスクリプトには、次のスコープの 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

承認

このメソッドを使用するスクリプトには、次のスコープの 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

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 未満で、25 メガピクセル以下である必要があります。また、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 から 1 回取得され、コピーが保存されてプレゼンテーション内に表示されます。画像のサイズは 50 MB 未満で、25 MP を超えてはなりません。また、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

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