Class CustomField

CustomField

已弃用。请改用 People API 高级 服务

联系人中的自定义字段。

方法

方法	返回类型	简介
getLabel()	Object	获取此字段的标签。
setLabel(label)	CustomField	设置此字段的标签。

已弃用的方法

方法	返回类型	简介
deleteCustomField()	void	删除此字段。
getValue()	Object	获取字段的值。
setLabel(field)	CustomField	设置此字段的标签。
setValue(value)	CustomField	设置此字段的值。

详细文档

getLabel()

获取此字段的标签。此字段可以是 Field、ExtendedField 或 String。

// 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