Cómo solucionar problemas de la API para revendedores

En esta página se describen algunos problemas habituales que pueden ocurrir en relación con la API para distribuidores.

400:badRequest

Este error ocurre 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 ocurrir por diferentes motivos.

Si usas el método customers.insert, uno de los siguientes parámetros de objeto de cliente no es válido:

  • postalAddress.postalCode no es válido.
  • postalAddress.countryCode no cumple con los requisitos para revender Google Workspace.
  • alternateEmail no puede estar en el mismo dominio que customerDomain

Para 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 de los tipos de planes anuales. Considera cambiar la configuración de renovación. para que la suscripción establezca automáticamente licencias (en el momento de la renovación) equivalentes a la cantidad de usuarios activos en la cuenta.
  • La cantidad de licencias que solicitaste es menor que la de los usuarios actuales en la cuenta. Envíale un mensaje al cliente que indique que debe quitar a un usuario para poder disminuir la cantidad de licencias.
  • Aumentaste el parámetro de asiento incorrecto. Para el plan FLEX, aumenta el parámetro maximumNumberOfSeats y, para el plan ANNUAL, aumenta el parámetro numberOfSeats.
  • 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 a partir de una suscripción de prueba gratuita para finalizar inmediatamente el período de prueba, comenzar la facturación y quitar el límite máximo de 10 licencias.

403:forbidden

Este error ocurre cuando no eres propietario del cliente o este inhabilita el acceso de los revendedores a su Consola del administrador.

403:usageLimits.dailyLimitExceeded

Este error ocurre cuando alcanzas la cuota diaria de llamadas a esta API. Para resolver este problema, implementa un retraso de retirada. Para obtener más información, consulta Límites y cuotas de uso.

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 revendedor.

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 la consola de Google Cloud y habilita la API. Para obtener más información, consulta Habilita las APIs de Google Workspace.

404:notFound

Cuando se usa el método customers.get, este error significa que el cliente o el dominio no existe 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 que solo lo estás llamando en los siguientes planes de pagos por 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 presente 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 del mercado emergente. Para resolver este problema, acepta las condiciones del servicio aplicables.

429:usageLimits.quotaExceeded

Este error ocurre cuando se supera el límite de consultas por segundo. Para resolver este problema, implementa una estrategia de reintento de retirada o almacena los resultados en caché para realizar menos llamadas a la API. Para obtener más información, consulta Límites y cuotas de uso.

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 revendedor.