중요: Apps Script에서 2023년 3월에 연락처 서비스를 종료하기 전에 주소록 서비스에서 People API 고급 서비스로 스크립트를 이전하세요.
Apps Script는 2022년 12월 16일에 주소록 서비스를 지원 중단했습니다. 대신 People API 고급 서비스를 사용하세요. People API는 최신 JSON 프로토콜을 사용하며 연락처를 프로필과 병합하는 등의 고급 기능을 제공합니다.
이 가이드를 사용하여 People API 고급 서비스에 동등한 기능이 없는 연락처 서비스 메서드를 알아보고, 대신 사용할 수 있는 방법을 알아보고, 일반적인 작업을 이전하는 데 필요한 코드 샘플을 찾아보세요. 자세한 내용은 Contacts API 이전 가이드를 참고하세요.
People API에 상응하지 않는 메서드
다음 목록에는 People API 고급 서비스에서 연락처를 검색하는 동일한 방법이 없는 연락처 서비스의 getContacts
메서드가 나와 있습니다. People API 고급 서비스를 사용하면 CONTACT
소스에 있는 연락처의 names
, nickNames
, emailAddresses
, phoneNumbers
, organizations
필드로 검색할 수 있습니다.
등가가 없는 메서드 |
---|
|
다음은 추가 label
매개변수를 사용하는 연락처 서비스의 getContacts
메서드 목록입니다. People API 고급 서비스의 searchContacts
를 사용하여 상응하는 필드별로 연락처를 가져올 수 있지만 검색을 특정 라벨로 제한할 수는 없습니다.
부분적으로 상응하는 메서드 |
---|
|
People API에서 사용할 수 있는 추가 기능
People API 고급 서비스로 이전하면 연락처 서비스에서 사용할 수 없는 다음과 같은 People API 기능에 액세스할 수 있습니다.
- 데이터 소스 지정: 사람에 대한 정보를 검색할 때 Google 연락처 또는 Google 프로필 등 검색 위치를 지정할 수 있습니다.
- 검색어 문자열로 사용자 검색: 특정 문자열과 일치하는 프로필 및 연락처 목록을 가져올 수 있습니다.
- 일괄 요청 – People API 호출을 일괄 처리하여 스크립트 실행 시간을 줄일 수 있습니다.
일반적인 작업을 위한 코드 샘플
이 섹션에는 주소록 서비스의 일반적인 작업이 나와 있습니다. 코드 샘플은 People API 고급 서비스를 사용하여 작업을 구성하는 방법을 보여줍니다.
이름으로 연락처 그룹 가져오기
다음 코드 샘플은 연락처 서비스의 getContactGroup(name)
와 동일한 이름으로 연락처 그룹을 가져오는 방법을 보여줍니다.
이메일 주소로 연락처 받기
다음 코드 샘플은 이메일 주소로 연락처를 가져오는 방법을 보여줍니다. 이는 연락처 서비스의 getContact(emailAddress)
에 해당합니다.
모든 연락처 가져오기
다음 코드 샘플은 사용자의 모든 연락처를 가져오는 방법을 보여줍니다. 이는 연락처 서비스의 getContacts()
에 해당합니다.
연락처의 전체 이름 가져오기
다음 코드 샘플은 연락처의 전체 이름(연락처 서비스의 getFullName()
에 해당)을 가져오는 방법을 보여줍니다.
특정 연락처의 전화번호 모두 가져오기
다음 코드 샘플은 연락처의 모든 전화번호를 가져오는 방법을 보여줍니다. 이는 연락처 서비스의 getPhones()
에 해당합니다.
연락처의 특정 전화번호 가져오기
다음 코드 샘플은 연락처의 특정 전화번호를 가져오는 방법을 보여줍니다. 전화번호는 연락처 서비스의 getPhoneNumber()
에 해당합니다.