Esta página foi traduzida pela API Cloud Translation.

Class Layout

Um layout em uma apresentação.

Cada layout serve como um modelo para os slides que o herdam, determinando como o conteúdo deles é organizado e estilizado.

Métodos

Método	Tipo de retorno	Breve descrição
`getBackground()`	`PageBackground`	Recebe o plano de fundo da página.
`getColorScheme()`	`ColorScheme`	Extrai 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.
`getLayoutName()`	`String`	Recebe o nome do layout.
`getLines()`	`Line[]`	Retorna a lista de objetos `Line` na página.
`getMaster()`	`Master`	Recebe o mestre em que o layout é baseado.
`getObjectId()`	`String`	Recebe o ID exclusivo da página.
`getPageElementById(id)`	`PageElement`	Retorna 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()`	`PageType`	Recebe o tipo da página.
`getPlaceholder(placeholderType)`	`PageElement`	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.
`getPlaceholder(placeholderType, placeholderIndex)`	`PageElement`	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.
`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)`	`Group`	Agrupe todos os elementos de página especificados.
`insertGroup(group)`	`Group`	Insere uma cópia do `Group` fornecido na página.
`insertImage(blobSource)`	`Image`	Insere uma imagem no canto superior esquerdo da página com um tamanho padrão do blob de imagem especificado.
`insertImage(blobSource, left, top, width, height)`	`Image`	Insere uma imagem na página com a posição e o tamanho fornecidos do blob de imagem especificado.
`insertImage(image)`	`Image`	Insere uma cópia do `Image` fornecido na página.
`insertImage(imageUrl)`	`Image`	Insere uma imagem no canto superior esquerdo da página com um tamanho padrão do URL fornecido.
`insertImage(imageUrl, left, top, width, height)`	`Image`	Insere uma imagem na página com a posição e o tamanho fornecidos pelo URL.
`insertLine(line)`	`Line`	Insere uma cópia do `Line` fornecido na página.
`insertLine(lineCategory, startConnectionSite, endConnectionSite)`	`Line`	Insere uma linha na página que conecta duas `connection sites`.
`insertLine(lineCategory, startLeft, startTop, endLeft, endTop)`	`Line`	Insere uma linha na página.
`insertPageElement(pageElement)`	`PageElement`	Insere uma cópia do `PageElement` fornecido na página.
`insertShape(shape)`	`Shape`	Insere uma cópia do `Shape` fornecido na página.
`insertShape(shapeType)`	`Shape`	Insere uma forma na página.
`insertShape(shapeType, left, top, width, height)`	`Shape`	Insere uma forma na página.
`insertSheetsChart(sourceChart)`	`SheetsChart`	Insere um gráfico das Planilhas Google na página.
`insertSheetsChart(sourceChart, left, top, width, height)`	`SheetsChart`	Insere um gráfico das Planilhas Google na página com a posição e o tamanho fornecidos.
`insertSheetsChart(sheetsChart)`	`SheetsChart`	Insere uma cópia do `SheetsChart` fornecido na página.
`insertSheetsChartAsImage(sourceChart)`	`Image`	Insere um gráfico das Planilhas Google como um `Image` na página.
`insertSheetsChartAsImage(sourceChart, left, top, width, height)`	`Image`	Insere um gráfico das Planilhas Google como um `Image` na página com a posição e o tamanho fornecidos.
`insertTable(numRows, numColumns)`	`Table`	Insere uma tabela na página.
`insertTable(numRows, numColumns, left, top, width, height)`	`Table`	Insere uma tabela na página com a posição e o tamanho fornecidos.
`insertTable(table)`	`Table`	Insere uma cópia do `Table` fornecido na página.
`insertTextBox(text)`	`Shape`	Insere uma caixa de texto `Shape` que contém a string fornecida na página.
`insertTextBox(text, left, top, width, height)`	`Shape`	Insere uma caixa de texto `Shape` que contém a string fornecida na página.
`insertVideo(videoUrl)`	`Video`	Insere um vídeo no canto superior esquerdo da página com um tamanho padrão.
`insertVideo(videoUrl, left, top, width, height)`	`Video`	Insere um vídeo na página com a posição e o tamanho fornecidos.
`insertVideo(video)`	`Video`	Insere uma cópia do `Video` fornecido na página.
`insertWordArt(wordArt)`	`WordArt`	Insere uma cópia do `WordArt` fornecido na página.
`remove()`	`void`	Remove a página.
`replaceAllText(findText, replaceText)`	`Integer`	Substitui todas as instâncias de texto correspondentes ao texto de pesquisa por texto de substituição.
`replaceAllText(findText, replaceText, matchCase)`	`Integer`	Substitui todas as instâncias de texto correspondentes ao texto de pesquisa por texto de substituição.
`selectAsCurrentPage()`	`void`	Seleciona 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

`getLayoutName()`

Recebe o nome do layout.

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

`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

`getMaster()`

Recebe o mestre em que o layout é baseado.

Retornar

Master

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

Nome	Tipo	Descrição
`id`	`String`	O 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

Nome	Tipo	Descrição
`placeholderType`	`PlaceholderType`

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

Nome	Tipo	Descrição
`placeholderType`	`PlaceholderType`
`placeholderIndex`	`Integer`

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

Nome	Tipo	Descrição
`pageElements`	`PageElement[]`	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

Nome	Tipo	Descrição
`group`	`Group`	O 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

Nome	Tipo	Descrição
`blobSource`	`BlobSource`	Dados 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

Nome	Tipo	Descrição
`blobSource`	`BlobSource`	Dados da imagem.
`left`	`Number`	A posição horizontal da imagem em pontos, medida a partir do canto superior esquerdo da página.
`top`	`Number`	A posição vertical da imagem em pontos, medida a partir do canto superior esquerdo da página.
`width`	`Number`	A largura da imagem em pontos.
`height`	`Number`	A altura da imagem em pontos.

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

Nome	Tipo	Descrição
`image`	`Image`	A 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

Nome	Tipo	Descrição
`imageUrl`	`String`	O 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.

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

Nome	Tipo	Descrição
`imageUrl`	`String`	O URL da imagem.
`left`	`Number`	A posição horizontal da imagem em pontos, medida a partir do canto superior esquerdo da página.
`top`	`Number`	A posição vertical da imagem em pontos, medida a partir do canto superior esquerdo da página.
`width`	`Number`	A largura da imagem em pontos.
`height`	`Number`	A altura da imagem em pontos.

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.

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

Nome	Tipo	Descrição
`line`	`Line`	A 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

Nome	Tipo	Descrição
`lineCategory`	`LineCategory`	A categoria da linha a ser inserida.
`startConnectionSite`	`ConnectionSite`	O site de conexão em que o início da linha será conectado.
`endConnectionSite`	`ConnectionSite`	O 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

Nome	Tipo	Descrição
`lineCategory`	`LineCategory`	A categoria da linha a ser inserida.
`startLeft`	`Number`	A posição horizontal do ponto inicial da linha, medida em pontos a partir do canto superior esquerdo da página.
`startTop`	`Number`	A posição vertical do ponto inicial da linha, medida em pontos a partir do canto superior esquerdo da página.
`endLeft`	`Number`	A posição horizontal do ponto final da linha, medida em pontos a partir do canto superior esquerdo da página.
`endTop`	`Number`	A posição vertical do ponto final da linha, medida em pontos 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.

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

Nome	Tipo	Descrição
`pageElement`	`PageElement`	O 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.

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

Nome	Tipo	Descrição
`shape`	`Shape`	A 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

Nome	Tipo	Descrição
`shapeType`	`ShapeType`	O 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

Nome	Tipo	Descrição
`shapeType`	`ShapeType`	O tipo de forma a ser inserido.
`left`	`Number`	A posição horizontal da forma, medida a partir do canto superior esquerdo da página.
`top`	`Number`	A posição vertical da forma, medida a partir do canto superior esquerdo da página.
`width`	`Number`	É a largura do formato.
`height`	`Number`	A 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

Nome	Tipo	Descrição
`sourceChart`	`EmbeddedChart`	O 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

Nome	Tipo	Descrição
`sourceChart`	`EmbeddedChart`	O gráfico em uma planilha a ser inserido na página.
`left`	`Number`	A posição horizontal do gráfico em pontos, medida a partir do canto superior esquerdo da página.
`top`	`Number`	A posição vertical do gráfico em pontos, medida a partir do canto superior esquerdo da página.
`width`	`Number`	A largura do gráfico em pontos.
`height`	`Number`	A altura do gráfico em pontos.

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.

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

Nome	Tipo	Descrição
`sheetsChart`	`SheetsChart`	O 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

Nome	Tipo	Descrição
`sourceChart`	`EmbeddedChart`	O 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

Nome	Tipo	Descrição
`sourceChart`	`EmbeddedChart`	O gráfico em uma planilha a ser inserido na página.
`left`	`Number`	A posição horizontal do gráfico em pontos, medida a partir do canto superior esquerdo da página.
`top`	`Number`	A posição vertical do gráfico em pontos, medida a partir do canto superior esquerdo da página.
`width`	`Number`	A largura do gráfico em pontos.
`height`	`Number`	A altura do gráfico em pontos.

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

Nome	Tipo	Descrição
`numRows`	`Integer`	O número de linhas na tabela.
`numColumns`	`Integer`	O 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

Nome	Tipo	Descrição
`numRows`	`Integer`	O número de linhas na tabela.
`numColumns`	`Integer`	O número de colunas na tabela.
`left`	`Number`	A posição horizontal da tabela, medida a partir do canto superior esquerdo da página.
`top`	`Number`	A posição vertical da tabela, medida a partir do canto superior esquerdo da página.
`width`	`Number`	A largura da tabela.
`height`	`Number`	A altura mínima da tabela. A altura real da tabela renderizada depende de fatores como o tamanho da fonte do texto.

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.

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

Nome	Tipo	Descrição
`table`	`Table`	A 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

Nome	Tipo	Descrição
`text`	`String`	A 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

Nome	Tipo	Descrição
`text`	`String`	A string que a forma da caixa de texto precisa conter.
`left`	`Number`	A posição horizontal da forma da caixa de texto, medida a partir do canto superior esquerdo da página.
`top`	`Number`	A posição vertical da forma da caixa de texto, medida a partir do canto superior esquerdo da página.
`width`	`Number`	A largura da forma da caixa de texto.
`height`	`Number`	A altura da forma da caixa de texto.

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

Nome	Tipo	Descrição
`videoUrl`	`String`	O 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

Nome	Tipo	Descrição
`videoUrl`	`String`	O URL do vídeo a ser inserido.
`left`	`Number`	A posição horizontal do vídeo em pontos, medida a partir do canto superior esquerdo da página.
`top`	`Number`	A posição vertical do vídeo em pontos, medida a partir do canto superior esquerdo da página.
`width`	`Number`	A largura do vídeo em pontos.
`height`	`Number`	A altura do vídeo em pontos.

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.

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

Nome	Tipo	Descrição
`video`	`Video`	O 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.

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

Nome	Tipo	Descrição
`wordArt`	`WordArt`	O 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

Nome	Tipo	Descrição
`findText`	`String`	O texto a ser encontrado.
`replaceText`	`String`	O 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

Nome	Tipo	Descrição
`findText`	`String`	O texto a ser encontrado.
`replaceText`	`String`	O texto que vai substituir o texto correspondente.
`matchCase`	`Boolean`	Se `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