Class User

Usuário

Um usuário associado a um arquivo no Google Drive. Os usuários podem ser acessados em File.getEditors(), Folder.getViewers() e outros métodos.

// Log the email address of all users who have edit access to a file.
const file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz');
const editors = file.getEditors();
for (let i = 0; i < editors.length; i++) {
  Logger.log(editors[i].getEmail());
}

Métodos

Método	Tipo de retorno	Breve descrição
getDomain()	String	Consegue o nome de domínio associado à conta do usuário.
getEmail()	String	Retorna o endereço de e-mail do usuário.
getName()	String	Recebe o nome do usuário.
getPhotoUrl()	String	Recebe o URL da foto do usuário.

Métodos obsoletos

Método	Tipo de retorno	Breve descrição
getUserLoginId()	String	Retorna o endereço de e-mail do usuário.

Documentação detalhada

getDomain()

Consegue o nome de domínio associado à conta do usuário.

// Log the domain names associated with all users who have edit access to a
// file.
const file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz');
const editors = file.getEditors();
for (let i = 0; i < editors.length; i++) {
  Logger.log(editors[i].getDomain());
}

Retornar

String: o nome de domínio associado à conta do usuário.

---

getEmail()

Retorna o endereço de e-mail do usuário. O endereço de e-mail do usuário só estará disponível se ele tiver escolhido compartilhar o endereço na página de configurações da conta do Google+ ou se ele pertencer ao mesmo domínio do usuário que está executando o script e o administrador do domínio tiver permitido que todos os usuários do domínio vejam os endereços de e-mail de outros usuários.

// Log the email address of all users who have edit access to a file.
const file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz');
const editors = file.getEditors();
for (let i = 0; i < editors.length; i++) {
  Logger.log(editors[i].getEmail());
}

Retornar

String: o endereço de e-mail do usuário ou uma string em branco se o endereço de e-mail não estiver disponível.

---

getName()

Recebe o nome do usuário. Esse método retorna null se o nome do usuário não estiver disponível.

// Log the names of all users who have edit access to a file.
const file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz');
const editors = file.getEditors();
for (let i = 0; i < editors.length; i++) {
  Logger.log(editors[i].getName());
}

Retornar

String: o nome do usuário ou null se o nome não estiver disponível.

---

getPhotoUrl()

Recebe o URL da foto do usuário. Esse método retorna null se a foto do usuário não estiver disponível.

// Log the URLs for the photos of all users who have edit access to a file.
const file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz');
const editors = file.getEditors();
for (let i = 0; i < editors.length; i++) {
  Logger.log(editors[i].getPhotoUrl());
}

Retornar

String: o URL da foto do usuário ou null se a foto não estiver disponível.

Métodos obsoletos

getUserLoginId()

Obsoleto. Substituído por getEmail() em 24 de junho de 2013.

Retorna o endereço de e-mail do usuário.

// Log the email address of the person running the script.
Logger.log(Session.getActiveUser().getUserLoginId());

Retornar

String: o endereço de e-mail do usuário.