Class Contact

Контакт

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

Контакт содержит имя, адрес и различные контактные данные контакта.

Метод Тип возврата Краткое описание
addAddress(label, address) AddressField Добавляет адрес к контакту со стандартной или настраиваемой меткой.
addCompany(company, title) CompanyField Добавляет компанию в контакт.
addCustomField(label, content) CustomField Добавляет к контакту настраиваемое поле с расширенной или настраиваемой меткой.
addDate(label, month, day, year) DateField Добавляет дату к контакту со стандартной или настраиваемой меткой.
addEmail(label, address) EmailField Добавьте адрес электронной почты со стандартной меткой (домашний, рабочий и т. д.) или собственной меткой.
addIM(label, address) IMField Добавляет к контакту адрес обмена мгновенными сообщениями со стандартной или настраиваемой меткой.
addPhone(label, number) PhoneField Добавляет номер телефона к контакту со стандартной или настраиваемой меткой.
addToGroup(group) Contact Добавляет этот контакт в данную группу контактов.
addUrl(label, url) UrlField Добавляет URL-адрес контакта со стандартной или настраиваемой меткой.
deleteContact() void Удаляет этот контакт.
getAddresses() AddressField[] Получает все адреса этого контакта.
getAddresses(label) AddressField[] Получает все адреса этого контакта, соответствующие определенному полю.
getCompanies() CompanyField[] Получает все компании для этого контакта.
getContactGroups() ContactGroup[] Получает все группы контактов, содержащие этот контакт.
getCustomFields() CustomField[] Получает все настраиваемые поля для этого контакта.
getCustomFields(label) CustomField[] Получает все настраиваемые поля для этого контакта, соответствующие определенному полю.
getDates() DateField[] Получает все даты для этого контакта.
getDates(label) DateField[] Получает все даты для этого контакта, соответствующие определенному полю.
getEmailAddresses() String[] Получает список адресов электронной почты, доступных для этого контакта.
getEmails() EmailField[] Получает адреса электронной почты этого контакта.
getEmails(label) EmailField[] Получает адреса электронной почты для этого контакта, соответствующие определенному полю.
getFamilyName() String Получает фамилию (фамилию) контакта в виде строки.
getFullName() String Получает полное имя (имя и фамилию) контакта в виде строки.
getGivenName() String Получает имя (имя) контакта в виде строки.
getHomeAddress() String Получает домашний адрес этого контакта или пустую строку, если таковая не существует.
getHomeFax() String Получает номер домашнего факса этого контакта или пустую строку, если она не существует.
getHomePhone() String Получает номер домашнего телефона этого контакта или пустую строку, если она не существует.
getIMs() IMField[] Получает все адреса мгновенных сообщений для этого контакта.
getIMs(label) IMField[] Получает все адреса мгновенных сообщений для этого контакта, соответствующие определенному полю.
getId() String Возвращает уникальный идентификатор этого контакта.
getInitials() String Получает инициалы контакта.
getLastUpdated() Date Получает дату последнего обновления этого контакта.
getMaidenName() String Получает девичью фамилию контакта в виде строки.
getMiddleName() String Получает отчество контакта в виде строки.
getMobilePhone() String Получает номер мобильного телефона этого контакта или пустую строку, если таковая не существует.
getNickname() String Получает псевдоним контакта в виде строки.
getNotes() String Получает заметки, связанные с этим контактом, или пустую строку, если заметок нет.
getPager() String Получает номер телефона пейджера этого контакта или пустую строку, если таковая не существует.
getPhones() PhoneField[] Получает все номера телефонов этого контакта.
getPhones(label) PhoneField[] Получает все номера телефонов этого контакта, соответствующие определенному полю.
getPrefix() String Получает префикс имени контакта.
getPrimaryEmail() String Получает основной адрес электронной почты контакта в виде строки.
getShortName() String Получает краткое имя контакта в виде строки.
getSuffix() String Получает суффикс имени контакта.
getUrls() UrlField[] Получает все URL-адреса этого контакта.
getUrls(label) UrlField[] Получает все URL-адреса для этого контакта, соответствующие определенному полю.
getUserDefinedField(key) String Получает определенное пользователем значение, связанное с данным ключом.
getUserDefinedFields() Object Получает все определенные пользователем поля для этого контакта и возвращает их как свойства объекта JavaScript.
getWorkAddress() String Получает рабочий адрес этого контакта или пустую строку, если она не существует.
getWorkFax() String Получает номер рабочего факса этого контакта или пустую строку, если она не существует.
getWorkPhone() String Получает номер рабочего телефона этого контакта или пустую строку, если таковая не существует.
removeFromGroup(group) Contact Удаляет этот контакт из данной группы контактов.
setFamilyName(familyName) Contact Устанавливает фамилию (фамилию) контакта.
setFullName(fullName) Contact Устанавливает полное имя (имя и фамилию) контакта.
setGivenName(givenName) Contact Устанавливает имя (имя) контакта.
setHomeAddress(addr) void Устанавливает домашний адрес этого контакта.
setHomeFax(phone) void Устанавливает номер домашнего факса этого контакта.
setHomePhone(phone) void Устанавливает номер домашнего телефона этого контакта.
setInitials(initials) Contact Устанавливает инициалы контакта.
setMaidenName(maidenName) Contact Устанавливает девичью фамилию контакта.
setMiddleName(middleName) Contact Устанавливает отчество контакта.
setMobilePhone(phone) void Устанавливает номер мобильного телефона этого контакта.
setNickname(nickname) Contact Устанавливает псевдоним контакта.
setNotes(notes) Contact Устанавливает заметки, связанные с этим контактом.
setPager(phone) void Устанавливает номер пейджера этого контакта.
setPrefix(prefix) Contact Устанавливает префикс имени контакта.
setPrimaryEmail(primaryEmail) void Устанавливает основной адрес электронной почты этого контакта.
setShortName(shortName) Contact Устанавливает краткое имя контакта.
setSuffix(suffix) Contact Устанавливает суффикс к имени контакта.
setUserDefinedField(key, value) void Устанавливает одно пользовательское поле для этого контакта, которое будет храниться с заданным ключом.
setUserDefinedFields(o) void Устанавливает определенные пользователем поля для этого Контакта со свойствами данного Объекта.
setWorkAddress(addr) void Устанавливает рабочий адрес этого контакта.
setWorkFax(phone) void Устанавливает номер рабочего факса этого контакта.
setWorkPhone(phone) void Устанавливает рабочий номер телефона этого контакта.

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

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

Добавляет адрес к контакту со стандартной или настраиваемой меткой.

Метка может быть либо из ContactsApp.Field, либо из пользовательской строки метки. 

// The code below retrieves a contact named "John Doe" and adds the address
// "123 Main St, Some City, NY 10011" with the the ContactsApp.Field.WORK_ADDRESS label.
var contacts = ContactsApp.getContactsByName('John Doe');
var address = contacts[0].addAddress(ContactsApp.Field.WORK_ADDRESS,
                                    '123 Main St, Some City, NY 10011');

Параметры

Имя Тип Описание
label Object метка нового адреса либо из ContactsApp.Field, либо из пользовательской строки.
address String новый адрес

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

AddressField — вновь созданное поле

Авторизация

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

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

См. также

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

Добавляет компанию в контакт. 

// The code below retrieves a contact named "John Doe" and adds the company "Google" and the
// job title "Product Manager".
var contacts = ContactsApp.getContactsByName('John Doe');
var url = contacts[0].addCompany('Google', 'Product Manager');

Параметры

Имя Тип Описание
company String название компании, которую нужно добавить к этому контакту
title String должность, связанная с этим контактом в этой компании

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

CompanyField — вновь созданное поле

Авторизация

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

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

См. также

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

Добавляет к контакту настраиваемое поле с расширенной или настраиваемой меткой.

Метка может быть либо из ContactsApp.ExtendedField, либо из пользовательской строки метки. 

// The code below retrieves a contact named "John Doe" and adds the custom field
// ContactsApp.ExtendedField.HOBBY with the value "hiking".
// Note that ContactsApp.ExtendedField.HOBBY is not the same as a custom field named 'HOBBY'.
var contacts = ContactsApp.getContactsByName('John Doe');
contacts[0].addCustomField(ContactsApp.ExtendedField.HOBBY, 'hiking');

Параметры

Имя Тип Описание
label Object метка нового адреса либо из ContactsApp.ExtendedField, либо из пользовательской строки.
content Object значение для хранения в настраиваемом поле

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

CustomField — вновь созданное поле

Авторизация

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

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

См. также

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

Добавляет дату к контакту со стандартной или настраиваемой меткой.

Метка может быть либо из ContactsApp.Field, либо из пользовательской строки метки. 

// The code below retrieves a contact named "John Doe" and adds a
// ContactsApp.ExtendedField.BIRTHDAY with the value "April 19, 1950".
var contacts = ContactsApp.getContactsByName('John Doe');
var birthday = contacts[0].addDate(ContactsApp.Field.BIRTHDAY,
                                   ContactsApp.Month.APRIL, 19, 1950);

Параметры

Имя Тип Описание
label Object метка новой даты либо из ContactsApp.Field, либо из пользовательской строки.
month Month месяц из ContactApps.Month
day Integer день
year Integer год

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

DateField — вновь созданная дата

Авторизация

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

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

См. также

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

Добавьте адрес электронной почты со стандартной меткой (домашний, рабочий и т. д.) или собственной меткой. 

// The code below retrieves a contact named "John Doe" and adds the email address
// "j.doe@example.com" to the ContactsApp.Field.HOME_EMAIL label.
var contacts = ContactsApp.getContactsByName('John Doe');
var emailField = contacts[0].addEmail(ContactsApp.Field.HOME_EMAIL, 'j.doe@example.com');

Параметры

Имя Тип Описание
label Object метка нового электронного письма, либо из ContactsApp.Field, либо в виде пользовательской строки.
address String новый адрес электронной почты

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

EmailField — новое добавленное поле.

Авторизация

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

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

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

Добавляет к контакту адрес обмена мгновенными сообщениями со стандартной или настраиваемой меткой.

Метка может быть либо из ContactsApp.Field, либо из пользовательской строки метки. 

// The code below retrieves a contact named "John Doe" and adds the IM address "ChatWithJohn"
// with the the ContactsApp.Field.AIM label.
var contacts = ContactsApp.getContactsByName('John Doe');
var email = contacts[0].addIM(ContactsApp.Field.AIM, 'ChatWithJohn');

Параметры

Имя Тип Описание
label Object метка нового адреса мгновенного обмена сообщениями либо из ContactsApp.Field, либо в виде пользовательской строки.
address String новый адрес обмена мгновенными сообщениями

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

IMField — вновь созданное поле

Авторизация

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

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

См. также

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

Добавляет номер телефона к контакту со стандартной или настраиваемой меткой.

Метка может быть либо из ContactsApp.Field, либо из пользовательской строки метки. 

// The code below retrieves a contact named "John Doe" and adds the phone number
// "212-555-1234" with the the ContactsApp.Field.WORK_PHONE label.
var contacts = ContactsApp.getContactsByName('John Doe');
var phone = contacts[0].addPhone(ContactsApp.Field.WORK_PHONE, '212-555-1234');

Параметры

Имя Тип Описание
label Object метка нового номера телефона из ContactsApp.Field или пользовательской строки.
number String новый номер телефона

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

PhoneField — вновь созданное поле

Авторизация

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

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

См. также

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

Добавляет этот контакт в данную группу контактов. 

// The code below creates a new contact and then adds it to the contact group named
// "Work Friends"
var contact = ContactsApp.createContact('John', 'Doe', 'john.doe@example.com');
var group = ContactsApp.getContactGroup('Work Friends');
contact = contact.addToGroup(group);

Параметры

Имя Тип Описание
group ContactGroup группа контактов, в которую нужно добавить этот контакт

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

Contact — этот контакт

Авторизация

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

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

См. также

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

Добавляет URL-адрес к контакту со стандартной или настраиваемой меткой.

Метка может быть либо из ContactsApp.Field, либо из пользовательской строки метки. 

// The code below retrieves a contact named "John Doe" and adds the URL
// "http://www.example.com" with the the ContactsApp.Field.WORK_WEBSITE label.
var contacts = ContactsApp.getContactsByName('John Doe');
var url = contacts[0].addUrl(ContactsApp.Field.WORK_WEBSITE, 'http://www.example.com');

Параметры

Имя Тип Описание
label Object метка нового адреса из ContactsApp.Field или пользовательской строки.
url String новый URL

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

UrlField — вновь созданное поле

Авторизация

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

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

См. также

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

Удаляет этот контакт. 

var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  contacts[i].deleteContact();
}

Авторизация

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

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

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

Получает все адреса этого контакта. 

// The code below logs the addresses of all the contacts whose names contain "John Doe"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  Logger.log(contacts[i].getAddresses());
}

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

AddressField[] — список адресов

Авторизация

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

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

См. также

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

Получает все адреса этого контакта, соответствующие определенному полю.

Метка может быть либо из ContactsApp.Field, либо из пользовательской строки метки. 

// The code below retrieves a contact named "John Doe" and logs the addresses
// associated with that contact that are in the ContactsApp.Field.WORK_ADDRESS label.
var contacts = ContactsApp.getContactsByName('John Doe');
var addresses = contacts[0].getAddresses(ContactsApp.Field.WORK_ADDRESS);
for (var i in addresses) {
  Logger.log(addresses[i].getAddress());
}

Параметры

Имя Тип Описание
label Object метка для сопоставления либо из ContactsApp.Field, либо из пользовательской строки.

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

AddressField[] — список адресов

Авторизация

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

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

См. также

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

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

// The code below logs the company names of all the contacts whose names contain "John Doe"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  var companies = contacts[i].getCompanies();
  for (var j in companies) {
    Logger.log(companies[j].getCompanyName());
  }
}

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

CompanyField[] — список компаний

Авторизация

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

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

См. также

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

Получает все группы контактов, содержащие этот контакт. 

// The code below gets a contact named "John Doe" and retrieves all the contact groups that
// the contact belongs to
var contacts = ContactsApp.getContactsByName('John Doe');
var groups = contacts[0].getContactGroups();

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

ContactGroup[] — группы, содержащие этот контакт

См. также

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

Получает все настраиваемые поля для этого контакта. 

// The code below retrieves a contact named "John Doe" and logs the custom fields
// associated with that contact
var contacts = ContactsApp.getContactsByName('John Doe');
var fields = contacts[0].getCustomFields();
for (var i in fields) {
  Logger.log(fields[i].getValue());
}

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

CustomField[] — список настраиваемых полей

Авторизация

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

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

См. также

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

Получает все настраиваемые поля для этого контакта, соответствующие определенному полю.

Метка может быть либо стандартной меткой из ContactsApp.ExtendedField, либо пользовательской строкой метки. 

// The code below retrieves a contact named "John Doe" and logs the custom fields
// associated with that contact that are in the ContactsApp.ExtendedField.HOBBY label.
var contacts = ContactsApp.getContactsByName('John Doe');
var hobbies = contacts[0].getCustomFields(ContactsApp.ExtendedField.HOBBY);
for (var i in hobbies) {
  Logger.log(hobbies[i].getValue());
}

Параметры

Имя Тип Описание
label Object метка для сопоставления либо из ContactsApp.ExtendedField, либо из пользовательской строки.

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

CustomField[] — список настраиваемых полей

Авторизация

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

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

См. также

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

Получает все даты для этого контакта. 

// The code below retrieves a contact named "John Doe" and logs the label of the date
// associated with that contact
var contacts = ContactsApp.getContactsByName('John Doe');
var dates = contacts[0].getDates();
for (var i in dates) {
  Logger.log(dates[i].getLabel());
}

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

DateField[] — список дат

Авторизация

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

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

См. также

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

Получает все даты для этого контакта, соответствующие определенному полю.

Метка может быть либо стандартной меткой из ContactsApp.Field, либо пользовательской строкой метки. 

// The code below retrieves a contact named "John Doe" and logs the day of the month
// associated with that contact that are in the ContactsApp.Field.BIRTHDAY label.
var contacts = ContactsApp.getContactsByName('John Doe');
var birthdays = contacts[0].getDates(ContactsApp.Field.BIRTHDAY);
for (var i in birthdays) {
  Logger.log(birthdays[i].getDay());
}

Параметры

Имя Тип Описание
label Object метка для сопоставления либо из ContactsApp.Field, либо из пользовательской строки.

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

DateField[] — список дат

Авторизация

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

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

См. также

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

Получает список адресов электронной почты, доступных для этого контакта.

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

String[] — список адресов электронной почты, доступных для этого контакта.

Авторизация

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

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

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

Получает адреса электронной почты этого контакта. 

// The code below retrieves a contact named "John Doe" and logs the email addresses
// associated with that contact
var contacts = ContactsApp.getContactsByName('John Doe');
var emails = contacts[0].getEmails();
for (var i in emails) {
  Logger.log(emails[i].getAddress());
}

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

EmailField[] — список адресов электронной почты для контакта

Авторизация

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

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

См. также

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

Получает адреса электронной почты для этого контакта, соответствующие определенному полю.

Метка может быть либо стандартной меткой из ContactsApp.Field, либо пользовательской строкой метки. 

// The code below retrieves a contact named "John Doe" and logs the email addresses
// associated with that contact that are in the ContactsApp.Field.HOME_EMAIL label.
var contacts = ContactsApp.getContactsByName('John Doe');
var emails = contacts[0].getEmails(ContactsApp.Field.HOME_EMAIL);
for (var i in emails) {
  Logger.log(emails[i].getAddress());
}

Параметры

Имя Тип Описание
label Object метка для сопоставления либо из ContactsApp.Field, либо из пользовательской строки.

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

EmailField[] — список адресов электронной почты для контакта

Авторизация

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

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

См. также

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

Получает фамилию (фамилию) контакта в виде строки. 

// The code below logs the family name of all the contacts whose names contain "John"
var contacts = ContactsApp.getContactsByName('John');
for (var i in contacts) {
  Logger.log(contacts[i].getFamilyName());
}

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

String — фамилия контакта.

Авторизация

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

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

См. также

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

Получает полное имя (имя и фамилию) контакта в виде строки. 

// The code below logs the full name of all the contacts whose names contain "John"
var contacts = ContactsApp.getContactsByName('John');
for (var i in contacts) {
  Logger.log(contacts[i].getFullName());
}

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

String — полное имя контакта

Авторизация

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

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

См. также

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

Получает имя (имя) контакта в виде строки. 

// The code below logs the given name of all the contacts whose names contain "Smith"
var contacts = ContactsApp.getContactsByName('Smith');
for (var i in contacts) {
  Logger.log(contacts[i].getGivenName());
}

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

String — имя контакта.

Авторизация

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

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

См. также

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

Получает домашний адрес этого контакта или пустую строку, если таковая не существует.

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

String — домашний адрес этого контакта или пустая строка, если ее нет.

Авторизация

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

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

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

Получает номер домашнего факса этого контакта или пустую строку, если таковая не существует.

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

String — номер домашнего факса этого контакта или пустая строка, если таковая не существует.

Авторизация

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

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

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

Получает номер домашнего телефона этого контакта или пустую строку, если она не существует.

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

String — домашний номер телефона этого Контакта или пустая строка, если ее нет.

Авторизация

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

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

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

Получает все адреса мгновенных сообщений для этого контакта. 

// The code below logs the IM addresses of all the contacts whose names contain "John Doe"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  Logger.log(contacts[i].getIMs());
}

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

IMField[] — список IM-адресов

Авторизация

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

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

См. также

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

Получает все адреса мгновенных сообщений для этого контакта, соответствующие определенному полю.

Метка может быть либо из ContactsApp.Field, либо из пользовательской строки метки. 

// The code below retrieves a contact named "John Doe" and logs the IM addresses
// associated with that contact that are in the ContactsApp.Field.GOOGLE_TALK label.
var contacts = ContactsApp.getContactsByName('John Doe');
var imAddresses = contacts[0].getIMs(ContactsApp.Field.GOOGLE_TALK);
for (var i in imAddresses) {
  Logger.log(imAddresses[i].getAddress());
}

Параметры

Имя Тип Описание
label Object метка для сопоставления либо из ContactsApp.Field, либо из пользовательской строки.

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

IMField[] — список IM-адресов

Авторизация

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

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

См. также

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

Возвращает уникальный идентификатор этого контакта. 

var contact = ContactsApp.createContact('John', 'Doe', 'john.doe@example.com');
var id = contact.getId();

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

String — идентификатор этого контакта

Авторизация

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

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

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

Получает инициалы контакта. 

// The code below logs the initials of all the contacts whose names contain "John Doe"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  Logger.log(contacts[i].getInitials());
}

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

String — инициалы контакта

Авторизация

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

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

См. также

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

Получает дату последнего обновления этого контакта. 

// The code below logs the last updated date of all the contacts whose names contain
// "John Doe"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  Logger.log(contacts[i].getLastUpdated());
}

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

Date — дата последнего обновления этого контакта.

Авторизация

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

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

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

Получает девичью фамилию контакта в виде строки. 

// The code below logs the maiden name of all the contacts whose names contain "Jane"
var contacts = ContactsApp.getContactsByName('Jane');
for (var i in contacts) {
  Logger.log(contacts[i].getMaidenName());
}

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

String — девичья фамилия контакта

Авторизация

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

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

См. также

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

Получает отчество контакта в виде строки. 

// The code below logs the middle name of all the contacts whose names contain "Smith"
var contacts = ContactsApp.getContactsByName('Smith');
for (var i in contacts) {
  Logger.log(contacts[i].getMiddleName());
}

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

String — отчество контакта

Авторизация

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

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

См. также

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

Получает номер мобильного телефона этого контакта или пустую строку, если таковая не существует.

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

String — номер мобильного телефона этого Контакта или пустая строка, если ее нет.

Авторизация

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

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

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

Получает псевдоним контакта в виде строки. 

// The code below logs the nickname of all the contacts whose names contain "John Doe"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  Logger.log(contacts[i].getNickname());
}

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

String — никнейм контакта

Авторизация

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

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

См. также

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

Получает заметки, связанные с этим контактом, или пустую строку, если заметок нет. 

// The code below logs the notes of all the contacts whose names contain "John Doe"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  Logger.log(contacts[i].getNotes());
}

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

String — заметки, связанные с этим контактом.

Авторизация

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

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

См. также

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

Получает номер телефона пейджера этого контакта или пустую строку, если таковая не существует.

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

String — номер телефона пейджера этого Контакта или пустая строка, если ее нет.

Авторизация

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

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

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

Получает все номера телефонов этого контакта. 

// The code below logs the phone numbers of all the contacts whose names contain "John Doe"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  Logger.log(contacts[i].getPhones());
}

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

PhoneField[] — список телефонных номеров

Авторизация

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

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

См. также

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

Получает все номера телефонов этого контакта, соответствующие определенному полю.

Метка может быть либо из ContactsApp.Field, либо из пользовательской строки метки. 

// The code below retrieves a contact named "John Doe" and logs the phone numbers
// associated with that contact that are in the ContactsApp.Field.WORK_PHONE label.
var contacts = ContactsApp.getContactsByName('John Doe');
var phones = contacts[0].getPhones(ContactsApp.Field.WORK_PHONE);
for (var i in phones) {
  Logger.log(phones[i].getPhoneNumber());
}

Параметры

Имя Тип Описание
label Object метка для сопоставления либо из ContactsApp.Field, либо из пользовательской строки.

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

PhoneField[] — список телефонных номеров

Авторизация

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

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

См. также

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

Получает префикс имени контакта. 

// The code below logs the prefix of all the contacts whose names contain "John Doe"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  Logger.log(contacts[i].getPrefix());
}

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

String — префикс имени контакта.

Авторизация

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

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

См. также

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

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

// The code below logs the primary email address of all the contacts whose names contain
// "John Doe"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  Logger.log(contacts[i].getPrimaryEmail());
}

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

String — основной адрес электронной почты контакта.

Авторизация

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

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

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

Получает краткое имя контакта в виде строки. 

// The code below logs the short name of all the contacts whose names contain "Johnathan"
var contacts = ContactsApp.getContactsByName('Johnathan');
for (var i in contacts) {
  Logger.log(contacts[i].getShortName());
}

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

String — короткое имя контакта

Авторизация

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

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

См. также

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

Получает суффикс имени контакта. 

// The code below logs the suffix of all the contacts whose names contain "John Doe"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  Logger.log(contacts[i].getSuffix());
}

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

String — суффикс имени контакта.

Авторизация

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

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

См. также

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

Получает все URL-адреса этого контакта. 

// The code below logs the URLs of all the contacts whose names contain "John Doe"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  Logger.log(contacts[i].getUrls());
}

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

UrlField[] — список URL-адресов

Авторизация

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

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

См. также

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

Получает все URL-адреса для этого контакта, соответствующие определенному полю.

Метка может быть либо из ContactsApp.Field, либо из пользовательской строки метки. 

// The code below retrieves a contact named "John Doe" and logs the URLs
// associated with that contact that are in the ContactsApp.Field.WORK_WEBSITE label.
var contacts = ContactsApp.getContactsByName('John Doe');
var urls = contacts[0].getUrls(ContactsApp.Field.WORK_WEBSITE);
for (var i in urls) {
  Logger.log(urls[i].getAddress());
}

Параметры

Имя Тип Описание
label Object метка для сопоставления либо из ContactsApp.Field, либо из пользовательской строки.

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

UrlField[] — список URL-адресов

Авторизация

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

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

См. также

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

Получает определенное пользователем значение, связанное с данным ключом.

Параметры

Имя Тип Описание
key String ключ может быть любого базового типа (String, int и т. д.).

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

String — определенный пользователем контент, который был сохранен с этим ключом.

Авторизация

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

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

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

Получает все определенные пользователем поля для этого контакта и возвращает их как свойства объекта JavaScript.

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

Object — определяемые пользователем поля для этого контакта как свойства объекта JavaScript.

Авторизация

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

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

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

Получает рабочий адрес этого контакта или пустую строку, если она не существует.

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

String — рабочий адрес этого Контакта или пустая строка, если ее нет.

Авторизация

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

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

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

Получает номер рабочего факса этого контакта или пустую строку, если она не существует.

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

String — номер рабочего факса этого Контакта или пустая строка, если таковая не существует.

Авторизация

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

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

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

Получает номер рабочего телефона этого контакта или пустую строку, если она не существует.

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

String — рабочий номер телефона этого Контакта или пустая строка, если ее нет.

Авторизация

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

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

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

Удаляет этот контакт из данной группы контактов. 

// The code below gets all the contacts named "John Doe" and then removes each of them from
// the "Work Friends" contact group
var contacts = ContactsApp.getContactsByName('John Doe');
var group = ContactsApp.getContactGroup('Work Friends');
for (var i in contacts) {
  contacts[i] = contacts[i].removeFromGroup(group);
}

Параметры

Имя Тип Описание
group ContactGroup группа контактов, из которой нужно удалить этот контакт

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

Contact — этот контакт

Авторизация

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

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

См. также

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

Устанавливает фамилию (фамилию) контакта. 

// The code below changes the family name of all the contacts whose names are "John Doe"
// to "Doe-Smith"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  contacts[i].setFamilyName('Doe-Smith');
}

Параметры

Имя Тип Описание
familyName String новая фамилия контактного лица

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

Contact — этот контакт

Авторизация

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

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

См. также

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

Устанавливает полное имя (имя и фамилию) контакта. 

// The code below changes the full name of all the contacts whose names are "John Doe"
// to "Johnny Doe"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  contacts[i].setFullName('Johnny Doe');
}

Параметры

Имя Тип Описание
fullName String новое полное имя контакта

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

Contact — этот контакт

Авторизация

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

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

См. также

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

Устанавливает имя (имя) контакта. 

// The code below changes the given name of all the contacts whose names are "John Doe"
// to "Johnny"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  contacts[i].setGivenName('Johnny');
}

Параметры

Имя Тип Описание
givenName String новое имя контакта

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

Contact — этот контакт

Авторизация

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

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

См. также

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

Устанавливает домашний адрес этого контакта.

Параметры

Имя Тип Описание
addr String домашний адрес, который нужно установить

Авторизация

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

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

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

Устанавливает номер домашнего факса этого контакта.

Параметры

Имя Тип Описание
phone String номер домашнего факса, который нужно установить

Авторизация

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

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

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

Устанавливает номер домашнего телефона этого контакта.

Параметры

Имя Тип Описание
phone String номер домашнего телефона, который нужно установить

Авторизация

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

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

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

Устанавливает инициалы контакта. 

// The code below sets the initials of all the contacts whose names are "Johnathan Doe"
// to "JD"
var contacts = ContactsApp.getContactsByName('Johnathan Doe');
for (var i in contacts) {
  contacts[i].setInitials('JD');
}

Параметры

Имя Тип Описание
initials String новые инициалы контакта

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

Contact — этот контакт

Авторизация

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

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

См. также

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

Устанавливает девичью фамилию контакта. 

// The code below changes the maiden name of all the contacts whose names are "Jane Doe"
// to "Smith"
var contacts = ContactsApp.getContactsByName('Jane Doe');
for (var i in contacts) {
  contacts[i].setMaidenName('Smith');
}

Параметры

Имя Тип Описание
maidenName String новая девичья фамилия контакта

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

Contact — этот контакт

Авторизация

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

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

См. также

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

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

// The code below changes the middle name of all the contacts whose names are "John Doe"
// to "Danger"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  contacts[i].setMiddleName('Danger');
}

Параметры

Имя Тип Описание
middleName String новое второе имя контакта

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

Contact — этот контакт

Авторизация

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

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

См. также

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

Устанавливает номер мобильного телефона этого контакта.

Параметры

Имя Тип Описание
phone String номер мобильного телефона, который нужно установить

Авторизация

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

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

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

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

// The code below changes the nickname of all the contacts whose names are "John Doe"
// to "JohnnyD"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  contacts[i].setNickname('JohnnyD');
}

Параметры

Имя Тип Описание
nickname String новый никнейм контакта

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

Contact — этот контакт

Авторизация

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

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

См. также

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

Устанавливает заметки, связанные с этим контактом. 

// The code below sets the notes of all the contacts whose names are "John Doe"
// to "Met him at the hackathon"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  contacts[i].setNotes('Met him at the hackathon');
}

Параметры

Имя Тип Описание
notes String заметки, которые будут храниться для этого контакта

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

Contact — этот контакт

Авторизация

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

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

См. также

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

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

Параметры

Имя Тип Описание
phone String номер пейджера, который нужно установить

Авторизация

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

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

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

Устанавливает префикс имени контакта. 

// The code below sets the prefix of all the contacts whose names are "Johnathan Doe"
// to "Mr"
var contacts = ContactsApp.getContactsByName('Johnathan Doe');
for (var i in contacts) {
  contacts[i].setPrefix('Mr');
}

Параметры

Имя Тип Описание
prefix String новый префикс имени контакта

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

Contact — этот контакт

Авторизация

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

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

См. также

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

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

Параметры

Имя Тип Описание
primaryEmail String основной адрес электронной почты, который нужно установить

Авторизация

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

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

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

Устанавливает краткое имя контакта. 

// The code below changes the short name of all the contacts whose names are "Johnathan Doe"
// to "John"
var contacts = ContactsApp.getContactsByName('Johnathan Doe');
for (var i in contacts) {
  contacts[i].setShortName('John');
}

Параметры

Имя Тип Описание
shortName String новое короткое имя контакта

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

Contact — этот контакт

Авторизация

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

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

См. также

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

Устанавливает суффикс к имени контакта. 

// The code below sets the suffix of all the contacts whose names are "Johnathan Doe"
// to "Jr"
var contacts = ContactsApp.getContactsByName('Johnathan Doe');
for (var i in contacts) {
  contacts[i].setSuffix('Jr');
}

Параметры

Имя Тип Описание
suffix String новый суффикс имени контакта

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

Contact — этот контакт

Авторизация

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

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

См. также

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

Устанавливает одно пользовательское поле для этого контакта, которое будет храниться с заданным ключом.

Параметры

Имя Тип Описание
key String ключ может быть любого базового типа (String, int и т. д.).
value String значение может быть любого базового типа (String, int и т. д.).

Авторизация

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

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

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

Устанавливает определенные пользователем поля для этого Контакта со свойствами данного Объекта.

Параметры

Имя Тип Описание
o Object Объект с одним или несколькими свойствами в форме {ключ: значение}

Авторизация

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

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

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

Устанавливает рабочий адрес этого контакта.

Параметры

Имя Тип Описание
addr String рабочий адрес, который нужно установить

Авторизация

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

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

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

Устанавливает номер рабочего факса этого контакта.

Параметры

Имя Тип Описание
phone String номер рабочего факса, который нужно установить

Авторизация

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

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

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

Устанавливает рабочий номер телефона этого контакта.

Параметры

Имя Тип Описание
phone String рабочий номер телефона, который нужно установить

Авторизация

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

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