In questa pagina vengono descritti alcuni problemi comuni che potresti riscontrare nell'ambito dell'API dei rivenditori.
400:badRequest
Questo errore si verifica quando l'abbonamento viene sospeso o annullato. Per ulteriori 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.postalAddress.countryCode
non idoneo per la rivendita di Google Workspace.alternateEmail
non può trovarsi nello stesso dominio dicustomerDomain
Per risolvere il problema, verifica che i parametri richiesti siano presenti e validi per il cliente.
Se utilizzi il metodo subscriptions.changeSeats
, questo errore potrebbe essere stato causato da uno dei seguenti
problemi:
- Non puoi ridurre le utenze per i tipi di piano annuale. Valuta la possibilità di modificare le impostazioni di rinnovo. affinché l'abbonamento imposti automaticamente (al momento del rinnovo) utenze uguali al numero di utenti attivi nell'account.
- L'importo delle utenze richiesto è inferiore al numero di utenti correnti dell'account. Invia un messaggio al cliente per chiedergli di rimuovere un utente prima di poter ridurre il numero di utenze.
- Hai aumentato il parametro utenza errato. Per il piano
FLEX
, aumenta il parametromaximumNumberOfSeats
e per il pianoANNUAL
, aumenta il parametronumberOfSeats
. - Hai tentato di modificare il parametro
licensedNumberOfSeats
, che è di sola lettura. - Durante il periodo di prova, i clienti hanno un limite massimo di 10 utenze. Inizia un servizio a pagamento partendo da un abbonamento di prova senza costi per terminare immediatamente il periodo di prova, avviare la fatturazione e rimuovere il limite massimo di 10 utenze.
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.
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 molte sottoscrizioni, valuta l'utilizzo del 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 di 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 abilita l'API. Per saperne di più, consulta Abilitare le API Google Workspace.
404:notFound
Quando utilizzi il metodo customers.get
, questo errore significa 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 chiamare questo metodo soltanto con i seguenti piani di pagamento con impegno:
ANNUAL_MONTHLY_PAY
ANNUAL_YEARLY_PAY
Se si verifica questo errore quando utilizzi il metodo subscriptions.delete
, significa che non è presente alcun utente amministratore nell'account Google Workspace. Per risolvere il problema, aggiungi un utente amministratore temporaneo e riprova.
Se riscontri questo errore quando utilizzi il metodo subscriptions.insert
, significa che non puoi rivendere lo SKU selezionato o al cliente dei mercati emergenti. Per risolvere il problema, accetta i Termini di servizio applicabili.
429:usageLimits.quotaExceeded
Questo errore si verifica quando hai superato il limite di query al secondo. Per risolvere il problema, implementa una strategia per i tentativi di backoff o memorizza nella cache i risultati per effettuare meno chiamate API. Per ulteriori informazioni, consulta Limiti e quote di utilizzo.
Se stai tentando di recuperare molte sottoscrizioni, valuta l'utilizzo del 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 di un account rivenditore.