Class Slide

Slide

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étodoTipo de retornoBreve descrição
duplicate()SlideDuplica o slide.
getBackground()PageBackgroundExtrai o plano de fundo da página.
getColorScheme()ColorSchemeRecebe 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()LayoutRecebe 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()NotesPageRetorna a página de notas associada ao slide.
getObjectId()StringRecebe o ID exclusivo da página.
getPageElementById(id)PageElementRetorna 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()PageTypeExtrai o tipo da página.
getPlaceholder(placeholderType)PageElementRetorna 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)PageElementRetorna 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()SlideLinkingModeRetorna um SlideLinkingMode que indica se o slide está vinculado a outro slide.
getSourcePresentationId()StringRetorna o ID Presentation de origem ou null se o slide não estiver vinculado.
getSourceSlideObjectId()StringRetorna 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)GroupAgrupa todos os elementos de página especificados.
insertGroup(group)GroupInsere uma cópia do Group fornecido na página.
insertImage(blobSource)ImageInsere 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)ImageInsere uma imagem na página com a posição e o tamanho fornecidos do blob de imagem especificado.
insertImage(image)ImageInsere uma cópia do Image fornecido na página.
insertImage(imageUrl)ImageInsere uma imagem no canto superior esquerdo da página com um tamanho padrão do URL fornecido.
insertImage(imageUrl, left, top, width, height)ImageInsere uma imagem na página com a posição e o tamanho fornecidos do URL informado.
insertLine(line)LineInsere uma cópia do Line fornecido na página.
insertLine(lineCategory, startConnectionSite, endConnectionSite)LineInsere uma linha na página conectando duas connection sites.
insertLine(lineCategory, startLeft, startTop, endLeft, endTop)LineInsere uma linha na página.
insertPageElement(pageElement)PageElementInsere uma cópia do PageElement fornecido na página.
insertShape(shape)ShapeInsere uma cópia do Shape fornecido na página.
insertShape(shapeType)ShapeInsere uma forma na página.
insertShape(shapeType, left, top, width, height)ShapeInsere uma forma na página.
insertSheetsChart(sourceChart)SheetsChartInsere um gráfico do Planilhas Google na página.
insertSheetsChart(sourceChart, left, top, width, height)SheetsChartInsere um gráfico do Planilhas Google na página com a posição e o tamanho fornecidos.
insertSheetsChart(sheetsChart)SheetsChartInsere uma cópia do SheetsChart fornecido na página.
insertSheetsChartAsImage(sourceChart)ImageInsere um gráfico do Planilhas Google como Image na página.
insertSheetsChartAsImage(sourceChart, left, top, width, height)ImageInsere um gráfico do Planilhas Google como um Image na página com a posição e o tamanho fornecidos.
insertTable(numRows, numColumns)TableInsere uma tabela na página.
insertTable(numRows, numColumns, left, top, width, height)TableInsere uma tabela na página com a posição e o tamanho fornecidos.
insertTable(table)TableInsere uma cópia do Table fornecido na página.
insertTextBox(text)ShapeInsere na página uma caixa de texto Shape contendo a string fornecida.
insertTextBox(text, left, top, width, height)ShapeInsere na página uma caixa de texto Shape contendo a string fornecida.
insertVideo(videoUrl)VideoInsere um vídeo no canto superior esquerdo da página com um tamanho padrão.
insertVideo(videoUrl, left, top, width, height)VideoInsere um vídeo na página com a posição e o tamanho fornecidos.
insertVideo(video)VideoInsere uma cópia do Video fornecido na página.
insertWordArt(wordArt)WordArtInsere uma cópia do WordArt fornecido na página.
isSkipped()BooleanInforma se o slide é ignorado no modo de apresentação.
move(index)voidMove o slide para o índice especificado.
refreshSlide()voidAtualiza o slide para refletir as alterações feitas no slide de origem vinculado.
remove()voidRemove a página.
replaceAllText(findText, replaceText)IntegerSubstitui todas as instâncias do texto correspondente ao texto de substituição pelo texto de substituição.
replaceAllText(findText, replaceText, matchCase)IntegerSubstitui todas as instâncias do texto correspondente ao texto de substituição pelo texto de substituição.
selectAsCurrentPage()voidSeleciona o Page na apresentação ativa como o current page selection e remove qualquer seleção anterior.
setSkipped(isSkipped)voidDefine se o slide será ignorado no modo de apresentação.
unlink()voidDesvincula 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()

Retorna a lista de objetos Group na página.

Retorno

Group[]

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

getImages()

Retorna a lista de objetos Image na página.

Retorno

Image[]

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

getLayout()

Recebe o layout em que o slide se baseia ou null se não for baseado em um layout.

Retorno

Layout

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()

Retorna a lista de objetos Line na página.

Retorno

Line[]

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

getNotesPage()

Retorna a página de notas associada ao slide.

Retorno

NotesPage

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

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

NomeTipoDescrição
idStringO 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

PageElement[]

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()

Extrai o tipo da página.

Retorno

PageType: o tipo de 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

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

NomeTipoDescrição
placeholderTypePlaceholderType

Retorno

PageElement

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

NomeTipoDescrição
placeholderTypePlaceholderType
placeholderIndexInteger

Retorno

PageElement

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

PageElement[]

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()

Retorna a lista de objetos Shape na página.

Retorno

Shape[]

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

getSheetsCharts()

Retorna a lista de objetos SheetsChart na página.

Retorno

SheetsChart[]

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()

Retorna a lista de objetos Table na página.

Retorno

Table[]

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

getVideos()

Retorna a lista de objetos Video na página.

Retorno

Video[]

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

getWordArts()

Retorna a lista de objetos WordArt na página.

Retorno

WordArt[]

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

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

NomeTipoDescrição
pageElementsPageElement[]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

NomeTipoDescrição
groupGroupO 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

NomeTipoDescrição
blobSourceBlobSourceDados 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

NomeTipoDescrição
blobSourceBlobSourceDados da imagem.
leftNumberÉ a posição horizontal da imagem em pontos, medida a partir do canto superior esquerdo da página.
topNumberÉ a posição vertical da imagem em pontos, medida a partir do canto superior esquerdo da página.
widthNumberA largura da imagem em pontos.
heightNumberA 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

NomeTipoDescrição
imageImageA 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

NomeTipoDescrição
imageUrlStringO 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

NomeTipoDescrição
imageUrlStringO URL da imagem.
leftNumberÉ a posição horizontal da imagem em pontos, medida a partir do canto superior esquerdo da página.
topNumberÉ a posição vertical da imagem em pontos, medida a partir do canto superior esquerdo da página.
widthNumberA largura da imagem em pontos.
heightNumberA 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

NomeTipoDescrição
lineLineA 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

NomeTipoDescrição
lineCategoryLineCategoryA categoria da linha a ser inserida.
startConnectionSiteConnectionSiteO local de conexão ao qual o início da linha deve ser conectado.
endConnectionSiteConnectionSiteO 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

NomeTipoDescrição
lineCategoryLineCategoryA categoria da linha a ser inserida.
startLeftNumberA posição horizontal do ponto inicial da linha, medida em pontos do canto superior esquerdo da página.
startTopNumberA posição vertical do ponto inicial da linha, medida em pontos do canto superior esquerdo da página.
endLeftNumberA posição horizontal do ponto final da linha, medida em pontos a partir do canto superior esquerdo da página.
endTopNumberA 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

NomeTipoDescrição
pageElementPageElementO 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

NomeTipoDescrição
shapeShapeA 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

NomeTipoDescrição
shapeTypeShapeTypeO 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

NomeTipoDescrição
shapeTypeShapeTypeO tipo de forma a ser inserida.
leftNumberPosição horizontal da forma, medida do canto superior esquerdo da página.
topNumberA posição vertical da forma, medida do canto superior esquerdo da página.
widthNumberA largura do formato.
heightNumberA 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

NomeTipoDescrição
sourceChartEmbeddedChartO 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

NomeTipoDescrição
sourceChartEmbeddedChartO gráfico em uma planilha a ser inserido na página.
leftNumberA posição horizontal do gráfico em pontos, medida a partir do canto superior esquerdo da página.
topNumberA posição vertical do gráfico em pontos, medida a partir do canto superior esquerdo da página.
widthNumberA largura do gráfico em pontos.
heightNumberA 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

NomeTipoDescrição
sheetsChartSheetsChartO 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

NomeTipoDescrição
sourceChartEmbeddedChartO 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

NomeTipoDescrição
sourceChartEmbeddedChartO gráfico em uma planilha a ser inserido na página.
leftNumberA posição horizontal do gráfico em pontos, medida a partir do canto superior esquerdo da página.
topNumberA posição vertical do gráfico em pontos, medida a partir do canto superior esquerdo da página.
widthNumberA largura do gráfico em pontos.
heightNumberA 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

NomeTipoDescrição
numRowsIntegerO número de linhas na tabela.
numColumnsIntegerO 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

NomeTipoDescrição
numRowsIntegerO número de linhas na tabela.
numColumnsIntegerO número de colunas na tabela.
leftNumberPosição horizontal da tabela, medida no canto superior esquerdo da página.
topNumberA posição vertical da tabela, medida do canto superior esquerdo da página.
widthNumberA largura da tabela.
heightNumberA 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

NomeTipoDescrição
tableTableA 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

NomeTipoDescrição
textStringÉ 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

NomeTipoDescrição
textStringÉ a string que a forma da caixa de texto deve conter.
leftNumberPosição horizontal da forma da caixa de texto, medida no canto superior esquerdo da página.
topNumberPosição vertical da forma da caixa de texto, medida no canto superior esquerdo da página.
widthNumberÉ a largura da forma da caixa de texto.
heightNumberÉ 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

NomeTipoDescrição
videoUrlStringO 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

NomeTipoDescrição
videoUrlStringO URL do vídeo a ser inserido.
leftNumberÉ a posição horizontal do vídeo em pontos, medida a partir do canto superior esquerdo da página.
topNumberÉ a posição vertical do vídeo em pontos, medida a partir do canto superior esquerdo da página.
widthNumberA largura do vídeo em pontos.
heightNumberA 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

NomeTipoDescrição
videoVideoO 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

NomeTipoDescrição
wordArtWordArtO 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

NomeTipoDescrição
indexIntegerO í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

NomeTipoDescrição
findTextStringO texto a ser encontrado.
replaceTextStringO 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

NomeTipoDescrição
findTextStringO texto a ser encontrado.
replaceTextStringO texto para substituir o texto correspondente.
matchCaseBooleanSe 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

NomeTipoDescrição
isSkippedBooleanTrue 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

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