Bevollmächtigte verwalten

In dieser Anleitung wird beschrieben, wie Sie Kontaktdelegierte für Google Workspace-Nutzer erstellen, auflisten und löschen.

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

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 Bevollmächtigenden:

POST https://admin.googleapis.com/admin/contacts/v1/users/delegator@example.com/delegates

Geben Sie im Anfragetext die E‑Mail-Adresse des Delegierten an:

{
  "email": "delegate@example.com"
}

Eine erfolgreiche Antwort gibt den Statuscode HTTP 200 und die E-Mail-Adresse des neuen Bevollmächtigten zurück:

{
  "email": "delegate@example.com"
}

Delegierte auflisten

Wenn Sie die delegierten Kontakte eines Nutzers auflisten möchten, senden Sie eine GET-Anfrage mit der E-Mail-Adresse des Nutzers:

GET https://admin.googleapis.com/admin/contacts/v1/users/delegator@example.com/delegates

Bei einer erfolgreichen Antwort wird der Statuscode HTTP 200 und eine Liste mit E-Mail-Adressen von Stellvertretern zurückgegeben:

{
  "delegates": [
    {
      "email": "delegate1@example.com"
    },
    {
      "email": "delegate2@example.com"
    }
  ]
}

Bevollmächtigte Person löschen

So löschen Sie einen Stellvertreter für die Kontakte eines Nutzers:

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

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

    DELETE https://admin.googleapis.com/admin/contacts/v1/users/delegator@example.com/delegates/delegate@example.com

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