จัดการผู้รับมอบสิทธิ์รายชื่อติดต่อ

คู่มือนี้ครอบคลุมวิธีสร้าง แสดงรายการ และลบผู้รับมอบสิทธิ์ให้เข้าถึงรายชื่อติดต่อสำหรับผู้ใช้ 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"
    }
  ]
}

ลบผู้รับมอบสิทธิ์

หากต้องการลบผู้รับมอบสิทธิ์สำหรับรายชื่อติดต่อของผู้ใช้ ให้ทำตามขั้นตอนต่อไปนี้

  1. ระบุผู้รับมอบสิทธิ์ที่จะนำออก ใช้วิธี List delegates เพื่อค้นหาอีเมลของผู้รับมอบสิทธิ์ที่เฉพาะเจาะจง
  2. ส่งDELETEคำขอพร้อมอีเมลของผู้มอบสิทธิ์และผู้รับมอบสิทธิ์

    DELETE https://admin.googleapis.com/admin/contacts/v1/users/USER_EMAIL/delegates/DELEGATE_EMAIL
    

แทนที่ USER_EMAIL ด้วยอีเมลของผู้มอบสิทธิ์ และ DELEGATE_EMAIL ด้วยอีเมลของผู้รับมอบสิทธิ์

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