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 è sospeso o annullato. Per maggiori informazioni, vedi 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 per la rivendita di Google Workspace.
  • alternateEmail non può trovarsi nello stesso dominio di customerDomain

Per risolvere il problema, verifica che i parametri obbligatori 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 piani annuali. Valuta la possibilità di modificare le impostazioni di rinnovo. per l'abbonamento di impostare automaticamente (al momento del rinnovo) i posti pari al numero di utenti attivi nell'account.
  • L'importo delle utenze che hai richiesto è inferiore al numero di utenti correnti dell'account. Comunica al cliente che deve rimuovere un utente prima di poter ridurre il numero di posti.
  • 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 utenze. Inizia un servizio a pagamento da un abbonamento di prova senza costi per terminare immediatamente il periodo di prova, avviare la fatturazione e rimuovere il limite massimo di 10 posti.

403:forbidden

Questo errore si verifica quando non sei il proprietario del cliente o 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 di chiamate a questa API. Per risolvere il problema, implementa un ritardo di backoff. Per ulteriori informazioni, consulta Limiti di utilizzo e quote.

Se stai tentando di recuperare molti abbonamenti, valuta la possibilità 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 abilita l'API. Per saperne di più, vedi Attivare 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 solo per 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 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 applicabili.

429:usageLimits.quotaExceeded

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

Se stai tentando di recuperare molti abbonamenti, valuta la possibilità 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.