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

Class ContactsApp

Không dùng nữa. Thay vào đó, hãy sử dụng dịch vụ nâng cao của API People

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

Thuộc tính không còn hoạt động

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 một nhóm người liên hệ có tên đã cho // The code below creates a new contact group named "Work Friends" const group = ContactsApp.createContactGroup('Work Friends');
`deleteContact(contact)`	`void`	Xoá người liên hệ.
`deleteContactGroup(group)`	`void`	Xoá nhóm người liên hệ // The code below creates deletes the contact group named "Work Friends" const group = ContactsApp.getContactGroup('Work Friends'); ContactsApp.deleteContactGroup(group);
`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 đã cho.
`getAllContacts()`	`Contact[]`	Lấy tất cả danh bạ thuộc về 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 danh bạ có tên đã cho hoặc trả về giá trị rỗng nếu không tìm thấy nhóm danh bạ như vậy.
`getContactGroupById(id)`	`ContactGroup`	Lấy một nhóm 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ả danh bạ của người dùng.
`getContactsByAddress(query)`	`Contact[]`	Lấy thông tin liên hệ khớp với một địa chỉ.
`getContactsByAddress(query, label)`	`Contact[]`	Lấy thông tin liên hệ khớp với một địa chỉ, chỉ giới hạn ở một trường cụ thể.
`getContactsByAddress(query, label)`	`Contact[]`	Lấy những người liên hệ khớp với một địa chỉ, chỉ giới hạn ở nhãn địa chỉ tuỳ chỉnh đã chỉ định.
`getContactsByCompany(query)`	`Contact[]`	Lấy thông tin liên hệ trùng khớp với trường công ty.
`getContactsByCustomField(query, label)`	`Contact[]`	Lấy những người liên hệ khớp với một giá trị nhất định trong trường tuỳ chỉnh.
`getContactsByDate(month, day, label)`	`Contact[]`	Lấy thông tin liên hệ khớp với một tháng và ngày nhất định cho một trường chuẩn cụ thể.
`getContactsByDate(month, day, year, label)`	`Contact[]`	Lấy những người liên hệ khớp với một tháng, ngày và năm nhất định cho một trường chuẩn cụ thể.
`getContactsByDate(month, day, year, label)`	`Contact[]`	Lấy những người liên hệ khớp với một tháng, ngày và năm nhất định cho một trường tuỳ chỉnh cụ thể.
`getContactsByDate(month, day, label)`	`Contact[]`	Lấy những người liên hệ khớp với một tháng và ngày nhất định cho một trường tuỳ chỉnh cụ thể.
`getContactsByEmailAddress(query)`	`Contact[]`	Lấy thông tin liên hệ khớp với một địa chỉ email.
`getContactsByEmailAddress(query, label)`	`Contact[]`	Lấy những người liên hệ khớp với một địa chỉ email, chỉ giới hạn ở một trường cụ thể.
`getContactsByEmailAddress(query, label)`	`Contact[]`	Lấy những người liên hệ khớp với một địa chỉ email, chỉ 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[]`	Lấy thông tin liên hệ khớp với địa chỉ nhắn tin nhanh.
`getContactsByIM(query, label)`	`Contact[]`	Lấy những người liên hệ khớp với địa chỉ nhắn tin nhanh, chỉ giới hạn ở một trường cụ thể.
`getContactsByIM(query, label)`	`Contact[]`	Lấy những người liên hệ khớp với địa chỉ nhắn tin nhanh, chỉ giới hạn ở nhãn nhắn tin nhanh tuỳ chỉnh đã chỉ định.
`getContactsByJobTitle(query)`	`Contact[]`	Lấy những người liên hệ khớp với trường chức danh.
`getContactsByName(query)`	`Contact[]`	Lấy danh bạ trùng khớp với một tên.
`getContactsByName(query, label)`	`Contact[]`	Lấy thông tin liên hệ trùng khớp với một tên, giới hạn ở một trường cụ thể.
`getContactsByNotes(query)`	`Contact[]`	Lấy những người liên hệ khớp với trường ghi chú.
`getContactsByPhone(query)`	`Contact[]`	Lấy 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, chỉ giới hạn ở một trường cụ thể.
`getContactsByPhone(query, label)`	`Contact[]`	Lấy thông tin liên hệ khớp với một số điện thoại, chỉ giới hạn ở nhãn số điện thoại tuỳ chỉnh được chỉ định.
`getContactsByUrl(query)`	`Contact[]`	Lấy thông tin liên hệ trùng khớp với một URL.
`getContactsByUrl(query, label)`	`Contact[]`	Lấy thông tin liên hệ khớp với một URL, giới hạn ở một trường cụ thể.
`getContactsByUrl(query, label)`	`Contact[]`	Lấy thông tin liên hệ khớp với một URL, giới hạn ở 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 được sử 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".
const 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 Danh bạ mới tạo

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 được sử dụng trong các tập lệnh mới.

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

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

Tham số

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

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 được sử 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.
const 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

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 được sử 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"
const 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

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 được sử 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

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 được sử dụng trong các tập lệnh mới.

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

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 đã cho

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 được sử dụng trong các tập lệnh mới.

Lấy tất cả danh bạ thuộc về người dùng này.

Cầu thủ trả bóng

Contact[] – tất cả người liên hệ của người dùng này

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 được sử dụng trong các tập lệnh mới.

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

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

// The code below retrieves a contact with the email address
// "john.doe@example.com".
const 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 – thông tin liên hệ chứa địa chỉ email đó

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ 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òn được dùng nữa và không nên được sử 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"
const id =
    'http://www.google.com/m8/feeds/contacts/john.doe%40example.com/base/7c86afde08d34c';
const contact = ContactsApp.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 – người liên hệ phù hợp hoặc giá trị rỗng

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 được sử dụng trong các tập lệnh mới.

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

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

Tham số

Tên	Loại	Mô tả
`name`	`String`	tên 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 giá trị rỗng nếu không tìm thấy nhóm người liên hệ trùng khớp

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 được sử dụng trong các tập lệnh mới.

Lấy một nhóm danh bạ 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 danh bạ 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"
const id =
    'http://www.google.com/m8/feeds/groups/john.doe%40example.com/base/54eefbb093fdecb';
const group = ContactsApp.getContactGroupById(id);

Tham số

Tên	Loại	Mô tả
`id`	`String`	mã 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 rỗng nếu không tìm thấy nhóm người 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òn được dùng nữa và không nên được sử 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ó một danh sách Danh bạ và có thể là một danh sách Nhóm danh bạ. Mỗi Nhóm người liên hệ có thể chứa Người liên hệ. Phương thức này trả về danh sách tất cả các Nhóm người liên hệ.

// The retrieves all the contract groups for the user and then logs the group
// name of each contact group.
const groups = ContactsApp.getContactGroups();
for (let 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

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 được sử dụng trong các 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
const contacts = ContactsApp.getContacts();

Cầu thủ trả bóng

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

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 được sử dụng trong các tập lệnh mới.

Lấy thông tin liên hệ khớp với một địa chỉ.

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

Tham số

Tên	Loại	Mô tả
`query`	`String`	chuỗi cần tì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 mục liên hệ trùng khớp

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 được sử dụng trong các tập lệnh mới.

Lấy thông tin liên hệ khớp với một địa chỉ, chỉ giới hạn ở 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.
const contacts = ContactsApp.getContactsByAddress(
    'San Francisco',
    ContactsApp.Field.HOME_ADDRESS,
);

Tham số

Tên	Loại	Mô tả
`query`	`String`	chuỗi cần tì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 mảng gồm các mục liên hệ trùng khớp

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 được sử dụng trong các tập lệnh mới.

Lấy những người liên hệ khớp với một địa chỉ, chỉ giới hạn ở 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".
const contacts = ContactsApp.getContactsByAddress('San Francisco', 'vacation');

Tham số

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

Cầu thủ trả bóng

Contact[] – một mảng gồm các mục liên hệ trùng khớp

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 được sử dụng trong các tập lệnh mới.

Lấy thông tin liên hệ trùng 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".
const contacts = ContactsApp.getContactsByCompany('Google');

Tham số

Tên	Loại	Mô tả
`query`	`String`	chuỗi cần 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 mục liên hệ trùng khớp

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 được sử dụng trong các tập lệnh mới.

Lấy những người liên hệ khớp với một giá trị nhất định 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ị của ContactsApp.ExtendedField.

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

Tham số

Tên	Loại	Mô tả
`query`	`Object`	chuỗi cần 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 mục liên hệ trùng khớp

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 được sử dụng trong các tập lệnh mới.

Lấy thông tin liên hệ khớp với một tháng và ngày nhất định cho một trường 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.
const contacts = ContactsApp.getContactsByDate(
    ContactsApp.Month.APRIL,
    19,
    ContactsApp.Field.BIRTHDAY,
);

Tham số

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

Cầu thủ trả bóng

Contact[] – một mảng gồm các mục liên hệ trùng khớp

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 được sử dụng trong các tập lệnh mới.

Lấy những người liên hệ khớp với một tháng, ngày và năm nhất định cho một trường 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.
const contacts = ContactsApp.getContactsByDate(
    ContactsApp.Month.APRIL,
    19,
    1950,
    ContactsApp.Field.BIRTHDAY,
);

Tham số

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

Cầu thủ trả bóng

Contact[] – một mảng gồm các mục liên hệ trùng khớp

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 được sử dụng trong các tập lệnh mới.

Lấy những người liên hệ khớp với một tháng, ngày và năm nhất định 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.
const contacts = ContactsApp.getContactsByDate(
    ContactsApp.Month.APRIL,
    19,
    2011,
    'Start Date',
);

Tham số

Tên	Loại	Mô tả
`month`	`Month`	tháng cần so khớp, dưới dạng một trong các giá trị từ ContactsApp.Month
`day`	`Integer`	ngày cần so khớp
`year`	`Integer`	năm cần so 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 mảng gồm các mục liên hệ trùng khớp

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 được sử dụng trong các tập lệnh mới.

Lấy những người liên hệ khớp với một tháng và ngày nhất định 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.
const contacts = ContactsApp.getContactsByDate(
    ContactsApp.Month.APRIL,
    19,
    'Start Date',
);

Tham số

Tên	Loại	Mô tả
`month`	`Month`	tháng cần so khớp, dưới dạng một trong các giá trị từ ContactsApp.Month
`day`	`Integer`	ngày cần 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 mục liên hệ trùng khớp

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 được sử dụng trong các tập lệnh mới.

Lấy thông tin liên hệ khớp với một địa chỉ email.

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

Tham số

Tên	Loại	Mô tả
`query`	`String`	chuỗi cần tìm trong địa chỉ email của người liên hệ

Cầu thủ trả bóng

Contact[] – một mảng gồm các mục liên hệ trùng khớp

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 được sử dụng trong các tập lệnh mới.

Lấy những người liên hệ khớp với một địa chỉ email, chỉ giới hạn ở 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.
const contacts = ContactsApp.getContactsByEmailAddress(
    'john.doe@example.com',
    ContactsApp.Field.HOME_EMAIL,
);

Tham số

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

Cầu thủ trả bóng

Contact[] – một mảng gồm các mục liên hệ trùng khớp

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 được sử dụng trong các tập lệnh mới.

Lấy những người liên hệ khớp với một địa chỉ email, chỉ 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 "john.doe@example.com" in a custom email address label (created by
// the user) called "alternate".
const contacts = ContactsApp.getContactsByEmailAddress(
    'john.doe@example.com',
    'alternate',
);

Tham số

Tên	Loại	Mô tả
`query`	`String`	chuỗi cần tìm trong địa chỉ email liên hệ có nhãn địa chỉ email tuỳ chỉnh được 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 mục liên hệ trùng khớp

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 được sử 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".
const group = ContactsApp.getContactGroup('Work Friends');
const 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 gồm các địa chỉ liên hệ trong nhóm đã cho

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 được sử dụng trong các tập lệnh mới.

Lấy thông tin 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.
const contacts = ContactsApp.getContactsByIM('ChatWithJohnDoe');

Tham số

Tên	Loại	Mô tả
`query`	`String`	chuỗi cần tì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 mục liên hệ trùng khớp

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 được sử dụng trong các tập lệnh mới.

Lấy những người liên hệ khớp với địa chỉ nhắn tin nhanh, chỉ giới hạn ở 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.
const contacts = ContactsApp.getContactsByIM(
    'ChatWithJohnDoe',
    ContactsApp.Field.AIM,
);

Tham số

Tên	Loại	Mô tả
`query`	`String`	chuỗi cần tìm trong đị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 mảng gồm các mục liên hệ trùng khớp

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 được sử dụng trong các tập lệnh mới.

Lấy những người liên hệ khớp với địa chỉ nhắn tin nhanh, chỉ giới hạn ở 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".
const contacts = ContactsApp.getContactsByIM('ChatWithJohnDoe', 'eBuddy');

Tham số

Tên	Loại	Mô tả
`query`	`String`	chuỗi cần tìm trong địa chỉ nhắn tin nhanh của người liên hệ bằng nhãn nhắn tin nhanh tuỳ chỉnh đã 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 mục liên hệ trùng khớp

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 được sử dụng trong các tập lệnh mới.

Lấy những người 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".
const 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 mảng gồm các mục liên hệ trùng khớp

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 được sử dụng trong các tập lệnh mới.

Lấy danh bạ trùng khớp với một tên.

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

Tham số

Tên	Loại	Mô tả
`query`	`String`	chuỗi cần 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 mục liên hệ trùng khớp

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 được sử dụng trong các tập lệnh mới.

Lấy thông tin liên hệ trùng khớp với một tên, giới hạn ở 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.
const contacts = ContactsApp.getContactsByName(
    'John',
    ContactsApp.Field.GIVEN_NAME,
);

Tham số

Tên	Loại	Mô tả
`query`	`String`	chuỗi cần tì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 mảng gồm các mục liên hệ trùng khớp

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 được sử dụng trong các tập lệnh mới.

Lấy những 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".
const contacts = ContactsApp.getContactsByNotes('sent birthday card');

Tham số

Tên	Loại	Mô tả
`query`	`String`	chuỗi cần 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 mục liên hệ trùng khớp

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 được sử dụng trong các tập lệnh mới.

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

Phương thức này sẽ mở rộng số điện thoại có chữ cái, vì vậy, nếu bạn tìm kiếm "212-555-MÃ" và bạn có "212-555-2633" trong danh bạ hoặc ngược lại, phương thức này sẽ tìm thấy người liên hệ thích 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.
const contacts = ContactsApp.getContactsByPhone('212-555-1234');

Tham số

Tên	Loại	Mô tả
`query`	`String`	chuỗi cần tì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 mục liên hệ trùng khớp

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 được sử dụng trong các tập lệnh mới.

Lấy danh bạ khớp với một số điện thoại, chỉ giới hạn ở 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.
const contacts = ContactsApp.getContactsByPhone(
    '212-555-1234',
    ContactsApp.Field.HOME_PHONE,
);

Tham số

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

Cầu thủ trả bóng

Contact[] – một mảng gồm các mục liên hệ trùng khớp

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 được sử dụng trong các tập lệnh mới.

Lấy thông tin liên hệ khớp với một số điện thoại, chỉ giới hạn ở nhãn số điện thoại tuỳ chỉnh được 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".
const contacts = ContactsApp.getContactsByPhone('212-555-1234', 'alternate');

Tham số

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

Cầu thủ trả bóng

Contact[] – một mảng gồm các mục liên hệ trùng khớp

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 được sử dụng trong các tập lệnh mới.

Lấy thông tin liên hệ trùng 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.
const contacts = ContactsApp.getContactsByUrl('www.example.com');

Tham số

Tên	Loại	Mô tả
`query`	`String`	chuỗi cần tì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 mục liên hệ trùng khớp

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 được sử dụng trong các tập lệnh mới.

Lấy thông tin liên hệ khớp với một 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.
const contacts = ContactsApp.getContactsByUrl(
    'www.example.com',
    ContactsApp.Field.WORK_WEBSITE,
);

Tham số

Tên	Loại	Mô tả
`query`	`String`	chuỗi cần tì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 mảng gồm các mục liên hệ trùng khớp

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 được sử dụng trong các tập lệnh mới.

Lấy thông tin liên hệ khớp với một URL, giới hạn ở 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".
const contacts = ContactsApp.getContactsByUrl(
    'www.example.com',
    'alternate work',
);

Tham số

Tên	Loại	Mô tả
`query`	`String`	chuỗi cần tì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 mảng gồm các mục liên hệ trùng khớp

Ủy quyền

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