Class Master

Mestre

Um mestre em uma apresentação.

Os modelos principais contêm todos os elementos de página comuns e as propriedades comuns para um conjunto de layouts. Elas servem a três propósitos:

  • As formas de marcador de posição em um modelo 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 modelo.
  • As propriedades de uma página mestre definem as propriedades comuns herdadas pelos layouts.
  • Todas as 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()PageBackgroundRecebe o plano de fundo da página.
getColorScheme()ColorSchemeExtrai 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[]Retorna os layouts desse 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 nenhum existir.
getPageElements()PageElement[]Retorna a lista de objetos PageElement renderizados na página.
getPageType()PageTypeRecebe o tipo da página.
getPlaceholder(placeholderType)PageElementRetorna o objeto marcador de posição PageElement para um PlaceholderType especificado ou null, se um marcador de posição correspondente não estiver presente.
getPlaceholder(placeholderType, placeholderIndex)PageElementRetorna o objeto marcador de posição PageElement para um PlaceholderType especificado e um índice de marcador de posição ou null, se o marcador de posição não estiver presente.
getPlaceholders()PageElement[]Retorna a lista de objetos PageElement de marcador de posição 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)GroupAgrupe 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 pelo URL.
insertLine(line)LineInsere uma cópia do Line fornecido na página.
insertLine(lineCategory, startConnectionSite, endConnectionSite)LineInsere uma linha na página que conecta 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 das Planilhas Google na página.
insertSheetsChart(sourceChart, left, top, width, height)SheetsChartInsere um gráfico das 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 das Planilhas Google como um Image na página.
insertSheetsChartAsImage(sourceChart, left, top, width, height)ImageInsere um gráfico das 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 uma caixa de texto Shape que contém a string fornecida na página.
insertTextBox(text, left, top, width, height)ShapeInsere uma caixa de texto Shape que contém 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 correspondentes ao texto de pesquisa por texto de substituição.
replaceAllText(findText, replaceText, matchCase)IntegerSubstitui todas as instâncias de texto correspondentes ao texto de pesquisa por texto de substituição.
selectAsCurrentPage()voidSeleciona o Page na apresentação ativa como current page selection e remove qualquer seleção anterior.

Documentação detalhada

getBackground()

Recebe 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 exigem autorização com um ou mais dos seguintes escopos:

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

getColorScheme()

Extrai o ColorScheme associado à página.

Retornar

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.

Retornar

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.

Retornar

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

Retorna os layouts desse mestre.

Retornar

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.

Retornar

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.

Retornar

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 o PageElement na página com o ID fornecido ou null se nenhum existir.

Parâmetros

NomeTipoDescrição
idStringO ID do elemento da página que está sendo recuperado.

Retornar

PageElement: o elemento da 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.

Retornar

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

Recebe o tipo da página.

Retornar

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 marcador de posição PageElement para um PlaceholderType especificado ou null, se um marcador de posição correspondente não estiver presente.

Se houver vários marcadores de posição com o mesmo tipo, será retornado o marcador com o índice mínimo. Se houver vários marcadores correspondentes com o mesmo índice, o primeiro marcador da coleção de elementos da página será retornado.

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

Parâmetros

NomeTipoDescrição
placeholderTypePlaceholderType

Retornar

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 marcador de posição PageElement para um PlaceholderType especificado e um índice de marcador de posição ou null, se o marcador de posição não estiver presente.

Se houver vários marcadores de posição com o mesmo tipo e índice, o primeiro marcador de posição da coleção de elementos da página será retornado.

const slide = SlidesApp.getActivePresentation().getSlides()[0];
const 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 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 marcador de posição na página.

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

Retornar

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.

Retornar

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.

Retornar

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.

Retornar

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.

Retornar

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)

Agrupe todos os elementos de página especificados.

Deve haver pelo menos dois elementos na mesma página que ainda não estejam em outro grupo. Alguns elementos da página, como Videos, Tables e placeholder Shapes, não podem ser agrupados.

Parâmetros

NomeTipoDescrição
pageElementsPageElement[]Os elementos a serem agrupados.

Retornar

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 nessa página é determinada pela posição do elemento de origem na respectiva página.

Se o elemento fornecido for um marcador de posição copiado da apresentação atual, as propriedades que herdam das páginas mestre ou de layout também serão herdadas no elemento inserido.

Se o elemento fornecido for um marcador de posição copiado de uma apresentação diferente, as propriedades que herdam das páginas mestre ou de layout serão copiadas para o elemento da apresentação de origem.

// Copy a group between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const group = otherPresentationSlide.getGroups()[0];
currentPresentationSlide.insertGroup(
    group);  // Also available for Layout, Master, and Page.

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 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 a busca do BlobSource uma vez, e uma cópia é armazenada para exibição na 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.

const slide = SlidesApp.getActivePresentation().getSlides()[0];
// Get the Drive image file with the given ID.
const image = DriveApp.getFileById('123abc');
slide.insertImage(image);

Parâmetros

NomeTipoDescrição
blobSourceBlobSourceDados da imagem.

Retornar

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 do BlobSource fornecido uma vez no momento da inserção, e uma cópia é armazenada para exibição na apresentação. As imagens precisam ter menos de 50 MB, não podem ultrapassar 25 megapixels e precisam estar nos formatos PNG, JPEG ou GIF.

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

const slide = SlidesApp.getActivePresentation().getSlides()[0];
// Get the Drive image file with the given ID.
const image = DriveApp.getFileById('123abc');
const position = {
  left: 0,
  top: 0
};
const size = {
  width: 300,
  height: 100
};
slide.insertImage(image, position.left, position.top, size.width, size.height);

Parâmetros

NomeTipoDescrição
blobSourceBlobSourceDados da imagem.
leftNumberA posiçã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 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 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 pela posição da imagem de origem na respectiva página.

Se a imagem fornecida for um marcador de posição copiado da apresentação atual, as propriedades que herdam das páginas mestre ou de layout também serão herdadas na imagem inserida.

Se a imagem fornecida for um marcador de posição copiado de uma apresentação diferente, as propriedades que herdam das páginas mestre 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.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const 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 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 a busca do URL uma vez, e uma cópia é armazenada para exibição na 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 é salvo com a imagem e exposto 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 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 pelo URL.

A inserção da imagem a busca do URL uma vez, e uma cópia é armazenada para exibição na 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 é salvo com a imagem e exposto 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.
leftNumberA posiçã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 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 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 nessa página é determinada pela posição do elemento de origem na respectiva página.

Se o elemento fornecido for um marcador de posição copiado da apresentação atual, as propriedades que herdam das páginas mestre ou de layout também serão herdadas no elemento inserido.

Se o elemento fornecido for um marcador de posição copiado de uma apresentação diferente, as propriedades que herdam das páginas mestre ou de layout serão copiadas para o elemento da apresentação de origem.

// Copy a line between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const line = otherPresentationSlide.getLines[0];
currentPresentationSlide.insertLine(line);

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 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 que conecta 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.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
const shape1 = slide.insertShape(SlidesApp.ShapeType.RECTANGLE);
const shape2 = slide.insertShape(SlidesApp.ShapeType.CLOUD);
slide.insertLine(
    SlidesApp.LineCategory.BENT,
    shape1.getConnectionSites()[0],
    shape2.getConnectionSites()[1],
);

Parâmetros

NomeTipoDescrição
lineCategoryLineCategoryA categoria da linha a ser inserida.
startConnectionSiteConnectionSiteO site de conexão em que o início da linha será conectado.
endConnectionSiteConnectionSiteO local de conexão em que o final da linha será conectado.

Retornar

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.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
const startPoint = {
  left: 10,
  top: 10
};
const endPoint = {
  left: 40,
  top: 40
};
slide.insertLine(
    SlidesApp.LineCategory.STRAIGHT,
    startPoint.left,
    startPoint.top,
    endPoint.left,
    endPoint.top,
);

Parâmetros

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

Retornar

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 nessa página é determinada pela posição do elemento de origem na respectiva página.

Se o elemento fornecido for um marcador de posição copiado da apresentação atual, as propriedades que herdam das páginas mestre ou de layout também serão herdadas no elemento inserido.

Se o elemento fornecido for um marcador de posição copiado de uma apresentação diferente, as propriedades que herdam das páginas mestre ou de layout serão copiadas para o elemento da apresentação de origem.

// Copy a page element between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const pageElement = otherPresentationSlide.getPageElements()[0];

// Also available for Layout, Master, and Page.
currentPresentationSlide.insertPageElement(pageElement);

Parâmetros

NomeTipoDescrição
pageElementPageElementO elemento da página a ser copiado e inserido.

Retornar

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 nessa página é determinada pela posição do elemento de origem na respectiva página.

Se o elemento fornecido for um marcador de posição copiado da apresentação atual, as propriedades que herdam das páginas mestre ou de layout também serão herdadas no elemento inserido.

Se o elemento fornecido for um marcador de posição copiado de uma apresentação diferente, as propriedades que herdam das páginas mestre ou de layout serão copiadas para o elemento da apresentação de origem.

// Copy a shape between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const shape = otherPresentationSlide.getShapes[0];
currentPresentationSlide.insertShape(
    shape);  // Also available for Layout, Master, and Page.

Parâmetros

NomeTipoDescrição
shapeShapeA forma que será copiada e inserida.

Retornar

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.
const 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 inserido.

Retornar

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 inserido.
leftNumberA posição horizontal da forma, medida a partir do canto superior esquerdo da página.
topNumberA posição vertical da forma, medida a partir do canto superior esquerdo da página.
widthNumberÉ a largura do formato.
heightNumberA altura do formato.

Retornar

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 das 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 das Planilhas Google, o que permite que ele seja atualizado. Outros colaboradores podem acessar o link para a planilha de origem.

const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
const chart = sheet.getCharts()[0];
// Insert the spreadsheet chart in the first slide.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.insertSheetsChart(chart);

Parâmetros

NomeTipoDescrição
sourceChartEmbeddedChartO gráfico em 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 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 das 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 em relação ao tamanho fornecido.

O gráfico inserido é vinculado ao gráfico de origem das Planilhas Google, o que permite que ele seja atualizado. Outros colaboradores podem acessar o link para a planilha de origem.

const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
const chart = sheet.getCharts()[0];
// Insert the spreadsheet chart in the first slide.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
const position = {
  left: 0,
  top: 0
};
const size = {
  width: 200,
  height: 200
};

// Also available for Layout, Master, and Page.
slide.insertSheetsChart(
    chart,
    position.left,
    position.top,
    size.width,
    size.height,
);

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.

Retornar

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 nessa página é determinada pela posição do elemento de origem na respectiva página.

Se o elemento fornecido for um marcador de posição copiado da apresentação atual, as propriedades que herdam das páginas mestre ou de layout também serão herdadas no elemento inserido.

Se o elemento fornecido for um marcador de posição copiado de uma apresentação diferente, as propriedades que herdam das páginas mestre ou de layout serão copiadas para o elemento da apresentação de origem.

// Copy a sheets chart between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const sheetsChart = otherPresentationSlide.getSheetsCharts[0];

// Also available for Layout, Master, and Page.
currentPresentationSlide.insertSheetsChart(sheetsChart);

Parâmetros

NomeTipoDescrição
sheetsChartSheetsChartO gráfico de planilhas a ser copiado e inserido.

Retornar

SheetsChart: o gráfico de planilhas 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 das 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 inserida do gráfico não está vinculada ao gráfico de origem das Planilhas Google.

const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
const chart = sheet.getCharts()[0];
// Insert the spreadsheet chart in the first slide.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.insertSheetsChartAsImage(
    chart);  // Also available for Layout, Master, and Page.

Parâmetros

NomeTipoDescrição
sourceChartEmbeddedChartO gráfico em uma planilha a ser inserido na página.

Retornar

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 das 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 das Planilhas Google.

const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
const chart = sheet.getCharts()[0];
// Insert the spreadsheet chart in the first slide.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
const position = {
  left: 0,
  top: 0
};
const size = {
  width: 200,
  height: 200
};

// Also available for Layout, Master, and Page.
slide.insertSheetsChartAsImage(
    chart,
    position.left,
    position.right,
    size.width,
    size.height,
);

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.

Retornar

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

Retornar

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 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 da 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 de fatores como o tamanho da fonte do texto.

Retornar

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 nessa página é determinada pela posição do elemento de origem na respectiva página.

Se o elemento fornecido for um marcador de posição copiado da apresentação atual, as propriedades que herdam das páginas mestre ou de layout também serão herdadas no elemento inserido.

Se o elemento fornecido for um marcador de posição copiado de uma apresentação diferente, as propriedades que herdam das páginas mestre ou de layout serão copiadas para o elemento da apresentação de origem.

// Copy a table between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const table = otherPresentationSlide.getTables[0];
currentPresentationSlide.insertTable(
    table);  // Also available for Layout, Master, and Page.

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 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 uma caixa de texto Shape que contém 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.
const 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 precisa conter.

Retornar

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 uma caixa de texto Shape que contém 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.
const 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 precisa conter.
leftNumberA posiçã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 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 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, apenas vídeos do YouTube são aceitos.

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 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, apenas vídeos do YouTube são aceitos.

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 da página.
widthNumberA largura do vídeo em pontos.
heightNumberA altura do vídeo em pontos.

Retornar

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 nessa página é determinada pela posição do elemento de origem na respectiva página.

Se o elemento fornecido for um marcador de posição copiado da apresentação atual, as propriedades que herdam das páginas mestre ou de layout também serão herdadas no elemento inserido.

Se o elemento fornecido for um marcador de posição copiado de uma apresentação diferente, as propriedades que herdam das páginas mestre ou de layout serão copiadas para o elemento da apresentação de origem.

// Copy a video between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const video = otherPresentationSlide.getVideos[0];
currentPresentationSlide.insertVideo(
    video);  // Also available for Layout, Master, and Page.

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 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 nessa página é determinada pela posição do elemento de origem na respectiva página.

Se o elemento fornecido for um marcador de posição copiado da apresentação atual, as propriedades que herdam das páginas mestre ou de layout também serão herdadas no elemento inserido.

Se o elemento fornecido for um marcador de posição copiado de uma apresentação diferente, as propriedades que herdam das páginas mestre ou de layout serão copiadas para o elemento da apresentação de origem.

// Copy a word art between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const wordArt = otherPresentationSlide.getWordArts[0];

// Also available for Layout, Master, and Page.
currentPresentationSlide.insertWordArt(wordArt);

Parâmetros

NomeTipoDescrição
wordArtWordArtO grupo a ser copiado e inserido.

Retornar

WordArt: o Word Art 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

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 de texto correspondentes ao texto de pesquisa por 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 que vai substituir o texto correspondente.

Retornar

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 de texto correspondentes ao texto de pesquisa por texto de substituição.

Parâmetros

NomeTipoDescrição
findTextStringO texto a ser encontrado.
replaceTextStringO texto que vai substituir o texto correspondente.
matchCaseBooleanSe true, a pesquisa diferencia maiúsculas de minúsculas. Se false, a pesquisa não diferencia maiúsculas de minúsculas.

Retornar

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 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 ele estiver vinculado à apresentação.

// Select the first slide as the current page selection and replace any previous
// selection.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.selectAsCurrentPage();  // Also available for Layout, Master, and Page.

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