Class ContactsApp

ContactsApp

เลิกใช้งานแล้ว โปรดใช้บริการขั้นสูงของ People API แทน

ชั้นเรียนนี้อนุญาตให้ผู้ใช้เข้าถึง Google Contacts ของตนเอง รวมถึงสร้าง นำออก และอัปเดตรายชื่อติดต่อที่แสดงในนั้น

พร็อพเพอร์ตี้ที่เลิกใช้งานแล้ว

พร็อพเพอร์ตี้	Type	คำอธิบาย
ExtendedField	ExtendedField
Field	Field
Gender	Gender
Month	Month
Priority	Priority
Sensitivity	Sensitivity

วิธีการที่เลิกใช้งานแล้ว

วิธีการ	ประเภทการแสดงผล	รายละเอียดแบบย่อ
createContact(givenName, familyName, email)	Contact	สร้างรายชื่อติดต่อใหม่
createContactGroup(name)	ContactGroup	สร้างกลุ่มรายชื่อติดต่อโดยใช้ชื่อตามที่ระบุ
deleteContact(contact)	void	ลบรายชื่อติดต่อ
deleteContactGroup(group)	void	ลบกลุ่มรายชื่อติดต่อ
findByEmailAddress(email)	Contact	ค้นหาผู้ติดต่อโดยใช้ที่อยู่อีเมลที่ระบุ
findContactGroup(name)	ContactGroup	ค้นหากลุ่มผู้ติดต่อของชื่อที่ระบุ
getAllContacts()	Contact[]	รับรายชื่อติดต่อทั้งหมดที่เป็นของผู้ใช้รายนี้
getContact(emailAddress)	Contact	เรียกรายชื่อติดต่อจากอีเมล
getContactById(id)	Contact	รับรายชื่อติดต่อที่มีรหัสนี้
getContactGroup(name)	ContactGroup	รับกลุ่มรายชื่อติดต่อที่มีชื่อที่ระบุ หรือแสดงผลเป็น Null หากไม่พบกลุ่มรายชื่อติดต่อดังกล่าว
getContactGroupById(id)	ContactGroup	รับกลุ่มรายชื่อติดต่อที่มีรหัสที่ระบุ หรือแสดงผลเป็น Null หากไม่พบกลุ่มรายชื่อติดต่อดังกล่าว
getContactGroups()	ContactGroup[]	เรียกดูรายการกลุ่มรายชื่อติดต่อของผู้ใช้ทั้งหมด
getContacts()	Contact[]	เรียกรายชื่อติดต่อทั้งหมดของผู้ใช้
getContactsByAddress(query)	Contact[]	รับรายชื่อติดต่อที่ตรงกับที่อยู่
getContactsByAddress(query, label)	Contact[]	รับรายชื่อติดต่อที่ตรงกับที่อยู่ โดยจำกัดเฉพาะช่องที่ระบุ
getContactsByAddress(query, label)	Contact[]	รับรายชื่อติดต่อที่ตรงกับที่อยู่ ซึ่งจำกัดไว้ที่ป้ายกำกับที่อยู่ที่กำหนดเองที่ระบุไว้
getContactsByCompany(query)	Contact[]	รับรายชื่อติดต่อที่ตรงกับช่องบริษัท
getContactsByCustomField(query, label)	Contact[]	รับรายชื่อติดต่อที่ตรงกับค่าที่ระบุในช่องที่กำหนดเอง
getContactsByDate(month, day, label)	Contact[]	รับรายชื่อติดต่อที่ตรงกับเดือนและวันหนึ่งๆ สำหรับฟิลด์มาตรฐานหนึ่งๆ
getContactsByDate(month, day, year, label)	Contact[]	รับรายชื่อติดต่อที่ตรงกับเดือน วัน และปีที่ต้องการสำหรับฟิลด์มาตรฐานหนึ่งๆ
getContactsByDate(month, day, year, label)	Contact[]	รับรายชื่อติดต่อที่ตรงกับเดือน วัน และปีที่ต้องการสำหรับช่องที่กำหนดเองนั้นๆ
getContactsByDate(month, day, label)	Contact[]	รับรายชื่อติดต่อที่ตรงกับเดือนและวันหนึ่งๆ สำหรับช่องที่กำหนดเองที่เจาะจง
getContactsByEmailAddress(query)	Contact[]	รับรายชื่อติดต่อที่ตรงกับที่อยู่อีเมล
getContactsByEmailAddress(query, label)	Contact[]	รับรายชื่อติดต่อที่ตรงกับที่อยู่อีเมล โดยจำกัดเฉพาะช่องที่ระบุ
getContactsByEmailAddress(query, label)	Contact[]	รับรายชื่อติดต่อที่ตรงกับอีเมลซึ่งจำกัดไว้ที่ป้ายกำกับอีเมลที่กำหนดเองที่ระบุไว้
getContactsByGroup(group)	Contact[]	ดึงรายชื่อติดต่อลงใน ContactGroup ที่ระบุ
getContactsByIM(query)	Contact[]	รับรายชื่อติดต่อที่ตรงกับที่อยู่การรับส่งข้อความโต้ตอบแบบทันที
getContactsByIM(query, label)	Contact[]	รับรายชื่อติดต่อที่ตรงกับที่อยู่การรับส่งข้อความโต้ตอบแบบทันที โดยจำกัดเฉพาะช่องข้อมูลที่กำหนด
getContactsByIM(query, label)	Contact[]	รับรายชื่อติดต่อที่ตรงกับที่อยู่การรับส่งข้อความโต้ตอบแบบทันที โดยจำกัดไว้ที่ป้ายกำกับการรับส่งข้อความโต้ตอบแบบทันทีที่กำหนดเองที่ระบุไว้เท่านั้น
getContactsByJobTitle(query)	Contact[]	รับรายชื่อติดต่อที่ตรงกับช่องตำแหน่งงาน
getContactsByName(query)	Contact[]	รับรายชื่อติดต่อที่ตรงกับชื่อ
getContactsByName(query, label)	Contact[]	รับรายชื่อติดต่อที่ตรงกับชื่อ จำกัดเฉพาะช่องที่ระบุ
getContactsByNotes(query)	Contact[]	รับรายชื่อติดต่อที่ตรงกับช่องหมายเหตุ
getContactsByPhone(query)	Contact[]	เรียกรายชื่อติดต่อที่ตรงกับหมายเลขโทรศัพท์
getContactsByPhone(query, label)	Contact[]	รับรายชื่อติดต่อที่ตรงกับหมายเลขโทรศัพท์ โดยจำกัดเฉพาะช่องบางช่อง
getContactsByPhone(query, label)	Contact[]	เรียกรายชื่อติดต่อที่ตรงกับหมายเลขโทรศัพท์ โดยจำกัดเฉพาะป้ายกำกับหมายเลขโทรศัพท์ที่กำหนดเองที่ระบุ
getContactsByUrl(query)	Contact[]	รับรายชื่อติดต่อที่ตรงกับ URL
getContactsByUrl(query, label)	Contact[]	รับรายชื่อติดต่อที่ตรงกับ URL ที่จำกัดไว้เพียงช่องเดียว
getContactsByUrl(query, label)	Contact[]	รับรายชื่อติดต่อที่ตรงกับ URL ซึ่งจำกัดไว้ที่ป้ายกำกับ URL ที่กำหนดเองที่ระบุ

วิธีการที่เลิกใช้งานแล้ว

createContact(givenName, familyName, email)

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

สร้างรายชื่อติดต่อใหม่

// The code below creates a new contact with the name "John Doe" and the email address
// "[e-mail]".
var contact = ContactsApp.createContact('John', 'Doe', '[e-mail]');

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
givenName	String	ชื่อของรายชื่อติดต่อ
familyName	String	นามสกุลของผู้ติดต่อ
email	String	อีเมลของรายชื่อติดต่อ

รีเทิร์น

Contact — ออบเจ็กต์รายชื่อติดต่อที่สร้างขึ้นใหม่

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

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

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

ดูเพิ่มเติม

• deleteContact(contact)

---

createContactGroup(name)

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

สร้างกลุ่มรายชื่อติดต่อโดยใช้ชื่อตามที่ระบุ

// The code below creates a new contact group named "Work Friends"
var group = ContactsApp.createContactGroup("Work Friends");

พารามิเตอร์

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

รีเทิร์น

ContactGroup — กลุ่มรายชื่อติดต่อที่สร้างขึ้นใหม่

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

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

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

ดูเพิ่มเติม

• deleteContactGroup(group)

---

deleteContact(contact)

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

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

// The code below retrieves a contact with the email address "[e-mail]"
// and then deletes that contact.
var contact = ContactsApp.getContact('[e-mail]');
ContactsApp.deleteContact(contact);

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
contact	Contact	รายชื่อติดต่อที่จะลบ

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

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

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

ดูเพิ่มเติม

• createContact(givenName, familyName, email)

---

deleteContactGroup(group)

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

ลบกลุ่มรายชื่อติดต่อ

// The code below creates deletes the contact group named "Work Friends"
var group = ContactsApp.getContactGroup("Work Friends");
ContactsApp.deleteContactGroup(group);

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
group	ContactGroup	กลุ่มรายชื่อติดต่อที่จะลบ

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

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

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

ดูเพิ่มเติม

• createContactGroup(name)

---

findByEmailAddress(email)

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

ค้นหาผู้ติดต่อโดยใช้ที่อยู่อีเมลที่ระบุ

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
email	String	อีเมลของรายชื่อติดต่อที่จะพบ

รีเทิร์น

Contact — รายชื่อติดต่อที่มีที่อยู่อีเมลนั้น

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

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

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

---

findContactGroup(name)

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

ค้นหากลุ่มผู้ติดต่อของชื่อที่ระบุ

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
name	String	ชื่อกลุ่มรายชื่อติดต่อที่จะค้นหา

รีเทิร์น

ContactGroup — กลุ่มรายชื่อติดต่อที่ตรงกับชื่อที่ระบุ

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

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

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

---

getAllContacts()

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

รับรายชื่อติดต่อทั้งหมดที่เป็นของผู้ใช้รายนี้

รีเทิร์น

Contact[] — รายชื่อติดต่อทั้งหมดของผู้ใช้รายนี้

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

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

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

---

getContact(emailAddress)

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

เรียกรายชื่อติดต่อจากอีเมล

หากผู้ติดต่อหลายคนใช้ที่อยู่อีเมลเดียวกัน วิธีการนี้จะสนับสนุนผู้ติดต่อที่ทำเครื่องหมายที่อยู่อีเมลว่าเป็นที่อยู่หลัก ถ้าไม่มีผู้ติดต่อรายใดที่ทำเครื่องหมายที่อยู่อีเมลเป็น ผู้ติดต่อหลัก หรือผู้ติดต่อหลายรายที่ทำเครื่องหมายที่อยู่อีเมลเป็นตำแหน่งหลัก จะแสดงผลเป็นลำดับแรก สำหรับลำดับผู้ติดต่อที่จัดเรียงแล้ว

// The code below retrieves a contact with the email address "[e-mail]".
var contact = ContactsApp.getContact('[e-mail]');

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
emailAddress	String	อีเมลของรายชื่อติดต่อ

รีเทิร์น

Contact — รายชื่อติดต่อที่มีที่อยู่อีเมลนั้น

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

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

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

ดูเพิ่มเติม

• getContacts()
• getContactById(id)

---

getContactById(id)

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

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

// The code below retrieves the contact with the id
// "http://www.google.com/m8/feeds/contacts/john.doe%40example.com/base/7c86afde08d34ca5"
var id = 'http://www.google.com/m8/feeds/contacts/john.doe%40example.com/base/7c86afde08d34c';
var contact = ContactApp.getContactById(id);

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
id	String	ID ของรายชื่อติดต่อที่จะเรียกดู

รีเทิร์น

Contact — รายชื่อติดต่อหรือค่าว่างที่ตรงกัน

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

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

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

ดูเพิ่มเติม

• getContact(emailAddress)

---

getContactGroup(name)

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

รับกลุ่มรายชื่อติดต่อที่มีชื่อที่ระบุ หรือแสดงผลเป็น Null หากไม่พบกลุ่มรายชื่อติดต่อดังกล่าว

// The code below returns the contact group with the name "Work Friends"
var group  = ContactsApp.getContactGroup('Work Friends');

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
name	String	ชื่อกลุ่มรายชื่อติดต่อที่จะจับคู่

รีเทิร์น

ContactGroup — กลุ่มรายชื่อติดต่อที่ตรงกันหรือค่าว่างหากไม่พบกลุ่มรายชื่อติดต่อที่ตรงกัน

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

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

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

ดูเพิ่มเติม

• getContactGroups()

---

getContactGroupById(id)

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

รับกลุ่มรายชื่อติดต่อที่มีรหัสที่ระบุ หรือแสดงผลเป็น Null หากไม่พบกลุ่มรายชื่อติดต่อดังกล่าว

// The code below returns the contact group with the id
// "http://www.google.com/m8/feeds/groups/john.doe%40example.com/base/54eefbb093fdecb"
var id = "http://www.google.com/m8/feeds/groups/john.doe%40example.com/base/54eefbb093fdecb";
var group  = ContactsApp.getContactGroupById(id);

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
id	String	รหัสของกลุ่มรายชื่อติดต่อที่จะจับคู่

รีเทิร์น

ContactGroup — กลุ่มรายชื่อติดต่อที่ตรงกันหรือค่าว่างหากไม่พบกลุ่มรายชื่อติดต่อที่ตรงกัน

ดูเพิ่มเติม

• getContactGroups()

---

getContactGroups()

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

เรียกดูรายการกลุ่มรายชื่อติดต่อของผู้ใช้ทั้งหมด

ผู้ใช้สามารถมีรายชื่อติดต่อได้ และอาจเป็นรายการของกลุ่มรายชื่อติดต่อได้เช่นกัน กลุ่มรายชื่อติดต่อแต่ละกลุ่ม สามารถมีรายชื่อติดต่อได้ วิธีนี้จะแสดงรายการกลุ่มรายชื่อติดต่อทั้งหมด

// The retrieves all the contract groups for the user and then logs the group name of each
// contact group.
var groups  = ContactsApp.getContactGroups();
for (var i = 0; i < groups.length; i++) {
  Logger.log(groups[i].getName());
}

รีเทิร์น

ContactGroup[] — อาร์เรย์ของกลุ่มรายชื่อติดต่อของผู้ใช้

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

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

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

ดูเพิ่มเติม

• getContactGroup(name)

---

getContacts()

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

เรียกรายชื่อติดต่อทั้งหมดของผู้ใช้

// The code below will retrieve all the user's contacts
var contacts = ContactsApp.getContacts();

รีเทิร์น

Contact[] — อาร์เรย์ของรายชื่อติดต่อทั้งหมดของผู้ใช้

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

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

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

ดูเพิ่มเติม

• getContact(emailAddress)

---

getContactsByAddress(query)

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

รับรายชื่อติดต่อที่ตรงกับที่อยู่

// The code below returns an array of contacts where the contact's address contains
// "San Francisco'.
var contacts = ContactsApp.getContactsByAddress('San Francisco');

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
query	String	สตริงที่จะค้นหาในที่อยู่ของผู้ติดต่อ

รีเทิร์น

Contact[] — อาร์เรย์ของรายชื่อติดต่อที่ตรงกัน

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

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

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

ดูเพิ่มเติม

• getContact(emailAddress)

---

getContactsByAddress(query, label)

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

รับรายชื่อติดต่อที่ตรงกับที่อยู่ โดยจำกัดเฉพาะช่องที่ระบุ

// The code below returns an array of contacts where the contact's address contains
// "San Francisco" in the Home address field.
var contacts = ContactsApp.getContactsByAddress('San Francisco',
                                                ContactsApp.Field.HOME_ADDRESS);

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
query	String	สตริงที่จะค้นหาในที่อยู่ของผู้ติดต่อ
label	Field	ช่องที่ควรค้นหาภายใน

รีเทิร์น

Contact[] — อาร์เรย์ของรายชื่อติดต่อที่ตรงกัน

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

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

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

ดูเพิ่มเติม

• getContact(emailAddress)

---

getContactsByAddress(query, label)

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

รับรายชื่อติดต่อที่ตรงกับที่อยู่ ซึ่งจำกัดไว้ที่ป้ายกำกับที่อยู่ที่กำหนดเองที่ระบุไว้

// The code below returns an array of contacts where the contact's address contains
// "San Francisco" in a custom address label (created by the user) called
// "vacation".
var contacts = ContactsApp.getContactsByAddress('San Francisco', 'vacation');

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
query	String	สตริงที่จะค้นหาในที่อยู่ของรายชื่อติดต่อที่มีป้ายกำกับที่อยู่ที่กำหนดเองที่ระบุ
label	String	ป้ายกำกับที่อยู่ที่กำหนดเองเพื่อค้นหาภายใน

รีเทิร์น

Contact[] — อาร์เรย์ของรายชื่อติดต่อที่ตรงกัน

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

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

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

ดูเพิ่มเติม

• getContact(emailAddress)

---

getContactsByCompany(query)

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

รับรายชื่อติดต่อที่ตรงกับช่องบริษัท

// The code below returns an array of contacts where the contact's company field
// contains "Google".
var contacts = ContactsApp.getContactsByCompany('Google');

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
query	String	สตริงที่ต้องการค้นหาในช่องบริษัทของรายชื่อติดต่อ

รีเทิร์น

Contact[] — อาร์เรย์ของรายชื่อติดต่อที่ตรงกัน

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

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

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

ดูเพิ่มเติม

• getContact(emailAddress)

---

getContactsByCustomField(query, label)

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

รับรายชื่อติดต่อที่ตรงกับค่าที่ระบุในช่องที่กำหนดเอง

คุณจะระบุช่องที่กำหนดเองด้วยสตริงหรือเป็นค่า ContactsApp.ExtendedField ก็ได้

// The code below returns an array of contacts where the contact's custom field
// named "Favorite Sport" contains "tennis".
var contacts = ContactsApp.getContactsByCustomField('tennis', 'Favorite Sport');

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
query	Object	สตริงที่ต้องการค้นหาในช่องที่กำหนดเองของรายชื่อติดต่อ
label	ExtendedField	ช่องที่กำหนดเองเพื่อค้นหาภายใน

รีเทิร์น

Contact[] — อาร์เรย์ของรายชื่อติดต่อที่ตรงกัน

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

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

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

ดูเพิ่มเติม

• getContact(emailAddress)

---

getContactsByDate(month, day, label)

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

รับรายชื่อติดต่อที่ตรงกับเดือนและวันหนึ่งๆ สำหรับฟิลด์มาตรฐานหนึ่งๆ

// The code below returns an array of contacts where the contact's "Birthday" field
// contains April for the month and 19 for the day.
var contacts = ContactsApp.getContactsByDate(ContactsApp.Month.APRIL, 19,
                                              ContactsApp.Field.BIRTHDAY);

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
month	Month	เดือนที่ตรงกัน เป็นหนึ่งในค่าจาก ContactsApp.Month
day	Integer	วันที่จะจับคู่
label	Field	ฟิลด์ที่จะค้นหาภายในจาก ContactsApp.Field

รีเทิร์น

Contact[] — อาร์เรย์ของรายชื่อติดต่อที่ตรงกัน

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

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

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

ดูเพิ่มเติม

• getContact(emailAddress)

---

getContactsByDate(month, day, year, label)

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

รับรายชื่อติดต่อที่ตรงกับเดือน วัน และปีที่ต้องการสำหรับฟิลด์มาตรฐานหนึ่งๆ

// The code below returns an array of contacts where the contact's "Birthday" field
// contains April for the month, 19 for the day, and 1950 for the year.
var contacts = ContactsApp.getContactsByDate(ContactsApp.Month.APRIL, 19, 1950,
                                             ContactsApp.Field.BIRTHDAY);

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
month	Month	เดือนที่ตรงกัน เป็นหนึ่งในค่าจาก ContactsApp.Month
day	Integer	วันที่จะจับคู่
year	Integer	ปีที่ตรงกันสามารถเว้นว่างได้
label	Field	ฟิลด์ที่จะค้นหาภายในจาก ContactsApp.Field

รีเทิร์น

Contact[] — อาร์เรย์ของรายชื่อติดต่อที่ตรงกัน

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

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

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

ดูเพิ่มเติม

• getContact(emailAddress)

---

getContactsByDate(month, day, year, label)

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

รับรายชื่อติดต่อที่ตรงกับเดือน วัน และปีที่ต้องการสำหรับช่องที่กำหนดเองนั้นๆ

// The code below returns an array of contacts where the contact's custom "Start Date" field
// contains April for the month, 19 for the day, and 2011 for the year.
var contacts = ContactsApp.getContactsByDate(ContactsApp.Month.APRIL, 19, 2011, 'Start Date');

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
month	Month	เดือนที่ตรงกัน เป็นหนึ่งในค่าจาก ContactsApp.Month
day	Integer	วันที่จะจับคู่
year	Integer	ปีที่ตรงกันสามารถเว้นว่างได้
label	String	ช่องที่กำหนดเองเพื่อค้นหาภายใน

รีเทิร์น

Contact[] — อาร์เรย์ของรายชื่อติดต่อที่ตรงกัน

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

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

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

ดูเพิ่มเติม

• getContact(emailAddress)

---

getContactsByDate(month, day, label)

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

รับรายชื่อติดต่อที่ตรงกับเดือนและวันหนึ่งๆ สำหรับช่องที่กำหนดเองที่เจาะจง

// The code below returns an array of contacts where the contact's custom "Start Date" field
// contains April for the month and 19 for the day.
var contacts = ContactsApp.getContactsByDate(ContactsApp.Month.APRIL, 19, 'Start Date');

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
month	Month	เดือนที่ตรงกัน เป็นหนึ่งในค่าจาก ContactsApp.Month
day	Integer	วันที่จะจับคู่
label	String	ช่องที่กำหนดเองเพื่อค้นหาภายใน

รีเทิร์น

Contact[] — อาร์เรย์ของรายชื่อติดต่อที่ตรงกัน

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

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

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

ดูเพิ่มเติม

• getContact(emailAddress)

---

getContactsByEmailAddress(query)

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

รับรายชื่อติดต่อที่ตรงกับที่อยู่อีเมล

// The code below returns an array of contacts where the contact's email address contains
// "[e-mail]'.
var contacts = ContactsApp.getContactsByEmailAddress('[e-mail]');

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
query	String	สตริงที่จะค้นหาในอีเมลติดต่อ

รีเทิร์น

Contact[] — อาร์เรย์ของรายชื่อติดต่อที่ตรงกัน

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

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

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

ดูเพิ่มเติม

• getContact(emailAddress)

---

getContactsByEmailAddress(query, label)

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

รับรายชื่อติดต่อที่ตรงกับที่อยู่อีเมล โดยจำกัดเฉพาะช่องที่ระบุ

// The code below returns an array of contacts where the contact's email address contains
// "[e-mail]" in the Home email field.
var contacts = ContactsApp.getContactsByEmailAddress('[e-mail]',
                                                     ContactsApp.Field.HOME_EMAIL);

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
query	String	สตริงที่จะค้นหาในอีเมลติดต่อ
label	Field	ช่องที่ควรค้นหาภายใน

รีเทิร์น

Contact[] — อาร์เรย์ของรายชื่อติดต่อที่ตรงกัน

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

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

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

ดูเพิ่มเติม

• getContact(emailAddress)

---

getContactsByEmailAddress(query, label)

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

รับรายชื่อติดต่อที่ตรงกับอีเมลซึ่งจำกัดไว้ที่ป้ายกำกับอีเมลที่กำหนดเองที่ระบุไว้

// The code below returns an array of contacts where the contact's email address contains
// "[e-mail]" in a custom email address label (created by the user) called
// "alternate".
var contacts = ContactsApp.getContactsByEmailAddress('[e-mail]', 'alternate');

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
query	String	สตริงที่จะค้นหาในอีเมลติดต่อที่มีป้ายกำกับอีเมลที่กำหนดเองที่ระบุ
label	String	ป้ายกำกับอีเมลที่กำหนดเองเพื่อค้นหาภายใน

รีเทิร์น

Contact[] — อาร์เรย์ของรายชื่อติดต่อที่ตรงกัน

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

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

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

ดูเพิ่มเติม

• getContact(emailAddress)

---

getContactsByGroup(group)

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

ดึงรายชื่อติดต่อลงใน ContactGroup ที่ระบุ

// The code below returns an array of contacts in the ContactGroup with the name
// "Work Friends".
var group  = ContactsApp.getContactGroup('Work Friends');
var contacts = ContactsApp.getContactsByGroup(group);

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
group	ContactGroup	กลุ่มรายชื่อติดต่อ

รีเทิร์น

Contact[] — อาร์เรย์ของรายชื่อติดต่อในกลุ่มที่กำหนด

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

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

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

ดูเพิ่มเติม

• getContact(emailAddress)

---

getContactsByIM(query)

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

รับรายชื่อติดต่อที่ตรงกับที่อยู่การรับส่งข้อความโต้ตอบแบบทันที

// The code below returns an array of contacts where the contact's instant messaging address
// contains "ChatWithJohnDoe" in any instant messaging field.
var contacts = ContactsApp.getContactsByIM('ChatWithJohnDoe');

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
query	String	สตริงที่จะค้นหาในที่อยู่การรับส่งข้อความโต้ตอบแบบทันทีของรายชื่อติดต่อ

รีเทิร์น

Contact[] — อาร์เรย์ของรายชื่อติดต่อที่ตรงกัน

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

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

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

ดูเพิ่มเติม

• getContact(emailAddress)

---

getContactsByIM(query, label)

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

รับรายชื่อติดต่อที่ตรงกับที่อยู่การรับส่งข้อความโต้ตอบแบบทันที โดยจำกัดเฉพาะช่องข้อมูลที่กำหนด

// The code below returns an array of contacts where the contact's instant messaging address
// contains "ChatWithJohnDoe" in the AIM instant messaging field.
var contacts = ContactsApp.getContactsByIM('ChatWithJohnDoe',
                                            ContactsApp.Field.AIM);

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
query	String	สตริงที่จะค้นหาในที่อยู่การรับส่งข้อความโต้ตอบแบบทันทีของรายชื่อติดต่อ
label	Field	ช่องที่ควรค้นหาภายใน

รีเทิร์น

Contact[] — อาร์เรย์ของรายชื่อติดต่อที่ตรงกัน

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

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

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

ดูเพิ่มเติม

• getContact(emailAddress)

---

getContactsByIM(query, label)

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

รับรายชื่อติดต่อที่ตรงกับที่อยู่การรับส่งข้อความโต้ตอบแบบทันที โดยจำกัดไว้ที่ป้ายกำกับการรับส่งข้อความโต้ตอบแบบทันทีที่กำหนดเองที่ระบุไว้เท่านั้น

// The code below returns an array of contacts where the contact's instant messaging address
// contains "ChatWithJohnDoe" in a custom instant messaging label (created by the user) called
// "eBuddy".
var contacts = ContactsApp.getContactsByIM('ChatWithJohnDoe', 'eBuddy');

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
query	String	สตริงที่จะค้นหาในที่อยู่การรับส่งข้อความโต้ตอบแบบทันทีของรายชื่อติดต่อที่มีป้ายกำกับการรับส่งข้อความโต้ตอบแบบทันทีที่กำหนดเองที่ระบุไว้
label	String	ป้ายกำกับการรับส่งข้อความโต้ตอบแบบทันทีที่กำหนดเองเพื่อค้นหาภายใน

รีเทิร์น

Contact[] — อาร์เรย์ของรายชื่อติดต่อที่ตรงกัน

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

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

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

ดูเพิ่มเติม

• getContact(emailAddress)

---

getContactsByJobTitle(query)

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

รับรายชื่อติดต่อที่ตรงกับช่องตำแหน่งงาน

// The code below returns an array of contacts where the contact's job title field
// contains "Product Manager".
var contacts = ContactsApp.getContactsByJobTitle('Product Manager');

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
query	String	สตริงที่จะค้นหาในช่องตำแหน่งงานของรายชื่อติดต่อ

รีเทิร์น

Contact[] — อาร์เรย์ของรายชื่อติดต่อที่ตรงกัน

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

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

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

ดูเพิ่มเติม

• getContact(emailAddress)

---

getContactsByName(query)

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

รับรายชื่อติดต่อที่ตรงกับชื่อ

// The code below returns an array of contacts where the contact name contains "John"
var contacts = ContactsApp.getContactsByName('John');

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
query	String	สตริงที่จะค้นหาในชื่อผู้ติดต่อ

รีเทิร์น

Contact[] — อาร์เรย์ของรายชื่อติดต่อที่ตรงกัน

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

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

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

ดูเพิ่มเติม

• getContact(emailAddress)

---

getContactsByName(query, label)

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

รับรายชื่อติดต่อที่ตรงกับชื่อ จำกัดเฉพาะช่องที่ระบุ

// The code below returns an array of contacts where the contact name contains "John"
// in the Given Name field.
var contacts = ContactsApp.getContactsByName('John', ContactsApp.Field.GIVEN_NAME);

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
query	String	สตริงที่จะค้นหาในชื่อผู้ติดต่อ
label	Field	ช่องที่ควรค้นหาภายใน

รีเทิร์น

Contact[] — อาร์เรย์ของรายชื่อติดต่อที่ตรงกัน

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

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

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

ดูเพิ่มเติม

• getContact(emailAddress)

---

getContactsByNotes(query)

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

รับรายชื่อติดต่อที่ตรงกับช่องหมายเหตุ

// The code below returns an array of contacts where the contact's notes field
// contains "sent birthday card".
var contacts = ContactsApp.getContactsByNotes('sent birthday card');

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
query	String	สตริงที่ต้องการค้นหาในช่องบันทึกของรายชื่อติดต่อ

รีเทิร์น

Contact[] — อาร์เรย์ของรายชื่อติดต่อที่ตรงกัน

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

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

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

ดูเพิ่มเติม

• getContact(emailAddress)

---

getContactsByPhone(query)

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

เรียกรายชื่อติดต่อที่ตรงกับหมายเลขโทรศัพท์

วิธีนี้จะแสดงหมายเลขโทรศัพท์ที่เขียนได้ด้วยตัวอักษร ดังนั้นหากคุณค้นหา "212-555-CODE" และคุณมี "212-555-2633" ในรายชื่อติดต่อ หรือในทางกลับกัน วิธีนี้จะค้นหาผู้ติดต่อที่เหมาะสมได้

// The code below returns an array of contacts where the contact's phone number contains
// "212-555-1234' in any phone number field.
var contacts = ContactsApp.getContactsByPhone('212-555-1234');

พารามิเตอร์

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

รีเทิร์น

Contact[] — อาร์เรย์ของรายชื่อติดต่อที่ตรงกัน

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

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

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

ดูเพิ่มเติม

• getContact(emailAddress)

---

getContactsByPhone(query, label)

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

รับรายชื่อติดต่อที่ตรงกับหมายเลขโทรศัพท์ โดยจำกัดเฉพาะช่องบางช่อง

วิธีนี้จะแสดงหมายเลขโทรศัพท์ที่เขียนได้ด้วยตัวอักษร ดังนั้นหากคุณค้นหา "212-555-CODE" และคุณมี "212-555-2633" ในรายชื่อติดต่อ หรือในทางกลับกัน วิธีนี้จะค้นหาผู้ติดต่อที่เหมาะสมได้

// The code below returns an array of contacts where the contact's phone number contains
// "212-555-1234" in the Home phone number field.
var contacts = ContactsApp.getContactsByPhone('212-555-1234',
                                              ContactsApp.Field.HOME_PHONE);

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
query	String	สตริงที่จะค้นหาในหมายเลขโทรศัพท์ของรายชื่อติดต่อ
label	Field	ช่องที่ควรค้นหาภายใน

รีเทิร์น

Contact[] — อาร์เรย์ของรายชื่อติดต่อที่ตรงกัน

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

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

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

ดูเพิ่มเติม

• getContact(emailAddress)

---

getContactsByPhone(query, label)

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

เรียกรายชื่อติดต่อที่ตรงกับหมายเลขโทรศัพท์ โดยจำกัดเฉพาะป้ายกำกับหมายเลขโทรศัพท์ที่กำหนดเองที่ระบุ

วิธีนี้จะแสดงหมายเลขโทรศัพท์ที่เขียนได้ด้วยตัวอักษร ดังนั้นหากคุณค้นหา "212-555-CODE" และคุณมี "212-555-2633" ในรายชื่อติดต่อ หรือในทางกลับกัน วิธีนี้จะค้นหาผู้ติดต่อที่เหมาะสมได้

// The code below returns an array of contacts where the contact's phone number contains
// "212-555-1234" in a custom phone number label (created by the user) called
// "alternate".
var contacts = ContactsApp.getContactsByPhone('212-555-1234', 'alternate');

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
query	String	สตริงที่จะค้นหาในหมายเลขโทรศัพท์ของผู้ติดต่อพร้อมป้ายกำกับ หมายเลขโทรศัพท์ที่กำหนดเองที่ระบุ
label	String	ป้ายกำกับหมายเลขโทรศัพท์ที่กำหนดเองเพื่อค้นหาภายใน

รีเทิร์น

Contact[] — อาร์เรย์ของรายชื่อติดต่อที่ตรงกัน

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

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

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

ดูเพิ่มเติม

• getContact(emailAddress)

---

getContactsByUrl(query)

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

รับรายชื่อติดต่อที่ตรงกับ URL

// The code below returns an array of contacts where the contact's URL contains
// "www.example.com' in any URL field.
var contacts = ContactsApp.getContactsByUrl('www.example.com');

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
query	String	สตริงที่ต้องการค้นหาใน URL ของรายชื่อติดต่อ

รีเทิร์น

Contact[] — อาร์เรย์ของรายชื่อติดต่อที่ตรงกัน

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

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

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

ดูเพิ่มเติม

• getContact(emailAddress)

---

getContactsByUrl(query, label)

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

รับรายชื่อติดต่อที่ตรงกับ URL ที่จำกัดไว้เพียงช่องเดียว

// The code below returns an array of contacts where the contact's URL contains
// "www.example.com" in the Work URL field.
var contacts = ContactsApp.getContactsByUrl('www.example.com',
                                            ContactsApp.Field.WORK_WEBSITE);

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
query	String	สตริงที่ต้องการค้นหาใน URL ของรายชื่อติดต่อ
label	Field	ช่องที่ควรค้นหาภายใน

รีเทิร์น

Contact[] — อาร์เรย์ของรายชื่อติดต่อที่ตรงกัน

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

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

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

ดูเพิ่มเติม

• getContact(emailAddress)

---

getContactsByUrl(query, label)

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

รับรายชื่อติดต่อที่ตรงกับ URL ซึ่งจำกัดไว้ที่ป้ายกำกับ URL ที่กำหนดเองที่ระบุ

// The code below returns an array of contacts where the contact's URL contains
// "www.example.com" in a custom URL label (created by the user) called
// "alternate work".
var contacts = ContactsApp.getContactsByUrl('www.example.com', 'alternate work');

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
query	String	สตริงที่จะค้นหาใน URL ของรายชื่อติดต่อที่มีป้ายกำกับ URL ที่กำหนดเองที่ระบุ
label	String	ป้ายกำกับ URL ที่กำหนดเองเพื่อค้นหาภายใน

รีเทิร์น

Contact[] — อาร์เรย์ของรายชื่อติดต่อที่ตรงกัน

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

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

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

ดูเพิ่มเติม

• getContact(emailAddress)