Class File

Adiciona o usuário especificado à lista de comentaristas do File. Se o usuário já estava na lista de leitores, esse método o promove para fora dela.

const files = DriveApp.getFilesByName('Test');

// Loops through the files
while (files.hasNext()) {
  const file = files.next();
  file.addCommenter('hello@example.com');
}

Parâmetros

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

Adiciona o usuário especificado à lista de comentaristas do File. Se o usuário já estava na lista de leitores, esse método o promove para fora dela.

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace the file name with your own.
const files = DriveApp.getFilesByName('Test');

// Adds the active user as a commenter.
while (files.hasNext()) {
  const file = files.next();
  file.addCommenter(Session.getActiveUser());
}

Parâmetros

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

Adiciona a matriz de usuários à lista de comentaristas do File. Se algum dos usuários já estiver na lista de leitores, esse método os promove para fora dela.

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace the file name with your own.
const files = DriveApp.getFilesByName('Test');

while (files.hasNext()) {
  const file = files.next();
  // TODO(developer): Replace 'cloudysanfrancisco@gmail.com' and
  // 'baklavainthebalkans@gmail.com' with the email addresses to add as
  // commenters.
  const emails = [
    'cloudysanfrancisco@gmail.com',
    'baklavainthebalkans@gmail.com',
  ];
  console.log(file.addCommenters(emails));
}

Parâmetros

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

Adiciona o usuário especificado à lista de editores do File. Se o usuário já estava na lista de leitores, esse método o remove dela.

Parâmetros

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

Adiciona o usuário especificado à lista de editores do File. Se o usuário já estava na lista de leitores, esse método o remove dela.

Parâmetros

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

Adiciona a matriz de usuários à lista de editores do File. Se algum dos usuários já estava na lista de espectadores, esse método o remove dela.

Parâmetros

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

Adiciona o usuário especificado à lista de leitores do File. Se o usuário já estava na lista de editores, esse método não tem efeito.

Parâmetros

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

Adiciona o usuário especificado à lista de leitores do File. Se o usuário já estava na lista de editores, esse método não tem efeito.

Parâmetros

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

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

Parâmetros

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

Recebe a permissão concedida a um usuário específico. O método não oferece suporte ao retorno de permissões para um grupo do Google ou permissões herdadas por grupos do Google.

Parâmetros

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

Recebe a permissão concedida a um usuário específico. O método não oferece suporte ao retorno de permissões para um grupo do Google ou permissões herdadas por grupos do Google.

Parâmetros

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

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, ele pressupõ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 torna "ShoppingList.12.25.pdf".

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

Parâmetros

Retornar

Blob: os dados como um blob.

Retorna os dados dentro desse objeto como um blob.

Retornar

Blob: os dados como um blob.

Recebe a data em que o File foi criado.

Retornar

Date: a data em que o File foi criado.

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

Recebe a descrição do File.

Retornar

String: a descrição do 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

Recebe o URL que pode ser usado para fazer o download do arquivo. Somente usuários com permissão para abrir o arquivo no Google Drive podem acessar o URL. Você pode usar esse URL em um navegador para baixar o arquivo, mas não pode usá-lo para buscar o arquivo com UrlFetchApp. Se quiser o conteúdo do arquivo no script, use getBlob().

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace the file name with your own.
const files = DriveApp.getFilesByName('Test');

// Loops through the files and logs the download URLs to the console.
while (files.hasNext()) {
  const file = files.next();
  console.log(file.getDownloadUrl());
}

Retornar

String: o URL que pode ser usado para fazer o download 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

Recebe a lista de editores para este File. Se o usuário que executar o script não tiver acesso de edição ao File, esse método vai retornar uma matriz vazia.

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace the file name with your own.
const files = DriveApp.getFilesByName('Test');

// Loops through the files.
while (files.hasNext()) {
  const file = files.next();

  // Adds the email addresses in the array as editors of each file.
  // TODO(developer): Replace 'cloudysanfrancisco@gmail.com'
  // and 'baklavainthebalkans@gmail.com' with valid email addresses.
  file.addEditors([
    'cloudysanfrancisco@gmail.com',
    'baklavainthebalkans@gmail.com',
  ]);

  // Gets a list of the file editors.
  const editors = file.getEditors();

  // For each file, logs the editors' email addresses to the console.
  for (const editor of editors) {
    console.log(editor.getEmail());
  }
}

Retornar

User[]: se o usuário tiver acesso de edição a este File, vai retornar a lista de editores. Se o usuário não tiver acesso de edição, vai retornar uma matriz vazia.

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

Recebe o ID do File.

Retornar

String: o ID do 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

Recebe a data da última atualização do File.

Retornar

Date: a data da última atualização do 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

Recebe o tipo MIME do arquivo.

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace the file name with your own.
const files = DriveApp.getFilesByName('Test');

// Loops through the files and logs the MIME type to the console.
while (files.hasNext()) {
  const file = files.next();
  console.log(file.getMimeType());
}

Retornar

String: o tipo MIME 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

Recebe o nome do File.

Retornar

String: o nome do 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

Recebe o proprietário do arquivo.

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace the file name with your own.
const files = DriveApp.getFilesByName('Test');

// Loops through the files and logs the names of the file owners to the console.
while (files.hasNext()) {
  const file = files.next();
  console.log(file.getOwner().getName());
}

Retornar

User: o proprietário 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

Recebe uma coleção de pastas que são pais imediatos do File.

Retornar

FolderIterator: uma coleção de pastas que são pais imediatos do 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

Recebe a chave de recurso do File necessária para acessar itens compartilhados usando um link.

Retornar

String: a chave de recurso do 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

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

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

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

Retornar

Boolean: indica 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

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

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

Retornar

Boolean: indica se o requisito de chave de recurso está ativado para este 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

Recebe a classe de usuários que podem acessar o File, além de usuários individuais que receberam acesso explícito.

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

Recebe a permissão concedida aos usuários que podem acessar o File, além de usuários individuais que receberam acesso explícito.

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

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

Se for um atalho, retorna o ID do item a que ele aponta.

Caso contrário, ele retorna null.

// The ID of the file for which to make a shortcut and the ID of
// the folder to which you want to add the shortcut.
// TODO(developer): Replace the file and folder IDs with your IDs.
const fileId = 'abc123456';
const folderId = 'xyz987654';

// Gets the folder to add the shortcut to.
const folder = DriveApp.getFolderById(folderId);

// Creates a shortcut of the file and moves it to the specified folder.
const shortcut = DriveApp.createShortcut(fileId).moveTo(folder);

// Logs the target ID of the shortcut.
console.log(`${shortcut.getName()}=${shortcut.getTargetId()}`);

Retornar

String: o ID do item de destino.

Se for um atalho, retorna o tipo MIME do item a que ele aponta.

Caso contrário, ele retorna null.

// The ID of the file for which to make a shortcut and the ID of
// the folder to which you want to add the shortcut.
// TODO(developer): Replace the file and folder IDs with your IDs.
const fileId = 'abc123456';
const folderId = 'xyz987654';

// Gets the folder to add the shortcut to.
const folder = DriveApp.getFolderById(folderId);

// Creates a shortcut of the file and moves it to the specified folder.
const shortcut = DriveApp.createShortcut(fileId).moveTo(folder);

// Logs the MIME type of the file that the shortcut points to.
console.log(`MIME type of the shortcut: ${shortcut.getTargetMimeType()}`);

Retornar

String: o tipo MIME do item de destino.

Se o arquivo for um atalho, vai retornar a chave de recurso do item a que ele aponta. Uma chave de recurso é um parâmetro adicional que você precisa transmitir para acessar arquivos compartilhados usando um link.

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

//  Gets a file by its ID.
//  TODO(developer): Replace 'abc123456' with your file ID.
const file = DriveApp.getFileById('abc123456');

// If the file is a shortcut, returns the resource key of the file that it
// points to.
console.log(file.getTargetResourceKey());

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

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

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace the file name with your own.
const files = DriveApp.getFilesByName('Test');

// Loops through the files.
while (files.hasNext()) {
  const file = files.next();

  // Logs the thumbnail image for each file to the console as a blob,
  // or null if no thumbnail exists.
  console.log(file.getThumbnail());
}

Retornar

Blob|null: 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

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

Retornar

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

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

Recebe a lista de leitores e comentaristas deste File. Se o usuário que executa o script não tiver acesso de edição ao File, esse método vai retornar uma matriz vazia.

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace the file name with your own.
const files = DriveApp.getFilesByName('Test');

// Loops through the files.
while (files.hasNext()) {
  const file = files.next();

  // For each file, logs the viewers' email addresses to the console.
  const viewers = file.getViewers();
  for (const viewer of viewers) {
    console.log(viewer.getEmail());
  }
}

Retornar

User[]: se o usuário tiver acesso de edição a este File, vai retornar a lista de leitores e comentaristas. Se o usuário não tiver acesso de edição, vai retornar uma matriz vazia.

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

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

Retornar

Boolean: true se os usuários com permissões de edição puderem compartilhar com outras pessoas ou mudar as permissões; false se não puderem

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

Determina se o File foi marcado como favorito no Drive do usuário.

Retornar

Boolean: true se o File estiver marcado com estrela no 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

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

Retornar

Boolean: true se o 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

Cria uma cópia do arquivo.

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace the file name with your own.
const files = DriveApp.getFilesByName('Test');

// Loops through the files.
while (files.hasNext()) {
  const file = files.next();

  // Creates a copy of each file and logs the file name to the console.
  console.log(file.makeCopy().getName());
}

Retornar

File: o novo texto.

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

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

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace the file name with your own.
const files = DriveApp.getFilesByName('Test');

// Loops through the files.
while (files.hasNext()) {
  const file = files.next();

  // Creates a copy of each file and adds it to the specified folder.
  // TODO(developer): Replace the folder ID with your own.
  const destination = DriveApp.getFolderById('123456abcxyz');
  const copiedFile = file.makeCopy(destination);

  // Logs the file names to the console.
  console.log(copiedFile.getName());
}

Parâmetros

Retornar

File: o novo texto.

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

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

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace the file name with your own.
const files = DriveApp.getFilesByName('Test');

// Loops through the files.
while (files.hasNext()) {
  const file = files.next();

  // Creates a copy of each file and sets the name to 'Test-Copy.'
  const filename = file.makeCopy('Test-Copy');

  // Logs the copied file's name to the console.
  console.log(filename.getName());
}

Parâmetros

Retornar

File: o novo texto.

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

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

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace the file name with your own.
const files = DriveApp.getFilesByName('Test');

// Loops through the files.
while (files.hasNext()) {
  const file = files.next();

  // Creates a copy of each file, sets the file name, and adds the copied file
  // to the specified folder.
  // TODO(developer): Replace the folder ID with your own.
  const destination = DriveApp.getFolderById('123456abcxyz');
  const copiedFile = file.makeCopy('Test-Copy', destination);

  // Logs the file names to the console.
  console.log(copiedFile.getName());
}

Parâmetros

Retornar

File: o novo texto.

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

Move o item para a pasta de destino fornecida.

O usuário atual precisa ser o proprietário do arquivo ou ter pelo menos acesso de edição à pasta mãe atual do item para movê-lo para a pasta de destino.

Parâmetros

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

Remove o usuário especificado da lista de pessoas que fizeram comentários no File. Esse método não impede que os usuários acessem o File se eles pertencerem a uma classe de usuários que têm acesso geral. Por exemplo, se o File for compartilhado com o domínio inteiro do usuário.

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace the file name with your own.
const files = DriveApp.getFilesByName('Test');

// Loops through the files.
while (files.hasNext()) {
  const file = files.next();

  // Removes the given user from the list of commenters for each file.
  // TODO(developer): Replace the email with the email of the user you want to
  // remove.
  file.removeCommenter('cloudysanfrancisco@gmail.com');
}

Parâmetros

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

Remove o usuário especificado da lista de pessoas que fizeram comentários no File. Esse método não impede que os usuários acessem o File se eles pertencerem a uma classe de usuários que têm acesso geral. Por exemplo, se o File for compartilhado com o domínio inteiro do usuário.

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace the file name with your own.
const files = DriveApp.getFilesByName('Test');

// Loops through the files.
while (files.hasNext()) {
  const file = files.next();

  // Removes the given user from the list of commenters for each file.
  console.log(file.removeCommenter(Session.getActiveUser()));
}

Parâmetros

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

Remove o usuário especificado da lista de editores do File. Esse método não impede que os usuários acessem o File se eles pertencerem a uma classe de usuários que têm 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.

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

Parâmetros

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

Remove o usuário especificado da lista de editores do File. Esse método não impede que os usuários acessem o File se eles pertencerem a uma classe de usuários que têm 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.

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

Parâmetros

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

Remove o usuário especificado da lista de espectadores e comentaristas do File. Esse método não tem 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 eles pertencerem a uma classe de usuários que têm 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.

Para arquivos do Drive, isso também remove o usuário da lista de editores.

Parâmetros

Retornar

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

Remove o usuário especificado da lista de espectadores e comentaristas do File. Esse método não tem 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 eles pertencerem a uma classe de usuários que têm 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 possa acessar.

Para arquivos do Drive, isso também remove o usuário da lista de editores.

Parâmetros

Retornar

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

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

Parâmetros

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

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

Parâmetros

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

Substitui o conteúdo do arquivo por uma substituição específica. Gera uma exceção se content for maior que 10 MB.

// Creates a text file with the content 'Hello, world!'
const file = DriveApp.createFile('New Text File', 'Hello, world!');

// Logs the content of the text file to the console.
console.log(file.getBlob().getDataAsString());

// Updates the content of the text file to 'Updated text!'
file.setContent('Updated text!');

// Logs content of the text file to the console.
console.log(file.getBlob().getDataAsString());

Parâmetros

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

Define a descrição do File.

Parâmetros

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

Define o nome do File.

Parâmetros

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

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

Parâmetros

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

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

Parâmetros

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

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

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

Parâmetros

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

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

Parâmetros

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

Define qual classe de usuários pode acessar o File e quais permissões são concedidas a eles, além de usuários individuais que receberam acesso explícito.

// 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.)
const folder = DriveApp.createFolder('Shared Folder');
folder.setSharing(DriveApp.Access.ANYONE, DriveApp.Permission.EDIT);

Parâmetros

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

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

Parâmetros

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

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

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