Rozwiązywanie problemów z interfejsem Directory API

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 parametru customerId wygenerowanego przez Google. Nie używaj rzeczywistej domeny klienta. Zalecamy użycie tego parametru, ponieważ jeśli klient ma domeny dodatkowe, użycie parametru domain 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:

1. 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.

2. Jeśli możesz potwierdzić własność domeny klienta, wykonaj te czynności:

   1. Utwórz administratora tymczasowego przy użyciu metody users.insert i kontynuuj obsługę administracyjną do ostatniego kroku weryfikacji domeny.
   2. Podczas weryfikowania domeny dodaj użytkowników tymczasowych do parametru owners[] w treści żądania wywołania webResource.insert. Dzwoń, aż otrzymasz odpowiedź 200.
   3. Po potwierdzeniu własności domeny zmień nazwę tymczasowej nazwy użytkownika, korzystając z metody users.patch lub users.update.

3. Jeśli nie możesz potwierdzić własności domeny klienta, wykonaj te czynności:

   1. Utwórz tymczasowego administratora, korzystając z metody users.insert.
   2. Poproś klienta, by zalogował się jako użytkownik tymczasowy i potwierdził własność domeny w konsoli administracyjnej.
   3. Po potwierdzeniu własności domeny możesz zmienić nazwę tymczasowej nazwy użytkownika lub klient. Możesz użyć metody users.patch lub users.update.

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 parametr maximumNumberOfSeats.
• W przypadku ANNUAL zwiększ parametr numberOfSeats.