借助 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 管理联系人的示例。如需了解详情，请参阅 客户端库。
受众群体
本文档适用于使用 HTTP 和 XML 编写客户端应用来操纵 Google 联系人列表的开发者。它假定读者了解 Google Data API 协议。
Linux 和 macOS 用户可以使用 curl 或 wget 尝试本文档中的示例。 请参阅将 curl 与 Google Data API 搭配使用。
原则
Domain Shared Contacts API 遵循 Google Data API的原则。 Google Data API 基于 Atom 1.0、RSS 2.0 和 Atom 发布协议。
指定版本
使用 Domain Shared Contacts API 发送的所有请求都应指定版本 3.0：
GData-Version: 3.0
如果您无法设置 HTTP 标头，请将 v=3.0 指定为查询参数。
建议使用 HTTP 标头方法。