Class CustomField

Пользовательское поле

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

Пользовательское поле в Контакте.

Методы

Метод	Тип возврата	Краткое описание
getLabel()	Object	Получает метку для этого поля.
setLabel(label)	CustomField	Устанавливает метку этого поля.

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

Метод	Тип возврата	Краткое описание
deleteCustomField()	void	Удаляет это поле.
getValue()	Object	Получает значение поля.
setLabel(field)	CustomField	Устанавливает метку этого поля.
setValue(value)	CustomField	Устанавливает значение этого поля.

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

getLabel()

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

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

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

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

Авторизация

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

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

---

setLabel(label)

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

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

Параметры

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

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

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

Авторизация

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

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

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

deleteCustomField()

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

Удаляет это поле.

var contacts = ContactsApp.getContactsByName('John Doe');
var fields = contacts[0].getCustomFields();
for (var i = 0; i < fields.length; i++) {
  if (fields[i].getLabel() == 'foo') {
    fields[i].deleteCustomField();
  }
}

Авторизация

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

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

---

getValue()

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

Получает значение поля.

// Logs the value of all the custom fields for contact 'John Doe'
var contacts = ContactsApp.getContactsByName('John Doe');
var fields = contacts[0].getCustomFields();
for (var i in fields) {
  Logger.log(fields[i].getValue());
}

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

Object — значение, хранящееся в поле

Авторизация

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

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

---

setLabel(field)

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

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

// Sets the first custom field associated with contact 'John Doe' to use 'Mail application' as
// a label, with 'Gmail' as the value.
var contacts = ContactsApp.getContactsByName('John Doe');
var field = contacts[0].getCustomFields()[0];
field.setLabel('Mail application');
field.setValue('Gmail');

Параметры

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

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

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

Авторизация

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

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

---

setValue(value)

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

Устанавливает значение этого поля.

// Sets the first custom field associated with contact 'John Doe' to use 'Mail application' as
// a label, with 'Gmail' as the value.
var contacts = ContactsApp.getContactsByName('John Doe');
var field = contacts[0].getCustomFields()[0];
field.setLabel('Mail application');
field.setValue('Gmail');

Параметры

Имя	Тип	Описание
value	Object	новое значение

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

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

Авторизация

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

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