Rozwiązywanie problemów z interfejsem Directory API

Na tej stronie opisaliśmy typowe problemy, które mogą wystąpić podczas korzystania z interfejsu Directory API jako sprzedawca.

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 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żyj tylko customerId wygenerowanego przez Google. Nie używaj rzeczywistej domeny klienta. Zalecamy użycie tego parametru, ponieważ jeśli klient ma domeny dodatkowe, używanie parametru domain zwraca tylko użytkowników z adresami e-mail w tej domenie.
  • Parametr domain: użyj tylko domeny klienta. Nie używaj
    customerId utworzonego 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 na temat kontrolowania dostępu do interfejsu API.

Jeśli próbujesz uzyskać liczbę bieżących licencji użytkowników, a pojawia się ten błąd, zamiast wywoływać metodę users.list użyj pola licensedNumberOfSeats w zasobie subskrypcji.

403:forbidden

Ten błąd występuje, jeśli nie jesteś właścicielem klienta lub jego klient wyłączył dostęp sprzedawcy do konsoli administracyjnej.

Aby rozwiązać ten problem, wywołaj metodę customers.get przed wykonaniem weryfikacji w celu zweryfikowania własności sprzedawcy 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, przejdź do konsoli Google Cloud i włącz API. Więcej informacji znajdziesz w artykule na temat włączania 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 już istnieje w jednej z tych sytuacji:

  • Obecne 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 istnieje już 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 sprzedaży lub główny adres e-mail był już wcześniej używany w innej usłudze Google, a jego domena musi zostać najpierw zweryfikowana.

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

    1. Utwórz tymczasowy konto administratora przy użyciu metody users.insert i kontynuuj udostępnianie, aż do ostatniego etapu weryfikacji domeny.
    2. Podczas weryfikacji domeny dodaj tymczasowych użytkowników do parametru owners[] w treści żądania webResource.insert. Wykonuj to połączenie do czasu, aż otrzymasz odpowiedź 200.
    3. Po potwierdzeniu własności domeny zmień tymczasową nazwę użytkownika, korzystając z metody users.patch lub users.update.

  3. Jeśli nie możesz zweryfikować domeny klienta, wykonaj te czynności:

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

412:limitExceeded

Ten błąd występuje, gdy klient osiągnął maksymalną liczbę stanowisk. Aby rozwiązać ten problem, użyj metody subscriptions.changeSeats, a następnie skorzystaj z tych metod:

  • Zwiększ wartość parametru maximumNumberOfSeats dla elementu FLEXIBLE.
  • Zwiększ wartość parametru numberOfSeats dla elementu ANNUAL.