Class User

User

Um usuário associado a um arquivo no Google Drive. Os usuários podem ser acessados de File.getEditors(), Folder.getViewers() e de 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()StringAcessa 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()

Acessa 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());
}

Retorno

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ó 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 que o usuário que executa o script e o administrador do domínio tiver permitido que todos os usuários no 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.
var file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz');
var editors = file.getEditors();
for (var i = 0; i < editors.length; i++) {
  Logger.log(editors[i].getEmail());
}

Retorno

String: o endereço de e-mail do usuário ou uma string em branco se o endereço 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());
}

Retorno

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 estiver disponível.

// 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());
}

Retorno

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

Métodos obsoletos