Rozwiązywanie problemów z interfejsem Seller API

Na tej stronie opisujemy kilka typowych problemów, które mogą wystąpić w związku 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 klienta jest nieprawidłowy:

  • Nieprawidłowy stan: postalAddress.postalCode.
  • Nie kwalifikujesz 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 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 przypadku abonamentów rocznych. Rozważ zmianę ustawień odnawiania. subskrypcja automatycznie ustawi (w momencie odnowienia) liczbę licencji równą liczbie aktywnych użytkowników na koncie.
  • Liczba stanowisk, o którą prosisz, jest mniejsza niż liczba użytkowników na koncie. Poinformuj klienta, że przed zmniejszeniem liczby licencji musi usunąć użytkownika.
  • Zwiększono nieprawidłowy parametr fotela. W przypadku planu FLEX zwiększ parametr maximumNumberOfSeats, a w przypadku planu ANNUAL zwiększ parametr numberOfSeats.
  • Próbowano zmienić parametr licensedNumberOfSeats, który jest parametrem tylko do odczytu.
  • W okresie próbnym klienci mają maksymalny limit 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 stanowisk.

403:forbidden

Ten błąd występuje, gdy nie jesteś właścicielem klienta lub klient wyłączył dostęp sprzedawcy do swojej 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, wdróż opóźnienie wycofywania. Więcej informacji znajdziesz w artykule Limity wykorzystania i limity.

Jeśli chcesz pobrać wiele subskrypcji, rozważ użycie metody subscriptions.list bez określania parametrów customerId lub subscriptionId. Podczas jednej rozmowy możesz zwrócić maksymalnie 100 subskrypcji. Użyj parametru pageToken, aby nadal pobierać wszystkie subskrypcje na koncie sprzedawcy.

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 Google Cloud Console i włącz interfejs API. Więcej informacji znajdziesz w artykule Włączanie interfejsów Google Workspace API.

404:notFound

W przypadku korzystania z metody customers.get ten błąd oznacza, że klient lub domena nie istnieją na żadnym koncie Google Workspace i że domena jest dostępna.

412:conditionNotMet

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

Jeśli podczas korzystania z metody subscriptions.changeRenewalSettings wystąpi ten błąd, upewnij się, że wywołujesz tę metodę tylko w przypadku tych planów płatności za zobowiązanie:

  • ANNUAL_MONTHLY_PAY
  • ANNUAL_YEARLY_PAY

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

Jeśli podczas korzystania z metody subscriptions.insert wystąpi ten błąd, oznacza to, że nie możesz odsprzedać wybranego kodu SKU lub nie możesz go odsprzedać klientowi na rynku wschodzącym. 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, wdróż strategię powtórnego odliczania czasu do ponowienia lub zapisuj wyniki w pamięci podręcznej, aby zmniejszyć liczbę wywołań interfejsu API. Więcej informacji znajdziesz w artykule Limity wykorzystania i limity.

Jeśli chcesz pobrać wiele subskrypcji, rozważ użycie metody subscriptions.list bez określania parametrów customerId lub subscriptionId. Podczas jednej rozmowy możesz zwrócić maksymalnie 100 subskrypcji. Użyj parametru pageToken, aby nadal pobierać wszystkie subskrypcje na koncie sprzedawcy.