Class User

Usuário

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

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

Métodos

MétodoTipo de retornoBreve descrição
getDomain()StringRecebe o nome de domínio associado à conta do usuário.
getEmail()StringExtrai o endereço de e-mail do usuário.
getName()StringExtrai o nome do usuário.
getPhotoUrl()StringExtrai o URL da foto do usuário.

Documentação detalhada

getDomain()

Recebe 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.
var file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz');
var editors = file.getEditors();
for (var i = 0; i < editors.length; i++) {
  Logger.log(editors[i].getDomain());
}

Retornar

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

getEmail()

Extrai o endereço de e-mail do usuário. O endereço de e-mail do usuário só fica disponível se o usuário tiver optar por compartilhar o endereço da página de configurações da conta do Google+ ou se o usuário pertence à no mesmo domínio do usuário que está executando o script e o administrador do domínio permitiu todas as usuários no domínio vejam os nomes endereços de e-mail. 

// Log the email address of all users who have edit access to a file.
var file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz');
var editors = file.getEditors();
for (var 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()

Extrai o nome do usuário. Esse método retornará 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.
var file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz');
var editors = file.getEditors();
for (var 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()

Extrai o URL da foto do usuário. Esse método retornará null se a foto do usuário não for disponíveis. 

// Log the URLs for the photos of all users who have edit access to a file.
var file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz');
var editors = file.getEditors();
for (var 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