Trang này được dịch bởi Cloud Translation API.

Class ContactsApp

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

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

Các thuộc tính không dùng nữa

Thuộc tính	Loại	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	Loại dữ liệu trả về	Mô tả ngắn
`createContact(givenName, familyName, email)`	`Contact`	Tạo một người liên hệ mới.
`createContactGroup(name)`	`ContactGroup`	Tạo nhóm người liên hệ có tên đã cho
`deleteContact(contact)`	`void`	Xoá người 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ủa tên được đặt.
`getAllContacts()`	`Contact[]`	Lấy tất cả danh bạ của người dùng này.
`getContact(emailAddress)`	`Contact`	Xem người 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 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 liên hệ nào như vậy.
`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 liên hệ nào như vậy.
`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ả thông tin liên hệ của người dùng.
`getContactsByAddress(query)`	`Contact[]`	Tải danh bạ khớp với địa chỉ.
`getContactsByAddress(query, label)`	`Contact[]`	Tải danh bạ khớp với địa chỉ, giới hạn trong một trường cụ thể.
`getContactsByAddress(query, label)`	`Contact[]`	Nhận địa chỉ liên hệ khớp với địa chỉ, giới hạn ở nhãn địa chỉ tùy chỉnh đã chỉ định.
`getContactsByCompany(query)`	`Contact[]`	Tải thông tin liên hệ khớp với trường công ty.
`getContactsByCustomField(query, label)`	`Contact[]`	Tải thông tin người liên hệ khớp với một giá trị đã cho trong trường tuỳ chỉnh.
`getContactsByDate(month, day, label)`	`Contact[]`	Tải địa chỉ liên hệ khớp với ngày và tháng cụ thể cho một trường tiêu chuẩn cụ thể.
`getContactsByDate(month, day, year, label)`	`Contact[]`	Nhận thông tin liên hệ khớp với tháng, ngày và năm cụ thể cho một trường tiêu chuẩn cụ thể.
`getContactsByDate(month, day, year, label)`	`Contact[]`	Nhận thông tin liên hệ khớp với tháng, ngày và năm cụ thể cho một trường tùy chỉnh cụ thể.
`getContactsByDate(month, day, label)`	`Contact[]`	Nhận người liên hệ khớp với ngày và tháng cụ thể cho một trường tuỳ chỉnh cụ thể.
`getContactsByEmailAddress(query)`	`Contact[]`	Tải danh bạ khớp với địa chỉ email.
`getContactsByEmailAddress(query, label)`	`Contact[]`	Tải danh bạ khớp với địa chỉ email, giới hạn trong một trường cụ thể.
`getContactsByEmailAddress(query, label)`	`Contact[]`	Nhận các địa chỉ liên hệ khớp với địa chỉ email, giới hạn ở nhãn địa chỉ email tùy chỉnh đã chỉ định.
`getContactsByGroup(group)`	`Contact[]`	Lấy danh bạ trong một ContactGroup nhất định.
`getContactsByIM(query)`	`Contact[]`	Tìm người liên hệ khớp với địa chỉ nhắn tin nhanh.
`getContactsByIM(query, label)`	`Contact[]`	Bạn có thể thiết lập danh bạ khớp với địa chỉ nhắn tin nhanh, chỉ áp dụng cho một trường cụ thể.
`getContactsByIM(query, label)`	`Contact[]`	Nhận danh bạ khớp với địa chỉ nhắn tin nhanh, giới hạn trong ứng dụng tức thì tuỳ chỉnh được chỉ định nhãn nhắn tin.
`getContactsByJobTitle(query)`	`Contact[]`	Tìm thông tin liên hệ khớp với trường chức danh.
`getContactsByName(query)`	`Contact[]`	Tải danh bạ khớp với tên.
`getContactsByName(query, label)`	`Contact[]`	Tải danh bạ trùng khớp với tên, giới hạn trong một trường cụ thể.
`getContactsByNotes(query)`	`Contact[]`	Tìm người liên hệ khớp với trường ghi chú.
`getContactsByPhone(query)`	`Contact[]`	Tìm người liên hệ khớp với số điện thoại.
`getContactsByPhone(query, label)`	`Contact[]`	Tải danh bạ khớp với 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[]`	Tải danh bạ khớp với URL.
`getContactsByUrl(query, label)`	`Contact[]`	Tải danh bạ khớp với URL, giới hạn trong một trường cụ thể.
`getContactsByUrl(query, label)`	`Contact[]`	Nhận các địa chỉ liên hệ khớp với một URL, giới hạn ở nhãn URL tùy 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 dùng nữa và không nên dùng trong các tập lệnh mới.

Tạo một người liên hệ mới.

// The code below creates a new contact with the name "John Doe" and the email address
// "john.doe@example.com".
var contact = ContactsApp.createContact('John', 'Doe', 'john.doe@example.com');

Tham số

Tên	Loại	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 Địa chỉ liên hệ mới được tạo

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy 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 dùng nữa và không nên dùng trong các tập lệnh mới.

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

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

Tham số

Tên	Loại	Mô tả
`name`	`String`	tên của nhóm 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 yêu cầu ủy 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 dùng nữa và không nên dùng trong các tập lệnh mới.

Xoá người liên hệ đó.

// The code below retrieves a contact with the email address "john.doe@example.com"
// and then deletes that contact.
var contact = ContactsApp.getContact('john.doe@example.com');
ContactsApp.deleteContact(contact);

Tham số

Tên	Loại	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 yêu cầu ủy 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 dùng nữa và không nên dùng trong các 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);

Tham số

Tên	Loại	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 yêu cầu ủy 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 dùng nữa và không nên dùng trong các tập lệnh mới.

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

Tham số

Tên	Loại	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 yêu cầu ủy 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 dùng nữa và không nên dùng trong các tập lệnh mới.

Tìm một nhóm người liên hệ của tên được đặt.

Tham số

Tên	Loại	Mô tả
`name`	`String`	tên của nhóm liên hệ cần tìm

Cầu thủ trả bóng

ContactGroup — nhóm người liên hệ khớp với tên đã đặt

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy 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 dùng nữa và không nên dùng trong các tập lệnh mới.

Lấy tất cả danh bạ 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 yêu cầu ủy 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 dùng nữa và không nên dùng trong các tập lệnh mới.

Xem người liên hệ theo địa chỉ email.

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

// The code below retrieves a contact with the email address "john.doe@example.com".
var contact = ContactsApp.getContact('john.doe@example.com');

Tham số

Tên	Loại	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 yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

`getContactById(id)`

Không dùng nữa. Hàm này không được dùng nữa và không nên dùng trong các 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);

Tham số

Tên	Loại	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 – địa chỉ liên hệ phù hợp hoặc giá trị rỗng

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy 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 dùng nữa và không nên dùng trong các tập lệnh mới.

Lấy một nhóm 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 liên hệ nào như vậy.

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

Tham số

Tên	Loại	Mô tả
`name`	`String`	tên của nhóm liên hệ cần khớp

Cầu thủ trả bóng

ContactGroup — nhóm liên hệ trùng khớp hoặc rỗng nếu không tìm thấy nhóm liên hệ trùng khớp

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy 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 dùng nữa và không nên dùng trong các 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 liên hệ nào như vậy.

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

Tham số

Tên	Loại	Mô tả
`id`	`String`	mã nhận dạng của nhóm liên hệ cần khớp

Cầu thủ trả bóng

ContactGroup – nhóm liên hệ trùng khớp hoặc rỗng nếu không tìm thấy nhóm liên hệ trùng khớp

Xem thêm

getContactGroups()

`getContactGroups()`

Không dùng nữa. Hàm này không được dùng nữa và không nên dùng trong các 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 Người liên hệ và cũng có thể có danh sách Nhóm liên hệ. Một Nhóm địa chỉ liên hệ có thể chứa Địa chỉ liên hệ. Phương thức này trả về danh sách tất 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 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 yêu cầu ủy 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 dùng nữa và không nên dùng trong các tập lệnh mới.

Lấy tất cả thông tin liên hệ 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ả thông tin 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 yêu cầu ủy 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 dùng nữa và không nên dùng trong các tập lệnh mới.

Tải danh bạ khớp với địa chỉ.

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

Tham số

Tên	Loại	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 loạt các địa chỉ liên hệ trùng khớp

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy 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 dùng nữa và không nên dùng trong các tập lệnh mới.

Tải danh bạ khớp với đị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);

Tham số

Tên	Loại	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

Cầu thủ trả bóng

Contact[] — một loạt các địa chỉ liên hệ trùng khớp

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy 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 dùng nữa và không nên dùng trong các tập lệnh mới.

Nhận địa chỉ liên hệ khớp với địa chỉ, giới hạn ở nhãn địa chỉ tùy 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');

Tham số

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

Cầu thủ trả bóng

Contact[] — một loạt các địa chỉ liên hệ trùng khớp

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy 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 dùng nữa và không nên dùng trong các tập lệnh mới.

Tải thông tin liên hệ 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');

Tham số

Tên	Loại	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 loạt các địa chỉ liên hệ trùng khớp

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy 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 dùng nữa và không nên dùng trong các tập lệnh mới.

Tải thông tin người liên hệ khớp với một giá trị đã cho trong trường tuỳ chỉnh.

Trường tuỳ chỉnh có thể được chỉ định bằng một Chuỗi hoặc dưới dạng một trong các contactsApp.ExtendedField giá trị.

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

Tham số

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

Cầu thủ trả bóng

Contact[] — một loạt các địa chỉ liên hệ trùng khớp

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy 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 dùng nữa và không nên dùng trong các tập lệnh mới.

Tải địa chỉ liên hệ khớp với ngày và tháng 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 and 19 for the day.
var contacts = ContactsApp.getContactsByDate(ContactsApp.Month.APRIL, 19,
                                              ContactsApp.Field.BIRTHDAY);

Tham số

Tên	Loại	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 để tìm kiếm, từ ContactsApp.Field

Cầu thủ trả bóng

Contact[] — một loạt các địa chỉ liên hệ trùng khớp

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy 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 dùng nữa và không nên dùng trong các tập lệnh mới.

Nhận thông tin liên hệ khớp với tháng, ngày 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);

Tham số

Tên	Loại	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 để khớp, có thể là giá trị rỗng
`label`	`Field`	trường để tìm kiếm, từ ContactsApp.Field

Cầu thủ trả bóng

Contact[] — một loạt các địa chỉ liên hệ trùng khớp

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy 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 dùng nữa và không nên dùng trong các tập lệnh mới.

Nhận thông tin liên hệ khớp với tháng, ngày và năm 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, 19 for the day, and 2011 for the year.
var contacts = ContactsApp.getContactsByDate(ContactsApp.Month.APRIL, 19, 2011, 'Start Date');

Tham số

Tên	Loại	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 để khớp, có thể là giá trị rỗng
`label`	`String`	trường tuỳ chỉnh để tìm kiếm

Cầu thủ trả bóng

Contact[] — một loạt các địa chỉ liên hệ trùng khớp

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy 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 dùng nữa và không nên dùng trong các tập lệnh mới.

Nhận người liên hệ khớp với ngày và tháng 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 and 19 for the day.
var contacts = ContactsApp.getContactsByDate(ContactsApp.Month.APRIL, 19, 'Start Date');

Tham số

Tên	Loại	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 loạt các địa chỉ liên hệ trùng khớp

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy 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 dùng nữa và không nên dùng trong các tập lệnh mới.

Tải danh bạ khớp với địa chỉ email.

// The code below returns an array of contacts where the contact's email address contains
// "john.doe@example.com'.
var contacts = ContactsApp.getContactsByEmailAddress('john.doe@example.com');

Tham số

Tên	Loại	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 loạt các địa chỉ liên hệ trùng khớp

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy 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 dùng nữa và không nên dùng trong các tập lệnh mới.

Tải danh bạ khớp với đị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
// "john.doe@example.com" in the Home email field.
var contacts = ContactsApp.getContactsByEmailAddress('john.doe@example.com',
                                                     ContactsApp.Field.HOME_EMAIL);

Tham số

Tên	Loại	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

Cầu thủ trả bóng

Contact[] — một loạt các địa chỉ liên hệ trùng khớp

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy 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 dùng nữa và không nên dùng trong các tập lệnh mới.

Nhận các địa chỉ liên hệ khớp với địa chỉ email, giới hạn ở nhãn địa chỉ email tùy chỉnh đã chỉ định.

// The code below returns an array of contacts where the contact's email address contains
// "john.doe@example.com" in a custom email address label (created by the user) called
// "alternate".
var contacts = ContactsApp.getContactsByEmailAddress('john.doe@example.com', 'alternate');

Tham số

Tên	Loại	Mô tả
`query`	`String`	để tìm kiếm trong địa chỉ email liên hệ bằng thuộc tính tuỳ chỉnh nhãn địa chỉ email
`label`	`String`	nhãn địa chỉ email tuỳ chỉnh để tìm kiếm

Cầu thủ trả bóng

Contact[] — một loạt các địa chỉ liên hệ trùng khớp

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy 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 dùng nữa và không nên dùng trong các 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);

Tham số

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

Cầu thủ trả bóng

Contact[] — một mảng các thông tin liên hệ trong nhóm đã cho

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy 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 dùng nữa và không nên dùng trong các tập lệnh mới.

Tìm người liên hệ khớ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');

Tham số

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

Cầu thủ trả bóng

Contact[] — một loạt các địa chỉ liên hệ trùng khớp

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy 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 dùng nữa và không nên dùng trong các tập lệnh mới.

Tải danh bạ khớp với địa chỉ nhắn tin nhanh, 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);

Tham số

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

Cầu thủ trả bóng

Contact[] — một loạt các địa chỉ liên hệ trùng khớp

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy 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 dùng nữa và không nên dùng trong các tập lệnh mới.

Nhận danh bạ khớp với địa chỉ nhắn tin nhanh, giới hạn trong ứng dụng tức thì tuỳ chỉnh được chỉ định nhãn nhắn tin.

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

Tham số

Tên	Loại	Mô tả
`query`	`String`	chuỗi để tìm kiếm địa chỉ nhắn tin nhanh của người liên hệ bằng nhãn nhắn tin nhanh tuỳ chỉnh được chỉ định
`label`	`String`	nhãn tin nhắn nhanh tuỳ chỉnh để tìm kiếm

Cầu thủ trả bóng

Contact[] — một loạt các địa chỉ liên hệ trùng khớp

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy 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 dùng nữa và không nên dùng trong các tập lệnh mới.

Tìm thông tin liên hệ khớ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');

Tham số

Tên	Loại	Mô tả
`query`	`String`	chuỗi cần 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 loạt các địa chỉ liên hệ trùng khớp

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy 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 dùng nữa và không nên dùng trong các tập lệnh mới.

Tải 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');

Tham số

Tên	Loại	Mô tả
`query`	`String`	chuỗi để tìm kiếm trong tên người liên hệ

Cầu thủ trả bóng

Contact[] — một loạt các địa chỉ liên hệ trùng khớp

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy 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 dùng nữa và không nên dùng trong các tập lệnh mới.

Tải danh bạ trùng 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);

Tham số

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

Cầu thủ trả bóng

Contact[] — một loạt các địa chỉ liên hệ trùng khớp

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy 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 dùng nữa và không nên dùng trong các tập lệnh mới.

Tìm người liên hệ 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');

Tham số

Tên	Loại	Mô tả
`query`	`String`	chuỗi cần tìm kiếm trong trường ghi chú của người liên hệ

Cầu thủ trả bóng

Contact[] — một loạt các địa chỉ liên hệ trùng khớp

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy 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 dùng nữa và không nên dùng trong các tập lệnh mới.

Tìm người liên hệ khớp với số điện thoại.

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

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

Tham số

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

Cầu thủ trả bóng

Contact[] — một loạt các địa chỉ liên hệ trùng khớp

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy 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 dùng nữa và không nên dùng trong các tập lệnh mới.

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

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

Tham số

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

Cầu thủ trả bóng

Contact[] — một loạt các địa chỉ liên hệ trùng khớp

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy 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 dùng nữa và không nên dùng trong các 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.

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

Tham số

Tên	Loại	Mô tả
`query`	`String`	để tìm kiếm số điện thoại của người liên hệ bằng thuộc tính tuỳ chỉnh nhãn số điện thoại
`label`	`String`	nhãn số điện thoại tuỳ chỉnh để tìm kiếm

Cầu thủ trả bóng

Contact[] — một loạt các địa chỉ liên hệ trùng khớp

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy 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 dùng nữa và không nên dùng trong các tập lệnh mới.

Tải danh bạ khớp với 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');

Tham số

Tên	Loại	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 loạt các địa chỉ liên hệ trùng khớp

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy 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 dùng nữa và không nên dùng trong các tập lệnh mới.

Tải danh bạ khớp với URL, giới hạn ở 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);

Tham số

Tên	Loại	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

Cầu thủ trả bóng

Contact[] — một loạt các địa chỉ liên hệ trùng khớp

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy 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 dùng nữa và không nên dùng trong các tập lệnh mới.

Nhận các địa chỉ liên hệ khớp với URL, giới hạn ở nhãn URL tùy 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');

Tham số

Tên	Loại	Mô tả
`query`	`String`	chuỗi để tìm kiếm trong URL của người liên hệ có nhãn URL tuỳ chỉnh được chỉ định
`label`	`String`	nhãn URL tuỳ chỉnh để tìm kiếm

Cầu thủ trả bóng

Contact[] — một loạt các địa chỉ liên hệ trùng khớp

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy 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)