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 elcustomerId
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ámetrodomain
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:
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.Si puede verificar el dominio del cliente, haga lo siguiente:
- 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. - Cuando verifiques el dominio, agrega los usuarios temporales al parámetro
owners[]
del cuerpo de la solicitud para la llamadawebResource.insert
. Realiza esta llamada hasta que recibas una respuesta de200
. - Después de verificar el dominio, cambia el nombre del nombre de usuario temporal mediante los métodos
users.patch
ousers.update
.
- Crea un usuario administrador temporal mediante el método
Si no puedes verificar el dominio del cliente, haz lo siguiente:
- Crea un usuario administrador temporal mediante el método
users.insert
. - Haz que tu cliente acceda como usuario temporal y verifica su dominio a través de la Consola del administrador.
- 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
ousers.update
.
- Crea un usuario administrador temporal mediante el método
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ámetromaximumNumberOfSeats
. - Para
ANNUAL
, aumenta el parámetronumberOfSeats
.