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.

Si usas Google Workspace, puedes permitir que otros usuarios de tu dominio accedan a tus 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 que contenga 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 que contenga 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. Puedes usar 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 que contenga la dirección 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.