Esta página foi traduzida pela API Cloud Translation.

Class Layout

Um layout em uma apresentação.

Cada layout serve como modelo para os slides que o herdam, determinando como o conteúdo em esses slides são organizados e estilizados.

Métodos

Método	Tipo de retorno	Breve descrição
`getBackground()`	`PageBackground`	Extrai o plano de fundo da página.
`getColorScheme()`	`ColorScheme`	Recebe 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 se baseia.
`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 não houver nenhum.
`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 `PageElement` do marcador para um `PlaceholderType` especificado ou `null` se um marcador de posição correspondente não estiver presente.
`getPlaceholder(placeholderType, placeholderIndex)`	`PageElement`	Retorna 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)`	`Group`	Agrupa 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 especificado blob de imagem padrão.
`insertImage(blobSource, left, top, width, height)`	`Image`	Insere uma imagem na página com a posição e o tamanho fornecidos no 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 fornecido.
`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 dois `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 do Planilhas Google na página.
`insertSheetsChart(sourceChart, left, top, width, height)`	`SheetsChart`	Insere um gráfico do 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 do Planilhas Google como um `Image` na página.
`insertSheetsChartAsImage(sourceChart, left, top, width, height)`	`Image`	Insere um gráfico do Planilhas Google como um `Image` na página com a posição fornecida e tamanho.
`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` contendo a string fornecida na página.
`insertTextBox(text, left, top, width, height)`	`Shape`	Insere uma caixa de texto `Shape` contendo 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 correspondente a localizar texto pelo texto de substituição.
`replaceAllText(findText, replaceText, matchCase)`	`Integer`	Substitui todas as instâncias de texto correspondente a localizar texto pelo texto de substituição.
`selectAsCurrentPage()`	`void`	Seleciona 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

`getLayoutName()`

Recebe o nome do layout.

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

`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

`getMaster()`

Recebe o mestre em que o layout se baseia.

Retornar

Master

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

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

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

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

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

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

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

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

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

Nome	Tipo	Descrição
`blobSource`	`BlobSource`	Dados da imagem.
`left`	`Number`	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 do 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 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

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

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

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

Nome	Tipo	Descrição
`imageUrl`	`String`	O URL da imagem.
`left`	`Number`	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 do 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 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

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

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

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

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

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

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

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

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

Nome	Tipo	Descrição
`sourceChart`	`EmbeddedChart`	O gráfico de 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 do 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 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

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

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

Nome	Tipo	Descrição
`sourceChart`	`EmbeddedChart`	O gráfico de 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 do 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 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

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

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

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

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

Nome	Tipo	Descrição
`text`	`String`	A string que a forma da caixa de texto deve conter.
`left`	`Number`	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 do 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 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

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

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

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

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

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

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