คู่มือนี้ครอบคลุมวิธีสร้าง แสดงรายการ และลบผู้รับมอบสิทธิ์ให้เข้าถึงรายชื่อติดต่อสำหรับผู้ใช้ Google Workspace
ผู้ใช้ Google Workspace สามารถให้สิทธิ์ผู้ใช้รายอื่นในโดเมน เพื่อเข้าถึงและจัดการรายชื่อติดต่อของตนได้ ผู้รับมอบสิทธิ์เหล่านี้สามารถเพิ่มและอัปเดตรายชื่อติดต่อด้วยข้อมูลต่างๆ เช่น ชื่อ หมายเลขโทรศัพท์ และที่อยู่
คู่มือนี้มีไว้สำหรับการมอบสิทธิ์เข้าถึงรายชื่อติดต่อ หากต้องการมอบสิทธิ์เข้าถึง Gmail โปรดดูหัวข้อมอบสิทธิ์และทำงานร่วมกันในอีเมล
ข้อกำหนดเบื้องต้น
ก่อนใช้ Contact Delegation API โปรดตรวจสอบว่าคุณมีคุณสมบัติตรงตามข้อกำหนดต่อไปนี้
- เปิดใช้การแชร์รายชื่อติดต่อ: ผู้ดูแลระบบไดเรกทอรีต้องเปิดการแชร์รายชื่อติดต่อในคอนโซลผู้ดูแลระบบ ดูข้อมูลเพิ่มเติมได้ที่หัวข้อเปิดหรือปิดการแชร์รายชื่อติดต่อ
- สิทธิ์ผู้ดูแลระบบ: คุณต้องมีสิทธิ์ผู้ดูแลระบบ "รายชื่อติดต่อ" จึงจะจัดการผู้ที่ได้รับสิทธิ์ให้จัดการรายชื่อติดต่อของผู้ใช้คนอื่นได้
- การจํากัดโดเมน: คุณจะมอบสิทธิ์ให้ผู้ใช้เข้าถึงรายชื่อติดต่อได้เฉพาะผู้ใช้ในองค์กร Google Workspace เดียวกัน
- ขอบเขต OAuth: แอปพลิเคชันต้องใช้ขอบเขต OAuth ต่อไปนี้
https://www.googleapis.com/auth/admin.contact.delegation
สร้างผู้รับมอบสิทธิ์
หากต้องการสร้างผู้รับมอบสิทธิ์สำหรับผู้ใช้ ให้ส่งPOSTคำขอพร้อมอีเมลของผู้มอบสิทธิ์
POST https://admin.googleapis.com/admin/contacts/v1/users/USER_EMAIL/delegates
แทนที่ USER_EMAIL ด้วยอีเมลของผู้มอบสิทธิ์
ในเนื้อหาของคำขอ ให้ระบุอีเมลของผู้รับมอบสิทธิ์
{
"email": "DELEGATE_EMAIL"
}
แทนที่ DELEGATE_EMAIL ด้วยอีเมลของผู้รับมอบสิทธิ์
การตอบกลับที่สำเร็จจะแสดงHTTP 200รหัสสถานะและอีเมลของผู้รับมอบสิทธิ์รายใหม่
{
"email": "DELEGATE_EMAIL"
}
ผู้รับมอบสิทธิ์ในรายการ
หากต้องการแสดงรายชื่อผู้รับมอบสิทธิ์สำหรับรายชื่อติดต่อของผู้ใช้ ให้ส่งGETคำขอพร้อมอีเมลของผู้ใช้รายนั้น
GET https://admin.googleapis.com/admin/contacts/v1/users/USER_EMAIL/delegates
แทนที่ USER_EMAIL ด้วยอีเมลของผู้ใช้
การตอบกลับที่สำเร็จจะแสดงHTTP 200รหัสสถานะและรายชื่ออีเมลของผู้รับมอบสิทธิ์
{
"delegates": [
{
"email": "DELEGATE_EMAIL_1"
},
{
"email": "DELEGATE_EMAIL_2"
}
]
}
ลบผู้รับมอบสิทธิ์
หากต้องการลบผู้รับมอบสิทธิ์สำหรับรายชื่อติดต่อของผู้ใช้ ให้ทำตามขั้นตอนต่อไปนี้
- ระบุผู้รับมอบสิทธิ์ที่จะนำออก ใช้วิธี List delegates เพื่อค้นหาอีเมลของผู้รับมอบสิทธิ์ที่เฉพาะเจาะจง
ส่ง
DELETEคำขอพร้อมอีเมลของผู้มอบสิทธิ์และผู้รับมอบสิทธิ์DELETE https://admin.googleapis.com/admin/contacts/v1/users/USER_EMAIL/delegates/DELEGATE_EMAIL
แทนที่ USER_EMAIL ด้วยอีเมลของผู้มอบสิทธิ์ และ
DELEGATE_EMAIL ด้วยอีเมลของผู้รับมอบสิทธิ์
การตอบกลับที่สำเร็จจะแสดงรหัสสถานะ HTTP 200