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

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

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

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

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

طلب JSON

يعرض طلب JSON التالي نموذج طلب لإنشاء اسم مستخدم بديل. المستخدم هو [email protected] والاسم المستعار هو [email protected]: 

POST https://admin.googleapis.com/admin/directory/v1/users/[email protected]/aliases
 يحتوي نص الطلب على معلومات الاسم المعرِّف الجديد: 
{  
 "alias": "[email protected]"
}

تعرِض الاستجابة الناجحة رمز حالة HTTP 201. وإلى جانب رمز الحالة، تعرض الاستجابة سمات الاسم المعرِّف للمستخدم الجديد.

استرداد جميع العناوين البديلة لمستخدم

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

GET https://admin.googleapis.com/admin/directory/v1/users/userKey/aliases
 على سبيل المثال، يعرض عنوان URL للطلب هذا جميع الأسماء البديلة لمفتاح المستخدم [email protected]: 
GET https://admin.googleapis.com/admin/directory/v1/users/[email protected]/aliases

يتم عرض جميع الأسماء البديلة للمستخدمين بترتيب أبجدي. لا يتوفّر حجم صفحة، مثل سلسلة طلب البحث maxResults أو تقسيم الصفحات المستخدَم في استجابة "استرداد كل الأسماء البديلة".

استجابة JSON

يعرض الطلب الناجح رمز الحالة HTTP 200. وإلى جانب رمز الحالة، تعرض الاستجابة الأسماء البديلة للمستخدم بترتيب أبجدي. أسماء النطاقات المستعارة هذه هي النطاق الأساسي ونطاقات متعددة أخرى في الحساب: 

{
"kind": "directory#user#aliases",
"aliases": [
 {
  "kind": "directory#user#alias",
  "id": "the unique user id",
  "primary_email": "[email protected]",
  "alias": "[email protected]"
 },
 {
  "kind": "directory#user#alias",
  "id": "the unique user id",
  "primary_email": "[email protected]",
  "alias": "[email protected]"
 },
 {
  "kind": "directory#user#alias",
  "id": "the unique user id",
  "primary_email": "[email protected]",
  "alias": "[email protected]"
 },
 {
  "kind": "directory#user#alias",
  "id": "the unique user id",
  "primary_email": "[email protected]",
  "alias": "[email protected]"
 }
]
}

حذف الاسم المعرِّف لأحد المستخدمين

لحذف عنوان مستخدم بديل، استخدِم طلب DELETE التالي وأضِف التفويض الموضّح في طلبات التفويض. قد تستغرق إزالة العنوان البديل للبريد الإلكتروني مدة تصل إلى 24 ساعة. يمكن أن يكون userKey عنوان البريد الإلكتروني الرئيسي للمستخدم أو المستخدم id أو أي من عناوين البريد الإلكتروني البديلة للمستخدم. وaliasId هو عنوان البريد الإلكتروني للعنوان البديل الذي تتم jego Deletion. للاطّلاع على سمات الطلب والاستجابة، اطّلِع على مرجع واجهة برمجة التطبيقات. 

DELETE https://admin.googleapis.com/admin/directory/v1/users/userKey/aliases/aliasId
 على سبيل المثال، يحذف طلب DELETE هذا الاسم المستعار [email protected] لمفتاح المستخدم [email protected]: 
DELETE https://admin.googleapis.com/admin/directory/v1/users/[email protected]/aliases/[email protected]

يعرض الطلب الناجح رمز الحالة HTTP 200.