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