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

Rozwiązywanie problemów z interfejsem Seller API

Na tej stronie znajdziesz opis kilku typowych problemów związanych z interfejsem Reseller API.

`400:badRequest`

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

`400:invalid`

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

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

Nieprawidłowy stan: postalAddress.postalCode.
Nie kwalifikuje się postalAddress.countryCode do odsprzedaży Google Workspace.
Wartość właściwości alternateEmail nie może znajdować się w tej samej domenie co wartość właściwości customerDomain

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

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

Nie możesz zmniejszyć liczby stanowisk w przypadku abonamentów rocznych. Rozważ zmianę ustawień odnawiania. aby subskrypcja automatycznie ustawiała (w momencie odnowienia) liczbę miejsc 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. Wyślij klientowi wiadomość, że musi usunąć użytkownika, zanim będzie można zmniejszyć liczbę miejsc.
Zwiększono niewłaściwy parametr fotela. W przypadku planu FLEX zwiększ parametr maximumNumberOfSeats, a w przypadku planu ANNUAL zwiększ parametr numberOfSeats.
Próbujesz zmienić parametr licensedNumberOfSeats, który jest parametrem 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, rozpocząć naliczanie opłat i usunąć limit 10 miejsc.

`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, wprowadź opóźnienie. Więcej informacji znajdziesz w artykule Limity i kwoty wykorzystania.

Jeśli próbujesz pobrać wiele subskrypcji, użyj metody subscriptions.list bez określania parametrów customerId ani subscriptionId. W ramach jednego połączenia możesz zwrócić maksymalnie 100 subskrypcji. Aby nadal pobierać wszystkie subskrypcje 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`

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

`412:conditionNotMet`

Ten błąd może być spowodowany różnymi problemami.

Jeśli ten błąd wystąpi podczas wywoływania metody subscriptions.changeRenewalSettings, upewnij się, że wywołujesz ją tylko w ramach tych planów płatności z zobowiązaniem:

ANNUAL_MONTHLY_PAY
ANNUAL_YEARLY_PAY

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

Jeśli podczas korzystania z metody subscriptions.insert wystąpi ten błąd, oznacza to, że nie możesz odsprzedawać wybranego kodu SKU lub sprzedawać go klientom na rynkach wschodzących. Aby rozwiązać ten problem, zaakceptuj odpowiednie warunki korzystania z usługi.

`429:usageLimits.quotaExceeded`

Ten błąd występuje, gdy przekroczysz limit zapytań na sekundę. Aby rozwiązać ten problem, zastosuj strategię powtórnego odliczania czasu do ponowienia lub przechowuj wyniki w pamięci podręcznej, aby ograniczyć liczbę wywołań interfejsu API. Więcej informacji znajdziesz w artykule Limity i kwoty wykorzystania.