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 saperne di più, 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.
  • postalAddress.countryCode non idoneo per la rivendita di Google Workspace.
  • alternateEmail non può essere 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 in modo da impostare automaticamente (al momento del rinnovo) le utenze pari alla quantità di utenti attivi sull'account.
  • La quantità di utenze richiesta è inferiore agli utenti attuali dell'account. Invia un messaggio al cliente per informarlo che deve rimuovere un utente prima di poter ridurre il numero di utenze.
  • Hai aumentato il parametro di 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. Avvia 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 utenze.

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 per le chiamate a questa API. Per risolvere il problema, implementa un ritardo di backoff. Per saperne di più, vedi 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 di un account rivenditore.

403:usageLimits.accessNotConfigured

Questo errore si verifica quando l'API non è abilitata nel progetto Google Cloud. Per risolvere il problema, vai alla console Google Cloud e abilita l'API. Per saperne di più, vedi Abilitare le API di 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 diversi problemi.

Se riscontri 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 riscontri 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 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 saperne di più, vedi 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 di un account rivenditore.