Risoluzione dei problemi relativi all'API dei rivenditori

In questa pagina vengono descritti alcuni problemi comuni che potresti riscontrare relativamente ai l'API dei rivenditori.

400:badRequest

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

400:invalid

Questo errore può verificarsi per diversi motivi.

Se utilizzi il metodo customers.insert, uno dei seguenti clienti I parametri dell'oggetto non sono validi:

  • postalAddress.postalCode non valido.
  • postalAddress.countryCode non idoneo per la rivendita di Google Workspace.
  • alternateEmail non può appartenere allo 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 potrebbero aver causato questo errore:

  • Non è possibile ridurre le utenze per i tipi di piano annuale. Prendi in considerazione modificando 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 che hai richiesto è inferiore a quello degli utenti correnti nella . Invia un messaggio al cliente per invitarlo a rimuovere un utente prima che possa farlo ridurre il numero di utenze.
  • Hai aumentato il parametro del posto errato. Per il piano FLEX, aumenta il parametro maximumNumberOfSeats e, per il piano ANNUAL, aumenta il numberOfSeats.
  • Hai tentato di modificare il parametro licensedNumberOfSeats, che è un di sola lettura.
  • Durante il periodo di prova, i clienti hanno un limite massimo di 10 utenze. Attivare un servizio a pagamento da un abbonamento di prova senza costi a terminare immediatamente il periodo di prova, iniziare la fatturazione e rimuovere le 10 utenze limite massimo.

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.

403:usageLimits.dailyLimitExceeded

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

Se stai cercando di recuperare molte sottoscrizioni, valuta l'utilizzo del metodo subscriptions.list senza specificare il metodo customerId o Parametri 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. Da risolvere questo problema, vai alla console Google Cloud e abilita l'API. Per maggiori informazioni le informazioni, vedi Abilita le API Google Workspace.

404:notFound

Quando utilizzi il metodo customers.get, questo errore significa che il cliente o dominio non esiste per alcun account Google Workspace e che se un dominio è disponibile.

412:conditionNotMet

Questo errore è causato da una serie di problemi diversi.

Se riscontri questo errore quando utilizzi subscriptions.changeRenewalSettings , assicurati di chiamare questo metodo solo nel seguente modo con impegno di pagamento:

  • ANNUAL_MONTHLY_PAY
  • ANNUAL_YEARLY_PAY

Se riscontri questo errore quando utilizzi il metodo subscriptions.delete, indica che in Google Workspace non è presente alcun utente amministratore . 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 mercato emergente al cliente. Per risolvere il problema, accetta i termini di servizio applicabili.

429:usageLimits.quotaExceeded

Questo errore si verifica quando superi il limite di query al secondo. A risolvere il problema, implementare una strategia di backoff per i nuovi tentativi o memorizzare nella cache i risultati di chiamate API in meno. Per ulteriori informazioni, vedi Limiti di utilizzo e quote.

Se stai cercando di recuperare molte sottoscrizioni, valuta l'utilizzo del metodo subscriptions.list senza specificare il metodo customerId o Parametri 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.