Method: users.get

Truy xuất người dùng.

Yêu cầu HTTP

GET https://admin.googleapis.com/admin/directory/v1/users/{userKey}

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Thông số
userKey

string

Xác định người dùng trong yêu cầu API. Giá trị có thể là địa chỉ email chính, địa chỉ email bí danh hoặc ID người dùng duy nhất của người dùng.

Tham số truy vấn

Thông số
customFieldMask

string

Danh sách tên giản đồ được phân tách bằng dấu phẩy. Hệ thống sẽ tìm nạp tất cả các trường trong những lược đồ này. Bạn chỉ nên đặt giá trị này khi projection=custom.

projection

enum (Projection)

Tập hợp con các trường để tìm nạp cho người dùng này.

viewType

enum (ViewType)

Có tìm nạp chế độ xem công khai trên toàn miền hoặc chỉ dành cho quản trị viên của người dùng hay không. Để biết thêm thông tin, hãy xem Truy xuất người dùng với tư cách không phải quản trị viên.

Nội dung yêu cầu

Nội dung yêu cầu phải trống.

Nội dung phản hồi

Nếu thành công, nội dung phản hồi sẽ chứa một phiên bản của User.

Phạm vi ủy quyền

Yêu cầu một trong các phạm vi OAuth sau:

  • https://www.googleapis.com/auth/admin.directory.user
  • https://www.googleapis.com/auth/admin.directory.user.readonly

Để biết thêm thông tin, hãy xem Hướng dẫn ủy quyền.

Dự đoán

Enum
BASIC Không bao gồm bất kỳ trường tùy chỉnh nào cho người dùng.
CUSTOM Bao gồm các trường tùy chỉnh từ giản đồ được yêu cầu trong customFieldMask.
FULL Bao gồm tất cả các trường được liên kết với người dùng này.

Loại khung hiển thị

Enum
admin_view Kết quả bao gồm cả trường chỉ dành cho quản trị viên và trường công khai của miền cho người dùng.
domain_public Kết quả chỉ bao gồm các trường của người dùng hiển thị công khai với người dùng khác trong miền.