Directory API: ชื่อแทนของผู้ใช้

สร้างชื่อแทนผู้ใช้

ชื่อแทนของผู้ใช้คืออีเมลอื่นที่ใช้กล่องจดหมายเดียวกับที่ผู้ใช้ อีเมลหลัก ชื่อแทนของผู้ใช้สามารถเชื่อมโยงกับโดเมนบัญชีอื่นที่ไม่ใช่โดเมนบัญชีนั้นได้ โดเมนที่ที่อยู่อีเมลหลักของผู้ใช้ใช้ ผู้ใช้จะเริ่มภายใน 24 ชั่วโมง (โดยมากจะเร็วกว่านั้น) ได้รับอีเมลที่ส่งไปยังที่อยู่นี้ API กำหนดให้ ยืนยันการเป็นเจ้าของโดเมนแล้ว ก่อนที่จะสร้างชื่อแทนผู้ใช้ได้

หากต้องการสร้างชื่อแทนผู้ใช้ ให้ใช้คำขอ POST ต่อไปนี้และรวมการให้สิทธิ์ที่อธิบายไว้ในคำขอให้สิทธิ์ userKey อาจเป็นที่อยู่อีเมลหลักของผู้ใช้, ผู้ใช้ id หรือชื่อแทนของผู้ใช้ อีเมล สำหรับพร็อพเพอร์ตี้คำขอและการตอบกลับ โปรดดูเอกสารอ้างอิง API

POST https://admin.googleapis.com/admin/directory/v1/users/userKey/aliases

คำขอ JSON

คำขอ JSON ต่อไปนี้แสดงตัวอย่างคำขอเพื่อสร้างชื่อแทนของผู้ใช้ ผู้ใช้คือ liz@example.com และนามแฝงคือ chica@example.com

POST https://admin.googleapis.com/admin/directory/v1/users/liz@example.com/aliases
เนื้อหาคำขอมีข้อมูลชื่อแทนใหม่ดังนี้ วันที่
{  
 "alias": "chica@example.com"
}

การตอบกลับที่สำเร็จจะแสดงรหัสสถานะ HTTP 201 นอกจากรหัสสถานะแล้ว การตอบกลับจะแสดงพร็อพเพอร์ตี้สำหรับชื่อแทนผู้ใช้ใหม่

ดึงข้อมูลชื่อแทนทั้งหมดของผู้ใช้

หากต้องการเรียกข้อมูลชื่อแทนทั้งหมดของผู้ใช้ในทุกโดเมน ให้ใช้คำขอ GET ต่อไปนี้และรวมการให้สิทธิ์ที่อธิบายไว้ในคำขอให้สิทธิ์ userKey อาจเป็นที่อยู่อีเมลหลักของผู้ใช้, ผู้ใช้ id หรือชื่อแทนของผู้ใช้ อีเมล สำหรับพร็อพเพอร์ตี้คำขอและการตอบกลับ โปรดดูเอกสารอ้างอิง API

GET https://admin.googleapis.com/admin/directory/v1/users/userKey/aliases
ตัวอย่างเช่น URI คำขอนี้แสดงชื่อแทนทั้งหมดสำหรับ userKey, liz@example.com: วันที่
GET https://admin.googleapis.com/admin/directory/v1/users/liz@example.com/aliases

ระบบจะแสดงชื่อแทนของผู้ใช้ทั้งหมดตามลำดับตัวอักษร ไม่มีขนาดหน้า เช่น สตริงคำค้นหา maxResults หรือการใส่เลขหน้าที่ใช้สำหรับ "เรียกข้อมูลชื่อแทนทั้งหมด" คำตอบ

การตอบสนองของ JSON

การตอบกลับที่สำเร็จจะแสดงรหัสสถานะ HTTP 200 นอกจากรหัสสถานะแล้ว การตอบกลับจะแสดงชื่อแทนของผู้ใช้ตามลำดับตัวอักษร โดเมนชื่อแทนเหล่านี้เป็นโดเมนหลักและโดเมนอื่นๆ ในบัญชี:

{
"kind": "directory#user#aliases",
"aliases": [
 {
  "kind": "directory#user#alias",
  "id": "the unique user id",
  "primary_email": "liz@example.com",
  "alias": "chica@example.com"
 },
 {
  "kind": "directory#user#alias",
  "id": "the unique user id",
  "primary_email": "liz@example.com",
  "alias": "support@example.com"
 },
 {
  "kind": "directory#user#alias",
  "id": "the unique user id",
  "primary_email": "liz@example.com",
  "alias": "help@hr.example.com"
 },
 {
  "kind": "directory#user#alias",
  "id": "the unique user id",
  "primary_email": "liz@example.com",
  "alias": "tickets@jumboinc.com"
 }
]
}

ลบชื่อแทนของผู้ใช้

หากต้องการลบชื่อแทนผู้ใช้ ให้ใช้คำขอ DELETE ต่อไปนี้และรวม การให้สิทธิ์ที่อธิบายไว้ใน ให้สิทธิ์คำขอ อาจใช้เวลา ถึง 24 ชั่วโมงในการนำชื่อแทนออก userKey อาจเป็นที่อยู่อีเมลหลักของผู้ใช้, ผู้ใช้ id หรืออะไรก็ได้ ชื่อแทนของผู้ใช้" อีเมล และ aliasId คือชื่อแทน" ที่อยู่อีเมลที่ถูก ลบแล้ว สำหรับพร็อพเพอร์ตี้คำขอและการตอบกลับ โปรดดูส่วน เอกสารอ้างอิง API

DELETE https://admin.googleapis.com/admin/directory/v1/users/userKey/aliases/aliasId
ตัวอย่างเช่น คำขอ DELETE นี้จะลบชื่อแทน chica@example.com สำหรับ userKey ซึ่งก็คือ liz@example.com
DELETE https://admin.googleapis.com/admin/directory/v1/users/liz@example.com/aliases/chica@example.com

การตอบกลับที่สำเร็จจะแสดงรหัสสถานะ HTTP 200