Soluciona problemas de la API de Directory

En esta página, se describen algunos problemas comunes que puedes encontrar cuando usas la API de Directory como distribuidor.

400:badRequest

Este error ocurre cuando se pasa un valor de parámetro incorrecto al método.

Si usas el método users.get, verifica que el valor que se pasa al parámetro userKey sea la dirección de correo electrónico principal del usuario, la dirección de correo electrónico del alias o el ID de usuario único.

Si usas el método users.list, verifica los siguientes parámetros:

  • Parámetro customer: Usa solo el customerId que generó Google. No uses el dominio real del cliente. Te recomendamos que uses este parámetro porque, si un cliente tiene dominios secundarios, el domain parámetro solo muestra los usuarios con direcciones de correo electrónico en ese dominio en particular.
  • Parámetro domain: Usa solo el dominio real del cliente. No uses el customerId que generó Google.

403:domainCannotUseApis

Este error ocurre cuando tu cliente inhabilita el acceso del distribuidor a la API del SDK de Admin. Para resolver este problema, pídele a tu cliente que vuelva a habilitar el acceso a la API del SDK de Admin. Para obtener más información, consulta Controla el acceso a la API.

Si intentas obtener el recuento de los usuarios con licencia actuales y recibes este error, en lugar de llamar al método users.list, usa el campo licensedNumberOfSeats del recurso de suscripción.

403:forbidden

Este error ocurre cuando no eres propietario del cliente o cuando tu cliente inhabilitó el acceso del distribuidor a su Consola del administrador.

Para resolver este problema, llama al customers.get método antes de realizar llamadas para verificar la propiedad del cliente por parte del distribuidor o pídele a tu cliente que vuelva a habilitar el acceso del distribuidor a su Consola del administrador. Para obtener más información, consulta Cómo acceder a la Consola del administrador de un cliente.

403:usageLimits.accessNotConfigured

Este error ocurre cuando la API no está habilitada en el proyecto de Google Cloud. Para resolver este problema, ve a la consola de Google Cloud y habilita la API. Para obtener más información, consulta Habilita las APIs de Google Workspace.

409:duplicate

Este error ocurre cuando intentas agregar un usuario nuevo, pero el correo electrónico principal del cliente ya existe en uno de los siguientes:

  • Cuenta actual de Google Workspace a la que intentas agregarlo
  • Otro producto de Google (que no es Google Workspace)

Para solucionar este problema, haz lo siguiente:

  1. Llama al método users.get.

    Si recibes una respuesta 200, significa que el usuario ya existe en la cuenta de Google Workspace del cliente. No puedes agregar este usuario a la cuenta.

    Si recibes una respuesta 403 forbidden, significa que el dominio en el parámetro de correo electrónico principal no es un cliente revendido o que el correo electrónico principal se usó anteriormente para un producto diferente de Google, y el dominio del cliente primero debe verificarse antes de que se pueda agregar este usuario correctamente.

  2. Si puedes verificar el dominio del cliente, haz lo siguiente:

    1. Crea un usuario administrador temporal con el users.insert método y continúa con el aprovisionamiento hasta el paso final de verificación del dominio.
    2. Cuando verifiques el dominio, agrega los usuarios temporales al owners[] parámetro del cuerpo de la solicitud para la webResource.insert llamada. Realiza esta llamada hasta que recibas una respuesta 200.
    3. Una vez que se verifique el dominio, cambia el nombre de usuario temporal con los métodos either the users.patch or the users.update methods.

  3. Si no puedes verificar el dominio del cliente, haz lo siguiente:

    1. Crea un usuario administrador temporal con el users.insert método.
    2. Pídele a tu cliente que acceda como usuario temporal y verifique su dominio a través de la Consola del administrador.
    3. Una vez que se verifique el dominio, el cliente o tú pueden cambiar el nombre de usuario temporal. Puedes usar los users.patch o los users.update métodos.

412:limitExceeded

Este error ocurre cuando tu cliente alcanzó su límite máximo de puestos. Para resolver este problema, usa el subscriptions.changeSeats método y, según su plan de suscripción, usa lo siguiente:

  • Para FLEXIBLE, aumenta el parámetro maximumNumberOfSeats.
  • Para ANNUAL, aumenta el parámetro numberOfSeats.