Résoudre les problèmes liés à l'API Reseller

Cette page décrit certains problèmes courants que vous pouvez rencontrer avec l'API Reseller.

400:badRequest

Cette erreur se produit lorsque l'abonnement est suspendu ou résilié. Pour en savoir plus, consultez Activer un abonnement.

400:invalid

Cette erreur peut se produire pour plusieurs raisons.

Si vous utilisez la méthode customers.insert, l'un des paramètres d'objet client suivants n'est pas valide :

  • postalAddress.postalCode non valide.
  • postalAddress.countryCode non éligible à la revente de Google Workspace.
  • alternateEmail ne peut pas se trouver sur le même domaine que customerDomain.

Pour résoudre ce problème, vérifiez que les paramètres requis sont présents et valides pour le client.

Si vous utilisez la méthode subscriptions.changeSeats, l'un des problèmes suivants peut être à l'origine de cette erreur :

  • Vous ne pouvez pas réduire le nombre de licences pour les forfaits annuels. Envisagez de modifier les paramètres de renouvellement. pour que le nombre de licences soit automatiquement défini (au moment du renouvellement) sur le nombre d'utilisateurs actifs du compte.
  • Le nombre de licences que vous avez demandé est inférieur au nombre actuel d'utilisateurs du compte. Indiquez au client qu'il doit supprimer un utilisateur avant de pouvoir réduire le nombre de licences.
  • Vous avez augmenté le mauvais paramètre de siège. Pour le forfait FLEX, augmentez le paramètre maximumNumberOfSeats, et pour le forfait ANNUAL, augmentez le paramètre numberOfSeats.
  • Vous avez essayé de modifier le paramètre licensedNumberOfSeats, qui est un paramètre en lecture seule.
  • Pendant la période d'essai, le nombre maximal de licences utilisateur est de 10. Passez d'un abonnement d'essai sans frais à un service payant pour mettre fin immédiatement à la période d'essai, commencer la facturation et supprimer la limite maximale de 10 utilisateurs.

403:forbidden

Cette erreur se produit lorsque vous n'êtes pas propriétaire du client ou que celui-ci a désactivé l'accès des revendeurs à sa console d'administration.

403:usageLimits.dailyLimitExceeded

Cette erreur se produit lorsque vous avez atteint le quota quotidien d'appels à cette API. Pour résoudre ce problème, implémentez un délai de backoff. Pour en savoir plus, consultez Limites et quotas d'utilisation.

Si vous essayez de récupérer de nombreux abonnements, pensez à utiliser la méthode subscriptions.list sans spécifier les paramètres customerId ni subscriptionId. Vous pouvez renvoyer un maximum de 100 abonnements par appel. Utilisez le paramètre pageToken pour continuer à récupérer tous les abonnements d'un compte revendeur.

403:usageLimits.accessNotConfigured

Cette erreur se produit lorsque l'API n'est pas activée dans le projet Google Cloud. Pour résoudre ce problème, accédez à la console Google Cloud et activez l'API. Pour en savoir plus, consultez Activer les API Google Workspace.

404:notFound

Lorsque vous utilisez la méthode customers.get, cette erreur signifie que le client ou le domaine n'existe pour aucun compte Google Workspace et que le domaine est disponible.

412:conditionNotMet

Cette erreur est due à différents problèmes.

Si vous rencontrez cette erreur lorsque vous utilisez la méthode subscriptions.changeRenewalSettings, assurez-vous de n'appeler cette méthode que sur les forfaits avec engagement suivants :

  • ANNUAL_MONTHLY_PAY
  • ANNUAL_YEARLY_PAY

Si cette erreur se produit lorsque vous utilisez la méthode subscriptions.delete, cela signifie qu'aucun utilisateur administrateur n'est présent dans le compte Google Workspace. Pour résoudre ce problème, ajoutez un administrateur temporaire et réessayez.

Si cette erreur se produit lorsque vous utilisez la méthode subscriptions.insert, cela signifie que vous ne pouvez pas revendre le SKU sélectionné ou au client du marché émergent. Pour résoudre ce problème, acceptez les conditions d'utilisation applicables.

429:usageLimits.quotaExceeded

Cette erreur se produit lorsque vous avez dépassé la limite de requêtes par seconde. Pour résoudre ce problème, implémentez une stratégie de répétition avec intervalle ou mettez les résultats en cache pour effectuer moins d'appels d'API. Pour en savoir plus, consultez Limites et quotas d'utilisation.

Si vous essayez de récupérer de nombreux abonnements, pensez à utiliser la méthode subscriptions.list sans spécifier les paramètres customerId ni subscriptionId. Vous pouvez renvoyer un maximum de 100 abonnements par appel. Utilisez le paramètre pageToken pour continuer à récupérer tous les abonnements d'un compte revendeur.