このページは Cloud Translation API によって翻訳されました。

Class Master

プレゼンテーションのマスター。

マスターには、一連のレイアウトのすべての共通ページ要素と共通プロパティが含まれています。以下の 3 つの目的があります。

マスターのプレースホルダシェイプには、そのマスターを使用するページ上のすべてのプレースホルダシェイプの既定のテキストスタイルとシェイププロパティが含まれます。
マスターページのプロパティは、レイアウトによって継承される共通のページプロパティを定義します。
マスタースライド上の他のシェイプは、レイアウトに関係なく、そのマスターを使用しているすべてのスライドに表示されます。

メソッド

メソッド	戻り値の型	概要
`getBackground()`	`PageBackground`	ページの背景を取得します。
`getColorScheme()`	`ColorScheme`	ページに関連付けられている `ColorScheme` を取得します。
`getGroups()`	`Group[]`	ページ上の `Group` オブジェクトのリストを返します。
`getImages()`	`Image[]`	ページ上の `Image` オブジェクトのリストを返します。
`getLayouts()`	`Layout[]`	このマスターのレイアウトを取得します。
`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)`	`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)`	`SheetsChart`	Google スプレッドシートのグラフをページに挿入します。
`insertSheetsChart(sourceChart, left, top, width, height)`	`SheetsChart`	指定された位置とサイズで Google スプレッドシートのグラフをページに挿入します。
`insertSheetsChart(sheetsChart)`	`SheetsChart`	指定された `SheetsChart` のコピーをページに挿入します。
`insertSheetsChartAsImage(sourceChart)`	`Image`	Google スプレッドシートのグラフを `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` として選択し、以前の選択をすべて削除します。

詳細なドキュメント

`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

`getLayouts()`

このマスターのレイアウトを取得します。

戻る

Layout[]

承認

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

パラメータ

名前	型	説明
`id`	`String`	取得されるページ要素の 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,
);

パラメータ

名前	型	説明
`placeholderType`	`PlaceholderType`

戻る

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,
);

パラメータ

名前	型	説明
`placeholderType`	`PlaceholderType`
`placeholderIndex`	`Integer`

戻る

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 などの一部のページ要素はグループ化できません。

パラメータ

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

戻る

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.

パラメータ

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

戻る

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);

パラメータ

名前	型	説明
`blobSource`	`BlobSource`	画像データ。

戻る

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);

パラメータ

名前	型	説明
`blobSource`	`BlobSource`	画像データ。
`left`	`Number`	ページの左上隅を基準として測定した、画像の水平位置（ポイント単位）。
`top`	`Number`	ページの左上隅を基準として測定した、画像の垂直方向の位置（ポイント単位）。
`width`	`Number`	画像の幅（ポイント単位）。
`height`	`Number`	画像の高さ（ポイント単位）。

戻る

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);

パラメータ

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

戻る

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() を介して公開されます。

パラメータ

名前	型	説明
`imageUrl`	`String`	画像の URL。

戻る

Image - 挿入された画像。

承認

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

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

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

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

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

画像のアスペクト比を維持するため、指定されたサイズに合わせて画像がスケーリングされ、中央に配置されます。

パラメータ

名前	型	説明
`imageUrl`	`String`	画像の URL。
`left`	`Number`	ページの左上隅を基準として測定した、画像の水平位置（ポイント単位）。
`top`	`Number`	ページの左上隅を基準として測定した、画像の垂直方向の位置（ポイント単位）。
`width`	`Number`	画像の幅（ポイント単位）。
`height`	`Number`	画像の高さ（ポイント単位）。

戻る

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);

パラメータ

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

戻る

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],
);

パラメータ

名前	型	説明
`lineCategory`	`LineCategory`	挿入する線のカテゴリ。
`startConnectionSite`	`ConnectionSite`	線路の始点が接続される接続サイト。
`endConnectionSite`	`ConnectionSite`	線の端を接続する接続サイト。

戻る

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,
);

パラメータ

名前	型	説明
`lineCategory`	`LineCategory`	挿入する線のカテゴリ。
`startLeft`	`Number`	線の始点の水平位置。ページの左上からポイント単位で測定されます。
`startTop`	`Number`	線の始点の垂直方向の位置。ページの左上からポイント単位で測定されます。
`endLeft`	`Number`	線の終点の水平位置（ページの左上からポイント単位で測定）。
`endTop`	`Number`	線の終点の垂直位置（ページの左上隅からのポイント単位）。

戻る

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);

パラメータ

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

戻る

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.

パラメータ

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

戻る

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);

パラメータ

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

戻る

Shape - 挿入された図形。

承認

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

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

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

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

パラメータ

名前	型	説明
`shapeType`	`ShapeType`	挿入する図形のタイプ。
`left`	`Number`	ページの左上隅を基準として測定した、図形の水平位置。
`top`	`Number`	ページの左上隅を基準とする、図形の垂直位置。
`width`	`Number`	図形の幅。
`height`	`Number`	図形の高さ。

戻る

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);

パラメータ

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

戻る

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

承認

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

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

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

指定された位置とサイズで 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,
);

パラメータ

名前	型	説明
`sourceChart`	`EmbeddedChart`	ページに挿入するスプレッドシート内のグラフ。
`left`	`Number`	ページの左上から測定した、グラフの水平位置（ポイント単位）。
`top`	`Number`	ページの左上から測定した、グラフの垂直位置（ポイント単位）。
`width`	`Number`	グラフの幅（ポイント単位）。
`height`	`Number`	グラフの高さ（ポイント単位）。

戻る

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);

パラメータ

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

戻る

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.

パラメータ

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

戻る

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,
);

パラメータ

名前	型	説明
`sourceChart`	`EmbeddedChart`	ページに挿入するスプレッドシート内のグラフ。
`left`	`Number`	ページの左上から測定した、グラフの水平位置（ポイント単位）。
`top`	`Number`	ページの左上から測定した、グラフの垂直位置（ポイント単位）。
`width`	`Number`	グラフの幅（ポイント単位）。
`height`	`Number`	グラフの高さ（ポイント単位）。

戻る

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

承認

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

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

`insertTable(numRows, numColumns)`

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

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

パラメータ

名前	型	説明
`numRows`	`Integer`	テーブル内の行数。
`numColumns`	`Integer`	テーブル内の列数。

戻る

Table - 挿入された表。

承認

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

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

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

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

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

パラメータ

名前	型	説明
`numRows`	`Integer`	テーブル内の行数。
`numColumns`	`Integer`	テーブル内の列数。
`left`	`Number`	ページの左上から測定した表の水平位置。
`top`	`Number`	ページの左上隅を基準とする表の垂直位置。
`width`	`Number`	テーブルの幅。
`height`	`Number`	テーブルの最小高さ。レンダリングされたテーブルの実際の高さは、テキストのフォントサイズなどの要素によって異なります。

戻る

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.

パラメータ

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

戻る

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.

パラメータ

名前	型	説明
`text`	`String`	テキストボックスの形状に含める文字列。

戻る

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.

パラメータ

名前	型	説明
`text`	`String`	テキストボックスの形状に含める文字列。
`left`	`Number`	テキストボックスの形状の水平位置（ページの左上隅を基準として測定）。
`top`	`Number`	ページの左上隅を基準として測定した、テキストボックスの形状の垂直位置。
`width`	`Number`	テキストボックスの形状の幅。
`height`	`Number`	テキストボックスの形状の高さ。

戻る

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

承認

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

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

`insertVideo(videoUrl)`

ページの左上にデフォルトのサイズの動画が挿入されます。

現在のところ、YouTube 動画のみをご利用いただけます。

パラメータ

名前	型	説明
`videoUrl`	`String`	挿入する動画の URL。

戻る

Video - 挿入された動画。

承認

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

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

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

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

現在のところ、YouTube 動画のみをご利用いただけます。

パラメータ

名前	型	説明
`videoUrl`	`String`	挿入する動画の URL。
`left`	`Number`	ページの左上隅を基準として測定した、動画の水平位置（ポイント単位）。
`top`	`Number`	ページの左上隅を基準として測定した、動画の垂直位置（ポイント単位）。
`width`	`Number`	動画の幅（ポイント）。
`height`	`Number`	動画の高さ（ポイント）。

戻る

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.

パラメータ

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

戻る

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);

パラメータ

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

戻る

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)`

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

パラメータ

名前	型	説明
`findText`	`String`	検索するテキスト。
`replaceText`	`String`	一致したテキストを置き換えるテキスト。

戻る

Integer - 変更された出現回数

承認

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

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

`replaceAllText(findText, replaceText, matchCase)`

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

パラメータ

名前	型	説明
`findText`	`String`	検索するテキスト。
`replaceText`	`String`	一致したテキストを置き換えるテキスト。
`matchCase`	`Boolean`	`true` の場合、検索では大文字と小文字が区別されます。`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