Esta página foi traduzida pela API Cloud Translation.

Class File

Um arquivo no Google Drive. Os arquivos podem ser acessados ou criados a partir de DriveApp.

// Trash every untitled spreadsheet that hasn't been updated in a week.
var files = DriveApp.getFilesByName('Untitled spreadsheet');
while (files.hasNext()) {
  var file = files.next();
  if (new Date() - file.getLastUpdated() > 7 * 24 * 60 * 60 * 1000) {
    file.setTrashed(true);
  }
}

Métodos

Método	Tipo de retorno	Breve descrição
`addCommenter(emailAddress)`	`File`	Adiciona o usuário especificado à lista de comentadores de `File`.
`addCommenter(user)`	`File`	Adiciona o usuário especificado à lista de comentadores de `File`.
`addCommenters(emailAddresses)`	`File`	Adiciona a matriz fornecida de usuários à lista de comentadores de `File`.
`addEditor(emailAddress)`	`File`	Adiciona o usuário especificado à lista de editores do `File`.
`addEditor(user)`	`File`	Adiciona o usuário especificado à lista de editores do `File`.
`addEditors(emailAddresses)`	`File`	Adiciona a matriz de usuários especificada à lista de editores do `File`.
`addViewer(emailAddress)`	`File`	Adiciona o usuário especificado à lista de visualizadores para o `File`.
`addViewer(user)`	`File`	Adiciona o usuário especificado à lista de visualizadores para o `File`.
`addViewers(emailAddresses)`	`File`	Adiciona a matriz de usuários especificada à lista de visualizadores para o `File`.
`getAccess(email)`	`Permission`	Recebe a permissão concedida ao usuário especificado.
`getAccess(user)`	`Permission`	Recebe a permissão concedida ao usuário especificado.
`getAs(contentType)`	`Blob`	Retorna os dados dentro desse objeto como um blob convertido para o tipo de conteúdo especificado.
`getBlob()`	`Blob`	Retorne os dados dentro desse objeto como um blob.
`getDateCreated()`	`Date`	Recebe a data em que o `File` foi criado.
`getDescription()`	`String`	Recebe a descrição do `File`.
`getDownloadUrl()`	`String`	Recebe o URL que pode ser usado para fazer o download do arquivo.
`getEditors()`	`User[]`	Recebe a lista de editores para esse `File`.
`getId()`	`String`	Recebe o ID de `File`.
`getLastUpdated()`	`Date`	Recebe a data da última atualização do `File`.
`getMimeType()`	`String`	Recebe o tipo MIME do arquivo.
`getName()`	`String`	Recebe o nome do `File`.
`getOwner()`	`User`	Recebe o proprietário do `File`.
`getParents()`	`FolderIterator`	Recebe um conjunto de pastas mães imediatas do `File`.
`getResourceKey()`	`String`	Recebe a chave de recurso do `File` que é necessária para acessar os itens que foram compartilhados usando um link.
`getSecurityUpdateEligible()`	`Boolean`	Determina se `File` está qualificado para aplicar a atualização de segurança que exige uma chave de recurso para acesso quando ela é compartilhada usando um link.
`getSecurityUpdateEnabled()`	`Boolean`	Recebe se essa `File` exige uma chave de recurso para acesso quando é compartilhada usando um link.
`getSharingAccess()`	`Access`	Recebe qual classe de usuários pode acessar o `File`, além de todos os usuários individuais que receberam acesso explicitamente.
`getSharingPermission()`	`Permission`	Recebe a permissão concedida a usuários que podem acessar o `File`, além de todos os usuários individuais que receberam acesso explicitamente.
`getSize()`	`Integer`	Recebe o número de bytes usados para armazenar o `File` no Drive.
`getTargetId()`	`String`	Se este for um atalho, retornará o ID do item para o qual ele aponta.
`getTargetMimeType()`	`String`	Se este for um atalho, retornará o tipo MIME do item para o qual ele aponta.
`getTargetResourceKey()`	`String`	Se o arquivo for um atalho, a chave de recurso do item para o qual ela aponta será retornada.
`getThumbnail()`	`Blob`	Recebe uma imagem em miniatura para o arquivo ou `null`, se não houver miniatura.
`getUrl()`	`String`	Recebe o URL que pode ser usado para abrir o `File` em um app do Google, como o Drive ou o Documentos.
`getViewers()`	`User[]`	Recebe a lista de leitores e comentaristas desta `File`.
`isShareableByEditors()`	`Boolean`	Determina se os usuários com permissões para edição da `File` podem compartilhar com outros usuários ou mudar as permissões.
`isStarred()`	`Boolean`	Determina se o `File` foi marcado com estrela no Drive do usuário.
`isTrashed()`	`Boolean`	Determina se o `File` está na lixeira do Drive do usuário.
`makeCopy()`	`File`	Cria uma cópia do arquivo.
`makeCopy(destination)`	`File`	Cria uma cópia do arquivo no diretório de destino.
`makeCopy(name)`	`File`	Cria uma cópia do arquivo e nomeia com o nome fornecido.
`makeCopy(name, destination)`	`File`	Cria uma cópia do arquivo no diretório de destino com o nome fornecido.
`moveTo(destination)`	`File`	Move esse item para a pasta de destino fornecida.
`removeCommenter(emailAddress)`	`File`	Remove o usuário da lista de comentaristas da `File`.
`removeCommenter(user)`	`File`	Remove o usuário da lista de comentaristas da `File`.
`removeEditor(emailAddress)`	`File`	Remove o usuário em questão da lista de editores do `File`.
`removeEditor(user)`	`File`	Remove o usuário em questão da lista de editores do `File`.
`removeViewer(emailAddress)`	`File`	Remove o usuário da lista de leitores e comentaristas da `File`.
`removeViewer(user)`	`File`	Remove o usuário da lista de leitores e comentaristas da `File`.
`revokePermissions(emailAddress)`	`File`	Revoga o acesso ao `File` concedido ao usuário especificado.
`revokePermissions(user)`	`File`	Revoga o acesso ao `File` concedido ao usuário especificado.
`setContent(content)`	`File`	Substitui o conteúdo do arquivo por uma determinada substituição.
`setDescription(description)`	`File`	Define a descrição de `File`.
`setName(name)`	`File`	Define o nome do `File`.
`setOwner(emailAddress)`	`File`	Altera o proprietário do `File`.
`setOwner(user)`	`File`	Altera o proprietário do `File`.
`setSecurityUpdateEnabled(enabled)`	`File`	Define se o `File` exige uma chave de recurso para acesso quando for compartilhado usando um link.
`setShareableByEditors(shareable)`	`File`	Define se os usuários com permissão para edição a `File` têm permissão para compartilhar com outros usuários ou mudar as permissões.
`setSharing(accessType, permissionType)`	`File`	Define qual classe de usuários pode acessar o `File` e quais permissões eles recebem, além de qualquer usuário individual que tenha recebido explicitamente o acesso.
`setStarred(starred)`	`File`	Define se o `File` é marcado com estrela no Drive do usuário.
`setTrashed(trashed)`	`File`	Define se o `File` está na lixeira do Drive do usuário.

Documentação detalhada

`addCommenter(emailAddress)`

Adiciona o usuário especificado à lista de comentadores de File. Se o usuário já estiver na lista de espectadores, esse método o promoverá fora da lista.

Parâmetros

Nome	Tipo	Descrição
`emailAddress`	`String`	Endereço de e-mail do usuário a ser adicionado.

Retornar

File: este File, 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/drive

`addCommenter(user)`

Adiciona o usuário especificado à lista de comentadores de File. Se o usuário já estiver na lista de espectadores, esse método o promoverá fora da lista.

Parâmetros

Nome	Tipo	Descrição
`user`	`User`	Uma representação do usuário a ser adicionado.

Retornar

File: este File, 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/drive

`addCommenters(emailAddresses)`

Adiciona a matriz fornecida de usuários à lista de comentadores de File. Se algum dos usuários já estiver na lista de espectadores, esse método os promoverá fora da lista de visualizadores.

Parâmetros

Nome	Tipo	Descrição
`emailAddresses`	`String[]`	Uma matriz de endereços de e-mail dos usuários a serem adicionados.

Retornar

File: este File, 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/drive

`addEditor(emailAddress)`

Adiciona o usuário especificado à lista de editores do File. Se o usuário já estiver na lista de espectadores, esse método o promoverá fora da lista.

Parâmetros

Nome	Tipo	Descrição
`emailAddress`	`String`	Endereço de e-mail do usuário a ser adicionado.

Retornar

File: este File, 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/drive

`addEditor(user)`

Adiciona o usuário especificado à lista de editores do File. Se o usuário já estiver na lista de espectadores, esse método o promoverá fora da lista.

Parâmetros

Nome	Tipo	Descrição
`user`	`User`	Uma representação do usuário a ser adicionado.

Retornar

File: este File, 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/drive

`addEditors(emailAddresses)`

Adiciona a matriz de usuários especificada à lista de editores do File. Se algum dos usuários já estiver na lista de visualizadores, esse método os promoverá fora da lista de visualizadores.

Parâmetros

Nome	Tipo	Descrição
`emailAddresses`	`String[]`	Uma matriz de endereços de e-mail dos usuários a serem adicionados.

Retornar

File: este File, 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/drive

`addViewer(emailAddress)`

Adiciona o usuário especificado à lista de visualizadores para o File. Esse método não terá efeito se o usuário já estiver na lista de editores.

Parâmetros

Nome	Tipo	Descrição
`emailAddress`	`String`	Endereço de e-mail do usuário a ser adicionado.

Retornar

File: este File, 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/drive

`addViewer(user)`

Adiciona o usuário especificado à lista de visualizadores para o File. Esse método não terá efeito se o usuário já estiver na lista de editores.

Parâmetros

Nome	Tipo	Descrição
`user`	`User`	Uma representação do usuário a ser adicionado.

Retornar

File: este File, 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/drive

`addViewers(emailAddresses)`

Adiciona a matriz de usuários especificada à lista de visualizadores para o File. Se algum dos usuários já estiver na lista de editores, esse método não vai ter efeito para eles.

Parâmetros

Nome	Tipo	Descrição
`emailAddresses`	`String[]`	Uma matriz de endereços de e-mail dos usuários a serem adicionados.

Retornar

File: este File, 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/drive

`getAccess(email)`

Recebe a permissão concedida ao usuário especificado.

Parâmetros

Nome	Tipo	Descrição
`email`	`String`	o endereço de e-mail do usuário cujas permissões devem ser verificadas

Retornar

Permission: as permissões concedidas ao usuário

Autorização

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

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getAccess(user)`

Recebe a permissão concedida ao usuário especificado.

Parâmetros

Nome	Tipo	Descrição
`user`	`User`	uma representação do usuário cujas permissões devem ser verificadas

Retornar

Permission: as permissões concedidas ao usuário

Autorização

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

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getAs(contentType)`

Retorna os dados dentro desse objeto como um blob convertido para o tipo de conteúdo especificado. Esse método adiciona a extensão apropriada ao nome do arquivo, por exemplo, "meuarquivo.pdf". No entanto, supõe que a parte do nome do arquivo que segue o último ponto (se houver) é uma extensão existente que precisa ser substituída. Consequentemente, "ShoppingList.12.25.2014" se tornará "ShoppingList.12.25.pdf".

Para ver as cotas diárias de conversões, consulte Cotas para serviços do Google. Os domínios do Google Workspace recém-criados podem estar temporariamente sujeitos a cotas mais rígidas.

Parâmetros

Nome	Tipo	Descrição
`contentType`	`String`	O tipo MIME para conversão. Para a maioria dos blobs, `'application/pdf'` é a única opção válida. Para imagens no formato BMP, GIF, JPEG ou PNG, qualquer um dos `'image/bmp'`, `'image/gif'`, `'image/jpeg'` ou `'image/png'` também é válido.

Retornar

Blob: os dados como um blob.

`getBlob()`

Retorne os dados dentro desse objeto como um blob.

Retornar

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getSecurityUpdateEligible()`

Determina se File está qualificado para aplicar a atualização de segurança que exige uma chave de recurso para acesso quando ela é compartilhada usando um link.

O Drive exige uma chave de recurso para acessar alguns arquivos ou pastas que foram compartilhados usando um link. Essa mudança faz parte de uma atualização de segurança. A atualização é ativada por padrão para pastas e arquivos qualificados. Para ativar ou desativar o requisito de chave de recurso para arquivos qualificados, use setSecurityUpdateEnabled.

Saiba mais sobre a atualização de segurança do Google Drive.

Retornar

Boolean: se o requisito de chave de recurso pode ser aplicado ao File.

Autorização

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

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getSecurityUpdateEnabled()`

Recebe se essa File exige uma chave de recurso para acesso quando é compartilhada usando um link. Esse requisito é ativado por padrão para pastas e arquivos qualificados. Para ativar ou desativar o requisito de chave de recurso para arquivos qualificados, use setSecurityUpdateEnabled.

Saiba mais sobre a atualização de segurança do Google Drive.

Retornar

Boolean: se o requisito de chave de recurso está ativado para esse File.

Autorização

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

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getSharingAccess()`

Recebe qual classe de usuários pode acessar o File, além de todos os usuários individuais que receberam acesso explicitamente.

Retornar

Access: qual classe de usuários pode acessar o File.

Autorização

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

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getSharingPermission()`

Recebe a permissão concedida a usuários que podem acessar o File, além de todos os usuários individuais que receberam acesso explicitamente.

Retornar

Permission: as permissões concedidas aos usuários que podem acessar o File

Autorização

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

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getSize()`

Recebe o número de bytes usados para armazenar o File no Drive. Os arquivos de aplicativos do Google Workspace não são contabilizados nos limites de armazenamento do Drive e, por isso, retornam 0 bytes.

Retornar

Integer: o número de bytes usados para armazenar o File no Drive.

Autorização

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

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getTargetId()`

Se este for um atalho, retornará o ID do item para o qual ele aponta.

Caso contrário, ele retorna null.

Retornar

String: o código do item de destino.

`getTargetMimeType()`

Se este for um atalho, retornará o tipo MIME do item para o qual ele aponta.

Caso contrário, ele retorna null.

Retornar

String: o tipo MIME do item de destino.

`getTargetResourceKey()`

Se o arquivo for um atalho, a chave de recurso do item para o qual ela aponta será retornada. As chaves de recurso são um parâmetro adicional que precisa ser transmitido para acessar arquivos que foram compartilhados usando um link.

Se o arquivo não for um atalho, ele retornará null.

Retornar

String: a chave de recurso do item de destino ou null se o arquivo não for um atalho.

Autorização

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

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getThumbnail()`

Recebe uma imagem em miniatura para o arquivo ou null, se não houver miniatura.

Retornar

Blob: a imagem em miniatura do arquivo.

Autorização

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

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getUrl()`

Recebe o URL que pode ser usado para abrir o File em um app do Google, como o Drive ou o Documentos.

Retornar

String: o URL que pode ser usado para ver este File em um app do Google como Drive ou Documentos

Autorização

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

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`getViewers()`

Recebe a lista de leitores e comentaristas desta File. Se o usuário que executar o script não tiver acesso para editar a File, esse método retornará uma matriz vazia.

Retornar

User[]: uma matriz de usuários com permissão para visualização ou comentário.

Autorização

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

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`isShareableByEditors()`

Determina se os usuários com permissões para edição da File podem compartilhar com outros usuários ou mudar as permissões.

Retornar

Boolean: true se os usuários com permissões para edição tiverem permissão para compartilhar com outros usuários ou mudar as permissões. false se não tiverem permissã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/drive.readonly
https://www.googleapis.com/auth/drive

`isStarred()`

Determina se o File foi marcado com estrela no Drive do usuário.

Retornar

Boolean: true se File estiver marcado com estrela no Google Drive do usuário; false se não estiver marcado

Autorização

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

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`isTrashed()`

Determina se o File está na lixeira do Drive do usuário.

Retornar

Boolean: true se File estiver na lixeira do Drive do usuário. false se não estiver

Autorização

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

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

`makeCopy()`

Cria uma cópia do arquivo.

Retornar

File: a nova cópia.

Autorização

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

https://www.googleapis.com/auth/drive

`makeCopy(destination)`

Cria uma cópia do arquivo no diretório de destino.

Parâmetros

Nome	Tipo	Descrição
`destination`	`Folder`	Diretório em que o arquivo será copiado.

Retornar

File: a nova cópia.

Autorização

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

https://www.googleapis.com/auth/drive

`makeCopy(name)`

Cria uma cópia do arquivo e nomeia com o nome fornecido.

Parâmetros

Nome	Tipo	Descrição
`name`	`String`	O nome do arquivo a ser aplicado à cópia nova.

Retornar

File: a nova cópia.

Autorização

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

https://www.googleapis.com/auth/drive

`makeCopy(name, destination)`

Cria uma cópia do arquivo no diretório de destino com o nome fornecido.

Parâmetros

Nome	Tipo	Descrição
`name`	`String`	O nome do arquivo a ser aplicado à cópia nova.
`destination`	`Folder`	Diretório em que o arquivo será copiado.

Retornar

File: a nova cópia.

Autorização

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

https://www.googleapis.com/auth/drive

`moveTo(destination)`

Move esse item para a pasta de destino fornecida.

O usuário atual precisa ser o proprietário do arquivo ou ter pelo menos acesso para editar à pasta atual do item para mover o item para a pasta de destino.

Parâmetros

Nome	Tipo	Descrição
`destination`	`Folder`	A pasta que se torna o novo pai.

Retornar

File: este File, 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/drive

`removeCommenter(emailAddress)`

Remove o usuário da lista de comentaristas da File. Esse método não impede que os usuários acessem o File se pertencerem a uma classe de usuários com acesso geral. Por exemplo, se o File for compartilhado com todo o domínio do usuário.

Parâmetros

Nome	Tipo	Descrição
`emailAddress`	`String`	Endereço de e-mail do usuário a ser removido.

Retornar

File: este File, 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/drive

`removeCommenter(user)`

Parâmetros

Nome	Tipo	Descrição
`user`	`User`	Uma representação do usuário a ser removido.

Retornar

File: este File, 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/drive

`removeEditor(emailAddress)`

Remove o usuário em questão da lista de editores do File. Esse método não impede que os usuários acessem o File se pertencerem a uma classe de usuários com acesso geral, por exemplo, se o File for compartilhado com todo o domínio do usuário ou se File estiver em um drive compartilhado que o usuário possa acessar.

No caso de arquivos do Drive, isso também remove o usuário da lista de leitores.

Parâmetros

Nome	Tipo	Descrição
`emailAddress`	`String`	Endereço de e-mail do usuário a ser removido.

Retornar

File: este File, 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/drive

`removeEditor(user)`

No caso de arquivos do Drive, isso também remove o usuário da lista de leitores.

Parâmetros

Nome	Tipo	Descrição
`user`	`User`	Uma representação do usuário a ser removido.

Retornar

File: este File, 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/drive

`removeViewer(emailAddress)`

Remove o usuário da lista de leitores e comentaristas da File. Esse método não terá efeito se o usuário for um editor, não um leitor ou comentarista. Esse método também não impede que os usuários acessem o File se pertencerem a uma classe de usuários que tenham acesso geral, por exemplo, se o File for compartilhado com todo o domínio do usuário ou se File estiver em um drive compartilhado que o usuário possa acessar.

Nos arquivos do Drive, essa ação também remove o usuário da lista de editores.

Parâmetros

Nome	Tipo	Descrição
`emailAddress`	`String`	Endereço de e-mail do usuário a ser removido.

Retornar

File: este File para encadeamentos.

Autorização

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

https://www.googleapis.com/auth/drive

`removeViewer(user)`

Remove o usuário da lista de leitores e comentaristas da File. Esse método não terá efeito se o usuário for um editor, não um leitor. Esse método também não impede que os usuários acessem o File se pertencerem a uma classe de usuários com acesso geral. Por exemplo, se o File for compartilhado com todo o domínio do usuário ou se o File estiver em um drive compartilhado que o usuário pode acessar.

Nos arquivos do Drive, essa ação também remove o usuário da lista de editores.

Parâmetros

Nome	Tipo	Descrição
`user`	`User`	Uma representação do usuário a ser removido.

Retornar

File: este File para encadeamentos.

Autorização

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

https://www.googleapis.com/auth/drive

`revokePermissions(emailAddress)`

Revoga o acesso ao File concedido ao usuário especificado. Esse método não impede que os usuários acessem o File se pertencerem a uma classe de usuários que tenham acesso geral, por exemplo, se o File for compartilhado com todo o domínio do usuário.

Parâmetros

Nome	Tipo	Descrição
`emailAddress`	`String`	O endereço de e-mail do usuário cujo acesso deve ser revogado.

Retornar

File: este File, 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/drive

`revokePermissions(user)`

Parâmetros

Nome	Tipo	Descrição
`user`	`User`	Uma representação do usuário cujo acesso deve ser revogado.

Retornar

File: este File, 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/drive

`setContent(content)`

Substitui o conteúdo do arquivo por uma determinada substituição. Emite uma exceção se content for maior que 10 MB.

Parâmetros

Nome	Tipo	Descrição
`content`	`String`	O novo conteúdo do arquivo.

Retornar

File: este File, 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/drive

`setDescription(description)`

Define a descrição de File.

Parâmetros

Nome	Tipo	Descrição
`description`	`String`	a nova descrição de `File`

Retornar

File: este File para encadeamentos

Autorização

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

https://www.googleapis.com/auth/drive

`setName(name)`

Define o nome do File.

Parâmetros

Nome	Tipo	Descrição
`name`	`String`	o novo nome do `File`

Retornar

File: este File para encadeamentos

Autorização

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

https://www.googleapis.com/auth/drive

`setOwner(emailAddress)`

Altera o proprietário do File. Esse método também concede ao proprietário anterior acesso de edição explícito ao File.

Parâmetros

Nome	Tipo	Descrição
`emailAddress`	`String`	o endereço de e-mail do usuário que deve se tornar o novo proprietário

Retornar

File: este File para encadeamentos

Autorização

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

https://www.googleapis.com/auth/drive

`setOwner(user)`

Altera o proprietário do File. Esse método também concede ao proprietário anterior acesso de edição explícito ao File.

Parâmetros

Nome	Tipo	Descrição
`user`	`User`	uma representação do usuário que se tornará o novo proprietário

Retornar

File: este File para encadeamentos

Autorização

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

https://www.googleapis.com/auth/drive

`setSecurityUpdateEnabled(enabled)`

Define se o File exige uma chave de recurso para acesso quando for compartilhado usando um link. As pastas e os arquivos qualificados são ativados por padrão.

Saiba mais sobre a atualização de segurança do Google Drive.

Parâmetros

Nome	Tipo	Descrição
`enabled`	`Boolean`	Define se o requisito de chave de recurso será ativado para `File`.

Retornar

File: este File, 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/drive

`setShareableByEditors(shareable)`

Define se os usuários com permissão para edição a File têm permissão para compartilhar com outros usuários ou mudar as permissões. O padrão para um novo File é true.

Parâmetros

Nome	Tipo	Descrição
`shareable`	`Boolean`	`true` se os usuários com permissões para edição tiverem permissão para compartilhar com outros usuários ou mudar as permissões. `false` se não tiverem permissão

Retornar

File: este File para encadeamentos

Autorização

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

https://www.googleapis.com/auth/drive

`setSharing(accessType, permissionType)`

Define qual classe de usuários pode acessar o File e quais permissões eles recebem, além de qualquer usuário individual que tenha recebido explicitamente o acesso.

// Creates a folder that anyone on the Internet can read from and write to. (Domain
// administrators can prohibit this setting for users of a Google Workspace domain.)
var folder = DriveApp.createFolder('Shared Folder');
folder.setSharing(DriveApp.Access.ANYONE, DriveApp.Permission.EDIT);

Parâmetros

Nome	Tipo	Descrição
`accessType`	`Access`	qual classe de usuários poderá acessar o `File`
`permissionType`	`Permission`	as permissões que precisam ser concedidas aos usuários que podem acessar o `File`

Retornar

File: este File para encadeamentos

Autorização

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

https://www.googleapis.com/auth/drive

`setStarred(starred)`

Define se o File é marcado com estrela no Drive do usuário. O padrão para novos Files é false.

Parâmetros

Nome	Tipo	Descrição
`starred`	`Boolean`	`true` se o `File` precisar ser marcado com estrela no Drive do usuário. Caso contrário, `false`.

Retornar

File: este File para encadeamentos

Autorização

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

https://www.googleapis.com/auth/drive

`setTrashed(trashed)`

Define se o File está na lixeira do Drive do usuário. Somente o proprietário pode mover o File para a lixeira. O padrão para novos Files é false.

Parâmetros

Nome	Tipo	Descrição
`trashed`	`Boolean`	`true` se o `File` precisar ser movido para a lixeira do Drive do usuário. `false` se não for

Retornar

File: este File para encadeamentos

Autorização

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

https://www.googleapis.com/auth/drive