Domain Shared Contact 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 数据 API 协议背后的基础知识

如果您使用的是 UNIX 操作系统,并且希望在不编写任何代码的情况下试用本文档中的示例,请使用 UNIX 命令行实用程序 curlwget。了解如何将 c网址 与 Google 数据服务搭配使用

原则

此版本的 Domain Shared Contacts API 遵循 Google 数据 API 的原则。Google 数据 API 基于 Atom 1.0 和 RSS 2.0 联合格式以及 Atom 发布协议。

指定版本

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

GData-Version: 3.0

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