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

Cette page décrit certains des problèmes courants liés aux l'API Directory en tant que revendeur.

400:badRequest

Cette erreur se produit lorsqu'une valeur de paramètre incorrecte est transmise à la méthode.

Si vous utilisez la méthode users.get, vérifiez que la valeur transmise à userKey est l'adresse e-mail principale de l'utilisateur, l'alias d'adresse e-mail ou un ID d'utilisateur unique.

Si vous utilisez la méthode users.list, vérifiez les paramètres suivants:

  • Paramètre customer: n'utilisez que le customerId généré par Google N'utilisez pas le véritable domaine du client. Nous vous recommandons d'utiliser car si un client possède des domaines secondaires, l'utilisation de domain ne renvoie que les utilisateurs dont les adresses e-mail appartiennent à ce domaine particulier.
  • Paramètre domain: n'utilisez que le domaine du client. N'utilisez pas le
    customerId généré par Google.

403:domainCannotUseApis

Cette erreur se produit lorsque votre client a désactivé l'accès du revendeur à la API SDK Admin. Pour résoudre ce problème, demandez à votre client de réactiver l'accès à l'API SDK Admin. Pour en savoir plus, consultez Contrôlez l'accès aux API.

Si vous essayez d'obtenir le nombre d'utilisateurs actuels disposant d'une licence au lieu d'appeler la méthode users.list, utilisez le champ licensedNumberOfSeats à partir de la ressource d'abonnement.

403:forbidden

Cette erreur se produit lorsque vous n'êtes pas le propriétaire du client ou que celui-ci a désactivé un accès revendeur à la console d'administration.

Pour résoudre ce problème, appelez la méthode Méthode customers.get avant d'effectuer des appels afin de vérifier que le client est bien le propriétaire du revendeur ou de poser la question à votre au client de réactiver l'accès du revendeur à sa console d'administration. Pour plus pour en savoir plus, consultez Accédez à la console d'administration d'un client.

403:usageLimits.accessNotConfigured

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

409:duplicate

Cette erreur se produit lorsque vous essayez d'ajouter un nouvel utilisateur, L'adresse e-mail principale figure déjà dans l'un des éléments suivants:

  • Compte Google Workspace actuel auquel vous essayez de les ajouter.
  • Un autre produit Google (autre que Google Workspace)

Pour résoudre ce problème :

  1. Appelez la méthode users.get.

    Si vous obtenez une réponse 200, cela signifie que l'utilisateur existe déjà dans le compte compte Google Workspace. Vous ne pouvez pas ajouter cet utilisateur au compte.

    Si vous obtenez une réponse 403 forbidden, le domaine de l'instance principale Le paramètre email ne correspond pas à un client indirect ou l'adresse e-mail principale a été utilisée pour un autre produit Google, et le domaine du client doit d'abord vérifier avant de pouvoir ajouter cet utilisateur.

  2. Si vous pouvez valider le domaine du client, procédez comme suit:

    1. Créez un administrateur temporaire à l'aide du Méthode users.insert et poursuivez le provisionnement jusqu'à l'étape finale de validation du domaine.
    2. Lors de la validation du domaine, ajoutez les utilisateurs temporaires dans owners[] du corps de la requête pour Appel webResource.insert. Passez cet appel jusqu'à ce que vous receviez une réponse 200.
    3. Une fois le domaine validé, renommez le nom d'utilisateur temporaire en utilisant soit users.patch ou users.update méthodes.

  3. Si vous ne parvenez pas à valider le domaine du client, procédez comme suit:

    1. Créez un administrateur temporaire à l'aide du Méthode users.insert.
    2. Demandez à votre client de se connecter en tant qu'utilisateur temporaire et de valider ses via la console d'administration.
    3. Une fois le domaine validé, vous ou le client pouvez renommer le nom d'utilisateur temporaire. Vous pouvez utiliser users.patch ou users.update méthodes.

412:limitExceeded

Cette erreur se produit lorsque votre client a atteint le nombre maximal de licences utilisateur. À résolvez ce problème, utilisez la méthode subscriptions.changeSeats. et, en fonction de leur abonnement, utilisez les éléments suivants:

  • Pour FLEXIBLE, augmentez le paramètre maximumNumberOfSeats.
  • Pour ANNUAL, augmentez le paramètre numberOfSeats.