Na tej stronie opisaliśmy kilka typowych problemów, które mogą wystąpić w związku z Interfejs API sprzedawcy.
400:badRequest
Ten błąd występuje, gdy subskrypcja została zawieszona lub anulowana. Dla: więcej informacji znajdziesz w Aktywuj subskrypcję.
400:invalid
Ten błąd może wystąpić z różnych powodów.
Jeśli używasz metody customers.insert
, jeden z tych klientów
parametry obiektu są nieprawidłowe:
- Nieprawidłowy stan:
postalAddress.postalCode
. postalAddress.countryCode
nie kwalifikuje się do sprzedaży Google Workspace.- Domena
alternateEmail
nie może znajdować się w tej samej domenie cocustomerDomain
Aby rozwiązać ten problem, sprawdź, czy wymagane parametry są obecne i prawidłowe dla do klienta.
Jeśli używasz metody subscriptions.changeSeats
, jedną z tych wartości
które mogą powodować ten błąd:
- Nie możesz zmniejszyć liczby stanowisk w przypadku abonamentu rocznego. Rozważ zmieniając ustawienia odnawiania. dla subskrypcji automatycznie ustawiane są (w momencie odnowienia) równe liczby stanowisk do liczby aktywnych użytkowników na koncie.
- Żądana liczba stanowisk 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 abonamentu
FLEX
zwiększ w parametrzemaximumNumberOfSeats
i w planieANNUAL
zwiększnumberOfSeats
. - Próbujesz zmienić parametr
licensedNumberOfSeats
, który jest tylko do odczytu. - W okresie próbnym klienci mogą mieć maksymalnie 10 miejsc. Rozpocznij płatną subskrypcję z bezpłatnego okresu próbnego, aby: natychmiast zakończy okres próbny, rozpocznij rozliczanie i usuń 10 stanowisk. maksymalnym.
403:forbidden
Ten błąd występuje, gdy nie jesteś właścicielem klienta lub klient wyłączył usługę dostęp sprzedawcy do konsoli administracyjnej.
403:usageLimits.dailyLimitExceeded
Ten błąd występuje po osiągnięciu dziennego limitu wywołań tego interfejsu API. Do rozwiązania tego problemu, zastosuj opóźnienie do ponowienia. Więcej informacji: Limity wykorzystania.
Jeśli próbujesz pobrać wiele subskrypcji, rozważ użycie metody
subscriptions.list
bez określania metody customerId
lub
subscriptionId
parametry. Możesz zwrócić maksymalnie 100 subskrypcji na
. Aby kontynuować pobieranie wszystkich subskrypcji, użyj parametru pageToken
na koncie sprzedawcy.
403:usageLimits.accessNotConfigured
Ten błąd występuje, gdy interfejs API nie jest włączony w projekcie Google Cloud. Do rozwiązania ten problem, otwórz konsolę Google Cloud i włącz interfejs API. Więcej Więcej informacji zawiera Włącz interfejsy Google Workspace API.
404:notFound
W przypadku używania metody customers.get
ten błąd oznacza, że klient lub
domena nie istnieje na żadnym koncie Google Workspace, a
.
412:conditionNotMet
Ten błąd może mieć wiele różnych przyczyn.
Jeśli napotkasz ten błąd podczas korzystania z narzędzia subscriptions.changeRenewalSettings
upewnij się, że ta metoda jest wywoływana tylko na
abonamenty ze zobowiązaniem:
ANNUAL_MONTHLY_PAY
ANNUAL_YEARLY_PAY
Jeśli napotkasz ten błąd podczas korzystania z metody subscriptions.delete
,
oznacza, że w Google Workspace nie ma administratora
koncie. 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, że nie możesz odsprzedawać wybranego kodu SKU na rynku wschodzącym
klienta. Aby rozwiązać ten problem, zaakceptuj obowiązujące warunki usługi.
429:usageLimits.quotaExceeded
Ten błąd występuje, gdy przekroczysz limit zapytań na sekundę. Do rozwiązania tego problemu, wdróż strategię ponawiania czasu do ponowienia lub zapisz wyniki w pamięci podręcznej, aby do mniejszej liczby wywołań interfejsu API. Więcej informacji: Limity wykorzystania.
Jeśli próbujesz pobrać wiele subskrypcji, rozważ użycie metody
subscriptions.list
bez określania metody customerId
lub
subscriptionId
parametry. Możesz zwrócić maksymalnie 100 subskrypcji na
. Aby kontynuować pobieranie wszystkich subskrypcji, użyj parametru pageToken
na koncie sprzedawcy.