Na tej stronie znajdziesz opis kilku typowych problemów, które mogą wystąpić w związku z interfejsem Directory API w przypadku resellera.
400:badRequest
Ten błąd występuje, gdy do metody przekazana zostanie nieprawidłowa wartość parametru.
Jeśli używasz metody users.get
, sprawdź, czy wartość przekazana do parametru userKey
to podstawowy adres e-mail użytkownika, alias adresu e-mail lub unikalny identyfikator użytkownika.
Jeśli używasz metody users.list
, sprawdź te parametry:
- Parametr
customer
: używaj tylko wartościcustomerId
wygenerowanej przez Google. Nie używaj domeny klienta. Zalecamy używanie tego parametru, ponieważ jeśli klient ma domeny dodatkowe, użycie parametrudomain
zwraca tylko użytkowników z adresami e-mail w tej konkretnej domenie. - parametr
domain
: używaj tylko domeny rzeczywistego klienta. Nie używaj klucza
customerId
wygenerowanego 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 API pakietu Admin SDK. Więcej informacji znajdziesz w artykule Kontrola dostępu do interfejsów API.
Jeśli próbujesz uzyskać liczbę obecnych użytkowników z licencją i wyświetla się ten błąd, zamiast wywoływać metodę users.list
użyj pola licensedNumberOfSeats
z zasobu subskrypcji.
403:forbidden
Ten błąd występuje, gdy nie jesteś właścicielem klienta lub klient wyłączył dostęp sprzedawcy do konsoli administracyjnej.
Aby rozwiązać ten problem, przed wykonaniem połączeń w celu zweryfikowania własności klienta przez sprzedawcę zadzwoń do customers.get
lub poproś klienta o ponowne włączenie dostępu sprzedawcy do 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 Włączanie interfejsów Google Workspace API.
409:duplicate
Ten błąd występuje, gdy próbujesz dodać nowego użytkownika, ale jego główny adres e-mail jest już używany w jednym z tych miejsc:
- bieżące konto Google Workspace, do którego chcesz je dodać.
- innej usługi Google (nie Google Workspace).
Aby rozwiązać ten problem:
Wywołaj metodę
users.get
.Jeśli otrzymasz odpowiedź
200
, oznacza to, że użytkownik jest już na koncie Google Workspace klienta. Nie możesz dodać tego użytkownika do konta.Jeśli otrzymasz odpowiedź
403 forbidden
, domena w głównym parametrze adresu e-mail nie jest klientem sprzedanym ponownie lub główny adres e-mail był wcześniej używany w innej usłudze Google. Najpierw musisz zweryfikować domenę klienta, aby móc dodać tego użytkownika.Jeśli możesz potwierdzić własność domeny klienta:
- Utwórz tymczasowego użytkownika o rolach administratora, korzystając z metody
users.insert
, i przeprowadź proces obsługi administracyjnej do ostatniego kroku weryfikacji domeny. - Podczas weryfikacji domeny dodaj tymczasowych użytkowników do parametru
owners[]
w treści żądania wwebResource.insert
. Dzwoń, aż otrzymasz odpowiedź200
. - Po zweryfikowaniu domeny zmień tymczasową nazwę użytkownika, korzystając z metody
users.patch
lubusers.update
.
- Utwórz tymczasowego użytkownika o rolach administratora, korzystając z metody
Jeśli nie możesz potwierdzić własności domeny klienta:
- Utwórz tymczasowe konto administratora za pomocą metody
users.insert
. - Poproś klienta o zalogowanie się jako użytkownik tymczasowy i potwierdzenie domeny w konsoli administracyjnej.
- Po zweryfikowaniu domeny klient lub Ty możecie zmienić tymczasową nazwę użytkownika. Możesz użyć metody
users.patch
lubusers.update
.
- Utwórz tymczasowe konto administratora za pomocą metody
412:limitExceeded
Ten błąd występuje, gdy klient osiągnął maksymalną liczbę miejsc. Aby rozwiązać ten problem, użyj metody subscriptions.changeSeats
i w zależności od abonamentu:
- W przypadku
FLEXIBLE
zwiększ parametrmaximumNumberOfSeats
. - W przypadku
ANNUAL
zwiększ parametrnumberOfSeats
.