Risolvere i problemi relativi all'API Directory

Questa pagina descrive alcuni problemi comuni che potresti riscontrare in qualità di rivenditore che utilizza l'API Directory.

400:badRequest

Questo errore si verifica quando al metodo viene passato un valore del parametro errato.

Se utilizzi il metodo users.get, verifica che il valore passato nel parametro userKey sia l'indirizzo email principale, l'indirizzo email alias o l'ID utente univoco dell'utente.

Se utilizzi il metodo users.list, verifica i seguenti parametri:

  • Parametro customer: utilizza solo il customerId 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 parametro domain restituisce solo gli utenti con indirizzi email su quel particolare dominio.
  • Parametro domain: utilizza solo il dominio effettivo del cliente. Non utilizzare il
    customerId generato da Google.

403:domainCannotUseApis

Questo errore si verifica quando il cliente ha disattivato l'accesso del rivenditore all'API Admin SDK. Per risolvere il problema, chiedi al cliente di riattivare l'accesso all'API Admin SDK. Per saperne di più, consulta Controllare l'accesso all'API.

Se stai tentando di ottenere il conteggio 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 non sei il proprietario del cliente o 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 rivenditore del cliente o chiedi al cliente di riattivare l'accesso del rivenditore alla 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ù, vedi Attivare le API Google Workspace.

409:duplicate

Questo errore si verifica quando tenti di aggiungere un nuovo utente, ma l'email principale del cliente esiste già in uno dei seguenti elementi:

  • L'account Google Workspace corrente a cui stai tentando di aggiungerlo.
  • Un altro prodotto Google (non Google Workspace).

Per risolvere il problema:

  1. Chiama il metodo users.get.

    Se ricevi una risposta 200, l'utente esiste già nell'account Google Workspace del cliente. Non puoi aggiungere questo utente all'account.

    Se ricevi una risposta 403 forbidden, significa che il dominio nel parametro email principale non è un cliente rivenduto o che l'email principale è stata utilizzata in precedenza per un altro prodotto Google e il dominio del cliente deve prima essere verificato prima che questo utente possa essere aggiunto correttamente.

  2. Se riesci a verificare il dominio del cliente, procedi nel seguente modo:

    1. Crea un utente amministratore temporaneo utilizzando il metodo users.insert e continua il provisioning fino al passaggio finale di verifica del dominio.
    2. Quando verifichi il dominio, aggiungi gli utenti temporanei al parametro owners[] del corpo della richiesta per la chiamata webResource.insert. Effettua questa chiamata finché non ricevi una risposta 200.
    3. Dopo la verifica del dominio, rinomina il nome utente temporaneo utilizzando il metodo users.patch o users.update.

  3. Se non riesci a verificare il dominio del cliente, procedi nel seguente modo:

    1. Crea un utente amministratore temporaneo utilizzando il metodo users.insert.
    2. Chiedi al cliente di accedere come utente temporaneo e di verificare il dominio tramite la Console di amministrazione.
    3. Una volta verificato il dominio, il cliente o tu potete rinominare il nome utente temporaneo. Puoi utilizzare il metodo users.patch o il metodo users.update.

412:limitExceeded

Questo errore si verifica quando il cliente ha raggiunto il limite massimo di utenze. Per risolvere questo problema, utilizza il metodo subscriptions.changeSeats e, a seconda del piano di abbonamento, utilizza quanto segue:

  • Per FLEXIBLE, aumenta il parametro maximumNumberOfSeats.
  • Per ANNUAL, aumenta il parametro numberOfSeats.