Risolvere i problemi relativi all'API Directory

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

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 al 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 valore customerId generato da Google. Non utilizzare il dominio del cliente effettivo. Ti consigliamo di utilizzare questo parammetro perché, se un cliente ha domini secondari, l'utilizzo del parametro domain restituisce solo gli utenti con indirizzi email in quel determinato dominio.
  • Parametro domain: utilizza solo il dominio del cliente effettivo. 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 SDK Admin. Per ulteriori informazioni, consulta Controllare l'accesso all'API.

Se stai tentando di ottenere il conteggio degli utenti con licenza corrente e ricevi questo messaggio di errore, anziché chiamare il metodo users.list, utilizza il campo licensedNumberOfSeats della risorsa dell'abbonamento.

403:forbidden

Questo errore si verifica quando non sei il proprietario del cliente o quando 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, consulta 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 attiva l'API. Per ulteriori informazioni, consulta Attivare le API Google Workspace.

409:duplicate

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

  • Account Google Workspace corrente a cui stai tentando di aggiungerli.
  • 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 che il dominio del cliente deve prima essere verificato prima che questo utente possa essere aggiunto correttamente.

  2. Se puoi 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. Durante la verifica del 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 da 200.
    3. Dopo aver verificato il dominio, rinomina il nome utente temporaneo utilizzando il metodo users.patch o il metodo 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 suo dominio tramite la Console di amministrazione.
    3. Una volta verificato il dominio, il cliente o tu puoi rinominare il nome utente temporaneo. Puoi utilizzare il metodo users.patch oppure il metodo users.update

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, procedi nel seguente modo:

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