Class ContactsApp

ContactsApp

Không dùng nữa. Thay vào đó, hãy sử dụng dịch vụ nâng cao về API Mọi người

Lớp này cho phép người dùng truy cập vào Danh bạ Google của chính họ cũng như tạo, xoá và cập nhật các mục liên hệ được liệt kê trong đó.

Thuộc tính không dùng nữa

Tài sản	Loại	Nội dung mô tả
ExtendedField	ExtendedField
Field	Field
Gender	Gender
Month	Month
Priority	Priority
Sensitivity	Sensitivity

Các phương thức ngừng hoạt động

Phương thức	Kiểu dữ liệu trả về	Mô tả ngắn
createContact(givenName, familyName, email)	Contact	Tạo một mục liên hệ mới.
createContactGroup(name)	ContactGroup	Tạo một nhóm người liên hệ bằng tên đã cho
deleteContact(contact)	void	Xoá mục liên hệ.
deleteContactGroup(group)	void	Xoá nhóm người liên hệ
findByEmailAddress(email)	Contact	Tìm một Người liên hệ có địa chỉ email đã cho.
findContactGroup(name)	ContactGroup	Tìm một nhóm người liên hệ có tên đã cung cấp.
getAllContacts()	Contact[]	Lấy tất cả thông tin liên hệ của người dùng này.
getContact(emailAddress)	Contact	Lấy thông tin liên hệ theo địa chỉ email.
getContactById(id)	Contact	Lấy thông tin liên hệ có mã nhận dạng này.
getContactGroup(name)	ContactGroup	Lấy một nhóm người liên hệ có tên đã cho, hoặc trả về giá trị rỗng nếu không tìm thấy nhóm người liên hệ đó.
getContactGroupById(id)	ContactGroup	Lấy một nhóm người liên hệ có mã nhận dạng đã cho hoặc trả về giá trị rỗng nếu không tìm thấy nhóm người liên hệ đó.
getContactGroups()	ContactGroup[]	Lấy danh sách đầy đủ các nhóm liên hệ của người dùng.
getContacts()	Contact[]	Lấy tất cả danh bạ của người dùng.
getContactsByAddress(query)	Contact[]	Xem danh bạ khớp với một địa chỉ.
getContactsByAddress(query, label)	Contact[]	Lấy danh bạ khớp với một địa chỉ, giới hạn trong một trường cụ thể.
getContactsByAddress(query, label)	Contact[]	Tải danh bạ khớp với một địa chỉ, giới hạn trong nhãn địa chỉ tuỳ chỉnh đã chỉ định.
getContactsByCompany(query)	Contact[]	Lấy danh bạ khớp với trường công ty.
getContactsByCustomField(query, label)	Contact[]	Nhận danh bạ khớp với một giá trị đã cho trong trường tuỳ chỉnh.
getContactsByDate(month, day, label)	Contact[]	Xem danh bạ khớp với một ngày và tháng cụ thể trong một trường tiêu chuẩn cụ thể.
getContactsByDate(month, day, year, label)	Contact[]	Lấy thông tin liên hệ khớp với một ngày, tháng và năm cụ thể cho một trường tiêu chuẩn cụ thể.
getContactsByDate(month, day, year, label)	Contact[]	Lấy thông tin liên hệ khớp với ngày, tháng và năm cụ thể cho một trường tuỳ chỉnh cụ thể.
getContactsByDate(month, day, label)	Contact[]	Nhận thông tin liên hệ khớp với một ngày và tháng cụ thể cho một trường tùy chỉnh cụ thể.
getContactsByEmailAddress(query)	Contact[]	Xem danh bạ khớp với một địa chỉ email.
getContactsByEmailAddress(query, label)	Contact[]	Lấy danh bạ khớp với một địa chỉ email, giới hạn trong một trường cụ thể.
getContactsByEmailAddress(query, label)	Contact[]	Lấy danh sách liên hệ khớp với một địa chỉ email, giới hạn ở nhãn địa chỉ email tuỳ chỉnh đã chỉ định.
getContactsByGroup(group)	Contact[]	Lấy danh bạ trong một ContactGroup nhất định.
getContactsByIM(query)	Contact[]	Tìm địa chỉ liên hệ phù hợp với địa chỉ nhắn tin nhanh.
getContactsByIM(query, label)	Contact[]	Nhận địa chỉ liên hệ khớp với địa chỉ nhắn tin nhanh, được giới hạn trong một trường cụ thể.
getContactsByIM(query, label)	Contact[]	Nhận các địa chỉ liên hệ khớp với địa chỉ nhắn tin nhanh, giới hạn với nhãn nhắn tin nhanh tuỳ chỉnh đã chỉ định.
getContactsByJobTitle(query)	Contact[]	Lấy thông tin liên hệ phù hợp với trường chức danh.
getContactsByName(query)	Contact[]	Lấy danh bạ khớp với tên.
getContactsByName(query, label)	Contact[]	Tải danh bạ khớp với tên, giới hạn trong một trường cụ thể.
getContactsByNotes(query)	Contact[]	Tìm danh bạ khớp với trường ghi chú.
getContactsByPhone(query)	Contact[]	Xem danh bạ khớp với một số điện thoại.
getContactsByPhone(query, label)	Contact[]	Lấy danh bạ khớp với một số điện thoại, giới hạn trong một trường cụ thể.
getContactsByPhone(query, label)	Contact[]	Tải danh bạ khớp với một số điện thoại, giới hạn ở nhãn số điện thoại tuỳ chỉnh đã chỉ định.
getContactsByUrl(query)	Contact[]	Lấy danh bạ khớp với một URL.
getContactsByUrl(query, label)	Contact[]	Lấy danh bạ khớp với một URL, giới hạn trong một trường cụ thể.
getContactsByUrl(query, label)	Contact[]	Lấy danh bạ khớp với một URL, giới hạn theo nhãn URL tuỳ chỉnh đã chỉ định.

Các phương thức ngừng hoạt động

createContact(givenName, familyName, email)

Không dùng nữa. Hàm này không còn được dùng nữa và không nên dùng trong tập lệnh mới.

Tạo một mục liên hệ mới.

// 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]');

Các tham số

Tên	Loại	Nội dung mô tả
givenName	String	tên của người liên hệ
familyName	String	họ của người liên hệ
email	String	địa chỉ email của người liên hệ

Cầu thủ trả bóng

Contact – đối tượng Danh bạ mới được tạo

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

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

Xem thêm

• deleteContact(contact)

---

createContactGroup(name)

Không dùng nữa. Hàm này không còn được dùng nữa và không nên dùng trong tập lệnh mới.

Tạo một nhóm người liên hệ bằng tên đã cho

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

Các tham số

Tên	Loại	Nội dung mô tả
name	String	tên của nhóm người liên hệ mới

Cầu thủ trả bóng

ContactGroup — nhóm liên hệ mới được tạo

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

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

Xem thêm

• deleteContactGroup(group)

---

deleteContact(contact)

Không dùng nữa. Hàm này không còn được dùng nữa và không nên dùng trong tập lệnh mới.

Xoá mục liên hệ.

// 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);

Các tham số

Tên	Loại	Nội dung mô tả
contact	Contact	người liên hệ cần xoá

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

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

Xem thêm

• createContact(givenName, familyName, email)

---

deleteContactGroup(group)

Không dùng nữa. Hàm này không còn được dùng nữa và không nên dùng trong tập lệnh mới.

Xoá nhóm người liên hệ

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

Các tham số

Tên	Loại	Nội dung mô tả
group	ContactGroup	nhóm người liên hệ cần xoá

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

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

Xem thêm

• createContactGroup(name)

---

findByEmailAddress(email)

Không dùng nữa. Hàm này không còn được dùng nữa và không nên dùng trong tập lệnh mới.

Tìm một Người liên hệ có địa chỉ email đã cho.

Các tham số

Tên	Loại	Nội dung mô tả
email	String	địa chỉ email của người liên hệ cần tìm

Cầu thủ trả bóng

Contact — Người liên hệ chứa địa chỉ email đó

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

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

---

findContactGroup(name)

Không dùng nữa. Hàm này không còn được dùng nữa và không nên dùng trong tập lệnh mới.

Tìm một nhóm người liên hệ có tên đã cung cấp.

Các tham số

Tên	Loại	Nội dung mô tả
name	String	tên của nhóm người liên hệ cần tìm

Cầu thủ trả bóng

ContactGroup — nhóm liên hệ khớp với tên đã nêu

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

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

---

getAllContacts()

Không dùng nữa. Hàm này không còn được dùng nữa và không nên dùng trong tập lệnh mới.

Lấy tất cả thông tin liên hệ của người dùng này.

Cầu thủ trả bóng

Contact[] — tất cả địa chỉ liên hệ của người dùng này

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

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

---

getContact(emailAddress)

Không dùng nữa. Hàm này không còn được dùng nữa và không nên dùng trong tập lệnh mới.

Lấy thông tin liên hệ theo địa chỉ email.

Nếu nhiều liên hệ có cùng địa chỉ email, phương thức này sẽ ưu tiên các liên hệ đã đánh dấu địa chỉ email là chính; nếu không có liên hệ nào có địa chỉ email được đánh dấu là chính hoặc nhiều liên hệ có địa chỉ email được đánh dấu là chính, thì phương thức này sẽ trả về kết quả đầu tiên theo thứ tự liên hệ được sắp xếp.

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

Các tham số

Tên	Loại	Nội dung mô tả
emailAddress	String	địa chỉ email của người liên hệ

Cầu thủ trả bóng

Contact — người liên hệ có chứa địa chỉ email đó

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

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

Xem thêm

• getContacts()
• getContactById(id)

---

getContactById(id)

Không dùng nữa. Hàm này không còn được dùng nữa và không nên dùng trong tập lệnh mới.

Lấy thông tin liên hệ có mã nhận dạng này.

// 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);

Các tham số

Tên	Loại	Nội dung mô tả
id	String	mã nhận dạng của người liên hệ cần truy xuất

Cầu thủ trả bóng

Contact – người liên hệ trùng khớp hoặc giá trị rỗng

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

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

Xem thêm

• getContact(emailAddress)

---

getContactGroup(name)

Không dùng nữa. Hàm này không còn được dùng nữa và không nên dùng trong tập lệnh mới.

Lấy một nhóm người liên hệ có tên đã cho, hoặc trả về giá trị rỗng nếu không tìm thấy nhóm người liên hệ đó.

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

Các tham số

Tên	Loại	Nội dung mô tả
name	String	tên của nhóm người liên hệ để so khớp

Cầu thủ trả bóng

ContactGroup — nhóm người liên hệ trùng khớp hoặc để trống nếu không tìm thấy nhóm người liên hệ nào phù hợp

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

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

Xem thêm

• getContactGroups()

---

getContactGroupById(id)

Không dùng nữa. Hàm này không còn được dùng nữa và không nên dùng trong tập lệnh mới.

Lấy một nhóm người liên hệ có mã nhận dạng đã cho hoặc trả về giá trị rỗng nếu không tìm thấy nhóm người liên hệ đó.

// 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);

Các tham số

Tên	Loại	Nội dung mô tả
id	String	mã nhận dạng của nhóm người liên hệ cần so khớp

Cầu thủ trả bóng

ContactGroup — nhóm người liên hệ trùng khớp hoặc để trống nếu không tìm thấy nhóm người liên hệ nào phù hợp

Xem thêm

• getContactGroups()

---

getContactGroups()

Không dùng nữa. Hàm này không còn được dùng nữa và không nên dùng trong tập lệnh mới.

Lấy danh sách đầy đủ các nhóm liên hệ của người dùng.

Người dùng có thể có danh sách Liên hệ và cũng có thể có cả danh sách Nhóm liên hệ. Mỗi Nhóm liên hệ có thể chứa nhiều Người liên hệ. Phương thức này trả về danh sách tất cả các Nhóm liên hệ.

// 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());
}

Cầu thủ trả bóng

ContactGroup[] – một mảng gồm các nhóm liên hệ của người dùng

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

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

Xem thêm

• getContactGroup(name)

---

getContacts()

Không dùng nữa. Hàm này không còn được dùng nữa và không nên dùng trong tập lệnh mới.

Lấy tất cả danh bạ của người dùng.

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

Cầu thủ trả bóng

Contact[] – một mảng gồm tất cả địa chỉ liên hệ của người dùng

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

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

Xem thêm

• getContact(emailAddress)

---

getContactsByAddress(query)

Không dùng nữa. Hàm này không còn được dùng nữa và không nên dùng trong tập lệnh mới.

Xem danh bạ khớp với một địa chỉ.

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

Các tham số

Tên	Loại	Nội dung mô tả
query	String	chuỗi để tìm kiếm trong địa chỉ của người liên hệ

Cầu thủ trả bóng

Contact[] – một mảng gồm các địa chỉ liên hệ phù hợp

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

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

Xem thêm

• getContact(emailAddress)

---

getContactsByAddress(query, label)

Không dùng nữa. Hàm này không còn được dùng nữa và không nên dùng trong tập lệnh mới.

Lấy danh bạ khớp với một địa chỉ, giới hạn trong một trường cụ thể.

// 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);

Các tham số

Tên	Loại	Nội dung mô tả
query	String	chuỗi để tìm kiếm trong địa chỉ của người liên hệ
label	Field	trường để tìm kiếm trong

Cầu thủ trả bóng

Contact[] – một mảng gồm các địa chỉ liên hệ phù hợp

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

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

Xem thêm

• getContact(emailAddress)

---

getContactsByAddress(query, label)

Không dùng nữa. Hàm này không còn được dùng nữa và không nên dùng trong tập lệnh mới.

Tải danh bạ khớp với một địa chỉ, giới hạn trong nhãn địa chỉ tuỳ chỉnh đã chỉ định.

// 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');

Các tham số

Tên	Loại	Nội dung mô tả
query	String	chuỗi để tìm kiếm trong địa chỉ của người liên hệ bằng nhãn địa chỉ tùy chỉnh được chỉ định
label	String	nhãn địa chỉ tuỳ chỉnh để tìm kiếm trong

Cầu thủ trả bóng

Contact[] – một mảng gồm các địa chỉ liên hệ phù hợp

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

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

Xem thêm

• getContact(emailAddress)

---

getContactsByCompany(query)

Không dùng nữa. Hàm này không còn được dùng nữa và không nên dùng trong tập lệnh mới.

Lấy danh bạ khớp với trường công ty.

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

Các tham số

Tên	Loại	Nội dung mô tả
query	String	chuỗi để tìm kiếm trong trường công ty của người liên hệ

Cầu thủ trả bóng

Contact[] – một mảng gồm các địa chỉ liên hệ phù hợp

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

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

Xem thêm

• getContact(emailAddress)

---

getContactsByCustomField(query, label)

Không dùng nữa. Hàm này không còn được dùng nữa và không nên dùng trong tập lệnh mới.

Nhận danh bạ khớp với một giá trị đã cho trong trường tuỳ chỉnh.

Bạn có thể chỉ định trường tuỳ chỉnh bằng một Chuỗi hoặc một trong các giá trị 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');

Các tham số

Tên	Loại	Nội dung mô tả
query	Object	chuỗi để tìm trong trường tuỳ chỉnh của người liên hệ
label	ExtendedField	trường tuỳ chỉnh để tìm kiếm

Cầu thủ trả bóng

Contact[] – một mảng gồm các địa chỉ liên hệ phù hợp

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

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

Xem thêm

• getContact(emailAddress)

---

getContactsByDate(month, day, label)

Không dùng nữa. Hàm này không còn được dùng nữa và không nên dùng trong tập lệnh mới.

Xem danh bạ khớp với một ngày và tháng cụ thể trong một trường tiêu chuẩn cụ thể.

// 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);

Các tham số

Tên	Loại	Nội dung mô tả
month	Month	tháng phù hợp, dưới dạng một trong các giá trị từ ContactsApp.Month
day	Integer	ngày để so khớp
label	Field	trường cần tìm kiếm trong đó, từ ContactsApp.Field

Cầu thủ trả bóng

Contact[] – một mảng gồm các địa chỉ liên hệ phù hợp

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

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

Xem thêm

• getContact(emailAddress)

---

getContactsByDate(month, day, year, label)

Không dùng nữa. Hàm này không còn được dùng nữa và không nên dùng trong tập lệnh mới.

Lấy thông tin liên hệ khớp với một ngày, tháng và năm cụ thể cho một trường tiêu chuẩn cụ thể.

// 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);

Các tham số

Tên	Loại	Nội dung mô tả
month	Month	tháng phù hợp, dưới dạng một trong các giá trị từ ContactsApp.Month
day	Integer	ngày để so khớp
year	Integer	năm trùng khớp, có thể rỗng
label	Field	trường cần tìm kiếm trong đó, từ ContactsApp.Field

Cầu thủ trả bóng

Contact[] – một mảng gồm các địa chỉ liên hệ phù hợp

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

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

Xem thêm

• getContact(emailAddress)

---

getContactsByDate(month, day, year, label)

Không dùng nữa. Hàm này không còn được dùng nữa và không nên dùng trong tập lệnh mới.

Lấy thông tin liên hệ khớp với ngày, tháng và năm cụ thể cho một trường tuỳ chỉnh cụ thể.

// 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');

Các tham số

Tên	Loại	Nội dung mô tả
month	Month	tháng phù hợp, dưới dạng một trong các giá trị từ ContactsApp.Month
day	Integer	ngày để so khớp
year	Integer	năm trùng khớp, có thể rỗng
label	String	trường tuỳ chỉnh để tìm kiếm

Cầu thủ trả bóng

Contact[] – một mảng gồm các địa chỉ liên hệ phù hợp

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

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

Xem thêm

• getContact(emailAddress)

---

getContactsByDate(month, day, label)

Không dùng nữa. Hàm này không còn được dùng nữa và không nên dùng trong tập lệnh mới.

Nhận thông tin liên hệ khớp với một ngày và tháng cụ thể cho một trường tùy chỉnh cụ thể.

// 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');

Các tham số

Tên	Loại	Nội dung mô tả
month	Month	tháng phù hợp, dưới dạng một trong các giá trị từ ContactsApp.Month
day	Integer	ngày để so khớp
label	String	trường tuỳ chỉnh để tìm kiếm

Cầu thủ trả bóng

Contact[] – một mảng gồm các địa chỉ liên hệ phù hợp

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

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

Xem thêm

• getContact(emailAddress)

---

getContactsByEmailAddress(query)

Không dùng nữa. Hàm này không còn được dùng nữa và không nên dùng trong tập lệnh mới.

Xem danh bạ khớp với một địa chỉ email.

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

Các tham số

Tên	Loại	Nội dung mô tả
query	String	chuỗi để tìm kiếm trong địa chỉ email liên hệ

Cầu thủ trả bóng

Contact[] – một mảng gồm các địa chỉ liên hệ phù hợp

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

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

Xem thêm

• getContact(emailAddress)

---

getContactsByEmailAddress(query, label)

Không dùng nữa. Hàm này không còn được dùng nữa và không nên dùng trong tập lệnh mới.

Lấy danh bạ khớp với một địa chỉ email, giới hạn trong một trường cụ thể.

// 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);

Các tham số

Tên	Loại	Nội dung mô tả
query	String	chuỗi để tìm kiếm trong địa chỉ email liên hệ
label	Field	trường để tìm kiếm trong

Cầu thủ trả bóng

Contact[] – một mảng gồm các địa chỉ liên hệ phù hợp

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

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

Xem thêm

• getContact(emailAddress)

---

getContactsByEmailAddress(query, label)

Không dùng nữa. Hàm này không còn được dùng nữa và không nên dùng trong tập lệnh mới.

Lấy danh sách liên hệ khớp với một địa chỉ email, giới hạn ở nhãn địa chỉ email tuỳ chỉnh đã chỉ định.

// 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');

Các tham số

Tên	Loại	Nội dung mô tả
query	String	chuỗi để tìm kiếm trong địa chỉ email liên hệ có nhãn địa chỉ email tùy chỉnh đã chỉ định
label	String	nhãn địa chỉ email tuỳ chỉnh để tìm kiếm trong

Cầu thủ trả bóng

Contact[] – một mảng gồm các địa chỉ liên hệ phù hợp

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

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

Xem thêm

• getContact(emailAddress)

---

getContactsByGroup(group)

Không dùng nữa. Hàm này không còn được dùng nữa và không nên dùng trong tập lệnh mới.

Lấy danh bạ trong một ContactGroup nhất định.

// 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);

Các tham số

Tên	Loại	Nội dung mô tả
group	ContactGroup	nhóm người liên hệ

Cầu thủ trả bóng

Contact[] – một mảng địa chỉ liên hệ trong nhóm đã cho

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

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

Xem thêm

• getContact(emailAddress)

---

getContactsByIM(query)

Không dùng nữa. Hàm này không còn được dùng nữa và không nên dùng trong tập lệnh mới.

Tìm địa chỉ liên hệ phù hợp với địa chỉ nhắn tin nhanh.

// 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');

Các tham số

Tên	Loại	Nội dung mô tả
query	String	chuỗi để tìm kiếm trong địa chỉ nhắn tin nhanh của người liên hệ

Cầu thủ trả bóng

Contact[] – một mảng gồm các địa chỉ liên hệ phù hợp

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

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

Xem thêm

• getContact(emailAddress)

---

getContactsByIM(query, label)

Không dùng nữa. Hàm này không còn được dùng nữa và không nên dùng trong tập lệnh mới.

Nhận địa chỉ liên hệ khớp với địa chỉ nhắn tin nhanh, được giới hạn trong một trường cụ thể.

// 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);

Các tham số

Tên	Loại	Nội dung mô tả
query	String	chuỗi để tìm kiếm trong địa chỉ nhắn tin nhanh của người liên hệ
label	Field	trường để tìm kiếm trong

Cầu thủ trả bóng

Contact[] – một mảng gồm các địa chỉ liên hệ phù hợp

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

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

Xem thêm

• getContact(emailAddress)

---

getContactsByIM(query, label)

Không dùng nữa. Hàm này không còn được dùng nữa và không nên dùng trong tập lệnh mới.

Nhận các địa chỉ liên hệ khớp với địa chỉ nhắn tin nhanh, giới hạn với nhãn nhắn tin nhanh tuỳ chỉnh đã chỉ định.

// 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');

Các tham số

Tên	Loại	Nội dung mô tả
query	String	chuỗi để tìm kiếm địa chỉ nhắn tin nhanh của người liên hệ với nhãn nhắn tin nhanh tùy chỉnh được chỉ định
label	String	nhãn nhắn tin nhanh tuỳ chỉnh để tìm kiếm trong

Cầu thủ trả bóng

Contact[] – một mảng gồm các địa chỉ liên hệ phù hợp

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

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

Xem thêm

• getContact(emailAddress)

---

getContactsByJobTitle(query)

Không dùng nữa. Hàm này không còn được dùng nữa và không nên dùng trong tập lệnh mới.

Lấy thông tin liên hệ phù hợp với trường chức danh.

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

Các tham số

Tên	Loại	Nội dung mô tả
query	String	chuỗi để tìm kiếm trong trường chức danh của người liên hệ

Cầu thủ trả bóng

Contact[] – một mảng gồm các địa chỉ liên hệ phù hợp

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

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

Xem thêm

• getContact(emailAddress)

---

getContactsByName(query)

Không dùng nữa. Hàm này không còn được dùng nữa và không nên dùng trong tập lệnh mới.

Lấy danh bạ khớp với tên.

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

Các tham số

Tên	Loại	Nội dung mô tả
query	String	chuỗi để tìm trong tên người liên hệ

Cầu thủ trả bóng

Contact[] – một mảng gồm các địa chỉ liên hệ phù hợp

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

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

Xem thêm

• getContact(emailAddress)

---

getContactsByName(query, label)

Không dùng nữa. Hàm này không còn được dùng nữa và không nên dùng trong tập lệnh mới.

Tải danh bạ khớp với tên, giới hạn trong một trường cụ thể.

// 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);

Các tham số

Tên	Loại	Nội dung mô tả
query	String	chuỗi để tìm trong tên người liên hệ
label	Field	trường để tìm kiếm trong

Cầu thủ trả bóng

Contact[] – một mảng gồm các địa chỉ liên hệ phù hợp

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

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

Xem thêm

• getContact(emailAddress)

---

getContactsByNotes(query)

Không dùng nữa. Hàm này không còn được dùng nữa và không nên dùng trong tập lệnh mới.

Tìm danh bạ khớp với trường ghi chú.

// 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');

Các tham số

Tên	Loại	Nội dung mô tả
query	String	chuỗi để tìm trong trường ghi chú của người liên hệ

Cầu thủ trả bóng

Contact[] – một mảng gồm các địa chỉ liên hệ phù hợp

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

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

Xem thêm

• getContact(emailAddress)

---

getContactsByPhone(query)

Không dùng nữa. Hàm này không còn được dùng nữa và không nên dùng trong tập lệnh mới.

Xem danh bạ khớp với một số điện thoại.

Phương thức này sẽ mở rộng các số điện thoại ở dạng chữ cái, vì vậy, nếu bạn tìm kiếm "212-555-CODE" và danh bạ của mình có "212-555-2633" hoặc ngược lại, thì phương thức này sẽ tìm người liên hệ phù hợp.

// 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');

Các tham số

Tên	Loại	Nội dung mô tả
query	String	chuỗi để tìm kiếm trong số điện thoại của người liên hệ

Cầu thủ trả bóng

Contact[] – một mảng gồm các địa chỉ liên hệ phù hợp

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

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

Xem thêm

• getContact(emailAddress)

---

getContactsByPhone(query, label)

Không dùng nữa. Hàm này không còn được dùng nữa và không nên dùng trong tập lệnh mới.

Lấy danh bạ khớp với một số điện thoại, giới hạn trong một trường cụ thể.

Phương thức này sẽ mở rộng các số điện thoại ở dạng chữ cái, vì vậy, nếu bạn tìm kiếm "212-555-CODE" và danh bạ của mình có "212-555-2633" hoặc ngược lại, thì phương thức này sẽ tìm người liên hệ phù hợp.

// 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);

Các tham số

Tên	Loại	Nội dung mô tả
query	String	chuỗi để tìm kiếm trong số điện thoại của người liên hệ
label	Field	trường để tìm kiếm trong

Cầu thủ trả bóng

Contact[] – một mảng gồm các địa chỉ liên hệ phù hợp

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

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

Xem thêm

• getContact(emailAddress)

---

getContactsByPhone(query, label)

Không dùng nữa. Hàm này không còn được dùng nữa và không nên dùng trong tập lệnh mới.

Tải danh bạ khớp với một số điện thoại, giới hạn ở nhãn số điện thoại tuỳ chỉnh đã chỉ định.

Phương thức này sẽ mở rộng các số điện thoại ở dạng chữ cái, vì vậy, nếu bạn tìm kiếm "212-555-CODE" và danh bạ của mình có "212-555-2633" hoặc ngược lại, thì phương thức này sẽ tìm người liên hệ phù hợp.

// 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');

Các tham số

Tên	Loại	Nội dung mô tả
query	String	chuỗi để tìm kiếm trong số điện thoại của người liên hệ với nhãn số điện thoại tùy chỉnh được chỉ định
label	String	nhãn số điện thoại tùy chỉnh để tìm kiếm trong

Cầu thủ trả bóng

Contact[] – một mảng gồm các địa chỉ liên hệ phù hợp

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

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

Xem thêm

• getContact(emailAddress)

---

getContactsByUrl(query)

Không dùng nữa. Hàm này không còn được dùng nữa và không nên dùng trong tập lệnh mới.

Lấy danh bạ khớp với một 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');

Các tham số

Tên	Loại	Nội dung mô tả
query	String	chuỗi để tìm kiếm trong URL của người liên hệ

Cầu thủ trả bóng

Contact[] – một mảng gồm các địa chỉ liên hệ phù hợp

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

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

Xem thêm

• getContact(emailAddress)

---

getContactsByUrl(query, label)

Không dùng nữa. Hàm này không còn được dùng nữa và không nên dùng trong tập lệnh mới.

Lấy danh bạ khớp với một URL, giới hạn trong một trường cụ thể.

// 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);

Các tham số

Tên	Loại	Nội dung mô tả
query	String	chuỗi để tìm kiếm trong URL của người liên hệ
label	Field	trường để tìm kiếm trong

Cầu thủ trả bóng

Contact[] – một mảng gồm các địa chỉ liên hệ phù hợp

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

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

Xem thêm

• getContact(emailAddress)

---

getContactsByUrl(query, label)

Không dùng nữa. Hàm này không còn được dùng nữa và không nên dùng trong tập lệnh mới.

Lấy danh bạ khớp với một URL, giới hạn theo nhãn URL tuỳ chỉnh đã chỉ định.

// 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');

Các tham số

Tên	Loại	Nội dung mô tả
query	String	chuỗi để tìm kiếm trong URL của người liên hệ bằng nhãn URL tùy chỉnh được chỉ định
label	String	nhãn URL tùy chỉnh để tìm kiếm trong

Cầu thủ trả bóng

Contact[] – một mảng gồm các địa chỉ liên hệ phù hợp

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

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

Xem thêm

• getContact(emailAddress)