Cómo administrar a los delegados de contacto

En esta guía, se explica cómo crear, enumerar y borrar delegados de contactos para usuarios de Google Workspace.

Los usuarios de Google Workspace pueden permitir que otros usuarios de su dominio accedan a sus contactos y los administren. Estos delegados podrán agregar y actualizar contactos con información como nombres, números de teléfono y direcciones.

Cómo crear un delegado

Para crear un delegado para un usuario, envía una solicitud POST con la dirección de correo electrónico del delegador:

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

En el cuerpo de la solicitud, proporciona la dirección de correo electrónico del delegado:

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

Una respuesta correcta devuelve un código de estado HTTP 200 y el correo electrónico del nuevo delegado:

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

Cómo enumerar delegados

Para enumerar los delegados de los contactos de un usuario, envía una solicitud de GET con la dirección de correo electrónico de ese usuario:

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

Una respuesta correcta devuelve un código de estado HTTP 200 y una lista de direcciones de correo electrónico de delegados:

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

Cómo borrar un delegado

Para borrar un delegado de los contactos de un usuario, completa estos pasos:

  1. Identifica al delegado que deseas quitar. Usa el método List delegates para encontrar la dirección de correo electrónico de un delegado específico.

  2. Envía una solicitud DELETE con las direcciones de correo electrónico del delegador y del delegado:

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

Una respuesta correcta devuelve un código de estado HTTP 200.