إنشاء اسم مستعار للمستخدم
العنوان البديل للبريد الإلكتروني للمستخدم هو عنوان بريد إلكتروني بديل يستخدم صندوق البريد الإلكتروني نفسه الذي يستخدمه عنوان البريد الإلكتروني الرئيسي للمستخدم. يمكن ربط عنوان البريد الإلكتروني البديل للمستخدم بنطاق حساب مختلف عن النطاق الذي يستخدمه عنوان البريد الإلكتروني الرئيسي للمستخدم. في غضون 24 ساعة (غالبًا في وقت أقرب من ذلك)، سيبدأ المستخدم في تلقّي رسالة إلكترونية مُرسَلة إلى هذا العنوان. تتطلّب واجهة برمجة التطبيقات تأكيد ملكية النطاق قبل أن تتمكّن من إنشاء الاسم المستعار للمستخدم.
لإنشاء اسم مستعار للمستخدم، استخدم طلب POST التالي وضمِّن التفويض الموضح في طلبات التفويض. يمكن أن يكون userKey هو عنوان البريد الإلكتروني الرئيسي للمستخدم أو المستخدم id أو أي عنوان من عناوين البريد الإلكتروني للعناوين البديلة الخاصة بالمستخدمين. بالنسبة إلى خصائص الطلب والاستجابة، اطّلِع على مرجع واجهة برمجة التطبيقات:
POST https://admin.googleapis.com/admin/directory/v1/users/userKey/aliases
طلب JSON
يعرض طلب JSON التالي نموذجًا لطلب إنشاء اسم مستعار لأحد المستخدمين. المستخدم هو liz@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 للطلب هذا جميع الأسماء المستعارة لمفتاح المستخدم، 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 هذا العنوان cha@example.com البديل لمفتاح المستخدم، liz@example.com:
DELETE https://admin.googleapis.com/admin/directory/v1/users/liz@example.com/aliases/chica@example.com
تعرض الاستجابة الناجحة رمز حالة HTTP 200.