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

Class ContactsApp

이 클래스를 통해 사용자는 자신의 Google 주소록에 액세스하고 연락처를 생성, 삭제, 업데이트할 수 있습니다. 연락처가 표시됩니다.

지원 중단된 속성

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

지원 중단된 메서드

메서드	반환 유형	간략한 설명
`createContact(givenName, familyName, email)`	`Contact`	새 연락처를 만듭니다.
`createContactGroup(name)`	`ContactGroup`	지정된 이름으로 연락처 그룹을 만듭니다.
`deleteContact(contact)`	`void`	연락처를 삭제합니다.
`deleteContactGroup(group)`	`void`	연락처 그룹을 삭제합니다.
`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".
var 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"
var 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.
var 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"
var 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".
var 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"
var id = 'http://www.google.com/m8/feeds/contacts/john.doe%40example.com/base/7c86afde08d34c';
var contact = ContactApp.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"
var 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"
var id = "http://www.google.com/m8/feeds/groups/john.doe%40example.com/base/54eefbb093fdecb";
var 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.
var groups  = ContactsApp.getContactGroups();
for (var 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
var 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'.
var 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.
var 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".
var 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".
var 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".
var 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.
var 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.
var 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.
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

참고 항목

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

참고 항목

getContact(emailAddress)

`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

참고 항목

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.
var 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".
var 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".
var group  = ContactsApp.getContactGroup('Work Friends');
var 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.
var 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.
var 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".
var 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".
var 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"
var 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.
var 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".
var 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.
var contacts = ContactsApp.getContactsByPhone('212-555-1234');

매개변수

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

리턴

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

승인

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

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

참고 항목

getContact(emailAddress)

`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`	`Field`	검색할 필드입니다.

리턴

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

승인

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

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

참고 항목

getContact(emailAddress)

`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

참고 항목

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.
var 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.
var 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".
var contacts = ContactsApp.getContactsByUrl('www.example.com', 'alternate work');

매개변수

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

리턴

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

승인

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

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

참고 항목

getContact(emailAddress)