管理联系人委托

本指南介绍了如何为 Google Workspace 用户创建、列出和删除联系人受托人。

Google Workspace 用户可以授权其网域中的其他用户访问和管理自己的通讯录。受托人可使用姓名、电话号码和地址等信息添加和更新联系人。

本指南介绍了如何委托对通讯录的访问权限。如需委托对 Gmail 的访问权限，请参阅委托和协作处理电子邮件。

前提条件

在使用 Contact Delegation API 之前，请确保满足以下要求：

启用联系人共享功能：目录管理员必须在管理控制台中开启联系人共享功能。如需了解详情，请参阅启用或停用联系人共享功能。
管理员权限：您必须拥有“通讯录”管理员权限，才能为其他用户管理受托人。
网域限制：您只能在同一 Google Workspace 组织中的用户之间委托联系人。
OAuth 范围：您的应用必须使用以下 OAuth 范围：https://www.googleapis.com/auth/admin.contact.delegation。

如需为用户创建委托人，请发送包含委托人电子邮件地址的 POST 请求：

POST https://admin.googleapis.com/admin/contacts/v1/users/USER_EMAIL/delegates

将 USER_EMAIL 替换为委托者的电子邮件地址。

在请求正文中，提供委托人的电子邮件地址：

{
  "email": "DELEGATE_EMAIL"
}

将 DELEGATE_EMAIL 替换为委托人的电子邮件地址。

如果响应成功，则会返回 HTTP 200 状态代码和新受托人的电子邮件地址：

{
  "email": "DELEGATE_EMAIL"
}

如需列出用户的联系人的委托人，请发送 GET 请求，并在其中添加相应用户的电子邮件地址：

GET https://admin.googleapis.com/admin/contacts/v1/users/USER_EMAIL/delegates

将 USER_EMAIL 替换为用户的电子邮件地址。

如果响应成功，则会返回 HTTP 200 状态代码和受托人电子邮件地址列表：

{
  "delegates": [
    {
      "email": "DELEGATE_EMAIL_1"
    },
    {
      "email": "DELEGATE_EMAIL_2"
    }
  ]
}

如需删除用户联系人的委托人，请完成以下步骤：

发送 DELETE 请求，其中包含委托人和受托人的电子邮件地址：

DELETE https://admin.googleapis.com/admin/contacts/v1/users/USER_EMAIL/delegates/DELEGATE_EMAIL

将 USER_EMAIL 替换为委托人的电子邮件地址，将 DELEGATE_EMAIL 替换为受托人的电子邮件地址。

成功的响应会返回 HTTP 200 状态代码。