หน้านี้ได้รับการแปลโดย Cloud Translation API

Class ContactGroup

เลิกใช้งานแล้ว แต่ให้ใช้ People API ขั้นสูงแทน บริการ

ContactGroup คือกลุ่มผู้ติดต่อ

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

วิธีการ	ประเภทการแสดงผล	รายละเอียดแบบย่อ
`addContact(contact)`	`ContactGroup`	เพิ่มรายชื่อติดต่อที่ระบุลงในกลุ่มนี้
`deleteGroup()`	`void`	ลบกลุ่มรายชื่อติดต่อนี้
`getContacts()`	`Contact[]`	รับรายชื่อติดต่อทั้งหมดในกลุ่มรายชื่อติดต่อนี้
`getGroupName()`	`String`	แสดงชื่อของกลุ่มนี้
`getId()`	`String`	รับรหัสของกลุ่มรายชื่อติดต่อนี้
`getName()`	`String`	รับข้อมูลชื่อกลุ่มรายชื่อติดต่อนี้
`isSystemGroup()`	`Boolean`	รับค่าบูลีนเพื่อระบุว่ากลุ่มรายชื่อติดต่อนี้เป็นกลุ่มของระบบ (ยกเลิกไม่ได้) หรือ ไม่ได้
`removeContact(contact)`	`ContactGroup`	นำรายชื่อติดต่อที่ระบุออกจากกลุ่มนี้
`setGroupName(name)`	`void`	ตั้งชื่อกลุ่มนี้
`setName(name)`	`ContactGroup`	ตั้งชื่อกลุ่มรายชื่อติดต่อนี้

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

`addContact(contact)`

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

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

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`contact`	`Contact`	รายชื่อติดต่อที่จะเพิ่มในกลุ่ม

รีเทิร์น

ContactGroup — กลุ่มรายชื่อติดต่อนี้

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

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

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

ดูเพิ่มเติม

removeContact(contact)

`deleteGroup()`

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

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

ลบเฉพาะกลุ่มที่ไม่ใช่ระบบ ไม่สามารถลบกลุ่มของระบบ

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

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

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

ดูเพิ่มเติม

isSystemGroup()

`getContacts()`

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

รับรายชื่อติดต่อทั้งหมดในกลุ่มรายชื่อติดต่อนี้

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

รีเทิร์น

Contact[] — รายชื่อติดต่อในกลุ่มนี้

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

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

`getGroupName()`

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

แสดงชื่อของกลุ่มนี้

รีเทิร์น

String — ชื่อของกลุ่มนี้

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

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

`getId()`

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

รับรหัสของกลุ่มรายชื่อติดต่อนี้

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

รีเทิร์น

String — รหัสของกลุ่มนี้

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

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

`getName()`

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

รับข้อมูลชื่อกลุ่มรายชื่อติดต่อนี้

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

รีเทิร์น

String — ชื่อของกลุ่มรายชื่อติดต่อนี้

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

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

ดูเพิ่มเติม

setName(name)

`isSystemGroup()`

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

รับค่าบูลีนเพื่อระบุว่ากลุ่มรายชื่อติดต่อนี้เป็นกลุ่มของระบบ (ยกเลิกไม่ได้) หรือ ไม่ได้

กลุ่มของระบบเป็นชุดกลุ่มที่กำหนดไว้ล่วงหน้าใน Google Contacts เช่น รายชื่อติดต่อ" "ครอบครัว" "เพื่อนร่วมงาน" ฯลฯ ชื่อกลุ่มระบบมักจะประกอบด้วยคำว่า "กลุ่มระบบ"

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

รีเทิร์น

Boolean — ไม่ว่ากลุ่มรายชื่อติดต่อนี้จะเป็นกลุ่มระบบหรือไม่ก็ตาม

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

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

`removeContact(contact)`

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

นำรายชื่อติดต่อที่ระบุออกจากกลุ่มนี้

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`contact`	`Contact`	รายชื่อติดต่อจะถูกนำออกจากกลุ่ม

รีเทิร์น

ContactGroup — กลุ่มรายชื่อติดต่อนี้

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

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

ดูเพิ่มเติม

addContact(contact)

`setGroupName(name)`

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

ตั้งชื่อกลุ่มนี้

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`name`	`String`	ชื่อที่จะตั้งให้กลุ่มนี้

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

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

`setName(name)`

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

ตั้งชื่อกลุ่มรายชื่อติดต่อนี้

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`name`	`String`	ชื่อใหม่ของกลุ่มรายชื่อติดต่อ

รีเทิร์น

ContactGroup — กลุ่มรายชื่อติดต่อนี้

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

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

ดูเพิ่มเติม

getName()