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	เพิ่มอีเมลที่มีป้ายกำกับมาตรฐาน (บ้าน ที่ทำงาน ฯลฯ) หรือป้ายกำกับที่กำหนดเอง
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 the ContactsApp.Field.WORK_ADDRESS label.
var contacts = ContactsApp.getContactsByName('John Doe');
var address = contacts[0].addAddress(ContactsApp.Field.WORK_ADDRESS,
                                    '123 Main St, Some City, NY 10011');

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
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".
var contacts = ContactsApp.getContactsByName('John Doe');
var url = contacts[0].addCompany('Google', 'Product Manager');

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
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'.
var contacts = ContactsApp.getContactsByName('John Doe');
contacts[0].addCustomField(ContactsApp.ExtendedField.HOBBY, 'hiking');

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
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".
var contacts = ContactsApp.getContactsByName('John Doe');
var birthday = contacts[0].addDate(ContactsApp.Field.BIRTHDAY,
                                   ContactsApp.Month.APRIL, 19, 1950);

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
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.
var contacts = ContactsApp.getContactsByName('John Doe');
var emailField = contacts[0].addEmail(ContactsApp.Field.HOME_EMAIL, '[e-mail]');

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
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 the ContactsApp.Field.AIM label.
var contacts = ContactsApp.getContactsByName('John Doe');
var email = contacts[0].addIM(ContactsApp.Field.AIM, 'ChatWithJohn');

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
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 the ContactsApp.Field.WORK_PHONE label.
var contacts = ContactsApp.getContactsByName('John Doe');
var phone = contacts[0].addPhone(ContactsApp.Field.WORK_PHONE, '212-555-1234');

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
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"
var contact = ContactsApp.createContact('John', 'Doe', '[e-mail]');
var group = ContactsApp.getContactGroup('Work Friends');
contact = contact.addToGroup(group);

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
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 the ContactsApp.Field.WORK_WEBSITE label.
var contacts = ContactsApp.getContactsByName('John Doe');
var url = contacts[0].addUrl(ContactsApp.Field.WORK_WEBSITE, 'http://www.example.com');

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
label	Object	ป้ายกำกับของที่อยู่ใหม่ ไม่ว่าจะจาก ContactsApp.Field หรือสตริงที่กำหนดเอง
url	String	URL ใหม่

รีเทิร์น

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

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

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

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

ดูเพิ่มเติม

• getUrls()

---

deleteContact()

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

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

var contacts = ContactsApp.getContactsByName('John Doe');
for (var 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"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var 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.
var contacts = ContactsApp.getContactsByName('John Doe');
var addresses = contacts[0].getAddresses(ContactsApp.Field.WORK_ADDRESS);
for (var i in addresses) {
  Logger.log(addresses[i].getAddress());
}

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
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"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  var companies = contacts[i].getCompanies();
  for (var 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
var contacts = ContactsApp.getContactsByName('John Doe');
var 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
var contacts = ContactsApp.getContactsByName('John Doe');
var fields = contacts[0].getCustomFields();
for (var 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.
var contacts = ContactsApp.getContactsByName('John Doe');
var hobbies = contacts[0].getCustomFields(ContactsApp.ExtendedField.HOBBY);
for (var i in hobbies) {
  Logger.log(hobbies[i].getValue());
}

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
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
var contacts = ContactsApp.getContactsByName('John Doe');
var dates = contacts[0].getDates();
for (var 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.
var contacts = ContactsApp.getContactsByName('John Doe');
var birthdays = contacts[0].getDates(ContactsApp.Field.BIRTHDAY);
for (var i in birthdays) {
  Logger.log(birthdays[i].getDay());
}

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
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
var contacts = ContactsApp.getContactsByName('John Doe');
var emails = contacts[0].getEmails();
for (var 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.
var contacts = ContactsApp.getContactsByName('John Doe');
var emails = contacts[0].getEmails(ContactsApp.Field.HOME_EMAIL);
for (var i in emails) {
  Logger.log(emails[i].getAddress());
}

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
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"
var contacts = ContactsApp.getContactsByName('John');
for (var 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"
var contacts = ContactsApp.getContactsByName('John');
for (var 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"
var contacts = ContactsApp.getContactsByName('Smith');
for (var 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"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var 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.
var contacts = ContactsApp.getContactsByName('John Doe');
var imAddresses = contacts[0].getIMs(ContactsApp.Field.GOOGLE_TALK);
for (var i in imAddresses) {
  Logger.log(imAddresses[i].getAddress());
}

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
label	Object	ป้ายกำกับที่จะจับคู่จาก ContactsApp.Field หรือสตริงที่กำหนดเอง

รีเทิร์น

IMField[] — รายการที่อยู่ IM

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

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

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

ดูเพิ่มเติม

• addIM(label, address)

---

getId()

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

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

var contact = ContactsApp.createContact('John', 'Doe', '[e-mail]');
var 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"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var 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"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var 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"
var contacts = ContactsApp.getContactsByName('Jane');
for (var 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"
var contacts = ContactsApp.getContactsByName('Smith');
for (var 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"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var 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"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var 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"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var 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.
var contacts = ContactsApp.getContactsByName('John Doe');
var phones = contacts[0].getPhones(ContactsApp.Field.WORK_PHONE);
for (var i in phones) {
  Logger.log(phones[i].getPhoneNumber());
}

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
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"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var 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"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var 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"
var contacts = ContactsApp.getContactsByName('Johnathan');
for (var 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"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var 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"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var 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.
var contacts = ContactsApp.getContactsByName('John Doe');
var urls = contacts[0].getUrls(ContactsApp.Field.WORK_WEBSITE);
for (var i in urls) {
  Logger.log(urls[i].getAddress());
}

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
label	Object	ป้ายกำกับที่จะจับคู่จาก ContactsApp.Field หรือสตริงที่กำหนดเอง

รีเทิร์น

UrlField[] — รายการ URL

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

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

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

ดูเพิ่มเติม

• addUrl(label, url)

---

getUserDefinedField(key)

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

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

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
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
var contacts = ContactsApp.getContactsByName('John Doe');
var group = ContactsApp.getContactGroup('Work Friends');
for (var i in contacts) {
  contacts[i] = contacts[i].removeFromGroup(group);
}

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
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"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  contacts[i].setFamilyName('Doe-Smith');
}

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
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"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  contacts[i].setFullName('Johnny Doe');
}

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
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"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  contacts[i].setGivenName('Johnny');
}

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
givenName	String	ชื่อใหม่ของผู้ติดต่อ

รีเทิร์น

Contact — รายชื่อติดต่อนี้

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

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

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

ดูเพิ่มเติม

• getGivenName()

---

setHomeAddress(addr)

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

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

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
addr	String	ที่อยู่บ้านที่จะกำหนด

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

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

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

---

setHomeFax(phone)

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

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

พารามิเตอร์

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

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

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

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

---

setHomePhone(phone)

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

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

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
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"
var contacts = ContactsApp.getContactsByName('Johnathan Doe');
for (var i in contacts) {
  contacts[i].setInitials('JD');
}

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
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"
var contacts = ContactsApp.getContactsByName('Jane Doe');
for (var i in contacts) {
  contacts[i].setMaidenName('Smith');
}

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
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"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  contacts[i].setMiddleName('Danger');
}

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
middleName	String	ชื่อกลางใหม่ของรายชื่อติดต่อ

รีเทิร์น

Contact — รายชื่อติดต่อนี้

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

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

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

ดูเพิ่มเติม

• getMiddleName()

---

setMobilePhone(phone)

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

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

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
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"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  contacts[i].setNickname('JohnnyD');
}

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
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"
var contacts = ContactsApp.getContactsByName('John Doe');
for (var i in contacts) {
  contacts[i].setNotes('Met him at the hackathon');
}

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
notes	String	บันทึกที่จะจัดเก็บสำหรับรายชื่อติดต่อนี้

รีเทิร์น

Contact — รายชื่อติดต่อนี้

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

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

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

ดูเพิ่มเติม

• getNotes()

---

setPager(phone)

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

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

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
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"
var contacts = ContactsApp.getContactsByName('Johnathan Doe');
for (var i in contacts) {
  contacts[i].setPrefix('Mr');
}

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
prefix	String	คำนำหน้าใหม่ของชื่อผู้ติดต่อ

รีเทิร์น

Contact — รายชื่อติดต่อนี้

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

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

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

ดูเพิ่มเติม

• getPrefix()

---

setPrimaryEmail(primaryEmail)

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

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

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
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"
var contacts = ContactsApp.getContactsByName('Johnathan Doe');
for (var i in contacts) {
  contacts[i].setShortName('John');
}

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
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"
var contacts = ContactsApp.getContactsByName('Johnathan Doe');
for (var i in contacts) {
  contacts[i].setSuffix('Jr');
}

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
suffix	String	คำต่อท้ายใหม่ของชื่อผู้ติดต่อ

รีเทิร์น

Contact — รายชื่อติดต่อนี้

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

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

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

ดูเพิ่มเติม

• getSuffix()

---

setUserDefinedField(key, value)

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

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

พารามิเตอร์

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

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

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

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

---

setUserDefinedFields(o)

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

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

พารามิเตอร์

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

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

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

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

---

setWorkAddress(addr)

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

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

พารามิเตอร์

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

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

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

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

---

setWorkFax(phone)

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

ตั้งหมายเลขโทรสารที่ทำงานของผู้ติดต่อรายนี้

พารามิเตอร์

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

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

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

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

---

setWorkPhone(phone)

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

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

พารามิเตอร์

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

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

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

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