หน้านี้ได้รับการแปลโดย 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);

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
`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]);
}

พารามิเตอร์

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

รีเทิร์น

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

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

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

ดูเพิ่มเติม

addContact(contact)

`setGroupName(name)`

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

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

พารามิเตอร์

ชื่อ	Type	คำอธิบาย
`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');

พารามิเตอร์

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

รีเทิร์น

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

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

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

ดูเพิ่มเติม

getName()