Cette page décrit certains problèmes courants que vous pouvez rencontrer concernant 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
est l'adresse e-mail principale, l'alias d'adresse e-mail ou l'ID utilisateur unique.
Si vous utilisez la méthode users.list
, vérifiez les paramètres suivants:
- Paramètre
customer
: n'utilisez que l'élémentcustomerId
généré par Google. N'utilisez pas le domaine du client. Nous vous recommandons d'utiliser ce paramètre, car si un client possède des domaines secondaires, le paramètredomain
ne renvoie que les utilisateurs disposant d'adresses e-mail sur ce domaine. - 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 à l'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ôler l'accès aux API.
Si vous essayez d'obtenir le nombre d'utilisateurs actuels sous licence et que cette erreur s'affiche, 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 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.
Pour résoudre ce problème, appelez la méthode customers.get
avant d'effectuer des appels pour confirmer que le revendeur est le propriétaire du client, ou demandez à votre client de réactiver l'accès du revendeur à 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 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.
- Un autre produit Google (autre que Google Workspace)
Pour résoudre ce problème, procédez comme suit :
Appelez la méthode
users.get
.Si vous recevez une réponse
200
, cela signifie que 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 indirect, 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é pour que l'utilisateur puisse être ajouté.Si vous pouvez valider le domaine du client, procédez comme suit:
- Créez un compte administrateur temporaire à l'aide de la méthode
users.insert
et poursuivez le provisionnement jusqu'à l'étape finale de validation du domaine. - Lors de la validation du domaine, ajoutez les utilisateurs temporaires dans le paramètre
owners[]
du corps de la requête pour l'appelwebResource.insert
. Passez cet appel jusqu'à ce que vous receviez une réponse200
. - Une fois le domaine validé, renommez le nom d'utilisateur temporaire à l'aide de la méthode
users.patch
ouusers.update
.
- Créez un compte administrateur temporaire à l'aide de la méthode
Si vous ne parvenez pas à valider le domaine du client, procédez comme suit:
- Créez un administrateur temporaire à l'aide de la méthode
users.insert
. - Demandez à votre client de se connecter en tant qu'utilisateur temporaire et de valider son domaine dans la console d'administration.
- Une fois le domaine validé, le nom d'utilisateur temporaire peut être renommé par le client ou par vous-même. Vous pouvez utiliser la méthode
users.patch
ouusers.update
.
- Créez un administrateur temporaire à l'aide de la méthode
412:limitExceeded
Cette erreur se produit lorsque votre client a atteint le nombre maximal de licences utilisateur. Pour résoudre ce problème, utilisez la méthode subscriptions.changeSeats
et, en fonction de son forfait, utilisez le code suivant:
- Pour
FLEXIBLE
, augmentez la valeur du paramètremaximumNumberOfSeats
. - Pour
ANNUAL
, augmentez la valeur du paramètrenumberOfSeats
.