REST Resource: users

Zasób: Użytkownik

Interfejs Directory API umożliwia tworzenie użytkowników na koncie, ich aliasów i zdjęć profilowych na koncie Google oraz zarządzanie nimi. Więcej informacji o popularnych zadaniach znajdziesz w przewodniku dla programistów na temat kont użytkowników i przewodniku dla programistów na temat 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 (UserName)
  },
  "kind": string,
  "etag": string,
  "emails": value,
  "externalIds": value,
  "relations": value,
  "aliases": [
    string
  ],
  "isMailboxSetup": boolean,
  "customerId": string,
  "addresses": value,
  "organizations": value,
  "lastLoginTime": string,
  "phones": value,
  "suspensionReason": string,
  "thumbnailPhotoUrl": string,
  "languages": value,
  "posixAccounts": value,
  "creationTime": string,
  "nonEditableAliases": [
    string
  ],
  "sshPublicKeys": value,
  "notes": value,
  "websites": value,
  "locations": value,
  "includeInGlobalAddressList": boolean,
  "keywords": value,
  "deletionTime": string,
  "gender": value,
  "thumbnailPhotoEtag": string,
  "ims": value,
  "customSchemas": value,
  "isEnrolledIn2Sv": boolean,
  "isEnforcedIn2Sv": boolean,
  "archived": boolean,
  "orgUnitPath": string,
  "recoveryEmail": string,
  "recoveryPhone": string
}
Pola
id

string

Unikalny identyfikator użytkownika. Jako identyfikator URI żądania użytkownika userKey można użyć identyfikatora id użytkownika.
primaryEmail

string

Podstawowy adres e-mail użytkownika. Ta właściwość jest wymagana w prośbie o utworzenie konta użytkownika. primaryEmail musi być niepowtarzalny i nie może być aliasem innego użytkownika.
password

value (Value format)

przechowuje hasło do konta użytkownika. Wartość hasła użytkownika jest wymagana podczas tworzenia konta użytkownika. Jest to opcjonalne podczas aktualizowania użytkownika i powinno być podawane tylko wtedy, gdy użytkownik aktualizuje hasło do konta. Wartość hasła nigdy nie jest zwracana w treści odpowiedzi interfejsu API.

Hasło może zawierać dowolną kombinację znaków ASCII i musi mieć od 8 do 100 znaków.

Zalecamy wysyłanie parametru password jako wartości skrótu zaszyfrowanej w sposób szesnastkowy i odpowiednie ustawienie parametru hashFunction. Jeśli podano wartość hashFunction, hasło musi być prawidłowym kluczem haszowania.
hashFunction

string

Przechowuje format hasha właściwości password. Dozwolone są następujące wartości hashFunction:

  • MD5 – Akceptuje proste wartości zapisane w szesnastkowym kodzie.
  • SHA-1 – Akceptuje proste wartości zapisane w szesnastkowym kodzie.
  • crypt – zgodność z biblioteką kryptograficzną C. Obsługuje algorytmy szyfrowania DES, MD5 (prefiks haszowania $1$), SHA-256 (prefiks haszowania $5$) i SHA-512 (prefiks haszowania $6$).

Jeśli w prefiksie występują zaokrąglenia, muszą one być równe 10 tysięcy lub mniejsze.
isAdmin

boolean

Tylko dane wyjściowe. Wskazuje użytkownika z uprawnieniami superadministratora. Właściwości isAdmin można edytować tylko w operacji Ustaw użytkownika jako administratora ( metoda makeAdmin). Jeśli edytujesz metody insert lub update w użytkowniku, usługa interfejsu API zignoruje te zmiany.
isDelegatedAdmin

boolean

Tylko dane wyjściowe. Wskazuje, czy użytkownik jest administratorem delegowanym.
Interfejs API obsługuje administratorów delegowanych, ale nie mogą oni tworzyć ani przywracać użytkowników ani mianować ich administratorami. Te żądania są ignorowane przez usługę interfejsu API.
Role i uprawnienia administratorów są przypisywane w konsoli administracyjnej.
agreedToTerms

boolean

Tylko dane wyjściowe. Ta usługa ma wartość true, jeśli użytkownik zalogował się po raz pierwszy i zaakceptował Warunki korzystania z usługi.
suspended

boolean

Wskazuje, czy użytkownik został zawieszony.
changePasswordAtNextLogin

boolean

Wskazuje, czy użytkownik musi zmienić hasło przy następnym logowaniu. To ustawienie nie ma zastosowania, gdy użytkownik loguje się za pomocą zewnętrznego dostawcy tożsamości.
ipWhitelisted

boolean

Jeśli true, adres IP użytkownika podlega wycofanej konfiguracji adresu IP allowlist.
name

object (UserName)

Zawiera imię i nazwisko użytkownika oraz wartość fullName tylko do odczytu. Maksymalna liczba znaków w wartościach givenName i familyName to 60. Wartości nazw mogą też zawierać znaki Unicode/UTF-8, spacje, litery (a–z), cyfry (0–9), łączniki (-), ukośniki (/) i kropki (.). Więcej informacji o zasadach dotyczących używania znaków znajdziesz w Centrum pomocy dla administratorów. Maksymalny dozwolony rozmiar danych w tym polu to 1 KB.
kind

string

Tylko dane wyjściowe. Typ zasobu interfejsu API. W przypadku zasobów Użytkownicy wartość to admin#directory#user.
etag

string

Tylko dane wyjściowe. ETag zasobu.
emails

value (Value format)

Lista adresów e-mail użytkownika. Maksymalny dozwolony rozmiar danych to 10 KB.

Pola

emails[].address

string

Adres e-mail użytkownika. Służy też jako identyfikator e-mail. Ta wartość może być podstawowym adresem e-mail użytkownika lub jego aliasem.

emails[].customType

string

Jeśli adres e-mail type to custom, ta właściwość zawiera niestandardową wartość i musi być skonfigurowana.

emails[].primary

boolean

Wskazuje, czy jest to główny adres e-mail użytkownika. Jako podstawowe można oznaczyć tylko 1 miejsce docelowe.

emails[].type

string

Typ konta e-mail. Jeśli ustawiona jest wartość custom, musi być też ustawiona wartość customType.

Dozwolone wartości: custom, home, other, work.
externalIds

value (Value format)

Lista zewnętrznych identyfikatorów użytkownika, np. identyfikator pracownika lub identyfikator sieci. Maksymalny dozwolony rozmiar danych to 2 KB.

Pola

externalIds[].customType

string

Jeśli zewnętrzny identyfikator type to custom, ta właściwość zawiera niestandardową wartość i musi być skonfigurowana.

externalIds[].type

string

Typ identyfikatora zewnętrznego. Jeśli ustawisz wartość custom, musisz też ustawić wartość customType.

Dopuszczalne wartości: account, custom, customer, login_id, network, organization.

externalIds[].value

string

Wartość zewnętrznego identyfikatora.
relations

value (Value format)

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.

Pola

relations[].customType

string

Jeśli relacja type to custom, ta właściwość zawiera niestandardową wartość i musi być ustawiona.

relations[].type

string

Typ relacji. Jeśli ustawisz wartość custom, musisz też ustawić wartość customType.

Akceptowane wartości:
  • admin_assistant
  • assistant
  • brother
  • child
  • custom
  • domestic_partner
  • dotted_line_manager
  • exec_assistant
  • father
  • friend
  • manager
  • mother
  • parent
  • partner
  • referred_by
  • relative
  • sister
  • spouse

relations[].value

string

Adres e-mail osoby, z którą użytkownik jest spokrewniony.
aliases[]

string

Tylko dane wyjściowe. Lista aliasów adresów e-mail użytkownika.
isMailboxSetup

boolean

Tylko dane wyjściowe. Wskazuje, czy skrzynka pocztowa Google użytkownika została utworzona. Ta usługa jest dostępna tylko wtedy, gdy użytkownik ma przypisaną licencję Gmail.
customerId

string

Tylko dane wyjściowe. Identyfikator klienta, aby pobrać wszystkich użytkowników konta.
Możesz użyć aliasu my_customer, aby reprezentować customerId Twojego konta.
Jako administrator sprzedawcy możesz użyć customerId konta klienta, którego dotyczy sprzedaż. Aby uzyskać customerId, użyj domeny podstawowej konta w parametrze domain żądania users.list.
addresses

value (Value format)

Lista adresów użytkownika. Maksymalny dozwolony rozmiar danych to 10 KB.

Pola

addresses[].country

string

Kraj.

addresses[].countryCode

string

Kod kraju. Używa standardu ISO 3166-1.

addresses[].customType

string

Jeśli adres type to custom, ta właściwość zawiera niestandardową wartość i musi być ustawiona.

addresses[].extendedAddress

string

rozszerzone adresy, np. adresy zawierające podregion.

addresses[].formatted

string

Pełny i nieustrukturyzowany adres pocztowy. Nie jest ono synchronizowane z uporządkowanymi polami adresu. Zawiera te atrybuty: adres, skrytka pocztowa, miasto, województwo, kod pocztowy, kraj.

addresses[].locality

string

Miasto lub miejscowość w adresie.

addresses[].poBox

string

Numer skrytki pocztowej, jeśli taka występuje.

addresses[].postalCode

string

Kod pocztowy (jeśli występuje).

addresses[].primary

boolean

Jeśli jest to główny adres użytkownika. Lista adresów może zawierać tylko 1 adres główny.

addresses[].region

string

Skrót nazwy prowincji lub stanu.

addresses[].sourceIsStructured

boolean

Wskazuje, czy adres podany przez użytkownika został sformatowany. Formatowane adresy nie są obecnie obsługiwane.

addresses[].streetAddress

string

Adres, np. 1600 Amphitheatre Parkway. Białe znaki w ciągu są ignorowane, ale znaki nowego wiersza są istotne.

addresses[].type

string

Typ adresu. Jeśli ustawisz wartość custom, musisz też ustawić wartość customType.

Dozwolone wartości: custom, home, other, work.
organizations

value (Value format)

Lista organizacji, do których należy użytkownik. Maksymalny dozwolony rozmiar danych to 10 KB.

Pola

organizations[].costCenter

string

Centrum kosztów organizacji użytkownika.

organizations[].customType

string

Jeśli wartość atrybutu type to custom, ta właściwość zawiera niestandardowy typ.

organizations[].department

string

Określa dział w organizacji, np. sales lub engineering.

organizations[].description

string

Opis organizacji.

organizations[].domain

string

Domena, do której należy organizacja.

organizations[].fullTimeEquivalent

integer

pełnoetatowe równoważne miliarsze w organizacji (100 000 = 100%).

organizations[].location

string

Fizyczna lokalizacja organizacji. Nie musi to być pełny adres.

organizations[].name

string

Nazwa organizacji.

organizations[].primary

boolean

Wskazuje, czy jest to główna organizacja użytkownika. Użytkownik może mieć tylko jedną organizację główną.

organizations[].symbol

string

Tekstowy symbol organizacji. Na przykład symbol tekstowy Google to GOOG.

organizations[].title

string

Tytuł użytkownika w organizacji. Na przykład member lub engineer.

organizations[].type

string

Typ organizacji.

Dozwolone wartości: domain_only, school, unknown, work.
lastLoginTime

string

Tylko dane wyjściowe. Ostatni czas logowania użytkownika na swoje konto. Wartość jest podana w formacie daty i godziny ISO 8601. Czas to pełna data oraz godziny, minuty i sekundy w formacie YYYY-MM-DDThh:mm:ssTZD. Na przykład: 2010-04-05T17:30:04+01:00.
phones

value (Value format)

Lista numerów telefonów użytkownika. Maksymalny dozwolony rozmiar danych to 1 KB.

Pola

phones[].customType

string

Jeśli numer telefonu type to custom, ta właściwość zawiera niestandardową wartość i musi być ustawiona.

phones[].primary

boolean

Jeśli true, jest to główny numer telefonu użytkownika. Użytkownik może mieć tylko 1 główny numer telefonu.

phones[].type

string

Typ numeru telefonu. Jeśli ustawiona jest wartość custom, musi być też ustawiona wartość customType.

Dopuszczalne wartości: assistant, callback, car, company_main, custom, grand_central, home, home_fax, isdn, main, mobile, other, other_fax, pager, radio, telex, tty_tdd, work, work_fax, work_mobile, work_pager.

phones[].value

string

Zrozumiały dla człowieka numer telefonu. Może mieć dowolny format numeru telefonu.
suspensionReason

string

Tylko dane wyjściowe. zawiera powód zawieszenia konta użytkownika przez administratora lub Google w momencie zawieszenia; Właściwość jest zwracana tylko wtedy, gdy właściwość suspended ma wartość true.
thumbnailPhotoUrl

string

Tylko dane wyjściowe. Adres URL zdjęcia profilowego użytkownika. Adres URL może być tymczasowy lub prywatny.
languages

value (Value format)

Lista języków użytkownika. Maksymalny dozwolony rozmiar danych to 1 KB.

Pola

languages[].customLanguage

string

Inny język. Jeśli nie ma odpowiedniego kodu języka w formacie ISO 639, użytkownik może podać własną nazwę języka. Jeśli to ustawienie jest włączone, nie można ustawić wartości languageCode.

languages[].languageCode

string

Reprezentacja języka w postaci ciągu znaków zgodnie ze standardem ISO 639. Listę obsługiwanych kodów znajdziesz w sekcji Kody języków. Interfejs API zaakceptuje prawidłowe kody języków spoza obsługiwanego zestawu, ale może to spowodować nieoczekiwane działanie. Nieprawidłowe wartości powodują SchemaException. Jeśli to ustawienie jest włączone, nie można ustawić wartości customLanguage.

languages[].preference

string

Opcjonalnie. Jeśli jest obecny, określa, czy określony languageCode jest preferowanym językiem użytkownika. Jeśli ustawiono wartość customLanguage, nie można ustawić tej wartości. Dozwolone wartości to preferred i not_preferred.
posixAccounts

value (Value format)

Lista informacji o koncie POSIX użytkownika.

Pola

posixAccounts[].accountId

string

Identyfikator pola konta POSIX.

posixAccounts[].gecos

string

GECOS (informacje o użytkowniku) na tym koncie.

posixAccounts[].gid

unsigned long

Domyślny identyfikator grupy.

posixAccounts[].homeDirectory

string

Ścieżka do katalogu domowego tego konta.

posixAccounts[].operatingSystemType

string

Typ systemu operacyjnego tego konta.

Akceptowane wartości: linux, unspecified, windows.

posixAccounts[].primary

boolean

Czy jest to główne konto użytkownika w SystemId.

posixAccounts[].shell

string

Ścieżka do powłoki logowania na tym koncie.

posixAccounts[].systemId

string

Identyfikator systemu, do którego odnoszą się nazwa użytkownika lub identyfikator Uid konta.

posixAccounts[].uid

unsigned long

Identyfikator użytkownika zgodny ze standardem POSIX.

posixAccounts[].username

string

Nazwa użytkownika na koncie.
creationTime

string

Tylko dane wyjściowe. Czas utworzenia konta użytkownika. Wartość jest podana w formacie daty i godziny ISO 8601. Czas to pełna data oraz godziny, minuty i sekundy w formacie YYYY-MM-DDThh:mm:ssTZD. Na przykład: 2010-04-05T17:30:04+01:00.
nonEditableAliases[]

string

Tylko dane wyjściowe. Lista nieedytowalnych aliasów adresów e-mail użytkownika. Zwykle są to domeny spoza domeny podstawowej lub domeny podrzędnej konta.
sshPublicKeys

value (Value format)

lista kluczy publicznych SSH;

Pola

sshPublicKeys[].expirationTimeUsec

long

Czas ważności w mikrosekundach od początku epoki.

sshPublicKeys[].fingerprint

string

odcisk cyfrowy SHA-256 klucza publicznego SSH. (Tylko do odczytu)

sshPublicKeys[].key

string

Klucz publiczny SSH.
notes

value (Value format)

Uwagi dla użytkownika jako obiekt zagnieżdżony.

Pola

notes.contentType

string

Typ treści notatki: zwykły tekst lub kod HTML. Domyślnie jest to zwykły tekst.

Akceptowane wartości: text_plain, text_html.

notes.value

string

treść notatek;
websites

value (Value format)

Lista witryn użytkownika.

Pola

websites[].customType

string

Jeśli wartość właściwości witryny type to custom, ta właściwość zawiera niestandardową wartość i musi być ustawiona.

websites[].primary

boolean

Jeśli true, jest to główna strona internetowa użytkownika.

websites[].type

string

Typ lub cel witryny. Na przykład witryna może mieć etykietę home lub blog. Może on mieć też typ custom. Jeśli ustawisz wartość custom, musisz też ustawić wartość customType.

Dopuszczalne wartości: app_install_page, blog, custom, ftp, home, home_page, other, profile, reservations, resume, work.

websites[].value

string

Adres URL witryny.
locations

value (Value format)

Lista lokalizacji użytkownika. Maksymalny dozwolony rozmiar danych to 10 KB.

Pola

locations[].area

string

Lokalizacja tekstowa. Jest to najlepszy sposób na zwięzły opis danego miejsca. Na przykład Mountain View, CA lub Near Seattle.

locations[].buildingId

string

Identyfikator budynku.

locations[].customType

string

Jeśli lokalizacja type to custom, ta właściwość zawiera niestandardową wartość i musi być ustawiona.

locations[].deskCode

string

Najdokładniejszy kod tekstowy konkretnego miejsca pracy.

locations[].floorName

string

Nazwa lub numer piętra.

locations[].floorSection

string

Sekcja piętra. bardziej szczegółowa lokalizacja na piętrze; Jeśli na przykład piętro jest podzielone na sekcje A, B i C, to pole będzie zawierać jedną z tych wartości.

locations[].type

string

Typ lokalizacji. Jeśli ustawiona jest wartość custom, musi być też ustawiona wartość customType.

Akceptowane wartości: custom, default, desk.
includeInGlobalAddressList

boolean

Wskazuje, czy profil użytkownika jest widoczny na globalnej liście adresów Google Workspace, gdy w domenie włączona jest funkcja udostępniania kontaktów. Więcej informacji o wykluczaniu profili użytkowników znajdziesz w Centrum pomocy dla administratorów.
keywords

value (Value format)

Lista słów kluczowych użytkownika. Maksymalny dozwolony rozmiar danych to 1 KB.

Pola

keywords[].customType

string

Jeśli słowo kluczowe type ma wartość custom, ta właściwość zawiera niestandardową wartość i musi być ustawiona.

keywords[].type

string

Każdy wpis może mieć typ, który wskazuje standardowy typ tego wpisu.

Na przykład słowo kluczowe może mieć typ occupation lub outlook. Oprócz typu standardowego wpis może mieć typ custom i dowolną nazwę. Jeśli ustawisz wartość custom, musisz też ustawić wartość customType.

Dozwolone wartości: custom, mission, occupation, outlook.

keywords[].value

string

Słowo kluczowe.
deletionTime

string

Tylko dane wyjściowe. Czas usunięcia konta użytkownika. Wartość jest podana w formacie daty i godziny ISO 8601. Czas to pełna data oraz godziny, minuty i sekundy w formacie YYYY-MM-DDThh:mm:ssTZD. Na przykład 2010-04-05T17:30:04+01:00.
gender

value (Value format)

Obiekt zagnieżdżony zawierający płeć użytkownika. Maksymalny dozwolony rozmiar danych w tym polu to 1 KB.

Pola

gender.addressMeAs

string

Zrozumiały dla człowieka ciąg tekstowy zawierający właściwy sposób odniesienia się do właściciela profilu przez ludzi, np. „on” lub „oni”.

gender.customGender

string

Nazwa płci niestandardowej.

gender.type

string

 Typ płci.

Akceptowane wartości:
  • female
  • male
  • other
  • unknown

thumbnailPhotoEtag

string

Tylko dane wyjściowe. ETag zdjęcia użytkownika (tylko do odczytu)
ims

value (Value format)

konta użytkownika w komunikatorze błyskawicznym; Konto użytkownika może mieć wiele usług ims, ale tylko jedna z tych usług ims może być głównym kontaktem w usłudze przesyłania wiadomości.

Pola

ims[].customProtocol

string

Jeśli wartość protokołu to custom_protocol, ta właściwość zawiera ciąg niestandardowego protokołu.

ims[].customType

string

Jeśli wartość IM type to custom, ta właściwość zawiera niestandardową wartość i musi być skonfigurowana.

ims[].im

string

Identyfikator sieci czatu użytkownika.

ims[].primary

boolean

Jeśli jest to główny komunikator użytkownika. Tylko jeden wpis na liście IM może mieć wartość true.

ims[].protocol

string

 Protokół komunikatora identyfikuje sieć komunikatora. Wartość może być siecią niestandardową lub standardową.

Akceptowane wartości:
  • aim: protokół AOL Instant Messenger
  • custom_protocol: niestandardowy protokół sieci komunikatora,
  • gtalk: protokół Google Talk
  • icq: protokół ICQ
  • jabber: protokół Jabber
  • msn: protokół MSN Messenger
  • net_meeting: protokół Net Meeting
  • qq: protokół QQ
  • skype: protokół Skype
  • yahoo: protokół Yahoo Messenger

ims[].type

string

Typ konta komunikatora błyskawicznego. Jeśli ustawisz wartość custom, musisz też ustawić wartość customType.

Dozwolone wartości: custom, home, other, work.
customSchemas

value (Value format)

Pola niestandardowe użytkownika. Kluczem jest schemaName, a jego wartości to 'fieldName': 'field_value'.

  • customSchemas.(key) to obiekt zagnieżdżony.
  • customSchemas.(key).(key) może mieć dowolną wartość.
isEnrolledIn2Sv

boolean

Tylko dane wyjściowe. jest zarejestrowany w systemie weryfikacji dwuetapowej (tylko do odczytu);
isEnforcedIn2Sv

boolean

Tylko dane wyjściowe. Czy weryfikacja dwuetapowa jest wymuszona (tylko do odczytu)
archived

boolean

Wskazuje, czy użytkownik jest zarchiwizowany.
orgUnitPath

string

Pełna ścieżka organizacji nadrzędnej powiązanej z użytkownikiem. Jeśli organizacja nadrzędna jest najwyższego poziomu, jest reprezentowana przez ukośnik (/).
recoveryEmail

string

Pomocniczy adres e-mail użytkownika.
recoveryPhone

string

Pomocniczy numer telefonu użytkownika. Numer telefonu musi być zgodny z formatem E.164 i zaczynać się od znaku plusa (+). Przykład: +16506661212.

UserName

Zapis JSON 
{
  "fullName": string,
  "familyName": string,
  "givenName": string,
  "displayName": string
}
Pola
fullName

string

Pełne imię i nazwisko użytkownika utworzone przez złączenie wartości imienia i nazwiska.
familyName

string

Nazwisko użytkownika. Wymagany podczas tworzenia konta użytkownika.
givenName

string

Imię użytkownika. Wymagany podczas tworzenia konta użytkownika.
displayName

string

Wyświetlana nazwa użytkownika. Limit: 256 znaków.

Metody

delete

 Usuwanie użytkownika.

get

 Pobiera dane użytkownika.

insert

 Tworzy użytkownika.

list

 Pobiera pogrupowaną listę usuniętych użytkowników lub wszystkich użytkowników w domenie.

makeAdmin

 Przypisuje użytkownikowi rolę superadministratora.

patch

 Aktualizuje użytkownika za pomocą semantyki poprawki.

signOut

 Wyloguje użytkownika ze wszystkich sesji w przeglądarce i na urządzeniach oraz resetuje jego pliki cookie logowania.

undelete

 przywraca usunięte konto użytkownika;

update

 Aktualizuje użytkownika.

watch

 Sprawdza zmiany na liście użytkowników.