Solucionar problemas de la API de Directory

En esta página, se describen algunos problemas comunes que pueden ocurrir en el caso de la API de Directory como distribuidor.

400:badRequest

Este error se produce 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 pasó al parámetro userKey sea la dirección de correo electrónico principal del usuario, un alias de dirección de correo electrónico o un ID de usuario único.

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

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

403:domainCannotUseApis

Este error se produce cuando tu cliente inhabilita el acceso del revendedor 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 Cómo controlar el acceso a la API.

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

403:forbidden

Este error se produce cuando no es el propietario del cliente o este inhabilita el acceso del distribuidor a la Consola del administrador.

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

403:usageLimits.accessNotConfigured

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

409:duplicate

Este error se produce cuando intentas agregar un usuario nuevo, pero el correo electrónico principal del cliente ya existe en una de las siguientes alternativas:

  • Cuenta de Google Workspace actual a la que intentas agregar personas
  • Otro producto de Google (no Google Workspace).

Para solucionar este problema, haz lo siguiente:

  1. Llama al método users.get.

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

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

  2. Si puede verificar el dominio del cliente, haga lo siguiente:

    1. Crea un usuario administrador temporal mediante el método users.insert y continúa con el aprovisionamiento para el paso de verificación final del dominio.
    2. Cuando verifiques el dominio, agrega los usuarios temporales al parámetro owners[] del cuerpo de la solicitud para la llamada webResource.insert. Realiza esta llamada hasta que recibas una respuesta de 200.
    3. Después de verificar el dominio, cambia el nombre del nombre de usuario temporal mediante los métodos users.patch o users.update.
  3. Si no puedes verificar el dominio del cliente, haz lo siguiente:

    1. Crea un usuario administrador temporal mediante el método users.insert.
    2. Haz que tu cliente acceda como usuario temporal y verifica su dominio a través de la Consola del administrador.
    3. Después de que se verifique el dominio, el cliente o tú puedes cambiar el nombre de usuario temporal. Puedes usar los métodos users.patch o users.update.

412:limitExceeded

Este error ocurre cuando tu cliente alcanza su límite máximo de licencias. Para resolver este problema, usa el método subscriptions.changeSeats 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.