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

Cette page décrit certains problèmes courants que vous pouvez rencontrer avec 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 au paramètre userKey correspond à l'adresse e-mail principale de l'utilisateur, à son adresse e-mail d'alias ou à son ID 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 domaine réel du client. Nous vous recommandons d'utiliser ce paramètre, car si un client possède des domaines secondaires, le domain paramètre ne renvoie que les utilisateurs dont l'adresse e-mail appartient à ce domaine spécifique.
  • Paramètre domain : n'utilisez que le domaine réel 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 des revendeurs à l'API Admin SDK. Pour résoudre ce problème, demandez à votre client de réactiver l'accès à l'API Admin SDK. Pour en savoir plus, consultez Contrôler l'accès aux API.

Si vous essayez d'obtenir le nombre d'utilisateurs sous licence actuels et que cette erreur s'affiche, au lieu d'appeler la méthode users.list, utilisez le champ licensedNumberOfSeats de la ressource d'abonnement.

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 des revendeurs à sa console d'administration.

Pour résoudre ce problème, appelez la customers.get méthode avant d'effectuer des appels pour vérifier que le revendeur est propriétaire du client, ou demandez à votre client de réactiver l'accès des revendeurs à sa console d'administration. Pour en savoir plus, consultez Accéder à 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 ce problème, accédez à la console Google Cloud et activez l'API. Pour en savoir plus, consultez Activer les API Google Workspace.

409:duplicate

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

  • Compte Google Workspace actuel auquel vous essayez de l'ajouter.
  • Autre produit Google (pas Google Workspace).

Pour résoudre ce problème, procédez comme suit :

  1. Appelez la méthode users.get.

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

    Si vous recevez une réponse 403 forbidden, cela signifie que le domaine du paramètre d'adresse e-mail principale n'est pas un client revendu ou que l'adresse e-mail principale a déjà été utilisée pour un autre produit Google. Le domaine du client doit d'abord être validé avant que cet utilisateur puisse être ajouté.

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

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

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

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

412:limitExceeded

Cette erreur se produit lorsque votre client a atteint sa limite maximale de licences. Pour résoudre ce problème, utilisez la méthode subscriptions.changeSeats et, en fonction de son forfait d'abonnement, procédez comme suit :

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