Risoluzione dei problemi relativi all'API dei rivenditori

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 di customerDomain

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 parametro maximumNumberOfSeats e per il piano ANNUAL, aumenta il parametro numberOfSeats.
  • 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.