Class Page

ページ

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

Methods

メソッド戻り値の型概要
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 または null のプレースホルダ PageElement オブジェクトを返します。
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)Lineページに 2 つの 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アクティブなプレゼンテーションの Pagecurrent 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 または null のプレースホルダ PageElement オブジェクトを返します。

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

var slide = SlidesApp.getActivePresentation().getSlides()[0];
var 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 を返します。

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

var slide = SlidesApp.getActivePresentation().getSlides()[0];
var 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 オブジェクトのリストを返します。

var 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 つ以上必要です。一部のページ要素(VideosTablesplaceholder 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.
var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0];
var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0];
var 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 から画像が取得され、プレゼンテーション内に表示するためにコピーが保存されます。画像は 50 MB 未満、25 メガピクセルを超えないようにしてください。また、PNG、JPEG、GIF のいずれかの形式である必要があります。

var slide = SlidesApp.getActivePresentation().getSlides()[0];
// Get the Drive image file with the given ID.
var image = DriveApp.getFileById(fileId);
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 メガピクセルを超えてはなりません。また、PNG、JPEG、GIF のいずれかの形式である必要があります。

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

var slide = SlidesApp.getActivePresentation().getSlides()[0];
// Get the Drive image file with the given ID.
var image = DriveApp.getFileById(fileId);
var position = {left: 0, top: 0};
var 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.
var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0];
var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0];
var 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 から画像が取得され、プレゼンテーション内に表示するためにコピーが保存されます。画像は 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 から画像が取得され、プレゼンテーション内に表示するためにコピーが保存されます。画像は 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.
var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0];
var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0];
var 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.
var slide = SlidesApp.getActivePresentation().getSlides()[0];
var shape1 = slide.insertShape(SlidesApp.ShapeType.RECTANGLE);
var 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.
var slide = SlidesApp.getActivePresentation().getSlides()[0];
var startPoint = {left: 10, top: 10};
var 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.
var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0];
var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0];
var 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.
var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0];
var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0];
var 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.
var 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 スプレッドシートのグラフにリンクされているため、更新できます。他の共同編集者は元のスプレッドシートへのリンクを表示できます。

var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
var chart = sheet.getCharts()[0];
// Insert the spreadsheet chart in the first slide.
var 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 スプレッドシートのグラフにリンクされているため、更新できます。他の共同編集者は元のスプレッドシートへのリンクを表示できます。

var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
var chart = sheet.getCharts()[0];
// Insert the spreadsheet chart in the first slide.
var slide = SlidesApp.getActivePresentation().getSlides()[0];
var position = {left: 0, top: 0};
var 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.
var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0];
var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0];
var 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 スプレッドシートのグラフにリンクされていません。

var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
var chart = sheet.getCharts()[0];
// Insert the spreadsheet chart in the first slide.
var 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 スプレッドシートのグラフにリンクされていません。

var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
var chart = sheet.getCharts()[0];
// Insert the spreadsheet chart in the first slide.
var slide = SlidesApp.getActivePresentation().getSlides()[0];
var position = {left: 0, top: 0};
var 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.
var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0];
var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0];
var 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.
var 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.
var 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.
var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0];
var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0];
var 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.
var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0];
var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0];
var 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()

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

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

// Select the first slide as the current page selection and replace any previous selection.
var 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