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 管理联系人的示例。如需了解详情，请参阅客户端库。

受众群体

本文档适用于使用 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 标头方法。