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

Rozwiązywanie problemów z interfejsem Reseller API

Na tej stronie opisaliśmy typowe problemy, które 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 obiektów klienta jest nieprawidłowy:

Nieprawidłowy stan: postalAddress.postalCode.
Usługa postalAddress.countryCode nie kwalifikuje się do sprzedaży Google Workspace.
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, może to być spowodowane jednym z tych problemów:

W przypadku abonamentów rocznych nie można zmniejszyć liczby stanowisk. Rozważ zmianę ustawień odnawiania. w celu automatycznego ustawiania (w momencie odnowienia) liczby stanowisk równej liczbie aktywnych użytkowników na koncie.
Żądana liczba miejsc jest mniejsza niż bieżąca liczba użytkowników na koncie. Poinformuj klienta, że musi usunąć użytkownika, zanim będzie mógł zmniejszyć liczbę stanowisk.
Udało Ci się zwiększyć nieprawidłowy parametr miejsca. Zwiększ w atrybucie FLEX parametr maximumNumberOfSeats, a w planie ANNUAL zwiększ parametr numberOfSeats.
Próbujesz zmienić parametr licensedNumberOfSeats, który jest tylko do odczytu.
W okresie próbnym klienci mogą mieć maksymalnie 10 stanowisk. Rozpocznij płatną usługę z bezpłatnej subskrypcji próbnej, 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 nie jesteś właścicielem klienta lub jego klient wyłączył dostęp sprzedawcy do konsoli administracyjnej.

`403:usageLimits.dailyLimitExceeded`

Ten błąd występuje, gdy został osiągnięty dzienny limit wywołań tego interfejsu API. Aby rozwiązać ten problem, zaimplementuj opóźnienie ponowienia. Więcej informacji znajdziesz w artykule Limity wykorzystania.

Jeśli chcesz pobrać wiele subskrypcji, możesz użyć 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, przejdź do konsoli Google Cloud i włącz API. Więcej informacji znajdziesz w artykule na temat włączania interfejsów Google Workspace API.

`404:notFound`

Jeśli używasz metody customers.get, błąd oznacza, że klient nie istnieje w przypadku żadnego konta Google Workspace oraz że domena jest dostępna.

`412:conditionNotMet`

Przyczyną tego błędu może być kilka różnych problemów.

Jeśli zobaczysz ten błąd podczas korzystania z metody subscriptions.changeRenewalSettings, upewnij się, że wywołujesz ją tylko w przypadku następujących abonamentów:

ANNUAL_MONTHLY_PAY
ANNUAL_YEARLY_PAY

Jeśli podczas korzystania z metody subscriptions.delete wystąpi ten błąd, 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 sprzedawać wybranego kodu SKU ani zdobyć nowych klientów rynku. Aby rozwiązać ten problem, zaakceptuj odpowiednie Warunki korzystania z usługi.

`429:usageLimits.quotaExceeded`

Ten błąd występuje, gdy liczba zapytań przekracza limit na sekundę. Aby rozwiązać ten problem, zaimplementuj strategię ponawiania próby ponowienia lub wyniki w pamięci podręcznej w celu tworzenia mniejszej liczby wywołań interfejsu API. Więcej informacji znajdziesz w artykule Limity wykorzystania.