Zasób: User
Interfejs Directory API umożliwia tworzenie kont użytkowników, aliasów użytkowników i zdjęć profilowych użytkowników Google oraz zarządzanie nimi. Więcej informacji o typowych zadaniach znajdziesz w przewodniku dla programistów kont użytkowników i w przewodniku dla programistów dotyczącym aliasów użytkowników.
Zapis JSON |
---|
{
"id": string,
"primaryEmail": string,
"password": value,
"hashFunction": string,
"isAdmin": boolean,
"isDelegatedAdmin": boolean,
"agreedToTerms": boolean,
"suspended": boolean,
"changePasswordAtNextLogin": boolean,
"ipWhitelisted": boolean,
"name": {
object ( |
Pola | |||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
id |
Unikalny identyfikator użytkownika. |
||||||||||||||||||||||||||||||||||||||||||
primaryEmail |
Podstawowy adres e-mail użytkownika. Ta usługa jest wymagana w prośbie o utworzenie konta użytkownika. Element |
||||||||||||||||||||||||||||||||||||||||||
password |
Przechowuje hasło do konta użytkownika. Podczas tworzenia konta użytkownika wymagana jest wartość hasła. Jest opcjonalna podczas aktualizowania użytkownika i powinna być wymagana tylko wtedy, gdy zmienia hasło do konta. Wartość hasła nigdy nie jest zwracana w treści odpowiedzi interfejsu API. |
||||||||||||||||||||||||||||||||||||||||||
hashFunction |
Zapisuje format skrótu właściwości
Jeśli prefiks jest określony, liczba rund nie może przekraczać 10 000. |
||||||||||||||||||||||||||||||||||||||||||
isAdmin |
Tylko dane wyjściowe. Wskazuje użytkownika z uprawnieniami superadministratora. Właściwość |
||||||||||||||||||||||||||||||||||||||||||
isDelegatedAdmin |
Tylko dane wyjściowe. Wskazuje, czy użytkownik jest administratorem delegowanym. |
||||||||||||||||||||||||||||||||||||||||||
agreedToTerms |
Tylko dane wyjściowe. Ta właściwość to |
||||||||||||||||||||||||||||||||||||||||||
suspended |
Wskazuje, czy konto użytkownika jest zawieszone. |
||||||||||||||||||||||||||||||||||||||||||
changePasswordAtNextLogin |
Wskazuje, czy użytkownik musi zmienić hasło podczas następnego logowania. To ustawienie nie obowiązuje, gdy użytkownik loguje się za pomocą zewnętrznego dostawcy tożsamości. |
||||||||||||||||||||||||||||||||||||||||||
ipWhitelisted |
Jeśli ustawiona jest wartość |
||||||||||||||||||||||||||||||||||||||||||
name |
Zawiera imiona i nazwiska użytkownika oraz wartość |
||||||||||||||||||||||||||||||||||||||||||
kind |
Tylko dane wyjściowe. Typ zasobu interfejsu API. W przypadku zasobów użytkowników wartość wynosi |
||||||||||||||||||||||||||||||||||||||||||
etag |
Tylko dane wyjściowe. ETag zasobu. |
||||||||||||||||||||||||||||||||||||||||||
emails |
Lista adresów e-mail użytkownika. Maksymalny dozwolony rozmiar danych to 10 KB.
|
||||||||||||||||||||||||||||||||||||||||||
externalIds |
Lista zewnętrznych identyfikatorów użytkownika, takich jak identyfikator pracownika lub identyfikator sieci. Maksymalny dozwolony rozmiar danych to 2 KB.
|
||||||||||||||||||||||||||||||||||||||||||
relations |
Lista relacji użytkownika z innymi użytkownikami. Maksymalny dozwolony rozmiar danych w tym polu to 2 KB. Więcej informacji znajdziesz w artykule Zarządzanie kontami użytkowników.
|
||||||||||||||||||||||||||||||||||||||||||
aliases[] |
Tylko dane wyjściowe. Lista aliasów e-mail użytkownika. |
||||||||||||||||||||||||||||||||||||||||||
isMailboxSetup |
Tylko dane wyjściowe. Wskazuje, czy została utworzona skrzynka pocztowa Google użytkownika. Ta usługa ma zastosowanie tylko wtedy, gdy użytkownikowi przypisano licencję na Gmaila. |
||||||||||||||||||||||||||||||||||||||||||
customerId |
Tylko dane wyjściowe. Identyfikator klienta do pobierania wszystkich użytkowników konta. |
||||||||||||||||||||||||||||||||||||||||||
addresses |
Lista adresów użytkownika. Maksymalny dozwolony rozmiar danych to 10 KB.
|
||||||||||||||||||||||||||||||||||||||||||
organizations |
Lista organizacji, do których należy użytkownik. Maksymalny dozwolony rozmiar danych to 10 KB.
|
||||||||||||||||||||||||||||||||||||||||||
lastLoginTime |
Tylko dane wyjściowe. Czas ostatniego logowania użytkownika na konto użytkownika. Data i godzina są podane w formacie ISO 8601. Czas to pełna data oraz godziny, minuty i sekundy w formacie |
||||||||||||||||||||||||||||||||||||||||||
phones |
Lista numerów telefonów użytkownika. Maksymalny dozwolony rozmiar danych to 1 KB.
|
||||||||||||||||||||||||||||||||||||||||||
suspensionReason |
Tylko dane wyjściowe. podaje powód zawieszenia konta przez administratora lub Google w momencie zawieszenia; Właściwość jest zwracana tylko wtedy, gdy właściwość |
||||||||||||||||||||||||||||||||||||||||||
thumbnailPhotoUrl |
Tylko dane wyjściowe. Adres URL zdjęcia profilowego użytkownika. Adres URL może być tymczasowy lub prywatny. |
||||||||||||||||||||||||||||||||||||||||||
languages |
Lista języków użytkownika. Maksymalny dozwolony rozmiar danych to 1 KB.
|
||||||||||||||||||||||||||||||||||||||||||
posixAccounts |
Lista informacji o koncie POSIX użytkownika.
|
||||||||||||||||||||||||||||||||||||||||||
creationTime |
Tylko dane wyjściowe. Godzina utworzenia konta użytkownika. Data i godzina są podane w formacie ISO 8601. Czas to pełna data oraz godziny, minuty i sekundy w formacie |
||||||||||||||||||||||||||||||||||||||||||
nonEditableAliases[] |
Tylko dane wyjściowe. Lista aliasów e-mail użytkownika, których nie można edytować. Zazwyczaj są one spoza domeny podstawowej lub subdomeny konta. |
||||||||||||||||||||||||||||||||||||||||||
sshPublicKeys |
Lista kluczy publicznych SSH.
|
||||||||||||||||||||||||||||||||||||||||||
notes |
Notatki dla użytkownika w formie obiektu zagnieżdżonego.
|
||||||||||||||||||||||||||||||||||||||||||
websites |
Lista stron internetowych użytkownika.
|
||||||||||||||||||||||||||||||||||||||||||
locations |
Lista lokalizacji użytkownika. Maksymalny dozwolony rozmiar danych to 10 KB.
|
||||||||||||||||||||||||||||||||||||||||||
includeInGlobalAddressList |
Określa, czy profil użytkownika jest widoczny na globalnej liście adresów Google Workspace, gdy w domenie jest włączona funkcja udostępniania kontaktów. Więcej informacji o wykluczaniu profili użytkowników znajdziesz w Centrum pomocy dla administratorów. |
||||||||||||||||||||||||||||||||||||||||||
keywords |
Lista słów kluczowych użytkownika. Maksymalny dozwolony rozmiar danych to 1 KB.
|
||||||||||||||||||||||||||||||||||||||||||
deletionTime |
Tylko dane wyjściowe. Godzina usunięcia konta użytkownika. Data i godzina są podane w formacie ISO 8601. Czas to pełna data oraz godziny, minuty i sekundy w formacie |
||||||||||||||||||||||||||||||||||||||||||
gender |
Zagnieżdżony obiekt zawierający płeć użytkownika. Maksymalny dozwolony rozmiar danych w tym polu to 1 KB.
|
||||||||||||||||||||||||||||||||||||||||||
thumbnailPhotoEtag |
Tylko dane wyjściowe. ETag zdjęcia użytkownika (tylko do odczytu) |
||||||||||||||||||||||||||||||||||||||||||
ims |
Konta błyskawicznego czatu użytkownika. Konto użytkownika może mieć kilka usług w
|
||||||||||||||||||||||||||||||||||||||||||
customSchemas |
Pola niestandardowe użytkownika. Maksymalny dozwolony rozmiar danych to 32 KB. Klucz to
|
||||||||||||||||||||||||||||||||||||||||||
isEnrolledIn2Sv |
Tylko dane wyjściowe. jest zarejestrowany w systemie weryfikacji dwuetapowej (tylko do odczytu), |
||||||||||||||||||||||||||||||||||||||||||
isEnforcedIn2Sv |
Tylko dane wyjściowe. Jest wymuszana weryfikacja dwuetapowa (tylko do odczytu) |
||||||||||||||||||||||||||||||||||||||||||
archived |
Wskazuje, czy konto użytkownika jest zarchiwizowane. |
||||||||||||||||||||||||||||||||||||||||||
orgUnitPath |
Pełna ścieżka organizacji nadrzędnej powiązanej z użytkownikiem. Jeśli organizacja nadrzędna jest organizacją najwyższego poziomu, jest ona przedstawiana za pomocą ukośnika prawego ( |
||||||||||||||||||||||||||||||||||||||||||
recoveryEmail |
Adres e-mail odzyskiwania użytkownika. |
||||||||||||||||||||||||||||||||||||||||||
recoveryPhone |
Pomocniczy numer telefonu użytkownika. Numer telefonu musi mieć format E.164 i zaczynać się znakiem plusa (+), np. +16506661212. |
UserName
Zapis JSON |
---|
{ "fullName": string, "familyName": string, "givenName": string, "displayName": string } |
Pola | |
---|---|
fullName |
Imię i nazwisko użytkownika utworzone przez połączenie wartości imienia i nazwiska. |
familyName |
Nazwisko użytkownika. Wymagane podczas tworzenia konta użytkownika. |
givenName |
Imię użytkownika. Wymagane podczas tworzenia konta użytkownika. |
displayName |
Wyświetlana nazwa użytkownika. Limit: 256 znaków. |
Metody |
|
---|---|
|
Usuwa użytkownika. |
|
Pobiera użytkownika. |
|
Tworzy użytkownika. |
|
Pobiera podzieloną na strony listę usuniętych użytkowników lub wszystkich użytkowników w domenie. |
|
nadaje użytkownikowi uprawnienia superadministratora. |
|
Aktualizuje użytkownika za pomocą semantyki poprawki. |
|
Wylogowuje użytkownika ze wszystkich sesji internetowych i na urządzeniu oraz resetuje pliki cookie logowania. |
|
Przywraca usunięcie usuniętego konta użytkownika. |
|
Aktualizuje użytkownika. |
|
Wykrywa zmiany na liście użytkowników. |