Method: users.watch

การดูการเปลี่ยนแปลงในรายชื่อผู้ใช้

คำขอ HTTP

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

URL ใช้ไวยากรณ์ gRPC Transcoding

พารามิเตอร์การค้นหา

พารามิเตอร์
domain	string ชื่อโดเมน กรอกข้อมูลในช่องนี้เพื่อให้ได้ผู้ใช้จากโดเมนนี้เท่านั้น แต่หากต้องการส่งคืนผู้ใช้ทั้งหมดในช่องสําหรับ "ลูกค้าหลายโดเมน" แทน ให้ทําดังนี้"
customer	string รหัสที่เปลี่ยนแปลงไม่ได้ของบัญชี Google Workspace ในกรณีที่ใช้หลายโดเมน โปรดป้อนช่องนี้แทนการระบุโดเมนสําหรับลูกค้าทั้งหมด
event	enum (EventType) กิจกรรมที่น่าจับตามอง
customFieldMask	string รายการชื่อสคีมาที่คั่นด้วยเครื่องหมายจุลภาค ดึงข้อมูลช่องทั้งหมดจากสคีมาเหล่านี้ ควรตั้งค่านี้เฉพาะเมื่อ projection=custom เท่านั้น
maxResults	integer จํานวนผลลัพธ์สูงสุดที่จะแสดง
orderBy	enum (OrderBy) คอลัมน์ที่จะใช้สําหรับการจัดเรียงผลลัพธ์
pageToken	string โทเค็นที่จะระบุหน้าถัดไปในรายการ
projection	enum (Projection) ช่องที่จะดึงข้อมูลสําหรับผู้ใช้รายนี้คือช่องใด
query	string การค้นหาสตริงคําค้นหา ควรอยู่ในรูปแบบ "" ดูเอกสารทั้งหมดได้ที่ https: //developers.google.com/admin-sdk/directory/v1/guides/search-users
showDeleted	string หากตั้งค่าเป็น "จริง" จะเรียกรายชื่อผู้ใช้ที่ถูกลบ (ค่าเริ่มต้น: เท็จ)
sortOrder	enum (SortOrder) จะให้ผลลัพธ์ในลําดับจากน้อยไปมากหรือมากไปน้อย
viewType	enum (ViewType) กําหนดว่าจะแสดงมุมมองสาธารณะเฉพาะผู้ดูแลระบบหรือทั้งโดเมนของผู้ใช้ โปรดดูข้อมูลเพิ่มเติมในเรียกคืนผู้ใช้ที่ไม่ใช่ผู้ดูแลระบบ

เนื้อหาของคำขอ

เนื้อความของคำขอมีอินสแตนซ์ของ SubscriptionChannel

เนื้อหาการตอบกลับ

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีอินสแตนซ์ SubscriptionChannel

ขอบเขตการให้สิทธิ์

ต้องการขอบเขต OAuth อย่างใดอย่างหนึ่งต่อไปนี้

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

สําหรับข้อมูลเพิ่มเติม โปรดดูคู่มือการให้สิทธิ์

ประเภทกิจกรรม

ประเภทของเหตุการณ์การติดตาม

Enum
ADD	กิจกรรมที่ผู้ใช้สร้าง
DELETE	เหตุการณ์ที่ผู้ใช้ลบ
MAKE_ADMIN	เหตุการณ์การเปลี่ยนสถานะผู้ดูแลระบบของผู้ใช้
UNDELETE	กิจกรรมที่ผู้ใช้ยกเลิกการลบ
UPDATE	กิจกรรมที่ผู้ใช้อัปเดต

เรียงลําดับตาม

Enum
EMAIL	อีเมลหลักของผู้ใช้
FAMILY_NAME	นามสกุลของผู้ใช้
GIVEN_NAME	ชื่อที่ผู้ใช้ให้ไว้

การคาดคะเน

Enum
BASIC	ไม่รวมช่องที่กําหนดเองของผู้ใช้
CUSTOM	รวมช่องที่กําหนดเองจากสคีมาที่กล่าวถึงใน customFieldMask
FULL	รวมช่องทั้งหมดที่เชื่อมโยงกับผู้ใช้รายนี้

SortOrder

Enum
ASCENDING	เรียงจากน้อยไปมาก
DESCENDING	เรียงลําดับจากมากไปน้อย

ประเภทมุมมอง

Enum
admin_view	ผลลัพธ์มีทั้งช่องสําหรับผู้ดูแลระบบเท่านั้นและช่องสาธารณะ
domain_public	ผลลัพธ์จะรวมเฉพาะช่องสําหรับผู้ใช้คนอื่นในโดเมนซึ่งปรากฏแก่สาธารณะ