連絡先代理人の管理

このガイドでは、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"
    }
  ]
}

ユーザーの連絡先の代理人を削除するには、次の手順を行います。

削除する代理人を特定します。特定の代理人のメールアドレスを確認するには、List delegates メソッドを使用します。
委任者と委任先のメールアドレスを指定して、DELETE リクエストを送信します。
```
DELETE https://admin.googleapis.com/admin/contacts/v1/users/USER_EMAIL/delegates/DELEGATE_EMAIL
```

USER_EMAIL は委任者のメールアドレスに、DELEGATE_EMAIL は委任先のメールアドレスに置き換えます。

成功すると、レスポンスとして HTTP 200 ステータスコードが返されます。