Questa pagina è stata tradotta dall'API Cloud Translation.

Risoluzione dei problemi relativi all'API dei rivenditori

Questa pagina descrive alcuni problemi comuni che potresti riscontrare con l'API Reseller.

`400:badRequest`

Questo errore si verifica quando l'abbonamento viene sospeso o annullato. Per maggiori informazioni, consulta Attivare un abbonamento.

`400:invalid`

Questo errore può verificarsi per diversi motivi.

Se utilizzi il metodo customers.insert, uno dei seguenti parametri dell'oggetto cliente non è valido:

postalAddress.postalCode non valido.
Non idoneo postalAddress.countryCode alla rivendita di Google Workspace.
alternateEmail non può trovarsi nello stesso dominio di customerDomain

Per risolvere il problema, verifica che i parametri richiesti siano presenti e validi per il cliente.

Se utilizzi il metodo subscriptions.changeSeats, uno dei seguenti problemi potrebbe aver causato questo errore:

Non puoi ridurre le utenze per i tipi di piano annuale. Valuta la possibilità di modificare le impostazioni di rinnovo. per l'abbonamento di impostare automaticamente (al momento del rinnovo) il numero di licenze uguale al numero di utenti attivi nell'account.
Il numero di licenze richieste è inferiore al numero di utenti correnti nell'account. Comunica al cliente che deve rimuovere un utente prima di poter diminuire il numero di licenze.
Hai aumentato il parametro del sedile errato. Per il piano FLEX, aumenta il parametro maximumNumberOfSeats e per il piano ANNUAL, aumenta il parametro numberOfSeats.
Hai tentato di modificare il parametro licensedNumberOfSeats, che è un parametro di sola lettura.
Durante il periodo di prova, i clienti hanno un limite massimo di 10 licenze. Avvia un servizio a pagamento da un abbonamento con prova senza costi per terminare immediatamente il periodo di prova, avviare la fatturazione e rimuovere il limite massimo di 10 licenze.

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

`403:usageLimits.dailyLimitExceeded`

Questo errore si verifica quando hai raggiunto la quota giornaliera per le chiamate a questa API. Per risolvere il problema, implementa un ritardo di backoff. Per ulteriori informazioni, consulta Limiti e quote di utilizzo.

Se stai tentando di recuperare molti abbonamenti, ti consigliamo di utilizzare il metodo subscriptions.list senza specificare i parametri customerId o subscriptionId. Puoi restituire un massimo di 100 abbonamenti per chiamata. Utilizza il parametro pageToken per continuare a recuperare tutti gli abbonamenti in un account rivenditore.

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

`404:notFound`

Quando utilizzi il metodo customers.get, questo errore indica che il cliente o il dominio non esiste per nessun account Google Workspace e che il dominio è disponibile.

`412:conditionNotMet`

Questo errore è causato da una serie di problemi diversi.

Se si verifica questo errore quando utilizzi il metodo subscriptions.changeRenewalSettings, assicurati di chiamarlo solo con i seguenti piani di pagamento con impegno:

ANNUAL_MONTHLY_PAY
ANNUAL_YEARLY_PAY

Se riscontri questo errore quando utilizzi il metodo subscriptions.delete, significa che nell'account Google Workspace non è presente alcun utente amministratore. Per risolvere il problema, aggiungi un utente amministratore temporaneo e riprova.

Se si verifica questo errore quando utilizzi il metodo subscriptions.insert, significa che non puoi rivendere lo SKU selezionato o al cliente del mercato emergente. Per risolvere il problema, accetta i Termini di servizio vigenti.

`429:usageLimits.quotaExceeded`

Questo errore si verifica quando superi il limite di query al secondo. Per risolvere il problema, implementa una strategia di ripetizione con tempo di attesa o memorizza nella cache i risultati per effettuare meno chiamate API. Per ulteriori informazioni, consulta Limiti e quote di utilizzo.