Rozwiązywanie problemów z interfejsem Directory API

Na tej stronie opisaliśmy kilka typowych problemów, które mogą wystąpić w związku z Directory API jako sprzedawcy.

400:badRequest

Ten błąd występuje, gdy do metody jest przekazywana nieprawidłowa wartość parametru.

Jeśli używasz metody users.get, sprawdź, czy wartość przekazywana do metody userKey jest podstawowym adresem e-mail użytkownika, aliasem adresu e-mail lub unikalny identyfikator użytkownika.

Jeśli używasz metody users.list, sprawdź te parametry:

• Parametr customer: używaj tylko parametru customerId, który został wygenerowany przez Google. Nie używaj rzeczywistej domeny klienta. Zalecamy użycie tego ponieważ jeśli klient ma domeny dodatkowe, użycie parametru domain zwraca tylko użytkowników z adresami e-mail w tej konkretnej domenie.
• Parametr domain: użyj tylko rzeczywistej domeny klienta. Nie używaj:
  customerId wygenerowaną przez Google.

403:domainCannotUseApis

Ten błąd występuje, gdy klient wyłączył dostęp sprzedawcy do Interfejs API pakietu Admin SDK. Aby rozwiązać ten problem, poproś klienta o ponowne włączenie dostępu do interfejs API pakietu Admin SDK. Więcej informacji: Kontrola nad dostępem do interfejsu API.

Jeśli próbujesz poznać liczbę aktualnie licencjonowanych użytkowników 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ł usługę dostęp sprzedawcy do konsoli administracyjnej.

Aby rozwiązać ten problem, wywołaj metodę Metoda customers.get przed nawiązaniem połączenia w celu zweryfikowania prawa własności sprzedawcy do klienta lub poproszeniem klient może ponownie włączyć dostęp sprzedawcy do jego konsoli administracyjnej. Więcej Więcej informacji zawiera Otwieranie konsoli administracyjnej klienta.

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.

409:duplicate

Ten błąd występuje, gdy próbujesz dodać nowego użytkownika, ale klient podstawowy adres e-mail już istnieje w jednym z tych adresów:

• Bieżące konto Google Workspace, do którego próbujesz je dodać.
• innej usługi Google (nie Google Workspace).

Aby rozwiązać ten problem:

1. Wywołaj metodę users.get.

   Jeśli otrzymasz odpowiedź 200, oznacza to, że użytkownik już istnieje na liście klientów Konto Google Workspace. Nie możesz dodać tego użytkownika do konta.

   Jeśli otrzymasz odpowiedź 403 forbidden, oznacza to, że domena w domenie podstawowej parametr email nie odnosi się do klienta sprzedawcy lub został użyty podstawowy adres e-mail; Wcześniej dla innej usługi Google, domena klienta musi musi zostać zweryfikowany, zanim będzie można dodać tego użytkownika.

2. Jeśli możesz zweryfikować domenę klienta, wykonaj te czynności:

   1. Utwórz tymczasowego administratora za pomocą Metoda users.insert i przejdź do ostatniego etapu weryfikacji domeny.
   2. Gdy potwierdzisz własność domeny, dodaj użytkowników tymczasowych do owners[] w treści żądania dla argumentu webResource.insert połączenie. Wykonuj to połączenie, dopóki nie otrzymasz odpowiedzi w usłudze 200.
   3. Po zweryfikowaniu domeny zmień nazwę tymczasowej nazwy użytkownika, używając instrukcji 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 za pomocą Metoda users.insert.
   2. Poproś klienta o zalogowanie się jako użytkownik tymczasowy i zweryfikowanie swojego w konsoli administracyjnej.
   3. Po zweryfikowaniu domeny klient może albo zmienić nazwę domeny tymczasowa nazwa użytkownika. Możesz użyć zarówno users.patch lub users.update .

412:limitExceeded

Ten błąd występuje, gdy klient osiągnął limit miejsc. Do rozwiąż ten problem, użyj metody subscriptions.changeSeats W zależności od abonamentu użyj tych opcji:

• W przypadku FLEXIBLE zwiększ parametr maximumNumberOfSeats.
• W przypadku ANNUAL zwiększ parametr numberOfSeats.