Class ContactGroup

Liên hệ vớiGroup

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

ContactGroup là một nhóm người liên hệ.

Phương thứcLoại dữ liệu trả vềMô tả ngắn
addContact(contact)ContactGroupThêm người liên hệ đã cho vào nhóm này
// The code below creates a new contact and adds it to the "Work Friends"
// contact group
const contact = ContactsApp.createContact(
    'John',
    'Doe',
    'john.doe@example.com',
);
const group = ContactsApp.getContactGroup('Work Friends');
group.addContact(contact);
deleteGroup()voidXoá nhóm người liên hệ này.
getContacts()Contact[]Lấy tất cả người liên hệ trong nhóm người liên hệ này.
getGroupName()StringTrả về tên của nhóm này.
getId()StringLấy mã của nhóm người liên hệ này.
getName()StringLấy tên của nhóm người liên hệ này.
isSystemGroup()BooleanLấy giá trị boolean để xác định xem nhóm người liên hệ này có phải là nhóm hệ thống (không xoá được) hay không.
removeContact(contact)ContactGroupXoá người liên hệ đã cho khỏi nhóm này
// The code below retrieves all the contacts named "John Doe' and removes them
// from the "Work Friends" contact group
const contacts = ContactsApp.getContactsByName('John Doe');
const group = ContactsApp.getContactGroup('Work Friends');
for (const i in contacts) {
  group.removeContact(contacts[i]);
}
setGroupName(name)voidĐặt tên cho nhóm này.
setName(name)ContactGroupĐặt tên cho nhóm người liên hệ này.

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

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.

Thêm người liên hệ đã cho vào nhóm này

// The code below creates a new contact and adds it to the "Work Friends"
// contact group
const contact = ContactsApp.createContact(
    'John',
    'Doe',
    'john.doe@example.com',
);
const group = ContactsApp.getContactGroup('Work Friends');
group.addContact(contact);

Tham số

TênLoạiMô tả
contactContactngười liên hệ cần thêm vào nhóm

Cầu thủ trả bóng

ContactGroup – nhóm địa chỉ liên hệ 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

Xem thêm


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ệ này.

Chỉ xoá các nhóm không phải hệ thống; không thể xoá các nhóm hệ thống.

// The code below retrieves a contact group named "Work Friends" and deletes it
const group = ContactsApp.getContactGroup('Work Friends');
group.deleteGroup();

Ủ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


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ả người liên hệ trong nhóm người liên hệ này.

// The code below retrieves all the contacts in the group named "Work Friends"
const group = ContactsApp.getContactGroup('Work Friends');
const contacts = group.getContacts();

Cầu thủ trả bóng

Contact[] – danh bạ trong nhóm 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

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.

Trả về tên của nhóm này.

Cầu thủ trả bóng

String – tên của nhóm 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

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ã của nhóm người liên hệ này.

// The code below retrieves a contact group named "Work Friends" and gets its id
const group = ContactsApp.getContactGroup('Work Friends');
const id = group.getId();

Cầu thủ trả bóng

String – mã nhận dạng của nhóm 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

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ên của nhóm người liên hệ này.

// The code below creates a new contact group and then retrieves its name
const group = ContactsApp.createContactGroup('Work Friends');
const name = group.getName();

Cầu thủ trả bóng

String – tên của nhóm liên hệ 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

Xem thêm


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 giá trị boolean để xác định xem nhóm người liên hệ này có phải là nhóm hệ thống (không xoá được) hay không.

Nhóm hệ thống là một tập hợp các nhóm được xác định trước trong Danh bạ Google, chẳng hạn như "Danh bạ của tôi", "Gia đình", "Đồng nghiệp", v.v. Tên của một nhóm hệ thống thường chứa từ "Nhóm hệ thống".

// The code below retrieves two contact groups, then logs whether or not
// each is a system group.
const myGroup = ContactsApp.getContactGroup('Work Friends');
const systemGroup = ContactsApp.getContactGroup('System Group: Coworkers');
Logger.log(myGroup.isSystemGroup());      // Returns false, if the group exists.
Logger.log(systemGroup.isSystemGroup());  // Returns true.

Cầu thủ trả bóng

Boolean – liệu nhóm người liên hệ này có phải là nhóm hệ thống hay khô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

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ệ đã cho khỏi nhóm này

// The code below retrieves all the contacts named "John Doe' and removes them
// from the "Work Friends" contact group
const contacts = ContactsApp.getContactsByName('John Doe');
const group = ContactsApp.getContactGroup('Work Friends');
for (const i in contacts) {
  group.removeContact(contacts[i]);
}

Tham số

TênLoạiMô tả
contactContactngười liên hệ cần xoá khỏi nhóm

Cầu thủ trả bóng

ContactGroup – nhóm địa chỉ liên hệ 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

Xem thêm


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 tên cho nhóm này.

Tham số

TênLoạiMô tả
nameStringtên cần đặt cho nhóm 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

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 tên cho nhóm người liên hệ này.

// The code below retrieves the contact group named "Work Friends" and renames
// it to "Work Buddies"
const group = ContactsApp.getContactGroup('Work Friends');
group.setName('Work Buddies');

Tham số

TênLoạiMô tả
nameStringtên mới cho nhóm người liên hệ

Cầu thủ trả bóng

ContactGroup – nhóm địa chỉ liên hệ 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

Xem thêm