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',
    'john.doe@example.com',
);
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이 연락처 그룹의 이름을 설정합니다.

지원 중단된 메서드

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

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

// 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);

매개변수

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

리턴

ContactGroup: 이 연락처 그룹

승인

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

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

참고 항목

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

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

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

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

참고 항목

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

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

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

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

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

리턴

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

승인

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

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

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

이 연락처 그룹의 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

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

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

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

참고 항목

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

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

시스템 그룹은 '내 연락처', '가족', '동료' 등 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

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

이 그룹에서 지정된 연락처를 삭제합니다. 

// 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]);
}

매개변수

이름유형설명
contactContact그룹에서 삭제할 연락처

리턴

ContactGroup: 이 연락처 그룹

승인

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

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

참고 항목

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

이 그룹의 이름을 설정합니다.

매개변수

이름유형설명
nameString이 그룹에 설정할 이름

승인

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

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

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

이 연락처 그룹의 이름을 설정합니다. 

// 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');

매개변수

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

리턴

ContactGroup: 이 연락처 그룹

승인

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

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

참고 항목