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)Line2 つの connection sites を接続する行をページに挿入します。
insertLine(lineCategory, startLeft, startTop, endLeft, endTop)Lineページに行を挿入します。
insertPageElement(pageElement)PageElement指定された PageElement のコピーをページに挿入します。
insertShape(shape)Shape指定された Shape のコピーをページに挿入します。
insertShape(shapeType)Shapeページに図形を挿入します。
insertShape(shapeType, left, top, width, height)Shapeページに図形を挿入します。
insertSheetsChart(sourceChart)SheetsChartGoogle スプレッドシートのグラフをページに挿入します。
insertSheetsChart(sourceChart, left, top, width, height)SheetsChart指定された位置とサイズの Google スプレッドシートのグラフをページに挿入します。
insertSheetsChart(sheetsChart)SheetsChart指定された SheetsChart のコピーをページに挿入します。
insertSheetsChartAsImage(sourceChart)ImageGoogle スプレッドシートのグラフを Image としてページに挿入します。
insertSheetsChartAsImage(sourceChart, left, top, width, height)ImageGoogle スプレッドシートのグラフを 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 は同じです Namespace があります。

戻る

String

承認

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

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

getPageElementById(id)

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

パラメータ

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

戻る

PageElement - 指定された ID のページ要素。

承認

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

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

getPageElements()

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

戻る

PageElement[]

承認

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

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

getPageType()

ページのタイプを取得します。

戻る

PageType - ページタイプ。

承認

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

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

getPlaceholder(placeholderType)

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

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

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 つ以上必要です できます。Videos、Tables、placeholder Shapes などの一部のページ要素はグループ化できません。

パラメータ

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

戻る

Group - 新しいグループ。

承認

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

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

insertGroup(group)

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

このページに挿入される要素の位置は、ソース要素の 掲載位置を特定します

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

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

// Copy a group between presentations.
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 から 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);
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 未満にする必要があります。 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 から 1 回取得され、画像のコピーが保存されて 説明します。画像のサイズは 50 MB 未満、25 メガピクセル以下である必要があります。また、 PNG、JPEG、GIF のいずれかの形式にします。

指定する URL は一般公開されていて、2 KB 以内である必要があります。URL 自体は 画像と一緒に公開し、Image.getSourceUrl() で公開します。

パラメータ

名前型説明
imageUrlString画像の URL。

戻る

Image - 挿入される画像。

承認

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

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

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

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

画像を挿入すると URL から 1 回取得され、画像のコピーが保存されて 説明します。画像のサイズは 50 MB 未満、25 メガピクセル以下である必要があります。また、 PNG、JPEG、GIF のいずれかの形式にします。

指定する URL は一般公開されていて、2 KB 以内である必要があります。URL 自体は 画像と一緒に公開し、Image.getSourceUrl() で公開します。

画像のアスペクト比を維持するため、画像のスケーリングと中央揃えが行われます。 サイズ変更されます。

パラメータ

名前型説明
imageUrlString画像の URL。
leftNumber画像の水平方向の位置（ポイント単位）。左上隅を起点として計算されます クリックします。
topNumberポイント単位の画像の垂直位置。座標の左上隅を起点とし、 表示されます。
widthNumber画像の幅（ポイント単位）。
heightNumberポイント単位の画像の高さ。

戻る

Image - 挿入される画像。

承認

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

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

insertLine(line)

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

このページに挿入される要素の位置は、ソース要素の 掲載位置を特定します

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

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

// Copy a line between presentations.
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()

アクティブなプレゼンテーションの Page を current 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