Rozwiązywanie problemów z interfejsem Seller API

Na tej stronie znajdziesz opis kilku częstych problemów, jakie mogą wystąpić podczas korzystania z interfejsu Reseller API.

400:badRequest

Ten błąd występuje, gdy subskrypcja jest zawieszona lub anulowana. Więcej informacji znajdziesz w artykule Aktywowanie subskrypcji.

400:invalid

Ten błąd może wystąpić z kilku różnych powodów.

Jeśli używasz metody customers.insert, jeden z tych parametrów obiektu klienta jest nieprawidłowy:

  • Nieprawidłowy parametr postalAddress.postalCode.
  • Nieprawidłowy parametr postalAddress.countryCode w przypadku odsprzedaży Google Workspace.
  • Parametr alternateEmail nie może znajdować się w tej samej domenie co parametr customerDomain.

Aby rozwiązać ten problem, sprawdź, czy wymagane parametry są obecne i prawidłowe dla klienta.

Jeśli używasz metody subscriptions.changeSeats, ten błąd mógł wystąpić z jednego z tych powodów:

  • Nie możesz zmniejszyć liczby stanowisk w przypadku abonamentów rocznych. Rozważ zmianę ustawień odnawiania. subskrypcji, aby automatycznie ustawić (w momencie odnowienia) liczbę stanowisk równą liczbie aktywnych użytkowników na koncie.
  • Liczba stanowisk, o którą prosisz, jest mniejsza niż liczba obecnych użytkowników na koncie. Poinformuj klienta, że musi usunąć użytkownika, zanim będzie mógł zmniejszyć liczbę stanowisk.
  • Zwiększono nieprawidłowy parametr stanowiska. W przypadku abonamentu FLEX zwiększ parametr maximumNumberOfSeats, a w przypadku abonamentu ANNUAL – parametr numberOfSeats.
  • Próbujesz zmienić parametr licensedNumberOfSeats, który jest parametrem tylko do odczytu.
  • W okresie próbnym klienci mają maksymalny limit 10 stanowisk. Aby natychmiast zakończyć okres próbny, rozpocząć naliczanie opłat i usunąć limit 10 stanowisk, rozpocznij płatną usługę z bezpłatnej subskrypcji próbnej.

403:forbidden

Ten błąd występuje, gdy nie jesteś właścicielem klienta lub gdy klient wyłączył dostęp sprzedawcy do konsoli administracyjnej.

403:usageLimits.dailyLimitExceeded

Ten błąd występuje, gdy osiągniesz dzienny limit wywołań tego interfejsu API. Aby rozwiązać ten problem, zaimplementuj opóźnienie wycofania. Więcej informacji znajdziesz w sekcji Limity i przydziały.

Jeśli próbujesz pobrać wiele subskrypcji, rozważ użycie metody subscriptions.list bez określania parametrów customerId ani subscriptionId. W jednym wywołaniu możesz zwrócić maksymalnie 100 subskrypcji. Aby kontynuować pobieranie wszystkich subskrypcji na koncie sprzedawcy, użyj parametru pageToken.

403:usageLimits.accessNotConfigured

Ten błąd występuje, gdy interfejs API nie jest włączony w projekcie Google Cloud. Aby rozwiązać ten problem, otwórz konsolę Google Cloud i włącz interfejs API. Więcej informacji znajdziesz w artykule Włączanie interfejsów Google Workspace API.

404:notFound

Jeśli używasz metody customers.get, ten błąd oznacza, że klient lub domena nie istnieją na żadnym koncie Google Workspace i że domena jest dostępna.

412:conditionNotMet

Ten błąd jest spowodowany kilkoma różnymi problemami.

Jeśli ten błąd występuje podczas korzystania z metody subscriptions.changeRenewalSettings, upewnij się, że wywołujesz tę metodę tylko w przypadku tych abonamentów z płatnością z góry:

  • ANNUAL_MONTHLY_PAY
  • ANNUAL_YEARLY_PAY

Jeśli ten błąd występuje podczas korzystania z metody subscriptions.delete, oznacza to, że na koncie Google Workspace nie ma użytkownika z uprawnieniami administratora. Aby rozwiązać ten problem, dodaj tymczasowego użytkownika z uprawnieniami administratora i spróbuj ponownie.

Jeśli ten błąd występuje podczas korzystania z metody subscriptions.insert, oznacza to, że nie możesz odsprzedać wybranego SKU lub klienta na rynku wschodzącym. Aby rozwiązać ten problem, zaakceptuj obowiązujące warunki korzystania z usługi.

429:usageLimits.quotaExceeded

Ten błąd występuje, gdy przekroczysz limit zapytań na sekundę. Aby rozwiązać ten problem, zaimplementuj strategię ponawiania z wycofywaniem lub zapisuj wyniki w pamięci podręcznej, aby zmniejszyć liczbę wywołań interfejsu API. Więcej informacji znajdziesz w sekcji Limity i przydziały.

Jeśli próbujesz pobrać wiele subskrypcji, rozważ użycie metody subscriptions.list bez określania parametrów customerId ani subscriptionId. W jednym wywołaniu możesz zwrócić maksymalnie 100 subskrypcji. Aby kontynuować pobieranie wszystkich subskrypcji na koncie sprzedawcy, użyj parametru pageToken.