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

Class Layout

プレゼンテーションのレイアウト。

各レイアウトは、そこから継承されるスライドのテンプレートとして機能し、それらのスライドのコンテンツの配置とスタイル設定を決定します。

メソッド

メソッド	戻り値の型	概要
`getBackground()`	`PageBackground`	ページの背景を取得します。
`getColorScheme()`	`ColorScheme`	ページに関連付けられている `ColorScheme` を取得します。
`getGroups()`	`Group[]`	ページ上の `Group` オブジェクトのリストを返します。
`getImages()`	`Image[]`	ページ上の `Image` オブジェクトのリストを返します。
`getLayoutName()`	`String`	レイアウトの名前を取得します。
`getLines()`	`Line[]`	ページ上の `Line` オブジェクトのリストを返します。
`getMaster()`	`Master`	レイアウトのベースとなるマスターを取得します。
`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` オブジェクトのリストを返します。
`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

`getLayoutName()`

レイアウトの名前を取得します。

戻る

String

承認

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

`getMaster()`

レイアウトのベースとなるマスターを取得します。

戻る

Master

承認

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

パラメータ

名前	型	説明
`placeholderType`	`PlaceholderType`

戻る

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

パラメータ

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

戻る

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

`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 未満、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);

パラメータ

名前	型	説明
`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 から一度だけ取得され、プレゼンテーション内に表示するためにコピーが保存されます。画像のサイズは 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);

パラメータ

名前	型	説明
`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

Class Layout コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

メソッド

詳細なドキュメント

getBackground()

戻る

承認

getColorScheme()

戻る

承認

getGroups()

戻る

承認

getImages()

戻る

承認

getLayoutName()

戻る

承認

getLines()

戻る

承認

getMaster()

戻る

承認

getObjectId()

戻る

承認

getPageElementById(id)

パラメータ

戻る

承認

getPageElements()

戻る

承認

getPageType()

戻る

承認

getPlaceholder(placeholderType)

パラメータ

戻る

承認

getPlaceholder(placeholderType, placeholderIndex)

パラメータ

戻る

承認

getPlaceholders()

戻る

承認

getShapes()

戻る

承認

getSheetsCharts()

戻る

承認

getTables()

戻る

承認

getVideos()

戻る

承認

getWordArts()

戻る

承認

group(pageElements)

パラメータ

戻る

承認

insertGroup(group)

パラメータ

戻る

承認

insertImage(blobSource)

パラメータ

戻る

承認

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

パラメータ

戻る

承認

insertImage(image)

Class Layout

`getBackground()`

`getColorScheme()`

`getGroups()`

`getImages()`

`getLayoutName()`

`getLines()`

`getMaster()`

`getObjectId()`

`getPageElementById(id)`

`getPageElements()`

`getPageType()`

`getPlaceholder(placeholderType)`

`getPlaceholder(placeholderType, placeholderIndex)`

`getPlaceholders()`

`getShapes()`

`getSheetsCharts()`

`getTables()`

`getVideos()`

`getWordArts()`

`group(pageElements)`

`insertGroup(group)`

`insertImage(blobSource)`

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

`insertImage(image)`

`insertImage(imageUrl)`

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

`insertLine(line)`

`insertLine(lineCategory, startConnectionSite, endConnectionSite)`

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

`insertPageElement(pageElement)`

`insertShape(shape)`

`insertShape(shapeType)`

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

`insertSheetsChart(sourceChart)`

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

`insertSheetsChart(sheetsChart)`

`insertSheetsChartAsImage(sourceChart)`

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

`insertTable(numRows, numColumns)`

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

`insertTable(table)`