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 annulé. 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 dans 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 types de plans annuels. Envisagez de modifier les paramètres de renouvellement. pour que l'abonnement définisse automatiquement (au moment du renouvellement) un nombre de licences égal au 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 licence. 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, les clients sont limités à 10 licences. 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 licences.

403:forbidden

Cette erreur se produit lorsque vous n'êtes pas propriétaire du client ou que 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 à 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 tentez de récupérer de nombreux abonnements, envisagez d'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 à plusieurs problèmes différents.

Si vous rencontrez cette erreur lorsque vous utilisez la méthode subscriptions.changeRenewalSettings, assurez-vous que vous n'appelez cette méthode que sur les plans de paiement d'engagement suivants :

  • ANNUAL_MONTHLY_PAY
  • ANNUAL_YEARLY_PAY

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

Si vous rencontrez cette erreur lorsque vous utilisez la méthode subscriptions.insert, cela signifie que vous ne pouvez pas revendre le code 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 nouvelle tentative avec backoff ou mettez en cache les résultats pour effectuer moins d'appels d'API. Pour en savoir plus, consultez Limites et quotas d'utilisation.

Si vous tentez de récupérer de nombreux abonnements, envisagez d'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.