本指南介绍了如何为 Google Workspace 用户创建、列出和删除联系人受托人。
如果您使用的是 Google Workspace,则可以授权您所在网域中的其他用户访问和管理您的通讯录。受托人可为您添加和更新联系人信息,例如姓名、电话号码和地址。
创建委托
如需为用户创建委托人,请发送包含委托人电子邮件地址的 POST 请求:
POST https://admin.googleapis.com/admin/contacts/v1/users/delegator@example.com/delegates
在请求正文中,提供委托人的电子邮件地址:
{
"email": "delegate@example.com"
}
如果响应成功,则会返回 HTTP 200 状态代码和新委托人的电子邮件地址:
{
"email": "delegate@example.com"
}
列出委托人
如需列出用户的联系人的委托人,请发送包含相应用户电子邮件地址的 GET 请求:
GET https://admin.googleapis.com/admin/contacts/v1/users/delegator@example.com/delegates
如果响应成功,则会返回 HTTP 200 状态代码和委托人电子邮件地址列表:
{
"delegates": [
{
"email": "delegate1@example.com"
},
{
"email": "delegate2@example.com"
}
]
}
删除受托人
如需删除用户联系人的委托人,请完成以下步骤:
- 确定要移除的委托人。您可以使用 List delegates 方法查找特定委托人的电子邮件地址。
发送一个
DELETE请求,其中包含委托人和受托人的电子邮件地址:DELETE https://admin.googleapis.com/admin/contacts/v1/users/delegator@example.com/delegates/delegate@example.com
成功的响应会返回 HTTP 200 状态代码。