En esta página, se describen algunos problemas comunes que pueden surgir relacionados con la API de distribuidor.
400:badRequest
Este error se produce cuando se suspende o cancela la suscripción. Para obtener más información, consulta Cómo activar una suscripción.
400:invalid
Este error puede deberse a varios motivos diferentes.
Si usas el método customers.insert
, uno de los siguientes parámetros del objeto de cliente no es válido:
postalAddress.postalCode
no es válido.- No cumple con los requisitos para revender Google Workspace a
postalAddress.countryCode
. alternateEmail
no puede estar en el mismo dominio quecustomerDomain
A fin de resolver este problema, verifica que los parámetros obligatorios estén presentes y sean válidos para el cliente.
Si usas el método subscriptions.changeSeats
, es posible que uno de los siguientes problemas haya causado este error:
- No puedes reducir las licencias para los tipos de planes anuales. Considera cambiar la configuración de renovación. para que la suscripción establezca automáticamente (en el momento de la renovación) licencias iguales a la cantidad de usuarios activos en la cuenta.
- La cantidad de licencias que solicitaste es inferior a la de los usuarios actuales de la cuenta. Envíale un mensaje al cliente para informarle que debe quitar a un usuario antes de que pueda reducir su recuento de licencias.
- Aumentó el parámetro de asiento incorrecto. Para el plan
FLEX
, aumenta el parámetromaximumNumberOfSeats
y, para el planANNUAL
, aumenta el parámetronumberOfSeats
. - Intentaste cambiar el parámetro
licensedNumberOfSeats
, que es un parámetro de solo lectura. - Durante el período de prueba, los clientes tienen un límite máximo de 10 licencias. Inicia un servicio pagado desde una suscripción de prueba gratuita para finalizar de inmediato el período de prueba, comenzar la facturación y quitar el límite máximo de 10 licencias.
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.
403:usageLimits.dailyLimitExceeded
Este error se produce cuando alcanzas la cuota diaria para las llamadas a esta API. Para resolver este problema, implementa un retraso de retirada. Para obtener más información, consulta Límites de uso y cuotas.
Si intentas recuperar muchas suscripciones, considera usar el método subscriptions.list
sin especificar los parámetros customerId
o subscriptionId
. Puedes mostrar un máximo de 100 suscripciones por llamada. Usa el parámetro pageToken
para seguir recuperando todas las suscripciones de una cuenta de distribuidor.
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.
404:notFound
Cuando se usa el método customers.get
, este error significa que el cliente o el dominio no existen para ninguna cuenta de Google Workspace y que el dominio está disponible.
412:conditionNotMet
Este error se debe a varios problemas diferentes.
Si encuentras este error cuando usas el método subscriptions.changeRenewalSettings
, asegúrate de llamar solo a este método en los siguientes planes de pago de compromiso:
ANNUAL_MONTHLY_PAY
ANNUAL_YEARLY_PAY
Si encuentras este error cuando usas el método subscriptions.delete
, significa que no hay un usuario administrador en la cuenta de Google Workspace. Para resolver este problema, agrega un usuario administrador temporal y vuelve a intentarlo.
Si encuentras este error cuando usas el método subscriptions.insert
, significa que no puedes revender el SKU seleccionado ni al cliente de mercado emergente. Para resolver este problema, acepta las Condiciones del Servicio aplicables.
429:usageLimits.quotaExceeded
Este error se produce cuando superas el límite de consultas por segundo. A fin de resolver este problema, implementa una estrategia de reintento de retirada o reduce los resultados de la caché para realizar menos llamadas a la API. Para obtener más información, consulta Límites de uso y cuotas.
Si intentas recuperar muchas suscripciones, considera usar el método subscriptions.list
sin especificar los parámetros customerId
o subscriptionId
. Puedes mostrar un máximo de 100 suscripciones por llamada. Usa el parámetro pageToken
para seguir recuperando todas las suscripciones de una cuenta de distribuidor.