Rozwiązywanie problemów z interfejsem Directory API

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ści customerId wygenerowanej przez Google. Nie używaj domeny klienta. Zalecamy używanie tego parametru, 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ż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:

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

  2. Jeśli możesz potwierdzić własność domeny klienta:

    1. 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.
    2. Podczas weryfikacji domeny dodaj tymczasowych użytkowników do parametru owners[] w treści żądania w webResource.insert. Dzwoń, aż otrzymasz odpowiedź 200.
    3. Po zweryfikowaniu domeny zmień tymczasową nazwę użytkownika, korzystając z metody users.patch lub users.update.
  3. Jeśli nie możesz potwierdzić własności domeny klienta:

    1. Utwórz tymczasowe konto administratora za pomocą metody users.insert.
    2. Poproś klienta o zalogowanie się jako użytkownik tymczasowy i potwierdzenie domeny w konsoli administracyjnej.
    3. Po zweryfikowaniu domeny klient lub Ty możecie zmienić tymczasową nazwę użytkownika. Możesz użyć metody users.patch lub users.update.

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