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 cocustomerDomain
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 parametrmaximumNumberOfSeats
, a w przypadku planuANNUAL
– parametrnumberOfSeats
. - 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.
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
.