Domain Shared Contacts API 概览

借助 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 Data API 的原则。除了 Atom 发布协议之外，Google Data API 还基于 Atom 1.0 和 RSS 2.0 联合发布格式。

指定版本

您使用 Domain Shared Contacts API 发送的每个请求都应指定 API 的 3.0 版本：

GData-Version: 3.0

如果您无法设置 HTTP 标头，则可以在网址中将 v=3.0 指定为查询参数，但建议使用 HTTP 标头方法。