Um slide em uma apresentação.
Essas páginas contêm o conteúdo que você apresenta para o público. A maioria dos slides é baseada em um mestre e um layout. Você pode especificar qual layout usar para cada slide quando ele for criado.
Métodos
Método | Tipo de retorno | Breve descrição |
---|---|---|
duplicate() | Slide | Duplica o slide. |
getBackground() | PageBackground | Extrai o plano de fundo da página. |
getColorScheme() | ColorScheme | Recebe o ColorScheme associado à página. |
getGroups() | Group[] | Retorna a lista de objetos Group na página. |
getImages() | Image[] | Retorna a lista de objetos Image na página. |
getLayout() | Layout | Recebe o layout em que o slide se baseia ou null se não for baseado em um
layout. |
getLines() | Line[] | Retorna a lista de objetos Line na página. |
getNotesPage() | NotesPage | Retorna a página de notas associada ao slide. |
getObjectId() | String | Recebe o ID exclusivo da página. |
getPageElementById(id) | PageElement | Retorna PageElement na página com o ID fornecido ou null se não houver nenhum. |
getPageElements() | PageElement[] | Retorna a lista de objetos PageElement renderizados na página. |
getPageType() | PageType | Extrai o tipo da página. |
getPlaceholder(placeholderType) | PageElement | Retorna o objeto PageElement do marcador de posição para um PlaceholderType ou null especificado se um marcador correspondente não estiver presente. |
getPlaceholder(placeholderType, placeholderIndex) | PageElement | Retorna o objeto PageElement do marcador de posição para um PlaceholderType especificado e um índice de marcador ou null se o marcador não estiver presente. |
getPlaceholders() | PageElement[] | Retorna a lista de objetos PageElement de marcadores na página. |
getShapes() | Shape[] | Retorna a lista de objetos Shape na página. |
getSheetsCharts() | SheetsChart[] | Retorna a lista de objetos SheetsChart na página. |
getSlideLinkingMode() | SlideLinkingMode | Retorna um SlideLinkingMode que indica se o slide está vinculado a outro slide. |
getSourcePresentationId() | String | Retorna o ID Presentation de origem ou null se o slide não estiver vinculado. |
getSourceSlideObjectId() | String | Retorna o ID do slide de origem ou null se o slide não estiver vinculado. |
getTables() | Table[] | Retorna a lista de objetos Table na página. |
getVideos() | Video[] | Retorna a lista de objetos Video na página. |
getWordArts() | WordArt[] | Retorna a lista de objetos WordArt na página. |
group(pageElements) | Group | Agrupa todos os elementos de página especificados. |
insertGroup(group) | Group | Insere uma cópia do Group fornecido na página. |
insertImage(blobSource) | Image | Insere uma imagem no canto superior esquerdo da página com um tamanho padrão do blob de imagem especificado. |
insertImage(blobSource, left, top, width, height) | Image | Insere uma imagem na página com a posição e o tamanho fornecidos do blob de imagem especificado. |
insertImage(image) | Image | Insere uma cópia do Image fornecido na página. |
insertImage(imageUrl) | Image | Insere uma imagem no canto superior esquerdo da página com um tamanho padrão do URL fornecido. |
insertImage(imageUrl, left, top, width, height) | Image | Insere uma imagem na página com a posição e o tamanho fornecidos do URL informado. |
insertLine(line) | Line | Insere uma cópia do Line fornecido na página. |
insertLine(lineCategory, startConnectionSite, endConnectionSite) | Line | Insere uma linha na página conectando duas connection sites . |
insertLine(lineCategory, startLeft, startTop, endLeft, endTop) | Line | Insere uma linha na página. |
insertPageElement(pageElement) | PageElement | Insere uma cópia do PageElement fornecido na página. |
insertShape(shape) | Shape | Insere uma cópia do Shape fornecido na página. |
insertShape(shapeType) | Shape | Insere uma forma na página. |
insertShape(shapeType, left, top, width, height) | Shape | Insere uma forma na página. |
insertSheetsChart(sourceChart) | SheetsChart | Insere um gráfico do Planilhas Google na página. |
insertSheetsChart(sourceChart, left, top, width, height) | SheetsChart | Insere um gráfico do Planilhas Google na página com a posição e o tamanho fornecidos. |
insertSheetsChart(sheetsChart) | SheetsChart | Insere uma cópia do SheetsChart fornecido na página. |
insertSheetsChartAsImage(sourceChart) | Image | Insere um gráfico do Planilhas Google como Image na página. |
insertSheetsChartAsImage(sourceChart, left, top, width, height) | Image | Insere um gráfico do Planilhas Google como um Image na página com a posição e o tamanho fornecidos. |
insertTable(numRows, numColumns) | Table | Insere uma tabela na página. |
insertTable(numRows, numColumns, left, top, width, height) | Table | Insere uma tabela na página com a posição e o tamanho fornecidos. |
insertTable(table) | Table | Insere uma cópia do Table fornecido na página. |
insertTextBox(text) | Shape | Insere na página uma caixa de texto Shape contendo a string fornecida. |
insertTextBox(text, left, top, width, height) | Shape | Insere na página uma caixa de texto Shape contendo a string fornecida. |
insertVideo(videoUrl) | Video | Insere um vídeo no canto superior esquerdo da página com um tamanho padrão. |
insertVideo(videoUrl, left, top, width, height) | Video | Insere um vídeo na página com a posição e o tamanho fornecidos. |
insertVideo(video) | Video | Insere uma cópia do Video fornecido na página. |
insertWordArt(wordArt) | WordArt | Insere uma cópia do WordArt fornecido na página. |
isSkipped() | Boolean | Informa se o slide é ignorado no modo de apresentação. |
move(index) | void | Move o slide para o índice especificado. |
refreshSlide() | void | Atualiza o slide para refletir as alterações feitas no slide de origem vinculado. |
remove() | void | Remove a página. |
replaceAllText(findText, replaceText) | Integer | Substitui todas as instâncias do texto correspondente ao texto de substituição pelo texto de substituição. |
replaceAllText(findText, replaceText, matchCase) | Integer | Substitui todas as instâncias do texto correspondente ao texto de substituição pelo texto de substituição. |
selectAsCurrentPage() | void | Seleciona o Page na apresentação ativa como o current page selection e remove qualquer seleção anterior. |
setSkipped(isSkipped) | void | Define se o slide será ignorado no modo de apresentação. |
unlink() | void | Desvincula o Slide atual do slide de origem. |
Documentação detalhada
duplicate()
Duplica o slide.
O slide duplicado é criado imediatamente após o original.
Retorno
Slide
: o slide duplicado.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getBackground()
Extrai o plano de fundo da página.
Retorno
PageBackground
: plano de fundo da página.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getColorScheme()
Recebe o ColorScheme
associado à página.
Retorno
ColorScheme
: o esquema de cores da página.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getGroups()
getImages()
getLayout()
Recebe o layout em que o slide se baseia ou null
se não for baseado em um
layout.
Retorno
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getLines()
getNotesPage()
getObjectId()
Recebe o ID exclusivo da página. Os IDs de objeto usados por páginas e elementos de página compartilham o mesmo namespace.
Retorno
String
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getPageElementById(id)
Retorna PageElement
na página com o ID fornecido ou null
se não houver nenhum.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
id | String | O ID do elemento de página que está sendo recuperado. |
Retorno
PageElement
: o elemento de página com o ID fornecido.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getPageElements()
Retorna a lista de objetos PageElement
renderizados na página.
Retorno
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getPageType()
getPlaceholder(placeholderType)
Retorna o objeto PageElement
do marcador de posição para um PlaceholderType
ou null
especificado se um marcador correspondente não estiver presente.
Se houver vários marcadores de posição com o mesmo tipo, ele vai retornar aquele com índice mínimo de marcador. Se houver vários marcadores correspondentes com o mesmo índice, ele vai retornar o primeiro marcador da coleção de elementos de página da página.
var slide = SlidesApp.getActivePresentation().getSlides()[0]; var placeholder = slide.getPlaceholder(SlidesApp.PlaceholderType.CENTERED_TITLE);
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
placeholderType | PlaceholderType |
Retorno
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getPlaceholder(placeholderType, placeholderIndex)
Retorna o objeto PageElement
do marcador de posição para um PlaceholderType
especificado e um índice de marcador ou null
se o marcador não estiver presente.
Se houver vários marcadores com o mesmo tipo e índice, ele vai retornar o primeiro marcador da coleção de elementos de página da página.
var slide = SlidesApp.getActivePresentation().getSlides()[0]; var placeholder = slide.getPlaceholder(SlidesApp.PlaceholderType.CENTERED_TITLE, 0);
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
placeholderType | PlaceholderType | |
placeholderIndex | Integer |
Retorno
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getPlaceholders()
Retorna a lista de objetos PageElement
de marcadores na página.
var master = SlidesApp.getActivePresentation().getMasters()[0]; Logger.log('Number of placeholders in the master: ' + master.getPlaceholders().length);
Retorno
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getShapes()
getSheetsCharts()
Retorna a lista de objetos SheetsChart
na página.
Retorno
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getSlideLinkingMode()
Retorna um SlideLinkingMode
que indica se o slide está vinculado a outro slide.
Retorno
SlideLinkingMode
: o modo de vinculação de slides.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getSourcePresentationId()
Retorna o ID Presentation
de origem ou null
se o slide não estiver vinculado.
Um slide só tem um ID Presentation
de origem quando está vinculado a um slide de
outra apresentação.
Retorno
String
: o ID da apresentação de origem, ou null
.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getSourceSlideObjectId()
Retorna o ID do slide de origem ou null
se o slide não estiver vinculado.
Um slide só tem um ID de origem quando está vinculado a um slide de outra apresentação.
Retorno
String
: o ID do slide de origem ou null
.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getTables()
getVideos()
getWordArts()
group(pageElements)
Agrupa todos os elementos de página especificados.
É preciso que haja pelo menos dois elementos na mesma página que ainda não estejam em outro
grupo. Alguns elementos de página, como Videos
, Tables
e placeholder Shapes
, não podem ser agrupados.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
pageElements | PageElement[] | Os elementos a serem agrupados. |
Retorno
Group
: o novo grupo.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertGroup(group)
Insere uma cópia do Group
fornecido na página.
A posição do elemento inserido nesta página é determinada com base na posição do elemento de origem na respectiva página.
Se o elemento fornecido for um marcador que está sendo copiado da apresentação atual, as propriedades herdadas das páginas principais ou de layout também herdam o elemento inserido.
Se o elemento fornecido for um marcador que está sendo copiado de uma apresentação diferente, as propriedades herdadas das páginas principais ou de layout são copiadas para o elemento da apresentação de origem.
// 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.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
group | Group | O grupo a ser copiado e inserido. |
Retorno
Group
: o grupo inserido.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertImage(blobSource)
Insere uma imagem no canto superior esquerdo da página com um tamanho padrão do blob de imagem especificado.
A inserção da imagem faz com que ela seja buscada do BlobSource
uma vez, e uma cópia é armazenada para
exibição dentro da apresentação. As imagens precisam ter menos de 50 MB, não podem exceder 25
megapixels e precisam estar nos formatos PNG, JPEG ou GIF.
var slide = SlidesApp.getActivePresentation().getSlides()[0]; // Get the Drive image file with the given ID. var image = DriveApp.getFileById(fileId); slide.insertImage(image);
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
blobSource | BlobSource | Dados da imagem. |
Retorno
Image
: a imagem inserida.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertImage(blobSource, left, top, width, height)
Insere uma imagem na página com a posição e o tamanho fornecidos do blob de imagem especificado.
A imagem é buscada no BlobSource
fornecido uma vez no momento da inserção, e uma cópia
é armazenada para exibição dentro da apresentação. As imagens precisam ter menos de 50 MB, não podem
exceder 25 megapixels e precisam estar nos formatos PNG, JPEG ou GIF.
Para manter a proporção, a imagem é dimensionada e centralizada em relação ao tamanho fornecido.
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);
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
blobSource | BlobSource | Dados da imagem. |
left | Number | É a posição horizontal da imagem em pontos, medida a partir do canto superior esquerdo da página. |
top | Number | É a posição vertical da imagem em pontos, medida a partir do canto superior esquerdo da página. |
width | Number | A largura da imagem em pontos. |
height | Number | A altura da imagem em pontos. |
Retorno
Image
: a imagem inserida.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertImage(image)
Insere uma cópia do Image
fornecido na página.
A posição das imagens inseridas nesta página é determinada com base na posição da imagem de origem na respectiva página.
Se a imagem fornecida for um marcador de posição que está sendo copiado da apresentação atual, as propriedades herdadas das páginas mestre ou de layout também herdam a imagem inserida.
Se a imagem fornecida for um marcador de posição copiado de uma apresentação diferente, as propriedades herdadas das páginas principais ou de layout serão copiadas para a imagem da apresentação de origem. Se a imagem do marcador de posição copiada estiver vazia, nada será inserido na apresentação de destino.
// 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);
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
image | Image | A imagem a ser copiada e inserida. |
Retorno
Image
: a imagem inserida.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertImage(imageUrl)
Insere uma imagem no canto superior esquerdo da página com um tamanho padrão do URL fornecido.
A inserção da imagem faz com que ela seja buscada no URL uma vez, e uma cópia é armazenada para exibição dentro da apresentação. As imagens precisam ter menos de 50 MB, não podem exceder 25 megapixels e precisam estar nos formatos PNG, JPEG ou GIF.
O URL fornecido precisa ser acessível publicamente e não pode ter mais de 2 KB. O URL em si é salvo
com a imagem e exposto por Image.getSourceUrl()
.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
imageUrl | String | O URL da imagem. |
Retorno
Image
: a imagem inserida.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertImage(imageUrl, left, top, width, height)
Insere uma imagem na página com a posição e o tamanho fornecidos do URL informado.
A inserção da imagem faz com que ela seja buscada no URL uma vez, e uma cópia é armazenada para exibição dentro da apresentação. As imagens precisam ter menos de 50 MB, não podem exceder 25 megapixels e precisam estar nos formatos PNG, JPEG ou GIF.
O URL fornecido precisa ser acessível publicamente e não pode ter mais de 2 KB. O URL em si é salvo
com a imagem e exposto por Image.getSourceUrl()
.
Para manter a proporção, a imagem é dimensionada e centralizada em relação ao tamanho fornecido.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
imageUrl | String | O URL da imagem. |
left | Number | É a posição horizontal da imagem em pontos, medida a partir do canto superior esquerdo da página. |
top | Number | É a posição vertical da imagem em pontos, medida a partir do canto superior esquerdo da página. |
width | Number | A largura da imagem em pontos. |
height | Number | A altura da imagem em pontos. |
Retorno
Image
: a imagem inserida.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertLine(line)
Insere uma cópia do Line
fornecido na página.
A posição do elemento inserido nesta página é determinada com base na posição do elemento de origem na respectiva página.
Se o elemento fornecido for um marcador que está sendo copiado da apresentação atual, as propriedades herdadas das páginas principais ou de layout também herdam o elemento inserido.
Se o elemento fornecido for um marcador que está sendo copiado de uma apresentação diferente, as propriedades herdadas das páginas principais ou de layout são copiadas para o elemento da apresentação de origem.
// 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);
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
line | Line | A linha a ser copiada e inserida. |
Retorno
Line
: a linha inserida.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertLine(lineCategory, startConnectionSite, endConnectionSite)
Insere uma linha na página conectando duas connection sites
. Os dois sites de conexão precisam estar nesta página.
// 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]);
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
lineCategory | LineCategory | A categoria da linha a ser inserida. |
startConnectionSite | ConnectionSite | O local de conexão ao qual o início da linha deve ser conectado. |
endConnectionSite | ConnectionSite | O local de conexão ao qual o fim da linha deve ser conectado. |
Retorno
Line
: a linha inserida.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertLine(lineCategory, startLeft, startTop, endLeft, endTop)
Insere uma linha na página.
// 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);
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
lineCategory | LineCategory | A categoria da linha a ser inserida. |
startLeft | Number | A posição horizontal do ponto inicial da linha, medida em pontos do canto superior esquerdo da página. |
startTop | Number | A posição vertical do ponto inicial da linha, medida em pontos do canto superior esquerdo da página. |
endLeft | Number | A posição horizontal do ponto final da linha, medida em pontos a partir do canto superior esquerdo da página. |
endTop | Number | A posição vertical do ponto final da linha, medida em pontos do canto superior esquerdo da página. |
Retorno
Line
: a linha inserida.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertPageElement(pageElement)
Insere uma cópia do PageElement
fornecido na página.
A posição do elemento inserido nesta página é determinada com base na posição do elemento de origem na respectiva página.
Se o elemento fornecido for um marcador que está sendo copiado da apresentação atual, as propriedades herdadas das páginas principais ou de layout também herdam o elemento inserido.
Se o elemento fornecido for um marcador que está sendo copiado de uma apresentação diferente, as propriedades herdadas das páginas principais ou de layout são copiadas para o elemento da apresentação de origem.
// 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);
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
pageElement | PageElement | O elemento de página a ser copiado e inserido. |
Retorno
PageElement
: o elemento de página inserido.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertShape(shape)
Insere uma cópia do Shape
fornecido na página.
A posição do elemento inserido nesta página é determinada com base na posição do elemento de origem na respectiva página.
Se o elemento fornecido for um marcador que está sendo copiado da apresentação atual, as propriedades herdadas das páginas principais ou de layout também herdam o elemento inserido.
Se o elemento fornecido for um marcador que está sendo copiado de uma apresentação diferente, as propriedades herdadas das páginas principais ou de layout são copiadas para o elemento da apresentação de origem.
// 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.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
shape | Shape | A forma a ser copiada e inserida. |
Retorno
Shape
: a forma inserida.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertShape(shapeType)
Insere uma forma na página.
A forma é inserida com um tamanho padrão no canto superior esquerdo da página.
// 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);
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
shapeType | ShapeType | O tipo de forma a ser inserida. |
Retorno
Shape
: a forma inserida.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertShape(shapeType, left, top, width, height)
Insere uma forma na página.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
shapeType | ShapeType | O tipo de forma a ser inserida. |
left | Number | Posição horizontal da forma, medida do canto superior esquerdo da página. |
top | Number | A posição vertical da forma, medida do canto superior esquerdo da página. |
width | Number | A largura do formato. |
height | Number | A altura do formato. |
Retorno
Shape
: a forma inserida.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertSheetsChart(sourceChart)
Insere um gráfico do Planilhas Google na página.
O gráfico é inserido com um tamanho padrão no canto superior esquerdo da página.
O gráfico inserido é vinculado ao gráfico de origem do Planilhas Google, o que permite que ele seja atualizado. Outros colaboradores podem ver o link para a planilha de origem.
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);
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
sourceChart | EmbeddedChart | O gráfico em uma planilha a ser inserido na página. |
Retorno
SheetsChart
: o gráfico inserido na página.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertSheetsChart(sourceChart, left, top, width, height)
Insere um gráfico do Planilhas Google na página com a posição e o tamanho fornecidos.
Para manter a proporção, o gráfico é dimensionado e centralizado em relação ao tamanho fornecido.
O gráfico inserido é vinculado ao gráfico de origem do Planilhas Google, o que permite que ele seja atualizado. Outros colaboradores podem ver o link para a planilha de origem.
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);
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
sourceChart | EmbeddedChart | O gráfico em uma planilha a ser inserido na página. |
left | Number | A posição horizontal do gráfico em pontos, medida a partir do canto superior esquerdo da página. |
top | Number | A posição vertical do gráfico em pontos, medida a partir do canto superior esquerdo da página. |
width | Number | A largura do gráfico em pontos. |
height | Number | A altura do gráfico em pontos. |
Retorno
SheetsChart
: o gráfico inserido na página.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertSheetsChart(sheetsChart)
Insere uma cópia do SheetsChart
fornecido na página.
A posição do elemento inserido nesta página é determinada com base na posição do elemento de origem na respectiva página.
Se o elemento fornecido for um marcador que está sendo copiado da apresentação atual, as propriedades herdadas das páginas principais ou de layout também herdam o elemento inserido.
Se o elemento fornecido for um marcador que está sendo copiado de uma apresentação diferente, as propriedades herdadas das páginas principais ou de layout são copiadas para o elemento da apresentação de origem.
// 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);
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
sheetsChart | SheetsChart | O gráfico de planilhas a ser copiado e inserido. |
Retorno
SheetsChart
: o gráfico de páginas inserido.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertSheetsChartAsImage(sourceChart)
Insere um gráfico do Planilhas Google como Image
na página.
A imagem do gráfico é inserida com um tamanho padrão no canto superior esquerdo da página.
A imagem do gráfico inserida não está vinculada ao gráfico de origem do Planilhas 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.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
sourceChart | EmbeddedChart | O gráfico em uma planilha a ser inserido na página. |
Retorno
Image
: a imagem inserida do gráfico na página.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertSheetsChartAsImage(sourceChart, left, top, width, height)
Insere um gráfico do Planilhas Google como um Image
na página com a posição e o tamanho fornecidos.
Para manter a proporção da imagem do gráfico, ela é dimensionada e centralizada em relação ao tamanho fornecido.
A imagem inserida do gráfico não está vinculada ao gráfico de origem do Planilhas 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);
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
sourceChart | EmbeddedChart | O gráfico em uma planilha a ser inserido na página. |
left | Number | A posição horizontal do gráfico em pontos, medida a partir do canto superior esquerdo da página. |
top | Number | A posição vertical do gráfico em pontos, medida a partir do canto superior esquerdo da página. |
width | Number | A largura do gráfico em pontos. |
height | Number | A altura do gráfico em pontos. |
Retorno
Image
: a imagem inserida do gráfico na página.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertTable(numRows, numColumns)
Insere uma tabela na página.
A tabela é centralizada na página com o tamanho padrão e linhas e colunas distribuídas de maneira uniforme.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
numRows | Integer | O número de linhas na tabela. |
numColumns | Integer | O número de colunas na tabela. |
Retorno
Table
: a tabela inserida.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertTable(numRows, numColumns, left, top, width, height)
Insere uma tabela na página com a posição e o tamanho fornecidos.
As linhas e colunas são distribuídas uniformemente na tabela criada.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
numRows | Integer | O número de linhas na tabela. |
numColumns | Integer | O número de colunas na tabela. |
left | Number | Posição horizontal da tabela, medida no canto superior esquerdo da página. |
top | Number | A posição vertical da tabela, medida do canto superior esquerdo da página. |
width | Number | A largura da tabela. |
height | Number | A altura mínima da tabela. A altura real da tabela renderizada depende de fatores como o tamanho da fonte do texto. |
Retorno
Table
: a tabela inserida.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertTable(table)
Insere uma cópia do Table
fornecido na página.
A posição do elemento inserido nesta página é determinada com base na posição do elemento de origem na respectiva página.
Se o elemento fornecido for um marcador que está sendo copiado da apresentação atual, as propriedades herdadas das páginas principais ou de layout também herdam o elemento inserido.
Se o elemento fornecido for um marcador que está sendo copiado de uma apresentação diferente, as propriedades herdadas das páginas principais ou de layout são copiadas para o elemento da apresentação de origem.
// 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.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
table | Table | A tabela a ser copiada e inserida. |
Retorno
Table
: a tabela inserida.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertTextBox(text)
Insere na página uma caixa de texto Shape
contendo a string fornecida.
A forma da caixa de texto é inserida com um tamanho padrão no canto superior esquerdo da página.
// 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.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
text | String | É a string que a forma da caixa de texto deve conter. |
Retorno
Shape
: a forma da caixa de texto inserida.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertTextBox(text, left, top, width, height)
Insere na página uma caixa de texto Shape
contendo a string fornecida.
// 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.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
text | String | É a string que a forma da caixa de texto deve conter. |
left | Number | Posição horizontal da forma da caixa de texto, medida no canto superior esquerdo da página. |
top | Number | Posição vertical da forma da caixa de texto, medida no canto superior esquerdo da página. |
width | Number | É a largura da forma da caixa de texto. |
height | Number | É a altura da forma da caixa de texto. |
Retorno
Shape
: a forma da caixa de texto inserida.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertVideo(videoUrl)
Insere um vídeo no canto superior esquerdo da página com um tamanho padrão.
No momento, só aceitamos vídeos do YouTube.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
videoUrl | String | O URL do vídeo a ser inserido. |
Retorno
Video
— O vídeo inserido.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertVideo(videoUrl, left, top, width, height)
Insere um vídeo na página com a posição e o tamanho fornecidos.
No momento, só aceitamos vídeos do YouTube.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
videoUrl | String | O URL do vídeo a ser inserido. |
left | Number | É a posição horizontal do vídeo em pontos, medida a partir do canto superior esquerdo da página. |
top | Number | É a posição vertical do vídeo em pontos, medida a partir do canto superior esquerdo da página. |
width | Number | A largura do vídeo em pontos. |
height | Number | A altura do vídeo em pontos. |
Retorno
Video
— O vídeo inserido.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertVideo(video)
Insere uma cópia do Video
fornecido na página.
A posição do elemento inserido nesta página é determinada com base na posição do elemento de origem na respectiva página.
Se o elemento fornecido for um marcador que está sendo copiado da apresentação atual, as propriedades herdadas das páginas principais ou de layout também herdam o elemento inserido.
Se o elemento fornecido for um marcador que está sendo copiado de uma apresentação diferente, as propriedades herdadas das páginas principais ou de layout são copiadas para o elemento da apresentação de origem.
// 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.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
video | Video | O vídeo a ser copiado e inserido. |
Retorno
Video
— O vídeo inserido.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertWordArt(wordArt)
Insere uma cópia do WordArt
fornecido na página.
A posição do elemento inserido nesta página é determinada com base na posição do elemento de origem na respectiva página.
Se o elemento fornecido for um marcador que está sendo copiado da apresentação atual, as propriedades herdadas das páginas principais ou de layout também herdam o elemento inserido.
Se o elemento fornecido for um marcador que está sendo copiado de uma apresentação diferente, as propriedades herdadas das páginas principais ou de layout são copiadas para o elemento da apresentação de origem.
// 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);
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
wordArt | WordArt | O grupo a ser copiado e inserido. |
Retorno
WordArt
: a word art inserida.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
isSkipped()
Informa se o slide é ignorado no modo de apresentação.
Retorno
Boolean
: True
se o slide for ignorado no modo de apresentação.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
move(index)
Move o slide para o índice especificado.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
index | Integer | O índice para onde o slide será movido, com base na organização dos slides antes da movimentação. O índice precisa estar entre zero e o número de slides da apresentação. |
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
refreshSlide()
Atualiza o slide para refletir as alterações feitas no slide de origem vinculado. Se este slide não estiver vinculado, ele retornará sem fazer alterações.
O método refreshSlide
copia as páginas mestre e de layout correspondentes do slide de origem vinculada para a apresentação do slide, se elas ainda não existirem. Se já existirem, eles serão
atualizados para refletir as mudanças feitas na origem.
var currentPresentation = SlidesApp.getActivePresentation(); var sourcePresentation = SlidesApp.openById('sourcePresentationId'); var sourceSlide = sourcePresentation.getSlides()[0]; var 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.
Gera
Error
: se o acesso de leitura à apresentação original não estiver mais disponível.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
remove()
Remove a página.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replaceAllText(findText, replaceText)
Substitui todas as instâncias do texto correspondente ao texto de substituição pelo texto de substituição. A pesquisa não diferencia maiúsculas de minúsculas.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
findText | String | O texto a ser encontrado. |
replaceText | String | O texto para substituir o texto correspondente. |
Retorno
Integer
: o número de ocorrências alteradas
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replaceAllText(findText, replaceText, matchCase)
Substitui todas as instâncias do texto correspondente ao texto de substituição pelo texto de substituição.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
findText | String | O texto a ser encontrado. |
replaceText | String | O texto para substituir o texto correspondente. |
matchCase | Boolean | Se true , a pesquisa diferencia maiúsculas de minúsculas. Se false , ela não diferencia maiúsculas de minúsculas. |
Retorno
Integer
: o número de ocorrências alteradas
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
selectAsCurrentPage()
Seleciona o Page
na apresentação ativa como o current page selection
e remove qualquer seleção anterior.
Um script só pode acessar a seleção do usuário que está executando o script e apenas se ele estiver vinculado à apresentação.
// 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.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setSkipped(isSkipped)
Define se o slide será ignorado no modo de apresentação.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
isSkipped | Boolean | True para pular o slide no modo de apresentação. |
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
unlink()
Desvincula o Slide
atual do slide de origem. Se este slide não estiver vinculado, retornará
sem fazer alterações.
var currentPresentation = SlidesApp.getActivePresentation(); var sourcePresentation = SlidesApp.openById('sourcePresentationId'); var sourceSlide = sourcePresentation.getSlides()[0]; var linkedSlide = currentPresentation.append(sourceSlide, SlidesApp.SlideLinkingMode.LINKED); linkedSlide.unlink(); linkedSlide.getSourcePresentationId(); // returns null linkedSlide.getSourceSlideObjectId(); // returns null linkedSlide.getSlideLinkingMode(); // returns SlidesApp.SlideLinkingMode.NOT_LINKED
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations