지원 중단되었습니다. 대신 People API 고급 서비스를 사용하세요.
이 클래스를 통해 사용자는 자신의 Google 주소록에 액세스하고 연락처 목록에 있는 연락처를 생성, 삭제, 업데이트할 수 있습니다.
지원 중단된 속성
속성 | 유형 | 설명 |
---|---|---|
ExtendedField |
| |
Field |
| |
Gender |
| |
Month | Month | |
Priority |
| |
Sensitivity |
|
지원 중단된 메서드
지원 중단된 메서드
createContact(givenName, familyName, email)
createContact(givenName, familyName, email)
지원 중단되었습니다. 이 함수는 지원 중단되었으며 새 스크립트에서 사용해서는 안 됩니다.
새 연락처를 만듭니다.
// The code below creates a new contact with the name "John Doe" and the email address // "john.doe@example.com". var contact = ContactsApp.createContact('John', 'Doe', 'john.doe@example.com');
매개변수
이름 | 유형 | 설명 |
---|---|---|
givenName | String | 연락처의 이름 |
familyName | String | 연락처의 성 |
email | String | 연락처의 이메일 주소 |
리턴
— 새로 생성된 연락처 객체Contact
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.google.com/m8/feeds
참고 항목
createContactGroup(name)
createContactGroup(name)
지원 중단되었습니다. 이 함수는 지원 중단되었으며 새 스크립트에서 사용해서는 안 됩니다.
특정 이름의 연락처 그룹을 만듭니다.
// The code below creates a new contact group named "Work Friends" var group = ContactsApp.createContactGroup("Work Friends");
매개변수
이름 | 유형 | 설명 |
---|---|---|
name | String | 새 연락처 그룹의 이름 |
리턴
: 새로 만든 연락처 그룹ContactGroup
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.google.com/m8/feeds
참고 항목
deleteContact(contact)
deleteContact(contact)
지원 중단되었습니다. 이 함수는 지원 중단되었으며 새 스크립트에서 사용해서는 안 됩니다.
연락처를 삭제합니다.
// The code below retrieves a contact with the email address "john.doe@example.com" // and then deletes that contact. var contact = ContactsApp.getContact('john.doe@example.com'); ContactsApp.deleteContact(contact);
매개변수
이름 | 유형 | 설명 |
---|---|---|
contact |
| 삭제할 연락처 |
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.google.com/m8/feeds
참고 항목
deleteContactGroup(group)
deleteContactGroup(group)
지원 중단되었습니다. 이 함수는 지원 중단되었으며 새 스크립트에서 사용해서는 안 됩니다.
연락처 그룹을 삭제합니다.
// The code below creates deletes the contact group named "Work Friends" var group = ContactsApp.getContactGroup("Work Friends"); ContactsApp.deleteContactGroup(group);
매개변수
이름 | 유형 | 설명 |
---|---|---|
group |
| 삭제할 연락처 그룹 |
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.google.com/m8/feeds
참고 항목
findByEmailAddress(email)
findByEmailAddress(email)
findContactGroup(name)
findContactGroup(name)
지원 중단되었습니다. 이 함수는 지원 중단되었으며 새 스크립트에서 사용해서는 안 됩니다.
지정된 이름의 연락처 그룹을 찾습니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
name | String | 연락처 그룹의 이름으로 |
리턴
: 지정된 이름과 일치하는 연락처 그룹ContactGroup
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.google.com/m8/feeds
getAllContacts()
getAllContacts()
getContact(emailAddress)
getContact(emailAddress)
지원 중단되었습니다. 이 함수는 지원 중단되었으며 새 스크립트에서 사용해서는 안 됩니다.
이메일 주소로 연락처를 가져옵니다.
여러 연락처가 동일한 이메일 주소를 공유하는 경우 이 방법은 이메일 주소를 기본 주소로 표시한 연락처를 우선 사용합니다. 기본 이메일 주소로 표시된 이메일 주소가 없거나 기본 이메일 주소가 여러 연락처인 경우 정렬된 연락처 순서로 첫 번째 결과를 반환합니다.
// The code below retrieves a contact with the email address "john.doe@example.com". var contact = ContactsApp.getContact('john.doe@example.com');
매개변수
이름 | 유형 | 설명 |
---|---|---|
emailAddress | String | 연락처의 이메일 주소 |
리턴
: 해당 이메일 주소가 포함된 연락처Contact
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.google.com/m8/feeds
참고 항목
getContactById(id)
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" var id = 'http://www.google.com/m8/feeds/contacts/john.doe%40example.com/base/7c86afde08d34c'; var contact = ContactApp.getContactById(id);
매개변수
이름 | 유형 | 설명 |
---|---|---|
id | String | 검색할 연락처의 ID입니다. |
리턴
— 일치하는 연락처 또는 nullContact
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.google.com/m8/feeds
참고 항목
getContactGroup(name)
getContactGroup(name)
지원 중단되었습니다. 이 함수는 지원 중단되었으며 새 스크립트에서 사용해서는 안 됩니다.
지정된 이름의 연락처 그룹을 가져오거나, 이러한 연락처 그룹이 없으면 null을 반환합니다.
// The code below returns the contact group with the name "Work Friends" var group = ContactsApp.getContactGroup('Work Friends');
매개변수
이름 | 유형 | 설명 |
---|---|---|
name | String | 일치시킬 연락처 그룹의 이름입니다. |
리턴
- 일치하는 연락처 그룹 또는 일치하는 연락처 그룹이 없는 경우 nullContactGroup
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.google.com/m8/feeds
참고 항목
getContactGroupById(id)
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" var id = "http://www.google.com/m8/feeds/groups/john.doe%40example.com/base/54eefbb093fdecb"; var group = ContactsApp.getContactGroupById(id);
매개변수
이름 | 유형 | 설명 |
---|---|---|
id | String | 일치시킬 연락처 그룹의 ID |
리턴
- 일치하는 연락처 그룹 또는 일치하는 연락처 그룹이 없는 경우 nullContactGroup
참고 항목
getContactGroups()
getContactGroups()
지원 중단되었습니다. 이 함수는 지원 중단되었으며 새 스크립트에서 사용해서는 안 됩니다.
사용자 연락처 그룹의 전체 목록을 가져옵니다.
사용자는 연락처 목록을 가질 수 있으며 연락처 그룹 목록도 가질 수 있습니다. 각 연락처 그룹에는 연락처가 포함될 수 있습니다. 이 메서드는 모든 연락처 그룹의 목록을 반환합니다.
// The retrieves all the contract groups for the user and then logs the group name of each // contact group. var groups = ContactsApp.getContactGroups(); for (var i = 0; i < groups.length; i++) { Logger.log(groups[i].getName()); }
리턴
: 사용자 연락처 그룹의 배열ContactGroup[]
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.google.com/m8/feeds
참고 항목
getContacts()
getContacts()
getContactsByAddress(query)
getContactsByAddress(query)
지원 중단되었습니다. 이 함수는 지원 중단되었으며 새 스크립트에서 사용해서는 안 됩니다.
주소와 일치하는 연락처를 가져옵니다.
// The code below returns an array of contacts where the contact's address contains // "San Francisco'. var contacts = ContactsApp.getContactsByAddress('San Francisco');
매개변수
이름 | 유형 | 설명 |
---|---|---|
query | String | 연락처 주소에서 검색할 문자열 |
리턴
: 일치하는 연락처 배열Contact[]
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.google.com/m8/feeds
참고 항목
getContactsByAddress(query, label)
getContactsByAddress(query, label)
지원 중단되었습니다. 이 함수는 지원 중단되었으며 새 스크립트에서 사용해서는 안 됩니다.
특정 입력란으로 제한된 주소와 일치하는 연락처를 가져옵니다.
// The code below returns an array of contacts where the contact's address contains // "San Francisco" in the Home address field. var contacts = ContactsApp.getContactsByAddress('San Francisco', ContactsApp.Field.HOME_ADDRESS);
매개변수
이름 | 유형 | 설명 |
---|---|---|
query | String | 연락처 주소에서 검색할 문자열 |
label |
| 검색할 필드 |
리턴
: 일치하는 연락처 배열Contact[]
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.google.com/m8/feeds
참고 항목
getContactsByAddress(query, label)
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". var contacts = ContactsApp.getContactsByAddress('San Francisco', 'vacation');
매개변수
이름 | 유형 | 설명 |
---|---|---|
query | String | 지정된 맞춤 주소 라벨이 있는 연락처 주소에서 검색할 문자열입니다. |
label | String | 검색할 맞춤 주소 라벨 |
리턴
: 일치하는 연락처 배열Contact[]
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.google.com/m8/feeds
참고 항목
getContactsByCompany(query)
getContactsByCompany(query)
지원 중단되었습니다. 이 함수는 지원 중단되었으며 새 스크립트에서 사용해서는 안 됩니다.
회사 입력란과 일치하는 연락처를 가져옵니다.
// The code below returns an array of contacts where the contact's company field // contains "Google". var contacts = ContactsApp.getContactsByCompany('Google');
매개변수
이름 | 유형 | 설명 |
---|---|---|
query | String | 연락처의 회사 필드에서 검색할 문자열 |
리턴
: 일치하는 연락처 배열Contact[]
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.google.com/m8/feeds
참고 항목
getContactsByCustomField(query, label)
getContactsByCustomField(query, label)
지원 중단되었습니다. 이 함수는 지원 중단되었으며 새 스크립트에서 사용해서는 안 됩니다.
맞춤 입력란의 특정 값과 일치하는 연락처를 가져옵니다.
맞춤 필드는 문자열로 지정하거나 ContactsApp.ExtendedField 값 중 하나로 지정할 수 있습니다.
// The code below returns an array of contacts where the contact's custom field // named "Favorite Sport" contains "tennis". var contacts = ContactsApp.getContactsByCustomField('tennis', 'Favorite Sport');
매개변수
이름 | 유형 | 설명 |
---|---|---|
query | Object | 연락처의 맞춤 입력란에서 검색할 문자열입니다. |
label |
| 검색할 맞춤 입력란 |
리턴
: 일치하는 연락처 배열Contact[]
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.google.com/m8/feeds
참고 항목
getContactsByDate(month, day, label)
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. var contacts = ContactsApp.getContactsByDate(ContactsApp.Month.APRIL, 19, ContactsApp.Field.BIRTHDAY);
매개변수
이름 | 유형 | 설명 |
---|---|---|
month | Month | ContactsApp.Month의 값 중 하나로 일치시킬 월입니다. |
day | Integer | 경기일 |
label |
| ContactsApp.Field에서 검색할 필드 |
리턴
: 일치하는 연락처 배열Contact[]
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.google.com/m8/feeds
참고 항목
getContactsByDate(month, day, year, label)
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. var contacts = ContactsApp.getContactsByDate(ContactsApp.Month.APRIL, 19, 1950, ContactsApp.Field.BIRTHDAY);
매개변수
이름 | 유형 | 설명 |
---|---|---|
month | Month | ContactsApp.Month의 값 중 하나로 일치시킬 월입니다. |
day | Integer | 경기일 |
year | Integer | 일치시킬 연도이며 null일 수 있습니다. |
label |
| ContactsApp.Field에서 검색할 필드 |
리턴
: 일치하는 연락처 배열Contact[]
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.google.com/m8/feeds
참고 항목
getContactsByDate(month, day, year, label)
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. var 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
참고 항목
getContactsByDate(month, day, label)
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. var contacts = ContactsApp.getContactsByDate(ContactsApp.Month.APRIL, 19, 'Start Date');
매개변수
이름 | 유형 | 설명 |
---|---|---|
month | Month | ContactsApp.Month의 값 중 하나로 일치시킬 월입니다. |
day | Integer | 경기일 |
label | String | 검색할 맞춤 입력란 |
리턴
: 일치하는 연락처 배열Contact[]
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.google.com/m8/feeds
참고 항목
getContactsByEmailAddress(query)
getContactsByEmailAddress(query)
지원 중단되었습니다. 이 함수는 지원 중단되었으며 새 스크립트에서 사용해서는 안 됩니다.
이메일 주소와 일치하는 연락처를 가져옵니다.
// The code below returns an array of contacts where the contact's email address contains // "john.doe@example.com'. var contacts = ContactsApp.getContactsByEmailAddress('john.doe@example.com');
매개변수
이름 | 유형 | 설명 |
---|---|---|
query | String | 연락처 이메일 주소에서 검색할 문자열입니다. |
리턴
: 일치하는 연락처 배열Contact[]
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.google.com/m8/feeds
참고 항목
getContactsByEmailAddress(query, label)
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. var contacts = ContactsApp.getContactsByEmailAddress('john.doe@example.com', ContactsApp.Field.HOME_EMAIL);
매개변수
이름 | 유형 | 설명 |
---|---|---|
query | String | 연락처 이메일 주소에서 검색할 문자열입니다. |
label |
| 검색할 필드 |
리턴
: 일치하는 연락처 배열Contact[]
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.google.com/m8/feeds
참고 항목
getContactsByEmailAddress(query, label)
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". var contacts = ContactsApp.getContactsByEmailAddress('john.doe@example.com', 'alternate');
매개변수
이름 | 유형 | 설명 |
---|---|---|
query | String | 지정된 커스텀 이메일 주소 라벨이 있는 연락처 이메일 주소에서 검색할 문자열입니다. |
label | String | 검색할 맞춤 이메일 주소 라벨 |
리턴
: 일치하는 연락처 배열Contact[]
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.google.com/m8/feeds
참고 항목
getContactsByGroup(group)
getContactsByGroup(group)
지원 중단되었습니다. 이 함수는 지원 중단되었으며 새 스크립트에서 사용해서는 안 됩니다.
지정된 ContactGroup의 연락처를 가져옵니다.
// The code below returns an array of contacts in the ContactGroup with the name // "Work Friends". var group = ContactsApp.getContactGroup('Work Friends'); var contacts = ContactsApp.getContactsByGroup(group);
매개변수
이름 | 유형 | 설명 |
---|---|---|
group |
| 연락처 그룹 |
리턴
: 지정된 그룹의 연락처 배열Contact[]
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.google.com/m8/feeds
참고 항목
getContactsByIM(query)
getContactsByIM(query)
지원 중단되었습니다. 이 함수는 지원 중단되었으며 새 스크립트에서 사용해서는 안 됩니다.
채팅 주소와 일치하는 연락처를 가져옵니다.
// The code below returns an array of contacts where the contact's instant messaging address // contains "ChatWithJohnDoe" in any instant messaging field. var contacts = ContactsApp.getContactsByIM('ChatWithJohnDoe');
매개변수
이름 | 유형 | 설명 |
---|---|---|
query | String | 연락처의 채팅 주소에서 검색할 문자열입니다. |
리턴
: 일치하는 연락처 배열Contact[]
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.google.com/m8/feeds
참고 항목
getContactsByIM(query, label)
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. var contacts = ContactsApp.getContactsByIM('ChatWithJohnDoe', ContactsApp.Field.AIM);
매개변수
이름 | 유형 | 설명 |
---|---|---|
query | String | 연락처의 채팅 주소에서 검색할 문자열입니다. |
label |
| 검색할 필드 |
리턴
: 일치하는 연락처 배열Contact[]
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.google.com/m8/feeds
참고 항목
getContactsByIM(query, label)
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". var contacts = ContactsApp.getContactsByIM('ChatWithJohnDoe', 'eBuddy');
매개변수
이름 | 유형 | 설명 |
---|---|---|
query | String | 지정된 맞춤 채팅 라벨이 있는 연락처의 채팅 주소에서 검색할 문자열입니다. |
label | String | 다음 내에서 검색할 수 있는 맞춤 채팅 라벨 |
리턴
: 일치하는 연락처 배열Contact[]
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.google.com/m8/feeds
참고 항목
getContactsByJobTitle(query)
getContactsByJobTitle(query)
지원 중단되었습니다. 이 함수는 지원 중단되었으며 새 스크립트에서 사용해서는 안 됩니다.
직책 입력란과 일치하는 연락처를 가져옵니다.
// The code below returns an array of contacts where the contact's job title field // contains "Product Manager". var contacts = ContactsApp.getContactsByJobTitle('Product Manager');
매개변수
이름 | 유형 | 설명 |
---|---|---|
query | String | 연락처의 직책 필드에서 검색할 문자열 |
리턴
: 일치하는 연락처 배열Contact[]
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.google.com/m8/feeds
참고 항목
getContactsByName(query)
getContactsByName(query)
지원 중단되었습니다. 이 함수는 지원 중단되었으며 새 스크립트에서 사용해서는 안 됩니다.
이름과 일치하는 연락처를 가져옵니다.
// The code below returns an array of contacts where the contact name contains "John" var contacts = ContactsApp.getContactsByName('John');
매개변수
이름 | 유형 | 설명 |
---|---|---|
query | String | 연락처 이름에서 검색할 문자열 |
리턴
: 일치하는 연락처 배열Contact[]
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.google.com/m8/feeds
참고 항목
getContactsByName(query, label)
getContactsByName(query, label)
지원 중단되었습니다. 이 함수는 지원 중단되었으며 새 스크립트에서 사용해서는 안 됩니다.
특정 필드로 제한된 이름과 일치하는 연락처를 가져옵니다.
// The code below returns an array of contacts where the contact name contains "John" // in the Given Name field. var contacts = ContactsApp.getContactsByName('John', ContactsApp.Field.GIVEN_NAME);
매개변수
이름 | 유형 | 설명 |
---|---|---|
query | String | 연락처 이름에서 검색할 문자열 |
label |
| 검색할 필드 |
리턴
: 일치하는 연락처 배열Contact[]
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.google.com/m8/feeds
참고 항목
getContactsByNotes(query)
getContactsByNotes(query)
지원 중단되었습니다. 이 함수는 지원 중단되었으며 새 스크립트에서 사용해서는 안 됩니다.
메모 입력란과 일치하는 연락처를 가져옵니다.
// The code below returns an array of contacts where the contact's notes field // contains "sent birthday card". var contacts = ContactsApp.getContactsByNotes('sent birthday card');
매개변수
이름 | 유형 | 설명 |
---|---|---|
query | String | 연락처 메모 필드에서 검색할 문자열 |
리턴
: 일치하는 연락처 배열Contact[]
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.google.com/m8/feeds
참고 항목
getContactsByPhone(query)
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. var contacts = ContactsApp.getContactsByPhone('212-555-1234');
매개변수
이름 | 유형 | 설명 |
---|---|---|
query | String | 연락처의 전화번호에서 검색할 문자열입니다. |
리턴
: 일치하는 연락처 배열Contact[]
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.google.com/m8/feeds
참고 항목
getContactsByPhone(query, label)
getContactsByPhone(query, label)
지원 중단되었습니다. 이 함수는 지원 중단되었으며 새 스크립트에서 사용해서는 안 됩니다.
특정 필드로 제한된 전화번호와 일치하는 연락처를 가져옵니다.
이 메서드는 글자화된 전화번호를 확장하므로 '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 the Home phone number field. var contacts = ContactsApp.getContactsByPhone('212-555-1234', ContactsApp.Field.HOME_PHONE);
매개변수
이름 | 유형 | 설명 |
---|---|---|
query | String | 연락처의 전화번호에서 검색할 문자열입니다. |
label |
| 검색할 필드 |
리턴
: 일치하는 연락처 배열Contact[]
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.google.com/m8/feeds
참고 항목
getContactsByPhone(query, label)
getContactsByPhone(query, label)
지원 중단되었습니다. 이 함수는 지원 중단되었으며 새 스크립트에서 사용해서는 안 됩니다.
지정된 맞춤 전화번호 라벨로 제한된 전화번호와 일치하는 연락처를 가져옵니다.
이 메서드는 글자화된 전화번호를 확장하므로 '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 a custom phone number label (created by the user) called // "alternate". var contacts = ContactsApp.getContactsByPhone('212-555-1234', 'alternate');
매개변수
이름 | 유형 | 설명 |
---|---|---|
query | String | 지정된 맞춤 전화번호 라벨이 있는 연락처의 전화번호에서 검색할 문자열입니다. |
label | String | 검색할 맞춤 전화번호 라벨 |
리턴
: 일치하는 연락처 배열Contact[]
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.google.com/m8/feeds
참고 항목
getContactsByUrl(query)
getContactsByUrl(query)
지원 중단되었습니다. 이 함수는 지원 중단되었으며 새 스크립트에서 사용해서는 안 됩니다.
URL과 일치하는 연락처를 가져옵니다.
// The code below returns an array of contacts where the contact's URL contains // "www.example.com' in any URL field. var contacts = ContactsApp.getContactsByUrl('www.example.com');
매개변수
이름 | 유형 | 설명 |
---|---|---|
query | String | 연락처의 URL에서 검색할 문자열 |
리턴
: 일치하는 연락처 배열Contact[]
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.google.com/m8/feeds
참고 항목
getContactsByUrl(query, label)
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. var contacts = ContactsApp.getContactsByUrl('www.example.com', ContactsApp.Field.WORK_WEBSITE);
매개변수
이름 | 유형 | 설명 |
---|---|---|
query | String | 연락처의 URL에서 검색할 문자열 |
label |
| 검색할 필드 |
리턴
: 일치하는 연락처 배열Contact[]
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.google.com/m8/feeds
참고 항목
getContactsByUrl(query, label)
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". var contacts = ContactsApp.getContactsByUrl('www.example.com', 'alternate work');
매개변수
이름 | 유형 | 설명 |
---|---|---|
query | String | 지정된 맞춤 URL 라벨이 있는 연락처 URL에서 검색할 문자열입니다. |
label | String | 검색할 맞춤 URL 라벨 |
리턴
: 일치하는 연락처 배열Contact[]
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.google.com/m8/feeds