Class EmailField

EmailField

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

联系人中的电子邮件字段。

方法

方法返回类型简介
getAddress()String获取此字段的地址。
getLabel()Object获取此字段的标签。
isPrimary()Boolean了解这是否为主要字段值。
setAddress(address)EmailField设置此字段的地址。
setAsPrimary()EmailField将此字段设为主要字段。
setLabel(field)EmailField设置此字段的标签。
setLabel(label)EmailField设置此字段的标签。

详细文档

getAddress()

获取此字段的地址。

// Logs the address for the 'Home Address' field for contact 'John Doe'.
// Can be used similarly for other fields that contain addresses.
var contacts = ContactsApp.getContactsByName('John Doe');
var homeAddress = contacts[0].getAddresses(ContactsApp.Field.HOME_ADDRESS);
Logger.log(homeAddress[0].getAddress());

弃踢回攻

String - 字符串形式的地址

授权

使用此方法的脚本需要获得以下一个或多个范围的授权:

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

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

isPrimary()

了解这是否为主要字段值。

// Logs whether or not the first address field associated with contact
// 'John Doe' is labeled as primary. This method can be similarly called
// for any field.
var contacts = ContactsApp.getContactsByName('John Doe');
var addressFields = contacts[0].getAddresses();
Logger.log(addressFields[0].isPrimary());

弃踢回攻

Boolean - 这是否是主要实例

授权

使用此方法的脚本需要获得以下一个或多个范围的授权:

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

setAddress(address)

设置此字段的地址。

// Sets the address for the 'Home Address' field for contact 'John Doe'.
// Can be used similarly for other fields that contain addresses.
var contacts = ContactsApp.getContactsByName('John Doe');
var homeAddress = contacts[0].getAddresses(ContactsApp.Field.HOME_ADDRESS);
homeAddress[0].setAddress('123 Main St, Raleigh, NC, 27601');

参数

名称类型说明
addressString新地址

弃踢回攻

EmailField - 此字段,可用于链接

授权

使用此方法的脚本需要获得以下一个或多个范围的授权:

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

setAsPrimary()

将此字段设为主要字段。

// Sets the the first address field associated with contact 'John Doe'
// as primary. This method can be similarly called for any field.
var contacts = ContactsApp.getContactsByName('John Doe');
var addressFields = contacts[0].getAddresses();
addressFields[0].setAsPrimary();

弃踢回攻

EmailField - 用于链接的此 FieldValue

授权

使用此方法的脚本需要获得以下一个或多个范围的授权:

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

setLabel(field)

设置此字段的标签。

// Sets the label to 'Work' 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(ContactsApp.Field.WORK_ADDRESS);

参数

名称类型说明
fieldField新的标准标签

弃踢回攻

EmailField - 用于链接的此 FieldValue

授权

使用此方法的脚本需要获得以下一个或多个范围的授权:

  • 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');

参数

名称类型说明
labelString此字段的新标签

弃踢回攻

EmailField - 此字段,可用于链接

授权

使用此方法的脚本需要获得以下一个或多个范围的授权:

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

已废弃的方法