이 페이지는 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)