Class Master

Mestre

Um mestre em uma apresentação.

Mestres contêm todos os elementos de página comuns e as propriedades comuns de um conjunto de layouts. Elas têm três propósitos:

  • As formas de marcador de posição em um mestre contêm os estilos de texto e as propriedades de forma padrão de todas as formas de marcador de posição nas páginas que usam esse mestre.
  • As propriedades de uma página mestre definem as propriedades de página comuns herdadas pelos layouts.
  • Quaisquer outras formas no slide mestre aparecem em todos os slides que usam esse mestre, independentemente do layout.

Métodos

MétodoTipo de retornoBreve descrição
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.
getLayouts()Layout[]Recebe os layouts deste mestre.
getLines()Line[]Retorna a lista de objetos Line na página.
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.
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.
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.

Documentação detalhada

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

getLayouts()

Recebe os layouts deste mestre.

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

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

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

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