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 la section 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 de l'objet client suivants n'est pas valide:

  • postalAddress.postalCode non valide.
  • postalAddress.countryCode n'est pas éligible à la revente de Google Workspace.
  • 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'une des erreurs suivantes peut être à l'origine de cette erreur:

  • Vous ne pouvez pas réduire le nombre de licences pour les types d'abonnements annuels. Envisagez de modifier les paramètres de renouvellement. pour que l'abonnement définisse automatiquement (au moment du renouvellement) le nombre de sièges égal au nombre d'utilisateurs actifs du compte.
  • Le nombre de licences utilisateur que vous avez demandé est inférieur au nombre d'utilisateurs actuels du compte. Indiquez au client qu'il doit supprimer un utilisateur avant de pouvoir réduire le nombre de licences.
  • 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 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 limité à 10. Démarrez un service payant à partir d'un abonnement d'essai sans frais pour mettre fin immédiatement à la période d'essai, démarrer la facturation et supprimer la limite maximale de 10 licences.

403:forbidden

Cette erreur se produit lorsque vous n'êtes pas le propriétaire du client ou que votre client 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 de cette API. Pour résoudre ce problème, implémentez un délai de recul. Pour en savoir plus, consultez la section Limites d'utilisation et quotas.

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 au maximum 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 un certain nombre de problèmes différents.

Si vous rencontrez cette erreur lorsque vous utilisez la méthode subscriptions.changeRenewalSettings, assurez-vous de n'appeler cette méthode que pour les forfaits de paiement avec 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 dans le compte Google Workspace. Pour résoudre ce problème, ajoutez un utilisateur administrateur temporaire, puis réessayez.

Si vous rencontrez cette erreur lorsque vous utilisez la méthode subscriptions.insert, cela signifie que vous ne pouvez pas revendre le SKU sélectionné ou au client sur les marchés émergents. 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 délai avant expiration ou mettez en cache les résultats pour effectuer moins d'appels d'API. Pour en savoir plus, consultez la section Limites d'utilisation et quotas.

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 au maximum 100 abonnements par appel. Utilisez le paramètre pageToken pour continuer à récupérer tous les abonnements d'un compte revendeur.