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	เพิ่มที่อยู่ IM ลงในรายชื่อติดต่อด้วยป้ายกำกับมาตรฐานหรือที่กำหนดเอง
addPhone(label, number)	PhoneField	เพิ่มหมายเลขโทรศัพท์ลงในรายชื่อติดต่อด้วยป้ายกำกับมาตรฐานหรือที่กำหนดเอง
addToGroup(group)	Contact	เพิ่มรายชื่อติดต่อนี้ลงในกลุ่มรายชื่อติดต่อที่ระบุ
addUrl(label, url)	UrlField	เพิ่ม URL ลงในรายชื่อติดต่อด้วยป้ายกำกับมาตรฐานหรือที่กำหนดเอง
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[]	รับอีเมล IM ทั้งหมดของรายชื่อติดต่อนี้
getIMs(label)	IMField[]	รับอีเมล IM ทั้งหมดของรายชื่อติดต่อนี้ที่ตรงกับฟิลด์หนึ่งๆ
getId()	String	แสดงผลรหัสที่ไม่ซ้ำกันของรายชื่อติดต่อนี้
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[]	รับ URL ทั้งหมดของรายชื่อติดต่อนี้
getUrls(label)	UrlField[]	รับ URL ทั้งหมดของรายชื่อติดต่อนี้ที่ตรงกับฟิลด์หนึ่งๆ
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 — ช่องที่สร้างขึ้นใหม่

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

• 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 — ช่องที่สร้างขึ้นใหม่

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

• 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 — ช่องที่สร้างขึ้นใหม่

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

• 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 — วันที่สร้างใหม่

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

• 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 — ช่องที่เพิ่มใหม่

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

---

addIM(label, address)

เลิกใช้งานแล้ว ฟังก์ชันนี้เลิกใช้งานแล้วและไม่ควรนำมาใช้ในสคริปต์ใหม่

เพิ่มที่อยู่ IM ลงในรายชื่อติดต่อด้วยป้ายกำกับมาตรฐานหรือที่กำหนดเอง

ป้ายกํากับอาจเป็นจาก 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	ป้ายกำกับของที่อยู่ IM ใหม่จาก ContactsApp.Field หรือสตริงที่กำหนดเอง
address	String	ที่อยู่ IM ใหม่

รีเทิร์น

IMField — ช่องที่สร้างขึ้นใหม่

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

• 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 — ช่องที่สร้างขึ้นใหม่

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

• 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 — รายชื่อติดต่อนี้

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

ดูเพิ่มเติม

• removeFromGroup(group)

---

addUrl(label, url)

เลิกใช้งานแล้ว ฟังก์ชันนี้เลิกใช้งานแล้วและไม่ควรนำมาใช้ในสคริปต์ใหม่

เพิ่ม 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	URL ใหม่

รีเทิร์น

UrlField — ช่องที่สร้างขึ้นใหม่

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

ดูเพิ่มเติม

• getUrls()

---

deleteContact()

เลิกใช้งานแล้ว ฟังก์ชันนี้เลิกใช้งานแล้วและไม่ควรนำมาใช้ในสคริปต์ใหม่

ลบรายชื่อติดต่อนี้

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

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

• 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[] — รายการที่อยู่

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

• 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[] — รายการที่อยู่

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

• 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[] — รายชื่อบริษัท

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

• 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[] — รายการช่องที่กำหนดเอง

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

• 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[] — รายการช่องที่กำหนดเอง

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

• 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[] — รายการวันที่

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

• 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[] — รายการวันที่

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

ดูเพิ่มเติม

• addDate(label, month, day, year)

---

getEmailAddresses()

เลิกใช้งานแล้ว ฟังก์ชันนี้เลิกใช้งานแล้วและไม่ควรนำมาใช้ในสคริปต์ใหม่

รับรายการอีเมลที่ใช้ได้สำหรับรายชื่อติดต่อนี้

รีเทิร์น

String[] — รายชื่ออีเมลที่ใช้ได้สำหรับรายชื่อติดต่อนี้

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

• 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[] — รายชื่ออีเมลของผู้ติดต่อ

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

• 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[] — รายชื่ออีเมลของผู้ติดต่อ

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

• 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 — นามสกุลของผู้ติดต่อ

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

• 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 — ชื่อและนามสกุลของผู้ติดต่อ

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

• 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 — ชื่อจริงของผู้ติดต่อ

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

ดูเพิ่มเติม

• setGivenName(givenName)

---

getHomeAddress()

เลิกใช้งานแล้ว ฟังก์ชันนี้เลิกใช้งานแล้วและไม่ควรนำมาใช้ในสคริปต์ใหม่

รับที่อยู่บ้านของผู้ติดต่อนี้ หรือสตริงว่างหากไม่มี

รีเทิร์น

String — ที่อยู่บ้านของผู้ติดต่อนี้ หรือสตริงว่างหากไม่มี

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

---

getHomeFax()

เลิกใช้งานแล้ว ฟังก์ชันนี้เลิกใช้งานแล้วและไม่ควรนำมาใช้ในสคริปต์ใหม่

รับหมายเลขโทรสารบ้านของผู้ติดต่อนี้ หรือสตริงว่างหากไม่มี

รีเทิร์น

String — หมายเลขโทรสารบ้านของผู้ติดต่อนี้ หรือสตริงว่างหากไม่มี

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

---

getHomePhone()

เลิกใช้งานแล้ว ฟังก์ชันนี้เลิกใช้งานแล้วและไม่ควรนำมาใช้ในสคริปต์ใหม่

รับหมายเลขโทรศัพท์บ้านของผู้ติดต่อรายนี้ หรือสตริงว่างหากไม่มี

รีเทิร์น

String — หมายเลขโทรศัพท์บ้านของผู้ติดต่อนี้ หรือสตริงว่างหากไม่มี

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

---

getIMs()

เลิกใช้งานแล้ว ฟังก์ชันนี้เลิกใช้งานแล้วและไม่ควรนำมาใช้ในสคริปต์ใหม่

รับอีเมล IM ทั้งหมดของรายชื่อติดต่อนี้

// 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[] — รายการที่อยู่ IM

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

ดูเพิ่มเติม

• addIM(label, address)

---

getIMs(label)

เลิกใช้งานแล้ว ฟังก์ชันนี้เลิกใช้งานแล้วและไม่ควรนำมาใช้ในสคริปต์ใหม่

รับอีเมล IM ทั้งหมดของรายชื่อติดต่อนี้ที่ตรงกับฟิลด์หนึ่งๆ

ป้ายกํากับอาจเป็นจาก 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[] — รายการที่อยู่ IM

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

ดูเพิ่มเติม

• addIM(label, address)

---

getId()

เลิกใช้งานแล้ว ฟังก์ชันนี้เลิกใช้งานแล้วและไม่ควรนำมาใช้ในสคริปต์ใหม่

แสดงผลรหัสที่ไม่ซ้ำกันของรายชื่อติดต่อนี้

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

รีเทิร์น

String — รหัสของรายชื่อติดต่อนี้

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

• 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 — อักษรย่อของผู้ติดต่อ

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

• 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 — วันที่อัปเดตรายชื่อติดต่อนี้ครั้งล่าสุด

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

• 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 — นามสกุลเดิมของผู้ติดต่อ

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

• 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 — ชื่อกลางของผู้ติดต่อ

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

ดูเพิ่มเติม

• setMiddleName(middleName)

---

getMobilePhone()

เลิกใช้งานแล้ว ฟังก์ชันนี้เลิกใช้งานแล้วและไม่ควรนำมาใช้ในสคริปต์ใหม่

รับหมายเลขโทรศัพท์มือถือของผู้ติดต่อนี้ หรือสตริงว่างหากไม่มี

รีเทิร์น

String — หมายเลขโทรศัพท์มือถือของผู้ติดต่อนี้ หรือสตริงว่างหากไม่มี

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

• 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 — ชื่อเล่นของผู้ติดต่อ

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

• 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 — หมายเหตุที่เชื่อมโยงกับผู้ติดต่อนี้

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

ดูเพิ่มเติม

• setNotes(notes)

---

getPager()

เลิกใช้งานแล้ว ฟังก์ชันนี้เลิกใช้งานแล้วและไม่ควรนำมาใช้ในสคริปต์ใหม่

รับหมายเลขโทรศัพท์ของเพจเจอร์ของผู้ติดต่อรายนี้ หรือสตริงว่างหากไม่มี

รีเทิร์น

String — หมายเลขโทรศัพท์ของเพจเจอร์ของผู้ติดต่อนี้ หรือสตริงว่างหากไม่มี

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

• 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[] — รายการหมายเลขโทรศัพท์

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

• 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[] — รายการหมายเลขโทรศัพท์

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

• 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 — คำนำหน้าชื่อของผู้ติดต่อ

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

• 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 — อีเมลหลักของผู้ติดต่อ

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

• 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 — ชื่อย่อของผู้ติดต่อ

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

• 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 — คำต่อท้ายของชื่อผู้ติดต่อ

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

ดูเพิ่มเติม

• setSuffix(suffix)

---

getUrls()

เลิกใช้งานแล้ว ฟังก์ชันนี้เลิกใช้งานแล้วและไม่ควรนำมาใช้ในสคริปต์ใหม่

รับ URL ทั้งหมดของรายชื่อติดต่อนี้

// 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[] — รายการ URL

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

ดูเพิ่มเติม

• addUrl(label, url)

---

getUrls(label)

เลิกใช้งานแล้ว ฟังก์ชันนี้เลิกใช้งานแล้วและไม่ควรนำมาใช้ในสคริปต์ใหม่

รับ URL ทั้งหมดของรายชื่อติดต่อนี้ที่ตรงกับฟิลด์หนึ่งๆ

ป้ายกํากับอาจมาจาก 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[] — รายการ URL

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

ดูเพิ่มเติม

• addUrl(label, url)

---

getUserDefinedField(key)

เลิกใช้งานแล้ว ฟังก์ชันนี้เลิกใช้งานแล้วและไม่ควรนำมาใช้ในสคริปต์ใหม่

รับค่าที่กําหนดโดยผู้ใช้ซึ่งเชื่อมโยงกับคีย์ที่ระบุ

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
key	String	คีย์อาจเป็นประเภทพื้นฐานใดก็ได้ (สตริง, int ฯลฯ)

รีเทิร์น

String — เนื้อหาที่ผู้ใช้กําหนดซึ่งจัดเก็บไว้กับคีย์นี้

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

---

getUserDefinedFields()

เลิกใช้งานแล้ว ฟังก์ชันนี้เลิกใช้งานแล้วและไม่ควรนำมาใช้ในสคริปต์ใหม่

รับช่องข้อมูลที่ผู้ใช้กําหนดทั้งหมดสําหรับรายชื่อติดต่อนี้และแสดงผลเป็นพร็อพเพอร์ตี้ของออบเจ็กต์ JavaScript

รีเทิร์น

Object — ช่องข้อมูลที่ผู้ใช้ระบุสำหรับรายชื่อติดต่อนี้ เป็นพร็อพเพอร์ตี้ของออบเจ็กต์ JavaScript

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

---

getWorkAddress()

เลิกใช้งานแล้ว ฟังก์ชันนี้เลิกใช้งานแล้วและไม่ควรนำมาใช้ในสคริปต์ใหม่

รับที่อยู่ทํางานของผู้ติดต่อนี้ หรือสตริงว่างหากไม่มี

รีเทิร์น

String — ที่อยู่ทํางานของผู้ติดต่อนี้ หรือสตริงว่างหากไม่มี

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

---

getWorkFax()

เลิกใช้งานแล้ว ฟังก์ชันนี้เลิกใช้งานแล้วและไม่ควรนำมาใช้ในสคริปต์ใหม่

รับหมายเลขแฟกซ์ของที่ทำงานของผู้ติดต่อรายนี้ หรือสตริงว่างหากไม่มี

รีเทิร์น

String — หมายเลขโทรสารของที่ทำงานของผู้ติดต่อรายนี้ หรือสตริงว่างหากไม่มี

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

---

getWorkPhone()

เลิกใช้งานแล้ว ฟังก์ชันนี้เลิกใช้งานแล้วและไม่ควรนำมาใช้ในสคริปต์ใหม่

รับหมายเลขโทรศัพท์สำหรับงานของผู้ติดต่อนี้ หรือสตริงว่างหากไม่มี

รีเทิร์น

String — หมายเลขโทรศัพท์ที่ทำงานของผู้ติดต่อนี้ หรือสตริงว่างหากไม่มี

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

• 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 — รายชื่อติดต่อนี้

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

• 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 — รายชื่อติดต่อนี้

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

• 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 — รายชื่อติดต่อนี้

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

• 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 — รายชื่อติดต่อนี้

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

ดูเพิ่มเติม

• getGivenName()

---

setHomeAddress(addr)

เลิกใช้งานแล้ว ฟังก์ชันนี้เลิกใช้งานแล้วและไม่ควรนำมาใช้ในสคริปต์ใหม่

ตั้งค่าที่อยู่บ้านของรายชื่อติดต่อนี้

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
addr	String	ที่อยู่บ้านที่จะตั้งค่า

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

---

setHomeFax(phone)

เลิกใช้งานแล้ว ฟังก์ชันนี้เลิกใช้งานแล้วและไม่ควรนำมาใช้ในสคริปต์ใหม่

ตั้งค่าหมายเลขแฟกซ์ที่บ้านของรายชื่อติดต่อนี้

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
phone	String	หมายเลขแฟกซ์ที่บ้านที่จะตั้งค่า

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

---

setHomePhone(phone)

เลิกใช้งานแล้ว ฟังก์ชันนี้เลิกใช้งานแล้วและไม่ควรนำมาใช้ในสคริปต์ใหม่

ตั้งค่าหมายเลขโทรศัพท์บ้านของผู้ติดต่อนี้

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
phone	String	หมายเลขโทรศัพท์บ้านที่จะตั้งค่า

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

• 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 — รายชื่อติดต่อนี้

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

• 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 — รายชื่อติดต่อนี้

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

• 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 — รายชื่อติดต่อนี้

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

ดูเพิ่มเติม

• getMiddleName()

---

setMobilePhone(phone)

เลิกใช้งานแล้ว ฟังก์ชันนี้เลิกใช้งานแล้วและไม่ควรนำมาใช้ในสคริปต์ใหม่

ตั้งค่าหมายเลขโทรศัพท์มือถือของผู้ติดต่อรายนี้

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
phone	String	หมายเลขโทรศัพท์มือถือที่จะตั้งค่า

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

• 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 — รายชื่อติดต่อนี้

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

• 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 — รายชื่อติดต่อนี้

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

ดูเพิ่มเติม

• getNotes()

---

setPager(phone)

เลิกใช้งานแล้ว ฟังก์ชันนี้เลิกใช้งานแล้วและไม่ควรนำมาใช้ในสคริปต์ใหม่

ตั้งค่าหมายเลขเพจเจอร์ของรายชื่อติดต่อนี้

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
phone	String	หมายเลขเพจเจอร์ที่จะตั้งค่า

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

• 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 — รายชื่อติดต่อนี้

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

ดูเพิ่มเติม

• getPrefix()

---

setPrimaryEmail(primaryEmail)

เลิกใช้งานแล้ว ฟังก์ชันนี้เลิกใช้งานแล้วและไม่ควรนำมาใช้ในสคริปต์ใหม่

ตั้งค่าอีเมลหลักของผู้ติดต่อนี้

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
primaryEmail	String	อีเมลหลักที่จะตั้งค่า

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

• 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 — รายชื่อติดต่อนี้

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

• 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 — รายชื่อติดต่อนี้

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

ดูเพิ่มเติม

• getSuffix()

---

setUserDefinedField(key, value)

เลิกใช้งานแล้ว ฟังก์ชันนี้เลิกใช้งานแล้วและไม่ควรนำมาใช้ในสคริปต์ใหม่

ตั้งค่าช่องข้อมูลที่ผู้ใช้ระบุช่องเดียวสําหรับรายชื่อติดต่อนี้ เพื่อจัดเก็บไว้กับคีย์ที่ระบุ

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
key	String	คีย์อาจเป็นประเภทพื้นฐานใดก็ได้ (สตริง, int ฯลฯ)
value	String	ค่าอาจเป็นประเภทพื้นฐานใดก็ได้ (สตริง, int ฯลฯ)

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

---

setUserDefinedFields(o)

เลิกใช้งานแล้ว ฟังก์ชันนี้เลิกใช้งานแล้วและไม่ควรนำมาใช้ในสคริปต์ใหม่

ตั้งค่าช่องข้อมูลที่ผู้ใช้กําหนดสําหรับรายชื่อติดต่อนี้ด้วยพร็อพเพอร์ตี้ของออบเจ็กต์ที่ระบุ

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
o	Object	ออบเจ็กต์ที่มีพร็อพเพอร์ตี้อย่างน้อย 1 รายการในรูปแบบ {key: value}

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

---

setWorkAddress(addr)

เลิกใช้งานแล้ว ฟังก์ชันนี้เลิกใช้งานแล้วและไม่ควรนำมาใช้ในสคริปต์ใหม่

ตั้งค่าที่อยู่ที่ทำงานของรายชื่อติดต่อนี้

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
addr	String	ที่อยู่ที่ทำงานที่จะตั้งค่า

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

---

setWorkFax(phone)

เลิกใช้งานแล้ว ฟังก์ชันนี้เลิกใช้งานแล้วและไม่ควรนำมาใช้ในสคริปต์ใหม่

ตั้งค่าหมายเลขแฟกซ์ที่ทำงานของรายชื่อติดต่อนี้

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
phone	String	หมายเลขแฟกซ์ที่ทำงานที่จะตั้งค่า

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

---

setWorkPhone(phone)

เลิกใช้งานแล้ว ฟังก์ชันนี้เลิกใช้งานแล้วและไม่ควรนำมาใช้ในสคริปต์ใหม่

ตั้งค่าหมายเลขโทรศัพท์ที่ทำงานของรายชื่อติดต่อนี้

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
phone	String	หมายเลขโทรศัพท์ที่ทำงานที่จะตั้งค่า

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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