Class Master

Mestre

Um mestre em uma apresentação.

A seção mestre contém todos os elementos de página comuns e as propriedades comuns de um conjunto de layouts. Eles servem a 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 todos formas de marcador de posição nas páginas que usam esse mestre.
  • As propriedades de uma página mestra 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 da pelo 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 o 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()PageTypeRecebe o tipo da página.
getPlaceholder(placeholderType)PageElementRetorna o objeto PageElement do marcador para um PlaceholderType especificado ou null se um marcador de posição correspondente não estiver presente.
getPlaceholder(placeholderType, placeholderIndex)PageElementRetorna o objeto PageElement do marcador para um PlaceholderType especificado e um índice de marcador ou null se ele não estiver presente.
getPlaceholders()PageElement[]Retorna a lista de objetos PageElement do marcador 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 especificado blob de imagem padrão.
insertImage(blobSource, left, top, width, height)ImageInsere uma imagem na página com a posição e o tamanho fornecidos no 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 pelo URL fornecido.
insertLine(line)LineInsere uma cópia do Line fornecido na página.
insertLine(lineCategory, startConnectionSite, endConnectionSite)LineInsere uma linha na página que conecta dois 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 um 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 fornecida e tamanho.
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 uma caixa de texto Shape contendo a string fornecida na página.
insertTextBox(text, left, top, width, height)ShapeInsere uma caixa de texto Shape contendo a string fornecida na página.
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 de texto correspondente a localizar texto pelo texto de substituição.
replaceAllText(findText, replaceText, matchCase)IntegerSubstitui todas as instâncias de texto correspondente a localizar texto pelo texto de substituição.
selectAsCurrentPage()voidSeleciona a Page na apresentação ativa como a current page selection e remove qualquer seleção anterior.

Documentação detalhada

getBackground()

Extrai o plano de fundo da página.

Retornar

PageBackground: o plano de fundo da página.

Autorização

Os scripts que usam esse método precisam de 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.

Retornar

ColorScheme: o esquema de cores da página.

Autorização

Os scripts que usam esse método precisam de 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.

Retornar

Group[]

Autorização

Os scripts que usam esse método precisam de 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.

Retornar

Image[]

Autorização

Os scripts que usam esse método precisam de 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.

Retornar

Layout[]

Autorização

Os scripts que usam esse método precisam de 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.

Retornar

Line[]

Autorização

Os scripts que usam esse método precisam de 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 .

Retornar

String

Autorização

Os scripts que usam esse método precisam de 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 o 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.

Retornar

PageElement: o elemento de página com o ID fornecido.

Autorização

Os scripts que usam esse método precisam de 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.

Retornar

PageElement[]

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getPageType()

Recebe o tipo da página.

Retornar

PageType: o tipo de página.

Autorização

Os scripts que usam esse método precisam de 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 para um PlaceholderType especificado ou null se um marcador de posição correspondente não estiver presente.

Se houver vários espaços reservados com o mesmo tipo, ele vai retornar aquele com índice de marcador de posição. Se houver vários marcadores de posição correspondentes com o mesmo índice, ele retorna o primeiro marcador de posição do conjunto de elementos da página.

var slide = SlidesApp.getActivePresentation().getSlides()[0];
var placeholder = slide.getPlaceholder(SlidesApp.PlaceholderType.CENTERED_TITLE);

Parâmetros

NomeTipoDescrição
placeholderTypePlaceholderType

Retornar

PageElement

Autorização

Os scripts que usam esse método precisam de 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 para um PlaceholderType especificado e um índice de marcador ou null se ele não estiver presente.

Se houver vários espaços reservados com o mesmo tipo e índice, ele retornará o primeiro do conjunto de elementos da página.

var slide = SlidesApp.getActivePresentation().getSlides()[0];
var placeholder = slide.getPlaceholder(SlidesApp.PlaceholderType.CENTERED_TITLE, 0);

Parâmetros

NomeTipoDescrição
placeholderTypePlaceholderType
placeholderIndexInteger

Retornar

PageElement

Autorização

Os scripts que usam esse método precisam de 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 do marcador na página.

var master = SlidesApp.getActivePresentation().getMasters()[0];
Logger.log('Number of placeholders in the master: ' + master.getPlaceholders().length);

Retornar

PageElement[]

Autorização

Os scripts que usam esse método precisam de 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.

Retornar

Shape[]

Autorização

Os scripts que usam esse método precisam de 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.

Retornar

SheetsChart[]

Autorização

Os scripts que usam esse método precisam de 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.

Retornar

Table[]

Autorização

Os scripts que usam esse método precisam de 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.

Retornar

Video[]

Autorização

Os scripts que usam esse método precisam de 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.

Retornar

WordArt[]

Autorização

Os scripts que usam esse método precisam de 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.

É necessário que haja pelo menos dois elementos de página na mesma página que não estejam em outro grupo. Não é possível agrupar alguns elementos da página, como Videos, Tables e placeholder Shapes.

Parâmetros

NomeTipoDescrição
pageElementsPageElement[]Os elementos que serão agrupados.

Retornar

Group: o novo grupo.

Autorização

Os scripts que usam esse método precisam de 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 pelo atributo na respectiva página.

Se o elemento fornecido for um espaço reservado copiado da apresentação atual, As propriedades herdadas das páginas mestre ou de layout também herdam o elemento inserido.

Se o elemento fornecido for um espaço reservado copiado de outra apresentação, as propriedades herdadas das páginas mestre ou de layout são copiadas da origem para o elemento. apresentação.

// 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.

Retornar

Group: o grupo inserido.

Autorização

Os scripts que usam esse método precisam de 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 especificado blob de imagem padrão.

Inserir a imagem faz com que ela seja buscada no BlobSource uma vez, e uma cópia é armazenada para serão exibidos dentro da apresentação. As imagens devem ter menos de 50 MB, não pode exceder 25 megapixels e deve estar no formato 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.

Retornar

Image: a imagem inserida.

Autorização

Os scripts que usam esse método precisam de 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 no blob de imagem especificado.

A imagem é buscada no BlobSource fornecido uma vez no momento da inserção, e uma cópia é armazenado para exibição dentro da apresentação. As imagens devem ter menos de 50 MB, não é possível têm mais de 25 megapixels e precisam estar no formato PNG, JPEG ou GIF.

Para manter a proporção da imagem, ela é 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.
leftNumberPosição horizontal da imagem em pontos, medida a partir do canto superior esquerdo da página.
topNumberA posição vertical da imagem em pontos, medida a partir do canto superior esquerdo do da página.
widthNumberA largura da imagem em pontos.
heightNumberA altura da imagem em pontos.

Retornar

Image: a imagem inserida.

Autorização

Os scripts que usam esse método precisam de 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 a partir da posição da imagem de origem na respectiva página.

Se a imagem fornecida for um espaço reservado copiado da apresentação atual, As propriedades herdadas das páginas mestre ou de layout também herdam a imagem inserida.

Se a imagem for um marcador de posição copiado de outra apresentação, as propriedades herdadas das páginas mestre ou de layout são copiadas da origem para a imagem. apresentação. Se a imagem do marcador de posição copiada estiver vazia, nada será inserido no destino apresentação.

// 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.

Retornar

Image: a imagem inserida.

Autorização

Os scripts que usam esse método precisam de 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 no apresentação. As imagens devem ter menos de 50 MB, não podem exceder 25 megapixels e devem ter 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 é salvo. com a imagem e exposta por Image.getSourceUrl().

Parâmetros

NomeTipoDescrição
imageUrlStringO URL da imagem.

Retornar

Image: a imagem inserida.

Autorização

Os scripts que usam esse método precisam de 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 pelo 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 no apresentação. As imagens devem ter menos de 50 MB, não podem exceder 25 megapixels e devem ter 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 é salvo. com a imagem e exposta por Image.getSourceUrl().

Para manter a proporção da imagem, ela é dimensionada e centralizada em relação ao tamanho fornecido.

Parâmetros

NomeTipoDescrição
imageUrlStringO URL da imagem.
leftNumberPosição horizontal da imagem em pontos, medida a partir do canto superior esquerdo da página.
topNumberA posição vertical da imagem em pontos, medida a partir do canto superior esquerdo do da página.
widthNumberA largura da imagem em pontos.
heightNumberA altura da imagem em pontos.

Retornar

Image: a imagem inserida.

Autorização

Os scripts que usam esse método precisam de 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 pelo atributo na respectiva página.

Se o elemento fornecido for um espaço reservado copiado da apresentação atual, As propriedades herdadas das páginas mestre ou de layout também herdam o elemento inserido.

Se o elemento fornecido for um espaço reservado copiado de outra apresentação, as propriedades herdadas das páginas mestre ou de layout são copiadas da origem para o elemento. apresentação.

// 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.

Retornar

Line: a linha inserida.

Autorização

Os scripts que usam esse método precisam de 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 que conecta dois connection sites. Os dois de conexão precisam estar nessa 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 em que o início da linha deve ser conectado.
endConnectionSiteConnectionSiteO local de conexão em que o fim da linha será conectado.

Retornar

Line: a linha inserida.

Autorização

Os scripts que usam esse método precisam de 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.
startLeftNumberPosição horizontal do ponto inicial da linha, medida em pontos. no canto superior esquerdo da página.
startTopNumberA posição vertical do ponto inicial da linha, medida em pontos a partir de no canto superior esquerdo da página.
endLeftNumberA posição horizontal do ponto final da linha, medida em pontos a partir no canto superior esquerdo da página.
endTopNumberA posição vertical do ponto final da linha, medida em pontos a partir do no canto superior esquerdo da página.

Retornar

Line: a linha inserida.

Autorização

Os scripts que usam esse método precisam de 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 pelo atributo na respectiva página.

Se o elemento fornecido for um espaço reservado copiado da apresentação atual, As propriedades herdadas das páginas mestre ou de layout também herdam o elemento inserido.

Se o elemento fornecido for um espaço reservado copiado de outra apresentação, as propriedades herdadas das páginas mestre ou de layout são copiadas da origem para o elemento. apresentação.

// 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.

Retornar

PageElement: o elemento de página inserido.

Autorização

Os scripts que usam esse método precisam de 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 pelo atributo na respectiva página.

Se o elemento fornecido for um espaço reservado copiado da apresentação atual, As propriedades herdadas das páginas mestre ou de layout também herdam o elemento inserido.

Se o elemento fornecido for um espaço reservado copiado de outra apresentação, as propriedades herdadas das páginas mestre ou de layout são copiadas da origem para o elemento. apresentação.

// 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.

Retornar

Shape: a forma inserida.

Autorização

Os scripts que usam esse método precisam de 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.

Retornar

Shape: a forma inserida.

Autorização

Os scripts que usam esse método precisam de 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.
leftNumberA posição horizontal da forma, medida a partir do canto superior esquerdo do página.
topNumberA posição vertical da forma, medida a partir do canto superior esquerdo da página.
widthNumberA largura da forma.
heightNumberA altura do polígono.

Retornar

Shape: a forma inserida.

Autorização

Os scripts que usam esse método precisam de 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 original 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 de uma planilha a ser inserido na página.

Retornar

SheetsChart: o gráfico inserido na página.

Autorização

Os scripts que usam esse método precisam de 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 do gráfico, ele é dimensionado e centralizado de acordo ao tamanho fornecido.

O gráfico inserido é vinculado ao gráfico original 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 de 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 do da página.
widthNumberA largura do gráfico em pontos.
heightNumberA altura do gráfico em pontos.

Retornar

SheetsChart: o gráfico inserido na página.

Autorização

Os scripts que usam esse método precisam de 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 pelo atributo na respectiva página.

Se o elemento fornecido for um espaço reservado copiado da apresentação atual, As propriedades herdadas das páginas mestre ou de layout também herdam o elemento inserido.

Se o elemento fornecido for um espaço reservado copiado de outra apresentação, as propriedades herdadas das páginas mestre ou de layout são copiadas da origem para o elemento. apresentação.

// 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 das páginas a ser copiado e inserido.

Retornar

SheetsChart: o gráfico de páginas inseridas.

Autorização

Os scripts que usam esse método precisam de 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 um 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 de uma planilha a ser inserido na página.

Retornar

Image: a imagem do gráfico inserida na página.

Autorização

Os scripts que usam esse método precisam de 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 fornecida e tamanho.

Para manter a proporção da imagem do gráfico, ela é dimensionada e centralizada com 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 de 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 do da página.
widthNumberA largura do gráfico em pontos.
heightNumberA altura do gráfico em pontos.

Retornar

Image: a imagem do gráfico inserida na página.

Autorização

Os scripts que usam esse método precisam de 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 tamanho padrão e linhas e colunas distribuídas uniformemente.

Parâmetros

NomeTipoDescrição
numRowsIntegerO número de linhas na tabela.
numColumnsIntegerO número de colunas na tabela.

Retornar

Table: a tabela inserida.

Autorização

Os scripts que usam esse método precisam de 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 de maneira uniforme na tabela criada.

Parâmetros

NomeTipoDescrição
numRowsIntegerO número de linhas na tabela.
numColumnsIntegerO número de colunas na tabela.
leftNumberA posição horizontal da tabela, medida a partir do canto superior esquerdo do página.
topNumberA posição vertical da tabela, medida a partir do canto superior esquerdo da página.
widthNumberA largura da tabela.
heightNumberA altura mínima da tabela. A altura real da tabela renderizada depende em fatores como tamanho da fonte do texto.

Retornar

Table: a tabela inserida.

Autorização

Os scripts que usam esse método precisam de 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 pelo atributo na respectiva página.

Se o elemento fornecido for um espaço reservado copiado da apresentação atual, As propriedades herdadas das páginas mestre ou de layout também herdam o elemento inserido.

Se o elemento fornecido for um espaço reservado copiado de outra apresentação, as propriedades herdadas das páginas mestre ou de layout são copiadas da origem para o elemento. apresentação.

// 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.

Retornar

Table: a tabela inserida.

Autorização

Os scripts que usam esse método precisam de 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 uma caixa de texto Shape contendo a string fornecida na página.

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
textStringA string que a forma da caixa de texto deve conter.

Retornar

Shape: a forma da caixa de texto inserida.

Autorização

Os scripts que usam esse método precisam de 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 uma caixa de texto Shape contendo a string fornecida na página.

// 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
textStringA string que a forma da caixa de texto deve conter.
leftNumberPosição horizontal da forma da caixa de texto, medida a partir do canto superior esquerdo. da página.
topNumberA posição vertical da forma da caixa de texto, medida a partir do canto superior esquerdo do da página.
widthNumberA largura da forma da caixa de texto.
heightNumberA altura da forma da caixa de texto.

Retornar

Shape: a forma da caixa de texto inserida.

Autorização

Os scripts que usam esse método precisam de 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, apenas vídeos do YouTube são compatíveis.

Parâmetros

NomeTipoDescrição
videoUrlStringO URL do vídeo a ser inserido.

Retornar

Video: o vídeo inserido.

Autorização

Os scripts que usam esse método precisam de 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, apenas vídeos do YouTube são compatíveis.

Parâmetros

NomeTipoDescrição
videoUrlStringO URL do vídeo a ser inserido.
leftNumberA posição horizontal do vídeo em pontos, medida a partir do canto superior esquerdo da página.
topNumberA posição vertical do vídeo em pontos, medida a partir do canto superior esquerdo do da página.
widthNumberA largura do vídeo em pontos.
heightNumberÉ a altura do vídeo em pontos.

Retornar

Video: o vídeo inserido.

Autorização

Os scripts que usam esse método precisam de 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 pelo atributo na respectiva página.

Se o elemento fornecido for um espaço reservado copiado da apresentação atual, As propriedades herdadas das páginas mestre ou de layout também herdam o elemento inserido.

Se o elemento fornecido for um espaço reservado copiado de outra apresentação, as propriedades herdadas das páginas mestre ou de layout são copiadas da origem para o elemento. apresentação.

// 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.

Retornar

Video: o vídeo inserido.

Autorização

Os scripts que usam esse método precisam de 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 pelo atributo na respectiva página.

Se o elemento fornecido for um espaço reservado copiado da apresentação atual, As propriedades herdadas das páginas mestre ou de layout também herdam o elemento inserido.

Se o elemento fornecido for um espaço reservado copiado de outra apresentação, as propriedades herdadas das páginas mestre ou de layout são copiadas da origem para o elemento. apresentação.

// 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.

Retornar

WordArt: a palavra "arte" inserida.

Autorização

Os scripts que usam esse método precisam de 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 precisam de 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 de texto correspondente a localizar texto pelo texto de substituição. A pesquisa é caso insensíveis.

Parâmetros

NomeTipoDescrição
findTextStringO texto a ser encontrado.
replaceTextStringO texto que substituirá o texto correspondente.

Retornar

Integer: o número de ocorrências alterado

Autorização

Os scripts que usam esse método precisam de 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 de texto correspondente a localizar texto pelo texto de substituição.

Parâmetros

NomeTipoDescrição
findTextStringO texto a ser encontrado.
replaceTextStringO texto que substituirá o texto correspondente.
matchCaseBooleanSe for true, a pesquisa diferencia maiúsculas de minúsculas. se for false, a pesquisa será são indiferentes a maiúsculas.

Retornar

Integer: o número de ocorrências alterado

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

selectAsCurrentPage()

Seleciona a Page na apresentação ativa como a 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 somente se o script está 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 precisam de autorização com um ou mais dos seguintes escopos:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations