Bevollmächtigte verwalten

In dieser Anleitung erfahren Sie, wie Sie Bevollmächtigte für Kontakte für Google Workspace-Nutzer erstellen, auflisten und löschen.

Google Workspace-Nutzer können anderen Nutzern in ihrer Domain die Berechtigung erteilen, auf ihre Kontakte zuzugreifen und sie zu verwalten. Diese Bevollmächtigten können dann Kontakte hinzufügen und sie mit Informationen wie Namen, Telefonnummern und Adressen aktualisieren.

Diese Anleitung bezieht sich auf die Delegierung des Zugriffs auf Kontakte. Informationen zum Delegieren des Zugriffs auf Gmail finden Sie unter E‑Mails delegieren und gemeinsam bearbeiten.

Vorbereitung

Bevor Sie die Contact Delegation API verwenden, müssen die folgenden Voraussetzungen erfüllt sein:

  • Kontaktfreigabe aktivieren: Ein Verzeichnisadministrator muss die Kontaktfreigabe in der Admin-Konsole aktivieren. Weitere Informationen finden Sie unter Kontaktfreigabe aktivieren oder deaktivieren.
  • Administratorberechtigungen: Sie benötigen die Administratorberechtigung „Kontakte“, um Bevollmächtigte für andere Nutzer zu verwalten.
  • Domainbeschränkung: Sie können Kontakte nur zwischen Nutzern in derselben Google Workspace-Organisation delegieren.
  • OAuth-Bereich: Ihre Anwendung muss den folgenden OAuth-Bereich verwenden: https://www.googleapis.com/auth/admin.contact.delegation.

Bevollmächtigten erstellen

Wenn Sie einen Bevollmächtigten für einen Nutzer erstellen möchten, senden Sie eine POST-Anfrage mit der E‑Mail-Adresse des Delegierenden:

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

Ersetzen Sie USER_EMAIL durch die E‑Mail-Adresse des Delegierenden.

Geben Sie im Anfragetext die E‑Mail-Adresse des Bevollmächtigten an:

{
  "email": "DELEGATE_EMAIL"
}

Ersetzen Sie DELEGATE_EMAIL durch die E‑Mail-Adresse des Bevollmächtigten.

Bei einer erfolgreichen Antwort wird der Statuscode HTTP 200 und die E‑Mail-Adresse des neuen Bevollmächtigten zurückgegeben:

{
  "email": "DELEGATE_EMAIL"
}

Bevollmächtigte auflisten

Wenn Sie die Bevollmächtigten für die Kontakte eines Nutzers auflisten möchten, senden Sie eine GET-Anfrage mit der E‑Mail-Adresse dieses Nutzers:

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

Ersetzen Sie USER_EMAIL durch die E‑Mail-Adresse des Nutzers.

Bei einer erfolgreichen Antwort wird der Statuscode HTTP 200 und eine Liste der E‑Mail-Adressen der Bevollmächtigten zurückgegeben:

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

Bevollmächtigten löschen

So löschen Sie einen Bevollmächtigten für die Kontakte eines Nutzers:

  1. Suchen Sie den Bevollmächtigten, den Sie entfernen möchten. Verwenden Sie die Methode Bevollmächtigte auflisten , um die E‑Mail-Adresse eines bestimmten Bevollmächtigten zu finden.

  2. Senden Sie eine DELETE-Anfrage mit den E‑Mail-Adressen des Delegierenden und des Bevollmächtigten:

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

Ersetzen Sie USER_EMAIL durch die E‑Mail-Adresse des Delegierenden und DELEGATE_EMAIL durch die E‑Mail-Adresse des Bevollmächtigten.

Bei einer erfolgreichen Antwort wird der Statuscode HTTP 200 zurückgegeben.