Risolvere i problemi relativi all'API Directory

In questa pagina vengono descritti alcuni problemi comuni che potresti riscontrare relativamente ai API Directory come rivenditore.

400:badRequest

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

Se utilizzi il metodo users.get, verifica che il valore trasmesso a userKey è l'indirizzo email principale, l'indirizzo email alias o l'ID utente univoco.

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

  • Parametro customer: usa solo il valore customerId generato da in tutti i canali Google. Non utilizzare il dominio del cliente effettivo. Ti consigliamo di usare questa perché se un cliente ha domini secondari, utilizzando il parametro domain restituisce solo gli utenti con indirizzi email in quel particolare dominio.
  • Parametro domain: utilizza solo il dominio effettivo del cliente. Non usare il
    customerId generato da Google.

403:domainCannotUseApis

Questo errore si verifica quando il cliente ha disattivato l'accesso da parte del rivenditore l'API SDK Admin. Per risolvere il problema, chiedi al cliente di riattivare l'accesso a l'API SDK Admin. Per ulteriori informazioni, vedi Controllare l'accesso all'API.

Se stai cercando di ottenere il conteggio degli utenti con licenza attuali e ottieni questo invece di chiamare il metodo users.list, usa il campo licensedNumberOfSeats dalla risorsa di sottoscrizione.

403:forbidden

Questo errore si verifica quando non sei il proprietario del cliente o se il tuo cliente ha disattivato l'accesso del rivenditore alla 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 chiedere di riattivare l'accesso del rivenditore alla Console di amministrazione. Per maggiori informazioni le 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. Da risolvere questo problema, vai alla console Google Cloud e abilita l'API. Per maggiori informazioni le informazioni, vedi Abilita le API Google Workspace.

409:duplicate

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

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

Per risolvere il problema:

  1. Chiama il metodo users.get.

    Se ricevi una risposta 200, significa che l'utente esiste già nel Account Google Workspace. Impossibile aggiungere questo utente all'account.

    Se ricevi una risposta 403 forbidden, il dominio nell'elenco principale il parametro email non è un cliente del rivenditore o è stato utilizzato l'indirizzo email principale in precedenza per un altro prodotto Google e il dominio del cliente verificare prima di poter aggiungere l'utente.

  2. Se puoi verificare il dominio del cliente:

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

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

    1. Crea un utente amministratore temporaneo utilizzando Metodo users.insert.
    2. Chiedi al cliente di accedere come utente temporaneo e di verificare la sua dominio tramite la Console di amministrazione.
    3. Dopo la verifica del dominio, tu o il cliente potete rinominare il un nome utente temporaneo. Puoi utilizzare users.patch o il users.update di machine learning.

412:limitExceeded

Questo errore si verifica quando il cliente ha raggiunto il limite massimo di utenze. A 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.