이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Class ContactsApp

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

이 클래스를 사용하면 사용자가 자신의 Google 주소록에 액세스하고 여기에 나열된 연락처를 생성, 삭제, 업데이트할 수 있습니다.

지원 중단된 속성

속성	유형	설명
`ExtendedField`	`ExtendedField`
`Field`	`Field`
`Gender`	`Gender`
`Month`	`Month`
`Priority`	`Priority`
`Sensitivity`	`Sensitivity`

지원 중단된 메서드

메서드	반환 유형	간략한 설명
`createContact(givenName, familyName, email)`	`Contact`	새 연락처를 만듭니다.
`createContactGroup(name)`	`ContactGroup`	지정된 이름으로 연락처 그룹을 만듭니다. // The code below creates a new contact group named "Work Friends" const group = ContactsApp.createContactGroup('Work Friends');
`deleteContact(contact)`	`void`	연락처를 삭제합니다.
`deleteContactGroup(group)`	`void`	연락처 그룹을 삭제합니다. // The code below creates deletes the contact group named "Work Friends" const group = ContactsApp.getContactGroup('Work Friends'); ContactsApp.deleteContactGroup(group);
`findByEmailAddress(email)`	`Contact`	지정된 이메일 주소가 있는 연락처를 찾습니다.
`findContactGroup(name)`	`ContactGroup`	지정된 이름의 연락처 그룹을 찾습니다.
`getAllContacts()`	`Contact[]`	이 사용자에게 속한 모든 연락처를 가져옵니다.
`getContact(emailAddress)`	`Contact`	이메일 주소로 연락처를 가져옵니다.
`getContactById(id)`	`Contact`	이 ID의 연락처를 가져옵니다.
`getContactGroup(name)`	`ContactGroup`	지정된 이름의 연락처 그룹을 가져오거나 이러한 연락처 그룹을 찾을 수 없는 경우 null을 반환합니다.
`getContactGroupById(id)`	`ContactGroup`	지정된 ID의 연락처 그룹을 가져오거나 이러한 연락처 그룹을 찾을 수 없는 경우 null을 반환합니다.
`getContactGroups()`	`ContactGroup[]`	사용자의 연락처 그룹의 전체 목록을 가져옵니다.
`getContacts()`	`Contact[]`	사용자의 모든 연락처를 가져옵니다.
`getContactsByAddress(query)`	`Contact[]`	주소와 일치하는 연락처 가져오기
`getContactsByAddress(query, label)`	`Contact[]`	특정 필드로 제한된 주소와 일치하는 연락처 가져오기
`getContactsByAddress(query, label)`	`Contact[]`	지정된 맞춤 주소 라벨로 제한된 주소와 일치하는 연락처를 가져옵니다.
`getContactsByCompany(query)`	`Contact[]`	회사 필드와 일치하는 연락처를 가져옵니다.
`getContactsByCustomField(query, label)`	`Contact[]`	맞춤 필드의 지정된 값과 일치하는 연락처를 가져옵니다.
`getContactsByDate(month, day, label)`	`Contact[]`	특정 표준 입력란의 지정된 월과 일과 일치하는 연락처를 가져옵니다.
`getContactsByDate(month, day, year, label)`	`Contact[]`	특정 표준 입력란의 지정된 월, 일, 연도와 일치하는 연락처를 가져옵니다.
`getContactsByDate(month, day, year, label)`	`Contact[]`	특정 맞춤 입력란의 지정된 월, 일, 연도와 일치하는 연락처를 가져옵니다.
`getContactsByDate(month, day, label)`	`Contact[]`	특정 맞춤 입력란의 지정된 월과 요일에 일치하는 연락처를 가져옵니다.
`getContactsByEmailAddress(query)`	`Contact[]`	이메일 주소와 일치하는 연락처 가져오기
`getContactsByEmailAddress(query, label)`	`Contact[]`	이메일 주소와 일치하는 연락처를 가져오되 특정 입력란으로 제한합니다.
`getContactsByEmailAddress(query, label)`	`Contact[]`	지정된 맞춤 이메일 주소 라벨로 제한된 이메일 주소와 일치하는 연락처를 가져옵니다.
`getContactsByGroup(group)`	`Contact[]`	지정된 ContactGroup의 연락처를 가져옵니다.
`getContactsByIM(query)`	`Contact[]`	채팅 주소와 일치하는 연락처 가져오기
`getContactsByIM(query, label)`	`Contact[]`	특정 입력란으로 제한된 채팅 주소와 일치하는 연락처를 가져옵니다.
`getContactsByIM(query, label)`	`Contact[]`	지정된 맞춤 채팅 라벨로 제한된 채팅 주소와 일치하는 연락처를 가져옵니다.
`getContactsByJobTitle(query)`	`Contact[]`	직책 필드와 일치하는 연락처를 가져옵니다.
`getContactsByName(query)`	`Contact[]`	이름과 일치하는 연락처를 가져옵니다.
`getContactsByName(query, label)`	`Contact[]`	특정 필드로 제한된 이름과 일치하는 연락처 가져오기
`getContactsByNotes(query)`	`Contact[]`	메모 필드와 일치하는 연락처를 가져옵니다.
`getContactsByPhone(query)`	`Contact[]`	전화번호와 일치하는 연락처 가져오기
`getContactsByPhone(query, label)`	`Contact[]`	특정 필드로 제한된 전화번호와 일치하는 연락처를 가져옵니다.
`getContactsByPhone(query, label)`	`Contact[]`	지정된 맞춤 전화번호 라벨로 제한된 전화번호와 일치하는 연락처를 가져옵니다.
`getContactsByUrl(query)`	`Contact[]`	URL과 일치하는 연락처 가져오기
`getContactsByUrl(query, label)`	`Contact[]`	특정 필드로 제한된 URL과 일치하는 연락처를 가져옵니다.
`getContactsByUrl(query, label)`	`Contact[]`	지정된 맞춤 URL 라벨로 제한된 URL과 일치하는 연락처를 가져옵니다.

지원 중단된 메서드

`createContact(givenName, familyName, email)`

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

새 연락처를 만듭니다.

// The code below creates a new contact with the name "John Doe" and the email
// address "john.doe@example.com".
const contact = ContactsApp.createContact(
    'John',
    'Doe',
    'john.doe@example.com',
);

매개변수

이름	유형	설명
`givenName`	`String`	연락처의 이름
`familyName`	`String`	연락처의 성
`email`	`String`	연락처의 이메일 주소

리턴

Contact: 새로 생성된 Contact 객체

승인

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

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

참고 항목

deleteContact(contact)

`createContactGroup(name)`

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

지정된 이름으로 연락처 그룹을 만듭니다.

// The code below creates a new contact group named "Work Friends"
const group = ContactsApp.createContactGroup('Work Friends');

매개변수

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

리턴

ContactGroup: 새로 생성된 연락처 그룹

승인

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

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

참고 항목

deleteContactGroup(group)

`deleteContact(contact)`

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

연락처를 삭제합니다.

// The code below retrieves a contact with the email address
// "john.doe@example.com" and then deletes that contact.
const contact = ContactsApp.getContact('john.doe@example.com');
ContactsApp.deleteContact(contact);

매개변수

이름	유형	설명
`contact`	`Contact`	삭제할 연락처

승인

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

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

참고 항목

createContact(givenName, familyName, email)

`deleteContactGroup(group)`

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

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

// The code below creates deletes the contact group named "Work Friends"
const group = ContactsApp.getContactGroup('Work Friends');
ContactsApp.deleteContactGroup(group);

매개변수

이름	유형	설명
`group`	`ContactGroup`	삭제할 연락처 그룹

승인

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

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

참고 항목

createContactGroup(name)

`findByEmailAddress(email)`

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

지정된 이메일 주소가 있는 연락처를 찾습니다.

매개변수

이름	유형	설명
`email`	`String`	찾을 연락처의 이메일 주소

리턴

Contact: 이메일 주소가 포함된 연락처

승인

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

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

`findContactGroup(name)`

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

지정된 이름의 연락처 그룹을 찾습니다.

매개변수

이름	유형	설명
`name`	`String`	찾을 연락처 그룹의 이름

리턴

ContactGroup: 지정된 이름과 일치하는 연락처 그룹

승인

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

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

`getAllContacts()`

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

이 사용자에게 속한 모든 연락처를 가져옵니다.

리턴

Contact[]: 이 사용자의 모든 연락처

승인

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

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

`getContact(emailAddress)`

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

이메일 주소로 연락처를 가져옵니다.

여러 연락처가 동일한 이메일 주소를 공유하는 경우 이 메서드는 이메일 주소를 기본으로 표시한 연락처를 우선시합니다. 연락처 중 이메일 주소가 기본으로 표시된 연락처가 없거나 여러 연락처에 이메일 주소가 기본으로 표시된 경우 정렬된 연락처 순서의 첫 번째 결과를 반환합니다.

// The code below retrieves a contact with the email address
// "john.doe@example.com".
const contact = ContactsApp.getContact('john.doe@example.com');

매개변수

이름	유형	설명
`emailAddress`	`String`	연락처의 이메일 주소

리턴

Contact: 이메일 주소가 포함된 연락처

승인

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

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

`getContactById(id)`

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

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

// The code below retrieves the contact with the id
// "http://www.google.com/m8/feeds/contacts/john.doe%40example.com/base/7c86afde08d34ca5"
const id =
    'http://www.google.com/m8/feeds/contacts/john.doe%40example.com/base/7c86afde08d34c';
const contact = ContactsApp.getContactById(id);

매개변수

이름	유형	설명
`id`	`String`	가져올 연락처의 ID

리턴

Contact: 일치하는 연락처 또는 null

승인

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

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

참고 항목

getContact(emailAddress)

`getContactGroup(name)`

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

지정된 이름의 연락처 그룹을 가져오거나 이러한 연락처 그룹을 찾을 수 없는 경우 null을 반환합니다.

// The code below returns the contact group with the name "Work Friends"
const group = ContactsApp.getContactGroup('Work Friends');

매개변수

이름	유형	설명
`name`	`String`	일치시킬 연락처 그룹의 이름

리턴

ContactGroup: 일치하는 연락처 그룹 또는 일치하는 연락처 그룹이 없는 경우 null

승인

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

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

참고 항목

getContactGroups()

`getContactGroupById(id)`

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

지정된 ID의 연락처 그룹을 가져오거나 이러한 연락처 그룹을 찾을 수 없는 경우 null을 반환합니다.

// The code below returns the contact group with the id
// "http://www.google.com/m8/feeds/groups/john.doe%40example.com/base/54eefbb093fdecb"
const id =
    'http://www.google.com/m8/feeds/groups/john.doe%40example.com/base/54eefbb093fdecb';
const group = ContactsApp.getContactGroupById(id);

매개변수

이름	유형	설명
`id`	`String`	일치시킬 연락처 그룹의 ID

리턴

ContactGroup: 일치하는 연락처 그룹 또는 일치하는 연락처 그룹이 없는 경우 null

참고 항목

getContactGroups()

`getContactGroups()`

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

사용자의 연락처 그룹의 전체 목록을 가져옵니다.

사용자는 연락처 목록을 보유할 수 있으며, 경우에 따라 연락처 그룹 목록도 보유할 수 있습니다. 각 연락처 그룹에는 연락처가 포함될 수 있습니다. 이 메서드는 모든 연락처 그룹의 목록을 반환합니다.

// The retrieves all the contract groups for the user and then logs the group
// name of each contact group.
const groups = ContactsApp.getContactGroups();
for (let i = 0; i < groups.length; i++) {
  Logger.log(groups[i].getName());
}

리턴

ContactGroup[]: 사용자의 연락처 그룹 배열

승인

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

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

참고 항목

getContactGroup(name)

`getContacts()`

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

사용자의 모든 연락처를 가져옵니다.

// The code below will retrieve all the user's contacts
const contacts = ContactsApp.getContacts();

리턴

Contact[]: 모든 사용자 연락처의 배열

승인

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

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

참고 항목

getContact(emailAddress)

`getContactsByAddress(query)`

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

주소와 일치하는 연락처 가져오기

// The code below returns an array of contacts where the contact's address
// contains "San Francisco'.
const contacts = ContactsApp.getContactsByAddress('San Francisco');

매개변수

이름	유형	설명
`query`	`String`	연락처 주소에서 검색할 문자열

리턴

Contact[]: 일치하는 연락처 배열

승인

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

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

참고 항목

getContact(emailAddress)

`getContactsByAddress(query, label)`

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

특정 필드로 제한된 주소와 일치하는 연락처 가져오기

// The code below returns an array of contacts where the contact's address
// contains "San Francisco" in the Home address field.
const contacts = ContactsApp.getContactsByAddress(
    'San Francisco',
    ContactsApp.Field.HOME_ADDRESS,
);

매개변수

이름	유형	설명
`query`	`String`	연락처 주소에서 검색할 문자열
`label`	`Field`	검색할 필드

리턴

Contact[]: 일치하는 연락처 배열

승인

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

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

참고 항목

getContact(emailAddress)

`getContactsByAddress(query, label)`

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

지정된 맞춤 주소 라벨로 제한된 주소와 일치하는 연락처를 가져옵니다.

// The code below returns an array of contacts where the contact's address
// contains "San Francisco" in a custom address label (created by the user)
// called "vacation".
const contacts = ContactsApp.getContactsByAddress('San Francisco', 'vacation');

매개변수

이름	유형	설명
`query`	`String`	지정된 맞춤 주소 라벨이 있는 연락처 주소에서 검색할 문자열
`label`	`String`	검색할 맞춤 주소 라벨

리턴

Contact[]: 일치하는 연락처 배열

승인

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

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

참고 항목

getContact(emailAddress)

`getContactsByCompany(query)`

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

회사 필드와 일치하는 연락처를 가져옵니다.

// The code below returns an array of contacts where the contact's company field
// contains "Google".
const contacts = ContactsApp.getContactsByCompany('Google');

매개변수

이름	유형	설명
`query`	`String`	연락처의 회사 입력란에서 검색할 문자열

리턴

Contact[]: 일치하는 연락처 배열

승인

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

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

참고 항목

getContact(emailAddress)

`getContactsByCustomField(query, label)`

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

맞춤 필드의 지정된 값과 일치하는 연락처를 가져옵니다.

맞춤 입력란은 문자열로 지정하거나 ContactsApp.ExtendedField 값 중 하나로 지정할 수 있습니다.

// The code below returns an array of contacts where the contact's custom field
// named "Favorite Sport" contains "tennis".
const contacts = ContactsApp.getContactsByCustomField(
    'tennis',
    'Favorite Sport',
);

매개변수

이름	유형	설명
`query`	`Object`	연락처의 맞춤 필드에서 검색할 문자열
`label`	`ExtendedField`	검색할 커스텀 필드

리턴

Contact[]: 일치하는 연락처 배열

승인

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

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

참고 항목

getContact(emailAddress)

`getContactsByDate(month, day, label)`

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

특정 표준 입력란의 지정된 월과 일과 일치하는 연락처를 가져옵니다.

// The code below returns an array of contacts where the contact's "Birthday"
// field contains April for the month and 19 for the day.
const contacts = ContactsApp.getContactsByDate(
    ContactsApp.Month.APRIL,
    19,
    ContactsApp.Field.BIRTHDAY,
);

매개변수

이름	유형	설명
`month`	`Month`	일치시킬 월입니다(ContactsApp.Month의 값 중 하나).
`day`	`Integer`	일치하는 날짜
`label`	`Field`	ContactsApp.Field에서 검색할 필드

리턴

Contact[]: 일치하는 연락처 배열

승인

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

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

참고 항목

getContact(emailAddress)

`getContactsByDate(month, day, year, label)`

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

특정 표준 입력란의 지정된 월, 일, 연도와 일치하는 연락처를 가져옵니다.

// The code below returns an array of contacts where the contact's "Birthday"
// field contains April for the month, 19 for the day, and 1950 for the year.
const contacts = ContactsApp.getContactsByDate(
    ContactsApp.Month.APRIL,
    19,
    1950,
    ContactsApp.Field.BIRTHDAY,
);

매개변수

이름	유형	설명
`month`	`Month`	일치시킬 월입니다(ContactsApp.Month의 값 중 하나).
`day`	`Integer`	일치하는 날짜
`year`	`Integer`	일치할 연도입니다(null일 수 있음).
`label`	`Field`	ContactsApp.Field에서 검색할 필드

리턴

Contact[]: 일치하는 연락처 배열

승인

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

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

참고 항목

getContact(emailAddress)

`getContactsByDate(month, day, year, label)`

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

특정 맞춤 입력란의 지정된 월, 일, 연도와 일치하는 연락처를 가져옵니다.

// The code below returns an array of contacts where the contact's custom "Start
// Date" field contains April for the month, 19 for the day, and 2011 for the
// year.
const contacts = ContactsApp.getContactsByDate(
    ContactsApp.Month.APRIL,
    19,
    2011,
    'Start Date',
);

매개변수

이름	유형	설명
`month`	`Month`	일치시킬 월입니다(ContactsApp.Month의 값 중 하나).
`day`	`Integer`	일치하는 날짜
`year`	`Integer`	일치할 연도입니다(null일 수 있음).
`label`	`String`	검색할 커스텀 필드

리턴

Contact[]: 일치하는 연락처 배열

승인

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

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

참고 항목

getContact(emailAddress)

`getContactsByDate(month, day, label)`

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

특정 맞춤 입력란의 지정된 월과 요일에 해당하는 연락처를 가져옵니다.

// The code below returns an array of contacts where the contact's custom "Start
// Date" field contains April for the month and 19 for the day.
const contacts = ContactsApp.getContactsByDate(
    ContactsApp.Month.APRIL,
    19,
    'Start Date',
);

매개변수

이름	유형	설명
`month`	`Month`	일치시킬 월입니다(ContactsApp.Month의 값 중 하나).
`day`	`Integer`	일치하는 날짜
`label`	`String`	검색할 커스텀 필드

리턴

Contact[]: 일치하는 연락처 배열

승인

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

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

참고 항목

getContact(emailAddress)

`getContactsByEmailAddress(query)`

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

이메일 주소와 일치하는 연락처 가져오기

// The code below returns an array of contacts where the contact's email address
// contains "john.doe@example.com'.
const contacts = ContactsApp.getContactsByEmailAddress('john.doe@example.com');

매개변수

이름	유형	설명
`query`	`String`	연락처 이메일 주소에서 검색할 문자열

리턴

Contact[]: 일치하는 연락처 배열

승인

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

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

참고 항목

getContact(emailAddress)

`getContactsByEmailAddress(query, label)`

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

이메일 주소와 일치하는 연락처를 가져오되 특정 입력란으로 제한합니다.

// The code below returns an array of contacts where the contact's email address
// contains "john.doe@example.com" in the Home email field.
const contacts = ContactsApp.getContactsByEmailAddress(
    'john.doe@example.com',
    ContactsApp.Field.HOME_EMAIL,
);

매개변수

이름	유형	설명
`query`	`String`	연락처 이메일 주소에서 검색할 문자열
`label`	`Field`	검색할 필드

리턴

Contact[]: 일치하는 연락처 배열

승인

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

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

참고 항목

getContact(emailAddress)

`getContactsByEmailAddress(query, label)`

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

지정된 맞춤 이메일 주소 라벨로 제한된 이메일 주소와 일치하는 연락처를 가져옵니다.

// The code below returns an array of contacts where the contact's email address
// contains "john.doe@example.com" in a custom email address label (created by
// the user) called "alternate".
const contacts = ContactsApp.getContactsByEmailAddress(
    'john.doe@example.com',
    'alternate',
);

매개변수

이름	유형	설명
`query`	`String`	지정된 맞춤 이메일 주소 라벨이 있는 연락처 이메일 주소에서 검색할 문자열
`label`	`String`	검색할 맞춤 이메일 주소 라벨

리턴

Contact[]: 일치하는 연락처 배열

승인

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

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

참고 항목

getContact(emailAddress)

`getContactsByGroup(group)`

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

지정된 ContactGroup의 연락처를 가져옵니다.

// The code below returns an array of contacts in the ContactGroup with the name
// "Work Friends".
const group = ContactsApp.getContactGroup('Work Friends');
const contacts = ContactsApp.getContactsByGroup(group);

매개변수

이름	유형	설명
`group`	`ContactGroup`	연락처 그룹

리턴

Contact[]: 지정된 그룹의 연락처 배열

승인

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

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

참고 항목

getContact(emailAddress)

`getContactsByIM(query)`

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

채팅 주소와 일치하는 연락처 가져오기

// The code below returns an array of contacts where the contact's instant
// messaging address contains "ChatWithJohnDoe" in any instant messaging field.
const contacts = ContactsApp.getContactsByIM('ChatWithJohnDoe');

매개변수

이름	유형	설명
`query`	`String`	연락처의 인스턴트 메시지 주소에서 검색할 문자열

리턴

Contact[]: 일치하는 연락처 배열

승인

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

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

참고 항목

getContact(emailAddress)

`getContactsByIM(query, label)`

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

특정 입력란으로 제한된 채팅 주소와 일치하는 연락처를 가져옵니다.

// The code below returns an array of contacts where the contact's instant
// messaging address contains "ChatWithJohnDoe" in the AIM instant messaging
// field.
const contacts = ContactsApp.getContactsByIM(
    'ChatWithJohnDoe',
    ContactsApp.Field.AIM,
);

매개변수

이름	유형	설명
`query`	`String`	연락처의 인스턴트 메시지 주소에서 검색할 문자열
`label`	`Field`	검색할 필드

리턴

Contact[]: 일치하는 연락처 배열

승인

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

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

참고 항목

getContact(emailAddress)

`getContactsByIM(query, label)`

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

지정된 맞춤 채팅 라벨로 제한된 채팅 주소와 일치하는 연락처를 가져옵니다.

// The code below returns an array of contacts where the contact's instant
// messaging address contains "ChatWithJohnDoe" in a custom instant messaging
// label (created by the user) called "eBuddy".
const contacts = ContactsApp.getContactsByIM('ChatWithJohnDoe', 'eBuddy');

매개변수

이름	유형	설명
`query`	`String`	지정된 맞춤 인스턴트 메시지 라벨을 사용하여 연락처의 인스턴트 메시지 주소에서 검색할 문자열
`label`	`String`	검색할 맞춤 인스턴트 메시지 라벨

리턴

Contact[]: 일치하는 연락처 배열

승인

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

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

참고 항목

getContact(emailAddress)

`getContactsByJobTitle(query)`

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

직책 필드와 일치하는 연락처를 가져옵니다.

// The code below returns an array of contacts where the contact's job title
// field contains "Product Manager".
const contacts = ContactsApp.getContactsByJobTitle('Product Manager');

매개변수

이름	유형	설명
`query`	`String`	연락처의 직책 입력란에서 검색할 문자열

리턴

Contact[]: 일치하는 연락처 배열

승인

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

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

참고 항목

getContact(emailAddress)

`getContactsByName(query)`

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

이름과 일치하는 연락처를 가져옵니다.

// The code below returns an array of contacts where the contact name contains
// "John"
const contacts = ContactsApp.getContactsByName('John');

매개변수

이름	유형	설명
`query`	`String`	연락처 이름에서 검색할 문자열

리턴

Contact[]: 일치하는 연락처 배열

승인

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

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

참고 항목

getContact(emailAddress)

`getContactsByName(query, label)`

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

특정 필드로 제한된 이름과 일치하는 연락처 가져오기

// The code below returns an array of contacts where the contact name contains
// "John" in the Given Name field.
const contacts = ContactsApp.getContactsByName(
    'John',
    ContactsApp.Field.GIVEN_NAME,
);

매개변수

이름	유형	설명
`query`	`String`	연락처 이름에서 검색할 문자열
`label`	`Field`	검색할 필드

리턴

Contact[]: 일치하는 연락처 배열

승인

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

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

참고 항목

getContact(emailAddress)

`getContactsByNotes(query)`

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

메모 필드와 일치하는 연락처를 가져옵니다.

// The code below returns an array of contacts where the contact's notes field
// contains "sent birthday card".
const contacts = ContactsApp.getContactsByNotes('sent birthday card');

매개변수

이름	유형	설명
`query`	`String`	연락처의 메모 필드에서 검색할 문자열

리턴

Contact[]: 일치하는 연락처 배열

승인

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

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

참고 항목

getContact(emailAddress)

`getContactsByPhone(query)`

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

전화번호와 일치하는 연락처 가져오기

이 메서드는 문자가 포함된 전화번호를 확장합니다. 따라서 '212-555-CODE'를 검색했는데 연락처에 '212-555-2633'이 있거나 그 반대의 경우 메서드가 적절한 연락처를 찾습니다.

// The code below returns an array of contacts where the contact's phone number
// contains "212-555-1234' in any phone number field.
const contacts = ContactsApp.getContactsByPhone('212-555-1234');

매개변수

이름	유형	설명
`query`	`String`	연락처의 전화번호에서 검색할 문자열

리턴

Contact[]: 일치하는 연락처 배열

승인

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

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

참고 항목

getContact(emailAddress)

`getContactsByPhone(query, label)`

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

특정 필드로 제한된 전화번호와 일치하는 연락처를 가져옵니다.

// The code below returns an array of contacts where the contact's phone number
// contains "212-555-1234" in the Home phone number field.
const contacts = ContactsApp.getContactsByPhone(
    '212-555-1234',
    ContactsApp.Field.HOME_PHONE,
);

매개변수

이름	유형	설명
`query`	`String`	연락처의 전화번호에서 검색할 문자열
`label`	`Field`	검색할 필드

리턴

Contact[]: 일치하는 연락처 배열

승인

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

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

참고 항목

getContact(emailAddress)

`getContactsByPhone(query, label)`

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

지정된 맞춤 전화번호 라벨로 제한된 전화번호와 일치하는 연락처를 가져옵니다.

// The code below returns an array of contacts where the contact's phone number
// contains "212-555-1234" in a custom phone number label (created by the user)
// called "alternate".
const contacts = ContactsApp.getContactsByPhone('212-555-1234', 'alternate');

매개변수

이름	유형	설명
`query`	`String`	지정된 맞춤 전화번호 라벨을 사용하여 연락처의 전화번호에서 검색할 문자열입니다.
`label`	`String`	검색할 맞춤 전화번호 라벨

리턴

Contact[]: 일치하는 연락처 배열

승인

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

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

참고 항목

getContact(emailAddress)

`getContactsByUrl(query)`

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

URL과 일치하는 연락처 가져오기

// The code below returns an array of contacts where the contact's URL contains
// "www.example.com' in any URL field.
const contacts = ContactsApp.getContactsByUrl('www.example.com');

매개변수

이름	유형	설명
`query`	`String`	연락처 URL에서 검색할 문자열

리턴

Contact[]: 일치하는 연락처 배열

승인

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

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

참고 항목

getContact(emailAddress)

`getContactsByUrl(query, label)`

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

특정 필드로 제한된 URL과 일치하는 연락처를 가져옵니다.

// The code below returns an array of contacts where the contact's URL contains
// "www.example.com" in the Work URL field.
const contacts = ContactsApp.getContactsByUrl(
    'www.example.com',
    ContactsApp.Field.WORK_WEBSITE,
);

매개변수

이름	유형	설명
`query`	`String`	연락처 URL에서 검색할 문자열
`label`	`Field`	검색할 필드

리턴

Contact[]: 일치하는 연락처 배열

승인

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

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

참고 항목

getContact(emailAddress)

`getContactsByUrl(query, label)`

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

지정된 맞춤 URL 라벨로 제한된 URL과 일치하는 연락처를 가져옵니다.

// The code below returns an array of contacts where the contact's URL contains
// "www.example.com" in a custom URL label (created by the user) called
// "alternate work".
const contacts = ContactsApp.getContactsByUrl(
    'www.example.com',
    'alternate work',
);

매개변수

이름	유형	설명
`query`	`String`	지정된 맞춤 URL 라벨이 있는 연락처 URL에서 검색할 문자열
`label`	`String`	검색할 맞춤 URL 라벨

리턴

Contact[]: 일치하는 연락처 배열

승인

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

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

참고 항목

getContact(emailAddress)

Class ContactsApp 컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

지원 중단된 속성

지원 중단된 메서드

지원 중단된 메서드

createContact(givenName, familyName, email)

매개변수

리턴

승인

참고 항목

createContactGroup(name)

매개변수

리턴

승인

참고 항목

deleteContact(contact)

매개변수

승인

참고 항목

deleteContactGroup(group)

매개변수

승인

참고 항목

findByEmailAddress(email)

매개변수

리턴

승인

findContactGroup(name)

매개변수

리턴

승인

getAllContacts()

리턴

승인

getContact(emailAddress)

매개변수

리턴

승인

참고 항목

getContactById(id)

매개변수

리턴

승인

참고 항목

getContactGroup(name)

매개변수

리턴

승인

참고 항목

getContactGroupById(id)

매개변수

리턴

참고 항목

getContactGroups()

리턴

승인

참고 항목

getContacts()

리턴

승인

참고 항목

getContactsByAddress(query)

매개변수

리턴

승인

참고 항목

getContactsByAddress(query, label)

매개변수

리턴

승인

참고 항목

getContactsByAddress(query, label)

매개변수

리턴

승인

참고 항목

getContactsByCompany(query)

매개변수

리턴

승인

참고 항목

Class ContactsApp

`createContact(givenName, familyName, email)`

`createContactGroup(name)`

`deleteContact(contact)`

`deleteContactGroup(group)`

`findByEmailAddress(email)`

`findContactGroup(name)`

`getAllContacts()`

`getContact(emailAddress)`

`getContactById(id)`

`getContactGroup(name)`

`getContactGroupById(id)`

`getContactGroups()`

`getContacts()`

`getContactsByAddress(query)`

`getContactsByAddress(query, label)`

`getContactsByAddress(query, label)`

`getContactsByCompany(query)`

`getContactsByCustomField(query, label)`

`getContactsByDate(month, day, label)`

`getContactsByDate(month, day, year, label)`

`getContactsByDate(month, day, year, label)`

`getContactsByDate(month, day, label)`

`getContactsByEmailAddress(query)`

`getContactsByEmailAddress(query, label)`

`getContactsByEmailAddress(query, label)`

`getContactsByGroup(group)`

`getContactsByIM(query)`

`getContactsByIM(query, label)`

`getContactsByIM(query, label)`

`getContactsByJobTitle(query)`

`getContactsByName(query)`