Class EmailField

Поле электронной почты

Устарело. Вместо этого используйте расширенный сервис People API.

Поле электронной почты в контакте.

Методы

Метод Тип возврата Краткое описание
getAddress() String Получите адрес для этого поля.
getLabel() Object Получает метку для этого поля.
isPrimary() Boolean Проверяет, является ли это значением основного поля.
setAddress(address) EmailField Устанавливает адрес этого поля.
setAsPrimary() EmailField Устанавливает это поле как основное.
setLabel(field) EmailField Устанавливает метку этого поля.
setLabel(label) EmailField Устанавливает метку этого поля.
Метод Тип возврата Краткое описание
deleteEmailField() void Удаляет этот адрес электронной почты из контакта.
getDisplayName() String Возвращает отображаемое имя для этого адреса электронной почты.
setDisplayName(name) EmailField Устанавливает отображаемое имя для этого адреса электронной почты.

Подробная документация

getAddress()

Получите адрес для этого поля.

// Logs the address for the 'Home Address' field for contact 'John Doe'.
// Can be used similarly for other fields that contain addresses.
var contacts = ContactsApp.getContactsByName('John Doe');
var homeAddress = contacts[0].getAddresses(ContactsApp.Field.HOME_ADDRESS);
Logger.log(homeAddress[0].getAddress());

Возвращаться

String — адрес в виде строки

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

  • https://www.google.com/m8/feeds

getLabel()

Получает метку для этого поля. Это может быть поле, ExtendedField или строка.

// Logs the label for all the address fields associated with contact
// 'John Doe'. This method can be similarly called for any field that has
// a label.
var contacts = ContactsApp.getContactsByName('John Doe');
var addressFields = contacts[0].getAddresses();
for (var i = 0; i < addressFields.length; i++) {
  Logger.log(addressFields[i].getLabel());
}

Возвращаться

Object — метка для этого поля

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

  • https://www.google.com/m8/feeds

isPrimary()

Проверяет, является ли это значением основного поля.

// Logs whether or not the first address field associated with contact
// 'John Doe' is labeled as primary. This method can be similarly called
// for any field.
var contacts = ContactsApp.getContactsByName('John Doe');
var addressFields = contacts[0].getAddresses();
Logger.log(addressFields[0].isPrimary());

Возвращаться

Boolean — является ли это первичным

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

  • https://www.google.com/m8/feeds

setAddress(address)

Устанавливает адрес этого поля.

// Sets the address for the 'Home Address' field for contact 'John Doe'.
// Can be used similarly for other fields that contain addresses.
var contacts = ContactsApp.getContactsByName('John Doe');
var homeAddress = contacts[0].getAddresses(ContactsApp.Field.HOME_ADDRESS);
homeAddress[0].setAddress('123 Main St, Raleigh, NC, 27601');

Параметры

Имя Тип Описание
address String новый адрес

Возвращаться

EmailField — это поле, полезное для цепочки

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

  • https://www.google.com/m8/feeds

setAsPrimary()

Устанавливает это поле как основное.

// Sets the the first address field associated with contact 'John Doe'
// as primary. This method can be similarly called for any field.
var contacts = ContactsApp.getContactsByName('John Doe');
var addressFields = contacts[0].getAddresses();
addressFields[0].setAsPrimary();

Возвращаться

EmailField — это FieldValue для цепочки

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

  • https://www.google.com/m8/feeds

setLabel(field)

Устанавливает метку этого поля.

// Sets the label to 'Work' for the first address field associated
// with contact 'John Doe'. This method can be similarly called for any
// field that has a label.
var contacts = ContactsApp.getContactsByName('John Doe');
var addressFields = contacts[0].getAddresses();
addressFields[0].setLabel(ContactsApp.Field.WORK_ADDRESS);

Параметры

Имя Тип Описание
field Field новая стандартная этикетка

Возвращаться

EmailField — это FieldValue для цепочки

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

  • https://www.google.com/m8/feeds

setLabel(label)

Устанавливает метку этого поля.

// Sets the label to 'Apartment' for the first address field associated
// with contact 'John Doe'. This method can be similarly called for any
// field that has a label.
var contacts = ContactsApp.getContactsByName('John Doe');
var addressFields = contacts[0].getAddresses();
addressFields[0].setLabel('Apartment');

Параметры

Имя Тип Описание
label String новая метка для этого поля

Возвращаться

EmailField — это поле, полезное для цепочки

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

  • https://www.google.com/m8/feeds

Устаревшие методы

Устарело. Эта функция устарела и не должна использоваться в новых скриптах.

Удаляет этот адрес электронной почты из контакта.

// Retrieves and deletes the work email address for contact 'John Doe'
var contacts = ContactsApp.getContactsByName('John Doe');
var workEmail = contacts[0].getEmails(ContactsApp.Field.WORK_EMAIL);
workEmail[0].deleteEmailField();

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

  • https://www.google.com/m8/feeds

Устарело. Эта функция устарела и не должна использоваться в новых скриптах.

Возвращает отображаемое имя для этого адреса электронной почты.

// Logs the display name for the the work email address for contact 'John Doe'
var contacts = ContactsApp.getContactsByName('John Doe');
var workEmail = contacts[0].getEmails(ContactsApp.Field.WORK_EMAIL);
Logger.log(workEmail[0].getDisplayName());

Возвращаться

String — отображаемое имя для этого письма.

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

  • https://www.google.com/m8/feeds

Устарело. Эта функция устарела и не должна использоваться в новых скриптах.

Устанавливает отображаемое имя для этого адреса электронной почты. 

// Sets the display name to 'Doe, John' for the the work email address for contact 'John Doe'
var contacts = ContactsApp.getContactsByName('John Doe');
var workEmail = contacts[0].getEmails(ContactsApp.Field.WORK_EMAIL);
workEmail[0].setDisplayName('Doe, John');

Параметры

Имя Тип Описание
name String новое отображаемое имя для этого адреса электронной почты

Возвращаться

EmailField — это поле электронной почты, полезное для цепочки

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

  • https://www.google.com/m8/feeds