Class Contact

聯絡

已淘汰。請改用 People API 進階服務

聯絡人包含聯絡人的姓名、地址和各種聯絡詳細資料。

已淘汰的方法

方法	傳回類型	簡短說明
addAddress(label, address)	AddressField	使用標準或自訂標籤，為聯絡人新增地址。
addCompany(company, title)	CompanyField	將公司新增至聯絡人。
addCustomField(label, content)	CustomField	使用擴充或自訂標籤，為聯絡人新增自訂欄位。
addDate(label, month, day, year)	DateField	使用標準或自訂標籤，為聯絡人新增日期。
addEmail(label, address)	EmailField	新增電子郵件地址，並加上標準標籤 (住家、公司等) 或自訂標籤 {@code // The code below retrieves a contact named "John Doe" and adds the email // address "[e-mail]" to the ContactsApp.Field.HOME_EMAIL label.
addIM(label, address)	IMField	使用標準或自訂標籤，為聯絡人新增即時通訊地址。
addPhone(label, number)	PhoneField	使用標準或自訂標籤，為聯絡人新增電話號碼。
addToGroup(group)	Contact	將這個聯絡人新增至指定的聯絡人群組。
addUrl(label, url)	UrlField	使用標準或自訂標籤，在聯絡人中新增網址。
deleteContact()	void	刪除這個聯絡人。
getAddresses()	AddressField[]	取得這個聯絡人的所有地址。
getAddresses(label)	AddressField[]	取得與特定欄位相符的聯絡人所有地址。
getCompanies()	CompanyField[]	取得此聯絡人的所有公司。
getContactGroups()	ContactGroup[]	取得含有此聯絡人的所有聯絡人群組。
getCustomFields()	CustomField[]	取得這個聯絡人的所有自訂欄位。
getCustomFields(label)	CustomField[]	取得與特定欄位相符的聯絡人所有自訂欄位。
getDates()	DateField[]	取得此聯絡人的所有日期。
getDates(label)	DateField[]	取得與特定欄位相符的聯絡人所有日期。
getEmailAddresses()	String[]	取得此聯絡人可用的電子郵件地址清單。
getEmails()	EmailField[]	取得這個聯絡人的電子郵件地址。
getEmails(label)	EmailField[]	取得與特定欄位相符的聯絡人電子郵件地址。
getFamilyName()	String	以字串形式取得聯絡人的姓氏。
getFullName()	String	以字串形式取得聯絡人的全名 (名字和姓氏)。
getGivenName()	String	以字串格式取得聯絡人的名字 (名字)。
getHomeAddress()	String	取得這個聯絡人的住家地址，如果不存在則傳回空字串。
getHomeFax()	String	取得這個聯絡人的住家傳真號碼，如果不存在，則傳回空字串。
getHomePhone()	String	取得這個聯絡人的住家電話號碼，如果不存在，則傳回空字串。
getIMs()	IMField[]	取得這個聯絡人的所有即時通訊地址。
getIMs(label)	IMField[]	取得與特定欄位相符的聯絡人所有即時通訊地址。
getId()	String	傳回此聯絡人的專屬 ID。
getInitials()	String	取得聯絡人的名字縮寫。
getLastUpdated()	Date	取得此聯絡人上次更新的日期。
getMaidenName()	String	以字串形式取得聯絡人的娘家姓氏。
getMiddleName()	String	以字串形式取得聯絡人的中間名。
getMobilePhone()	String	取得這個聯絡人的手機號碼，如果不存在則傳回空字串。
getNickname()	String	以字串形式取得聯絡人的暱稱。
getNotes()	String	取得與此聯絡人相關聯的備註，如果沒有備註，則會傳回空字串。
getPager()	String	取得這個聯絡人的尋呼機電話號碼，如果不存在則傳回空字串。
getPhones()	PhoneField[]	取得這個聯絡人的所有電話號碼。
getPhones(label)	PhoneField[]	取得與特定欄位相符的聯絡人電話號碼。
getPrefix()	String	取得聯絡人名稱的前置字串。
getPrimaryEmail()	String	以字串形式取得聯絡人的主要電子郵件地址。
getShortName()	String	以字串形式取得聯絡人的簡稱。
getSuffix()	String	取得聯絡人姓名的後置詞。
getUrls()	UrlField[]	取得這個聯絡人的所有網址。
getUrls(label)	UrlField[]	取得與特定欄位相符的聯絡人所有網址。
getUserDefinedField(key)	String	取得與指定索引鍵相關聯的使用者定義值。
getUserDefinedFields()	Object	取得此聯絡人的所有使用者定義欄位，並將這些欄位做為 JavaScript 物件的屬性傳回。
getWorkAddress()	String	取得這個聯絡人的辦公室地址，如果不存在，則傳回空字串。
getWorkFax()	String	取得這個聯絡人的辦公室傳真號碼，如果不存在，則傳回空字串。
getWorkPhone()	String	取得這個聯絡人的辦公室電話號碼，如果不存在，則傳回空字串。
removeFromGroup(group)	Contact	將這個聯絡人從指定的聯絡人群組中移除。
setFamilyName(familyName)	Contact	設定聯絡人的姓氏。
setFullName(fullName)	Contact	設定聯絡人的全名 (名字和姓氏)。
setGivenName(givenName)	Contact	設定聯絡人的名字 (名字)。
setHomeAddress(addr)	void	設定這個聯絡人的住家地址。
setHomeFax(phone)	void	設定聯絡人的住家傳真號碼。
setHomePhone(phone)	void	設定聯絡人的住家電話號碼。
setInitials(initials)	Contact	設定聯絡人的名字縮寫。
setMaidenName(maidenName)	Contact	設定聯絡人的原姓。
setMiddleName(middleName)	Contact	設定聯絡人的中間名。
setMobilePhone(phone)	void	設定聯絡人的行動電話號碼。
setNickname(nickname)	Contact	設定聯絡人的暱稱。
setNotes(notes)	Contact	設定與此聯絡人相關聯的備註。
setPager(phone)	void	設定這個聯絡人的尋呼機號碼。
setPrefix(prefix)	Contact	將前置字串設為聯絡人的名稱。
setPrimaryEmail(primaryEmail)	void	設定這個聯絡人的主要電子郵件地址。
setShortName(shortName)	Contact	設定聯絡人的簡稱。
setSuffix(suffix)	Contact	將聯絡人的姓名後綴設定為後綴。
setUserDefinedField(key, value)	void	為此聯絡人設定單一使用者定義欄位，以便透過指定鍵儲存。
setUserDefinedFields(o)	void	使用指定物件的屬性，為此聯絡人設定使用者定義的欄位。
setWorkAddress(addr)	void	設定聯絡人的公司地址。
setWorkFax(phone)	void	設定聯絡人的公司傳真號碼。
setWorkPhone(phone)	void	設定聯絡人的公司電話號碼。

已淘汰的方法

addAddress(label, address)

已淘汰。這個函式已淘汰，不建議在新指令碼中使用。

使用標準或自訂標籤，為聯絡人新增地址。

標籤可以是 ContactsApp.Field 或自訂標籤字串。

// The code below retrieves a contact named "John Doe" and adds the address
// "123 Main St, Some City, NY 10011" with the ContactsApp.Field.WORK_ADDRESS
// label.
const contacts = ContactsApp.getContactsByName('John Doe');
const address = contacts[0].addAddress(
    ContactsApp.Field.WORK_ADDRESS,
    '123 Main St, Some City, NY 10011',
);

參數

名稱	類型	說明
label	Object	新地址的標籤，可從 ContactsApp.Field 或自訂字串取得
address	String	新地址

回攻員

AddressField：新建立的欄位

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

另請參閱

• getAddresses()

---

addCompany(company, title)

已淘汰。這個函式已淘汰，不建議在新指令碼中使用。

將公司新增至聯絡人。

// The code below retrieves a contact named "John Doe" and adds the company
// "Google" and the job title "Product Manager".
const contacts = ContactsApp.getContactsByName('John Doe');
const url = contacts[0].addCompany('Google', 'Product Manager');

參數

名稱	類型	說明
company	String	要新增至此聯絡人的公司名稱
title	String	與這家公司聯絡人相關的職稱

回攻員

CompanyField：新建立的欄位

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

另請參閱

• getCompanies()

---

addCustomField(label, content)

已淘汰。這個函式已淘汰，不建議在新指令碼中使用。

使用擴充或自訂標籤，為聯絡人新增自訂欄位。

標籤可以是 ContactsApp.ExtendedField 或自訂標籤字串。

// The code below retrieves a contact named "John Doe" and adds the custom field
// ContactsApp.ExtendedField.HOBBY with the value "hiking".
// Note that ContactsApp.ExtendedField.HOBBY is not the same as a custom field
// named 'HOBBY'.
const contacts = ContactsApp.getContactsByName('John Doe');
contacts[0].addCustomField(ContactsApp.ExtendedField.HOBBY, 'hiking');

參數

名稱	類型	說明
label	Object	新地址的標籤，可從 ContactsApp.ExtendedField 或自訂字串取得
content	Object	要儲存在自訂欄位中的值

回攻員

CustomField：新建立的欄位

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

另請參閱

• getCustomFields()

---

addDate(label, month, day, year)

已淘汰。這個函式已淘汰，不建議在新指令碼中使用。

使用標準或自訂標籤，為聯絡人新增日期。

標籤可以是 ContactsApp.Field 或自訂標籤字串。

// The code below retrieves a contact named "John Doe" and adds a
// ContactsApp.ExtendedField.BIRTHDAY with the value "April 19, 1950".
const contacts = ContactsApp.getContactsByName('John Doe');
const birthday = contacts[0].addDate(
    ContactsApp.Field.BIRTHDAY,
    ContactsApp.Month.APRIL,
    19,
    1950,
);

參數

名稱	類型	說明
label	Object	新日期的標籤，可從 ContactsApp.Field 或自訂字串取得
month	Month	月，來自 ContactApps.Month
day	Integer	這一天
year	Integer	年

回攻員

DateField - 新建日期

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

另請參閱

• getDates()

---

addEmail(label, address)

已淘汰。這個函式已淘汰，不建議在新指令碼中使用。

新增電子郵件地址，並加上標準標籤 (住家、公司等) 或自訂標籤

// The code below retrieves a contact named "John Doe" and adds the email
// address "[e-mail]" to the ContactsApp.Field.HOME_EMAIL label.
const contacts = ContactsApp.getContactsByName('John Doe');
const emailField = contacts[0].addEmail(
    ContactsApp.Field.HOME_EMAIL,
    '[e-mail]',
);

參數

名稱	類型	說明
label	Object	新電子郵件的標籤，可使用 ContactsApp.Field 或自訂字串
address	String	新的電子郵件地址

回攻員

EmailField：新加入的欄位

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

---

addIM(label, address)

已淘汰。這個函式已淘汰，不建議在新指令碼中使用。

使用標準或自訂標籤，為聯絡人新增即時通訊地址。

標籤可以是 ContactsApp.Field 或自訂標籤字串。

// The code below retrieves a contact named "John Doe" and adds the IM address
// "ChatWithJohn" with the ContactsApp.Field.AIM label.
const contacts = ContactsApp.getContactsByName('John Doe');
const email = contacts[0].addIM(ContactsApp.Field.AIM, 'ChatWithJohn');

參數

名稱	類型	說明
label	Object	新即時通訊地址的標籤，可使用 ContactsApp.Field 或自訂字串
address	String	新的即時通訊地址

回攻員

IMField：新建立的欄位

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

另請參閱

• getIMs()

---

addPhone(label, number)

已淘汰。這個函式已淘汰，不建議在新指令碼中使用。

使用標準或自訂標籤，為聯絡人新增電話號碼。

標籤可以是 ContactsApp.Field 或自訂標籤字串。

// The code below retrieves a contact named "John Doe" and adds the phone number
// "212-555-1234" with the ContactsApp.Field.WORK_PHONE label.
const contacts = ContactsApp.getContactsByName('John Doe');
const phone = contacts[0].addPhone(
    ContactsApp.Field.WORK_PHONE,
    '212-555-1234',
);

參數

名稱	類型	說明
label	Object	新電話號碼的標籤，可從 ContactsApp.Field 或自訂字串取得
number	String	新電話號碼

回攻員

PhoneField：新建立的欄位

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

另請參閱

• getPhones()

---

addToGroup(group)

已淘汰。這個函式已淘汰，不建議在新指令碼中使用。

將這個聯絡人新增至指定的聯絡人群組。

// The code below creates a new contact and then adds it to the contact group
// named "Work Friends"
let contact = ContactsApp.createContact('John', 'Doe', '[e-mail]');
const group = ContactsApp.getContactGroup('Work Friends');
contact = contact.addToGroup(group);

參數

名稱	類型	說明
group	ContactGroup	要將聯絡人新增至哪個聯絡人群組

回攻員

Contact：這個聯絡人

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

另請參閱

• removeFromGroup(group)

---

addUrl(label, url)

已淘汰。這個函式已淘汰，不建議在新指令碼中使用。

使用標準或自訂標籤，在聯絡人中新增網址。

標籤可以是 ContactsApp.Field 或自訂標籤字串。

// The code below retrieves a contact named "John Doe" and adds the URL
// "http://www.example.com" with the ContactsApp.Field.WORK_WEBSITE label.
const contacts = ContactsApp.getContactsByName('John Doe');
const url = contacts[0].addUrl(
    ContactsApp.Field.WORK_WEBSITE,
    'http://www.example.com',
);

參數

名稱	類型	說明
label	Object	新地址的標籤，可從 ContactsApp.Field 或自訂字串取得
url	String	新的網址

回攻員

UrlField：新建立的欄位

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

另請參閱

• getUrls()

---

deleteContact()

已淘汰。這個函式已淘汰，不建議在新指令碼中使用。

刪除這個聯絡人。

const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  contacts[i].deleteContact();
}

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

---

getAddresses()

已淘汰。這個函式已淘汰，不建議在新指令碼中使用。

取得這個聯絡人的所有地址。

// The code below logs the addresses of all the contacts whose names contain
// "John Doe"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  Logger.log(contacts[i].getAddresses());
}

回攻員

AddressField[]：地址清單

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

另請參閱

• addAddress(label, address)

---

getAddresses(label)

已淘汰。這個函式已淘汰，不建議在新指令碼中使用。

取得與特定欄位相符的聯絡人所有地址。

標籤可以是 ContactsApp.Field 或自訂標籤字串。

// The code below retrieves a contact named "John Doe" and logs the addresses
// associated with that contact that are in the ContactsApp.Field.WORK_ADDRESS
// label.
const contacts = ContactsApp.getContactsByName('John Doe');
const addresses = contacts[0].getAddresses(ContactsApp.Field.WORK_ADDRESS);
for (const i in addresses) {
  Logger.log(addresses[i].getAddress());
}

參數

名稱	類型	說明
label	Object	要比對的標籤，可從 ContactsApp.Field 或自訂字串取得

回攻員

AddressField[]：地址清單

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

另請參閱

• addAddress(label, address)

---

getCompanies()

已淘汰。這個函式已淘汰，不建議在新指令碼中使用。

取得此聯絡人的所有公司。

// The code below logs the company names of all the contacts whose names contain
// "John Doe"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  const companies = contacts[i].getCompanies();
  for (const j in companies) {
    Logger.log(companies[j].getCompanyName());
  }
}

回攻員

CompanyField[]：公司清單

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

另請參閱

• addCompany(company, title)

---

getContactGroups()

已淘汰。這個函式已淘汰，不建議在新指令碼中使用。

取得包含此聯絡人的所有聯絡人群組。

// The code below gets a contact named "John Doe" and retrieves all the contact
// groups that the contact belongs to
const contacts = ContactsApp.getContactsByName('John Doe');
const groups = contacts[0].getContactGroups();

回攻員

ContactGroup[]：包含這個聯絡人的群組

另請參閱

• addToGroup(group)

---

getCustomFields()

已淘汰。這個函式已淘汰，不建議在新指令碼中使用。

取得這個聯絡人的所有自訂欄位。

// The code below retrieves a contact named "John Doe" and logs the custom
// fields associated with that contact
const contacts = ContactsApp.getContactsByName('John Doe');
const fields = contacts[0].getCustomFields();
for (const i in fields) {
  Logger.log(fields[i].getValue());
}

回攻員

CustomField[]：自訂欄位清單

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

另請參閱

• addCustomField(label, content)

---

getCustomFields(label)

已淘汰。這個函式已淘汰，不建議在新指令碼中使用。

取得與特定欄位相符的聯絡人所有自訂欄位。

標籤可以是 ContactsApp.ExtendedField 中的標準標籤，或是自訂標籤字串。

// The code below retrieves a contact named "John Doe" and logs the custom
// fields associated with that contact that are in the
// ContactsApp.ExtendedField.HOBBY label.
const contacts = ContactsApp.getContactsByName('John Doe');
const hobbies = contacts[0].getCustomFields(ContactsApp.ExtendedField.HOBBY);
for (const i in hobbies) {
  Logger.log(hobbies[i].getValue());
}

參數

名稱	類型	說明
label	Object	要比對的標籤，可從 ContactsApp.ExtendedField 或自訂字串取得

回攻員

CustomField[]：自訂欄位清單

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

另請參閱

• addCustomField(label, content)

---

getDates()

已淘汰。這個函式已淘汰，不建議在新指令碼中使用。

取得此聯絡人的所有日期。

// The code below retrieves a contact named "John Doe" and logs the label of the
// date associated with that contact
const contacts = ContactsApp.getContactsByName('John Doe');
const dates = contacts[0].getDates();
for (const i in dates) {
  Logger.log(dates[i].getLabel());
}

回攻員

DateField[]：日期清單

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

另請參閱

• addDate(label, month, day, year)

---

getDates(label)

已淘汰。這個函式已淘汰，不建議在新指令碼中使用。

取得與特定欄位相符的聯絡人所有日期。

標籤可以是 ContactsApp.Field 的標準標籤，也可以是自訂標籤字串。

// The code below retrieves a contact named "John Doe" and logs the day of the
// month associated with that contact that are in the ContactsApp.Field.BIRTHDAY
// label.
const contacts = ContactsApp.getContactsByName('John Doe');
const birthdays = contacts[0].getDates(ContactsApp.Field.BIRTHDAY);
for (const i in birthdays) {
  Logger.log(birthdays[i].getDay());
}

參數

名稱	類型	說明
label	Object	要比對的標籤，可從 ContactsApp.Field 或自訂字串取得

回攻員

DateField[]：日期清單

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

另請參閱

• addDate(label, month, day, year)

---

getEmailAddresses()

已淘汰。這個函式已淘汰，不建議在新指令碼中使用。

取得此聯絡人可用的電子郵件地址清單。

回攻員

String[]：這個聯絡人可用的電子郵件地址清單

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

---

getEmails()

已淘汰。這個函式已淘汰，不建議在新指令碼中使用。

取得這個聯絡人的電子郵件地址。

// The code below retrieves a contact named "John Doe" and logs the email
// addresses associated with that contact
const contacts = ContactsApp.getContactsByName('John Doe');
const emails = contacts[0].getEmails();
for (const i in emails) {
  Logger.log(emails[i].getAddress());
}

回攻員

EmailField[]：聯絡人的電子郵件地址清單

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

另請參閱

• addEmail(label, address)

---

getEmails(label)

已淘汰。這個函式已淘汰，不建議在新指令碼中使用。

取得與特定欄位相符的聯絡人電子郵件地址。

標籤可以是 ContactsApp.Field 的標準標籤，也可以是自訂標籤字串。

// The code below retrieves a contact named "John Doe" and logs the email
// addresses associated with that contact that are in the
// ContactsApp.Field.HOME_EMAIL label.
const contacts = ContactsApp.getContactsByName('John Doe');
const emails = contacts[0].getEmails(ContactsApp.Field.HOME_EMAIL);
for (const i in emails) {
  Logger.log(emails[i].getAddress());
}

參數

名稱	類型	說明
label	Object	要比對的標籤，可從 ContactsApp.Field 或自訂字串取得

回攻員

EmailField[]：聯絡人的電子郵件地址清單

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

另請參閱

• addEmail(label, address)

---

getFamilyName()

已淘汰。這個函式已淘汰，不建議在新指令碼中使用。

以字串形式取得聯絡人的姓氏。

// The code below logs the family name of all the contacts whose names contain
// "John"
const contacts = ContactsApp.getContactsByName('John');
for (const i in contacts) {
  Logger.log(contacts[i].getFamilyName());
}

回攻員

String：聯絡人的姓氏

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

另請參閱

• setFamilyName(familyName)

---

getFullName()

已淘汰。這個函式已淘汰，不建議在新指令碼中使用。

以字串形式取得聯絡人的全名 (名字和姓氏)。

// The code below logs the full name of all the contacts whose names contain
// "John"
const contacts = ContactsApp.getContactsByName('John');
for (const i in contacts) {
  Logger.log(contacts[i].getFullName());
}

回攻員

String：聯絡人的全名

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

另請參閱

• setFullName(fullName)

---

getGivenName()

已淘汰。這個函式已淘汰，不建議在新指令碼中使用。

以字串形式取得聯絡人的名字 (名字)。

// The code below logs the given name of all the contacts whose names contain
// "Smith"
const contacts = ContactsApp.getContactsByName('Smith');
for (const i in contacts) {
  Logger.log(contacts[i].getGivenName());
}

回攻員

String：聯絡人的名字

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

另請參閱

• setGivenName(givenName)

---

getHomeAddress()

已淘汰。這個函式已淘汰，不建議在新指令碼中使用。

取得這個聯絡人的住家地址，如果不存在則傳回空字串。

回攻員

String：這個聯絡人的住家地址，如果不存在則為空字串

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

---

getHomeFax()

已淘汰。這個函式已淘汰，不建議在新指令碼中使用。

取得這個聯絡人的住家傳真號碼，如果不存在，則傳回空字串。

回攻員

String：這個聯絡人的住家傳真號碼，如果不存在則為空字串

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

---

getHomePhone()

已淘汰。這個函式已淘汰，不建議在新指令碼中使用。

取得這個聯絡人的住家電話號碼，如果不存在，則傳回空字串。

回攻員

String：這個聯絡人的住家電話號碼，如果不存在則為空字串

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

---

getIMs()

已淘汰。這個函式已淘汰，不建議在新指令碼中使用。

取得這個聯絡人的所有即時通訊地址。

// The code below logs the IM addresses of all the contacts whose names contain
// "John Doe"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  Logger.log(contacts[i].getIMs());
}

回攻員

IMField[]：即時通訊地址清單

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

另請參閱

• addIM(label, address)

---

getIMs(label)

已淘汰。這個函式已淘汰，不建議在新指令碼中使用。

取得與特定欄位相符的聯絡人所有即時通訊地址。

標籤可以是 ContactsApp.Field 或自訂標籤字串。

// The code below retrieves a contact named "John Doe" and logs the IM addresses
// associated with that contact that are in the ContactsApp.Field.GOOGLE_TALK
// label.
const contacts = ContactsApp.getContactsByName('John Doe');
const imAddresses = contacts[0].getIMs(ContactsApp.Field.GOOGLE_TALK);
for (const i in imAddresses) {
  Logger.log(imAddresses[i].getAddress());
}

參數

名稱	類型	說明
label	Object	要比對的標籤，可從 ContactsApp.Field 或自訂字串取得

回攻員

IMField[]：即時通訊地址清單

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

另請參閱

• addIM(label, address)

---

getId()

已淘汰。這個函式已淘汰，不建議在新指令碼中使用。

傳回此聯絡人的專屬 ID。

const contact = ContactsApp.createContact(
    'John',
    'Doe',
    '[e-mail]',
);
const id = contact.getId();

回攻員

String：這個聯絡人的 ID

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

---

getInitials()

已淘汰。這個函式已淘汰，不建議在新指令碼中使用。

取得聯絡人的名字縮寫。

// The code below logs the initials of all the contacts whose names contain
// "John Doe"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  Logger.log(contacts[i].getInitials());
}

回攻員

String：聯絡人的名字縮寫

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

另請參閱

• setInitials(initials)

---

getLastUpdated()

已淘汰。這個函式已淘汰，不建議在新指令碼中使用。

取得此聯絡人上次更新的日期。

// The code below logs the last updated date of all the contacts whose names
// contain "John Doe"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  Logger.log(contacts[i].getLastUpdated());
}

回攻員

Date：上次更新聯絡人的日期

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

---

getMaidenName()

已淘汰。這個函式已淘汰，不建議在新指令碼中使用。

取得聯絡人的原姓氏，並以字串格式呈現。

// The code below logs the maiden name of all the contacts whose names contain
// "Jane"
const contacts = ContactsApp.getContactsByName('Jane');
for (const i in contacts) {
  Logger.log(contacts[i].getMaidenName());
}

回攻員

String：聯絡人的本姓

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

另請參閱

• setMaidenName(maidenName)

---

getMiddleName()

已淘汰。這個函式已淘汰，不建議在新指令碼中使用。

取得聯絡人的中間名，並以字串格式傳回。

// The code below logs the middle name of all the contacts whose names contain
// "Smith"
const contacts = ContactsApp.getContactsByName('Smith');
for (const i in contacts) {
  Logger.log(contacts[i].getMiddleName());
}

回攻員

String：聯絡人的中間名

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

另請參閱

• setMiddleName(middleName)

---

getMobilePhone()

已淘汰。這個函式已淘汰，不建議在新指令碼中使用。

取得這個聯絡人的手機號碼，如果不存在則傳回空字串。

回攻員

String：這個聯絡人的手機號碼，如果沒有則為空字串

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

---

getNickname()

已淘汰。這個函式已淘汰，不建議在新指令碼中使用。

以字串形式取得聯絡人的暱稱。

// The code below logs the nickname of all the contacts whose names contain
// "John Doe"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  Logger.log(contacts[i].getNickname());
}

回攻員

String：聯絡人的暱稱

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

另請參閱

• setNickname(nickname)

---

getNotes()

已淘汰。這個函式已淘汰，不建議在新指令碼中使用。

取得與此聯絡人相關聯的備註，如果沒有備註，則會取得空字串。

// The code below logs the notes of all the contacts whose names contain "John
// Doe"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  Logger.log(contacts[i].getNotes());
}

回攻員

String：與這個聯絡人相關聯的附註

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

另請參閱

• setNotes(notes)

---

getPager()

已淘汰。這個函式已淘汰，不建議在新指令碼中使用。

取得這個聯絡人的尋呼機電話號碼，如果不存在則傳回空字串。

回攻員

String：這個聯絡人的尋呼機電話號碼，如果不存在則為空字串

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

---

getPhones()

已淘汰。這個函式已淘汰，不建議在新指令碼中使用。

取得這個聯絡人的所有電話號碼。

// The code below logs the phone numbers of all the contacts whose names contain
// "John Doe"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  Logger.log(contacts[i].getPhones());
}

回攻員

PhoneField[]：電話號碼清單

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

另請參閱

• addPhone(label, number)

---

getPhones(label)

已淘汰。這個函式已淘汰，不建議在新指令碼中使用。

取得與特定欄位相符的聯絡人電話號碼。

標籤可以是 ContactsApp.Field 或自訂標籤字串。

// The code below retrieves a contact named "John Doe" and logs the phone
// numbers associated with that contact that are in the
// ContactsApp.Field.WORK_PHONE label.
const contacts = ContactsApp.getContactsByName('John Doe');
const phones = contacts[0].getPhones(ContactsApp.Field.WORK_PHONE);
for (const i in phones) {
  Logger.log(phones[i].getPhoneNumber());
}

參數

名稱	類型	說明
label	Object	要比對的標籤，可從 ContactsApp.Field 或自訂字串取得

回攻員

PhoneField[]：電話號碼清單

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

另請參閱

• addPhone(label, number)

---

getPrefix()

已淘汰。這個函式已淘汰，不建議在新指令碼中使用。

取得聯絡人名稱的前置字串。

// The code below logs the prefix of all the contacts whose names contain "John
// Doe"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  Logger.log(contacts[i].getPrefix());
}

回攻員

String：聯絡人名稱的前置字串

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

另請參閱

• setPrefix(prefix)

---

getPrimaryEmail()

已淘汰。這個函式已淘汰，不建議在新指令碼中使用。

取得聯絡人的主要電子郵件地址，並以字串格式呈現。

// The code below logs the primary email address of all the contacts whose names
// contain "John Doe"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  Logger.log(contacts[i].getPrimaryEmail());
}

回攻員

String：聯絡人的主要電子郵件地址

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

---

getShortName()

已淘汰。這個函式已淘汰，不建議在新指令碼中使用。

以字串形式取得聯絡人的簡稱。

// The code below logs the short name of all the contacts whose names contain
// "Johnathan"
const contacts = ContactsApp.getContactsByName('Johnathan');
for (const i in contacts) {
  Logger.log(contacts[i].getShortName());
}

回攻員

String：聯絡人的簡稱

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

另請參閱

• setShortName(shortName)

---

getSuffix()

已淘汰。這個函式已淘汰，不建議在新指令碼中使用。

取得聯絡人姓名後綴。

// The code below logs the suffix of all the contacts whose names contain "John
// Doe"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  Logger.log(contacts[i].getSuffix());
}

回攻員

String：聯絡人姓名後綴

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

另請參閱

• setSuffix(suffix)

---

getUrls()

已淘汰。這個函式已淘汰，不建議在新指令碼中使用。

取得這個聯絡人的所有網址。

// The code below logs the URLs of all the contacts whose names contain "John
// Doe"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  Logger.log(contacts[i].getUrls());
}

回攻員

UrlField[] - 網址清單

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

另請參閱

• addUrl(label, url)

---

getUrls(label)

已淘汰。這個函式已淘汰，不建議在新指令碼中使用。

取得與特定欄位相符的聯絡人所有網址。

標籤可以是 ContactsApp.Field 或自訂標籤字串。

// The code below retrieves a contact named "John Doe" and logs the URLs
// associated with that contact that are in the ContactsApp.Field.WORK_WEBSITE
// label.
const contacts = ContactsApp.getContactsByName('John Doe');
const urls = contacts[0].getUrls(ContactsApp.Field.WORK_WEBSITE);
for (const i in urls) {
  Logger.log(urls[i].getAddress());
}

參數

名稱	類型	說明
label	Object	要比對的標籤，可從 ContactsApp.Field 或自訂字串取得

回攻員

UrlField[] - 網址清單

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

另請參閱

• addUrl(label, url)

---

getUserDefinedField(key)

已淘汰。這個函式已淘汰，不建議在新指令碼中使用。

取得與指定索引鍵相關聯的使用者定義值。

參數

名稱	類型	說明
key	String	鍵可以是任何基本類型 (字串、int 等)

回攻員

String：使用者定義的內容，已使用此鍵儲存

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

---

getUserDefinedFields()

已淘汰。這個函式已淘汰，不建議在新指令碼中使用。

取得此聯絡人的所有使用者定義欄位，並將這些欄位做為 JavaScript 物件的屬性傳回。

回攻員

Object：使用者為此聯絡人定義的欄位，做為 JavaScript 物件的屬性

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

---

getWorkAddress()

已淘汰。這個函式已淘汰，不建議在新指令碼中使用。

取得這個聯絡人的辦公室地址，如果不存在，則傳回空字串。

回攻員

String：這個聯絡人的辦公室地址，如果不存在則為空字串

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

---

getWorkFax()

已淘汰。這個函式已淘汰，不建議在新指令碼中使用。

取得這個聯絡人的辦公室傳真號碼，如果不存在，則傳回空字串。

回攻員

String：這個聯絡人的辦公室傳真號碼，如果沒有則為空字串

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

---

getWorkPhone()

已淘汰。這個函式已淘汰，不建議在新指令碼中使用。

取得這個聯絡人的辦公室電話號碼，如果不存在，則傳回空字串。

回攻員

String：這個聯絡人的辦公室電話號碼，如果不存在則為空字串

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

---

removeFromGroup(group)

已淘汰。這個函式已淘汰，不建議在新指令碼中使用。

將這個聯絡人從指定的聯絡人群組中移除。

// The code below gets all the contacts named "John Doe" and then removes each
// of them from the "Work Friends" contact group
const contacts = ContactsApp.getContactsByName('John Doe');
const group = ContactsApp.getContactGroup('Work Friends');
for (const i in contacts) {
  contacts[i] = contacts[i].removeFromGroup(group);
}

參數

名稱	類型	說明
group	ContactGroup	要移除這位聯絡人的聯絡人群組

回攻員

Contact：這個聯絡人

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

另請參閱

• addToGroup(group)

---

setFamilyName(familyName)

已淘汰。這個函式已淘汰，不建議在新指令碼中使用。

設定聯絡人的姓氏。

// The code below changes the family name of all the contacts whose names are
// "John Doe" to "Doe-Smith"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  contacts[i].setFamilyName('Doe-Smith');
}

參數

名稱	類型	說明
familyName	String	聯絡人的新姓氏

回攻員

Contact：這個聯絡人

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

另請參閱

• getFamilyName()

---

setFullName(fullName)

已淘汰。這個函式已淘汰，不建議在新指令碼中使用。

設定聯絡人的全名 (名字和姓氏)。

// The code below changes the full name of all the contacts whose names are
// "John Doe" to "Johnny Doe"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  contacts[i].setFullName('Johnny Doe');
}

參數

名稱	類型	說明
fullName	String	聯絡人的新全名

回攻員

Contact：這個聯絡人

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

另請參閱

• getFullName()

---

setGivenName(givenName)

已淘汰。這個函式已淘汰，不建議在新指令碼中使用。

設定聯絡人的名字 (名字)。

// The code below changes the given name of all the contacts whose names are
// "John Doe" to "Johnny"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  contacts[i].setGivenName('Johnny');
}

參數

名稱	類型	說明
givenName	String	聯絡人的新名字

回攻員

Contact：這個聯絡人

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

另請參閱

• getGivenName()

---

setHomeAddress(addr)

已淘汰。這個函式已淘汰，不建議在新指令碼中使用。

設定這個聯絡人的住家地址。

參數

名稱	類型	說明
addr	String	要設定的住家地址

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

---

setHomeFax(phone)

已淘汰。這個函式已淘汰，不建議在新指令碼中使用。

設定這個聯絡人的住家傳真號碼。

參數

名稱	類型	說明
phone	String	要設定的住家傳真號碼

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

---

setHomePhone(phone)

已淘汰。這個函式已淘汰，不建議在新指令碼中使用。

設定這個聯絡人的住家電話號碼。

參數

名稱	類型	說明
phone	String	要設定的住家電話號碼

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

---

setInitials(initials)

已淘汰。這個函式已淘汰，不建議在新指令碼中使用。

設定聯絡人的名字縮寫。

// The code below sets the initials of all the contacts whose names are
// "Johnathan Doe" to "JD"
const contacts = ContactsApp.getContactsByName('Johnathan Doe');
for (const i in contacts) {
  contacts[i].setInitials('JD');
}

參數

名稱	類型	說明
initials	String	聯絡人的新姓名縮寫

回攻員

Contact：這個聯絡人

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

另請參閱

• getInitials()

---

setMaidenName(maidenName)

已淘汰。這個函式已淘汰，不建議在新指令碼中使用。

設定聯絡人的原姓。

// The code below changes the maiden name of all the contacts whose names are
// "Jane Doe" to "Smith"
const contacts = ContactsApp.getContactsByName('Jane Doe');
for (const i in contacts) {
  contacts[i].setMaidenName('Smith');
}

參數

名稱	類型	說明
maidenName	String	聯絡人的新姓氏

回攻員

Contact：這個聯絡人

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

另請參閱

• getMaidenName()

---

setMiddleName(middleName)

已淘汰。這個函式已淘汰，不建議在新指令碼中使用。

設定聯絡人的中間名。

// The code below changes the middle name of all the contacts whose names are
// "John Doe" to "Danger"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  contacts[i].setMiddleName('Danger');
}

參數

名稱	類型	說明
middleName	String	聯絡人的新中間名

回攻員

Contact：這個聯絡人

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

另請參閱

• getMiddleName()

---

setMobilePhone(phone)

已淘汰。這個函式已淘汰，不建議在新指令碼中使用。

設定聯絡人的行動電話號碼。

參數

名稱	類型	說明
phone	String	要設定的手機號碼

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

---

setNickname(nickname)

已淘汰。這個函式已淘汰，不建議在新指令碼中使用。

設定聯絡人的暱稱。

// The code below changes the nickname of all the contacts whose names are "John
// Doe" to "JohnnyD"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  contacts[i].setNickname('JohnnyD');
}

參數

名稱	類型	說明
nickname	String	聯絡人的新暱稱

回攻員

Contact：這個聯絡人

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

另請參閱

• getNickname()

---

setNotes(notes)

已淘汰。這個函式已淘汰，不建議在新指令碼中使用。

設定與此聯絡人相關聯的備註。

// The code below sets the notes of all the contacts whose names are "John Doe"
// to "Met him at the hackathon"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  contacts[i].setNotes('Met him at the hackathon');
}

參數

名稱	類型	說明
notes	String	要儲存給這個聯絡人的備註

回攻員

Contact：這個聯絡人

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

另請參閱

• getNotes()

---

setPager(phone)

已淘汰。這個函式已淘汰，不建議在新指令碼中使用。

設定這個聯絡人的尋呼機號碼。

參數

名稱	類型	說明
phone	String	要設定的尋呼機號碼

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

---

setPrefix(prefix)

已淘汰。這個函式已淘汰，不建議在新指令碼中使用。

將前置字串設為聯絡人的名稱。

// The code below sets the prefix of all the contacts whose names are "Johnathan
// Doe" to "Mr"
const contacts = ContactsApp.getContactsByName('Johnathan Doe');
for (const i in contacts) {
  contacts[i].setPrefix('Mr');
}

參數

名稱	類型	說明
prefix	String	聯絡人名稱的新前置字串

回攻員

Contact：這個聯絡人

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

另請參閱

• getPrefix()

---

setPrimaryEmail(primaryEmail)

已淘汰。這個函式已淘汰，不建議在新指令碼中使用。

設定這個聯絡人的主要電子郵件地址。

參數

名稱	類型	說明
primaryEmail	String	要設定的主要電子郵件地址

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

---

setShortName(shortName)

已淘汰。這個函式已淘汰，不建議在新指令碼中使用。

設定聯絡人的簡稱。

// The code below changes the short name of all the contacts whose names are
// "Johnathan Doe" to "John"
const contacts = ContactsApp.getContactsByName('Johnathan Doe');
for (const i in contacts) {
  contacts[i].setShortName('John');
}

參數

名稱	類型	說明
shortName	String	聯絡人的新簡稱

回攻員

Contact：這個聯絡人

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

另請參閱

• getShortName()

---

setSuffix(suffix)

已淘汰。這個函式已淘汰，不建議在新指令碼中使用。

將聯絡人的姓名後綴設定為「@」

// The code below sets the suffix of all the contacts whose names are "Johnathan
// Doe" to "Jr"
const contacts = ContactsApp.getContactsByName('Johnathan Doe');
for (const i in contacts) {
  contacts[i].setSuffix('Jr');
}

參數

名稱	類型	說明
suffix	String	聯絡人姓名的全新後置字串

回攻員

Contact：這個聯絡人

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

另請參閱

• getSuffix()

---

setUserDefinedField(key, value)

已淘汰。這個函式已淘汰，不建議在新指令碼中使用。

為此聯絡人設定單一使用者定義欄位，以便透過指定鍵儲存。

參數

名稱	類型	說明
key	String	鍵可以是任何基本類型 (字串、int 等)
value	String	值可以是任何基本類型 (字串、int 等)

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

---

setUserDefinedFields(o)

已淘汰。這個函式已淘汰，不建議在新指令碼中使用。

使用指定物件的屬性，為此聯絡人設定使用者定義的欄位。

參數

名稱	類型	說明
o	Object	含有一或多個屬性的物件，格式為 {key: value}

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

---

setWorkAddress(addr)

已淘汰。這個函式已淘汰，不建議在新指令碼中使用。

設定聯絡人的公司地址。

參數

名稱	類型	說明
addr	String	要設定的公司地址

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

---

setWorkFax(phone)

已淘汰。這個函式已淘汰，不建議在新指令碼中使用。

設定聯絡人的公司傳真號碼。

參數

名稱	類型	說明
phone	String	要設定的公司傳真號碼

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

---

setWorkPhone(phone)

已淘汰。這個函式已淘汰，不建議在新指令碼中使用。

設定聯絡人的公司電話號碼。

參數

名稱	類型	說明
phone	String	要設定的公司電話號碼

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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