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.

Esta guía está destinada a delegar el acceso a los contactos. Para delegar el acceso a Gmail, consulta Delega correo electrónico y colabora en él.

Requisitos previos

Antes de usar la API de Contact Delegation, asegúrate de cumplir con los siguientes requisitos:

  • Habilita el uso compartido de contactos: Un administrador de Directorio debe activar el uso compartido de contactos en la Consola del administrador. Para obtener más información, consulta Activa o desactiva el uso compartido de contactos.
  • Privilegios de administrador: Debes tener el privilegio de administrador "Contactos" para administrar delegados para otros usuarios.
  • Restricción de dominio: Solo puedes delegar contactos entre usuarios de la misma organización de Google Workspace.
  • Alcance de OAuth: Tu aplicación debe usar el siguiente alcance de OAuth: https://www.googleapis.com/auth/admin.contact.delegation.

Crear 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/USER_EMAIL/delegates

Reemplaza USER_EMAIL por la dirección de correo electrónico del delegador.

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

{
  "email": "DELEGATE_EMAIL"
}

Reemplaza DELEGATE_EMAIL por la dirección de correo electrónico del delegado.

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

{
  "email": "DELEGATE_EMAIL"
}

Enumerar delegados

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

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

Reemplaza USER_EMAIL por la dirección de correo electrónico del usuario.

Una respuesta correcta devuelve un código de estado HTTP 200 y una lista de correos electrónicos de delegados:

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

Borrar un delegado

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

  1. Identifica el 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/USER_EMAIL/delegates/DELEGATE_EMAIL

Reemplaza USER_EMAIL por la dirección de correo electrónico del delegador y DELEGATE_EMAIL por la dirección de correo electrónico del delegado.

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