管理聯絡人委派功能

本指南說明如何為 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"
    }
  ]
}

刪除委派代表

如要刪除使用者聯絡人的委派對象，請完成下列步驟：

1. 找出要移除的委派對象。使用 List delegates 方法找出特定委派代表的電子郵件地址。

2. 傳送 DELETE 要求，並附上委派者和受委派者的電子郵件地址：

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

將 USER_EMAIL 替換為委派者的電子郵件地址，並將 DELEGATE_EMAIL 替換為受委派者的電子郵件地址。

成功的回應會傳回 HTTP 200 狀態碼。