Stay organized with collections Save and categorize content based on your preferences.
LayoutA layout in a presentation.
Each layout serves as a template for slides that inherit from it, determining how content on those slides is arranged and styled.
Methods Method Return type Brief descriptiongetBackground() PageBackground Gets the page's background. getColorScheme() ColorScheme Gets the ColorScheme associated with the page. getGroups() Group[] Returns the list of Group objects on the page. getImages() Image[] Returns the list of Image objects on the page. getLayoutName() String Gets the name of the layout. getLines() Line[] Returns the list of Line objects on the page. getMaster() Master Gets the master that the layout is based on. getObjectId() String Gets the unique ID for the page. getPageElementById(id) PageElement Returns the PageElement on the page with the given ID, or null if none exists. getPageElements() PageElement[] Returns the list of PageElement objects rendered on the page. getPageType() PageType Gets the type of the page. getPlaceholder(placeholderType) PageElement Returns the placeholder PageElement object for a specified PlaceholderType or null if a matching placeholder is not present. getPlaceholder(placeholderType, placeholderIndex) PageElement Returns the placeholder PageElement object for a specified PlaceholderType and a placeholder index, or null if the placeholder is not present. getPlaceholders() PageElement[] Returns the list of placeholder PageElement objects in the page. getShapes() Shape[] Returns the list of Shape objects on the page. getSheetsCharts() SheetsChart[] Returns the list of SheetsChart objects on the page. getTables() Table[] Returns the list of Table objects on the page. getVideos() Video[] Returns the list of Video objects on the page. getWordArts() WordArt[] Returns the list of WordArt objects on the page. group(pageElements) Group Groups all the specified page elements. insertGroup(group) Group Inserts a copy of the provided Group on the page. insertImage(blobSource) Image Inserts an image at the top left corner of the page with a default size from the specified image blob. insertImage(blobSource, left, top, width, height) Image Inserts an image on the page with the provided position and size from the specified image blob. insertImage(image) Image Inserts a copy of the provided Image on the page. insertImage(imageUrl) Image Inserts an image at the top left corner of the page with a default size from the provided URL. insertImage(imageUrl, left, top, width, height) Image Inserts an image on the page with the provided position and size from the provided URL. insertLine(line) Line Inserts a copy of the provided Line on the page. insertLine(lineCategory, startConnectionSite, endConnectionSite) Line Inserts a line on the page connecting two connection sites. insertLine(lineCategory, startLeft, startTop, endLeft, endTop) Line Inserts a line on the page. insertPageElement(pageElement) PageElement Inserts a copy of the provided PageElement on the page. insertShape(shape) Shape Inserts a copy of the provided Shape on the page. insertShape(shapeType) Shape Inserts a shape on the page. insertShape(shapeType, left, top, width, height) Shape Inserts a shape on the page. insertSheetsChart(sourceChart) SheetsChart Inserts a Google Sheets chart on the page. insertSheetsChart(sourceChart, left, top, width, height) SheetsChart Inserts a Google Sheets chart on the page with the provided position and size. insertSheetsChart(sheetsChart) SheetsChart Inserts a copy of the provided SheetsChart on the page. insertSheetsChartAsImage(sourceChart) Image Inserts a Google Sheets chart as an Image on the page. insertSheetsChartAsImage(sourceChart, left, top, width, height) Image Inserts a Google Sheets chart as an Image on the page with the provided position and size. insertTable(numRows, numColumns) Table Inserts a table on the page. insertTable(numRows, numColumns, left, top, width, height) Table Inserts a table on the page with the provided position and size. insertTable(table) Table Inserts a copy of the provided Table on the page. insertTextBox(text) Shape Inserts a text box Shape containing the provided string on the page. insertTextBox(text, left, top, width, height) Shape Inserts a text box Shape containing the provided string on the page. insertVideo(videoUrl) Video Inserts a video at the top left corner of the page with a default size. insertVideo(videoUrl, left, top, width, height) Video Inserts a video on the page with the provided position and size. insertVideo(video) Video Inserts a copy of the provided Video on the page. insertWordArt(wordArt) WordArt Inserts a copy of the provided WordArt on the page. remove() void Removes the page. replaceAllText(findText, replaceText) Integer Replaces all instances of text matching find text with replace text. replaceAllText(findText, replaceText, matchCase) Integer Replaces all instances of text matching find text with replace text. selectAsCurrentPage() void Selects the Page in the active presentation as the current page selection and removes any previous selection. Detailed documentation getBackground()
Gets the page's background.
ReturnPageBackground — The page's background.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsgetColorScheme()
Gets the ColorScheme associated with the page.
ColorScheme — The page's color scheme.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsgetGroups()
Returns the list of Group objects on the page.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsgetImages()
Returns the list of Image objects on the page.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsgetLayoutName()
Gets the name of the layout.
ReturnString
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsgetLines()
Returns the list of Line objects on the page.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsgetMaster()
Gets the master that the layout is based on.
Return AuthorizationScripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsgetObjectId()
Gets the unique ID for the page. Object IDs used by pages and page elements share the same namespace.
ReturnString
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsgetPageElementById(id)
Returns the PageElement on the page with the given ID, or null if none exists.
id String The ID of the page element that is being retrieved. Return
PageElement — The page element with the given ID.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsgetPageElements()
Returns the list of PageElement objects rendered on the page.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsgetPageType()
Gets the type of the page.
ReturnPageType — The page type.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsgetPlaceholder(placeholderType)
Returns the placeholder PageElement object for a specified PlaceholderType or null if a matching placeholder is not present.
If there are multiple placeholders with the same type, it returns the one with minimal placeholder index. If there are multiple matching placeholders with the same index, it returns the first placeholder from the page's page elements collection.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
const placeholder = slide.getPlaceholder(
SlidesApp.PlaceholderType.CENTERED_TITLE,
); Parameters Return
Authorization
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsgetPlaceholder(placeholderType, placeholderIndex)
Returns the placeholder PageElement object for a specified PlaceholderType and a placeholder index, or null if the placeholder is not present.
If there are multiple placeholders with the same type and index, it returns the first placeholder from the page's page elements collection.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
const placeholder = slide.getPlaceholder(
SlidesApp.PlaceholderType.CENTERED_TITLE,
0,
); Parameters Name Type Description placeholderType PlaceholderType placeholderIndex Integer Return
Authorization
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsgetPlaceholders()
Returns the list of placeholder PageElement objects in the page.
const master = SlidesApp.getActivePresentation().getMasters()[0];
Logger.log(
`Number of placeholders in the master: ${master.getPlaceholders().length}`,
); Return
Authorization
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsgetShapes()
Returns the list of Shape objects on the page.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsgetSheetsCharts()
Returns the list of SheetsChart objects on the page.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsgetTables()
Returns the list of Table objects on the page.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsgetVideos()
Returns the list of Video objects on the page.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsgetWordArts()
Returns the list of WordArt objects on the page.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsgroup(pageElements)
Groups all the specified page elements.
There should be at least two page elements on the same page that are not already in another group. Some page elements, such as Videos, Tables and placeholder Shapes cannot be grouped.
pageElements PageElement[] The elements to group together. Return
Group — The new group.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsinsertGroup(group)
Inserts a copy of the provided Group on the page.
The inserted element's position on this page is determined from the source element's position on its respective page.
If the provided element is a placeholder being copied from within the current presentation, properties that inherit from master or layout pages also inherit on the inserted element.
If the provided element is a placeholder being copied from a different presentation, properties that inherit from master or layout pages are copied onto the element from the source presentation.
// 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. Parameters Name Type Description group Group The group to be copied and inserted. Return
Group — The inserted group.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsinsertImage(blobSource)
Inserts an image at the top left corner of the page with a default size from the specified image blob.
Inserting the image fetches it from the BlobSource once and a copy is stored for display inside the presentation. Images must be less than 50MB in size, cannot exceed 25 megapixels, and must be in either in PNG, JPEG, or GIF format.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
// Get the Drive image file with the given ID.
const image = DriveApp.getFileById('123abc');
slide.insertImage(image); Parameters Name Type Description blobSource BlobSource The image data. Return
Image — The inserted image.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsinsertImage(blobSource, left, top, width, height)
Inserts an image on the page with the provided position and size from the specified image blob.
The image is fetched from the provided BlobSource once at insertion time and a copy is stored for display inside the presentation. Images must be less than 50MB in size, cannot exceed 25 megapixels, and must be in either in PNG, JPEG, or GIF format.
In order to maintain the image's aspect ratio, the image is scaled and centered with respect to the provided size.
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); Parameters Name Type Description blobSource BlobSource The image data. left Number The horizontal position of the image in points, measured from the upper left corner of the page. top Number The vertical position of the image in points, measured from the upper left corner of the page. width Number The width of the image in points. height Number The height of the image in points. Return
Image — The inserted image.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsinsertImage(image)
Inserts a copy of the provided Image on the page.
The inserted images's position on this page is determined from the source image's position on its respective page.
If the provided image is a placeholder being copied from within the current presentation, properties that inherit from master or layout pages also inherit on the inserted image.
If the provided image is a placeholder being copied from a different presentation, properties that inherit from master or layout pages are copied onto the image from the source presentation. If the copied placeholder image is empty, nothing is inserted in the destination presentation.
// 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); Parameters Name Type Description image Image The image to be copied and inserted. Return
Image — The inserted image.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsinsertImage(imageUrl)
Inserts an image at the top left corner of the page with a default size from the provided URL.
Inserting the image fetches it from the URL once and a copy is stored for display inside the presentation. Images must be less than 50MB in size, cannot exceed 25 megapixels, and must be in either in PNG, JPEG, or GIF format.
The provided URL must be publicly accessible and no larger than 2kB. The URL itself is saved with the image and exposed via Image.getSourceUrl().
imageUrl String The image URL. Return
Image — The inserted image.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsinsertImage(imageUrl, left, top, width, height)
Inserts an image on the page with the provided position and size from the provided URL.
Inserting the image fetches it from the URL once and a copy is stored for display inside the presentation. Images must be less than 50MB in size, cannot exceed 25 megapixels, and must be in either in PNG, JPEG, or GIF format.
The provided URL must be publicly accessible and no larger than 2kB. The URL itself is saved with the image and exposed via Image.getSourceUrl().
In order to maintain the image's aspect ratio, the image is scaled and centered with respect to the provided size.
Parameters Name Type DescriptionimageUrl String The image URL. left Number The horizontal position of the image in points, measured from the upper left corner of the page. top Number The vertical position of the image in points, measured from the upper left corner of the page. width Number The width of the image in points. height Number The height of the image in points. Return
Image — The inserted image.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsinsertLine(line)
Inserts a copy of the provided Line on the page.
The inserted element's position on this page is determined from the source element's position on its respective page.
If the provided element is a placeholder being copied from within the current presentation, properties that inherit from master or layout pages also inherit on the inserted element.
If the provided element is a placeholder being copied from a different presentation, properties that inherit from master or layout pages are copied onto the element from the source presentation.
// 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); Parameters Name Type Description line Line The line to be copied and inserted. Return
Line — The inserted line.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsinsertLine(lineCategory, startConnectionSite, endConnectionSite)
Inserts a line on the page connecting two connection sites. The two connection sites must be on this page.
// 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],
); Parameters Name Type Description lineCategory LineCategory The category of the line to insert. startConnectionSite ConnectionSite The connection site where the start of the line is to be connected. endConnectionSite ConnectionSite The connection site where the end of the line is to be connected. Return
Line — The inserted line.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsinsertLine(lineCategory, startLeft, startTop, endLeft, endTop)
Inserts a line on the page.
// 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,
); Parameters Name Type Description lineCategory LineCategory The category of the line to insert. startLeft Number The horizontal position of the start point of the line, measured in points from the upper left corner of the page. startTop Number The vertical position of the start point of the line, measured in points from the upper left corner of the page. endLeft Number The horizontal position of the end point of the line, measured in points from the upper left corner of the page. endTop Number The vertical position of the end point of the line, measured in points from the upper left corner of the page. Return
Line — The inserted line.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsinsertPageElement(pageElement)
Inserts a copy of the provided PageElement on the page.
The inserted element's position on this page is determined from the source element's position on its respective page.
If the provided element is a placeholder being copied from within the current presentation, properties that inherit from master or layout pages also inherit on the inserted element.
If the provided element is a placeholder being copied from a different presentation, properties that inherit from master or layout pages are copied onto the element from the source presentation.
// 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); Parameters Name Type Description pageElement PageElement The page element to be copied and inserted. Return
PageElement — The inserted page element.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsinsertShape(shape)
Inserts a copy of the provided Shape on the page.
The inserted element's position on this page is determined from the source element's position on its respective page.
If the provided element is a placeholder being copied from within the current presentation, properties that inherit from master or layout pages also inherit on the inserted element.
If the provided element is a placeholder being copied from a different presentation, properties that inherit from master or layout pages are copied onto the element from the source presentation.
// 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. Parameters Name Type Description shape Shape The shape to be copied and inserted. Return
Shape — The inserted shape.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsinsertShape(shapeType)
Inserts a shape on the page.
The shape is inserted with a default size at the top left corner of the page.
// 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);Parameters Name Type Description
shapeType ShapeType The type of shape to insert. Return
Shape — The inserted shape.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsinsertShape(shapeType, left, top, width, height)
Inserts a shape on the page.
Parameters Name Type DescriptionshapeType ShapeType The type of shape to insert. left Number The horizontal position of the shape, measured from the upper left corner of the page. top Number The vertical position of the shape, measured from the upper left corner of the page. width Number The width of the shape. height Number The height of the shape. Return
Shape — The inserted shape.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsinsertSheetsChart(sourceChart)
Inserts a Google Sheets chart on the page.
The chart is inserted with a default size at the top left corner of the page.
The inserted chart is linked with the source Google Sheets chart which allows it to be updated. Other collaborators can see the link to the source spreadsheet.
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); Parameters Name Type Description sourceChart EmbeddedChart The chart in a spreadsheet to be inserted in the page. Return
SheetsChart — The inserted chart in the page.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsinsertSheetsChart(sourceChart, left, top, width, height)
Inserts a Google Sheets chart on the page with the provided position and size.
In order to maintain the chart's aspect ratio, the chart is scaled and centered with respect to the provided size.
The inserted chart is linked with the source Google Sheets chart which allows it to be updated. Other collaborators can see the link to the source spreadsheet.
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,
); Parameters Name Type Description sourceChart EmbeddedChart The chart in a spreadsheet to be inserted in the page. left Number The horizontal position of the chart in points, measured from the upper left corner of the page. top Number The vertical position of the chart in points, measured from the upper left corner of the page. width Number The width of the chart in points. height Number The height of the chart in points. Return
SheetsChart — The inserted chart in the page.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsinsertSheetsChart(sheetsChart)
Inserts a copy of the provided SheetsChart on the page.
The inserted element's position on this page is determined from the source element's position on its respective page.
If the provided element is a placeholder being copied from within the current presentation, properties that inherit from master or layout pages also inherit on the inserted element.
If the provided element is a placeholder being copied from a different presentation, properties that inherit from master or layout pages are copied onto the element from the source presentation.
// 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); Parameters Name Type Description sheetsChart SheetsChart The sheets chart to be copied and inserted. Return
SheetsChart — The inserted sheets chart.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsinsertSheetsChartAsImage(sourceChart)
Inserts a Google Sheets chart as an Image on the page.
The image of the chart is inserted with a default size at the top left corner of the page.
The inserted image of chart is not linked with the source Google Sheets chart.
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. Parameters Name Type Description sourceChart EmbeddedChart The chart in a spreadsheet to be inserted in the page. Return
Image — The inserted image of the chart in the page.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsinsertSheetsChartAsImage(sourceChart, left, top, width, height)
Inserts a Google Sheets chart as an Image on the page with the provided position and size.
In order to maintain the chart image's aspect ratio, the image is scaled and centered with respect to the provided size.
The inserted image of the chart is not linked with the source Google Sheets chart.
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,
); Parameters Name Type Description sourceChart EmbeddedChart The chart in a spreadsheet to be inserted in the page. left Number The horizontal position of the chart in points, measured from the upper left corner of the page. top Number The vertical position of the chart in points, measured from the upper left corner of the page. width Number The width of the chart in points. height Number The height of the chart in points. Return
Image — The inserted image of the chart in the page.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsinsertTable(numRows, numColumns)
Inserts a table on the page.
The table is centered on the page with default size and evenly distributed rows and columns.
Parameters Name Type DescriptionnumRows Integer The number of rows in the table. numColumns Integer The number of columns in the table. Return
Table — The inserted table.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsinsertTable(numRows, numColumns, left, top, width, height)
Inserts a table on the page with the provided position and size.
Rows and columns are evenly distributed in the created table.
Parameters Name Type DescriptionnumRows Integer The number of rows in the table. numColumns Integer The number of columns in the table. left Number The horizontal position of the table, measured from the upper left corner of the page. top Number The vertical position of the table, measured from the upper left corner of the page. width Number The width of the table. height Number The minimum height of the table. The actual height of the rendered table depends on factors such as text font size. Return
Table — The inserted table.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsinsertTable(table)
Inserts a copy of the provided Table on the page.
The inserted element's position on this page is determined from the source element's position on its respective page.
If the provided element is a placeholder being copied from within the current presentation, properties that inherit from master or layout pages also inherit on the inserted element.
If the provided element is a placeholder being copied from a different presentation, properties that inherit from master or layout pages are copied onto the element from the source presentation.
// 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. Parameters Name Type Description table Table The table to be copied and inserted. Return
Table — The inserted table.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsinsertTextBox(text)
Inserts a text box Shape containing the provided string on the page.
The text box shape is inserted with a default size at the top left corner of the page.
// 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. Parameters Name Type Description text String The string the text box shape should contain. Return
Shape — The inserted text box shape.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsinsertTextBox(text, left, top, width, height)
Inserts a text box Shape containing the provided string on the page.
// 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. Parameters Name Type Description text String The string the text box shape should contain. left Number The horizontal position of the text box shape, measured from the upper left corner of the page. top Number The vertical position of the text box shape, measured from the upper left corner of the page. width Number The width of the text box shape. height Number The height of the text box shape. Return
Shape — The inserted text box shape.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsinsertVideo(videoUrl)
Inserts a video at the top left corner of the page with a default size.
Only YouTube videos are currently supported.
Parameters Name Type DescriptionvideoUrl String The URL of the video to insert. Return
Video — The inserted video.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsinsertVideo(videoUrl, left, top, width, height)
Inserts a video on the page with the provided position and size.
Only YouTube videos are currently supported.
Parameters Name Type DescriptionvideoUrl String The URL of the video to insert. left Number The horizontal position of the video in points, measured from the upper left corner of the page. top Number The vertical position of the video in points, measured from the upper left corner of the page. width Number The width of the video in points. height Number The height of the video in points. Return
Video — The inserted video.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsinsertVideo(video)
Inserts a copy of the provided Video on the page.
The inserted element's position on this page is determined from the source element's position on its respective page.
If the provided element is a placeholder being copied from within the current presentation, properties that inherit from master or layout pages also inherit on the inserted element.
If the provided element is a placeholder being copied from a different presentation, properties that inherit from master or layout pages are copied onto the element from the source presentation.
// 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. Parameters Name Type Description video Video The video to be copied and inserted. Return
Video — The inserted video.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsinsertWordArt(wordArt)
Inserts a copy of the provided WordArt on the page.
The inserted element's position on this page is determined from the source element's position on its respective page.
If the provided element is a placeholder being copied from within the current presentation, properties that inherit from master or layout pages also inherit on the inserted element.
If the provided element is a placeholder being copied from a different presentation, properties that inherit from master or layout pages are copied onto the element from the source presentation.
// 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); Parameters Name Type Description wordArt WordArt The group to be copied and inserted. Return
WordArt — The inserted word art.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsremove()
Removes the page.
AuthorizationScripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsreplaceAllText(findText, replaceText)
Replaces all instances of text matching find text with replace text. The search is case insensitive.
Parameters Name Type DescriptionfindText String The text to find. replaceText String The text to replace the matched text. Return
Integer — the number of occurrences changed
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsreplaceAllText(findText, replaceText, matchCase)
Replaces all instances of text matching find text with replace text.
Parameters Name Type DescriptionfindText String The text to find. replaceText String The text to replace the matched text. matchCase Boolean If true, the search is case sensitive; if false, the search is case insensitive. Return
Integer — the number of occurrences changed
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsselectAsCurrentPage()
Selects the Page in the active presentation as the current page selection and removes any previous selection.
A script can only access the selection of the user who is running the script, and only if the script is bound to the presentation.
// 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.Authorization
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsExcept as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-12-03 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-12-03 UTC."],[[["The `Layout` object in Google Slides acts as a template for individual slides, defining the placement and style of elements."],["Google Apps Script provides a variety of methods to programmatically interact with and modify slide layouts."],["Developers can use these methods to access layout properties, retrieve and manipulate existing elements, and insert new content like shapes, images, and text."],["Utilizing these methods requires proper authorization with specific Google API scopes to grant access to presentations."],["By leveraging these functionalities, developers gain extensive control over slide layouts, enabling dynamic content creation and manipulation within Google Slides."]]],["A layout determines slide content and styling. Actions include retrieving elements like background, color scheme, groups, images, lines, and placeholders. You can get specific elements by type, ID, or index. Operations include inserting images from various sources, lines, shapes, tables, text boxes, videos, sheets charts, and groups. Additionally, elements can be grouped, removed, and text can be replaced. The layout allows to replace all the text in a presentation as well. Authorization scopes are required for most operations.\n"]]
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4