Class Contact

연락처

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

연락처에는 연락처의 이름, 주소, 다양한 연락처 세부정보가 포함됩니다.

메서드반환 유형간략한 설명
addAddress(label, address)AddressField연락처에 표준 또는 맞춤 라벨이 지정된 주소를 추가합니다.
addCompany(company, title)CompanyField연락처에 회사를 추가합니다.
addCustomField(label, content)CustomField연락처에 확장 라벨 또는 맞춤 라벨이 있는 맞춤 입력란을 추가합니다.
addDate(label, month, day, year)DateField연락처에 표준 또는 맞춤 라벨이 지정된 날짜를 추가합니다.
addEmail(label, address)EmailField표준 라벨 (집, 직장 등) 또는 맞춤 라벨이 지정된 이메일 주소 추가
{@code
// The code below retrieves a contact named "John Doe" and adds the email
// address "j.doe@example.com" to the ContactsApp.Field.HOME_EMAIL label.
addIM(label, address)IMField표준 또는 맞춤 라벨이 지정된 채팅 주소를 연락처에 추가합니다.
addPhone(label, number)PhoneField표준 또는 맞춤 라벨이 지정된 전화번호를 연락처에 추가합니다.
addToGroup(group)Contact지정된 연락처 그룹에 이 연락처를 추가합니다.
addUrl(label, url)UrlField표준 또는 맞춤 라벨이 지정된 URL을 연락처에 추가합니다.
deleteContact()void이 연락처를 삭제합니다.
getAddresses()AddressField[]이 연락처의 모든 주소를 가져옵니다.
getAddresses(label)AddressField[]특정 필드와 일치하는 이 연락처의 모든 주소를 가져옵니다.
getCompanies()CompanyField[]이 연락처의 모든 회사를 가져옵니다.
getContactGroups()ContactGroup[]이 연락처가 포함된 모든 연락처 그룹을 가져옵니다.
getCustomFields()CustomField[]이 연락처의 모든 맞춤 입력란을 가져옵니다.
getCustomFields(label)CustomField[]특정 필드와 일치하는 이 연락처의 모든 맞춤 입력란을 가져옵니다.
getDates()DateField[]이 연락처의 모든 날짜를 가져옵니다.
getDates(label)DateField[]특정 필드와 일치하는 이 연락처의 모든 날짜를 가져옵니다.
getEmailAddresses()String[]이 연락처에 사용할 수 있는 이메일 주소 목록을 가져옵니다.
getEmails()EmailField[]이 연락처의 이메일 주소를 가져옵니다.
getEmails(label)EmailField[]특정 입력란과 일치하는 이 연락처의 이메일 주소를 가져옵니다.
getFamilyName()String연락처의 성 (last name)을 문자열로 가져옵니다.
getFullName()String연락처의 전체 이름 (이름 및 성)을 문자열로 가져옵니다.
getGivenName()String연락처의 이름 (이름)을 문자열로 가져옵니다.
getHomeAddress()String이 연락처의 집 주소를 가져오거나 주소가 없는 경우 빈 문자열을 가져옵니다.
getHomeFax()String이 연락처의 집 팩스 번호를 가져오거나 팩스 번호가 없는 경우 빈 문자열을 가져옵니다.
getHomePhone()String이 연락처의 집 전화번호를 가져오거나 전화번호가 없는 경우 빈 문자열을 가져옵니다.
getIMs()IMField[]이 연락처의 모든 IM 주소를 가져옵니다.
getIMs(label)IMField[]특정 필드와 일치하는 이 연락처의 모든 IM 주소를 가져옵니다.
getId()String이 연락처의 고유 ID를 반환합니다.
getInitials()String연락처의 이니셜을 가져옵니다.
getLastUpdated()Date이 연락처가 마지막으로 업데이트된 날짜를 가져옵니다.
getMaidenName()String연락처의 성명 중 첫 번째 이름을 문자열로 가져옵니다.
getMiddleName()String연락처의 중간 이름을 문자열로 가져옵니다.
getMobilePhone()String이 연락처의 휴대전화 번호를 가져오거나 번호가 없는 경우 빈 문자열을 가져옵니다.
getNickname()String문자열로 연락처의 닉네임을 가져옵니다.
getNotes()String이 연락처와 연결된 메모를 가져오거나 메모가 없는 경우 빈 문자열을 가져옵니다.
getPager()String이 연락처의 пей저 전화번호를 가져오거나 페이저 전화번호가 없는 경우 빈 문자열을 가져옵니다.
getPhones()PhoneField[]이 연락처의 모든 전화번호를 가져옵니다.
getPhones(label)PhoneField[]특정 필드와 일치하는 이 연락처의 모든 전화번호를 가져옵니다.
getPrefix()String연락처 이름의 접두사를 가져옵니다.
getPrimaryEmail()String연락처의 기본 이메일 주소를 문자열로 가져옵니다.
getShortName()String연락처의 약어 이름을 문자열로 가져옵니다.
getSuffix()String연락처 이름의 접미사를 가져옵니다.
getUrls()UrlField[]이 연락처의 모든 URL을 가져옵니다.
getUrls(label)UrlField[]특정 필드와 일치하는 이 연락처의 모든 URL을 가져옵니다.
getUserDefinedField(key)String지정된 키와 연결된 사용자 정의 값을 가져옵니다.
getUserDefinedFields()Object이 연락처의 모든 사용자 정의 필드를 가져와 JavaScript 객체의 속성으로 반환합니다.
getWorkAddress()String이 연락처의 직장 주소를 가져오거나 주소가 없는 경우 빈 문자열을 가져옵니다.
getWorkFax()String이 연락처의 직장 팩스 번호를 가져오거나 팩스 번호가 없는 경우 빈 문자열을 가져옵니다.
getWorkPhone()String이 연락처의 직장 전화번호를 가져오거나 전화번호가 없는 경우 빈 문자열을 가져옵니다.
removeFromGroup(group)Contact지정된 연락처 그룹에서 이 연락처를 삭제합니다.
setFamilyName(familyName)Contact연락처의 성 (last name)을 설정합니다.
setFullName(fullName)Contact연락처의 전체 이름 (이름 및 성)을 설정합니다.
setGivenName(givenName)Contact연락처의 이름 (이름)을 설정합니다.
setHomeAddress(addr)void이 연락처의 집 주소를 설정합니다.
setHomeFax(phone)void이 연락처의 집 팩스 번호를 설정합니다.
setHomePhone(phone)void이 연락처의 집 전화번호를 설정합니다.
setInitials(initials)Contact연락처의 이니셜을 설정합니다.
setMaidenName(maidenName)Contact연락처의 결혼 전 이름을 설정합니다.
setMiddleName(middleName)Contact연락처의 중간 이름을 설정합니다.
setMobilePhone(phone)void이 연락처의 휴대전화 번호를 설정합니다.
setNickname(nickname)Contact연락처의 닉네임을 설정합니다.
setNotes(notes)Contact이 연락처와 연결된 메모를 설정합니다.
setPager(phone)void이 연락처의 페이저 번호를 설정합니다.
setPrefix(prefix)Contact연락처 이름의 접두사를 설정합니다.
setPrimaryEmail(primaryEmail)void이 연락처의 기본 이메일 주소를 설정합니다.
setShortName(shortName)Contact연락처의 약어를 설정합니다.
setSuffix(suffix)Contact연락처 이름에 접미사를 설정합니다.
setUserDefinedField(key, value)void지정된 키로 저장되도록 이 연락처의 단일 사용자 정의 필드를 설정합니다.
setUserDefinedFields(o)void이 연락처의 사용자 정의 필드를 지정된 객체의 속성으로 설정합니다.
setWorkAddress(addr)void이 연락처의 직장 주소를 설정합니다.
setWorkFax(phone)void이 연락처의 직장 팩스 번호를 설정합니다.
setWorkPhone(phone)void이 연락처의 직장 전화번호를 설정합니다.

지원 중단된 메서드

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

연락처에 표준 또는 맞춤 라벨이 지정된 주소를 추가합니다.

라벨은 ContactsApp.Field의 라벨이거나 맞춤 라벨 문자열일 수 있습니다.

// The code below retrieves a contact named "John Doe" and adds the address
// "123 Main St, Some City, NY 10011" with the ContactsApp.Field.WORK_ADDRESS
// label.
const contacts = ContactsApp.getContactsByName('John Doe');
const address = contacts[0].addAddress(
    ContactsApp.Field.WORK_ADDRESS,
    '123 Main St, Some City, NY 10011',
);

매개변수

이름유형설명
labelObject새 주소의 라벨(ContactsApp.Field 또는 맞춤 문자열)
addressString새 주소

리턴

AddressField: 새로 생성된 필드

승인

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

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

참고 항목


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

연락처에 회사를 추가합니다.

// The code below retrieves a contact named "John Doe" and adds the company
// "Google" and the job title "Product Manager".
const contacts = ContactsApp.getContactsByName('John Doe');
const url = contacts[0].addCompany('Google', 'Product Manager');

매개변수

이름유형설명
companyString이 연락처에 추가할 회사 이름
titleString이 회사의 이 담당자와 연결된 직책

리턴

CompanyField: 새로 생성된 필드

승인

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

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

참고 항목


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

연락처에 확장 라벨 또는 맞춤 라벨이 있는 맞춤 입력란을 추가합니다.

라벨은 ContactsApp.ExtendedField의 라벨이거나 맞춤 라벨 문자열일 수 있습니다.

// The code below retrieves a contact named "John Doe" and adds the custom field
// ContactsApp.ExtendedField.HOBBY with the value "hiking".
// Note that ContactsApp.ExtendedField.HOBBY is not the same as a custom field
// named 'HOBBY'.
const contacts = ContactsApp.getContactsByName('John Doe');
contacts[0].addCustomField(ContactsApp.ExtendedField.HOBBY, 'hiking');

매개변수

이름유형설명
labelObject새 주소의 라벨(ContactsApp.ExtendedField 또는 맞춤 문자열)
contentObject맞춤 입력란에 저장할 값

리턴

CustomField: 새로 생성된 필드

승인

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

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

참고 항목


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

연락처에 표준 또는 맞춤 라벨이 지정된 날짜를 추가합니다.

라벨은 ContactsApp.Field의 라벨이거나 맞춤 라벨 문자열일 수 있습니다.

// The code below retrieves a contact named "John Doe" and adds a
// ContactsApp.ExtendedField.BIRTHDAY with the value "April 19, 1950".
const contacts = ContactsApp.getContactsByName('John Doe');
const birthday = contacts[0].addDate(
    ContactsApp.Field.BIRTHDAY,
    ContactsApp.Month.APRIL,
    19,
    1950,
);

매개변수

이름유형설명
labelObject새 날짜의 라벨(ContactsApp.Field 또는 맞춤 문자열)
monthMonthContactApps.Month의 월
dayInteger하루
yearInteger연도

리턴

DateField: 새로 생성된 날짜

승인

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

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

참고 항목


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

표준 라벨 (집, 직장 등) 또는 맞춤 라벨이 지정된 이메일 주소 추가

// The code below retrieves a contact named "John Doe" and adds the email
// address "j.doe@example.com" to the ContactsApp.Field.HOME_EMAIL label.
const contacts = ContactsApp.getContactsByName('John Doe');
const emailField = contacts[0].addEmail(
    ContactsApp.Field.HOME_EMAIL,
    'j.doe@example.com',
);

매개변수

이름유형설명
labelObject새 이메일의 라벨(ContactsApp.Field 또는 맞춤 문자열)
addressString새 이메일 주소

리턴

EmailField: 새로 추가된 필드

승인

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

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

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

표준 또는 맞춤 라벨이 지정된 채팅 주소를 연락처에 추가합니다.

라벨은 ContactsApp.Field의 라벨이거나 맞춤 라벨 문자열일 수 있습니다.

// The code below retrieves a contact named "John Doe" and adds the IM address
// "ChatWithJohn" with the ContactsApp.Field.AIM label.
const contacts = ContactsApp.getContactsByName('John Doe');
const email = contacts[0].addIM(ContactsApp.Field.AIM, 'ChatWithJohn');

매개변수

이름유형설명
labelObject새 IM 주소의 라벨(ContactsApp.Field 또는 맞춤 문자열)
addressString새 IM 주소

리턴

IMField: 새로 생성된 필드

승인

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

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

참고 항목


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

표준 또는 맞춤 라벨이 지정된 전화번호를 연락처에 추가합니다.

라벨은 ContactsApp.Field의 라벨이거나 맞춤 라벨 문자열일 수 있습니다.

// The code below retrieves a contact named "John Doe" and adds the phone number
// "212-555-1234" with the ContactsApp.Field.WORK_PHONE label.
const contacts = ContactsApp.getContactsByName('John Doe');
const phone = contacts[0].addPhone(
    ContactsApp.Field.WORK_PHONE,
    '212-555-1234',
);

매개변수

이름유형설명
labelObject새 전화번호의 라벨(ContactsApp.Field 또는 맞춤 문자열)
numberString새 전화번호

리턴

PhoneField: 새로 생성된 필드

승인

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

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

참고 항목


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

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

// The code below creates a new contact and then adds it to the contact group
// named "Work Friends"
let contact = ContactsApp.createContact('John', 'Doe', 'john.doe@example.com');
const group = ContactsApp.getContactGroup('Work Friends');
contact = contact.addToGroup(group);

매개변수

이름유형설명
groupContactGroup이 연락처를 추가할 연락처 그룹

리턴

Contact: 이 연락처

승인

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

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

참고 항목


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

표준 또는 맞춤 라벨이 지정된 URL을 연락처에 추가합니다.

라벨은 ContactsApp.Field의 라벨이거나 맞춤 라벨 문자열일 수 있습니다.

// The code below retrieves a contact named "John Doe" and adds the URL
// "http://www.example.com" with the ContactsApp.Field.WORK_WEBSITE label.
const contacts = ContactsApp.getContactsByName('John Doe');
const url = contacts[0].addUrl(
    ContactsApp.Field.WORK_WEBSITE,
    'http://www.example.com',
);

매개변수

이름유형설명
labelObject새 주소의 라벨(ContactsApp.Field 또는 맞춤 문자열)
urlString새 URL

리턴

UrlField: 새로 생성된 필드

승인

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

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

참고 항목


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

이 연락처를 삭제합니다.

const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  contacts[i].deleteContact();
}

승인

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

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

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

이 연락처의 모든 주소를 가져옵니다.

// The code below logs the addresses of all the contacts whose names contain
// "John Doe"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  Logger.log(contacts[i].getAddresses());
}

리턴

AddressField[]: 주소 목록

승인

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

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

참고 항목


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

특정 필드와 일치하는 이 연락처의 모든 주소를 가져옵니다.

라벨은 ContactsApp.Field의 라벨이거나 맞춤 라벨 문자열일 수 있습니다.

// The code below retrieves a contact named "John Doe" and logs the addresses
// associated with that contact that are in the ContactsApp.Field.WORK_ADDRESS
// label.
const contacts = ContactsApp.getContactsByName('John Doe');
const addresses = contacts[0].getAddresses(ContactsApp.Field.WORK_ADDRESS);
for (const i in addresses) {
  Logger.log(addresses[i].getAddress());
}

매개변수

이름유형설명
labelObject일치시킬 라벨(ContactsApp.Field 또는 맞춤 문자열)

리턴

AddressField[]: 주소 목록

승인

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

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

참고 항목


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

이 연락처의 모든 회사를 가져옵니다.

// The code below logs the company names of all the contacts whose names contain
// "John Doe"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  const companies = contacts[i].getCompanies();
  for (const j in companies) {
    Logger.log(companies[j].getCompanyName());
  }
}

리턴

CompanyField[] — 회사 목록

승인

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

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

참고 항목


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

이 연락처가 포함된 모든 연락처 그룹을 가져옵니다.

// The code below gets a contact named "John Doe" and retrieves all the contact
// groups that the contact belongs to
const contacts = ContactsApp.getContactsByName('John Doe');
const groups = contacts[0].getContactGroups();

리턴

ContactGroup[]: 이 연락처가 포함된 그룹

참고 항목


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

이 연락처의 모든 맞춤 입력란을 가져옵니다.

// The code below retrieves a contact named "John Doe" and logs the custom
// fields associated with that contact
const contacts = ContactsApp.getContactsByName('John Doe');
const fields = contacts[0].getCustomFields();
for (const i in fields) {
  Logger.log(fields[i].getValue());
}

리턴

CustomField[]: 맞춤 필드 목록

승인

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

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

참고 항목


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

특정 필드와 일치하는 이 연락처의 모든 맞춤 입력란을 가져옵니다.

라벨은 ContactsApp.ExtendedField의 표준 라벨 또는 맞춤 라벨 문자열일 수 있습니다.

// The code below retrieves a contact named "John Doe" and logs the custom
// fields associated with that contact that are in the
// ContactsApp.ExtendedField.HOBBY label.
const contacts = ContactsApp.getContactsByName('John Doe');
const hobbies = contacts[0].getCustomFields(ContactsApp.ExtendedField.HOBBY);
for (const i in hobbies) {
  Logger.log(hobbies[i].getValue());
}

매개변수

이름유형설명
labelObject일치시킬 라벨(ContactsApp.ExtendedField 또는 맞춤 문자열)

리턴

CustomField[]: 맞춤 필드 목록

승인

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

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

참고 항목


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

이 연락처의 모든 날짜를 가져옵니다.

// The code below retrieves a contact named "John Doe" and logs the label of the
// date associated with that contact
const contacts = ContactsApp.getContactsByName('John Doe');
const dates = contacts[0].getDates();
for (const i in dates) {
  Logger.log(dates[i].getLabel());
}

리턴

DateField[]: 날짜 목록

승인

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

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

참고 항목


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

특정 필드와 일치하는 이 연락처의 모든 날짜를 가져옵니다.

라벨은 ContactsApp.Field의 표준 라벨 또는 맞춤 라벨 문자열일 수 있습니다.

// The code below retrieves a contact named "John Doe" and logs the day of the
// month associated with that contact that are in the ContactsApp.Field.BIRTHDAY
// label.
const contacts = ContactsApp.getContactsByName('John Doe');
const birthdays = contacts[0].getDates(ContactsApp.Field.BIRTHDAY);
for (const i in birthdays) {
  Logger.log(birthdays[i].getDay());
}

매개변수

이름유형설명
labelObject일치시킬 라벨(ContactsApp.Field 또는 맞춤 문자열)

리턴

DateField[]: 날짜 목록

승인

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

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

참고 항목


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

이 연락처에 사용할 수 있는 이메일 주소 목록을 가져옵니다.

리턴

String[]: 이 연락처에 사용할 수 있는 이메일 주소 목록

승인

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

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

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

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

// The code below retrieves a contact named "John Doe" and logs the email
// addresses associated with that contact
const contacts = ContactsApp.getContactsByName('John Doe');
const emails = contacts[0].getEmails();
for (const i in emails) {
  Logger.log(emails[i].getAddress());
}

리턴

EmailField[]: 연락처의 이메일 주소 목록

승인

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

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

참고 항목


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

특정 입력란과 일치하는 이 연락처의 이메일 주소를 가져옵니다.

라벨은 ContactsApp.Field의 표준 라벨 또는 맞춤 라벨 문자열일 수 있습니다.

// The code below retrieves a contact named "John Doe" and logs the email
// addresses associated with that contact that are in the
// ContactsApp.Field.HOME_EMAIL label.
const contacts = ContactsApp.getContactsByName('John Doe');
const emails = contacts[0].getEmails(ContactsApp.Field.HOME_EMAIL);
for (const i in emails) {
  Logger.log(emails[i].getAddress());
}

매개변수

이름유형설명
labelObject일치시킬 라벨(ContactsApp.Field 또는 맞춤 문자열)

리턴

EmailField[]: 연락처의 이메일 주소 목록

승인

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

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

참고 항목


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

연락처의 성 (last name)을 문자열로 가져옵니다.

// The code below logs the family name of all the contacts whose names contain
// "John"
const contacts = ContactsApp.getContactsByName('John');
for (const i in contacts) {
  Logger.log(contacts[i].getFamilyName());
}

리턴

String: 연락처의 성

승인

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

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

참고 항목


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

연락처의 전체 이름 (이름 및 성)을 문자열로 가져옵니다.

// The code below logs the full name of all the contacts whose names contain
// "John"
const contacts = ContactsApp.getContactsByName('John');
for (const i in contacts) {
  Logger.log(contacts[i].getFullName());
}

리턴

String: 연락처의 전체 이름

승인

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

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

참고 항목


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

연락처의 이름 (이름)을 문자열로 가져옵니다.

// The code below logs the given name of all the contacts whose names contain
// "Smith"
const contacts = ContactsApp.getContactsByName('Smith');
for (const i in contacts) {
  Logger.log(contacts[i].getGivenName());
}

리턴

String: 연락처의 이름입니다.

승인

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

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

참고 항목


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

이 연락처의 집 주소를 가져오거나 주소가 없는 경우 빈 문자열을 가져옵니다.

리턴

String: 이 연락처의 집 주소 또는 주소가 없는 경우 빈 문자열

승인

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

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

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

이 연락처의 집 팩스 번호를 가져오거나 팩스 번호가 없는 경우 빈 문자열을 가져옵니다.

리턴

String: 이 연락처의 집 팩스 번호 또는 팩스 번호가 없는 경우 빈 문자열

승인

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

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

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

이 연락처의 집 전화번호를 가져오거나 전화번호가 없는 경우 빈 문자열을 가져옵니다.

리턴

String: 이 연락처의 집 전화번호 또는 전화번호가 없는 경우 빈 문자열

승인

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

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

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

이 연락처의 모든 IM 주소를 가져옵니다.

// The code below logs the IM addresses of all the contacts whose names contain
// "John Doe"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  Logger.log(contacts[i].getIMs());
}

리턴

IMField[]: IM 주소 목록

승인

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

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

참고 항목


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

특정 필드와 일치하는 이 연락처의 모든 IM 주소를 가져옵니다.

라벨은 ContactsApp.Field의 라벨이거나 맞춤 라벨 문자열일 수 있습니다.

// The code below retrieves a contact named "John Doe" and logs the IM addresses
// associated with that contact that are in the ContactsApp.Field.GOOGLE_TALK
// label.
const contacts = ContactsApp.getContactsByName('John Doe');
const imAddresses = contacts[0].getIMs(ContactsApp.Field.GOOGLE_TALK);
for (const i in imAddresses) {
  Logger.log(imAddresses[i].getAddress());
}

매개변수

이름유형설명
labelObject일치시킬 라벨(ContactsApp.Field 또는 맞춤 문자열)

리턴

IMField[]: IM 주소 목록

승인

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

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

참고 항목


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

이 연락처의 고유 ID를 반환합니다.

const contact = ContactsApp.createContact(
    'John',
    'Doe',
    'john.doe@example.com',
);
const id = contact.getId();

리턴

String: 이 연락처의 ID입니다.

승인

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

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

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

연락처의 이니셜을 가져옵니다.

// The code below logs the initials of all the contacts whose names contain
// "John Doe"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  Logger.log(contacts[i].getInitials());
}

리턴

String: 연락처의 이니셜

승인

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

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

참고 항목


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

이 연락처가 마지막으로 업데이트된 날짜를 가져옵니다.

// The code below logs the last updated date of all the contacts whose names
// contain "John Doe"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  Logger.log(contacts[i].getLastUpdated());
}

리턴

Date: 이 연락처가 마지막으로 업데이트된 날짜입니다.

승인

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

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

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

연락처의 성명 중 첫 번째 이름을 문자열로 가져옵니다.

// The code below logs the maiden name of all the contacts whose names contain
// "Jane"
const contacts = ContactsApp.getContactsByName('Jane');
for (const i in contacts) {
  Logger.log(contacts[i].getMaidenName());
}

리턴

String: 연락처의 처녀 성

승인

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

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

참고 항목


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

연락처의 중간 이름을 문자열로 가져옵니다.

// The code below logs the middle name of all the contacts whose names contain
// "Smith"
const contacts = ContactsApp.getContactsByName('Smith');
for (const i in contacts) {
  Logger.log(contacts[i].getMiddleName());
}

리턴

String: 연락처의 중간 이름입니다.

승인

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

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

참고 항목


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

이 연락처의 휴대전화 번호를 가져오거나 번호가 없는 경우 빈 문자열을 가져옵니다.

리턴

String: 이 연락처의 휴대전화 번호 또는 번호가 없는 경우 빈 문자열

승인

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

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

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

문자열로 연락처의 닉네임을 가져옵니다.

// The code below logs the nickname of all the contacts whose names contain
// "John Doe"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  Logger.log(contacts[i].getNickname());
}

리턴

String: 연락처의 닉네임입니다.

승인

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

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

참고 항목


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

이 연락처와 연결된 메모를 가져오거나 메모가 없는 경우 빈 문자열을 가져옵니다.

// The code below logs the notes of all the contacts whose names contain "John
// Doe"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  Logger.log(contacts[i].getNotes());
}

리턴

String: 이 연락처와 연결된 메모입니다.

승인

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

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

참고 항목


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

이 연락처의 пей저 전화번호를 가져오거나 페이저 전화번호가 없는 경우 빈 문자열을 가져옵니다.

리턴

String: 이 연락처의 페이저 전화번호 또는 페이저 전화번호가 없는 경우 빈 문자열

승인

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

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

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

이 연락처의 모든 전화번호를 가져옵니다.

// The code below logs the phone numbers of all the contacts whose names contain
// "John Doe"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  Logger.log(contacts[i].getPhones());
}

리턴

PhoneField[]: 전화번호 목록

승인

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

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

참고 항목


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

특정 필드와 일치하는 이 연락처의 모든 전화번호를 가져옵니다.

라벨은 ContactsApp.Field의 라벨이거나 맞춤 라벨 문자열일 수 있습니다.

// The code below retrieves a contact named "John Doe" and logs the phone
// numbers associated with that contact that are in the
// ContactsApp.Field.WORK_PHONE label.
const contacts = ContactsApp.getContactsByName('John Doe');
const phones = contacts[0].getPhones(ContactsApp.Field.WORK_PHONE);
for (const i in phones) {
  Logger.log(phones[i].getPhoneNumber());
}

매개변수

이름유형설명
labelObject일치시킬 라벨(ContactsApp.Field 또는 맞춤 문자열)

리턴

PhoneField[]: 전화번호 목록

승인

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

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

참고 항목


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

연락처 이름의 접두사를 가져옵니다.

// The code below logs the prefix of all the contacts whose names contain "John
// Doe"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  Logger.log(contacts[i].getPrefix());
}

리턴

String: 연락처 이름의 접두사입니다.

승인

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

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

참고 항목


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

연락처의 기본 이메일 주소를 문자열로 가져옵니다.

// The code below logs the primary email address of all the contacts whose names
// contain "John Doe"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  Logger.log(contacts[i].getPrimaryEmail());
}

리턴

String: 연락처의 기본 이메일 주소입니다.

승인

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

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

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

연락처의 약어 이름을 문자열로 가져옵니다.

// The code below logs the short name of all the contacts whose names contain
// "Johnathan"
const contacts = ContactsApp.getContactsByName('Johnathan');
for (const i in contacts) {
  Logger.log(contacts[i].getShortName());
}

리턴

String: 연락처의 약어

승인

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

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

참고 항목


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

연락처 이름의 접미사를 가져옵니다.

// The code below logs the suffix of all the contacts whose names contain "John
// Doe"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  Logger.log(contacts[i].getSuffix());
}

리턴

String: 연락처 이름의 접미사입니다.

승인

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

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

참고 항목


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

이 연락처의 모든 URL을 가져옵니다.

// The code below logs the URLs of all the contacts whose names contain "John
// Doe"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  Logger.log(contacts[i].getUrls());
}

리턴

UrlField[]: URL 목록

승인

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

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

참고 항목


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

특정 필드와 일치하는 이 연락처의 모든 URL을 가져옵니다.

라벨은 ContactsApp.Field의 라벨이거나 맞춤 라벨 문자열일 수 있습니다.

// The code below retrieves a contact named "John Doe" and logs the URLs
// associated with that contact that are in the ContactsApp.Field.WORK_WEBSITE
// label.
const contacts = ContactsApp.getContactsByName('John Doe');
const urls = contacts[0].getUrls(ContactsApp.Field.WORK_WEBSITE);
for (const i in urls) {
  Logger.log(urls[i].getAddress());
}

매개변수

이름유형설명
labelObject일치시킬 라벨(ContactsApp.Field 또는 맞춤 문자열)

리턴

UrlField[]: URL 목록

승인

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

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

참고 항목


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

지정된 키와 연결된 사용자 정의 값을 가져옵니다.

매개변수

이름유형설명
keyString키는 모든 기본 유형 (String, int 등)일 수 있습니다.

리턴

String: 이 키로 저장된 사용자 정의 콘텐츠입니다.

승인

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

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

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

이 연락처의 모든 사용자 정의 필드를 가져와 JavaScript 객체의 속성으로 반환합니다.

리턴

Object: 이 연락처의 사용자 정의 필드(JavaScript 객체의 속성)

승인

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

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

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

이 연락처의 직장 주소를 가져오거나 주소가 없는 경우 빈 문자열을 가져옵니다.

리턴

String: 이 연락처의 직장 주소 또는 주소가 없는 경우 빈 문자열

승인

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

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

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

이 연락처의 직장 팩스 번호를 가져오거나 팩스 번호가 없는 경우 빈 문자열을 가져옵니다.

리턴

String: 이 연락처의 직장 팩스 번호 또는 팩스 번호가 없는 경우 빈 문자열

승인

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

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

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

이 연락처의 직장 전화번호를 가져오거나 전화번호가 없는 경우 빈 문자열을 가져옵니다.

리턴

String: 이 연락처의 직장 전화번호 또는 전화번호가 없는 경우 빈 문자열

승인

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

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

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

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

// The code below gets all the contacts named "John Doe" and then removes each
// of them from the "Work Friends" contact group
const contacts = ContactsApp.getContactsByName('John Doe');
const group = ContactsApp.getContactGroup('Work Friends');
for (const i in contacts) {
  contacts[i] = contacts[i].removeFromGroup(group);
}

매개변수

이름유형설명
groupContactGroup이 연락처를 삭제할 연락처 그룹

리턴

Contact: 이 연락처

승인

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

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

참고 항목


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

연락처의 성 (last name)을 설정합니다.

// The code below changes the family name of all the contacts whose names are
// "John Doe" to "Doe-Smith"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  contacts[i].setFamilyName('Doe-Smith');
}

매개변수

이름유형설명
familyNameString연락처의 새 성

리턴

Contact: 이 연락처

승인

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

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

참고 항목


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

연락처의 전체 이름 (이름 및 성)을 설정합니다.

// The code below changes the full name of all the contacts whose names are
// "John Doe" to "Johnny Doe"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  contacts[i].setFullName('Johnny Doe');
}

매개변수

이름유형설명
fullNameString연락처의 새 전체 이름

리턴

Contact: 이 연락처

승인

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

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

참고 항목


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

연락처의 이름 (이름)을 설정합니다.

// The code below changes the given name of all the contacts whose names are
// "John Doe" to "Johnny"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  contacts[i].setGivenName('Johnny');
}

매개변수

이름유형설명
givenNameString연락처의 새 이름

리턴

Contact: 이 연락처

승인

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

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

참고 항목


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

이 연락처의 집 주소를 설정합니다.

매개변수

이름유형설명
addrString설정할 집 주소

승인

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

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

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

이 연락처의 집 팩스 번호를 설정합니다.

매개변수

이름유형설명
phoneString설정할 집 팩스 번호

승인

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

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

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

이 연락처의 집 전화번호를 설정합니다.

매개변수

이름유형설명
phoneString설정할 집 전화번호

승인

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

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

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

연락처의 이니셜을 설정합니다.

// The code below sets the initials of all the contacts whose names are
// "Johnathan Doe" to "JD"
const contacts = ContactsApp.getContactsByName('Johnathan Doe');
for (const i in contacts) {
  contacts[i].setInitials('JD');
}

매개변수

이름유형설명
initialsString연락처의 새 이니셜

리턴

Contact: 이 연락처

승인

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

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

참고 항목


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

연락처의 결혼 전 이름을 설정합니다.

// The code below changes the maiden name of all the contacts whose names are
// "Jane Doe" to "Smith"
const contacts = ContactsApp.getContactsByName('Jane Doe');
for (const i in contacts) {
  contacts[i].setMaidenName('Smith');
}

매개변수

이름유형설명
maidenNameString연락처의 새 성명

리턴

Contact: 이 연락처

승인

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

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

참고 항목


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

연락처의 중간 이름을 설정합니다.

// The code below changes the middle name of all the contacts whose names are
// "John Doe" to "Danger"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  contacts[i].setMiddleName('Danger');
}

매개변수

이름유형설명
middleNameString연락처의 새 중간 이름

리턴

Contact: 이 연락처

승인

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

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

참고 항목


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

이 연락처의 휴대전화 번호를 설정합니다.

매개변수

이름유형설명
phoneString설정할 휴대전화 번호

승인

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

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

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

연락처의 닉네임을 설정합니다.

// The code below changes the nickname of all the contacts whose names are "John
// Doe" to "JohnnyD"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  contacts[i].setNickname('JohnnyD');
}

매개변수

이름유형설명
nicknameString연락처의 새 닉네임

리턴

Contact: 이 연락처

승인

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

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

참고 항목


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

이 연락처와 연결된 메모를 설정합니다.

// The code below sets the notes of all the contacts whose names are "John Doe"
// to "Met him at the hackathon"
const contacts = ContactsApp.getContactsByName('John Doe');
for (const i in contacts) {
  contacts[i].setNotes('Met him at the hackathon');
}

매개변수

이름유형설명
notesString이 연락처에 저장할 메모

리턴

Contact: 이 연락처

승인

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

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

참고 항목


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

이 연락처의 페이저 번호를 설정합니다.

매개변수

이름유형설명
phoneString설정할 무선 호출기 번호

승인

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

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

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

연락처 이름의 접두사를 설정합니다.

// The code below sets the prefix of all the contacts whose names are "Johnathan
// Doe" to "Mr"
const contacts = ContactsApp.getContactsByName('Johnathan Doe');
for (const i in contacts) {
  contacts[i].setPrefix('Mr');
}

매개변수

이름유형설명
prefixString연락처 이름의 새 접두사

리턴

Contact: 이 연락처

승인

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

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

참고 항목


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

이 연락처의 기본 이메일 주소를 설정합니다.

매개변수

이름유형설명
primaryEmailString설정할 기본 이메일 주소

승인

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

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

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

연락처의 약어를 설정합니다.

// The code below changes the short name of all the contacts whose names are
// "Johnathan Doe" to "John"
const contacts = ContactsApp.getContactsByName('Johnathan Doe');
for (const i in contacts) {
  contacts[i].setShortName('John');
}

매개변수

이름유형설명
shortNameString연락처의 새 짧은 이름

리턴

Contact: 이 연락처

승인

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

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

참고 항목


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

연락처 이름에 접미사를 설정합니다.

// The code below sets the suffix of all the contacts whose names are "Johnathan
// Doe" to "Jr"
const contacts = ContactsApp.getContactsByName('Johnathan Doe');
for (const i in contacts) {
  contacts[i].setSuffix('Jr');
}

매개변수

이름유형설명
suffixString연락처 이름의 새 접미사

리턴

Contact: 이 연락처

승인

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

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

참고 항목


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

지정된 키로 저장되도록 이 연락처의 단일 사용자 정의 필드를 설정합니다.

매개변수

이름유형설명
keyString키는 모든 기본 유형 (String, int 등)일 수 있습니다.
valueString값은 모든 기본 유형 (String, int 등)일 수 있습니다.

승인

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

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

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

이 연락처의 사용자 정의 필드를 지정된 객체의 속성으로 설정합니다.

매개변수

이름유형설명
oObject{key: value} 형식의 속성이 하나 이상 있는 객체

승인

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

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

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

이 연락처의 직장 주소를 설정합니다.

매개변수

이름유형설명
addrString설정할 직장 주소

승인

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

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

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

이 연락처의 직장 팩스 번호를 설정합니다.

매개변수

이름유형설명
phoneString설정할 직장 팩스 번호

승인

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

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

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

이 연락처의 직장 전화번호를 설정합니다.

매개변수

이름유형설명
phoneString설정할 직장 전화번호

승인

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

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