借助 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 协议背后的基础知识。
如果您使用的是 UNIX 操作系统，并且想要在不编写任何代码的情况下尝试本文档中的示例，请使用 UNIX 命令行实用程序 curl 或 wget。了解如何将 c网址 与 Google 数据服务搭配使用。
原则
此版本的 Domain Shared Contacts API 遵循 Google 数据 API 的原则。Google 数据 API 不仅基于 Atom 发布协议，还基于 Atom 1.0 和 RSS 2.0 整合格式。
指定版本
您使用 Domain Shared Contacts API 发送的每个请求都应指定 3.0 版 API：
GData-Version: 3.0
如果您无法设置 HTTP 标头，可以在网址中将 v=3.0 指定为查询参数，但建议使用 HTTP 标头方法。