プレゼンテーション内のスライド。
このタイプのページには、ユーザーに表示されるコンテンツが含まれます。大半のスライドには、ベースとなるマスターとレイアウトがそれぞれ 1 つずつあります。使用するレイアウトは、各スライドの作成時に指定できます。
メソッド
詳細なドキュメント
duplicate()
get Background()
ページの背景を取得します。
戻る
Page
- ページの背景。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Color Scheme()
ページに関連付けられている Color
を取得します。
戻る
Color
- ページのカラーパターン。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Groups()
get Images()
get Layout()
get Lines()
get Notes Page()
get Object Id()
ページの一意の ID を取得します。ページとページ要素で使用されるオブジェクト ID は同じ名前空間を共有します。
戻る
String
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Page Element By Id(id)
指定された ID のページの Page
を返します。存在しない場合は null
を返します。
パラメータ
名前 | 型 | 説明 |
---|---|---|
id | String | 取得されるページ要素の ID。 |
戻る
Page
- 指定された ID のページ要素。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Page Elements()
ページにレンダリングされた Page
オブジェクトのリストを返します。
戻る
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Page Type()
get Placeholder(placeholderType)
指定された Placeholder
のプレースホルダ Page
オブジェクトを返します。一致するプレースホルダが存在しない場合は null
を返します。
同じタイプのプレースホルダが複数ある場合は、プレースホルダ インデックスが最小のプレースホルダが返されます。同じインデックスを持つ一致するプレースホルダが複数ある場合は、ページのページ要素コレクションから最初のプレースホルダが返されます。
const slide = SlidesApp.getActivePresentation().getSlides()[0]; const placeholder = slide.getPlaceholder( SlidesApp.PlaceholderType.CENTERED_TITLE, );
パラメータ
名前 | 型 | 説明 |
---|---|---|
placeholder | Placeholder |
戻る
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Placeholder(placeholderType, placeholderIndex)
指定された Placeholder
のプレースホルダ Page
オブジェクトとプレースホルダ インデックスを返します。プレースホルダが存在しない場合は null
を返します。
同じタイプとインデックスを持つプレースホルダが複数ある場合は、ページのページ要素コレクションから最初のプレースホルダが返されます。
const slide = SlidesApp.getActivePresentation().getSlides()[0]; const placeholder = slide.getPlaceholder( SlidesApp.PlaceholderType.CENTERED_TITLE, 0, );
パラメータ
名前 | 型 | 説明 |
---|---|---|
placeholder | Placeholder | |
placeholder | Integer |
戻る
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Placeholders()
ページ内のプレースホルダ Page
オブジェクトのリストを返します。
const 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
get Shapes()
get Sheets Charts()
ページ上の Sheets
オブジェクトのリストを返します。
戻る
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Slide Linking Mode()
スライドが別のスライドにリンクされているかどうかを示す Slide
を返します。
戻る
Slide
- スライドのリンクモード。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Source Presentation Id()
ソースの Presentation
ID を返します。スライドがリンクされていない場合は null
を返します。
スライドにソース Presentation
ID が設定されるのは、別のプレゼンテーション内のスライドにリンクされている場合のみです。
戻る
String
- ソース プレゼンテーション ID または null
。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Source Slide Object Id()
ソース スライドの ID を返します。スライドがリンクされていない場合は null
を返します。
スライドにソース スライド ID が設定されるのは、別のプレゼンテーション内のスライドにリンクされている場合のみです。
戻る
String
- ソース スライドの ID または null
。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Tables()
get Videos()
get Word Arts()
group(pageElements)
指定されたすべてのページ要素をグループ化します。
同じページに、別のグループにまだ含まれていないページ要素が 2 つ以上ある必要があります。Videos
、Tables
、placeholder Shapes
などの一部のページ要素はグループ化できません。
パラメータ
名前 | 型 | 説明 |
---|---|---|
page | Page | グループ化する要素。 |
戻る
Group
- 新しいグループ。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Group(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
insert Image(blobSource)
指定された画像 BLOB のデフォルトサイズの画像をページの左上に挿入します。
画像を挿入すると、Blob
から 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);
パラメータ
名前 | 型 | 説明 |
---|---|---|
blob | Blob | 画像データ。 |
戻る
Image
- 挿入された画像。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Image(blobSource, left, top, width, height)
指定された画像 BLOB から、指定された位置とサイズでページに画像を挿入します。
画像は、挿入時に指定された Blob
から 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);
パラメータ
名前 | 型 | 説明 |
---|---|---|
blob | Blob | 画像データ。 |
left | Number | ページの左上隅を基準として測定した、画像の水平位置(ポイント単位)。 |
top | Number | ページの左上隅を基準として測定した、画像の垂直方向の位置(ポイント単位)。 |
width | Number | 画像の幅(ポイント単位)。 |
height | Number | 画像の高さ(ポイント単位)。 |
戻る
Image
- 挿入された画像。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Image(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
insert Image(imageUrl)
指定された URL の画像をページの左上にデフォルトのサイズで挿入します。
画像を挿入すると、その画像が URL から 1 回取得され、プレゼンテーション内に表示するためのコピーが保存されます。画像のサイズは 50 MB 未満で、25 メガピクセルを超えてはなりません。また、PNG、JPEG、GIF のいずれかの形式である必要があります。
指定する URL は一般公開されているもので、2 KB 以下である必要があります。URL 自体は画像とともに保存され、Image.getSourceUrl()
を介して公開されます。
パラメータ
名前 | 型 | 説明 |
---|---|---|
image | String | 画像の URL。 |
戻る
Image
- 挿入された画像。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Image(imageUrl, left, top, width, height)
指定された URL の画像を、指定された位置とサイズでページに挿入します。
画像を挿入すると、その画像が URL から 1 回取得され、プレゼンテーション内に表示するためのコピーが保存されます。画像のサイズは 50 MB 未満で、25 メガピクセルを超えてはなりません。また、PNG、JPEG、GIF のいずれかの形式である必要があります。
指定する URL は一般公開されているもので、2 KB 以下である必要があります。URL 自体は画像とともに保存され、Image.getSourceUrl()
を介して公開されます。
画像のアスペクト比を維持するため、指定されたサイズに合わせて画像がスケーリングされ、中央に配置されます。
パラメータ
名前 | 型 | 説明 |
---|---|---|
image | 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
insert Line(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
insert Line(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], );
パラメータ
名前 | 型 | 説明 |
---|---|---|
line | Line | 挿入する線のカテゴリ。 |
start | Connection | 線路の始点が接続される接続サイト。 |
end | Connection | 線の端を接続する接続サイト。 |
戻る
Line
- 挿入された線。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Line(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, );
パラメータ
名前 | 型 | 説明 |
---|---|---|
line | Line | 挿入する線のカテゴリ。 |
start | Number | 線の始点の水平位置。ページの左上からポイント単位で測定されます。 |
start | Number | 線の始点の垂直方向の位置。ページの左上からポイント単位で測定されます。 |
end | Number | 線の終点の水平位置(ページの左上からポイント単位で測定)。 |
end | Number | 線の終点の垂直位置(ページの左上隅からのポイント単位)。 |
戻る
Line
- 挿入された線。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Page Element(pageElement)
指定された Page
のコピーをページに挿入します。
このページに挿入された要素の位置は、それぞれのページのソース要素の位置から決まります。
指定された要素が現在のプレゼンテーション内からコピーされたプレースホルダの場合、マスターページまたはレイアウトページから継承されるプロパティは、挿入された要素にも継承されます。
指定された要素が別のプレゼンテーションからコピーされたプレースホルダの場合、マスターページまたはレイアウトページから継承されるプロパティが、ソース プレゼンテーションから要素にコピーされます。
// 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);
パラメータ
名前 | 型 | 説明 |
---|---|---|
page | Page | コピーして挿入するページ要素。 |
戻る
Page
- 挿入されたページ要素。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Shape(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
insert Shape(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);
パラメータ
名前 | 型 | 説明 |
---|---|---|
shape | Shape | 挿入する図形のタイプ。 |
戻る
Shape
- 挿入された図形。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Shape(shapeType, left, top, width, height)
ページに図形を挿入します。
パラメータ
名前 | 型 | 説明 |
---|---|---|
shape | Shape | 挿入する図形のタイプ。 |
left | Number | ページの左上隅を基準として測定した、図形の水平位置。 |
top | Number | ページの左上隅を基準とする、図形の垂直位置。 |
width | Number | 図形の幅。 |
height | Number | 図形の高さ。 |
戻る
Shape
- 挿入された図形。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Sheets Chart(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);
パラメータ
名前 | 型 | 説明 |
---|---|---|
source | Embedded | ページに挿入するスプレッドシート内のグラフ。 |
戻る
Sheets
- ページに挿入されたグラフ。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Sheets Chart(sourceChart, left, top, width, height)
指定された位置とサイズで 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]; 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, );
パラメータ
名前 | 型 | 説明 |
---|---|---|
source | Embedded | ページに挿入するスプレッドシート内のグラフ。 |
left | Number | ページの左上から測定した、グラフの水平位置(ポイント単位)。 |
top | Number | ページの左上から測定した、グラフの垂直位置(ポイント単位)。 |
width | Number | グラフの幅(ポイント単位)。 |
height | Number | グラフの高さ(ポイント単位)。 |
戻る
Sheets
- ページに挿入されたグラフ。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Sheets Chart(sheetsChart)
指定された Sheets
のコピーをページに挿入します。
このページに挿入された要素の位置は、それぞれのページのソース要素の位置から決まります。
指定された要素が現在のプレゼンテーション内からコピーされたプレースホルダの場合、マスターページまたはレイアウトページから継承されるプロパティは、挿入された要素にも継承されます。
指定された要素が別のプレゼンテーションからコピーされたプレースホルダの場合、マスターページまたはレイアウトページから継承されるプロパティが、ソース プレゼンテーションから要素にコピーされます。
// 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);
パラメータ
名前 | 型 | 説明 |
---|---|---|
sheets | Sheets | コピーして挿入するシートのグラフ。 |
戻る
Sheets
- 挿入されたスプレッドシートのグラフ。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Sheets Chart As Image(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.
パラメータ
名前 | 型 | 説明 |
---|---|---|
source | Embedded | ページに挿入するスプレッドシート内のグラフ。 |
戻る
Image
- ページに挿入されたグラフの画像。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Sheets Chart As Image(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, );
パラメータ
名前 | 型 | 説明 |
---|---|---|
source | Embedded | ページに挿入するスプレッドシート内のグラフ。 |
left | Number | ページの左上から測定した、グラフの水平位置(ポイント単位)。 |
top | Number | ページの左上から測定した、グラフの垂直位置(ポイント単位)。 |
width | Number | グラフの幅(ポイント単位)。 |
height | Number | グラフの高さ(ポイント単位)。 |
戻る
Image
- ページに挿入されたグラフの画像。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Table(numRows, numColumns)
insert Table(numRows, numColumns, left, top, width, height)
指定された位置とサイズでページにテーブルを挿入します。
作成された表に行と列が均等に配置されます。
パラメータ
名前 | 型 | 説明 |
---|---|---|
num | Integer | テーブル内の行数。 |
num | Integer | テーブル内の列数。 |
left | Number | ページの左上から測定した表の水平位置。 |
top | Number | ページの左上隅を基準とする表の垂直位置。 |
width | Number | テーブルの幅。 |
height | Number | テーブルの最小高さ。レンダリングされたテーブルの実際の高さは、テキストのフォントサイズなどの要素によって異なります。 |
戻る
Table
- 挿入された表。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insert Table(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
insert Text Box(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
insert Text Box(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
insert Video(videoUrl)
insert Video(videoUrl, left, top, width, height)
指定された位置とサイズでページに動画を挿入します。
現在のところ、YouTube 動画のみをご利用いただけます。
パラメータ
名前 | 型 | 説明 |
---|---|---|
video | 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
insert Video(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
insert Word Art(wordArt)
指定された Word
のコピーをページに挿入します。
このページに挿入された要素の位置は、それぞれのページのソース要素の位置から決まります。
指定された要素が現在のプレゼンテーション内からコピーされたプレースホルダの場合、マスターページまたはレイアウトページから継承されるプロパティは、挿入された要素にも継承されます。
指定された要素が別のプレゼンテーションからコピーされたプレースホルダの場合、マスターページまたはレイアウトページから継承されるプロパティが、ソース プレゼンテーションから要素にコピーされます。
// 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);
パラメータ
名前 | 型 | 説明 |
---|---|---|
word | Word | コピーして挿入するグループ。 |
戻る
Word
- 挿入されたワードアート。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
is Skipped()
プレゼンテーション モードでスライドがスキップされるかどうかを返します。
戻る
Boolean
- プレゼンテーション モードでスライドがスキップされた場合は True
。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
move(index)
スライドを指定されたインデックスに移動します。
パラメータ
名前 | 型 | 説明 |
---|---|---|
index | Integer | 移動前のスライドの配置に基づいて、スライドを移動するインデックス。インデックスは 0 ~プレゼンテーション内のスライド数(両端を含む)の範囲で指定する必要があります。 |
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
refresh Slide()
スライドを更新して、リンクされたソーススライドに加えた変更を反映します。このスライドがリンクされていない場合は、変更を加えずに戻ります。
refresh
メソッドは、リンクされたソーススライドの対応するマスターページとレイアウト ページがまだ存在しない場合、それらをスライドのプレゼンテーションにコピーします。すでに存在する場合は、ソースに加えられた変更を反映するように更新されます。
const currentPresentation = SlidesApp.getActivePresentation(); const sourcePresentation = SlidesApp.openById('sourcePresentationId'); const sourceSlide = sourcePresentation.getSlides()[0]; const linkedSlide = currentPresentation.append( sourceSlide, SlidesApp.SlideLinkingMode.LINKED, ); sourceSlide.insertText( 'hello world'); // Only the source slide has the text box. linkedSlide.refreshSlide(); // The linked slide now has the text box.
例外
Error
- ソース プレゼンテーションへの読み取りアクセス権が利用できなくなった場合。
承認
このメソッドを使用するスクリプトには、次のスコープの 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
replace All Text(findText, replaceText)
検索テキストに一致するテキストをすべて置換テキストに置き換えます。検索では大文字と小文字が区別されません。
パラメータ
名前 | 型 | 説明 |
---|---|---|
find | String | 検索するテキスト。 |
replace | String | 一致したテキストを置き換えるテキスト。 |
戻る
Integer
- 変更された出現回数
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replace All Text(findText, replaceText, matchCase)
検索テキストに一致するテキストをすべて置換テキストに置き換えます。
パラメータ
名前 | 型 | 説明 |
---|---|---|
find | String | 検索するテキスト。 |
replace | String | 一致したテキストを置き換えるテキスト。 |
match | Boolean | true の場合、検索では大文字と小文字が区別されます。false の場合、検索では大文字と小文字が区別されません。 |
戻る
Integer
- 変更された出現回数
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
select As Current Page()
アクティブなプレゼンテーションの 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
set Skipped(isSkipped)
プレゼンテーション モードでスライドをスキップするかどうかを設定します。
パラメータ
名前 | 型 | 説明 |
---|---|---|
is | Boolean | True : プレゼンテーション モードでスライドをスキップします。 |
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
unlink()
現在の Slide
とそのソース スライドのリンクを解除します。このスライドがリンクされていない場合は、変更を加えずに戻ります。
const currentPresentation = SlidesApp.getActivePresentation(); const sourcePresentation = SlidesApp.openById('sourcePresentationId'); const sourceSlide = sourcePresentation.getSlides()[0]; const linkedSlide = currentPresentation.append( sourceSlide, SlidesApp.SlideLinkingMode.LINKED, ); linkedSlide.unlink(); linkedSlide.getSourcePresentationId(); // returns null linkedSlide.getSourceSlideObjectId(); // returns null linkedSlide .getSlideLinkingMode(); // returns SlidesApp.SlideLinkingMode.NOT_LINKED
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations