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()
getImages()
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()
getMaster()
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
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()
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
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
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
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()
getSheetsCharts()
Retorna a lista de objetos SheetsChart na página.
Retornar
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()
getVideos()
getWordArts()
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.
A inserção da imagem faz com que ela seja buscada no URL uma vez, e uma cópia é armazenada para exibição no apresentação. As imagens devem ter menos de 50 MB, não podem exceder 25 megapixels e devem ter nos formatos PNG, JPEG ou GIF.
O URL fornecido precisa ser acessível publicamente e não pode ter mais de 2 KB. O URL é salvo.
com a imagem e exposta por Image.getSourceUrl().
Para manter a proporção da imagem, ela é dimensionada e centralizada em relação ao tamanho fornecido.
Parâmetros
| 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