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

Cette page décrit certains des 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 différentes 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.
  • Vous n'êtes pas autorisé à revendre Google Workspace pour postalAddress.countryCode.
  • alternateEmail ne peut pas appartenir au 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 avoir causé cette erreur:

  • Vous ne pouvez pas réduire le nombre de licences utilisateur pour les forfaits annuels. Envisagez de modifier les paramètres de renouvellement. pour que l'abonnement définisse automatiquement (au moment du renouvellement) des licences correspondant au nombre d'utilisateurs actifs sur le compte.
  • Le nombre de licences utilisateur que vous avez demandé est inférieur à celui des utilisateurs actuels du compte. Envoyer un message au client pour lui dire qu'il doit supprimer un utilisateur avant de pouvoir réduire le nombre de licences utilisateur.
  • Vous avez augmenté le paramètre de siège incorrect. Pour le plan FLEX, augmentez le paramètre maximumNumberOfSeats et pour le plan ANNUAL, augmentez le paramètre numberOfSeats.
  • Vous avez tenté de modifier le paramètre licensedNumberOfSeats, qui est en lecture seule.
  • Pendant la période d'essai, le nombre maximal de licences utilisateur est de 10. Démarrez un service payant à partir d'un essai sans frais pour mettre immédiatement fin à la période d'essai, commencer la facturation et supprimer la limite maximale de 10 licences utilisateur.

403:forbidden

Cette erreur se produit si vous n'êtes pas le propriétaire du client ou si votre client a désactivé l'accès du revendeur à sa console d'administration.

403:usageLimits.dailyLimitExceeded

Cette erreur se produit lorsque vous avez atteint le quota quotidien d'appels vers cette API. Pour résoudre ce problème, mettez en œuvre un délai d'intervalle entre les tentatives. Pour en savoir plus, consultez la page Limites et quotas d'utilisation.

Si vous essayez de récupérer de nombreux abonnements, envisagez d'utiliser la méthode subscriptions.list sans spécifier les paramètres customerId ou 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 causée par plusieurs problèmes différents.

Si vous rencontrez cette erreur lors de l'utilisation de la méthode subscriptions.changeRenewalSettings, assurez-vous de l'appeler uniquement pour les forfaits avec engagement suivants:

  • ANNUAL_MONTHLY_PAY
  • ANNUAL_YEARLY_PAY

Si vous rencontrez cette erreur lors de l'utilisation de la méthode subscriptions.delete, cela signifie qu'aucun administrateur n'est présent sur le compte Google Workspace. Pour résoudre ce problème, ajoutez un administrateur temporaire, puis réessayez.

Si vous rencontrez cette erreur lors de l'utilisation de la méthode subscriptions.insert, cela signifie que vous ne pouvez pas revendre le SKU sélectionné ni aux clients du marché émergent. Pour résoudre ce problème, acceptez les conditions d'utilisation applicables.

429:usageLimits.quotaExceeded

Cette erreur se produit lorsque vous dépassez la limite du nombre de requêtes par seconde. Pour résoudre ce problème, mettez en œuvre une stratégie d'intervalle entre les tentatives ou mettez en cache les résultats afin d'effectuer moins d'appels d'API. Pour en savoir plus, consultez la page Limites et quotas d'utilisation.

Si vous essayez de récupérer de nombreux abonnements, envisagez d'utiliser la méthode subscriptions.list sans spécifier les paramètres customerId ou 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.