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étodoTipo de retornoBreve descrição
getDomain()StringConsegue o nome de domínio associado à conta do usuário.
getEmail()StringRetorna o endereço de e-mail do usuário.
getName()StringRecebe o nome do usuário.
getPhotoUrl()StringRecebe o URL da foto 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