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