Class ContactGroup

그룹에 문의하기

지원 중단되었습니다. 대신 People API 고급 서비스를 사용하세요.

ContactGroup은 연락처 그룹입니다.

지원 중단된 메서드

메서드	반환 유형	간략한 설명
addContact(contact)	ContactGroup	지정된 연락처를 이 그룹에 추가합니다. // The code below creates a new contact and adds it to the "Work Friends" // contact group const contact = ContactsApp.createContact( 'John', 'Doe', '[e-mail]', ); const group = ContactsApp.getContactGroup('Work Friends'); group.addContact(contact);
deleteGroup()	void	이 연락처 그룹을 삭제합니다.
getContacts()	Contact[]	이 연락처 그룹의 모든 연락처를 가져옵니다.
getGroupName()	String	이 그룹의 이름을 반환합니다.
getId()	String	이 연락처 그룹의 ID를 가져옵니다.
getName()	String	이 연락처 그룹의 이름을 가져옵니다.
isSystemGroup()	Boolean	이 연락처 그룹이 시스템 그룹 (삭제 불가)인지 여부를 결정하는 불리언 값을 가져옵니다.
removeContact(contact)	ContactGroup	이 그룹에서 지정된 연락처를 삭제합니다. // 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	이 그룹의 이름을 설정합니다.
setName(name)	ContactGroup	이 연락처 그룹의 이름을 설정합니다.

지원 중단된 메서드

addContact(contact)

지원 중단되었습니다. 이 함수는 지원 중단되었으며 새 스크립트에서 사용해서는 안 됩니다.

지정된 연락처를 이 그룹에 추가합니다.

// The code below creates a new contact and adds it to the "Work Friends"
// contact group
const contact = ContactsApp.createContact(
    'John',
    'Doe',
    '[e-mail]',
);
const group = ContactsApp.getContactGroup('Work Friends');
group.addContact(contact);

매개변수

이름	유형	설명
contact	Contact	그룹에 추가할 연락처

리턴

ContactGroup: 이 연락처 그룹

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

참고 항목

• removeContact(contact)

---

deleteGroup()

지원 중단되었습니다. 이 함수는 지원 중단되었으며 새 스크립트에서 사용해서는 안 됩니다.

이 연락처 그룹을 삭제합니다.

시스템 외 그룹만 삭제할 수 있습니다. 시스템 그룹은 삭제할 수 없습니다.

// The code below retrieves a contact group named "Work Friends" and deletes it
const 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"
const group = ContactsApp.getContactGroup('Work Friends');
const contacts = group.getContacts();

리턴

Contact[]: 이 그룹의 연락처

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

---

getGroupName()

지원 중단되었습니다. 이 함수는 지원 중단되었으며 새 스크립트에서 사용해서는 안 됩니다.

이 그룹의 이름을 반환합니다.

리턴

String: 이 그룹의 이름입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

---

getId()

지원 중단되었습니다. 이 함수는 지원 중단되었으며 새 스크립트에서 사용해서는 안 됩니다.

이 연락처 그룹의 ID를 가져옵니다.

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

리턴

String: 이 그룹의 ID입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

---

getName()

지원 중단되었습니다. 이 함수는 지원 중단되었으며 새 스크립트에서 사용해서는 안 됩니다.

이 연락처 그룹의 이름을 가져옵니다.

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

리턴

String: 이 연락처 그룹의 이름입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

참고 항목

• setName(name)

---

isSystemGroup()

지원 중단되었습니다. 이 함수는 지원 중단되었으며 새 스크립트에서 사용해서는 안 됩니다.

이 연락처 그룹이 시스템 그룹 (삭제 불가)인지 여부를 결정하는 불리언 값을 가져옵니다.

시스템 그룹은 '내 연락처', '가족', '동료' 등 Google 주소록에 사전 정의된 그룹의 집합입니다. 시스템 그룹의 이름에는 일반적으로 '시스템 그룹'이라는 단어가 포함됩니다.

// 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.

리턴

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
const contacts = ContactsApp.getContactsByName('John Doe');
const group = ContactsApp.getContactGroup('Work Friends');
for (const 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"
const group = ContactsApp.getContactGroup('Work Friends');
group.setName('Work Buddies');

매개변수

이름	유형	설명
name	String	연락처 그룹의 새 이름

리턴

ContactGroup: 이 연락처 그룹

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

참고 항목

• getName()