Directory API: الأسماء البديلة للمستخدمين

إنشاء عنوان بديل للبريد الإلكتروني للمستخدم

العنوان البديل للمستخدم هو عنوان بريد إلكتروني بديل يستخدم صندوق البريد نفسه الذي يستخدمه عنوان البريد الإلكتروني الرئيسي للمستخدم. يمكن ربط اسم مستخدم بديل بنطاق حساب مختلف عن النطاق الذي يستخدمه عنوان البريد الإلكتروني الأساسي للمستخدم. في غضون 24 ساعة (غالبًا في وقت أقرب من ذلك)، يبدأ المستخدم باستلام الرسائل الإلكترونية المُرسَلة إلى هذا العنوان الإلكتروني. تتطلّب واجهة برمجة التطبيقات تأكيد ملكية النطاق قبل أن تتمكّن من إنشاء العنوان البديل للبريد الإلكتروني للمستخدم. الأسماء المستعارة غير متاحة للمستخدمين الضيوف.

لإنشاء اسم مستعار للمستخدم، استخدِم طلب POST التالي وأضِف التفويض الموضّح في طلبات التفويض. يمكن أن يكون userKey هو عنوان البريد الإلكتروني الرئيسي للمستخدم أو id أو أي من عناوين البريد الإلكتروني البديلة للمستخدم. للاطّلاع على سمات الطلب والاستجابة، يُرجى الرجوع إلى مرجع واجهة برمجة التطبيقات:

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 أو أي من عناوين البريد الإلكتروني البديلة للمستخدم. للاطّلاع على سمات الطلب والاستجابة، يُرجى الرجوع إلى مرجع واجهة برمجة التطبيقات:

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 عنوان البريد الإلكتروني للاسم المستعار الذي سيتم حذفه. للاطّلاع على سمات الطلب والاستجابة، يُرجى مراجعة مرجع واجهة برمجة التطبيقات.

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.