Ta strona została przetłumaczona przez Cloud Translation API.

Rozwiązywanie problemów z interfejsem Seller API

Na tej stronie opisujemy kilka typowych problemów, które mogą wystąpić podczas korzystania z interfejsu Seller API.

`400:badRequest`

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

`400:invalid`

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

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

Nieprawidłowy stan: postalAddress.postalCode.
postalAddress.countryCode nie spełnia kryteriów sprzedaży Google Workspace.
Domena alternateEmail nie może być w tej samej domenie co customerDomain

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

Jeśli używasz metody subscriptions.changeSeats, przyczyną tego błędu może być jeden z tych problemów:

Nie możesz zmniejszyć liczby stanowisk w abonamencie rocznym. Rozważ zmianę ustawień odnawiania. automatyczne ustawianie (w momencie odnowienia) liczby stanowisk równych liczbie aktywnych użytkowników na koncie.
Wymagana przez Ciebie kwota jest niższa niż liczba obecnych użytkowników na koncie. Poinformuj klienta, że musi usunąć użytkownika, zanim będzie mógł zmniejszyć liczbę miejsc.
Zwiększono nieprawidłowy parametr miejsca. W przypadku planu FLEX zwiększ parametr maximumNumberOfSeats, a w przypadku planu ANNUAL – parametr numberOfSeats.
Próbujesz zmienić parametr licensedNumberOfSeats, który jest parametrem tylko do odczytu.
W okresie próbnym klienci mogą mieć maksymalnie 10 miejsc. Przejdź na płatną subskrypcję z bezpłatnego okresu próbnego, aby natychmiast zakończyć okres próbny, rozpocząć naliczanie opłat i usunąć limit 10 stanowisk.

`403:forbidden`

Ten błąd występuje, jeśli klient nie należy do Ciebie lub wyłączył dostęp sprzedawcy do swojej konsoli administracyjnej.

`403:usageLimits.dailyLimitExceeded`

Ten błąd występuje po osiągnięciu dziennego limitu wywołań tego interfejsu API. Aby rozwiązać ten problem, zaimplementuj opóźnienie do ponowienia. Więcej informacji znajdziesz w artykule Limity wykorzystania.

Jeśli chcesz pobrać wiele subskrypcji, rozważ użycie metody subscriptions.list bez określania parametrów customerId lub subscriptionId. Możesz zwrócić maksymalnie 100 subskrypcji na połączenie. Aby nadal pobierać wszystkie subskrypcje z konta 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 o włączaniu interfejsów Google Workspace API.

`404:notFound`

W przypadku użycia metody customers.get ten błąd oznacza, że klient lub domena nie istnieją dla żadnego konta Google Workspace, a domena jest dostępna.

`412:conditionNotMet`

Przyczyny tego błędu mogą być różne.

Jeśli napotkasz ten błąd podczas korzystania z metody subscriptions.changeRenewalSettings, upewnij się, że wywołujesz tę metodę tylko w przypadku tych abonamentów ze zobowiązaniem:

ANNUAL_MONTHLY_PAY
ANNUAL_YEARLY_PAY

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

Jeśli napotkasz ten błąd podczas korzystania z metody subscriptions.insert, oznacza to, że nie możesz odsprzedawać wybranego kodu SKU ani klientom z rynków wschodzących. Aby rozwiązać ten problem, zaakceptuj obowiązujące warunki korzystania z usługi.

`429:usageLimits.quotaExceeded`

Ten błąd występuje po przekroczeniu limitu zapytań na sekundę. Aby rozwiązać ten problem, zaimplementuj strategię ponawiania prób ponowienia lub wyniki w pamięci podręcznej, aby zmniejszyć liczbę wywołań interfejsu API. Więcej informacji znajdziesz w artykule Limity wykorzystania.