プレゼンテーション内の 1 つのページ。
Methods
詳細なドキュメント
asLayout()
asMaster()
asSlide()
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()
getImages()
getLines()
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
オブジェクトのリストを返します。
リターン
承認
この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getPageType()
getPlaceholder(placeholderType)
一致するプレースホルダが存在しない場合は、指定された PlaceholderType
または null
のプレースホルダ PageElement
オブジェクトを返します。
同じタイプのプレースホルダが複数ある場合は、プレースホルダ インデックスが最小のプレースホルダが返されます。同じインデックスに一致するプレースホルダが複数ある場合は、ページのページ要素コレクションから最初のプレースホルダを返します。
var slide = SlidesApp.getActivePresentation().getSlides()[0]; var placeholder = slide.getPlaceholder(SlidesApp.PlaceholderType.CENTERED_TITLE);
パラメータ
名前 | 型 | 説明 |
---|---|---|
placeholderType | PlaceholderType |
リターン
承認
この方法を使用するスクリプトには、次の 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);
パラメータ
名前 | 型 | 説明 |
---|---|---|
placeholderType | PlaceholderType | |
placeholderIndex | Integer |
リターン
承認
この方法を使用するスクリプトには、次の 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);
リターン
承認
この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getShapes()
getSheetsCharts()
ページ上の SheetsChart
オブジェクトのリストを返します。
リターン
承認
この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getTables()
getVideos()
getWordArts()
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. 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.
パラメータ
名前 | 型 | 説明 |
---|---|---|
group | Group | コピーして挿入するグループ。 |
リターン
Group
- 挿入されたグループ。
承認
この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertImage(blobSource)
指定された画像 blob からデフォルト サイズの画像をページの左上に挿入します。
画像を挿入すると、BlobSource
から画像が取得され、プレゼンテーション内に表示するためにコピーが保存されます。画像は 50 MB 未満、25 メガピクセルを超えないようにしてください。また、PNG、JPEG、GIF のいずれかの形式である必要があります。
var slide = SlidesApp.getActivePresentation().getSlides()[0]; // Get the Drive image file with the given ID. var image = DriveApp.getFileById(fileId); slide.insertImage(image);
パラメータ
名前 | 型 | 説明 |
---|---|---|
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 メガピクセルを超えてはなりません。また、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);
パラメータ
名前 | 型 | 説明 |
---|---|---|
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. var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; var 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 から画像が取得され、プレゼンテーション内に表示するためにコピーが保存されます。画像は 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 から画像が取得され、プレゼンテーション内に表示するためにコピーが保存されます。画像は 50 MB 未満、25 メガピクセルを超えないようにしてください。また、PNG、JPEG、GIF のいずれかの形式である必要があります。
指定する 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. var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; var 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. 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]);
パラメータ
名前 | 型 | 説明 |
---|---|---|
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. 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);
パラメータ
名前 | 型 | 説明 |
---|---|---|
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. 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);
パラメータ
名前 | 型 | 説明 |
---|---|---|
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. 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.
パラメータ
名前 | 型 | 説明 |
---|---|---|
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. var 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 スプレッドシートのグラフにリンクされているため、更新できます。他の共同編集者は元のスプレッドシートへのリンクを表示できます。
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);
パラメータ
名前 | 型 | 説明 |
---|---|---|
sourceChart | EmbeddedChart | ページに挿入されるスプレッドシートのグラフ。 |
リターン
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);
パラメータ
名前 | 型 | 説明 |
---|---|---|
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. 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);
パラメータ
名前 | 型 | 説明 |
---|---|---|
sheetsChart | SheetsChart | コピーして挿入するスプレッドシートのグラフ。 |
リターン
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.
パラメータ
名前 | 型 | 説明 |
---|---|---|
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 スプレッドシートのグラフにリンクされていません。
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);
パラメータ
名前 | 型 | 説明 |
---|---|---|
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)
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. 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.
パラメータ
名前 | 型 | 説明 |
---|---|---|
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. var 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. var 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)
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. 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.
パラメータ
名前 | 型 | 説明 |
---|---|---|
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. 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);
パラメータ
名前 | 型 | 説明 |
---|---|---|
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. 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