Эта страница переведена с помощью Cloud Translation API.

Class Contact

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

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

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

Метод	Тип возврата	Краткое описание
`add Address(label, address)`	`Address Field`	Добавляет адрес к контакту со стандартной или настраиваемой меткой.
`add Company(company, title)`	`Company Field`	Добавляет компанию в контакт.
`add Custom Field(label, content)`	`Custom Field`	Добавляет к контакту настраиваемое поле с расширенной или настраиваемой меткой.
`add Date(label, month, day, year)`	`Date Field`	Добавляет дату к контакту со стандартной или настраиваемой меткой.
`add Email(label, address)`	`Email Field`	Добавьте адрес электронной почты со стандартной меткой (домашний, рабочий и т. д.) или собственной меткой. {@code // 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.
`add IM(label, address)`	`IMField`	Добавляет к контакту адрес обмена мгновенными сообщениями со стандартной или настраиваемой меткой.
`add Phone(label, number)`	`Phone Field`	Добавляет номер телефона к контакту со стандартной или настраиваемой меткой.
`add To Group(group)`	`Contact`	Добавляет этот контакт в данную группу контактов.
`add Url(label, url)`	`Url Field`	Добавляет URL-адрес контакта со стандартной или настраиваемой меткой.
`delete Contact()`	`void`	Удаляет этот контакт.
`get Addresses()`	`Address Field[]`	Получает все адреса этого контакта.
`get Addresses(label)`	`Address Field[]`	Получает все адреса этого контакта, соответствующие определенному полю.
`get Companies()`	`Company Field[]`	Получает все компании для этого контакта.
`get Contact Groups()`	`Contact Group[]`	Получает все группы контактов, содержащие этот контакт.
`get Custom Fields()`	`Custom Field[]`	Получает все настраиваемые поля для этого контакта.
`get Custom Fields(label)`	`Custom Field[]`	Получает все настраиваемые поля для этого контакта, соответствующие определенному полю.
`get Dates()`	`Date Field[]`	Получает все даты для этого контакта.
`get Dates(label)`	`Date Field[]`	Получает все даты для этого контакта, соответствующие определенному полю.
`get Email Addresses()`	`String[]`	Получает список адресов электронной почты, доступных для этого контакта.
`get Emails()`	`Email Field[]`	Получает адреса электронной почты этого контакта.
`get Emails(label)`	`Email Field[]`	Получает адреса электронной почты для этого контакта, соответствующие определенному полю.
`get Family Name()`	`String`	Получает фамилию (фамилию) контакта в виде строки.
`get Full Name()`	`String`	Получает полное имя (имя и фамилию) контакта в виде строки.
`get Given Name()`	`String`	Получает имя (имя) контакта в виде строки.
`get Home Address()`	`String`	Получает домашний адрес этого контакта или пустую строку, если таковая не существует.
`get Home Fax()`	`String`	Получает номер домашнего факса этого контакта или пустую строку, если таковая не существует.
`get Home Phone()`	`String`	Получает номер домашнего телефона этого контакта или пустую строку, если она не существует.
`get IMs()`	`IMField[]`	Получает все адреса мгновенных сообщений для этого контакта.
`get IMs(label)`	`IMField[]`	Получает все адреса мгновенных сообщений для этого контакта, соответствующие определенному полю.
`get Id()`	`String`	Возвращает уникальный идентификатор этого контакта.
`get Initials()`	`String`	Получает инициалы контакта.
`get Last Updated()`	`Date`	Получает дату последнего обновления этого контакта.
`get Maiden Name()`	`String`	Получает девичью фамилию контакта в виде строки.
`get Middle Name()`	`String`	Получает отчество контакта в виде строки.
`get Mobile Phone()`	`String`	Получает номер мобильного телефона этого контакта или пустую строку, если таковая не существует.
`get Nickname()`	`String`	Получает псевдоним контакта в виде строки.
`get Notes()`	`String`	Получает заметки, связанные с этим контактом, или пустую строку, если заметок нет.
`get Pager()`	`String`	Получает номер телефона пейджера этого контакта или пустую строку, если таковая не существует.
`get Phones()`	`Phone Field[]`	Получает все номера телефонов этого контакта.
`get Phones(label)`	`Phone Field[]`	Получает все номера телефонов этого контакта, соответствующие определенному полю.
`get Prefix()`	`String`	Получает префикс имени контакта.
`get Primary Email()`	`String`	Получает основной адрес электронной почты контакта в виде строки.
`get Short Name()`	`String`	Получает краткое имя контакта в виде строки.
`get Suffix()`	`String`	Получает суффикс имени контакта.
`get Urls()`	`Url Field[]`	Получает все URL-адреса этого контакта.
`get Urls(label)`	`Url Field[]`	Получает все URL-адреса для этого контакта, соответствующие определенному полю.
`get User Defined Field(key)`	`String`	Получает определенное пользователем значение, связанное с данным ключом.
`get User Defined Fields()`	`Object`	Получает все определенные пользователем поля для этого контакта и возвращает их как свойства объекта JavaScript.
`get Work Address()`	`String`	Получает рабочий адрес этого контакта или пустую строку, если она не существует.
`get Work Fax()`	`String`	Получает номер рабочего факса этого контакта или пустую строку, если она не существует.
`get Work Phone()`	`String`	Получает номер рабочего телефона этого контакта или пустую строку, если таковая не существует.
`remove From Group(group)`	`Contact`	Удаляет этот контакт из данной группы контактов.
`set Family Name(familyName)`	`Contact`	Устанавливает фамилию (фамилию) контакта.
`set Full Name(fullName)`	`Contact`	Устанавливает полное имя (имя и фамилию) контакта.
`set Given Name(givenName)`	`Contact`	Устанавливает имя (имя) контакта.
`set Home Address(addr)`	`void`	Устанавливает домашний адрес этого контакта.
`set Home Fax(phone)`	`void`	Устанавливает номер домашнего факса этого контакта.
`set Home Phone(phone)`	`void`	Устанавливает номер домашнего телефона этого контакта.
`set Initials(initials)`	`Contact`	Устанавливает инициалы контакта.
`set Maiden Name(maidenName)`	`Contact`	Устанавливает девичью фамилию контакта.
`set Middle Name(middleName)`	`Contact`	Устанавливает отчество контакта.
`set Mobile Phone(phone)`	`void`	Устанавливает номер мобильного телефона этого контакта.
`set Nickname(nickname)`	`Contact`	Устанавливает псевдоним контакта.
`set Notes(notes)`	`Contact`	Устанавливает заметки, связанные с этим контактом.
`set Pager(phone)`	`void`	Устанавливает номер пейджера этого контакта.
`set Prefix(prefix)`	`Contact`	Устанавливает префикс имени контакта.
`set Primary Email(primaryEmail)`	`void`	Устанавливает основной адрес электронной почты этого контакта.
`set Short Name(shortName)`	`Contact`	Устанавливает краткое имя контакта.
`set Suffix(suffix)`	`Contact`	Устанавливает суффикс к имени контакта.
`set User Defined Field(key, value)`	`void`	Устанавливает одно пользовательское поле для этого контакта, которое будет храниться с заданным ключом.
`set User Defined Fields(o)`	`void`	Устанавливает определенные пользователем поля для этого Контакта со свойствами данного Объекта.
`set Work Address(addr)`	`void`	Устанавливает рабочий адрес этого контакта.
`set Work Fax(phone)`	`void`	Устанавливает номер рабочего факса этого контакта.
`set Work Phone(phone)`	`void`	Устанавливает рабочий номер телефона этого контакта.

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

`add Address(label, address)`

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

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

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

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

Параметры

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

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

Address Field — вновь созданное поле.

Авторизация

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

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

См. также

get Addresses()

`add Company(company, title)`

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

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

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

Параметры

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

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

Company Field — вновь созданное поле.

Авторизация

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

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

См. также

get Companies()

`add Custom Field(label, content)`

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

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

Метка может быть либо из 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'.
const contacts = ContactsApp.getContactsByName('John Doe');
contacts[0].addCustomField(ContactsApp.ExtendedField.HOBBY, 'hiking');

Параметры

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

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

Custom Field — вновь созданное поле.

Авторизация

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

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

См. также

get Custom Fields()

`add Date(label, month, day, year)`

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

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

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

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

Параметры

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

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

Date Field — вновь созданная дата.

Авторизация

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

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

См. также

get Dates()

`add Email(label, address)`

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

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

// 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.
const contacts = ContactsApp.getContactsByName('John Doe');
const emailField = contacts[0].addEmail(
    ContactsApp.Field.HOME_EMAIL,
    'j.doe@example.com',
);

Параметры

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

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

Email Field — новое добавленное поле.

Авторизация

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

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

`add IM(label, address)`

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

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

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

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

Параметры

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

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

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

Авторизация

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

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

См. также

get IMs()

`add Phone(label, number)`

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

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

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

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

Параметры

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

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

Phone Field — вновь созданное поле.

Авторизация

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

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

См. также

get Phones()

`add To Group(group)`

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

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

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

Параметры

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

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

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

Авторизация

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

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

См. также

remove From Group(group)

`add Url(label, url)`

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

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

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

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

Параметры

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

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

Url Field — вновь созданное поле.

Авторизация

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

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

См. также

get Urls()

`delete Contact()`

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

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

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

Авторизация

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

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

`get Addresses()`

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

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

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

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

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

Авторизация

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

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

См. также

add Address(label, address)

`get Addresses(label)`

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

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

Метка может быть либо из 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.
const contacts = ContactsApp.getContactsByName('John Doe');
const addresses = contacts[0].getAddresses(ContactsApp.Field.WORK_ADDRESS);
for (const i in addresses) {
  Logger.log(addresses[i].getAddress());
}

Параметры

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

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

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

Авторизация

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

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

См. также

add Address(label, address)

`get Companies()`

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

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

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

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

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

Авторизация

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

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

См. также

add Company(company, title)

`get Contact Groups()`

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

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

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

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

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

См. также

add To Group(group)

`get Custom Fields()`

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

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

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

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

Custom Field[] — список произвольных полей.

Авторизация

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

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

См. также

add Custom Field(label, content)

`get Custom Fields(label)`

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

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

Метка может быть либо стандартной меткой из 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.
const contacts = ContactsApp.getContactsByName('John Doe');
const hobbies = contacts[0].getCustomFields(ContactsApp.ExtendedField.HOBBY);
for (const i in hobbies) {
  Logger.log(hobbies[i].getValue());
}

Параметры

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

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

Custom Field[] — список произвольных полей.

Авторизация

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

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

См. также

add Custom Field(label, content)

`get Dates()`

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

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

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

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

Date Field[] — список дат

Авторизация

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

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

См. также

add Date(label, month, day, year)

`get Dates(label)`

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

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

Метка может быть либо стандартной меткой из 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.
const contacts = ContactsApp.getContactsByName('John Doe');
const birthdays = contacts[0].getDates(ContactsApp.Field.BIRTHDAY);
for (const i in birthdays) {
  Logger.log(birthdays[i].getDay());
}

Параметры

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

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

Date Field[] — список дат

Авторизация

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

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

См. также

add Date(label, month, day, year)

`get Email Addresses()`

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

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

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

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

Авторизация

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

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

`get Emails()`

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

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

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

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

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

Авторизация

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

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

См. также

add Email(label, address)

`get Emails(label)`

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

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

Метка может быть либо стандартной меткой из 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.
const contacts = ContactsApp.getContactsByName('John Doe');
const emails = contacts[0].getEmails(ContactsApp.Field.HOME_EMAIL);
for (const i in emails) {
  Logger.log(emails[i].getAddress());
}

Параметры

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

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

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

Авторизация

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

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

См. также

add Email(label, address)

`get Family Name()`

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

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

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

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

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

Авторизация

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

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

См. также

set Family Name(familyName)

`get Full Name()`

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

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

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

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

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

Авторизация

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

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

См. также

set Full Name(fullName)

`get Given Name()`

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

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

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

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

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

Авторизация

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

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

См. также

set Given Name(givenName)

`get Home Address()`

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

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

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

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

Авторизация

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

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

`get Home Fax()`

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

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

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

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

Авторизация

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

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

`get Home Phone()`

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

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

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

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

Авторизация

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

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

`get IMs()`

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

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

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

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

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

Авторизация

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

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

См. также

add IM(label, address)

`get IMs(label)`

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

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

Метка может быть либо из 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.
const contacts = ContactsApp.getContactsByName('John Doe');
const imAddresses = contacts[0].getIMs(ContactsApp.Field.GOOGLE_TALK);
for (const i in imAddresses) {
  Logger.log(imAddresses[i].getAddress());
}

Параметры

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

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

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

Авторизация

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

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

См. также

add IM(label, address)

`get Id()`

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

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

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

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

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

Авторизация

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

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

`get Initials()`

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

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

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

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

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

Авторизация

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

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

См. также

set Initials(initials)

`get Last Updated()`

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

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

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

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

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

Авторизация

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

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

`get Maiden Name()`

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

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

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

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

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

Авторизация

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

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

См. также

set Maiden Name(maidenName)

`get Middle Name()`

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

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

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

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

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

Авторизация

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

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

См. также

set Middle Name(middleName)

`get Mobile Phone()`

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

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

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

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

Авторизация

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

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

`get Nickname()`

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

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

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

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

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

Авторизация

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

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

См. также

set Nickname(nickname)

`get Notes()`

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

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

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

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

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

Авторизация

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

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

См. также

set Notes(notes)

`get Pager()`

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

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

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

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

Авторизация

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

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

`get Phones()`

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

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

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

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

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

Авторизация

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

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

См. также

add Phone(label, number)

`get Phones(label)`

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

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

Метка может быть либо из 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.
const contacts = ContactsApp.getContactsByName('John Doe');
const phones = contacts[0].getPhones(ContactsApp.Field.WORK_PHONE);
for (const i in phones) {
  Logger.log(phones[i].getPhoneNumber());
}

Параметры

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

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

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

Авторизация

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

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

См. также

add Phone(label, number)

`get Prefix()`

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

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

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

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

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

Авторизация

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

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

См. также

set Prefix(prefix)

`get Primary Email()`

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

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

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

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

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

Авторизация

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

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

`get Short Name()`

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

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

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

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

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

Авторизация

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

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

См. также

set Short Name(shortName)

`get Suffix()`

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

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

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

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

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

Авторизация

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

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

См. также

set Suffix(suffix)

`get Urls()`

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

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

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

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

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

Авторизация

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

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

См. также

add Url(label, url)

`get Urls(label)`

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

Получает все 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.
const contacts = ContactsApp.getContactsByName('John Doe');
const urls = contacts[0].getUrls(ContactsApp.Field.WORK_WEBSITE);
for (const i in urls) {
  Logger.log(urls[i].getAddress());
}

Параметры

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

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

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

Авторизация

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

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

См. также

add Url(label, url)

`get User Defined Field(key)`

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

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

Параметры

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

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

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

Авторизация

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

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

`get User Defined Fields()`

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

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

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

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

Авторизация

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

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

`get Work Address()`

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

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

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

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

Авторизация

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

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

`get Work Fax()`

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

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

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

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

Авторизация

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

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

`get Work Phone()`

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

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

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

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

Авторизация

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

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

`remove From Group(group)`

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

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

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

Параметры

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

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

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

Авторизация

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

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

См. также

add To Group(group)

`set Family Name(familyName)`

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

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

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

Параметры

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

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

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

Авторизация

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

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

См. также

get Family Name()

`set Full Name(fullName)`

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

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

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

Параметры

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

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

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

Авторизация

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

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

См. также

get Full Name()

`set Given Name(givenName)`

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

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

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

Параметры

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

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

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

Авторизация

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

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

См. также

get Given Name()

`set Home Address(addr)`

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

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

Параметры

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

Авторизация

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

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

`set Home Fax(phone)`

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

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

Параметры

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

Авторизация

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

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

`set Home Phone(phone)`

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

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

Параметры

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

Авторизация

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

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

`set Initials(initials)`

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

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

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

Параметры

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

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

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

Авторизация

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

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

См. также

get Initials()

`set Maiden Name(maidenName)`

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

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

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

Параметры

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

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

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

Авторизация

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

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

См. также

get Maiden Name()

`set Middle Name(middleName)`

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

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

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

Параметры

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

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

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

Авторизация

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

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

См. также

get Middle Name()

`set Mobile Phone(phone)`

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

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

Параметры

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

Авторизация

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

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

`set Nickname(nickname)`

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

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

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

Параметры

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

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

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

Авторизация

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

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

См. также

get Nickname()

`set Notes(notes)`

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

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

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

Параметры

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

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

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

Авторизация

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

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

См. также

get Notes()

`set Pager(phone)`

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

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

Параметры

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

Авторизация

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

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

`set Prefix(prefix)`

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

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

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

Параметры

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

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

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

Авторизация

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

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

См. также

get Prefix()

`set Primary Email(primaryEmail)`

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

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

Параметры

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

Авторизация

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

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

`set Short Name(shortName)`

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

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

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

Параметры

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

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

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

Авторизация

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

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

См. также

get Short Name()

`set Suffix(suffix)`

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

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

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

Параметры

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

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

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

Авторизация

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

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

См. также

get Suffix()

`set User Defined Field(key, value)`

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

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

Параметры

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

Авторизация

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

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

`set User Defined Fields(o)`

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

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

Параметры

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

Авторизация

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

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

`set Work Address(addr)`

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

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

Параметры

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

Авторизация

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

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

`set Work Fax(phone)`

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

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

Параметры

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

Авторизация

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

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

`set Work Phone(phone)`

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

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

Параметры

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

Авторизация

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

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

Class Contact Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

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

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

add Address(label, address)

Параметры

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

Авторизация

См. также

add Company(company, title)

Параметры

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

Авторизация

См. также

add Custom Field(label, content)

Параметры

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

Авторизация

См. также

add Date(label, month, day, year)

Параметры

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

Авторизация

См. также

add Email(label, address)

Параметры

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

Авторизация

add IM(label, address)

Параметры

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

Авторизация

См. также

add Phone(label, number)

Параметры

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

Авторизация

См. также

add To Group(group)

Параметры

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

Авторизация

См. также

add Url(label, url)

Параметры

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

Авторизация

См. также

delete Contact()

Авторизация

get Addresses()

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

Авторизация

См. также

get Addresses(label)

Параметры

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

Авторизация

См. также

get Companies()

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

Авторизация

См. также

get Contact Groups()

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

См. также

get Custom Fields()

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

Авторизация

См. также

get Custom Fields(label)

Параметры

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

Авторизация

См. также

get Dates()

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

Авторизация

См. также

get Dates(label)

Параметры

Class Contact

`add Address(label, address)`

`add Company(company, title)`

`add Custom Field(label, content)`

`add Date(label, month, day, year)`

`add Email(label, address)`

`add IM(label, address)`

`add Phone(label, number)`

`add To Group(group)`

`add Url(label, url)`

`delete Contact()`

`get Addresses()`

`get Addresses(label)`

`get Companies()`

`get Contact Groups()`

`get Custom Fields()`

`get Custom Fields(label)`

`get Dates()`

`get Dates(label)`

`get Email Addresses()`

`get Emails()`

`get Emails(label)`

`get Family Name()`

`get Full Name()`

`get Given Name()`

`get Home Address()`

`get Home Fax()`

`get Home Phone()`

`get IMs()`

`get IMs(label)`

`get Id()`

`get Initials()`

`get Last Updated()`

`get Maiden Name()`

`get Middle Name()`

`get Mobile Phone()`

`get Nickname()`