Um slide em uma apresentação.
Essas páginas incluem o conteúdo que você apresenta ao público. A maioria dos slides é baseada um mestre e um layout. Você pode especificar qual layout usar para cada slide quando ele for criado.
Métodos
Método | Tipo de retorno | Breve descrição |
---|---|---|
duplicate() | Slide | Duplica o slide. |
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. |
getLayout() | Layout | Recebe o layout em que o slide se baseia ou null se o slide não é baseado em uma
o mesmo layout organizacional. |
getLines() | Line[] | Retorna a lista de objetos Line na página. |
getNotesPage() | NotesPage | Retorna a página de notas associada ao slide. |
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 o marcador 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. |
getSlideLinkingMode() | SlideLinkingMode | Retorna uma SlideLinkingMode que indica se o slide está vinculado a outro slide. |
getSourcePresentationId() | String | Retorna o ID da Presentation de origem ou null se o slide não estiver vinculado. |
getSourceSlideObjectId() | String | Retorna o ID do slide de origem ou null se o slide não estiver vinculado. |
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 no 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 das 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. |
isSkipped() | Boolean | Mostra se o slide foi ignorado no modo de apresentação. |
move(index) | void | Move o slide para o índice especificado. |
refreshSlide() | void | Atualiza o slide para refletir as alterações feitas no slide de origem vinculado. |
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. |
setSkipped(isSkipped) | void | Define se o slide será ignorado no modo de apresentação. |
unlink() | void | Desvincula o Slide atual do slide de origem. |
Documentação detalhada
duplicate()
Duplica o slide.
O slide duplicado é criado imediatamente após o original.
Retornar
Slide
: o slide duplicado.
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
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()
getLayout()
Recebe o layout em que o slide se baseia ou null
se o slide não é baseado em um
o mesmo layout organizacional.
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
getLines()
getNotesPage()
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 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
getSlideLinkingMode()
Retorna uma SlideLinkingMode
que indica se o slide está vinculado a outro slide.
Retornar
SlideLinkingMode
: é o modo de vinculação de slides.
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
getSourcePresentationId()
Retorna o ID da Presentation
de origem ou null
se o slide não estiver vinculado.
Um slide só tem um ID Presentation
de origem quando está vinculado a um slide em
outra apresentação.
Retornar
String
: o ID da apresentação de origem ou null
.
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
getSourceSlideObjectId()
Retorna o ID do slide de origem ou null
se o slide não estiver vinculado.
Um slide só tem um ID de slide de origem quando está vinculado a um slide de outra apresentação.
Retornar
String
: o ID do slide de origem ou null
.
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 a partir do 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 a partir do 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 a partir do 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 a partir do 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 a partir do 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
isSkipped()
Mostra se o slide foi ignorado no modo de apresentação.
Retornar
Boolean
— True
se o slide for pulado no modo de apresentação.
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
move(index)
Move o slide para o índice especificado.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
index | Integer | O índice para onde o slide deve ser movido, com base na organização dos slides antes da mudança. O índice deve estar entre zero e o número de slides do apresentação inclusiva. |
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
refreshSlide()
Atualiza o slide para refletir as alterações feitas no slide de origem vinculado. Se este slide for não vinculado, retorna sem fazer alterações.
O método refreshSlide
copia o mestre correspondente do slide de origem vinculado e
páginas de layout na apresentação do slide se elas ainda não existirem. Se já tiverem
existem, elas são atualizadas da mesma forma para refletir as alterações feitas na origem.
var currentPresentation = SlidesApp.getActivePresentation(); var sourcePresentation = SlidesApp.openById('sourcePresentationId'); var sourceSlide = sourcePresentation.getSlides()[0]; var linkedSlide = currentPresentation.append(sourceSlide, SlidesApp.SlideLinkingMode.LINKED); sourceSlide.insertText('hello world'); // Only the source slide has the text box. linkedSlide.refreshSlide(); // The linked slide now has the text box.
Gera
Error
: se o acesso de leitura à apresentação original não estiver mais disponível.
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
setSkipped(isSkipped)
Define se o slide será ignorado no modo de apresentação.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
isSkipped | Boolean | True para pular o slide no modo de apresentação. |
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
unlink()
Desvincula o Slide
atual do slide de origem. Se este slide não estiver vinculado,
sem fazer alterações.
var currentPresentation = SlidesApp.getActivePresentation(); var sourcePresentation = SlidesApp.openById('sourcePresentationId'); var sourceSlide = sourcePresentation.getSlides()[0]; var linkedSlide = currentPresentation.append(sourceSlide, SlidesApp.SlideLinkingMode.LINKED); linkedSlide.unlink(); linkedSlide.getSourcePresentationId(); // returns null linkedSlide.getSourceSlideObjectId(); // returns null linkedSlide.getSlideLinkingMode(); // returns SlidesApp.SlideLinkingMode.NOT_LINKED
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