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 Data API 프로토콜의 기본사항을 이해하고 있다고 가정합니다.
[null,null,["최종 업데이트: 2025-03-25(UTC)"],[],[],null,["# Domain Shared Contacts API overview\n\nThe Domain Shared Contacts API lets your applications get and update external\ncontacts that are shared with all users in a Google Workspace domain. Shared\ncontacts are visible to all users of a Google Workspace domain and all Google\nservices have access to the contact list.\n| **Warning:** The Domain Shared Contacts API is intended only for *external* contacts. Using this API to create contact information for domain (internal) users or groups can result in duplicate contact information for those users and groups, which might lead to unexpected behavior. To get and update Google Workspace domain (internal) users' contact information, use the [Directory API](https://developers.google.com/workspace/admin/directory) instead.\n\nYour application can use the Domain Shared Contacts API to create shared contacts, edit\nor delete existing shared contacts, and query for shared contacts that match a\nparticular criteria.\n\nThe Domain Shared Contacts API is only available to Google Workspace accounts.\nTo use the API,\n[enable the Domain Shared Contacts API in the Admin console](https://support.google.com/a/answer/60757).\nShared contact changes can take up to 24 hours to be reflected in the email\naddress autocomplete and the contact manager.\n\nIn addition to providing background on the capabilities of the\nDomain Shared Contacts API, this document offers examples about how to manage\ncontacts by using XML and HTTP. After reading this document, you can learn more\nabout interacting with the API by using our\n[client libraries](https://developers.google.com/api-client-library).\n\nAudience\n--------\n\nThis document is intended for developers who want to write client applications\nthat can manipulate Google's contact lists by using HTTP and XML.\nThis document assumes that you understand the\n[fundamentals behind the Google Data APIs protocol](https://developers.google.com/gdata/docs/2.0/basics).\n\nIf you're using a UNIX operating system and you want to try the examples in this\ndocument without writing any code, use the UNIX command-line utilities\n[curl](https://curl.haxx.se/)\nor\n[wget](https://www.gnu.org/software/wget/).\nLearn how to\n[use cURL with Google Data services](https://developers.google.com/gdata/articles/using_cURL).\n\nPrinciples\n----------\n\nThis version of the Domain Shared Contacts API follows the principles of the\n[Google Data APIs](https://developers.google.com/gdata/docs/developers-guide).\nGoogle Data APIs are based on both the Atom 1.0 and RSS 2.0 syndication formats\nin addition to the Atom Publishing Protocol.\n\nSpecify a version\n-----------------\n\nEvery request that you send using the Domain Shared Contacts API should specify version\n3.0 of the API: \n\n GData-Version: 3.0\n\nIf you can't set HTTP headers, you can specify`v=3.0` as a query parameter in\nthe URL, but the HTTP header method is recommended.\n| **Note:** The client libraries supply appropriate version headers automatically, so don't use the `v=3.0` query parameter when you're using a client library."]]
