Domain Shared Contacts API를 사용하면 애플리케이션에서 Google Workspace 도메인의 모든 사용자와 공유되는 외부 연락처를 가져오고 업데이트할 수 있습니다. 공유 연락처는 Google Workspace 도메인의 모든 사용자에게 표시되며 모든 Google 서비스에서 연락처 목록에 액세스할 수 있습니다.
애플리케이션에서는 Domain Shared Contacts API를 사용하여 공유 연락처를 만들고, 기존 공유 연락처를 수정 또는 삭제하며, 특정 기준과 일치하는 공유 연락처를 쿼리할 수 있습니다.
Domain Shared Contacts API는 Google Workspace 계정에서만 사용할 수 있습니다. API를 사용하려면 관리 콘솔에서 Domain Shared Contacts API를 사용 설정하세요. 공유 연락처 변경사항이 이메일 주소 자동 완성 및 연락처 관리자에 반영되려면 최대 24시간이 걸릴 수 있습니다.
이 문서에서는 Domain Shared Contacts API의 기능에 관한 배경 지식 외에 XML 및 HTTP를 사용하여 연락처를 관리하는 방법에 대한 예도 제공합니다. 이 문서를 읽은 후에는 클라이언트 라이브러리를 사용하여 API와 상호작용하는 방법을 자세히 알아볼 수 있습니다.
대상
이 문서는 HTTP 및 XML을 사용하여 Google의 연락처 목록을 조작할 수 있는 클라이언트 애플리케이션을 작성하려는 개발자를 대상으로 합니다. 이 문서에서는 Google 데이터 API 프로토콜의 기본 사항을 이해하고 있다고 가정합니다.
UNIX 운영체제를 사용하는 경우 코드를 작성하지 않고 이 문서의 예시를 사용해 보려면 UNIX 명령줄 유틸리티인 curl 또는 wget을 사용하세요. Google 데이터 서비스에서 cURL을 사용하는 방법을 알아보세요.
원칙
이 버전의 Domain Shared Contacts API는 Google Data API의 원칙을 따릅니다. Google 데이터 API는 Atom 게시 프로토콜 외에도 Atom 1.0 및 RSS 2.0 신디케이션 형식을 모두 기반으로 합니다.
버전 지정
Domain Shared Contacts API를 사용하여 전송하는 모든 요청에는 API의 버전 3.0을 지정해야 합니다.
GData-Version: 3.0
HTTP 헤더를 설정할 수 없는 경우 URL에 v=3.0를 쿼리 매개변수로 지정할 수 있지만 HTTP 헤더 메서드를 사용하는 것이 좋습니다.