In questa pagina vengono descritti alcuni problemi comuni che potresti riscontrare relativamente all'API Directory in qualità di rivenditore.
400:badRequest
Questo errore si verifica quando viene trasmesso un valore parametro errato al metodo.
Se utilizzi il metodo users.get
, verifica che il valore trasmesso al parametro userKey
sia l'indirizzo email principale, l'indirizzo email dell'alias o l'ID utente univoco dell'utente.
Se utilizzi il metodo users.list
, verifica i seguenti parametri:
- Parametro
customer
: utilizza solo il valorecustomerId
generato da Google. Non utilizzare il dominio effettivo del cliente. Ti consigliamo di utilizzare questo parametro perché se un cliente ha domini secondari, l'utilizzo del parametrodomain
restituisce solo gli utenti con indirizzi email in quel dominio specifico. - Parametro
domain
: utilizza solo il dominio effettivo del cliente. Non utilizzare l'elemento
customerId
generato da Google.
403:domainCannotUseApis
Questo errore si verifica quando il cliente ha disattivato l'accesso del rivenditore all'API SDK Admin. Per risolvere il problema, chiedi al cliente di riattivare l'accesso all'API SDK Admin. Per maggiori informazioni, consulta Controllare l'accesso all'API.
Se stai tentando di ottenere il numero degli utenti con licenza attuali e ricevi questo errore, anziché chiamare il metodo users.list
, utilizza il campo licensedNumberOfSeats
della risorsa di abbonamento.
403:forbidden
Questo errore si verifica quando il cliente non è di tua proprietà o se il cliente ha disattivato l'accesso del rivenditore alla sua Console di amministrazione.
Per risolvere il problema, chiama il metodo customers.get
prima di effettuare chiamate per verificare la proprietà del cliente da parte del rivenditore o chiedi al cliente di riattivare l'accesso del rivenditore alla sua Console di amministrazione. Per ulteriori informazioni, vedi Accedere alla Console di amministrazione di un cliente.
403:usageLimits.accessNotConfigured
Questo errore si verifica quando l'API non è abilitata nel progetto Google Cloud. Per risolvere questo problema, vai alla console Google Cloud e abilita l'API. Per saperne di più, consulta Abilitare le API Google Workspace.
409:duplicate
Questo errore si verifica quando provi ad aggiungere un nuovo utente, ma l'indirizzo email principale del cliente esiste già in uno dei seguenti indirizzi:
- Account Google Workspace attuale a cui stai tentando di aggiungere l'utente.
- Un altro prodotto Google (non Google Workspace).
Per risolvere il problema:
Chiama il metodo
users.get
.Se ricevi una risposta
200
, significa che l'utente esiste già nell'account Google Workspace del cliente. Impossibile aggiungere questo utente all'account.Se ricevi una risposta
403 forbidden
, significa che il dominio nel parametro email principale non è un cliente del rivenditore oppure l'indirizzo email principale è stato utilizzato in precedenza per un prodotto Google diverso e per poter aggiungere correttamente l'utente è necessario verificare il dominio del cliente.Se puoi verificare il dominio del cliente:
- Crea un utente amministratore temporaneo utilizzando il
metodo
users.insert
e continua il provisioning fino al passaggio finale di verifica del dominio. - Durante la verifica del dominio, aggiungi gli utenti temporanei nel parametro
owners[]
del corpo della richiesta per la chiamatawebResource.insert
. Effettua questa chiamata finché non ricevi una risposta200
. - Dopo la verifica del dominio, rinomina il nome utente temporaneo utilizzando i metodi
users.patch
ousers.update
.
- Crea un utente amministratore temporaneo utilizzando il
metodo
Se non riesci a verificare il dominio del cliente:
- Crea un utente amministratore temporaneo utilizzando il
metodo
users.insert
. - Chiedi al cliente di accedere come utente temporaneo e verificare il suo dominio tramite la Console di amministrazione.
- Dopo la verifica del dominio, il cliente o puoi rinominare il nome utente temporaneo. Puoi utilizzare i metodi
users.patch
ousers.update
.
- Crea un utente amministratore temporaneo utilizzando il
metodo
412:limitExceeded
Questo errore si verifica quando il cliente ha raggiunto il limite massimo di utenze. Per risolvere il problema, utilizza il metodo subscriptions.changeSeats
e, a seconda del piano di abbonamento, utilizza quanto segue:
- Per
FLEXIBLE
, aumenta il parametromaximumNumberOfSeats
. - Per
ANNUAL
, aumenta il parametronumberOfSeats
.