Na tej stronie opisujemy kilka typowych problemów, które mogą wystąpić podczas korzystania z interfejsu Directory API jako sprzedawcy.
400:badRequest
Ten błąd występuje, gdy do metody zostanie przekazana nieprawidłowa wartość parametru.
Jeśli korzystasz z metody users.get
, sprawdź, czy wartość przekazywana do parametru userKey
jest podstawowym adresem e-mail użytkownika, aliasem adresu e-mail lub unikalnym identyfikatorem użytkownika.
Jeśli używasz metody users.list
, sprawdź te parametry:
- Parametr
customer
: używaj tylko parametrucustomerId
wygenerowanego przez Google. Nie używaj rzeczywistej domeny klienta. Zalecamy użycie tego parametru, ponieważ jeśli klient ma domeny dodatkowe, użycie parametrudomain
zwróci tylko użytkowników z adresami e-mail w tej konkretnej domenie. - Parametr
domain
: używaj tylko rzeczywistej domeny klienta. Nie używaj
customerId
, które został wygenerowany przez Google.
403:domainCannotUseApis
Ten błąd występuje, gdy klient wyłączył dostęp sprzedawcy do interfejsu Admin SDK API. Aby rozwiązać ten problem, poproś klienta o ponowne włączenie dostępu do interfejsu Admin SDK API. Więcej informacji znajdziesz w artykule Kontrolowanie dostępu przez interfejs API.
Jeśli próbujesz sprawdzić liczbę bieżących użytkowników z licencją i pojawia się ten błąd, zamiast wywoływać metody users.list
użyj pola licensedNumberOfSeats
z zasobu subskrypcji.
403:forbidden
Ten błąd występuje, jeśli klient nie należy do Ciebie lub wyłączył dostęp sprzedawcy do swojej konsoli administracyjnej.
Aby rozwiązać ten problem, wywołaj metodę customers.get
przed wykonaniem połączeń w celu zweryfikowania własności sprzedawcy w celu weryfikacji własności klienta lub poproś klienta o ponowne włączenie dostępu sprzedawcy do jego konsoli administracyjnej. Więcej informacji znajdziesz w artykule Uzyskiwanie dostępu do konsoli administracyjnej klienta.
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 o włączaniu interfejsów Google Workspace API.
409:duplicate
Ten błąd występuje, gdy próbujesz dodać nowego użytkownika, ale podstawowy adres e-mail klienta znajduje się już w jednym z tych adresów:
- Bieżące konto Google Workspace, do którego próbujesz go dodać.
- inna usługa Google (nie Google Workspace).
Aby rozwiązać ten problem:
Wywołaj metodę
users.get
.Jeśli wyświetli się odpowiedź
200
, oznacza to, że użytkownik już istnieje na koncie Google Workspace klienta. Nie możesz dodać tego użytkownika do konta.Jeśli otrzymasz odpowiedź
403 forbidden
, oznacza to, że domena w głównym parametrze adresu e-mail nie jest klientem sprzedawcy albo podstawowy adres e-mail został już wcześniej użyty w innej usłudze Google. Aby dodać użytkownika, musisz najpierw potwierdzić własność domeny klienta.Jeśli możesz potwierdzić własność domeny klienta, wykonaj te czynności:
- Utwórz administratora tymczasowego przy użyciu metody
users.insert
i kontynuuj obsługę administracyjną do ostatniego kroku weryfikacji domeny. - Podczas weryfikowania domeny dodaj użytkowników tymczasowych do parametru
owners[]
w treści żądania wywołaniawebResource.insert
. Dzwoń, aż otrzymasz odpowiedź200
. - Po potwierdzeniu własności domeny zmień nazwę tymczasowej nazwy użytkownika, korzystając z metody
users.patch
lubusers.update
.
- Utwórz administratora tymczasowego przy użyciu metody
Jeśli nie możesz potwierdzić własności domeny klienta, wykonaj te czynności:
- Utwórz tymczasowego administratora, korzystając z metody
users.insert
. - Poproś klienta, by zalogował się jako użytkownik tymczasowy i potwierdził własność domeny w konsoli administracyjnej.
- Po potwierdzeniu własności domeny możesz zmienić nazwę tymczasowej nazwy użytkownika lub klient. Możesz użyć metody
users.patch
lubusers.update
.
- Utwórz tymczasowego administratora, korzystając z metody
412:limitExceeded
Ten błąd występuje, gdy klient osiągnął maksymalny limit miejsc. Aby rozwiązać ten problem, użyj metody subscriptions.changeSeats
i, w zależności od abonamentu, wykonaj te czynności:
- W przypadku
FLEXIBLE
zwiększ parametrmaximumNumberOfSeats
. - W przypadku
ANNUAL
zwiększ parametrnumberOfSeats
.