Rozwiązywanie problemów z interfejsem Seller API

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 co customerDomain

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 parametrze maximumNumberOfSeats i w planie ANNUAL zwiększ numberOfSeats.
  • 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.