إدارة المفوَّضين عن جهات الاتصال

يوضّح هذا الدليل كيفية إنشاء قائمة بالمفوّضين في جهات الاتصال وحذفهم لمستخدمي 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.