Method: users.watch

Xem các thay đổi trong danh sách người dùng.

Yêu cầu HTTP

POST https://admin.googleapis.com/admin/directory/v1/users/watch

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

Tham số truy vấn

Thông số
domain

string

Tên miền. Điền vào trường này để chỉ những người dùng từ tên miền này. Để trả lại tất cả người dùng trong trường khách hàng điền vào nhiều miền thay thế."

customer

string

Mã không thể thay đổi của tài khoản Google Workspace. Trong trường hợp có nhiều miền, hãy điền vào trường này thay vì miền để tìm nạp tất cả người dùng cho một khách hàng.

event

enum (EventType)

Các sự kiện cần theo dõi.

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. Giá trị này chỉ được đặt khi chiếu=tùy chỉnh.

maxResults

integer

Số kết quả tối đa cần trả về.

orderBy

enum (OrderBy)

Cột dùng để sắp xếp kết quả

pageToken

string

Mã thông báo để chỉ định trang tiếp theo trong danh sách

projection

enum (Projection)

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

query

string

Tìm kiếm chuỗi truy vấn. Phải ở dạng "". Tài liệu hoàn chỉnh có tại https: //developers.google.com/admin-sdk/directory/v1/guides/search-users

showDeleted

string

Nếu bạn đặt chính sách này thành true, thì danh sách này sẽ truy xuất danh sách người dùng đã xóa. (Mặc định: false)

sortOrder

enum (SortOrder)

Trả lại kết quả theo thứ tự tăng dần hay giảm dần.

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 chứa một bản sao của SubscriptionChannel.

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

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
  • https://www.googleapis.com/auth/cloud-platform

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

Loại sự kiện

Loại sự kiện Đăng ký

Enum
ADD Sự kiện do người dùng tạo
DELETE Sự kiện đã xóa người dùng
MAKE_ADMIN Sự kiện thay đổi trạng thái quản trị viên người dùng
UNDELETE Sự kiện người dùng chưa bị xóa
UPDATE Sự kiện do người dùng cập nhật

Sắp xếp theo

Enum
EMAIL Email chính của người dùng.
FAMILY_NAME Họ của người dùng.
GIVEN_NAME Tên do người dùng cung cấp.

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ừ những lược đồ được đề cập 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.

SortOrder

Enum
ASCENDING Thứ tự tăng dần.
DESCENDING Thứ tự giảm dần.

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