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

Class ContactsApp

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

Этот класс позволяет пользователям получать доступ к своим контактам Google, а также создавать, удалять и обновлять перечисленные в них контакты.

Устаревшие свойства

Свойство	Тип	Описание
`Extended Field`	`Extended Field`
`Field`	`Field`
`Gender`	`Gender`
`Month`	`Month`
`Priority`	`Priority`
`Sensitivity`	`Sensitivity`

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

Метод	Тип возврата	Краткое описание
`create Contact(givenName, familyName, email)`	`Contact`	Создает новый контакт.
`create Contact Group(name)`	`Contact Group`	Создает группу контактов с заданным именем. // The code below creates a new contact group named "Work Friends" const group = ContactsApp.createContactGroup('Work Friends');
`delete Contact(contact)`	`void`	Удаляет контакт.
`delete Contact Group(group)`	`void`	Удаляет группу контактов // The code below creates deletes the contact group named "Work Friends" const group = ContactsApp.getContactGroup('Work Friends'); ContactsApp.deleteContactGroup(group);
`find By Email Address(email)`	`Contact`	Находит контакт с указанным адресом электронной почты.
`find Contact Group(name)`	`Contact Group`	Находит группу контактов по заданному имени.
`get All Contacts()`	`Contact[]`	Получите все контакты, принадлежащие этому пользователю.
`get Contact(emailAddress)`	`Contact`	Получает контакт по адресу электронной почты.
`get Contact By Id(id)`	`Contact`	Получает контакт с этим идентификатором.
`get Contact Group(name)`	`Contact Group`	Получает группу контактов с заданным именем или возвращает значение null, если такая группа контактов не найдена.
`get Contact Group By Id(id)`	`Contact Group`	Получает группу контактов с заданным идентификатором или возвращает значение null, если такая группа контактов не найдена.
`get Contact Groups()`	`Contact Group[]`	Получает полный список групп контактов пользователя.
`get Contacts()`	`Contact[]`	Получает все контакты пользователя.
`get Contacts By Address(query)`	`Contact[]`	Получите контакты, соответствующие адресу.
`get Contacts By Address(query, label)`	`Contact[]`	Получите контакты, соответствующие адресу, ограниченному определенным полем.
`get Contacts By Address(query, label)`	`Contact[]`	Получите контакты, соответствующие адресу, ограниченному указанной настраиваемой меткой адреса.
`get Contacts By Company(query)`	`Contact[]`	Получите контакты, соответствующие полю компании.
`get Contacts By Custom Field(query, label)`	`Contact[]`	Получите контакты, соответствующие заданному значению в настраиваемом поле.
`get Contacts By Date(month, day, label)`	`Contact[]`	Получите контакты, соответствующие заданному месяцу и дню, для определенного стандартного поля.
`get Contacts By Date(month, day, year, label)`	`Contact[]`	Получите контакты, соответствующие заданному месяцу, дню и году, для определенного стандартного поля.
`get Contacts By Date(month, day, year, label)`	`Contact[]`	Получите контакты, соответствующие заданному месяцу, дню и году, для определенного настраиваемого поля.
`get Contacts By Date(month, day, label)`	`Contact[]`	Получите контакты, соответствующие заданному месяцу и дню, для определенного настраиваемого поля.
`get Contacts By Email Address(query)`	`Contact[]`	Получите контакты, соответствующие адресу электронной почты.
`get Contacts By Email Address(query, label)`	`Contact[]`	Получите контакты, соответствующие адресу электронной почты, ограниченные определенным полем.
`get Contacts By Email Address(query, label)`	`Contact[]`	Получайте контакты, соответствующие адресу электронной почты, ограниченные указанной настраиваемой меткой адреса электронной почты.
`get Contacts By Group(group)`	`Contact[]`	Получите контакты в данной ContactGroup.
`get Contacts By IM(query)`	`Contact[]`	Получите контакты, соответствующие адресу обмена мгновенными сообщениями.
`get Contacts By IM(query, label)`	`Contact[]`	Получите контакты, соответствующие адресу обмена мгновенными сообщениями, ограниченному определенным полем.
`get Contacts By IM(query, label)`	`Contact[]`	Получайте контакты, соответствующие адресу обмена мгновенными сообщениями, ограниченному указанной настраиваемой меткой обмена мгновенными сообщениями.
`get Contacts By Job Title(query)`	`Contact[]`	Получите контакты, соответствующие полю должности.
`get Contacts By Name(query)`	`Contact[]`	Получите контакты, соответствующие имени.
`get Contacts By Name(query, label)`	`Contact[]`	Получите контакты, соответствующие имени, ограниченные определенным полем.
`get Contacts By Notes(query)`	`Contact[]`	Получите контакты, соответствующие полю примечаний.
`get Contacts By Phone(query)`	`Contact[]`	Получите контакты, соответствующие номеру телефона.
`get Contacts By Phone(query, label)`	`Contact[]`	Получите контакты, соответствующие номеру телефона, ограниченному определенным полем.
`get Contacts By Phone(query, label)`	`Contact[]`	Получайте контакты, соответствующие номеру телефона, ограниченные указанной настраиваемой меткой номера телефона.
`get Contacts By Url(query)`	`Contact[]`	Получите контакты, соответствующие URL-адресу.
`get Contacts By Url(query, label)`	`Contact[]`	Получите контакты, соответствующие URL-адресу, ограниченному определенным полем.
`get Contacts By Url(query, label)`	`Contact[]`	Получите контакты, соответствующие URL-адресу, ограниченному указанной настраиваемой меткой URL-адреса.

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

`create Contact(givenName, familyName, email)`

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

Создает новый контакт.

// The code below creates a new contact with the name "John Doe" and the email
// address "john.doe@example.com".
const contact = ContactsApp.createContact(
    'John',
    'Doe',
    'john.doe@example.com',
);

Параметры

Имя	Тип	Описание
`given Name`	`String`	имя контакта
`family Name`	`String`	фамилия контактного лица
`email`	`String`	адрес электронной почты контактного лица

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

Contact — вновь созданный объект Контакта.

Авторизация

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

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

См. также

delete Contact(contact)

`create Contact Group(name)`

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

Создает группу контактов с заданным именем.

// The code below creates a new contact group named "Work Friends"
const group = ContactsApp.createContactGroup('Work Friends');

Параметры

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

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

Contact Group — вновь созданная контактная группа.

Авторизация

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

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

См. также

delete Contact Group(group)

`delete Contact(contact)`

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

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

// The code below retrieves a contact with the email address
// "john.doe@example.com" and then deletes that contact.
const contact = ContactsApp.getContact('john.doe@example.com');
ContactsApp.deleteContact(contact);

Параметры

Имя	Тип	Описание
`contact`	`Contact`	контакт, который нужно удалить

Авторизация

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

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

См. также

create Contact(givenName, familyName, email)

`delete Contact Group(group)`

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

Удаляет группу контактов

// The code below creates deletes the contact group named "Work Friends"
const group = ContactsApp.getContactGroup('Work Friends');
ContactsApp.deleteContactGroup(group);

Параметры

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

Авторизация

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

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

См. также

create Contact Group(name)

`find By Email Address(email)`

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

Находит контакт с указанным адресом электронной почты.

Параметры

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

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

Contact — Контакт, содержащий этот адрес электронной почты.

Авторизация

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

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

`find Contact Group(name)`

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

Находит группу контактов по заданному имени.

Параметры

Имя	Тип	Описание
`name`	`String`	название контактной группы, которую нужно найти

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

Contact Group — группа контактов, соответствующая данному имени.

Авторизация

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

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

`get All Contacts()`

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

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

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

Contact[] — все контакты этого пользователя

Авторизация

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

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

`get Contact(emailAddress)`

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

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

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

// The code below retrieves a contact with the email address
// "john.doe@example.com".
const contact = ContactsApp.getContact('john.doe@example.com');

Параметры

Имя	Тип	Описание
`email Address`	`String`	адрес электронной почты контактного лица

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

Contact — контакт, содержащий этот адрес электронной почты.

Авторизация

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

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

`get Contact By Id(id)`

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

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

// The code below retrieves the contact with the id
// "http://www.google.com/m8/feeds/contacts/john.doe%40example.com/base/7c86afde08d34ca5"
const id =
    'http://www.google.com/m8/feeds/contacts/john.doe%40example.com/base/7c86afde08d34c';
const contact = ContactsApp.getContactById(id);

Параметры

Имя	Тип	Описание
`id`	`String`	идентификатор контакта для получения

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

Contact — соответствующий контакт или ноль

Авторизация

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

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

См. также

get Contact(emailAddress)

`get Contact Group(name)`

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

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

// The code below returns the contact group with the name "Work Friends"
const group = ContactsApp.getContactGroup('Work Friends');

Параметры

Имя	Тип	Описание
`name`	`String`	имя контактной группы для сопоставления

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

Contact Group — соответствующая группа контактов или значение NULL, если соответствующая группа контактов не найдена.

Авторизация

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

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

См. также

get Contact Groups()

`get Contact Group By Id(id)`

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

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

// The code below returns the contact group with the id
// "http://www.google.com/m8/feeds/groups/john.doe%40example.com/base/54eefbb093fdecb"
const id =
    'http://www.google.com/m8/feeds/groups/john.doe%40example.com/base/54eefbb093fdecb';
const group = ContactsApp.getContactGroupById(id);

Параметры

Имя	Тип	Описание
`id`	`String`	идентификатор группы контактов для сопоставления

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

См. также

get Contact Groups()

`get Contact Groups()`

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

Получает полный список групп контактов пользователя.

Пользователь может иметь список контактов, а также, возможно, список групп контактов. Каждая группа контактов может содержать контакты. Этот метод возвращает список всех групп контактов.

// The retrieves all the contract groups for the user and then logs the group
// name of each contact group.
const groups = ContactsApp.getContactGroups();
for (let i = 0; i < groups.length; i++) {
  Logger.log(groups[i].getName());
}

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

Contact Group[] — массив групп контактов пользователя.

Авторизация

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

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

См. также

get Contact Group(name)

`get Contacts()`

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

Получает все контакты пользователя.

// The code below will retrieve all the user's contacts
const contacts = ContactsApp.getContacts();

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

Contact[] — массив всех контактов пользователя

Авторизация

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

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

См. также

get Contact(emailAddress)

`get Contacts By Address(query)`

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

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

// The code below returns an array of contacts where the contact's address
// contains "San Francisco'.
const contacts = ContactsApp.getContactsByAddress('San Francisco');

Параметры

Имя	Тип	Описание
`query`	`String`	строка для поиска в адресах контактов

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

Contact[] — массив совпадающих контактов

Авторизация

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

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

См. также

get Contact(emailAddress)

`get Contacts By Address(query, label)`

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

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

// The code below returns an array of contacts where the contact's address
// contains "San Francisco" in the Home address field.
const contacts = ContactsApp.getContactsByAddress(
    'San Francisco',
    ContactsApp.Field.HOME_ADDRESS,
);

Параметры

Имя	Тип	Описание
`query`	`String`	строка для поиска в адресах контактов
`label`	`Field`	поле для поиска внутри

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

Contact[] — массив совпадающих контактов

Авторизация

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

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

См. также

get Contact(emailAddress)

`get Contacts By Address(query, label)`

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

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

// The code below returns an array of contacts where the contact's address
// contains "San Francisco" in a custom address label (created by the user)
// called "vacation".
const contacts = ContactsApp.getContactsByAddress('San Francisco', 'vacation');

Параметры

Имя	Тип	Описание
`query`	`String`	строка для поиска в адресах контактов с указанной настраиваемой адресной меткой
`label`	`String`	настраиваемая адресная метка для поиска внутри

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

Contact[] — массив совпадающих контактов

Авторизация

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

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

См. также

get Contact(emailAddress)

`get Contacts By Company(query)`

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

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

// The code below returns an array of contacts where the contact's company field
// contains "Google".
const contacts = ContactsApp.getContactsByCompany('Google');

Параметры

Имя	Тип	Описание
`query`	`String`	строка для поиска в поле компании контакта

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

Contact[] — массив совпадающих контактов

Авторизация

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

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

См. также

get Contact(emailAddress)

`get Contacts By Custom Field(query, label)`

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

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

Настраиваемое поле можно указать в виде строки или одного из значений ContactsApp.ExtendedField.

// The code below returns an array of contacts where the contact's custom field
// named "Favorite Sport" contains "tennis".
const contacts = ContactsApp.getContactsByCustomField(
    'tennis',
    'Favorite Sport',
);

Параметры

Имя	Тип	Описание
`query`	`Object`	строка для поиска в настраиваемом поле контакта
`label`	`Extended Field`	настраиваемое поле для поиска

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

Contact[] — массив совпадающих контактов

Авторизация

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

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

См. также

get Contact(emailAddress)

`get Contacts By Date(month, day, label)`

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

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

// The code below returns an array of contacts where the contact's "Birthday"
// field contains April for the month and 19 for the day.
const contacts = ContactsApp.getContactsByDate(
    ContactsApp.Month.APRIL,
    19,
    ContactsApp.Field.BIRTHDAY,
);

Параметры

Имя	Тип	Описание
`month`	`Month`	соответствующий месяц, как одно из значений ContactsApp.Month
`day`	`Integer`	день, чтобы соответствовать
`label`	`Field`	поле для поиска из ContactsApp.Field

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

Contact[] — массив совпадающих контактов

Авторизация

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

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

См. также

get Contact(emailAddress)

`get Contacts By Date(month, day, year, label)`

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

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

// The code below returns an array of contacts where the contact's "Birthday"
// field contains April for the month, 19 for the day, and 1950 for the year.
const contacts = ContactsApp.getContactsByDate(
    ContactsApp.Month.APRIL,
    19,
    1950,
    ContactsApp.Field.BIRTHDAY,
);

Параметры

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

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

Contact[] — массив совпадающих контактов

Авторизация

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

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

См. также

get Contact(emailAddress)

`get Contacts By Date(month, day, year, label)`

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

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

// The code below returns an array of contacts where the contact's custom "Start
// Date" field contains April for the month, 19 for the day, and 2011 for the
// year.
const contacts = ContactsApp.getContactsByDate(
    ContactsApp.Month.APRIL,
    19,
    2011,
    'Start Date',
);

Параметры

Имя	Тип	Описание
`month`	`Month`	соответствующий месяц, как одно из значений ContactsApp.Month
`day`	`Integer`	день, чтобы соответствовать
`year`	`Integer`	соответствующий год может быть нулевым
`label`	`String`	настраиваемое поле для поиска

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

Contact[] — массив совпадающих контактов

Авторизация

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

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

См. также

get Contact(emailAddress)

`get Contacts By Date(month, day, label)`

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

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

// The code below returns an array of contacts where the contact's custom "Start
// Date" field contains April for the month and 19 for the day.
const contacts = ContactsApp.getContactsByDate(
    ContactsApp.Month.APRIL,
    19,
    'Start Date',
);

Параметры

Имя	Тип	Описание
`month`	`Month`	соответствующий месяц, как одно из значений ContactsApp.Month
`day`	`Integer`	день, чтобы соответствовать
`label`	`String`	настраиваемое поле для поиска

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

Contact[] — массив совпадающих контактов

Авторизация

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

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

См. также

get Contact(emailAddress)

`get Contacts By Email Address(query)`

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

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

// The code below returns an array of contacts where the contact's email address
// contains "john.doe@example.com'.
const contacts = ContactsApp.getContactsByEmailAddress('john.doe@example.com');

Параметры

Имя	Тип	Описание
`query`	`String`	строка для поиска в контактных адресах электронной почты

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

Contact[] — массив совпадающих контактов

Авторизация

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

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

См. также

get Contact(emailAddress)

`get Contacts By Email Address(query, label)`

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

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

// The code below returns an array of contacts where the contact's email address
// contains "john.doe@example.com" in the Home email field.
const contacts = ContactsApp.getContactsByEmailAddress(
    'john.doe@example.com',
    ContactsApp.Field.HOME_EMAIL,
);

Параметры

Имя	Тип	Описание
`query`	`String`	строка для поиска в контактных адресах электронной почты
`label`	`Field`	поле для поиска внутри

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

Contact[] — массив совпадающих контактов

Авторизация

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

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

См. также

get Contact(emailAddress)

`get Contacts By Email Address(query, label)`

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

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

// The code below returns an array of contacts where the contact's email address
// contains "john.doe@example.com" in a custom email address label (created by
// the user) called "alternate".
const contacts = ContactsApp.getContactsByEmailAddress(
    'john.doe@example.com',
    'alternate',
);

Параметры

Имя	Тип	Описание
`query`	`String`	строка для поиска в контактных адресах электронной почты с указанной настраиваемой меткой адреса электронной почты
`label`	`String`	метка пользовательского адреса электронной почты для поиска

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

Contact[] — массив совпадающих контактов

Авторизация

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

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

См. также

get Contact(emailAddress)

`get Contacts By Group(group)`

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

Получите контакты в данной ContactGroup.

// The code below returns an array of contacts in the ContactGroup with the name
// "Work Friends".
const group = ContactsApp.getContactGroup('Work Friends');
const contacts = ContactsApp.getContactsByGroup(group);

Параметры

Имя	Тип	Описание
`group`	`Contact Group`	группа контактов

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

Contact[] — массив контактов в данной группе

Авторизация

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

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

См. также

get Contact(emailAddress)

`get Contacts By IM(query)`

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

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

// The code below returns an array of contacts where the contact's instant
// messaging address contains "ChatWithJohnDoe" in any instant messaging field.
const contacts = ContactsApp.getContactsByIM('ChatWithJohnDoe');

Параметры

Имя	Тип	Описание
`query`	`String`	строка для поиска в адресах обмена мгновенными сообщениями контакта

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

Contact[] — массив совпадающих контактов

Авторизация

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

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

См. также

get Contact(emailAddress)

`get Contacts By IM(query, label)`

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

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

// The code below returns an array of contacts where the contact's instant
// messaging address contains "ChatWithJohnDoe" in the AIM instant messaging
// field.
const contacts = ContactsApp.getContactsByIM(
    'ChatWithJohnDoe',
    ContactsApp.Field.AIM,
);

Параметры

Имя	Тип	Описание
`query`	`String`	строка для поиска в адресах обмена мгновенными сообщениями контакта
`label`	`Field`	поле для поиска внутри

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

Contact[] — массив совпадающих контактов

Авторизация

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

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

См. также

get Contact(emailAddress)

`get Contacts By IM(query, label)`

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

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

// The code below returns an array of contacts where the contact's instant
// messaging address contains "ChatWithJohnDoe" in a custom instant messaging
// label (created by the user) called "eBuddy".
const contacts = ContactsApp.getContactsByIM('ChatWithJohnDoe', 'eBuddy');

Параметры

Имя	Тип	Описание
`query`	`String`	строка для поиска в адресах обмена мгновенными сообщениями контакта с указанной пользовательской меткой обмена мгновенными сообщениями
`label`	`String`	персонализированная метка обмена мгновенными сообщениями для поиска

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

Contact[] — массив совпадающих контактов

Авторизация

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

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

См. также

get Contact(emailAddress)

`get Contacts By Job Title(query)`

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

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

// The code below returns an array of contacts where the contact's job title
// field contains "Product Manager".
const contacts = ContactsApp.getContactsByJobTitle('Product Manager');

Параметры

Имя	Тип	Описание
`query`	`String`	строка для поиска в поле названия должности контакта

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

Contact[] — массив совпадающих контактов

Авторизация

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

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

См. также

get Contact(emailAddress)

`get Contacts By Name(query)`

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

Получите контакты, соответствующие имени.

// The code below returns an array of contacts where the contact name contains
// "John"
const contacts = ContactsApp.getContactsByName('John');

Параметры

Имя	Тип	Описание
`query`	`String`	строка для поиска в именах контактов

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

Contact[] — массив совпадающих контактов

Авторизация

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

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

См. также

get Contact(emailAddress)

`get Contacts By Name(query, label)`

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

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

// The code below returns an array of contacts where the contact name contains
// "John" in the Given Name field.
const contacts = ContactsApp.getContactsByName(
    'John',
    ContactsApp.Field.GIVEN_NAME,
);

Параметры

Имя	Тип	Описание
`query`	`String`	строка для поиска в именах контактов
`label`	`Field`	поле для поиска внутри

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

Contact[] — массив совпадающих контактов

Авторизация

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

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

См. также

get Contact(emailAddress)

`get Contacts By Notes(query)`

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

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

// The code below returns an array of contacts where the contact's notes field
// contains "sent birthday card".
const contacts = ContactsApp.getContactsByNotes('sent birthday card');

Параметры

Имя	Тип	Описание
`query`	`String`	строка для поиска в поле заметок контакта

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

Contact[] — массив совпадающих контактов

Авторизация

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

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

См. также

get Contact(emailAddress)

`get Contacts By Phone(query)`

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

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

Этот метод расширит буквенные телефонные номера, поэтому, если вы ищете «212-555-КОД», а в ваших контактах есть «212-555-2633» или наоборот, метод найдет соответствующий контакт.

// The code below returns an array of contacts where the contact's phone number
// contains "212-555-1234' in any phone number field.
const contacts = ContactsApp.getContactsByPhone('212-555-1234');

Параметры

Имя	Тип	Описание
`query`	`String`	строка для поиска в телефонных номерах контакта

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

Contact[] — массив совпадающих контактов

Авторизация

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

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

См. также

get Contact(emailAddress)

`get Contacts By Phone(query, label)`

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

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

// The code below returns an array of contacts where the contact's phone number
// contains "212-555-1234" in the Home phone number field.
const contacts = ContactsApp.getContactsByPhone(
    '212-555-1234',
    ContactsApp.Field.HOME_PHONE,
);

Параметры

Имя	Тип	Описание
`query`	`String`	строка для поиска в телефонных номерах контакта
`label`	`Field`	поле для поиска внутри

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

Contact[] — массив совпадающих контактов

Авторизация

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

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

См. также

get Contact(emailAddress)

`get Contacts By Phone(query, label)`

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

Получайте контакты, соответствующие номеру телефона, ограниченные указанной настраиваемой меткой номера телефона.

// The code below returns an array of contacts where the contact's phone number
// contains "212-555-1234" in a custom phone number label (created by the user)
// called "alternate".
const contacts = ContactsApp.getContactsByPhone('212-555-1234', 'alternate');

Параметры

Имя	Тип	Описание
`query`	`String`	строка для поиска в телефонных номерах контакта с указанной настраиваемой меткой номера телефона
`label`	`String`	метка пользовательского номера телефона для поиска

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

Contact[] — массив совпадающих контактов

Авторизация

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

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

См. также

get Contact(emailAddress)

`get Contacts By Url(query)`

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

Получите контакты, соответствующие URL-адресу.

// The code below returns an array of contacts where the contact's URL contains
// "www.example.com' in any URL field.
const contacts = ContactsApp.getContactsByUrl('www.example.com');

Параметры

Имя	Тип	Описание
`query`	`String`	строка для поиска в URL-адресах контактов

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

Contact[] — массив совпадающих контактов

Авторизация

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

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

См. также

get Contact(emailAddress)

`get Contacts By Url(query, label)`

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

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

// The code below returns an array of contacts where the contact's URL contains
// "www.example.com" in the Work URL field.
const contacts = ContactsApp.getContactsByUrl(
    'www.example.com',
    ContactsApp.Field.WORK_WEBSITE,
);

Параметры

Имя	Тип	Описание
`query`	`String`	строка для поиска в URL-адресах контактов
`label`	`Field`	поле для поиска внутри

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

Contact[] — массив совпадающих контактов

Авторизация

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

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

См. также

get Contact(emailAddress)

`get Contacts By Url(query, label)`

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

Получите контакты, соответствующие URL-адресу, ограниченному указанной настраиваемой меткой URL-адреса.

// The code below returns an array of contacts where the contact's URL contains
// "www.example.com" in a custom URL label (created by the user) called
// "alternate work".
const contacts = ContactsApp.getContactsByUrl(
    'www.example.com',
    'alternate work',
);

Параметры

Имя	Тип	Описание
`query`	`String`	строка для поиска в URL-адресах контактов с указанной настраиваемой меткой URL-адреса
`label`	`String`	пользовательская метка URL-адреса для поиска

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

Contact[] — массив совпадающих контактов

Авторизация

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

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

См. также

get Contact(emailAddress)

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

Устаревшие свойства

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

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

create Contact(givenName, familyName, email)

Параметры

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

Авторизация

См. также

create Contact Group(name)

Параметры

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

Авторизация

См. также

delete Contact(contact)

Параметры

Авторизация

См. также

delete Contact Group(group)

Параметры

Авторизация

См. также

find By Email Address(email)

Параметры

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

Авторизация

find Contact Group(name)

Параметры

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

Авторизация

get All Contacts()

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

Авторизация

get Contact(emailAddress)

Параметры

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

Авторизация

См. также

get Contact By Id(id)

Параметры

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

Авторизация

См. также

get Contact Group(name)

Параметры

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

Авторизация

См. также

get Contact Group By Id(id)

Параметры

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

См. также

get Contact Groups()

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

Авторизация

См. также

get Contacts()

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

Авторизация

См. также

get Contacts By Address(query)

Параметры

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

Авторизация

См. также

get Contacts By Address(query, label)

Параметры

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

Авторизация

См. также

get Contacts By Address(query, label)

Параметры

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

Авторизация

См. также

get Contacts By Company(query)

Параметры

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

Авторизация

См. также

Class ContactsApp

`create Contact(givenName, familyName, email)`

`create Contact Group(name)`

`delete Contact(contact)`

`delete Contact Group(group)`

`find By Email Address(email)`

`find Contact Group(name)`

`get All Contacts()`

`get Contact(emailAddress)`

`get Contact By Id(id)`

`get Contact Group(name)`

`get Contact Group By Id(id)`

`get Contact Groups()`

`get Contacts()`

`get Contacts By Address(query)`

`get Contacts By Address(query, label)`

`get Contacts By Address(query, label)`

`get Contacts By Company(query)`

`get Contacts By Custom Field(query, label)`

`get Contacts By Date(month, day, label)`

`get Contacts By Date(month, day, year, label)`

`get Contacts By Date(month, day, year, label)`

`get Contacts By Date(month, day, label)`

`get Contacts By Email Address(query)`

`get Contacts By Email Address(query, label)`

`get Contacts By Email Address(query, label)`

`get Contacts By Group(group)`

`get Contacts By IM(query)`

`get Contacts By IM(query, label)`

`get Contacts By IM(query, label)`

`get Contacts By Job Title(query)`

`get Contacts By Name(query)`