本指南說明如何為 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"
}
]
}
刪除委派代表
如要刪除使用者聯絡人的委派對象,請完成下列步驟:
- 找出要移除的委派對象。使用「列出代表」方法找出特定代表的電子郵件地址。
傳送
DELETE要求,並附上委派者和委派代表的電子郵件地址:DELETE https://admin.googleapis.com/admin/contacts/v1/users/delegator@example.com/delegates/delegate@example.com
成功的回應會傳回 HTTP 200 狀態碼。