Esta página foi traduzida pela API Cloud Translation.

Class Video

Um PageElement que representa um vídeo.

Métodos

Método	Tipo de retorno	Breve descrição
`alignOnPage(alignmentPosition)`	`Video`	Alinha o elemento à posição de alinhamento especificada na página.
`bringForward()`	`Video`	Move o elemento da página para frente em um elemento.
`bringToFront()`	`Video`	Traz o elemento da página para a frente.
`duplicate()`	`PageElement`	Duplica o elemento da página.
`getBorder()`	`Border`	Retorna o `Border` do vídeo.
`getConnectionSites()`	`ConnectionSite[]`	Retorna a lista de `ConnectionSite`s no elemento da página ou uma lista vazia se o elemento da página não tiver sites de conexão.
`getDescription()`	`String`	Retorna a descrição do texto alternativo do elemento da página.
`getHeight()`	`Number`	Recebe a altura do elemento em pontos, que é a altura da caixa delimitadora do elemento quando ele não tem rotação.
`getInherentHeight()`	`Number`	Retorna a altura inerente do elemento em pontos.
`getInherentWidth()`	`Number`	Retorna a largura inerente do elemento em pontos.
`getLeft()`	`Number`	Retorna a posição horizontal do elemento em pontos, medida a partir do canto superior esquerdo da página quando o elemento não tem rotação.
`getObjectId()`	`String`	Retorna o ID exclusivo para esse objeto.
`getPageElementType()`	`PageElementType`	Retorna o tipo do elemento da página, representado como um tipo enumerado `PageElementType`.
`getParentGroup()`	`Group`	Retorna o grupo ao qual esse elemento de página pertence ou `null` se o elemento não estiver em um grupo.
`getParentPage()`	`Page`	Retorna a página em que o elemento está.
`getRotation()`	`Number`	Retorna o ângulo de rotação no sentido horário do elemento em torno do centro em graus, em que zero graus significa nenhuma rotação.
`getSource()`	`VideoSourceType`	Consegue a origem do vídeo.
`getThumbnailUrl()`	`String`	Recebe um URL para a miniatura do vídeo.
`getTitle()`	`String`	Retorna o título do texto alternativo do elemento da página.
`getTop()`	`Number`	Recebe a posição vertical do elemento em pontos, medida a partir do canto superior esquerdo da página quando o elemento não tem rotação.
`getTransform()`	`AffineTransform`	Retorna a transformação do elemento da página.
`getUrl()`	`String`	Recebe um URL para o vídeo.
`getVideoId()`	`String`	Extrai o identificador exclusivo da fonte do vídeo.
`getWidth()`	`Number`	Retorna a largura do elemento em pontos, que é a largura da caixa delimitadora do elemento quando ele não tem rotação.
`preconcatenateTransform(transform)`	`Video`	Pré-concatena a transformação fornecida à transformação atual do elemento da página.
`remove()`	`void`	Remove o elemento da página.
`scaleHeight(ratio)`	`Video`	Dimensiona a altura do elemento pela proporção especificada.
`scaleWidth(ratio)`	`Video`	Dimensiona a largura do elemento pela proporção especificada.
`select()`	`void`	Seleciona apenas o `PageElement` na apresentação ativa e remove qualquer seleção anterior.
`select(replace)`	`void`	Seleciona o `PageElement` na apresentação ativa.
`sendBackward()`	`Video`	Envia o elemento da página para trás na página por um elemento.
`sendToBack()`	`Video`	Envia o elemento da página para a parte de trás.
`setDescription(description)`	`Video`	Define a descrição do texto alternativo do elemento da página.
`setHeight(height)`	`Video`	Define a altura do elemento em pontos, que é a altura da caixa delimitadora do elemento quando ele não tem rotação.
`setLeft(left)`	`Video`	Define a posição horizontal do elemento em pontos, medida a partir do canto superior esquerdo da página quando o elemento não tem rotação.
`setRotation(angle)`	`Video`	Define o ângulo de rotação no sentido horário do elemento em torno do centro em graus.
`setTitle(title)`	`Video`	Define o título do texto alternativo do elemento da página.
`setTop(top)`	`Video`	Define a posição vertical do elemento em pontos, medida a partir do canto superior esquerdo da página quando o elemento não tem rotação.
`setTransform(transform)`	`Video`	Define a transformação do elemento da página com a transformação fornecida.
`setWidth(width)`	`Video`	Define a largura do elemento em pontos, que é a largura da caixa delimitadora do elemento quando ele não tem rotação.

Documentação detalhada

`alignOnPage(alignmentPosition)`

Alinha o elemento à posição de alinhamento especificada na página.

Parâmetros

Nome	Tipo	Descrição
`alignmentPosition`	`AlignmentPosition`	A posição em que alinhar esse elemento na página.

Retornar

Video: este elemento da página, para encadeamento.

`bringForward()`

Move o elemento da página para frente em um elemento.

O elemento de página não pode estar em um grupo.

Retornar

Video: este elemento da página, para encadeamento.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

`bringToFront()`

Traz o elemento da página para a frente.

O elemento de página não pode estar em um grupo.

Retornar

Video: este elemento da página, para encadeamento.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

`duplicate()`

Duplica o elemento da página.

O elemento de página duplicado é colocado na mesma página e na mesma posição que o original.

Retornar

PageElement: a nova cópia desse elemento da página.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

`getBorder()`

Retorna o Border do vídeo.

Retornar

Border: a configuração de borda para este vídeo.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

`getConnectionSites()`

Retorna a lista de ConnectionSites no elemento da página ou uma lista vazia se o elemento da página não tiver sites de conexão.

Retornar

ConnectionSite[]: a lista de sites de conexão, que pode estar vazia se o elemento não tiver sites de conexão.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

`getDescription()`

Retorna a descrição do texto alternativo do elemento da página. A descrição é combinada com o título para exibir e ler o texto alternativo.

Retornar

String: a descrição do texto alternativo do elemento da página.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

`getHeight()`

Recebe a altura do elemento em pontos, que é a altura da caixa delimitadora do elemento quando ele não tem rotação.

Esse método não é compatível com todos os elementos da página. Para saber quais elementos da página não são compatíveis com esse método, consulte as limitações de dimensionamento e posicionamento.

Retornar

Number: a altura inerente do elemento da página em pontos ou null se o elemento da página não tiver altura.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

`getInherentHeight()`

Retorna a altura inerente do elemento em pontos.

A transformação do elemento da página é relativa ao tamanho inerente dele. Use o tamanho inerente em conjunto com a transformação do elemento para determinar a aparência visual final dele.

Retornar

Number: a altura inerente do elemento da página em pontos ou null se o elemento da página não tiver altura.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

`getInherentWidth()`

Retorna a largura inerente do elemento em pontos.

A transformação do elemento da página é relativa ao tamanho inerente dele. Use o tamanho inerente em conjunto com a transformação do elemento para determinar a aparência visual final dele.

Retornar

Number: a largura inerente do elemento de página em pontos ou null se o elemento de página não tiver largura.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

`getLeft()`

Retorna a posição horizontal do elemento em pontos, medida a partir do canto superior esquerdo da página quando o elemento não tem rotação.

Retornar

Number: a posição horizontal desse elemento em pontos, a partir do canto superior esquerdo da página.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

`getObjectId()`

Retorna o ID exclusivo para esse objeto. Os IDs de objeto usados por páginas e elementos de página compartilham o mesmo namespace.

Retornar

String: o ID exclusivo para esse objeto.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

`getPageElementType()`

Retorna o tipo do elemento da página, representado como um tipo enumerado PageElementType.

Retornar

PageElementType: o tipo do elemento da página.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

`getParentGroup()`

Retorna o grupo ao qual esse elemento de página pertence ou null se o elemento não estiver em um grupo.

Retornar

Group: o grupo ao qual o elemento da página pertence ou null.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

`getParentPage()`

Retorna a página em que o elemento está.

Retornar

Page: a página em que o elemento está.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

`getRotation()`

Retorna o ângulo de rotação no sentido horário do elemento em torno do centro em graus, em que zero graus significa nenhuma rotação.

Retornar

Number: é o ângulo de rotação em graus entre 0 (inclusive) e 360 (exclusivo).

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

`getSource()`

Consegue a origem do vídeo.

Retornar

VideoSourceType: a origem do vídeo.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

`getThumbnailUrl()`

Recebe um URL para a miniatura do vídeo. Esse URL é marcado com a conta do solicitante. Qualquer pessoa com o URL acessa a miniatura como o requerente original. O acesso à miniatura pode ser perdido se as configurações de compartilhamento da apresentação forem alteradas. O URL expira após um curto período.

Retornar

String: é o URL da miniatura do vídeo.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

`getTitle()`

Retorna o título do texto alternativo do elemento da página. O título é combinado com a descrição para exibir e ler o texto alternativo.

Retornar

String: o título do texto alternativo do elemento da página.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

`getTop()`

Recebe a posição vertical do elemento em pontos, medida a partir do canto superior esquerdo da página quando o elemento não tem rotação.

Retornar

Number: a posição vertical desse elemento em pontos, a partir do canto superior esquerdo da página.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

`getTransform()`

Retorna a transformação do elemento da página.

A aparência visual do elemento da página é determinada pela transformação absoluta. Para calcular a transformação absoluta, pré-concatene a transformação de um elemento da página com as transformações de todos os grupos pais. Se o elemento da página não estiver em um grupo, a transformação absoluta será igual ao valor nesse campo.

Retornar

AffineTransform: a transformação do elemento da página.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

`getUrl()`

Recebe um URL para o vídeo. O URL é válido enquanto o vídeo de origem existir e as configurações de compartilhamento não mudarem. Retorna null quando a fonte de vídeo não é compatível.

Retornar

String: o URL do vídeo ou null se a origem do vídeo não for compatível.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

`getVideoId()`

Extrai o identificador exclusivo da fonte do vídeo.

Retornar

String: o ID de origem do vídeo.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

`getWidth()`

Retorna a largura do elemento em pontos, que é a largura da caixa delimitadora do elemento quando ele não tem rotação.

Retornar

Number: a largura inerente do elemento de página em pontos ou null se o elemento de página não tiver largura.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

`preconcatenateTransform(transform)`

Pré-concatena a transformação fornecida à transformação atual do elemento da página.

newTransform = argument * existingTransform;

Por exemplo, para mover um elemento da página 36 pontos para a esquerda:

const element = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
element.preconcatenateTransform(
    SlidesApp.newAffineTransformBuilder().setTranslateX(-36.0).build(),
);

Também é possível substituir a transformação do elemento da página por setTransform(transform).

Parâmetros

Nome	Tipo	Descrição
`transform`	`AffineTransform`	A transformação a ser pré-concatenada na transformação do elemento da página.

Retornar

Video: este elemento da página, para encadeamento.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

`remove()`

Remove o elemento da página.

Se, após uma operação de remoção, um Group tiver apenas um ou nenhum elemento da página, o grupo também será removido.

Se um marcador de posição PageElement for removido em um mestre ou layout, todos os marcadores de posição vazios herdados também serão removidos.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

`scaleHeight(ratio)`

Dimensiona a altura do elemento pela proporção especificada. A altura do elemento é a altura da caixa delimitadora quando o elemento não tem rotação.

Parâmetros

Nome	Tipo	Descrição
`ratio`	`Number`	A proporção para dimensionar a altura desse elemento da página.

Retornar

Video: este elemento da página, para encadeamento.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

`scaleWidth(ratio)`

Dimensiona a largura do elemento pela proporção especificada. A largura do elemento é a largura da caixa delimitadora quando o elemento não tem rotação.

Parâmetros

Nome	Tipo	Descrição
`ratio`	`Number`	A proporção para dimensionar a largura desse elemento da página.

Retornar

Video: este elemento da página, para encadeamento.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

`select()`

Seleciona apenas o PageElement na apresentação ativa e remove qualquer seleção anterior. Isso é o mesmo que chamar select(replace) com true.

Um script só pode acessar a seleção do usuário que está executando o script e somente se ele estiver vinculado à apresentação.

Isso define a Page pai da PageElement como a current page selection.

const slide = SlidesApp.getActivePresentation().getSlides()[0];
const pageElement = slide.getPageElements()[0];
// Only select this page element and replace any previous selection.
pageElement.select();

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

`select(replace)`

Seleciona o PageElement na apresentação ativa.

Um script só pode acessar a seleção do usuário que está executando o script e somente se ele estiver vinculado à apresentação.

Transmita true para este método para selecionar apenas o PageElement e remover qualquer seleção anterior. Isso também define o Page pai do PageElement como o current page selection.

Transmita false para selecionar vários objetos PageElement. Os objetos PageElement precisam estar no mesmo Page.

As seguintes condições precisam ser atendidas ao selecionar um elemento da página usando um parâmetro false:

O Page pai do objeto PageElement precisa ser o current page selection.
Não devem haver vários objetos Page selecionados.

Para garantir que esse seja o caso, a abordagem recomendada é selecionar a Page pai primeiro usando Page.selectAsCurrentPage() e, em seguida, selecionar os elementos da página.

const slide = SlidesApp.getActivePresentation().getSlides()[0];
// First select the slide page, as the current page selection.
slide.selectAsCurrentPage();
// Then select all the page elements in the selected slide page.
const pageElements = slide.getPageElements();
for (let i = 0; i < pageElements.length; i++) {
  pageElements[i].select(false);
}

Parâmetros

Nome	Tipo	Descrição
`replace`	`Boolean`	Se `true`, a seleção substitui qualquer seleção anterior. Caso contrário, a seleção é adicionada a qualquer seleção anterior.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

`sendBackward()`

Envia o elemento da página para trás na página por um elemento.

O elemento de página não pode estar em um grupo.

Retornar

Video: este elemento da página, para encadeamento.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

`sendToBack()`

Envia o elemento da página para a parte de trás.

O elemento de página não pode estar em um grupo.

Retornar

Video: este elemento da página, para encadeamento.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

`setDescription(description)`

Define a descrição do texto alternativo do elemento da página.

O método não é compatível com elementos Group.

// Set the first page element's alt text description to "new alt text
// description".
const pageElement =
    SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
pageElement.setDescription('new alt text description');
Logger.log(pageElement.getDescription());

Parâmetros

Nome	Tipo	Descrição
`description`	`String`	A string para definir a descrição do texto alternativo.

Retornar

Video: este elemento da página.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

`setHeight(height)`

Define a altura do elemento em pontos, que é a altura da caixa delimitadora do elemento quando ele não tem rotação.

Parâmetros

Nome	Tipo	Descrição
`height`	`Number`	A nova altura desse elemento da página a ser definida, em pontos.

Retornar

Video: este elemento da página, para encadeamento.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

`setLeft(left)`

Define a posição horizontal do elemento em pontos, medida a partir do canto superior esquerdo da página quando o elemento não tem rotação.

Parâmetros

Nome	Tipo	Descrição
`left`	`Number`	A nova posição horizontal a ser definida, em pontos.

Retornar

Video: este elemento da página, para encadeamento.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

`setRotation(angle)`

Define o ângulo de rotação no sentido horário do elemento em torno do centro em graus.

Parâmetros

Nome	Tipo	Descrição
`angle`	`Number`	O novo ângulo de rotação no sentido horário a ser definido, em graus.

Retornar

Video: este elemento da página, para encadeamento.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

`setTitle(title)`

Define o título do texto alternativo do elemento da página.

O método não é compatível com elementos Group.

// Set the first page element's alt text title to "new alt text title".
const pageElement =
    SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
pageElement.setTitle('new alt text title');
Logger.log(pageElement.getTitle());

Parâmetros

Nome	Tipo	Descrição
`title`	`String`	A string para definir o título do texto alternativo.

Retornar

Video: este elemento da página.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

`setTop(top)`

Define a posição vertical do elemento em pontos, medida a partir do canto superior esquerdo da página quando o elemento não tem rotação.

Parâmetros

Nome	Tipo	Descrição
`top`	`Number`	A nova posição vertical a ser definida, em pontos.

Retornar

Video: este elemento da página, para encadeamento.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

`setTransform(transform)`

Define a transformação do elemento da página com a transformação fornecida.

Atualizar a transformação de um grupo muda a transformação absoluta dos elementos da página nesse grupo, o que pode mudar a aparência visual deles.

Atualizar a transformação de um elemento de página que está em um grupo só muda a transformação desse elemento, não afeta as transformações do grupo ou de outros elementos de página no grupo.

Para saber como as transformações afetam a aparência visual dos elementos da página, consulte getTransform().

Parâmetros

Nome	Tipo	Descrição
`transform`	`AffineTransform`	A transformação definida para esse elemento da página.

Retornar

Video: este elemento, para encadeamento.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

`setWidth(width)`

Define a largura do elemento em pontos, que é a largura da caixa delimitadora do elemento quando ele não tem rotação.

Parâmetros

Nome	Tipo	Descrição
`width`	`Number`	A nova largura desse elemento da página a ser definida, em pontos.

Retornar

Video: este elemento da página, para encadeamento.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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