Risolvere i problemi relativi all'API Directory

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 valore 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 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:

  1. 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.

  2. Se puoi verificare il dominio del cliente:

    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 nel 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 i metodi users.patch o users.update.

  3. Se non riesci a verificare il dominio del cliente:

    1. Crea un utente amministratore temporaneo utilizzando il metodo users.insert.
    2. Chiedi al cliente di accedere come utente temporaneo e verificare il suo dominio tramite la Console di amministrazione.
    3. Dopo la verifica del dominio, il cliente o puoi rinominare il nome utente temporaneo. Puoi utilizzare i metodi users.patch o 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, utilizza quanto segue:

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